核心用法
check-wallet 是一个纯客户端区块链查询工具,通过 OpenAnt CLI 直接连接 Solana 和 EVM 链的 RPC 节点,获取钱包地址与链上余额信息。主要功能包括:
- 地址查询:一键获取 Solana 和 EVM(ETH/Base 等)双链钱包地址
- 余额查询:实时读取 SOL 原生余额、SPL 代币(自动识别 USDC)、ETH 原生余额及 EVM 链 USDC 余额
- 自定义 RPC:支持通过
--solana-rpc和--evm-rpc参数指定自定义节点,规避公共 RPC 拥堵或限制 - 结构化输出:所有命令强制附加
--json,返回标准化 JSON 便于程序解析
显著优点
1. 去信任架构:直连链上 RPC,无需依赖 OpenAnt 后端 API,消除第三方数据篡改风险
2. 多链统一:单命令同时查询 Solana + EVM 双生态,避免切换工具的繁琐
3. 自动化友好:JSON 输出天然适配脚本与 Agent 工作流,支持程序化余额检查(如任务创建前的资金预检)
4. 零确认执行:读操作无需用户二次确认,查询延迟极低
潜在局限
- 只读限制:仅支持查询,无法执行转账、签名等状态变更操作
- RPC 依赖:若自定义 RPC 节点失效或受速率限制,查询将失败(需手动切换节点)
- 凭证前置:必须预先完成 OpenAnt CLI 登录,离线环境下无法使用
- 代币识别范围:自动识别的稳定币仅限于 USDC,其他 SPL/ERC-20 代币可能仅显示合约地址需人工解析
适合人群
- 需要频繁核对多链余额的 DeFi 交易者或做市商
- 构建自动化工作流的开发者(如任务创建前检查 USDC 充足性)
- 对数据自主性有要求、倾向于验证而非信任的用户
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| RPC 节点监控 | 自定义 RPC 可能记录查询 IP 与钱包地址关联 | 使用隐私 RPC(如 Helius/Alchemy 的隐私模式)或代理 |
| 余额非最终性 | 链上余额可能因回滚、假充值而变化 | 大额操作前等待区块确认数达标 |
| CLI 凭证泄露 | 本地存储的登录凭证若被窃取可导致信息泄露 | 遵循 `authenticate-openant` 的安全存储建议 |
| 误读精度 | `uiAmount` 与原始 `amount` 混淆可能导致金额误判 | 始终核对 `decimals` 字段进行换算 |
使用示例
# 快速检查全链余额 npx @openant-ai/cli@latest wallet balance --json # 任务创建前验证 USDC 充足性 npx @openant-ai/cli@latest wallet balance --json | jq '.data.solana.tokens[] | select(.symbol=="USDC").uiAmount' # 使用 Base 主网 RPC 查询 npx @openant-ai/cli@latest wallet balance --evm-rpc https://mainnet.base.org --json