sparkbtcbot-proxy
为AI智能体提供安全的Spark比特币钱包HTTP代理服务。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：sparkbtcbot-proxy。 它的用途是：为AI智能体提供安全的Spark比特币钱包HTTP代理服务。 完整的 Skill 内容见：https://321skill.com/skills/sparkbtcbot-proxy/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“检查我的Spark钱包余额。”，它会调用代理的`/api/balance`接口并返回余额信息。或者
对AI说：“向客户创建一个1000聪的闪电网络发票，备注‘服务费’。”，AI会通过代理的`/api/invoice/create`接口生成BOLT11发票。
介绍
sparkbtcbot-proxy 是一个无服务器代理，旨在解决AI智能体直接操作比特币钱包时的安全风险。它通过将Spark比特币L2钱包的SDK封装在需要身份验证的REST API之后，让智能体可以在不接触私钥或助记词的情况下，安全地进行余额查询、创建发票和发送支付等操作。
使用时，开发者需部署此代理服务，并配置环境变量（如助记词和API认证令牌）。AI智能体通过向代理的API端点发送携带Bearer Token的HTTP请求来执行钱包操作。代理服务会根据Token对应的角色（如admin, invoice, pay-only, read-only）来验证和限制其权限。
该工具非常适合那些希望将比特币支付能力集成到其AI应用（如客服机器人、自动化工具）中的开发者、运维工程师或智能体开发者。它尤其适用于生产环境，需要严格管控资金安全和操作权限的场景。
部署时请注意，务必妥善保管API_AUTH_TOKEN和环境变量中的助记词，避免泄露。建议仅使用强生成的Token分发给智能体，并利用其内置的消费限额和角色权限功能，为不同的智能体分配最小必要权限。
核心特点
与直接使用Spark SDK的Skill不同，本代理将敏感的助记词完全隔离在服务端，AI智能体仅通过可撤销、带消费限额和角色权限的Token进行交互，从根本上解决了生产环境中私钥泄露的风险。
注意事项
不适合需要智能体直接、完全控制私钥进行复杂链上交互或离线签名的场景。
常见问题
如何为我的AI智能体创建一个只能收款的Token？
使用admin权限的Token调用`POST /api/tokens`接口，指定`role`为`invoice`即可生成一个仅能查询和创建发票的Token。
代理服务宕机了，是否有备用方案访问钱包？
环境变量`API_AUTH_TOKEN`是一个硬编码的admin后备令牌，即使Redis不可用也能工作，可用于紧急情况或初始引导。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/sparkbtcbot-proxy/raw/index.md 读取 sparkbtcbot-proxy 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/sparkbtcbot-proxy/raw/index.md（查看排版版本）