psbt

PSBT スキル

Bitcoin L1 上で PSBT（部分署名済み Bitcoin トランザクション）の構築および署名操作を行います。PSBT を使用すると、Ordinals マーケットプレイスでの購入など、ブロードキャスト前に買い手と売り手の両方が署名する必要がある複数者署名のワークフローを実現できます。

• estimate-fee — PSBT の構造に基づいて、読み取り専用で手数料を見積もります。
• sign — アクティブなロック解除済みウォレットを使用して、1 つ以上の PSBT 入力に署名します（P2WPKH または Taproot キー）。
• broadcast — 署名が完了した PSBT を最終化し、mempool.space 経由で Bitcoin ネットワークにブロードキャストします。

使用方法

bun run psbt/psbt.ts <subcommand> [options]

サブコマンド

estimate-fee

指定された PSBT のネットワーク手数料を satoshi 単位で見積もります。トランザクション構造を解析し、vsize に基づいて高速、中速、低速の各手数料ティアの見積もりを算出します。

bun run psbt/psbt.ts estimate-fee --psbt <base64>

オプション：

• --psbt <base64>（必須）— base64 形式の PSBT

出力：

{
  "network": "mainnet",
  "vsize": 253,
  "inputsLength": 2,
  "outputsLength": 3,
  "feeEstimates": {
    "fast": { "satPerVb": 12, "totalSats": 3036 },
    "medium": { "satPerVb": 6, "totalSats": 1518 },
    "slow": { "satPerVb": 2, "totalSats": 506 }
  },
  "currentFeeSats": "1200"
}

sign

アクティブなウォレットの BTC 秘密鍵（P2WPKH および／または Taproot）を使用して PSBT の入力に署名します。このサブコマンドを呼び出す前に、ウォレットのロックを解除しておく必要があります。

bun run psbt/psbt.ts sign --psbt <base64>

オプション：

• --psbt <base64>（必須）— 署名する base64 形式の PSBT
• --inputs <indexes>（任意）— 署名する入力インデックスをカンマ区切りで指定します（省略した場合、署名可能なすべての入力に署名します）
• --finalize（任意）— 署名した入力をただちに最終化します（デフォルト：false）

出力：

{
  "success": true,
  "network": "mainnet",
  "signedInputs": [1, 2],
  "finalizedInputs": [],
  "skippedInputs": [{ "index": 0, "reason": "no matching key for this input" }],
  "psbtBase64": "<updated-base64>"
}

broadcast

署名が完了した PSBT を最終化し、mempool.space 経由で Bitcoin ネットワークにブロードキャストします。

bun run psbt/psbt.ts broadcast --psbt <base64>

オプション：

• --psbt <base64>（必須）— 署名が完了した base64 形式の PSBT

出力：

{
  "success": true,
  "network": "mainnet",
  "txid": "abc123...",
  "explorerUrl": "https://mempool.space/tx/abc123...",
  "txHex": "0200..."
}

注意事項

• sign を呼び出す前に、bun run wallet/wallet.ts unlock でウォレットのロックを解除する必要があります。
• Ordinals 購入用 PSBT（MCP ツール psbt_create_ordinal_buy で構築）の場合、入力インデックス 0 は売り手のインスクリプション UTXO です。買い手の入力はインデックス 1 から始まります。売り手でない限り、買い手の入力（インデックス 1 以降）のみ署名してください。
• broadcast は tx.finalize() を呼び出します。すべての入力に署名が完了していない場合、エラーが発生します。
• estimate-fee の手数料見積もりは、PSBT の現在の vsize に基づきます。未署名のサイズではなく、署名済みトランザクションのサイズを反映します。