mirage-solana-wallet

用途：当任务需要智能体代为操作 Solana 钱包时使用本技能，覆盖钱包创建、地址解析、余额查询、充值、兑换、SPL 公私转账、任意 Anchor 程序调用以及原始交易或消息签名。全部操作通过 mirage 和捆绑的 mirage ows CLI 执行，底层为 OWS 钱包，默认钱包名为 agent-treasury。\n\n主要能力与用法：创建命名钱包用 mirage ows wallet create --name <wallet>，列出用 mirage ows wallet list，查地址用 mirage address --wallet <name>，查余额用 mirage balance --wallet <name>。mirage address、balance、fund、transfer、swap、invoke 在默认钱包缺失时会自动创建。充值使用 mirage fund，它是接收/充值流程而非发送流程。调用 Anchor 程序先尝试 mirage invoke <program-id>；若提示链上无 IDL，则用 --idl <path> 指定本地 IDL。非交互环境（脚本、CI、无 TTY 的智能体框架）使用 --show-idl 查看指令目录，再以 --ix、--arg、--account、--yes 驱动，可加 --dry-run 预览。SPL 转账用 mirage transfer --to <recipient> --amount <ui-amount>，默认主网 USDC、私有可见性，可用 --mint、--wallet、--visibility public 调整。兑换先用 quote 接口 GET https://payments.magicblock.app/v1/swap/quote 获取报价并展示 inAmount、outAmount、otherAmountThreshold、slippageBps、priceImpactPct 等，经用户确认后再执行 mirage swap，且 swap 不支持 --yes。签名用 mirage ows sign tx 或 mirage ows sign message。\n\n安全与限制：所有钱包、资金、转账、程序调用与签名流程都视为敏感操作，执行前需简要确认钱包、网络、程序/收款方、mint、金额与参数；不熟悉程序时优先 devnet；优先使用 OWS_PASSPHRASE 而非命令行 --passphrase；mirage transfer 与 mirage swap 接受 UI 金额（如 0.1），仅在直接调用 quote API 时才需转换为基本单位。若只提供收款钱包名，先用 mirage address 解析。旧版 Mirage 在私有转账时出现 BlockhashNotFound 可能表示全局 CLI 过旧。