AIBTC Bitcoin Wallet

核心用法

AIBTC Bitcoin Wallet 是一款专为 AI 代理设计的比特币钱包管理技能，提供完整的 Bitcoin L1 操作能力。核心功能包括：

• 余额与 UTXO 管理：get_btc_balance 查询总余额、确认及未确认余额；get_btc_utxos 列出 UTXO 详情，支持筛选仅确认交易
• 交易发送：transfer_btc 支持按 satoshis 精确转账，内置三种预设费率（fast/medium/slow）或自定义 sat/vB
• 钱包生命周期管理：加密存储于 ~/.aibtc/，支持创建（BIP39 助记词）、导入、解锁/锁定、多钱包切换
• 网络费用估算：get_btc_fees 提供 ~10 分钟/~30 分钟/~1 小时三档费率参考

显著优点

1. 代理原生设计：工具命名与参数结构针对 LLM 调用优化，自然语言即可触发复杂操作（如"发送 50000 sats 到 bc1q... 使用 medium 费率"）
2. 安全架构：钱包采用加密存储，交易前需显式解锁，操作后可主动锁定；助记词不上云
3. 渐进式扩展：Bitcoin L1 为基础层，可无缝叠加 Stacks L2（STX 转账、DEX 兑换、借贷）、Pillar 智能钱包（sBTC 收益自动化）、铭文及 Genesis 身份声誉系统
4. 多网络支持：一行命令切换主网/测试网，地址格式自动校验（bc1/tb1）

潜在缺点与局限性

• 依赖本地密钥管理：虽有加密，但仍为热钱包架构，大额资产建议配合硬件钱包或离线签名
• Bitcoin L1 功能边界：不支持原生智能合约，复杂 DeFi 需依赖 Stacks L2 扩展层
• 费率估算依赖外部 API：极端网络拥堵时可能偏差
• 多钱包切换无原子性：并发场景下需开发者自行管理状态

适合人群

• 构建 AI 代理自动化比特币操作的开发者
• 需要程序化管理 BTC 热钱包的量化交易/支付场景
• 探索 Bitcoin + Stacks 生态集成的 Web3 项目

常规风险

• 助记词泄露风险：加密文件若被物理访问且密码薄弱，存在暴力破解可能
• 测试网/主网误操作：地址前缀校验（bc1 vs tb1）需人工确认，代理可能因提示词注入发送错网络
• UTXO 粉尘攻击：未设置 UTXO 过滤阈值，可能积累小额输入导致未来交易费率飙升
• 智能合约层风险：Stacks L2 及 Pillar 扩展涉及第三方协议智能合约风险，需额外审计

核心用法

AIBTC Bitcoin Wallet是一个面向AI Agent的比特币钱包管理技能，提供从基础到高级的完整功能层级。核心功能围绕钱包生命周期管理展开：用户可通过wallet_create生成BIP39加密助记词，使用wallet_import导入现有钱包，并通过wallet_unlock/wallet_lock控制钱包的活跃状态。完成解锁后，即可执行transfer_btc转账操作，配合get_btc_balance余额查询和get_btc_fees费率估算，形成完整的交易闭环。

该技能采用分层架构设计，基础层专注比特币L1操作（余额查询、UTXO管理、P2WPKH转账），扩展层则无缝衔接Stacks L2生态——支持STX代币流转、ALEX DEX兑换、Zest Protocol借贷等DeFi场景，以及Pillar智能钱包的sBTC收益自动化功能。所有金额以satoshis为单位，地址严格区分mainnet（bc1开头）与testnet（tb1开头）。

显著优点

安全性设计突出：钱包采用加密存储（~/.aibtc/目录），支持多钱包并行管理（wallet_list/switch），操作后主动锁定清除内存痕迹。BIP39标准兼容现有硬件钱包生态，降低迁移成本。

渐进式功能 exposing：纯文档型架构让用户按需探索——新手可止步于基础转账，进阶用户可深入Stacks智能合约交互，机构用户可部署Pillar自动化收益策略。这种"分层解锁"模式显著降低了学习曲线。

生态整合深度：不仅是孤立钱包工具，而是嵌入AIBTC完整的Agent身份体系（Genesis Lifecycle），支持X认证、BTC空投激活、5分钟存活心跳等链上声誉机制，为未来Agent经济网络奠定基础。

潜在缺点与局限性

网络依赖性明显：所有操作依赖外部API（Pillar、ALEX、Zest等DeFi服务），节点故障或服务变更可能导致功能中断。测试网与主网切换需重新安装（--testnet标志），缺乏运行时切换能力。

功能边界模糊：作为纯Markdown文档型Skill，实际执行依赖底层MCP服务器（@aibtc/mcp-server），文档与代码分离可能导致版本不同步。用户难以直接审计交易构造逻辑，信任链条延伸至NPM包维护者。

DeFi风险敞口：扩展功能涉及多个第三方协议，智能合约漏洞、流动性风险、预言机故障等系统性风险未被文档充分披露。sBTC作为封装资产，存在中心化托管假设。

适合的目标群体

• 加密原生开发者：熟悉比特币UTXO模型，需要快速搭建Agent自动化支付流程
• Stacks生态参与者：持有STX/sBTC，寻求自动化DeFi策略（定投、借贷、流动性挖矿）
• AI Agent构建者：需要为Agent赋予链上身份和经济能力，参与x402付费API经济
• 小额高频支付场景：内容付费、API调用结算、微打赏等需要程序化BTC转账的用例

不适合：大额冷存储需求者（建议硬件钱包）、完全不懂加密货币的新手（缺乏交互式引导）、追求极致隐私者（依赖外部API暴露地址关联性）。

使用风险

资金安全风险：尽管Skill本身无恶意代码，但用户误操作（地址粘贴错误、fee rate设置过低导致交易卡住、测试网/主网混淆）可能导致不可逆损失。建议始终先在testnet验证流程。

依赖项风险：NPM包更新可能引入破坏性变更，MCP协议版本兼容性需持续关注。外部DeFi协议参数调整（如ALEX兑换费率）可能使自动化策略失效。

性能与可用性：比特币网络拥堵时费率估算可能失准，导致交易长时间未确认。多UTXO场景下未实现Coin Selection优化，可能产生不必要的 dust output。

合规不确定性：sBTC、Stacks等L2资产的监管分类在部分司法管辖区尚不明确，自动化收益功能可能触发证券或税务申报义务。