用途:Vara Wallet 是面向 AI 智能体的命令行工具,用于与 Vara Network 进行链上交互,包括部署程序、调用 Sails 方法、管理钱包、转账 VARA、查询状态和监控事件。安装命令为 npm install -g vara-wallet。
主要能力:只读命令无需账户,可查询节点信息、余额、程序与代码信息、Sails 只读查询、状态读取、邮箱与事件查询、VFT 代币信息、DEX 交易对与报价等。写入命令需加 --account <name>,支持转账、程序上传与部署、代码上传、消息发送与回复、Sails 状态变更调用、VFT 转账/授权/铸造/销毁、DEX 兑换与流动性操作、凭证签发、水龙头领测试币、签名与通用交易提交。另有验证、等待消息、监听事件与区块、订阅邮箱/余额/转账/程序状态等监控命令,以及钱包创建、导入、导出、默认设置和配置管理。
使用方式:首次使用可执行 vara-wallet wallet create --name agent 创建加密钱包,口令自动生成并存于 ~/.vara-wallet/.passphrase(0600),智能体无需接触。所有命令输出 JSON 到 stdout,错误以 { error, code } 输出到 stderr。Sails 命令需 IDL,可通过 --idl <path> 提供,VFT 命令有内置 IDL。网络可用 --network mainnet|testnet|local、--ws 或 VARA_WS 环境变量指定,默认主网。金额默认单位为 VARA(1 VARA = 10^12 最小单位),可用 --units raw 切换。
适用场景:智能体在 Vara 主网、测试网或本地节点上部署并调用 Sails 程序、管理代币与 DEX 操作、监控链上事件、签名验证等。
限制:不适用于编写 Sails Rust 程序、运行 gtest 或搭建 Rust/Gear 工具链。水龙头仅测试网可用。消息为异步,发送后需用 wait 获取回复。主网存在约 10 VARA 的存在性存款。连接超时为 10 秒。不要在脚本参数中传递助记词、种子或口令,应使用加密钱包文件。非 VFT 程序必须提供 --idl。部分细节(如远程 IDL 注册表)资料未提供。