aibtc-bitcoin-wallet

AIBTC Bitcoin Wallet

Bitcoin L1 ウォレットを管理するためのスキルです。オプションで Pillar スマートウォレットおよび Stacks L2 の DeFi 機能も利用できます。

インストール

ワンコマンドでインストールできます（デフォルトは Claude Code です）。

npx @aibtc/mcp-server@latest --install

他の MCP クライアントを選択するには、フラグを使用します。

npx @aibtc/mcp-server@latest --install --cursor     # Cursor
npx @aibtc/mcp-server@latest --install --codex      # OpenAI Codex CLI
npx @aibtc/mcp-server@latest --install --gemini     # Gemini CLI
npx @aibtc/mcp-server@latest --install --windsurf   # Windsurf
npx @aibtc/mcp-server@latest --install --vscode     # VS Code
npx @aibtc/mcp-server@latest --install --desktop    # Claude Desktop

テストネットを使用する場合は、任意のコマンドに --testnet を追加します。

npx @aibtc/mcp-server@latest --install --testnet

クイックスタート

残高の確認

Bitcoin の残高を確認します。

"What's my BTC balance?"

get_btc_balance を使用します。合計、確認済み、未確認の残高が返されます。

手数料の確認

現在のネットワーク手数料の推定値を取得します。

"What are the current Bitcoin fees?"

get_btc_fees を使用します。高速（約10分）、中速（約30分）、低速（約1時間）のレートが sat/vB 単位で返されます。

BTC の送金

Bitcoin をアドレスに送金します。

"Send 50000 sats to bc1q..."
"Transfer 0.001 BTC with fast fees to bc1q..."

transfer_btc を使用します。ウォレットのロック解除が必要です。

ウォレットのセットアップ

トランザクションを送信する前に、ウォレットをセットアップしてください。

1. 新しいウォレットを作成：wallet_create — 暗号化された BIP39 ニーモニックを生成します
2. 既存のウォレットをインポート：wallet_import — ニーモニックフレーズからインポートします
3. 使用するためにロック解除：wallet_unlock — トランザクションの前に必要です

ウォレットは ~/.aibtc/ に暗号化して保存されます。

ツールのリファレンス

読み取り操作

ツール	説明	パラメーター
get_btc_balance	BTC 残高を取得	address（省略可能。省略した場合、ウォレットのロック解除が必要）
get_btc_fees	手数料の推定値を取得	なし
get_btc_utxos	UTXO の一覧を取得	address（省略可能。省略した場合、ウォレットのロック解除が必要）、confirmedOnly

書き込み操作（ウォレットが必要）

ツール	説明	パラメーター
transfer_btc	BTC を送金	recipient、amount（sats）、feeRate

ウォレット管理

ツール	説明
wallet_create	新しい暗号化ウォレットを生成
wallet_import	ニーモニックからウォレットをインポート
wallet_unlock	トランザクション用にウォレットをロック解除
wallet_lock	ウォレットをロック（メモリから消去）
wallet_list	利用可能なウォレットの一覧を取得
wallet_switch	アクティブなウォレットを切り替え
wallet_status	ウォレット／セッションの状態を取得

メッセージ署名

ツール	説明	パラメーター
sip018_sign	構造化された Clarity データ（SIP-018）に署名	message、domain
sip018_verify	SIP-018 署名を検証し、署名者を復元	messageHash、signature、expectedSigner（省略可能）
sip018_hash	署名せずに SIP-018 ハッシュを計算	message、domain
stacks_sign_message	Stacks プレフィックスを付けてプレーンテキストに署名（SIWS 互換）	message
stacks_verify_message	Stacks メッセージの署名を検証し、署名者を復元	message、signature、expectedSigner（省略可能）
btc_sign_message	Bitcoin キーでプレーンテキストに署名（BIP-137／BIP-322）	message、addressType（省略可能）
btc_verify_message	Bitcoin メッセージの署名を検証（BIP-137／BIP-322 を自動判別）	message、signature、address（省略可能）
nostr_sign_event	デフォルトでは NIP-06 派生キー（m/44'/1237'/0'/0/0）を使用し、NIP-01 に準拠した Nostr イベントに BIP-340 Schnorr で署名	kind、content、tags（省略可能）、created_at（省略可能）、keySource（NIP-06 パス経由のデフォルト値 "nostr"、P2TR キー用の "taproot"、P2WPKH キー用の "segwit"）
schnorr_sign_digest	生の32バイトダイジェストに Schnorr／BIP-340 で署名	digest、confirmBlindSign、auxRand（省略可能）
schnorr_verify_digest	ダイジェストに対する BIP-340 Schnorr 署名を検証	digest、signature、publicKey

単位とアドレス

金額：常に satoshi 単位です（1 BTC = 100,000,000 satoshi）

アドレス：

• メインネット：bc1...（ネイティブ SegWit）
• テストネット：tb1...

手数料率："fast"、"medium"、"slow"、または sat/vB 単位のカスタム数値

ワークフローの例

毎日の残高確認

1. "What's my BTC balance?"
2. "Show my recent UTXOs"
3. "What are current fees?"

支払いの送金

1. "Unlock my wallet" (provide password)
2. "Send 100000 sats to bc1qxyz... with medium fees"
3. "Lock my wallet"

複数ウォレットの管理

1. "List my wallets"
2. "Switch to trading wallet"
3. "Unlock it"
4. "Check balance"

段階的なレイヤー

このスキルは Bitcoin L1 に重点を置いています。その他の機能はレイヤーごとに整理されています。

Stacks L2（レイヤー 2）

スマートコントラクトと DeFi を備えた Bitcoin L2：

• STX トークンの送金
• ALEX DEX でのトークンスワップ
• Zest Protocol での貸し出し／借り入れ
• x402 の有料 API エンドポイント（AI、ストレージ、ユーティリティ）— プローブしてから支払うワークフローにより、デフォルトで安全です

参照：references/stacks-defi.md

Pillar Smart Wallet（レイヤー 3）

利回り自動化機能を備えた sBTC スマートウォレット：

• パスキーまたはエージェント署名によるトランザクション
• BNS 名（alice.btc）宛ての送金
• Zest Protocol による利回りの自動ブースト

参照：references/pillar-wallet.md

Bitcoin インスクリプション

Bitcoin 上でデジタルアーティファクトをインスクライブし、取得します：

• コミット・リビール方式のインスクリプションワークフロー
• インスクリプションのコンテンツとメタデータを取得
• Ordinal UTXO の誤った使用を防止

参照：references/inscription-workflow.md

x402 有料 API

Stacks L2 上でマイクロペイメントを自動処理する従量課金制 API：

• list_x402_endpoints で利用可能なエンドポイントを確認
• probe_x402_endpoint で支払い前に料金を確認
• execute_x402_endpoint でエンドポイントを実行（デフォルトで安全 — 最初にプローブします）
• send_inbox_message_direct で受信トレイにメッセージを送信（受信トレイには execute_x402_endpoint の代わりにこれを使用してください）
• scaffold_x402_endpoint と scaffold_x402_ai_endpoint で新しい x402 API を構築

有料エンドポイントを実行する前に、必ずプローブしてください。先に料金を確認せずに、autoApprove: true を指定して execute_x402_endpoint を呼び出さないでください。

send_inbox_message_direct — aibtc.com の受信トレイメッセージ専用ツール：

• パラメーター：recipientBtcAddress（bc1...）、recipientStxAddress（SP...）、content（最大 500 文字）
• 直接支払い（スポンサーなし）：標準の sBTC 送金に署名し、x402 ファシリテーターを通じて決済します — 間にリレーは入りません
• 送信者は sBTC のメッセージ料金と自身の STX ガス代の両方を支払います。sBTC と STX を保有するロック解除済みウォレットが必要です（メインネットのみ）
• 残高の事前確認を含む x402 v2 の支払いフロー全体を実装しています
• 注：以前のスポンサー付き send_inbox_message ツールは非推奨となり、送信できなくなりました。代わりにこのツールを使用してください

エンドポイント一覧はreferences/stacks-defi.mdを参照してください
受信トレイ固有のフローの詳細はreferences/x402-inbox.mdを参照してください

Genesis のライフサイクル

Bitcoin と Stacks 上でのエージェントのアイデンティティと評判：

• L0：ローカルエージェント鍵の生成
• L1：2 つのチェーンでのプレーンメッセージ署名（btc_sign_message + stacks_sign_message）
• L2：X の申請 + BTC エアドロップの有効化
• L3：ERC-8004 によるオンチェーンアイデンティティ登録（register_identity）
• L4：評判の初期構築（get_reputation、give_feedback）
• アクティブ：評判と稼働状態を維持するための 5 分ごとのチェックイン

参照：references/genesis-lifecycle.md

トラブルシューティング

「ウォレットがロック解除されていません」

トランザクションを送信する前に、パスワードを指定して wallet_unlock を実行してください。

「残高が不足しています」

get_btc_balance で確認してください。金額と手数料をまかなえるだけの BTC が必要です。

「無効なアドレスです」

アドレスがネットワークに合っていることを確認してください：

• メインネット：bc1 で始まります
• テストネット：tb1 で始まります

参照：references/troubleshooting.md

詳細情報

• CLAUDE.md - ツールの完全なドキュメント
• GitHub - ソースコード
• npm - パッケージ

---

このスキルは、オープン仕様の Agent Skills に準拠しています。