+ {label}
+
+
+
+
+
+
+
+
+
+
+ {options.map(option => {
+ const active = !isCustom && option.value === currentValue
+
+ return (
+
+ )
+ })}
+
+
+ {children}
+ !disabled && !isReadOnly && inputRef.current?.focus()}
+ className="flex min-h-8 min-w-0 flex-1 cursor-text items-center justify-center gap-1 rounded-[20px] px-2 text-sm text-subText hover:bg-buttonGray data-[disabled=true]:cursor-not-allowed data-[active=true]:bg-tabActive data-[active=true]:font-medium data-[active=true]:text-text data-[disabled=true]:opacity-50"
+ >
+ {customPrefix}
+ {
+ setIsInputFocused(false)
+ if (!customInput || !isValueAllowed(Number(customInput))) resetCustomInput()
+ }}
+ onChange={event => handleCustomInputChange(event.target.value)}
+ onFocus={() => {
+ setIsInputFocused(true)
+ setIsCustom(true)
+ }}
+ className="w-14 min-w-0 border-0 bg-transparent p-0 text-right text-[13px] font-medium text-inherit outline-none placeholder:text-inherit placeholder:opacity-60 disabled:cursor-not-allowed"
+ />
+ {customSuffix}
+
+
{(label && positionLabel === 'in') || showTopActions ? (
+ Copy Trading
+
+ New
+
+
+ )}
{!upToExtraSmall && (
diff --git a/apps/kyberswap-interface/src/components/Menu/components/MainMenuSection.tsx b/apps/kyberswap-interface/src/components/Menu/components/MainMenuSection.tsx
index ca2d3d16a2..e5668db929 100644
--- a/apps/kyberswap-interface/src/components/Menu/components/MainMenuSection.tsx
+++ b/apps/kyberswap-interface/src/components/Menu/components/MainMenuSection.tsx
@@ -1,5 +1,5 @@
import { Trans, t } from '@lingui/macro'
-import { BookOpen, FileText, Info, MessageCircle, PieChart } from 'react-feather'
+import { BookOpen, FileText, Info, MessageCircle, PieChart, Users } from 'react-feather'
import { NavLink } from 'react-router-dom'
import { useMedia } from 'react-use'
@@ -74,16 +74,28 @@ export const MainMenuSection = ({ openTipLinkGenerator, toggle }: MainMenuSectio
)}
{upToExtraSmall && (
-
+ <>
+
+
+
)}
{upToMedium && (
diff --git a/apps/kyberswap-interface/src/components/ScrollableWithSignal/index.tsx b/apps/kyberswap-interface/src/components/ScrollableWithSignal/index.tsx
index bcba1fbe5b..264ff8057c 100644
--- a/apps/kyberswap-interface/src/components/ScrollableWithSignal/index.tsx
+++ b/apps/kyberswap-interface/src/components/ScrollableWithSignal/index.tsx
@@ -1,4 +1,5 @@
import { type HTMLAttributes, PropsWithChildren, forwardRef, useCallback, useEffect, useRef, useState } from 'react'
+import { ChevronDown } from 'react-feather'
import { cn } from 'utils/cn'
@@ -6,13 +7,21 @@ type Props = HTMLAttributes &
PropsWithChildren<{
isOpen?: boolean
showArrow?: boolean
- showBackground?: boolean
+ wrapperClassName?: string
'data-open'?: 'true' | 'false'
'data-signal'?: 'true' | 'false'
}>
const ScrollableWithSignal = forwardRef(function ScrollableWithSignal(
- { children, showArrow = false, showBackground = false, className, ...rest }: Props,
+ {
+ children,
+ showArrow = false,
+ className,
+ wrapperClassName,
+ 'data-open': dataOpen,
+ 'data-signal': dataSignal,
+ ...rest
+ }: Props,
forwardedRef,
) {
const localRef = useRef(null)
@@ -37,23 +46,40 @@ const ScrollableWithSignal = forwardRef(function Scrollab
}, [])
useEffect(() => {
- updateSignal(localRef.current)
+ const target = localRef.current
+ updateSignal(target)
+
+ if (!target || typeof ResizeObserver === 'undefined') return
+
+ const observer = new ResizeObserver(() => updateSignal(target))
+ observer.observe(target)
+
+ return () => observer.disconnect()
}, [children, updateSignal])
- const isOpen = rest['data-open'] === 'true'
- const disabledSignal = rest['data-signal'] === 'false'
+ const isOpen = dataOpen === 'true'
+ const disabledSignal = dataSignal === 'false'
return (
(EMPTY_BALANCE)
+ const [balance, setBalance] = useState(INITIAL_BALANCE)
const { account, chainId: activeChainId } = useActiveWeb3React()
const chainId = customChainId || activeChainId
const publicClient = usePublicClient({ chainId: chainId as number })
@@ -33,10 +35,11 @@ function useTokenBalance(tokenAddress: string, customChainId?: ChainId) {
setBalance(EMPTY_BALANCE)
return
}
+ setBalance(currentBalance => ({ ...currentBalance, isLoading: true }))
try {
if (addressCheckSum === WETH[chainId].address) {
const ethBalance = await publicClient.getBalance({ address: account as Address })
- setBalance({ value: ethBalance, decimals: 18 })
+ setBalance({ value: ethBalance, decimals: 18, isLoading: false })
return
}
const cacheKey = `${chainId}:${addressCheckSum}`
@@ -48,7 +51,7 @@ function useTokenBalance(tokenAddress: string, customChainId?: ChainId) {
functionName: 'balanceOf',
args: [account],
})) as bigint
- setBalance({ value: rawBalance, decimals: cachedDecimals })
+ setBalance({ value: rawBalance, decimals: cachedDecimals, isLoading: false })
return
}
const [rawBalance, decimals] = await Promise.all([
@@ -65,7 +68,7 @@ function useTokenBalance(tokenAddress: string, customChainId?: ChainId) {
}) as Promise,
])
decimalsCacheRef.current.set(cacheKey, decimals)
- setBalance({ value: rawBalance, decimals })
+ setBalance({ value: rawBalance, decimals, isLoading: false })
} catch {
setBalance(EMPTY_BALANCE)
}
diff --git a/apps/kyberswap-interface/src/pages/App.tsx b/apps/kyberswap-interface/src/pages/App.tsx
index 8fb787aff3..d0f22e219a 100644
--- a/apps/kyberswap-interface/src/pages/App.tsx
+++ b/apps/kyberswap-interface/src/pages/App.tsx
@@ -50,6 +50,7 @@ const Consent = lazy(() => import('pages/Oauth/Consent'))
const ElasticSnapshot = lazy(() => import('pages/ElasticSnapshot'))
const MarketOverview = lazy(() => import('pages/MarketOverview'))
+const CopyTrading = lazy(() => import('pages/CopyTrading'))
const PartnerSwap = lazy(() => import('pages/PartnerSwap'))
const MyPool = lazy(() => import('pages/MyPool'))
@@ -210,6 +211,7 @@ export default function App() {
useGlobalTrackingEvents()
const showFooter = !pathname.includes(APP_PATHS.ABOUT) && !isEmbeddedSwap
+ const isFullPage = pathname.includes(APP_PATHS.COPY_TRADING)
return (
@@ -343,6 +345,7 @@ export default function App() {
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/AgentList/AgentTable.tsx b/apps/kyberswap-interface/src/pages/CopyTrading/AgentList/AgentTable.tsx
new file mode 100644
index 0000000000..730b072090
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/AgentList/AgentTable.tsx
@@ -0,0 +1,204 @@
+import { type HTMLAttributes, useMemo } from 'react'
+import { useNavigate } from 'react-router-dom'
+import copyRunApi from 'services/copyTrading/api/endpoints/copyRuns'
+import type { AgentCard } from 'services/copyTrading/types/agents'
+import type { CopyRunSummary } from 'services/copyTrading/types/copyRuns'
+import type { LeaderboardSortBy, SortOrder } from 'services/copyTrading/types/primitives'
+
+import { ButtonPrimary } from 'components/Button'
+import { Stack } from 'components/Stack'
+import { APP_PATHS } from 'constants/index'
+import CursorPagination, { type CursorPaginationState } from 'pages/CopyTrading/components/CursorPagination'
+import { HeaderCell, TableBody, TableCell, TableHeader, TableRow } from 'pages/CopyTrading/components/Table'
+import { AgentCell } from 'pages/CopyTrading/components/common/agentIdentity'
+import { copyTradingStatIconMap } from 'pages/CopyTrading/constants'
+import { useCopyTradingContext } from 'pages/CopyTrading/context'
+import {
+ compactUsd,
+ formatCount,
+ getPreparedReasonMessage,
+ getSignedMetricClassName,
+ getWinRateClassName,
+ isActionAvailable,
+ percent,
+} from 'pages/CopyTrading/helpers'
+import { useCopyTradingModal } from 'pages/CopyTrading/modals/context'
+import { cn } from 'utils/cn'
+
+type LeaderboardGridProps = HTMLAttributes & {
+ header?: boolean
+}
+
+const LeaderboardGrid = ({ header, className, ...props }: LeaderboardGridProps) => {
+ const Grid = header ? TableHeader : TableRow
+
+ return (
+ >((acc, run) => {
+ acc[run.agentId] = run
+ return acc
+ }, {}),
+ [activeCopyRuns?.data],
+ )
+
+ const openAgent = (agentId: string) => {
+ navigate(`${APP_PATHS.COPY_TRADING}/${agentId}`)
+ }
+
+ return (
+
+
+ )
+}
+
+export default AgentTable
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/AgentList/components.tsx b/apps/kyberswap-interface/src/pages/CopyTrading/AgentList/components.tsx
new file mode 100644
index 0000000000..159462ff5a
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/AgentList/components.tsx
@@ -0,0 +1,146 @@
+import { useRef } from 'react'
+import { Search, X } from 'react-feather'
+import type { LeaderboardSummary as LeaderboardSummaryData } from 'services/copyTrading/types/agents'
+import type { StrategyKey } from 'services/copyTrading/types/primitives'
+
+import { ButtonEmpty } from 'components/Button'
+import { HStack, Stack } from 'components/Stack'
+import Leaderboard, { type LeaderboardStat } from 'pages/CopyTrading/components/Leaderboard'
+import { copyTradingStatIconMap } from 'pages/CopyTrading/constants'
+import { compactUsd, formatCount } from 'pages/CopyTrading/helpers'
+import { cn } from 'utils/cn'
+
+const strategyOptions = [
+ { label: 'All Strategies', value: 'all' },
+ { label: 'Focused', value: 'focused' },
+ { label: 'Diversified', value: 'diversified' },
+ { label: 'Active', value: 'active' },
+] as const
+
+export type StrategyFilter = (typeof strategyOptions)[number]['value']
+
+export const strategyTabs = strategyOptions.map(option => option.value)
+
+export const toStrategyKey = (strategy: StrategyFilter): StrategyKey | undefined =>
+ strategy === 'all' ? undefined : (strategy as StrategyKey)
+
+type LeaderboardSummaryProps = {
+ summary?: LeaderboardSummaryData
+ fallbackAgentCount?: number
+}
+
+export const LeaderboardSummary = ({ summary, fallbackAgentCount }: LeaderboardSummaryProps) => {
+ const stats: LeaderboardStat[] = [
+ {
+ label: 'Total Agents',
+ value: formatCount(summary?.totalAgents ?? fallbackAgentCount),
+ icon: copyTradingStatIconMap.agents,
+ status: summary?.metrics.agentCount?.status,
+ },
+ {
+ label: 'Total AUM',
+ value: compactUsd(summary?.totalAumUsd),
+ icon: copyTradingStatIconMap.money,
+ status: summary?.metrics.totalAumUsd?.status,
+ },
+ {
+ label: 'Total Copiers',
+ value: formatCount(summary?.totalCopiers),
+ icon: copyTradingStatIconMap.usersPurple,
+ status: summary?.metrics.totalCopierCount?.status,
+ },
+ {
+ label: 'Total Volume',
+ value: compactUsd(summary?.totalVolumeUsd),
+ icon: copyTradingStatIconMap.volume,
+ status: summary?.metrics.lifetimeVolumeUsd?.status,
+ },
+ ]
+
+ return
+
+ )
+}
+
+type SearchInputProps = {
+ value: string
+ onChange: (value: string) => void
+}
+
+export const SearchInput = ({ value, onChange }: SearchInputProps) => {
+ const inputRef = useRef(null)
+
+ const handleClear = () => {
+ onChange('')
+ inputRef.current?.focus()
+ }
+
+ return (
+
+ onChange(event.target.value)}
+ className="min-w-0 flex-1 border-0 bg-transparent text-sm text-text outline-none placeholder:text-subText"
+ placeholder="Search agent, address, or strategy..."
+ />
+
+ {!!value && (
+
+
+ )}
+
+
+ )
+}
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/AgentList/index.tsx b/apps/kyberswap-interface/src/pages/CopyTrading/AgentList/index.tsx
new file mode 100644
index 0000000000..cf586ad12f
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/AgentList/index.tsx
@@ -0,0 +1,122 @@
+import { useMemo, useState } from 'react'
+import discoveryApi from 'services/copyTrading/api/endpoints/discovery'
+import type { LeaderboardSortBy, SortOrder } from 'services/copyTrading/types/primitives'
+
+import { HStack, Stack } from 'components/Stack'
+import useDebounce from 'hooks/useDebounce'
+import useTab from 'hooks/useTab'
+import AgentTable from 'pages/CopyTrading/AgentList/AgentTable'
+import {
+ LeaderboardSummary,
+ SearchInput,
+ type StrategyFilter,
+ StrategyFilterControl,
+ strategyTabs,
+ toStrategyKey,
+} from 'pages/CopyTrading/AgentList/components'
+import { useCursorPageQuery } from 'pages/CopyTrading/components/CursorPagination'
+import { CopyTradingPage, CopyTradingPageHeading } from 'pages/CopyTrading/components/common/layout'
+import { useCopyTradingContext } from 'pages/CopyTrading/context'
+
+const PAGE_SIZE = 5
+
+const AgentList = () => {
+ const { selectedChainId } = useCopyTradingContext()
+
+ const [search, setSearch] = useState('')
+ const [sortBy, setSortBy] = useState()
+ const [sortOrder, setSortOrder] = useState()
+
+ const { activeTab, setActiveTab } = useTab({
+ tabs: strategyTabs,
+ defaultTab: 'all',
+ queryKey: 'strategy',
+ })
+
+ const debouncedSearch = useDebounce(search, 300)
+
+ const selectedStrategy = toStrategyKey(activeTab || 'all')
+ const normalizedSearch = debouncedSearch.trim() || undefined
+
+ const summaryQuery = useMemo(
+ () => ({
+ chainId: selectedChainId,
+ strategy: selectedStrategy,
+ search: normalizedSearch,
+ }),
+ [normalizedSearch, selectedChainId, selectedStrategy],
+ )
+
+ const { data: leaderboardSummary } = discoveryApi.useGetLeaderboardSummaryQuery(summaryQuery, {
+ pollingInterval: 10_000,
+ })
+ const [getLeaderboard] = discoveryApi.useLazyGetLeaderboardQuery()
+ const leaderboardPage = useCursorPageQuery({
+ queryKey: ['copy-trading', 'leaderboard', selectedChainId, selectedStrategy, normalizedSearch, sortBy, sortOrder],
+ queryFn: cursor =>
+ getLeaderboard({
+ ...summaryQuery,
+ sortBy,
+ sortOrder,
+ cursor,
+ limit: PAGE_SIZE,
+ }).unwrap(),
+ })
+
+ const agents = leaderboardPage.items
+
+ const handleStrategyChange = (strategy: StrategyFilter) => {
+ setActiveTab(strategy)
+ }
+
+ const handleSearchChange = (value: string) => {
+ setSearch(value)
+ }
+
+ const handleSortChange = (nextSortBy: LeaderboardSortBy) => {
+ if (sortBy !== nextSortBy) {
+ setSortBy(nextSortBy)
+ setSortOrder('desc')
+ return
+ }
+ if (sortOrder === 'desc') {
+ setSortOrder('asc')
+ return
+ }
+ setSortBy(undefined)
+ setSortOrder(undefined)
+ }
+
+ return (
+
+
+ Agent Leaderboard
+
+ }
+ description="Automatically delegate to top on-chain AI agents. Maintain full custody of your assets with transparent fees and cashback."
+ />
+
+
+
+
+
+
+
+ )
+}
+
+export default AgentList
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/AgentProfile/AgentInstruction.tsx b/apps/kyberswap-interface/src/pages/CopyTrading/AgentProfile/AgentInstruction.tsx
new file mode 100644
index 0000000000..a9495637de
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/AgentProfile/AgentInstruction.tsx
@@ -0,0 +1,90 @@
+import { Zap } from 'react-feather'
+import { useNavigate } from 'react-router-dom'
+import copyRunApi from 'services/copyTrading/api/endpoints/copyRuns'
+import type { AdvisoryActionAvailability } from 'services/copyTrading/types/actionAvailability'
+import type { AgentProfile } from 'services/copyTrading/types/agents'
+
+import { ButtonPrimary } from 'components/Button'
+import { HStack, Stack } from 'components/Stack'
+import { APP_PATHS } from 'constants/index'
+import {
+ AgentRiskCard,
+ StrategyExecutionCard,
+ WhitelistedTokensCard,
+} from 'pages/CopyTrading/components/AgentSidebarCards/AgentProfileCards'
+import { CopyCapitalCard } from 'pages/CopyTrading/components/AgentSidebarCards/CopyActionCards'
+import { SidePanelCard } from 'pages/CopyTrading/components/AgentSidebarCards/SidePanelCard'
+import { useCopyTradingContext } from 'pages/CopyTrading/context'
+import {
+ formatUsd,
+ getDisplayCapitalInUsd,
+ getPreparedReasonMessage,
+ isActionAvailable,
+} from 'pages/CopyTrading/helpers'
+import { useCopyTradingModal } from 'pages/CopyTrading/modals/context'
+
+const StartCopyCard = ({ availability, onCopy }: { availability?: AdvisoryActionAvailability; onCopy: () => void }) => {
+ const disabled = !isActionAvailable(availability)
+
+ return (
+
+
+
+
+
+
+ )
+}
+
+type AgentInstructionProps = {
+ agent: AgentProfile
+}
+
+const AgentInstruction = ({ agent }: AgentInstructionProps) => {
+ const navigate = useNavigate()
+ const { ownerAddress } = useCopyTradingContext()
+ const { openStartCopy, openAddCapital } = useCopyTradingModal()
+
+ const { currentData: activeCopyRuns } = copyRunApi.useGetCopyRunsQuery(
+ {
+ ownerAddress: ownerAddress || '',
+ view: 'open',
+ agentId: agent.agentId,
+ limit: 1,
+ },
+ { pollingInterval: 10_000, skip: !ownerAddress },
+ )
+
+ const activeCopyRun = activeCopyRuns?.data[0]
+
+ return (
+
+ {activeCopyRun ? (
+ navigate(`${APP_PATHS.COPY_TRADING}/my-copies/${activeCopyRun.copyRunId}`)}
+ onAddCapital={() => openAddCapital(activeCopyRun, agent.displayName)}
+ />
+ ) : (
+ openStartCopy(agent)} />
+ )}
+
+ )
+}
+
+export default AgentInstruction
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/AgentProfile/AgentStats.tsx b/apps/kyberswap-interface/src/pages/CopyTrading/AgentProfile/AgentStats.tsx
new file mode 100644
index 0000000000..c014f8ef25
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/AgentProfile/AgentStats.tsx
@@ -0,0 +1,126 @@
+import { useMemo, useState } from 'react'
+import agentApi from 'services/copyTrading/api/endpoints/agents'
+import type { AgentStats as AgentStatsData } from 'services/copyTrading/types/agents'
+import type { PerformanceWindow } from 'services/copyTrading/types/primitives'
+
+import { Stack } from 'components/Stack'
+import Leaderboard, { type LeaderboardStat } from 'pages/CopyTrading/components/Leaderboard'
+import {
+ CapitalValueChart,
+ CumulativeRealisedPnlChart,
+ toPerformanceChartPoint,
+} from 'pages/CopyTrading/components/PerformanceCharts'
+import { copyTradingStatIconMap } from 'pages/CopyTrading/constants'
+import {
+ compactUsd,
+ formatCount,
+ getSignedMetricClassName,
+ getWinRateClassName,
+ percent,
+ signedUsd,
+} from 'pages/CopyTrading/helpers'
+
+const getProfileStats = (stats?: AgentStatsData): LeaderboardStat[] => [
+ {
+ label: 'Total Realised P&L',
+ value: signedUsd(stats?.totalRealizedPnlUsd),
+ valueClassName: getSignedMetricClassName(stats?.totalRealizedPnlUsd),
+ icon: copyTradingStatIconMap.pnl,
+ status: stats?.metrics.totalRealizedPnlUsd?.status,
+ },
+ {
+ label: 'Copiers',
+ value: formatCount(stats?.copiers),
+ icon: copyTradingStatIconMap.users,
+ status: stats?.metrics.copiers?.status,
+ },
+ {
+ label: 'Win Rate',
+ value: percent(stats?.winRatePct),
+ valueClassName: getWinRateClassName(stats?.winRatePct),
+ icon: copyTradingStatIconMap.winRate,
+ status: stats?.metrics.winRatePct?.status,
+ },
+ {
+ label: 'AUM',
+ value: compactUsd(stats?.aumUsd),
+ icon: copyTradingStatIconMap.aum,
+ status: stats?.metrics.aumUsd?.status,
+ },
+]
+
+type AgentStatsProps = {
+ agentId: string
+}
+
+const AgentStats = ({ agentId }: AgentStatsProps) => {
+ const [window, setWindow] = useState('30d')
+
+ const interval = window === 'all' ? 'month' : 'day'
+
+ const { data: agentStats } = agentApi.useGetAgentStatsQuery({ agentId }, { pollingInterval: 10_000 })
+
+ const {
+ data: portfolioPerformance,
+ isError: isPortfolioError,
+ isFetching: isPortfolioFetching,
+ } = agentApi.useGetAgentPerformanceQuery(
+ {
+ agentId,
+ interval,
+ limit: 100,
+ series: 'portfolio_value',
+ window,
+ },
+ { pollingInterval: 10_000 },
+ )
+
+ const {
+ data: realizedPnlPerformance,
+ isError: isRealizedPnlError,
+ isFetching: isRealizedPnlFetching,
+ } = agentApi.useGetAgentPerformanceQuery(
+ {
+ agentId,
+ interval,
+ limit: 100,
+ series: 'cumulative_realized_pnl',
+ window,
+ },
+ { pollingInterval: 10_000 },
+ )
+
+ const stats = agentStats?.data
+ const portfolioData = useMemo(
+ () => (portfolioPerformance?.data || []).map(toPerformanceChartPoint),
+ [portfolioPerformance?.data],
+ )
+
+ const realizedPnlData = useMemo(
+ () => (realizedPnlPerformance?.data || []).map(toPerformanceChartPoint),
+ [realizedPnlPerformance?.data],
+ )
+
+ return (
+
+
+
+
+ )
+}
+
+export default AgentStats
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/AgentProfile/TabActions.tsx b/apps/kyberswap-interface/src/pages/CopyTrading/AgentProfile/TabActions.tsx
new file mode 100644
index 0000000000..a6a752a663
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/AgentProfile/TabActions.tsx
@@ -0,0 +1,190 @@
+import { AnimatePresence, motion } from 'framer-motion'
+import { type PropsWithChildren, useState } from 'react'
+import { ChevronDown, ChevronUp, ExternalLink as ExternalLinkIcon } from 'react-feather'
+import agentApi from 'services/copyTrading/api/endpoints/agents'
+import type { CotLog } from 'services/copyTrading/types/positions'
+
+import { HStack, Stack } from 'components/Stack'
+import { isSupportedChainId } from 'constants/networks'
+import InfiniteScroll, { useInfiniteCursorQuery } from 'pages/CopyTrading/components/InfiniteScroll'
+import { TableBody } from 'pages/CopyTrading/components/Table'
+import { ExternalLink } from 'theme'
+import { shortenHash } from 'utils/address'
+import { cn } from 'utils/cn'
+import { getEtherscanLink } from 'utils/explorer'
+import { formatDateTime } from 'utils/time'
+
+const PAGE_SIZE = 10
+
+const formatStatus = (status: string) => {
+ return status?.replace(/[-_]/g, ' ').replace(/\b\w/g, value => value.toUpperCase()) ?? '-'
+}
+
+const statusClassName = (status: string) =>
+ status === 'broadcast'
+ ? 'text-primary'
+ : status === 'failed'
+ ? 'text-red'
+ : status === 'skipped'
+ ? 'text-warning'
+ : 'text-subText'
+
+const DetailSection = ({ label, children }: PropsWithChildren<{ label: string }>) => (
+
+ {label}
+
+)
+
+const TxLink = ({ chainId, txHash }: { chainId: number; txHash?: string }) => {
+ if (!txHash) {
+ return (No transaction)
+ }
+
+ const displayHash = shortenHash(txHash, 4)
+
+ return (
+
+ {!isSupportedChainId(chainId) ? (
+
+ {displayHash}
+
+ ) : (
+
+ {displayHash}
+
+ )}
+
+ )
+}
+
+type ActionLogRowProps = {
+ expanded: boolean
+ onToggle: (id: string) => void
+ row: CotLog
+}
+
+const ActionLogRow = ({ expanded, onToggle, row }: ActionLogRowProps) => {
+ const toggle = () => onToggle(row.logId)
+ const summary = row.summary?.trim()
+ const showSummary = !!summary && summary.toLowerCase() !== row.action.trim().toLowerCase()
+
+ return (
+
+ {
+ if (event.key === 'Enter' || event.key === ' ') {
+ event.preventDefault()
+ toggle()
+ }
+ }}
+ >
+
+
+ {formatStatus(row.status)}
+
+ {row.action}
+ {formatDateTime(row.occurredAt)}
+
+ {expanded ?
+ {showSummary && {summary}}
+ {(row.trigger || row.reasoning) && (
+
+ {row.trigger && (
+
+ Trigger: {row.trigger}
+
+ )}
+ {row.reasoning && (
+
+ Reasoning: {row.reasoning}
+
+ )}
+
+ )}
+
+
+
+ {expanded && (
+
+
+ {row.trigger}
+ {row.data}
+ {row.reasoning}
+
+ {row.txHash && (
+
+ {formatStatus(row.status)}
+
+ )}
+
+
+
+ )}
+
+
+ )
+}
+
+const TabActions = ({ agentId }: { agentId: string }) => {
+ const [expandedIds, setExpandedIds] = useState([])
+ const [getActionLogs] = agentApi.useLazyGetAgentActionLogsQuery()
+
+ const {
+ infiniteScroll,
+ isFetching,
+ items: rows,
+ } = useInfiniteCursorQuery({
+ queryKey: ['copy-trading', 'agent-action-logs', agentId],
+ queryFn: cursor =>
+ getActionLogs({
+ agentId,
+ cursor,
+ limit: PAGE_SIZE,
+ }).unwrap(),
+ })
+
+ const toggleExpanded = (id: string) => {
+ setExpandedIds(current => (current.includes(id) ? current.filter(item => item !== id) : [...current, id]))
+ }
+
+ return (
+
+
+
+
+ {rows.map(row => (
+
+
+
+
+ )
+}
+
+export default TabActions
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/AgentProfile/TabHistory.tsx b/apps/kyberswap-interface/src/pages/CopyTrading/AgentProfile/TabHistory.tsx
new file mode 100644
index 0000000000..f1b8bea948
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/AgentProfile/TabHistory.tsx
@@ -0,0 +1,92 @@
+import type { HTMLAttributes } from 'react'
+import agentApi from 'services/copyTrading/api/endpoints/agents'
+
+import { Stack } from 'components/Stack'
+import InfiniteScroll, { useInfiniteCursorQuery } from 'pages/CopyTrading/components/InfiniteScroll'
+import { HeaderCell, TableBody, TableCell, TableHeader, TableRow } from 'pages/CopyTrading/components/Table'
+import { ShortenedId } from 'pages/CopyTrading/components/common/layout'
+import { formatTokenAmount, formatUsd, getSignedMetricClassName, signedUsd } from 'pages/CopyTrading/helpers'
+import { cn } from 'utils/cn'
+import { formatDateTime } from 'utils/time'
+
+const PAGE_SIZE = 10
+
+type TabHistoryGridProps = HTMLAttributes & {
+ header?: boolean
+}
+
+const TabHistoryGrid = ({ header, className, ...props }: TabHistoryGridProps) => {
+ const Grid = header ? TableHeader : TableRow
+
+ return (
+
+
+
+ Trade ID
+ Token
+ Entry Price
+ Exit
+ Amount
+ Realised P&L
+ Closed
+
+
+ {rows.map(row => {
+ return (
+
+
+
+ {row.token.symbol || '—'}
+ {formatUsd(row.entryPriceUsd)}
+ {formatUsd(row.exitPriceUsd || row.currentPriceUsd)}
+ {formatTokenAmount(row.amountDecimal)}
+
+ {signedUsd(row.realizedPnlUsd)}
+
+ {formatDateTime(row.closedAt)}
+
+ )
+ })}
+
+
+
+ )
+}
+
+export default TabHistory
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/AgentProfile/TabPositions.tsx b/apps/kyberswap-interface/src/pages/CopyTrading/AgentProfile/TabPositions.tsx
new file mode 100644
index 0000000000..6ee9de80d3
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/AgentProfile/TabPositions.tsx
@@ -0,0 +1,110 @@
+import type { HTMLAttributes } from 'react'
+import agentApi from 'services/copyTrading/api/endpoints/agents'
+
+import { Stack } from 'components/Stack'
+import InfiniteScroll, { useInfiniteCursorQuery } from 'pages/CopyTrading/components/InfiniteScroll'
+import { HeaderCell, TableBody, TableCell, TableHeader, TableRow } from 'pages/CopyTrading/components/Table'
+import { ShortenedId } from 'pages/CopyTrading/components/common/layout'
+import { PositionLifecycleBadge } from 'pages/CopyTrading/components/common/status'
+import {
+ formatTokenAmount,
+ formatUsd,
+ getSignedMetricClassName,
+ signedPercent,
+ signedUsd,
+} from 'pages/CopyTrading/helpers'
+import { cn } from 'utils/cn'
+import { formatDateTime } from 'utils/time'
+
+const PAGE_SIZE = 10
+
+type TabPositionsGridProps = HTMLAttributes & {
+ header?: boolean
+}
+
+const TabPositionsGrid = ({ header, className, ...props }: TabPositionsGridProps) => {
+ const Grid = header ? TableHeader : TableRow
+
+ return (
+
+
+
+ Trade ID
+ Token
+ Entry Price
+ Current Price
+ Amount
+ Value
+ P&L
+ Status
+ Open Since
+
+
+ {rows.map(row => {
+ const pnl = row.unrealizedPnlUsd || row.realizedPnlUsd
+
+ return (
+
+
+
+ {row.token.symbol || '—'}
+ {formatUsd(row.entryPriceUsd)}
+ {formatUsd(row.currentPriceUsd)}
+ {formatTokenAmount(row.amountDecimal)}
+ {formatUsd(row.valueUsd)}
+
+
+ {signedUsd(pnl)}
+ {signedPercent(row.unrealizedPnlPct)}
+
+
+
+
+ {formatDateTime(row.openedAt)}
+
+ )
+ })}
+
+
+
+ )
+}
+
+export default TabPositions
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/AgentProfile/index.tsx b/apps/kyberswap-interface/src/pages/CopyTrading/AgentProfile/index.tsx
new file mode 100644
index 0000000000..8d31062574
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/AgentProfile/index.tsx
@@ -0,0 +1,114 @@
+import { type PropsWithChildren } from 'react'
+import { Navigate, useParams } from 'react-router-dom'
+import agentApi from 'services/copyTrading/api/endpoints/agents'
+
+import LocalLoader from 'components/LocalLoader'
+import { HStack, Stack } from 'components/Stack'
+import { APP_PATHS } from 'constants/index'
+import useTab from 'hooks/useTab'
+import AgentInstruction from 'pages/CopyTrading/AgentProfile/AgentInstruction'
+import AgentStats from 'pages/CopyTrading/AgentProfile/AgentStats'
+import TabActions from 'pages/CopyTrading/AgentProfile/TabActions'
+import TabHistory from 'pages/CopyTrading/AgentProfile/TabHistory'
+import TabPositions from 'pages/CopyTrading/AgentProfile/TabPositions'
+import { AgentIdentity } from 'pages/CopyTrading/components/common/agentIdentity'
+import { CopyTradingPage, StickySideColumn } from 'pages/CopyTrading/components/common/layout'
+import { type ProfileTab, profileTabLabel, profileTabs } from 'pages/CopyTrading/constants'
+import { cn } from 'utils/cn'
+
+type AgentProfileTabsProps = PropsWithChildren<{
+ activeTab: ProfileTab
+ onTabChange: (tab: ProfileTab) => void
+}>
+
+const Tabs = ({ activeTab, onTabChange, children }: AgentProfileTabsProps) => {
+ return (
+
+
+
+
+
+ )
+}
+
+const AgentProfile = () => {
+ const { agentCode } = useParams()
+
+ const agentQuery = { agentId: agentCode || '' }
+
+ const {
+ data: agent,
+ isFetching: isAgentFetching,
+ isLoading: isAgentLoading,
+ isUninitialized: isAgentUninitialized,
+ } = agentApi.useGetAgentQuery(agentQuery, {
+ pollingInterval: 10_000,
+ skip: !agentCode,
+ })
+
+ const { activeTab: activeProfileTab, setActiveTab: setActiveProfileTab } = useTab({
+ tabs: profileTabs,
+ defaultTab: 'open-position',
+ queryKey: 'profileTab',
+ })
+
+ const profile = agent?.data
+
+ if (!profile && (isAgentFetching || isAgentLoading || isAgentUninitialized)) {
+ return (
+
+
+ )
+ }
+ if (!profile) return
+
+ {currentProfileTab === 'open-position' &&
+
+ )
+}
+
+export default AgentProfile
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/CopyDetail/CopyDetailTabs.tsx b/apps/kyberswap-interface/src/pages/CopyTrading/CopyDetail/CopyDetailTabs.tsx
new file mode 100644
index 0000000000..48919de17f
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/CopyDetail/CopyDetailTabs.tsx
@@ -0,0 +1,190 @@
+import copyRunApi from 'services/copyTrading/api/endpoints/copyRuns'
+import type { CopyRunSummary } from 'services/copyTrading/types/copyRuns'
+
+import { Center, HStack, Stack } from 'components/Stack'
+import useTab from 'hooks/useTab'
+import { ActionLogsTable } from 'pages/CopyTrading/CopyDetail/tables/ActionLogsTable'
+import { CopyPositionsTable } from 'pages/CopyTrading/CopyDetail/tables/CopyPositionsTable'
+import { TradeHistoryTable } from 'pages/CopyTrading/CopyDetail/tables/TradeHistoryTable'
+import { useInfiniteCursorQuery } from 'pages/CopyTrading/components/InfiniteScroll'
+import { useCopyTradingContext } from 'pages/CopyTrading/context'
+import { formatCount } from 'pages/CopyTrading/helpers'
+import { cn } from 'utils/cn'
+
+const PAGE_SIZE = 10
+
+const copyDetailTabs = ['open-positions', 'closed-positions', 'action-logs'] as const
+const closedCopyDetailTabs = ['closed-positions', 'action-logs'] as const
+
+type CopyDetailTab = (typeof copyDetailTabs)[number]
+
+const copyDetailTabLabels: Record = {
+ 'open-positions': 'Open Positions',
+ 'closed-positions': 'Closed Positions',
+ 'action-logs': 'Action Logs',
+}
+
+type CopyDetailTabsProps = {
+ defaultTab?: CopyDetailTab
+ includeOpenPositions?: boolean
+ run: CopyRunSummary
+}
+
+type CopyRunPanelProps = {
+ enabled?: boolean
+ run: CopyRunSummary
+}
+
+const OpenPositionsPanel = ({ enabled = true, run }: CopyRunPanelProps) => {
+ const { ownerAddress } = useCopyTradingContext()
+ const [getCopyRunPositions] = copyRunApi.useLazyGetCopyRunPositionsQuery()
+ const {
+ infiniteScroll,
+ isFetching,
+ items: positions,
+ } = useInfiniteCursorQuery({
+ enabled: !!ownerAddress && enabled,
+ queryKey: ['copy-trading', 'copy-run-positions', ownerAddress, run.copyRunId, 'open'],
+ queryFn: cursor =>
+ getCopyRunPositions({
+ ownerAddress: ownerAddress || '',
+ copyRunId: run.copyRunId,
+ status: 'open',
+ cursor,
+ limit: 100,
+ }).unwrap(),
+ })
+
+ return (
+ ({
+ tabs,
+ defaultTab,
+ queryKey: 'detailTab',
+ })
+
+ const currentTab = activeTab || defaultTab
+ const keepOpenPositionsLoaded = includeOpenPositions && (run.status === 'active' || run.status === 'closing')
+
+ return (
+
+
+
+
+ {includeOpenPositions && (
+
+ )
+}
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/CopyDetail/CopyRunPerformance.tsx b/apps/kyberswap-interface/src/pages/CopyTrading/CopyDetail/CopyRunPerformance.tsx
new file mode 100644
index 0000000000..0f7176f9a3
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/CopyDetail/CopyRunPerformance.tsx
@@ -0,0 +1,85 @@
+import { useMemo, useState } from 'react'
+import copyRunApi from 'services/copyTrading/api/endpoints/copyRuns'
+import type { CopyRunSummary } from 'services/copyTrading/types/copyRuns'
+import type { PerformanceWindow } from 'services/copyTrading/types/primitives'
+
+import { Stack } from 'components/Stack'
+import {
+ CapitalValueChart,
+ CumulativeRealisedPnlChart,
+ toPerformanceChartPoint,
+} from 'pages/CopyTrading/components/PerformanceCharts'
+import { useCopyTradingContext } from 'pages/CopyTrading/context'
+
+type CopyRunPerformanceProps = {
+ copyRunId: string
+ status: CopyRunSummary['status']
+}
+
+const CopyRunPerformance = ({ copyRunId, status }: CopyRunPerformanceProps) => {
+ const { ownerAddress } = useCopyTradingContext()
+ const [window, setWindow] = useState('30d')
+
+ const isTerminal = status === 'stopped' || status === 'closed'
+ const performanceWindow = isTerminal ? 'all' : window
+ const interval = performanceWindow === 'all' ? 'month' : 'day'
+
+ const {
+ currentData: portfolioPerformance,
+ isError: isPortfolioError,
+ isFetching: isPortfolioFetching,
+ } = copyRunApi.useGetCopyRunPerformanceQuery(
+ {
+ ownerAddress: ownerAddress || '',
+ copyRunId,
+ interval,
+ limit: 100,
+ series: 'portfolio_value',
+ window: performanceWindow,
+ },
+ { pollingInterval: 10_000, skip: !ownerAddress || isTerminal },
+ )
+
+ const {
+ currentData: realizedPnlPerformance,
+ isError: isRealizedPnlError,
+ isFetching: isRealizedPnlFetching,
+ } = copyRunApi.useGetCopyRunPerformanceQuery(
+ {
+ ownerAddress: ownerAddress || '',
+ copyRunId,
+ interval,
+ limit: 100,
+ series: 'cumulative_realized_pnl',
+ window: performanceWindow,
+ },
+ { pollingInterval: 10_000, skip: !ownerAddress },
+ )
+
+ const portfolioData = useMemo(
+ () => (portfolioPerformance?.data || []).map(toPerformanceChartPoint),
+ [portfolioPerformance?.data],
+ )
+
+ const realizedPnlData = useMemo(
+ () => (realizedPnlPerformance?.data || []).map(toPerformanceChartPoint),
+ [realizedPnlPerformance?.data],
+ )
+
+ return (
+
+
+ )
+}
+
+export default CopyRunPerformance
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/CopyDetail/CopySidePanel.tsx b/apps/kyberswap-interface/src/pages/CopyTrading/CopyDetail/CopySidePanel.tsx
new file mode 100644
index 0000000000..e3bd4f4027
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/CopyDetail/CopySidePanel.tsx
@@ -0,0 +1,234 @@
+import { Token as CurrencyToken } from '@kyberswap/ks-sdk-core'
+import { useMemo } from 'react'
+import { CreditCard } from 'react-feather'
+import copyAccountApi from 'services/copyTrading/api/endpoints/copyAccounts'
+import type { AgentProfile, Token } from 'services/copyTrading/types/agents'
+import type { CopyRunSummary, WalletBalanceRow } from 'services/copyTrading/types/copyRuns'
+import type { Metric } from 'services/copyTrading/types/primitives'
+
+import CurrencyLogo from 'components/CurrencyLogo'
+import Loader from 'components/Loader'
+import { Center, HStack, Stack } from 'components/Stack'
+import {
+ AgentRiskCard,
+ StrategyExecutionCard,
+ WhitelistedTokensCard,
+} from 'pages/CopyTrading/components/AgentSidebarCards/AgentProfileCards'
+import { CopyCapitalCard, WithdrawQuoteCard } from 'pages/CopyTrading/components/AgentSidebarCards/CopyActionCards'
+import {
+ SidePanelCard,
+ type SidePanelCardWrapperProps,
+} from 'pages/CopyTrading/components/AgentSidebarCards/SidePanelCard'
+import { copyRunStatusTextClassName } from 'pages/CopyTrading/components/common/status'
+import { formatTokenAmount, formatUsd, getDisplayCapitalInUsd } from 'pages/CopyTrading/helpers'
+import { useCopyTradingModal } from 'pages/CopyTrading/modals/context'
+import { cn } from 'utils/cn'
+import { formatDateTime } from 'utils/time'
+
+type AssetRowProps = {
+ amount?: string
+ chainId: number
+ token?: Token
+ tokenAddress: string
+ valueUsd?: string
+}
+
+const AssetRow = ({ amount, chainId, token, tokenAddress, valueUsd }: AssetRowProps) => {
+ const currency = useMemo(() => {
+ try {
+ return new CurrencyToken(chainId, tokenAddress, token?.decimals ?? 0, token?.symbol, token?.name)
+ } catch {
+ return undefined
+ }
+ }, [chainId, token?.decimals, token?.name, token?.symbol, tokenAddress])
+
+ return (
+
+
+
+ {formatUsd(valueUsd)}
+
+ )
+}
+
+type RemainingInWalletCardProps = SidePanelCardWrapperProps & {
+ assets: WalletBalanceRow[]
+ complete: boolean
+ loading: boolean
+ totalValueUsd?: Metric
+}
+
+const RemainingInWalletCard = ({
+ assets,
+ bodyClassName,
+ collapsible = true,
+ complete,
+ headerRight,
+ initialExpanded = false,
+ loading,
+ title,
+ totalValueUsd,
+ ...sidePanelCardProps
+}: RemainingInWalletCardProps) => {
+ const hasAssets = !!assets.length
+ const hasContent = loading || hasAssets
+ const totalIsRenderable =
+ complete && (totalValueUsd?.status === 'METRIC_STATUS_CURRENT' || totalValueUsd?.status === 'METRIC_STATUS_STALE')
+
+ return (
+
+
+ {formatUsd(totalIsRenderable ? totalValueUsd.value : undefined)}
+
+ {totalIsRenderable && totalValueUsd.status === 'METRIC_STATUS_STALE' && (
+
+ Stale
+
+ )}
+
+ )
+ }
+ initialExpanded={initialExpanded}
+ title={
+ title ?? (
+
+
+ )
+ }
+ >
+ {hasContent && (
+ <>
+ {loading && !hasAssets ? (
+
+
+ ) : (
+ assets.map(asset => (
+
+ )
+}
+
+type CopySidePanelProps = {
+ agent: AgentProfile
+ run: CopyRunSummary
+}
+
+const CopySidePanel = ({ agent, run }: CopySidePanelProps) => {
+ const { openAddCapital, openStopCopy, openWithdrawQuote } = useCopyTradingModal()
+
+ const copyAccountQuery = { chainId: run.chainId, copyAccount: run.copyAccount }
+ const skipCopyAccount = !run.copyAccount || !run.chainId
+ const { data: inventoryResponse, isFetching: isInventoryFetching } =
+ copyAccountApi.useGetCopyAccountWalletInventoryQuery(copyAccountQuery, {
+ pollingInterval: 10_000,
+ skip: skipCopyAccount,
+ })
+
+ const pinnedStableBalance = inventoryResponse?.pinnedStableBalance
+ const quoteBalance =
+ pinnedStableBalance?.status === 'PINNED_STABLE_BALANCE_STATUS_PRESENT' ? pinnedStableBalance.balance : undefined
+
+ const walletAssets = useMemo(
+ () => [
+ ...(quoteBalance ? [quoteBalance] : []),
+ ...(inventoryResponse?.data || []).filter(
+ asset => !quoteBalance || asset.tokenAddress.toLowerCase() !== quoteBalance.tokenAddress.toLowerCase(),
+ ),
+ ],
+ [inventoryResponse?.data, quoteBalance],
+ )
+
+ const inventoryComplete =
+ inventoryResponse?.complete === true && pinnedStableBalance?.status === 'PINNED_STABLE_BALANCE_STATUS_PRESENT'
+ const isTerminal = run.status === 'stopped' || run.status === 'closed'
+
+ const capitalCard = (
+ {formatDateTime(run.stoppedAt)}
+ ) : undefined
+ }
+ stopCopyAvailability={run.stopCopyAvailability}
+ title={
+ run.status === 'stopped' ? (
+
+
+ Stopped Copy
+
+ ) : run.status === 'closed' ? (
+
+
+ Closed Copy
+
+ ) : (
+ 'Current Copying'
+ )
+ }
+ onAddCapital={isTerminal ? undefined : () => openAddCapital(run, agent.displayName)}
+ onStopCopy={isTerminal ? undefined : () => openStopCopy(run, agent.displayName)}
+ />
+ )
+
+ const remainingInWallet = (
+
+ {capitalCard}
+ {remainingInWallet}
+ {run.status === 'stopped' && (
+ openWithdrawQuote(run, run.withdrawQuoteAvailability)}
+ />
+ )}
+
+ )
+ }
+
+ return (
+
+ {capitalCard}
+ {remainingInWallet}
+
+ )
+}
+
+export default CopySidePanel
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/CopyDetail/index.tsx b/apps/kyberswap-interface/src/pages/CopyTrading/CopyDetail/index.tsx
new file mode 100644
index 0000000000..76a9934f8f
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/CopyDetail/index.tsx
@@ -0,0 +1,195 @@
+import { Navigate, useParams } from 'react-router-dom'
+import agentApi from 'services/copyTrading/api/endpoints/agents'
+import copyRunApi from 'services/copyTrading/api/endpoints/copyRuns'
+import type { AgentProfile } from 'services/copyTrading/types/agents'
+import type { CopyRunSummary } from 'services/copyTrading/types/copyRuns'
+
+import LocalLoader from 'components/LocalLoader'
+import { Center, HStack, Stack } from 'components/Stack'
+import { APP_PATHS } from 'constants/index'
+import { CopyDetailTabs } from 'pages/CopyTrading/CopyDetail/CopyDetailTabs'
+import CopyRunPerformance from 'pages/CopyTrading/CopyDetail/CopyRunPerformance'
+import CopySidePanel from 'pages/CopyTrading/CopyDetail/CopySidePanel'
+import Leaderboard, { type LeaderboardStat } from 'pages/CopyTrading/components/Leaderboard'
+import { AgentIdentity } from 'pages/CopyTrading/components/common/agentIdentity'
+import { CopyTradingPage, StickySideColumn } from 'pages/CopyTrading/components/common/layout'
+import { OwnerWalletRequired } from 'pages/CopyTrading/components/common/status'
+import { copyTradingStatIconMap } from 'pages/CopyTrading/constants'
+import { useCopyTradingContext } from 'pages/CopyTrading/context'
+import {
+ formatApproximateUsd,
+ formatUsd,
+ getDisplayCapitalInUsd,
+ getSignedMetricClassName,
+ signedPercent,
+ signedUsd,
+ sumUsdValues,
+} from 'pages/CopyTrading/helpers'
+import { formatDateTime } from 'utils/time'
+
+type CopyDetailContentProps = {
+ agent: AgentProfile
+ backPath: 'my-copies' | 'history'
+ run: CopyRunSummary
+}
+
+const getCopyRunStats = (run: CopyRunSummary): LeaderboardStat[] => {
+ const totalPnlUsd = sumUsdValues(run.realizedPnlUsd, run.unrealizedPnlUsd)
+ const totalPnlStatus =
+ run.metrics.realizedPnlUsd?.status === 'METRIC_STATUS_STALE' ||
+ run.metrics.unrealizedPnlUsd?.status === 'METRIC_STATUS_STALE'
+ ? 'METRIC_STATUS_STALE'
+ : run.metrics.realizedPnlUsd?.status === 'METRIC_STATUS_CURRENT' &&
+ run.metrics.unrealizedPnlUsd?.status === 'METRIC_STATUS_CURRENT'
+ ? 'METRIC_STATUS_CURRENT'
+ : undefined
+
+ return [
+ {
+ label: 'Total P&L',
+ value: signedUsd(totalPnlUsd),
+ valueClassName: getSignedMetricClassName(totalPnlUsd),
+ icon: copyTradingStatIconMap.pnl,
+ status: totalPnlStatus,
+ },
+ {
+ label: 'Realised P&L',
+ value: signedUsd(run.realizedPnlUsd),
+ valueClassName: getSignedMetricClassName(run.realizedPnlUsd),
+ icon: copyTradingStatIconMap.cash,
+ status: run.metrics.realizedPnlUsd?.status,
+ },
+ {
+ label: 'APR Since Copy',
+ value: signedPercent(run.myAprSinceCopyPct),
+ valueClassName: getSignedMetricClassName(run.myAprSinceCopyPct),
+ icon: copyTradingStatIconMap.winRate,
+ status: run.metrics.myAprSinceCopy?.status,
+ },
+ {
+ label: 'Fee Paid',
+ value: formatUsd(run.flatFeesCapturedUsd),
+ icon: copyTradingStatIconMap.volumePrimary,
+ status: run.metrics.flatFeesCapturedUsd?.status,
+ },
+ {
+ label: 'Est. Cashback Pending',
+ value: formatApproximateUsd(run.estimatedCashbackPendingUsd),
+ icon: copyTradingStatIconMap.moneyPrimary,
+ status: run.metrics.estimatedCashbackPendingUsd?.status,
+ },
+ ]
+}
+
+const CopyRunStats = ({ run }: { run: CopyRunSummary }) =>
+
+
+ Started Copy
+
+
+ {formatDateTime(run.startedAt)}
+ In: {formatUsd(getDisplayCapitalInUsd(run))}
+
+
+
+
+
+ {formatDateTime(run.stoppedAt)}
+ Out: {formatUsd(run.capitalOutUsd)}
+
+ Stopped Copy
+
+
+ )
+}
+
+const CopyDetailContent = ({ agent, backPath, run }: CopyDetailContentProps) => {
+ if (run.status === 'closed') {
+ return (
+ <>
+
+
+ )
+ }
+
+ if ((!run || !profile) && (isFetching || isLoading || isUninitialized || isAgentFetching || isAgentLoading)) {
+ return (
+
+
+ )
+ }
+ if (!run || !profile) return
+
+ )
+}
+
+export default CopyDetailView
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/CopyDetail/tables/ActionLogsTable.tsx b/apps/kyberswap-interface/src/pages/CopyTrading/CopyDetail/tables/ActionLogsTable.tsx
new file mode 100644
index 0000000000..45ac39d297
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/CopyDetail/tables/ActionLogsTable.tsx
@@ -0,0 +1,74 @@
+import type { HTMLAttributes } from 'react'
+import type { ActivityRow } from 'services/copyTrading/types/copyRuns'
+
+import { Stack } from 'components/Stack'
+import InfiniteScroll, { type InfiniteScrollState } from 'pages/CopyTrading/components/InfiniteScroll'
+import { HeaderCell, TableBody, TableCell, TableHeader, TableRow } from 'pages/CopyTrading/components/Table'
+import { ShortenedId } from 'pages/CopyTrading/components/common/layout'
+import { getActivityLabel } from 'pages/CopyTrading/helpers'
+import { cn } from 'utils/cn'
+import { formatDateTime } from 'utils/time'
+
+type TableGridWrapperProps = HTMLAttributes & {
+ header?: boolean
+}
+
+const ActivityGrid = ({ header, className, ...props }: TableGridWrapperProps) => {
+ const Grid = header ? TableHeader : TableRow
+
+ return (
+
+
+
+ Trade ID
+ Type
+ Details
+ Tx Hash
+ Time
+
+
+ {rows.map(row => (
+
+
+
+ {getActivityLabel(row)}
+ {row.summary || '—'}
+
+
+ {formatDateTime(row.occurredAt)}
+
+ ))}
+
+
+
+ )
+}
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/CopyDetail/tables/CopyPositionsTable.tsx b/apps/kyberswap-interface/src/pages/CopyTrading/CopyDetail/tables/CopyPositionsTable.tsx
new file mode 100644
index 0000000000..f2bfc78567
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/CopyDetail/tables/CopyPositionsTable.tsx
@@ -0,0 +1,133 @@
+import type { HTMLAttributes } from 'react'
+import type { PositionActionKind, PositionSummary } from 'services/copyTrading/types/positions'
+
+import { ButtonLight } from 'components/Button'
+import { Stack } from 'components/Stack'
+import InfiniteScroll, { type InfiniteScrollState } from 'pages/CopyTrading/components/InfiniteScroll'
+import { HeaderCell, TableBody, TableCell, TableHeader, TableRow } from 'pages/CopyTrading/components/Table'
+import { ShortenedId } from 'pages/CopyTrading/components/common/layout'
+import { PositionLifecycleBadge } from 'pages/CopyTrading/components/common/status'
+import { copyTradingStatIconMap } from 'pages/CopyTrading/constants'
+import {
+ formatApproximateUsd,
+ formatUsd,
+ getSignedMetricClassName,
+ signedPercent,
+ signedUsd,
+} from 'pages/CopyTrading/helpers'
+import { useCopyTradingModal } from 'pages/CopyTrading/modals/context'
+import { cn } from 'utils/cn'
+import { formatDateTime } from 'utils/time'
+
+type TableGridWrapperProps = HTMLAttributes & {
+ header?: boolean
+}
+
+type PositionTableProps = {
+ infiniteScroll: InfiniteScrollState
+ loading?: boolean
+ rows: PositionSummary[]
+}
+
+const actionLabels: Partial> = {
+ POSITION_ACTION_KIND_MANUAL_SELL: 'Manual Sell',
+ POSITION_ACTION_KIND_CLOSE_POSITION: 'Close position',
+}
+
+const PositionAction = ({ position }: { position: PositionSummary }) => {
+ const { openManagePosition } = useCopyTradingModal()
+ const availableAction =
+ position.actionKind && position.actionKind !== 'POSITION_ACTION_KIND_UNSPECIFIED'
+ ? position.actionKind
+ : position.availableActionKinds.find(kind => kind !== 'POSITION_ACTION_KIND_UNSPECIFIED')
+ const label = availableAction && actionLabels[availableAction]
+ if (!label) return null
+
+ const isClose = availableAction === 'POSITION_ACTION_KIND_CLOSE_POSITION'
+
+ return (
+ {
+ event.stopPropagation()
+ openManagePosition(position, isClose ? 'close' : 'sell')
+ }}
+ >
+ {label}
+
+ )
+}
+
+const CopyPositionsGrid = ({ header, className, ...props }: TableGridWrapperProps) => {
+ const Grid = header ? TableHeader : TableRow
+
+ return (
+
+
+
+ Trade ID
+ Token
+ Entry Price
+ Current
+ Value
+ Unrealised P&L
+ Est. Rebate
+ Open Since
+ Status
+ Action
+
+
+ {rows.map(row => {
+ return (
+
+
+
+ {row.token.symbol || '—'}
+ {formatUsd(row.entryPriceUsd)}
+ {formatUsd(row.currentPriceUsd)}
+ {formatUsd(row.valueUsd)}
+
+
+ {signedUsd(row.unrealizedPnlUsd)}
+ {signedPercent(row.unrealizedPnlPct)}
+
+
+ {formatApproximateUsd(row.estimatedCashbackUsd)}
+ {formatDateTime(row.openedAt)}
+
+
+
+
+
+ )
+ })}
+
+
+
+ )
+}
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/CopyDetail/tables/TradeHistoryTable.tsx b/apps/kyberswap-interface/src/pages/CopyTrading/CopyDetail/tables/TradeHistoryTable.tsx
new file mode 100644
index 0000000000..c252b00367
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/CopyDetail/tables/TradeHistoryTable.tsx
@@ -0,0 +1,111 @@
+import type { HTMLAttributes } from 'react'
+import type { PositionSummary } from 'services/copyTrading/types/positions'
+
+import { Stack } from 'components/Stack'
+import InfiniteScroll, { type InfiniteScrollState } from 'pages/CopyTrading/components/InfiniteScroll'
+import { HeaderCell, TableBody, TableCell, TableHeader, TableRow } from 'pages/CopyTrading/components/Table'
+import { ShortenedId } from 'pages/CopyTrading/components/common/layout'
+import { copyTradingStatIconMap } from 'pages/CopyTrading/constants'
+import { formatUsd, getSignedMetricClassName, signedUsd } from 'pages/CopyTrading/helpers'
+import { cn } from 'utils/cn'
+import { formatDateTime } from 'utils/time'
+
+type TableGridWrapperProps = HTMLAttributes & {
+ header?: boolean
+}
+
+type PositionTableProps = {
+ infiniteScroll: InfiniteScrollState
+ loading?: boolean
+ rows: PositionSummary[]
+}
+
+const formatDuration = (durationSeconds?: string, openedAt?: string, closedAt?: string) => {
+ const apiDuration = Number(durationSeconds)
+ if (durationSeconds !== undefined && Number.isFinite(apiDuration)) {
+ const totalMinutes = Math.max(0, Math.floor(apiDuration / 60))
+ const hours = Math.floor(totalMinutes / 60)
+ const minutes = totalMinutes % 60
+
+ return hours ? hours + 'h ' + minutes + 'm' : minutes + 'm'
+ }
+
+ if (!openedAt || !closedAt) return '-'
+
+ const durationMs = new Date(closedAt).getTime() - new Date(openedAt).getTime()
+ if (Number.isNaN(durationMs)) return '-'
+
+ const totalMinutes = Math.max(0, Math.floor(durationMs / 60_000))
+ const hours = Math.floor(totalMinutes / 60)
+ const minutes = totalMinutes % 60
+
+ return hours ? hours + 'h ' + minutes + 'm' : minutes + 'm'
+}
+
+const TradeHistoryGrid = ({ header, className, ...props }: TableGridWrapperProps) => {
+ const Grid = header ? TableHeader : TableRow
+
+ return (
+
+
+
+ Trade ID
+ Token
+ Entry Price
+ Exit
+ P&L
+ Fee
+ Rebate
+ Net Cost
+ Opened
+ Closed
+ Duration
+
+
+ {rows.map(row => {
+ return (
+
+
+
+ {row.token.symbol || '—'}
+ {formatUsd(row.entryPriceUsd)}
+ {formatUsd(row.exitPriceUsd || row.currentPriceUsd)}
+
+ {signedUsd(row.realizedPnlUsd)}
+
+ {formatUsd(row.flatFeeCapturedUsd)}
+ {formatUsd(row.cashbackReceivedUsd)}
+ {formatUsd(row.netFeeCostUsd)}
+ {formatDateTime(row.openedAt)}
+ {formatDateTime(row.closedAt)}
+
+ {formatDuration(row.durationSeconds, row.openedAt, row.closedAt)}
+
+
+ )
+ })}
+
+
+
+ )
+}
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/CopyHistory/ClosedSubscriptionsTable.tsx b/apps/kyberswap-interface/src/pages/CopyTrading/CopyHistory/ClosedSubscriptionsTable.tsx
new file mode 100644
index 0000000000..d75eaded34
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/CopyHistory/ClosedSubscriptionsTable.tsx
@@ -0,0 +1,110 @@
+import { type HTMLAttributes } from 'react'
+import type { CopyRunSummary } from 'services/copyTrading/types/copyRuns'
+
+import { Stack } from 'components/Stack'
+import CursorPagination, { type CursorPaginationState } from 'pages/CopyTrading/components/CursorPagination'
+import { HeaderCell, TableBody, TableCell, TableHeader, TableRow } from 'pages/CopyTrading/components/Table'
+import { CopyRunAgentCell } from 'pages/CopyTrading/components/common/agentIdentity'
+import { copyTradingStatIconMap } from 'pages/CopyTrading/constants'
+import {
+ formatCount,
+ formatUsd,
+ getDisplayCapitalInUsd,
+ getSignedMetricClassName,
+ signedUsd,
+} from 'pages/CopyTrading/helpers'
+import { cn } from 'utils/cn'
+import { formatDateTime } from 'utils/time'
+
+type ClosedSubscriptionsGridProps = HTMLAttributes & {
+ header?: boolean
+}
+
+const ClosedSubscriptionsGrid = ({ header, className, ...props }: ClosedSubscriptionsGridProps) => {
+ const Grid = header ? TableHeader : TableRow
+
+ return (
+
+
+ )
+}
+
+export default ClosedSubscriptionsTable
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/CopyHistory/index.tsx b/apps/kyberswap-interface/src/pages/CopyTrading/CopyHistory/index.tsx
new file mode 100644
index 0000000000..e8b3f7454b
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/CopyHistory/index.tsx
@@ -0,0 +1,93 @@
+import { useNavigate } from 'react-router-dom'
+import copyRunApi from 'services/copyTrading/api/endpoints/copyRuns'
+import type { OwnerCopySummary } from 'services/copyTrading/types/copyRuns'
+
+import { APP_PATHS } from 'constants/index'
+import useIsWalletRestoring from 'hooks/useIsWalletRestoring'
+import ClosedSubscriptionsTable from 'pages/CopyTrading/CopyHistory/ClosedSubscriptionsTable'
+import CopyRunsPageHeading from 'pages/CopyTrading/components/CopyRunsPageHeading'
+import { useCursorPageQuery } from 'pages/CopyTrading/components/CursorPagination'
+import Leaderboard, { type LeaderboardStat } from 'pages/CopyTrading/components/Leaderboard'
+import { CopyTradingPage } from 'pages/CopyTrading/components/common/layout'
+import { OwnerWalletRequired } from 'pages/CopyTrading/components/common/status'
+import { copyTradingStatIconMap } from 'pages/CopyTrading/constants'
+import { useCopyTradingContext } from 'pages/CopyTrading/context'
+import { formatCount, formatUsd, getSignedMetricClassName, signedUsd } from 'pages/CopyTrading/helpers'
+
+const PAGE_SIZE = 5
+
+const CopyHistorySummary = ({ summary }: { summary?: OwnerCopySummary }) => {
+ const historyStats: LeaderboardStat[] = [
+ {
+ label: 'Realised P&L (All time)',
+ value: signedUsd(summary?.realizedPnlUsd),
+ valueClassName: getSignedMetricClassName(summary?.realizedPnlUsd),
+ icon: copyTradingStatIconMap.money,
+ status: summary?.metrics.realizedPnlUsd?.status,
+ },
+ {
+ label: 'Closed Capital (Returned)',
+ value: formatUsd(summary?.closedCapitalUsd),
+ icon: copyTradingStatIconMap.volume,
+ status: summary?.metrics.closedCapitalUsd?.status,
+ },
+ {
+ label: 'Closed Positions',
+ value: formatCount(summary?.closedPositions),
+ icon: copyTradingStatIconMap.positionClose,
+ status: summary?.metrics.closedPositionCount?.status,
+ },
+ ]
+
+ return
+ navigate(`${APP_PATHS.COPY_TRADING}/history/${subscription.copyRunId}`)}
+ />
+
+ )}
+
+ )
+}
+
+export default CopyHistoryView
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/Docs/FE_API_Catalog.md b/apps/kyberswap-interface/src/pages/CopyTrading/Docs/FE_API_Catalog.md
new file mode 100644
index 0000000000..ae749b0bf2
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/Docs/FE_API_Catalog.md
@@ -0,0 +1,2131 @@
+# Copy Trade API — Frontend Integration Catalog
+
+This document describes the public HTTPS/JSON contract used by frontend
+applications. It intentionally excludes service architecture, storage, and
+deployment details. Use each changelog entry's status instead of assuming the
+newest documented behavior is already merged or deployed.
+
+## Changelog
+
+### 2026-08-14 — Pending release: grouped agent action logs
+
+Status: implemented on `hung/action-log-group-filter`; not merged or deployed.
+
+- Changes `GET /agents/{agentId}/action-logs` so `data[]` always contains
+ session groups with `sessionId` and `logs[]`, rather than flat action logs.
+- Adds exact action filtering through `type` and explicit session grouping
+ through `groupBy`. Omitted `groupBy` defaults to session grouping.
+- Changes `limit` to count whole session groups. Cursor pages never split one
+ session.
+
+Frontend migration: read each `data[]` item as an
+`AgentActionLogSessionGroup` and render its nested `logs[]`. Do not continue
+decoding `data[]` as flat `AgentActionLog` objects.
+
+### 2026-08-13 — Pending release: stateless Manual Sell and Close Position
+
+Status: operator support merged in
+[`copy-trade-operator` PR #94](https://github.com/KyberNetwork/copy-trade-operator/pull/94)
+at `eb814dbb2f77bc73add3e1b407bbdb4285e4c729`; aggregate API support is in
+[`copy-trade-api` PR #24](https://github.com/KyberNetwork/copy-trade-api/pull/24).
+The coordinated release is not yet deployed.
+
+- Removes `POST /wallet-session-challenges` and `POST /wallet-sessions`.
+- Removes wallet-session bearer authentication from Manual Sell and Close
+ Position preparation.
+- Removes the Redis-backed session store and final-issuance lease. Repeated
+ preparation requests are allowed and each response must be treated as a
+ short-lived snapshot.
+- Reduces the public HTTP surface from 34 to **32 operations**: 26 GET reads
+ and six transaction-preparation POSTs.
+- Does not weaken chain execution authorization. The owner wallet still submits
+ the returned call; the follower-account contract enforces the owner/admin
+ caller, while the operator-produced KS-signer payload remains bound to the
+ account, chain, position, current unsold balance, route, minimum output, and
+ deadline.
+- Removes the action-specific Redis requirement. Redis is still required when
+ selected as the API cache backend.
+
+Frontend migration:
+
+1. Delete the challenge, signature-exchange, bearer-token, expiry, and refresh
+ steps from Manual Sell and Close Position dialogs.
+2. Call the preparation route directly after refreshing its authoritative read
+ inputs.
+3. Keep `to`, `data`, and `valueRaw` unchanged and submit them from the owner
+ wallet. A preparation response is not authority to execute from another
+ wallet.
+4. Discard stale or superseded preparations. Multiple preparations can be
+ returned, but a state-changing transaction makes competing payloads stale.
+
+Rollout order: deploy and drain the new aggregate API before removing the
+operator wallet-proof RPC. The new API remains compatible with an older
+operator; an older API cannot create sessions after the proof RPC is removed.
+
+### 2026-08-13 — Merged on `origin/main`
+
+Baseline verified against `origin/main` commit
+`1b0d9e27b60dc02e960f4557232727c50dcf724b`, the checked-in protobuf
+sources, and the generated OpenAPI document. That revision pins
+`copy-trade-operator` at
+`v0.0.0-20260813084007-e8a0e0149d68` for the read/action contract.
+
+The following frontend-visible semantics are merged on `origin/main`; source
+status does not by itself prove that a particular environment is running the
+same image.
+
+| Surface | Merged contract | Required FE behavior |
+| --- | --- | --- |
+| Explicit Start funding intent | `PrepareStartCopyRequest.fundingMode` is required and is either `START_COPY_FUNDING_MODE_UNFUNDED` or `START_COPY_FUNDING_MODE_FUNDED`. `createPermitData` is optional only for funded mode and is never echoed publicly. | Choose the mode explicitly for each attempt, keep it stable with the same `startRequestId`, and never infer the mode from the presence of permit bytes. |
+| Start Copy onboarding | `START_COPY_STAGE_CREATE_CONFIRMING` is implemented. It is returned with `PREPARED_ACTION_STATUS_PENDING`, `PREPARED_ACTION_REASON_SOURCE_COVERAGE_PENDING`, the predicted `copyAccount`, and no call. | Keep polling with the same `startRequestId` and target. Do not resubmit the create call and do not fund until `START_COPY_STAGE_FUNDING_REQUIRED`. |
+| Capital In | `CopyRunSummary.capitalInProjectionStatus` is implemented with `SYNCING`, `READY`, and `UNAVAILABLE`. | Render `capitalInUsd` only when the projection status is `READY`. A visible funding transaction does not make a provisional aggregate value authoritative. |
+| Account-effective cashback policy | `GET /users/{ownerAddress}/copy-runs/{copyRunId}/cashback-policy` returns the operator-authored policy for that exact follower account, including typed status, optional rates, scope, provenance times, and optional formula version. | Fetch it lazily for a selected run's fee/cashback panel. Branch on `status`; do not substitute an agent-level advertised rate, infer missing rates as zero, or hard-code a formula version. |
+| Pinned stable balance | The current-stable materializer reads exact quote-token balances from the operator at one canonical block anchor. A present row can use `balanceSource = "onchain_rpc"`; exact zero remains present. | Trust the row only when `pinnedStableBalance.status` is `PRESENT`. Preserve all other typed states as unavailable rather than converting them to zero. |
+| Current wallet inventory | `GET /copy-accounts/{chainId}/{copyAccount}/wallet-inventory` returns bounded current wallet rows and an account-wide `walletInventoryValueUsd` only when the source proves the response is complete and every nonzero asset is valued. | Use this route for **Remaining in Wallet** on active and stopped copy runs. Never calculate the total from `/balances` pages or add the pinned stable row to the server total. |
+| Action-log chain links | Valid mixed-case EVM addresses and hashes are canonicalized to lowercase. Invalid optional linkage claims are discarded while a safe narrative row remains renderable. | Treat `txHash`, `leaderPositionId`, `blockNumber`, and `tokenAddress` as optional links. Their absence is not an action failure and must not be reconstructed from narrative text. |
+| Copy lifecycle views | `OPEN` contains admitted runs with status `COPY_RUN_STATUS_ACTIVE` or `COPY_RUN_STATUS_CLOSING`. `HISTORY` contains admitted or readable historical-generation runs with status `COPY_RUN_STATUS_STOPPED` or `COPY_RUN_STATUS_CLOSED`. Position history is a separate universe. | Refresh from the server after lifecycle changes; do not pin local tab membership or derive it from position counts. Use owner position routes for owner-wide closed-trade history. |
+| Historical-generation compatibility | Parentless child facts explicitly classified `HISTORICAL` by the operator are consumed without creating current/actionable projections. Missing `ADMITTED` or `QUARANTINED` parent identity still fails closed. | Historical or unavailable data must not be promoted into current dashboards or actions. Preserve typed unavailable states and direct/History reads; never infer missing values as zero. |
+| Public HTTP surface | All 26 reads and six preparations have generated gateway mappings and concrete aggregate handlers. The two wallet-session operations remain only in the merged baseline and are removed by the pending entry above. | Do not feature-gate a remaining route as unimplemented. Treat typed product statuses separately from HTTP availability. |
+
+### 2026-08-12 — Verified pre-release read smoke
+
+`GET /chains`, `GET /agents?limit=1`, and `GET /docs/` were reachable in
+pre-release. See [Current Availability and Verification Status](#current-availability-and-verification-status)
+for the exact observations and limitations.
+
+### 2026-07-30 — Historical pre-release action smoke
+
+This evidence predates required Start funding intent and the pending removal
+of wallet sessions. It is retained only as historical deployment evidence; do
+not use it as the current payload or authentication contract.
+
+## API Endpoint
+
+Pre-release origin:
+
+```text
+https://pre-copy-trade-api.kyberengineering.io
+```
+
+API base path:
+
+```text
+https://pre-copy-trade-api.kyberengineering.io/api/v1
+```
+
+## Frontend Contract Notes
+
+The merged baseline and pending release add the following UI-facing behavior.
+Apply each row according to the environment status in the changelog, and update
+all affected action dialogs and Smart Wallet activity rendering together.
+
+| Surface | Contract | Required FE behavior |
+| --- | --- | --- |
+| Manual Sell / Close Position preparation | No wallet challenge, session exchange, bearer token, or issuance lease in the pending contract | Prepare directly from the latest authoritative read inputs. The owner wallet must still submit the exact returned call; preparation is not transaction authorization. |
+| Start Copy funding | `fundingMode` plus optional `createPermitData` | Send `START_COPY_FUNDING_MODE_UNFUNDED` with no permit, or `START_COPY_FUNDING_MODE_FUNDED` with an optional protobuf-JSON base64 byte string. The API uses `targetCapitalRaw` as the funded create amount. Permit format/capability remains operator-authoritative. |
+| Contract-generation routing | No public `generationId`, factory, controller, or contract-address request field | Do not hard-code or select deployment addresses. Start uses the currently create-enabled operator generation; existing-account actions derive generation from persisted account identity. Render `PREPARED_ACTION_REASON_UNSUPPORTED_ACCOUNT_GENERATION` as non-actionable product state. |
+| Copy-run cashback policy | `GET .../cashback-policy` | Use this run/account-specific policy for detailed fee/cashback presentation. `COPY_RUN_CASHBACK_POLICY_STATUS_AVAILABLE`, `..._NOT_CONFIGURED`, `..._INVALIDATED`, and `..._UNAVAILABLE` are distinct states; missing optional rates or `cashbackFormulaVersion` are not zero. |
+| Prepared Smart Wallet identity | `PreparedAction.copyAccount` | For every non-Start action, require it to equal the selected Smart Wallet. It is absent only for Start Copy creation; Start confirming, funding, and completion must equal `startCopy.predictedCopyAccount`. Do not confuse it with `call.to` or `expectedAccount`. |
+| Manual Sell / Close Position quote | `data.manualSell.swapQuote` or `data.closePosition.swapQuote` | Display `expectedQuote`, `minimumQuote`, and optional `effectiveSlippageBps`. Preserve metric status; unavailable is not zero. |
+| Stop Copy per-position quote | `data.stopCopy.positions[].swapQuote` | Render the expected/minimum quote for each selected position. These values belong only to the returned preparation. |
+| Stop Copy total quote | `data.stopCopy.totalSwapQuote` | Render total expected/minimum quote. There is intentionally no aggregate `effectiveSlippageBps`; do not average per-position slippage. |
+| Generic owner sell history | `position.actionType = "sell_unaligned"` and `PositionSummary.exitKind = POSITION_EXIT_KIND_UNSPECIFIED` | Label it **Owner Sell**. Do not infer Manual Sell or Close Position from sold amount, remaining amount, lifecycle, skipped obligations, or calldata shape. |
+| Stop Copy activity | One `ACTIVITY_TYPE_COPY_STOPPED` lifecycle row plus independent downstream position/execution rows | Render Stop Copy as an amount-less lifecycle row. Render each token-specific reduction, closure, or exit separately; do not attach one arbitrary token/amount/value to the lifecycle row. |
+
+All quote-preview values expire with their parent preparation at
+`reprepareAfter` (and, when present, `liquidationConfigDeadline`). They are not
+a quote cache. After expiry or a relevant state change, discard the response
+and prepare again.
+
+## Contract Authority and Naming
+
+This catalog is an integration guide. The machine-readable contract remains:
+
+- [`aggregate_read.proto`](../proto/aggregate/v1/aggregate_read.proto) for
+ read routes, enums, request validation, and response models.
+- [`aggregate_action.proto`](../proto/aggregate/v1/aggregate_action.proto) for
+ transaction preparation.
+- [`aggregate.swagger.yaml`](../proto/gen/openapi/aggregate/v1/aggregate.swagger.yaml)
+ for the generated HTTP/OpenAPI surface.
+
+HTTP JSON and query strings use lower-camel-case names:
+
+```text
+chainId
+ownerAddress
+sortBy
+sortOrder
+startRequestId
+```
+
+Use the symbolic enum names shown in this document, not their numeric protobuf
+values. Unknown enum values must be handled as unsupported data rather than
+silently mapped to another state.
+
+## Screen-to-API Map
+
+This is the recommended UI integration map. “Initial” calls are needed to
+render the main screen. “Lazy” calls should be issued only when the relevant
+tab, chart, drawer, or drilldown is opened.
+
+| Screen or UI region | Initial APIs | Lazy or drilldown APIs | Action APIs |
+| --- | --- | --- | --- |
+| App bootstrap / network selector | `GET /chains` | None | None |
+| Explore / leaderboard header | `GET /leaderboard/summary` | None | None |
+| Leaderboard table | `GET /leaderboard` | Load the next cursor page | `POST /users/{ownerAddress}/agents/{agentId}:prepareStartCopy` |
+| Agent discovery/search | `GET /agents` | Load the next cursor page | `POST /users/{ownerAddress}/agents/{agentId}:prepareStartCopy` |
+| Agent profile header and KPI cards | `GET /agents/{agentId}`, optionally `GET /agents/{agentId}/stats` | None | `POST /users/{ownerAddress}/agents/{agentId}:prepareStartCopy` |
+| Agent performance chart | `GET /agents/{agentId}/performance` | Additional cursor pages or a new request when series/window changes | None |
+| Agent action-log tab | `GET /agents/{agentId}/action-logs` | Filter by leader position, action `type`, or time range; group by `sessionId`; load the next cursor page | None |
+| Agent open/history positions tab | `GET /agents/{agentId}/positions` | `GET /agents/{agentId}/positions/{positionId}` and `/events` when a row is opened | None |
+| My Copies — Open summary | `GET /users/{ownerAddress}/copy-summary?view=OWNER_COPY_VIEW_OPEN` | None | None |
+| My Copies — Open rows | `GET /users/{ownerAddress}/copy-runs?view=OWNER_COPY_VIEW_OPEN` | Load the next cursor page; selected-run detail and positions | Prepare Add Capital, Stop Copy, or Withdraw Quote from the selected run |
+| History — stopped-run summary | `GET /users/{ownerAddress}/copy-summary?view=OWNER_COPY_VIEW_HISTORY` | None | None |
+| History — stopped-run list | `GET /users/{ownerAddress}/copy-runs?view=OWNER_COPY_VIEW_HISTORY` | Load the next cursor page | Prepare Withdraw Quote when advisory availability allows it |
+| History — all closed positions/trades | `GET /users/{ownerAddress}/positions?view=POSITION_VIEW_CLOSED` | Filter by agent/chain, paginate, or group rows by `copyRunId` | None for an already closed position |
+| History — selected stopped run | `GET /users/{ownerAddress}/copy-runs/{copyRunId}` and `GET .../positions?view=POSITION_VIEW_CLOSED` | `GET .../performance`; `GET .../cashback-policy` when the fee panel opens; owner activity filtered by `copyRunId` | Prepare Withdraw Quote only when advertised; historical-generation rows remain non-actionable |
+| Copy-run detail | `GET /users/{ownerAddress}/copy-runs/{copyRunId}` and `GET .../positions` | `GET .../performance`; `GET .../cashback-policy` when fee/cashback detail is visible; owner activity filtered by `copyRunId` | Prepare Add Capital, Stop Copy, Withdraw Quote, Manual Sell, or Close Position as applicable |
+| All owner positions | `GET /users/{ownerAddress}/positions` | Filter by agent, chain, view, or sort; load the next cursor page | Prepare Manual Sell or Close Position when advertised |
+| Leftover positions | Owner or copy-run positions with `view=POSITION_VIEW_LEFTOVER` | Copy-account drilldown and pending-sell obligations | Manual Sell or Close Position when advertised |
+| Owner activity feed | `GET /users/{ownerAddress}/activity` | Filter by `copyRunId`, `chainId`, exact `type`, or product `group` | None |
+| Owner copy-account list | `GET /users/{ownerAddress}/copy-accounts` | Load the next cursor page | None |
+| Copy-account overview | `GET /copy-accounts/{chainId}/{copyAccount}` | Balances, positions, and history routes below | Prepare Add Capital, Stop Copy, or Withdraw Quote through the associated copy run |
+| Copy Details — Remaining in Wallet | `GET /copy-accounts/{chainId}/{copyAccount}/wallet-inventory` | Use `/balances` only for a separately paginated asset explorer | None |
+| Copy-account balances | `GET /copy-accounts/{chainId}/{copyAccount}/balances` | Load the next cursor page | None |
+| Copy-account positions | `GET /copy-accounts/{chainId}/{copyAccount}/positions` | Pending-sell obligations for a selected `userPositionId` | Manual Sell or Close Position |
+| Copy-account history | `GET /copy-accounts/{chainId}/{copyAccount}/history` | Filter by exact `type` or product `group` | None |
+| Skipped-sell recovery drawer | Position row plus `GET .../pending-sell-obligations` | Refresh the FIFO immediately before preparation | Prepare Manual Sell or Close Position directly, then submit from the owner wallet |
+
+### Critical History Scope Rule
+
+Copy-run lifecycle and position lifecycle are independent:
+
+- `OWNER_COPY_VIEW_HISTORY` returns terminal copy runs. A stopped run can have
+ zero closed positions.
+- `POSITION_VIEW_CLOSED` returns closed positions. A still-active copy run can
+ already contain many closed positions.
+
+Therefore the page-level **Closed Positions** or **Trade History** table must
+call:
+
+```text
+GET /users/{ownerAddress}/positions?view=POSITION_VIEW_CLOSED&limit=25
+```
+
+Do not build that table by first fetching
+`copy-runs?view=OWNER_COPY_VIEW_HISTORY` and then fetching positions only for
+those runs. That excludes closed positions belonging to active runs. Use the
+run-scoped positions route only after the user selects a specific copy run; an
+empty run-scoped response is valid for a stopped run that never completed a
+trade. For the closed positions of one specific follower account, use:
+
+```text
+GET /copy-accounts/{chainId}/{copyAccount}/positions?view=POSITION_VIEW_CLOSED&limit=25
+```
+
+The History-view copy summary is scoped the same way as the stopped-run list.
+Its `closedPositionCount` means “closed positions in terminal copy runs,” not
+“all closed positions owned by this wallet.” Do not label that value as an
+owner-wide closed-trade total. The current owner-wide positions list does not
+return a total count; if the UI requires an exact all-pages total, that needs a
+separate API contract rather than counting the first page or reusing the
+History-view summary.
+
+### Action Screen Map
+
+All six preparation routes are implemented in the source baseline. Preparation
+is read-only with respect to the chain: the frontend must submit the returned
+wallet call. Environment availability still depends on the deployed image and
+its operator dependencies.
+
+| UI action | Read before enabling the control | Preparation route |
+| --- | --- | --- |
+| Start Copy | Agent card/profile `startCopyAvailability`; refresh the direct agent profile when opening the modal | `POST /users/{ownerAddress}/agents/{agentId}:prepareStartCopy` |
+| Add Capital | Direct copy-run or copy-account detail and `addCapitalAvailability` | `POST /users/{ownerAddress}/copy-runs/{copyRunId}:prepareAddCapital` |
+| Stop Copy | Direct copy-run detail plus its current open/leftover position selection and `stopCopyAvailability` | `POST /users/{ownerAddress}/copy-runs/{copyRunId}:prepareStopCopy` |
+| Withdraw Quote | Direct copy-run/copy-account detail and `withdrawQuoteAvailability` | `POST /users/{ownerAddress}/copy-runs/{copyRunId}:prepareWithdrawQuote` |
+| Manual Sell | Current position plus the latest pending-sell-obligation FIFO | `POST /users/{ownerAddress}/copy-runs/{copyRunId}/positions/{userPositionId}:prepareManualSell` |
+| Close Position | Current position and its advertised `availableActionKinds` | `POST /users/{ownerAddress}/copy-runs/{copyRunId}/positions/{userPositionId}:prepareClosePosition` |
+
+Advisory availability controls presentation only. Always call the matching
+preparation route when the user confirms, and branch on its typed
+`status`/`reason`. A `PENDING`, `COMPLETED`, or `UNAVAILABLE` preparation is a
+successful API response describing current product state; it does not mean the
+route is missing.
+
+### Screen Fetch Guidance
+
+- Calls at the same screen level can be made in parallel. For example, Open
+ Copies summary and rows do not depend on each other.
+- Do not issue one `GET /agents/{agentId}` per leaderboard or copy-run row.
+ `AgentCard` and `agentSnapshot` already contain the row-level display data.
+- Use the direct detail endpoint when a user opens a row. Do not treat a cached
+ list row as authoritative transaction state.
+- Start a new cursor sequence when a filter, sort field, sort order, owner,
+ agent, chain, view, or route changes.
+- After a submitted transaction confirms, poll the relevant detail/list reads
+ until their source metadata and lifecycle reflect the receipt. Then prepare
+ the next stage, if any. Do not locally predict aggregate state.
+
+Common screen requests:
+
+```text
+# Base leaderboard, highest APR first
+GET /leaderboard?chainId=8453&sortBy=LEADERBOARD_SORT_FIELD_APR_30D&sortOrder=SORT_ORDER_DESC&limit=25
+
+# Agent 30-day daily portfolio-equity chart
+GET /agents/{agentId}/performance?series=PERFORMANCE_SERIES_PORTFOLIO_EQUITY&window=WINDOW_30D&interval=PERFORMANCE_INTERVAL_DAY&limit=100
+
+# My Copies open tab
+GET /users/{ownerAddress}/copy-summary?view=OWNER_COPY_VIEW_OPEN
+GET /users/{ownerAddress}/copy-runs?view=OWNER_COPY_VIEW_OPEN&limit=25
+
+# My Copies history tab
+GET /users/{ownerAddress}/copy-summary?view=OWNER_COPY_VIEW_HISTORY
+GET /users/{ownerAddress}/copy-runs?view=OWNER_COPY_VIEW_HISTORY&limit=25
+
+# Page-level closed-position history, including positions from active runs
+GET /users/{ownerAddress}/positions?view=POSITION_VIEW_CLOSED&limit=25
+
+# Copy-run open positions
+GET /users/{ownerAddress}/copy-runs/{copyRunId}/positions?view=POSITION_VIEW_OPEN&limit=25
+
+# Closed positions inside one selected copy run only
+GET /users/{ownerAddress}/copy-runs/{copyRunId}/positions?view=POSITION_VIEW_CLOSED&limit=25
+
+# Owner skipped-activity group
+GET /users/{ownerAddress}/activity?group=ACTIVITY_GROUP_SKIPPED&limit=25
+```
+
+## Quick Start
+
+Public read requests do not require an API key.
+
+```ts
+const API_ORIGIN = "https://pre-copy-trade-api.kyberengineering.io";
+
+async function apiGet(path: string): Promise {
+ const response = await fetch(`${API_ORIGIN}/api/v1${path}`, {
+ headers: { Accept: "application/json" },
+ });
+
+ const body = await response.json();
+ if (!response.ok) {
+ throw new Error(body.message ?? `HTTP ${response.status}`);
+ }
+ return body as T;
+}
+```
+
+POST requests use:
+
+```http
+Accept: application/json
+Content-Type: application/json
+```
+
+Path variables belong in the URL and are omitted from POST bodies. URL-encode
+opaque IDs:
+
+```ts
+const pathID = (value: string) => encodeURIComponent(value);
+
+const query = new URLSearchParams({
+ view: "OWNER_COPY_VIEW_OPEN",
+ sortBy: "OWNER_COPY_RUN_SORT_FIELD_STARTED_AT",
+ sortOrder: "SORT_ORDER_DESC",
+ limit: "25",
+});
+```
+
+Omit optional query parameters instead of sending an empty enum string,
+`undefined`, or `null`. Send `chainId`, raw amounts, block numbers, and other
+protobuf `int64` values as decimal strings when they appear in JSON.
+
+No transaction-preparation route requires a wallet-session bearer token in the
+pending contract. Do not add an `Authorization` header solely for Copy Trade
+preparation.
+
+All transaction-preparation responses are emitted with `Cache-Control:
+no-store` and `Pragma: no-cache`. The frontend must not place prepared calldata
+or signed operator payloads in a persistent HTTP cache, service-worker cache,
+analytics event, or error-report payload.
+
+## Common Response Contract
+
+### Envelopes
+
+A single-resource **read** response:
+
+```json
+{
+ "data": {},
+ "meta": {
+ "requestId": "...",
+ "generatedAt": "2026-07-27T08:57:00Z",
+ "dataAsOf": "2026-07-27T08:56:30Z",
+ "status": "DATA_STATUS_CURRENT",
+ "asOfChains": []
+ }
+}
+```
+
+A list **read** response:
+
+```json
+{
+ "data": [],
+ "pagination": {
+ "nextCursor": "...",
+ "hasMore": true,
+ "limit": 25
+ },
+ "meta": {}
+}
+```
+
+Default-valued JSON fields may be omitted. In particular:
+
+- A successful empty list can omit `data`; normalize `body.data ?? []`.
+- `pagination.hasMore` can be omitted when false.
+- `pagination.nextCursor` can be omitted when there is no next page.
+- Optional metric values are omitted when unavailable.
+
+POST responses use `{ "data": ... }` without `meta` or cursor pagination.
+Prepared actions carry their own `preparedAt`, `reprepareAfter`, and
+`evidence`.
+
+### Response Metadata
+
+| Field | Meaning |
+| --- | --- |
+| `requestId` | Server request correlation ID. Include it in bug reports, but do not use it as product identity. |
+| `generatedAt` | Time this response was assembled. It is not necessarily the source-data time. |
+| `dataAsOf` | Conservative time through which the response's aggregate data is known. |
+| `stalenessReason` | Optional sanitized reason when data is stale or unavailable. Treat it as diagnostic text, not a stable enum. |
+| `asOfChains[]` | Per-chain source coverage contributing to the response. |
+| `status` | Response-level `DataStatus`. Individual metrics and valuations can have more specific statuses. |
+
+Each `asOfChains[]` entry contains:
+
+| Field | Meaning |
+| --- | --- |
+| `chainId` | Chain to which this coverage applies. |
+| `dataAsOf` | Source-data time at the covered boundary. |
+| `asOfBlockNumber` | Highest covered block represented by the response. |
+| `safeBlockNumber` | Operator-configured reorg-safe boundary. This is **not** consensus finality. |
+| `syncedAt` | Time the source/materializer recorded the coverage. |
+| `status` | Per-chain `DataStatus`. |
+
+### Freshness
+
+Every successful read response includes `meta`.
+
+| Status | FE behavior |
+| --- | --- |
+| `DATA_STATUS_CURRENT` | Render normally. |
+| `DATA_STATUS_STALE` | Render the returned data and show a stale-data indication where appropriate. |
+| `DATA_STATUS_UNAVAILABLE` | Do not invent missing values. A response may still contain independently usable fields or metrics. |
+
+`meta.asOfChains[]` can contain:
+
+- `chainId`
+- `dataAsOf`
+- `asOfBlockNumber`
+- `safeBlockNumber`
+- `syncedAt`
+- `status`
+
+Use `meta.status` for the response-level state. Use each metric's own status for
+the metric itself.
+
+Do not require all timestamps in `meta` and `asOfChains[]` to be identical.
+Different dependencies are folded conservatively and can be synchronized in
+different rounds. The stable frontend invariants are the chain identity,
+coverage block, status, and nonzero timestamps.
+
+### Metrics
+
+Most numeric display values use an explicit status:
+
+```ts
+type MetricStatus =
+ | "METRIC_STATUS_CURRENT"
+ | "METRIC_STATUS_STALE"
+ | "METRIC_STATUS_UNAVAILABLE"
+ | "METRIC_STATUS_NOT_APPLICABLE";
+
+interface DecimalMetric {
+ value?: string;
+ status: MetricStatus;
+ asOf?: string;
+}
+
+interface CountMetric {
+ // int64 values are encoded as decimal strings in JSON.
+ value?: string;
+ status: MetricStatus;
+ asOf?: string;
+}
+
+interface RatioMetric {
+ // Fixed-point integer scaled by 1e18.
+ valueRaw?: string;
+ status: MetricStatus;
+ asOf?: string;
+}
+```
+
+Rules:
+
+- Render `CURRENT` normally.
+- Render `STALE` only with an appropriate stale indication.
+- Do not display a fabricated zero for `UNAVAILABLE`.
+- `NOT_APPLICABLE` is a valid product state, not an error.
+
+`AprMetric` additionally contains:
+
+- `window`
+- `nominalWindowDays`
+- `actualWindowSeconds`
+- `windowPolicy`
+- `windowStart`
+- `windowEnd`
+
+The API can shorten an APR window when an agent or copy run has not existed for
+the full nominal period. Display the returned metric and interval rather than
+recomputing APR in the browser.
+
+### Valuations
+
+`PositionValuation` is independently status-bearing:
+
+| Field | Meaning |
+| --- | --- |
+| `valueUsd` | Position or asset value as an exact decimal string. |
+| `priceUsd` | Unit price used for the valuation. |
+| `priceSource` | Sanitized source label for display/debugging. |
+| `priceAsOf` | Observation time of the price. |
+| `asOf` | Time of the resulting valuation. |
+| `isEstimated` | Value is provisional or derived from a retained price. |
+| `isFinal` | Value belongs to a terminal/settled position and is final. |
+| `status` | `DATA_STATUS_CURRENT`, `STALE`, or `UNAVAILABLE`. |
+
+An unavailable valuation is not the same as a zero-valued asset. Never derive a
+USD value from missing fields.
+
+### Advisory Action Availability
+
+Agent, copy-run, copy-account, and position reads expose compact advisory action
+state:
+
+```text
+ADVISORY_ACTION_STATUS_AVAILABLE
+ADVISORY_ACTION_STATUS_PENDING
+ADVISORY_ACTION_STATUS_UNAVAILABLE
+```
+
+The object contains `status`, a typed `reason`, and optional `asOf`. Use it to
+render or disable controls. It is not authorization and must not be used to
+construct calldata. The matching POST preparation route always makes the final
+decision using current chain and source state.
+
+### Numeric Values
+
+Treat these as strings:
+
+- `chainId`
+- block numbers
+- raw token amounts
+- token prices and USD amounts
+- percentages and fixed-point ratios
+- int64 counts
+
+Do not parse large values through JavaScript `number`. Use a decimal or bigint
+library appropriate for the field.
+
+Important distinctions:
+
+- `*Raw` fields are base-unit integers. Format them with the matching
+ `token.decimals`.
+- `amountDecimal`, `*Usd`, `priceUsd`, APR, and percentage fields are decimal
+ strings intended for decimal arithmetic and display formatting.
+- `RatioMetric.valueRaw`, sell ratios, and fee rates are fixed-point integers
+ scaled by `1e18`. For example, `500000000000000000` is 50%.
+- `slippageBps`, `limit`, and small counts defined as `uint32`/`int32` remain
+ JSON numbers.
+
+### Addresses and Time
+
+- Send EVM addresses as `0x` addresses.
+- Lowercase addresses are canonical in responses and are recommended in URLs.
+- Timestamps are RFC3339 strings.
+- `ownerAddress` on owner read routes is the wallet that originally created the
+ follower account. It is a read filter, not proof of current on-chain ownership
+ or authority.
+- Public routes accept mixed-case input and canonicalize addresses in the
+ response. Lowercase input remains recommended for stable URLs and cache keys.
+
+## Cursor Pagination
+
+All list routes use opaque cursor pagination.
+
+| Parameter | Behavior |
+| --- | --- |
+| `limit` | Default `25`; valid range `0..100`, where `0` selects the default. |
+| `cursor` | Omit on the first request. Pass the exact returned `nextCursor` on the next request. |
+
+The pending-sell-obligation FIFO is the one limit exception: it accepts
+`0..200`, with `0` still selecting the default `25`.
+
+Cursor rules:
+
+- Treat cursors as opaque.
+- Reuse a cursor only with the same route, filters, and sort values.
+- Ordinary cursors expire after 72 hours.
+- Position pages sorted by current USD value use a shorter five-minute cursor
+ because their ordering depends on changing prices.
+- If a cursor is rejected or expired, restart from the first page.
+
+The cursor is signed and scoped to the normalized request. The following all
+invalidate an existing cursor:
+
+- using it on another endpoint;
+- changing `ownerAddress`, `agentId`, `copyRunId`, `chainId`, or account;
+- changing any view/filter;
+- changing sort field or direction;
+- changing performance series/window/interval;
+- changing the action-log time range, leader-position filter, action `type`, or `groupBy`.
+
+`limit` controls page size and is not part of the logical result identity, but
+the safest client behavior is to keep it stable through one sequence.
+
+### Stable Ordering
+
+| Collection | Default/effective order |
+| --- | --- |
+| Leaderboard | APR 30D descending, with stable identity tie-breakers |
+| Agent discovery | Display name ascending, nulls last |
+| Performance points | Timestamp ascending; per-trade series also uses trade ID |
+| Agent action-log session groups | Newest matching log in each session descending, then that log's `actionLogId` descending; logs inside each group use the same order |
+| Positions | `openedAt` descending unless explicitly changed |
+| Open copy runs | `startedAt` descending unless explicitly changed |
+| History copy runs | `stoppedAt` descending when `sortBy` is omitted |
+| Owner activity / copy-account history | `occurredAt` descending, then `activityId` descending |
+| Owner copy accounts | Chain and copy-account ascending |
+| Pending sell obligations | Operator-authoritative FIFO order; never re-sort client-side |
+
+`closedAt` and live `valueUsd` sorts place unavailable/null values last.
+
+## Shared Query Enums
+
+### Strategy category
+
+```text
+STRATEGY_CATEGORY_FOCUSED
+STRATEGY_CATEGORY_DIVERSIFIED
+STRATEGY_CATEGORY_ACTIVE
+```
+
+### Sort order
+
+```text
+SORT_ORDER_ASC
+SORT_ORDER_DESC
+```
+
+### Owner copy view
+
+```text
+OWNER_COPY_VIEW_OPEN
+OWNER_COPY_VIEW_HISTORY
+```
+
+`view` is required for owner copy-summary and copy-run list requests.
+
+### Position view
+
+```text
+POSITION_VIEW_ALL
+POSITION_VIEW_OPEN
+POSITION_VIEW_CLOSED
+POSITION_VIEW_LEFTOVER
+```
+
+`POSITION_VIEW_LEFTOVER` is supported on owner and copy-account position lists,
+but not on agent position lists.
+
+### Position sort field
+
+```text
+POSITION_SORT_FIELD_OPENED_AT
+POSITION_SORT_FIELD_CLOSED_AT
+POSITION_SORT_FIELD_VALUE_USD
+```
+
+Unsupported combinations:
+
+- `POSITION_SORT_FIELD_VALUE_USD` with `POSITION_VIEW_CLOSED`
+- `POSITION_SORT_FIELD_CLOSED_AT` with `POSITION_VIEW_OPEN`
+- `POSITION_SORT_FIELD_CLOSED_AT` with `POSITION_VIEW_LEFTOVER`
+
+Omitting `view` selects `POSITION_VIEW_ALL`. Omitting `sortBy` selects
+`POSITION_SORT_FIELD_OPENED_AT`; omitting `sortOrder` selects
+`SORT_ORDER_DESC`.
+
+### Position state
+
+Lifecycle:
+
+```text
+POSITION_LIFECYCLE_ACTIVE
+POSITION_LIFECYCLE_CLOSING
+POSITION_LIFECYCLE_CLOSED
+```
+
+Quantity state:
+
+```text
+POSITION_QUANTITY_STATE_OPEN_FULL
+POSITION_QUANTITY_STATE_OPEN_PARTIAL
+POSITION_QUANTITY_STATE_CLOSED
+```
+
+Exit kind, when known:
+
+```text
+POSITION_EXIT_KIND_ALIGNED
+POSITION_EXIT_KIND_MANUAL
+```
+
+Available recovery actions:
+
+```text
+POSITION_ACTION_KIND_MANUAL_SELL
+POSITION_ACTION_KIND_CLOSE_POSITION
+```
+
+Do not infer lifecycle from remaining quantity, timestamps, or valuations.
+Render `lifecycle` and `quantityState` independently.
+
+### Copy lifecycle
+
+Copy-run statuses:
+
+```text
+COPY_RUN_STATUS_ACTIVE
+COPY_RUN_STATUS_CLOSED
+COPY_RUN_STATUS_CLOSING
+COPY_RUN_STATUS_STOPPED
+```
+
+Copy-account statuses:
+
+```text
+COPY_ACCOUNT_STATUS_ACTIVE
+COPY_ACCOUNT_STATUS_CLOSED
+COPY_ACCOUNT_STATUS_CLOSING
+COPY_ACCOUNT_STATUS_STOPPED
+```
+
+Omit the copy-account `status` query parameter to include every status.
+
+### Performance selections
+
+Defaults:
+
+```text
+series = PERFORMANCE_SERIES_PORTFOLIO_EQUITY
+window = WINDOW_30D
+interval = PERFORMANCE_INTERVAL_DAY
+```
+
+Supported combinations:
+
+| Series | Window | Interval |
+| --- | --- | --- |
+| `PERFORMANCE_SERIES_PORTFOLIO_EQUITY` | `WINDOW_7D`, `WINDOW_30D`, `WINDOW_90D` | `PERFORMANCE_INTERVAL_DAY` |
+| `PERFORMANCE_SERIES_PORTFOLIO_EQUITY` | `WINDOW_ALL` | `PERFORMANCE_INTERVAL_WEEK` or `PERFORMANCE_INTERVAL_MONTH` |
+| `PERFORMANCE_SERIES_CUMULATIVE_REALIZED_PNL` | `WINDOW_7D`, `WINDOW_30D`, `WINDOW_90D` | `PERFORMANCE_INTERVAL_DAY` |
+| `PERFORMANCE_SERIES_CUMULATIVE_REALIZED_PNL` | `WINDOW_ALL` | `PERFORMANCE_INTERVAL_WEEK` or `PERFORMANCE_INTERVAL_MONTH` |
+| `PERFORMANCE_SERIES_PERIOD_REALIZED_PNL` | Any supported window | `PERFORMANCE_INTERVAL_MONTH` |
+| `PERFORMANCE_SERIES_PER_TRADE_REALIZED_PNL` | Any supported window | Omit `interval` |
+
+Agent stats currently support `WINDOW_30D`; omitting `window` selects it.
+
+### Activity group
+
+```text
+ACTIVITY_GROUP_BUYS
+ACTIVITY_GROUP_SELLS
+ACTIVITY_GROUP_DEPOSITS_WITHDRAWALS
+ACTIVITY_GROUP_SKIPPED
+```
+
+Groups are stable product groupings, not aliases for every related activity:
+
+| Group | Included activity types |
+| --- | --- |
+| `ACTIVITY_GROUP_BUYS` | `ACTIVITY_TYPE_POSITION_OPENED` |
+| `ACTIVITY_GROUP_SELLS` | `ACTIVITY_TYPE_POSITION_CLOSED`, `ACTIVITY_TYPE_EXIT_SUCCEEDED`, `ACTIVITY_TYPE_POSITION_REDUCED` |
+| `ACTIVITY_GROUP_DEPOSITS_WITHDRAWALS` | `ACTIVITY_TYPE_CAPITAL_DEPOSITED`, `ACTIVITY_TYPE_CAPITAL_TOPPED_UP`, `ACTIVITY_TYPE_CAPITAL_WITHDRAWN`, `ACTIVITY_TYPE_CAPITAL_RETURNED` |
+| `ACTIVITY_GROUP_SKIPPED` | `ACTIVITY_TYPE_ALIGNED_TRADE_SKIPPED`, `ACTIVITY_TYPE_EXIT_SKIPPED` |
+
+In-progress and failed execution rows are intentionally available only through
+an exact `type` filter or the unfiltered feed. `type` and `group` are mutually
+exclusive.
+
+### Agent action-log grouping
+
+```text
+AGENT_ACTION_LOG_GROUP_BY_SESSION_ID
+```
+
+Action-log `type` is an exact filter over the row's source-owned `action`
+value. It is applied before session grouping, so a grouped response contains
+only matching rows. The response always uses session groups; omitted
+`groupBy` defaults to `AGENT_ACTION_LOG_GROUP_BY_SESSION_ID`.
+
+### Activity type
+
+```text
+ACTIVITY_TYPE_COPY_STARTED
+ACTIVITY_TYPE_COPY_STOPPED
+ACTIVITY_TYPE_POSITION_OPENED
+ACTIVITY_TYPE_POSITION_CLOSED
+ACTIVITY_TYPE_CAPITAL_DEPOSITED
+ACTIVITY_TYPE_CAPITAL_TOPPED_UP
+ACTIVITY_TYPE_CAPITAL_WITHDRAWN
+ACTIVITY_TYPE_CAPITAL_RETURNED
+ACTIVITY_TYPE_FLAT_FEE_CAPTURED
+ACTIVITY_TYPE_CASHBACK_RECEIVED
+ACTIVITY_TYPE_ALIGNED_TRADE_SKIPPED
+ACTIVITY_TYPE_EXIT_STARTED
+ACTIVITY_TYPE_EXIT_SUCCEEDED
+ACTIVITY_TYPE_EXIT_SKIPPED
+ACTIVITY_TYPE_EXIT_FAILED
+ACTIVITY_TYPE_EXECUTION_FAILED
+ACTIVITY_TYPE_POSITION_REDUCED
+```
+
+### Pinned stable balance status
+
+```text
+PINNED_STABLE_BALANCE_STATUS_PRESENT
+PINNED_STABLE_BALANCE_STATUS_REGISTRATION_PENDING
+PINNED_STABLE_BALANCE_STATUS_NOT_INDEXED
+PINNED_STABLE_BALANCE_STATUS_UNAVAILABLE
+PINNED_STABLE_BALANCE_STATUS_TOKEN_MISMATCH
+```
+
+Only `PRESENT` guarantees that `pinnedStableBalance.balance` is the configured
+stable-token row. A present row can contain an exact zero balance and can use
+`balanceSource = "onchain_rpc"`. The other values are explicit
+operational/data states and must not be converted to a zero balance.
+
+## Shared Request Validation
+
+- A supplied `chainId` must be positive.
+- IDs such as `agentId`, `copyRunId`, `positionId`, and `userPositionId` are
+ opaque. Preserve them exactly and URL-encode them; do not split or derive
+ business meaning from their text.
+- Filters are normalized server-side, but the client should trim search text
+ and omit empty optional filters.
+- Raw amounts are canonical positive decimal integers without signs,
+ separators, decimals, or leading zeroes.
+- `slippageBps` is an integer in `0..10000`.
+- RFC3339 timestamps should include an explicit offset, preferably `Z`.
+- Query enum names are case-sensitive.
+- `type` and `group` cannot both be supplied on activity/history routes.
+
+## Endpoint Catalog
+
+### Chain Metadata
+
+| Method | Path | Parameters | `data` |
+| --- | --- | --- | --- |
+| GET | `/chains` | None | `Chain[]` |
+
+A chain contains `chainId`, `slug`, `name`, `iconUrl`, and `isEnabled`.
+
+Use this route to populate the network selector and chain metadata. Do not
+hard-code chain display names or icons from `chainId`.
+
+### Leaderboard and Agent Discovery
+
+| Method | Path | Parameters | `data` |
+| --- | --- | --- | --- |
+| GET | `/leaderboard/summary` | `chainId?`, `search?`, `strategyCategory?` | `LeaderboardSummary` |
+| GET | `/leaderboard` | Previous filters plus `cursor?`, `limit?`, `sortBy?`, `sortOrder?` | `AgentCard[]` |
+| GET | `/agents` | `chainId?`, `search?`, `strategyCategory?`, `cursor?`, `limit?` | `AgentCard[]` |
+
+Leaderboard sort fields:
+
+```text
+LEADERBOARD_SORT_FIELD_APR_30D
+LEADERBOARD_SORT_FIELD_WIN_RATE
+LEADERBOARD_SORT_FIELD_LIFETIME_VOLUME
+LEADERBOARD_SORT_FIELD_COPIERS
+LEADERBOARD_SORT_FIELD_AUM
+LEADERBOARD_SORT_FIELD_OPEN_POSITIONS
+```
+
+The default leaderboard order is APR 30D descending. Agent discovery uses a
+stable display-name order.
+
+Filter behavior:
+
+| Parameter | Supported values and behavior |
+| --- | --- |
+| `chainId` | Optional positive chain ID. Omit for all configured chains. |
+| `search` | Optional, trimmed and case-insensitive, maximum 256 Unicode characters. |
+| `strategyCategory` | Optional `FOCUSED`, `DIVERSIFIED`, or `ACTIVE` enum. Categories overlap; an agent can appear in more than one. |
+| `sortBy` | Leaderboard only. Omit for APR 30D. |
+| `sortOrder` | Leaderboard only. Omit for descending. |
+| `limit`, `cursor` | Standard cursor pagination. |
+
+Key `AgentCard` fields:
+
+- `agentId`, `chainId`, `leaderAddress`
+- `displayName`, `avatarUrl`, `modelName`, `isVerified`
+- `badges`, `strategyLabel`, `strategyCategories`
+- `metrics`
+- `flatFeeRatePct`
+- `startCopyAvailability`
+
+`AgentCard.metrics` contains:
+
+| Field | Meaning |
+| --- | --- |
+| `apr30d` | APR with its exact effective interval and status. |
+| `winRatePct` | Closed-position win rate. |
+| `lifetimeVolumeUsd` | Lifetime notional volume. |
+| `copiers` | Unique active copier count. |
+| `aumUsd` | Follower assets under management. |
+| `openPositions` | Current open-position count. |
+| `totalRealizedPnlUsd` | Lifetime realized P&L. |
+| `maxDrawdownPct` | Maximum drawdown percentage when available. |
+| `winningPositionCount`, `losingPositionCount`, `breakevenPositionCount`, `closedPositionCount` | Explicit terminal-position counts. |
+
+`LeaderboardSummary` contains status-bearing `agentCount`, `totalAumUsd`,
+`totalCopierCount`, and `lifetimeVolumeUsd`, plus `asOf`. `agentCount`,
+`totalAumUsd`, and `lifetimeVolumeUsd` use the supplied leaderboard filters.
+`totalCopierCount` is different: it is the platform-wide lifetime count of
+distinct owner wallets across configured agents and intentionally ignores
+leaderboard filters, including `chainId`, search, and strategy category. Every
+metric still has its own status and can be unavailable independently.
+
+### Agent Profile, Performance, and Positions
+
+| Method | Path | Parameters | `data` |
+| --- | --- | --- | --- |
+| GET | `/agents/{agentId}` | Path: `agentId` | `AgentProfile` |
+| GET | `/agents/{agentId}/stats` | `window?` | `AgentMetrics` |
+| GET | `/agents/{agentId}/performance` | `series?`, `window?`, `interval?`, `cursor?`, `limit?` | `PerformancePoint[]` |
+| GET | `/agents/{agentId}/action-logs` | `leaderPositionId?`, `type?`, `groupBy?`, `from?`, `to?`, `cursor?`, `limit?` | `AgentActionLogSessionGroup[]` |
+| GET | `/agents/{agentId}/positions` | `view?`, `token?`, `cursor?`, `limit?`, `sortBy?`, `sortOrder?` | `PositionSummary[]` |
+| GET | `/agents/{agentId}/positions/{positionId}` | Path: `agentId`, `positionId` | `PositionSummary` |
+| GET | `/agents/{agentId}/positions/{positionId}/events` | `cursor?`, `limit?` | `PositionEvent[]` |
+
+Action-log `from` and `to` are RFC3339 timestamps. When both are present,
+`from` must not be after `to`. `type` is an exact match against the existing
+source-owned `action` value, such as `hold`, `open`, `close_full`, or
+`close_partial`; it is not the upstream memory-note type. `groupBy` accepts
+`AGENT_ACTION_LOG_GROUP_BY_SESSION_ID`; omission currently defaults to that
+value. The response `data[]` contains one whole session group per item, with
+`sessionId` and `logs[]`. A session is never split across cursor pages, and
+the `limit` counts groups rather than individual logs. A very large session
+therefore produces a correspondingly large item; clients should render its
+logs incrementally where possible.
+
+Agent-route behavior:
+
+| Route | Defaults and constraints |
+| --- | --- |
+| Stats | Omitted `window` means `WINDOW_30D`; 30D is currently the only accepted stats window. |
+| Performance | Uses the performance defaults/combinations above and returns points in ascending time order. |
+| Action logs | Optional `leaderPositionId` is 1..256 characters; `type` is an exact 1..128-character action value; `groupBy` defaults to `SESSION_ID`; `from` and `to` are inclusive source-time bounds. Groups and their logs are newest first. |
+| Positions | Omitted view means `ALL`; `LEFTOVER` is rejected. Optional `token` is a token-address filter. |
+| Position events | Standard pagination; events preserve source lifecycle order for the selected position. |
+
+Key `AgentProfile` additions over a card:
+
+- `bio`, `liveSince`, `whitelistedSymbols`, `tags`
+- `strategyExecutionItems`
+
+`strategyExecutionItems[]` has `label` and `description` and is intended for
+the “Strategy & Execution” section of the profile. It is configured display
+content, not a machine-readable trading rule.
+
+Key `PositionSummary` fields:
+
+- identity: `positionId`, optional `userPositionId`, optional
+ `agentPositionId`, optional `copyRunId`
+- routing/display: `agentId`, `chainId`, optional `copyAccount`, `tradeId`,
+ `token`
+- lifecycle: `lifecycle`, `quantityState`, `exitKind`, `openedAt`, `closedAt`
+- amount: `remainingBaseRaw` and optional gross/net accounting fields
+- value: `entryValuation`, `currentValuation`, `exitValuation`
+- metrics: realized/unrealized PnL, fees, cashback, skip counts and ratios
+- recovery UI: `actionKind`, `availableActionKinds`
+
+Position rendering rules:
+
+- Use `displayBaseRaw` when present for the main human-facing base amount;
+ otherwise use the product-specific gross/net fields deliberately. Do not
+ assume `remainingBaseRaw` and `remainingNetBaseRaw` are interchangeable.
+- `isLeftover` and `leftoverReason` are explicit stopped-run residue state.
+- Use `durationSeconds`/`durationAsOf` rather than recomputing a changing
+ duration from browser time.
+- `actionKind` is the primary suggested recovery action;
+ `availableActionKinds[]` is the complete advisory set.
+- A position's three valuations can have different statuses. Closed-position
+ `exitValuation` can remain final even when a current price is unavailable.
+- `POSITION_EXIT_KIND_MANUAL` is reserved for an explicitly proven manual
+ exit.
+ Generic owner-directed `sell_unaligned` history projects as
+ `POSITION_EXIT_KIND_UNSPECIFIED`; render a neutral **Owner Sell** label from
+ the typed activity detail rather than inferring Manual Sell versus Close
+ Position from amount, lifecycle, or skip count.
+
+An `AgentActionLogSessionGroup` contains a `sessionId` and the `logs[]` from
+that source session which match the request filters. The old flat response
+field was retired in the breaking action-log contract; do not expect raw
+`AgentActionLog` objects directly in response `data[]`.
+
+An `AgentActionLog` contains the public fields `actionLogId`, `chainId`,
+`occurredAt`, `summary`, `trigger`, `dataSummary`, `reasoningSummary`,
+`actionSummary`, `action`, and `status`, plus optional chain links such as
+`txHash`, `leaderPositionId`, `blockNumber`, and `tokenAddress`.
+
+Action-log text is sanitized, public narrative content. Optional chain links
+are populated only after canonical linkage is validated; absence does not make
+the narrative row invalid. Valid fixed-width EVM addresses and hashes are
+returned in canonical lowercase form even when the upstream claim used mixed
+case. If any optional linkage claim is malformed or cannot be validated, the
+linkage set is omitted while the safe narrative can still be returned. Do not
+reconstruct omitted links from text. `model` and `strategyVersion` are optional
+provenance labels. `action` and `status` are source-owned strings rather than
+public enums. Do not parse `summary`, `trigger`, `status`, or reasoning strings
+to derive transaction state.
+
+A `PerformancePoint` contains `timestamp`, `series`, `interval`, a
+status-bearing `valueUsd`, and optional `tradeId`/`positionId`/`token` context.
+For per-trade P&L, the trade and position identifiers are suitable for opening
+the related detail, while the point timestamp remains the chart order key.
+
+### Owner Dashboard and Copy Runs
+
+| Method | Path | Parameters | `data` |
+| --- | --- | --- | --- |
+| GET | `/users/{ownerAddress}/copy-summary` | `view` **required**, `chainId?` | `OwnerCopySummary` |
+| GET | `/users/{ownerAddress}/copy-runs` | `view` **required**, `agentId?`, `chainId?`, `cursor?`, `limit?`, `sortBy?`, `sortOrder?` | `CopyRunSummary[]` |
+| GET | `/users/{ownerAddress}/copy-runs/{copyRunId}` | Path only | `CopyRunSummary` |
+| GET | `/users/{ownerAddress}/copy-runs/{copyRunId}/cashback-policy` | Path only | `CopyRunCashbackPolicy` |
+| GET | `/users/{ownerAddress}/copy-runs/{copyRunId}/positions` | `view?`, `cursor?`, `limit?`, `sortBy?`, `sortOrder?` | `PositionSummary[]` |
+| GET | `/users/{ownerAddress}/copy-runs/{copyRunId}/performance` | `series?`, `window?`, `interval?`, `cursor?`, `limit?` | `PerformancePoint[]` |
+| GET | `/users/{ownerAddress}/positions` | `agentId?`, `chainId?`, `view?`, `cursor?`, `limit?`, `sortBy?`, `sortOrder?` | `PositionSummary[]` |
+| GET | `/users/{ownerAddress}/activity` | `copyRunId?`, `chainId?`, `type?`, `group?`, `cursor?`, `limit?` | `ActivityRow[]` |
+| GET | `/users/{ownerAddress}/copy-accounts` | `chainId?`, `status?`, `cursor?`, `limit?` | `CopyAccountSummary[]` |
+
+Owner copy-run sort fields:
+
+```text
+OWNER_COPY_RUN_SORT_FIELD_STARTED_AT
+OWNER_COPY_RUN_SORT_FIELD_STOPPED_AT
+OWNER_COPY_RUN_SORT_FIELD_AGENT_APR_30D
+OWNER_COPY_RUN_SORT_FIELD_AGENT_WIN_RATE
+OWNER_COPY_RUN_SORT_FIELD_AGENT_LIFETIME_VOLUME
+OWNER_COPY_RUN_SORT_FIELD_CAPITAL_IN
+```
+
+`OWNER_COPY_VIEW_OPEN` and `OWNER_COPY_VIEW_HISTORY` are server-defined product
+universes, not direct aliases for one `CopyRunStatus`. Always pass the selected
+view and render the returned `status`. Do not filter the page client-side by
+status.
+
+`OPEN` contains only source-admitted runs whose status is
+`COPY_RUN_STATUS_ACTIVE` or `COPY_RUN_STATUS_CLOSING`. `HISTORY` contains
+`COPY_RUN_STATUS_STOPPED` or `COPY_RUN_STATUS_CLOSED` runs, including terminal
+historical-generation rows that remain readable for audit/history. A stopped
+run does not remain in `OPEN` because it still has a closing or leftover
+position. An active historical-generation run is intentionally in neither
+list, although an exact direct lookup can remain readable.
+
+The server owns list membership. A source reorg or corrected lifecycle can
+move a run between the product universes, so refresh rather than retaining a
+client-side tab assignment.
+
+These run views do not define the owner-position universe. In particular,
+closed positions can belong to a run that remains in `OPEN` because the copy
+relationship is still active and can receive future trades. Use
+`GET /users/{ownerAddress}/positions?view=POSITION_VIEW_CLOSED` for an
+owner-wide closed-position screen. Use
+`GET /users/{ownerAddress}/copy-runs/{copyRunId}/positions?view=POSITION_VIEW_CLOSED`
+only for a selected-run drilldown.
+
+Copy-run list behavior:
+
+| Parameter | Behavior |
+| --- | --- |
+| `view` | Required: `OPEN` or `HISTORY`. |
+| `agentId` | Optional exact agent filter. |
+| `chainId` | Optional positive chain filter. |
+| `sortBy` | Open defaults to `OWNER_COPY_RUN_SORT_FIELD_STARTED_AT`; History defaults to `OWNER_COPY_RUN_SORT_FIELD_STOPPED_AT`. |
+| `sortOrder` | Defaults to descending. |
+| `limit`, `cursor` | Standard cursor pagination. |
+
+Copy-account status filters:
+
+```text
+COPY_ACCOUNT_STATUS_ACTIVE
+COPY_ACCOUNT_STATUS_CLOSED
+COPY_ACCOUNT_STATUS_CLOSING
+COPY_ACCOUNT_STATUS_STOPPED
+```
+
+Key `CopyRunSummary` fields:
+
+- `copyRunId`, `ownerAddress`, `agentId`, `chainId`, `copyAccount`
+- `startedAt`, `stoppedAt`, `status`, `durationSeconds`
+- `agentSnapshot`
+- capital, portfolio, PnL, fee, cashback, position-count, and APR metrics
+- `capitalInProjectionStatus`, which must be `READY` before the UI renders a
+ numeric `capitalInUsd`. `SYNCING` means canonical funding is visible but the
+ immutable account-capital projection is still catching up; `UNAVAILABLE`
+ means its source or lineage cannot currently authorize a value. In both
+ non-ready states `capitalInUsd` is unavailable and never a provisional zero.
+- `addCapitalAvailability`, `stopCopyAvailability`,
+ `withdrawQuoteAvailability`
+
+#### Account-effective cashback policy
+
+Fetch the policy only when the selected-run UI needs its fee/cashback detail:
+
+```text
+GET /users/{ownerAddress}/copy-runs/{copyRunId}/cashback-policy
+```
+
+This route is deliberately run/account-scoped. It is the effective policy
+assigned to that follower account, not the agent's current advertised policy.
+The `feePolicy` inside a Start Copy preview is create-time advertised policy;
+after the account exists, it is not a substitute for this endpoint.
+The response contains the exact `copyRunId`, `chainId`, `copyAccount`, and
+`agentId`, plus:
+
+| Field | FE meaning |
+| --- | --- |
+| `status` | Authoritative policy state: `COPY_RUN_CASHBACK_POLICY_STATUS_AVAILABLE`, `..._NOT_CONFIGURED`, `..._INVALIDATED`, or `..._UNAVAILABLE`. |
+| `scope` | `COPY_RUN_CASHBACK_POLICY_SCOPE_DEFAULT` or `..._EXTRA` when a policy is selected. Do not infer a scope when unspecified. |
+| `capCashbackRatioRaw`, `pnlRateRaw` | Optional 1e18-scaled raw ratios. They are present or absent together; absence is not zero. |
+| `selectionPolicyVersion` | Optional operator policy-selection version. Treat as opaque diagnostic/version identity. |
+| `cashbackFormulaVersion` | Optional positive formula identity. Do not infer it from scope, selection version, generation, or agent data. |
+| `selectedAt`, `invalidatedAt`, `fallbackAt` | Optional provenance times for the selected, invalidated, or default-fallback state. |
+| `unavailableReason` | Present for `..._STATUS_UNAVAILABLE`: `COPY_RUN_CASHBACK_POLICY_UNAVAILABLE_REASON_COVERAGE_PENDING`, `..._HISTORICAL_GENERATION_UNSUPPORTED`, or `..._POLICY_TRANSITION_PENDING`. |
+
+Frontend shape:
+
+```ts
+interface CopyRunCashbackPolicy {
+ copyRunId: string;
+ chainId: string;
+ copyAccount: `0x${string}`;
+ agentId: string;
+ capCashbackRatioRaw?: string;
+ pnlRateRaw?: string;
+ scope: string;
+ status: string;
+ selectionPolicyVersion?: string;
+ cashbackFormulaVersion?: number;
+ selectedAt?: string;
+ invalidatedAt?: string;
+ unavailableReason?: string;
+ fallbackAt?: string;
+}
+```
+
+The currently pinned operator emits `cashbackFormulaVersion = 2` for supported
+policy outcomes. Unsupported historical-generation policy can legitimately
+omit it. Treat the value as an explicit contract field, not a frontend
+constant, because formula identity is independent from policy scope and
+selection version.
+
+Use these rendering rules:
+
+- `COPY_RUN_CASHBACK_POLICY_STATUS_AVAILABLE`: render the returned rates and
+ scope.
+- `COPY_RUN_CASHBACK_POLICY_STATUS_NOT_CONFIGURED`: render the product's
+ no-policy state; do not show zero
+ rates.
+- `COPY_RUN_CASHBACK_POLICY_STATUS_INVALIDATED`: render the state as
+ invalidated, using `invalidatedAt` when present. Do not present the retained
+ rate pair as currently selectable.
+- `COPY_RUN_CASHBACK_POLICY_STATUS_UNAVAILABLE`: render an
+ unavailable/pending state from `unavailableReason`; do not reuse an
+ agent-level rate as a fallback.
+- Use the response `meta.status` independently. A stale, renderable policy is
+ not equivalent to a current policy.
+
+`OwnerCopySummary` is already scoped to the requested `view` and contains:
+
+- active and closed copy-run counts;
+- total allocated, portfolio value, realized P&L, and unrealized P&L;
+- open, closed, and leftover position counts;
+- closed capital and leftover value;
+- flat fees captured, cashback received, net fee cost, and estimated pending
+ cashback.
+
+Fields that are not meaningful for the selected view can be
+`METRIC_STATUS_NOT_APPLICABLE`; do not merge the Open and History summary
+objects locally.
+
+`ActivityRow.detail` contains exactly one typed detail object appropriate for
+the activity: `copyLifecycle`, `position`, `capital`, `fee`, or `execution`.
+
+The detail variant has this shape:
+
+| Variant | Used for | Important fields |
+| --- | --- | --- |
+| `copyLifecycle` | Copy started/stopped | `eventId`, `eventType`, optional `beforeStatus`, `afterStatus` |
+| `position` | Open/close/reduce position | Tokens, raw base/quote accounting, settlement value, realized P&L, fee, cashback |
+| `capital` | Deposit/top-up/withdraw/return | `movementType`, exact raw amount, token, USD metric |
+| `fee` | Flat fee/cashback | Exact raw amount, token, USD metric |
+| `execution` | Skip/exit/failure lifecycle | Execution/action identifiers and statuses, public error, config index/rate/deadline, display amount/value |
+
+The top-level `summary` is display text. Business logic should switch on the
+typed `type` and oneof detail, not parse the summary.
+
+For Smart Wallet Activity and the Open Copies alerts feed, use one cursor chain
+per exact `type` or product `group`. Render capital actions distinctly
+(Deposit, Add Capital, Withdraw Quote, Returned Capital).
+
+#### Stop Copy and downstream activity rows
+
+Stop Copy is not one monetary trade. One request can initiate exits for zero,
+one, or many positions and tokens. The activity feed therefore exposes
+independent canonical facts:
+
+| Row | What it represents | Token / amount / value |
+| --- | --- | --- |
+| `ACTIVITY_TYPE_COPY_STOPPED` | The copy-account lifecycle transition to stopped/cancelled | None. Use `copyLifecycle` and the optional top-level `txHash`. |
+| `ACTIVITY_TYPE_EXIT_STARTED`, `ACTIVITY_TYPE_EXIT_SUCCEEDED`, `ACTIVITY_TYPE_EXIT_SKIPPED`, `ACTIVITY_TYPE_EXIT_FAILED` | One exit-action execution transition | Use `execution`; monetary display fields can be absent when no authoritative value exists. |
+| `ACTIVITY_TYPE_POSITION_REDUCED` | One completed sell that leaves base inventory | Use the token and exact raw accounting from `position`. |
+| `ACTIVITY_TYPE_POSITION_CLOSED` | One completed sell that closes the position | Use the token and exact raw accounting from `position`. |
+
+All such rows can share `copyRunId` and `copyAccount`. Position and execution
+rows can additionally carry `userPositionId`, `followerPositionId`, `tradeId`,
+or `execution.exitActionId`. The public `ACTIVITY_TYPE_COPY_STOPPED` row does
+**not** expose a parent/child correlation identifier connecting it to every
+downstream exit.
+Do not group rows by timestamp proximity or assume that every nearby sell was
+caused by that Stop Copy.
+
+Render the lifecycle row and the token-specific rows separately. In
+particular, do not reproduce a mockup row such as “Stop Copy / ETH / 8.65 /
+$4,750” by selecting one affected position. If the product later requires one
+expandable aggregate Stop operation, that needs a new explicit correlation and
+grouping contract rather than client-side inference.
+
+There is no exact total-count contract—use `pagination.hasMore`.
+
+### Copy Accounts
+
+| Method | Path | Parameters | `data` |
+| --- | --- | --- | --- |
+| GET | `/copy-accounts/{chainId}/{copyAccount}` | Path only | `CopyAccountSummary` |
+| GET | `/copy-accounts/{chainId}/{copyAccount}/balances` | `cursor?`, `limit?` | `WalletBalanceRow[]`; response also includes `pinnedStableBalance` |
+| GET | `/copy-accounts/{chainId}/{copyAccount}/wallet-inventory` | Path only | Bounded `WalletBalanceRow[]`, `walletInventoryValueUsd`, `complete`, and `pinnedStableBalance` |
+| GET | `/copy-accounts/{chainId}/{copyAccount}/positions` | `view?`, `cursor?`, `limit?`, `sortBy?`, `sortOrder?` | `PositionSummary[]` |
+| GET | `/copy-accounts/{chainId}/{copyAccount}/positions/{userPositionId}/pending-sell-obligations` | `cursor?`, `limit?` | `PendingSellObligation[]` |
+| GET | `/copy-accounts/{chainId}/{copyAccount}/history` | `type?`, `group?`, `cursor?`, `limit?` | `ActivityRow[]` |
+
+`CopyAccountSummary` contains chain/account/creation-owner identity, current
+copy run and agent snapshot, start/stop times, lifecycle status, capital and
+portfolio totals, available balance, P&L, position counts, leftover value,
+fee/cashback totals, and advisory Add/Stop/Withdraw availability.
+
+A pending sell obligation contains:
+
+- `leaderPositionEventId`
+- `currentRatioRaw` — an exact 1e18-scaled ratio
+- optional `skippedAt`
+- optional display-only `publicErrorCode` and `publicErrorMessage`
+
+Use the returned FIFO order and exact ratios when requesting Manual Sell.
+
+`WalletBalanceRow` contains:
+
+| Field | Meaning |
+| --- | --- |
+| `chainId`, `copyAccount`, `tokenAddress` | Exact inventory identity. |
+| `amountDecimal` | Human-unit decimal amount, not a base-unit `*Raw` integer. |
+| `balanceSource` | Sanitized upstream/source label. |
+| `freshnessStatus` | Source-specific freshness label. |
+| `balanceAsOfBlock` | Block at which the balance was read. |
+| `cachedAt` | Time the row was cached. |
+| `stalenessReason` | Optional diagnostic reason. |
+| `token` | Token metadata. |
+| `currentValuation` | Independently status-bearing USD valuation. |
+
+The balance endpoint also returns `pinnedStableBalance`. This is separate from
+the ordinary page because the configured quote/stable token has action-critical
+semantics. On `origin/main`, this sidecar is materialized from the operator's
+exact quote-token balance batch at one canonical block anchor; it does not
+depend on the token appearing in the ordinary paginated balance rows. A
+present row can therefore report `balanceSource = "onchain_rpc"`. A
+response-level `meta.status=DATA_STATUS_UNAVAILABLE` can coexist with usable
+rows; check row freshness, valuation status, and
+`pinnedStableBalance.status` separately.
+
+#### Current wallet inventory
+
+Use the following non-paginated endpoint for the **Remaining in Wallet** card
+on both active and stopped copy runs:
+
+```http
+GET /copy-accounts/{chainId}/{copyAccount}/wallet-inventory
+```
+
+The endpoint returns the current token rows held by the Smart Wallet and a
+server-calculated account-wide USD total. It does not include open-position
+valuation, and it is not a replacement for `portfolioValueUsd`.
+
+| Field | Frontend behavior |
+| --- | --- |
+| `data` | Render the returned wallet-token rows. Each row uses the existing `WalletBalanceRow` contract. |
+| `walletInventoryValueUsd` | Use this `DecimalMetric` as the **Remaining in Wallet** total. Do not calculate another total from `data`. |
+| `complete` | A value of `true` means the bounded operator request proved that all wallet rows fit in one response. A value of `false` means the rows may be rendered, but they are not a complete inventory. |
+| `pinnedStableBalance` | Render the stable row separately only when its status is `PRESENT`. The API already counts it exactly once in `walletInventoryValueUsd`. |
+| `meta` | Apply the normal response metadata rules independently from the total metric and row-level freshness. |
+
+An abbreviated complete response has the following shape:
+
+```json
+{
+ "data": [
+ {
+ "chainId": "8453",
+ "copyAccount": "0x1111111111111111111111111111111111111111",
+ "tokenAddress": "0x2222222222222222222222222222222222222222",
+ "amountDecimal": "2",
+ "freshnessStatus": "fresh",
+ "currentValuation": {
+ "valueUsd": "5",
+ "status": "DATA_STATUS_CURRENT"
+ }
+ }
+ ],
+ "walletInventoryValueUsd": {
+ "value": "1005",
+ "status": "METRIC_STATUS_CURRENT",
+ "asOf": "2026-08-13T06:45:00Z"
+ },
+ "complete": true,
+ "pinnedStableBalance": {
+ "status": "PINNED_STABLE_BALANCE_STATUS_PRESENT",
+ "balance": {
+ "chainId": "8453",
+ "copyAccount": "0x1111111111111111111111111111111111111111",
+ "tokenAddress": "0x3333333333333333333333333333333333333333",
+ "amountDecimal": "1000",
+ "freshnessStatus": "fresh",
+ "currentValuation": {
+ "valueUsd": "1000",
+ "status": "DATA_STATUS_CURRENT"
+ }
+ }
+ }
+}
+```
+
+Apply these rules when rendering the total:
+
+1. Render `walletInventoryValueUsd.value` only when its status is
+ `METRIC_STATUS_CURRENT` or `METRIC_STATUS_STALE`. Show the normal stale-data
+ treatment for `METRIC_STATUS_STALE`.
+2. When `complete` is `false` or the metric status is
+ `METRIC_STATUS_UNAVAILABLE`, show an unavailable state. Do not sum `data`,
+ crawl `/balances`, or treat omitted assets as zero.
+3. Do not add `pinnedStableBalance.balance` to `walletInventoryValueUsd`; the
+ server total already includes a present stable row exactly once.
+4. Preserve an explicit value of `"0"`. It is a valid complete inventory
+ result, not missing data.
+5. Do not add open-position valuation or `availableBalanceUsd`. Those fields
+ answer different product questions.
+6. Treat a non-`PRESENT` pinned stable status as unavailable, not zero. The
+ total also becomes unavailable when any nonzero wallet asset lacks a valid
+ USD valuation.
+7. The total becomes `METRIC_STATUS_STALE` when any included balance or price
+ is stale. Its `asOf` is the oldest effective valuation time included in the
+ total.
+
+Use the cursor-paginated `/balances` endpoint only when the UI needs a
+page-by-page asset browser. It cannot be used to derive a stable account-wide
+total because pages are independent current reads.
+
+Pending obligations are current operator authority, while `skippedAt` and
+public error fields are optional aggregate display evidence. Never size a sell
+from the error text or a locally accumulated ratio. Use the exact
+`currentRatioRaw` values and current FIFO count returned immediately before
+preparation.
+
+## Transaction Preparation
+
+These routes prepare wallet calls. They do **not** submit transactions.
+
+Never construct or mutate calldata in the frontend. When an action is ready,
+submit the returned `data.call` exactly:
+
+```ts
+interface PreparedCall {
+ kind: string;
+ to: `0x${string}`; // Call target; not necessarily a swap recipient.
+ data: `0x${string}`;
+ valueRaw: "0";
+}
+```
+
+Common prepared-action statuses:
+
+```text
+PREPARED_ACTION_STATUS_READY
+PREPARED_ACTION_STATUS_PARTIALLY_COMPLETED
+PREPARED_ACTION_STATUS_COMPLETED
+PREPARED_ACTION_STATUS_PENDING
+PREPARED_ACTION_STATUS_UNAVAILABLE
+```
+
+| Status | Call present? | FE behavior |
+| --- | --- | --- |
+| `READY` | Yes | Show the preview and request wallet submission of the exact call. |
+| `PARTIALLY_COMPLETED` | Yes, Start Copy only | The account exists and the next funding call is ready. Submit it, confirm, then prepare again. |
+| `COMPLETED` | No | The requested state is already complete. Refresh reads and close the action flow. |
+| `PENDING` | No | Current evidence is not yet sufficient or an earlier transaction is still converging. Honor `reprepareAfter` when present and retry preparation. |
+| `UNAVAILABLE` | No | The action cannot currently execute. Render the typed `reason`; do not submit anything. |
+
+Prepared call kinds:
+
+```text
+PREPARED_CALL_KIND_START_COPY_CREATE
+PREPARED_CALL_KIND_START_COPY_FUND
+PREPARED_CALL_KIND_ADD_CAPITAL
+PREPARED_CALL_KIND_STOP_COPY
+PREPARED_CALL_KIND_WITHDRAW_QUOTE
+PREPARED_CALL_KIND_MANUAL_SELL
+PREPARED_CALL_KIND_CLOSE_POSITION
+```
+
+The response must contain the call kind expected for the route/stage. A
+mismatch is a client safety error: do not submit the call.
+
+Advisory availability fields on read responses are suitable for buttons and
+empty states, but the corresponding preparation response is authoritative.
+
+### Prepared Action Fields
+
+| Field | Meaning |
+| --- | --- |
+| `status` | Typed outcome described above. |
+| `chainId` | Chain on which the wallet call belongs. |
+| `expectedAccount` | Account expected to send the outer transaction. Compare it with the connected wallet/account. |
+| `copyAccount` | Optional Smart Wallet identity. It is absent only before a Start Copy account exists; it is not the call target. |
+| `preparedAt` | Time the preparation was produced. |
+| `reprepareAfter` | Only public expiry/retry boundary for the preparation. Discard the result after this time. |
+| `liquidationConfigDeadline` | Optional action-specific deadline. Do not submit after it. |
+| `call` | Exact reviewed EVM inner call, only when executable. |
+| `reason` | Stable typed reason for non-ready/advisory state. |
+| `warnings[]` | Allowlisted render-only qualifications. Warnings do not authorize changing calldata. |
+| `evidence` | Exact safely covered fact boundary and fresh action block used by preparation. |
+| one preview | Exactly one of `startCopy`, `addCapital`, `stopCopy`, `withdrawQuote`, `manualSell`, or `closePosition`. |
+
+Swap-producing previews use this nested shape:
+
+```ts
+interface SwapQuotePreview {
+ expectedQuote: RawAmountMetric;
+ minimumQuote: RawAmountMetric;
+ effectiveSlippageBps?: number;
+}
+```
+
+`expectedQuote` and `minimumQuote` always retain an explicit metric status;
+missing data is unavailable, never numeric zero. A present
+`effectiveSlippageBps: 0` is a real zero and must not be treated as absent.
+The Stop Copy total quote intentionally omits a synthetic aggregate slippage.
+Derive human display amounts/rates from the raw quote values and token decimals.
+There is no public route path, router recipient, price-impact, or server gas
+estimate. Estimate gas with the connected wallet/provider for the exact call.
+
+`evidence.evidenceAnchor` is the safely covered fact boundary (S/E), when one is
+required. `evidence.actionBlock` is the fresh canonical mutable-state/preflight
+block (H). The two blocks can differ. Display neither as “finalized” unless the
+product explicitly labels the operator-configured safe boundary that way.
+
+Warnings currently supported:
+
+```text
+PREPARED_ACTION_WARNING_ALLOCATION_STALE
+PREPARED_ACTION_WARNING_INVALID_STOP_INTENT_RECOVERED
+PREPARED_ACTION_WARNING_OWNER_SNAPSHOT_REQUIRES_REFRESH
+```
+
+Typed reasons currently supported:
+
+```text
+PREPARED_ACTION_REASON_ALREADY_ACTIVE
+PREPARED_ACTION_REASON_NOT_CURRENT_OWNER
+PREPARED_ACTION_REASON_ACCOUNT_NOT_ACTIVE
+PREPARED_ACTION_REASON_ACCOUNT_NOT_STOPPED
+PREPARED_ACTION_REASON_ACCOUNT_PERMANENTLY_PAUSED
+PREPARED_ACTION_REASON_EXIT_IN_PROGRESS
+PREPARED_ACTION_REASON_EXIT_NOT_TERMINAL
+PREPARED_ACTION_REASON_SOURCE_STALE
+PREPARED_ACTION_REASON_SOURCE_COVERAGE_PENDING
+PREPARED_ACTION_REASON_FACTORY_PAUSED
+PREPARED_ACTION_REASON_FEE_POLICY_CHANGED
+PREPARED_ACTION_REASON_SIGNER_POLICY_CHANGED
+PREPARED_ACTION_REASON_REQUEST_ID_CONFLICT
+PREPARED_ACTION_REASON_UNSUPPORTED_ACCOUNT_GENERATION
+PREPARED_ACTION_REASON_NO_QUOTE_BALANCE
+PREPARED_ACTION_REASON_INSUFFICIENT_QUOTE_BALANCE
+PREPARED_ACTION_REASON_INSUFFICIENT_QUOTE_ALLOWANCE
+PREPARED_ACTION_REASON_CONTROLLER_PAUSED
+PREPARED_ACTION_REASON_COPY_RUN_STOPPED
+PREPARED_ACTION_REASON_UNSUPPORTED_QUOTE_TOKEN
+PREPARED_ACTION_REASON_AMOUNT_BELOW_MINIMUM
+PREPARED_ACTION_REASON_INVALID_STOP_INTENT
+PREPARED_ACTION_REASON_NO_EXECUTABLE_ROUTE
+PREPARED_ACTION_REASON_INNER_CALL_REVERTED
+PREPARED_ACTION_REASON_NO_SELLABLE_BASE
+PREPARED_ACTION_REASON_NO_PENDING_SELL_OBLIGATION
+PREPARED_ACTION_REASON_SELL_OBLIGATION_CHANGED
+PREPARED_ACTION_REASON_POSITION_NOT_OPEN
+PREPARED_ACTION_REASON_CLOSE_NOT_ELIGIBLE
+```
+
+Treat reason names as localization keys. Do not display raw enum names to end
+users or infer an executable call from a reason.
+
+### Prepare Start Copy
+
+```http
+POST /users/{ownerAddress}/agents/{agentId}:prepareStartCopy
+```
+
+```json
+{
+ "chainId": "8453",
+ "targetCapitalRaw": "50000000",
+ "startRequestId": "3d7d7b58-72b2-4b7c-bf19-4ee9db355490",
+ "fundingMode": "START_COPY_FUNDING_MODE_UNFUNDED"
+}
+```
+
+`startRequestId` must be a UUIDv4. Keep the same ID while progressing one Start
+Copy attempt. `fundingMode` is required; omission/`UNSPECIFIED` is HTTP 400.
+Keep the target, funding mode, and permit intent stable while reusing that ID,
+because the canonical creation evidence is bound to the create amount and
+permit hash. Start Copy can be multi-stage: prepare, submit the returned call,
+wait for confirmation and refreshed reads, then prepare again until the
+response is complete.
+
+Funding modes:
+
+| Mode | Request contract | Create-stage behavior |
+| --- | --- | --- |
+| `START_COPY_FUNDING_MODE_UNFUNDED` | Omit `createPermitData`. | Creates the follower account without quote-token capital. A later preparation returns the separate funding call after canonical creation evidence is ready. |
+| `START_COPY_FUNDING_MODE_FUNDED` | The API uses the full `targetCapitalRaw` as the create amount. `createPermitData` is optional and, when supplied through protobuf JSON, is a base64 byte string with a maximum decoded length of 192 bytes. | Attempts account creation and full target funding in one call. Exact permit capability and format remain operator/token-policy decisions. |
+
+Funded example with permit transport:
+
+```json
+{
+ "chainId": "8453",
+ "targetCapitalRaw": "50000000",
+ "startRequestId": "3d7d7b58-72b2-4b7c-bf19-4ee9db355490",
+ "fundingMode": "START_COPY_FUNDING_MODE_FUNDED",
+ "createPermitData": ""
+}
+```
+
+Do not hex-encode `createPermitData`, include it in unfunded mode, write it to
+durable browser storage or logs, or expect it to be echoed in the response. A
+funded request can omit it when the wallet/token flow does not use permit;
+preparation remains authoritative for whether that request is executable. A
+permit-backed attempt must retain the exact bytes in volatile flow state until
+the Start Copy attempt reaches completion because creation evidence is bound to
+their hash.
+
+#### Funded authorization flow
+
+When a funded request has enough quote-token balance but not enough factory
+allowance, preparation returns HTTP 200 with:
+
+```json
+{
+ "data": {
+ "status": "PREPARED_ACTION_STATUS_UNAVAILABLE",
+ "reason": "PREPARED_ACTION_REASON_INSUFFICIENT_QUOTE_ALLOWANCE",
+ "startCopy": {
+ "stage": "START_COPY_STAGE_CREATE_REQUIRED",
+ "createAmountRaw": "50000000",
+ "allowanceRequirement": {
+ "spenderAddress": "0x...generation-factory...",
+ "currentAllowanceRaw": "0",
+ "requiredAllowanceRaw": "50000000",
+ "approvalScheme": "START_COPY_APPROVAL_SCHEME_STANDARD",
+ "permitScheme": "START_COPY_PERMIT_SCHEME_ERC20_EIP2612",
+ "eip712DomainName": "USD Coin",
+ "eip712DomainVersion": "2",
+ "eip712DomainKind": "START_COPY_EIP712_DOMAIN_KIND_CHAIN_ID"
+ }
+ }
+ }
+}
+```
+
+`allowanceRequirement` is present only with this reason. It is an exact-block
+diagnostic, not authorization to submit a transaction. The UI must use the
+returned `spenderAddress`; never hardcode a factory or infer it from an older
+agent response. `requiredAllowanceRaw` equals `createAmountRaw`.
+
+`permitScheme` is the operator-authoritative encoding choice. `approvalScheme`
+is the operator-authoritative ERC-20 fallback behavior. Do not select either
+path from a token symbol or infer it from a byte length:
+
+- `START_COPY_PERMIT_SCHEME_ALLOWANCE_ONLY`: the token has no reviewed permit
+ path. The EIP-712 domain fields are absent. Use `approvalScheme` to approve
+ `spenderAddress`, then reprepare funded mode. This is how a USDT-like token
+ is handled when the returned scheme says it is allowance-only; its symbol is
+ not evidence of that behavior.
+- `START_COPY_PERMIT_SCHEME_ERC20_EIP2612`: sign the token's EIP-712 Permit and
+ encode the reviewed 160-byte payload below, using the returned domain fields
+ and `eip712DomainKind`.
+- `START_COPY_PERMIT_SCHEME_ERC20_DAI_LIKE`: use the reviewed DAI-like permit
+ flow and its 192-byte payload with the returned domain fields and
+ `eip712DomainKind`; do not reuse the EIP-2612 encoder.
+
+For allowance-only responses:
+
+- `START_COPY_APPROVAL_SCHEME_STANDARD`: submit one normal `approve` for the
+ required amount to `spenderAddress`.
+- `START_COPY_APPROVAL_SCHEME_ZERO_THEN_SET`: if the current allowance is
+ nonzero, submit `approve(spenderAddress, 0)` first; then submit the normal
+ required-amount approval. Track both transactions, await each receipt, and
+ verify the intermediate zero and final required allowance before
+ repreparing. Do not reuse the current best-effort approval fallback that
+ discovers this behavior only after failed approval attempts.
+
+The API deliberately does not expose permit payload length. The exact scheme,
+not a token symbol or a numeric length, selects the encoder.
+
+Implementation note for kyberswap-interface: reuse `signTypedDataRaw`, the
+existing chain-ID and chain-ID-as-salt EIP-712 domain builders, signature
+parsing, transaction submission, smart-account detection, and bounded
+allowance refresh. Do not reuse the swap `usePermit` result or its Redux cache:
+its saved `rawSignature` ABI-encodes `owner` and `spender` too, and its cache
+identity omits this flow's spender, scheme, and domain. Start Copy needs a
+small authorization adapter scoped by account, chain, token, spender, scheme,
+domain, amount, nonce, and deadline/expiry, and must build the payload described
+below from the parsed signature.
+
+Native token permits carry an EOA `v/r/s` signature. When the connected owner
+is a smart-contract account, skip these native permit branches and use the
+returned `approvalScheme` fallback instead; do not assume EIP-1271 support from
+an ERC-2612 or DAI-like response.
+
+For `START_COPY_PERMIT_SCHEME_ERC20_EIP2612`, `createPermitData` is the
+protobuf-JSON base64 encoding of these ABI bytes:
+
+```text
+abi.encode(uint256 value, uint256 deadline, uint8 v, bytes32 r, bytes32 s)
+```
+
+This is the five EIP-2612 arguments only: no function selector, owner, or
+spender is included in the 160 bytes. Sign the token's EIP-712 Permit with:
+
+```text
+owner = connected owner wallet
+spender = allowanceRequirement.spenderAddress
+value = allowanceRequirement.requiredAllowanceRaw
+nonce = current quote-token nonce for owner
+deadline = a fresh UI-selected deadline
+chainId = response chainId
+verifyingContract = response startCopy.quoteToken.address
+name = allowanceRequirement.eip712DomainName
+version = allowanceRequirement.eip712DomainVersion
+```
+
+The returned `eip712DomainKind` selects the EIP-712 domain type exactly:
+
+- `START_COPY_EIP712_DOMAIN_KIND_CHAIN_ID`: reuse `EIP712_DOMAIN_TYPE` with
+ the response chain ID.
+- `START_COPY_EIP712_DOMAIN_KIND_CHAIN_ID_SALT`: reuse
+ `EIP712_DOMAIN_TYPE_SALT`, setting `salt` to `bytes32(chainId)`.
+
+`ALLOWANCE_ONLY` responses carry `UNSPECIFIED` and no domain fields. Do not
+infer a domain shape from a token symbol, name, version, or chain.
+
+For the Base USDC example above, the operator response carries EIP-712 name
+`USD Coin` and version `2`; `v` is encoded as `27` or `28`. The returned
+domain fields and a current token nonce are signing authority. Do not replace
+them with token-symbol rules or hardcoded catalog data.
+
+For `START_COPY_PERMIT_SCHEME_ERC20_DAI_LIKE`, sign the DAI-style typed value:
+
+```text
+holder = connected owner wallet
+spender = allowanceRequirement.spenderAddress
+nonce = current quote-token nonce for holder
+expiry = a fresh UI-selected expiry
+allowed = true
+chainId = response chainId
+verifyingContract = response startCopy.quoteToken.address
+name = allowanceRequirement.eip712DomainName
+version = allowanceRequirement.eip712DomainVersion
+```
+
+Then send the protobuf-JSON base64 encoding of:
+
+```text
+abi.encode(uint256 nonce, uint256 expiry, bool allowed, uint8 v, bytes32 r, bytes32 s)
+```
+
+This is a different typed-data schema and grants the DAI-like allowance form;
+it is not an EIP-2612 amount permit.
+
+Recommended funded flow:
+
+1. Prepare funded mode without permit using diagnostic UUID A.
+2. If preparation is already `READY`, submit its create call; no permit is
+ needed.
+3. If the reason is `INSUFFICIENT_QUOTE_ALLOWANCE`, branch on the returned
+ `allowanceRequirement` schemes:
+ - `ALLOWANCE_ONLY`: perform the `STANDARD` or `ZERO_THEN_SET` approval
+ sequence required by `approvalScheme`, then generate a new UUID and
+ reprepare funded mode without permit bytes. This path requires one or two
+ approval transactions before the create transaction.
+ - `ERC20_EIP2612`: sign and ABI-encode the five values above into the
+ reviewed 160-byte payload, using the returned EIP-712 domain kind.
+ - `ERC20_DAI_LIKE`: use only the reviewed DAI-like 192-byte encoder and
+ its returned EIP-712 domain kind.
+4. For a permit-backed attempt, generate UUID B and reprepare the same target
+ in funded mode with base64 `createPermitData`. Keep UUID B, target, funding
+ mode, and exact permit bytes stable for that attempt.
+5. Submit only the operator-authored create call returned as `READY`. A
+ permit-backed attempt remains one blockchain transaction: create plus full
+ initial capital.
+
+A permit can become stale after its nonce is consumed or its deadline expires;
+discard the old preparation and create a new UUID/signature pair.
+
+Stages:
+
+```text
+START_COPY_STAGE_CREATE_REQUIRED
+START_COPY_STAGE_CREATE_CONFIRMING
+START_COPY_STAGE_FUNDING_REQUIRED
+START_COPY_STAGE_COMPLETE
+```
+
+`CREATE_CONFIRMING` means the deterministic account exists with the exact
+reviewed live deployment graph, but its canonical creation/allocation evidence
+has not crossed the safe funding boundary. Do not resubmit the create call in
+this stage. Continue polling with the same UUID and target until
+`FUNDING_REQUIRED`, then submit only the newly returned funding call.
+
+`targetCapitalRaw` is a positive base-unit integer with at most 78 digits.
+`data.startCopy` includes the stage, request ID, predicted copy account, quote
+token, requested target, credited capital, remaining deficit, minimum initial
+capital, wallet quote balance, current advertised upfront-fee policy, and
+optional `createAmountRaw`. `createAmountRaw` is present only for a create
+stage and is `"0"` for an explicitly unfunded create. Permit bytes are never
+returned.
+
+Recommended loop:
+
+1. Generate one UUIDv4 when the user starts the flow.
+2. Prepare using that UUID, requested target, and explicit funding mode.
+3. Validate `expectedAccount`, `chainId`, status, stage, and call kind.
+4. Submit the exact call and wait for a successful receipt.
+5. Refresh relevant reads, then prepare again with the same UUID, target,
+ funding mode, and permit intent.
+ If the stage is `CREATE_CONFIRMING`, do not submit another transaction.
+6. Submit the funding call only after `FUNDING_REQUIRED` is returned.
+7. Finish only on `COMPLETED`/`START_COPY_STAGE_COMPLETE`.
+
+### Prepare Add Capital
+
+```http
+POST /users/{ownerAddress}/copy-runs/{copyRunId}:prepareAddCapital
+```
+
+```json
+{
+ "amountRaw": "10000000"
+}
+```
+
+`amountRaw` is a positive base-unit integer with at most 78 digits.
+`data.addCapital` contains the quote token, requested amount, minimum amount,
+wallet balance, current allocated capital, and resulting allocated capital.
+Every raw amount metric carries its own status.
+
+### Prepare Stop Copy
+
+```http
+POST /users/{ownerAddress}/copy-runs/{copyRunId}:prepareStopCopy
+```
+
+```json
+{
+ "userPositionIds": ["user_position_..."],
+ "slippageBps": 400
+}
+```
+
+- At most 32 position IDs.
+- The array can be empty when the current stop operation has no selected
+ sellable positions; preparation remains authoritative.
+- Each position ID is 1..256 characters.
+- `slippageBps` is an integer from 0 to 10,000.
+
+`data.stopCopy` contains at most 32 position previews and totals. Each row pins
+the `userPositionId`, `tradeId`, base token, user base amount, cashback,
+current valuation, lifecycle, unrealized P&L, and `swapQuote`. The stop-level
+`totalSwapQuote` carries total expected/minimum quote metrics. If the selectable
+position set changes, discard the old preparation and prepare again.
+
+### Prepare Withdraw Quote
+
+```http
+POST /users/{ownerAddress}/copy-runs/{copyRunId}:prepareWithdrawQuote
+```
+
+```json
+{}
+```
+
+`data.withdrawQuote` contains the quote token, status-bearing quote balance,
+and optional exact sweep amount and recipient. This is a repeatable max sweep;
+the recipient is current prepared state, not a client-selected field.
+
+### Prepare Manual Sell
+
+```http
+POST /users/{ownerAddress}/copy-runs/{copyRunId}/positions/{userPositionId}:prepareManualSell
+```
+
+```json
+{
+ "slippageBps": 400,
+ "expectedUnresolvedSkipCount": 1,
+ "expectedSellRatioRaw": "1000000000000000000"
+}
+```
+
+Obtain `expectedUnresolvedSkipCount` and `expectedSellRatioRaw` from the current
+pending-sell-obligation FIFO. If it changes, refresh the obligation list and
+prepare again.
+
+`expectedSellRatioRaw` must be in `(0, 1e18]`; the unresolved count must be
+positive. `data.manualSell` contains the recovery context, exact
+position/trade/token identity when covered, remaining base before, user sell
+amount, released upfront fee, ratio, unresolved count, cashback, and the
+preparation-scoped `swapQuote`. It intentionally excludes gross route input and
+router internals.
+
+### Prepare Close Position
+
+```http
+POST /users/{ownerAddress}/copy-runs/{copyRunId}/positions/{userPositionId}:prepareClosePosition
+```
+
+```json
+{
+ "slippageBps": 400
+}
+```
+
+Close Position uses the same `PositionSellPreview` shape. It is eligible only
+for a full-position recovery close under current operator state; otherwise the
+response is typed `PENDING` or `UNAVAILABLE`. Do not treat Close Position as a
+generic sell endpoint.
+
+## Preparation Authorization and Submission
+
+The pending contract has no wallet challenge or session endpoints. A successful
+preparation does not prove that the caller controls `ownerAddress`, does not
+authorize another wallet, and does not submit a transaction.
+
+For Manual Sell and Close Position, the execution boundary is:
+
+1. The aggregate API resolves the selected owner, copy run, and position and
+ asks exactly one operator for a preparation.
+2. The operator rechecks the live account, owner, position, and action state,
+ then builds and preflights a bounded call containing its
+ KS-signer-authorized payload.
+3. The frontend submits the exact returned `to`, `data`, and `valueRaw` from the
+ owner wallet.
+4. The follower-account contract requires the owner/admin caller and verifies
+ the signed payload, current state, and deadline before execution.
+
+This submission flow supports EOA and smart-contract wallet owners through
+their normal wallet transaction flow. The API no longer verifies an EOA or
+ERC-1271 proof and no longer stores a Copy Trade wallet session.
+
+Repeated preparation requests are allowed. There is no cross-replica issuance
+lease:
+
+- Treat every response as a short-lived snapshot and use only one selected
+ preparation for wallet submission.
+- Do not combine fields from different preparation responses.
+- The first successful state-changing transaction makes competing preparations
+ stale through their pinned state, nonce, amount, and deadline checks.
+- If submission fails because state changed or the preparation expired, refresh
+ the authoritative reads and prepare again.
+
+## Error Handling
+
+Non-2xx responses use:
+
+```json
+{
+ "code": 3,
+ "message": "invalid argument: ...",
+ "details": []
+}
+```
+
+Use the HTTP status as the primary control-flow signal and `message` as
+display/debug context.
+
+Common statuses observed or expected:
+
+| HTTP | Meaning |
+| --- | --- |
+| 400 | Invalid parameter, unsupported enum combination, or cursor mismatch |
+| 408 | Request was canceled |
+| 404 | Requested public resource not found |
+| 429 | Server action-preparation capacity is exhausted |
+| 500 | Internal request failure; the response is sanitized |
+| 503 | Temporarily unavailable; retry with bounded backoff |
+| 504 | Request deadline exceeded; retry with bounded backoff |
+
+Some upstream failed-precondition responses also map to HTTP 400. Use the typed
+prepared-action `status` and `reason` for normal product state; HTTP errors are
+request/transport failures.
+
+Retry guidance:
+
+- Do not retry 400 or 404 automatically.
+- On 429, honor `Retry-After` when present and reprepare; do not reuse a
+ previous call.
+- For 503 and 504, use a short bounded backoff and keep the UI state
+ recoverable.
+- A timed-out preparation request did not submit a chain transaction. It is
+ safe to request a fresh preparation, but never submit stale calldata merely
+ because the first HTTP response was lost.
+- If a list cursor receives 400, discard it and restart at page one with the
+ current filters.
+
+## Frontend Integration Patterns
+
+### Normalize list envelopes
+
+```ts
+type ListEnvelope = {
+ data?: T[];
+ pagination?: {
+ nextCursor?: string;
+ hasMore?: boolean;
+ limit?: number;
+ };
+ meta: ResponseMeta;
+};
+
+function normalizePage(body: ListEnvelope) {
+ return {
+ rows: body.data ?? [],
+ nextCursor: body.pagination?.nextCursor,
+ hasMore: body.pagination?.hasMore === true,
+ limit: body.pagination?.limit ?? 25,
+ meta: body.meta,
+ };
+}
+```
+
+Only append a page after the request succeeds. Deduplicate by the resource's
+stable ID as a defensive UI measure, but do not re-sort server pages.
+
+### Render a status-bearing metric
+
+```ts
+function metricText(metric?: {
+ value?: string;
+ status?: string;
+}): string {
+ if (!metric) return "—";
+ switch (metric.status) {
+ case "METRIC_STATUS_CURRENT":
+ case "METRIC_STATUS_STALE":
+ return metric.value ?? "—";
+ case "METRIC_STATUS_NOT_APPLICABLE":
+ case "METRIC_STATUS_UNAVAILABLE":
+ default:
+ return "—";
+ }
+}
+```
+
+Apply stale styling separately. Do not make `value === undefined` mean zero.
+
+### Preparation safety checks
+
+Before opening the wallet:
+
+1. Require `READY` or the Start-only `PARTIALLY_COMPLETED`.
+2. Require `data.call`.
+3. Require the route-appropriate `call.kind`.
+4. Require `chainId` to match the wallet network.
+5. Require `expectedAccount` to match the sending account.
+6. For non-Start actions, require `copyAccount` to match the selected Smart
+ Wallet. For Start create it is absent; confirming, funding, and complete
+ stages must match `startCopy.predictedCopyAccount`.
+7. Require `valueRaw === "0"`.
+8. Reject a response past `reprepareAfter` or
+ `liquidationConfigDeadline`.
+9. Submit `to`, `data`, and `valueRaw` unchanged.
+
+The browser should never ABI-encode a Copy Trade action from preview fields.
+
+### Refresh after a transaction
+
+Use the transaction receipt as the start of a refresh loop, not as proof that
+the aggregate API has already projected the state:
+
+1. Wait for a successful wallet receipt.
+2. Poll the direct copy-run/copy-account/position read.
+3. Require lifecycle/accounting to reflect the transaction and source metadata
+ to advance.
+4. Refresh the containing list/summary in the background.
+5. For multi-stage Start Copy, request a new preparation only after the detail
+ state has converged.
+
+Keep the loop bounded and offer a manual refresh if projection remains behind.
+
+## Complete HTTP Operation Index
+
+The pending public HTTP surface contains **32 operations**:
+
+- 26 GET reads;
+- 6 transaction-preparation POSTs.
+
+The two targeted copy-run/copy-account reads added after the original read
+surface are:
+
+```text
+GET /users/{ownerAddress}/copy-runs/{copyRunId}/cashback-policy
+GET /copy-accounts/{chainId}/{copyAccount}/wallet-inventory
+```
+
+There is no generated HTTP mapping for private operator transaction
+preparation, projector, or execution methods. The pending operator contract
+removes wallet-proof verification entirely. Frontend clients must use only the
+aggregate routes in this document.
+
+## Current Availability and Verification Status
+
+At `origin/main` commit
+`1b0d9e27b60dc02e960f4557232727c50dcf724b`, the generated OpenAPI contract
+still contains 34 public HTTP operations:
+
+- 26 GET read operations;
+- 6 transaction-preparation POST operations;
+- 2 wallet-session POST operations.
+
+The pending release removes the two wallet-session operations, leaving the 32
+operations in the index above. All remaining operations have concrete aggregate
+handlers. No remaining transaction-preparation route should be feature-gated as
+“not implemented.” Preparation routes do not broadcast transactions; they
+return a typed product outcome and, only when executable, an exact wallet call.
+
+Until the pending release is deployed, an environment may still expose the two
+historical session routes and require their bearer token for Manual Sell and
+Close Position. Frontend rollout must therefore be coordinated with the API
+deployment; do not infer the environment contract solely from this catalog's
+newest entry.
+
+PR #21 adds the current wallet-inventory read used by the **Remaining in
+Wallet** card. It is merged on `origin/main`; the older live pre-release smoke
+below does not prove that a particular environment has deployed it. Verify the
+deployed image before enabling the UI integration in that environment.
+
+### Live pre-release public-read smoke
+
+At **2026-08-12 00:36 UTC**, the following non-mutating checks reached
+pre-release:
+
+| Route | HTTP/result |
+| --- | --- |
+| `GET /api/v1/chains` | 200 with Base (`chainId = "8453"`) and `meta.status = DATA_STATUS_CURRENT` |
+| `GET /api/v1/agents?limit=1` | 200 with a cursor-paginated row and `meta.status = DATA_STATUS_CURRENT` |
+| `GET /docs/` | 200 HTML Swagger UI |
+
+This proves those deployed entry points were reachable at that timestamp. It
+does not prove every materializer, account-specific row, preparation outcome,
+or dependency was healthy, and it does not replace the source contract above.
+
+### Historical pre-release action smoke
+
+This is dated deployment evidence from **2026-07-30 07:56 UTC**, not proof that
+pre-release currently runs the source baseline above. No returned call was
+submitted. It predates the required `fundingMode` field and must not be used as
+a current Start Copy payload example. Representative requests produced:
+
+| Route | HTTP/result |
+| --- | --- |
+| `:prepareStartCopy` | 200 `READY`, `START_COPY_STAGE_CREATE_REQUIRED`, `PREPARED_CALL_KIND_START_COPY_CREATE` |
+| `:prepareAddCapital` | 200 `READY`, `PREPARED_CALL_KIND_ADD_CAPITAL` |
+| `:prepareStopCopy` | 200 `READY`, `PREPARED_CALL_KIND_STOP_COPY` |
+| `:prepareWithdrawQuote` | 200 typed `PREPARED_ACTION_STATUS_UNAVAILABLE` / `PREPARED_ACTION_REASON_ACCOUNT_NOT_STOPPED` for an active run |
+| `:prepareManualSell` | Historically available behind a wallet-session bearer token; the pending contract prepares directly |
+| `:prepareClosePosition` | Historically available behind a wallet-session bearer token; the pending contract prepares directly |
+| `/wallet-session-challenges` | Historical endpoint; removed by the pending contract |
+| `/wallet-sessions` | Historical endpoint; removed by the pending contract |
+
+The Withdraw result demonstrates an important integration rule: HTTP 200 with
+a typed `UNAVAILABLE`, `PENDING`, or `COMPLETED` result is normal product state,
+not an unavailable endpoint.
+
+### Read integration status
+
+All 26 GET operations are implemented and exposed by the generated gateway.
+Returned rows and freshness statuses depend on the selected fixture and current
+materializer/source state; do not encode point-in-time row counts into the
+frontend.
+
+Current integration rules that prevent known UI mismatches:
+
+- Use `/leaderboard` for qualification-ranked leaderboard rows and `/agents`
+ for agent discovery. They are distinct product lists.
+- Use owner-wide
+ `/users/{ownerAddress}/positions?view=POSITION_VIEW_CLOSED` for the History
+ page's complete closed-position/trade list.
+- Use `copy-runs?view=OWNER_COPY_VIEW_HISTORY` only for stopped/terminal copy
+ runs. It is not the source of all closed positions.
+- Use a run-scoped positions route only for a selected-run drilldown. A stopped
+ run that never completed a trade correctly returns an empty closed-position
+ page.
+- Fetch the run-scoped cashback-policy route only when the selected-run UI
+ needs effective fee/cashback details. Do not issue it once per list row or
+ replace it with the agent's advertised policy.
+- Use copy-account routes for one follower account's current inventory,
+ positions, balances, obligations, and activity.
+- Render stale data according to its status. Never replace unavailable data
+ with fabricated zeroes.
+
+Live pre-release data is diagnostic rather than contractual. When a response
+temporarily fails because an operator or external dependency is unavailable,
+keep the screen recoverable and follow the retry/error guidance above; do not
+reinterpret the operation as absent from the API.
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/Docs/IMPLEMENTATION_STATUS.md b/apps/kyberswap-interface/src/pages/CopyTrading/Docs/IMPLEMENTATION_STATUS.md
new file mode 100644
index 0000000000..79acd13b85
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/Docs/IMPLEMENTATION_STATUS.md
@@ -0,0 +1,424 @@
+# Copy Trading Implementation Status
+
+Last reviewed: 2026-08-20
+
+This is the single frontend-owned record for current code implementation,
+accepted product decisions, ownership, and static verification evidence. The
+current HTTP contract is documented in `FE_API_Catalog.md`; `openapi.yaml` is its
+machine-readable API source. Both contract files are backend-owned inputs. The
+checked-in `openapi.yaml` is synchronized byte-for-byte with the pre-release
+Swagger contract fetched on 2026-08-14.
+
+All 26 GET and 6 POST Copy Trading API operations in the current catalog are
+declared in the frontend service.
+
+## Implementation at a Glance
+
+| Layer | Current status |
+| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| BE API catalog | `CURRENT INPUT`: 32 public operations are documented. |
+| Checked-in OpenAPI | `CURRENT INPUT`: synchronized with the live 32-operation pre-release Swagger contract; wallet-session routes and Bearer security are removed. |
+| RTK Query service | `CODE-COMPLETE`: all 26 GET and 6 POST operations are declared and typed. |
+| Read UI | `CODE-COMPLETE`: all currently defined product surfaces are connected; 17 GET operations have UI consumers and nine service-only operations have no product surface. |
+| Write UX | `CODE-COMPLETE`: all six actions use prepared-action validation; Add Capital submits directly after preparation while the other review-bearing flows retain review. |
+| Write integration | `CODE-COMPLETE`: exact API-prepared calls, receipt-success completion, Start Copy list polling, stateless recovery preparation, and async cache refresh are connected. |
+
+## Changes Included Since the Previous Review
+
+The 2026-08-20 review also includes the Copy Trading commits between the prior
+status update and the current working tree:
+
+- `155ac5ebd` scopes wallet- and argument-sensitive RTK reads to `currentData`.
+ Agent actions, owner summaries, Copy Run performance, and Sidebar Open Copies
+ no longer retain a previous wallet, chain, Copy Run, or performance-window
+ result while the next query is pending. Open Copies also clears immediately
+ when no owner wallet is available.
+- `e1b98c55e` updates KPI icons and terminology, card sizing, Sidebar hierarchy
+ and navigation visuals, and the capital-input empty balance display.
+- `128783f4d` adds server-backed sorting to My Copies, standardizes prepared-flow
+ CTA hierarchy, uses red secondary Stop actions and a secondary Withdraw
+ action, shortens Agent metadata presentation, and highlights positive History
+ cashback.
+
+## Contract and Service Coverage
+
+`services/copyTrading/api/baseApi.ts` owns the shared `createApi` and
+`fetchBaseQuery` configuration, reducer, and middleware. Discovery, Agents,
+Copy Runs, Copy Accounts, and prepared actions each inject their endpoints
+directly into that shared API. Consumers import the endpoint group that owns
+the hook they use instead of relying on a later group as an endpoint superset.
+Together these endpoint groups declare all 32 public operations:
+
+- 26 GET queries, including the run-scoped effective cashback policy and
+ copy-account wallet inventory.
+- Six transaction-preparation mutations:
+ - Start Copy.
+ - Add Capital.
+ - Stop Copy.
+ - Withdraw Quote.
+ - Manual Sell.
+ - Close Position.
+
+Domain files under `services/copyTrading/adapters/` and
+`services/copyTrading/types/` own the compatibility boundary between API-native
+envelopes/enums and the existing UI models. Consumers import those ownership
+files directly; there are no top-level adapter or type re-export barrels.
+Shared request parameter normalization stays in `api/queryParams.ts`. Prepared
+action response and request contracts stay together in
+`types/preparedActions.ts`; activity and Agent action-log normalization stay
+together in `adapters/activity.ts`.
+
+Confirmed service behavior:
+
+- Owner views map to `OWNER_COPY_VIEW_OPEN` and
+ `OWNER_COPY_VIEW_HISTORY`.
+- Position filters map to `POSITION_VIEW_OPEN`, `CLOSED`, and `LEFTOVER`.
+- Agent action logs use `/action-logs`.
+- Empty pending-sell obligations normalize `data: null` to an empty list.
+- Status-bearing metrics preserve their raw metric objects while renderable
+ values are exposed only for `CURRENT` and `STALE`.
+- Position display amount prefers `displayBaseRaw`.
+- Copy Run lifecycle preserves `ACTIVE`, `CLOSING`, `STOPPED`, and `CLOSED`.
+- Position `ACTIVE` and `CLOSING` both map to compatibility `status: "open"`;
+ exact API lifecycle is preserved separately in `lifecycle`.
+
+## Current UI Read Coverage
+
+The current UI consumes these 17 GET operations:
+
+- Chains.
+- Leaderboard summary and leaderboard rows.
+- Agent profile, stats, performance, positions, and action logs.
+- Owner copy summary and copy runs.
+- Copy Run detail, positions, and performance.
+- Owner activity.
+- Copy-account wallet inventory for the `Remaining in Wallet` rows and
+ authoritative account-wide USD total.
+- Copy-account positions to refresh the selected recovery position immediately
+ before Manual Sell or Close Position preparation.
+- Pending sell obligations through the Manual Sell recovery modal. The complete
+ cursor-backed FIFO is preparation input, not a user-selected sell ratio.
+
+The following nine GET operations are declared but have no dedicated Copy
+Trading UI consumer:
+
+- Copy Run cashback policy. Its service contract is integrated, but no
+ fee/cashback product surface has been defined.
+- Agent discovery (`GET /agents`). The current Agent List uses the distinct
+ qualification-ranked `GET /leaderboard` collection.
+- Agent position detail.
+- Agent position events.
+- All owner positions.
+- Owner copy-account list.
+- Copy-account detail.
+- Copy-account balances.
+- Copy-account history.
+
+These are intentionally service-only until a product surface is defined. They
+are not open implementation work for the current Copy Trading scope.
+
+`Remaining in Wallet` uses the non-paginated wallet-inventory endpoint. It
+renders the server total only when the response is complete, its pinned stable
+balance is present, and the metric is current or stale. It never sums rows,
+position valuations, balance pages, or the pinned stable sidecar locally.
+
+Current primary-screen read behavior:
+
+- `WINDOW_ALL` uses monthly performance intervals; shorter windows use daily
+ intervals.
+- Copy Run badges preserve `ACTIVE`, `CLOSING`, `STOPPED`, and `CLOSED`.
+- Position lifecycle and quantity state render independently from typed fields.
+- Open and History remain server-owned Copy Run views. The frontend does not
+ locally move rows between them.
+- Agent Positions, Agent History, Action Logs, My Copies, Copy Run detail tabs,
+ and Alerts Feed cursor collections use infinite scroll
+ inside bounded scroll containers.
+- Copy History uses cursor-backed Previous / Page N / Next pagination with 5
+ rows per page. The API does not expose a total count, so the UI does not
+ invent numbered last-page navigation.
+- Cursor lists use TanStack `useInfiniteQuery` for the page/cursor chain and
+ invoke the existing RTK lazy query trigger from `queryFn`.
+- Copy Detail owns independent cursor chains for Open Positions, Closed
+ Positions, and owner activity filtered by `copyRunId`.
+- Agent and Copy Run performance charts intentionally request only the first
+ page with `limit=100`.
+- Sidebar Agents is a selected-chain snapshot with `limit=10`; Open Copies is
+ independently capped at `limit=10`.
+- Infinite-scroll collections intentionally have no manual Retry action. They
+ keep the error state until the query refetches or the surface remounts.
+- Copy-run rows use their `agentSnapshot`; My Copies and History do not issue a
+ redundant agent collection request.
+- Wallet- and argument-sensitive RTK reads consume `currentData`, so a result
+ cached under previous query arguments is not rendered while the current
+ request is pending. Sidebar Open Copies also requires a current owner.
+- My Copies supports server-backed sorting by Agent APR, Agent Win Rate, Agent
+ Volume, and Capital In. Repeated header selection cycles descending,
+ ascending, then the server default; each sort state owns a separate cursor
+ query chain.
+- Activity details are typed and Alerts Feed does not parse display summary text
+ for P&L direction.
+- Summary KPI cards identify `STALE` metrics; unavailable values remain `—`.
+- Owner screens show a dedicated disconnected-wallet state.
+
+## Accepted Product Decisions
+
+- Keep the nine currently unowned GET operations documented without inventing
+ routes or secondary tables.
+- Keep Agent and Copy Run performance at the first API page (`limit=100`).
+- Keep Sidebar Agents capped at 10 items for the selected network and Open
+ Copies capped at 10 items independently.
+- Open and History membership remains owned by the server response.
+- Stop Copy trusts the Copy Run passed by the entry point and loads the complete
+ open-position cursor chain once when the modal opens. It does not refetch that
+ list immediately before preparation. Manual Sell and Close Position use the
+ selected `PositionSummary` only to open the modal, then refresh the current
+ copy-account position before preparation. The preparation response remains
+ authoritative before any wallet submission.
+- The Stop Copy modal owns loading every open-position cursor page. An
+ incomplete or invalid cursor chain prevents preparation rather than
+ presenting a partial position list. Position-load failure has no separate
+ Retry control; the disabled action communicates that positions are
+ unavailable, consistent with other read-query error surfaces.
+- Infinite-scroll read surfaces show their error state without a manual Retry
+ button. Recovery is owned by a later query refetch or remount.
+- Withdraw trusts the Copy Run and availability passed from Copy Detail or Smart
+ Wallet. The modal does not reload either entity before preparation.
+- A write action is successful in the UI after its submitted transaction has a
+ successful receipt. Cache invalidation runs asynchronously and the UI does not
+ wait for backend indexing.
+- Start Copy explicitly uses `START_COPY_FUNDING_MODE_FUNDED`. When preparation
+ reports insufficient quote allowance, the checkbox-gated review exposes a
+ separate API-selected Permit or Approve action. Loading uses `Dots` without
+ changing that CTA label. The UI follows the returned permit, approval,
+ spender, and EIP-712 domain schemes, then starts a new UUID-bound attempt with
+ the exact volatile permit bytes or confirmed allowance. Once that attempt
+ returns `READY`, the review exposes a separate Start Copying action; approval
+ never auto-submits Create. The UI submits only the returned create call, then
+ polls the Agent-filtered open Copy list after its successful receipt. Every
+ list request is an independent bounded attempt; polling does not classify API
+ errors as retryable or non-retryable.
+- Start Copy and Add Capital share only the capital-entry domain: the supported
+ quote-token configuration, action-specific minimums, 25/50/75/100 presets,
+ wallet balance, decimal parsing, minimum/balance validation, and input UI.
+ Each flow still owns its availability and network guards, preparation request
+ validation, authorization or ownership rules, and navigation. Add Capital
+ owns its inline current/new allocation summary and has no review step.
+- Add Capital displays current allocation above the amount panel and the
+ client-projected new allocation below it as token amounts (`x SYMBOL`). Its
+ current value uses the existing canonical `capitalInUsd` display value with
+ the observed fallback because Copy Run summary has no raw allocated-token
+ field. Its CTA prepares, validates, simulates, and submits the returned call
+ directly.
+- All six write flows use the same prepared-action recovery and success
+ primitives. Review-bearing flows also use the shared review presentation.
+ Error and expired states expose Back and Try again actions; Add Capital retry
+ keeps its direct prepare-and-submit behavior. Success keeps Close outlined
+ while the primary destination remains flow-owned: My Copies for
+ Start/Add/Manual Sell/Close Position and History for Stop/Withdraw.
+- Stop Copy keeps position loading, selection, selection-cap validation, and
+ selected-ID validation local. Manual Sell and Close Position keep their
+ refreshed-position and FIFO validation in `ManagePositionModal`. These
+ concerns are not part of the shared capital abstraction used by Start Copy
+ and Add Capital. Stop and position actions share only the prepared-action
+ slippage control and default while retaining flow-local state and request
+ conversion to basis points.
+
+## Current Prepared-Action Write UI
+
+The production write path is split by ownership:
+
+- Each action folder under `modals/` owns its modal composition, action-specific
+ guards, preparation request and response validation, review or inline summary
+ metrics where applicable, tests, and destination navigation.
+- `modals/CapitalAmount/` owns the capital-entry state and UI shared by Start
+ Copy and Add Capital: fixed supported quote-token configuration,
+ action-specific minimums, wallet balance, presets, decimal parsing, and local
+ minimum/balance validation.
+- `modals/StartCopyModal/` owns UUID-bound attempt identity, Permit or Approve
+ authorization, and post-receipt completion polling. Its target and
+ completion-polling domain logic stays in `StartCopyModal/startCopy.ts`.
+- `modals/StopCopyModal/` owns its complete open-position load, local selection,
+ 32-position cap, slippage, and selected-ID payload validation.
+- `modals/ManagePositionModal/` owns the shared Manual Sell and Close Position
+ composition. The selected mode owns its required advertised action, current
+ position refresh, optional Manual Sell FIFO refresh, request validation,
+ review metrics, and success navigation.
+- `modals/WithdrawQuoteModal/` owns the non-editable max-sweep composition,
+ positive prepared amount and owner-recipient validation, review metrics, and
+ History navigation. It does not create client-owned amount or recipient state.
+- `modals/PreparedActionModal/requestPreparation.ts` owns preparation status
+ handling, bounded continuation polling, response validation, and transitions
+ into review, direct READY handoff, pending, unavailable, error, or
+ completed states.
+- `modals/PreparedActionModal/usePreparedAction.ts` owns exact wallet
+ simulation/submission, receipt wait, receipt retry without rebroadcast,
+ action-specific post-receipt work, and completion notification.
+- `modals/PreparedActionModal/index.tsx` owns the shared idle, review, wallet,
+ confirmation, syncing, unavailable, error, and success presentation,
+ including review-row skeletons, recovery actions, and the reusable success
+ action layout. Processing copy distinguishes wallet confirmation, submitted
+ transaction, and confirmed transaction states; recovery copy avoids internal
+ preparation terminology. Success uses one generic confirmation description;
+ titles and destinations remain action-specific.
+- `modals/PreparedActionModal/preparedAction.ts` owns the shared phase shape,
+ superseded-request versioning, pure parsing, formatting, preparation
+ validation, and retry timing. `helpers.ts` owns stateless formatting, reason
+ copy, and availability helpers shared with read screens.
+- Within `modals/StartCopyModal/`, `authorization.ts` validates the API-selected
+ allowance scheme, `permit.ts` builds and encodes supported EIP-712 permits,
+ `useApproval.ts` owns standard and zero-then-set approval lifecycles, and
+ `useAuthorization.ts` dispatches the selected Permit or Approve path.
+- `modals/context.tsx` owns only modal routing. `hooks/useRefreshCopyTrading.ts`
+ owns fire-and-forget RTK/TanStack invalidation of active Copy Trading reads.
+
+Implemented behavior:
+
+- Start Copy keeps one UUID, target amount, explicit funded mode, permit intent,
+ and predicted Smart Wallet stable within each attempt. A diagnostic
+ insufficient-allowance response does not bind its predicted Smart Wallet to
+ the authorized attempt. After the checkbox-gated Permit or Approve action
+ completes the exact operator-selected EIP-2612, DAI-like, standard approval,
+ or zero-then-set authorization, the UI creates UUID B, validates and captures
+ UUID B's predicted Smart Wallet, and returns to review. Permit bytes remain
+ only in volatile component state and are reused unchanged through completion.
+ The user must then press Start Copying to submit Create. The funded create
+ amount must equal the full target. Only
+ `PREPARED_CALL_KIND_START_COPY_CREATE` can reach wallet submission; a
+ separate Fund call fails closed. After the Create receipt, the UI polls the
+ open Copy Run list filtered by the exact Agent every two seconds for at most
+ twenty seconds; it does not call Start preparation again. Success exposes
+ Close and the My Copies destination.
+- Add Capital shows current allocation above the capital panel and the
+ client-projected new allocation below it as token-denominated values. Wallet
+ balance has an explicit spinner while its RPC read is pending. The Add Capital
+ CTA converts the decimal input to raw units, prepares and validates the exact
+ amount/call, then proceeds directly to wallet simulation and submission with
+ no intermediate review step.
+- Stop Copy fetches and renders the complete open-position list inside the modal.
+ It fetches once when the modal opens and does not refresh the list again before
+ preparation. The UI defaults at most 32 positions to selected, prevents
+ selecting a 33rd, and validates the final payload length before sending
+ `userPositionIds`. An empty array remains valid. A position-load failure
+ disables the review action without rendering a separate Retry control. Review
+ shows the selected-position count, estimated position value, estimated
+ cashback, and both expected and minimum total quote received.
+- All six write flows use shared prepared-action recovery states. Flows that
+ retain review use shared review rows and skeletons for server-owned values.
+ Add Capital remains on its editable inline-summary view during preparation
+ and proceeds directly to wallet submission when preparation returns READY.
+- Withdraw is exposed only when the selected Copy Run status is `STOPPED`, then
+ gated by `withdrawQuoteAvailability`. It sends `{}` to preparation and
+ requires a positive prepared amount and connected-owner recipient. Review
+ renders the prepared available balance, exact withdrawal amount, and recipient;
+ success exposes Close and the History destination.
+- Manual Sell refreshes the selected copy-account position and complete
+ pending-obligation cursor chain. It uses the FIFO head ratio and total
+ unresolved FIFO count. The refreshed position must still advertise Manual
+ Sell before preparation. FIFO obligation count remains request validation and
+ is not exposed as a user-facing review metric.
+- Close Position refreshes the selected copy-account position before direct
+ preparation; the original row controls the initial CTA presentation only and
+ the refreshed position must still advertise Close Position.
+- Both position actions use the shared four-preset/custom slippage control. The
+ review renders remaining and sold base amounts, returned upfront fee, expected
+ and minimum quote, quote-token cashback, and effective slippage; Manual Sell
+ also renders its FIFO ratio as the user-facing `Portion to sell`. Success
+ exposes Close and the My Copies destination.
+- Manual Sell and Close Position call their preparation routes directly without
+ a challenge, access token, or Authorization header. The owner wallet still
+ simulates and submits the exact returned call.
+- `call.to`, `call.data`, and `call.valueRaw` are simulated and submitted
+ unchanged through the gated wallet client.
+- A receipt retry waits for the already-submitted hash and never sends the
+ prepared call again.
+- A reverted receipt keeps its hash for display, but Retry starts a fresh
+ preparation and does not treat the reverted transaction as post-receipt
+ continuation.
+- A submitted transaction is shown as confirmed only after a successful receipt.
+- A user retry from `PENDING` waits until `reprepareAfter` before preparing again.
+- Immediately after a successful receipt, flows invalidate active RTK and
+ TanStack Copy Trading reads so their network refetches start without blocking
+ post-receipt synchronization or success UI. Agent Stats and Agent Performance
+ participate in the same RTK invalidation.
+
+## Action Integration Matrix
+
+| Capability | Current production UI |
+| -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Start Copy | Uses the API-selected Permit or Approve step, submits Create separately, then polls the Agent-filtered open Copy list and links to My Copies. |
+| Add Capital | Shows current/new token allocation inline, then prepares, validates, simulates, and submits the exact call without a separate review step. |
+| Stop Copy | Loads all open-position pages when opened, supports zero to 32 selected IDs, validates the payload cap, and submits the exact prepared call. |
+| Withdraw Quote | Only a `STOPPED` Copy Detail exposes the availability-gated CTA; amount and owner recipient are server-prepared and non-editable. |
+| Manual Sell | Refreshes the current position and authoritative FIFO, rechecks availability, then reviews the complete position-sell preview and prepares directly. |
+| Close Position | Refreshes the current position, rechecks availability, then reviews the complete position-sell preview and prepares directly. |
+
+## Implemented Write Invariants
+
+Every connected action follows this boundary:
+
+```text
+read advisory availability
+→ collect the action-owned inputs
+→ call the matching preparation endpoint
+→ inspect status, reason, preview, evidence, and exact call
+→ for funded Start authorization, use a separate Permit or Approve action for the exact returned token/spender/scheme
+→ re-prepare with a new UUID and require a separate Start Copying action for the READY Create call
+→ validate owner, chain, preview, Smart Wallet, call kind, target, value, and expiry
+→ simulate and submit call.to / call.data / call.valueRaw unchanged
+→ wait for a successful receipt
+→ invalidate affected RTK and TanStack reads asynchronously
+→ after the funded Start Create transaction, poll the Agent-filtered open Copy list every 2s for at most 20s
+→ mark the action successful after its action-specific completion work
+```
+
+The implementation fails closed when advisory availability is missing,
+unspecified, pending, or unavailable. Preparation remains authoritative, and
+`PENDING`, `UNAVAILABLE`, expired results, unexpected previews/stages/call kinds,
+or mismatched ownership never reach wallet submission.
+
+Start and Add use the fixed supported quote token for user input conversion.
+Start renders its preparation-owned review values. Add renders its current/new
+allocation summary before preparation, then still requires a validated READY
+response before direct wallet submission. Stop accepts an empty selection.
+Manual Sell has no arbitrary percentage input. Withdraw has no user-owned amount
+or recipient input.
+
+Prepared Smart Wallet identity is distinct from both `call.to` and
+`expectedAccount`. A diagnostic insufficient-allowance UUID does not bind the
+authorized UUID's predicted account. Start captures the authorized UUID's
+predicted account and rejects any later stage within that attempt that changes
+it. A review is discarded after `reprepareAfter` or
+`liquidationConfigDeadline`.
+
+Repeated stateless preparation calls are allowed, but the UI keeps only the
+latest request's response. An older response that resolves after a newer
+request is discarded, and starting wallet submission invalidates any competing
+preparation snapshot.
+
+Manual Sell and Close Position preparation is stateless. A returned preparation
+does not authorize execution by another wallet; the connected owner still
+submits the exact call and the follower-account contract enforces its caller.
+
+## Implementation Completion
+
+The currently defined Copy Trading code scope is complete. All owned read
+surfaces and all six write flows are implemented, connected to the typed service
+layer, and assigned to explicit shared or feature-local owners. There are no
+open `TODO` or `FIXME` markers in the Copy Trading implementation. Product
+surfaces that have not been defined and browser or live-transaction validation
+are outside this code-implementation status.
+
+## Verification
+
+- The checked-in `openapi.yaml` matches the live pre-release Swagger contract
+ fetched on 2026-08-14: 32 paths and 128 definitions.
+- The service surface contains 26 GET queries and 6 POST mutations.
+- All six preparation mutations have an owned UI flow.
+- The local ABI, mock signer, and mock transaction-hash path have been removed.
+- All 45 Copy Trading unit tests pass, including the direct READY handoff test.
+- Commit review for this status covers `155ac5ebd`, `e1b98c55e`, and
+ `128783f4d` in addition to the current staged and unstaged working-tree
+ changes.
+- For the 2026-08-20 Add Capital update, app TypeScript, targeted ESLint,
+ Prettier, and `git diff --check` pass. Browser QA, a production build, and a
+ positive Add Capital transaction E2E were not run for this update.
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/Docs/openapi.yaml b/apps/kyberswap-interface/src/pages/CopyTrading/Docs/openapi.yaml
new file mode 100644
index 0000000000..ee226cd715
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/Docs/openapi.yaml
@@ -0,0 +1,3529 @@
+swagger: "2.0"
+info:
+ title: AI Copy Trade Aggregate API
+ description: UI-facing read API for AI copy trading
+ version: 1.0.0
+tags:
+ - name: Chains
+ description: Public chain metadata.
+ - name: Leaderboard
+ description: Public agent ranking and leaderboard summary reads.
+ - name: Agents
+ description: Public agent discovery, profile, and position reads.
+ - name: Owner Copies
+ description: Copy-run, position, activity, and copy-account reads filtered by the initial follower-account creation wallet; this is not current ownership or authorization evidence.
+ - name: Copy Accounts
+ description: Chain-scoped copy account balances, positions, history, and summary reads.
+ - name: Transaction Preparation
+ description: Prepare authoritative Copy Trade contract calls for wallet-owned execution.
+basePath: /api/v1
+schemes:
+ - https
+consumes:
+ - application/json
+produces:
+ - application/json
+paths:
+ /chains:
+ get:
+ summary: ListChains lists enabled public chain metadata.
+ operationId: listChains
+ responses:
+ "200":
+ description: A successful response.
+ schema:
+ $ref: '#/definitions/v1ListChainsResponse'
+ default:
+ description: An unexpected error response.
+ schema:
+ $ref: '#/definitions/rpcStatus'
+ tags:
+ - Chains
+ /leaderboard/summary:
+ get:
+ summary: GetLeaderboardSummary returns summary cards for the filtered leaderboard universe.
+ operationId: getLeaderboardSummary
+ responses:
+ "200":
+ description: A successful response.
+ schema:
+ $ref: '#/definitions/v1GetLeaderboardSummaryResponse'
+ default:
+ description: An unexpected error response.
+ schema:
+ $ref: '#/definitions/rpcStatus'
+ parameters:
+ - name: chainId
+ in: query
+ required: false
+ type: string
+ format: int64
+ - name: search
+ in: query
+ required: false
+ type: string
+ - name: strategyCategory
+ in: query
+ required: false
+ type: string
+ enum:
+ - STRATEGY_CATEGORY_UNSPECIFIED
+ - STRATEGY_CATEGORY_FOCUSED
+ - STRATEGY_CATEGORY_DIVERSIFIED
+ - STRATEGY_CATEGORY_ACTIVE
+ default: STRATEGY_CATEGORY_UNSPECIFIED
+ tags:
+ - Leaderboard
+ /leaderboard:
+ get:
+ summary: ListLeaderboard returns leaderboard agent rows.
+ operationId: listLeaderboard
+ responses:
+ "200":
+ description: A successful response.
+ schema:
+ $ref: '#/definitions/v1ListLeaderboardResponse'
+ default:
+ description: An unexpected error response.
+ schema:
+ $ref: '#/definitions/rpcStatus'
+ parameters:
+ - name: chainId
+ in: query
+ required: false
+ type: string
+ format: int64
+ - name: search
+ in: query
+ required: false
+ type: string
+ - name: cursor
+ in: query
+ required: false
+ type: string
+ - name: limit
+ in: query
+ required: false
+ type: integer
+ format: int32
+ - name: strategyCategory
+ in: query
+ required: false
+ type: string
+ enum:
+ - STRATEGY_CATEGORY_UNSPECIFIED
+ - STRATEGY_CATEGORY_FOCUSED
+ - STRATEGY_CATEGORY_DIVERSIFIED
+ - STRATEGY_CATEGORY_ACTIVE
+ default: STRATEGY_CATEGORY_UNSPECIFIED
+ - name: sortBy
+ in: query
+ required: false
+ type: string
+ enum:
+ - LEADERBOARD_SORT_FIELD_UNSPECIFIED
+ - LEADERBOARD_SORT_FIELD_APR_30D
+ - LEADERBOARD_SORT_FIELD_WIN_RATE
+ - LEADERBOARD_SORT_FIELD_LIFETIME_VOLUME
+ - LEADERBOARD_SORT_FIELD_COPIERS
+ - LEADERBOARD_SORT_FIELD_AUM
+ - LEADERBOARD_SORT_FIELD_OPEN_POSITIONS
+ default: LEADERBOARD_SORT_FIELD_UNSPECIFIED
+ - name: sortOrder
+ in: query
+ required: false
+ type: string
+ enum:
+ - SORT_ORDER_UNSPECIFIED
+ - SORT_ORDER_ASC
+ - SORT_ORDER_DESC
+ default: SORT_ORDER_UNSPECIFIED
+ tags:
+ - Leaderboard
+ /agents:
+ get:
+ summary: ListAgents searches and lists public agents.
+ operationId: listAgents
+ responses:
+ "200":
+ description: A successful response.
+ schema:
+ $ref: '#/definitions/v1ListAgentsResponse'
+ default:
+ description: An unexpected error response.
+ schema:
+ $ref: '#/definitions/rpcStatus'
+ parameters:
+ - name: chainId
+ in: query
+ required: false
+ type: string
+ format: int64
+ - name: search
+ in: query
+ required: false
+ type: string
+ - name: cursor
+ in: query
+ required: false
+ type: string
+ - name: limit
+ in: query
+ required: false
+ type: integer
+ format: int32
+ - name: strategyCategory
+ in: query
+ required: false
+ type: string
+ enum:
+ - STRATEGY_CATEGORY_UNSPECIFIED
+ - STRATEGY_CATEGORY_FOCUSED
+ - STRATEGY_CATEGORY_DIVERSIFIED
+ - STRATEGY_CATEGORY_ACTIVE
+ default: STRATEGY_CATEGORY_UNSPECIFIED
+ tags:
+ - Agents
+ /agents/{agentId}:
+ get:
+ summary: GetAgent returns one public agent profile.
+ operationId: getAgent
+ responses:
+ "200":
+ description: A successful response.
+ schema:
+ $ref: '#/definitions/v1GetAgentResponse'
+ default:
+ description: An unexpected error response.
+ schema:
+ $ref: '#/definitions/rpcStatus'
+ parameters:
+ - name: agentId
+ in: path
+ required: true
+ type: string
+ tags:
+ - Agents
+ /agents/{agentId}/stats:
+ get:
+ summary: GetAgentStats returns one agent metric window.
+ operationId: getAgentStats
+ responses:
+ "200":
+ description: A successful response.
+ schema:
+ $ref: '#/definitions/v1GetAgentStatsResponse'
+ default:
+ description: An unexpected error response.
+ schema:
+ $ref: '#/definitions/rpcStatus'
+ parameters:
+ - name: agentId
+ in: path
+ required: true
+ type: string
+ - name: window
+ in: query
+ required: false
+ type: string
+ enum:
+ - WINDOW_UNSPECIFIED
+ - WINDOW_7D
+ - WINDOW_30D
+ - WINDOW_90D
+ - WINDOW_ALL
+ default: WINDOW_UNSPECIFIED
+ tags:
+ - Agents
+ /agents/{agentId}/performance:
+ get:
+ summary: ListAgentPerformance returns profile chart points.
+ operationId: listAgentPerformance
+ responses:
+ "200":
+ description: A successful response.
+ schema:
+ $ref: '#/definitions/v1ListAgentPerformanceResponse'
+ default:
+ description: An unexpected error response.
+ schema:
+ $ref: '#/definitions/rpcStatus'
+ parameters:
+ - name: agentId
+ in: path
+ required: true
+ type: string
+ - name: cursor
+ in: query
+ required: false
+ type: string
+ - name: limit
+ in: query
+ required: false
+ type: integer
+ format: int32
+ - name: series
+ in: query
+ required: false
+ type: string
+ enum:
+ - PERFORMANCE_SERIES_UNSPECIFIED
+ - PERFORMANCE_SERIES_PORTFOLIO_EQUITY
+ - PERFORMANCE_SERIES_CUMULATIVE_REALIZED_PNL
+ - PERFORMANCE_SERIES_PERIOD_REALIZED_PNL
+ - PERFORMANCE_SERIES_PER_TRADE_REALIZED_PNL
+ default: PERFORMANCE_SERIES_UNSPECIFIED
+ - name: window
+ in: query
+ required: false
+ type: string
+ enum:
+ - WINDOW_UNSPECIFIED
+ - WINDOW_7D
+ - WINDOW_30D
+ - WINDOW_90D
+ - WINDOW_ALL
+ default: WINDOW_UNSPECIFIED
+ - name: interval
+ in: query
+ required: false
+ type: string
+ enum:
+ - PERFORMANCE_INTERVAL_UNSPECIFIED
+ - PERFORMANCE_INTERVAL_DAY
+ - PERFORMANCE_INTERVAL_WEEK
+ - PERFORMANCE_INTERVAL_MONTH
+ default: PERFORMANCE_INTERVAL_UNSPECIFIED
+ tags:
+ - Agents
+ /agents/{agentId}/action-logs:
+ get:
+ summary: ListAgentActionLogs returns the sanitized public agent decision timeline.
+ operationId: listAgentActionLogs
+ responses:
+ "200":
+ description: A successful response.
+ schema:
+ $ref: '#/definitions/v1ListAgentActionLogsResponse'
+ default:
+ description: An unexpected error response.
+ schema:
+ $ref: '#/definitions/rpcStatus'
+ parameters:
+ - name: agentId
+ in: path
+ required: true
+ type: string
+ - name: leaderPositionId
+ in: query
+ required: false
+ type: string
+ - name: from
+ in: query
+ required: false
+ type: string
+ format: date-time
+ - name: to
+ in: query
+ required: false
+ type: string
+ format: date-time
+ - name: cursor
+ in: query
+ required: false
+ type: string
+ - name: limit
+ in: query
+ required: false
+ type: integer
+ format: int32
+ - name: type
+ description: |-
+ Exact match against AgentActionLog.action. Filtering is applied before
+ grouping, so every returned row matches this value.
+ in: query
+ required: false
+ type: string
+ - name: groupBy
+ description: |-
+ Omitted/UNSPECIFIED currently defaults to SESSION_ID. The enum remains
+ explicit so future grouping modes can be added without changing the
+ response item type again.
+ in: query
+ required: false
+ type: string
+ enum:
+ - AGENT_ACTION_LOG_GROUP_BY_UNSPECIFIED
+ - AGENT_ACTION_LOG_GROUP_BY_SESSION_ID
+ default: AGENT_ACTION_LOG_GROUP_BY_UNSPECIFIED
+ tags:
+ - Agents
+ /agents/{agentId}/positions:
+ get:
+ summary: ListAgentPositions returns agent position summary rows.
+ operationId: listAgentPositions
+ responses:
+ "200":
+ description: A successful response.
+ schema:
+ $ref: '#/definitions/v1ListAgentPositionsResponse'
+ default:
+ description: An unexpected error response.
+ schema:
+ $ref: '#/definitions/rpcStatus'
+ parameters:
+ - name: agentId
+ in: path
+ required: true
+ type: string
+ - name: view
+ in: query
+ required: false
+ type: string
+ enum:
+ - POSITION_VIEW_UNSPECIFIED
+ - POSITION_VIEW_ALL
+ - POSITION_VIEW_OPEN
+ - POSITION_VIEW_CLOSED
+ - POSITION_VIEW_LEFTOVER
+ default: POSITION_VIEW_UNSPECIFIED
+ - name: token
+ in: query
+ required: false
+ type: string
+ - name: cursor
+ in: query
+ required: false
+ type: string
+ - name: limit
+ in: query
+ required: false
+ type: integer
+ format: int32
+ - name: sortBy
+ in: query
+ required: false
+ type: string
+ enum:
+ - POSITION_SORT_FIELD_UNSPECIFIED
+ - POSITION_SORT_FIELD_OPENED_AT
+ - POSITION_SORT_FIELD_CLOSED_AT
+ - POSITION_SORT_FIELD_VALUE_USD
+ default: POSITION_SORT_FIELD_UNSPECIFIED
+ - name: sortOrder
+ in: query
+ required: false
+ type: string
+ enum:
+ - SORT_ORDER_UNSPECIFIED
+ - SORT_ORDER_ASC
+ - SORT_ORDER_DESC
+ default: SORT_ORDER_UNSPECIFIED
+ tags:
+ - Agents
+ /agents/{agentId}/positions/{positionId}:
+ get:
+ summary: GetAgentPosition returns one agent position detail.
+ operationId: getAgentPosition
+ responses:
+ "200":
+ description: A successful response.
+ schema:
+ $ref: '#/definitions/v1GetAgentPositionResponse'
+ default:
+ description: An unexpected error response.
+ schema:
+ $ref: '#/definitions/rpcStatus'
+ parameters:
+ - name: agentId
+ in: path
+ required: true
+ type: string
+ - name: positionId
+ in: path
+ required: true
+ type: string
+ tags:
+ - Agents
+ /agents/{agentId}/positions/{positionId}/events:
+ get:
+ summary: ListAgentPositionEvents returns lifecycle events for an agent position.
+ operationId: listAgentPositionEvents
+ responses:
+ "200":
+ description: A successful response.
+ schema:
+ $ref: '#/definitions/v1ListAgentPositionEventsResponse'
+ default:
+ description: An unexpected error response.
+ schema:
+ $ref: '#/definitions/rpcStatus'
+ parameters:
+ - name: agentId
+ in: path
+ required: true
+ type: string
+ - name: positionId
+ in: path
+ required: true
+ type: string
+ - name: cursor
+ in: query
+ required: false
+ type: string
+ - name: limit
+ in: query
+ required: false
+ type: integer
+ format: int32
+ tags:
+ - Agents
+ /users/{ownerAddress}/copy-summary:
+ get:
+ summary: GetOwnerCopySummary returns public My Copies summary values for an owner.
+ operationId: getOwnerCopySummary
+ responses:
+ "200":
+ description: A successful response.
+ schema:
+ $ref: '#/definitions/v1GetOwnerCopySummaryResponse'
+ default:
+ description: An unexpected error response.
+ schema:
+ $ref: '#/definitions/rpcStatus'
+ parameters:
+ - name: ownerAddress
+ description: Initial follower-account creation wallet filter; not current ownership or authorization evidence.
+ in: path
+ required: true
+ type: string
+ - name: chainId
+ in: query
+ required: false
+ type: string
+ format: int64
+ - name: view
+ in: query
+ required: false
+ type: string
+ enum:
+ - OWNER_COPY_VIEW_UNSPECIFIED
+ - OWNER_COPY_VIEW_OPEN
+ - OWNER_COPY_VIEW_HISTORY
+ default: OWNER_COPY_VIEW_UNSPECIFIED
+ tags:
+ - Owner Copies
+ /users/{ownerAddress}/copy-runs:
+ get:
+ summary: ListOwnerCopyRuns lists copy runs for an owner.
+ operationId: listOwnerCopyRuns
+ responses:
+ "200":
+ description: A successful response.
+ schema:
+ $ref: '#/definitions/v1ListOwnerCopyRunsResponse'
+ default:
+ description: An unexpected error response.
+ schema:
+ $ref: '#/definitions/rpcStatus'
+ parameters:
+ - name: ownerAddress
+ description: Initial follower-account creation wallet filter; not current ownership or authorization evidence.
+ in: path
+ required: true
+ type: string
+ - name: agentId
+ in: query
+ required: false
+ type: string
+ - name: chainId
+ in: query
+ required: false
+ type: string
+ format: int64
+ - name: cursor
+ in: query
+ required: false
+ type: string
+ - name: limit
+ in: query
+ required: false
+ type: integer
+ format: int32
+ - name: view
+ in: query
+ required: false
+ type: string
+ enum:
+ - OWNER_COPY_VIEW_UNSPECIFIED
+ - OWNER_COPY_VIEW_OPEN
+ - OWNER_COPY_VIEW_HISTORY
+ default: OWNER_COPY_VIEW_UNSPECIFIED
+ - name: sortBy
+ in: query
+ required: false
+ type: string
+ enum:
+ - OWNER_COPY_RUN_SORT_FIELD_UNSPECIFIED
+ - OWNER_COPY_RUN_SORT_FIELD_STARTED_AT
+ - OWNER_COPY_RUN_SORT_FIELD_STOPPED_AT
+ - OWNER_COPY_RUN_SORT_FIELD_AGENT_APR_30D
+ - OWNER_COPY_RUN_SORT_FIELD_AGENT_WIN_RATE
+ - OWNER_COPY_RUN_SORT_FIELD_AGENT_LIFETIME_VOLUME
+ - OWNER_COPY_RUN_SORT_FIELD_CAPITAL_IN
+ default: OWNER_COPY_RUN_SORT_FIELD_UNSPECIFIED
+ - name: sortOrder
+ in: query
+ required: false
+ type: string
+ enum:
+ - SORT_ORDER_UNSPECIFIED
+ - SORT_ORDER_ASC
+ - SORT_ORDER_DESC
+ default: SORT_ORDER_UNSPECIFIED
+ tags:
+ - Owner Copies
+ /users/{ownerAddress}/copy-runs/{copyRunId}:
+ get:
+ summary: GetOwnerCopyRun returns one owner copy-run detail.
+ operationId: getOwnerCopyRun
+ responses:
+ "200":
+ description: A successful response.
+ schema:
+ $ref: '#/definitions/v1GetOwnerCopyRunResponse'
+ default:
+ description: An unexpected error response.
+ schema:
+ $ref: '#/definitions/rpcStatus'
+ parameters:
+ - name: ownerAddress
+ description: Initial follower-account creation wallet filter; not current ownership or authorization evidence.
+ in: path
+ required: true
+ type: string
+ - name: copyRunId
+ in: path
+ required: true
+ type: string
+ tags:
+ - Owner Copies
+ /users/{ownerAddress}/copy-runs/{copyRunId}/cashback-policy:
+ get:
+ summary: |-
+ GetOwnerCopyRunCashbackPolicy returns the effective account-owned
+ cashback policy for exactly one persisted owner/copy-run identity.
+ operationId: getOwnerCopyRunCashbackPolicy
+ responses:
+ "200":
+ description: A successful response.
+ schema:
+ $ref: '#/definitions/v1GetOwnerCopyRunCashbackPolicyResponse'
+ default:
+ description: An unexpected error response.
+ schema:
+ $ref: '#/definitions/rpcStatus'
+ parameters:
+ - name: ownerAddress
+ description: Initial follower-account creation wallet filter; not current ownership or authorization evidence.
+ in: path
+ required: true
+ type: string
+ - name: copyRunId
+ in: path
+ required: true
+ type: string
+ tags:
+ - Owner Copies
+ /users/{ownerAddress}/copy-runs/{copyRunId}/positions:
+ get:
+ summary: ListOwnerCopyRunPositions lists positions inside one copy run.
+ operationId: listOwnerCopyRunPositions
+ responses:
+ "200":
+ description: A successful response.
+ schema:
+ $ref: '#/definitions/v1ListOwnerCopyRunPositionsResponse'
+ default:
+ description: An unexpected error response.
+ schema:
+ $ref: '#/definitions/rpcStatus'
+ parameters:
+ - name: ownerAddress
+ description: Initial follower-account creation wallet filter; not current ownership or authorization evidence.
+ in: path
+ required: true
+ type: string
+ - name: copyRunId
+ in: path
+ required: true
+ type: string
+ - name: cursor
+ in: query
+ required: false
+ type: string
+ - name: limit
+ in: query
+ required: false
+ type: integer
+ format: int32
+ - name: view
+ in: query
+ required: false
+ type: string
+ enum:
+ - POSITION_VIEW_UNSPECIFIED
+ - POSITION_VIEW_ALL
+ - POSITION_VIEW_OPEN
+ - POSITION_VIEW_CLOSED
+ - POSITION_VIEW_LEFTOVER
+ default: POSITION_VIEW_UNSPECIFIED
+ - name: sortBy
+ in: query
+ required: false
+ type: string
+ enum:
+ - POSITION_SORT_FIELD_UNSPECIFIED
+ - POSITION_SORT_FIELD_OPENED_AT
+ - POSITION_SORT_FIELD_CLOSED_AT
+ - POSITION_SORT_FIELD_VALUE_USD
+ default: POSITION_SORT_FIELD_UNSPECIFIED
+ - name: sortOrder
+ in: query
+ required: false
+ type: string
+ enum:
+ - SORT_ORDER_UNSPECIFIED
+ - SORT_ORDER_ASC
+ - SORT_ORDER_DESC
+ default: SORT_ORDER_UNSPECIFIED
+ tags:
+ - Owner Copies
+ /users/{ownerAddress}/copy-runs/{copyRunId}/performance:
+ get:
+ summary: ListOwnerCopyRunPerformance returns copy-run chart points.
+ operationId: listOwnerCopyRunPerformance
+ responses:
+ "200":
+ description: A successful response.
+ schema:
+ $ref: '#/definitions/v1ListOwnerCopyRunPerformanceResponse'
+ default:
+ description: An unexpected error response.
+ schema:
+ $ref: '#/definitions/rpcStatus'
+ parameters:
+ - name: ownerAddress
+ description: Initial follower-account creation wallet filter; not current ownership or authorization evidence.
+ in: path
+ required: true
+ type: string
+ - name: copyRunId
+ in: path
+ required: true
+ type: string
+ - name: cursor
+ in: query
+ required: false
+ type: string
+ - name: limit
+ in: query
+ required: false
+ type: integer
+ format: int32
+ - name: series
+ in: query
+ required: false
+ type: string
+ enum:
+ - PERFORMANCE_SERIES_UNSPECIFIED
+ - PERFORMANCE_SERIES_PORTFOLIO_EQUITY
+ - PERFORMANCE_SERIES_CUMULATIVE_REALIZED_PNL
+ - PERFORMANCE_SERIES_PERIOD_REALIZED_PNL
+ - PERFORMANCE_SERIES_PER_TRADE_REALIZED_PNL
+ default: PERFORMANCE_SERIES_UNSPECIFIED
+ - name: window
+ in: query
+ required: false
+ type: string
+ enum:
+ - WINDOW_UNSPECIFIED
+ - WINDOW_7D
+ - WINDOW_30D
+ - WINDOW_90D
+ - WINDOW_ALL
+ default: WINDOW_UNSPECIFIED
+ - name: interval
+ in: query
+ required: false
+ type: string
+ enum:
+ - PERFORMANCE_INTERVAL_UNSPECIFIED
+ - PERFORMANCE_INTERVAL_DAY
+ - PERFORMANCE_INTERVAL_WEEK
+ - PERFORMANCE_INTERVAL_MONTH
+ default: PERFORMANCE_INTERVAL_UNSPECIFIED
+ tags:
+ - Owner Copies
+ /users/{ownerAddress}/positions:
+ get:
+ summary: ListOwnerPositions lists flattened owner positions.
+ operationId: listOwnerPositions
+ responses:
+ "200":
+ description: A successful response.
+ schema:
+ $ref: '#/definitions/v1ListOwnerPositionsResponse'
+ default:
+ description: An unexpected error response.
+ schema:
+ $ref: '#/definitions/rpcStatus'
+ parameters:
+ - name: ownerAddress
+ description: Initial follower-account creation wallet filter; not current ownership or authorization evidence.
+ in: path
+ required: true
+ type: string
+ - name: agentId
+ in: query
+ required: false
+ type: string
+ - name: chainId
+ in: query
+ required: false
+ type: string
+ format: int64
+ - name: cursor
+ in: query
+ required: false
+ type: string
+ - name: limit
+ in: query
+ required: false
+ type: integer
+ format: int32
+ - name: view
+ in: query
+ required: false
+ type: string
+ enum:
+ - POSITION_VIEW_UNSPECIFIED
+ - POSITION_VIEW_ALL
+ - POSITION_VIEW_OPEN
+ - POSITION_VIEW_CLOSED
+ - POSITION_VIEW_LEFTOVER
+ default: POSITION_VIEW_UNSPECIFIED
+ - name: sortBy
+ in: query
+ required: false
+ type: string
+ enum:
+ - POSITION_SORT_FIELD_UNSPECIFIED
+ - POSITION_SORT_FIELD_OPENED_AT
+ - POSITION_SORT_FIELD_CLOSED_AT
+ - POSITION_SORT_FIELD_VALUE_USD
+ default: POSITION_SORT_FIELD_UNSPECIFIED
+ - name: sortOrder
+ in: query
+ required: false
+ type: string
+ enum:
+ - SORT_ORDER_UNSPECIFIED
+ - SORT_ORDER_ASC
+ - SORT_ORDER_DESC
+ default: SORT_ORDER_UNSPECIFIED
+ tags:
+ - Owner Copies
+ /users/{ownerAddress}/activity:
+ get:
+ summary: ListOwnerActivity lists public owner activity rows.
+ operationId: listOwnerActivity
+ responses:
+ "200":
+ description: A successful response.
+ schema:
+ $ref: '#/definitions/v1ListOwnerActivityResponse'
+ default:
+ description: An unexpected error response.
+ schema:
+ $ref: '#/definitions/rpcStatus'
+ parameters:
+ - name: ownerAddress
+ description: Initial follower-account creation wallet filter; not current ownership or authorization evidence.
+ in: path
+ required: true
+ type: string
+ - name: copyRunId
+ in: query
+ required: false
+ type: string
+ - name: chainId
+ in: query
+ required: false
+ type: string
+ format: int64
+ - name: cursor
+ in: query
+ required: false
+ type: string
+ - name: limit
+ in: query
+ required: false
+ type: integer
+ format: int32
+ - name: type
+ in: query
+ required: false
+ type: string
+ enum:
+ - ACTIVITY_TYPE_UNSPECIFIED
+ - ACTIVITY_TYPE_COPY_STARTED
+ - ACTIVITY_TYPE_COPY_STOPPED
+ - ACTIVITY_TYPE_POSITION_OPENED
+ - ACTIVITY_TYPE_POSITION_CLOSED
+ - ACTIVITY_TYPE_CAPITAL_DEPOSITED
+ - ACTIVITY_TYPE_CAPITAL_TOPPED_UP
+ - ACTIVITY_TYPE_CAPITAL_WITHDRAWN
+ - ACTIVITY_TYPE_CAPITAL_RETURNED
+ - ACTIVITY_TYPE_FLAT_FEE_CAPTURED
+ - ACTIVITY_TYPE_CASHBACK_RECEIVED
+ - ACTIVITY_TYPE_ALIGNED_TRADE_SKIPPED
+ - ACTIVITY_TYPE_EXIT_STARTED
+ - ACTIVITY_TYPE_EXIT_SUCCEEDED
+ - ACTIVITY_TYPE_EXIT_SKIPPED
+ - ACTIVITY_TYPE_EXIT_FAILED
+ - ACTIVITY_TYPE_EXECUTION_FAILED
+ - ACTIVITY_TYPE_POSITION_REDUCED
+ default: ACTIVITY_TYPE_UNSPECIFIED
+ - name: group
+ in: query
+ required: false
+ type: string
+ enum:
+ - ACTIVITY_GROUP_UNSPECIFIED
+ - ACTIVITY_GROUP_BUYS
+ - ACTIVITY_GROUP_SELLS
+ - ACTIVITY_GROUP_DEPOSITS_WITHDRAWALS
+ - ACTIVITY_GROUP_SKIPPED
+ default: ACTIVITY_GROUP_UNSPECIFIED
+ tags:
+ - Owner Copies
+ /users/{ownerAddress}/copy-accounts:
+ get:
+ summary: ListOwnerCopyAccounts lists copy accounts for an owner.
+ operationId: listOwnerCopyAccounts
+ responses:
+ "200":
+ description: A successful response.
+ schema:
+ $ref: '#/definitions/v1ListOwnerCopyAccountsResponse'
+ default:
+ description: An unexpected error response.
+ schema:
+ $ref: '#/definitions/rpcStatus'
+ parameters:
+ - name: ownerAddress
+ description: Initial follower-account creation wallet filter; not current ownership or authorization evidence.
+ in: path
+ required: true
+ type: string
+ - name: chainId
+ in: query
+ required: false
+ type: string
+ format: int64
+ - name: cursor
+ in: query
+ required: false
+ type: string
+ - name: limit
+ in: query
+ required: false
+ type: integer
+ format: int32
+ - name: status
+ in: query
+ required: false
+ type: string
+ enum:
+ - COPY_ACCOUNT_STATUS_UNSPECIFIED
+ - COPY_ACCOUNT_STATUS_ACTIVE
+ - COPY_ACCOUNT_STATUS_CLOSED
+ - COPY_ACCOUNT_STATUS_CLOSING
+ - COPY_ACCOUNT_STATUS_STOPPED
+ default: COPY_ACCOUNT_STATUS_UNSPECIFIED
+ tags:
+ - Owner Copies
+ /copy-accounts/{chainId}/{copyAccount}:
+ get:
+ summary: GetCopyAccountSummary returns one chain-scoped copy account summary.
+ operationId: getCopyAccountSummary
+ responses:
+ "200":
+ description: A successful response.
+ schema:
+ $ref: '#/definitions/v1GetCopyAccountSummaryResponse'
+ default:
+ description: An unexpected error response.
+ schema:
+ $ref: '#/definitions/rpcStatus'
+ parameters:
+ - name: chainId
+ in: path
+ required: true
+ type: string
+ format: int64
+ - name: copyAccount
+ in: path
+ required: true
+ type: string
+ tags:
+ - Copy Accounts
+ /copy-accounts/{chainId}/{copyAccount}/balances:
+ get:
+ summary: ListCopyAccountBalances lists explicit wallet inventory for a copy account.
+ operationId: listCopyAccountBalances
+ responses:
+ "200":
+ description: A successful response.
+ schema:
+ $ref: '#/definitions/v1ListCopyAccountBalancesResponse'
+ default:
+ description: An unexpected error response.
+ schema:
+ $ref: '#/definitions/rpcStatus'
+ parameters:
+ - name: chainId
+ in: path
+ required: true
+ type: string
+ format: int64
+ - name: copyAccount
+ in: path
+ required: true
+ type: string
+ - name: cursor
+ in: query
+ required: false
+ type: string
+ - name: limit
+ in: query
+ required: false
+ type: integer
+ format: int32
+ tags:
+ - Copy Accounts
+ /copy-accounts/{chainId}/{copyAccount}/wallet-inventory:
+ get:
+ summary: |-
+ GetCopyAccountWalletInventory returns the current wallet rows and an
+ account-wide USD total only when the bounded operator source proves that
+ all rows were returned from one request. An incomplete source remains
+ renderable but returns an unavailable total.
+ operationId: getCopyAccountWalletInventory
+ responses:
+ "200":
+ description: A successful response.
+ schema:
+ $ref: '#/definitions/v1GetCopyAccountWalletInventoryResponse'
+ default:
+ description: An unexpected error response.
+ schema:
+ $ref: '#/definitions/rpcStatus'
+ parameters:
+ - name: chainId
+ in: path
+ required: true
+ type: string
+ format: int64
+ - name: copyAccount
+ in: path
+ required: true
+ type: string
+ tags:
+ - Copy Accounts
+ /copy-accounts/{chainId}/{copyAccount}/positions:
+ get:
+ summary: ListCopyAccountPositions lists positions for a copy account.
+ operationId: listCopyAccountPositions
+ responses:
+ "200":
+ description: A successful response.
+ schema:
+ $ref: '#/definitions/v1ListCopyAccountPositionsResponse'
+ default:
+ description: An unexpected error response.
+ schema:
+ $ref: '#/definitions/rpcStatus'
+ parameters:
+ - name: chainId
+ in: path
+ required: true
+ type: string
+ format: int64
+ - name: copyAccount
+ in: path
+ required: true
+ type: string
+ - name: cursor
+ in: query
+ required: false
+ type: string
+ - name: limit
+ in: query
+ required: false
+ type: integer
+ format: int32
+ - name: view
+ in: query
+ required: false
+ type: string
+ enum:
+ - POSITION_VIEW_UNSPECIFIED
+ - POSITION_VIEW_ALL
+ - POSITION_VIEW_OPEN
+ - POSITION_VIEW_CLOSED
+ - POSITION_VIEW_LEFTOVER
+ default: POSITION_VIEW_UNSPECIFIED
+ - name: sortBy
+ in: query
+ required: false
+ type: string
+ enum:
+ - POSITION_SORT_FIELD_UNSPECIFIED
+ - POSITION_SORT_FIELD_OPENED_AT
+ - POSITION_SORT_FIELD_CLOSED_AT
+ - POSITION_SORT_FIELD_VALUE_USD
+ default: POSITION_SORT_FIELD_UNSPECIFIED
+ - name: sortOrder
+ in: query
+ required: false
+ type: string
+ enum:
+ - SORT_ORDER_UNSPECIFIED
+ - SORT_ORDER_ASC
+ - SORT_ORDER_DESC
+ default: SORT_ORDER_UNSPECIFIED
+ tags:
+ - Copy Accounts
+ /copy-accounts/{chainId}/{copyAccount}/positions/{userPositionId}/pending-sell-obligations:
+ get:
+ summary: |-
+ ListCopyAccountPositionPendingSellObligations returns the current
+ operator-authoritative FIFO used by Manual Sell and Close Position modals.
+ operationId: listCopyAccountPositionPendingSellObligations
+ responses:
+ "200":
+ description: A successful response.
+ schema:
+ $ref: '#/definitions/v1ListCopyAccountPositionPendingSellObligationsResponse'
+ default:
+ description: An unexpected error response.
+ schema:
+ $ref: '#/definitions/rpcStatus'
+ parameters:
+ - name: chainId
+ in: path
+ required: true
+ type: string
+ format: int64
+ - name: copyAccount
+ in: path
+ required: true
+ type: string
+ - name: userPositionId
+ in: path
+ required: true
+ type: string
+ - name: cursor
+ in: query
+ required: false
+ type: string
+ - name: limit
+ in: query
+ required: false
+ type: integer
+ format: int32
+ tags:
+ - Copy Accounts
+ /copy-accounts/{chainId}/{copyAccount}/history:
+ get:
+ summary: ListCopyAccountHistory lists balance and execution history for a copy account.
+ operationId: listCopyAccountHistory
+ responses:
+ "200":
+ description: A successful response.
+ schema:
+ $ref: '#/definitions/v1ListCopyAccountHistoryResponse'
+ default:
+ description: An unexpected error response.
+ schema:
+ $ref: '#/definitions/rpcStatus'
+ parameters:
+ - name: chainId
+ in: path
+ required: true
+ type: string
+ format: int64
+ - name: copyAccount
+ in: path
+ required: true
+ type: string
+ - name: cursor
+ in: query
+ required: false
+ type: string
+ - name: limit
+ in: query
+ required: false
+ type: integer
+ format: int32
+ - name: type
+ in: query
+ required: false
+ type: string
+ enum:
+ - ACTIVITY_TYPE_UNSPECIFIED
+ - ACTIVITY_TYPE_COPY_STARTED
+ - ACTIVITY_TYPE_COPY_STOPPED
+ - ACTIVITY_TYPE_POSITION_OPENED
+ - ACTIVITY_TYPE_POSITION_CLOSED
+ - ACTIVITY_TYPE_CAPITAL_DEPOSITED
+ - ACTIVITY_TYPE_CAPITAL_TOPPED_UP
+ - ACTIVITY_TYPE_CAPITAL_WITHDRAWN
+ - ACTIVITY_TYPE_CAPITAL_RETURNED
+ - ACTIVITY_TYPE_FLAT_FEE_CAPTURED
+ - ACTIVITY_TYPE_CASHBACK_RECEIVED
+ - ACTIVITY_TYPE_ALIGNED_TRADE_SKIPPED
+ - ACTIVITY_TYPE_EXIT_STARTED
+ - ACTIVITY_TYPE_EXIT_SUCCEEDED
+ - ACTIVITY_TYPE_EXIT_SKIPPED
+ - ACTIVITY_TYPE_EXIT_FAILED
+ - ACTIVITY_TYPE_EXECUTION_FAILED
+ - ACTIVITY_TYPE_POSITION_REDUCED
+ default: ACTIVITY_TYPE_UNSPECIFIED
+ - name: group
+ in: query
+ required: false
+ type: string
+ enum:
+ - ACTIVITY_GROUP_UNSPECIFIED
+ - ACTIVITY_GROUP_BUYS
+ - ACTIVITY_GROUP_SELLS
+ - ACTIVITY_GROUP_DEPOSITS_WITHDRAWALS
+ - ACTIVITY_GROUP_SKIPPED
+ default: ACTIVITY_GROUP_UNSPECIFIED
+ tags:
+ - Copy Accounts
+ /users/{ownerAddress}/agents/{agentId}:prepareStartCopy:
+ post:
+ operationId: prepareStartCopy
+ responses:
+ "200":
+ description: A successful response.
+ schema:
+ $ref: '#/definitions/v1PrepareStartCopyResponse'
+ default:
+ description: An unexpected error response.
+ schema:
+ $ref: '#/definitions/rpcStatus'
+ parameters:
+ - name: ownerAddress
+ in: path
+ required: true
+ type: string
+ - name: agentId
+ in: path
+ required: true
+ type: string
+ - name: body
+ in: body
+ required: true
+ schema:
+ $ref: '#/definitions/TransactionPreparationServicePrepareStartCopyBody'
+ tags:
+ - Transaction Preparation
+ /users/{ownerAddress}/copy-runs/{copyRunId}:prepareAddCapital:
+ post:
+ operationId: prepareAddCapital
+ responses:
+ "200":
+ description: A successful response.
+ schema:
+ $ref: '#/definitions/v1PrepareAddCapitalResponse'
+ default:
+ description: An unexpected error response.
+ schema:
+ $ref: '#/definitions/rpcStatus'
+ parameters:
+ - name: ownerAddress
+ in: path
+ required: true
+ type: string
+ - name: copyRunId
+ in: path
+ required: true
+ type: string
+ - name: body
+ in: body
+ required: true
+ schema:
+ $ref: '#/definitions/TransactionPreparationServicePrepareAddCapitalBody'
+ tags:
+ - Transaction Preparation
+ /users/{ownerAddress}/copy-runs/{copyRunId}:prepareStopCopy:
+ post:
+ operationId: prepareStopCopy
+ responses:
+ "200":
+ description: A successful response.
+ schema:
+ $ref: '#/definitions/v1PrepareStopCopyResponse'
+ default:
+ description: An unexpected error response.
+ schema:
+ $ref: '#/definitions/rpcStatus'
+ parameters:
+ - name: ownerAddress
+ in: path
+ required: true
+ type: string
+ - name: copyRunId
+ in: path
+ required: true
+ type: string
+ - name: body
+ in: body
+ required: true
+ schema:
+ $ref: '#/definitions/TransactionPreparationServicePrepareStopCopyBody'
+ tags:
+ - Transaction Preparation
+ /users/{ownerAddress}/copy-runs/{copyRunId}:prepareWithdrawQuote:
+ post:
+ operationId: prepareWithdrawQuote
+ responses:
+ "200":
+ description: A successful response.
+ schema:
+ $ref: '#/definitions/v1PrepareWithdrawQuoteResponse'
+ default:
+ description: An unexpected error response.
+ schema:
+ $ref: '#/definitions/rpcStatus'
+ parameters:
+ - name: ownerAddress
+ in: path
+ required: true
+ type: string
+ - name: copyRunId
+ in: path
+ required: true
+ type: string
+ - name: body
+ in: body
+ required: true
+ schema:
+ $ref: '#/definitions/TransactionPreparationServicePrepareWithdrawQuoteBody'
+ tags:
+ - Transaction Preparation
+ /users/{ownerAddress}/copy-runs/{copyRunId}/positions/{userPositionId}:prepareManualSell:
+ post:
+ summary: PrepareManualSell prepares the exact unresolved skipped-sell obligation.
+ operationId: prepareManualSell
+ responses:
+ "200":
+ description: A successful response.
+ schema:
+ $ref: '#/definitions/v1PrepareManualSellResponse'
+ default:
+ description: An unexpected error response.
+ schema:
+ $ref: '#/definitions/rpcStatus'
+ parameters:
+ - name: ownerAddress
+ in: path
+ required: true
+ type: string
+ - name: copyRunId
+ in: path
+ required: true
+ type: string
+ - name: userPositionId
+ in: path
+ required: true
+ type: string
+ - name: body
+ in: body
+ required: true
+ schema:
+ $ref: '#/definitions/TransactionPreparationServicePrepareManualSellBody'
+ tags:
+ - Transaction Preparation
+ /users/{ownerAddress}/copy-runs/{copyRunId}/positions/{userPositionId}:prepareClosePosition:
+ post:
+ summary: PrepareClosePosition prepares one eligible full-position recovery close.
+ operationId: prepareClosePosition
+ responses:
+ "200":
+ description: A successful response.
+ schema:
+ $ref: '#/definitions/v1PrepareClosePositionResponse'
+ default:
+ description: An unexpected error response.
+ schema:
+ $ref: '#/definitions/rpcStatus'
+ parameters:
+ - name: ownerAddress
+ in: path
+ required: true
+ type: string
+ - name: copyRunId
+ in: path
+ required: true
+ type: string
+ - name: userPositionId
+ in: path
+ required: true
+ type: string
+ - name: body
+ in: body
+ required: true
+ schema:
+ $ref: '#/definitions/TransactionPreparationServicePrepareClosePositionBody'
+ tags:
+ - Transaction Preparation
+definitions:
+ TransactionPreparationServicePrepareAddCapitalBody:
+ type: object
+ properties:
+ amountRaw:
+ type: string
+ TransactionPreparationServicePrepareClosePositionBody:
+ type: object
+ properties:
+ slippageBps:
+ type: integer
+ format: int64
+ TransactionPreparationServicePrepareManualSellBody:
+ type: object
+ properties:
+ slippageBps:
+ type: integer
+ format: int64
+ expectedUnresolvedSkipCount:
+ type: integer
+ format: int64
+ expectedSellRatioRaw:
+ type: string
+ TransactionPreparationServicePrepareStartCopyBody:
+ type: object
+ properties:
+ chainId:
+ type: string
+ format: int64
+ targetCapitalRaw:
+ type: string
+ startRequestId:
+ type: string
+ fundingMode:
+ $ref: '#/definitions/v1StartCopyFundingMode'
+ createPermitData:
+ type: string
+ format: byte
+ description: |-
+ Optional opaque permit transport for FUNDED mode. Token-specific format
+ and capability checks remain operator-owned.
+ TransactionPreparationServicePrepareStopCopyBody:
+ type: object
+ properties:
+ userPositionIds:
+ type: array
+ items:
+ type: string
+ slippageBps:
+ type: integer
+ format: int64
+ TransactionPreparationServicePrepareWithdrawQuoteBody:
+ type: object
+ protobufAny:
+ type: object
+ properties:
+ '@type':
+ type: string
+ additionalProperties: {}
+ rpcStatus:
+ type: object
+ properties:
+ code:
+ type: integer
+ format: int32
+ message:
+ type: string
+ details:
+ type: array
+ items:
+ type: object
+ $ref: '#/definitions/protobufAny'
+ v1ActionBlock:
+ type: object
+ properties:
+ blockNumber:
+ type: string
+ blockHash:
+ type: string
+ blockTime:
+ type: string
+ format: date-time
+ description: ActionBlock is the fresh canonical mutable-state and preflight block H.
+ v1ActionEvidence:
+ type: object
+ properties:
+ evidenceAnchor:
+ $ref: '#/definitions/v1EvidenceAnchor'
+ actionBlock:
+ $ref: '#/definitions/v1ActionBlock'
+ description: |-
+ ActionEvidence exposes the fact and mutable-state boundaries used to prepare
+ the call. Operator-owned route clocks remain internal; reprepare_after is the
+ only client expiry boundary.
+ v1ActivityGroup:
+ type: string
+ enum:
+ - ACTIVITY_GROUP_UNSPECIFIED
+ - ACTIVITY_GROUP_BUYS
+ - ACTIVITY_GROUP_SELLS
+ - ACTIVITY_GROUP_DEPOSITS_WITHDRAWALS
+ - ACTIVITY_GROUP_SKIPPED
+ default: ACTIVITY_GROUP_UNSPECIFIED
+ description: ActivityGroup selects one stable product activity grouping.
+ v1ActivityRow:
+ type: object
+ properties:
+ activityId:
+ type: string
+ ownerAddress:
+ type: string
+ description: Initial follower-account creation wallet; not current ownership or authorization evidence.
+ agentId:
+ type: string
+ chainId:
+ type: string
+ format: int64
+ copyRunId:
+ type: string
+ copyAccount:
+ type: string
+ summary:
+ type: string
+ occurredAt:
+ type: string
+ format: date-time
+ type:
+ $ref: '#/definitions/v1ActivityType'
+ userPositionId:
+ type: string
+ followerPositionId:
+ type: string
+ tradeId:
+ type: string
+ txHash:
+ type: string
+ agentDisplayName:
+ type: string
+ agentAvatarUrl:
+ type: string
+ copyLifecycle:
+ $ref: '#/definitions/v1CopyLifecycleActivityDetail'
+ position:
+ $ref: '#/definitions/v1PositionActivityDetail'
+ capital:
+ $ref: '#/definitions/v1CapitalActivityDetail'
+ fee:
+ $ref: '#/definitions/v1FeeActivityDetail'
+ execution:
+ $ref: '#/definitions/v1ExecutionActivityDetail'
+ description: ActivityRow is a public owner or copy-account timeline row.
+ v1ActivityType:
+ type: string
+ enum:
+ - ACTIVITY_TYPE_UNSPECIFIED
+ - ACTIVITY_TYPE_COPY_STARTED
+ - ACTIVITY_TYPE_COPY_STOPPED
+ - ACTIVITY_TYPE_POSITION_OPENED
+ - ACTIVITY_TYPE_POSITION_CLOSED
+ - ACTIVITY_TYPE_CAPITAL_DEPOSITED
+ - ACTIVITY_TYPE_CAPITAL_TOPPED_UP
+ - ACTIVITY_TYPE_CAPITAL_WITHDRAWN
+ - ACTIVITY_TYPE_CAPITAL_RETURNED
+ - ACTIVITY_TYPE_FLAT_FEE_CAPTURED
+ - ACTIVITY_TYPE_CASHBACK_RECEIVED
+ - ACTIVITY_TYPE_ALIGNED_TRADE_SKIPPED
+ - ACTIVITY_TYPE_EXIT_STARTED
+ - ACTIVITY_TYPE_EXIT_SUCCEEDED
+ - ACTIVITY_TYPE_EXIT_SKIPPED
+ - ACTIVITY_TYPE_EXIT_FAILED
+ - ACTIVITY_TYPE_EXECUTION_FAILED
+ - ACTIVITY_TYPE_POSITION_REDUCED
+ default: ACTIVITY_TYPE_UNSPECIFIED
+ description: ActivityType is the stable public activity timeline type set.
+ v1AddCapitalPreview:
+ type: object
+ properties:
+ quoteToken:
+ $ref: '#/definitions/v1Token'
+ addedCapitalRaw:
+ type: string
+ minimumAddCapitalRaw:
+ type: string
+ walletQuoteBalance:
+ $ref: '#/definitions/v1RawAmountMetric'
+ currentAllocatedCapital:
+ $ref: '#/definitions/v1RawAmountMetric'
+ newAllocatedCapital:
+ $ref: '#/definitions/v1RawAmountMetric'
+ description: AddCapitalPreview contains direct-transfer and net-allocation values.
+ v1AdvisoryActionAvailability:
+ type: object
+ properties:
+ status:
+ $ref: '#/definitions/v1AdvisoryActionStatus'
+ reason:
+ $ref: '#/definitions/v1PreparedActionReason'
+ asOf:
+ type: string
+ format: date-time
+ description: AdvisoryActionAvailability is compact and safe to materialize on list rows.
+ v1AdvisoryActionStatus:
+ type: string
+ enum:
+ - ADVISORY_ACTION_STATUS_UNSPECIFIED
+ - ADVISORY_ACTION_STATUS_AVAILABLE
+ - ADVISORY_ACTION_STATUS_PENDING
+ - ADVISORY_ACTION_STATUS_UNAVAILABLE
+ default: ADVISORY_ACTION_STATUS_UNSPECIFIED
+ description: |-
+ AdvisoryActionStatus is render-only aggregate availability. Live preparation
+ remains authoritative and may return a different typed result.
+ v1AgentActionLog:
+ type: object
+ properties:
+ actionLogId:
+ type: string
+ chainId:
+ type: string
+ format: int64
+ occurredAt:
+ type: string
+ format: date-time
+ summary:
+ type: string
+ trigger:
+ type: string
+ dataSummary:
+ type: string
+ reasoningSummary:
+ type: string
+ actionSummary:
+ type: string
+ action:
+ type: string
+ status:
+ type: string
+ txHash:
+ type: string
+ leaderPositionId:
+ type: string
+ blockNumber:
+ type: string
+ tokenAddress:
+ type: string
+ model:
+ type: string
+ strategyVersion:
+ type: string
+ description: |-
+ AgentActionLog is one sanitized public decision-log narrative. Optional
+ chain links are populated only from canonical operator-derived facts.
+ v1AgentActionLogGroupBy:
+ type: string
+ enum:
+ - AGENT_ACTION_LOG_GROUP_BY_UNSPECIFIED
+ - AGENT_ACTION_LOG_GROUP_BY_SESSION_ID
+ default: AGENT_ACTION_LOG_GROUP_BY_UNSPECIFIED
+ description: |-
+ AgentActionLogGroupBy selects the response collection shape for one action
+ log timeline. Unspecified currently defaults to whole session groups.
+ v1AgentActionLogSessionGroup:
+ type: object
+ properties:
+ sessionId:
+ type: string
+ logs:
+ type: array
+ items:
+ type: object
+ $ref: '#/definitions/v1AgentActionLog'
+ description: |-
+ AgentActionLogSessionGroup contains all matching action logs from one
+ source session. Groups and their logs are ordered newest first.
+ v1AgentCard:
+ type: object
+ properties:
+ agentId:
+ type: string
+ leaderAddress:
+ type: string
+ displayName:
+ type: string
+ avatarUrl:
+ type: string
+ isVerified:
+ type: boolean
+ badges:
+ type: array
+ items:
+ type: string
+ modelName:
+ type: string
+ chainId:
+ type: string
+ format: int64
+ asOf:
+ type: string
+ format: date-time
+ strategyLabel:
+ type: string
+ strategyCategories:
+ type: array
+ items:
+ $ref: '#/definitions/v1StrategyCategory'
+ metrics:
+ $ref: '#/definitions/v1AgentMetrics'
+ flatFeeRatePct:
+ $ref: '#/definitions/v1DecimalMetric'
+ startCopyAvailability:
+ $ref: '#/definitions/v1AdvisoryActionAvailability'
+ description: AgentCard is a row in leaderboard and agent discovery.
+ v1AgentMetrics:
+ type: object
+ properties:
+ apr30d:
+ $ref: '#/definitions/v1AprMetric'
+ winRatePct:
+ $ref: '#/definitions/v1DecimalMetric'
+ lifetimeVolumeUsd:
+ $ref: '#/definitions/v1DecimalMetric'
+ copiers:
+ $ref: '#/definitions/v1CountMetric'
+ aumUsd:
+ $ref: '#/definitions/v1DecimalMetric'
+ openPositions:
+ $ref: '#/definitions/v1CountMetric'
+ totalRealizedPnlUsd:
+ $ref: '#/definitions/v1DecimalMetric'
+ maxDrawdownPct:
+ $ref: '#/definitions/v1DecimalMetric'
+ winningPositionCount:
+ $ref: '#/definitions/v1CountMetric'
+ losingPositionCount:
+ $ref: '#/definitions/v1CountMetric'
+ breakevenPositionCount:
+ $ref: '#/definitions/v1CountMetric'
+ closedPositionCount:
+ $ref: '#/definitions/v1CountMetric'
+ description: AgentMetrics contains canonical public agent metrics.
+ v1AgentProfile:
+ type: object
+ properties:
+ agentId:
+ type: string
+ chainId:
+ type: string
+ format: int64
+ displayName:
+ type: string
+ avatarUrl:
+ type: string
+ bio:
+ type: string
+ modelName:
+ type: string
+ badges:
+ type: array
+ items:
+ type: string
+ liveSince:
+ type: string
+ format: date-time
+ whitelistedSymbols:
+ type: array
+ items:
+ type: string
+ tags:
+ type: array
+ items:
+ type: string
+ leaderAddress:
+ type: string
+ isVerified:
+ type: boolean
+ strategyLabel:
+ type: string
+ strategyCategories:
+ type: array
+ items:
+ $ref: '#/definitions/v1StrategyCategory'
+ metrics:
+ $ref: '#/definitions/v1AgentMetrics'
+ flatFeeRatePct:
+ $ref: '#/definitions/v1DecimalMetric'
+ strategyExecutionItems:
+ type: array
+ items:
+ type: object
+ $ref: '#/definitions/v1StrategyExecutionItem'
+ startCopyAvailability:
+ $ref: '#/definitions/v1AdvisoryActionAvailability'
+ description: AgentProfile contains one agent profile.
+ v1AgentSnapshot:
+ type: object
+ properties:
+ agentId:
+ type: string
+ chainId:
+ type: string
+ format: int64
+ leaderAddress:
+ type: string
+ displayName:
+ type: string
+ avatarUrl:
+ type: string
+ isVerified:
+ type: boolean
+ modelName:
+ type: string
+ strategyLabel:
+ type: string
+ strategyCategories:
+ type: array
+ items:
+ $ref: '#/definitions/v1StrategyCategory'
+ metrics:
+ $ref: '#/definitions/v1AgentSnapshotMetrics'
+ badges:
+ type: array
+ items:
+ type: string
+ description: AgentSnapshot is the lightweight agent projection nested in copy-run rows.
+ v1AgentSnapshotMetrics:
+ type: object
+ properties:
+ apr30d:
+ $ref: '#/definitions/v1AprMetric'
+ winRatePct:
+ $ref: '#/definitions/v1DecimalMetric'
+ lifetimeVolumeUsd:
+ $ref: '#/definitions/v1DecimalMetric'
+ description: AgentSnapshotMetrics contains only metrics required on copy-run rows.
+ v1AprMetric:
+ type: object
+ properties:
+ value:
+ type: string
+ status:
+ $ref: '#/definitions/v1MetricStatus'
+ asOf:
+ type: string
+ format: date-time
+ window:
+ $ref: '#/definitions/v1Window'
+ nominalWindowDays:
+ type: integer
+ format: int32
+ actualWindowSeconds:
+ type: string
+ format: int64
+ windowPolicy:
+ $ref: '#/definitions/v1WindowPolicy'
+ windowStart:
+ type: string
+ format: date-time
+ windowEnd:
+ type: string
+ format: date-time
+ description: AprMetric preserves exact APR value and the interval used to derive it.
+ v1CapitalActivityDetail:
+ type: object
+ properties:
+ movementType:
+ type: string
+ amountRaw:
+ type: string
+ tokenAddress:
+ type: string
+ token:
+ $ref: '#/definitions/v1Token'
+ valueUsd:
+ $ref: '#/definitions/v1DecimalMetric'
+ description: CapitalActivityDetail contains typed copy-account capital movement context.
+ v1CapitalInProjectionStatus:
+ type: string
+ enum:
+ - CAPITAL_IN_PROJECTION_STATUS_UNSPECIFIED
+ - CAPITAL_IN_PROJECTION_STATUS_SYNCING
+ - CAPITAL_IN_PROJECTION_STATUS_READY
+ - CAPITAL_IN_PROJECTION_STATUS_UNAVAILABLE
+ default: CAPITAL_IN_PROJECTION_STATUS_UNSPECIFIED
+ description: |-
+ CapitalInProjectionStatus describes whether the immutable Capital In
+ projection for a copy run is still catching up or is safe to render.
+
+ - CAPITAL_IN_PROJECTION_STATUS_SYNCING: A canonical funding fact is visible, but immutable account-capital
+ coverage or the latest monetary recomputation has not completed yet.
+ - CAPITAL_IN_PROJECTION_STATUS_READY: The latest monetary work generation completed against proven immutable
+ account-capital coverage. capital_in_usd may legitimately be zero.
+ - CAPITAL_IN_PROJECTION_STATUS_UNAVAILABLE: Required source lineage or projection authority is unavailable.
+ v1Chain:
+ type: object
+ properties:
+ chainId:
+ type: string
+ format: int64
+ slug:
+ type: string
+ name:
+ type: string
+ iconUrl:
+ type: string
+ isEnabled:
+ type: boolean
+ description: Chain is a supported public chain.
+ v1ChainFreshness:
+ type: object
+ properties:
+ chainId:
+ type: string
+ format: int64
+ dataAsOf:
+ type: string
+ format: date-time
+ asOfBlockNumber:
+ type: string
+ safeBlockNumber:
+ type: string
+ description: safe_block_number is the operator's configured reorg-safe boundary, not consensus finality.
+ syncedAt:
+ type: string
+ format: date-time
+ status:
+ $ref: '#/definitions/v1DataStatus'
+ description: ChainFreshness describes source freshness for one chain.
+ v1CopyAccountStatus:
+ type: string
+ enum:
+ - COPY_ACCOUNT_STATUS_UNSPECIFIED
+ - COPY_ACCOUNT_STATUS_ACTIVE
+ - COPY_ACCOUNT_STATUS_CLOSED
+ - COPY_ACCOUNT_STATUS_CLOSING
+ - COPY_ACCOUNT_STATUS_STOPPED
+ default: COPY_ACCOUNT_STATUS_UNSPECIFIED
+ description: CopyAccountStatus describes the public copy-account lifecycle.
+ v1CopyAccountSummary:
+ type: object
+ properties:
+ chainId:
+ type: string
+ format: int64
+ copyAccount:
+ type: string
+ ownerAddress:
+ type: string
+ description: Initial follower-account creation wallet; not current ownership or authorization evidence.
+ activeCopyRuns:
+ $ref: '#/definitions/v1CountMetric'
+ totalAllocatedUsd:
+ $ref: '#/definitions/v1DecimalMetric'
+ portfolioValueUsd:
+ $ref: '#/definitions/v1DecimalMetric'
+ availableBalanceUsd:
+ $ref: '#/definitions/v1DecimalMetric'
+ realizedPnlUsd:
+ $ref: '#/definitions/v1DecimalMetric'
+ unrealizedPnlUsd:
+ $ref: '#/definitions/v1DecimalMetric'
+ openPositionCount:
+ $ref: '#/definitions/v1CountMetric'
+ closedPositionCount:
+ $ref: '#/definitions/v1CountMetric'
+ leftoverPositionCount:
+ $ref: '#/definitions/v1CountMetric'
+ leftoverValueUsd:
+ $ref: '#/definitions/v1DecimalMetric'
+ flatFeesCapturedUsd:
+ $ref: '#/definitions/v1DecimalMetric'
+ cashbackReceivedUsd:
+ $ref: '#/definitions/v1DecimalMetric'
+ netFeeCostUsd:
+ $ref: '#/definitions/v1DecimalMetric'
+ estimatedCashbackPendingUsd:
+ $ref: '#/definitions/v1DecimalMetric'
+ status:
+ $ref: '#/definitions/v1CopyAccountStatus'
+ copyRunId:
+ type: string
+ agentSnapshot:
+ $ref: '#/definitions/v1AgentSnapshot'
+ startedAt:
+ type: string
+ format: date-time
+ stoppedAt:
+ type: string
+ format: date-time
+ addCapitalAvailability:
+ $ref: '#/definitions/v1AdvisoryActionAvailability'
+ stopCopyAvailability:
+ $ref: '#/definitions/v1AdvisoryActionAvailability'
+ withdrawQuoteAvailability:
+ $ref: '#/definitions/v1AdvisoryActionAvailability'
+ description: CopyAccountSummary contains chain-scoped copy-account totals.
+ v1CopyLifecycleActivityDetail:
+ type: object
+ properties:
+ eventId:
+ type: string
+ eventType:
+ type: string
+ beforeStatus:
+ type: string
+ afterStatus:
+ type: string
+ description: CopyLifecycleActivityDetail contains typed copy-run lifecycle context.
+ v1CopyRunCashbackPolicy:
+ type: object
+ properties:
+ copyRunId:
+ type: string
+ chainId:
+ type: string
+ format: int64
+ copyAccount:
+ type: string
+ agentId:
+ type: string
+ capCashbackRatioRaw:
+ type: string
+ pnlRateRaw:
+ type: string
+ scope:
+ $ref: '#/definitions/v1CopyRunCashbackPolicyScope'
+ status:
+ $ref: '#/definitions/v1CopyRunCashbackPolicyStatus'
+ selectionPolicyVersion:
+ type: string
+ selectedAt:
+ type: string
+ format: date-time
+ invalidatedAt:
+ type: string
+ format: date-time
+ unavailableReason:
+ $ref: '#/definitions/v1CopyRunCashbackPolicyUnavailableReason'
+ fallbackAt:
+ type: string
+ format: date-time
+ cashbackFormulaVersion:
+ type: integer
+ format: int64
+ description: |-
+ Formula identity is operator-authored and independent from policy selection.
+ Unsupported historical generations omit it; supported outcomes carry a positive version.
+ description: |-
+ CopyRunCashbackPolicy is the public effective cashback assignment for one
+ copy run. Optional raw rates preserve missing versus proven zero semantics.
+ v1CopyRunCashbackPolicyScope:
+ type: string
+ enum:
+ - COPY_RUN_CASHBACK_POLICY_SCOPE_UNSPECIFIED
+ - COPY_RUN_CASHBACK_POLICY_SCOPE_DEFAULT
+ - COPY_RUN_CASHBACK_POLICY_SCOPE_EXTRA
+ default: COPY_RUN_CASHBACK_POLICY_SCOPE_UNSPECIFIED
+ description: |-
+ CopyRunCashbackPolicyScope identifies the effective cashback tier selected
+ for one follower account.
+ v1CopyRunCashbackPolicyStatus:
+ type: string
+ enum:
+ - COPY_RUN_CASHBACK_POLICY_STATUS_UNSPECIFIED
+ - COPY_RUN_CASHBACK_POLICY_STATUS_AVAILABLE
+ - COPY_RUN_CASHBACK_POLICY_STATUS_NOT_CONFIGURED
+ - COPY_RUN_CASHBACK_POLICY_STATUS_INVALIDATED
+ - COPY_RUN_CASHBACK_POLICY_STATUS_UNAVAILABLE
+ default: COPY_RUN_CASHBACK_POLICY_STATUS_UNSPECIFIED
+ description: |-
+ CopyRunCashbackPolicyStatus describes the effective account-owned cashback
+ assignment at the operator's common covered boundary.
+ v1CopyRunCashbackPolicyUnavailableReason:
+ type: string
+ enum:
+ - COPY_RUN_CASHBACK_POLICY_UNAVAILABLE_REASON_UNSPECIFIED
+ - COPY_RUN_CASHBACK_POLICY_UNAVAILABLE_REASON_COVERAGE_PENDING
+ - COPY_RUN_CASHBACK_POLICY_UNAVAILABLE_REASON_HISTORICAL_GENERATION_UNSUPPORTED
+ - COPY_RUN_CASHBACK_POLICY_UNAVAILABLE_REASON_POLICY_TRANSITION_PENDING
+ default: COPY_RUN_CASHBACK_POLICY_UNAVAILABLE_REASON_UNSPECIFIED
+ description: CopyRunCashbackPolicyUnavailableReason explains typed policy unavailability.
+ v1CopyRunStatus:
+ type: string
+ enum:
+ - COPY_RUN_STATUS_UNSPECIFIED
+ - COPY_RUN_STATUS_ACTIVE
+ - COPY_RUN_STATUS_CLOSED
+ - COPY_RUN_STATUS_CLOSING
+ - COPY_RUN_STATUS_STOPPED
+ default: COPY_RUN_STATUS_UNSPECIFIED
+ description: CopyRunStatus describes the public copy-run lifecycle.
+ v1CopyRunSummary:
+ type: object
+ properties:
+ copyRunId:
+ type: string
+ ownerAddress:
+ type: string
+ description: Initial follower-account creation wallet; not current ownership or authorization evidence.
+ agentId:
+ type: string
+ chainId:
+ type: string
+ format: int64
+ copyAccount:
+ type: string
+ startedAt:
+ type: string
+ format: date-time
+ stoppedAt:
+ type: string
+ format: date-time
+ agentSnapshot:
+ $ref: '#/definitions/v1AgentSnapshot'
+ capitalInUsd:
+ $ref: '#/definitions/v1DecimalMetric'
+ capitalOutUsd:
+ $ref: '#/definitions/v1DecimalMetric'
+ portfolioValueUsd:
+ $ref: '#/definitions/v1DecimalMetric'
+ realizedPnlUsd:
+ $ref: '#/definitions/v1DecimalMetric'
+ unrealizedPnlUsd:
+ $ref: '#/definitions/v1DecimalMetric'
+ myAprSinceCopy:
+ $ref: '#/definitions/v1AprMetric'
+ openPositionCount:
+ $ref: '#/definitions/v1CountMetric'
+ closedPositionCount:
+ $ref: '#/definitions/v1CountMetric'
+ leftoverPositionCount:
+ $ref: '#/definitions/v1CountMetric'
+ leftoverValueUsd:
+ $ref: '#/definitions/v1DecimalMetric'
+ durationSeconds:
+ type: string
+ format: int64
+ durationAsOf:
+ type: string
+ format: date-time
+ flatFeesCapturedUsd:
+ $ref: '#/definitions/v1DecimalMetric'
+ cashbackReceivedUsd:
+ $ref: '#/definitions/v1DecimalMetric'
+ netFeeCostUsd:
+ $ref: '#/definitions/v1DecimalMetric'
+ estimatedCashbackPendingUsd:
+ $ref: '#/definitions/v1DecimalMetric'
+ status:
+ $ref: '#/definitions/v1CopyRunStatus'
+ addCapitalAvailability:
+ $ref: '#/definitions/v1AdvisoryActionAvailability'
+ stopCopyAvailability:
+ $ref: '#/definitions/v1AdvisoryActionAvailability'
+ withdrawQuoteAvailability:
+ $ref: '#/definitions/v1AdvisoryActionAvailability'
+ capitalInProjectionStatus:
+ $ref: '#/definitions/v1CapitalInProjectionStatus'
+ observedCapitalInUsd:
+ $ref: '#/definitions/v1DecimalMetric'
+ description: |-
+ Query-time observed Capital In from active follower account-capital facts.
+ This value is reversible display data and does not drive sorting, totals,
+ performance, AUM, or action preparation.
+ description: CopyRunSummary contains one copy-run row.
+ v1CountMetric:
+ type: object
+ properties:
+ value:
+ type: string
+ format: int64
+ status:
+ $ref: '#/definitions/v1MetricStatus'
+ asOf:
+ type: string
+ format: date-time
+ description: CountMetric preserves an integer count and independent availability.
+ v1CursorPagination:
+ type: object
+ properties:
+ nextCursor:
+ type: string
+ hasMore:
+ type: boolean
+ limit:
+ type: integer
+ format: int32
+ description: CursorPagination describes opaque cursor pagination.
+ v1DataStatus:
+ type: string
+ enum:
+ - DATA_STATUS_UNSPECIFIED
+ - DATA_STATUS_CURRENT
+ - DATA_STATUS_STALE
+ - DATA_STATUS_UNAVAILABLE
+ default: DATA_STATUS_UNSPECIFIED
+ description: DataStatus describes aggregate response data availability.
+ v1DecimalMetric:
+ type: object
+ properties:
+ value:
+ type: string
+ status:
+ $ref: '#/definitions/v1MetricStatus'
+ asOf:
+ type: string
+ format: date-time
+ description: DecimalMetric preserves exact decimal values and independent availability.
+ v1EvidenceAnchor:
+ type: object
+ properties:
+ blockNumber:
+ type: string
+ blockHash:
+ type: string
+ blockTime:
+ type: string
+ format: date-time
+ coverageGeneration:
+ type: string
+ sourceReorgSequence:
+ type: string
+ actionFactEventSeq:
+ type: string
+ projectors:
+ type: array
+ items:
+ type: object
+ $ref: '#/definitions/v1ProjectorCoverage'
+ description: EvidenceAnchor is the exact safely covered fact boundary S/E.
+ v1ExecutionActivityDetail:
+ type: object
+ properties:
+ executionKind:
+ type: string
+ eventSeq:
+ type: string
+ eventType:
+ type: string
+ actionKind:
+ type: string
+ copyJobId:
+ type: string
+ exitActionId:
+ type: string
+ executionId:
+ type: string
+ copyJobAction:
+ type: string
+ copyJobStatus:
+ type: string
+ actionStatus:
+ type: string
+ executionStatus:
+ type: string
+ publicErrorCode:
+ type: string
+ publicErrorMessage:
+ type: string
+ configIndex:
+ type: integer
+ format: int64
+ minBaseTokenRateRaw:
+ type: string
+ configDeadlineRaw:
+ type: string
+ token:
+ $ref: '#/definitions/v1Token'
+ displayAmountRaw:
+ type: string
+ valueUsd:
+ $ref: '#/definitions/v1DecimalMetric'
+ description: ExecutionActivityDetail contains typed action and exit lifecycle context.
+ v1FeeActivityDetail:
+ type: object
+ properties:
+ amountRaw:
+ type: string
+ tokenAddress:
+ type: string
+ token:
+ $ref: '#/definitions/v1Token'
+ valueUsd:
+ $ref: '#/definitions/v1DecimalMetric'
+ description: FeeActivityDetail contains typed flat-fee or cashback context.
+ v1FeePolicyPreview:
+ type: object
+ properties:
+ advertisedUpfrontFeeRateRaw:
+ type: string
+ advertisedRateStatus:
+ $ref: '#/definitions/v1MetricStatus'
+ description: |-
+ FeePolicyPreview exposes the controller rate used by the deployed beta-3
+ account. It deliberately does not claim immutable per-account fee terms.
+ v1GetAgentPositionResponse:
+ type: object
+ properties:
+ data:
+ $ref: '#/definitions/v1PositionSummary'
+ meta:
+ $ref: '#/definitions/v1ResponseMeta'
+ description: GetAgentPositionResponse is the agent position detail envelope.
+ v1GetAgentResponse:
+ type: object
+ properties:
+ data:
+ $ref: '#/definitions/v1AgentProfile'
+ meta:
+ $ref: '#/definitions/v1ResponseMeta'
+ description: GetAgentResponse is the agent profile envelope.
+ v1GetAgentStatsResponse:
+ type: object
+ properties:
+ data:
+ $ref: '#/definitions/v1AgentMetrics'
+ meta:
+ $ref: '#/definitions/v1ResponseMeta'
+ description: GetAgentStatsResponse is the agent stats envelope.
+ v1GetCopyAccountSummaryResponse:
+ type: object
+ properties:
+ data:
+ $ref: '#/definitions/v1CopyAccountSummary'
+ meta:
+ $ref: '#/definitions/v1ResponseMeta'
+ description: GetCopyAccountSummaryResponse is the copy-account summary envelope.
+ v1GetCopyAccountWalletInventoryResponse:
+ type: object
+ properties:
+ data:
+ type: array
+ items:
+ type: object
+ $ref: '#/definitions/v1WalletBalanceRow'
+ walletInventoryValueUsd:
+ $ref: '#/definitions/v1DecimalMetric'
+ meta:
+ $ref: '#/definitions/v1ResponseMeta'
+ complete:
+ type: boolean
+ pinnedStableBalance:
+ $ref: '#/definitions/v1PinnedStableBalance'
+ description: |-
+ GetCopyAccountWalletInventoryResponse is the current wallet inventory
+ envelope. The total is never a page subtotal and is unavailable when
+ complete is false or any nonzero asset cannot be valued authoritatively.
+ v1GetLeaderboardSummaryResponse:
+ type: object
+ properties:
+ data:
+ $ref: '#/definitions/v1LeaderboardSummary'
+ meta:
+ $ref: '#/definitions/v1ResponseMeta'
+ description: GetLeaderboardSummaryResponse is the leaderboard summary envelope.
+ v1GetOwnerCopyRunCashbackPolicyResponse:
+ type: object
+ properties:
+ data:
+ $ref: '#/definitions/v1CopyRunCashbackPolicy'
+ meta:
+ $ref: '#/definitions/v1ResponseMeta'
+ description: GetOwnerCopyRunCashbackPolicyResponse is the targeted policy envelope.
+ v1GetOwnerCopyRunResponse:
+ type: object
+ properties:
+ data:
+ $ref: '#/definitions/v1CopyRunSummary'
+ meta:
+ $ref: '#/definitions/v1ResponseMeta'
+ description: GetOwnerCopyRunResponse is the owner copy-run detail envelope.
+ v1GetOwnerCopySummaryResponse:
+ type: object
+ properties:
+ data:
+ $ref: '#/definitions/v1OwnerCopySummary'
+ meta:
+ $ref: '#/definitions/v1ResponseMeta'
+ description: GetOwnerCopySummaryResponse is the owner summary envelope.
+ v1LeaderboardSortField:
+ type: string
+ enum:
+ - LEADERBOARD_SORT_FIELD_UNSPECIFIED
+ - LEADERBOARD_SORT_FIELD_APR_30D
+ - LEADERBOARD_SORT_FIELD_WIN_RATE
+ - LEADERBOARD_SORT_FIELD_LIFETIME_VOLUME
+ - LEADERBOARD_SORT_FIELD_COPIERS
+ - LEADERBOARD_SORT_FIELD_AUM
+ - LEADERBOARD_SORT_FIELD_OPEN_POSITIONS
+ default: LEADERBOARD_SORT_FIELD_UNSPECIFIED
+ description: LeaderboardSortField selects a public leaderboard metric order.
+ v1LeaderboardSummary:
+ type: object
+ properties:
+ asOf:
+ type: string
+ format: date-time
+ agentCount:
+ $ref: '#/definitions/v1CountMetric'
+ totalAumUsd:
+ $ref: '#/definitions/v1DecimalMetric'
+ totalCopierCount:
+ $ref: '#/definitions/v1CountMetric'
+ description: |-
+ Platform-wide lifetime distinct owner wallets across configured agents,
+ independent of leaderboard filters.
+ lifetimeVolumeUsd:
+ $ref: '#/definitions/v1DecimalMetric'
+ description: LeaderboardSummary contains aggregate leaderboard totals.
+ v1ListAgentActionLogsResponse:
+ type: object
+ properties:
+ pagination:
+ $ref: '#/definitions/v1CursorPagination'
+ meta:
+ $ref: '#/definitions/v1ResponseMeta'
+ data:
+ type: array
+ items:
+ type: object
+ $ref: '#/definitions/v1AgentActionLogSessionGroup'
+ description: ListAgentActionLogsResponse is the sanitized action-log list envelope.
+ v1ListAgentPerformanceResponse:
+ type: object
+ properties:
+ data:
+ type: array
+ items:
+ type: object
+ $ref: '#/definitions/v1PerformancePoint'
+ pagination:
+ $ref: '#/definitions/v1CursorPagination'
+ meta:
+ $ref: '#/definitions/v1ResponseMeta'
+ description: ListAgentPerformanceResponse is the agent performance list envelope.
+ v1ListAgentPositionEventsResponse:
+ type: object
+ properties:
+ data:
+ type: array
+ items:
+ type: object
+ $ref: '#/definitions/v1PositionEvent'
+ pagination:
+ $ref: '#/definitions/v1CursorPagination'
+ meta:
+ $ref: '#/definitions/v1ResponseMeta'
+ description: ListAgentPositionEventsResponse is the agent position event list envelope.
+ v1ListAgentPositionsResponse:
+ type: object
+ properties:
+ data:
+ type: array
+ items:
+ type: object
+ $ref: '#/definitions/v1PositionSummary'
+ pagination:
+ $ref: '#/definitions/v1CursorPagination'
+ meta:
+ $ref: '#/definitions/v1ResponseMeta'
+ description: ListAgentPositionsResponse is the agent position list envelope.
+ v1ListAgentsResponse:
+ type: object
+ properties:
+ data:
+ type: array
+ items:
+ type: object
+ $ref: '#/definitions/v1AgentCard'
+ pagination:
+ $ref: '#/definitions/v1CursorPagination'
+ meta:
+ $ref: '#/definitions/v1ResponseMeta'
+ description: ListAgentsResponse is the agent list envelope.
+ v1ListChainsResponse:
+ type: object
+ properties:
+ data:
+ type: array
+ items:
+ type: object
+ $ref: '#/definitions/v1Chain'
+ meta:
+ $ref: '#/definitions/v1ResponseMeta'
+ description: ListChainsResponse is the chain list envelope.
+ v1ListCopyAccountBalancesResponse:
+ type: object
+ properties:
+ data:
+ type: array
+ items:
+ type: object
+ $ref: '#/definitions/v1WalletBalanceRow'
+ pagination:
+ $ref: '#/definitions/v1CursorPagination'
+ meta:
+ $ref: '#/definitions/v1ResponseMeta'
+ pinnedStableBalance:
+ $ref: '#/definitions/v1PinnedStableBalance'
+ description: ListCopyAccountBalancesResponse is the wallet inventory list envelope.
+ v1ListCopyAccountHistoryResponse:
+ type: object
+ properties:
+ data:
+ type: array
+ items:
+ type: object
+ $ref: '#/definitions/v1ActivityRow'
+ pagination:
+ $ref: '#/definitions/v1CursorPagination'
+ meta:
+ $ref: '#/definitions/v1ResponseMeta'
+ description: ListCopyAccountHistoryResponse is the copy-account history envelope.
+ v1ListCopyAccountPositionPendingSellObligationsResponse:
+ type: object
+ properties:
+ data:
+ type: array
+ items:
+ type: object
+ $ref: '#/definitions/v1PendingSellObligation'
+ pagination:
+ $ref: '#/definitions/v1CursorPagination'
+ meta:
+ $ref: '#/definitions/v1ResponseMeta'
+ description: |-
+ ListCopyAccountPositionPendingSellObligationsResponse is one
+ watermark-consistent current FIFO page.
+ v1ListCopyAccountPositionsResponse:
+ type: object
+ properties:
+ data:
+ type: array
+ items:
+ type: object
+ $ref: '#/definitions/v1PositionSummary'
+ pagination:
+ $ref: '#/definitions/v1CursorPagination'
+ meta:
+ $ref: '#/definitions/v1ResponseMeta'
+ description: ListCopyAccountPositionsResponse is the copy-account position list envelope.
+ v1ListLeaderboardResponse:
+ type: object
+ properties:
+ data:
+ type: array
+ items:
+ type: object
+ $ref: '#/definitions/v1AgentCard'
+ pagination:
+ $ref: '#/definitions/v1CursorPagination'
+ meta:
+ $ref: '#/definitions/v1ResponseMeta'
+ description: ListLeaderboardResponse is the leaderboard list envelope.
+ v1ListOwnerActivityResponse:
+ type: object
+ properties:
+ data:
+ type: array
+ items:
+ type: object
+ $ref: '#/definitions/v1ActivityRow'
+ pagination:
+ $ref: '#/definitions/v1CursorPagination'
+ meta:
+ $ref: '#/definitions/v1ResponseMeta'
+ description: ListOwnerActivityResponse is the owner activity list envelope.
+ v1ListOwnerCopyAccountsResponse:
+ type: object
+ properties:
+ data:
+ type: array
+ items:
+ type: object
+ $ref: '#/definitions/v1CopyAccountSummary'
+ pagination:
+ $ref: '#/definitions/v1CursorPagination'
+ meta:
+ $ref: '#/definitions/v1ResponseMeta'
+ description: ListOwnerCopyAccountsResponse is the owner copy-account list envelope.
+ v1ListOwnerCopyRunPerformanceResponse:
+ type: object
+ properties:
+ data:
+ type: array
+ items:
+ type: object
+ $ref: '#/definitions/v1PerformancePoint'
+ pagination:
+ $ref: '#/definitions/v1CursorPagination'
+ meta:
+ $ref: '#/definitions/v1ResponseMeta'
+ description: ListOwnerCopyRunPerformanceResponse is the copy-run performance list envelope.
+ v1ListOwnerCopyRunPositionsResponse:
+ type: object
+ properties:
+ data:
+ type: array
+ items:
+ type: object
+ $ref: '#/definitions/v1PositionSummary'
+ pagination:
+ $ref: '#/definitions/v1CursorPagination'
+ meta:
+ $ref: '#/definitions/v1ResponseMeta'
+ description: ListOwnerCopyRunPositionsResponse is the copy-run position list envelope.
+ v1ListOwnerCopyRunsResponse:
+ type: object
+ properties:
+ data:
+ type: array
+ items:
+ type: object
+ $ref: '#/definitions/v1CopyRunSummary'
+ pagination:
+ $ref: '#/definitions/v1CursorPagination'
+ meta:
+ $ref: '#/definitions/v1ResponseMeta'
+ view:
+ $ref: '#/definitions/v1OwnerCopyView'
+ description: ListOwnerCopyRunsResponse is the owner copy-run list envelope.
+ v1ListOwnerPositionsResponse:
+ type: object
+ properties:
+ data:
+ type: array
+ items:
+ type: object
+ $ref: '#/definitions/v1PositionSummary'
+ pagination:
+ $ref: '#/definitions/v1CursorPagination'
+ meta:
+ $ref: '#/definitions/v1ResponseMeta'
+ description: ListOwnerPositionsResponse is the flattened owner position list envelope.
+ v1MetricStatus:
+ type: string
+ enum:
+ - METRIC_STATUS_UNSPECIFIED
+ - METRIC_STATUS_CURRENT
+ - METRIC_STATUS_STALE
+ - METRIC_STATUS_UNAVAILABLE
+ - METRIC_STATUS_NOT_APPLICABLE
+ default: METRIC_STATUS_UNSPECIFIED
+ description: MetricStatus describes one independently available metric value.
+ v1OwnerCopyRunSortField:
+ type: string
+ enum:
+ - OWNER_COPY_RUN_SORT_FIELD_UNSPECIFIED
+ - OWNER_COPY_RUN_SORT_FIELD_STARTED_AT
+ - OWNER_COPY_RUN_SORT_FIELD_STOPPED_AT
+ - OWNER_COPY_RUN_SORT_FIELD_AGENT_APR_30D
+ - OWNER_COPY_RUN_SORT_FIELD_AGENT_WIN_RATE
+ - OWNER_COPY_RUN_SORT_FIELD_AGENT_LIFETIME_VOLUME
+ - OWNER_COPY_RUN_SORT_FIELD_CAPITAL_IN
+ default: OWNER_COPY_RUN_SORT_FIELD_UNSPECIFIED
+ description: OwnerCopyRunSortField selects a public owner copy-run order.
+ v1OwnerCopySummary:
+ type: object
+ properties:
+ ownerAddress:
+ type: string
+ description: Initial follower-account creation wallet; not current ownership or authorization evidence.
+ activeCopyRuns:
+ $ref: '#/definitions/v1CountMetric'
+ closedCopyRuns:
+ $ref: '#/definitions/v1CountMetric'
+ totalAllocatedUsd:
+ $ref: '#/definitions/v1DecimalMetric'
+ portfolioValueUsd:
+ $ref: '#/definitions/v1DecimalMetric'
+ realizedPnlUsd:
+ $ref: '#/definitions/v1DecimalMetric'
+ unrealizedPnlUsd:
+ $ref: '#/definitions/v1DecimalMetric'
+ openPositionCount:
+ $ref: '#/definitions/v1CountMetric'
+ closedPositionCount:
+ $ref: '#/definitions/v1CountMetric'
+ closedCapitalUsd:
+ $ref: '#/definitions/v1DecimalMetric'
+ leftoverPositionCount:
+ $ref: '#/definitions/v1CountMetric'
+ leftoverValueUsd:
+ $ref: '#/definitions/v1DecimalMetric'
+ flatFeesCapturedUsd:
+ $ref: '#/definitions/v1DecimalMetric'
+ cashbackReceivedUsd:
+ $ref: '#/definitions/v1DecimalMetric'
+ netFeeCostUsd:
+ $ref: '#/definitions/v1DecimalMetric'
+ estimatedCashbackPendingUsd:
+ $ref: '#/definitions/v1DecimalMetric'
+ view:
+ $ref: '#/definitions/v1OwnerCopyView'
+ description: OwnerCopySummary contains public owner dashboard totals.
+ v1OwnerCopyView:
+ type: string
+ enum:
+ - OWNER_COPY_VIEW_UNSPECIFIED
+ - OWNER_COPY_VIEW_OPEN
+ - OWNER_COPY_VIEW_HISTORY
+ default: OWNER_COPY_VIEW_UNSPECIFIED
+ description: OwnerCopyView selects one product tab and its exact membership universe.
+ v1PendingSellObligation:
+ type: object
+ properties:
+ leaderPositionEventId:
+ type: string
+ currentRatioRaw:
+ type: string
+ skippedAt:
+ type: string
+ format: date-time
+ description: |-
+ Optional aggregate display evidence; absence does not invalidate the
+ operator-authoritative obligation or its exact ratio.
+ publicErrorCode:
+ type: string
+ publicErrorMessage:
+ type: string
+ description: |-
+ PendingSellObligation is one current FIFO item behind a skipped-sell
+ recovery. The ratio is the operator's exact post-rebase WAD value. Error
+ fields are sanitized display evidence and are not sizing authority.
+ v1PerformanceInterval:
+ type: string
+ enum:
+ - PERFORMANCE_INTERVAL_UNSPECIFIED
+ - PERFORMANCE_INTERVAL_DAY
+ - PERFORMANCE_INTERVAL_WEEK
+ - PERFORMANCE_INTERVAL_MONTH
+ default: PERFORMANCE_INTERVAL_UNSPECIFIED
+ description: PerformanceInterval selects a public chart bucket interval.
+ v1PerformancePoint:
+ type: object
+ properties:
+ timestamp:
+ type: string
+ format: date-time
+ series:
+ $ref: '#/definitions/v1PerformanceSeries'
+ interval:
+ $ref: '#/definitions/v1PerformanceInterval'
+ valueUsd:
+ $ref: '#/definitions/v1DecimalMetric'
+ tradeId:
+ type: string
+ positionId:
+ type: string
+ token:
+ $ref: '#/definitions/v1Token'
+ description: PerformancePoint is a chart point.
+ v1PerformanceSeries:
+ type: string
+ enum:
+ - PERFORMANCE_SERIES_UNSPECIFIED
+ - PERFORMANCE_SERIES_PORTFOLIO_EQUITY
+ - PERFORMANCE_SERIES_CUMULATIVE_REALIZED_PNL
+ - PERFORMANCE_SERIES_PERIOD_REALIZED_PNL
+ - PERFORMANCE_SERIES_PER_TRADE_REALIZED_PNL
+ default: PERFORMANCE_SERIES_UNSPECIFIED
+ description: PerformanceSeries selects a public chart series.
+ v1PinnedStableBalance:
+ type: object
+ properties:
+ status:
+ $ref: '#/definitions/v1PinnedStableBalanceStatus'
+ balance:
+ $ref: '#/definitions/v1WalletBalanceRow'
+ description: PinnedStableBalance describes the configured stablecoin balance for a copy account.
+ v1PinnedStableBalanceStatus:
+ type: string
+ enum:
+ - PINNED_STABLE_BALANCE_STATUS_UNSPECIFIED
+ - PINNED_STABLE_BALANCE_STATUS_PRESENT
+ - PINNED_STABLE_BALANCE_STATUS_REGISTRATION_PENDING
+ - PINNED_STABLE_BALANCE_STATUS_NOT_INDEXED
+ - PINNED_STABLE_BALANCE_STATUS_UNAVAILABLE
+ - PINNED_STABLE_BALANCE_STATUS_TOKEN_MISMATCH
+ default: PINNED_STABLE_BALANCE_STATUS_UNSPECIFIED
+ description: PinnedStableBalanceStatus describes exact approved-stable balance authority.
+ v1PositionActionKind:
+ type: string
+ enum:
+ - POSITION_ACTION_KIND_UNSPECIFIED
+ - POSITION_ACTION_KIND_MANUAL_SELL
+ - POSITION_ACTION_KIND_CLOSE_POSITION
+ default: POSITION_ACTION_KIND_UNSPECIFIED
+ description: |-
+ PositionActionKind identifies one recovery action currently available for a
+ public position. Live transaction preparation remains authoritative.
+ v1PositionActivityDetail:
+ type: object
+ properties:
+ eventId:
+ type: string
+ actionType:
+ type: string
+ baseTokenAddress:
+ type: string
+ quoteTokenAddress:
+ type: string
+ baseAmountRaw:
+ type: string
+ quoteAmountRaw:
+ type: string
+ accountingStatus:
+ type: string
+ grossBaseSoldRaw:
+ type: string
+ grossQuoteReceivedRaw:
+ type: string
+ baseToken:
+ $ref: '#/definitions/v1Token'
+ quoteToken:
+ $ref: '#/definitions/v1Token'
+ grossBaseBoughtRaw:
+ type: string
+ upfrontFeeCapturedBaseRaw:
+ type: string
+ upfrontFeeReleasedBaseRaw:
+ type: string
+ netBaseReceivedRaw:
+ type: string
+ netBaseSoldRaw:
+ type: string
+ displayBaseRaw:
+ type: string
+ settlementValueUsd:
+ $ref: '#/definitions/v1DecimalMetric'
+ realizedPnlUsd:
+ $ref: '#/definitions/v1DecimalMetric'
+ flatFeeCapturedUsd:
+ $ref: '#/definitions/v1DecimalMetric'
+ cashbackReceivedUsd:
+ $ref: '#/definitions/v1DecimalMetric'
+ description: PositionActivityDetail contains typed follower-position context.
+ v1PositionEvent:
+ type: object
+ properties:
+ eventId:
+ type: string
+ positionId:
+ type: string
+ chainId:
+ type: string
+ format: int64
+ eventType:
+ type: string
+ summary:
+ type: string
+ occurredAt:
+ type: string
+ format: date-time
+ txHash:
+ type: string
+ blockNumber:
+ type: string
+ description: PositionEvent is a public position lifecycle event.
+ v1PositionExitKind:
+ type: string
+ enum:
+ - POSITION_EXIT_KIND_UNSPECIFIED
+ - POSITION_EXIT_KIND_ALIGNED
+ - POSITION_EXIT_KIND_MANUAL
+ default: POSITION_EXIT_KIND_UNSPECIFIED
+ description: PositionExitKind identifies how a terminal or reduced position exited.
+ v1PositionLifecycle:
+ type: string
+ enum:
+ - POSITION_LIFECYCLE_UNSPECIFIED
+ - POSITION_LIFECYCLE_ACTIVE
+ - POSITION_LIFECYCLE_CLOSING
+ - POSITION_LIFECYCLE_CLOSED
+ default: POSITION_LIFECYCLE_UNSPECIFIED
+ description: PositionLifecycle describes the authoritative public position state.
+ v1PositionQuantityState:
+ type: string
+ enum:
+ - POSITION_QUANTITY_STATE_UNSPECIFIED
+ - POSITION_QUANTITY_STATE_OPEN_FULL
+ - POSITION_QUANTITY_STATE_OPEN_PARTIAL
+ - POSITION_QUANTITY_STATE_CLOSED
+ default: POSITION_QUANTITY_STATE_UNSPECIFIED
+ description: PositionQuantityState describes how much of the original position remains.
+ v1PositionSellContext:
+ type: string
+ enum:
+ - POSITION_SELL_CONTEXT_UNSPECIFIED
+ - POSITION_SELL_CONTEXT_ALIGN_SKIP
+ - POSITION_SELL_CONTEXT_STOP_COPY
+ default: POSITION_SELL_CONTEXT_UNSPECIFIED
+ description: PositionSellContext identifies the canonical recovery source for a position sell.
+ v1PositionSellPreview:
+ type: object
+ properties:
+ context:
+ $ref: '#/definitions/v1PositionSellContext'
+ userPositionId:
+ type: string
+ tradeId:
+ type: string
+ baseToken:
+ $ref: '#/definitions/v1Token'
+ quoteToken:
+ $ref: '#/definitions/v1Token'
+ remainingBaseBefore:
+ $ref: '#/definitions/v1RawAmountMetric'
+ sellBase:
+ $ref: '#/definitions/v1RawAmountMetric'
+ upfrontFeeReleasedBase:
+ $ref: '#/definitions/v1RawAmountMetric'
+ sellRatioRaw:
+ type: string
+ unresolvedSkipCount:
+ type: integer
+ format: int64
+ cashback:
+ $ref: '#/definitions/v1RawAmountMetric'
+ swapQuote:
+ $ref: '#/definitions/v1SwapQuotePreview'
+ description: |-
+ PositionSellPreview contains the shared Manual Sell and Close Position facts.
+ Identity and obligation fields may be absent while source coverage is pending;
+ retained raw metrics remain present with an explicit unavailable status.
+ Gross route input remains private because it is an internal accounting and
+ routing quantity rather than the user's sell amount.
+ v1PositionSortField:
+ type: string
+ enum:
+ - POSITION_SORT_FIELD_UNSPECIFIED
+ - POSITION_SORT_FIELD_OPENED_AT
+ - POSITION_SORT_FIELD_CLOSED_AT
+ - POSITION_SORT_FIELD_VALUE_USD
+ default: POSITION_SORT_FIELD_UNSPECIFIED
+ description: PositionSortField selects a public position order.
+ v1PositionSummary:
+ type: object
+ properties:
+ positionId:
+ type: string
+ userPositionId:
+ type: string
+ agentPositionId:
+ type: string
+ copyRunId:
+ type: string
+ agentId:
+ type: string
+ chainId:
+ type: string
+ format: int64
+ copyAccount:
+ type: string
+ tradeId:
+ type: string
+ token:
+ $ref: '#/definitions/v1Token'
+ openedAt:
+ type: string
+ format: date-time
+ closedAt:
+ type: string
+ format: date-time
+ lifecycle:
+ $ref: '#/definitions/v1PositionLifecycle'
+ remainingBaseRaw:
+ type: string
+ entryValuation:
+ $ref: '#/definitions/v1PositionValuation'
+ currentValuation:
+ $ref: '#/definitions/v1PositionValuation'
+ exitValuation:
+ $ref: '#/definitions/v1PositionValuation'
+ realizedPnlUsd:
+ $ref: '#/definitions/v1DecimalMetric'
+ unrealizedPnlUsd:
+ $ref: '#/definitions/v1DecimalMetric'
+ unrealizedPnlPct:
+ $ref: '#/definitions/v1DecimalMetric'
+ flatFeeCapturedUsd:
+ $ref: '#/definitions/v1DecimalMetric'
+ cashbackReceivedUsd:
+ $ref: '#/definitions/v1DecimalMetric'
+ netFeeCostUsd:
+ $ref: '#/definitions/v1DecimalMetric'
+ estimatedCashbackUsd:
+ $ref: '#/definitions/v1DecimalMetric'
+ skippedSellCount:
+ $ref: '#/definitions/v1CountMetric'
+ latestSkippedRatio:
+ $ref: '#/definitions/v1RatioMetric'
+ cumulativeSkippedRatio:
+ $ref: '#/definitions/v1RatioMetric'
+ latestSkipPublicErrorCode:
+ type: string
+ isLeftover:
+ type: boolean
+ leftoverReason:
+ type: string
+ leftoverValuation:
+ $ref: '#/definitions/v1PositionValuation'
+ durationSeconds:
+ type: string
+ format: int64
+ durationAsOf:
+ type: string
+ format: date-time
+ totalGrossBaseBoughtRaw:
+ type: string
+ totalGrossBaseSoldRaw:
+ type: string
+ upfrontFeeCapturedBaseRaw:
+ type: string
+ upfrontFeeReleasedBaseRaw:
+ type: string
+ netBaseReceivedRaw:
+ type: string
+ remainingNetBaseRaw:
+ type: string
+ displayBaseRaw:
+ type: string
+ quantityState:
+ $ref: '#/definitions/v1PositionQuantityState'
+ exitKind:
+ $ref: '#/definitions/v1PositionExitKind'
+ actionKind:
+ $ref: '#/definitions/v1PositionActionKind'
+ availableActionKinds:
+ type: array
+ items:
+ $ref: '#/definitions/v1PositionActionKind'
+ description: PositionSummary is a public position row.
+ v1PositionValuation:
+ type: object
+ properties:
+ valueUsd:
+ type: string
+ priceUsd:
+ type: string
+ priceSource:
+ type: string
+ priceAsOf:
+ type: string
+ format: date-time
+ asOf:
+ type: string
+ format: date-time
+ isEstimated:
+ type: boolean
+ isFinal:
+ type: boolean
+ status:
+ $ref: '#/definitions/v1DataStatus'
+ description: PositionValuation describes one independently available position value.
+ v1PositionView:
+ type: string
+ enum:
+ - POSITION_VIEW_UNSPECIFIED
+ - POSITION_VIEW_ALL
+ - POSITION_VIEW_OPEN
+ - POSITION_VIEW_CLOSED
+ - POSITION_VIEW_LEFTOVER
+ default: POSITION_VIEW_UNSPECIFIED
+ description: PositionView filters position collections without changing lifecycle state.
+ v1PrepareAddCapitalResponse:
+ type: object
+ properties:
+ data:
+ $ref: '#/definitions/v1PreparedAction'
+ v1PrepareClosePositionResponse:
+ type: object
+ properties:
+ data:
+ $ref: '#/definitions/v1PreparedAction'
+ v1PrepareManualSellResponse:
+ type: object
+ properties:
+ data:
+ $ref: '#/definitions/v1PreparedAction'
+ v1PrepareStartCopyResponse:
+ type: object
+ properties:
+ data:
+ $ref: '#/definitions/v1PreparedAction'
+ v1PrepareStopCopyResponse:
+ type: object
+ properties:
+ data:
+ $ref: '#/definitions/v1PreparedAction'
+ v1PrepareWithdrawQuoteResponse:
+ type: object
+ properties:
+ data:
+ $ref: '#/definitions/v1PreparedAction'
+ v1PreparedAction:
+ type: object
+ properties:
+ status:
+ $ref: '#/definitions/v1PreparedActionStatus'
+ chainId:
+ type: string
+ format: int64
+ expectedAccount:
+ type: string
+ preparedAt:
+ type: string
+ format: date-time
+ reprepareAfter:
+ type: string
+ format: date-time
+ liquidationConfigDeadline:
+ type: string
+ format: date-time
+ call:
+ $ref: '#/definitions/v1PreparedCall'
+ reason:
+ $ref: '#/definitions/v1PreparedActionReason'
+ warnings:
+ type: array
+ items:
+ $ref: '#/definitions/v1PreparedActionWarning'
+ evidence:
+ $ref: '#/definitions/v1ActionEvidence'
+ copyAccount:
+ type: string
+ startCopy:
+ $ref: '#/definitions/v1StartCopyPreview'
+ addCapital:
+ $ref: '#/definitions/v1AddCapitalPreview'
+ stopCopy:
+ $ref: '#/definitions/v1StopCopyPreview'
+ withdrawQuote:
+ $ref: '#/definitions/v1WithdrawQuotePreview'
+ manualSell:
+ $ref: '#/definitions/v1PositionSellPreview'
+ closePosition:
+ $ref: '#/definitions/v1PositionSellPreview'
+ description: PreparedAction is the common current-action result.
+ v1PreparedActionReason:
+ type: string
+ enum:
+ - PREPARED_ACTION_REASON_UNSPECIFIED
+ - PREPARED_ACTION_REASON_ALREADY_ACTIVE
+ - PREPARED_ACTION_REASON_NOT_CURRENT_OWNER
+ - PREPARED_ACTION_REASON_ACCOUNT_NOT_ACTIVE
+ - PREPARED_ACTION_REASON_ACCOUNT_NOT_STOPPED
+ - PREPARED_ACTION_REASON_ACCOUNT_PERMANENTLY_PAUSED
+ - PREPARED_ACTION_REASON_EXIT_IN_PROGRESS
+ - PREPARED_ACTION_REASON_EXIT_NOT_TERMINAL
+ - PREPARED_ACTION_REASON_SOURCE_STALE
+ - PREPARED_ACTION_REASON_SOURCE_COVERAGE_PENDING
+ - PREPARED_ACTION_REASON_FACTORY_PAUSED
+ - PREPARED_ACTION_REASON_FEE_POLICY_CHANGED
+ - PREPARED_ACTION_REASON_SIGNER_POLICY_CHANGED
+ - PREPARED_ACTION_REASON_REQUEST_ID_CONFLICT
+ - PREPARED_ACTION_REASON_UNSUPPORTED_ACCOUNT_GENERATION
+ - PREPARED_ACTION_REASON_NO_QUOTE_BALANCE
+ - PREPARED_ACTION_REASON_INSUFFICIENT_QUOTE_BALANCE
+ - PREPARED_ACTION_REASON_CONTROLLER_PAUSED
+ - PREPARED_ACTION_REASON_COPY_RUN_STOPPED
+ - PREPARED_ACTION_REASON_UNSUPPORTED_QUOTE_TOKEN
+ - PREPARED_ACTION_REASON_AMOUNT_BELOW_MINIMUM
+ - PREPARED_ACTION_REASON_INVALID_STOP_INTENT
+ - PREPARED_ACTION_REASON_NO_EXECUTABLE_ROUTE
+ - PREPARED_ACTION_REASON_INNER_CALL_REVERTED
+ - PREPARED_ACTION_REASON_NO_SELLABLE_BASE
+ - PREPARED_ACTION_REASON_NO_PENDING_SELL_OBLIGATION
+ - PREPARED_ACTION_REASON_SELL_OBLIGATION_CHANGED
+ - PREPARED_ACTION_REASON_POSITION_NOT_OPEN
+ - PREPARED_ACTION_REASON_CLOSE_NOT_ELIGIBLE
+ - PREPARED_ACTION_REASON_INSUFFICIENT_QUOTE_ALLOWANCE
+ default: PREPARED_ACTION_REASON_UNSPECIFIED
+ description: PreparedActionReason is the shared stable action/preparation reason vocabulary.
+ v1PreparedActionStatus:
+ type: string
+ enum:
+ - PREPARED_ACTION_STATUS_UNSPECIFIED
+ - PREPARED_ACTION_STATUS_READY
+ - PREPARED_ACTION_STATUS_PARTIALLY_COMPLETED
+ - PREPARED_ACTION_STATUS_COMPLETED
+ - PREPARED_ACTION_STATUS_PENDING
+ - PREPARED_ACTION_STATUS_UNAVAILABLE
+ default: PREPARED_ACTION_STATUS_UNSPECIFIED
+ description: PreparedActionStatus describes whether a prepared action can be submitted.
+ v1PreparedActionWarning:
+ type: string
+ enum:
+ - PREPARED_ACTION_WARNING_UNSPECIFIED
+ - PREPARED_ACTION_WARNING_ALLOCATION_STALE
+ - PREPARED_ACTION_WARNING_INVALID_STOP_INTENT_RECOVERED
+ - PREPARED_ACTION_WARNING_OWNER_SNAPSHOT_REQUIRES_REFRESH
+ default: PREPARED_ACTION_WARNING_UNSPECIFIED
+ description: PreparedActionWarning carries allowlisted render-only qualifications.
+ v1PreparedCall:
+ type: object
+ properties:
+ kind:
+ $ref: '#/definitions/v1PreparedCallKind'
+ to:
+ type: string
+ data:
+ type: string
+ valueRaw:
+ type: string
+ description: PreparedCall is one reviewed ordinary EVM CALL. The wallet owns its outer envelope.
+ v1PreparedCallKind:
+ type: string
+ enum:
+ - PREPARED_CALL_KIND_UNSPECIFIED
+ - PREPARED_CALL_KIND_START_COPY_CREATE
+ - PREPARED_CALL_KIND_START_COPY_FUND
+ - PREPARED_CALL_KIND_ADD_CAPITAL
+ - PREPARED_CALL_KIND_STOP_COPY
+ - PREPARED_CALL_KIND_WITHDRAW_QUOTE
+ - PREPARED_CALL_KIND_MANUAL_SELL
+ - PREPARED_CALL_KIND_CLOSE_POSITION
+ default: PREPARED_CALL_KIND_UNSPECIFIED
+ description: PreparedCallKind identifies the reviewed semantic call returned to the wallet.
+ v1ProjectorCoverage:
+ type: object
+ properties:
+ projector:
+ type: string
+ completedThroughBlockNumber:
+ type: string
+ coverageGeneration:
+ type: string
+ sourceReorgSequence:
+ type: string
+ description: ProjectorCoverage identifies one projector included in the frozen evidence fold.
+ v1RatioMetric:
+ type: object
+ properties:
+ valueRaw:
+ type: string
+ status:
+ $ref: '#/definitions/v1MetricStatus'
+ asOf:
+ type: string
+ format: date-time
+ description: RatioMetric preserves an exact fixed-point ratio scaled by 1e18.
+ v1RawAmountMetric:
+ type: object
+ properties:
+ valueRaw:
+ type: string
+ status:
+ $ref: '#/definitions/v1MetricStatus'
+ asOf:
+ type: string
+ format: date-time
+ description: RawAmountMetric preserves authoritative zero separately from unavailable data.
+ v1ResponseMeta:
+ type: object
+ properties:
+ requestId:
+ type: string
+ generatedAt:
+ type: string
+ format: date-time
+ dataAsOf:
+ type: string
+ format: date-time
+ stalenessReason:
+ type: string
+ asOfChains:
+ type: array
+ items:
+ type: object
+ $ref: '#/definitions/v1ChainFreshness'
+ status:
+ $ref: '#/definitions/v1DataStatus'
+ description: ResponseMeta carries freshness metadata for public responses.
+ v1SortOrder:
+ type: string
+ enum:
+ - SORT_ORDER_UNSPECIFIED
+ - SORT_ORDER_ASC
+ - SORT_ORDER_DESC
+ default: SORT_ORDER_UNSPECIFIED
+ description: SortOrder controls the direction of a stable public order.
+ v1StartCopyAllowanceRequirement:
+ type: object
+ properties:
+ spenderAddress:
+ type: string
+ currentAllowanceRaw:
+ type: string
+ requiredAllowanceRaw:
+ type: string
+ approvalScheme:
+ $ref: '#/definitions/v1StartCopyApprovalScheme'
+ permitScheme:
+ $ref: '#/definitions/v1StartCopyPermitScheme'
+ eip712DomainName:
+ type: string
+ eip712DomainVersion:
+ type: string
+ eip712DomainKind:
+ $ref: '#/definitions/v1StartCopyEIP712DomainKind'
+ description: |-
+ StartCopyAllowanceRequirement provides the exact signer requirement for a
+ funded create that cannot proceed with the wallet's current allowance.
+ v1StartCopyApprovalScheme:
+ type: string
+ enum:
+ - START_COPY_APPROVAL_SCHEME_UNSPECIFIED
+ - START_COPY_APPROVAL_SCHEME_STANDARD
+ - START_COPY_APPROVAL_SCHEME_ZERO_THEN_SET
+ default: START_COPY_APPROVAL_SCHEME_UNSPECIFIED
+ description: |-
+ StartCopyApprovalScheme identifies the token's reviewed ERC-20 approval
+ behavior when a permit is unavailable.
+ v1StartCopyEIP712DomainKind:
+ type: string
+ enum:
+ - START_COPY_EIP712_DOMAIN_KIND_UNSPECIFIED
+ - START_COPY_EIP712_DOMAIN_KIND_CHAIN_ID
+ - START_COPY_EIP712_DOMAIN_KIND_CHAIN_ID_SALT
+ default: START_COPY_EIP712_DOMAIN_KIND_UNSPECIFIED
+ description: |-
+ StartCopyEIP712DomainKind identifies the reviewed EIP-712 domain shape for
+ a permit-backed funded create.
+ v1StartCopyFundingMode:
+ type: string
+ enum:
+ - START_COPY_FUNDING_MODE_UNSPECIFIED
+ - START_COPY_FUNDING_MODE_UNFUNDED
+ - START_COPY_FUNDING_MODE_FUNDED
+ default: START_COPY_FUNDING_MODE_UNSPECIFIED
+ description: |-
+ StartCopyFundingMode makes create-time quote funding explicit. The operator
+ remains authoritative for the configured quote token's permit capability.
+ v1StartCopyPermitScheme:
+ type: string
+ enum:
+ - START_COPY_PERMIT_SCHEME_UNSPECIFIED
+ - START_COPY_PERMIT_SCHEME_ALLOWANCE_ONLY
+ - START_COPY_PERMIT_SCHEME_ERC20_EIP2612
+ - START_COPY_PERMIT_SCHEME_ERC20_DAI_LIKE
+ default: START_COPY_PERMIT_SCHEME_UNSPECIFIED
+ description: |-
+ StartCopyPermitScheme identifies the reviewed permit encoding, independent
+ from the opaque permit bytes supplied by the wallet.
+ v1StartCopyPreview:
+ type: object
+ properties:
+ stage:
+ $ref: '#/definitions/v1StartCopyStage'
+ startRequestId:
+ type: string
+ predictedCopyAccount:
+ type: string
+ quoteToken:
+ $ref: '#/definitions/v1Token'
+ requestedTargetRaw:
+ type: string
+ initialCapitalCredited:
+ $ref: '#/definitions/v1RawAmountMetric'
+ remainingTargetDeficit:
+ $ref: '#/definitions/v1RawAmountMetric'
+ minimumInitialCapitalRaw:
+ type: string
+ walletQuoteBalance:
+ $ref: '#/definitions/v1RawAmountMetric'
+ feePolicy:
+ $ref: '#/definitions/v1FeePolicyPreview'
+ createAmountRaw:
+ type: string
+ description: |-
+ Create-time capital encoded into the create call. Present only when the
+ operator returns the create stage; "0" means explicitly unfunded.
+ allowanceRequirement:
+ $ref: '#/definitions/v1StartCopyAllowanceRequirement'
+ description: StartCopyPreview contains the deterministic create/fund state shown by the UI.
+ v1StartCopyStage:
+ type: string
+ enum:
+ - START_COPY_STAGE_UNSPECIFIED
+ - START_COPY_STAGE_CREATE_REQUIRED
+ - START_COPY_STAGE_FUNDING_REQUIRED
+ - START_COPY_STAGE_COMPLETE
+ - START_COPY_STAGE_CREATE_CONFIRMING
+ default: START_COPY_STAGE_UNSPECIFIED
+ description: |-
+ StartCopyStage identifies the current deterministic Start Copy stage.
+
+ - START_COPY_STAGE_CREATE_CONFIRMING: The predicted account exists at the action block, but canonical safe
+ creation history/opening allocation has not yet reached funding authority.
+ This stage never carries executable calldata.
+ v1StopCopyPreview:
+ type: object
+ properties:
+ positions:
+ type: array
+ items:
+ type: object
+ $ref: '#/definitions/v1StopPositionPreview'
+ totalCurrentValueUsd:
+ $ref: '#/definitions/v1DecimalMetric'
+ totalCashback:
+ $ref: '#/definitions/v1RawAmountMetric'
+ quoteToken:
+ $ref: '#/definitions/v1Token'
+ totalSwapQuote:
+ $ref: '#/definitions/v1SwapQuotePreview'
+ description: StopCopyPreview contains the atomic Stop Copy selection and totals.
+ v1StopPositionPreview:
+ type: object
+ properties:
+ userPositionId:
+ type: string
+ tradeId:
+ type: string
+ baseToken:
+ $ref: '#/definitions/v1Token'
+ userBaseRaw:
+ type: string
+ cashback:
+ $ref: '#/definitions/v1RawAmountMetric'
+ currentValuation:
+ $ref: '#/definitions/v1PositionValuation'
+ lifecycle:
+ $ref: '#/definitions/v1PositionLifecycle'
+ unrealizedPnlUsd:
+ $ref: '#/definitions/v1DecimalMetric'
+ swapQuote:
+ $ref: '#/definitions/v1SwapQuotePreview'
+ description: StopPositionPreview is one bounded position row in a Stop Copy preview.
+ v1StrategyCategory:
+ type: string
+ enum:
+ - STRATEGY_CATEGORY_UNSPECIFIED
+ - STRATEGY_CATEGORY_FOCUSED
+ - STRATEGY_CATEGORY_DIVERSIFIED
+ - STRATEGY_CATEGORY_ACTIVE
+ default: STRATEGY_CATEGORY_UNSPECIFIED
+ description: StrategyCategory is a derived, overlapping public strategy category.
+ v1StrategyExecutionItem:
+ type: object
+ properties:
+ label:
+ type: string
+ description:
+ type: string
+ description: StrategyExecutionItem is one configured Strategy & Execution display item.
+ v1SwapQuotePreview:
+ type: object
+ properties:
+ expectedQuote:
+ $ref: '#/definitions/v1RawAmountMetric'
+ minimumQuote:
+ $ref: '#/definitions/v1RawAmountMetric'
+ effectiveSlippageBps:
+ type: integer
+ format: int64
+ description: SwapQuotePreview is valid only for its parent preparation through reprepare_after.
+ v1Token:
+ type: object
+ properties:
+ chainId:
+ type: string
+ format: int64
+ address:
+ type: string
+ symbol:
+ type: string
+ name:
+ type: string
+ decimals:
+ type: integer
+ format: int32
+ logoUrl:
+ type: string
+ description: Token describes public token display metadata.
+ v1WalletBalanceRow:
+ type: object
+ properties:
+ chainId:
+ type: string
+ format: int64
+ copyAccount:
+ type: string
+ tokenAddress:
+ type: string
+ amountDecimal:
+ type: string
+ balanceSource:
+ type: string
+ freshnessStatus:
+ type: string
+ balanceAsOfBlock:
+ type: string
+ cachedAt:
+ type: string
+ format: date-time
+ stalenessReason:
+ type: string
+ token:
+ $ref: '#/definitions/v1Token'
+ currentValuation:
+ $ref: '#/definitions/v1PositionValuation'
+ description: WalletBalanceRow is a copy-account wallet inventory row.
+ v1Window:
+ type: string
+ enum:
+ - WINDOW_UNSPECIFIED
+ - WINDOW_7D
+ - WINDOW_30D
+ - WINDOW_90D
+ - WINDOW_ALL
+ default: WINDOW_UNSPECIFIED
+ description: Window selects a public metric or chart time window.
+ v1WindowPolicy:
+ type: string
+ enum:
+ - WINDOW_POLICY_UNSPECIFIED
+ - WINDOW_POLICY_TRAILING
+ - WINDOW_POLICY_SINCE_LIVE
+ - WINDOW_POLICY_SINCE_COPY_START
+ default: WINDOW_POLICY_UNSPECIFIED
+ description: WindowPolicy identifies how an APR interval boundary was selected.
+ v1WithdrawQuotePreview:
+ type: object
+ properties:
+ quoteToken:
+ $ref: '#/definitions/v1Token'
+ quoteBalance:
+ $ref: '#/definitions/v1RawAmountMetric'
+ sweepAmountRaw:
+ type: string
+ recipientAddress:
+ type: string
+ description: WithdrawQuotePreview describes a repeatable max sweep to the owner snapshot at H.
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/MyCopies/ActiveSubscriptionsTable.tsx b/apps/kyberswap-interface/src/pages/CopyTrading/MyCopies/ActiveSubscriptionsTable.tsx
new file mode 100644
index 0000000000..48491484f1
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/MyCopies/ActiveSubscriptionsTable.tsx
@@ -0,0 +1,173 @@
+import { type HTMLAttributes } from 'react'
+import type { CopyRunSummary } from 'services/copyTrading/types/copyRuns'
+import type { CopyRunSortBy, SortOrder } from 'services/copyTrading/types/primitives'
+
+import { ButtonLight } from 'components/Button'
+import { Stack } from 'components/Stack'
+import CursorPagination, { type CursorPaginationState } from 'pages/CopyTrading/components/CursorPagination'
+import { HeaderCell, TableBody, TableCell, TableHeader, TableRow } from 'pages/CopyTrading/components/Table'
+import { CopyRunAgentCell } from 'pages/CopyTrading/components/common/agentIdentity'
+import { copyTradingStatIconMap } from 'pages/CopyTrading/constants'
+import {
+ compactUsd,
+ formatCount,
+ formatUsd,
+ getAgentDisplayName,
+ getDisplayCapitalInUsd,
+ getPreparedReasonMessage,
+ getSignedMetricClassName,
+ getWinRateClassName,
+ isActionAvailable,
+ percent,
+} from 'pages/CopyTrading/helpers'
+import { useCopyTradingModal } from 'pages/CopyTrading/modals/context'
+import { cn } from 'utils/cn'
+
+type ActiveSubscriptionsGridProps = HTMLAttributes & {
+ header?: boolean
+}
+
+const ActiveSubscriptionsGrid = ({ header, className, ...props }: ActiveSubscriptionsGridProps) => {
+ const Grid = header ? TableHeader : TableRow
+
+ return (
+
+
+ )
+}
+
+export default ActiveSubscriptionsTable
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/MyCopies/components.tsx b/apps/kyberswap-interface/src/pages/CopyTrading/MyCopies/components.tsx
new file mode 100644
index 0000000000..dd92567e32
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/MyCopies/components.tsx
@@ -0,0 +1,160 @@
+import type { ActivityRow, OwnerCopySummary } from 'services/copyTrading/types/copyRuns'
+
+import Dots from 'components/Dots'
+import { HStack, Stack } from 'components/Stack'
+import InfiniteScroll, { type InfiniteScrollState } from 'pages/CopyTrading/components/InfiniteScroll'
+import Leaderboard, { type LeaderboardStat } from 'pages/CopyTrading/components/Leaderboard'
+import { AgentAvatar } from 'pages/CopyTrading/components/common/agentIdentity'
+import { ContentPanel } from 'pages/CopyTrading/components/common/layout'
+import { copyTradingStatIconMap } from 'pages/CopyTrading/constants'
+import {
+ formatCount,
+ formatUsd,
+ getActivityLabel,
+ getSignedMetricClassName,
+ signedUsd,
+} from 'pages/CopyTrading/helpers'
+import { cn } from 'utils/cn'
+import { formatDateTime } from 'utils/time'
+
+type OpenCopiesSummaryProps = {
+ fallbackActiveCopies?: number
+ summary?: OwnerCopySummary
+}
+
+export const OpenCopiesSummary = ({ fallbackActiveCopies, summary }: OpenCopiesSummaryProps) => {
+ const stats: LeaderboardStat[] = [
+ {
+ label: 'Total Allocated',
+ value: formatUsd(summary?.totalAllocatedUsd),
+ icon: copyTradingStatIconMap.volume,
+ status: summary?.metrics.totalAllocatedUsd?.status,
+ },
+ {
+ label: 'Unrealised P&L',
+ value: signedUsd(summary?.unrealizedPnlUsd),
+ valueClassName: getSignedMetricClassName(summary?.unrealizedPnlUsd),
+ icon: copyTradingStatIconMap.money,
+ status: summary?.metrics.unrealizedPnlUsd?.status,
+ },
+ {
+ label: 'Open Positions',
+ value: formatCount(summary?.openPositions),
+ icon: copyTradingStatIconMap.positionOpen,
+ status: summary?.metrics.openPositionCount?.status,
+ },
+ {
+ label: 'Active Copies',
+ value: formatCount(summary?.activeCopies ?? fallbackActiveCopies),
+ icon: copyTradingStatIconMap.agents,
+ status: summary?.metrics.activeCopyRuns?.status,
+ },
+ ]
+
+ return
+
+
+ {rows.map(item => {
+ const agentName = getActivityAgentName(item)
+ const activityLabel = getActivityLabel(item)
+ const tokenSymbol = getActivityTokenSymbol(item)
+ const valueUsd = getActivityValueUsd(item)
+ const realizedPnlUsd = item.position?.realizedPnlUsd?.value
+ const publicError = item.execution?.publicErrorMessage
+ const summary = item.summary.trim()
+ const showSummary = !!summary && !isSameActivityCopy(summary, activityLabel)
+ const showPublicError =
+ !!publicError &&
+ !isSameActivityCopy(publicError, summary) &&
+ !isSameActivityCopy(publicError, activityLabel)
+
+ return (
+
+
+
+ {activityLabel}
+ •
+ {agentName}
+ {formatDateTime(item.occurredAt)}
+
+ {showSummary && {summary}}
+ {showPublicError && {publicError}}
+ {(tokenSymbol || valueUsd !== undefined || realizedPnlUsd !== undefined) && (
+
+ {tokenSymbol && (
+
+ Token: {tokenSymbol}
+
+ )}
+ {valueUsd !== undefined && (
+
+ Value: {formatUsd(valueUsd)}
+
+ )}
+ {realizedPnlUsd !== undefined && (
+
+ Realised P&L:{' '}
+
+ {signedUsd(realizedPnlUsd)}
+
+
+ )}
+
+ )}
+
+
+ )
+ })}
+
+ {loading && !rows.length && (
+
+ Loading
+
+ )}
+ {!loading && !rows.length && (
+ No recent activity found
+ )}
+
+
+
+ )
+}
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/MyCopies/index.tsx b/apps/kyberswap-interface/src/pages/CopyTrading/MyCopies/index.tsx
new file mode 100644
index 0000000000..5c5f77e52f
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/MyCopies/index.tsx
@@ -0,0 +1,112 @@
+import { useState } from 'react'
+import { useNavigate } from 'react-router-dom'
+import copyRunApi from 'services/copyTrading/api/endpoints/copyRuns'
+import type { CopyRunSortBy, SortOrder } from 'services/copyTrading/types/primitives'
+
+import { APP_PATHS } from 'constants/index'
+import useIsWalletRestoring from 'hooks/useIsWalletRestoring'
+import ActiveSubscriptionsTable from 'pages/CopyTrading/MyCopies/ActiveSubscriptionsTable'
+import { AlertsFeed, OpenCopiesSummary } from 'pages/CopyTrading/MyCopies/components'
+import CopyRunsPageHeading from 'pages/CopyTrading/components/CopyRunsPageHeading'
+import { useCursorPageQuery } from 'pages/CopyTrading/components/CursorPagination'
+import { useInfiniteCursorQuery } from 'pages/CopyTrading/components/InfiniteScroll'
+import { CopyTradingPage } from 'pages/CopyTrading/components/common/layout'
+import { OwnerWalletRequired } from 'pages/CopyTrading/components/common/status'
+import { useCopyTradingContext } from 'pages/CopyTrading/context'
+
+const PAGE_SIZE = 10
+
+const MyCopiesView = () => {
+ const navigate = useNavigate()
+ const { ownerAddress } = useCopyTradingContext()
+ const isRestoringWallet = useIsWalletRestoring()
+ const [sortBy, setSortBy] = useState()
+ const [sortOrder, setSortOrder] = useState()
+ const [getCopyRuns] = copyRunApi.useLazyGetCopyRunsQuery()
+ const [getOwnerActivity] = copyRunApi.useLazyGetOwnerActivityQuery()
+
+ const activeRunsPage = useCursorPageQuery({
+ enabled: !!ownerAddress,
+ queryKey: ['copy-trading', 'copy-runs', ownerAddress, 'open', sortBy, sortOrder],
+ queryFn: cursor =>
+ getCopyRuns({
+ ownerAddress: ownerAddress || '',
+ view: 'open',
+ sortBy,
+ sortOrder,
+ cursor,
+ limit: PAGE_SIZE,
+ }).unwrap(),
+ })
+
+ const {
+ infiniteScroll: activityInfiniteScroll,
+ isFetching: isActivityFetching,
+ items: activityRows,
+ } = useInfiniteCursorQuery({
+ enabled: !!ownerAddress,
+ queryKey: ['copy-trading', 'owner-activity', ownerAddress],
+ queryFn: cursor =>
+ getOwnerActivity({
+ ownerAddress: ownerAddress || '',
+ cursor,
+ limit: PAGE_SIZE,
+ }).unwrap(),
+ })
+
+ const { currentData: ownerSummary } = copyRunApi.useGetOwnerCopySummaryQuery(
+ {
+ ownerAddress: ownerAddress || '',
+ view: 'open',
+ },
+ { pollingInterval: 10_000, skip: !ownerAddress },
+ )
+
+ const activeRuns = activeRunsPage.items
+ const summary = ownerSummary?.data
+
+ const handleSortChange = (nextSortBy: CopyRunSortBy) => {
+ if (sortBy !== nextSortBy) {
+ setSortBy(nextSortBy)
+ setSortOrder('desc')
+ return
+ }
+ if (sortOrder === 'desc') {
+ setSortOrder('asc')
+ return
+ }
+ setSortBy(undefined)
+ setSortOrder(undefined)
+ }
+
+ return (
+
+
+ navigate(`${APP_PATHS.COPY_TRADING}/my-copies/${subscription.copyRunId}`)
+ }
+ />
+
+ )
+}
+
+export default MyCopiesView
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/components/AgentSidebarCards/AgentProfileCards.tsx b/apps/kyberswap-interface/src/pages/CopyTrading/components/AgentSidebarCards/AgentProfileCards.tsx
new file mode 100644
index 0000000000..1d51c73ce4
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/components/AgentSidebarCards/AgentProfileCards.tsx
@@ -0,0 +1,97 @@
+import type { AgentProfile } from 'services/copyTrading/types/agents'
+
+import Badge, { BadgeVariant } from 'components/Badge'
+import InfoHelper from 'components/InfoHelper'
+import { HStack, Stack } from 'components/Stack'
+import { SidePanelCard } from 'pages/CopyTrading/components/AgentSidebarCards/SidePanelCard'
+import { getWinRateClassName, getWinRateTone, percent } from 'pages/CopyTrading/helpers'
+import { cn } from 'utils/cn'
+
+export const AgentRiskCard = ({ agent }: { agent: AgentProfile }) => {
+ const winRatePct = agent.stats.winRatePct
+ const winRate = Math.max(0, Math.min(100, Number(winRatePct || 0)))
+ const winRateBackgroundClassName = getWinRateClassName(winRatePct, 'background')
+ const winRateTone = getWinRateTone(winRatePct)
+ const winRateBadgeVariant =
+ winRateTone === 'positive'
+ ? BadgeVariant.PRIMARY
+ : winRateTone === 'warning'
+ ? BadgeVariant.WARNING
+ : winRateTone === 'negative'
+ ? BadgeVariant.NEGATIVE
+ : undefined
+
+ return (
+
+
+ Win Rate
+
+
+ Max Drawdown
+ {percent(agent.stats.maxDrawdownPct)}
+
+
+ )
+}
+
+export const StrategyExecutionCard = ({ items }: { items: AgentProfile['strategyExecutionItems'] }) => {
+ return (
+
+ {items.length ? (
+
+ {items.map(item => (
+
+ {item.label}: {item.description}
+
+ ))}
+
+ ) : (
+ No strategy or execution details available
+ )}
+
+ )
+}
+
+export const WhitelistedTokensCard = ({ tokens }: { tokens: string[] }) => {
+ return (
+
+ Whitelisted Tokens
+
+ {tokens.length ? (
+ tokens.map(token => (
+
+ {token}
+
+ ))
+ ) : (
+ No whitelisted tokens
+ )}
+
+
+ )
+}
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/components/AgentSidebarCards/CopyActionCards.tsx b/apps/kyberswap-interface/src/pages/CopyTrading/components/AgentSidebarCards/CopyActionCards.tsx
new file mode 100644
index 0000000000..6ad9874cc0
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/components/AgentSidebarCards/CopyActionCards.tsx
@@ -0,0 +1,104 @@
+import type { AdvisoryActionAvailability } from 'services/copyTrading/types/actionAvailability'
+
+import { ButtonLight, ButtonPrimary } from 'components/Button'
+import { HStack } from 'components/Stack'
+import {
+ SidePanelCard,
+ type SidePanelCardWrapperProps,
+} from 'pages/CopyTrading/components/AgentSidebarCards/SidePanelCard'
+import { getPreparedReasonMessage, isActionAvailable } from 'pages/CopyTrading/helpers'
+
+type CopyCapitalCardProps = SidePanelCardWrapperProps & {
+ addCapitalAvailability?: AdvisoryActionAvailability
+ capital: string
+ stopCopyAvailability?: AdvisoryActionAvailability
+ onView?: () => void
+ onAddCapital?: () => void
+ onStopCopy?: () => void
+}
+
+export const CopyCapitalCard = ({
+ addCapitalAvailability,
+ capital,
+ stopCopyAvailability,
+ title = 'Your Current Copy',
+ onView,
+ onAddCapital,
+ onStopCopy,
+ ...sidePanelCardProps
+}: CopyCapitalCardProps) => {
+ const addCapitalDisabled = !isActionAvailable(addCapitalAvailability)
+ const stopCopyDisabled = !isActionAvailable(stopCopyAvailability)
+ const hasActions = !!onStopCopy || !!onView || !!onAddCapital
+
+ return (
+
+
+ Capital In
+ {capital}
+
+ {hasActions && (
+
+ {onStopCopy && (
+
+ )}
+
+ )
+}
+
+export const WithdrawQuoteCard = ({
+ availability,
+ onWithdraw,
+}: {
+ availability?: AdvisoryActionAvailability
+ onWithdraw: () => void
+}) => {
+ const disabled = !isActionAvailable(availability)
+
+ return (
+
+ Withdraw available quote balance without selling positions.
+
+ Withdraw
+
+
+ )
+}
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/components/AgentSidebarCards/SidePanelCard.tsx b/apps/kyberswap-interface/src/pages/CopyTrading/components/AgentSidebarCards/SidePanelCard.tsx
new file mode 100644
index 0000000000..a70e4164c4
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/components/AgentSidebarCards/SidePanelCard.tsx
@@ -0,0 +1,88 @@
+import { AnimatePresence, motion } from 'framer-motion'
+import { type PropsWithChildren, type ReactNode, useState } from 'react'
+import { ChevronDown, ChevronUp } from 'react-feather'
+
+import { HStack, Stack } from 'components/Stack'
+import { cn } from 'utils/cn'
+
+export type SidePanelCardProps = PropsWithChildren<{
+ bodyClassName?: string
+ collapsible?: boolean
+ headerRight?: ReactNode
+ initialExpanded?: boolean
+ title?: ReactNode
+}>
+
+export type SidePanelCardWrapperProps = Omit
+
+export const SidePanelCard = ({
+ bodyClassName,
+ children,
+ collapsible,
+ headerRight,
+ initialExpanded = true,
+ title,
+}: SidePanelCardProps) => {
+ const [expanded, setExpanded] = useState(initialExpanded)
+ const hasBody = children !== undefined && children !== null && children !== false
+
+ if (collapsible && title && hasBody) {
+ return (
+
+
+
+ {expanded && (
+
+ {children}
+
+ )}
+
+
+ )
+ }
+
+ return (
+
+ {title && (
+
+ {headerRight ? (
+
+ )}
+ {hasBody && {children} }
+
+ )
+}
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/components/CopyRunsPageHeading.tsx b/apps/kyberswap-interface/src/pages/CopyTrading/components/CopyRunsPageHeading.tsx
new file mode 100644
index 0000000000..a70878ac20
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/components/CopyRunsPageHeading.tsx
@@ -0,0 +1,66 @@
+import { Link } from 'react-router-dom'
+
+import { Stack } from 'components/Stack'
+import { APP_PATHS } from 'constants/index'
+import { cn } from 'utils/cn'
+
+type CopyRunsView = 'open' | 'history'
+
+type CopyRunsPageHeadingProps = {
+ activeView: CopyRunsView
+}
+
+const copyRunsTabs: Array<{
+ description: string
+ label: string
+ to: string
+ value: CopyRunsView
+}> = [
+ {
+ description: 'Monitor and manage all your active copy positions.',
+ label: 'Open Copies',
+ to: `${APP_PATHS.COPY_TRADING}/my-copies`,
+ value: 'open',
+ },
+ {
+ description: 'Review all closed copy runs and settled performance.',
+ label: 'History',
+ to: `${APP_PATHS.COPY_TRADING}/history`,
+ value: 'history',
+ },
+]
+
+const CopyRunsPageHeading = ({ activeView }: CopyRunsPageHeadingProps) => {
+ const activeTab = copyRunsTabs.find(tab => tab.value === activeView) || copyRunsTabs[0]
+
+ return (
+
+
+ )
+}
+
+export default CopyRunsPageHeading
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/components/CursorPagination/index.tsx b/apps/kyberswap-interface/src/pages/CopyTrading/components/CursorPagination/index.tsx
new file mode 100644
index 0000000000..d20778b2c3
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/components/CursorPagination/index.tsx
@@ -0,0 +1,124 @@
+import { type QueryKey, useQuery } from '@tanstack/react-query'
+import { useEffect, useState } from 'react'
+import { ChevronLeft, ChevronRight } from 'react-feather'
+import type { CursorResponse } from 'services/copyTrading/types/primitives'
+
+import { ButtonLight } from 'components/Button'
+import { HStack } from 'components/Stack'
+
+type CursorPageQueryParams> = {
+ enabled?: boolean
+ queryFn: (cursor?: string) => Promise
+ queryKey: QueryKey
+}
+
+type CursorItem = TResponse extends CursorResponse ? T : never
+
+type PaginationState = {
+ currentPage: number
+ cursors: Array
+ scopeKey: string
+}
+
+export const useCursorPageQuery = >({
+ enabled = true,
+ queryFn,
+ queryKey,
+}: CursorPageQueryParams) => {
+ const scopeKey = JSON.stringify(queryKey)
+ const [pagination, setPagination] = useState(() => ({
+ currentPage: 1,
+ cursors: [undefined],
+ scopeKey,
+ }))
+ const paginationReady = pagination.scopeKey === scopeKey
+ const currentPage = paginationReady ? pagination.currentPage : 1
+ const cursor = paginationReady ? pagination.cursors[currentPage - 1] : undefined
+
+ useEffect(() => {
+ if (!paginationReady) setPagination({ currentPage: 1, cursors: [undefined], scopeKey })
+ }, [paginationReady, scopeKey])
+
+ const query = useQuery({
+ enabled: enabled && paginationReady,
+ queryKey: [...queryKey, 'page', cursor || null],
+ queryFn: () => queryFn(cursor),
+ refetchInterval: 10_000,
+ retry: false,
+ })
+
+ const nextCursor = query.data?.pagination.nextCursor
+ const hasNextPage = !!query.data?.pagination.hasMore && !!nextCursor
+
+ const goToNextPage = () => {
+ if (!nextCursor || !hasNextPage) return
+
+ setPagination(current => ({
+ ...current,
+ currentPage: currentPage + 1,
+ cursors: [...current.cursors.slice(0, currentPage), nextCursor],
+ }))
+ }
+
+ const goToPreviousPage = () => {
+ setPagination(current => ({ ...current, currentPage: Math.max(1, currentPage - 1) }))
+ }
+
+ return {
+ currentPage,
+ error: query.isError,
+ hasNextPage,
+ items: (query.data?.data || []) as CursorItem[],
+ loading: query.isFetching && !query.data,
+ navigating: query.isFetching,
+ onNextPage: goToNextPage,
+ onPreviousPage: goToPreviousPage,
+ }
+}
+
+export type CursorPaginationState = {
+ currentPage: number
+ error?: boolean
+ hasNextPage: boolean
+ navigating?: boolean
+ onNextPage: () => void
+ onPreviousPage: () => void
+}
+
+const CursorPagination = ({
+ currentPage,
+ hasNextPage,
+ navigating,
+ onNextPage,
+ onPreviousPage,
+}: CursorPaginationState) => {
+ if (currentPage === 1 && !hasNextPage) return null
+
+ return (
+
+
+
+ Page {currentPage}
+
+ Next
+
+
+ )
+}
+
+export default CursorPagination
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/components/InfiniteScroll/index.tsx b/apps/kyberswap-interface/src/pages/CopyTrading/components/InfiniteScroll/index.tsx
new file mode 100644
index 0000000000..6f3cfa7768
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/components/InfiniteScroll/index.tsx
@@ -0,0 +1,116 @@
+import { type QueryKey, useInfiniteQuery } from '@tanstack/react-query'
+import { type PropsWithChildren, useEffect, useMemo, useRef } from 'react'
+import type { CursorResponse } from 'services/copyTrading/types/primitives'
+
+import Loader from 'components/Loader'
+import { Center, Stack } from 'components/Stack'
+import { cn } from 'utils/cn'
+
+export type InfiniteScrollState = {
+ error?: boolean
+ hasMore: boolean
+ initialError?: boolean
+ loadingMore?: boolean
+ onLoadMore: () => Promise | void
+}
+
+type InfiniteCursorQueryParams> = {
+ enabled?: boolean
+ queryFn: (cursor?: string) => Promise
+ queryKey: QueryKey
+}
+
+type CursorItem = TResponse extends CursorResponse ? T : never
+
+export const useInfiniteCursorQuery = >({
+ enabled = true,
+ queryFn,
+ queryKey,
+}: InfiniteCursorQueryParams) => {
+ const query = useInfiniteQuery({
+ enabled,
+ initialPageParam: null as string | null,
+ queryKey,
+ queryFn: ({ pageParam }) => queryFn(pageParam || undefined),
+ getNextPageParam: lastPage =>
+ lastPage.pagination.hasMore && lastPage.pagination.nextCursor ? lastPage.pagination.nextCursor : undefined,
+ refetchInterval: 10_000,
+ retry: false,
+ })
+
+ const items = useMemo[]>(
+ () => (query.data?.pages.flatMap(page => page.data) || []) as CursorItem[],
+ [query.data?.pages],
+ )
+
+ const infiniteScroll: InfiniteScrollState = {
+ error: query.isError,
+ hasMore: !!query.hasNextPage,
+ initialError: query.isError && !items.length,
+ loadingMore: query.isFetchingNextPage,
+ onLoadMore: query.fetchNextPage,
+ }
+
+ return {
+ infiniteScroll,
+ isFetching: query.isFetching,
+ items,
+ pages: query.data?.pages || [],
+ }
+}
+
+type InfiniteScrollProps = PropsWithChildren<
+ InfiniteScrollState & {
+ className?: string
+ }
+>
+
+const InfiniteScroll = ({
+ children,
+ className,
+ error,
+ hasMore,
+ initialError,
+ loadingMore,
+ onLoadMore,
+}: InfiniteScrollProps) => {
+ const scrollContainerRef = useRef(null)
+ const loadMoreRef = useRef(null)
+
+ useEffect(() => {
+ const root = scrollContainerRef.current
+ const target = loadMoreRef.current
+ if (!root || !target || error || !hasMore || loadingMore) return
+
+ const observer = new IntersectionObserver(
+ ([entry]) => {
+ if (entry.isIntersecting) void onLoadMore()
+ },
+ { root, rootMargin: '80px 0px' },
+ )
+
+ observer.observe(target)
+ return () => observer.disconnect()
+ }, [error, hasMore, loadingMore, onLoadMore])
+
+ return (
+
+
+ {item.label}
+
+ {item.status === 'METRIC_STATUS_STALE' && (
+ Stale
+ )}
+
+)
+
+const StatIconView = ({ icon }: Pick) => {
+ const { backgroundColor } = icon
+
+ return (
+
+ {'Icon' in icon ? (
+ 
+ )}
+
+ )
+}
+
+const LargeLeaderboardCard = ({ item }: LeaderboardCardProps) => {
+ return (
+
+
+
+ {item.value}
+
+
+
+ )
+}
+
+const SmallLeaderboardCard = ({ item }: LeaderboardCardProps) => {
+ return (
+
+
+
+ {item.value}
+
+
+
+ )
+}
+
+type LeaderboardCardSelectorProps = {
+ item: LeaderboardStat
+ size: LeaderboardSize
+}
+
+const LeaderboardCard = ({ item, size }: LeaderboardCardSelectorProps) =>
+ size === 'sm' ? [] = [
+ { label: '7D', value: '7d' },
+ { label: '1M', value: '30d' },
+ { label: '3M', value: '90d' },
+ { label: 'All', value: 'all' },
+]
+
+type PerformanceChartPoint = {
+ timestamp: number
+ portfolioValueUsd?: number
+ realizedPnlUsd?: number
+}
+
+const toChartNumber = (value?: string) => {
+ if (value === undefined) return undefined
+
+ const amount = Number(value)
+ return Number.isFinite(amount) ? amount : undefined
+}
+
+export const toPerformanceChartPoint = (point: PerformancePoint): PerformanceChartPoint => ({
+ timestamp: new Date(point.timestamp).getTime(),
+ portfolioValueUsd: toChartNumber(point.portfolioValueUsd),
+ realizedPnlUsd: toChartNumber(point.realizedPnlUsd),
+})
+
+const getPnlGradientOffset = (data: PerformanceChartPoint[]) => {
+ const values = data.map(point => point.realizedPnlUsd).filter(value => value !== undefined)
+ if (!values.length) return 1
+ const maximum = Math.max(...values)
+ const minimum = Math.min(...values)
+
+ if (maximum <= 0) return 0
+ if (minimum >= 0) return 1
+ return maximum / (maximum - minimum)
+}
+
+type ChartTitleProps = {
+ loading?: boolean
+ title: string
+}
+
+const ChartTitle = ({ loading, title }: ChartTitleProps) => (
+
+
+)
+
+type ChartTooltipProps = {
+ active?: boolean
+ payload?: Array<{
+ color?: string
+ dataKey?: string
+ name?: string
+ payload?: PerformanceChartPoint
+ value?: number
+ }>
+}
+
+const ChartTooltip = ({ active, payload }: ChartTooltipProps) => {
+ if (!active || !payload?.length) return null
+
+ const point = payload[0].payload
+ if (!point) return null
+
+ return (
+
+ {formatDateTime(point.timestamp)}
+ {payload.map(item => {
+ const isPnl = item.dataKey === 'realizedPnlUsd'
+
+ return (
+
+ {item.name}: {formatUsd(item.value === undefined ? undefined : String(item.value))}
+
+ )
+ })}
+
+ )
+}
+
+type PnlActiveDotProps = {
+ cx?: number
+ cy?: number
+ payload?: PerformanceChartPoint
+}
+
+const PnlActiveDot = ({ cx, cy, payload }: PnlActiveDotProps) => {
+ const value = payload?.realizedPnlUsd
+ const fill = value === undefined || value === 0 ? 'var(--ks-text)' : value > 0 ? 'var(--ks-primary)' : 'var(--ks-red)'
+
+ return
+
+
+
+ {!!data.length && (
+
+
+
+
+
+
+
+
+ compactUsd(String(value))}
+ tickLine={false}
+ width={72}
+ />
+
+
+ )}
+
+
+ )
+}
+
+type CapitalValueChartProps = {
+ data: PerformanceChartPoint[]
+ isError?: boolean
+ isFetching?: boolean
+ title?: string
+}
+
+export const CapitalValueChart = ({ data, isError, isFetching, title = 'Capital Value' }: CapitalValueChartProps) => {
+ return (
+
+
+ {!!data.length && (
+
+
+ compactUsd(String(value))}
+ tickLine={false}
+ width={72}
+ />
+
+
+ )}
+
+
+ )
+}
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/components/Sidebar/MobileNavigation.tsx b/apps/kyberswap-interface/src/pages/CopyTrading/components/Sidebar/MobileNavigation.tsx
new file mode 100644
index 0000000000..37c8b5b4ac
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/components/Sidebar/MobileNavigation.tsx
@@ -0,0 +1,92 @@
+import { Link } from 'react-router-dom'
+import type { Chain } from 'services/copyTrading/types/agents'
+
+import { Center } from 'components/Stack'
+import { APP_PATHS } from 'constants/index'
+import type { SidebarRouteState } from 'pages/CopyTrading/components/Sidebar/primitives'
+import { cn } from 'utils/cn'
+
+type MobileNavigationProps = {
+ agentsCount: number
+ chains: Chain[]
+ copiesCount: number
+ onSelectChain: (chainId: number) => void
+ route: SidebarRouteState
+ selectedChainId?: number
+}
+
+const MobileNavigation = ({
+ agentsCount,
+ chains,
+ copiesCount,
+ onSelectChain,
+ route,
+ selectedChainId,
+}: MobileNavigationProps) => {
+ const items = [
+ {
+ active: route.isAgentsPage,
+ count: agentsCount,
+ label: 'Agents',
+ to: APP_PATHS.COPY_TRADING,
+ },
+ {
+ active: route.isCopiesPage,
+ count: copiesCount,
+ label: 'Open Copies',
+ to: APP_PATHS.COPY_TRADING + '/my-copies',
+ },
+ {
+ active: route.isHistorySectionActive,
+ label: 'History',
+ to: APP_PATHS.COPY_TRADING + '/history',
+ },
+ ]
+
+ return (
+
+ )
+}
+
+export default MobileNavigation
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/components/Sidebar/index.tsx b/apps/kyberswap-interface/src/pages/CopyTrading/components/Sidebar/index.tsx
new file mode 100644
index 0000000000..6135a20dd3
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/components/Sidebar/index.tsx
@@ -0,0 +1,261 @@
+import { AnimatePresence, motion } from 'framer-motion'
+import { useEffect, useRef, useState } from 'react'
+import { ChevronDown, ChevronUp } from 'react-feather'
+import { useLocation } from 'react-router-dom'
+import copyRunApi from 'services/copyTrading/api/endpoints/copyRuns'
+import discoveryApi from 'services/copyTrading/api/endpoints/discovery'
+import type { AgentCard, Chain } from 'services/copyTrading/types/agents'
+import type { CopyRunSummary } from 'services/copyTrading/types/copyRuns'
+
+import { ReactComponent as HistoryIcon } from 'assets/images/copy-trading/ic_history.svg'
+import { ReactComponent as OpenCopiesIcon } from 'assets/images/copy-trading/ic_opens.svg'
+import { ButtonEmpty } from 'components/Button'
+import { Center, HStack, Stack } from 'components/Stack'
+import { APP_PATHS } from 'constants/index'
+import MobileNavigation from 'pages/CopyTrading/components/Sidebar/MobileNavigation'
+import {
+ SidebarMenuItem,
+ type SidebarRouteState,
+ SidebarSection,
+ getSidebarRouteState,
+} from 'pages/CopyTrading/components/Sidebar/primitives'
+import { useCopyTradingContext } from 'pages/CopyTrading/context'
+import { getAgentInitials } from 'pages/CopyTrading/helpers'
+import { cn } from 'utils/cn'
+
+const SIDEBAR_ITEM_LIMIT = 10
+const DEFAULT_VISIBLE_AGENTS = 5
+const ACTIVE_COPY_DOT_COLORS = ['bg-primary', 'bg-yellow1', 'bg-blue3', 'bg-lightGreen', 'bg-warning'] as const
+
+const AgentItem = ({ activeAgentCode, agent }: { activeAgentCode: string; agent: AgentCard }) => {
+ const active = activeAgentCode === agent.agentId
+
+ return (
+
+
+ {getAgentInitials(agent.displayName)}
+
+ {agent.displayName}
+
+ )
+}
+
+type AgentsSectionProps = {
+ activeAgentCode: string
+ agents: AgentCard[]
+ expanded: boolean
+ isActive: boolean
+ onToggle: () => void
+}
+
+const AgentsSection = ({ activeAgentCode, agents, expanded, isActive, onToggle }: AgentsSectionProps) => {
+ const visibleAgents = agents.slice(0, DEFAULT_VISIBLE_AGENTS)
+ const hiddenAgents = agents.slice(DEFAULT_VISIBLE_AGENTS)
+
+ return (
+
+
+ {visibleAgents.map(agent => (
+
+ {expanded && (
+
+
+ {hiddenAgents.map(agent => (
+
+
+ )}
+
+
+ {!!hiddenAgents.length && (
+
+
+ {expanded ?
+
+ )}
+
+
+ )
+}
+
+const getActiveCopyDotColor = (copyRunId: string) => {
+ const colorIndex = Array.from(copyRunId).reduce((hash, character) => (hash * 31 + character.charCodeAt(0)) >>> 0, 0)
+ return ACTIVE_COPY_DOT_COLORS[colorIndex % ACTIVE_COPY_DOT_COLORS.length]
+}
+
+const getCopyStatusDotColor = (run: CopyRunSummary) => {
+ if (run.status === 'active') return getActiveCopyDotColor(run.copyRunId)
+ if (run.status === 'closing') return 'bg-blue'
+ if (run.status === 'stopped') return 'bg-red'
+ return 'bg-subText'
+}
+
+type MyCopiesSectionProps = {
+ agentById: Map
+ runs: CopyRunSummary[]
+ route: SidebarRouteState
+}
+
+const MyCopiesSection = ({ agentById, route, runs }: MyCopiesSectionProps) => {
+ return (
+
+
+
+
+ {runs.length}
+
+
+
+ {runs.map(run => {
+ const agent = agentById.get(run.agentId)
+ const active = route.activeCopyId === run.copyRunId
+
+ return (
+
+
+
+ {run.agentSnapshot?.displayName || agent?.displayName || run.agentId}
+
+
+ )
+ })}
+
+
+
+
+
+ )
+}
+
+const NetworksSection = ({
+ chains,
+ onSelectChain,
+ selectedChainId,
+}: {
+ chains: Chain[]
+ onSelectChain: (chainId: number) => void
+ selectedChainId?: number
+}) => {
+ return (
+
+
+ {chains.map(chain => {
+ const active = selectedChainId === chain.chainId
+
+ return (
+ onSelectChain(chain.chainId)}
+ >
+ 
+ {chain.name}
+
+ )
+ })}
+
+
+ )
+}
+
+const Sidebar = () => {
+ const location = useLocation()
+ const { chains, ownerAddress, selectedChainId, setSelectedChainId } = useCopyTradingContext()
+ const [expandedAgents, setExpandedAgents] = useState(false)
+ const previousPathname = useRef(location.pathname)
+
+ const { data: leaderboard } = discoveryApi.useGetLeaderboardQuery(
+ { chainId: selectedChainId, limit: SIDEBAR_ITEM_LIMIT },
+ { pollingInterval: 10_000, skip: selectedChainId === undefined },
+ )
+ const { currentData: openCopies, refetch: refetchOpenCopies } = copyRunApi.useGetCopyRunsQuery(
+ {
+ ownerAddress: ownerAddress || '',
+ view: 'open',
+ limit: SIDEBAR_ITEM_LIMIT,
+ },
+ { pollingInterval: 10_000, skip: !ownerAddress },
+ )
+
+ useEffect(() => {
+ if (previousPathname.current === location.pathname) return
+ previousPathname.current = location.pathname
+
+ if (ownerAddress) void refetchOpenCopies()
+ }, [location.pathname, ownerAddress, refetchOpenCopies])
+
+ const agents = leaderboard?.data || []
+ const activeRuns = ownerAddress ? openCopies?.data || [] : []
+ const enabledChains = chains.filter(chain => chain.isEnabled)
+ const agentById = new Map(agents.map(agent => [agent.agentId, agent]))
+ const route = getSidebarRouteState(location.pathname)
+
+ const selectChain = (chainId: number) => {
+ setSelectedChainId(chainId)
+ setExpandedAgents(false)
+ }
+
+ return (
+ <>
+
+
+type SidebarSectionProps = PropsWithChildren<{
+ title: string
+ active?: boolean
+ count?: number
+ onClick?: () => void
+ to?: string
+}>
+
+export const SidebarSection = ({ title, active, count, children, onClick, to }: SidebarSectionProps) => {
+ return (
+
+ {to ? (
+
+ )
+}
+
+type SidebarMenuItemProps = PropsWithChildren<{
+ to?: string
+ active?: boolean
+ onClick?: () => void
+ activeStyle?: 'surface' | 'text'
+ layout?: 'default' | 'between' | 'row'
+ colorByActive?: boolean
+}>
+
+export const SidebarMenuItem = ({
+ to,
+ active,
+ children,
+ onClick,
+ activeStyle = 'surface',
+ layout = 'default',
+ colorByActive,
+}: SidebarMenuItemProps) => {
+ const className = cn(
+ 'flex size-full items-center pl-2.5 pr-3 text-left font-medium no-underline',
+ layout === 'between' && 'justify-between',
+ layout === 'row' && 'gap-3',
+ colorByActive && 'text-sm hover:text-primary',
+ colorByActive && (active ? 'text-primary' : 'text-subText'),
+ )
+
+ return (
+ = PropsWithChildren<{
+ activeSortBy?: TSortField
+ className?: string
+ onSortChange?: (sortBy: TSortField) => void
+ sortField?: TSortField
+ sortOrder?: SortOrder
+}>
+
+type TableCellProps = HTMLAttributes & {
+ padding?: 'default' | 'none'
+}
+
+type EmptyStateProps = {
+ className?: string
+ iconUrl?: string
+ message: string
+}
+
+type TableBodyProps = PropsWithChildren<{
+ className?: string
+ empty: boolean
+ emptyIconUrl?: string
+ emptyMessage: string
+ loading?: boolean
+}>
+
+const TableGrid = ({ className, ...rest }: HTMLAttributes) => (
+
+)
+
+const EmptyState = ({ iconUrl, message, className }: EmptyStateProps) => (
+
+
+ {iconUrl ? 
: null}
+ {message}
+
+
+)
+
+export const TableHeader = ({ className, ...props }: HTMLAttributes) => (
+ ({
+ activeSortBy,
+ children,
+ className,
+ onSortChange,
+ sortField,
+ sortOrder,
+}: HeaderCellProps) => {
+ const sortable = !!sortField
+ const active = sortable && activeSortBy === sortField
+ const SortIcon = active && sortOrder === 'asc' ? ChevronUp : ChevronDown
+ const content = (
+
+ {children}
+ {sortable &&
+ )
+
+ if (!sortField) return content
+
+ return (
+ onSortChange?.(sortField)} padding="0">
+ {content}
+
+ )
+}
+
+export const TableBody = ({ children, className, empty, emptyIconUrl, emptyMessage, loading }: TableBodyProps) => (
+ ) => (
+ {strategyLabel(strategy)}
+)
+
+type AgentCellSize = 'sm' | 'lg'
+
+type AgentAvatarProps = {
+ avatarUrl?: string
+ chainId: number
+ displayName: string
+ size?: AgentCellSize
+}
+
+type AgentCellProps = {
+ agent: AgentCard | AgentProfile | AgentSnapshot
+ className?: string
+ nameExtension?: ReactNode
+ size?: AgentCellSize
+ subLineExtension?: ReactNode
+}
+
+const getLeaderAddress = (agent: AgentCard | AgentProfile | AgentSnapshot) => agent.leaderAddress
+
+const isVerifiedAgent = (agent: AgentCard | AgentProfile | AgentSnapshot) => agent.isVerified
+
+export const AgentAvatar = ({ avatarUrl, chainId, displayName, size = 'sm' }: AgentAvatarProps) => {
+ const { chains } = useCopyTradingContext()
+ const chain = chains.find(item => item.chainId === chainId)
+ const isLarge = size === 'lg'
+
+ return (
+
+ {getAgentInitials(displayName)}
+ {avatarUrl && 
}
+ {chain?.iconUrl && (
+
+
+
+ )}
+
+ )
+}
+
+export const AgentCell = ({ agent, className, nameExtension, size = 'sm', subLineExtension }: AgentCellProps) => {
+ const displayName = getAgentDisplayName(agent)
+ const isLarge = size === 'lg'
+ const strategies = Array.from(
+ new Set(agent.strategyCategories.map(strategyCategoryKey).filter(strategy => strategy !== 'unknown')),
+ )
+ if (!strategies.length) strategies.push(agent.strategy)
+
+ return (
+
+
+
+ {isLarge ? (
+ 
}
+ {nameExtension}
+ {'isTrending' in agent && agent.isTrending && 🔥}
+
+
+ {strategies.map(strategy => (
+ {agent.modelName}
+ {subLineExtension}
+
+
+
+ )
+}
+
+type CopyRunAgentCellProps = {
+ className?: string
+ run: Pick
+}
+
+export const CopyRunAgentCell = ({ className, run }: CopyRunAgentCellProps) => {
+ const agent = run.agentSnapshot
+ if (agent) return
+
+ {getAgentInitials(fallbackName)}
+
+
+ {run.agentId}
+
+ Chain {run.chainId}
+
+
+
+ )
+}
+
+export const AgentIdentity = ({ agent, status }: { agent: AgentCard | AgentProfile; status?: CopyRunStatus }) => (
+
+ •
+ {shortenAddress(agent.chainId, getLeaderAddress(agent))}
+
+ }
+ />
+)
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/components/common/layout.tsx b/apps/kyberswap-interface/src/pages/CopyTrading/components/common/layout.tsx
new file mode 100644
index 0000000000..8a56e6953f
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/components/common/layout.tsx
@@ -0,0 +1,94 @@
+import { type PropsWithChildren, type ReactNode } from 'react'
+import { ArrowLeft } from 'react-feather'
+import { useNavigate } from 'react-router-dom'
+
+import { ButtonEmpty } from 'components/Button'
+import { HStack, Stack } from 'components/Stack'
+import { shortenHash } from 'utils/address'
+import { cn } from 'utils/cn'
+
+type CopyTradingPageBackTo = {
+ label: string
+ to: string
+}
+
+type CopyTradingPageProps = PropsWithChildren<{
+ backTo?: CopyTradingPageBackTo
+ className?: string
+}>
+
+type CopyTradingPageHeadingProps = {
+ className?: string
+ description?: ReactNode
+ title: ReactNode
+}
+
+type ContentPanelProps = PropsWithChildren<{
+ bodyClassName?: string
+ className?: string
+ headerAside?: ReactNode
+ title: string
+ titleAddon?: ReactNode
+}>
+
+export const CopyTradingPage = ({ children, backTo, className }: CopyTradingPageProps) => {
+ const navigate = useNavigate()
+
+ return (
+
+ {backTo && (
+
+ )
+}
+
+export const CopyTradingPageHeading = ({ className, description, title }: CopyTradingPageHeadingProps) => (
+
+
+)
+
+export const StickySideColumn = ({ children }: PropsWithChildren) => (
+
+)
+
+export const ContentPanel = ({
+ bodyClassName,
+ children,
+ className,
+ headerAside,
+ title,
+ titleAddon,
+}: ContentPanelProps) => (
+
+
+
+
+ {headerAside}
+
+ {children}
+
+)
+
+export const ShortenedId = ({ value }: { value?: string }) => (
+
+ {value ? shortenHash(value, 3) : '—'}
+
+)
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/components/common/status.tsx b/apps/kyberswap-interface/src/pages/CopyTrading/components/common/status.tsx
new file mode 100644
index 0000000000..d3d4a9ed63
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/components/common/status.tsx
@@ -0,0 +1,84 @@
+import type { CopyRunStatus, PositionLifecycle, PositionQuantityState } from 'services/copyTrading/types/primitives'
+
+import { Center, Stack } from 'components/Stack'
+import { cn } from 'utils/cn'
+
+const copyRunStatusLabel: Record = {
+ active: 'Active',
+ closing: 'Closing',
+ stopped: 'Stopped',
+ closed: 'Closed',
+ unknown: 'Unknown',
+}
+
+export const copyRunStatusTextClassName: Record = {
+ active: 'text-primary',
+ closing: 'text-blue',
+ stopped: 'text-red',
+ closed: 'text-subText',
+ unknown: 'text-subText',
+}
+
+export const CopyRunStatusBadge = ({ status }: { status: CopyRunStatus }) => (
+
+ {copyRunStatusLabel[status]}
+
+)
+
+const positionLifecycleLabel: Record = {
+ active: 'Open',
+ closing: 'Closing',
+ closed: 'Closed',
+ unknown: 'Status unavailable',
+}
+
+const positionQuantityLabel: Record = {
+ open_full: undefined,
+ open_partial: 'Partially sold',
+ closed: undefined,
+ unknown: undefined,
+}
+
+export const PositionLifecycleBadge = ({
+ lifecycle,
+ quantityState,
+}: {
+ lifecycle: PositionLifecycle
+ quantityState: PositionQuantityState
+}) => {
+ const quantityLabel =
+ lifecycle === 'active' || lifecycle === 'closing' ? positionQuantityLabel[quantityState] : undefined
+
+ return (
+
+ {positionLifecycleLabel[lifecycle]}
+ {quantityLabel ? ' · ' + quantityLabel : ''}
+
+ )
+}
+
+export const OwnerWalletRequired = () => (
+
+
+ Connect your wallet
+ Connect a wallet to view your Copy Trading data.
+
+
+)
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/constants.tsx b/apps/kyberswap-interface/src/pages/CopyTrading/constants.tsx
new file mode 100644
index 0000000000..97013af908
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/constants.tsx
@@ -0,0 +1,85 @@
+import agentsIcon from 'assets/images/copy-trading/agents.svg'
+import { ReactComponent as AumIcon } from 'assets/images/copy-trading/ic_aum.svg'
+import { ReactComponent as CashIcon } from 'assets/images/copy-trading/ic_cash.svg'
+import { ReactComponent as PnlIcon } from 'assets/images/copy-trading/ic_pnl.svg'
+import { ReactComponent as WinRateIcon } from 'assets/images/copy-trading/ic_winrate.svg'
+import moneyIcon, { ReactComponent as MoneyIcon } from 'assets/images/copy-trading/money.svg'
+import positionCloseIcon from 'assets/images/copy-trading/position-close.svg'
+import positionOpenIcon from 'assets/images/copy-trading/position-open.svg'
+import { ReactComponent as UsersIcon } from 'assets/images/copy-trading/users.svg'
+import volumeIcon, { ReactComponent as VolumeIcon } from 'assets/images/copy-trading/volume.svg'
+
+export const copyTradingStatIconMap = {
+ agents: {
+ iconUrl: agentsIcon,
+ backgroundColor: 'bg-[#FBB324]/20',
+ },
+ aum: {
+ Icon: AumIcon,
+ backgroundColor: 'bg-primary-12',
+ iconClassName: 'text-primary',
+ },
+ cash: {
+ Icon: CashIcon,
+ backgroundColor: 'bg-primary-12',
+ iconClassName: 'text-primary',
+ },
+ money: {
+ iconUrl: moneyIcon,
+ backgroundColor: 'bg-[#58B5EE]/20',
+ },
+ moneyPrimary: {
+ Icon: MoneyIcon,
+ backgroundColor: 'bg-primary-12',
+ iconClassName: 'text-primary [&_*]:stroke-current',
+ },
+ pnl: {
+ Icon: PnlIcon,
+ backgroundColor: 'bg-primary-12',
+ iconClassName: 'text-primary',
+ },
+ positionClose: {
+ iconUrl: positionCloseIcon,
+ backgroundColor: 'bg-[#8F92FF]/20',
+ },
+ positionOpen: {
+ iconUrl: positionOpenIcon,
+ backgroundColor: 'bg-[#8F92FF]/20',
+ },
+ users: {
+ Icon: UsersIcon,
+ backgroundColor: 'bg-primary-12',
+ iconClassName: 'text-primary',
+ },
+ usersPurple: {
+ Icon: UsersIcon,
+ backgroundColor: 'bg-[#8F92FF]/20',
+ iconClassName: 'text-[#8F92FF]',
+ },
+ volume: {
+ iconUrl: volumeIcon,
+ backgroundColor: 'bg-[#31CB9E]/20',
+ },
+ volumePrimary: {
+ Icon: VolumeIcon,
+ backgroundColor: 'bg-primary-12',
+ iconClassName: 'text-primary [&_*]:stroke-current',
+ },
+ winRate: {
+ Icon: WinRateIcon,
+ backgroundColor: 'bg-primary-12',
+ iconClassName: 'text-primary',
+ },
+} as const
+
+export type StatIcon = (typeof copyTradingStatIconMap)[keyof typeof copyTradingStatIconMap]
+
+export const profileTabs = ['open-position', 'trade-history', 'action-log'] as const
+
+export type ProfileTab = (typeof profileTabs)[number]
+
+export const profileTabLabel: Record = {
+ 'open-position': 'OPEN POSITIONS',
+ 'trade-history': 'TRADE HISTORY',
+ 'action-log': 'ACTION LOG',
+}
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/context.tsx b/apps/kyberswap-interface/src/pages/CopyTrading/context.tsx
new file mode 100644
index 0000000000..4bb8e9a84d
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/context.tsx
@@ -0,0 +1,43 @@
+import { type PropsWithChildren, createContext, useContext, useEffect, useMemo, useState } from 'react'
+import type { Chain } from 'services/copyTrading/types/agents'
+import type { Address } from 'services/copyTrading/types/primitives'
+
+type CopyTradingContextValue = {
+ chains: Chain[]
+ ownerAddress?: Address
+ selectedChainId?: number
+ setSelectedChainId: (chainId?: number) => void
+}
+
+const CopyTradingContext = createContext(undefined)
+
+type CopyTradingProviderProps = PropsWithChildren<{
+ chains: Chain[]
+ ownerAddress?: Address
+}>
+
+export const CopyTradingProvider = ({ chains, children, ownerAddress }: CopyTradingProviderProps) => {
+ const [selectedChainId, setSelectedChainId] = useState()
+
+ useEffect(() => {
+ setSelectedChainId(currentChainId => {
+ const enabledChains = chains.filter(chain => chain.isEnabled)
+ const isCurrentChainEnabled = enabledChains.some(chain => chain.chainId === currentChainId)
+
+ return isCurrentChainEnabled ? currentChainId : enabledChains[0]?.chainId
+ })
+ }, [chains])
+
+ const value = useMemo(
+ () => ({ chains, ownerAddress, selectedChainId, setSelectedChainId }),
+ [chains, ownerAddress, selectedChainId],
+ )
+
+ return {children}
+}
+
+export const useCopyTradingContext = () => {
+ const context = useContext(CopyTradingContext)
+ if (!context) throw new Error('useCopyTradingContext must be used within CopyTradingProvider')
+ return context
+}
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/helpers.test.ts b/apps/kyberswap-interface/src/pages/CopyTrading/helpers.test.ts
new file mode 100644
index 0000000000..577a39a504
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/helpers.test.ts
@@ -0,0 +1,79 @@
+import { describe, expect, it } from 'vitest'
+
+import {
+ compactUsd,
+ formatApproximateUsd,
+ formatCount,
+ formatTokenAmount,
+ formatUsd,
+ getDisplayCapitalInUsd,
+ getSignedMetricClassName,
+ getWinRateClassName,
+ getWinRateTone,
+ percent,
+ signedPercent,
+ signedUsd,
+ sumUsdValues,
+} from './helpers'
+
+describe('Copy Trading metric formatters', () => {
+ it('displays N/A for missing metrics', () => {
+ expect([
+ compactUsd(undefined),
+ formatUsd(undefined),
+ signedUsd(undefined),
+ formatTokenAmount(undefined),
+ formatCount(undefined),
+ percent(undefined),
+ signedPercent(undefined),
+ formatApproximateUsd(undefined),
+ ]).toEqual(Array(8).fill('N/A'))
+ })
+
+ it('keeps zero as a valid metric', () => {
+ expect(formatUsd('0')).not.toBe('N/A')
+ expect(formatCount(0)).not.toBe('N/A')
+ expect(percent('0')).not.toBe('N/A')
+ })
+
+ it('keeps a negative USD sign with its value when wrapping', () => {
+ expect(formatUsd('-10')).toMatch(/^-\u2060/)
+ })
+
+ it('uses semantic colors only for signed metrics with a direction', () => {
+ expect(getSignedMetricClassName('12.5')).toBe('text-primary')
+ expect(getSignedMetricClassName('-0.1')).toBe('text-red')
+ expect(getSignedMetricClassName('0')).toBe('text-text')
+ expect(getSignedMetricClassName(undefined)).toBe('text-text')
+ })
+
+ it('colors win rates by performance range', () => {
+ expect(getWinRateClassName('60')).toBe('text-primary')
+ expect(getWinRateClassName('59.9')).toBe('text-warning')
+ expect(getWinRateClassName('30')).toBe('text-warning')
+ expect(getWinRateClassName('29.9')).toBe('text-red')
+ expect(getWinRateClassName(undefined)).toBe('text-text')
+ expect(getWinRateClassName('80', 'background')).toBe('bg-primary')
+ expect(getWinRateClassName('20', 'background')).toBe('bg-red1')
+ expect(getWinRateTone('60')).toBe('positive')
+ expect(getWinRateTone('30')).toBe('warning')
+ expect(getWinRateTone('20')).toBe('negative')
+ })
+
+ it('only prefixes approximate values when data is available', () => {
+ expect(formatApproximateUsd('10')).toMatch(/^~\$/)
+ expect(formatApproximateUsd(undefined)).toBe('N/A')
+ })
+
+ it('only calculates combined USD metrics when every value is available', () => {
+ expect(sumUsdValues('10.5', '-2')).toBe('8.5')
+ expect(sumUsdValues('10.5', undefined)).toBeUndefined()
+ })
+
+ it('uses observed capital only when canonical capital is unavailable', () => {
+ expect(getDisplayCapitalInUsd({ capitalInUsd: '10', observedCapitalInUsd: '12' })).toBe('10')
+ expect(getDisplayCapitalInUsd({ capitalInUsd: '0', observedCapitalInUsd: '12' })).toBe('0')
+ expect(getDisplayCapitalInUsd({ observedCapitalInUsd: '12' })).toBe('12')
+ expect(getDisplayCapitalInUsd({})).toBeUndefined()
+ })
+})
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/helpers.ts b/apps/kyberswap-interface/src/pages/CopyTrading/helpers.ts
new file mode 100644
index 0000000000..b5fc8b8c16
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/helpers.ts
@@ -0,0 +1,222 @@
+import type { AdvisoryActionAvailability, PreparedActionReason } from 'services/copyTrading/types/actionAvailability'
+import type { AgentCard, AgentProfile, AgentSnapshot, StrategyCategory } from 'services/copyTrading/types/agents'
+import type { ActivityRow, CopyRunSummary } from 'services/copyTrading/types/copyRuns'
+import type { DecimalString, StrategyKey } from 'services/copyTrading/types/primitives'
+
+import { formatDisplayNumber } from 'utils/numbers'
+
+type NumericValue = DecimalString | number
+
+const METRIC_FALLBACK = 'N/A'
+
+const parseNumericValue = (value?: NumericValue) => {
+ if (value === undefined || (typeof value === 'string' && !value.trim())) return undefined
+
+ const numeric = Number(value)
+ return Number.isFinite(numeric) ? numeric : undefined
+}
+
+export const compactUsd = (value?: DecimalString) => {
+ const amount = parseNumericValue(value)
+ return amount === undefined
+ ? METRIC_FALLBACK
+ : formatDisplayNumber(amount, { allowDisplayNegative: true, significantDigits: 3, style: 'currency' })
+}
+
+export const formatUsd = (value?: DecimalString) => {
+ const amount = parseNumericValue(value)
+ if (amount === undefined) return METRIC_FALLBACK
+
+ const absoluteAmount = Math.abs(amount)
+ const fractionDigits = absoluteAmount > 0 && absoluteAmount < 1 ? 6 : 2
+ const formattedValue = formatDisplayNumber(amount, {
+ allowDisplayNegative: true,
+ fractionDigits,
+ significantDigits: 15,
+ style: 'currency',
+ })
+
+ return formattedValue.replace(/^-/, '-\u2060')
+}
+
+export const getDisplayCapitalInUsd = (run: Pick) =>
+ run.capitalInUsd ?? run.observedCapitalInUsd
+
+export const signedUsd = (value?: DecimalString) => {
+ const amount = parseNumericValue(value)
+ if (amount === undefined) return METRIC_FALLBACK
+
+ return `${amount > 0 ? '+' : amount < 0 ? '-' : ''}${formatUsd(String(Math.abs(amount)))}`
+}
+
+export const sumUsdValues = (...values: Array) => {
+ const amounts = values.map(parseNumericValue)
+ if (amounts.some(amount => amount === undefined)) return undefined
+
+ return String(amounts.reduce((total, amount) => total + (amount ?? 0), 0))
+}
+
+export const formatTokenAmount = (value?: DecimalString) => {
+ const amount = parseNumericValue(value)
+ if (amount === undefined) return METRIC_FALLBACK
+
+ return formatDisplayNumber(amount, {
+ allowDisplayNegative: true,
+ fractionDigits: 6,
+ significantDigits: 15,
+ })
+}
+
+export const formatCount = (value?: NumericValue) => {
+ const amount = parseNumericValue(value)
+ return amount === undefined
+ ? METRIC_FALLBACK
+ : formatDisplayNumber(Math.round(amount), { fractionDigits: 0, significantDigits: 15 })
+}
+
+export const percent = (value?: DecimalString) => {
+ const amount = parseNumericValue(value)
+ return amount === undefined
+ ? METRIC_FALLBACK
+ : `${formatDisplayNumber(amount, {
+ allowDisplayNegative: true,
+ fractionDigits: 1,
+ significantDigits: 15,
+ })}%`
+}
+
+export const signedPercent = (value?: DecimalString) => {
+ const amount = parseNumericValue(value)
+ if (amount === undefined) return METRIC_FALLBACK
+
+ return `${amount > 0 ? '+' : ''}${percent(value)}`
+}
+
+export const getSignedMetricClassName = (value?: NumericValue) => {
+ const amount = parseNumericValue(value)
+
+ return amount === undefined || amount === 0 ? 'text-text' : amount > 0 ? 'text-primary' : 'text-red'
+}
+
+export type WinRateTone = 'positive' | 'warning' | 'negative' | 'neutral'
+
+export const getWinRateTone = (value?: NumericValue): WinRateTone => {
+ const amount = parseNumericValue(value)
+
+ if (amount === undefined) return 'neutral'
+ if (amount >= 60) return 'positive'
+ return amount >= 30 ? 'warning' : 'negative'
+}
+
+export const getWinRateClassName = (value?: NumericValue, variant: 'text' | 'background' = 'text') => {
+ const tone = getWinRateTone(value)
+
+ if (variant === 'background') {
+ if (tone === 'neutral') return 'bg-subText'
+ if (tone === 'positive') return 'bg-primary'
+ return tone === 'warning' ? 'bg-warning' : 'bg-red1'
+ }
+
+ if (tone === 'neutral') return 'text-text'
+ if (tone === 'positive') return 'text-primary'
+ return tone === 'warning' ? 'text-warning' : 'text-red'
+}
+
+export const formatApproximateUsd = (value?: DecimalString) => {
+ const formattedValue = formatUsd(value)
+ return formattedValue === METRIC_FALLBACK ? formattedValue : `~${formattedValue}`
+}
+
+export const getAgentInitials = (name: string) =>
+ name
+ .split(' ')
+ .map(part => part[0])
+ .join('')
+ .slice(0, 2)
+ .toUpperCase()
+
+export const strategyLabel = (strategy: StrategyKey) =>
+ strategy === 'active'
+ ? 'Active'
+ : strategy === 'diversified'
+ ? 'Diversified'
+ : strategy === 'focused'
+ ? 'Focused'
+ : 'Unknown'
+
+export const strategyCategoryKey = (category: StrategyCategory): StrategyKey =>
+ category === 'STRATEGY_CATEGORY_ACTIVE'
+ ? 'active'
+ : category === 'STRATEGY_CATEGORY_DIVERSIFIED'
+ ? 'diversified'
+ : category === 'STRATEGY_CATEGORY_FOCUSED'
+ ? 'focused'
+ : 'unknown'
+
+export const getAgentDisplayName = (agent?: AgentCard | AgentProfile | AgentSnapshot) =>
+ agent?.displayName || 'Unknown Agent'
+
+export const getActivityLabel = (activity: Pick) => {
+ if (activity.position?.actionType?.toLowerCase() === 'sell_unaligned') return 'Owner Sell'
+
+ switch (activity.activityType) {
+ case 'copy_started':
+ return 'Start Copy'
+ case 'copy_stopped':
+ return 'Stop Copy'
+ case 'capital_deposited':
+ return 'Deposit'
+ case 'capital_topped_up':
+ return 'Add Capital'
+ case 'capital_withdrawn':
+ return 'Withdraw Quote'
+ case 'capital_returned':
+ return 'Returned Capital'
+ default:
+ return activity.activityType
+ .split('_')
+ .map(part => part.charAt(0).toUpperCase() + part.slice(1))
+ .join(' ')
+ }
+}
+
+const reasonMessages: Partial> = {
+ PREPARED_ACTION_REASON_ALREADY_ACTIVE: 'You are already copying this agent.',
+ PREPARED_ACTION_REASON_NOT_CURRENT_OWNER: 'The connected wallet is not the current owner.',
+ PREPARED_ACTION_REASON_ACCOUNT_NOT_ACTIVE: 'This Smart Wallet is not active.',
+ PREPARED_ACTION_REASON_ACCOUNT_NOT_STOPPED: 'Stop copying before withdrawing from this Smart Wallet.',
+ PREPARED_ACTION_REASON_ACCOUNT_PERMANENTLY_PAUSED: 'This Smart Wallet is permanently paused.',
+ PREPARED_ACTION_REASON_EXIT_IN_PROGRESS: 'A position exit is already in progress.',
+ PREPARED_ACTION_REASON_EXIT_NOT_TERMINAL: 'The previous exit has not reached a terminal state yet.',
+ PREPARED_ACTION_REASON_SOURCE_STALE: 'The latest on-chain state is still syncing. Please try again shortly.',
+ PREPARED_ACTION_REASON_SOURCE_COVERAGE_PENDING: 'The latest on-chain state is still being indexed.',
+ PREPARED_ACTION_REASON_FACTORY_PAUSED: 'New Copy Trading accounts are temporarily paused.',
+ PREPARED_ACTION_REASON_FEE_POLICY_CHANGED: 'The fee policy changed. Review the latest preparation.',
+ PREPARED_ACTION_REASON_SIGNER_POLICY_CHANGED: 'The execution signer policy changed. Please prepare again.',
+ PREPARED_ACTION_REASON_REQUEST_ID_CONFLICT: 'This Start Copy request conflicts with an earlier attempt.',
+ PREPARED_ACTION_REASON_UNSUPPORTED_ACCOUNT_GENERATION: 'This Smart Wallet generation is not supported.',
+ PREPARED_ACTION_REASON_NO_QUOTE_BALANCE: 'There is no quote-token balance available to withdraw.',
+ PREPARED_ACTION_REASON_INSUFFICIENT_QUOTE_BALANCE: 'Your wallet does not have enough quote-token balance.',
+ PREPARED_ACTION_REASON_INSUFFICIENT_QUOTE_ALLOWANCE:
+ 'The quote token needs a fresh authorization before Start Copy can continue.',
+ PREPARED_ACTION_REASON_CONTROLLER_PAUSED: 'Copy Trading actions are temporarily paused.',
+ PREPARED_ACTION_REASON_COPY_RUN_STOPPED: 'This Copy Run has already stopped.',
+ PREPARED_ACTION_REASON_UNSUPPORTED_QUOTE_TOKEN: 'The configured quote token is not supported.',
+ PREPARED_ACTION_REASON_AMOUNT_BELOW_MINIMUM: 'Enter an amount that meets the current minimum.',
+ PREPARED_ACTION_REASON_INVALID_STOP_INTENT: 'The selected positions changed. Review the latest position set.',
+ PREPARED_ACTION_REASON_NO_EXECUTABLE_ROUTE: 'No executable route is currently available.',
+ PREPARED_ACTION_REASON_INNER_CALL_REVERTED: 'The prepared call cannot currently be executed.',
+ PREPARED_ACTION_REASON_NO_SELLABLE_BASE: 'This position has no sellable balance.',
+ PREPARED_ACTION_REASON_NO_PENDING_SELL_OBLIGATION: 'There is no pending sell obligation to recover.',
+ PREPARED_ACTION_REASON_SELL_OBLIGATION_CHANGED: 'The pending sell obligation changed. Refresh and review again.',
+ PREPARED_ACTION_REASON_POSITION_NOT_OPEN: 'This position is no longer open.',
+ PREPARED_ACTION_REASON_CLOSE_NOT_ELIGIBLE: 'This position is not eligible for full recovery.',
+}
+
+export const isActionAvailable = (availability?: AdvisoryActionAvailability) =>
+ availability?.status === 'ADVISORY_ACTION_STATUS_AVAILABLE'
+
+export const getPreparedReasonMessage = (reason?: PreparedActionReason) => {
+ if (!reason || reason === 'PREPARED_ACTION_REASON_UNSPECIFIED') return 'This action is not available right now.'
+ return reasonMessages[reason] || reason.replace('PREPARED_ACTION_REASON_', '').replaceAll('_', ' ').toLowerCase()
+}
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/hooks/useRefreshCopyTrading.ts b/apps/kyberswap-interface/src/pages/CopyTrading/hooks/useRefreshCopyTrading.ts
new file mode 100644
index 0000000000..503a59056b
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/hooks/useRefreshCopyTrading.ts
@@ -0,0 +1,17 @@
+import { useQueryClient } from '@tanstack/react-query'
+import { useCallback } from 'react'
+import copyTradingBaseApi from 'services/copyTrading/api/baseApi'
+
+import { useAppDispatch } from 'state/hooks'
+
+const useRefreshCopyTrading = () => {
+ const dispatch = useAppDispatch()
+ const queryClient = useQueryClient()
+
+ return useCallback(() => {
+ dispatch(copyTradingBaseApi.util.invalidateTags(['CopyTrading']))
+ void queryClient.invalidateQueries({ queryKey: ['copy-trading'] })
+ }, [dispatch, queryClient])
+}
+
+export default useRefreshCopyTrading
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/index.tsx b/apps/kyberswap-interface/src/pages/CopyTrading/index.tsx
new file mode 100644
index 0000000000..958faa5e49
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/index.tsx
@@ -0,0 +1,65 @@
+import { useEffect, useRef } from 'react'
+import { Navigate, Route, Routes, useLocation, useNavigate } from 'react-router-dom'
+import discoveryApi from 'services/copyTrading/api/endpoints/discovery'
+import type { Address } from 'services/copyTrading/types/primitives'
+
+import { APP_PATHS } from 'constants/index'
+import { useActiveWeb3React } from 'hooks'
+import AgentList from 'pages/CopyTrading/AgentList'
+import AgentProfile from 'pages/CopyTrading/AgentProfile'
+import CopyDetailView from 'pages/CopyTrading/CopyDetail'
+import CopyHistoryView from 'pages/CopyTrading/CopyHistory'
+import MyCopiesView from 'pages/CopyTrading/MyCopies'
+import Sidebar from 'pages/CopyTrading/components/Sidebar'
+import { CopyTradingProvider } from 'pages/CopyTrading/context'
+import { CopyTradingModalProvider } from 'pages/CopyTrading/modals/context'
+
+const CopyTrading = () => {
+ const location = useLocation()
+ const navigate = useNavigate()
+ const { account } = useActiveWeb3React()
+ const previousPathname = useRef(location.pathname)
+
+ const { data: chains, refetch: refetchChains } = discoveryApi.useGetChainsQuery(undefined, {
+ pollingInterval: 10_000,
+ })
+
+ const { pathname } = location
+ const ownerAddress = account?.toLowerCase() as Address | undefined
+ const chainOptions = chains?.data || []
+
+ useEffect(() => {
+ if (!location.state?.scrollToCopyTrading) return
+
+ window.scrollTo({ top: 80, behavior: 'smooth' })
+ navigate(location, { replace: true, state: null })
+ }, [location, navigate])
+
+ useEffect(() => {
+ if (previousPathname.current === pathname) return
+ previousPathname.current = pathname
+
+ void refetchChains()
+ }, [pathname, refetchChains])
+
+ return (
+
+
+
+
+ )
+}
+
+export default CopyTrading
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/modals/AddCapitalModal/components.tsx b/apps/kyberswap-interface/src/pages/CopyTrading/modals/AddCapitalModal/components.tsx
new file mode 100644
index 0000000000..213aa2dc25
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/modals/AddCapitalModal/components.tsx
@@ -0,0 +1,94 @@
+import { Token } from '@kyberswap/ks-sdk-core'
+
+import { ButtonPrimary } from 'components/Button'
+import Dots from 'components/Dots'
+import { HStack, Stack } from 'components/Stack'
+import CapitalAmountInput from 'pages/CopyTrading/modals/CapitalAmount'
+import { type CapitalPercentage, type CapitalPreset } from 'pages/CopyTrading/modals/CapitalAmount/capital'
+
+const CapitalSummaryRow = ({ label, value }: { label: string; value: string }) => (
+
+ {label}
+ {value}
+
+)
+
+type AddCapitalFormProps = {
+ amount: string
+ amountError?: string
+ amountIsValid: boolean
+ availabilityMessage?: string
+ currentAllocatedCapital: string
+ isPreparing: boolean
+ newAllocatedCapital: string
+ onAmountChange: (amount: string) => void
+ onExpectedChain: boolean
+ onPercentageChange: (percentage: CapitalPercentage) => void
+ onPrimaryAction: () => void
+ presetAmounts?: CapitalPreset[]
+ presetsEnabled: boolean
+ primaryActionLabel: string
+ quoteCurrency?: Token
+ selectedChainId: number
+ walletBalanceLoading?: boolean
+ walletBalanceText: string
+ accountConnected: boolean
+}
+
+export const AddCapitalForm = ({
+ accountConnected,
+ amount,
+ amountError,
+ amountIsValid,
+ availabilityMessage,
+ currentAllocatedCapital,
+ isPreparing,
+ newAllocatedCapital,
+ onAmountChange,
+ onExpectedChain,
+ onPercentageChange,
+ onPrimaryAction,
+ presetAmounts,
+ presetsEnabled,
+ primaryActionLabel,
+ quoteCurrency,
+ selectedChainId,
+ walletBalanceLoading,
+ walletBalanceText,
+}: AddCapitalFormProps) => {
+ return (
+
+
+ {isPreparing ? {primaryActionLabel} : primaryActionLabel}
+
+
+ )
+}
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/modals/AddCapitalModal/index.tsx b/apps/kyberswap-interface/src/pages/CopyTrading/modals/AddCapitalModal/index.tsx
new file mode 100644
index 0000000000..a8b2318e78
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/modals/AddCapitalModal/index.tsx
@@ -0,0 +1,199 @@
+import { ChainId } from '@kyberswap/ks-sdk-core'
+import { useState } from 'react'
+import { useNavigate } from 'react-router-dom'
+import preparedActionApi from 'services/copyTrading/api/endpoints/preparedActions'
+import type { CopyRunSummary } from 'services/copyTrading/types/copyRuns'
+import type { PreparedCallKind } from 'services/copyTrading/types/preparedActions'
+
+import { APP_PATHS } from 'constants/index'
+import { useActiveWeb3React } from 'hooks'
+import { useChangeNetwork } from 'hooks/web3/useChangeNetwork'
+import {
+ formatTokenAmount,
+ getDisplayCapitalInUsd,
+ getPreparedReasonMessage,
+ isActionAvailable,
+ sumUsdValues,
+} from 'pages/CopyTrading/helpers'
+import useRefreshCopyTrading from 'pages/CopyTrading/hooks/useRefreshCopyTrading'
+import { AddCapitalForm } from 'pages/CopyTrading/modals/AddCapitalModal/components'
+import { type CapitalPercentage } from 'pages/CopyTrading/modals/CapitalAmount/capital'
+import { useCapitalAmount } from 'pages/CopyTrading/modals/CapitalAmount/useCapitalAmount'
+import PreparedActionModal, { PreparedActionSuccessActions } from 'pages/CopyTrading/modals/PreparedActionModal'
+import { DEFAULT_PREPARED_ACTION_STATE } from 'pages/CopyTrading/modals/PreparedActionModal/preparedAction'
+import { usePreparedAction } from 'pages/CopyTrading/modals/PreparedActionModal/usePreparedAction'
+import { useWalletModalToggle } from 'state/application/hooks'
+
+type AddCapitalModalProps = {
+ isOpen: boolean
+ onDismiss: () => void
+ copyRun: CopyRunSummary
+ agentName?: string
+}
+
+const ADD_CAPITAL_CALL_KINDS: PreparedCallKind[] = ['PREPARED_CALL_KIND_ADD_CAPITAL']
+
+const AddCapitalModal = ({ isOpen, onDismiss, copyRun }: AddCapitalModalProps) => {
+ const navigate = useNavigate()
+ const { account, chainId } = useActiveWeb3React()
+ const { changeNetwork } = useChangeNetwork()
+ const toggleWalletModal = useWalletModalToggle()
+ const refreshCopyTrading = useRefreshCopyTrading()
+ const [prepareAddCapital] = preparedActionApi.usePrepareAddCapitalMutation()
+
+ const [flowState, setFlowState] = useState(DEFAULT_PREPARED_ACTION_STATE)
+ const capital = useCapitalAmount({
+ account: account || undefined,
+ action: 'addCapital',
+ connectedChainId: chainId,
+ targetChainId: copyRun.chainId,
+ })
+
+ const ownershipMessage =
+ account && copyRun.ownerAddress.toLowerCase() !== account.toLowerCase()
+ ? 'The selected Copy Run is not owned by the connected wallet.'
+ : undefined
+
+ const currentAllocatedCapitalUsd = getDisplayCapitalInUsd(copyRun)
+ const newAllocatedCapitalUsd =
+ currentAllocatedCapitalUsd !== undefined
+ ? sumUsdValues(currentAllocatedCapitalUsd, capital.amount || '0')
+ : undefined
+ const formatCapitalAmount = (value?: string) => {
+ const formattedAmount = formatTokenAmount(value)
+ return value !== undefined && capital.quoteToken?.symbol
+ ? `${formattedAmount} ${capital.quoteToken.symbol}`
+ : formattedAmount
+ }
+
+ const flow = usePreparedAction({
+ state: flowState,
+ setState: setFlowState,
+ expected: {
+ account: account || '',
+ callKinds: ADD_CAPITAL_CALL_KINDS,
+ chainId: copyRun.chainId,
+ copyAccount: copyRun.copyAccount,
+ preview: 'addCapital',
+ },
+ prepare: async () => {
+ if (!account || !capital.quoteToken) throw new Error('Connect a supported wallet and network first.')
+ if (copyRun.ownerAddress.toLowerCase() !== account.toLowerCase()) {
+ throw new Error('The selected Copy Run is not owned by the connected wallet.')
+ }
+ if (!capital.amountRaw) throw new Error('Enter an amount greater than zero.')
+ if (capital.amountError) throw new Error(capital.amountError)
+
+ const response = await prepareAddCapital({
+ ownerAddress: account.toLowerCase(),
+ copyRunId: copyRun.copyRunId,
+ amountRaw: capital.amountRaw,
+ }).unwrap()
+ if (
+ [
+ 'PREPARED_ACTION_STATUS_READY',
+ 'PREPARED_ACTION_STATUS_PARTIALLY_COMPLETED',
+ 'PREPARED_ACTION_STATUS_COMPLETED',
+ 'PREPARED_ACTION_STATUS_PENDING',
+ ].includes(response.data.status || '') &&
+ response.data.addCapital?.addedCapitalRaw !== capital.amountRaw
+ ) {
+ throw new Error('The prepared amount does not match the requested capital amount.')
+ }
+
+ return response.data
+ },
+ onComplete: refreshCopyTrading,
+ })
+
+ const dismiss = () => {
+ flow.reset()
+ capital.setAmount('')
+ onDismiss()
+ }
+
+ const handlePrimaryAction = () => {
+ if (!account) {
+ toggleWalletModal()
+ return
+ }
+ if (!capital.onExpectedChain) {
+ void changeNetwork(copyRun.chainId as ChainId)
+ return
+ }
+ if (!capital.amountIsValid) return
+
+ void flow.prepareAndConfirm()
+ }
+
+ const setPercentageAmount = (percentage: CapitalPercentage) => {
+ const preset = capital.getPreset(percentage)
+ if (flowState.isPreparing || !capital.presetsEnabled || !preset) return
+
+ capital.setAmount(preset.amount)
+ }
+
+ const viewMyCopies = () => {
+ dismiss()
+ navigate(APP_PATHS.COPY_TRADING + '/my-copies')
+ }
+
+ const availabilityMessage = ownershipMessage
+ ? ownershipMessage
+ : !isActionAvailable(copyRun.addCapitalAvailability)
+ ? getPreparedReasonMessage(copyRun.addCapitalAvailability?.reason)
+ : undefined
+ const primaryActionLabel = !account
+ ? 'Connect wallet'
+ : !capital.onExpectedChain
+ ? 'Switch network'
+ : availabilityMessage || !capital.quoteToken
+ ? 'Add Capital unavailable'
+ : 'Add Capital'
+
+ const successActions = (
+ void flow.confirm()}
+ onRetry={() => void flow.retryAndConfirm()}
+ successTitle="Capital added"
+ successActions={successActions}
+ width={520}
+ >
+
+ )
+}
+
+export default AddCapitalModal
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/modals/CapitalAmount/capital.ts b/apps/kyberswap-interface/src/pages/CopyTrading/modals/CapitalAmount/capital.ts
new file mode 100644
index 0000000000..93033c6e6d
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/modals/CapitalAmount/capital.ts
@@ -0,0 +1,30 @@
+import type { PreparedToken } from 'services/copyTrading/types/preparedActions'
+
+export const CAPITAL_PERCENTAGES = [25, 50, 75, 100] as const
+
+export type CapitalPercentage = (typeof CAPITAL_PERCENTAGES)[number]
+
+export type CapitalPreset = {
+ amount: string
+ percentage: CapitalPercentage
+}
+
+export type CapitalAction = 'startCopy' | 'addCapital'
+
+export type CapitalInputQuoteToken = Required> & {
+ minimumAmountRaw: Record
+}
+
+const inputQuoteTokens: Record = {
+ 8453: {
+ address: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
+ decimals: 6,
+ minimumAmountRaw: {
+ addCapital: '1000000',
+ startCopy: '1000000',
+ },
+ symbol: 'USDC',
+ },
+}
+
+export const getCapitalInputQuoteToken = (chainId: number) => inputQuoteTokens[chainId]
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/modals/CapitalAmount/index.tsx b/apps/kyberswap-interface/src/pages/CopyTrading/modals/CapitalAmount/index.tsx
new file mode 100644
index 0000000000..1003d93636
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/modals/CapitalAmount/index.tsx
@@ -0,0 +1,98 @@
+import { ChainId, Token } from '@kyberswap/ks-sdk-core'
+
+import CurrencyInputPanel from 'components/CurrencyInputPanel'
+import Loader from 'components/Loader'
+import { HStack, Stack } from 'components/Stack'
+import {
+ CAPITAL_PERCENTAGES,
+ type CapitalPercentage,
+ type CapitalPreset,
+} from 'pages/CopyTrading/modals/CapitalAmount/capital'
+import { cn } from 'utils/cn'
+
+type CapitalAmountInputProps = {
+ amount: string
+ amountError?: string
+ inputId: string
+ isPreparing: boolean
+ label: string
+ onAmountChange: (amount: string) => void
+ onPercentageChange: (percentage: CapitalPercentage) => void
+ presetAmounts?: CapitalPreset[]
+ presetsEnabled: boolean
+ quoteCurrency?: Token
+ selectedChainId: number
+ walletBalanceLoading?: boolean
+ walletBalanceText: string
+}
+
+const CapitalAmountInput = ({
+ amount,
+ amountError,
+ inputId,
+ isPreparing,
+ label,
+ onAmountChange,
+ onPercentageChange,
+ presetAmounts,
+ presetsEnabled,
+ quoteCurrency,
+ selectedChainId,
+ walletBalanceLoading,
+ walletBalanceText,
+}: CapitalAmountInputProps) => (
+
+ {label}
+
+ {CAPITAL_PERCENTAGES.map(percentage => {
+ const preset = presetAmounts?.find(item => item.percentage === percentage)
+ const selected = !!preset && amount === preset.amount
+
+ return (
+
+ )
+ })}
+
+ }
+ positionMax="top"
+ />
+ {amountError && (
+
+ {amountError}
+
+ )}
+
+)
+
+export default CapitalAmountInput
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/modals/CapitalAmount/useCapitalAmount.ts b/apps/kyberswap-interface/src/pages/CopyTrading/modals/CapitalAmount/useCapitalAmount.ts
new file mode 100644
index 0000000000..f81d060e68
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/modals/CapitalAmount/useCapitalAmount.ts
@@ -0,0 +1,95 @@
+import { ChainId, Token } from '@kyberswap/ks-sdk-core'
+import { useMemo, useState } from 'react'
+
+import useTokenBalance from 'hooks/useTokenBalance'
+import {
+ CAPITAL_PERCENTAGES,
+ type CapitalAction,
+ type CapitalPercentage,
+ type CapitalPreset,
+ getCapitalInputQuoteToken,
+} from 'pages/CopyTrading/modals/CapitalAmount/capital'
+import { formatPreparedAmount, parsePreparedAmount } from 'pages/CopyTrading/modals/PreparedActionModal/preparedAction'
+import { formatDisplayNumber } from 'utils/numbers'
+import { formatUnits } from 'utils/viem'
+
+type UseCapitalAmountProps = {
+ account?: string
+ action: CapitalAction
+ connectedChainId?: number
+ targetChainId: number
+}
+
+export const useCapitalAmount = ({ account, action, connectedChainId, targetChainId }: UseCapitalAmountProps) => {
+ const [amount, setAmount] = useState('')
+
+ const quoteToken = getCapitalInputQuoteToken(targetChainId)
+ const quoteCurrency = useMemo(
+ () =>
+ quoteToken
+ ? new Token(targetChainId, quoteToken.address, quoteToken.decimals, quoteToken.symbol, quoteToken.symbol)
+ : undefined,
+ [quoteToken, targetChainId],
+ )
+
+ const walletBalance = useTokenBalance(quoteToken?.address || '', targetChainId as ChainId)
+ const walletBalanceLoading = !!account && !!quoteToken && walletBalance.isLoading
+ const walletBalanceRaw = account && quoteToken && !walletBalanceLoading ? walletBalance.value.toString() : undefined
+
+ const presetAmounts = useMemo(() => {
+ if (!quoteToken || !walletBalanceRaw) return undefined
+
+ return CAPITAL_PERCENTAGES.map(percentage => ({
+ percentage,
+ amount: formatUnits((BigInt(walletBalanceRaw) * BigInt(percentage)) / 100n, quoteToken.decimals),
+ }))
+ }, [quoteToken, walletBalanceRaw])
+
+ const amountRaw = useMemo(() => {
+ if (!quoteToken) return undefined
+
+ try {
+ return parsePreparedAmount(amount, quoteToken.decimals)
+ } catch {
+ return undefined
+ }
+ }, [amount, quoteToken])
+
+ const minimumAmountRaw = quoteToken?.minimumAmountRaw[action]
+ const amountBelowMinimum = !!amountRaw && !!minimumAmountRaw && BigInt(amountRaw) < BigInt(minimumAmountRaw)
+ const insufficientBalance = !!amountRaw && !!walletBalanceRaw && BigInt(amountRaw) > BigInt(walletBalanceRaw)
+ const amountError =
+ !amount || !quoteToken || !minimumAmountRaw
+ ? undefined
+ : !amountRaw || amountBelowMinimum
+ ? `Minimum amount is ${formatPreparedAmount(minimumAmountRaw, quoteToken)}.`
+ : insufficientBalance
+ ? `Insufficient ${quoteToken.symbol} balance.`
+ : undefined
+ const amountIsValid = !!amountRaw && !amountBelowMinimum && !insufficientBalance && !walletBalanceLoading
+
+ const onExpectedChain = connectedChainId === targetChainId
+ const presetsEnabled = !!account && onExpectedChain && !!walletBalanceRaw && BigInt(walletBalanceRaw) > 0n
+ const walletBalanceText =
+ walletBalanceRaw && quoteToken
+ ? formatDisplayNumber(formatUnits(BigInt(walletBalanceRaw), quoteToken.decimals), { significantDigits: 8 })
+ : '0'
+
+ const getPreset = (percentage: CapitalPercentage) => presetAmounts?.find(item => item.percentage === percentage)
+
+ return {
+ amount,
+ amountError,
+ amountIsValid,
+ amountRaw,
+ getPreset,
+ onExpectedChain,
+ presetAmounts,
+ presetsEnabled,
+ quoteCurrency,
+ quoteToken,
+ setAmount,
+ walletBalanceLoading,
+ walletBalanceText,
+ }
+}
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/modals/ManagePositionModal/components.tsx b/apps/kyberswap-interface/src/pages/CopyTrading/modals/ManagePositionModal/components.tsx
new file mode 100644
index 0000000000..a6d7207004
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/modals/ManagePositionModal/components.tsx
@@ -0,0 +1,135 @@
+import type { PositionSummary } from 'services/copyTrading/types/positions'
+import type { PositionSellPreview } from 'services/copyTrading/types/preparedActions'
+
+import { ButtonPrimary } from 'components/Button'
+import Dots from 'components/Dots'
+import { Stack } from 'components/Stack'
+import { ShortenedId } from 'pages/CopyTrading/components/common/layout'
+import { formatApproximateUsd } from 'pages/CopyTrading/helpers'
+import { ReviewRow, ReviewSection } from 'pages/CopyTrading/modals/PreparedActionModal'
+import PreparedActionSlippageControl from 'pages/CopyTrading/modals/PreparedActionModal/SlippageControl'
+import {
+ formatPreparedAmount,
+ formatSlippage,
+ formatWadPercent,
+} from 'pages/CopyTrading/modals/PreparedActionModal/preparedAction'
+
+const withMetricFallback = (value: string) => (value === '—' ? 'N/A' : value)
+
+export const PositionValue = ({ symbol, tradeId }: { symbol?: string; tradeId: string }) => (
+ <>
+ {symbol || 'Token'} ·
+
+ )
+}
+
+type ManagePositionFormProps = {
+ isPreparing: boolean
+ onPrimaryAction: () => void
+ onSlippageChange: (slippage: number) => void
+ position: PositionSummary
+ primaryActionDisabled: boolean
+ primaryActionLabel: string
+ slippage: number
+ unavailableMessage?: string
+}
+
+export const ManagePositionForm = ({
+ isPreparing,
+ onPrimaryAction,
+ onSlippageChange,
+ position,
+ primaryActionDisabled,
+ primaryActionLabel,
+ slippage,
+ unavailableMessage,
+}: ManagePositionFormProps) => {
+ return (
+
+
+
+
+
+ {isPreparing ? {primaryActionLabel} : primaryActionLabel}
+
+
+ )
+}
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/modals/ManagePositionModal/index.tsx b/apps/kyberswap-interface/src/pages/CopyTrading/modals/ManagePositionModal/index.tsx
new file mode 100644
index 0000000000..40b2e3ac89
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/modals/ManagePositionModal/index.tsx
@@ -0,0 +1,232 @@
+import { ChainId } from '@kyberswap/ks-sdk-core'
+import { useCallback, useState } from 'react'
+import { useNavigate } from 'react-router-dom'
+import copyAccountApi from 'services/copyTrading/api/endpoints/copyAccounts'
+import preparedActionApi from 'services/copyTrading/api/endpoints/preparedActions'
+import type { PositionActionKind, PositionSummary } from 'services/copyTrading/types/positions'
+import type { PreparedCallKind } from 'services/copyTrading/types/preparedActions'
+
+import { APP_PATHS } from 'constants/index'
+import { useActiveWeb3React } from 'hooks'
+import { useChangeNetwork } from 'hooks/web3/useChangeNetwork'
+import useRefreshCopyTrading from 'pages/CopyTrading/hooks/useRefreshCopyTrading'
+import { ManagePositionForm, ManagePositionReview } from 'pages/CopyTrading/modals/ManagePositionModal/components'
+import {
+ hasPositionAction,
+ isValidWadRatio,
+ loadCurrentCopyAccountPosition,
+ loadPendingSellObligations,
+} from 'pages/CopyTrading/modals/ManagePositionModal/positionData'
+import PreparedActionModal, { PreparedActionSuccessActions } from 'pages/CopyTrading/modals/PreparedActionModal'
+import { DEFAULT_PREPARED_ACTION_SLIPPAGE } from 'pages/CopyTrading/modals/PreparedActionModal/SlippageControl'
+import { DEFAULT_PREPARED_ACTION_STATE } from 'pages/CopyTrading/modals/PreparedActionModal/preparedAction'
+import { usePreparedAction } from 'pages/CopyTrading/modals/PreparedActionModal/usePreparedAction'
+import { useWalletModalToggle } from 'state/application/hooks'
+
+export type ManagePositionMode = 'sell' | 'close'
+
+type ManagePositionModalProps = {
+ isOpen: boolean
+ onDismiss: () => void
+ position: PositionSummary
+ mode: ManagePositionMode
+}
+
+const MANUAL_SELL_CALL_KINDS: PreparedCallKind[] = ['PREPARED_CALL_KIND_MANUAL_SELL']
+const CLOSE_POSITION_CALL_KINDS: PreparedCallKind[] = ['PREPARED_CALL_KIND_CLOSE_POSITION']
+
+const ManagePositionModal = ({ isOpen, onDismiss, position, mode }: ManagePositionModalProps) => {
+ const navigate = useNavigate()
+ const { account, chainId } = useActiveWeb3React()
+ const { changeNetwork } = useChangeNetwork()
+ const toggleWalletModal = useWalletModalToggle()
+ const refreshCopyTrading = useRefreshCopyTrading()
+ const [prepareManualSell] = preparedActionApi.usePrepareManualSellMutation()
+ const [prepareClosePosition] = preparedActionApi.usePrepareClosePositionMutation()
+ const [getCopyAccountPositions] = copyAccountApi.useLazyGetCopyAccountPositionsQuery()
+ const [getObligations] = copyAccountApi.useLazyGetPendingSellObligationsQuery()
+
+ const [flowState, setFlowState] = useState(DEFAULT_PREPARED_ACTION_STATE)
+ const [slippage, setSlippage] = useState(DEFAULT_PREPARED_ACTION_SLIPPAGE)
+
+ const isClose = mode === 'close'
+ const actionLabel = isClose ? 'Close Position' : 'Manual Sell'
+ const requiredAction: PositionActionKind = isClose
+ ? 'POSITION_ACTION_KIND_CLOSE_POSITION'
+ : 'POSITION_ACTION_KIND_MANUAL_SELL'
+ const userPositionId = position.userPositionId
+ const copyRunId = position.copyRunId
+ const copyAccount = position.copyAccount
+ const onExpectedChain = chainId === position.chainId
+ const actionAdvertised = hasPositionAction(position, requiredAction)
+
+ const fetchObligations = useCallback(async () => {
+ if (!copyAccount || !userPositionId) throw new Error('This position is missing its Smart Wallet identity.')
+
+ return loadPendingSellObligations(getObligations, {
+ chainId: position.chainId,
+ copyAccount,
+ userPositionId,
+ })
+ }, [copyAccount, getObligations, position.chainId, userPositionId])
+
+ const fetchCurrentPosition = useCallback(async () => {
+ if (!copyAccount || !userPositionId) throw new Error('This position is missing its Smart Wallet identity.')
+
+ return loadCurrentCopyAccountPosition(getCopyAccountPositions, {
+ chainId: position.chainId,
+ copyAccount,
+ userPositionId,
+ })
+ }, [copyAccount, getCopyAccountPositions, position.chainId, userPositionId])
+
+ const flow = usePreparedAction({
+ state: flowState,
+ setState: setFlowState,
+ expected: {
+ account: account || '',
+ callKinds: isClose ? CLOSE_POSITION_CALL_KINDS : MANUAL_SELL_CALL_KINDS,
+ chainId: position.chainId,
+ copyAccount,
+ preview: isClose ? 'closePosition' : 'manualSell',
+ },
+ prepare: async () => {
+ if (!account || !copyRunId || !copyAccount || !userPositionId) {
+ throw new Error('The selected position is missing write-flow identity fields.')
+ }
+
+ const [currentPosition, currentObligations] = await Promise.all([
+ fetchCurrentPosition(),
+ isClose ? Promise.resolve([]) : fetchObligations(),
+ ])
+ if (currentPosition.copyRunId !== copyRunId || currentPosition.copyAccount !== copyAccount) {
+ throw new Error('The refreshed position does not match the selected Copy Run.')
+ }
+ if (!hasPositionAction(currentPosition, requiredAction)) {
+ throw new Error('The refreshed position no longer supports ' + actionLabel + '.')
+ }
+
+ const slippageBps = Math.round(slippage * 100)
+ if (isClose) {
+ const response = await prepareClosePosition({
+ ownerAddress: account,
+ copyRunId,
+ userPositionId,
+ slippageBps,
+ }).unwrap()
+ if (
+ response.data.status === 'PREPARED_ACTION_STATUS_READY' &&
+ response.data.closePosition?.userPositionId !== userPositionId
+ ) {
+ throw new Error('The prepared position does not match your selection.')
+ }
+
+ return response.data
+ }
+
+ const currentObligation = currentObligations[0]
+ if (!isValidWadRatio(currentObligation?.currentRatioRaw) || !currentObligations.length) {
+ throw new Error('There is no current pending sell obligation for this position.')
+ }
+
+ const response = await prepareManualSell({
+ ownerAddress: account,
+ copyRunId,
+ userPositionId,
+ slippageBps,
+ expectedUnresolvedSkipCount: currentObligations.length,
+ expectedSellRatioRaw: currentObligation.currentRatioRaw,
+ }).unwrap()
+ const preview = response.data.manualSell
+ if (response.data.status === 'PREPARED_ACTION_STATUS_READY') {
+ if (preview?.userPositionId !== userPositionId) {
+ throw new Error('The prepared position does not match your selection.')
+ }
+ if (preview.sellRatioRaw !== currentObligation.currentRatioRaw) {
+ throw new Error('The prepared sell ratio does not match the current FIFO obligation.')
+ }
+ if (preview.unresolvedSkipCount !== currentObligations.length) {
+ throw new Error('The prepared obligation count does not match the current FIFO.')
+ }
+ }
+
+ return response.data
+ },
+ onComplete: refreshCopyTrading,
+ })
+
+ const dismiss = () => {
+ flow.reset()
+ setSlippage(DEFAULT_PREPARED_ACTION_SLIPPAGE)
+ onDismiss()
+ }
+
+ const handlePrimaryAction = () => {
+ if (!account) {
+ toggleWalletModal()
+ return
+ }
+ if (!onExpectedChain) {
+ void changeNetwork(position.chainId as ChainId)
+ return
+ }
+
+ void flow.prepare()
+ }
+
+ const viewMyCopies = () => {
+ dismiss()
+ navigate(APP_PATHS.COPY_TRADING + '/my-copies')
+ }
+
+ const unavailableMessage = !actionAdvertised
+ ? 'The selected position does not advertise ' + actionLabel + '.'
+ : undefined
+ const primaryActionLabel = !account
+ ? 'Connect wallet'
+ : !onExpectedChain
+ ? 'Switch network'
+ : unavailableMessage
+ ? actionLabel + ' unavailable'
+ : 'Review ' + actionLabel
+ const preview = isClose ? flowState.action?.closePosition : flowState.action?.manualSell
+ const reviewPreparing = flowState.phase === 'review' && flowState.isPreparing === true
+
+ const review = (
+ void flow.confirm()}
+ onRetry={() => void flow.retry()}
+ successTitle={isClose ? 'Position closed' : 'Manual sell completed'}
+ successActions={successActions}
+ width={520}
+ >
+
+ )
+}
+
+export default ManagePositionModal
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/modals/ManagePositionModal/positionData.test.ts b/apps/kyberswap-interface/src/pages/CopyTrading/modals/ManagePositionModal/positionData.test.ts
new file mode 100644
index 0000000000..7a9506becc
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/modals/ManagePositionModal/positionData.test.ts
@@ -0,0 +1,115 @@
+import type { PendingSellObligation } from 'services/copyTrading/types/copyRuns'
+import type { PositionSummary } from 'services/copyTrading/types/positions'
+import type { PendingSellObligationsQuery } from 'services/copyTrading/types/queries'
+import type { CopyAccountPositionsResponse, PendingSellObligationsResponse } from 'services/copyTrading/types/responses'
+import { describe, expect, it, vi } from 'vitest'
+
+import {
+ loadCurrentCopyAccountPosition,
+ loadPendingSellObligations,
+} from 'pages/CopyTrading/modals/ManagePositionModal/positionData'
+
+const copyAccount = '0x1111111111111111111111111111111111111111'
+
+const position = (userPositionId: string): PositionSummary =>
+ ({
+ userPositionId,
+ } as PositionSummary)
+
+const page = (
+ data: PositionSummary[],
+ pagination: CopyAccountPositionsResponse['pagination'],
+): CopyAccountPositionsResponse => ({ data, pagination })
+
+describe('loadCurrentCopyAccountPosition', () => {
+ it('refreshes cursor pages until it finds the selected position', async () => {
+ const getPositions = vi
+ .fn()
+ .mockReturnValueOnce({
+ unwrap: () => Promise.resolve(page([position('other')], { hasMore: true, limit: 100, nextCursor: 'page-2' })),
+ })
+ .mockReturnValueOnce({
+ unwrap: () => Promise.resolve(page([position('selected')], { hasMore: false, limit: 100 })),
+ })
+
+ await expect(
+ loadCurrentCopyAccountPosition(getPositions, {
+ chainId: 8453,
+ copyAccount,
+ userPositionId: 'selected',
+ }),
+ ).resolves.toMatchObject({ userPositionId: 'selected' })
+ expect(getPositions).toHaveBeenNthCalledWith(2, {
+ chainId: 8453,
+ copyAccount,
+ cursor: 'page-2',
+ limit: 100,
+ })
+ })
+
+ it('rejects an incomplete cursor chain instead of trusting a stale position snapshot', async () => {
+ const getPositions = vi.fn().mockReturnValue({
+ unwrap: () => Promise.resolve(page([], { hasMore: true, limit: 100, nextCursor: 'same-cursor' })),
+ })
+
+ await expect(
+ loadCurrentCopyAccountPosition(getPositions, {
+ chainId: 8453,
+ copyAccount,
+ userPositionId: 'selected',
+ }),
+ ).rejects.toThrow('invalid pagination cursor')
+ })
+})
+
+const obligation = (leaderPositionEventId: string): PendingSellObligation => ({
+ leaderPositionEventId,
+ currentRatioRaw: '1000000000000000000',
+})
+
+const obligationPage = (
+ data: PendingSellObligation[],
+ pagination: PendingSellObligationsResponse['pagination'],
+): PendingSellObligationsResponse => ({ data, pagination })
+
+const obligationQuery = {
+ chainId: 8453,
+ copyAccount,
+ userPositionId: 'selected',
+}
+
+describe('loadPendingSellObligations', () => {
+ it('loads every FIFO cursor page in order', async () => {
+ const getObligations = vi.fn((query: PendingSellObligationsQuery) => ({
+ unwrap: async () =>
+ query.cursor
+ ? obligationPage([obligation('event-2')], { hasMore: false, limit: 100 })
+ : obligationPage([obligation('event-1')], { hasMore: true, limit: 100, nextCursor: 'page-2' }),
+ }))
+
+ await expect(loadPendingSellObligations(getObligations, obligationQuery)).resolves.toEqual([
+ obligation('event-1'),
+ obligation('event-2'),
+ ])
+ expect(getObligations).toHaveBeenNthCalledWith(2, {
+ ...obligationQuery,
+ cursor: 'page-2',
+ limit: 100,
+ })
+ })
+
+ it('rejects a cursor cycle instead of looping forever', async () => {
+ const getObligations = vi.fn((query: PendingSellObligationsQuery) => ({
+ unwrap: async () =>
+ obligationPage([], {
+ hasMore: true,
+ limit: 100,
+ nextCursor: query.cursor === 'page-2' ? 'page-1' : query.cursor ? 'page-2' : 'page-1',
+ }),
+ }))
+
+ await expect(loadPendingSellObligations(getObligations, obligationQuery)).rejects.toThrow(
+ 'invalid pagination cursor',
+ )
+ })
+})
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/modals/ManagePositionModal/positionData.ts b/apps/kyberswap-interface/src/pages/CopyTrading/modals/ManagePositionModal/positionData.ts
new file mode 100644
index 0000000000..cb2f1b4322
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/modals/ManagePositionModal/positionData.ts
@@ -0,0 +1,86 @@
+import type { PendingSellObligation } from 'services/copyTrading/types/copyRuns'
+import type { PositionActionKind, PositionSummary } from 'services/copyTrading/types/positions'
+import type { CopyAccountPositionsQuery, PendingSellObligationsQuery } from 'services/copyTrading/types/queries'
+import type { CopyAccountPositionsResponse, PendingSellObligationsResponse } from 'services/copyTrading/types/responses'
+
+const POSITIONS_PAGE_SIZE = 100
+
+export const hasPositionAction = (position: PositionSummary, action: PositionActionKind) =>
+ position.actionKind === action || position.availableActionKinds.includes(action)
+
+export const isValidWadRatio = (value?: string) => {
+ if (!value || !/^\d+$/.test(value)) return false
+
+ const ratio = BigInt(value)
+ return ratio > 0n && ratio <= 10n ** 18n
+}
+
+type GetCopyAccountPositions = (query: CopyAccountPositionsQuery) => {
+ unwrap: () => Promise
+}
+
+type CurrentPositionQuery = Pick & {
+ userPositionId: string
+}
+
+export const loadCurrentCopyAccountPosition = async (
+ getCopyAccountPositions: GetCopyAccountPositions,
+ { chainId, copyAccount, userPositionId }: CurrentPositionQuery,
+) => {
+ const seenCursors = new Set()
+ let cursor: string | undefined
+
+ while (true) {
+ const response = await getCopyAccountPositions({
+ chainId,
+ copyAccount,
+ cursor,
+ limit: POSITIONS_PAGE_SIZE,
+ }).unwrap()
+ const currentPosition = response.data.find(position => position.userPositionId === userPositionId)
+ if (currentPosition) return currentPosition
+ if (!response.pagination.hasMore) {
+ throw new Error('The selected position is no longer available in this Smart Wallet.')
+ }
+
+ const nextCursor = response.pagination.nextCursor
+ if (!nextCursor || seenCursors.has(nextCursor)) {
+ throw new Error('The positions response returned an invalid pagination cursor.')
+ }
+
+ seenCursors.add(nextCursor)
+ cursor = nextCursor
+ }
+}
+
+type GetPendingSellObligations = (query: PendingSellObligationsQuery) => {
+ unwrap: () => Promise
+}
+
+export const loadPendingSellObligations = async (
+ getPendingSellObligations: GetPendingSellObligations,
+ query: Pick,
+) => {
+ const obligations: PendingSellObligation[] = []
+ const seenCursors = new Set()
+ let cursor: string | undefined
+
+ while (true) {
+ const response = await getPendingSellObligations({
+ ...query,
+ cursor,
+ limit: POSITIONS_PAGE_SIZE,
+ }).unwrap()
+ obligations.push(...response.data)
+
+ if (!response.pagination.hasMore) return obligations
+
+ const nextCursor = response.pagination.nextCursor
+ if (!nextCursor || seenCursors.has(nextCursor)) {
+ throw new Error('The pending obligations response returned an invalid pagination cursor.')
+ }
+
+ seenCursors.add(nextCursor)
+ cursor = nextCursor
+ }
+}
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/modals/PreparedActionModal/SlippageControl.tsx b/apps/kyberswap-interface/src/pages/CopyTrading/modals/PreparedActionModal/SlippageControl.tsx
new file mode 100644
index 0000000000..c1168ebbcb
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/modals/PreparedActionModal/SlippageControl.tsx
@@ -0,0 +1,38 @@
+import CollapsiblePresetControl, { type CollapsiblePresetControlOption } from 'components/CollapsiblePresetControl'
+import { DEFAULT_SLIPPAGES } from 'constants/trade'
+import { formatSlippage } from 'pages/CopyTrading/modals/PreparedActionModal/preparedAction'
+
+export const DEFAULT_PREPARED_ACTION_SLIPPAGE = 0.5
+
+const SLIPPAGE_OPTIONS: CollapsiblePresetControlOption[] = DEFAULT_SLIPPAGES.map(value => ({
+ label: formatSlippage(value),
+ value: value / 100,
+}))
+
+const formatValue = (value: number) => formatSlippage(value * 100)
+const isValueAllowed = (value: number) => value >= 0 && value <= 100
+
+type PreparedActionSlippageControlProps = {
+ disabled?: boolean
+ onChange: (value: number) => void
+ value: number
+}
+
+const PreparedActionSlippageControl = ({ disabled, onChange, value }: PreparedActionSlippageControlProps) => (
+
+
+ {label}
+
+
+ {isLoading ?
+ )
+}
+
+export const ReviewSection = ({ children, title }: { children: ReactNode; title?: string }) => (
+
+ {title && {title}}
+ {children}
+
+)
+
+type PreparedActionSuccessActionsProps = {
+ onClose: () => void
+ onPrimaryAction: () => void
+ primaryLabel: string
+}
+
+export const PreparedActionSuccessActions = ({
+ onClose,
+ onPrimaryAction,
+ primaryLabel,
+}: PreparedActionSuccessActionsProps) => (
+
+
+ Close
+
+
+ {primaryLabel}
+
+
+)
+
+type PreparedActionModalProps = {
+ children: ReactNode
+ confirmDisabled?: boolean
+ confirmLabel: string
+ confirmLoading?: boolean
+ isOpen: boolean
+ onBack?: () => void
+ onConfirm: () => void
+ onDismiss: () => void
+ onRetry: () => void
+ review: ReactNode
+ state: PreparedActionFlowState
+ successActions?: ReactNode
+ successText?: ReactNode
+ successTitle?: string
+ title: ReactNode
+ width?: number
+}
+
+const isProcessing = (state: PreparedActionFlowState) =>
+ ['awaiting_signature', 'confirming', 'syncing'].includes(state.phase)
+
+const getProcessingCopy = (state: PreparedActionFlowState) => {
+ if (state.phase === 'awaiting_signature') {
+ return {
+ title: 'Confirm in your wallet',
+ text: 'Review and confirm this transaction in your wallet to continue.',
+ }
+ }
+ if (state.phase === 'confirming') {
+ return { title: 'Transaction submitted', text: 'Your transaction is waiting for on-chain confirmation.' }
+ }
+ return {
+ title: 'Transaction confirmed',
+ text: 'Updating your latest Copy Trading data.',
+ }
+}
+
+type RecoveryViewModel = {
+ retryLabel: string
+ showBackAction: boolean
+ title?: string
+}
+
+const getRecoveryViewModel = (state: PreparedActionFlowState): RecoveryViewModel | undefined => {
+ switch (state.phase) {
+ case 'pending':
+ return { retryLabel: 'Try again', showBackAction: false, title: 'Update in progress' }
+ case 'unavailable':
+ return { retryLabel: 'Try again', showBackAction: false, title: 'Action unavailable' }
+ case 'expired':
+ return { retryLabel: 'Try again', showBackAction: true, title: 'Review expired' }
+ case 'error':
+ return { retryLabel: 'Try again', showBackAction: true }
+ case 'sync_error':
+ return state.retryStage === 'receipt'
+ ? { retryLabel: 'Check confirmation', showBackAction: false, title: 'Transaction submitted' }
+ : { retryLabel: 'Refresh status', showBackAction: false, title: 'Transaction confirmed' }
+ default:
+ return undefined
+ }
+}
+
+const PreparedActionModal = ({
+ children,
+ confirmDisabled,
+ confirmLabel,
+ confirmLoading = false,
+ isOpen,
+ onBack,
+ onConfirm,
+ onDismiss,
+ onRetry,
+ review,
+ state,
+ successActions,
+ successText = 'The transaction is confirmed on-chain. Copy Trading data will refresh in the background.',
+ successTitle = 'Action completed',
+ title,
+ width = 460,
+}: PreparedActionModalProps) => {
+ const [expandedError, setExpandedError] = useState()
+ const errorDetailId = useId()
+ const chainId = Number(state.action?.chainId)
+ const scanLink = state.hash && chainId ? getEtherscanLink(chainId, state.hash, 'transaction') : undefined
+ const processing = isProcessing(state)
+ const processingCopy = getProcessingCopy(state)
+ const recovery = getRecoveryViewModel(state)
+ const reviewPreparing = state.phase === 'review' && state.isPreparing === true
+ const interactionLocked = confirmLoading || reviewPreparing
+ const recoveryError = state.error ? friendlyError(state.error) : undefined
+ const hasErrorDetail = state.phase === 'error' && !!state.error && recoveryError !== state.error
+ const showErrorDetail = hasErrorDetail && expandedError === state.error
+ const RecoveryBackButton = recovery?.showBackAction ? ButtonOutlined : ButtonLight
+ const RecoveryRetryButton = recovery?.showBackAction ? ButtonLight : ButtonPrimary
+ return (
+
+
+
+
+ {typeof title === 'string' ? (
+
+
+ )}
+
+
+ {state.phase === 'idle' && children}
+
+ {state.phase === 'review' && (
+
+ {review}
+ {!!state.action?.warnings?.length && (
+
+ {state.action.warnings.map(warning => (
+ {warning.replace('PREPARED_ACTION_WARNING_', '').replaceAll('_', ' ')}
+ ))}
+
+ )}
+
+ {onBack && (
+
+ Back
+
+ )}
+
+ {interactionLocked ? {confirmLabel} : confirmLabel}
+
+
+
+ )}
+
+ {processing && (
+
+
+ {processingCopy.title}
+ {processingCopy.text}
+
+ {scanLink && (
+
+ View on explorer ↗
+
+ )}
+
+ )}
+
+ {state.phase === 'success' && (
+
+
+ {successTitle}
+ {successText && {successText}}
+
+ {scanLink && (
+
+ View on explorer ↗
+
+ )}
+ {successActions ?? (
+
+ Done
+
+ )}
+
+ )}
+
+ {recovery && (
+
+ {state.phase === 'pending' ? (
+
+ {state.phase === 'error' ? (
+ <>
+ {recoveryError && (
+ {recoveryError}
+ )}
+ {hasErrorDetail && (
+
+
+
+ )}
+
+ ) : (
+ <>
+ {recovery.title}
+ {recoveryError && {recoveryError}}
+
+ )}
+
+ {scanLink && (
+
+ View on explorer ↗
+
+ )}
+
+
+ {recovery.showBackAction ? 'Back' : 'Close'}
+
+
+ {state.isPreparing ? (
+ {recovery.retryLabel}
+ ) : (
+
+
+ )}
+
+
+
+ )}
+
+
+
+ )
+}
+
+export default PreparedActionModal
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/modals/PreparedActionModal/preparedAction.test.ts b/apps/kyberswap-interface/src/pages/CopyTrading/modals/PreparedActionModal/preparedAction.test.ts
new file mode 100644
index 0000000000..5bfc4bb460
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/modals/PreparedActionModal/preparedAction.test.ts
@@ -0,0 +1,189 @@
+import type { PreparedAction } from 'services/copyTrading/types/preparedActions'
+import { describe, expect, it } from 'vitest'
+
+import {
+ type PreparedActionExpectation,
+ validatePreparedAction,
+ validatePreparedActionContinuation,
+} from 'pages/CopyTrading/modals/PreparedActionModal/preparedAction'
+
+const account = '0x1111111111111111111111111111111111111111'
+const copyAccount = '0x2222222222222222222222222222222222222222'
+const authorizedCopyAccount = '0x4444444444444444444444444444444444444444'
+const callTarget = '0x3333333333333333333333333333333333333333'
+const startRequestId = '123e4567-e89b-42d3-a456-426614174000'
+const authorizedStartRequestId = '123e4567-e89b-42d3-a456-426614174001'
+const targetCapitalRaw = '1000000'
+
+const expected: PreparedActionExpectation = {
+ account,
+ callKinds: ['PREPARED_CALL_KIND_START_COPY_CREATE'],
+ chainId: 8453,
+ preview: 'startCopy',
+ startCopyCreateAmountRaw: targetCapitalRaw,
+ startCopyPredictedAccount: copyAccount,
+ startCopyRequestId: startRequestId,
+ startCopyTargetRaw: targetCapitalRaw,
+}
+
+const confirmingAction = (overrides: Partial = {}): PreparedAction => ({
+ status: 'PREPARED_ACTION_STATUS_PENDING',
+ chainId: '8453',
+ expectedAccount: account,
+ copyAccount,
+ reason: 'PREPARED_ACTION_REASON_SOURCE_COVERAGE_PENDING',
+ startCopy: {
+ stage: 'START_COPY_STAGE_CREATE_CONFIRMING',
+ startRequestId,
+ predictedCopyAccount: copyAccount,
+ requestedTargetRaw: targetCapitalRaw,
+ },
+ ...overrides,
+})
+
+const unsafeConfirmingCases: Array<{ name: string; overrides: Partial }> = [
+ {
+ name: 'an executable call',
+ overrides: {
+ call: {
+ kind: 'PREPARED_CALL_KIND_START_COPY_CREATE',
+ to: callTarget,
+ data: '0x',
+ valueRaw: '0',
+ },
+ },
+ },
+ {
+ name: 'a changed target',
+ overrides: {
+ startCopy: {
+ stage: 'START_COPY_STAGE_CREATE_CONFIRMING',
+ startRequestId,
+ predictedCopyAccount: copyAccount,
+ requestedTargetRaw: '2000000',
+ },
+ },
+ },
+ { name: 'a missing Smart Wallet identity', overrides: { copyAccount: undefined } },
+]
+
+describe('validatePreparedAction', () => {
+ it('accepts a call-free Start Copy confirming response', () => {
+ expect(validatePreparedAction(confirmingAction(), expected, { requireCall: false })).toBeUndefined()
+ })
+
+ it.each(unsafeConfirmingCases)('rejects a confirming response with $name', ({ overrides }) => {
+ expect(validatePreparedAction(confirmingAction(overrides), expected, { requireCall: false })).toBeTruthy()
+ })
+
+ it('rejects a non-zero prepared call value', () => {
+ const action: PreparedAction = {
+ status: 'PREPARED_ACTION_STATUS_READY',
+ chainId: '8453',
+ expectedAccount: account,
+ startCopy: {
+ createAmountRaw: targetCapitalRaw,
+ stage: 'START_COPY_STAGE_CREATE_REQUIRED',
+ startRequestId,
+ predictedCopyAccount: copyAccount,
+ requestedTargetRaw: targetCapitalRaw,
+ },
+ call: {
+ kind: 'PREPARED_CALL_KIND_START_COPY_CREATE',
+ to: callTarget,
+ data: '0x',
+ valueRaw: '1',
+ },
+ }
+
+ expect(validatePreparedAction(action, expected)).toBe('The preparation returned a non-zero call value.')
+ })
+
+ it('rejects an unfunded create amount for a funded Start Copy attempt', () => {
+ const action: PreparedAction = {
+ status: 'PREPARED_ACTION_STATUS_READY',
+ chainId: '8453',
+ expectedAccount: account,
+ startCopy: {
+ stage: 'START_COPY_STAGE_CREATE_REQUIRED',
+ startRequestId,
+ predictedCopyAccount: copyAccount,
+ requestedTargetRaw: targetCapitalRaw,
+ createAmountRaw: '0',
+ },
+ call: {
+ kind: 'PREPARED_CALL_KIND_START_COPY_CREATE',
+ to: callTarget,
+ data: '0x',
+ valueRaw: '0',
+ },
+ }
+
+ expect(validatePreparedAction(action, expected)).toBe(
+ 'The prepared Start Copy create amount does not match the selected funding mode.',
+ )
+ })
+
+ it('rejects a separate Fund call for a funded Start Copy attempt', () => {
+ const action: PreparedAction = {
+ status: 'PREPARED_ACTION_STATUS_PARTIALLY_COMPLETED',
+ chainId: '8453',
+ expectedAccount: account,
+ copyAccount,
+ startCopy: {
+ stage: 'START_COPY_STAGE_FUNDING_REQUIRED',
+ startRequestId,
+ predictedCopyAccount: copyAccount,
+ requestedTargetRaw: targetCapitalRaw,
+ },
+ call: {
+ kind: 'PREPARED_CALL_KIND_START_COPY_FUND',
+ to: callTarget,
+ data: '0x',
+ valueRaw: '0',
+ },
+ }
+
+ expect(validatePreparedAction(action, expected)).toBe('The preparation returned an unexpected call kind.')
+ })
+
+ it('accepts the authorized UUID predicted account after clearing the diagnostic UUID identity', () => {
+ const action: PreparedAction = {
+ status: 'PREPARED_ACTION_STATUS_READY',
+ chainId: '8453',
+ expectedAccount: account,
+ startCopy: {
+ stage: 'START_COPY_STAGE_CREATE_REQUIRED',
+ startRequestId: authorizedStartRequestId,
+ predictedCopyAccount: authorizedCopyAccount,
+ requestedTargetRaw: targetCapitalRaw,
+ createAmountRaw: targetCapitalRaw,
+ },
+ call: {
+ kind: 'PREPARED_CALL_KIND_START_COPY_CREATE',
+ to: callTarget,
+ data: '0x',
+ valueRaw: '0',
+ },
+ }
+ const authorizedExpected: PreparedActionExpectation = {
+ ...expected,
+ startCopyPredictedAccount: undefined,
+ startCopyRequestId: authorizedStartRequestId,
+ }
+
+ expect(validatePreparedAction(action, authorizedExpected)).toBeUndefined()
+ expect(validatePreparedAction(action, { ...authorizedExpected, startCopyPredictedAccount: copyAccount })).toBe(
+ 'The prepared Start Copy Smart Wallet changed during this attempt.',
+ )
+ })
+
+ it.each(['PREPARED_ACTION_STATUS_READY', 'PREPARED_ACTION_STATUS_PARTIALLY_COMPLETED'] as const)(
+ 'rejects an executable %s response after the funded Create receipt',
+ status => {
+ expect(validatePreparedActionContinuation({ status })).toBe(
+ 'The confirmed Start Copy transaction returned another executable preparation. Do not submit another transaction.',
+ )
+ },
+ )
+})
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/modals/PreparedActionModal/preparedAction.ts b/apps/kyberswap-interface/src/pages/CopyTrading/modals/PreparedActionModal/preparedAction.ts
new file mode 100644
index 0000000000..354a4077ba
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/modals/PreparedActionModal/preparedAction.ts
@@ -0,0 +1,272 @@
+import type { Dispatch, SetStateAction } from 'react'
+import type {
+ PreparedAction,
+ PreparedCallKind,
+ PreparedToken,
+ RawAmountMetric,
+} from 'services/copyTrading/types/preparedActions'
+
+import { formatDisplayNumber } from 'utils/numbers'
+import { type Hash, formatUnits, isAddress, parseUnits } from 'utils/viem'
+
+export type PreparedActionPhase =
+ | 'idle'
+ | 'review'
+ | 'awaiting_signature'
+ | 'confirming'
+ | 'syncing'
+ | 'pending'
+ | 'unavailable'
+ | 'expired'
+ | 'success'
+ | 'error'
+ | 'sync_error'
+
+export type PreparedActionFlowState = {
+ phase: PreparedActionPhase
+ isPreparing?: boolean
+ action?: PreparedAction
+ error?: string
+ hash?: Hash
+ retryStage?: 'receipt' | 'sync'
+}
+
+export const DEFAULT_PREPARED_ACTION_STATE: PreparedActionFlowState = { phase: 'idle' }
+
+export type PreparedActionStateSetter = Dispatch>
+
+const preparationRequestVersions = new WeakMap()
+
+export const invalidatePreparationRequests = (setState: PreparedActionStateSetter) => {
+ const nextVersion = (preparationRequestVersions.get(setState) || 0) + 1
+ preparationRequestVersions.set(setState, nextVersion)
+ return nextVersion
+}
+
+export const isCurrentPreparationRequest = (setState: PreparedActionStateSetter, version: number) =>
+ preparationRequestVersions.get(setState) === version
+
+export type PreparedActionExpectation = {
+ account: string
+ callKinds: readonly PreparedCallKind[]
+ chainId: number
+ copyAccount?: string
+ preview: 'startCopy' | 'addCapital' | 'stopCopy' | 'withdrawQuote' | 'manualSell' | 'closePosition'
+ startCopyPredictedAccount?: string
+ startCopyCreateAmountRaw?: string
+ startCopyRequestId?: string
+ startCopyTargetRaw?: string
+}
+
+export const getApiErrorMessage = (error: unknown) => {
+ if (error instanceof Error) return error.message
+ if (!error || typeof error !== 'object') return 'The request could not be completed.'
+
+ const value = error as {
+ data?: { error?: string; message?: string; publicErrorMessage?: string } | string
+ error?: string
+ message?: string
+ }
+ if (typeof value.data === 'string') return value.data
+ return (
+ value.data?.publicErrorMessage ||
+ value.data?.message ||
+ value.data?.error ||
+ value.message ||
+ value.error ||
+ 'The request could not be completed.'
+ )
+}
+
+export const parsePreparedAmount = (amount: string, decimals: number) => {
+ const normalized = amount.trim()
+ if (!normalized || Number(normalized) <= 0) throw new Error('Enter an amount greater than zero.')
+ return parseUnits(normalized, decimals).toString()
+}
+
+const isUnavailableMetric = (metric?: RawAmountMetric) =>
+ !metric?.valueRaw ||
+ metric.status === 'METRIC_STATUS_UNAVAILABLE' ||
+ metric.status === 'METRIC_STATUS_NOT_APPLICABLE' ||
+ metric.status === 'METRIC_STATUS_UNSPECIFIED'
+
+export const formatPreparedAmount = (
+ value: string | RawAmountMetric | undefined,
+ token?: PreparedToken,
+ maximumFractionDigits = 6,
+) => {
+ const valueRaw = typeof value === 'string' ? value : value?.valueRaw
+ if ((typeof value !== 'string' && isUnavailableMetric(value)) || !valueRaw || token?.decimals === undefined)
+ return '—'
+
+ const decimal = formatUnits(BigInt(valueRaw), token.decimals)
+ const formatted = formatDisplayNumber(decimal, {
+ allowDisplayNegative: true,
+ fractionDigits: maximumFractionDigits,
+ significantDigits: 15,
+ })
+ return `${formatted} ${token.symbol || ''}`.trim()
+}
+
+export const formatWadPercent = (valueRaw?: string) => {
+ if (!valueRaw || !/^\d+$/.test(valueRaw)) return '—'
+ const percentage = Number(formatUnits(BigInt(valueRaw), 16))
+ return Number.isFinite(percentage)
+ ? `${formatDisplayNumber(percentage, { fractionDigits: 4, significantDigits: 15 })}%`
+ : '—'
+}
+
+export const formatSlippage = (slippageBps?: number) =>
+ slippageBps === undefined
+ ? '—'
+ : `${formatDisplayNumber(slippageBps / 100, { fractionDigits: 2, significantDigits: 15 })}%`
+
+export const PREPARATION_EXPIRED_ERROR = 'This preparation has expired. Please try again.'
+export const LIQUIDATION_QUOTE_EXPIRED_ERROR = 'The liquidation quote has expired. Please try again.'
+
+export const isPreparationExpiredError = (error?: string) =>
+ error === PREPARATION_EXPIRED_ERROR || error === LIQUIDATION_QUOTE_EXPIRED_ERROR
+
+const sameAddress = (a?: string, b?: string) => Boolean(a && b && a.toLowerCase() === b.toLowerCase())
+
+export const validatePreparedAction = (
+ action: PreparedAction,
+ expected: PreparedActionExpectation,
+ { requireCall = true }: { requireCall?: boolean } = {},
+) => {
+ if (Number(action.chainId) !== expected.chainId) return 'The prepared chain does not match the selected chain.'
+ if (!sameAddress(action.expectedAccount, expected.account)) return 'The prepared sender does not match your wallet.'
+
+ if (expected.copyAccount && !sameAddress(action.copyAccount, expected.copyAccount)) {
+ return 'The prepared Smart Wallet does not match the selected Copy Run.'
+ }
+
+ const previewKeys = (
+ ['startCopy', 'addCapital', 'stopCopy', 'withdrawQuote', 'manualSell', 'closePosition'] as const
+ ).filter(key => action[key] !== undefined)
+ if (previewKeys.length !== 1 || previewKeys[0] !== expected.preview) {
+ return 'The preparation returned an unexpected action preview.'
+ }
+
+ const call = action.call
+ if (
+ (action.status === 'PREPARED_ACTION_STATUS_COMPLETED' || action.status === 'PREPARED_ACTION_STATUS_PENDING') &&
+ call
+ ) {
+ return 'The non-executable preparation unexpectedly returned a call.'
+ }
+
+ if (expected.preview === 'startCopy') {
+ const startCopy = action.startCopy
+ if (expected.startCopyRequestId && startCopy?.startRequestId !== expected.startCopyRequestId) {
+ return 'The prepared Start Copy request does not match this attempt.'
+ }
+ if (expected.startCopyTargetRaw && startCopy?.requestedTargetRaw !== expected.startCopyTargetRaw) {
+ return 'The prepared Start Copy target does not match this attempt.'
+ }
+ if (
+ expected.startCopyPredictedAccount &&
+ !sameAddress(startCopy?.predictedCopyAccount, expected.startCopyPredictedAccount)
+ ) {
+ return 'The prepared Start Copy Smart Wallet changed during this attempt.'
+ }
+ if (!startCopy?.predictedCopyAccount) {
+ return 'The prepared Start Copy action is missing its predicted Smart Wallet.'
+ }
+ if (action.copyAccount && !sameAddress(startCopy.predictedCopyAccount, action.copyAccount)) {
+ return 'The prepared Start Copy account identity is inconsistent.'
+ }
+
+ if (startCopy.stage === 'START_COPY_STAGE_CREATE_REQUIRED' && action.copyAccount) {
+ return 'The Start Copy create preparation unexpectedly returned a Smart Wallet identity.'
+ }
+ if (
+ startCopy.stage === 'START_COPY_STAGE_CREATE_REQUIRED' &&
+ expected.startCopyCreateAmountRaw !== undefined &&
+ startCopy.createAmountRaw !== expected.startCopyCreateAmountRaw
+ ) {
+ return 'The prepared Start Copy create amount does not match the selected funding mode.'
+ }
+
+ if (action.status === 'PREPARED_ACTION_STATUS_PENDING') {
+ if (startCopy.stage !== 'START_COPY_STAGE_CREATE_CONFIRMING') {
+ return 'The pending Start Copy action returned an unexpected stage.'
+ }
+ if (!action.copyAccount || !sameAddress(startCopy.predictedCopyAccount, action.copyAccount)) {
+ return 'The confirming Start Copy action is missing its Smart Wallet identity.'
+ }
+ }
+
+ if (action.status === 'PREPARED_ACTION_STATUS_COMPLETED') {
+ if (startCopy.stage !== 'START_COPY_STAGE_COMPLETE') {
+ return 'The completed Start Copy action returned an unexpected stage.'
+ }
+ if (!action.copyAccount || !sameAddress(startCopy.predictedCopyAccount, action.copyAccount)) {
+ return 'The completed Start Copy action is missing its Smart Wallet identity.'
+ }
+ }
+ }
+
+ if (requireCall || action.status === 'PREPARED_ACTION_STATUS_PENDING') {
+ const now = Date.now()
+ if (action.reprepareAfter) {
+ const reprepareAfter = Date.parse(action.reprepareAfter)
+ if (!Number.isFinite(reprepareAfter)) return 'The preparation returned an invalid expiry.'
+ if (action.status !== 'PREPARED_ACTION_STATUS_PENDING' && reprepareAfter <= now) {
+ return PREPARATION_EXPIRED_ERROR
+ }
+ }
+ if (action.liquidationConfigDeadline) {
+ const liquidationConfigDeadline = Date.parse(action.liquidationConfigDeadline)
+ if (!Number.isFinite(liquidationConfigDeadline)) {
+ return 'The preparation returned an invalid liquidation deadline.'
+ }
+ if (liquidationConfigDeadline <= now) return LIQUIDATION_QUOTE_EXPIRED_ERROR
+ }
+ }
+
+ if (!requireCall) return undefined
+
+ if (!call?.kind || !expected.callKinds.includes(call.kind)) return 'The preparation returned an unexpected call kind.'
+
+ if (expected.preview === 'startCopy') {
+ const startCopy = action.startCopy
+ if (call.kind === 'PREPARED_CALL_KIND_START_COPY_CREATE') {
+ if (startCopy?.stage !== 'START_COPY_STAGE_CREATE_REQUIRED') {
+ return 'The prepared Start Copy create call returned an unexpected stage.'
+ }
+ if (action.status === 'PREPARED_ACTION_STATUS_PARTIALLY_COMPLETED') {
+ return 'The partially completed Start Copy action returned another create call.'
+ }
+ }
+ if (call.kind === 'PREPARED_CALL_KIND_START_COPY_FUND') {
+ if (startCopy?.stage !== 'START_COPY_STAGE_FUNDING_REQUIRED') {
+ return 'The prepared Start Copy funding call returned an unexpected stage.'
+ }
+ if (!action.copyAccount || !sameAddress(action.copyAccount, startCopy.predictedCopyAccount)) {
+ return 'The prepared funding account does not match the predicted Smart Wallet.'
+ }
+ }
+ } else if (action.status === 'PREPARED_ACTION_STATUS_PARTIALLY_COMPLETED') {
+ return 'Only Start Copy can return a partially completed preparation.'
+ }
+
+ if (!call.to || !isAddress(call.to)) return 'The preparation returned an invalid call target.'
+ if (!call.data || !/^0x[0-9a-fA-F]*$/.test(call.data)) return 'The preparation returned invalid calldata.'
+ if (call.valueRaw !== '0') return 'The preparation returned a non-zero call value.'
+
+ return undefined
+}
+
+export const getReprepareDelay = (action: PreparedAction) => {
+ const requestedAt = action.reprepareAfter ? Date.parse(action.reprepareAfter) : Number.NaN
+ if (!Number.isFinite(requestedAt)) return 2_000
+ return Math.max(500, requestedAt - Date.now())
+}
+
+export const validatePreparedActionContinuation = (action: PreparedAction) =>
+ action.status === 'PREPARED_ACTION_STATUS_READY' || action.status === 'PREPARED_ACTION_STATUS_PARTIALLY_COMPLETED'
+ ? 'The confirmed Start Copy transaction returned another executable preparation. Do not submit another transaction.'
+ : undefined
+
+export const wait = (milliseconds: number) => new Promise(resolve => setTimeout(resolve, milliseconds))
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/modals/PreparedActionModal/requestPreparation.test.ts b/apps/kyberswap-interface/src/pages/CopyTrading/modals/PreparedActionModal/requestPreparation.test.ts
new file mode 100644
index 0000000000..50bef4836b
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/modals/PreparedActionModal/requestPreparation.test.ts
@@ -0,0 +1,63 @@
+import type { Dispatch, SetStateAction } from 'react'
+import type { PreparedAction } from 'services/copyTrading/types/preparedActions'
+import { describe, expect, it, vi } from 'vitest'
+
+import {
+ DEFAULT_PREPARED_ACTION_STATE,
+ type PreparedActionExpectation,
+ type PreparedActionFlowState,
+} from 'pages/CopyTrading/modals/PreparedActionModal/preparedAction'
+import { requestPreparation } from 'pages/CopyTrading/modals/PreparedActionModal/requestPreparation'
+
+const account = '0x1111111111111111111111111111111111111111'
+const copyAccount = '0x2222222222222222222222222222222222222222'
+
+const expected: PreparedActionExpectation = {
+ account,
+ callKinds: ['PREPARED_CALL_KIND_ADD_CAPITAL'],
+ chainId: 8453,
+ copyAccount,
+ preview: 'addCapital',
+}
+
+const readyAction: PreparedAction = {
+ status: 'PREPARED_ACTION_STATUS_READY',
+ chainId: '8453',
+ expectedAccount: account,
+ copyAccount,
+ addCapital: { addedCapitalRaw: '1000000' },
+ call: {
+ kind: 'PREPARED_CALL_KIND_ADD_CAPITAL',
+ to: '0x3333333333333333333333333333333333333333',
+ data: '0x',
+ valueRaw: '0',
+ },
+}
+
+const createStateHarness = () => {
+ let state = DEFAULT_PREPARED_ACTION_STATE
+ const setState: Dispatch> = update => {
+ state = typeof update === 'function' ? update(state) : update
+ }
+ return { getState: () => state, setState }
+}
+
+describe('requestPreparation', () => {
+ it('forwards a validated ready action without entering the review phase', async () => {
+ const harness = createStateHarness()
+ const onReady = vi.fn((action: PreparedAction) => harness.setState({ phase: 'awaiting_signature', action }))
+
+ await requestPreparation(
+ {
+ expected,
+ finish: vi.fn(),
+ prepare: vi.fn().mockResolvedValue(readyAction),
+ setState: harness.setState,
+ },
+ { onReady },
+ )
+
+ expect(onReady).toHaveBeenCalledWith(readyAction)
+ expect(harness.getState()).toEqual({ phase: 'awaiting_signature', action: readyAction })
+ })
+})
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/modals/PreparedActionModal/requestPreparation.ts b/apps/kyberswap-interface/src/pages/CopyTrading/modals/PreparedActionModal/requestPreparation.ts
new file mode 100644
index 0000000000..32b4377176
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/modals/PreparedActionModal/requestPreparation.ts
@@ -0,0 +1,170 @@
+import type { PreparedAction } from 'services/copyTrading/types/preparedActions'
+
+import { getPreparedReasonMessage } from 'pages/CopyTrading/helpers'
+import {
+ type PreparedActionExpectation,
+ type PreparedActionStateSetter,
+ getApiErrorMessage,
+ getReprepareDelay,
+ invalidatePreparationRequests,
+ isCurrentPreparationRequest,
+ isPreparationExpiredError,
+ validatePreparedAction,
+ validatePreparedActionContinuation,
+ wait,
+} from 'pages/CopyTrading/modals/PreparedActionModal/preparedAction'
+import type { Hash } from 'utils/viem'
+
+const CONTINUATION_ATTEMPTS = 6
+
+export type PreparationRequestOptions = {
+ continuation?: boolean
+ delay?: number
+ hash?: Hash
+ onReady?: (action: PreparedAction) => Promise | void
+ phaseWhilePreparing?: 'review'
+}
+
+type RequestPreparationProps = {
+ expected: PreparedActionExpectation
+ finish: (action?: PreparedAction, hash?: Hash, preparationVersion?: number) => void
+ prepare: () => Promise
+ reviewUnavailable?: (action: PreparedAction) => boolean
+ setState: PreparedActionStateSetter
+}
+
+export const requestPreparation = async (
+ { expected, finish, prepare, reviewUnavailable, setState }: RequestPreparationProps,
+ { continuation = false, delay = 0, hash, onReady, phaseWhilePreparing }: PreparationRequestOptions = {},
+) => {
+ const preparationVersion = invalidatePreparationRequests(setState)
+ const isCurrent = () => isCurrentPreparationRequest(setState, preparationVersion)
+
+ setState(current =>
+ continuation
+ ? { phase: 'syncing', action: current.action, hash, isPreparing: true }
+ : phaseWhilePreparing === 'review'
+ ? { phase: 'review', isPreparing: true }
+ : { ...current, isPreparing: true },
+ )
+
+ if (delay > 0) {
+ await wait(delay)
+ if (!isCurrent()) return
+ }
+
+ for (let attempt = 0; attempt < CONTINUATION_ATTEMPTS; attempt++) {
+ let action: PreparedAction
+ try {
+ action = await prepare()
+ } catch (error) {
+ if (!isCurrent()) return
+ setState(current => ({
+ phase: continuation ? 'sync_error' : 'error',
+ action: continuation ? current.action : undefined,
+ error: getApiErrorMessage(error),
+ hash,
+ retryStage: continuation ? 'sync' : undefined,
+ }))
+ return
+ }
+ if (!isCurrent()) return
+
+ if (action.status === 'PREPARED_ACTION_STATUS_PENDING') {
+ const validationError = validatePreparedAction(action, expected, { requireCall: false })
+ if (validationError) {
+ setState({
+ phase: isPreparationExpiredError(validationError) ? 'expired' : 'error',
+ action,
+ error: validationError,
+ hash,
+ })
+ return
+ }
+ if (continuation && attempt < CONTINUATION_ATTEMPTS - 1) {
+ await wait(getReprepareDelay(action))
+ if (!isCurrent()) return
+ continue
+ }
+
+ setState({ phase: 'pending', action, error: getPreparedReasonMessage(action.reason), hash })
+ return
+ }
+
+ if (action.status === 'PREPARED_ACTION_STATUS_UNAVAILABLE') {
+ if (!continuation && reviewUnavailable?.(action)) {
+ const validationError = validatePreparedAction(action, expected, { requireCall: false })
+ if (validationError) {
+ setState({
+ phase: isPreparationExpiredError(validationError) ? 'expired' : 'error',
+ action,
+ error: validationError,
+ hash,
+ })
+ return
+ }
+
+ setState({ phase: 'review', action, hash })
+ return
+ }
+
+ setState({ phase: 'unavailable', action, error: getPreparedReasonMessage(action.reason), hash })
+ return
+ }
+
+ if (action.status === 'PREPARED_ACTION_STATUS_COMPLETED') {
+ const validationError = validatePreparedAction(action, expected, { requireCall: false })
+ if (validationError) {
+ setState({
+ phase: isPreparationExpiredError(validationError) ? 'expired' : 'error',
+ action,
+ error: validationError,
+ hash,
+ })
+ return
+ }
+
+ finish(action, hash, preparationVersion)
+ return
+ }
+
+ if (
+ action.status !== 'PREPARED_ACTION_STATUS_READY' &&
+ action.status !== 'PREPARED_ACTION_STATUS_PARTIALLY_COMPLETED'
+ ) {
+ setState({ phase: 'error', action, error: 'The API returned an unsupported preparation status.', hash })
+ return
+ }
+
+ if (continuation) {
+ const continuationError = validatePreparedActionContinuation(action)
+ setState({
+ phase: 'sync_error',
+ action,
+ error: continuationError || 'The confirmed transaction returned an unsupported continuation state.',
+ hash,
+ retryStage: 'sync',
+ })
+ return
+ }
+
+ const validationError = validatePreparedAction(action, expected)
+ if (validationError) {
+ setState({
+ phase: isPreparationExpiredError(validationError) ? 'expired' : 'error',
+ action,
+ error: validationError,
+ hash,
+ })
+ return
+ }
+
+ if (onReady) {
+ await onReady(action)
+ return
+ }
+
+ setState({ phase: 'review', action, hash })
+ return
+ }
+}
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/modals/PreparedActionModal/usePreparedAction.test.ts b/apps/kyberswap-interface/src/pages/CopyTrading/modals/PreparedActionModal/usePreparedAction.test.ts
new file mode 100644
index 0000000000..6200ca636c
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/modals/PreparedActionModal/usePreparedAction.test.ts
@@ -0,0 +1,305 @@
+import type { Dispatch, SetStateAction } from 'react'
+import type { PreparedAction } from 'services/copyTrading/types/preparedActions'
+import { describe, expect, it, vi } from 'vitest'
+
+import {
+ DEFAULT_PREPARED_ACTION_STATE,
+ type PreparedActionExpectation,
+ type PreparedActionFlowState,
+} from 'pages/CopyTrading/modals/PreparedActionModal/preparedAction'
+import { usePreparedAction } from 'pages/CopyTrading/modals/PreparedActionModal/usePreparedAction'
+
+const account = '0x1111111111111111111111111111111111111111'
+const predictedCopyAccount = '0x2222222222222222222222222222222222222222'
+const callTarget = '0x3333333333333333333333333333333333333333'
+const startRequestId = '123e4567-e89b-42d3-a456-426614174000'
+const targetCapitalRaw = '50000000'
+
+const expected: PreparedActionExpectation = {
+ account,
+ callKinds: ['PREPARED_CALL_KIND_START_COPY_CREATE'],
+ chainId: 8453,
+ preview: 'startCopy',
+ startCopyCreateAmountRaw: targetCapitalRaw,
+ startCopyRequestId: startRequestId,
+ startCopyTargetRaw: targetCapitalRaw,
+}
+
+const allowanceDiagnostic: PreparedAction = {
+ status: 'PREPARED_ACTION_STATUS_UNAVAILABLE',
+ reason: 'PREPARED_ACTION_REASON_INSUFFICIENT_QUOTE_ALLOWANCE',
+ chainId: '8453',
+ expectedAccount: account,
+ startCopy: {
+ stage: 'START_COPY_STAGE_CREATE_REQUIRED',
+ startRequestId,
+ predictedCopyAccount,
+ requestedTargetRaw: targetCapitalRaw,
+ createAmountRaw: targetCapitalRaw,
+ },
+}
+
+const completedAction: PreparedAction = {
+ status: 'PREPARED_ACTION_STATUS_COMPLETED',
+ chainId: '8453',
+ expectedAccount: account,
+ copyAccount: predictedCopyAccount,
+ startCopy: {
+ stage: 'START_COPY_STAGE_COMPLETE',
+ startRequestId,
+ predictedCopyAccount,
+ requestedTargetRaw: targetCapitalRaw,
+ createAmountRaw: targetCapitalRaw,
+ },
+}
+
+const readyAction: PreparedAction = {
+ status: 'PREPARED_ACTION_STATUS_READY',
+ chainId: '8453',
+ expectedAccount: account,
+ startCopy: {
+ stage: 'START_COPY_STAGE_CREATE_REQUIRED',
+ startRequestId,
+ predictedCopyAccount,
+ requestedTargetRaw: targetCapitalRaw,
+ createAmountRaw: targetCapitalRaw,
+ },
+ call: {
+ kind: 'PREPARED_CALL_KIND_START_COPY_CREATE',
+ to: callTarget,
+ data: '0x',
+ valueRaw: '0',
+ },
+}
+
+const expiredAction: PreparedAction = {
+ ...readyAction,
+ reprepareAfter: '2020-01-01T00:00:00.000Z',
+}
+
+const createStateHarness = (initialState: PreparedActionFlowState = DEFAULT_PREPARED_ACTION_STATE) => {
+ let state = initialState
+ const setState: Dispatch> = update => {
+ state = typeof update === 'function' ? update(state) : update
+ }
+ return { getState: () => state, setState }
+}
+
+describe('usePreparedAction', () => {
+ it('keeps the current modal phase while the initial preparation is pending', async () => {
+ const harness = createStateHarness()
+ let resolvePreparation: (action: PreparedAction) => void = () => undefined
+ const prepare = vi
+ .fn<[], Promise>()
+ .mockImplementation(() => new Promise(resolve => (resolvePreparation = resolve)))
+ const flow = usePreparedAction({
+ state: harness.getState(),
+ setState: harness.setState,
+ expected,
+ prepare,
+ reviewUnavailable: action => action.reason === 'PREPARED_ACTION_REASON_INSUFFICIENT_QUOTE_ALLOWANCE',
+ })
+
+ const request = flow.prepare()
+
+ expect(harness.getState()).toEqual({ phase: 'idle', isPreparing: true })
+
+ resolvePreparation(allowanceDiagnostic)
+ await request
+
+ expect(harness.getState()).toEqual({ phase: 'review', action: allowanceDiagnostic })
+ })
+
+ it('fires the data refresh without waiting to show success', async () => {
+ const harness = createStateHarness()
+ let resolveRefresh: () => void = () => undefined
+ const onComplete = vi.fn(() => new Promise(resolve => (resolveRefresh = resolve)))
+ const flow = usePreparedAction({
+ state: harness.getState(),
+ setState: harness.setState,
+ expected,
+ prepare: vi.fn().mockResolvedValue(completedAction),
+ onComplete,
+ })
+
+ await flow.prepare()
+
+ expect(onComplete).toHaveBeenCalledOnce()
+ expect(harness.getState()).toEqual({ phase: 'success', action: completedAction })
+ resolveRefresh()
+ })
+
+ it('refreshes screen data when post-receipt synchronization is still pending', async () => {
+ const hash = `0x${'1'.repeat(64)}` as const
+ const harness = createStateHarness({ phase: 'sync_error', action: completedAction, hash, retryStage: 'sync' })
+ let rejectSynchronization: (error: Error) => void = () => undefined
+ const afterReceipt = vi.fn(() => new Promise((_resolve, reject) => (rejectSynchronization = reject)))
+ const onComplete = vi.fn()
+ const flow = usePreparedAction({
+ state: harness.getState(),
+ setState: harness.setState,
+ expected,
+ prepare: vi.fn(),
+ afterReceipt,
+ onComplete,
+ })
+
+ const request = flow.retry()
+
+ expect(afterReceipt).toHaveBeenCalledWith(completedAction, hash)
+ expect(onComplete).toHaveBeenCalledOnce()
+ expect(harness.getState()).toEqual({ phase: 'syncing', action: completedAction, hash })
+
+ rejectSynchronization(new Error('The new Copy is not available yet.'))
+ await request
+
+ expect(harness.getState()).toEqual({
+ phase: 'sync_error',
+ action: completedAction,
+ error: 'The new Copy is not available yet.',
+ hash,
+ retryStage: 'sync',
+ })
+ })
+
+ it('prepares a fresh call when retrying after a reverted transaction', async () => {
+ const hash = `0x${'2'.repeat(64)}` as const
+ const harness = createStateHarness({
+ phase: 'error',
+ action: readyAction,
+ error: 'The transaction reverted on-chain. Prepare a new call before trying again.',
+ hash,
+ })
+ const prepare = vi.fn().mockResolvedValue(readyAction)
+ const flow = usePreparedAction({
+ state: harness.getState(),
+ setState: harness.setState,
+ expected,
+ prepare,
+ })
+
+ await flow.retry()
+
+ expect(prepare).toHaveBeenCalledOnce()
+ expect(harness.getState()).toMatchObject({ phase: 'review', action: readyAction })
+ expect(harness.getState().hash).toBeUndefined()
+ })
+
+ it('uses the expired recovery state for an expired preparation', async () => {
+ const harness = createStateHarness()
+ const flow = usePreparedAction({
+ state: harness.getState(),
+ setState: harness.setState,
+ expected,
+ prepare: vi.fn().mockResolvedValue(expiredAction),
+ })
+
+ await flow.prepare()
+
+ expect(harness.getState()).toEqual({
+ phase: 'expired',
+ action: expiredAction,
+ error: 'This preparation has expired. Please try again.',
+ })
+ })
+
+ it('uses the expired recovery state when the review expires before confirmation', async () => {
+ const harness = createStateHarness({ phase: 'review', action: expiredAction })
+ const flow = usePreparedAction({
+ state: harness.getState(),
+ setState: harness.setState,
+ expected,
+ prepare: vi.fn(),
+ })
+
+ await flow.confirm()
+
+ expect(harness.getState()).toEqual({
+ phase: 'expired',
+ action: expiredAction,
+ error: 'This preparation has expired. Please try again.',
+ })
+ })
+
+ it.each([
+ {
+ phase: 'expired' as const,
+ action: expiredAction,
+ error: 'This preparation has expired. Please try again.',
+ },
+ { phase: 'error' as const, error: 'The request could not be completed.' },
+ ])('returns to an empty review with loading while retrying a $phase state', async initialState => {
+ const harness = createStateHarness(initialState)
+ let resolvePreparation: (action: PreparedAction) => void = () => undefined
+ const prepare = vi
+ .fn<[], Promise>()
+ .mockImplementation(() => new Promise(resolve => (resolvePreparation = resolve)))
+ const flow = usePreparedAction({
+ state: harness.getState(),
+ setState: harness.setState,
+ expected,
+ prepare,
+ })
+
+ const request = flow.retry()
+
+ expect(harness.getState()).toEqual({ phase: 'review', isPreparing: true })
+
+ resolvePreparation(readyAction)
+ await request
+
+ expect(harness.getState()).toEqual({ phase: 'review', action: readyAction })
+ })
+
+ it('keeps other unavailable actions in the recovery state', async () => {
+ const harness = createStateHarness()
+ const action: PreparedAction = {
+ ...allowanceDiagnostic,
+ reason: 'PREPARED_ACTION_REASON_CONTROLLER_PAUSED',
+ }
+ const flow = usePreparedAction({
+ state: harness.getState(),
+ setState: harness.setState,
+ expected,
+ prepare: vi.fn().mockResolvedValue(action),
+ reviewUnavailable: candidate => candidate.reason === 'PREPARED_ACTION_REASON_INSUFFICIENT_QUOTE_ALLOWANCE',
+ })
+
+ await flow.prepare()
+
+ expect(harness.getState()).toEqual({
+ phase: 'unavailable',
+ action,
+ error: 'Copy Trading actions are temporarily paused.',
+ })
+ })
+
+ it('discards a preparation response superseded by a newer request', async () => {
+ const harness = createStateHarness()
+ const firstAction = { ...allowanceDiagnostic, preparedAt: '2026-08-14T00:00:00Z' }
+ const secondAction = { ...allowanceDiagnostic, preparedAt: '2026-08-14T00:00:01Z' }
+ let resolveFirst: (action: PreparedAction) => void = () => undefined
+ let resolveSecond: (action: PreparedAction) => void = () => undefined
+ const prepare = vi
+ .fn<[], Promise>()
+ .mockImplementationOnce(() => new Promise(resolve => (resolveFirst = resolve)))
+ .mockImplementationOnce(() => new Promise(resolve => (resolveSecond = resolve)))
+ const flow = usePreparedAction({
+ state: harness.getState(),
+ setState: harness.setState,
+ expected,
+ prepare,
+ reviewUnavailable: action => action.reason === 'PREPARED_ACTION_REASON_INSUFFICIENT_QUOTE_ALLOWANCE',
+ })
+
+ const firstRequest = flow.prepare()
+ const secondRequest = flow.prepare()
+ resolveSecond(secondAction)
+ await secondRequest
+ expect(harness.getState()).toEqual({ phase: 'review', action: secondAction })
+
+ resolveFirst(firstAction)
+ await firstRequest
+ expect(harness.getState()).toEqual({ phase: 'review', action: secondAction })
+ })
+})
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/modals/PreparedActionModal/usePreparedAction.ts b/apps/kyberswap-interface/src/pages/CopyTrading/modals/PreparedActionModal/usePreparedAction.ts
new file mode 100644
index 0000000000..bdcd4f450c
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/modals/PreparedActionModal/usePreparedAction.ts
@@ -0,0 +1,228 @@
+import { getPublicClient } from '@wagmi/core'
+import type { PreparedAction } from 'services/copyTrading/types/preparedActions'
+
+import { wagmiConfig } from 'components/Web3Provider'
+import {
+ DEFAULT_PREPARED_ACTION_STATE,
+ type PreparedActionExpectation,
+ type PreparedActionFlowState,
+ type PreparedActionStateSetter,
+ getApiErrorMessage,
+ getReprepareDelay,
+ invalidatePreparationRequests,
+ isCurrentPreparationRequest,
+ isPreparationExpiredError,
+ validatePreparedAction,
+} from 'pages/CopyTrading/modals/PreparedActionModal/preparedAction'
+import {
+ type PreparationRequestOptions,
+ requestPreparation,
+} from 'pages/CopyTrading/modals/PreparedActionModal/requestPreparation'
+import type { Hash, Hex, Address as ViemAddress } from 'utils/viem'
+import { getGatedWalletClient } from 'utils/walletClient'
+
+type UsePreparedActionProps = {
+ state: PreparedActionFlowState
+ setState: PreparedActionStateSetter
+ expected: PreparedActionExpectation
+ prepare: () => Promise
+ reviewUnavailable?: (action: PreparedAction) => boolean
+ afterReceipt?: (action: PreparedAction, hash: Hash) => Promise | void
+ onComplete?: () => Promise | void
+}
+
+export const usePreparedAction = ({
+ state,
+ setState,
+ expected,
+ prepare,
+ reviewUnavailable,
+ afterReceipt,
+ onComplete,
+}: UsePreparedActionProps) => {
+ const notifyComplete = () => {
+ try {
+ void Promise.resolve(onComplete?.()).catch(() => undefined)
+ } catch {}
+ }
+
+ const finish = (action?: PreparedAction, hash?: Hash, preparationVersion?: number, shouldNotifyComplete = true) => {
+ if (preparationVersion !== undefined && !isCurrentPreparationRequest(setState, preparationVersion)) {
+ return
+ }
+ if (shouldNotifyComplete) notifyComplete()
+ if (preparationVersion !== undefined && !isCurrentPreparationRequest(setState, preparationVersion)) {
+ return
+ }
+
+ setState({ phase: 'success', action, hash })
+ }
+
+ const requestPreparedAction = (options?: PreparationRequestOptions) =>
+ requestPreparation(
+ {
+ expected,
+ finish,
+ prepare,
+ reviewUnavailable,
+ setState,
+ },
+ options,
+ )
+
+ const finishReceipt = async (action: PreparedAction, hash: Hash) => {
+ setState({ phase: 'syncing', action, hash })
+ notifyComplete()
+
+ if (!afterReceipt) {
+ finish(action, hash, undefined, false)
+ return
+ }
+
+ try {
+ await afterReceipt(action, hash)
+ finish(action, hash, undefined, false)
+ } catch (error) {
+ setState({
+ phase: 'sync_error',
+ action,
+ error: getApiErrorMessage(error),
+ hash,
+ retryStage: 'sync',
+ })
+ }
+ }
+
+ const confirmPreparedAction = async (preparedAction?: PreparedAction) => {
+ invalidatePreparationRequests(setState)
+ const action = preparedAction || state.action
+ const call = action?.call
+ if (!action || !call?.to || !call.data) {
+ setState({ phase: 'error', action, error: 'The prepared call is missing. Prepare the action again.' })
+ return
+ }
+
+ const validationError = validatePreparedAction(action, expected)
+ if (validationError) {
+ setState({
+ phase: isPreparationExpiredError(validationError) ? 'expired' : 'error',
+ action,
+ error: validationError,
+ })
+ return
+ }
+
+ let hash: Hash | undefined
+ try {
+ setState({ phase: 'awaiting_signature', action })
+ const publicClient = getPublicClient(wagmiConfig, { chainId: expected.chainId })
+ const walletClient = await getGatedWalletClient({ chainId: expected.chainId })
+ if (!publicClient || !walletClient) throw new Error('Wallet client is unavailable for the selected chain.')
+
+ const value = BigInt(call.valueRaw || '0')
+ await publicClient.call({
+ account: expected.account as ViemAddress,
+ to: call.to as ViemAddress,
+ data: call.data as Hex,
+ value,
+ })
+
+ const submittedHash = await walletClient.sendTransaction({
+ account: expected.account as ViemAddress,
+ chain: undefined,
+ to: call.to as ViemAddress,
+ data: call.data as Hex,
+ value,
+ })
+ hash = submittedHash
+
+ setState({ phase: 'confirming', action, hash: submittedHash })
+ const receipt = await publicClient.waitForTransactionReceipt({ hash: submittedHash })
+ if (receipt.status !== 'success') {
+ setState({
+ phase: 'error',
+ action,
+ error: 'The transaction reverted on-chain. Prepare a new call before trying again.',
+ hash: submittedHash,
+ })
+ return
+ }
+
+ await finishReceipt(action, submittedHash)
+ } catch (error) {
+ setState({
+ phase: hash ? 'sync_error' : 'error',
+ action,
+ error: hash
+ ? 'The transaction was submitted, but its receipt could not be confirmed. ' + getApiErrorMessage(error)
+ : getApiErrorMessage(error),
+ hash,
+ retryStage: hash ? 'receipt' : undefined,
+ })
+ }
+ }
+
+ const confirm = () => confirmPreparedAction()
+ const prepareAndConfirm = () => requestPreparedAction({ onReady: confirmPreparedAction })
+
+ const retryReceipt = async (action: PreparedAction, hash: Hash) => {
+ setState({ phase: 'confirming', action, hash })
+
+ try {
+ const publicClient = getPublicClient(wagmiConfig, { chainId: expected.chainId })
+ if (!publicClient) throw new Error('The public client is unavailable for the selected chain.')
+
+ const receipt = await publicClient.waitForTransactionReceipt({ hash })
+ if (receipt.status !== 'success') {
+ setState({
+ phase: 'error',
+ action,
+ error: 'The transaction reverted on-chain. Prepare a new call before trying again.',
+ hash,
+ })
+ return
+ }
+
+ await finishReceipt(action, hash)
+ } catch (error) {
+ setState({
+ phase: 'sync_error',
+ action,
+ error: getApiErrorMessage(error),
+ hash,
+ retryStage: 'receipt',
+ })
+ }
+ }
+
+ const retryPreparedAction = async (onReady?: (action: PreparedAction) => Promise | void) => {
+ if (state.phase === 'sync_error' && state.action && state.hash) {
+ if (state.retryStage === 'receipt') {
+ await retryReceipt(state.action, state.hash)
+ return
+ }
+
+ await finishReceipt(state.action, state.hash)
+ return
+ }
+
+ const continuation = state.phase === 'pending' && !!state.hash
+ await requestPreparedAction({
+ continuation,
+ delay: state.phase === 'pending' && state.action ? getReprepareDelay(state.action) : 0,
+ hash: continuation ? state.hash : undefined,
+ onReady: continuation ? undefined : onReady,
+ phaseWhilePreparing: !onReady && (state.phase === 'expired' || state.phase === 'error') ? 'review' : undefined,
+ })
+ }
+
+ const retry = () => retryPreparedAction()
+ const retryAndConfirm = () => retryPreparedAction(confirmPreparedAction)
+
+ const reset = () => {
+ invalidatePreparationRequests(setState)
+ setState(DEFAULT_PREPARED_ACTION_STATE)
+ }
+
+ return { confirm, prepare: requestPreparedAction, prepareAndConfirm, reset, retry, retryAndConfirm }
+}
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/modals/StartCopyModal/authorization.test.ts b/apps/kyberswap-interface/src/pages/CopyTrading/modals/StartCopyModal/authorization.test.ts
new file mode 100644
index 0000000000..9feb1f9e53
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/modals/StartCopyModal/authorization.test.ts
@@ -0,0 +1,142 @@
+import { Buffer } from 'buffer'
+import type { PreparedAction, StartCopyPermitScheme } from 'services/copyTrading/types/preparedActions'
+import { describe, expect, it } from 'vitest'
+
+import {
+ getStartCopyAllowanceAuthorization,
+ getStartCopyAuthorizationKind,
+} from 'pages/CopyTrading/modals/StartCopyModal/authorization'
+import {
+ buildStartCopyPermitTypedData,
+ encodeStartCopyPermitData,
+} from 'pages/CopyTrading/modals/StartCopyModal/permit'
+import { decodeAbiParameters, parseAbiParameters } from 'utils/viem'
+
+const OWNER = '0x1111111111111111111111111111111111111111'
+const TOKEN = '0x2222222222222222222222222222222222222222'
+const SPENDER = '0x3333333333333333333333333333333333333333'
+const SIGNATURE = `0x${'11'.repeat(32)}${'22'.repeat(32)}1b`
+
+const startCopyAction = (
+ permitScheme: StartCopyPermitScheme = 'START_COPY_PERMIT_SCHEME_ERC20_EIP2612',
+): PreparedAction => ({
+ status: 'PREPARED_ACTION_STATUS_UNAVAILABLE',
+ reason: 'PREPARED_ACTION_REASON_INSUFFICIENT_QUOTE_ALLOWANCE',
+ chainId: '8453',
+ expectedAccount: OWNER,
+ startCopy: {
+ stage: 'START_COPY_STAGE_CREATE_REQUIRED',
+ createAmountRaw: '50000000',
+ quoteToken: { chainId: '8453', address: TOKEN },
+ allowanceRequirement: {
+ spenderAddress: SPENDER,
+ currentAllowanceRaw: '0',
+ requiredAllowanceRaw: '50000000',
+ approvalScheme: 'START_COPY_APPROVAL_SCHEME_STANDARD',
+ permitScheme,
+ ...(permitScheme === 'START_COPY_PERMIT_SCHEME_ALLOWANCE_ONLY'
+ ? {}
+ : {
+ eip712DomainName: 'USD Coin',
+ eip712DomainVersion: '2',
+ eip712DomainKind: 'START_COPY_EIP712_DOMAIN_KIND_CHAIN_ID',
+ }),
+ },
+ },
+})
+
+describe('getStartCopyAllowanceAuthorization', () => {
+ it('accepts an operator-authored funded allowance requirement', () => {
+ expect(getStartCopyAllowanceAuthorization(startCopyAction())).toMatchObject({
+ approvalScheme: 'START_COPY_APPROVAL_SCHEME_STANDARD',
+ chainId: 8453,
+ permitScheme: 'START_COPY_PERMIT_SCHEME_ERC20_EIP2612',
+ quoteTokenAddress: TOKEN,
+ requiredAllowanceRaw: '50000000',
+ spenderAddress: SPENDER,
+ })
+ })
+
+ it('rejects a requirement whose allowance does not match the funded create amount', () => {
+ const action = startCopyAction()
+ if (action.startCopy?.allowanceRequirement) {
+ action.startCopy.allowanceRequirement.requiredAllowanceRaw = '49999999'
+ }
+
+ expect(() => getStartCopyAllowanceAuthorization(action)).toThrow('inconsistent allowance amounts')
+ })
+
+ it('labels permit-capable EOAs as Permit and approval fallbacks as Approve', () => {
+ expect(getStartCopyAuthorizationKind(startCopyAction(), false)).toBe('permit')
+ expect(getStartCopyAuthorizationKind(startCopyAction(), true)).toBe('approve')
+ expect(getStartCopyAuthorizationKind(startCopyAction('START_COPY_PERMIT_SCHEME_ALLOWANCE_ONLY'), false)).toBe(
+ 'approve',
+ )
+ })
+})
+
+describe('Start Copy permit encoding', () => {
+ it('builds and encodes the reviewed EIP-2612 five-argument payload', () => {
+ const authorization = getStartCopyAllowanceAuthorization(startCopyAction())
+ const typedData = buildStartCopyPermitTypedData({
+ account: OWNER,
+ authorization,
+ deadline: 2_000_000_000,
+ nonce: 7n,
+ })
+
+ expect(typedData).toMatchObject({
+ domain: { chainId: 8453, name: 'USD Coin', version: '2', verifyingContract: TOKEN },
+ message: { owner: OWNER, spender: SPENDER, value: '50000000', nonce: '7', deadline: 2_000_000_000 },
+ })
+
+ const base64 = encodeStartCopyPermitData({
+ authorization,
+ deadline: 2_000_000_000,
+ nonce: 7n,
+ rawSignature: SIGNATURE,
+ })
+ const permitHex = `0x${Buffer.from(base64, 'base64').toString('hex')}` as `0x${string}`
+ const decoded = decodeAbiParameters(parseAbiParameters('uint256, uint256, uint8, bytes32, bytes32'), permitHex)
+
+ expect(Buffer.from(base64, 'base64')).toHaveLength(160)
+ expect(decoded.slice(0, 3)).toEqual([50_000_000n, 2_000_000_000n, 27])
+ })
+
+ it('builds the salt domain and reviewed DAI-like six-argument payload', () => {
+ const action = startCopyAction('START_COPY_PERMIT_SCHEME_ERC20_DAI_LIKE')
+ if (action.startCopy?.allowanceRequirement) {
+ action.startCopy.allowanceRequirement.eip712DomainKind = 'START_COPY_EIP712_DOMAIN_KIND_CHAIN_ID_SALT'
+ }
+ const authorization = getStartCopyAllowanceAuthorization(action)
+ const typedData = buildStartCopyPermitTypedData({
+ account: OWNER,
+ authorization,
+ deadline: 2_000_000_000,
+ nonce: 9n,
+ })
+
+ expect(typedData.domain).toMatchObject({
+ name: 'USD Coin',
+ version: '2',
+ verifyingContract: TOKEN,
+ salt: `0x${'0'.repeat(60)}2105`,
+ })
+ expect(typedData.message).toMatchObject({ holder: OWNER, spender: SPENDER, nonce: '9', allowed: true })
+
+ const base64 = encodeStartCopyPermitData({
+ authorization,
+ deadline: 2_000_000_000,
+ nonce: 9n,
+ rawSignature: SIGNATURE,
+ })
+ const permitHex = `0x${Buffer.from(base64, 'base64').toString('hex')}` as `0x${string}`
+ const decoded = decodeAbiParameters(
+ parseAbiParameters('uint256, uint256, bool, uint8, bytes32, bytes32'),
+ permitHex,
+ )
+
+ expect(Buffer.from(base64, 'base64')).toHaveLength(192)
+ expect(decoded.slice(0, 4)).toEqual([9n, 2_000_000_000n, true, 27])
+ })
+})
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/modals/StartCopyModal/authorization.ts b/apps/kyberswap-interface/src/pages/CopyTrading/modals/StartCopyModal/authorization.ts
new file mode 100644
index 0000000000..6501a7d2d4
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/modals/StartCopyModal/authorization.ts
@@ -0,0 +1,180 @@
+import type {
+ PreparedAction,
+ StartCopyApprovalScheme,
+ StartCopyEip712DomainKind,
+ StartCopyPermitScheme,
+} from 'services/copyTrading/types/preparedActions'
+
+import { type Address, isAddress, maxUint256 } from 'utils/viem'
+
+type SupportedApprovalScheme = Extract<
+ StartCopyApprovalScheme,
+ 'START_COPY_APPROVAL_SCHEME_STANDARD' | 'START_COPY_APPROVAL_SCHEME_ZERO_THEN_SET'
+>
+
+type SupportedPermitScheme = Extract<
+ StartCopyPermitScheme,
+ | 'START_COPY_PERMIT_SCHEME_ALLOWANCE_ONLY'
+ | 'START_COPY_PERMIT_SCHEME_ERC20_EIP2612'
+ | 'START_COPY_PERMIT_SCHEME_ERC20_DAI_LIKE'
+>
+
+type PermitDomainKind = Extract<
+ StartCopyEip712DomainKind,
+ 'START_COPY_EIP712_DOMAIN_KIND_CHAIN_ID' | 'START_COPY_EIP712_DOMAIN_KIND_CHAIN_ID_SALT'
+>
+
+export type StartCopyAllowanceAuthorization = {
+ approvalScheme: SupportedApprovalScheme
+ chainId: number
+ createAmountRaw: string
+ currentAllowanceRaw: string
+ domainKind?: PermitDomainKind
+ domainName?: string
+ domainVersion?: string
+ permitScheme: SupportedPermitScheme
+ quoteTokenAddress: Address
+ requiredAllowanceRaw: string
+ spenderAddress: Address
+}
+
+export type StartCopyAuthorizationKind = 'approve' | 'permit'
+
+export const getStartCopyAuthorizationKind = (
+ action: PreparedAction,
+ requiresApprovalFallback: boolean,
+): StartCopyAuthorizationKind => {
+ const permitScheme = action.startCopy?.allowanceRequirement?.permitScheme
+ const supportsPermit =
+ permitScheme === 'START_COPY_PERMIT_SCHEME_ERC20_EIP2612' ||
+ permitScheme === 'START_COPY_PERMIT_SCHEME_ERC20_DAI_LIKE'
+
+ return supportsPermit && !requiresApprovalFallback ? 'permit' : 'approve'
+}
+
+const isUint256String = (value?: string) => !!value && /^\d{1,78}$/.test(value) && BigInt(value) <= maxUint256
+
+export const getStartCopyAllowanceAuthorization = (action: PreparedAction): StartCopyAllowanceAuthorization => {
+ if (
+ action.status !== 'PREPARED_ACTION_STATUS_UNAVAILABLE' ||
+ action.reason !== 'PREPARED_ACTION_REASON_INSUFFICIENT_QUOTE_ALLOWANCE'
+ ) {
+ throw new Error('The preparation does not require Start Copy token authorization.')
+ }
+ if (action.call) throw new Error('The unavailable Start Copy authorization unexpectedly returned a call.')
+
+ const chainId = Number(action.chainId)
+ const preview = action.startCopy
+ const requirement = preview?.allowanceRequirement
+
+ if (!Number.isSafeInteger(chainId) || chainId <= 0) {
+ throw new Error('The Start Copy authorization returned an invalid chain.')
+ }
+ if (preview?.stage !== 'START_COPY_STAGE_CREATE_REQUIRED' || !requirement) {
+ throw new Error('The Start Copy authorization returned an unexpected stage.')
+ }
+
+ const quoteTokenAddress = preview.quoteToken?.address
+ if (!isAddress(quoteTokenAddress || '')) {
+ throw new Error('The Start Copy authorization returned an invalid quote token.')
+ }
+ if (preview.quoteToken?.chainId && Number(preview.quoteToken.chainId) !== chainId) {
+ throw new Error('The Start Copy authorization quote token is on a different chain.')
+ }
+
+ const spenderAddress = requirement.spenderAddress
+ if (!isAddress(spenderAddress || '')) {
+ throw new Error('The Start Copy authorization returned an invalid spender.')
+ }
+
+ const createAmountRaw = preview.createAmountRaw
+ const currentAllowanceRaw = requirement.currentAllowanceRaw
+ const requiredAllowanceRaw = requirement.requiredAllowanceRaw
+ if (
+ !isUint256String(createAmountRaw) ||
+ !isUint256String(currentAllowanceRaw) ||
+ !isUint256String(requiredAllowanceRaw)
+ ) {
+ throw new Error('The Start Copy authorization returned inconsistent allowance amounts.')
+ }
+
+ const validatedCreateAmountRaw = createAmountRaw as string
+ const validatedCurrentAllowanceRaw = currentAllowanceRaw as string
+ const validatedRequiredAllowanceRaw = requiredAllowanceRaw as string
+
+ if (BigInt(validatedRequiredAllowanceRaw) === 0n || validatedRequiredAllowanceRaw !== validatedCreateAmountRaw) {
+ throw new Error('The Start Copy authorization returned inconsistent allowance amounts.')
+ }
+ if (BigInt(validatedCurrentAllowanceRaw) >= BigInt(validatedRequiredAllowanceRaw)) {
+ throw new Error('The Start Copy authorization reason conflicts with its allowance values.')
+ }
+
+ const approvalScheme = requirement.approvalScheme
+ if (
+ approvalScheme !== 'START_COPY_APPROVAL_SCHEME_STANDARD' &&
+ approvalScheme !== 'START_COPY_APPROVAL_SCHEME_ZERO_THEN_SET'
+ ) {
+ throw new Error('The Start Copy authorization returned an unsupported approval scheme.')
+ }
+
+ const permitScheme = requirement.permitScheme
+ if (
+ permitScheme !== 'START_COPY_PERMIT_SCHEME_ALLOWANCE_ONLY' &&
+ permitScheme !== 'START_COPY_PERMIT_SCHEME_ERC20_EIP2612' &&
+ permitScheme !== 'START_COPY_PERMIT_SCHEME_ERC20_DAI_LIKE'
+ ) {
+ throw new Error('The Start Copy authorization returned an unsupported permit scheme.')
+ }
+
+ const validatedApprovalScheme = approvalScheme as SupportedApprovalScheme
+ const validatedPermitScheme = permitScheme as SupportedPermitScheme
+ const validatedQuoteTokenAddress = quoteTokenAddress as Address
+ const validatedSpenderAddress = spenderAddress as Address
+
+ if (permitScheme === 'START_COPY_PERMIT_SCHEME_ALLOWANCE_ONLY') {
+ if (
+ requirement.eip712DomainName ||
+ requirement.eip712DomainVersion ||
+ (requirement.eip712DomainKind && requirement.eip712DomainKind !== 'START_COPY_EIP712_DOMAIN_KIND_UNSPECIFIED')
+ ) {
+ throw new Error('The allowance-only Start Copy authorization unexpectedly returned a permit domain.')
+ }
+
+ return {
+ approvalScheme: validatedApprovalScheme,
+ chainId,
+ createAmountRaw: validatedCreateAmountRaw,
+ currentAllowanceRaw: validatedCurrentAllowanceRaw,
+ permitScheme: validatedPermitScheme,
+ quoteTokenAddress: validatedQuoteTokenAddress,
+ requiredAllowanceRaw: validatedRequiredAllowanceRaw,
+ spenderAddress: validatedSpenderAddress,
+ }
+ }
+
+ if (!requirement.eip712DomainName || !requirement.eip712DomainVersion) {
+ throw new Error('The Start Copy permit authorization is missing its EIP-712 domain.')
+ }
+ if (
+ requirement.eip712DomainKind !== 'START_COPY_EIP712_DOMAIN_KIND_CHAIN_ID' &&
+ requirement.eip712DomainKind !== 'START_COPY_EIP712_DOMAIN_KIND_CHAIN_ID_SALT'
+ ) {
+ throw new Error('The Start Copy permit authorization returned an unsupported EIP-712 domain.')
+ }
+
+ const domainKind = requirement.eip712DomainKind as PermitDomainKind
+
+ return {
+ approvalScheme: validatedApprovalScheme,
+ chainId,
+ createAmountRaw: validatedCreateAmountRaw,
+ currentAllowanceRaw: validatedCurrentAllowanceRaw,
+ domainKind,
+ domainName: requirement.eip712DomainName,
+ domainVersion: requirement.eip712DomainVersion,
+ permitScheme: validatedPermitScheme,
+ quoteTokenAddress: validatedQuoteTokenAddress,
+ requiredAllowanceRaw: validatedRequiredAllowanceRaw,
+ spenderAddress: validatedSpenderAddress,
+ }
+}
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/modals/StartCopyModal/components.tsx b/apps/kyberswap-interface/src/pages/CopyTrading/modals/StartCopyModal/components.tsx
new file mode 100644
index 0000000000..fbef414deb
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/modals/StartCopyModal/components.tsx
@@ -0,0 +1,196 @@
+import { Token } from '@kyberswap/ks-sdk-core'
+import { Info } from 'react-feather'
+import type { PreparedToken, StartCopyPreview } from 'services/copyTrading/types/preparedActions'
+
+import verifiedIcon from 'assets/images/copy-trading/verified.svg'
+import { ButtonPrimary } from 'components/Button'
+import Checkbox from 'components/CheckBox'
+import CopyHelper from 'components/Copy'
+import Dots from 'components/Dots'
+import InfoHelper from 'components/InfoHelper'
+import { Center, HStack, Stack } from 'components/Stack'
+import { getAgentInitials } from 'pages/CopyTrading/helpers'
+import CapitalAmountInput from 'pages/CopyTrading/modals/CapitalAmount'
+import { type CapitalPercentage, type CapitalPreset } from 'pages/CopyTrading/modals/CapitalAmount/capital'
+import { ReviewRow, ReviewSection } from 'pages/CopyTrading/modals/PreparedActionModal'
+import { formatPreparedAmount, formatWadPercent } from 'pages/CopyTrading/modals/PreparedActionModal/preparedAction'
+import { type StartCopyTarget } from 'pages/CopyTrading/modals/StartCopyModal/startCopy'
+import { shortenAddress } from 'utils/address'
+
+const ReviewLabel = ({ label, tooltip }: { label: string; tooltip: string }) => (
+
+ {label}
+
+
+ {getAgentInitials(agent.displayName)}
+
+
+
+ }
+
+
+ •
+ {agent.modelName}
+ •
+ {shortenAddress(agent.chainId, agent.leaderAddress)}
+
+
+
+ )
+}
+
+type StartCopyReviewProps = {
+ agreed: boolean
+ confirmBalanceError?: string
+ isAuthorizing: boolean
+ isLoading: boolean
+ onAgreementChange: (agreed: boolean) => void
+ preparedToken?: PreparedToken
+ quoteToken?: PreparedToken
+ startPreview?: StartCopyPreview
+ targetCapitalRaw?: string
+}
+
+export const StartCopyReview = ({
+ agreed,
+ confirmBalanceError,
+ isAuthorizing,
+ isLoading,
+ onAgreementChange,
+ preparedToken,
+ quoteToken,
+ startPreview,
+ targetCapitalRaw,
+}: StartCopyReviewProps) => {
+ return (
+
+
+
+
+
+ {confirmBalanceError && (
+
+ {confirmBalanceError}
+
+ )}
+
+ )
+}
+
+type StartCopyFormProps = {
+ agent: StartCopyTarget
+ amount: string
+ amountError?: string
+ availabilityMessage?: string
+ isPreparing: boolean
+ onAmountChange: (amount: string) => void
+ onPercentageChange: (percentage: CapitalPercentage) => void
+ onPrimaryAction: () => void
+ presetAmounts?: CapitalPreset[]
+ presetsEnabled: boolean
+ primaryActionLabel: string
+ quoteCurrency?: Token
+ walletBalanceLoading?: boolean
+ walletBalanceText: string
+ amountIsValid: boolean
+ onExpectedChain: boolean
+ accountConnected: boolean
+}
+
+export const StartCopyForm = ({
+ accountConnected,
+ agent,
+ amount,
+ amountError,
+ amountIsValid,
+ availabilityMessage,
+ isPreparing,
+ onAmountChange,
+ onExpectedChain,
+ onPercentageChange,
+ onPrimaryAction,
+ presetAmounts,
+ presetsEnabled,
+ primaryActionLabel,
+ quoteCurrency,
+ walletBalanceLoading,
+ walletBalanceText,
+}: StartCopyFormProps) => {
+ return (
+
+
+
+
+
+ {isPreparing ? {primaryActionLabel} : primaryActionLabel}
+
+
+ )
+}
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/modals/StartCopyModal/index.tsx b/apps/kyberswap-interface/src/pages/CopyTrading/modals/StartCopyModal/index.tsx
new file mode 100644
index 0000000000..ee94fe3d01
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/modals/StartCopyModal/index.tsx
@@ -0,0 +1,80 @@
+import PreparedActionModal, { PreparedActionSuccessActions } from 'pages/CopyTrading/modals/PreparedActionModal'
+import { AgentHeader, StartCopyForm, StartCopyReview } from 'pages/CopyTrading/modals/StartCopyModal/components'
+import type { StartCopyTarget } from 'pages/CopyTrading/modals/StartCopyModal/startCopy'
+import { useStartCopyFlow } from 'pages/CopyTrading/modals/StartCopyModal/useStartCopyFlow'
+
+type StartCopyModalProps = {
+ isOpen: boolean
+ onDismiss: () => void
+ agent: StartCopyTarget
+}
+
+const StartCopyModal = ({ isOpen, onDismiss, agent }: StartCopyModalProps) => {
+ const flow = useStartCopyFlow({ agent, onDismiss })
+
+ const reviewPreparing = flow.flowState.phase === 'review' && flow.flowState.isPreparing === true
+
+ const review = (
+ {
+ flow.capital.setAmount(value)
+ flow.setAgreed(false)
+ }}
+ onExpectedChain={flow.capital.onExpectedChain}
+ onPercentageChange={flow.setPercentageAmount}
+ onPrimaryAction={flow.handlePrimaryAction}
+ presetAmounts={flow.capital.presetAmounts}
+ presetsEnabled={flow.capital.presetsEnabled}
+ primaryActionLabel={flow.primaryActionLabel}
+ quoteCurrency={flow.capital.quoteCurrency}
+ walletBalanceLoading={flow.capital.walletBalanceLoading}
+ walletBalanceText={flow.capital.walletBalanceText}
+ />
+
+ )
+}
+
+export default StartCopyModal
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/modals/StartCopyModal/permit.ts b/apps/kyberswap-interface/src/pages/CopyTrading/modals/StartCopyModal/permit.ts
new file mode 100644
index 0000000000..2aa50c5b7d
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/modals/StartCopyModal/permit.ts
@@ -0,0 +1,147 @@
+import { Buffer } from 'buffer'
+
+import type { StartCopyAllowanceAuthorization } from 'pages/CopyTrading/modals/StartCopyModal/authorization'
+import { type Address, encodeAbiParameters, isAddress, parseAbiParameters, parseSignature, toHex } from 'utils/viem'
+
+const EIP712_DOMAIN_TYPE = [
+ { name: 'name', type: 'string' },
+ { name: 'version', type: 'string' },
+ { name: 'chainId', type: 'uint256' },
+ { name: 'verifyingContract', type: 'address' },
+]
+
+const EIP712_DOMAIN_TYPE_SALT = [
+ { name: 'name', type: 'string' },
+ { name: 'version', type: 'string' },
+ { name: 'verifyingContract', type: 'address' },
+ { name: 'salt', type: 'bytes32' },
+]
+
+const EIP2612_PERMIT_TYPE = [
+ { name: 'owner', type: 'address' },
+ { name: 'spender', type: 'address' },
+ { name: 'value', type: 'uint256' },
+ { name: 'nonce', type: 'uint256' },
+ { name: 'deadline', type: 'uint256' },
+]
+
+const DAI_LIKE_PERMIT_TYPE = [
+ { name: 'holder', type: 'address' },
+ { name: 'spender', type: 'address' },
+ { name: 'nonce', type: 'uint256' },
+ { name: 'expiry', type: 'uint256' },
+ { name: 'allowed', type: 'bool' },
+]
+
+type PermitValues = {
+ account: Address
+ authorization: StartCopyAllowanceAuthorization
+ deadline: number
+ nonce: bigint
+}
+
+export const buildStartCopyPermitTypedData = ({ account, authorization, deadline, nonce }: PermitValues) => {
+ if (!isAddress(account) || !Number.isSafeInteger(deadline) || deadline <= 0 || nonce < 0n) {
+ throw new Error('The Start Copy permit values are invalid.')
+ }
+ if (
+ authorization.permitScheme === 'START_COPY_PERMIT_SCHEME_ALLOWANCE_ONLY' ||
+ !authorization.domainKind ||
+ !authorization.domainName ||
+ !authorization.domainVersion
+ ) {
+ throw new Error('This Start Copy authorization does not support a native permit.')
+ }
+
+ const domain =
+ authorization.domainKind === 'START_COPY_EIP712_DOMAIN_KIND_CHAIN_ID_SALT'
+ ? {
+ name: authorization.domainName,
+ version: authorization.domainVersion,
+ verifyingContract: authorization.quoteTokenAddress,
+ salt: toHex(authorization.chainId, { size: 32 }),
+ }
+ : {
+ name: authorization.domainName,
+ version: authorization.domainVersion,
+ chainId: authorization.chainId,
+ verifyingContract: authorization.quoteTokenAddress,
+ }
+ const EIP712Domain =
+ authorization.domainKind === 'START_COPY_EIP712_DOMAIN_KIND_CHAIN_ID_SALT'
+ ? EIP712_DOMAIN_TYPE_SALT
+ : EIP712_DOMAIN_TYPE
+
+ if (authorization.permitScheme === 'START_COPY_PERMIT_SCHEME_ERC20_EIP2612') {
+ return {
+ types: { EIP712Domain, Permit: EIP2612_PERMIT_TYPE },
+ domain,
+ primaryType: 'Permit',
+ message: {
+ owner: account,
+ spender: authorization.spenderAddress,
+ value: authorization.requiredAllowanceRaw,
+ nonce: nonce.toString(),
+ deadline,
+ },
+ }
+ }
+
+ return {
+ types: { EIP712Domain, Permit: DAI_LIKE_PERMIT_TYPE },
+ domain,
+ primaryType: 'Permit',
+ message: {
+ holder: account,
+ spender: authorization.spenderAddress,
+ nonce: nonce.toString(),
+ expiry: deadline,
+ allowed: true,
+ },
+ }
+}
+
+export const encodeStartCopyPermitData = ({
+ authorization,
+ deadline,
+ nonce,
+ rawSignature,
+}: Omit & { rawSignature: string }) => {
+ if (authorization.permitScheme === 'START_COPY_PERMIT_SCHEME_ALLOWANCE_ONLY') {
+ throw new Error('The allowance-only Start Copy flow cannot encode permit data.')
+ }
+
+ let signature: ReturnType
+ try {
+ signature = parseSignature(rawSignature as `0x${string}`)
+ } catch {
+ throw new Error('Invalid Start Copy permit signature.')
+ }
+
+ const v = Number(signature.v ?? (signature.yParity === 0 ? 27 : 28))
+ if (v !== 27 && v !== 28) throw new Error('Invalid Start Copy permit signature.')
+
+ const encoded =
+ authorization.permitScheme === 'START_COPY_PERMIT_SCHEME_ERC20_EIP2612'
+ ? encodeAbiParameters(parseAbiParameters('uint256, uint256, uint8, bytes32, bytes32'), [
+ BigInt(authorization.requiredAllowanceRaw),
+ BigInt(deadline),
+ v,
+ signature.r,
+ signature.s,
+ ])
+ : encodeAbiParameters(parseAbiParameters('uint256, uint256, bool, uint8, bytes32, bytes32'), [
+ nonce,
+ BigInt(deadline),
+ true,
+ v,
+ signature.r,
+ signature.s,
+ ])
+ const expectedByteLength = authorization.permitScheme === 'START_COPY_PERMIT_SCHEME_ERC20_EIP2612' ? 160 : 192
+ if ((encoded.length - 2) / 2 !== expectedByteLength) {
+ throw new Error('The Start Copy permit payload has an invalid length.')
+ }
+
+ return Buffer.from(encoded.slice(2), 'hex').toString('base64')
+}
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/modals/StartCopyModal/startCopy.test.ts b/apps/kyberswap-interface/src/pages/CopyTrading/modals/StartCopyModal/startCopy.test.ts
new file mode 100644
index 0000000000..b18a3edd72
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/modals/StartCopyModal/startCopy.test.ts
@@ -0,0 +1,87 @@
+import type { CopyRunSummary } from 'services/copyTrading/types/copyRuns'
+import type { CopyRunsResponse } from 'services/copyTrading/types/responses'
+import { describe, expect, it, vi } from 'vitest'
+
+import { pollStartCopyRun } from 'pages/CopyTrading/modals/StartCopyModal/startCopy'
+
+const ownerAddress = '0x1111111111111111111111111111111111111111'
+const agentId = 'agent-1'
+const chainId = 8453
+const pagination = { hasMore: false, limit: 1 }
+const copyRun = {
+ copyRunId: 'copy-run-1',
+ ownerAddress,
+ agentId,
+ chainId,
+} as CopyRunSummary
+
+const response = (data: CopyRunSummary[]): CopyRunsResponse => ({ data, pagination })
+
+describe('pollStartCopyRun', () => {
+ it('polls the agent-filtered Copy list until the new run is available', async () => {
+ const fetchCopyRuns = vi
+ .fn()
+ .mockResolvedValueOnce(response([]))
+ .mockResolvedValueOnce(response([copyRun]))
+ const waitForNextAttempt = vi.fn().mockResolvedValue(undefined)
+
+ await expect(
+ pollStartCopyRun({
+ agentId,
+ chainId,
+ fetchCopyRuns,
+ maxAttempts: 3,
+ ownerAddress,
+ pollIntervalMs: 25,
+ waitForNextAttempt,
+ }),
+ ).resolves.toBe(copyRun)
+
+ expect(fetchCopyRuns).toHaveBeenCalledTimes(2)
+ expect(waitForNextAttempt).toHaveBeenCalledOnce()
+ expect(waitForNextAttempt).toHaveBeenCalledWith(25)
+ })
+
+ it('polls every two seconds for a maximum twenty-second window by default', async () => {
+ const fetchCopyRuns = vi.fn().mockResolvedValue(response([]))
+ const waitForNextAttempt = vi.fn().mockResolvedValue(undefined)
+
+ await expect(
+ pollStartCopyRun({
+ agentId,
+ chainId,
+ fetchCopyRuns,
+ ownerAddress,
+ waitForNextAttempt,
+ }),
+ ).rejects.toThrow('new Copy is not available yet')
+
+ expect(fetchCopyRuns).toHaveBeenCalledTimes(11)
+ expect(waitForNextAttempt).toHaveBeenCalledTimes(10)
+ expect(waitForNextAttempt).toHaveBeenCalledWith(2_000)
+ })
+
+ it('continues bounded polling after any list failure without accepting a different agent run', async () => {
+ const anotherRun = { ...copyRun, agentId: 'agent-2' }
+ const fetchCopyRuns = vi
+ .fn()
+ .mockRejectedValueOnce(new Error('Network request failed.'))
+ .mockResolvedValueOnce(response([anotherRun]))
+ .mockResolvedValueOnce(response([copyRun]))
+ const waitForNextAttempt = vi.fn().mockResolvedValue(undefined)
+
+ await expect(
+ pollStartCopyRun({
+ agentId,
+ chainId,
+ fetchCopyRuns,
+ maxAttempts: 3,
+ ownerAddress,
+ waitForNextAttempt,
+ }),
+ ).resolves.toBe(copyRun)
+
+ expect(fetchCopyRuns).toHaveBeenCalledTimes(3)
+ expect(waitForNextAttempt).toHaveBeenCalledTimes(2)
+ })
+})
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/modals/StartCopyModal/startCopy.ts b/apps/kyberswap-interface/src/pages/CopyTrading/modals/StartCopyModal/startCopy.ts
new file mode 100644
index 0000000000..e5fd67e1a6
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/modals/StartCopyModal/startCopy.ts
@@ -0,0 +1,52 @@
+import type { AgentCard, AgentProfile } from 'services/copyTrading/types/agents'
+import type { CopyRunSummary } from 'services/copyTrading/types/copyRuns'
+import type { Address } from 'services/copyTrading/types/primitives'
+import type { CopyRunsResponse } from 'services/copyTrading/types/responses'
+
+import { wait } from 'pages/CopyTrading/modals/PreparedActionModal/preparedAction'
+
+export type StartCopyTarget = AgentCard | AgentProfile
+
+const START_COPY_POLL_INTERVAL_MS = 2_000
+const START_COPY_POLL_TIMEOUT_MS = 20_000
+const START_COPY_POLL_ATTEMPTS = START_COPY_POLL_TIMEOUT_MS / START_COPY_POLL_INTERVAL_MS + 1
+
+type PollStartCopyRunParams = {
+ agentId: string
+ chainId: number
+ fetchCopyRuns: () => Promise
+ maxAttempts?: number
+ ownerAddress: Address
+ pollIntervalMs?: number
+ waitForNextAttempt?: (milliseconds: number) => Promise
+}
+
+export const pollStartCopyRun = async ({
+ agentId,
+ chainId,
+ fetchCopyRuns,
+ maxAttempts = START_COPY_POLL_ATTEMPTS,
+ ownerAddress,
+ pollIntervalMs = START_COPY_POLL_INTERVAL_MS,
+ waitForNextAttempt = wait,
+}: PollStartCopyRunParams): Promise => {
+ const attempts = Math.max(1, maxAttempts)
+
+ for (let attempt = 0; attempt < attempts; attempt++) {
+ try {
+ const response = await fetchCopyRuns()
+ const copyRun = response.data.find(
+ run =>
+ !!run.copyRunId &&
+ run.agentId === agentId &&
+ run.chainId === chainId &&
+ run.ownerAddress.toLowerCase() === ownerAddress.toLowerCase(),
+ )
+ if (copyRun) return copyRun
+ } catch {}
+
+ if (attempt < attempts - 1) await waitForNextAttempt(pollIntervalMs)
+ }
+
+ throw new Error('Your transaction is confirmed, but the new Copy is not available yet. Refresh status to try again.')
+}
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/modals/StartCopyModal/useApproval.ts b/apps/kyberswap-interface/src/pages/CopyTrading/modals/StartCopyModal/useApproval.ts
new file mode 100644
index 0000000000..2d4eabb696
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/modals/StartCopyModal/useApproval.ts
@@ -0,0 +1,220 @@
+import { ChainId } from '@kyberswap/ks-sdk-core'
+import { getPublicClient, readContract } from '@wagmi/core'
+import { useCallback, useRef } from 'react'
+import type { PreparedAction } from 'services/copyTrading/types/preparedActions'
+
+import { wagmiConfig } from 'components/Web3Provider'
+import { useActiveWeb3React, useWeb3React } from 'hooks'
+import type { StartCopyAllowanceAuthorization } from 'pages/CopyTrading/modals/StartCopyModal/authorization'
+import { useAllTransactions, useTransactionAdder } from 'state/transactions/hooks'
+import { TRANSACTION_TYPE } from 'state/transactions/type'
+import { sendEVMTransaction } from 'utils/sendTransaction'
+import { ErrorName } from 'utils/transactionError'
+import { type Address, type Hash, encodeFunctionData, parseAbi } from 'utils/viem'
+
+export const START_COPY_TOKEN_ABI = parseAbi([
+ 'function allowance(address owner, address spender) view returns (uint256)',
+ 'function approve(address spender, uint256 amount) returns (bool)',
+ 'function nonces(address owner) view returns (uint256)',
+])
+
+const ALLOWANCE_REFRESH_ATTEMPTS = 6
+const ALLOWANCE_REFRESH_DELAY_MS = 750
+
+type PendingApproval = {
+ chainId: number
+ expectedAllowanceRaw: string
+ hash: Hash
+ ownerAddress: Address
+ spenderAddress: Address
+ tokenAddress: Address
+}
+
+type StartCopyApprovalExtra = {
+ arbitrary?: { startCopyApprovalAmountRaw?: unknown }
+ contract?: string
+ tokenAddress?: string
+}
+
+const wait = (milliseconds: number) => new Promise(resolve => setTimeout(resolve, milliseconds))
+
+export const useStartCopyApproval = () => {
+ const { account, chainId } = useActiveWeb3React()
+ const { isSmartConnector } = useWeb3React()
+ const addTransactionWithType = useTransactionAdder()
+ const allTransactions = useAllTransactions()
+ const pendingApprovalRef = useRef(undefined)
+
+ const recoverPendingApproval = useCallback(
+ (action: PreparedAction, authorization: StartCopyAllowanceAuthorization) => {
+ if (pendingApprovalRef.current || !account) return
+
+ const candidate = Object.values(allTransactions || {})
+ .flatMap(transactions => transactions || [])
+ .map(transaction => ({
+ transaction,
+ extraInfo: transaction.extraInfo as StartCopyApprovalExtra | undefined,
+ }))
+ .filter(
+ ({ transaction, extraInfo }) =>
+ !transaction.receipt &&
+ transaction.type === TRANSACTION_TYPE.APPROVE &&
+ transaction.chainId === authorization.chainId &&
+ extraInfo?.tokenAddress?.toLowerCase() === authorization.quoteTokenAddress.toLowerCase() &&
+ extraInfo?.contract?.toLowerCase() === authorization.spenderAddress.toLowerCase() &&
+ typeof extraInfo.arbitrary?.startCopyApprovalAmountRaw === 'string',
+ )
+ .sort((a, b) => b.transaction.addedTime - a.transaction.addedTime)[0]
+
+ const expectedAllowanceRaw = candidate?.extraInfo?.arbitrary?.startCopyApprovalAmountRaw
+ if (!candidate || typeof expectedAllowanceRaw !== 'string') return
+
+ pendingApprovalRef.current = {
+ chainId: authorization.chainId,
+ expectedAllowanceRaw,
+ hash: candidate.transaction.hash as Hash,
+ ownerAddress: account as Address,
+ spenderAddress: authorization.spenderAddress,
+ tokenAddress: authorization.quoteTokenAddress,
+ }
+ },
+ [account, allTransactions],
+ )
+
+ const readAllowance = useCallback(
+ async (tokenAddress: Address, ownerAddress: Address, spenderAddress: Address) => {
+ return (await readContract(wagmiConfig, {
+ address: tokenAddress,
+ abi: START_COPY_TOKEN_ABI,
+ functionName: 'allowance',
+ args: [ownerAddress, spenderAddress],
+ chainId: chainId as number,
+ })) as bigint
+ },
+ [chainId],
+ )
+
+ const waitForAllowance = useCallback(
+ async (
+ tokenAddress: Address,
+ ownerAddress: Address,
+ spenderAddress: Address,
+ predicate: (allowance: bigint) => boolean,
+ ) => {
+ for (let attempt = 0; attempt < ALLOWANCE_REFRESH_ATTEMPTS; attempt++) {
+ const allowance = await readAllowance(tokenAddress, ownerAddress, spenderAddress)
+ if (predicate(allowance)) return allowance
+ if (attempt < ALLOWANCE_REFRESH_ATTEMPTS - 1) await wait(ALLOWANCE_REFRESH_DELAY_MS)
+ }
+
+ throw new Error('The token allowance has not updated on-chain yet. Check its confirmation before trying again.')
+ },
+ [readAllowance],
+ )
+
+ const confirmPendingApproval = useCallback(
+ async (action: PreparedAction) => {
+ const pending = pendingApprovalRef.current
+ if (!pending) return
+ if (pending.chainId !== Number(action.chainId) || pending.ownerAddress.toLowerCase() !== account?.toLowerCase()) {
+ throw new Error('A token approval from another Start Copy attempt is still awaiting confirmation.')
+ }
+
+ const publicClient = getPublicClient(wagmiConfig, { chainId: pending.chainId })
+ if (!publicClient) throw new Error('The public client is unavailable for the selected chain.')
+
+ const receipt = await publicClient.waitForTransactionReceipt({ hash: pending.hash })
+ if (receipt.status !== 'success') {
+ pendingApprovalRef.current = undefined
+ throw new Error('The token approval reverted on-chain.')
+ }
+
+ const expectedAllowance = BigInt(pending.expectedAllowanceRaw)
+ await waitForAllowance(
+ pending.tokenAddress,
+ pending.ownerAddress,
+ pending.spenderAddress,
+ allowance => allowance === expectedAllowance || (expectedAllowance > 0n && allowance >= expectedAllowance),
+ )
+ pendingApprovalRef.current = undefined
+ },
+ [account, waitForAllowance],
+ )
+
+ const syncPendingApproval = useCallback(
+ async (action: PreparedAction, authorization: StartCopyAllowanceAuthorization) => {
+ recoverPendingApproval(action, authorization)
+ await confirmPendingApproval(action)
+ },
+ [confirmPendingApproval, recoverPendingApproval],
+ )
+
+ const approve = useCallback(
+ async ({
+ action,
+ authorization,
+ currentAllowance,
+ ownerAddress,
+ }: {
+ action: PreparedAction
+ authorization: StartCopyAllowanceAuthorization
+ currentAllowance: bigint
+ ownerAddress: Address
+ }) => {
+ const submitApproval = async (allowance: bigint) => {
+ const result = await sendEVMTransaction({
+ account: ownerAddress,
+ contractAddress: authorization.quoteTokenAddress,
+ encodedData: encodeFunctionData({
+ abi: START_COPY_TOKEN_ABI,
+ functionName: 'approve',
+ args: [authorization.spenderAddress, allowance],
+ }),
+ value: 0n,
+ errorInfo: { name: ErrorName.SwapError, wallet: undefined },
+ isSmartConnector,
+ chainId: authorization.chainId as ChainId,
+ })
+ if (!result?.hash) throw new Error('The token approval was not submitted.')
+
+ const hash = result.hash as Hash
+ pendingApprovalRef.current = {
+ chainId: authorization.chainId,
+ expectedAllowanceRaw: allowance.toString(),
+ hash,
+ ownerAddress,
+ spenderAddress: authorization.spenderAddress,
+ tokenAddress: authorization.quoteTokenAddress,
+ }
+
+ void addTransactionWithType({
+ hash,
+ desiredChainId: authorization.chainId as ChainId,
+ type: TRANSACTION_TYPE.APPROVE,
+ extraInfo: {
+ tokenAddress: authorization.quoteTokenAddress,
+ tokenSymbol: action.startCopy?.quoteToken?.symbol || '',
+ contract: authorization.spenderAddress,
+ arbitrary: { startCopyApprovalAmountRaw: allowance.toString() },
+ },
+ })
+ await confirmPendingApproval(action)
+ }
+
+ if (authorization.approvalScheme === 'START_COPY_APPROVAL_SCHEME_ZERO_THEN_SET' && currentAllowance > 0n) {
+ await submitApproval(0n)
+ }
+
+ const refreshedAllowance = await readAllowance(
+ authorization.quoteTokenAddress,
+ ownerAddress,
+ authorization.spenderAddress,
+ )
+ const requiredAllowance = BigInt(authorization.requiredAllowanceRaw)
+ if (refreshedAllowance < requiredAllowance) await submitApproval(requiredAllowance)
+ },
+ [addTransactionWithType, confirmPendingApproval, isSmartConnector, readAllowance],
+ )
+
+ return { approve, isSmartConnector, readAllowance, syncPendingApproval }
+}
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/modals/StartCopyModal/useAuthorization.ts b/apps/kyberswap-interface/src/pages/CopyTrading/modals/StartCopyModal/useAuthorization.ts
new file mode 100644
index 0000000000..393fdb1f34
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/modals/StartCopyModal/useAuthorization.ts
@@ -0,0 +1,98 @@
+import { readContract } from '@wagmi/core'
+import { useCallback } from 'react'
+import type { PreparedAction } from 'services/copyTrading/types/preparedActions'
+
+import { wagmiConfig } from 'components/Web3Provider'
+import { useActiveWeb3React } from 'hooks'
+import { useIsSmartAccount } from 'hooks/useIsSmartAccount'
+import {
+ getStartCopyAllowanceAuthorization,
+ getStartCopyAuthorizationKind,
+} from 'pages/CopyTrading/modals/StartCopyModal/authorization'
+import {
+ buildStartCopyPermitTypedData,
+ encodeStartCopyPermitData,
+} from 'pages/CopyTrading/modals/StartCopyModal/permit'
+import { START_COPY_TOKEN_ABI, useStartCopyApproval } from 'pages/CopyTrading/modals/StartCopyModal/useApproval'
+import { type Address } from 'utils/viem'
+import { signTypedDataRaw } from 'utils/walletClient'
+
+const PERMIT_VALIDITY_SECONDS = 24 * 60 * 60
+
+export const useStartCopyAuthorization = () => {
+ const { account, chainId } = useActiveWeb3React()
+ const isSmartAccount = useIsSmartAccount()
+ const approval = useStartCopyApproval()
+
+ const requiresApprovalFallback = approval.isSmartConnector || isSmartAccount
+ const getAuthorizationKind = useCallback(
+ (action: PreparedAction) => getStartCopyAuthorizationKind(action, requiresApprovalFallback),
+ [requiresApprovalFallback],
+ )
+
+ const authorize = useCallback(
+ async (action: PreparedAction) => {
+ if (!account || action.expectedAccount?.toLowerCase() !== account.toLowerCase()) {
+ throw new Error('The Start Copy authorization sender does not match your wallet.')
+ }
+
+ const authorization = getStartCopyAllowanceAuthorization(action)
+ const authorizationKind = getAuthorizationKind(action)
+ if (chainId !== authorization.chainId) {
+ throw new Error('Switch to the prepared chain before authorizing the quote token.')
+ }
+
+ await approval.syncPendingApproval(action, authorization)
+
+ const ownerAddress = account as Address
+ const currentAllowance = await approval.readAllowance(
+ authorization.quoteTokenAddress,
+ ownerAddress,
+ authorization.spenderAddress,
+ )
+ const requiredAllowance = BigInt(authorization.requiredAllowanceRaw)
+ if (currentAllowance >= requiredAllowance) return undefined
+
+ if (authorizationKind === 'permit') {
+ const nonce = (await readContract(wagmiConfig, {
+ address: authorization.quoteTokenAddress,
+ abi: START_COPY_TOKEN_ABI,
+ functionName: 'nonces',
+ args: [ownerAddress],
+ chainId: authorization.chainId,
+ })) as bigint
+ const deadline = Math.floor(Date.now() / 1000) + PERMIT_VALIDITY_SECONDS
+ const typedData = buildStartCopyPermitTypedData({
+ account: ownerAddress,
+ authorization,
+ deadline,
+ nonce,
+ })
+ const rawSignature = await signTypedDataRaw({
+ account: ownerAddress,
+ chainId: authorization.chainId,
+ typedData,
+ })
+
+ return encodeStartCopyPermitData({
+ authorization,
+ deadline,
+ nonce,
+ rawSignature,
+ })
+ }
+
+ await approval.approve({
+ action,
+ authorization,
+ currentAllowance,
+ ownerAddress,
+ })
+
+ return undefined
+ },
+ [account, approval, chainId, getAuthorizationKind],
+ )
+
+ return { authorize, getAuthorizationKind }
+}
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/modals/StartCopyModal/useStartCopyAttempt.ts b/apps/kyberswap-interface/src/pages/CopyTrading/modals/StartCopyModal/useStartCopyAttempt.ts
new file mode 100644
index 0000000000..d81be6d0e0
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/modals/StartCopyModal/useStartCopyAttempt.ts
@@ -0,0 +1,170 @@
+import { useRef, useState } from 'react'
+import type {
+ PrepareStartCopyRequest,
+ PrepareStartCopyResponse,
+ PreparedAction,
+ PreparedCallKind,
+} from 'services/copyTrading/types/preparedActions'
+import { v4 as uuidv4 } from 'uuid'
+
+import type { PreparedActionExpectation } from 'pages/CopyTrading/modals/PreparedActionModal/preparedAction'
+import type { StartCopyTarget } from 'pages/CopyTrading/modals/StartCopyModal/startCopy'
+
+const START_CALL_KINDS: PreparedCallKind[] = ['PREPARED_CALL_KIND_START_COPY_CREATE']
+const START_FUNDING_MODE = 'START_COPY_FUNDING_MODE_FUNDED' as const
+
+type StartCopyAttempt = {
+ agentId?: string
+ authorizationApplied: boolean
+ chainId?: number
+ createPermitData?: string
+ ownerAddress?: string
+ requestId: string
+ targetCapitalRaw?: string
+}
+
+type PrepareStartCopy = (request: PrepareStartCopyRequest) => {
+ unwrap: () => Promise
+}
+
+const createStartCopyAttempt = (): StartCopyAttempt => ({
+ authorizationApplied: false,
+ requestId: uuidv4(),
+})
+
+type StartCopyAuthorizationAction = PreparedAction & {
+ reason: 'PREPARED_ACTION_REASON_INSUFFICIENT_QUOTE_ALLOWANCE'
+ status: 'PREPARED_ACTION_STATUS_UNAVAILABLE'
+}
+
+export const requiresStartCopyAuthorization = (action?: PreparedAction): action is StartCopyAuthorizationAction =>
+ action?.status === 'PREPARED_ACTION_STATUS_UNAVAILABLE' &&
+ action.reason === 'PREPARED_ACTION_REASON_INSUFFICIENT_QUOTE_ALLOWANCE'
+
+export const useStartCopyAttempt = ({
+ account,
+ agent,
+ prepareStartCopy,
+ targetCapitalRaw,
+}: {
+ account?: string
+ agent: StartCopyTarget
+ prepareStartCopy: PrepareStartCopy
+ targetCapitalRaw?: string
+}) => {
+ const [predictedCopyAccount, setPredictedCopyAccount] = useState()
+ const attemptRef = useRef(createStartCopyAttempt())
+ const expectedRef = useRef({
+ account: account || '',
+ callKinds: START_CALL_KINDS,
+ chainId: agent.chainId,
+ preview: 'startCopy',
+ })
+
+ expectedRef.current.account = account || ''
+ expectedRef.current.chainId = agent.chainId
+ expectedRef.current.startCopyCreateAmountRaw = targetCapitalRaw
+ expectedRef.current.startCopyPredictedAccount = predictedCopyAccount
+ expectedRef.current.startCopyRequestId = attemptRef.current.requestId
+ expectedRef.current.startCopyTargetRaw = targetCapitalRaw
+
+ const resetStartAttempt = () => {
+ const nextAttempt = createStartCopyAttempt()
+ attemptRef.current = nextAttempt
+ expectedRef.current.startCopyRequestId = nextAttempt.requestId
+ }
+
+ const resetAttemptState = () => {
+ setPredictedCopyAccount(undefined)
+ resetStartAttempt()
+ }
+
+ const getScopedStartAttempt = (ownerAddress: string, targetRaw: string) => {
+ const currentAttempt = attemptRef.current
+ const scopeChanged =
+ (currentAttempt.ownerAddress && currentAttempt.ownerAddress !== ownerAddress.toLowerCase()) ||
+ (currentAttempt.agentId && currentAttempt.agentId !== agent.agentId) ||
+ (currentAttempt.chainId && currentAttempt.chainId !== agent.chainId) ||
+ (currentAttempt.targetCapitalRaw && currentAttempt.targetCapitalRaw !== targetRaw)
+
+ if (scopeChanged) {
+ resetAttemptState()
+ expectedRef.current.startCopyPredictedAccount = undefined
+ }
+
+ const scopedAttempt = {
+ ...attemptRef.current,
+ agentId: agent.agentId,
+ chainId: agent.chainId,
+ ownerAddress: ownerAddress.toLowerCase(),
+ targetCapitalRaw: targetRaw,
+ }
+ attemptRef.current = scopedAttempt
+ return scopedAttempt
+ }
+
+ const capturePredictedCopyAccount = (nextPredictedCopyAccount?: string) => {
+ const expectedPredictedCopyAccount = expectedRef.current.startCopyPredictedAccount
+ if (
+ expectedPredictedCopyAccount &&
+ nextPredictedCopyAccount?.toLowerCase() !== expectedPredictedCopyAccount.toLowerCase()
+ ) {
+ throw new Error('The prepared Start Copy Smart Wallet changed during this attempt.')
+ }
+
+ if (!expectedPredictedCopyAccount && nextPredictedCopyAccount) {
+ expectedRef.current.startCopyPredictedAccount = nextPredictedCopyAccount
+ setPredictedCopyAccount(nextPredictedCopyAccount)
+ }
+ }
+
+ const requestStartCopy = (attempt: StartCopyAttempt, ownerAddress: string, targetRaw: string) =>
+ prepareStartCopy({
+ ownerAddress: ownerAddress.toLowerCase(),
+ agentId: agent.agentId,
+ chainId: String(agent.chainId),
+ targetCapitalRaw: targetRaw,
+ startRequestId: attempt.requestId,
+ fundingMode: START_FUNDING_MODE,
+ ...(attempt.createPermitData ? { createPermitData: attempt.createPermitData } : {}),
+ }).unwrap()
+
+ const createAuthorizedAttempt = ({
+ createPermitData,
+ ownerAddress,
+ targetRaw,
+ }: {
+ createPermitData?: string
+ ownerAddress: string
+ targetRaw: string
+ }) => {
+ const authorizedAttempt: StartCopyAttempt = {
+ agentId: agent.agentId,
+ authorizationApplied: true,
+ chainId: agent.chainId,
+ createPermitData,
+ ownerAddress: ownerAddress.toLowerCase(),
+ requestId: uuidv4(),
+ targetCapitalRaw: targetRaw,
+ }
+
+ setPredictedCopyAccount(undefined)
+ expectedRef.current.startCopyPredictedAccount = undefined
+ attemptRef.current = authorizedAttempt
+ expectedRef.current.startCopyRequestId = authorizedAttempt.requestId
+
+ return authorizedAttempt
+ }
+
+ return {
+ attemptRef,
+ capturePredictedCopyAccount,
+ createAuthorizedAttempt,
+ expected: expectedRef.current,
+ getScopedStartAttempt,
+ predictedCopyAccount,
+ requestStartCopy,
+ resetAttemptState,
+ resetStartAttempt,
+ }
+}
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/modals/StartCopyModal/useStartCopyFlow.ts b/apps/kyberswap-interface/src/pages/CopyTrading/modals/StartCopyModal/useStartCopyFlow.ts
new file mode 100644
index 0000000000..511408ac78
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/modals/StartCopyModal/useStartCopyFlow.ts
@@ -0,0 +1,278 @@
+import { ChainId } from '@kyberswap/ks-sdk-core'
+import { useState } from 'react'
+import { useNavigate } from 'react-router-dom'
+import copyRunApi from 'services/copyTrading/api/endpoints/copyRuns'
+import preparedActionApi from 'services/copyTrading/api/endpoints/preparedActions'
+import type { CopyRunSummary } from 'services/copyTrading/types/copyRuns'
+
+import { APP_PATHS } from 'constants/index'
+import { useActiveWeb3React } from 'hooks'
+import { useChangeNetwork } from 'hooks/web3/useChangeNetwork'
+import { getPreparedReasonMessage, isActionAvailable } from 'pages/CopyTrading/helpers'
+import useRefreshCopyTrading from 'pages/CopyTrading/hooks/useRefreshCopyTrading'
+import { type CapitalPercentage } from 'pages/CopyTrading/modals/CapitalAmount/capital'
+import { useCapitalAmount } from 'pages/CopyTrading/modals/CapitalAmount/useCapitalAmount'
+import {
+ DEFAULT_PREPARED_ACTION_STATE,
+ getApiErrorMessage,
+ validatePreparedAction,
+} from 'pages/CopyTrading/modals/PreparedActionModal/preparedAction'
+import { usePreparedAction } from 'pages/CopyTrading/modals/PreparedActionModal/usePreparedAction'
+import { type StartCopyTarget, pollStartCopyRun } from 'pages/CopyTrading/modals/StartCopyModal/startCopy'
+import { useStartCopyAuthorization } from 'pages/CopyTrading/modals/StartCopyModal/useAuthorization'
+import {
+ requiresStartCopyAuthorization,
+ useStartCopyAttempt,
+} from 'pages/CopyTrading/modals/StartCopyModal/useStartCopyAttempt'
+import { useWalletModalToggle } from 'state/application/hooks'
+
+export const useStartCopyFlow = ({ agent, onDismiss }: { agent: StartCopyTarget; onDismiss: () => void }) => {
+ const navigate = useNavigate()
+ const { account, chainId } = useActiveWeb3React()
+ const { changeNetwork } = useChangeNetwork()
+ const toggleWalletModal = useWalletModalToggle()
+ const refreshCopyTrading = useRefreshCopyTrading()
+ const [prepareStartCopy] = preparedActionApi.usePrepareStartCopyMutation()
+ const [getCopyRuns] = copyRunApi.useLazyGetCopyRunsQuery()
+ const { authorize: authorizeStartCopy, getAuthorizationKind } = useStartCopyAuthorization()
+
+ const [flowState, setFlowState] = useState(DEFAULT_PREPARED_ACTION_STATE)
+ const [agreed, setAgreed] = useState(false)
+ const [createdCopyRun, setCreatedCopyRun] = useState()
+ const [isAuthorizing, setIsAuthorizing] = useState(false)
+
+ const capital = useCapitalAmount({
+ account: account || undefined,
+ action: 'startCopy',
+ connectedChainId: chainId,
+ targetChainId: agent.chainId,
+ })
+ const attempt = useStartCopyAttempt({
+ account: account || undefined,
+ agent,
+ prepareStartCopy,
+ targetCapitalRaw: capital.amountRaw,
+ })
+
+ const flow = usePreparedAction({
+ state: flowState,
+ setState: setFlowState,
+ expected: attempt.expected,
+ prepare: async () => {
+ if (!account || !capital.quoteToken) throw new Error('Connect a supported wallet and network first.')
+ if (!capital.amountRaw) throw new Error('Enter an amount greater than zero.')
+ if (capital.amountError) throw new Error(capital.amountError)
+
+ const scopedAttempt = attempt.getScopedStartAttempt(account, capital.amountRaw)
+ const response = await attempt.requestStartCopy(scopedAttempt, account, capital.amountRaw)
+ const action = response.data
+
+ if (
+ [
+ 'PREPARED_ACTION_STATUS_READY',
+ 'PREPARED_ACTION_STATUS_PARTIALLY_COMPLETED',
+ 'PREPARED_ACTION_STATUS_COMPLETED',
+ 'PREPARED_ACTION_STATUS_PENDING',
+ ].includes(action.status || '') &&
+ action.startCopy?.requestedTargetRaw !== capital.amountRaw
+ ) {
+ throw new Error('The prepared target does not match your requested capital amount.')
+ }
+ if (!requiresStartCopyAuthorization(action)) {
+ attempt.capturePredictedCopyAccount(action.startCopy?.predictedCopyAccount)
+ }
+
+ return action
+ },
+ reviewUnavailable: action =>
+ requiresStartCopyAuthorization(action) && !attempt.attemptRef.current.authorizationApplied,
+ afterReceipt: async action => {
+ setAgreed(false)
+ const ownerAddress = action.expectedAccount
+ if (!ownerAddress) throw new Error('The confirmed Start Copy action is missing its owner wallet.')
+
+ const copyRun = await pollStartCopyRun({
+ agentId: agent.agentId,
+ chainId: agent.chainId,
+ ownerAddress,
+ fetchCopyRuns: () =>
+ getCopyRuns({
+ ownerAddress,
+ view: 'open',
+ agentId: agent.agentId,
+ chainId: agent.chainId,
+ limit: 1,
+ }).unwrap(),
+ })
+ setCreatedCopyRun(copyRun)
+ },
+ onComplete: refreshCopyTrading,
+ })
+
+ const startPreview = flowState.action?.startCopy
+ const authorizationKind = requiresStartCopyAuthorization(flowState.action)
+ ? getAuthorizationKind(flowState.action)
+ : undefined
+
+ const preparedWalletBalanceRaw = startPreview?.walletQuoteBalance?.valueRaw
+ const requiredWalletBalanceRaw = startPreview?.remainingTargetDeficit?.valueRaw || capital.amountRaw
+ const preparedBalanceIsInsufficient =
+ !!requiredWalletBalanceRaw &&
+ !!preparedWalletBalanceRaw &&
+ BigInt(requiredWalletBalanceRaw) > BigInt(preparedWalletBalanceRaw)
+ const confirmBalanceError =
+ capital.amountError ||
+ (preparedBalanceIsInsufficient
+ ? 'Insufficient ' + (capital.quoteToken?.symbol || 'quote token') + ' balance.'
+ : undefined)
+
+ const availabilityMessage = !isActionAvailable(agent.startCopyAvailability)
+ ? getPreparedReasonMessage(agent.startCopyAvailability?.reason)
+ : undefined
+ const primaryActionLabel = !account
+ ? 'Connect wallet'
+ : !capital.onExpectedChain
+ ? 'Switch network'
+ : availabilityMessage || !capital.quoteToken
+ ? 'Start Copy unavailable'
+ : 'Next'
+
+ const resetPreparedState = () => {
+ flow.reset()
+ setAgreed(false)
+ setCreatedCopyRun(undefined)
+ setIsAuthorizing(false)
+ attempt.resetAttemptState()
+ }
+
+ const dismiss = () => {
+ resetPreparedState()
+ capital.setAmount('')
+ onDismiss()
+ }
+
+ const handlePrimaryAction = () => {
+ if (!account) {
+ toggleWalletModal()
+ return
+ }
+ if (!capital.onExpectedChain) {
+ void changeNetwork(agent.chainId as ChainId)
+ return
+ }
+ if (!capital.amountIsValid) return
+
+ void flow.prepare()
+ }
+
+ const setPercentageAmount = (percentage: CapitalPercentage) => {
+ const preset = capital.getPreset(percentage)
+ if (flowState.isPreparing || !capital.presetsEnabled || !preset) return
+
+ capital.setAmount(preset.amount)
+ setAgreed(false)
+ }
+
+ const confirmStartCopy = async () => {
+ if (!agreed || confirmBalanceError || isAuthorizing) return
+
+ const diagnosticAction = flowState.action
+ if (!requiresStartCopyAuthorization(diagnosticAction)) {
+ await flow.confirm()
+ return
+ }
+
+ if (!account || !capital.quoteToken || !capital.amountRaw) {
+ setFlowState({
+ phase: 'error',
+ action: diagnosticAction,
+ error: 'Connect a supported wallet and network first.',
+ })
+ return
+ }
+
+ try {
+ setIsAuthorizing(true)
+ const validationError = validatePreparedAction(diagnosticAction, attempt.expected, { requireCall: false })
+ if (validationError) throw new Error(validationError)
+
+ const createPermitData = await authorizeStartCopy(diagnosticAction)
+ const authorizedAttempt = attempt.createAuthorizedAttempt({
+ createPermitData,
+ ownerAddress: account,
+ targetRaw: capital.amountRaw,
+ })
+ const response = await attempt.requestStartCopy(authorizedAttempt, account, capital.amountRaw)
+ const action = response.data
+
+ if (action.startCopy?.requestedTargetRaw !== capital.amountRaw) {
+ throw new Error('The prepared target does not match your requested capital amount.')
+ }
+ if (action.status !== 'PREPARED_ACTION_STATUS_READY') {
+ const nextValidationError = validatePreparedAction(action, attempt.expected, { requireCall: false })
+ if (nextValidationError) throw new Error(nextValidationError)
+
+ setFlowState({
+ phase: action.status === 'PREPARED_ACTION_STATUS_UNAVAILABLE' ? 'unavailable' : 'error',
+ action,
+ error:
+ action.status === 'PREPARED_ACTION_STATUS_UNAVAILABLE'
+ ? getPreparedReasonMessage(action.reason)
+ : 'The authorized Start Copy preparation did not return a ready create call.',
+ })
+ return
+ }
+
+ const nextValidationError = validatePreparedAction(action, attempt.expected)
+ if (nextValidationError) throw new Error(nextValidationError)
+
+ attempt.capturePredictedCopyAccount(action.startCopy?.predictedCopyAccount)
+ setFlowState({ phase: 'review', action })
+ } catch (error) {
+ setFlowState({ phase: 'error', action: diagnosticAction, error: getApiErrorMessage(error) })
+ } finally {
+ setIsAuthorizing(false)
+ }
+ }
+
+ const retry = () => {
+ if (
+ flowState.phase === 'unavailable' &&
+ (flowState.action?.reason === 'PREPARED_ACTION_REASON_INSUFFICIENT_QUOTE_ALLOWANCE' ||
+ flowState.action?.reason === 'PREPARED_ACTION_REASON_SIGNER_POLICY_CHANGED')
+ ) {
+ attempt.resetStartAttempt()
+ }
+
+ setIsAuthorizing(false)
+ void flow.retry()
+ }
+
+ const viewMyCopies = () => {
+ dismiss()
+ navigate(APP_PATHS.COPY_TRADING + '/my-copies')
+ }
+
+ return {
+ accountConnected: !!account,
+ agreed,
+ authorizationLabel: authorizationKind === 'permit' ? 'Permit' : 'Approve',
+ authorizationRequired: !!authorizationKind,
+ availabilityMessage,
+ capital,
+ confirmBalanceError,
+ confirmStartCopy,
+ createdCopyRun,
+ dismiss,
+ editAmount: resetPreparedState,
+ flowState,
+ handlePrimaryAction,
+ isAuthorizing,
+ primaryActionLabel,
+ retry,
+ setAgreed,
+ setPercentageAmount,
+ startPreview,
+ viewMyCopies,
+ }
+}
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/modals/StopCopyModal/components.tsx b/apps/kyberswap-interface/src/pages/CopyTrading/modals/StopCopyModal/components.tsx
new file mode 100644
index 0000000000..f6e69bfae0
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/modals/StopCopyModal/components.tsx
@@ -0,0 +1,176 @@
+import type { PositionSummary } from 'services/copyTrading/types/positions'
+import type { StopCopyPreview } from 'services/copyTrading/types/preparedActions'
+
+import { ButtonPrimary } from 'components/Button'
+import Dots from 'components/Dots'
+import Loader from 'components/Loader'
+import ScrollableWithSignal from 'components/ScrollableWithSignal'
+import { Center, HStack, Stack } from 'components/Stack'
+import { ShortenedId } from 'pages/CopyTrading/components/common/layout'
+import { formatApproximateUsd, formatUsd, getSignedMetricClassName, signedUsd } from 'pages/CopyTrading/helpers'
+import { ReviewRow, ReviewSection } from 'pages/CopyTrading/modals/PreparedActionModal'
+import PreparedActionSlippageControl from 'pages/CopyTrading/modals/PreparedActionModal/SlippageControl'
+import { formatPreparedAmount } from 'pages/CopyTrading/modals/PreparedActionModal/preparedAction'
+import { MAX_STOP_POSITIONS, getUserPositionId } from 'pages/CopyTrading/modals/StopCopyModal/positions'
+import { cn } from 'utils/cn'
+
+const withMetricFallback = (value: string) => (value === '—' ? 'N/A' : value)
+
+export const StopCopyReview = ({
+ isLoading,
+ preview,
+ totalPositionCount,
+}: {
+ isLoading: boolean
+ preview?: StopCopyPreview
+ totalPositionCount: number
+}) => {
+ const showSkeleton = isLoading && !preview
+
+ return (
+
+
+ )
+}
+
+type StopCopyFormProps = {
+ availabilityMessage?: string
+ isPreparing: boolean
+ isSelected: (position: PositionSummary, index: number) => boolean
+ onPrimaryAction: () => void
+ onSlippageChange: (slippage: number) => void
+ onTogglePosition: (position: PositionSummary, index: number) => void
+ positions?: PositionSummary[]
+ positionsError?: string
+ primaryActionDisabled: boolean
+ primaryActionLabel: string
+ primaryActionLoading: boolean
+ selectedPositionCount: number
+ slippage: number
+}
+
+export const StopCopyForm = ({
+ availabilityMessage,
+ isPreparing,
+ isSelected,
+ onPrimaryAction,
+ onSlippageChange,
+ onTogglePosition,
+ positions,
+ positionsError,
+ primaryActionDisabled,
+ primaryActionLabel,
+ primaryActionLoading,
+ selectedPositionCount,
+ slippage,
+}: StopCopyFormProps) => {
+ return (
+
+
+ Select positions to sell:
+
+ {positions ? `${selectedPositionCount}/${positions.length}` : ''}
+
+
+
+
+ {positions === undefined ? (
+ !positionsError ? (
+
+
+ ) : null
+ ) : positions.length ? (
+ positions.map((position, index) => {
+ const userPositionId = getUserPositionId(position) as string
+ const checked = isSelected(position, index)
+ const selectionLimitReached = !checked && selectedPositionCount >= MAX_STOP_POSITIONS
+
+ return (
+
+ )
+ })
+ ) : (
+ No open positions. You can still stop copying.
+ )}
+
+
+ {!!positions && positions.length > MAX_STOP_POSITIONS && (
+
+ Select up to {MAX_STOP_POSITIONS} positions to sell in this Stop Copy request.
+
+ )}
+
+
+ {primaryActionLoading ? {primaryActionLabel} : primaryActionLabel}
+
+
+ )
+}
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/modals/StopCopyModal/index.tsx b/apps/kyberswap-interface/src/pages/CopyTrading/modals/StopCopyModal/index.tsx
new file mode 100644
index 0000000000..84c66cb3f2
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/modals/StopCopyModal/index.tsx
@@ -0,0 +1,244 @@
+import { ChainId } from '@kyberswap/ks-sdk-core'
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react'
+import { useNavigate } from 'react-router-dom'
+import copyRunApi from 'services/copyTrading/api/endpoints/copyRuns'
+import preparedActionApi from 'services/copyTrading/api/endpoints/preparedActions'
+import type { CopyRunSummary } from 'services/copyTrading/types/copyRuns'
+import type { PositionSummary } from 'services/copyTrading/types/positions'
+import type { PreparedCallKind } from 'services/copyTrading/types/preparedActions'
+
+import { APP_PATHS } from 'constants/index'
+import { useActiveWeb3React } from 'hooks'
+import { useChangeNetwork } from 'hooks/web3/useChangeNetwork'
+import { getPreparedReasonMessage, isActionAvailable } from 'pages/CopyTrading/helpers'
+import useRefreshCopyTrading from 'pages/CopyTrading/hooks/useRefreshCopyTrading'
+import PreparedActionModal, { PreparedActionSuccessActions } from 'pages/CopyTrading/modals/PreparedActionModal'
+import { DEFAULT_PREPARED_ACTION_SLIPPAGE } from 'pages/CopyTrading/modals/PreparedActionModal/SlippageControl'
+import {
+ DEFAULT_PREPARED_ACTION_STATE,
+ getApiErrorMessage,
+} from 'pages/CopyTrading/modals/PreparedActionModal/preparedAction'
+import { usePreparedAction } from 'pages/CopyTrading/modals/PreparedActionModal/usePreparedAction'
+import { StopCopyForm, StopCopyReview } from 'pages/CopyTrading/modals/StopCopyModal/components'
+import {
+ MAX_STOP_POSITIONS,
+ getSelectedStopCopyPositionIds,
+ getUserPositionId,
+ loadAllOpenCopyRunPositions,
+} from 'pages/CopyTrading/modals/StopCopyModal/positions'
+import { useWalletModalToggle } from 'state/application/hooks'
+
+type StopCopyModalProps = {
+ isOpen: boolean
+ onDismiss: () => void
+ copyRun: CopyRunSummary
+ agentName?: string
+}
+
+const STOP_COPY_CALL_KINDS: PreparedCallKind[] = ['PREPARED_CALL_KIND_STOP_COPY']
+
+const StopCopyModal = ({ isOpen, onDismiss, copyRun, agentName }: StopCopyModalProps) => {
+ const navigate = useNavigate()
+ const { account, chainId } = useActiveWeb3React()
+ const { changeNetwork } = useChangeNetwork()
+ const toggleWalletModal = useWalletModalToggle()
+ const refreshCopyTrading = useRefreshCopyTrading()
+ const [prepareStopCopy] = preparedActionApi.usePrepareStopCopyMutation()
+ const [getCopyRunPositions] = copyRunApi.useLazyGetCopyRunPositionsQuery()
+
+ const [flowState, setFlowState] = useState(DEFAULT_PREPARED_ACTION_STATE)
+ const [positions, setPositions] = useState()
+ const [positionsError, setPositionsError] = useState()
+ const [selected, setSelected] = useState>({})
+ const [slippage, setSlippage] = useState(DEFAULT_PREPARED_ACTION_SLIPPAGE)
+ const positionsRequestId = useRef(0)
+
+ const onExpectedChain = chainId === copyRun.chainId
+ const ownershipMessage =
+ account && copyRun.ownerAddress.toLowerCase() !== account.toLowerCase()
+ ? 'The selected Copy Run is not owned by the connected wallet.'
+ : undefined
+
+ const loadPositions = useCallback(async () => {
+ const requestId = ++positionsRequestId.current
+
+ setPositions(undefined)
+ setPositionsError(undefined)
+ setSelected({})
+
+ try {
+ const allPositions = await loadAllOpenCopyRunPositions(getCopyRunPositions, {
+ ownerAddress: copyRun.ownerAddress,
+ copyRunId: copyRun.copyRunId,
+ })
+
+ if (positionsRequestId.current === requestId) setPositions(allPositions)
+ } catch (error) {
+ if (positionsRequestId.current === requestId) setPositionsError(getApiErrorMessage(error))
+ }
+ }, [copyRun.copyRunId, copyRun.ownerAddress, getCopyRunPositions])
+
+ useEffect(() => {
+ if (isOpen) void loadPositions()
+
+ return () => {
+ positionsRequestId.current += 1
+ }
+ }, [isOpen, loadPositions])
+
+ const selectablePositions = useMemo(
+ () => (positions || []).filter(position => getUserPositionId(position)),
+ [positions],
+ )
+ const isSelected = (position: PositionSummary, index: number) => {
+ const positionId = getUserPositionId(position)
+ return positionId ? selected[positionId] ?? index < MAX_STOP_POSITIONS : false
+ }
+
+ const selectedPositions = selectablePositions.filter(isSelected)
+
+ const flow = usePreparedAction({
+ state: flowState,
+ setState: setFlowState,
+ expected: {
+ account: account || '',
+ callKinds: STOP_COPY_CALL_KINDS,
+ chainId: copyRun.chainId,
+ copyAccount: copyRun.copyAccount,
+ preview: 'stopCopy',
+ },
+ prepare: async () => {
+ if (!account) throw new Error('Connect your wallet first.')
+ if (positions === undefined) throw new Error('Wait for all open positions to finish loading.')
+ if (copyRun.ownerAddress.toLowerCase() !== account.toLowerCase()) {
+ throw new Error('The selected Copy Run is not owned by the connected wallet.')
+ }
+
+ const currentPositionIds = getSelectedStopCopyPositionIds(selectablePositions, isSelected)
+ const response = await prepareStopCopy({
+ ownerAddress: account.toLowerCase(),
+ copyRunId: copyRun.copyRunId,
+ userPositionIds: currentPositionIds,
+ slippageBps: Math.round(slippage * 100),
+ }).unwrap()
+ const preparedPositionIds = (response.data.stopCopy?.positions || [])
+ .map(position => position.userPositionId)
+ .filter((positionId): positionId is string => !!positionId)
+
+ if (preparedPositionIds.some(positionId => !currentPositionIds.includes(positionId))) {
+ throw new Error('The prepared position set does not match your current selection.')
+ }
+
+ return response.data
+ },
+ onComplete: refreshCopyTrading,
+ })
+
+ const togglePosition = (position: PositionSummary, index: number) => {
+ const positionId = getUserPositionId(position)
+ if (!positionId) return
+
+ const checked = isSelected(position, index)
+ if (!checked && selectedPositions.length >= MAX_STOP_POSITIONS) return
+
+ setSelected(current => ({ ...current, [positionId]: !checked }))
+ }
+
+ const dismiss = () => {
+ flow.reset()
+ setSelected({})
+ setSlippage(DEFAULT_PREPARED_ACTION_SLIPPAGE)
+ onDismiss()
+ }
+
+ const handlePrimaryAction = () => {
+ if (!account) {
+ toggleWalletModal()
+ return
+ }
+ if (!onExpectedChain) {
+ void changeNetwork(copyRun.chainId as ChainId)
+ return
+ }
+
+ void flow.prepare()
+ }
+
+ const viewHistory = () => {
+ dismiss()
+ navigate(APP_PATHS.COPY_TRADING + '/history')
+ }
+
+ const availabilityMessage = ownershipMessage
+ ? ownershipMessage
+ : !isActionAvailable(copyRun.stopCopyAvailability)
+ ? getPreparedReasonMessage(copyRun.stopCopyAvailability?.reason)
+ : undefined
+ const primaryActionLabel =
+ positions === undefined
+ ? positionsError
+ ? 'Positions unavailable'
+ : 'Loading positions'
+ : !account
+ ? 'Connect wallet'
+ : !onExpectedChain
+ ? 'Switch network'
+ : availabilityMessage
+ ? 'Stop Copy unavailable'
+ : 'Review Stop Copy'
+
+ const primaryActionLoading = flowState.isPreparing || (positions === undefined && !positionsError)
+ const reviewPreparing = flowState.phase === 'review' && flowState.isPreparing === true
+
+ const review = (
+ void flow.confirm()}
+ onRetry={() => void flow.retry()}
+ successTitle="Copy stopped"
+ successActions={successActions}
+ width={480}
+ >
+
+ )
+}
+
+export default StopCopyModal
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/modals/StopCopyModal/positions.test.ts b/apps/kyberswap-interface/src/pages/CopyTrading/modals/StopCopyModal/positions.test.ts
new file mode 100644
index 0000000000..2fb3d7d147
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/modals/StopCopyModal/positions.test.ts
@@ -0,0 +1,80 @@
+import type { PositionSummary } from 'services/copyTrading/types/positions'
+import type { CopyRunPositionsQuery } from 'services/copyTrading/types/queries'
+import type { CopyRunPositionsResponse } from 'services/copyTrading/types/responses'
+import { describe, expect, it, vi } from 'vitest'
+
+import {
+ getSelectedStopCopyPositionIds,
+ loadAllOpenCopyRunPositions,
+} from 'pages/CopyTrading/modals/StopCopyModal/positions'
+
+const position = (id: string): PositionSummary =>
+ ({
+ positionId: id,
+ userPositionId: id,
+ } as PositionSummary)
+
+const response = (
+ data: PositionSummary[],
+ pagination: CopyRunPositionsResponse['pagination'],
+): CopyRunPositionsResponse => ({ data, pagination })
+
+describe('Stop Copy position loading', () => {
+ it('loads every cursor page and deduplicates positions', async () => {
+ const getPositions = vi.fn((query: CopyRunPositionsQuery) => ({
+ unwrap: async () =>
+ query.cursor
+ ? response([position('position-2'), position('position-3')], { hasMore: false, limit: 100 })
+ : response([position('position-1'), position('position-2')], {
+ hasMore: true,
+ limit: 100,
+ nextCursor: 'next-page',
+ }),
+ }))
+
+ const positions = await loadAllOpenCopyRunPositions(getPositions, {
+ ownerAddress: '0x1111111111111111111111111111111111111111',
+ copyRunId: 'copy-run-1',
+ })
+
+ expect(positions.map(item => item.userPositionId)).toEqual(['position-1', 'position-2', 'position-3'])
+ expect(getPositions).toHaveBeenNthCalledWith(
+ 1,
+ expect.objectContaining({ status: 'open', cursor: undefined, limit: 100 }),
+ )
+ expect(getPositions).toHaveBeenNthCalledWith(
+ 2,
+ expect.objectContaining({ status: 'open', cursor: 'next-page', limit: 100 }),
+ )
+ })
+
+ it('fails closed when the cursor chain repeats', async () => {
+ const getPositions = vi.fn((query: CopyRunPositionsQuery) => ({
+ unwrap: async () =>
+ response([position('position-1')], {
+ hasMore: true,
+ limit: 100,
+ nextCursor: query.cursor === 'page-2' ? 'page-1' : query.cursor ? 'page-2' : 'page-1',
+ }),
+ }))
+
+ await expect(
+ loadAllOpenCopyRunPositions(getPositions, {
+ ownerAddress: '0x1111111111111111111111111111111111111111',
+ copyRunId: 'copy-run-1',
+ }),
+ ).rejects.toThrow('invalid pagination cursor')
+ })
+})
+
+describe('Stop Copy position selection', () => {
+ it('returns 32 selected position IDs', () => {
+ const positions = Array.from({ length: 32 }, (_, index) => position(`position-${index}`))
+ expect(getSelectedStopCopyPositionIds(positions, () => true)).toHaveLength(32)
+ })
+
+ it('rejects a payload containing more than 32 position IDs', () => {
+ const positions = Array.from({ length: 33 }, (_, index) => position(`position-${index}`))
+ expect(() => getSelectedStopCopyPositionIds(positions, () => true)).toThrow('Select at most 32 positions')
+ })
+})
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/modals/StopCopyModal/positions.ts b/apps/kyberswap-interface/src/pages/CopyTrading/modals/StopCopyModal/positions.ts
new file mode 100644
index 0000000000..dd230ad840
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/modals/StopCopyModal/positions.ts
@@ -0,0 +1,62 @@
+import type { PositionSummary } from 'services/copyTrading/types/positions'
+import type { CopyRunPositionsQuery, CopyRunQuery } from 'services/copyTrading/types/queries'
+import type { CopyRunPositionsResponse } from 'services/copyTrading/types/responses'
+
+export const MAX_STOP_POSITIONS = 32
+const POSITIONS_PAGE_SIZE = 100
+
+export const getUserPositionId = (position: PositionSummary) => position.userPositionId
+
+type GetCopyRunPositions = (query: CopyRunPositionsQuery) => {
+ unwrap: () => Promise
+}
+
+export const loadAllOpenCopyRunPositions = async (getCopyRunPositions: GetCopyRunPositions, copyRun: CopyRunQuery) => {
+ const allPositions: PositionSummary[] = []
+ const seenPositionIds = new Set()
+ const seenCursors = new Set()
+ let cursor: string | undefined
+
+ while (true) {
+ const response = await getCopyRunPositions({
+ ...copyRun,
+ status: 'open',
+ cursor,
+ limit: POSITIONS_PAGE_SIZE,
+ }).unwrap()
+
+ response.data.forEach(position => {
+ const positionId = position.userPositionId || position.positionId
+ if (!positionId || seenPositionIds.has(positionId)) return
+
+ seenPositionIds.add(positionId)
+ allPositions.push(position)
+ })
+
+ if (!response.pagination.hasMore) return allPositions
+
+ const nextCursor = response.pagination.nextCursor
+ if (!nextCursor || seenCursors.has(nextCursor)) {
+ throw new Error('The positions response returned an invalid pagination cursor.')
+ }
+
+ seenCursors.add(nextCursor)
+ cursor = nextCursor
+ }
+}
+
+export const getSelectedStopCopyPositionIds = (
+ positions: PositionSummary[],
+ isSelected: (position: PositionSummary, index: number) => boolean,
+) => {
+ const positionIds = positions
+ .filter(isSelected)
+ .map(getUserPositionId)
+ .filter((positionId): positionId is string => !!positionId)
+
+ if (positionIds.length > MAX_STOP_POSITIONS) {
+ throw new Error('Select at most ' + MAX_STOP_POSITIONS + ' positions before continuing.')
+ }
+
+ return positionIds
+}
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/modals/WithdrawQuoteModal/components.tsx b/apps/kyberswap-interface/src/pages/CopyTrading/modals/WithdrawQuoteModal/components.tsx
new file mode 100644
index 0000000000..f311967ce0
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/modals/WithdrawQuoteModal/components.tsx
@@ -0,0 +1,69 @@
+import type { WithdrawQuotePreview } from 'services/copyTrading/types/preparedActions'
+
+import { ButtonPrimary } from 'components/Button'
+import Dots from 'components/Dots'
+import { HStack, Stack } from 'components/Stack'
+import { ReviewRow, ReviewSection } from 'pages/CopyTrading/modals/PreparedActionModal'
+import { formatPreparedAmount } from 'pages/CopyTrading/modals/PreparedActionModal/preparedAction'
+import { shortenAddress } from 'utils/address'
+
+const withMetricFallback = (value: string) => (value === '—' ? 'N/A' : value)
+
+type WithdrawQuoteReviewProps = {
+ chainId: number
+ isLoading: boolean
+ preview?: WithdrawQuotePreview
+}
+
+export const WithdrawQuoteReview = ({ chainId, isLoading, preview }: WithdrawQuoteReviewProps) => {
+ const showSkeleton = isLoading && !preview
+
+ return (
+
+
+ )
+}
+
+type WithdrawQuoteFormProps = {
+ availabilityMessage?: string
+ isPreparing: boolean
+ onPrimaryAction: () => void
+ primaryActionDisabled: boolean
+ primaryActionLabel: string
+}
+
+export const WithdrawQuoteForm = ({
+ availabilityMessage,
+ isPreparing,
+ onPrimaryAction,
+ primaryActionDisabled,
+ primaryActionLabel,
+}: WithdrawQuoteFormProps) => (
+
+
+ Open positions are not sold by this action. Recover positions separately when the API advertises an action.
+
+
+ {isPreparing ? {primaryActionLabel} : primaryActionLabel}
+
+
+)
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/modals/WithdrawQuoteModal/index.tsx b/apps/kyberswap-interface/src/pages/CopyTrading/modals/WithdrawQuoteModal/index.tsx
new file mode 100644
index 0000000000..4637f78f43
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/modals/WithdrawQuoteModal/index.tsx
@@ -0,0 +1,139 @@
+import { ChainId } from '@kyberswap/ks-sdk-core'
+import { useState } from 'react'
+import { useNavigate } from 'react-router-dom'
+import preparedActionApi from 'services/copyTrading/api/endpoints/preparedActions'
+import type { AdvisoryActionAvailability } from 'services/copyTrading/types/actionAvailability'
+import type { CopyRunSummary } from 'services/copyTrading/types/copyRuns'
+import type { PreparedCallKind } from 'services/copyTrading/types/preparedActions'
+
+import { APP_PATHS } from 'constants/index'
+import { useActiveWeb3React } from 'hooks'
+import { useChangeNetwork } from 'hooks/web3/useChangeNetwork'
+import { getPreparedReasonMessage, isActionAvailable } from 'pages/CopyTrading/helpers'
+import useRefreshCopyTrading from 'pages/CopyTrading/hooks/useRefreshCopyTrading'
+import PreparedActionModal, { PreparedActionSuccessActions } from 'pages/CopyTrading/modals/PreparedActionModal'
+import { DEFAULT_PREPARED_ACTION_STATE } from 'pages/CopyTrading/modals/PreparedActionModal/preparedAction'
+import { usePreparedAction } from 'pages/CopyTrading/modals/PreparedActionModal/usePreparedAction'
+import { WithdrawQuoteForm, WithdrawQuoteReview } from 'pages/CopyTrading/modals/WithdrawQuoteModal/components'
+import { useWalletModalToggle } from 'state/application/hooks'
+
+type WithdrawQuoteModalProps = {
+ isOpen: boolean
+ onDismiss: () => void
+ copyRun: CopyRunSummary
+ withdrawQuoteAvailability?: AdvisoryActionAvailability
+}
+
+const WITHDRAW_CALL_KINDS: PreparedCallKind[] = ['PREPARED_CALL_KIND_WITHDRAW_QUOTE']
+
+const WithdrawQuoteModal = ({ isOpen, onDismiss, copyRun, withdrawQuoteAvailability }: WithdrawQuoteModalProps) => {
+ const navigate = useNavigate()
+ const { account, chainId } = useActiveWeb3React()
+ const { changeNetwork } = useChangeNetwork()
+ const toggleWalletModal = useWalletModalToggle()
+ const refreshCopyTrading = useRefreshCopyTrading()
+ const [prepareWithdrawQuote] = preparedActionApi.usePrepareWithdrawQuoteMutation()
+
+ const [flowState, setFlowState] = useState(DEFAULT_PREPARED_ACTION_STATE)
+
+ const availability = withdrawQuoteAvailability || copyRun.withdrawQuoteAvailability
+ const onExpectedChain = chainId === copyRun.chainId
+
+ const flow = usePreparedAction({
+ state: flowState,
+ setState: setFlowState,
+ expected: {
+ account: account || '',
+ callKinds: WITHDRAW_CALL_KINDS,
+ chainId: copyRun.chainId,
+ copyAccount: copyRun.copyAccount,
+ preview: 'withdrawQuote',
+ },
+ prepare: async () => {
+ if (!account) throw new Error('Connect your wallet first.')
+ const response = await prepareWithdrawQuote({
+ ownerAddress: account,
+ copyRunId: copyRun.copyRunId,
+ }).unwrap()
+ const recipient = response.data.withdrawQuote?.recipientAddress
+ const sweepAmountRaw = response.data.withdrawQuote?.sweepAmountRaw
+ if (response.data.status === 'PREPARED_ACTION_STATUS_READY') {
+ if (!recipient || recipient.toLowerCase() !== account.toLowerCase()) {
+ throw new Error('The prepared withdrawal recipient does not match your wallet.')
+ }
+ if (!sweepAmountRaw || !/^\d+$/.test(sweepAmountRaw) || BigInt(sweepAmountRaw) <= 0n) {
+ throw new Error('The prepared withdrawal is missing its exact sweep amount.')
+ }
+ }
+ return response.data
+ },
+ onComplete: refreshCopyTrading,
+ })
+
+ const dismiss = () => {
+ flow.reset()
+ onDismiss()
+ }
+
+ const handlePrimaryAction = () => {
+ if (!account) {
+ toggleWalletModal()
+ return
+ }
+ if (!onExpectedChain) {
+ void changeNetwork(copyRun.chainId as ChainId)
+ return
+ }
+ void flow.prepare()
+ }
+
+ const viewHistory = () => {
+ dismiss()
+ navigate(APP_PATHS.COPY_TRADING + '/history')
+ }
+
+ const availabilityMessage = !isActionAvailable(availability)
+ ? getPreparedReasonMessage(availability?.reason)
+ : undefined
+ const primaryActionLabel = !account
+ ? 'Connect wallet'
+ : !onExpectedChain
+ ? 'Switch network'
+ : availabilityMessage
+ ? 'Withdraw unavailable'
+ : 'Review Withdrawal'
+
+ const preview = flowState.action?.withdrawQuote
+ const reviewPreparing = flowState.phase === 'review' && flowState.isPreparing === true
+ const review = void flow.confirm()}
+ onRetry={() => void flow.retry()}
+ successTitle="Withdrawal completed"
+ successActions={successActions}
+ width={480}
+ >
+
+ )
+}
+
+export default WithdrawQuoteModal
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/modals/context.tsx b/apps/kyberswap-interface/src/pages/CopyTrading/modals/context.tsx
new file mode 100644
index 0000000000..f8c916d202
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/modals/context.tsx
@@ -0,0 +1,87 @@
+import { type PropsWithChildren, createContext, useContext, useEffect, useMemo, useRef, useState } from 'react'
+import type { AdvisoryActionAvailability } from 'services/copyTrading/types/actionAvailability'
+import type { CopyRunSummary } from 'services/copyTrading/types/copyRuns'
+import type { PositionSummary } from 'services/copyTrading/types/positions'
+
+import { useActiveWeb3React } from 'hooks'
+import AddCapitalModal from 'pages/CopyTrading/modals/AddCapitalModal'
+import ManagePositionModal, { type ManagePositionMode } from 'pages/CopyTrading/modals/ManagePositionModal'
+import StartCopyModal from 'pages/CopyTrading/modals/StartCopyModal'
+import type { StartCopyTarget } from 'pages/CopyTrading/modals/StartCopyModal/startCopy'
+import StopCopyModal from 'pages/CopyTrading/modals/StopCopyModal'
+import WithdrawQuoteModal from 'pages/CopyTrading/modals/WithdrawQuoteModal'
+
+type ActiveModal =
+ | { type: 'startCopy'; agent: StartCopyTarget }
+ | { type: 'addCapital'; copyRun: CopyRunSummary; agentName?: string }
+ | { type: 'stopCopy'; copyRun: CopyRunSummary; agentName?: string }
+ | { type: 'withdrawQuote'; copyRun: CopyRunSummary; withdrawQuoteAvailability?: AdvisoryActionAvailability }
+ | { type: 'managePosition'; position: PositionSummary; mode: ManagePositionMode }
+
+type CopyTradingModalContextValue = {
+ openStartCopy: (agent: StartCopyTarget) => void
+ openAddCapital: (copyRun: CopyRunSummary, agentName?: string) => void
+ openStopCopy: (copyRun: CopyRunSummary, agentName?: string) => void
+ openWithdrawQuote: (copyRun: CopyRunSummary, availability?: AdvisoryActionAvailability) => void
+ openManagePosition: (position: PositionSummary, mode: ManagePositionMode) => void
+}
+
+const CopyTradingModalContext = createContext(undefined)
+
+export const CopyTradingModalProvider = ({ children }: PropsWithChildren) => {
+ const { account } = useActiveWeb3React()
+ const [active, setActive] = useState(null)
+ const previousAccount = useRef(account)
+
+ useEffect(() => {
+ if (active && previousAccount.current && previousAccount.current !== account) {
+ setActive(null)
+ }
+
+ previousAccount.current = account
+ }, [account, active])
+
+ const value = useMemo(
+ () => ({
+ openStartCopy: agent => setActive({ type: 'startCopy', agent }),
+ openAddCapital: (copyRun, agentName) => setActive({ type: 'addCapital', copyRun, agentName }),
+ openStopCopy: (copyRun, agentName) => setActive({ type: 'stopCopy', copyRun, agentName }),
+ openWithdrawQuote: (copyRun, withdrawQuoteAvailability) =>
+ setActive({ type: 'withdrawQuote', copyRun, withdrawQuoteAvailability }),
+ openManagePosition: (position, mode) => setActive({ type: 'managePosition', position, mode }),
+ }),
+ [],
+ )
+
+ const close = () => setActive(null)
+
+ return (
+
+ {children}
+ {active?.type === 'startCopy' &&
+ )
+}
+
+export const useCopyTradingModal = () => {
+ const context = useContext(CopyTradingModalContext)
+ if (!context) throw new Error('useCopyTradingModal must be used within CopyTradingModalProvider')
+ return context
+}
diff --git a/apps/kyberswap-interface/src/pages/CrossChainSwap/components/QuoteSelector.tsx b/apps/kyberswap-interface/src/pages/CrossChainSwap/components/QuoteSelector.tsx
index 3099d048af..d8e9f50f62 100644
--- a/apps/kyberswap-interface/src/pages/CrossChainSwap/components/QuoteSelector.tsx
+++ b/apps/kyberswap-interface/src/pages/CrossChainSwap/components/QuoteSelector.tsx
@@ -61,8 +61,13 @@ export const QuoteSelector = ({
{t`Choose your Route`}
{upToLarge && setShow(false)} />}
-
-
+
+
{quotes.map((quote, index) => {
const ongoingTag = nearIntentCampaignOnGoing && quote.adapter.getName() === 'Near Intents'
return (
diff --git a/apps/kyberswap-interface/src/pages/Earns/SmartExitOrders/index.tsx b/apps/kyberswap-interface/src/pages/Earns/SmartExitOrders/index.tsx
index 47a76c9043..ed46fa767a 100644
--- a/apps/kyberswap-interface/src/pages/Earns/SmartExitOrders/index.tsx
+++ b/apps/kyberswap-interface/src/pages/Earns/SmartExitOrders/index.tsx
@@ -27,6 +27,7 @@ import RefetchIndicator from 'components/RefetchIndicator'
import SmartExitListSkeleton from 'components/RouteFallback/SmartExitListSkeleton'
import { APP_PATHS } from 'constants/index'
import { useActiveWeb3React } from 'hooks'
+import useIsWalletRestoring from 'hooks/useIsWalletRestoring'
import { useChangeNetwork } from 'hooks/web3/useChangeNetwork'
import Filter from 'pages/Earns/SmartExitOrders/Filter'
import OrderItem from 'pages/Earns/SmartExitOrders/OrderItem'
@@ -34,7 +35,6 @@ import useSmartExitFilter from 'pages/Earns/SmartExitOrders/useSmartExitFilter'
import { useSmartExitOrdersData } from 'pages/Earns/SmartExitOrders/useSmartExitOrdersData'
import { SmartExit as SmartExitModal } from 'pages/Earns/components/SmartExit'
import { SMART_EXIT_SUPPORTED_CHAINS, SMART_EXIT_SUPPORTED_EXCHANGES } from 'pages/Earns/constants'
-import useIsWalletRestoring from 'pages/Earns/hooks/useIsWalletRestoring'
import { OrderStatus, ParsedPosition, SmartExitOrder, UserPosition } from 'pages/Earns/types'
import { parsePosition } from 'pages/Earns/utils/position'
import { useNotify, useWalletModalToggle } from 'state/application/hooks'
diff --git a/apps/kyberswap-interface/src/pages/Earns/UserPositions/index.tsx b/apps/kyberswap-interface/src/pages/Earns/UserPositions/index.tsx
index 909b23e76b..2162839abc 100644
--- a/apps/kyberswap-interface/src/pages/Earns/UserPositions/index.tsx
+++ b/apps/kyberswap-interface/src/pages/Earns/UserPositions/index.tsx
@@ -22,6 +22,7 @@ import { HiddenH1, HiddenH2 } from 'components/Seo/components'
import { HStack } from 'components/Stack'
import { APP_PATHS } from 'constants/index'
import { useActiveWeb3React } from 'hooks'
+import useIsWalletRestoring from 'hooks/useIsWalletRestoring'
import Filter from 'pages/Earns/UserPositions/Filter'
import PositionBanner from 'pages/Earns/UserPositions/PositionBanner'
import TableContent, { FeeInfoFromRpc } from 'pages/Earns/UserPositions/TableContent'
@@ -35,7 +36,6 @@ import {
import useFilter, { SortBy } from 'pages/Earns/UserPositions/useFilter'
import useAccountChanged from 'pages/Earns/hooks/useAccountChanged'
import useClosedPositions from 'pages/Earns/hooks/useClosedPositions'
-import useIsWalletRestoring from 'pages/Earns/hooks/useIsWalletRestoring'
import useKemRewards from 'pages/Earns/hooks/useKemRewards'
import useSupportedDexesAndChains, { AllChainsOption } from 'pages/Earns/hooks/useSupportedDexesAndChains'
import useUnfinalizedPositions from 'pages/Earns/hooks/useUnfinalizedPositions'
diff --git a/apps/kyberswap-interface/src/pages/Earns/components/ClaimAllModal/index.tsx b/apps/kyberswap-interface/src/pages/Earns/components/ClaimAllModal/index.tsx
index c532fa4433..d53e1041b4 100644
--- a/apps/kyberswap-interface/src/pages/Earns/components/ClaimAllModal/index.tsx
+++ b/apps/kyberswap-interface/src/pages/Earns/components/ClaimAllModal/index.tsx
@@ -238,7 +238,6 @@ export default function ClaimAllModal({
data-open={isSelected ? 'true' : 'false'}
data-signal={chain.tokens.length > 5 ? 'true' : 'false'}
showArrow
- showBackground
>
{[...chain.tokens]
.filter(token => token.claimableUsdValue > 0)
@@ -301,7 +300,6 @@ export default function ClaimAllModal({
5 ? 'true' : 'false'}
- showBackground
>
{[...selectedRewardChain.tokens]
.filter(token => token.claimableUsdValue > 0)
diff --git a/apps/kyberswap-interface/src/pages/Earns/hooks/useIsWalletRestoring.ts b/apps/kyberswap-interface/src/pages/Earns/hooks/useIsWalletRestoring.ts
deleted file mode 100644
index 7fcf3fc655..0000000000
--- a/apps/kyberswap-interface/src/pages/Earns/hooks/useIsWalletRestoring.ts
+++ /dev/null
@@ -1,14 +0,0 @@
-import { useEffect, useState } from 'react'
-
-import { useAccount } from 'hooks/useAccount'
-
-export default function useIsWalletRestoring() {
- const { status } = useAccount()
- const [hasPassedInitialRender, setHasPassedInitialRender] = useState(false)
-
- useEffect(() => {
- setHasPassedInitialRender(true)
- }, [])
-
- return !hasPassedInitialRender || status === 'connecting' || status === 'reconnecting'
-}
diff --git a/apps/kyberswap-interface/src/services/copyTrading/adapters.test.ts b/apps/kyberswap-interface/src/services/copyTrading/adapters.test.ts
new file mode 100644
index 0000000000..9e36a839bd
--- /dev/null
+++ b/apps/kyberswap-interface/src/services/copyTrading/adapters.test.ts
@@ -0,0 +1,178 @@
+import { describe, expect, it } from 'vitest'
+
+import { adaptActionLogsResponse } from './adapters/activity'
+import { adaptCopyAccountBalancesResponse, adaptCopyAccountWalletInventoryResponse } from './adapters/copyAccounts'
+import { adaptCopyRunCashbackPolicyResponse, adaptCopyRunResponse } from './adapters/copyRuns'
+
+const currentCapital = {
+ value: '12.34',
+ status: 'METRIC_STATUS_CURRENT' as const,
+}
+
+describe('adaptCopyRunResponse', () => {
+ it.each([
+ ['CAPITAL_IN_PROJECTION_STATUS_READY', currentCapital, '56.78', 'ready', '12.34'],
+ [
+ 'CAPITAL_IN_PROJECTION_STATUS_READY',
+ { value: '12.34', status: 'METRIC_STATUS_UNAVAILABLE' },
+ '56.78',
+ 'ready',
+ undefined,
+ ],
+ ['CAPITAL_IN_PROJECTION_STATUS_SYNCING', currentCapital, '56.78', 'syncing', undefined],
+ ['CAPITAL_IN_PROJECTION_STATUS_UNAVAILABLE', currentCapital, '56.78', 'unavailable', undefined],
+ ['CAPITAL_IN_PROJECTION_STATUS_UNAVAILABLE', currentCapital, undefined, 'unavailable', undefined],
+ ] as const)(
+ 'maps %s and keeps observed capital separate from canonical capital',
+ (capitalInProjectionStatus, capitalInUsd, observedValue, expectedStatus, expectedCapitalInUsd) => {
+ const response = adaptCopyRunResponse({
+ data: {
+ capitalInProjectionStatus,
+ capitalInUsd,
+ observedCapitalInUsd: observedValue ? { value: observedValue, status: 'METRIC_STATUS_CURRENT' } : undefined,
+ },
+ })
+
+ expect(response.data.capitalInProjectionStatus).toBe(expectedStatus)
+ expect(response.data.capitalInUsd).toBe(expectedCapitalInUsd)
+ expect(response.data.observedCapitalInUsd).toBe(observedValue)
+ },
+ )
+
+ it.each([
+ ['METRIC_STATUS_STALE', '56.78'],
+ ['METRIC_STATUS_UNAVAILABLE', undefined],
+ ] as const)('maps observed capital according to its %s metric status', (status, expectedObservedCapitalInUsd) => {
+ const response = adaptCopyRunResponse({
+ data: {
+ capitalInProjectionStatus: 'CAPITAL_IN_PROJECTION_STATUS_SYNCING',
+ observedCapitalInUsd: { value: '56.78', status },
+ },
+ })
+
+ expect(response.data.observedCapitalInUsd).toBe(expectedObservedCapitalInUsd)
+ })
+})
+
+describe('adaptActionLogsResponse', () => {
+ it('flattens session groups and adapts their nested action logs', () => {
+ const response = adaptActionLogsResponse({
+ data: [
+ {
+ sessionId: 'session-1',
+ logs: [
+ {
+ actionLogId: 'log-1',
+ action: 'buy',
+ actionSummary: 'Buy ETH',
+ chainId: '8453',
+ occurredAt: '2026-08-14T01:02:03Z',
+ },
+ ],
+ },
+ ],
+ pagination: { hasMore: true, limit: 10, nextCursor: 'next' },
+ })
+
+ expect(response).toMatchObject({
+ data: [
+ {
+ logId: 'log-1',
+ action: 'Buy ETH',
+ actionCode: 'buy',
+ chainId: 8453,
+ },
+ ],
+ pagination: { hasMore: true, limit: 10, nextCursor: 'next' },
+ })
+ })
+})
+
+describe('adaptCopyAccountBalancesResponse', () => {
+ it('preserves a present pinned stable balance with an exact zero on-chain amount', () => {
+ const response = adaptCopyAccountBalancesResponse({
+ data: [],
+ pagination: { hasMore: false, limit: 10 },
+ pinnedStableBalance: {
+ status: 'PINNED_STABLE_BALANCE_STATUS_PRESENT',
+ balance: {
+ amountDecimal: '0',
+ balanceSource: 'onchain_rpc',
+ chainId: '8453',
+ copyAccount: '0x2222222222222222222222222222222222222222',
+ tokenAddress: '0x3333333333333333333333333333333333333333',
+ },
+ },
+ })
+
+ expect(response.pinnedStableBalance?.balance).toMatchObject({
+ amountDecimal: '0',
+ balanceSource: 'onchain_rpc',
+ })
+ })
+})
+
+describe('adaptCopyAccountWalletInventoryResponse', () => {
+ it('preserves the authoritative total, completeness and pinned zero balance', () => {
+ const response = adaptCopyAccountWalletInventoryResponse({
+ data: [
+ {
+ amountDecimal: '2',
+ chainId: '8453',
+ copyAccount: '0x2222222222222222222222222222222222222222',
+ currentValuation: { status: 'DATA_STATUS_STALE', valueUsd: '5' },
+ tokenAddress: '0x3333333333333333333333333333333333333333',
+ },
+ ],
+ walletInventoryValueUsd: { status: 'METRIC_STATUS_STALE', value: '5' },
+ complete: true,
+ pinnedStableBalance: {
+ status: 'PINNED_STABLE_BALANCE_STATUS_PRESENT',
+ balance: {
+ amountDecimal: '0',
+ chainId: '8453',
+ copyAccount: '0x2222222222222222222222222222222222222222',
+ tokenAddress: '0x4444444444444444444444444444444444444444',
+ },
+ },
+ })
+
+ expect(response).toMatchObject({
+ complete: true,
+ walletInventoryValueUsd: { status: 'METRIC_STATUS_STALE', value: '5' },
+ data: [{ chainId: 8453, valueUsd: '5' }],
+ pinnedStableBalance: { balance: { amountDecimal: '0' } },
+ })
+ })
+})
+
+describe('adaptCopyRunCashbackPolicyResponse', () => {
+ it.each([
+ 'COPY_RUN_CASHBACK_POLICY_STATUS_AVAILABLE',
+ 'COPY_RUN_CASHBACK_POLICY_STATUS_NOT_CONFIGURED',
+ 'COPY_RUN_CASHBACK_POLICY_STATUS_INVALIDATED',
+ 'COPY_RUN_CASHBACK_POLICY_STATUS_UNAVAILABLE',
+ ] as const)('preserves the typed %s policy state and response freshness', status => {
+ const response = adaptCopyRunCashbackPolicyResponse({
+ data: {
+ copyRunId: 'copy-run-1',
+ chainId: '8453',
+ copyAccount: '0x2222222222222222222222222222222222222222',
+ agentId: 'agent-1',
+ status,
+ scope: 'COPY_RUN_CASHBACK_POLICY_SCOPE_DEFAULT',
+ },
+ meta: { status: 'DATA_STATUS_STALE' },
+ })
+
+ expect(response.data).toMatchObject({
+ chainId: 8453,
+ status,
+ scope: 'COPY_RUN_CASHBACK_POLICY_SCOPE_DEFAULT',
+ })
+ expect(response.data.capCashbackRatioRaw).toBeUndefined()
+ expect(response.data.pnlRateRaw).toBeUndefined()
+ expect(response.data.cashbackFormulaVersion).toBeUndefined()
+ expect(response.meta?.status).toBe('DATA_STATUS_STALE')
+ })
+})
diff --git a/apps/kyberswap-interface/src/services/copyTrading/adapters/activity.ts b/apps/kyberswap-interface/src/services/copyTrading/adapters/activity.ts
new file mode 100644
index 0000000000..f9beefdec8
--- /dev/null
+++ b/apps/kyberswap-interface/src/services/copyTrading/adapters/activity.ts
@@ -0,0 +1,210 @@
+import type { ActivityRow } from 'services/copyTrading/types/copyRuns'
+import type { CotLog } from 'services/copyTrading/types/positions'
+import type { ActivityType, Address } from 'services/copyTrading/types/primitives'
+import type {
+ CopyAccountHistoryResponse,
+ CotLogsResponse,
+ OwnerActivityResponse,
+} from 'services/copyTrading/types/responses'
+
+import { type ApiCursorResponse, type ApiMetric, type ApiToken, chainIdNumber, cursorResponse, toToken } from './shared'
+
+type ApiActivity = {
+ activityId?: string
+ ownerAddress?: string
+ agentId?: string
+ chainId?: string
+ copyRunId?: string
+ copyAccount?: string
+ type?: string
+ summary?: string
+ occurredAt?: string
+ userPositionId?: string
+ followerPositionId?: string
+ tradeId?: string
+ txHash?: string
+ agentDisplayName?: string
+ agentAvatarUrl?: string
+ copyLifecycle?: {
+ eventId?: string
+ eventType?: string
+ beforeStatus?: string
+ afterStatus?: string
+ }
+ position?: {
+ eventId?: string
+ actionType?: string
+ baseTokenAddress?: string
+ quoteTokenAddress?: string
+ baseAmountRaw?: string
+ quoteAmountRaw?: string
+ accountingStatus?: string
+ grossBaseSoldRaw?: string
+ grossQuoteReceivedRaw?: string
+ baseToken?: ApiToken
+ quoteToken?: ApiToken
+ grossBaseBoughtRaw?: string
+ upfrontFeeCapturedBaseRaw?: string
+ upfrontFeeReleasedBaseRaw?: string
+ netBaseReceivedRaw?: string
+ netBaseSoldRaw?: string
+ displayBaseRaw?: string
+ settlementValueUsd?: ApiMetric
+ realizedPnlUsd?: ApiMetric
+ flatFeeCapturedUsd?: ApiMetric
+ cashbackReceivedUsd?: ApiMetric
+ }
+ capital?: {
+ movementType?: string
+ amountRaw?: string
+ tokenAddress?: string
+ token?: ApiToken
+ valueUsd?: ApiMetric
+ }
+ fee?: {
+ amountRaw?: string
+ tokenAddress?: string
+ token?: ApiToken
+ valueUsd?: ApiMetric
+ }
+ execution?: {
+ executionKind?: string
+ eventSeq?: string
+ eventType?: string
+ actionKind?: string
+ copyJobId?: string
+ exitActionId?: string
+ executionId?: string
+ copyJobAction?: string
+ copyJobStatus?: string
+ actionStatus?: string
+ executionStatus?: string
+ publicErrorCode?: string
+ publicErrorMessage?: string
+ configIndex?: number
+ minBaseTokenRateRaw?: string
+ configDeadlineRaw?: string
+ token?: ApiToken
+ displayAmountRaw?: string
+ valueUsd?: ApiMetric
+ }
+}
+
+type ApiAgentActionLog = {
+ actionLogId?: string
+ chainId?: string
+ occurredAt?: string
+ trigger?: string
+ dataSummary?: string
+ reasoningSummary?: string
+ actionSummary?: string
+ action?: string
+ status?: string
+ txHash?: string
+ leaderPositionId?: string
+ summary?: string
+ blockNumber?: string
+ tokenAddress?: string
+ model?: string
+ strategyVersion?: string
+}
+
+type ApiAgentActionLogSessionGroup = {
+ sessionId?: string
+ logs?: ApiAgentActionLog[]
+}
+
+const toPositionActivity = (detail: ApiActivity['position']): ActivityRow['position'] =>
+ detail
+ ? {
+ ...detail,
+ baseTokenAddress: detail.baseTokenAddress as Address | undefined,
+ quoteTokenAddress: detail.quoteTokenAddress as Address | undefined,
+ baseToken: detail.baseToken ? toToken(detail.baseToken) : undefined,
+ quoteToken: detail.quoteToken ? toToken(detail.quoteToken) : undefined,
+ }
+ : undefined
+
+const toCapitalActivity = (detail: ApiActivity['capital']): ActivityRow['capital'] =>
+ detail
+ ? {
+ ...detail,
+ tokenAddress: detail.tokenAddress as Address | undefined,
+ token: detail.token ? toToken(detail.token) : undefined,
+ }
+ : undefined
+
+const toFeeActivity = (detail: ApiActivity['fee']): ActivityRow['fee'] =>
+ detail
+ ? {
+ ...detail,
+ tokenAddress: detail.tokenAddress as Address | undefined,
+ token: detail.token ? toToken(detail.token) : undefined,
+ }
+ : undefined
+
+const toExecutionActivity = (detail: ApiActivity['execution']): ActivityRow['execution'] =>
+ detail
+ ? {
+ ...detail,
+ token: detail.token ? toToken(detail.token) : undefined,
+ }
+ : undefined
+
+const toActivity = (activity: ApiActivity): ActivityRow => ({
+ activityId: activity.activityId || '',
+ ownerAddress: (activity.ownerAddress || '') as Address,
+ agentId: activity.agentId || '',
+ chainId: chainIdNumber(activity.chainId),
+ copyRunId: activity.copyRunId,
+ copyAccount: activity.copyAccount as Address | undefined,
+ activityType: (activity.type?.replace('ACTIVITY_TYPE_', '').toLowerCase() || 'unknown') as ActivityType,
+ summary: activity.summary || '',
+ occurredAt: activity.occurredAt || '',
+ userPositionId: activity.userPositionId,
+ followerPositionId: activity.followerPositionId,
+ tradeId: activity.tradeId,
+ txHash: activity.txHash,
+ agentDisplayName: activity.agentDisplayName,
+ agentAvatarUrl: activity.agentAvatarUrl,
+ copyLifecycle: activity.copyLifecycle,
+ position: toPositionActivity(activity.position),
+ capital: toCapitalActivity(activity.capital),
+ fee: toFeeActivity(activity.fee),
+ execution: toExecutionActivity(activity.execution),
+})
+
+export const adaptActivityResponse = (
+ response: ApiCursorResponse,
+): OwnerActivityResponse | CopyAccountHistoryResponse => cursorResponse(response, toActivity)
+
+const toActionLog = (log: ApiAgentActionLog): CotLog => ({
+ logId: log.actionLogId || '',
+ agentId: '',
+ chainId: chainIdNumber(log.chainId),
+ positionId: log.leaderPositionId,
+ trigger: log.trigger || '',
+ data: log.dataSummary || '',
+ reasoning: log.reasoningSummary || '',
+ action: log.actionSummary || log.action || '',
+ actionCode: log.action,
+ status: log.status || '',
+ summary: log.summary,
+ txHash: log.txHash,
+ blockNumber: log.blockNumber,
+ tokenAddress: log.tokenAddress as Address | undefined,
+ model: log.model,
+ strategyVersion: log.strategyVersion,
+ occurredAt: log.occurredAt || '',
+})
+
+export const adaptActionLogsResponse = (
+ response: ApiCursorResponse,
+): CotLogsResponse => {
+ const groupedResponse = cursorResponse(response, group => (group.logs || []).map(toActionLog))
+
+ return {
+ ...groupedResponse,
+ data: groupedResponse.data.flat(),
+ }
+}
diff --git a/apps/kyberswap-interface/src/services/copyTrading/adapters/agents.ts b/apps/kyberswap-interface/src/services/copyTrading/adapters/agents.ts
new file mode 100644
index 0000000000..388d9e54fd
--- /dev/null
+++ b/apps/kyberswap-interface/src/services/copyTrading/adapters/agents.ts
@@ -0,0 +1,263 @@
+import type { AdvisoryActionAvailability } from 'services/copyTrading/types/actionAvailability'
+import type {
+ AgentCard,
+ AgentProfile,
+ AgentSnapshot,
+ AgentStats,
+ Chain,
+ PerformancePoint,
+} from 'services/copyTrading/types/agents'
+import type {
+ Address,
+ PerformanceInterval,
+ PerformanceSeries,
+ StrategyKey,
+} from 'services/copyTrading/types/primitives'
+import type {
+ AgentPerformanceResponse,
+ AgentResponse,
+ AgentStatsResponse,
+ AgentsResponse,
+ ChainsResponse,
+ CopyRunPerformanceResponse,
+ LeaderboardResponse,
+ LeaderboardSummaryResponse,
+} from 'services/copyTrading/types/responses'
+
+import {
+ type ApiCursorResponse,
+ type ApiMetric,
+ type ApiSingleResponse,
+ type ApiToken,
+ chainIdNumber,
+ cursorResponse,
+ metricValue,
+ singleResponse,
+ toToken,
+} from './shared'
+
+type ApiChain = {
+ chainId?: string
+ slug?: string
+ name?: string
+ iconUrl?: string
+ isEnabled?: boolean
+}
+
+export type ApiAgentMetrics = {
+ apr30d?: ApiMetric
+ winRatePct?: ApiMetric
+ lifetimeVolumeUsd?: ApiMetric
+ copiers?: ApiMetric
+ aumUsd?: ApiMetric
+ openPositions?: ApiMetric
+ totalRealizedPnlUsd?: ApiMetric
+ maxDrawdownPct?: ApiMetric
+ winningPositionCount?: ApiMetric
+ losingPositionCount?: ApiMetric
+ breakevenPositionCount?: ApiMetric
+ closedPositionCount?: ApiMetric
+}
+
+type ApiAgentCard = {
+ agentId?: string
+ chainId?: string
+ leaderAddress?: string
+ displayName?: string
+ avatarUrl?: string
+ isVerified?: boolean
+ badges?: string[]
+ modelName?: string
+ asOf?: string
+ strategyLabel?: string
+ strategyCategories?: string[]
+ metrics?: ApiAgentMetrics
+ flatFeeRatePct?: ApiMetric
+ startCopyAvailability?: AdvisoryActionAvailability
+}
+
+type ApiAgentProfile = ApiAgentCard & {
+ bio?: string
+ liveSince?: string
+ whitelistedSymbols?: string[]
+ tags?: string[]
+ strategyExecutionItems?: { label?: string; description?: string }[]
+}
+
+export type ApiAgentSnapshot = {
+ agentId?: string
+ chainId?: string
+ leaderAddress?: string
+ displayName?: string
+ avatarUrl?: string
+ isVerified?: boolean
+ modelName?: string
+ strategyLabel?: string
+ strategyCategories?: string[]
+ badges?: string[]
+ metrics?: ApiAgentMetrics
+}
+
+type ApiPerformancePoint = {
+ timestamp?: string
+ series?: string
+ interval?: string
+ valueUsd?: ApiMetric
+ tradeId?: string
+ positionId?: string
+ token?: ApiToken
+}
+
+const performanceSeriesMap: Record = {
+ PERFORMANCE_SERIES_PORTFOLIO_EQUITY: 'portfolio_value',
+ PERFORMANCE_SERIES_CUMULATIVE_REALIZED_PNL: 'cumulative_realized_pnl',
+ PERFORMANCE_SERIES_PERIOD_REALIZED_PNL: 'period_realized_pnl',
+ PERFORMANCE_SERIES_PER_TRADE_REALIZED_PNL: 'per_trade_realized_pnl',
+}
+
+const performanceIntervalMap: Record = {
+ PERFORMANCE_INTERVAL_DAY: 'day',
+ PERFORMANCE_INTERVAL_WEEK: 'week',
+ PERFORMANCE_INTERVAL_MONTH: 'month',
+}
+
+const toStrategy = (categories?: string[], label?: string): StrategyKey => {
+ const category = categories?.find(value => value !== 'STRATEGY_CATEGORY_UNSPECIFIED')
+ if (category) return category.replace('STRATEGY_CATEGORY_', '').toLowerCase() as StrategyKey
+
+ const normalizedLabel = label?.trim().toLowerCase()
+ return (
+ normalizedLabel === 'focused' || normalizedLabel === 'diversified' || normalizedLabel === 'active'
+ ? normalizedLabel
+ : 'unknown'
+ ) as StrategyKey
+}
+
+export const toAgentSnapshot = (snapshot: ApiAgentSnapshot): AgentSnapshot => ({
+ agentId: snapshot.agentId || '',
+ chainId: chainIdNumber(snapshot.chainId),
+ leaderAddress: (snapshot.leaderAddress || '') as Address,
+ displayName: snapshot.displayName || snapshot.agentId || '',
+ avatarUrl: snapshot.avatarUrl,
+ isVerified: snapshot.isVerified === true,
+ modelName: snapshot.modelName || '',
+ strategy: toStrategy(snapshot.strategyCategories, snapshot.strategyLabel),
+ strategyLabel: snapshot.strategyLabel,
+ strategyCategories: (snapshot.strategyCategories || []) as AgentSnapshot['strategyCategories'],
+ badges: snapshot.badges || [],
+ metrics: snapshot.metrics || {},
+})
+
+export const toAgentStats = (metrics?: ApiAgentMetrics): AgentStats => ({
+ apr30dPct: metricValue(metrics?.apr30d),
+ winRatePct: metricValue(metrics?.winRatePct),
+ volumeUsd: metricValue(metrics?.lifetimeVolumeUsd),
+ copiers: metricValue(metrics?.copiers),
+ aumUsd: metricValue(metrics?.aumUsd),
+ openPositions: metricValue(metrics?.openPositions),
+ totalRealizedPnlUsd: metricValue(metrics?.totalRealizedPnlUsd),
+ maxDrawdownPct: metricValue(metrics?.maxDrawdownPct),
+ metrics: metrics || {},
+})
+
+const toAgentCard = (agent: ApiAgentCard): AgentCard => ({
+ agentId: agent.agentId || '',
+ chainId: chainIdNumber(agent.chainId),
+ leaderAddress: (agent.leaderAddress || '') as Address,
+ displayName: agent.displayName || agent.agentId || '',
+ avatarUrl: agent.avatarUrl,
+ isVerified: agent.isVerified === true,
+ badges: agent.badges || [],
+ isTrending: agent.badges?.some(badge => badge.toLowerCase() === 'trending') === true,
+ strategy: toStrategy(agent.strategyCategories, agent.strategyLabel),
+ strategyLabel: agent.strategyLabel,
+ strategyCategories: (agent.strategyCategories || []) as AgentCard['strategyCategories'],
+ modelName: agent.modelName || '',
+ stats: toAgentStats(agent.metrics),
+ flatFeeRatePct: metricValue(agent.flatFeeRatePct),
+ flatFeeRatePctMetric: agent.flatFeeRatePct,
+ startCopyAvailability: agent.startCopyAvailability,
+ asOf: agent.asOf,
+})
+
+const toAgentProfile = (agent: ApiAgentProfile): AgentProfile => ({
+ ...toAgentCard(agent),
+ bio: agent.bio,
+ liveSince: agent.liveSince,
+ whitelistedSymbols: agent.whitelistedSymbols || [],
+ tags: agent.tags || [],
+ strategyExecutionItems:
+ agent.strategyExecutionItems?.map(item => ({
+ label: item.label || '',
+ description: item.description || '',
+ })) || [],
+})
+
+const toPerformancePoint = (point: ApiPerformancePoint): PerformancePoint => {
+ const value = metricValue(point.valueUsd)
+ const isRealizedPnl = point.series !== 'PERFORMANCE_SERIES_PORTFOLIO_EQUITY'
+
+ return {
+ timestamp: point.timestamp || '',
+ series: performanceSeriesMap[point.series || ''],
+ interval: performanceIntervalMap[point.interval || ''],
+ portfolioValueUsd: isRealizedPnl ? undefined : value,
+ realizedPnlUsd: isRealizedPnl ? value : undefined,
+ tradeId: point.tradeId,
+ positionId: point.positionId,
+ token: point.token ? toToken(point.token) : undefined,
+ metric: point.valueUsd || {},
+ }
+}
+
+export const adaptChainsResponse = (response: ApiSingleResponse): ChainsResponse => ({
+ data: (response.data || []).map(
+ (chain): Chain => ({
+ chainId: chainIdNumber(chain.chainId),
+ slug: chain.slug || '',
+ name: chain.name || '',
+ iconUrl: chain.iconUrl || '',
+ isEnabled: chain.isEnabled === true,
+ }),
+ ),
+ meta: response.meta,
+})
+
+export const adaptLeaderboardSummaryResponse = (
+ response: ApiSingleResponse<{
+ asOf?: string
+ agentCount?: ApiMetric
+ totalAumUsd?: ApiMetric
+ totalCopierCount?: ApiMetric
+ lifetimeVolumeUsd?: ApiMetric
+ }>,
+): LeaderboardSummaryResponse =>
+ singleResponse(response, summary => ({
+ asOf: summary.asOf,
+ totalAgents: metricValue(summary.agentCount),
+ totalAumUsd: metricValue(summary.totalAumUsd),
+ totalCopiers: metricValue(summary.totalCopierCount),
+ totalVolumeUsd: metricValue(summary.lifetimeVolumeUsd),
+ metrics: {
+ agentCount: summary.agentCount,
+ totalAumUsd: summary.totalAumUsd,
+ totalCopierCount: summary.totalCopierCount,
+ lifetimeVolumeUsd: summary.lifetimeVolumeUsd,
+ },
+ }))
+
+export const adaptLeaderboardResponse = (response: ApiCursorResponse): LeaderboardResponse =>
+ cursorResponse(response, toAgentCard)
+
+export const adaptAgentsResponse = (response: ApiCursorResponse): AgentsResponse =>
+ cursorResponse(response, toAgentCard)
+
+export const adaptAgentResponse = (response: ApiSingleResponse): AgentResponse =>
+ singleResponse(response, toAgentProfile)
+
+export const adaptAgentStatsResponse = (response: ApiSingleResponse): AgentStatsResponse =>
+ singleResponse(response, toAgentStats)
+
+export const adaptPerformanceResponse = (
+ response: ApiCursorResponse,
+): AgentPerformanceResponse | CopyRunPerformanceResponse => cursorResponse(response, toPerformancePoint)
diff --git a/apps/kyberswap-interface/src/services/copyTrading/adapters/copyAccounts.ts b/apps/kyberswap-interface/src/services/copyTrading/adapters/copyAccounts.ts
new file mode 100644
index 0000000000..30ec577bb9
--- /dev/null
+++ b/apps/kyberswap-interface/src/services/copyTrading/adapters/copyAccounts.ts
@@ -0,0 +1,186 @@
+import type { AdvisoryActionAvailability } from 'services/copyTrading/types/actionAvailability'
+import type {
+ CopyAccountSummary,
+ PendingSellObligation,
+ PinnedStableBalanceStatus,
+ WalletBalanceRow,
+} from 'services/copyTrading/types/copyRuns'
+import type { Address, CopyAccountStatus, ResponseMeta } from 'services/copyTrading/types/primitives'
+import type {
+ CopyAccountBalancesResponse,
+ CopyAccountResponse,
+ CopyAccountWalletInventoryResponse,
+ OwnerCopyAccountsResponse,
+ PendingSellObligationsResponse,
+} from 'services/copyTrading/types/responses'
+
+import { type ApiAgentSnapshot, toAgentSnapshot } from './agents'
+import {
+ type ApiCursorResponse,
+ type ApiMetric,
+ type ApiSingleResponse,
+ type ApiToken,
+ type ApiValuation,
+ chainIdNumber,
+ cursorResponse,
+ isValuationRenderable,
+ metricValue,
+ singleResponse,
+ toToken,
+} from './shared'
+
+type ApiCopyAccount = {
+ chainId?: string
+ copyAccount?: string
+ ownerAddress?: string
+ status?: string
+ activeCopyRuns?: ApiMetric
+ totalAllocatedUsd?: ApiMetric
+ portfolioValueUsd?: ApiMetric
+ availableBalanceUsd?: ApiMetric
+ realizedPnlUsd?: ApiMetric
+ unrealizedPnlUsd?: ApiMetric
+ openPositionCount?: ApiMetric
+ closedPositionCount?: ApiMetric
+ leftoverPositionCount?: ApiMetric
+ leftoverValueUsd?: ApiMetric
+ flatFeesCapturedUsd?: ApiMetric
+ cashbackReceivedUsd?: ApiMetric
+ netFeeCostUsd?: ApiMetric
+ estimatedCashbackPendingUsd?: ApiMetric
+ agentSnapshot?: ApiAgentSnapshot
+ copyRunId?: string
+ startedAt?: string
+ stoppedAt?: string
+ addCapitalAvailability?: AdvisoryActionAvailability
+ stopCopyAvailability?: AdvisoryActionAvailability
+ withdrawQuoteAvailability?: AdvisoryActionAvailability
+}
+
+type ApiWalletBalance = {
+ chainId?: string
+ copyAccount?: string
+ tokenAddress?: string
+ amountDecimal?: string
+ balanceSource?: string
+ freshnessStatus?: string
+ balanceAsOfBlock?: string
+ cachedAt?: string
+ stalenessReason?: string
+ token?: ApiToken
+ currentValuation?: ApiValuation
+}
+
+type ApiBalancesResponse = ApiCursorResponse & {
+ pinnedStableBalance?: {
+ status?: string
+ balance?: ApiWalletBalance
+ }
+}
+
+type ApiWalletInventoryResponse = {
+ data?: ApiWalletBalance[]
+ walletInventoryValueUsd?: ApiMetric
+ complete?: boolean
+ pinnedStableBalance?: ApiBalancesResponse['pinnedStableBalance']
+ meta?: ResponseMeta
+}
+
+const toCopyAccountStatus = (status?: string): CopyAccountStatus => {
+ const value = status?.replace('COPY_ACCOUNT_STATUS_', '').toLowerCase()
+ return (
+ value === 'active' || value === 'closing' || value === 'closed' || value === 'stopped' ? value : 'unknown'
+ ) as CopyAccountStatus
+}
+
+const toCopyAccount = (account: ApiCopyAccount): CopyAccountSummary => ({
+ chainId: chainIdNumber(account.chainId),
+ copyAccount: (account.copyAccount || '') as Address,
+ ownerAddress: (account.ownerAddress || '') as Address,
+ status: toCopyAccountStatus(account.status),
+ activeCopyRuns: metricValue(account.activeCopyRuns),
+ totalAllocatedUsd: metricValue(account.totalAllocatedUsd),
+ portfolioValueUsd: metricValue(account.portfolioValueUsd),
+ availableBalanceUsd: metricValue(account.availableBalanceUsd),
+ realizedPnlUsd: metricValue(account.realizedPnlUsd),
+ unrealizedPnlUsd: metricValue(account.unrealizedPnlUsd),
+ openPositionCount: metricValue(account.openPositionCount),
+ closedPositionCount: metricValue(account.closedPositionCount),
+ leftoverPositionCount: metricValue(account.leftoverPositionCount),
+ leftoverValueUsd: metricValue(account.leftoverValueUsd),
+ flatFeesCapturedUsd: metricValue(account.flatFeesCapturedUsd),
+ cashbackReceivedUsd: metricValue(account.cashbackReceivedUsd),
+ netFeeCostUsd: metricValue(account.netFeeCostUsd),
+ estimatedCashbackPendingUsd: metricValue(account.estimatedCashbackPendingUsd),
+ copyRunId: account.copyRunId,
+ startedAt: account.startedAt,
+ stoppedAt: account.stoppedAt,
+ addCapitalAvailability: account.addCapitalAvailability,
+ stopCopyAvailability: account.stopCopyAvailability,
+ withdrawQuoteAvailability: account.withdrawQuoteAvailability,
+ metrics: {
+ activeCopyRuns: account.activeCopyRuns,
+ totalAllocatedUsd: account.totalAllocatedUsd,
+ portfolioValueUsd: account.portfolioValueUsd,
+ availableBalanceUsd: account.availableBalanceUsd,
+ realizedPnlUsd: account.realizedPnlUsd,
+ unrealizedPnlUsd: account.unrealizedPnlUsd,
+ openPositionCount: account.openPositionCount,
+ closedPositionCount: account.closedPositionCount,
+ leftoverPositionCount: account.leftoverPositionCount,
+ leftoverValueUsd: account.leftoverValueUsd,
+ flatFeesCapturedUsd: account.flatFeesCapturedUsd,
+ cashbackReceivedUsd: account.cashbackReceivedUsd,
+ netFeeCostUsd: account.netFeeCostUsd,
+ estimatedCashbackPendingUsd: account.estimatedCashbackPendingUsd,
+ },
+ agentSnapshot: account.agentSnapshot ? toAgentSnapshot(account.agentSnapshot) : undefined,
+})
+
+const toWalletBalance = (balance: ApiWalletBalance): WalletBalanceRow => ({
+ chainId: chainIdNumber(balance.chainId),
+ copyAccount: (balance.copyAccount || '') as Address,
+ tokenAddress: (balance.tokenAddress || '') as Address,
+ amountDecimal: balance.amountDecimal || '0',
+ balanceSource: balance.balanceSource || '',
+ freshnessStatus: balance.freshnessStatus || '',
+ balanceAsOfBlock: balance.balanceAsOfBlock || '',
+ cachedAt: balance.cachedAt || '',
+ stalenessReason: balance.stalenessReason,
+ token: balance.token ? toToken(balance.token) : undefined,
+ valueUsd: isValuationRenderable(balance.currentValuation) ? balance.currentValuation?.valueUsd : undefined,
+ currentValuation: balance.currentValuation,
+})
+
+const toPinnedStableBalance = (pinnedStableBalance?: ApiBalancesResponse['pinnedStableBalance']) =>
+ pinnedStableBalance
+ ? {
+ status: pinnedStableBalance.status as PinnedStableBalanceStatus | undefined,
+ balance: pinnedStableBalance.balance ? toWalletBalance(pinnedStableBalance.balance) : undefined,
+ }
+ : undefined
+
+export const adaptCopyAccountsResponse = (response: ApiCursorResponse): OwnerCopyAccountsResponse =>
+ cursorResponse(response, toCopyAccount)
+
+export const adaptCopyAccountResponse = (response: ApiSingleResponse): CopyAccountResponse =>
+ singleResponse(response, toCopyAccount)
+
+export const adaptCopyAccountBalancesResponse = (response: ApiBalancesResponse): CopyAccountBalancesResponse => ({
+ ...cursorResponse(response, toWalletBalance),
+ pinnedStableBalance: toPinnedStableBalance(response.pinnedStableBalance),
+})
+
+export const adaptCopyAccountWalletInventoryResponse = (
+ response: ApiWalletInventoryResponse,
+): CopyAccountWalletInventoryResponse => ({
+ data: (response.data || []).map(toWalletBalance),
+ walletInventoryValueUsd: response.walletInventoryValueUsd,
+ complete: response.complete === true,
+ pinnedStableBalance: toPinnedStableBalance(response.pinnedStableBalance),
+ meta: response.meta,
+})
+
+export const adaptPendingSellObligationsResponse = (
+ response: ApiCursorResponse,
+): PendingSellObligationsResponse => cursorResponse(response, obligation => obligation)
diff --git a/apps/kyberswap-interface/src/services/copyTrading/adapters/copyRuns.ts b/apps/kyberswap-interface/src/services/copyTrading/adapters/copyRuns.ts
new file mode 100644
index 0000000000..a744b90885
--- /dev/null
+++ b/apps/kyberswap-interface/src/services/copyTrading/adapters/copyRuns.ts
@@ -0,0 +1,238 @@
+import type { AdvisoryActionAvailability } from 'services/copyTrading/types/actionAvailability'
+import type { CopyRunCashbackPolicy, CopyRunSummary, OwnerCopySummary } from 'services/copyTrading/types/copyRuns'
+import type {
+ Address,
+ CapitalInProjectionStatus,
+ CopyRunStatus,
+ CopyRunView,
+} from 'services/copyTrading/types/primitives'
+import type {
+ CopyRunCashbackPolicyResponse,
+ CopyRunResponse,
+ CopyRunsResponse,
+ OwnerCopySummaryResponse,
+} from 'services/copyTrading/types/responses'
+
+import { type ApiAgentMetrics, type ApiAgentSnapshot, toAgentSnapshot, toAgentStats } from './agents'
+import {
+ type ApiCursorResponse,
+ type ApiMetric,
+ type ApiSingleResponse,
+ chainIdNumber,
+ cursorResponse,
+ metricValue,
+ singleResponse,
+} from './shared'
+
+type ApiCopyRun = {
+ copyRunId?: string
+ ownerAddress?: string
+ agentId?: string
+ chainId?: string
+ copyAccount?: string
+ status?: string
+ capitalInProjectionStatus?: string
+ startedAt?: string
+ stoppedAt?: string
+ capitalInUsd?: ApiMetric
+ observedCapitalInUsd?: ApiMetric
+ capitalOutUsd?: ApiMetric
+ portfolioValueUsd?: ApiMetric
+ realizedPnlUsd?: ApiMetric
+ unrealizedPnlUsd?: ApiMetric
+ myAprSinceCopy?: ApiMetric
+ openPositionCount?: ApiMetric
+ closedPositionCount?: ApiMetric
+ leftoverPositionCount?: ApiMetric
+ leftoverValueUsd?: ApiMetric
+ durationSeconds?: string
+ durationAsOf?: string
+ flatFeesCapturedUsd?: ApiMetric
+ cashbackReceivedUsd?: ApiMetric
+ netFeeCostUsd?: ApiMetric
+ estimatedCashbackPendingUsd?: ApiMetric
+ agentSnapshot?: ApiAgentSnapshot
+ addCapitalAvailability?: AdvisoryActionAvailability
+ stopCopyAvailability?: AdvisoryActionAvailability
+ withdrawQuoteAvailability?: AdvisoryActionAvailability
+}
+
+type ApiCopyRunCashbackPolicy = {
+ copyRunId?: string
+ chainId?: string
+ copyAccount?: string
+ agentId?: string
+ capCashbackRatioRaw?: string
+ pnlRateRaw?: string
+ scope?: string
+ status?: string
+ selectionPolicyVersion?: string
+ cashbackFormulaVersion?: number
+ selectedAt?: string
+ invalidatedAt?: string
+ unavailableReason?: string
+ fallbackAt?: string
+}
+
+type ApiOwnerCopySummary = {
+ ownerAddress?: string
+ view?: string
+ totalAllocatedUsd?: ApiMetric
+ portfolioValueUsd?: ApiMetric
+ realizedPnlUsd?: ApiMetric
+ unrealizedPnlUsd?: ApiMetric
+ openPositionCount?: ApiMetric
+ activeCopyRuns?: ApiMetric
+ closedCopyRuns?: ApiMetric
+ closedPositionCount?: ApiMetric
+ closedCapitalUsd?: ApiMetric
+ leftoverPositionCount?: ApiMetric
+ leftoverValueUsd?: ApiMetric
+ flatFeesCapturedUsd?: ApiMetric
+ cashbackReceivedUsd?: ApiMetric
+ netFeeCostUsd?: ApiMetric
+ estimatedCashbackPendingUsd?: ApiMetric
+}
+
+const toCopyRunStatus = (status?: string): CopyRunStatus => {
+ const value = status?.replace('COPY_RUN_STATUS_', '').toLowerCase()
+ return (
+ value === 'active' || value === 'closing' || value === 'closed' || value === 'stopped' ? value : 'unknown'
+ ) as CopyRunStatus
+}
+
+const toCapitalInProjectionStatus = (status?: string): CapitalInProjectionStatus => {
+ const value = status
+ ?.replace('COPY_RUN_CAPITAL_IN_PROJECTION_STATUS_', '')
+ .replace('CAPITAL_IN_PROJECTION_STATUS_', '')
+ .toLowerCase()
+ return value === 'syncing' || value === 'ready' || value === 'unavailable' ? value : 'unknown'
+}
+
+const toCopyRun = (run: ApiCopyRun): CopyRunSummary => {
+ const capitalInProjectionStatus = toCapitalInProjectionStatus(run.capitalInProjectionStatus)
+ const observedCapitalInUsd = metricValue(run.observedCapitalInUsd)
+
+ return {
+ copyRunId: run.copyRunId || '',
+ ownerAddress: (run.ownerAddress || '') as Address,
+ agentId: run.agentId || run.agentSnapshot?.agentId || '',
+ chainId: chainIdNumber(run.chainId),
+ copyAccount: (run.copyAccount || '') as Address,
+ status: toCopyRunStatus(run.status),
+ capitalInProjectionStatus,
+ startedAt: run.startedAt || '',
+ stoppedAt: run.stoppedAt,
+ capitalInUsd: capitalInProjectionStatus === 'ready' ? metricValue(run.capitalInUsd) : undefined,
+ observedCapitalInUsd,
+ capitalOutUsd: metricValue(run.capitalOutUsd),
+ portfolioValueUsd: metricValue(run.portfolioValueUsd),
+ realizedPnlUsd: metricValue(run.realizedPnlUsd),
+ unrealizedPnlUsd: metricValue(run.unrealizedPnlUsd),
+ myAprSinceCopyPct: metricValue(run.myAprSinceCopy),
+ openPositionCount: metricValue(run.openPositionCount),
+ closedPositionCount: metricValue(run.closedPositionCount),
+ leftoverPositionCount: metricValue(run.leftoverPositionCount),
+ leftoverValueUsd: metricValue(run.leftoverValueUsd),
+ flatFeesCapturedUsd: metricValue(run.flatFeesCapturedUsd),
+ cashbackReceivedUsd: metricValue(run.cashbackReceivedUsd),
+ netFeeCostUsd: metricValue(run.netFeeCostUsd),
+ estimatedCashbackPendingUsd: metricValue(run.estimatedCashbackPendingUsd),
+ durationSeconds: run.durationSeconds,
+ durationAsOf: run.durationAsOf,
+ addCapitalAvailability: run.addCapitalAvailability,
+ stopCopyAvailability: run.stopCopyAvailability,
+ withdrawQuoteAvailability: run.withdrawQuoteAvailability,
+ metrics: {
+ capitalInUsd: run.capitalInUsd,
+ observedCapitalInUsd: run.observedCapitalInUsd,
+ capitalOutUsd: run.capitalOutUsd,
+ portfolioValueUsd: run.portfolioValueUsd,
+ realizedPnlUsd: run.realizedPnlUsd,
+ unrealizedPnlUsd: run.unrealizedPnlUsd,
+ myAprSinceCopy: run.myAprSinceCopy,
+ openPositionCount: run.openPositionCount,
+ closedPositionCount: run.closedPositionCount,
+ leftoverPositionCount: run.leftoverPositionCount,
+ leftoverValueUsd: run.leftoverValueUsd,
+ flatFeesCapturedUsd: run.flatFeesCapturedUsd,
+ cashbackReceivedUsd: run.cashbackReceivedUsd,
+ netFeeCostUsd: run.netFeeCostUsd,
+ estimatedCashbackPendingUsd: run.estimatedCashbackPendingUsd,
+ },
+ agentSnapshot: run.agentSnapshot ? toAgentSnapshot(run.agentSnapshot) : undefined,
+ agentStats: toAgentStats(run.agentSnapshot?.metrics as ApiAgentMetrics | undefined),
+ }
+}
+
+export const adaptOwnerCopySummaryResponse = (
+ response: ApiSingleResponse,
+): OwnerCopySummaryResponse =>
+ singleResponse(
+ response,
+ (summary): OwnerCopySummary => ({
+ ownerAddress: (summary.ownerAddress || '') as Address,
+ view: (summary.view === 'OWNER_COPY_VIEW_HISTORY' ? 'history' : 'open') as CopyRunView,
+ totalAllocatedUsd: metricValue(summary.totalAllocatedUsd),
+ portfolioValueUsd: metricValue(summary.portfolioValueUsd),
+ realizedPnlUsd: metricValue(summary.realizedPnlUsd),
+ unrealizedPnlUsd: metricValue(summary.unrealizedPnlUsd),
+ openPositions: metricValue(summary.openPositionCount),
+ activeCopies: metricValue(summary.activeCopyRuns),
+ closedCopies: metricValue(summary.closedCopyRuns),
+ closedPositions: metricValue(summary.closedPositionCount),
+ closedCapitalUsd: metricValue(summary.closedCapitalUsd),
+ leftoverPositions: metricValue(summary.leftoverPositionCount),
+ leftoverValueUsd: metricValue(summary.leftoverValueUsd),
+ flatFeesCapturedUsd: metricValue(summary.flatFeesCapturedUsd),
+ cashbackReceivedUsd: metricValue(summary.cashbackReceivedUsd),
+ netFeeCostUsd: metricValue(summary.netFeeCostUsd),
+ estimatedCashbackPendingUsd: metricValue(summary.estimatedCashbackPendingUsd),
+ metrics: {
+ totalAllocatedUsd: summary.totalAllocatedUsd,
+ portfolioValueUsd: summary.portfolioValueUsd,
+ realizedPnlUsd: summary.realizedPnlUsd,
+ unrealizedPnlUsd: summary.unrealizedPnlUsd,
+ openPositionCount: summary.openPositionCount,
+ activeCopyRuns: summary.activeCopyRuns,
+ closedCopyRuns: summary.closedCopyRuns,
+ closedPositionCount: summary.closedPositionCount,
+ closedCapitalUsd: summary.closedCapitalUsd,
+ leftoverPositionCount: summary.leftoverPositionCount,
+ leftoverValueUsd: summary.leftoverValueUsd,
+ flatFeesCapturedUsd: summary.flatFeesCapturedUsd,
+ cashbackReceivedUsd: summary.cashbackReceivedUsd,
+ netFeeCostUsd: summary.netFeeCostUsd,
+ estimatedCashbackPendingUsd: summary.estimatedCashbackPendingUsd,
+ },
+ }),
+ )
+
+export const adaptCopyRunsResponse = (response: ApiCursorResponse): CopyRunsResponse =>
+ cursorResponse(response, toCopyRun)
+
+export const adaptCopyRunResponse = (response: ApiSingleResponse): CopyRunResponse =>
+ singleResponse(response, toCopyRun)
+
+export const adaptCopyRunCashbackPolicyResponse = (
+ response: ApiSingleResponse,
+): CopyRunCashbackPolicyResponse =>
+ singleResponse(
+ response,
+ (policy): CopyRunCashbackPolicy => ({
+ copyRunId: policy.copyRunId || '',
+ chainId: chainIdNumber(policy.chainId),
+ copyAccount: (policy.copyAccount || '') as Address,
+ agentId: policy.agentId || '',
+ capCashbackRatioRaw: policy.capCashbackRatioRaw,
+ pnlRateRaw: policy.pnlRateRaw,
+ scope: policy.scope || 'COPY_RUN_CASHBACK_POLICY_SCOPE_UNSPECIFIED',
+ status: policy.status || 'COPY_RUN_CASHBACK_POLICY_STATUS_UNSPECIFIED',
+ selectionPolicyVersion: policy.selectionPolicyVersion,
+ cashbackFormulaVersion: policy.cashbackFormulaVersion,
+ selectedAt: policy.selectedAt,
+ invalidatedAt: policy.invalidatedAt,
+ unavailableReason: policy.unavailableReason,
+ fallbackAt: policy.fallbackAt,
+ }),
+ )
diff --git a/apps/kyberswap-interface/src/services/copyTrading/adapters/positions.ts b/apps/kyberswap-interface/src/services/copyTrading/adapters/positions.ts
new file mode 100644
index 0000000000..e2529688ae
--- /dev/null
+++ b/apps/kyberswap-interface/src/services/copyTrading/adapters/positions.ts
@@ -0,0 +1,210 @@
+import type { PositionEvent, PositionExitKind, PositionSummary } from 'services/copyTrading/types/positions'
+import type { Address, PositionLifecycle, PositionQuantityState } from 'services/copyTrading/types/primitives'
+import type {
+ AgentPositionEventsResponse,
+ AgentPositionResponse,
+ AgentPositionsResponse,
+ CopyAccountPositionsResponse,
+ CopyRunPositionsResponse,
+ OwnerPositionsResponse,
+} from 'services/copyTrading/types/responses'
+
+import {
+ type ApiCursorResponse,
+ type ApiMetric,
+ type ApiSingleResponse,
+ type ApiToken,
+ type ApiValuation,
+ chainIdNumber,
+ cursorResponse,
+ formatRawAmount,
+ isValuationRenderable,
+ metricValue,
+ singleResponse,
+ toToken,
+} from './shared'
+
+type ApiPosition = {
+ positionId?: string
+ userPositionId?: string
+ agentPositionId?: string
+ copyRunId?: string
+ agentId?: string
+ chainId?: string
+ copyAccount?: string
+ tradeId?: string
+ token?: ApiToken
+ lifecycle?: string
+ remainingBaseRaw?: string
+ totalGrossBaseBoughtRaw?: string
+ totalGrossBaseSoldRaw?: string
+ upfrontFeeCapturedBaseRaw?: string
+ upfrontFeeReleasedBaseRaw?: string
+ netBaseReceivedRaw?: string
+ remainingNetBaseRaw?: string
+ displayBaseRaw?: string
+ entryValuation?: ApiValuation
+ currentValuation?: ApiValuation
+ exitValuation?: ApiValuation
+ realizedPnlUsd?: ApiMetric
+ unrealizedPnlUsd?: ApiMetric
+ unrealizedPnlPct?: ApiMetric
+ flatFeeCapturedUsd?: ApiMetric
+ cashbackReceivedUsd?: ApiMetric
+ netFeeCostUsd?: ApiMetric
+ estimatedCashbackUsd?: ApiMetric
+ skippedSellCount?: ApiMetric
+ latestSkippedRatio?: ApiMetric
+ cumulativeSkippedRatio?: ApiMetric
+ quantityState?: string
+ exitKind?: string
+ actionKind?: string
+ availableActionKinds?: string[]
+ isLeftover?: boolean
+ leftoverReason?: string
+ leftoverValuation?: ApiValuation
+ latestSkipPublicErrorCode?: string
+ durationSeconds?: string
+ durationAsOf?: string
+ openedAt?: string
+ closedAt?: string
+}
+
+const toPositionLifecycle = (lifecycle?: string): PositionLifecycle => {
+ const value = lifecycle?.replace('POSITION_LIFECYCLE_', '').toLowerCase()
+ return value === 'active' || value === 'closing' || value === 'closed' ? value : 'unknown'
+}
+
+const toPositionQuantityState = (quantityState?: string): PositionQuantityState => {
+ const value = quantityState?.replace('POSITION_QUANTITY_STATE_', '').toLowerCase()
+ return value === 'open_full' || value === 'open_partial' || value === 'closed' ? value : 'unknown'
+}
+
+const toPositionStatus = (lifecycle: PositionLifecycle) =>
+ lifecycle === 'closed'
+ ? ('closed' as const)
+ : lifecycle === 'active' || lifecycle === 'closing'
+ ? ('open' as const)
+ : ('unknown' as const)
+
+const toPositionExitKind = (exitKind?: string): PositionExitKind | undefined => {
+ if (
+ exitKind === 'POSITION_EXIT_KIND_UNSPECIFIED' ||
+ exitKind === 'POSITION_EXIT_KIND_ALIGNED' ||
+ exitKind === 'POSITION_EXIT_KIND_MANUAL'
+ ) {
+ return exitKind
+ }
+
+ return undefined
+}
+
+const toPosition = (position: ApiPosition): PositionSummary => {
+ const token = toToken(position.token)
+ const amountRaw = position.displayBaseRaw || position.remainingBaseRaw || '0'
+ const lifecycle = toPositionLifecycle(position.lifecycle)
+
+ return {
+ positionId: position.positionId || '',
+ userPositionId: position.userPositionId,
+ agentPositionId: position.agentPositionId,
+ copyRunId: position.copyRunId,
+ agentId: position.agentId || '',
+ chainId: chainIdNumber(position.chainId),
+ copyAccount: position.copyAccount as Address | undefined,
+ tradeId: position.tradeId || '',
+ token,
+ status: toPositionStatus(lifecycle),
+ lifecycle,
+ amountRaw,
+ amountDecimal: formatRawAmount(amountRaw, token.decimals),
+ remainingBaseRaw: position.remainingBaseRaw,
+ totalGrossBaseBoughtRaw: position.totalGrossBaseBoughtRaw,
+ totalGrossBaseSoldRaw: position.totalGrossBaseSoldRaw,
+ upfrontFeeCapturedBaseRaw: position.upfrontFeeCapturedBaseRaw,
+ upfrontFeeReleasedBaseRaw: position.upfrontFeeReleasedBaseRaw,
+ netBaseReceivedRaw: position.netBaseReceivedRaw,
+ remainingNetBaseRaw: position.remainingNetBaseRaw,
+ displayBaseRaw: position.displayBaseRaw,
+ entryValuation: position.entryValuation,
+ currentValuation: position.currentValuation,
+ exitValuation: position.exitValuation,
+ entryPriceUsd: isValuationRenderable(position.entryValuation) ? position.entryValuation?.priceUsd : undefined,
+ currentPriceUsd: isValuationRenderable(position.currentValuation) ? position.currentValuation?.priceUsd : undefined,
+ exitPriceUsd: isValuationRenderable(position.exitValuation) ? position.exitValuation?.priceUsd : undefined,
+ valueUsd: isValuationRenderable(position.currentValuation)
+ ? position.currentValuation?.valueUsd
+ : isValuationRenderable(position.exitValuation)
+ ? position.exitValuation?.valueUsd
+ : undefined,
+ realizedPnlUsd: metricValue(position.realizedPnlUsd),
+ unrealizedPnlUsd: metricValue(position.unrealizedPnlUsd),
+ unrealizedPnlPct: metricValue(position.unrealizedPnlPct),
+ flatFeeCapturedUsd: metricValue(position.flatFeeCapturedUsd),
+ cashbackReceivedUsd: metricValue(position.cashbackReceivedUsd),
+ netFeeCostUsd: metricValue(position.netFeeCostUsd),
+ estimatedCashbackUsd: metricValue(position.estimatedCashbackUsd),
+ metrics: {
+ realizedPnlUsd: position.realizedPnlUsd,
+ unrealizedPnlUsd: position.unrealizedPnlUsd,
+ unrealizedPnlPct: position.unrealizedPnlPct,
+ flatFeeCapturedUsd: position.flatFeeCapturedUsd,
+ cashbackReceivedUsd: position.cashbackReceivedUsd,
+ netFeeCostUsd: position.netFeeCostUsd,
+ estimatedCashbackUsd: position.estimatedCashbackUsd,
+ skippedSellCount: position.skippedSellCount,
+ latestSkippedRatio: position.latestSkippedRatio,
+ cumulativeSkippedRatio: position.cumulativeSkippedRatio,
+ },
+ quantityState: toPositionQuantityState(position.quantityState),
+ exitKind: toPositionExitKind(position.exitKind),
+ actionKind: position.actionKind as PositionSummary['actionKind'],
+ availableActionKinds: (position.availableActionKinds || []) as PositionSummary['availableActionKinds'],
+ isLeftover: position.isLeftover,
+ leftoverReason: position.leftoverReason,
+ leftoverValuation: position.leftoverValuation,
+ latestSkipPublicErrorCode: position.latestSkipPublicErrorCode,
+ durationSeconds: position.durationSeconds,
+ durationAsOf: position.durationAsOf,
+ openedAt: position.openedAt || '',
+ closedAt: position.closedAt,
+ }
+}
+
+export const adaptPositionsResponse = (
+ response: ApiCursorResponse,
+): AgentPositionsResponse | CopyRunPositionsResponse | OwnerPositionsResponse | CopyAccountPositionsResponse =>
+ cursorResponse(response, toPosition)
+
+export const adaptPositionResponse = (response: ApiSingleResponse): AgentPositionResponse =>
+ singleResponse(response, toPosition)
+
+export const adaptPositionEventsResponse = (
+ response: ApiCursorResponse<{
+ eventId?: string
+ positionId?: string
+ chainId?: string
+ eventType?: string
+ summary?: string
+ occurredAt?: string
+ txHash?: string
+ blockNumber?: string
+ }>,
+): AgentPositionEventsResponse =>
+ cursorResponse(
+ response,
+ (event): PositionEvent => ({
+ eventId: event.eventId || '',
+ positionId: event.positionId || '',
+ activityType: event.eventType?.toLowerCase() || '',
+ chainId: chainIdNumber(event.chainId),
+ summary: event.summary || '',
+ occurredAt: event.occurredAt || '',
+ txHash: event.txHash,
+ blockNumber: event.blockNumber,
+ metadata: {
+ txHash: event.txHash,
+ blockNumber: event.blockNumber,
+ },
+ }),
+ )
diff --git a/apps/kyberswap-interface/src/services/copyTrading/adapters/shared.ts b/apps/kyberswap-interface/src/services/copyTrading/adapters/shared.ts
new file mode 100644
index 0000000000..4fef71b607
--- /dev/null
+++ b/apps/kyberswap-interface/src/services/copyTrading/adapters/shared.ts
@@ -0,0 +1,97 @@
+import type { Token } from 'services/copyTrading/types/agents'
+import type {
+ Address,
+ CursorPagination,
+ CursorResponse,
+ DataStatus,
+ Metric,
+ ResponseMeta,
+ SingleResponse,
+} from 'services/copyTrading/types/primitives'
+
+export type ApiMetric = Metric
+
+export type ApiValuation = {
+ valueUsd?: string
+ priceUsd?: string
+ priceSource?: string
+ priceAsOf?: string
+ asOf?: string
+ status?: DataStatus
+ isEstimated?: boolean
+ isFinal?: boolean
+}
+
+export type ApiToken = {
+ chainId?: string
+ address?: string
+ symbol?: string
+ name?: string
+ decimals?: number
+ logoUrl?: string
+}
+
+export type ApiSingleResponse = {
+ data?: T
+ meta?: ResponseMeta
+}
+
+export type ApiCursorResponse = {
+ data?: T[]
+ pagination?: Partial
+ meta?: ResponseMeta
+}
+
+export const isValuationRenderable = (valuation?: ApiValuation) =>
+ valuation?.status === 'DATA_STATUS_CURRENT' ||
+ valuation?.status === 'DATA_STATUS_STALE' ||
+ valuation?.isFinal === true
+
+export const metricValue = (metric?: ApiMetric) => {
+ const renderable = metric?.status === 'METRIC_STATUS_CURRENT' || metric?.status === 'METRIC_STATUS_STALE'
+ return renderable ? metric?.value : undefined
+}
+
+export const chainIdNumber = (chainId?: string) => Number(chainId || 0)
+
+export const toToken = (token?: ApiToken): Token => ({
+ chainId: chainIdNumber(token?.chainId),
+ address: (token?.address || '') as Address,
+ symbol: token?.symbol,
+ name: token?.name || token?.symbol,
+ decimals: token?.decimals,
+ iconUrl: token?.logoUrl,
+})
+
+export const formatRawAmount = (value: string, decimals?: number) => {
+ if (decimals === undefined) return undefined
+ if (!/^\d+$/.test(value) || decimals <= 0) return value
+
+ const padded = value.padStart(decimals + 1, '0')
+ const integer = padded.slice(0, -decimals)
+ const fraction = padded.slice(-decimals).replace(/0+$/, '')
+ return fraction ? integer + '.' + fraction : integer
+}
+
+const normalizePagination = (pagination?: Partial): CursorPagination => ({
+ nextCursor: pagination?.nextCursor,
+ hasMore: pagination?.hasMore === true,
+ limit: pagination?.limit || 25,
+})
+
+export const singleResponse = (
+ response: ApiSingleResponse,
+ transform: (value: ApiValue) => Value,
+): SingleResponse => ({
+ data: transform(response.data as ApiValue),
+ meta: response.meta,
+})
+
+export const cursorResponse = (
+ response: ApiCursorResponse,
+ transform: (value: ApiValue) => Value,
+): CursorResponse => ({
+ data: (response.data || []).map(transform),
+ pagination: normalizePagination(response.pagination),
+ meta: response.meta,
+})
diff --git a/apps/kyberswap-interface/src/services/copyTrading/api/baseApi.ts b/apps/kyberswap-interface/src/services/copyTrading/api/baseApi.ts
new file mode 100644
index 0000000000..98ded831af
--- /dev/null
+++ b/apps/kyberswap-interface/src/services/copyTrading/api/baseApi.ts
@@ -0,0 +1,17 @@
+import { createApi, fetchBaseQuery } from '@reduxjs/toolkit/query/react'
+
+const copyTradingBaseApi = createApi({
+ reducerPath: 'copyTradingApi',
+ tagTypes: ['CopyTrading'],
+ refetchOnMountOrArgChange: true,
+ baseQuery: fetchBaseQuery({
+ baseUrl: import.meta.env.VITE_COPY_TRADING_API_URL,
+ prepareHeaders: headers => {
+ headers.set('Accept', 'application/json')
+ return headers
+ },
+ }),
+ endpoints: () => ({}),
+})
+
+export default copyTradingBaseApi
diff --git a/apps/kyberswap-interface/src/services/copyTrading/api/endpoints/agents.ts b/apps/kyberswap-interface/src/services/copyTrading/api/endpoints/agents.ts
new file mode 100644
index 0000000000..216da098a8
--- /dev/null
+++ b/apps/kyberswap-interface/src/services/copyTrading/api/endpoints/agents.ts
@@ -0,0 +1,104 @@
+import { adaptActionLogsResponse } from 'services/copyTrading/adapters/activity'
+import {
+ adaptAgentResponse,
+ adaptAgentStatsResponse,
+ adaptAgentsResponse,
+ adaptPerformanceResponse,
+} from 'services/copyTrading/adapters/agents'
+import {
+ adaptPositionEventsResponse,
+ adaptPositionResponse,
+ adaptPositionsResponse,
+} from 'services/copyTrading/adapters/positions'
+import type {
+ AgentPerformanceQuery,
+ AgentPositionEventsQuery,
+ AgentPositionQuery,
+ AgentPositionsQuery,
+ AgentQuery,
+ AgentStatsQuery,
+ AgentsQuery,
+ CotLogsQuery,
+} from 'services/copyTrading/types/queries'
+import type {
+ AgentPerformanceResponse,
+ AgentPositionEventsResponse,
+ AgentPositionResponse,
+ AgentPositionsResponse,
+ AgentResponse,
+ AgentStatsResponse,
+ AgentsResponse,
+ CotLogsResponse,
+} from 'services/copyTrading/types/responses'
+
+import copyTradingBaseApi from '../baseApi'
+import { cleanParams, pathPart, performanceParams, performanceWindowMap, positionParams } from '../queryParams'
+
+const agentApi = copyTradingBaseApi.injectEndpoints({
+ endpoints: builder => ({
+ getAgents: builder.query({
+ query: query => ({
+ url: '/agents',
+ params: cleanParams({
+ chainId: query?.chainId,
+ search: query?.search,
+ strategyCategory: query?.strategy ? 'STRATEGY_CATEGORY_' + query.strategy.toUpperCase() : undefined,
+ cursor: query?.cursor,
+ limit: query?.limit,
+ }),
+ }),
+ transformResponse: adaptAgentsResponse,
+ }),
+ getAgent: builder.query({
+ query: ({ agentId }) => '/agents/' + pathPart(agentId),
+ transformResponse: adaptAgentResponse,
+ providesTags: ['CopyTrading'],
+ }),
+ getAgentStats: builder.query({
+ query: ({ agentId, window }) => ({
+ url: '/agents/' + pathPart(agentId) + '/stats',
+ params: cleanParams({ window: window ? performanceWindowMap[window] : undefined }),
+ }),
+ transformResponse: adaptAgentStatsResponse,
+ providesTags: ['CopyTrading'],
+ }),
+ getAgentPerformance: builder.query({
+ query: query => ({
+ url: '/agents/' + pathPart(query.agentId) + '/performance',
+ params: performanceParams(query),
+ }),
+ transformResponse: adaptPerformanceResponse,
+ providesTags: ['CopyTrading'],
+ }),
+ getAgentPositions: builder.query({
+ query: query => ({
+ url: '/agents/' + pathPart(query.agentId) + '/positions',
+ params: {
+ ...positionParams(query),
+ ...cleanParams({ token: query.token }),
+ },
+ }),
+ transformResponse: adaptPositionsResponse,
+ }),
+ getAgentPosition: builder.query({
+ query: ({ agentId, positionId }) => '/agents/' + pathPart(agentId) + '/positions/' + pathPart(positionId),
+ transformResponse: adaptPositionResponse,
+ }),
+ getAgentPositionEvents: builder.query({
+ query: ({ agentId, positionId, cursor, limit }) => ({
+ url: '/agents/' + pathPart(agentId) + '/positions/' + pathPart(positionId) + '/events',
+ params: cleanParams({ cursor, limit }),
+ }),
+ transformResponse: adaptPositionEventsResponse,
+ }),
+ getAgentActionLogs: builder.query({
+ query: ({ agentId, leaderPositionId, type, groupBy, from, to, cursor, limit }) => ({
+ url: '/agents/' + pathPart(agentId) + '/action-logs',
+ params: cleanParams({ leaderPositionId, type, groupBy, from, to, cursor, limit }),
+ }),
+ transformResponse: adaptActionLogsResponse,
+ }),
+ }),
+})
+
+export default agentApi
diff --git a/apps/kyberswap-interface/src/services/copyTrading/api/endpoints/copyAccounts.ts b/apps/kyberswap-interface/src/services/copyTrading/api/endpoints/copyAccounts.ts
new file mode 100644
index 0000000000..818ef083ce
--- /dev/null
+++ b/apps/kyberswap-interface/src/services/copyTrading/api/endpoints/copyAccounts.ts
@@ -0,0 +1,88 @@
+import { adaptActivityResponse } from 'services/copyTrading/adapters/activity'
+import {
+ adaptCopyAccountBalancesResponse,
+ adaptCopyAccountResponse,
+ adaptCopyAccountWalletInventoryResponse,
+ adaptPendingSellObligationsResponse,
+} from 'services/copyTrading/adapters/copyAccounts'
+import { adaptPositionsResponse } from 'services/copyTrading/adapters/positions'
+import type {
+ CopyAccountBalancesQuery,
+ CopyAccountHistoryQuery,
+ CopyAccountPositionsQuery,
+ CopyAccountQuery,
+ PendingSellObligationsQuery,
+} from 'services/copyTrading/types/queries'
+import type {
+ CopyAccountBalancesResponse,
+ CopyAccountHistoryResponse,
+ CopyAccountPositionsResponse,
+ CopyAccountResponse,
+ CopyAccountWalletInventoryResponse,
+ PendingSellObligationsResponse,
+} from 'services/copyTrading/types/responses'
+
+import copyTradingBaseApi from '../baseApi'
+import { activityGroupMap, cleanParams, pathPart, positionParams } from '../queryParams'
+
+const copyAccountApi = copyTradingBaseApi.injectEndpoints({
+ endpoints: builder => ({
+ getCopyAccount: builder.query({
+ query: ({ chainId, copyAccount }) => '/copy-accounts/' + pathPart(chainId) + '/' + pathPart(copyAccount),
+ transformResponse: adaptCopyAccountResponse,
+ providesTags: ['CopyTrading'],
+ }),
+ getCopyAccountBalances: builder.query({
+ query: ({ chainId, copyAccount, cursor, limit }) => ({
+ url: '/copy-accounts/' + pathPart(chainId) + '/' + pathPart(copyAccount) + '/balances',
+ params: cleanParams({ cursor, limit }),
+ }),
+ transformResponse: adaptCopyAccountBalancesResponse,
+ providesTags: ['CopyTrading'],
+ }),
+ getCopyAccountWalletInventory: builder.query({
+ query: ({ chainId, copyAccount }) =>
+ '/copy-accounts/' + pathPart(chainId) + '/' + pathPart(copyAccount) + '/wallet-inventory',
+ transformResponse: adaptCopyAccountWalletInventoryResponse,
+ providesTags: ['CopyTrading'],
+ }),
+ getCopyAccountPositions: builder.query({
+ query: query => ({
+ url: '/copy-accounts/' + pathPart(query.chainId) + '/' + pathPart(query.copyAccount) + '/positions',
+ params: positionParams(query),
+ }),
+ transformResponse: adaptPositionsResponse,
+ providesTags: ['CopyTrading'],
+ }),
+ getPendingSellObligations: builder.query({
+ query: ({ chainId, copyAccount, userPositionId, cursor, limit }) => ({
+ url:
+ '/copy-accounts/' +
+ pathPart(chainId) +
+ '/' +
+ pathPart(copyAccount) +
+ '/positions/' +
+ pathPart(userPositionId) +
+ '/pending-sell-obligations',
+ params: cleanParams({ cursor, limit }),
+ }),
+ transformResponse: adaptPendingSellObligationsResponse,
+ providesTags: ['CopyTrading'],
+ }),
+ getCopyAccountHistory: builder.query({
+ query: ({ chainId, copyAccount, activityType, group, cursor, limit }) => ({
+ url: '/copy-accounts/' + pathPart(chainId) + '/' + pathPart(copyAccount) + '/history',
+ params: cleanParams({
+ type: activityType && activityType !== 'all' ? 'ACTIVITY_TYPE_' + activityType.toUpperCase() : undefined,
+ group: group ? activityGroupMap[group] : undefined,
+ cursor,
+ limit,
+ }),
+ }),
+ transformResponse: adaptActivityResponse,
+ providesTags: ['CopyTrading'],
+ }),
+ }),
+})
+
+export default copyAccountApi
diff --git a/apps/kyberswap-interface/src/services/copyTrading/api/endpoints/copyRuns.ts b/apps/kyberswap-interface/src/services/copyTrading/api/endpoints/copyRuns.ts
new file mode 100644
index 0000000000..1252b25bed
--- /dev/null
+++ b/apps/kyberswap-interface/src/services/copyTrading/api/endpoints/copyRuns.ts
@@ -0,0 +1,141 @@
+import { adaptActivityResponse } from 'services/copyTrading/adapters/activity'
+import { adaptPerformanceResponse } from 'services/copyTrading/adapters/agents'
+import { adaptCopyAccountsResponse } from 'services/copyTrading/adapters/copyAccounts'
+import {
+ adaptCopyRunCashbackPolicyResponse,
+ adaptCopyRunResponse,
+ adaptCopyRunsResponse,
+ adaptOwnerCopySummaryResponse,
+} from 'services/copyTrading/adapters/copyRuns'
+import { adaptPositionsResponse } from 'services/copyTrading/adapters/positions'
+import type {
+ CopyRunPerformanceQuery,
+ CopyRunPositionsQuery,
+ CopyRunQuery,
+ CopyRunsQuery,
+ OwnerActivityQuery,
+ OwnerCopyAccountsQuery,
+ OwnerCopySummaryQuery,
+ OwnerPositionsQuery,
+} from 'services/copyTrading/types/queries'
+import type {
+ CopyRunCashbackPolicyResponse,
+ CopyRunPerformanceResponse,
+ CopyRunPositionsResponse,
+ CopyRunResponse,
+ CopyRunsResponse,
+ OwnerActivityResponse,
+ OwnerCopyAccountsResponse,
+ OwnerCopySummaryResponse,
+ OwnerPositionsResponse,
+} from 'services/copyTrading/types/responses'
+
+import copyTradingBaseApi from '../baseApi'
+import {
+ activityGroupMap,
+ cleanParams,
+ copyAccountStatusMap,
+ copyRunSortMap,
+ ownerViewMap,
+ pathPart,
+ performanceParams,
+ positionParams,
+ sortOrderMap,
+} from '../queryParams'
+
+const copyRunApi = copyTradingBaseApi.injectEndpoints({
+ endpoints: builder => ({
+ getOwnerCopySummary: builder.query({
+ query: ({ ownerAddress, view, chainId }) => ({
+ url: '/users/' + pathPart(ownerAddress) + '/copy-summary',
+ params: cleanParams({ view: ownerViewMap[view], chainId }),
+ }),
+ transformResponse: adaptOwnerCopySummaryResponse,
+ providesTags: ['CopyTrading'],
+ }),
+ getCopyRuns: builder.query({
+ query: ({ ownerAddress, view, agentId, chainId, sortBy, sortOrder, cursor, limit }) => ({
+ url: '/users/' + pathPart(ownerAddress) + '/copy-runs',
+ params: cleanParams({
+ view: ownerViewMap[view],
+ agentId,
+ chainId,
+ sortBy: sortBy ? copyRunSortMap[sortBy] : undefined,
+ sortOrder: sortOrder ? sortOrderMap[sortOrder] : undefined,
+ cursor,
+ limit,
+ }),
+ }),
+ transformResponse: adaptCopyRunsResponse,
+ providesTags: ['CopyTrading'],
+ }),
+ getCopyRun: builder.query({
+ query: ({ ownerAddress, copyRunId }) => '/users/' + pathPart(ownerAddress) + '/copy-runs/' + pathPart(copyRunId),
+ transformResponse: adaptCopyRunResponse,
+ providesTags: ['CopyTrading'],
+ }),
+ getCopyRunCashbackPolicy: builder.query({
+ query: ({ ownerAddress, copyRunId }) =>
+ '/users/' + pathPart(ownerAddress) + '/copy-runs/' + pathPart(copyRunId) + '/cashback-policy',
+ transformResponse: adaptCopyRunCashbackPolicyResponse,
+ providesTags: ['CopyTrading'],
+ }),
+ getCopyRunPositions: builder.query({
+ query: query => ({
+ url: '/users/' + pathPart(query.ownerAddress) + '/copy-runs/' + pathPart(query.copyRunId) + '/positions',
+ params: positionParams(query),
+ }),
+ transformResponse: adaptPositionsResponse,
+ providesTags: ['CopyTrading'],
+ }),
+ getCopyRunPerformance: builder.query({
+ query: query => ({
+ url: '/users/' + pathPart(query.ownerAddress) + '/copy-runs/' + pathPart(query.copyRunId) + '/performance',
+ params: performanceParams(query),
+ }),
+ transformResponse: adaptPerformanceResponse,
+ providesTags: ['CopyTrading'],
+ }),
+ getOwnerPositions: builder.query({
+ query: query => ({
+ url: '/users/' + pathPart(query.ownerAddress) + '/positions',
+ params: {
+ ...positionParams(query),
+ ...cleanParams({ agentId: query.agentId, chainId: query.chainId }),
+ },
+ }),
+ transformResponse: adaptPositionsResponse,
+ providesTags: ['CopyTrading'],
+ }),
+ getOwnerActivity: builder.query({
+ query: ({ ownerAddress, copyRunId, chainId, activityType, group, cursor, limit }) => ({
+ url: '/users/' + pathPart(ownerAddress) + '/activity',
+ params: cleanParams({
+ copyRunId,
+ chainId,
+ type: activityType && activityType !== 'all' ? 'ACTIVITY_TYPE_' + activityType.toUpperCase() : undefined,
+ group: group ? activityGroupMap[group] : undefined,
+ cursor,
+ limit,
+ }),
+ }),
+ transformResponse: adaptActivityResponse,
+ providesTags: ['CopyTrading'],
+ }),
+ getOwnerCopyAccounts: builder.query({
+ query: ({ ownerAddress, chainId, status, cursor, limit }) => ({
+ url: '/users/' + pathPart(ownerAddress) + '/copy-accounts',
+ params: cleanParams({
+ chainId,
+ status: status && status !== 'all' ? copyAccountStatusMap[status] : undefined,
+ cursor,
+ limit,
+ }),
+ }),
+ transformResponse: adaptCopyAccountsResponse,
+ providesTags: ['CopyTrading'],
+ }),
+ }),
+})
+
+export default copyRunApi
diff --git a/apps/kyberswap-interface/src/services/copyTrading/api/endpoints/discovery.ts b/apps/kyberswap-interface/src/services/copyTrading/api/endpoints/discovery.ts
new file mode 100644
index 0000000000..2f4efa5ba9
--- /dev/null
+++ b/apps/kyberswap-interface/src/services/copyTrading/api/endpoints/discovery.ts
@@ -0,0 +1,53 @@
+import {
+ adaptChainsResponse,
+ adaptLeaderboardResponse,
+ adaptLeaderboardSummaryResponse,
+} from 'services/copyTrading/adapters/agents'
+import type { LeaderboardQuery, LeaderboardSummaryQuery } from 'services/copyTrading/types/queries'
+import type {
+ ChainsResponse,
+ LeaderboardResponse,
+ LeaderboardSummaryResponse,
+} from 'services/copyTrading/types/responses'
+
+import copyTradingBaseApi from '../baseApi'
+import { cleanParams, leaderboardSortMap, sortOrderMap } from '../queryParams'
+
+const discoveryApi = copyTradingBaseApi.injectEndpoints({
+ endpoints: builder => ({
+ getChains: builder.query({
+ query: () => '/chains',
+ transformResponse: adaptChainsResponse,
+ }),
+ getLeaderboardSummary: builder.query({
+ query: query => ({
+ url: '/leaderboard/summary',
+ params: cleanParams({
+ chainId: query?.chainId,
+ search: query?.search,
+ strategyCategory: query?.strategy ? 'STRATEGY_CATEGORY_' + query.strategy.toUpperCase() : undefined,
+ }),
+ }),
+ transformResponse: adaptLeaderboardSummaryResponse,
+ providesTags: ['CopyTrading'],
+ }),
+ getLeaderboard: builder.query({
+ query: query => ({
+ url: '/leaderboard',
+ params: cleanParams({
+ chainId: query?.chainId,
+ search: query?.search,
+ strategyCategory: query?.strategy ? 'STRATEGY_CATEGORY_' + query.strategy.toUpperCase() : undefined,
+ sortBy: query?.sortBy ? leaderboardSortMap[query.sortBy] : undefined,
+ sortOrder: query?.sortOrder ? sortOrderMap[query.sortOrder] : undefined,
+ cursor: query?.cursor,
+ limit: query?.limit,
+ }),
+ }),
+ transformResponse: adaptLeaderboardResponse,
+ providesTags: ['CopyTrading'],
+ }),
+ }),
+})
+
+export default discoveryApi
diff --git a/apps/kyberswap-interface/src/services/copyTrading/api/endpoints/preparedActions.ts b/apps/kyberswap-interface/src/services/copyTrading/api/endpoints/preparedActions.ts
new file mode 100644
index 0000000000..01ac8fda89
--- /dev/null
+++ b/apps/kyberswap-interface/src/services/copyTrading/api/endpoints/preparedActions.ts
@@ -0,0 +1,87 @@
+import type {
+ PrepareAddCapitalRequest,
+ PrepareAddCapitalResponse,
+ PrepareClosePositionRequest,
+ PrepareClosePositionResponse,
+ PrepareManualSellRequest,
+ PrepareManualSellResponse,
+ PrepareStartCopyRequest,
+ PrepareStartCopyResponse,
+ PrepareStopCopyRequest,
+ PrepareStopCopyResponse,
+ PrepareWithdrawQuoteRequest,
+ PrepareWithdrawQuoteResponse,
+} from 'services/copyTrading/types/preparedActions'
+
+import copyTradingBaseApi from '../baseApi'
+import { pathPart } from '../queryParams'
+
+const preparedActionApi = copyTradingBaseApi.injectEndpoints({
+ endpoints: builder => ({
+ prepareStartCopy: builder.mutation({
+ query: ({ ownerAddress, agentId, ...body }) => ({
+ url: '/users/' + pathPart(ownerAddress) + '/agents/' + pathPart(agentId) + ':prepareStartCopy',
+ method: 'POST',
+ body,
+ }),
+ }),
+ prepareAddCapital: builder.mutation({
+ query: ({ ownerAddress, copyRunId, ...body }) => ({
+ url: '/users/' + pathPart(ownerAddress) + '/copy-runs/' + pathPart(copyRunId) + ':prepareAddCapital',
+ method: 'POST',
+ body,
+ }),
+ }),
+ prepareStopCopy: builder.mutation({
+ query: ({ ownerAddress, copyRunId, ...body }) => ({
+ url: '/users/' + pathPart(ownerAddress) + '/copy-runs/' + pathPart(copyRunId) + ':prepareStopCopy',
+ method: 'POST',
+ body,
+ }),
+ }),
+ prepareWithdrawQuote: builder.mutation({
+ query: ({ ownerAddress, copyRunId }) => ({
+ url: '/users/' + pathPart(ownerAddress) + '/copy-runs/' + pathPart(copyRunId) + ':prepareWithdrawQuote',
+ method: 'POST',
+ body: {},
+ }),
+ }),
+ prepareManualSell: builder.mutation({
+ query: ({
+ ownerAddress,
+ copyRunId,
+ userPositionId,
+ slippageBps,
+ expectedUnresolvedSkipCount,
+ expectedSellRatioRaw,
+ }) => ({
+ url:
+ '/users/' +
+ pathPart(ownerAddress) +
+ '/copy-runs/' +
+ pathPart(copyRunId) +
+ '/positions/' +
+ pathPart(userPositionId) +
+ ':prepareManualSell',
+ method: 'POST',
+ body: { slippageBps, expectedUnresolvedSkipCount, expectedSellRatioRaw },
+ }),
+ }),
+ prepareClosePosition: builder.mutation({
+ query: ({ ownerAddress, copyRunId, userPositionId, slippageBps }) => ({
+ url:
+ '/users/' +
+ pathPart(ownerAddress) +
+ '/copy-runs/' +
+ pathPart(copyRunId) +
+ '/positions/' +
+ pathPart(userPositionId) +
+ ':prepareClosePosition',
+ method: 'POST',
+ body: { slippageBps },
+ }),
+ }),
+ }),
+})
+
+export default preparedActionApi
diff --git a/apps/kyberswap-interface/src/services/copyTrading/api/queryParams.ts b/apps/kyberswap-interface/src/services/copyTrading/api/queryParams.ts
new file mode 100644
index 0000000000..9c32f78ecc
--- /dev/null
+++ b/apps/kyberswap-interface/src/services/copyTrading/api/queryParams.ts
@@ -0,0 +1,135 @@
+import type {
+ CopyRunSortBy,
+ LeaderboardSortBy,
+ PerformanceInterval,
+ PerformanceSeries,
+ PerformanceWindow,
+ PositionSortBy,
+ PositionStatusFilter,
+ SortOrder,
+} from 'services/copyTrading/types/primitives'
+
+type QueryParam = string | number | boolean
+type QueryParams = Record
+
+export const cleanParams = (params: QueryParams = {}) =>
+ Object.fromEntries(Object.entries(params).filter(([, value]) => value !== undefined && value !== ''))
+
+export const pathPart = (value: string | number) => encodeURIComponent(String(value))
+
+export const sortOrderMap: Record = {
+ asc: 'SORT_ORDER_ASC',
+ desc: 'SORT_ORDER_DESC',
+}
+
+export const leaderboardSortMap: Record = {
+ apr_30d_pct: 'LEADERBOARD_SORT_FIELD_APR_30D',
+ win_rate_pct: 'LEADERBOARD_SORT_FIELD_WIN_RATE',
+ volume_usd: 'LEADERBOARD_SORT_FIELD_LIFETIME_VOLUME',
+ copiers: 'LEADERBOARD_SORT_FIELD_COPIERS',
+ aum_usd: 'LEADERBOARD_SORT_FIELD_AUM',
+ open_positions: 'LEADERBOARD_SORT_FIELD_OPEN_POSITIONS',
+}
+
+const positionSortMap: Record = {
+ opened_at: 'POSITION_SORT_FIELD_OPENED_AT',
+ closed_at: 'POSITION_SORT_FIELD_CLOSED_AT',
+ value_usd: 'POSITION_SORT_FIELD_VALUE_USD',
+}
+
+const positionViewMap: Record = {
+ all: undefined,
+ open: 'POSITION_VIEW_OPEN',
+ closed: 'POSITION_VIEW_CLOSED',
+ leftover: 'POSITION_VIEW_LEFTOVER',
+}
+
+const performanceSeriesMap: Record = {
+ portfolio_value: 'PERFORMANCE_SERIES_PORTFOLIO_EQUITY',
+ cumulative_realized_pnl: 'PERFORMANCE_SERIES_CUMULATIVE_REALIZED_PNL',
+ period_realized_pnl: 'PERFORMANCE_SERIES_PERIOD_REALIZED_PNL',
+ per_trade_realized_pnl: 'PERFORMANCE_SERIES_PER_TRADE_REALIZED_PNL',
+}
+
+export const performanceWindowMap: Record = {
+ '7d': 'WINDOW_7D',
+ '30d': 'WINDOW_30D',
+ '90d': 'WINDOW_90D',
+ all: 'WINDOW_ALL',
+}
+
+const performanceIntervalMap: Record = {
+ day: 'PERFORMANCE_INTERVAL_DAY',
+ week: 'PERFORMANCE_INTERVAL_WEEK',
+ month: 'PERFORMANCE_INTERVAL_MONTH',
+}
+
+export const activityGroupMap = {
+ buys: 'ACTIVITY_GROUP_BUYS',
+ sells: 'ACTIVITY_GROUP_SELLS',
+ deposits_withdrawals: 'ACTIVITY_GROUP_DEPOSITS_WITHDRAWALS',
+ skipped: 'ACTIVITY_GROUP_SKIPPED',
+}
+
+export const copyRunSortMap: Record = {
+ started_at: 'OWNER_COPY_RUN_SORT_FIELD_STARTED_AT',
+ stopped_at: 'OWNER_COPY_RUN_SORT_FIELD_STOPPED_AT',
+ agent_apr_30d: 'OWNER_COPY_RUN_SORT_FIELD_AGENT_APR_30D',
+ agent_win_rate: 'OWNER_COPY_RUN_SORT_FIELD_AGENT_WIN_RATE',
+ agent_volume: 'OWNER_COPY_RUN_SORT_FIELD_AGENT_LIFETIME_VOLUME',
+ capital_in: 'OWNER_COPY_RUN_SORT_FIELD_CAPITAL_IN',
+}
+
+export const ownerViewMap = {
+ open: 'OWNER_COPY_VIEW_OPEN',
+ history: 'OWNER_COPY_VIEW_HISTORY',
+}
+
+export const copyAccountStatusMap = {
+ active: 'COPY_ACCOUNT_STATUS_ACTIVE',
+ closed: 'COPY_ACCOUNT_STATUS_CLOSED',
+ closing: 'COPY_ACCOUNT_STATUS_CLOSING',
+ stopped: 'COPY_ACCOUNT_STATUS_STOPPED',
+}
+
+export const performanceParams = ({
+ series,
+ window,
+ interval,
+ cursor,
+ limit,
+}: {
+ series?: PerformanceSeries
+ window?: PerformanceWindow
+ interval?: PerformanceInterval
+ cursor?: string
+ limit?: number
+}) =>
+ cleanParams({
+ series: series ? performanceSeriesMap[series] : undefined,
+ window: window ? performanceWindowMap[window] : undefined,
+ interval: interval ? performanceIntervalMap[interval] : undefined,
+ cursor,
+ limit,
+ })
+
+export const positionParams = ({
+ status,
+ sortBy,
+ sortOrder,
+ cursor,
+ limit,
+}: {
+ status?: PositionStatusFilter
+ sortBy?: PositionSortBy
+ sortOrder?: SortOrder
+ cursor?: string
+ limit?: number
+}) =>
+ cleanParams({
+ view: status ? positionViewMap[status] : undefined,
+ sortBy: sortBy ? positionSortMap[sortBy] : undefined,
+ sortOrder: sortOrder ? sortOrderMap[sortOrder] : undefined,
+ cursor,
+ limit,
+ })
diff --git a/apps/kyberswap-interface/src/services/copyTrading/types/actionAvailability.ts b/apps/kyberswap-interface/src/services/copyTrading/types/actionAvailability.ts
new file mode 100644
index 0000000000..1119ae0016
--- /dev/null
+++ b/apps/kyberswap-interface/src/services/copyTrading/types/actionAvailability.ts
@@ -0,0 +1,45 @@
+import type { Timestamp } from './primitives'
+
+export type PreparedActionReason =
+ | 'PREPARED_ACTION_REASON_UNSPECIFIED'
+ | 'PREPARED_ACTION_REASON_ALREADY_ACTIVE'
+ | 'PREPARED_ACTION_REASON_NOT_CURRENT_OWNER'
+ | 'PREPARED_ACTION_REASON_ACCOUNT_NOT_ACTIVE'
+ | 'PREPARED_ACTION_REASON_ACCOUNT_NOT_STOPPED'
+ | 'PREPARED_ACTION_REASON_ACCOUNT_PERMANENTLY_PAUSED'
+ | 'PREPARED_ACTION_REASON_EXIT_IN_PROGRESS'
+ | 'PREPARED_ACTION_REASON_EXIT_NOT_TERMINAL'
+ | 'PREPARED_ACTION_REASON_SOURCE_STALE'
+ | 'PREPARED_ACTION_REASON_SOURCE_COVERAGE_PENDING'
+ | 'PREPARED_ACTION_REASON_FACTORY_PAUSED'
+ | 'PREPARED_ACTION_REASON_FEE_POLICY_CHANGED'
+ | 'PREPARED_ACTION_REASON_SIGNER_POLICY_CHANGED'
+ | 'PREPARED_ACTION_REASON_REQUEST_ID_CONFLICT'
+ | 'PREPARED_ACTION_REASON_UNSUPPORTED_ACCOUNT_GENERATION'
+ | 'PREPARED_ACTION_REASON_NO_QUOTE_BALANCE'
+ | 'PREPARED_ACTION_REASON_INSUFFICIENT_QUOTE_BALANCE'
+ | 'PREPARED_ACTION_REASON_INSUFFICIENT_QUOTE_ALLOWANCE'
+ | 'PREPARED_ACTION_REASON_CONTROLLER_PAUSED'
+ | 'PREPARED_ACTION_REASON_COPY_RUN_STOPPED'
+ | 'PREPARED_ACTION_REASON_UNSUPPORTED_QUOTE_TOKEN'
+ | 'PREPARED_ACTION_REASON_AMOUNT_BELOW_MINIMUM'
+ | 'PREPARED_ACTION_REASON_INVALID_STOP_INTENT'
+ | 'PREPARED_ACTION_REASON_NO_EXECUTABLE_ROUTE'
+ | 'PREPARED_ACTION_REASON_INNER_CALL_REVERTED'
+ | 'PREPARED_ACTION_REASON_NO_SELLABLE_BASE'
+ | 'PREPARED_ACTION_REASON_NO_PENDING_SELL_OBLIGATION'
+ | 'PREPARED_ACTION_REASON_SELL_OBLIGATION_CHANGED'
+ | 'PREPARED_ACTION_REASON_POSITION_NOT_OPEN'
+ | 'PREPARED_ACTION_REASON_CLOSE_NOT_ELIGIBLE'
+
+export type AdvisoryActionStatus =
+ | 'ADVISORY_ACTION_STATUS_UNSPECIFIED'
+ | 'ADVISORY_ACTION_STATUS_AVAILABLE'
+ | 'ADVISORY_ACTION_STATUS_PENDING'
+ | 'ADVISORY_ACTION_STATUS_UNAVAILABLE'
+
+export type AdvisoryActionAvailability = {
+ status?: AdvisoryActionStatus
+ reason?: PreparedActionReason
+ asOf?: Timestamp
+}
diff --git a/apps/kyberswap-interface/src/services/copyTrading/types/agents.ts b/apps/kyberswap-interface/src/services/copyTrading/types/agents.ts
new file mode 100644
index 0000000000..edaf814646
--- /dev/null
+++ b/apps/kyberswap-interface/src/services/copyTrading/types/agents.ts
@@ -0,0 +1,134 @@
+import type { AdvisoryActionAvailability } from './actionAvailability'
+import type {
+ Address,
+ DecimalString,
+ Metric,
+ PerformanceInterval,
+ PerformanceSeries,
+ StrategyKey,
+ Timestamp,
+} from './primitives'
+
+export type StrategyCategory =
+ | 'STRATEGY_CATEGORY_UNSPECIFIED'
+ | 'STRATEGY_CATEGORY_FOCUSED'
+ | 'STRATEGY_CATEGORY_DIVERSIFIED'
+ | 'STRATEGY_CATEGORY_ACTIVE'
+
+export type Chain = {
+ chainId: number
+ slug: string
+ name: string
+ iconUrl: string
+ isEnabled: boolean
+}
+
+export type Token = {
+ chainId: number
+ address: Address
+ symbol?: string
+ name?: string
+ decimals?: number
+ iconUrl?: string
+}
+
+export type AgentMetrics = {
+ apr30d?: Metric
+ winRatePct?: Metric
+ lifetimeVolumeUsd?: Metric
+ copiers?: Metric
+ aumUsd?: Metric
+ openPositions?: Metric
+ totalRealizedPnlUsd?: Metric
+ maxDrawdownPct?: Metric
+ winningPositionCount?: Metric
+ losingPositionCount?: Metric
+ breakevenPositionCount?: Metric
+ closedPositionCount?: Metric
+}
+
+export type AgentStats = {
+ apr30dPct?: DecimalString
+ winRatePct?: DecimalString
+ volumeUsd?: DecimalString
+ copiers?: DecimalString
+ aumUsd?: DecimalString
+ openPositions?: DecimalString
+ totalRealizedPnlUsd?: DecimalString
+ maxDrawdownPct?: DecimalString
+ metrics: AgentMetrics
+}
+
+export type StrategyExecutionItem = {
+ label: string
+ description: string
+}
+
+export type AgentCard = {
+ agentId: string
+ chainId: number
+ leaderAddress: Address
+ displayName: string
+ avatarUrl?: string
+ isVerified: boolean
+ badges: string[]
+ isTrending: boolean
+ strategy: StrategyKey
+ strategyLabel?: string
+ strategyCategories: StrategyCategory[]
+ modelName: string
+ stats: AgentStats
+ flatFeeRatePct?: DecimalString
+ flatFeeRatePctMetric?: Metric
+ startCopyAvailability?: AdvisoryActionAvailability
+ asOf?: Timestamp
+}
+
+export type AgentProfile = AgentCard & {
+ bio?: string
+ liveSince?: Timestamp
+ whitelistedSymbols: string[]
+ tags: string[]
+ strategyExecutionItems: StrategyExecutionItem[]
+}
+
+export type AgentSnapshot = {
+ agentId: string
+ chainId: number
+ leaderAddress: Address
+ displayName: string
+ avatarUrl?: string
+ isVerified: boolean
+ modelName: string
+ strategy: StrategyKey
+ strategyLabel?: string
+ strategyCategories: StrategyCategory[]
+ badges: string[]
+ metrics: Pick
+}
+
+export type LeaderboardSummary = {
+ asOf?: Timestamp
+ totalAgents?: DecimalString
+ totalAumUsd?: DecimalString
+ totalCopiers?: DecimalString
+ totalVolumeUsd?: DecimalString
+ metrics: {
+ agentCount?: Metric
+ totalAumUsd?: Metric
+ totalCopierCount?: Metric
+ lifetimeVolumeUsd?: Metric
+ }
+}
+
+export type PerformancePoint = {
+ timestamp: Timestamp
+ series: PerformanceSeries
+ interval?: PerformanceInterval
+ portfolioValueUsd?: DecimalString
+ realizedPnlUsd?: DecimalString
+ tradeId?: string
+ positionId?: string
+ token?: Token
+ metric: Metric
+}
diff --git a/apps/kyberswap-interface/src/services/copyTrading/types/copyRuns.ts b/apps/kyberswap-interface/src/services/copyTrading/types/copyRuns.ts
new file mode 100644
index 0000000000..e4541a3aed
--- /dev/null
+++ b/apps/kyberswap-interface/src/services/copyTrading/types/copyRuns.ts
@@ -0,0 +1,201 @@
+import type { AdvisoryActionAvailability } from './actionAvailability'
+import type { AgentSnapshot, AgentStats, Token } from './agents'
+import type {
+ CapitalActivityDetail,
+ CopyLifecycleActivityDetail,
+ ExecutionActivityDetail,
+ FeeActivityDetail,
+ PositionActivityDetail,
+ PositionValuation,
+} from './positions'
+import type {
+ ActivityType,
+ Address,
+ CapitalInProjectionStatus,
+ CopyAccountStatus,
+ CopyRunStatus,
+ CopyRunView,
+ DecimalString,
+ LooseString,
+ Metric,
+ Timestamp,
+} from './primitives'
+
+export type OwnerCopySummary = {
+ ownerAddress: Address
+ view: CopyRunView
+ totalAllocatedUsd?: DecimalString
+ realizedPnlUsd?: DecimalString
+ unrealizedPnlUsd?: DecimalString
+ openPositions?: DecimalString
+ activeCopies?: DecimalString
+ closedCopies?: DecimalString
+ closedPositions?: DecimalString
+ closedCapitalUsd?: DecimalString
+ portfolioValueUsd?: DecimalString
+ leftoverPositions?: DecimalString
+ leftoverValueUsd?: DecimalString
+ flatFeesCapturedUsd?: DecimalString
+ cashbackReceivedUsd?: DecimalString
+ netFeeCostUsd?: DecimalString
+ estimatedCashbackPendingUsd?: DecimalString
+ metrics: Record
+}
+
+export type CopyRunSummary = {
+ copyRunId: string
+ ownerAddress: Address
+ agentId: string
+ chainId: number
+ copyAccount: Address
+ status: CopyRunStatus
+ capitalInProjectionStatus: CapitalInProjectionStatus
+ startedAt: Timestamp
+ stoppedAt?: Timestamp
+ capitalInUsd?: DecimalString
+ observedCapitalInUsd?: DecimalString
+ capitalOutUsd?: DecimalString
+ portfolioValueUsd?: DecimalString
+ realizedPnlUsd?: DecimalString
+ unrealizedPnlUsd?: DecimalString
+ myAprSinceCopyPct?: DecimalString
+ openPositionCount?: DecimalString
+ closedPositionCount?: DecimalString
+ leftoverPositionCount?: DecimalString
+ leftoverValueUsd?: DecimalString
+ flatFeesCapturedUsd?: DecimalString
+ cashbackReceivedUsd?: DecimalString
+ netFeeCostUsd?: DecimalString
+ estimatedCashbackPendingUsd?: DecimalString
+ durationSeconds?: DecimalString
+ durationAsOf?: Timestamp
+ addCapitalAvailability?: AdvisoryActionAvailability
+ stopCopyAvailability?: AdvisoryActionAvailability
+ withdrawQuoteAvailability?: AdvisoryActionAvailability
+ metrics: Record
+ agentSnapshot?: AgentSnapshot
+ agentStats: AgentStats
+}
+
+export type CopyRunCashbackPolicyScope =
+ | 'COPY_RUN_CASHBACK_POLICY_SCOPE_UNSPECIFIED'
+ | 'COPY_RUN_CASHBACK_POLICY_SCOPE_DEFAULT'
+ | 'COPY_RUN_CASHBACK_POLICY_SCOPE_EXTRA'
+
+export type CopyRunCashbackPolicyStatus =
+ | 'COPY_RUN_CASHBACK_POLICY_STATUS_UNSPECIFIED'
+ | 'COPY_RUN_CASHBACK_POLICY_STATUS_AVAILABLE'
+ | 'COPY_RUN_CASHBACK_POLICY_STATUS_NOT_CONFIGURED'
+ | 'COPY_RUN_CASHBACK_POLICY_STATUS_INVALIDATED'
+ | 'COPY_RUN_CASHBACK_POLICY_STATUS_UNAVAILABLE'
+
+export type CopyRunCashbackPolicyUnavailableReason =
+ | 'COPY_RUN_CASHBACK_POLICY_UNAVAILABLE_REASON_UNSPECIFIED'
+ | 'COPY_RUN_CASHBACK_POLICY_UNAVAILABLE_REASON_COVERAGE_PENDING'
+ | 'COPY_RUN_CASHBACK_POLICY_UNAVAILABLE_REASON_HISTORICAL_GENERATION_UNSUPPORTED'
+ | 'COPY_RUN_CASHBACK_POLICY_UNAVAILABLE_REASON_POLICY_TRANSITION_PENDING'
+
+export type CopyRunCashbackPolicy = {
+ copyRunId: string
+ chainId: number
+ copyAccount: Address
+ agentId: string
+ capCashbackRatioRaw?: string
+ pnlRateRaw?: string
+ scope: LooseString
+ status: LooseString
+ selectionPolicyVersion?: string
+ cashbackFormulaVersion?: number
+ selectedAt?: Timestamp
+ invalidatedAt?: Timestamp
+ unavailableReason?: LooseString
+ fallbackAt?: Timestamp
+}
+
+export type CopyAccountSummary = {
+ chainId: number
+ copyAccount: Address
+ ownerAddress: Address
+ status: CopyAccountStatus
+ activeCopyRuns?: DecimalString
+ totalAllocatedUsd?: DecimalString
+ portfolioValueUsd?: DecimalString
+ availableBalanceUsd?: DecimalString
+ realizedPnlUsd?: DecimalString
+ unrealizedPnlUsd?: DecimalString
+ openPositionCount?: DecimalString
+ closedPositionCount?: DecimalString
+ leftoverPositionCount?: DecimalString
+ leftoverValueUsd?: DecimalString
+ flatFeesCapturedUsd?: DecimalString
+ cashbackReceivedUsd?: DecimalString
+ netFeeCostUsd?: DecimalString
+ estimatedCashbackPendingUsd?: DecimalString
+ copyRunId?: string
+ startedAt?: Timestamp
+ stoppedAt?: Timestamp
+ addCapitalAvailability?: AdvisoryActionAvailability
+ stopCopyAvailability?: AdvisoryActionAvailability
+ withdrawQuoteAvailability?: AdvisoryActionAvailability
+ metrics: Record
+ agentSnapshot?: AgentSnapshot
+}
+
+export type ActivityRow = {
+ activityId: string
+ ownerAddress: Address
+ agentId: string
+ chainId: number
+ copyRunId?: string
+ copyAccount?: Address
+ activityType: LooseString
+ summary: string
+ occurredAt: Timestamp
+ userPositionId?: string
+ followerPositionId?: string
+ tradeId?: string
+ txHash?: string
+ agentDisplayName?: string
+ agentAvatarUrl?: string
+ copyLifecycle?: CopyLifecycleActivityDetail
+ position?: PositionActivityDetail
+ capital?: CapitalActivityDetail
+ fee?: FeeActivityDetail
+ execution?: ExecutionActivityDetail
+}
+
+export type WalletBalanceRow = {
+ chainId: number
+ copyAccount: Address
+ tokenAddress: Address
+ amountDecimal: DecimalString
+ balanceSource: string
+ freshnessStatus: string
+ balanceAsOfBlock: DecimalString
+ cachedAt: Timestamp
+ stalenessReason?: string
+ token?: Token
+ valueUsd?: DecimalString
+ currentValuation?: PositionValuation
+}
+
+export type PinnedStableBalanceStatus =
+ | 'PINNED_STABLE_BALANCE_STATUS_UNSPECIFIED'
+ | 'PINNED_STABLE_BALANCE_STATUS_PRESENT'
+ | 'PINNED_STABLE_BALANCE_STATUS_REGISTRATION_PENDING'
+ | 'PINNED_STABLE_BALANCE_STATUS_NOT_INDEXED'
+ | 'PINNED_STABLE_BALANCE_STATUS_UNAVAILABLE'
+ | 'PINNED_STABLE_BALANCE_STATUS_TOKEN_MISMATCH'
+
+export type PinnedStableBalance = {
+ status?: PinnedStableBalanceStatus
+ balance?: WalletBalanceRow
+}
+
+export type PendingSellObligation = {
+ leaderPositionEventId: string
+ currentRatioRaw: string
+ skippedAt?: Timestamp
+ publicErrorCode?: string
+ publicErrorMessage?: string
+}
diff --git a/apps/kyberswap-interface/src/services/copyTrading/types/positions.ts b/apps/kyberswap-interface/src/services/copyTrading/types/positions.ts
new file mode 100644
index 0000000000..63089f98e2
--- /dev/null
+++ b/apps/kyberswap-interface/src/services/copyTrading/types/positions.ts
@@ -0,0 +1,198 @@
+import type { Token } from './agents'
+import type {
+ ActivityType,
+ Address,
+ DataStatus,
+ DecimalString,
+ LooseString,
+ Metric,
+ PositionLifecycle,
+ PositionQuantityState,
+ PositionStatus,
+ Timestamp,
+} from './primitives'
+
+export type PositionActionKind =
+ | 'POSITION_ACTION_KIND_UNSPECIFIED'
+ | 'POSITION_ACTION_KIND_MANUAL_SELL'
+ | 'POSITION_ACTION_KIND_CLOSE_POSITION'
+
+export type PositionExitKind =
+ | 'POSITION_EXIT_KIND_UNSPECIFIED'
+ | 'POSITION_EXIT_KIND_ALIGNED'
+ | 'POSITION_EXIT_KIND_MANUAL'
+
+export type PositionValuation = {
+ valueUsd?: DecimalString
+ priceUsd?: DecimalString
+ priceSource?: string
+ priceAsOf?: Timestamp
+ asOf?: Timestamp
+ isEstimated?: boolean
+ isFinal?: boolean
+ status?: DataStatus
+}
+
+export type PositionMetrics = {
+ realizedPnlUsd?: Metric
+ unrealizedPnlUsd?: Metric
+ unrealizedPnlPct?: Metric
+ flatFeeCapturedUsd?: Metric
+ cashbackReceivedUsd?: Metric
+ netFeeCostUsd?: Metric
+ estimatedCashbackUsd?: Metric
+ skippedSellCount?: Metric
+ latestSkippedRatio?: Metric
+ cumulativeSkippedRatio?: Metric
+}
+
+export type PositionSummary = {
+ positionId: string
+ userPositionId?: string
+ agentPositionId?: string
+ copyRunId?: string
+ agentId: string
+ chainId: number
+ copyAccount?: Address
+ tradeId: string
+ token: Token
+ status: LooseString
+ lifecycle: PositionLifecycle
+ amountRaw: DecimalString
+ amountDecimal?: DecimalString
+ remainingBaseRaw?: string
+ totalGrossBaseBoughtRaw?: string
+ totalGrossBaseSoldRaw?: string
+ upfrontFeeCapturedBaseRaw?: string
+ upfrontFeeReleasedBaseRaw?: string
+ netBaseReceivedRaw?: string
+ remainingNetBaseRaw?: string
+ displayBaseRaw?: string
+ entryValuation?: PositionValuation
+ currentValuation?: PositionValuation
+ exitValuation?: PositionValuation
+ entryPriceUsd?: DecimalString
+ currentPriceUsd?: DecimalString
+ exitPriceUsd?: DecimalString
+ valueUsd?: DecimalString
+ realizedPnlUsd?: DecimalString
+ unrealizedPnlUsd?: DecimalString
+ unrealizedPnlPct?: DecimalString
+ flatFeeCapturedUsd?: DecimalString
+ cashbackReceivedUsd?: DecimalString
+ netFeeCostUsd?: DecimalString
+ estimatedCashbackUsd?: DecimalString
+ metrics: PositionMetrics
+ quantityState: PositionQuantityState
+ exitKind?: PositionExitKind
+ actionKind?: PositionActionKind
+ availableActionKinds: PositionActionKind[]
+ isLeftover?: boolean
+ leftoverReason?: string
+ leftoverValuation?: PositionValuation
+ latestSkipPublicErrorCode?: string
+ durationSeconds?: DecimalString
+ durationAsOf?: Timestamp
+ openedAt: Timestamp
+ closedAt?: Timestamp
+}
+
+export type CopyLifecycleActivityDetail = {
+ eventId?: string
+ eventType?: string
+ beforeStatus?: string
+ afterStatus?: string
+}
+
+export type PositionActivityDetail = {
+ eventId?: string
+ actionType?: string
+ baseTokenAddress?: Address
+ quoteTokenAddress?: Address
+ baseAmountRaw?: string
+ quoteAmountRaw?: string
+ accountingStatus?: string
+ grossBaseSoldRaw?: string
+ grossQuoteReceivedRaw?: string
+ baseToken?: Token
+ quoteToken?: Token
+ grossBaseBoughtRaw?: string
+ upfrontFeeCapturedBaseRaw?: string
+ upfrontFeeReleasedBaseRaw?: string
+ netBaseReceivedRaw?: string
+ netBaseSoldRaw?: string
+ displayBaseRaw?: string
+ settlementValueUsd?: Metric
+ realizedPnlUsd?: Metric
+ flatFeeCapturedUsd?: Metric
+ cashbackReceivedUsd?: Metric
+}
+
+export type CapitalActivityDetail = {
+ movementType?: string
+ amountRaw?: string
+ tokenAddress?: Address
+ token?: Token
+ valueUsd?: Metric
+}
+
+export type FeeActivityDetail = {
+ amountRaw?: string
+ tokenAddress?: Address
+ token?: Token
+ valueUsd?: Metric
+}
+
+export type ExecutionActivityDetail = {
+ executionKind?: string
+ eventSeq?: string
+ eventType?: string
+ actionKind?: string
+ copyJobId?: string
+ exitActionId?: string
+ executionId?: string
+ copyJobAction?: string
+ copyJobStatus?: string
+ actionStatus?: string
+ executionStatus?: string
+ publicErrorCode?: string
+ publicErrorMessage?: string
+ configIndex?: number
+ minBaseTokenRateRaw?: string
+ configDeadlineRaw?: string
+ token?: Token
+ displayAmountRaw?: string
+ valueUsd?: Metric
+}
+
+export type PositionEvent = {
+ eventId: string
+ positionId: string
+ activityType: LooseString
+ chainId: number
+ summary: string
+ occurredAt: Timestamp
+ txHash?: string
+ blockNumber?: string
+ metadata?: Record
+}
+
+export type CotLog = {
+ logId: string
+ agentId: string
+ chainId: number
+ positionId?: string
+ trigger: string
+ data: string
+ reasoning: string
+ action: string
+ actionCode?: string
+ status: string
+ summary?: string
+ txHash?: string
+ blockNumber?: string
+ tokenAddress?: Address
+ model?: string
+ strategyVersion?: string
+ occurredAt: Timestamp
+}
diff --git a/apps/kyberswap-interface/src/services/copyTrading/types/preparedActions.ts b/apps/kyberswap-interface/src/services/copyTrading/types/preparedActions.ts
new file mode 100644
index 0000000000..bc6c473c9a
--- /dev/null
+++ b/apps/kyberswap-interface/src/services/copyTrading/types/preparedActions.ts
@@ -0,0 +1,268 @@
+import type { PreparedActionReason } from './actionAvailability'
+import type { PositionValuation } from './positions'
+import type { Address, LooseString, Metric, MetricStatus, Timestamp } from './primitives'
+
+export type RawAmountMetric = Pick
+
+export type SwapQuotePreview = {
+ expectedQuote?: RawAmountMetric
+ minimumQuote?: RawAmountMetric
+ effectiveSlippageBps?: number
+}
+
+export type PreparedToken = {
+ chainId?: string
+ address?: Address
+ symbol?: string
+ name?: string
+ decimals?: number
+ logoUrl?: string
+}
+
+export type PreparedCallKind =
+ | 'PREPARED_CALL_KIND_UNSPECIFIED'
+ | 'PREPARED_CALL_KIND_START_COPY_CREATE'
+ | 'PREPARED_CALL_KIND_START_COPY_FUND'
+ | 'PREPARED_CALL_KIND_ADD_CAPITAL'
+ | 'PREPARED_CALL_KIND_STOP_COPY'
+ | 'PREPARED_CALL_KIND_WITHDRAW_QUOTE'
+ | 'PREPARED_CALL_KIND_MANUAL_SELL'
+ | 'PREPARED_CALL_KIND_CLOSE_POSITION'
+
+export type PreparedCall = {
+ kind?: PreparedCallKind
+ to?: Address
+ data?: `0x${string}`
+ valueRaw?: string
+}
+
+export type PreparedActionStatus =
+ | 'PREPARED_ACTION_STATUS_UNSPECIFIED'
+ | 'PREPARED_ACTION_STATUS_READY'
+ | 'PREPARED_ACTION_STATUS_PARTIALLY_COMPLETED'
+ | 'PREPARED_ACTION_STATUS_COMPLETED'
+ | 'PREPARED_ACTION_STATUS_PENDING'
+ | 'PREPARED_ACTION_STATUS_UNAVAILABLE'
+
+export type PreparedActionWarning =
+ | 'PREPARED_ACTION_WARNING_UNSPECIFIED'
+ | 'PREPARED_ACTION_WARNING_ALLOCATION_STALE'
+ | 'PREPARED_ACTION_WARNING_INVALID_STOP_INTENT_RECOVERED'
+ | 'PREPARED_ACTION_WARNING_OWNER_SNAPSHOT_REQUIRES_REFRESH'
+
+export type ProjectorCoverage = {
+ projector?: string
+ completedThroughBlockNumber?: string
+ coverageGeneration?: string
+ sourceReorgSequence?: string
+}
+
+export type EvidenceAnchor = {
+ blockNumber?: string
+ blockHash?: string
+ blockTime?: Timestamp
+ coverageGeneration?: string
+ sourceReorgSequence?: string
+ actionFactEventSeq?: string
+ projectors?: ProjectorCoverage[]
+}
+
+export type ActionBlock = {
+ blockNumber?: string
+ blockHash?: string
+ blockTime?: Timestamp
+}
+
+export type ActionEvidence = {
+ evidenceAnchor?: EvidenceAnchor
+ actionBlock?: ActionBlock
+}
+
+export type FeePolicyPreview = {
+ advertisedUpfrontFeeRateRaw?: string
+ advertisedRateStatus?: MetricStatus
+}
+
+export type StartCopyStage =
+ | 'START_COPY_STAGE_UNSPECIFIED'
+ | 'START_COPY_STAGE_CREATE_REQUIRED'
+ | 'START_COPY_STAGE_CREATE_CONFIRMING'
+ | 'START_COPY_STAGE_FUNDING_REQUIRED'
+ | 'START_COPY_STAGE_COMPLETE'
+
+export type StartCopyApprovalScheme =
+ | 'START_COPY_APPROVAL_SCHEME_UNSPECIFIED'
+ | 'START_COPY_APPROVAL_SCHEME_STANDARD'
+ | 'START_COPY_APPROVAL_SCHEME_ZERO_THEN_SET'
+
+export type StartCopyPermitScheme =
+ | 'START_COPY_PERMIT_SCHEME_UNSPECIFIED'
+ | 'START_COPY_PERMIT_SCHEME_ALLOWANCE_ONLY'
+ | 'START_COPY_PERMIT_SCHEME_ERC20_EIP2612'
+ | 'START_COPY_PERMIT_SCHEME_ERC20_DAI_LIKE'
+
+export type StartCopyEip712DomainKind =
+ | 'START_COPY_EIP712_DOMAIN_KIND_UNSPECIFIED'
+ | 'START_COPY_EIP712_DOMAIN_KIND_CHAIN_ID'
+ | 'START_COPY_EIP712_DOMAIN_KIND_CHAIN_ID_SALT'
+
+export type StartCopyAllowanceRequirement = {
+ spenderAddress?: Address
+ currentAllowanceRaw?: string
+ requiredAllowanceRaw?: string
+ approvalScheme?: LooseString
+ permitScheme?: LooseString
+ eip712DomainName?: string
+ eip712DomainVersion?: string
+ eip712DomainKind?: LooseString
+}
+
+export type StartCopyPreview = {
+ stage?: StartCopyStage
+ startRequestId?: string
+ predictedCopyAccount?: Address
+ quoteToken?: PreparedToken
+ requestedTargetRaw?: string
+ createAmountRaw?: string
+ initialCapitalCredited?: RawAmountMetric
+ remainingTargetDeficit?: RawAmountMetric
+ minimumInitialCapitalRaw?: string
+ walletQuoteBalance?: RawAmountMetric
+ feePolicy?: FeePolicyPreview
+ allowanceRequirement?: StartCopyAllowanceRequirement
+}
+
+export type AddCapitalPreview = {
+ quoteToken?: PreparedToken
+ addedCapitalRaw?: string
+ minimumAddCapitalRaw?: string
+ walletQuoteBalance?: RawAmountMetric
+ currentAllocatedCapital?: RawAmountMetric
+ newAllocatedCapital?: RawAmountMetric
+}
+
+export type PreparedPositionLifecycle =
+ | 'POSITION_LIFECYCLE_UNSPECIFIED'
+ | 'POSITION_LIFECYCLE_ACTIVE'
+ | 'POSITION_LIFECYCLE_CLOSING'
+ | 'POSITION_LIFECYCLE_CLOSED'
+
+export type StopPositionPreview = {
+ userPositionId?: string
+ tradeId?: string
+ baseToken?: PreparedToken
+ userBaseRaw?: string
+ cashback?: RawAmountMetric
+ currentValuation?: PositionValuation
+ lifecycle?: PreparedPositionLifecycle
+ unrealizedPnlUsd?: Metric
+ swapQuote?: SwapQuotePreview
+}
+
+export type StopCopyPreview = {
+ positions?: StopPositionPreview[]
+ totalCurrentValueUsd?: Metric
+ totalCashback?: RawAmountMetric
+ quoteToken?: PreparedToken
+ totalSwapQuote?: SwapQuotePreview
+}
+
+export type WithdrawQuotePreview = {
+ quoteToken?: PreparedToken
+ quoteBalance?: RawAmountMetric
+ sweepAmountRaw?: string
+ recipientAddress?: Address
+}
+
+export type PositionSellContext =
+ | 'POSITION_SELL_CONTEXT_UNSPECIFIED'
+ | 'POSITION_SELL_CONTEXT_ALIGN_SKIP'
+ | 'POSITION_SELL_CONTEXT_STOP_COPY'
+
+export type PositionSellPreview = {
+ context?: PositionSellContext
+ userPositionId?: string
+ tradeId?: string
+ baseToken?: PreparedToken
+ quoteToken?: PreparedToken
+ remainingBaseBefore?: RawAmountMetric
+ sellBase?: RawAmountMetric
+ upfrontFeeReleasedBase?: RawAmountMetric
+ sellRatioRaw?: string
+ unresolvedSkipCount?: number
+ cashback?: RawAmountMetric
+ swapQuote?: SwapQuotePreview
+}
+
+export type PreparedAction = {
+ status?: PreparedActionStatus
+ chainId?: string
+ expectedAccount?: Address
+ copyAccount?: Address
+ preparedAt?: Timestamp
+ reprepareAfter?: Timestamp
+ liquidationConfigDeadline?: Timestamp
+ call?: PreparedCall
+ reason?: PreparedActionReason
+ warnings?: PreparedActionWarning[]
+ evidence?: ActionEvidence
+ startCopy?: StartCopyPreview
+ addCapital?: AddCapitalPreview
+ stopCopy?: StopCopyPreview
+ withdrawQuote?: WithdrawQuotePreview
+ manualSell?: PositionSellPreview
+ closePosition?: PositionSellPreview
+}
+
+export type PreparedActionResponse = { data: PreparedAction }
+export type PrepareStartCopyResponse = PreparedActionResponse
+export type PrepareAddCapitalResponse = PreparedActionResponse
+export type PrepareStopCopyResponse = PreparedActionResponse
+export type PrepareWithdrawQuoteResponse = PreparedActionResponse
+export type PrepareManualSellResponse = PreparedActionResponse
+export type PrepareClosePositionResponse = PreparedActionResponse
+
+export type StartCopyFundingMode = 'START_COPY_FUNDING_MODE_UNFUNDED' | 'START_COPY_FUNDING_MODE_FUNDED'
+
+type PrepareStartCopyRequestBase = {
+ ownerAddress: Address
+ agentId: string
+ chainId: string
+ targetCapitalRaw: string
+ startRequestId: string
+ fundingMode: StartCopyFundingMode
+}
+
+export type PrepareStartCopyRequest = PrepareStartCopyRequestBase &
+ (
+ | { fundingMode: 'START_COPY_FUNDING_MODE_UNFUNDED'; createPermitData?: never }
+ | { fundingMode: 'START_COPY_FUNDING_MODE_FUNDED'; createPermitData?: string }
+ )
+
+export type PrepareCopyRunRequest = {
+ ownerAddress: Address
+ copyRunId: string
+}
+
+export type PrepareAddCapitalRequest = PrepareCopyRunRequest & {
+ amountRaw: string
+}
+
+export type PrepareStopCopyRequest = PrepareCopyRunRequest & {
+ userPositionIds: string[]
+ slippageBps: number
+}
+
+export type PrepareWithdrawQuoteRequest = PrepareCopyRunRequest
+
+export type PreparePositionRequest = PrepareCopyRunRequest & {
+ userPositionId: string
+ slippageBps: number
+}
+
+export type PrepareManualSellRequest = PreparePositionRequest & {
+ expectedUnresolvedSkipCount: number
+ expectedSellRatioRaw: string
+}
+
+export type PrepareClosePositionRequest = PreparePositionRequest
diff --git a/apps/kyberswap-interface/src/services/copyTrading/types/primitives.ts b/apps/kyberswap-interface/src/services/copyTrading/types/primitives.ts
new file mode 100644
index 0000000000..7091e34240
--- /dev/null
+++ b/apps/kyberswap-interface/src/services/copyTrading/types/primitives.ts
@@ -0,0 +1,124 @@
+export type LooseString = T | (string & Record)
+export type DecimalString = string
+export type Timestamp = string
+export type Address = `0x${string}` | (string & Record)
+
+export type DataStatus =
+ | 'DATA_STATUS_CURRENT'
+ | 'DATA_STATUS_STALE'
+ | 'DATA_STATUS_UNAVAILABLE'
+ | 'DATA_STATUS_UNSPECIFIED'
+
+export type MetricStatus =
+ | 'METRIC_STATUS_CURRENT'
+ | 'METRIC_STATUS_STALE'
+ | 'METRIC_STATUS_UNAVAILABLE'
+ | 'METRIC_STATUS_NOT_APPLICABLE'
+ | 'METRIC_STATUS_UNSPECIFIED'
+
+export type ApiWindow = 'WINDOW_UNSPECIFIED' | 'WINDOW_7D' | 'WINDOW_30D' | 'WINDOW_90D' | 'WINDOW_ALL'
+
+export type WindowPolicy =
+ | 'WINDOW_POLICY_UNSPECIFIED'
+ | 'WINDOW_POLICY_TRAILING'
+ | 'WINDOW_POLICY_SINCE_LIVE'
+ | 'WINDOW_POLICY_SINCE_COPY_START'
+
+export type Metric = {
+ value?: DecimalString
+ valueRaw?: string
+ status?: MetricStatus
+ asOf?: Timestamp
+ window?: ApiWindow
+ nominalWindowDays?: number
+ actualWindowSeconds?: string
+ windowPolicy?: WindowPolicy
+ windowStart?: Timestamp
+ windowEnd?: Timestamp
+}
+
+export type ChainFreshness = {
+ chainId?: string
+ dataAsOf?: Timestamp
+ asOfBlockNumber?: string
+ safeBlockNumber?: string
+ syncedAt?: Timestamp
+ status?: DataStatus
+}
+
+export type ResponseMeta = {
+ requestId?: string
+ generatedAt?: Timestamp
+ dataAsOf?: Timestamp
+ stalenessReason?: string
+ asOfChains?: ChainFreshness[]
+ status?: DataStatus
+}
+
+export type SingleResponse = {
+ data: T
+ meta?: ResponseMeta
+}
+
+export type CursorPagination = {
+ nextCursor?: string
+ hasMore: boolean
+ limit: number
+}
+
+export type CursorResponse = {
+ data: T[]
+ pagination: CursorPagination
+ meta?: ResponseMeta
+}
+
+export type PerformanceWindow = '7d' | '30d' | '90d' | 'all'
+export type PerformanceInterval = 'day' | 'week' | 'month'
+export type PerformanceSeries =
+ | 'portfolio_value'
+ | 'cumulative_realized_pnl'
+ | 'period_realized_pnl'
+ | 'per_trade_realized_pnl'
+export type AgentStatsWindow = '30d'
+export type SortOrder = 'desc' | 'asc'
+export type PositionStatus = 'open' | 'closed' | 'unknown'
+export type PositionStatusFilter = 'all' | Exclude | 'leftover'
+export type AgentPositionStatusFilter = Exclude
+export type PositionLifecycle = 'active' | 'closing' | 'closed' | 'unknown'
+export type PositionQuantityState = 'open_full' | 'open_partial' | 'closed' | 'unknown'
+export type CopyRunView = 'open' | 'history'
+export type CopyRunSortBy =
+ | 'started_at'
+ | 'stopped_at'
+ | 'agent_apr_30d'
+ | 'agent_win_rate'
+ | 'agent_volume'
+ | 'capital_in'
+export type CopyRunStatus = 'active' | 'closing' | 'closed' | 'stopped' | 'unknown'
+export type CapitalInProjectionStatus = 'syncing' | 'ready' | 'unavailable' | 'unknown'
+export type CopyAccountStatus = 'active' | 'closed' | 'closing' | 'stopped' | 'unknown'
+export type CopyAccountStatusFilter = 'all' | Exclude
+export type StrategyKey = LooseString<'focused' | 'diversified' | 'active' | 'unknown'>
+
+export type ActivityType =
+ | 'copy_started'
+ | 'copy_stopped'
+ | 'position_opened'
+ | 'position_closed'
+ | 'capital_deposited'
+ | 'capital_topped_up'
+ | 'capital_withdrawn'
+ | 'capital_returned'
+ | 'flat_fee_captured'
+ | 'cashback_received'
+ | 'aligned_trade_skipped'
+ | 'exit_started'
+ | 'exit_succeeded'
+ | 'exit_skipped'
+ | 'exit_failed'
+ | 'execution_failed'
+ | 'position_reduced'
+
+export type ActivityTypeFilter = 'all' | ActivityType
+export type LeaderboardSortBy = 'apr_30d_pct' | 'win_rate_pct' | 'volume_usd' | 'aum_usd' | 'copiers' | 'open_positions'
+export type PositionSortBy = 'opened_at' | 'closed_at' | 'value_usd'
diff --git a/apps/kyberswap-interface/src/services/copyTrading/types/queries.ts b/apps/kyberswap-interface/src/services/copyTrading/types/queries.ts
new file mode 100644
index 0000000000..81c8e1a6b4
--- /dev/null
+++ b/apps/kyberswap-interface/src/services/copyTrading/types/queries.ts
@@ -0,0 +1,153 @@
+import type {
+ ActivityTypeFilter,
+ Address,
+ AgentPositionStatusFilter,
+ AgentStatsWindow,
+ CopyAccountStatusFilter,
+ CopyRunSortBy,
+ CopyRunView,
+ LeaderboardSortBy,
+ PerformanceInterval,
+ PerformanceSeries,
+ PerformanceWindow,
+ PositionSortBy,
+ PositionStatusFilter,
+ SortOrder,
+ StrategyKey,
+ Timestamp,
+} from './primitives'
+
+export type CursorQuery = {
+ cursor?: string
+ limit?: number
+}
+
+export type LeaderboardFilters = {
+ chainId?: number
+ strategy?: StrategyKey
+ search?: string
+}
+
+export type LeaderboardSummaryQuery = LeaderboardFilters
+export type LeaderboardQuery = CursorQuery &
+ LeaderboardFilters & {
+ sortBy?: LeaderboardSortBy
+ sortOrder?: SortOrder
+ }
+
+export type AgentsQuery = CursorQuery & LeaderboardFilters
+
+export type AgentQuery = {
+ agentId: string
+}
+
+export type AgentStatsQuery = AgentQuery & {
+ window?: AgentStatsWindow
+}
+
+export type PerformanceQuery = CursorQuery & {
+ series?: PerformanceSeries
+ window?: PerformanceWindow
+ interval?: PerformanceInterval
+}
+
+export type AgentPerformanceQuery = AgentQuery & PerformanceQuery
+
+export type AgentPositionsQuery = CursorQuery &
+ AgentQuery & {
+ status?: AgentPositionStatusFilter
+ token?: Address
+ sortBy?: PositionSortBy
+ sortOrder?: SortOrder
+ }
+
+export type AgentPositionQuery = AgentQuery & {
+ positionId: string
+}
+
+export type AgentPositionEventsQuery = CursorQuery & AgentPositionQuery
+
+export type CotLogsQuery = CursorQuery &
+ AgentQuery & {
+ leaderPositionId?: string
+ type?: string
+ groupBy?: 'AGENT_ACTION_LOG_GROUP_BY_UNSPECIFIED' | 'AGENT_ACTION_LOG_GROUP_BY_SESSION_ID'
+ from?: Timestamp
+ to?: Timestamp
+ }
+
+export type OwnerQuery = {
+ ownerAddress: Address
+ chainId?: number
+}
+
+export type OwnerCopySummaryQuery = OwnerQuery & {
+ view: CopyRunView
+}
+
+export type CopyRunsQuery = CursorQuery &
+ OwnerQuery & {
+ view: CopyRunView
+ agentId?: string
+ sortBy?: CopyRunSortBy
+ sortOrder?: SortOrder
+ }
+
+export type CopyRunQuery = {
+ ownerAddress: Address
+ copyRunId: string
+}
+
+export type CopyRunPositionsQuery = CursorQuery &
+ CopyRunQuery & {
+ status?: PositionStatusFilter
+ sortBy?: PositionSortBy
+ sortOrder?: SortOrder
+ }
+
+export type CopyRunPerformanceQuery = CursorQuery & CopyRunQuery & PerformanceQuery
+
+export type OwnerPositionsQuery = CursorQuery &
+ OwnerQuery & {
+ status?: PositionStatusFilter
+ agentId?: string
+ sortBy?: PositionSortBy
+ sortOrder?: SortOrder
+ }
+
+export type OwnerActivityQuery = CursorQuery &
+ OwnerQuery & {
+ copyRunId?: string
+ activityType?: ActivityTypeFilter
+ group?: 'buys' | 'sells' | 'deposits_withdrawals' | 'skipped'
+ }
+
+export type OwnerCopyAccountsQuery = CursorQuery &
+ OwnerQuery & {
+ status?: CopyAccountStatusFilter
+ }
+
+export type CopyAccountQuery = {
+ chainId: number
+ copyAccount: Address
+}
+
+export type CopyAccountBalancesQuery = CursorQuery & CopyAccountQuery
+
+export type CopyAccountPositionsQuery = CursorQuery &
+ CopyAccountQuery & {
+ status?: PositionStatusFilter
+ sortBy?: PositionSortBy
+ sortOrder?: SortOrder
+ }
+
+export type CopyAccountHistoryQuery = CursorQuery &
+ CopyAccountQuery & {
+ activityType?: ActivityTypeFilter
+ group?: 'buys' | 'sells' | 'deposits_withdrawals' | 'skipped'
+ }
+
+export type PendingSellObligationsQuery = CursorQuery &
+ CopyAccountQuery & {
+ userPositionId: string
+ }
diff --git a/apps/kyberswap-interface/src/services/copyTrading/types/responses.ts b/apps/kyberswap-interface/src/services/copyTrading/types/responses.ts
new file mode 100644
index 0000000000..576be201cd
--- /dev/null
+++ b/apps/kyberswap-interface/src/services/copyTrading/types/responses.ts
@@ -0,0 +1,50 @@
+import type { AgentCard, AgentProfile, AgentStats, Chain, LeaderboardSummary, PerformancePoint } from './agents'
+import type {
+ ActivityRow,
+ CopyAccountSummary,
+ CopyRunCashbackPolicy,
+ CopyRunSummary,
+ OwnerCopySummary,
+ PendingSellObligation,
+ PinnedStableBalance,
+ WalletBalanceRow,
+} from './copyRuns'
+import type { CotLog, PositionEvent, PositionSummary } from './positions'
+import type { CursorResponse, Metric, ResponseMeta, SingleResponse } from './primitives'
+
+export type ChainsResponse = SingleResponse
+export type LeaderboardSummaryResponse = SingleResponse
+export type LeaderboardResponse = CursorResponse
+export type AgentsResponse = CursorResponse
+export type AgentResponse = SingleResponse
+export type AgentStatsResponse = SingleResponse
+export type AgentPerformanceResponse = CursorResponse
+export type AgentPositionsResponse = CursorResponse
+export type AgentPositionResponse = SingleResponse
+export type AgentPositionEventsResponse = CursorResponse
+export type CotLogsResponse = CursorResponse
+export type OwnerCopySummaryResponse = SingleResponse
+export type CopyRunsResponse = CursorResponse
+export type CopyRunResponse = SingleResponse
+export type CopyRunCashbackPolicyResponse = SingleResponse
+export type CopyRunPositionsResponse = CursorResponse
+export type CopyRunPerformanceResponse = CursorResponse
+export type OwnerPositionsResponse = CursorResponse
+export type OwnerActivityResponse = CursorResponse
{label && positionLabel === 'in' && label}
+ {showTopActions && balanceActions}
{showTopActions && onMax && (
Max
@@ -177,12 +183,21 @@ const BalanceRow = ({
)}
-
)
}
@@ -314,6 +329,8 @@ const PoolLockContent = (
interface CurrencyInputPanelProps {
value: string
+ balanceActions?: ReactNode
+ onBalanceClick?: () => void
onMax?: () => void
onHalf?: () => void
onUserInput?: (value: string) => void
@@ -333,7 +350,7 @@ interface CurrencyInputPanelProps {
id: string
dataTestId?: string
showPinnedTokens?: boolean
- customBalanceText?: string
+ customBalanceText?: ReactNode
hideLogo?: boolean
highlightCurrencySelect?: boolean
fontSize?: string
@@ -357,6 +374,8 @@ interface CurrencyInputPanelProps {
export default function CurrencyInputPanel({
value,
+ balanceActions,
+ onBalanceClick,
error,
onUserInput,
onMax,
@@ -423,9 +442,11 @@ export default function CurrencyInputPanel({
{!hideBalance && (
+
+
updateSignal(e.currentTarget)}
- className={cn('ks-scrollable-with-signal overflow-auto', className)}
>
- {children}
+
)
})
diff --git a/apps/kyberswap-interface/src/components/Web3Provider/BitcoinProvider/providers/ledger.ts b/apps/kyberswap-interface/src/components/Web3Provider/BitcoinProvider/providers/ledger.ts
index b5600663f4..7baf86516f 100644
--- a/apps/kyberswap-interface/src/components/Web3Provider/BitcoinProvider/providers/ledger.ts
+++ b/apps/kyberswap-interface/src/components/Web3Provider/BitcoinProvider/providers/ledger.ts
@@ -267,7 +267,7 @@ export const createLedgerProvider = ({
outputs: [
{
amount: amountToBuffer(+amount),
- script: Buffer.from(bitcoin.address.toOutputScript(recipient, bitcoin.networks.bitcoin)),
+ script: Buffer.from(new Uint8Array(bitcoin.address.toOutputScript(recipient, bitcoin.networks.bitcoin))),
},
],
}
@@ -275,7 +275,7 @@ export const createLedgerProvider = ({
if (changeAmount > 546) {
transaction.outputs.push({
amount: amountToBuffer(changeAmount),
- script: Buffer.from(bitcoin.address.toOutputScript(sender, bitcoin.networks.bitcoin)),
+ script: Buffer.from(new Uint8Array(bitcoin.address.toOutputScript(sender, bitcoin.networks.bitcoin))),
})
}
diff --git a/apps/kyberswap-interface/src/constants/index.ts b/apps/kyberswap-interface/src/constants/index.ts
index 91bcd1e1d1..31cd6d5c95 100644
--- a/apps/kyberswap-interface/src/constants/index.ts
+++ b/apps/kyberswap-interface/src/constants/index.ts
@@ -31,6 +31,7 @@ export const APP_PATHS = {
POOL_DETAIL: '/pools/:chain/:protocol/:address',
DISCOVER: '/discover',
CROSS_CHAIN: '/cross-chain',
+ COPY_TRADING: '/copy-trading',
KYBERDAO: '/kyberdao',
KYBERDAO_STAKE: '/kyberdao/stake-knc',
KYBERDAO_VOTE: '/kyberdao/vote',
diff --git a/apps/kyberswap-interface/src/hooks/useIsWalletRestoring.ts b/apps/kyberswap-interface/src/hooks/useIsWalletRestoring.ts
new file mode 100644
index 0000000000..d29629eb2f
--- /dev/null
+++ b/apps/kyberswap-interface/src/hooks/useIsWalletRestoring.ts
@@ -0,0 +1,21 @@
+import { useEffect, useState } from 'react'
+
+import { useAccount } from 'hooks/useAccount'
+
+/**
+ * Indicates whether the connected wallet address may still be hydrating.
+ *
+ * Wagmi can temporarily report no account on the first render before restoring a persisted connection. This hook
+ * keeps account-dependent screens in their loading state during that render and while the wallet is connecting or
+ * reconnecting, preventing them from briefly showing an empty state. It does not restore the connection itself.
+ */
+export default function useIsWalletRestoring() {
+ const { status } = useAccount()
+ const [hasPassedInitialRender, setHasPassedInitialRender] = useState(false)
+
+ useEffect(() => {
+ setHasPassedInitialRender(true)
+ }, [])
+
+ return !hasPassedInitialRender || status === 'connecting' || status === 'reconnecting'
+}
diff --git a/apps/kyberswap-interface/src/hooks/useTokenBalance.ts b/apps/kyberswap-interface/src/hooks/useTokenBalance.ts
index 4b577d196b..c8bed82216 100644
--- a/apps/kyberswap-interface/src/hooks/useTokenBalance.ts
+++ b/apps/kyberswap-interface/src/hooks/useTokenBalance.ts
@@ -11,12 +11,14 @@ import { Address } from 'utils/viem'
interface BalanceProps {
value: bigint
decimals: number
+ isLoading: boolean
}
-const EMPTY_BALANCE: BalanceProps = { value: 0n, decimals: 18 }
+const EMPTY_BALANCE: BalanceProps = { value: 0n, decimals: 18, isLoading: false }
+const INITIAL_BALANCE: BalanceProps = { ...EMPTY_BALANCE, isLoading: true }
function useTokenBalance(tokenAddress: string, customChainId?: ChainId) {
- const [balance, setBalance] = useState updateSignal(e.currentTarget)}
+ className={cn('overflow-auto', className)}
+ >
+ {children}
+
+ {showArrow && (
+
+
+
+ Agent
+
+ Agent APR 30D
+
+
+ Win Rates
+
+
+ Volume
+
+
+ Copiers
+
+
+ AUM
+
+
+ Position
+
+
+
+
+ {agents.map(agent => {
+ const copiedRun = copiedRunsByAgentId?.[agent.agentId]
+ const canStartCopy = isActionAvailable(agent.startCopyAvailability)
+
+ return (
+ {
+ if ((event.target as HTMLElement).closest('button')) return
+ openAgent(agent.agentId)
+ }}
+ >
+
+ {percent(agent.stats.apr30dPct)}
+
+
+ {percent(agent.stats.winRatePct)}
+
+ {compactUsd(agent.stats.volumeUsd)}
+ {formatCount(agent.stats.copiers)}
+ {compactUsd(agent.stats.aumUsd)}
+ {formatCount(agent.stats.openPositions)}
+
+ {copiedRun ? (
+ Copied
+ ) : (
+
+
+ )
+ })}
+
+
+
+ openStartCopy(agent)}
+ >
+ Copy
+
+
+ )}
+
+
+ {strategyOptions.map(option => {
+ const active = activeStrategy === option.value
+
+ return (
+ onChange(option.value)}
+ padding="8px 12px"
+ role="tab"
+ type="button"
+ >
+ {option.label}
+
+ )
+ })}
+
+ + Your funds remain in your personal Smart Contract Wallet. Only proportional trades are executed. +
+{children}
+
+ {profileTabs.map((tab, index) => {
+ const active = activeTab === tab
+ const isLast = index === profileTabs.length - 1
+
+ return (
+
+ )
+ })}
+
+ {children}
+
+
+
+
+
+
+ {tabs.map((tab, index) => {
+ const active = currentTab === tab
+ const isLast = index === tabs.length - 1
+ const count =
+ tab === 'open-positions'
+ ? run.openPositionCount
+ : tab === 'closed-positions'
+ ? run.closedPositionCount
+ : undefined
+
+ return (
+
+ )
+ })}
+
+
+
+ )}
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ )
+}
+
+const CopyDetailView = ({ backPath }: { backPath: 'my-copies' | 'history' }) => {
+ const { copyId } = useParams()
+ const { ownerAddress } = useCopyTradingContext()
+
+ const copyRunQuery = { ownerAddress: ownerAddress || '', copyRunId: copyId || '' }
+ const {
+ currentData: copyRun,
+ isFetching,
+ isLoading,
+ isUninitialized,
+ } = copyRunApi.useGetCopyRunQuery(copyRunQuery, { pollingInterval: 10_000, skip: !copyId || !ownerAddress })
+
+ const {
+ currentData: agent,
+ isFetching: isAgentFetching,
+ isLoading: isAgentLoading,
+ } = agentApi.useGetAgentQuery(
+ { agentId: copyRun?.data.agentId || '' },
+ { pollingInterval: 10_000, skip: !copyRun?.data.agentId },
+ )
+
+ const run = copyRun?.data
+ const profile = agent?.data
+ const backLabel = backPath === 'history' ? 'History' : 'My Copies'
+
+ if (!ownerAddress) {
+ return (
+
+
+ Agent
+ Closed Trades
+ Started & Stopped Time
+ Capital In
+ Current Balance
+ Realised P&L
+ Fees Paid
+ Rebates
+
+
+
+ {rows.map(subscription => {
+ return (
+ onOpenSubscription(subscription)}
+ onKeyDown={event => {
+ if (event.key === 'Enter' || event.key === ' ') {
+ event.preventDefault()
+ onOpenSubscription(subscription)
+ }
+ }}
+ className="cursor-pointer"
+ >
+
+ {formatCount(subscription.closedPositionCount ?? subscription.openPositionCount)}
+
+
+ {formatDateTime(subscription.startedAt)}
+ {formatDateTime(subscription.stoppedAt)}
+
+ {formatUsd(getDisplayCapitalInUsd(subscription))}
+ {formatUsd(subscription.portfolioValueUsd)}
+
+ {signedUsd(subscription.realizedPnlUsd)}
+
+ {formatUsd(subscription.flatFeesCapturedUsd)}
+ 0 && 'text-blue')}>
+ {formatUsd(subscription.cashbackReceivedUsd)}
+
+
+ )
+ })}
+
+
+
+
+ Agent
+
+ Agent APR
+
+
+ Win Rates
+
+
+ Volume
+
+
+ Capital In
+
+ Positions
+
+
+
+ {rows.map(subscription => {
+ const actionAvailable = isActionAvailable(subscription.stopCopyAvailability)
+
+ return (
+ {
+ if ((event.target as HTMLElement).closest('button')) return
+ onOpenSubscription(subscription)
+ }}
+ onKeyDown={event => {
+ if ((event.target as HTMLElement).closest('button')) return
+ if (event.key === 'Enter' || event.key === ' ') {
+ event.preventDefault()
+ onOpenSubscription(subscription)
+ }
+ }}
+ className="cursor-pointer"
+ >
+
+ {percent(subscription.agentStats.apr30dPct)}
+
+
+ {percent(subscription.agentStats.winRatePct)}
+
+ {compactUsd(subscription.agentStats.volumeUsd)}
+ {formatUsd(getDisplayCapitalInUsd(subscription))}
+ {formatCount(subscription.openPositionCount)}
+
+ openStopCopy(subscription, getAgentDisplayName(subscription.agentSnapshot))}
+ >
+ Stop Copying
+
+
+
+ )
+ })}
+
+
+
+
+ {percent(winRatePct)}
+
+
+
+
+
+
+
+ Stop Copy
+
+
+ )}
+ {onView && (
+
+
+ My Copy
+
+
+ )}
+ {onAddCapital && (
+
+
+ Add Capital
+
+
+ )}
+
+ {headerRight ? (
+
+ {title}
+ {headerRight}
+
+ ) : (
+ title
+ )}
+
+ )}
+ {hasBody && {activeTab.label}
+
+ {copyRunsTabs.map((tab, index) => {
+ const active = tab.value === activeView
+
+ return (
+
+
+ {!!index && }
+
+ {tab.label}
+
+
+ )
+ })}
+ {activeTab.description}
+
+ {!initialError && children}
+ {error && (
+
+ Unable to load data.
+
+ )}
+ {!error && hasMore && (
+
+ {loadingMore &&
+ )}
+
+ )
+}
+
+export default InfiniteScroll
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/components/Leaderboard.tsx b/apps/kyberswap-interface/src/pages/CopyTrading/components/Leaderboard.tsx
new file mode 100644
index 0000000000..187097dff2
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/components/Leaderboard.tsx
@@ -0,0 +1,118 @@
+import { type CSSProperties } from 'react'
+import type { MetricStatus } from 'services/copyTrading/types/primitives'
+
+import { Center, HStack, Stack } from 'components/Stack'
+import { type StatIcon } from 'pages/CopyTrading/constants'
+import { cn } from 'utils/cn'
+
+type LeaderboardSize = 'sm' | 'lg'
+
+export type LeaderboardStat = {
+ label: string
+ value: string
+ icon: StatIcon
+ status?: MetricStatus
+ valueClassName?: string
+}
+
+const getMinCardWidth = (size: LeaderboardSize) => (size === 'sm' ? 250 : 260)
+
+type LeaderboardCardProps = {
+ item: LeaderboardStat
+}
+
+const StatLabel = ({ item }: LeaderboardCardProps) => (
+
+
+
+
+
+ {items.map(item => (
+
+ )
+}
+
+export default Leaderboard
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/components/PerformanceCharts.tsx b/apps/kyberswap-interface/src/pages/CopyTrading/components/PerformanceCharts.tsx
new file mode 100644
index 0000000000..e6df202e7c
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/components/PerformanceCharts.tsx
@@ -0,0 +1,258 @@
+import { type PropsWithChildren } from 'react'
+import { Area, AreaChart, Bar, BarChart, CartesianGrid, ResponsiveContainer, Tooltip, XAxis, YAxis } from 'recharts'
+import type { PerformancePoint } from 'services/copyTrading/types/agents'
+import type { PerformanceWindow } from 'services/copyTrading/types/primitives'
+
+import Dots from 'components/Dots'
+import Loader from 'components/Loader'
+import SegmentedControl, { type SegmentedControlOption } from 'components/SegmentedControl'
+import { HStack, Stack } from 'components/Stack'
+import { compactUsd, formatUsd, getSignedMetricClassName } from 'pages/CopyTrading/helpers'
+import { cn } from 'utils/cn'
+import { formatDateTime, formatShortDate } from 'utils/time'
+
+const chartWindowOptions: readonly SegmentedControlOption{title}
+ {loading &&
+ Loading
+
+ ) : isEmpty ? (
+ No chart data available.
+ ) : null
+
+ return (
+
+ {children}
+ {state && (
+
+ {state}
+
+ )}
+
+ )
+}
+
+type CumulativeRealisedPnlChartProps = {
+ data: PerformanceChartPoint[]
+ isError?: boolean
+ isFetching?: boolean
+ onWindowChange?: (window: PerformanceWindow) => void
+ window?: PerformanceWindow
+}
+
+export const CumulativeRealisedPnlChart = ({
+ data,
+ isError,
+ isFetching,
+ onWindowChange,
+ window,
+}: CumulativeRealisedPnlChartProps) => {
+ const gradientOffset = getPnlGradientOffset(data)
+
+ return (
+
+
+ {title}
+ {typeof count === 'number' && (
+ {count}
+ )}
+
+
+ ) : (
+
+ {title}
+ {typeof count === 'number' && (
+ {count}
+ )}
+
+ )}
+ {children}
+
+ {to ? (
+
+ {children}
+
+ ) : (
+
+ )}
+
+ )
+}
diff --git a/apps/kyberswap-interface/src/pages/CopyTrading/components/Table.tsx b/apps/kyberswap-interface/src/pages/CopyTrading/components/Table.tsx
new file mode 100644
index 0000000000..24f2533c34
--- /dev/null
+++ b/apps/kyberswap-interface/src/pages/CopyTrading/components/Table.tsx
@@ -0,0 +1,107 @@
+import { type HTMLAttributes, type PropsWithChildren } from 'react'
+import { ChevronDown, ChevronUp } from 'react-feather'
+
+import { ButtonEmpty } from 'components/Button'
+import RefetchIndicator from 'components/RefetchIndicator'
+import { Center, HStack } from 'components/Stack'
+import { cn } from 'utils/cn'
+
+type SortOrder = 'asc' | 'desc'
+
+type HeaderCellProps
+
+)
+
+export const TableRow = ({ className, ...props }: HTMLAttributes{displayName}
+ ) : ( + {displayName} + )} + {isVerifiedAgent(agent) &&
+ navigate(backTo.to)}
+ padding="0"
+ className="text-subText hover:text-text"
+ >
+
+
+
+
+ )}
+ {children}
+ {title}
+ {description &&{description}
} +{title}
+ {titleAddon} +
+
+
+
+ + Capital will deploy on the agent's next trade. No immediate swaps. Existing settings apply. +
++ {title} +
+ ) : ( + title + )} + {!processing && ( +
+
+
+
+
+
+
+ {state.error}
+
+ {agent.displayName}
+ {agent.isVerified &&+ You will follow new trades from this moment. Your P&L may differ from the agent's stats until open + positions close. +
+ ++ Withdraw the prepared maximum quote-token balance to the current owner. The amount and recipient are fixed by the + latest server evidence and cannot be edited. +
+