用途:围绕 Mirage 钱包完成 Solana 上的充值、SPL 转账、交易签名,以及按 Anchor IDL 调用任意 Solana 程序。
主要能力: 钱包管理:mirage ows wallet create --name <wallet>、mirage ows wallet list;mirage address、balance、fund、transfer 在默认 agent-treasury 钱包缺失时会自动创建。 充值:mirage fund 为接收或充值流程,可选 --wallet <name>,打开 Mirage 托管充值流程。 转账:mirage transfer --to <recipient> --amount <ui-amount>,可加 --wallet、--mint、--visibility private|public(默认 private)、--cluster 或 --rpc-url。UI 金额直接传入,无需换算最小单位。 程序调用:mirage invoke <program-id> 优先使用链上 Anchor IDL;报错未发布 IDL 时用 --idl <path> 提供本地 IDL。CLI 会拉取 IDL、交互选择指令、自动推导签名者、知名 sysvar/程序及 IDL 声明的 PDA,仅对无法解析的参数和账户提示,确认摘要后签名广播。 交易签名:mirage ows sign tx --wallet <name> --chain solana --tx <unsigned-tx-hex>;消息签名用 mirage ows sign message。
使用方式与安全:钱包充值、转账、程序调用与签名为敏感操作。执行前需用一句简短确认复述钱包、收款方、mint、金额、网络与交易来源;invoke 前复述程序 ID、集群、所选指令及参数账户,陌生程序优先 devnet。优先使用 OWS_PASSPHRASE 而非命令行 --passphrase。仅在用户已确认完整交易计划时使用 --yes。完成后报告交易签名、发送方地址,并按集群给出浏览器链接。
限制:mirage fund 是收款/充值而非发送流程;transfer 默认主网 USDC 且私密可见;仅凭钱包名收款时需先用 mirage address 解析;新钱包需显式创建;invoke 默认链上 IDL PDA,无链上 IDL 时才需本地文件;旧版本私密转账出现 BlockhashNotFound 可能需更新 CLI。