Onchain OS DEX Cross-Chain Swap

Flow: /quote → /approve-tx (if needApprove) → /swap → /status. 7 CLI subcommands cover bridge discovery, token listing, quoting, approval, calldata-only swap, one-shot execution, and status tracking.

Error Handling

• Always attempt the CLI command first. Never skip CLI and go directly to static data. The CLI returns real-time data from the API.
• Do NOT show raw CLI error output to the user. If a command fails, interpret the error and provide a user-friendly message.
• Heterogeneous chain pairs (e.g. EVM ↔ Solana / Sui / Tron / Ton) are not enabled by the current set of bridges. If quote returns 82105/82106 for such a pair, tell the user "currently no bridge supports this chain pair" — do NOT mention specific bridge protocol names.
• Unsupported chain or token: 82104 (token) / 82105 (chain) / 82106 (bridge id). Tell the user the chain/token isn't supported, do not expose the raw error.
• Risk warning (81362): backend flagged broadcast as potentially dangerous (possible honeypot / poisoned contract). Full handling rule lives in Risk Controls + Fund-action Flag Gates; never add --force without explicit user confirmation.
• Region restriction (50125): do not show the raw code. Display: "Service is not available in your region. Please switch to a supported region and try again."

Pre-flight Checks