Zerion 是面向 AI 智能体的加密钱包统一 API 与 CLI,覆盖 14 条 EVM 链和 Solana。zerion 二进制通过 npm 发布,本技能是安装、认证和路由到具体能力技能的入口。
安装:可免安装运行 npx zerion --help,或全局安装 npm install -g zerion。需要 Node.js ≥ 20。
认证有三种模式,分析类任务任选其一,交易始终使用 API 密钥。A) API 密钥(推荐):export ZERION_API_KEY="zk_dev_...",密钥在 dashboard.zerion.io 获取,开发密钥以 zk_dev_ 开头,限制为 120 请求/分钟、5K 请求/天。B) x402 按次付费(无需注册,仅分析):每次请求支付 0.01 USDC,支持 EVM(Base)或 Solana,可设置 WALLET_PRIVATE_KEY 后加 --x402,或全局 export ZERION_X402=true;两条链同时使用可分别设置 EVM_PRIVATE_KEY 与 SOLANA_PRIVATE_KEY,并可选 ZERION_X402_PREFER_SOLANA=true。C) MPP 按次付费(仅分析,EVM Tempo):每次请求支付 0.01 USDC,设置 TEMPO_PRIVATE_KEY 后加 --mpp,或全局 export ZERION_MPP=true。交易命令(swap、bridge、send)无论是否启用 x402/MPP,始终使用 API 密钥加智能体令牌。
按任务选择技能:查询钱包持仓、头寸、历史、盈亏、自选列表用 zerion-analyze;兑换、跨链、发送代币用 zerion-trading;签名消息或 EIP-712 类型数据(不广播)用 zerion-sign;创建、导入、列出、备份、删除钱包用 zerion-wallet;为自主交易设置智能体令牌与策略用 zerion-agent-management。
输出约定:所有命令默认向 stdout 输出 JSON,错误以结构化 JSON 输出到 stderr,例如 {"error":{"code":"missing_api_key","message":"..."}}。标志有 --json(默认)、--pretty(TTY 自动启用)、--quiet。
支持的链包括 ethereum、base、arbitrum、optimism、polygon、binance-smart-chain、avalanche、gnosis、scroll、linea、zksync-era、zora、blast、solana,可用 zerion chains 查看带元数据的实时目录。
常见错误码:missing_api_key(未设置 ZERION_API_KEY,设置环境变量或分析时用 --x402)、no_agent_token(交易/签名缺少智能体令牌,见 zerion-agent-management)、no_wallet(未指定钱包且无默认,用 --wallet <name> 或设置 defaultWallet)、wallet_not_found(钱包不在本地保险库,用 zerion wallet list 检查)、unsupported_chain(--chain 值无效,用 zerion chains 查有效 ID)、api_error 401(密钥无效)、api_error 429(限流,等待、降低频率或改用 x402)。
密钥管理:钱包通过 Open Wallet Standard(OWS)保险库以 AES-256-GCM 加密存放于 ~/.ows/,私钥不离开设备,签名在本地完成,Zerion API 不会接触密钥。~/.zerion/config.json(权限 0o600)存储智能体令牌、默认钱包、默认链和滑点。
资源:API 文档 developers.zerion.io,控制台 dashboard.zerion.io,x402 协议 x402.org,CLI 源码 github.com/zeriontech/zerion-cli。