Okx Agentic Wallet

OKX Agentic Wallet

Wallet and on-chain execution skill using the onchainos CLI. It covers wallet lifecycle, Gas Station, DEX swaps, cross-chain bridges, limit-order strategies, transaction gateway operations, public-address portfolios, security checks, and audit logs.

Intent Routing

Match the user intent to a row, then read that row's linked file first — it holds the flow. Read only the matched file; do not load other rows' files. Each file links its own deeper files (cli-reference, troubleshooting) at the bottom via explicit links — open those when the flow needs them; never construct a file path yourself.

Preflight

Preflight checks: At the start of each thread, complete the checks in _shared/preflight.md.

Build the Command

1. Read the matched row's linked file first (per the Intent Routing table) — it carries the flow and the commands you need. Never guess subcommand, flag, or file names.
2. Use the matched reference as the command contract. Run CLI --help only when the matched reference does not provide the required syntax, the installed CLI rejects the documented command or flag, or version drift is suspected. Do not run --help routinely before a command whose syntax is already explicit and verified in the current thread. Load the matched domain's -cli-reference.md only when its return-field schema or examples are needed.
3. Confirm before any state-changing command. Display the prompt, get an explicit affirmative, and follow the Confirming Response rule below. For native BTC, direct BRC-20, and SUI transfers, follow the chain-specific confirmation flow; a BRC-20 transfer inscription confirms before signing and broadcast.

Chain Name Support

--chain accepts numeric chain IDs and human-readable names. Resolution rules and the supported-chain matrix live in _shared/chain-support.md. If <100% confident of a chain name, run onchainos wallet chains.

Confirming Response

Some state-changing commands return confirming (exit code 2) when the backend needs user confirmation. The response carries message (prompt to show) and next (what to do after they confirm).

1. Display message and ask for confirmation.
2. Confirms → immediately follow next (usually: re-run the same command with --force appended). For wallet send, do not query wallet balance between confirmation and the re-run; the server validates balances and gas.
3. Declines → do NOT proceed; tell the user it was cancelled.

Never pass --force on the FIRST invocation of a state-changing command. Add --force only after all of: (1) you ran the command once without it, (2) the CLI returned a Confirming response (exit code 2, "confirming": true), (3) you displayed message and the user explicitly confirmed.

Amount Display Rules

• Token amounts in UI units (1.5 ETH), never base units.
• USD values with 2 decimal places; if < 0.01, show full precision.
• Large amounts in shorthand ($1.2M, $340K); sort holdings by USD value descending.
• In balance/holdings displays, show the abbreviated contract address alongside the symbol (0x1234...abcd); native tokens with empty tokenAddress → (native).
• Flag suspicious prices: if a token looks like a wrapped/bridged variant (wETH, stETH, wBTC, xOKB…) and its price differs >50% from the base token, add an inline price unverified flag and suggest onchainos token price-info to cross-check.

Security & Global Notes

• Credential protection: never log, display, or ask for session tokens, clientId, API keys, private keys, seed phrases, or passwords. Never expose: accessToken, refreshToken, apiKey, secretKey, passphrase, sessionKey, sessionCert, teeId, saTeeId, encryptedSessionSk, signingKey, raw tx data. Show raw accountName (never raw accountId to the user).
• Credential recovery: on a Credentials corrupted / "please login again" error the local credential store is unreadable — don't retry the same command, re-authenticate the user with wallet login. See wallet-troubleshooting.md.
• Address integrity (funds-loss risk): any on-chain identifier shown to the user (wallet address, txHash, signature, contract address) MUST be echoed verbatim, character-for-character from the most recent CLI stdout. Never reproduce an identifier from memory, expand an abbreviated form, or re-type it across messages — re-invoke the command that produced it; for a wallet address, use wallet addresses. Never paraphrase, normalize case, insert spaces, or line-break inside an identifier. Always display the full txHash.
• No address hallucination: never fabricate a contract address — malicious tokens clone legitimate names. Only use addresses from a token lookup or the user's explicit input.
• Recipient validation: EVM 0x-prefixed, 42 chars; Solana Base58, 32–44 chars. Validate before sending.
• Transaction simulation: the CLI runs pre-execution simulation; if executeResult is false → show executeErrorMsg, do NOT broadcast.
• Risk action priority: block > warn > empty. Top-level action = highest priority from riskItemDetail. An empty action means only that no risk was detected within the checks performed; it is not proof that the asset, DApp, signature, or transaction is safe.