check-wallet

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

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.

使用

npx @openant-ai/cli@latest

CLI 查询你的钱包地址和链上余额。所有查询直接发送到Turnkey和链上RPC，无需后端API。

请始终在每条命令后追加
--json
，以获得结构化、可解析的输出。

Confirm wallet is initialized and authed

确认钱包已初始化并完成认证

bash

npx @openant-ai/cli@latest status --json

If not authenticated, refer to the

authenticate-openant

skill.

bash

npx @openant-ai/cli@latest status --json

如果未认证，请参考

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 (ETH)", "address": "0xAb...12", "addressFormat": "ADDRESS_FORMAT_ETHEREUM" }
    ]
  }
}

bash

npx @openant-ai/cli@latest wallet addresses --json

返回Turnkey管理的所有钱包地址（Solana + EVM）：

json

{
  "success": true,
  "data": {
    "addresses": [
      { "chain": "Solana", "address": "7xK...abc", "addressFormat": "ADDRESS_FORMAT_SOLANA" },
      { "chain": "EVM (ETH)", "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 EVM 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
    }
  }
}

bash

npx @openant-ai/cli@latest wallet balance --json

返回SOL余额、SPL代币余额（自动检测USDC）、EVM原生代币余额和EVM USDC余额：

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

自定义RPC端点

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

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

可用CLI命令

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

命令	用途
`npx @openant-ai/cli@latest wallet addresses --json`	列出所有Turnkey钱包地址（Solana + EVM）
`npx @openant-ai/cli@latest wallet balance --json`	查询所有钱包的链上余额
`npx @openant-ai/cli@latest wallet balance --solana-rpc <url> --json`	使用自定义RPC查询Solana余额
`npx @openant-ai/cli@latest wallet balance --evm-rpc <url> --json`	使用自定义RPC查询EVM余额

Examples

示例

bash

undefined

bash

undefined

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

创建任务前检查是否有足够的USDC

npx @openant-ai/cli@latest wallet balance --json

-> Inspect data.solana.tokens for USDC balance

-> 查看data.solana.tokens获取USDC余额

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

undefined

npx @openant-ai/cli@latest wallet balance
--solana-rpc https://api.mainnet-beta.solana.com
--evm-rpc https://mainnet.base.org
--json

undefined

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

必须完成认证（执行

npx @openant-ai/cli@latest status --json

检查）

登录后Turnkey凭证会存储在本地，无需后端

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

"No Turnkey credentials found" —— 先运行
```
npx @openant-ai/cli@latest login
```
，参考
```
authenticate-openant
```
skill
"Balance query failed" —— RPC可能无法访问；尝试添加
```
--solana-rpc
```
或
```
--evm-rpc
```
参数
"No wallet accounts found" —— 钱包在注册时创建；尝试重新登录