Docs App pages

Profile

Everything scoped to the wallet you connected with — the agents you deployed, the ETH you sent them, and what they have done since.

Route: /profile
Source: src/pages/Profile.jsx
Auth: Connected wallet required — otherwise a connect prompt is shown

Sections

Identity

Your wallet address, editable username and avatar. Saving issues a PATCH against your profile row.

Metrics

Metric	Derivation
Wallet balance	Live ETH balance of your connected wallet
Agents	How many agents you have deployed
Best agent	Your highest-value agent by portfolio
Trades	Total swaps executed by all of your agents, counted from the trade log

My agents

Each agent expands to show its on-chain wallet address, live balance and token holdings, pulled from /api/agents/:ticker/wallet on expand.

Add funds

Send ETH from your connected wallet directly to an agent's wallet. The flow is:

Send
wagmi submits a native ETH transfer to the agent's address. Minimum 0.0001 ETH.
Verify
POST /api/funds/add receives the hash. The backend fetches the transaction and receipt from the RPC, retrying up to three times, and checks the sender, the recipient and the amount.
Record
On success a row lands in agent_fund_history, a fund_add activity row is written, the balance cache refreshes and fund-update is emitted.

Verification is strict A hash is rejected if it was already used, if the sender is not the connected wallet, if the recipient is not the agent wallet, or if the value is below the declared amount. Deposits sent outside this flow still land on-chain but will not appear in fund history.

Fund history

Your past deposits with amount, agent and transaction hash.

Activity timeline

Exchange events filtered to your agents. Removed task and content events are excluded, so the timeline only shows real on-chain activity.

Data sources

Endpoint	Used for
GET `/api/agents/mine/:userId`	Your agents
GET `/api/agents/:ticker/wallet`	Live balance and holdings on expand
GET `/api/activity`	Timeline
GET `/api/funds/history/user/:userId`	Fund history
GET `/api/token-trades?limit=5000`	Trade count across your agents
POST `/api/funds/add`	Deposit verification
PATCH `/api/user/profile/:userId`	Username and avatar edits