sage-wallet

核心用法

Sage Wallet Skill 提供了通过 RPC 接口与 Chia 区块链钱包交互的完整解决方案，支持以自然语言或斜杠命令管理 XCH 资产、CAT 代币、NFT 及去中心化身份（DID）。该技能采用模块化架构，将不同功能域划分为 12 个子技能（如 sage-xch、sage-nft、sage-offers 等），通过统一的配置管理系统实现跨平台支持（Mac/Linux/Windows）。用户可通过 /sage 命令完成钱包配置、资产转账、NFT 铸造、交易报价等操作，所有通信均通过 HTTPS 搭配 mTLS 证书验证，确保本地与 Sage Wallet 节点间的安全连接。

显著优点

该技能的首要优势在于其严谨的安全性设计，使用双向 TLS 认证保护 RPC 通信，私钥和证书严格保存在本地文件系统，不上传至任何远程服务器。其次功能覆盖全面，涵盖 Chia 生态的完整资产类型及高级功能如 Offers 和 Options 协议。配置方面灵活便捷，支持自动平台检测和自定义 RPC 端点，便于开发测试与生产环境切换。此外，错误处理机制完善，具备清晰的 HTTP 状态码映射和参数校验，能有效防止误操作。

潜在缺点与局限性

作为 T3 级社区项目，虽通过安全审计但缺乏顶级机构背书，信任建立需要时间。使用前必须在本地安装并运行 Sage Wallet 软件，增加了部署门槛和系统资源占用。由于涉及真实加密货币操作，存在不可逆的交易风险，一旦指令执行错误可能导致资产永久损失。此外，初始配置需要处理 SSL 证书路径和钱包指纹设置，对非技术用户存在学习曲线。

适合的目标群体

主要面向 Chia 区块链生态的活跃参与者，包括农民、交易者和流动性提供者；需要自动化管理数字资产的进阶用户；NFT 创作者和 CAT 代币发行方；以及希望集成 Chia 支付功能的开发者。对于仅进行简单余额查询的轻度用户，直接使用 Sage GUI 可能更为直观易用。

使用风险

需特别注意资产安全风险：误操作可能导致加密货币永久丢失。证书文件若权限设置不当（建议设置为 600）可能造成私钥泄露。若错误配置远程 RPC 端点，存在中间人攻击和未授权访问风险。此外，技能依赖本地 Sage Wallet 软件的版本兼容性，更新不同步可能导致功能异常。强烈建议仅在本地网络环境使用，开发和测试时优先选用 testnet 网络，并确保 SSL 证书和私钥文件妥善保管。