check-wallet

# Checking Wallet Addresses & Balances Use the `npx @openant-ai/cli@latest` CLI to query your wallet addresses and on-chain balances. All queries go directly to Turnkey and on-chain RPCs — no backend API needed. **Always append `--json`** to every command for structured, parseable output. ## Confirm wallet is initialized and authed ```bash npx @openant-ai/cli@latest status --json ``` If not authenticated, refer to the `authenticate-openant` skill. ## List Wallet Addresses ```bash npx @openant-ai/cli@latest wallet addresses --json ``` Returns all wallet addresses (Solana + EVM) managed by Turnkey: ```json { "success": true, "data": { "addresses": [ { "chain": "Solana", "address": "7xK...abc", "addressFormat": "ADDRESS_FORMAT_SOLANA" }, { "chain": "EVM (Base)", "address": "0xAb...12", "addressFormat": "ADDRESS_FORMAT_ETHEREUM" } ] } } ``` ## Query On-Chain Balances ```bash npx @openant-ai/cli@latest wallet balance --json ``` Returns SOL balance, SPL token balances (USDC auto-detected), EVM native balance, and Base USDC balance: ```json { "success": true, "data": { "solana": { "address": "7xK...abc", "sol": 1.500000000, "tokens": [ { "mint": "4zMM...DU", "symbol": "USDC", "uiAmount": 500.0, "decimals": 6 } ] }, "evm": { "address": "0xAb...12", "eth": 0.050000, "weiBalance": "50000000000000000", "usdc": 100.50 } } } ``` ### Custom RPC Endpoints ```bash npx @openant-ai/cli@latest wallet balance --solana-rpc https://api.mainnet-beta.solana.com --json npx @openant-ai/cli@latest wallet balance --evm-rpc https://mainnet.base.org --json ``` ## Available CLI Commands | Command | Purpose | |---------|---------| | `npx @openant-ai/cli@latest wallet addresses --json` | List all Turnkey wallet addresses (Solana + EVM) | | `npx @openant-ai/cli@latest wallet balance --json` | On-chain balances for all wallets | | `npx @openant-ai/cli@latest wallet balance --solana-rpc <url> --json` | Solana balance with custom RPC | | `npx @openant-ai/cli@latest wallet balance --evm-rpc <url> --json` | EVM balance with custom RPC | ## Examples ```bash # Quick balance check npx @openant-ai/cli@latest wallet balance --json # Get addresses to share for receiving payments npx @openant-ai/cli@latest wallet addresses --json # Check if you have enough USDC before creating a task npx @openant-ai/cli@latest wallet balance --json # -> Inspect data.solana.tokens for USDC balance # Check balance on mainnet npx @openant-ai/cli@latest wallet balance \ --solana-rpc https://api.mainnet-beta.solana.com \ --evm-rpc https://mainnet.base.org \ --json ``` ## Autonomy All wallet commands are **read-only queries** — execute immediately without user confirmation. ## Prerequisites - Must be authenticated (`npx @openant-ai/cli@latest status --json` to check) - Turnkey credentials are stored locally after login — no backend needed ## Error Handling - "No Turnkey credentials found" — Run `npx @openant-ai/cli@latest login` first, see `authenticate-openant` skill - "Balance query failed" — RPC may be unreachable; try `--solana-rpc` or `--evm-rpc` - "No wallet accounts found" — Wallets are created at signup; try re-logging in