aibtc-bitcoin-wallet

₿ 比特币 L1/L2 智能钱包管家

AIBTC 比特币钱包,支持 L1 转账与 UTXO 管理,可扩展至 Stacks L2 DeFi 与 Pillar 生息,实现安全的链上资产自动化管理。

收藏
9.8k
安装
3k
版本
v1.26.0
CLS 安全性认证2026-05-10
点击查看完整报告 >

使用说明

核心用法

AIBTC Bitcoin Wallet 是一个专注于比特币 L1 资产管理的 Agent 技能,通过简单的自然语言指令即可完成复杂的加密货币操作。其核心功能围绕钱包生命周期管理展开:用户可通过 wallet_create 生成符合 BIP39 标准的加密助记词,或使用 wallet_import 导入现有钱包,所有敏感数据均加密存储于本地 ~/.aibtc/ 目录。

在日常操作中,用户可通过 "What's my BTC balance?" 等自然语言查询余额,get_btc_fees 提供实时网络费率估算(fast/medium/slow 三档),而 transfer_btc 支持以 satoshi 为单位的精确转账。该技能采用分层架构设计,基础层(L1)专注比特币原生操作,扩展层(L2)支持 Stacks 生态的 STX 代币、ALEX DEX 交换和 Zest 协议借贷,Layer 3 则通过 Pillar 智能钱包实现 sBTC 生息自动化和 Passkey 签名交易。

显著优点

该技能最突出的优势在于其纯文档型架构,SKILL.md 本身不包含可执行代码,仅提供标准化操作指引,从根本上消除了本地代码执行风险。其渐进式功能分层设计允许用户根据需求选择使用深度,从简单的余额查询到复杂的跨链 DeFi 操作均可无缝衔接。

多钱包管理功能支持用户创建隔离的"日常钱包"和"交易钱包",通过 wallet_switch 快速切换上下文。测试网支持(--testnet 参数)为开发者提供了零风险的实验环境。与 x402 付费 API 的集成更拓展了 AI 服务的支付场景,使 Agent 能够自主完成链上支付。

潜在缺点与局限性

作为纯文档型技能,其实际功能完全依赖外部 MCP 服务器@aibtc/mcp-server npm 包),这意味着用户必须信任并审查第三方代码库。当前仅支持原生 SegWit 地址格式(bc1/tb1 开头),对旧版地址兼容性有限。

来源可信度为 T3 级(社区项目),缺乏企业级安全背书。虽然文档本身安全,但实际资金操作涉及真实加密货币,存在不可逆的交易风险。此外,每次转账前必须手动解锁钱包(wallet_unlock),虽然提升了安全性,但在高频自动化场景下可能影响用户体验。

适合的目标群体

该技能主要面向加密货币开发者DeFi 高级用户,特别是需要构建自动化交易机器人的技术团队。对于持有 sBTC 并寻求被动收益的"生息猎人",Pillar 智能钱包集成提供了便捷的收益优化入口。

区块链教育机构可利用其清晰的文档结构和测试网支持进行教学演示。同时,任何希望通过自然语言界面管理比特币资产、避免直接操作复杂 CLI 工具的"非技术型Holder"也能从中受益。

使用风险

首要风险来自外部依赖项:npm 包 @aibtc/mcp-server 的更新可能引入未经审计的代码,建议在生产环境使用前锁定版本并进行代码审查。加密货币操作固有的不可逆性意味着错误的地址输入或金额设置将导致永久资金损失,尽管文档提供了地址格式验证(bc1/tb1),但用户仍需仔细核对。

助记词管理风险不容忽视:虽然钱包文件加密存储,但密码强度直接决定资产安全。网络费用波动可能导致小额转账不经济,建议在大额操作前使用 get_btc_fees 确认当前费率。最后,作为 T3 来源的社区项目,其长期维护稳定性和安全响应速度可能不及企业级解决方案。

安全解读

核心用法

AIBTC Bitcoin Wallet 是一款面向 AI Agent 的比特币 L1 钱包管理技能,通过自然语言指令即可完成复杂的加密货币操作。核心功能包括:

基础钱包操作

  • 余额查询:支持查看 BTC 总余额、已确认/未确认余额
  • 费率获取:实时获取网络费率(快/中/慢三档,对应约10分钟/30分钟/1小时确认时间)
  • UTXO 管理:列出未花费交易输出,支持筛选仅确认 UTXO
  • 转账功能:以 satoshi 为单位向 bc1...(主网)或 tb1...(测试网)地址发送 BTC

钱包生命周期管理

  • 创建新钱包:生成加密存储的 BIP39 助记词
  • 导入现有钱包:从助记词短语恢复
  • 解锁/锁定机制:交易前需解锁,完成后建议立即锁定
  • 多钱包支持:支持列表、切换不同钱包

渐进式扩展架构

  • Stacks L2(Layer 2):STX 代币转账、ALEX DEX 兑换、Zest Protocol 借贷、x402 付费 API
  • Pillar 智能钱包(Layer 3):sBTC 收益自动化、Passkey/代理签名、BNS 域名转账(如 alice.btc)
  • 比特币铭文:Commit-reveal 铭文流程、Ordinal UTXO 保护
  • Genesis 生命周期:代理身份与声誉系统

显著优点

1. 纯文档型零风险架构:无可执行代码,仅通过 Markdown 指导 Agent 调用 MCP 工具,从根本上杜绝代码注入风险
2. 分层渐进设计:从基础 BTC 操作到高级 DeFi,用户可按需启用不同层级功能

3. 本地加密存储:钱包数据加密存储于 ~/.aibtc/,私钥不上传云端

4. 活跃的开源生态:aibtcdev 为 GitHub 组织账号,项目采用 MIT 协议,npm 包 @aibtc/mcp-server 持续维护

5. 自然语言交互:"Send 50000 sats to bc1q..." 式指令降低使用门槛

6. 测试网支持:一键切换 testnet 模式,便于安全测试

潜在缺点与局限性

1. 依赖外部 MCP 服务器:实际交易执行依赖 @aibtc/mcp-server,Skill 本身仅为文档指导层
2. 多 API 依赖风险:涉及 mempool.space、Hiro API、Pillar API 等多个第三方服务,存在可用性依赖

3. 金融操作固有风险:交易不可逆、私钥丢失不可恢复、智能合约风险(L2/L3 功能)

4. 地址格式限制:仅支持 Native SegWit(bc1/tb1 开头),不包含 Legacy 或 P2SH 地址

5. 单位单一性:金额强制使用 satoshi,对习惯 BTC 单位的用户需心算转换

适合人群

  • AI Agent 开发者:需要为 Agent 集成比特币原生支付能力的开发者
  • Stacks 生态用户:已在 Stacks L2 活跃,希望统一管理 BTC 和 STX 资产的用户
  • DeFi 自动化探索者:希望通过 Agent 自动执行 sBTC 收益策略的早期采用者
  • 技术型加密货币用户:熟悉助记词、UTXO、fee rate 等概念,追求非托管方案的用户
  • 不适合:完全不了解加密货币基础操作、无法承担私钥管理责任的新手用户

常规风险

  • 资金损失风险:地址输入错误导致 BTC 永久丢失(区块链交易不可逆)
  • 私钥安全:助记词和密码需自行保管,无「忘记密码」恢复机制
  • 智能合约风险:L2/L3 DeFi 操作涉及第三方合约,可能存在漏洞或治理风险
  • 钓鱼风险:需警惕假冒的 wallet_unlock 等诱导性指令
  • 网络费用波动:高峰期费率可能远高于预期,小额转账可能不经济
  • 版本兼容性:MCP 服务器更新后,Skill 文档可能存在滞后

aibtc-bitcoin-wallet 内容

references文件夹
手动下载zip · 17.6 kB
genesis-lifecycle.mdtext/markdown
请选择文件