核心用法
Kaspa Wallet Skill 是一个基于 Kaspa Python SDK 的轻量级命令行钱包工具，专为自动化场景设计。用户通过环境变量注入私钥或助记词，实现完全自托管的资产管理。核心功能包括：余额查询（支持任意地址）、KAS 转账（支持指定金额或 max 全余额发送）、支付 URI 生成（符合 BIP-21 风格的 kaspa: 协议）、网络状态监控及手续费估算。
CLI 设计遵循 Unix 哲学，所有命令返回结构化 JSON，便于脚本解析和 Agent 集成。安装流程通过 install.py 自动完成虚拟环境与依赖配置，支持 macOS/Linux/Windows 三平台。
显著优点
1. 自动化友好：JSON 输出原生支持管道处理，适合 CI/CD、定时任务和 AI Agent 调用
2. 自托管安全：私钥仅存在于内存与环境变量，无本地持久化存储，降低泄露面
3. Kaspa 生态原生：直接对接 wRPC 节点，支持主网、测试网及自定义 RPC 端点
4. UTXO 管理：内置 max 自转账功能，可主动合并 UTXO 解决 Storage Mass 限制
5. 零 GUI 依赖：纯 CLI 运行，服务器/容器环境部署无负担
潜在缺点与局限
- 功能精简：无交易历史查询、多地址管理、二维码生成等零售用户常用功能
- 错误处理依赖文档：如
STORAGE_MASS_EXCEEDED等 Kaspa 特有错误需用户自行理解 UTXO 模型 - 网络依赖：每次命令新建 RPC 连接，高并发场景下连接开销明显
- 无硬件钱包支持：仅支持软件密钥，大额资产存储安全性有限
- SDK 成熟度：
kaspa-py为社区维护，API 稳定性不及 Bitcoin/Ethereum 主流库
适合人群
- 开发者与 DevOps 工程师：需要将 Kaspa 支付集成到自动化流程
- 节点运营者：快速查询链上状态、验证交易广播
- 交易所/服务商后台：临时热钱包管理、批量地址检测
- 技术型用户：偏好 CLI 界面、重视隐私与自托管
常规风险
| 风险类型 | 说明 | 缓释建议 |
|---------|------|---------|
| 密钥泄露 | 环境变量可能被 `ps`、`/proc` 读取 | 使用专用机密管理服务，命令执行后立即 `unset` |
| RPC 节点作恶 | 自定义端点可能返回虚假余额 | 交叉验证多个节点或使用官方公共节点 |
| 交易不可逆 | Kaspa 确认速度快（~10秒），误发无法撤回 | 首次转账先用小额测试，确认地址格式 `kaspa:q...` |
| Storage Mass 限制 | 小额 UTXO 可能无法单独花费 | 定期执行 `send ... max` 合并 UTXO |
| 依赖供应链 | `kaspa-py` 及其底层 Rust 绑定存在供应链攻击可能 | 锁定依赖版本，审计 `requirements.txt` 变更 |