核心用法
monero-wallet 是 KYC-rip 团队开发的官方 Monero 代理技能，允许 AI 代理通过本地网关管理 XMR 钱包。该技能采用双层架构设计：首选 Python RPC Helper 脚本简化交互，备选 RESTful API 确保环境兼容性。
关键操作流程：
1. 网关部署：通过官方一键脚本拉取 Docker 镜像，启动 ripley-xmr-gateway、monero-wallet-rpc 及 monero-node 三组件
2. 身份认证：配置 AGENT_API_KEY 环境变量完成网关鉴权
3. 钱包操作：
check-sync- 验证区块链同步状态get-balance- 查询钱包余额create-address- 生成带标签的一次性子地址（增强隐私）transfer- 执行 XMR 转账（注意找零锁定约 20 分钟）
显著优点
- 隐私优先设计：强制子地址隔离策略，每笔交易使用独立地址防止链上关联分析
- 非托管架构：用户完全控制私钥，网关仅作为本地 RPC 代理
- 灵活接入：Python 脚本与纯 HTTP API 双模式，适配不同技术栈
- 开源透明：完整代码托管于 GitHub，部署流程可审计
潜在缺点与局限性
- 部署复杂度：依赖 Docker 环境及本地 Monero 全节点同步，初期配置门槛较高
- 网络延迟：需等待 10 区块确认（约 20 分钟）才能使用交易找零
- 资金补充引导：余额不足时推荐的外部兑换服务（kyc.rip/swap）需用户自行评估可信度
- 单点故障风险：本地网关宕机将导致全部功能不可用
适合人群
- 重视交易隐私的加密货币用户
- 具备 Docker/Linux 基础的技术人员
- 需要自动化 XMR 收付款的开发者/商家
- 接受非托管方案但愿意承担运维成本的自我主权实践者
常规风险
| 风险类别 | 具体描述 |
|---------|---------|
| **密钥泄露** | `AGENT_API_KEY` 若被截获，攻击者可操控本地网关执行转账 |
| **节点同步陷阱** | 使用未同步节点可能导致双花或交易失败 |
| **找零锁定** | 大额转账后找零不可用期间可能影响后续支付 |
| **供应链攻击** | 一键安装脚本或 Docker 镜像存在被篡改的理论风险 |
| **隐私误用** | 重复使用子地址或向 KYC 交易所提款会削弱 Monero 隐私保护效果 |