mempool-watch

Mempool Watch スキル

mempool.space の公開 API（認証不要）を使用して、Bitcoin のメモリプールを監視し、オンチェーンのアクティビティを追跡します。メインネットとテストネットの両方で動作します。

使用方法

bun run mempool-watch/mempool-watch.ts <subcommand> [options]

サブコマンド

tx-status

Bitcoin トランザクションの承認状況を確認します。

bun run mempool-watch/mempool-watch.ts tx-status --txid <txid>

オプション：

• --txid（必須）— 照会する Bitcoin トランザクション ID

出力：

{
  "txid": "abc123...",
  "network": "mainnet",
  "confirmed": true,
  "blockHeight": 880000,
  "blockHash": "000000...",
  "blockTime": "2026-01-01T00:00:00.000Z",
  "confirmations": 42,
  "explorerUrl": "https://mempool.space/tx/abc123..."
}

未承認の場合：

{
  "txid": "abc123...",
  "network": "mainnet",
  "confirmed": false,
  "blockHeight": null,
  "blockHash": null,
  "blockTime": null,
  "confirmations": 0,
  "explorerUrl": "https://mempool.space/tx/abc123..."
}

address-history

Bitcoin アドレスのトランザクション履歴を取得します。

bun run mempool-watch/mempool-watch.ts address-history --address <addr> [--limit <n>]

オプション：

• --address（必須）— 照会する Bitcoin アドレス
• --limit（任意）— 返すトランザクションの最大数（デフォルト：10、最大：25）

出力：

{
  "address": "bc1q...",
  "network": "mainnet",
  "count": 3,
  "transactions": [
    {
      "txid": "abc123...",
      "confirmed": true,
      "blockHeight": 880000,
      "blockTime": "2026-01-01T00:00:00.000Z",
      "fee": 1200,
      "valueIn": 500000,
      "valueOut": 498800,
      "explorerUrl": "https://mempool.space/tx/abc123..."
    }
  ],
  "explorerUrl": "https://mempool.space/address/bc1q..."
}

mempool-stats

保留中のトランザクション数、バックログのサイズ、手数料のヒストグラムなど、現在の Bitcoin メモリプールの統計情報を取得します。

bun run mempool-watch/mempool-watch.ts mempool-stats

出力：

{
  "network": "mainnet",
  "pendingTransactions": 12400,
  "pendingVsize": 8500000,
  "totalFees": 120000000,
  "recommendedFees": {
    "fast": { "satPerVb": 15, "target": "~10 minutes (next block)" },
    "medium": { "satPerVb": 8, "target": "~30 minutes" },
    "slow": { "satPerVb": 3, "target": "~1 hour" },
    "economy": { "satPerVb": 1, "target": "~24 hours" }
  },
  "feeHistogram": [[15, 200000], [8, 500000], [3, 1000000]]
}

注意事項

• すべてのサブコマンドは mempool.space の公開 API を使用します。認証もウォレットも不要です。
• デフォルトではテストネットを使用します。NETWORK=mainnet を設定するとメインネットを使用します。
• tx-status の confirmations は、現在のブロック高からトランザクションのブロック高を差し引いて推定されます。
• address-history は新しいトランザクションから順に返します。mempool.space は after_txid でページネーションしますが、ここでは公開されていません。結果の件数を調整するには --limit を使用してください。