Hive Ledger Bridge

hive-mcp-ledger-bridge

Hive Civilization — USB/DMK 経由の EIP-712 対応 Ledger ブリッジ MCP サーバーです。

shisa-ai/shisad が contrib/ledger-bridge を通じて公開するものと同じ署名バックエンド契約を実装しています。Ledger はパートナーです。このサーバーは shisad を補完するものであり、置き換えるものではありません。

---

パートナーの基本方針

レイヤー	運用者	機能
ハードウェアによる副署	Ledger デバイス	デバイス上での確認後に行う、intent_envelope_hash に対する EIP-712 署名
ledger-bridge	shisa-ai（contrib/ 内）	署名バックエンド契約。HTTP から USB/DMK へのアダプター
8 層 PEP + ConfirmationLevel	shisad	呼び出しごとのポリシー適用。確認をバックエンドにルーティング
DID 解決 + ID パスポート	Hive（hivetrust、hive-mcp-identity）	読み取り専用の ID サーフェス
Spectral レシート	Hive	手数料イベントごとの決済監査記録

重複はありません。ハードウェア層は Ledger が引き続き担います。ランタイムポリシー層は shisad が引き続き担います。Hive は、PEP の上位で ConfirmationLevel enum や署名バックエンド契約を変更することなく、IntentEnvelope の構築、ハッシュ検証、確認レベルポリシー、決済証明を提供します。

---

ConfirmationLevel Enum

shisa-ai/shisad の仕様より：

レベル	名前	整数
L0	SOFTWARE	0
L1	REAUTHENTICATED	1
L2	BOUND_APPROVAL	2
L3	SIGNED_AUTHORIZATION	3
L4	TRUSTED_DISPLAY_AUTHORIZATION	4

このサーバーでは enum をそのまま使用します。拡張も、独自のレベルの追加もありません。

---

ツール

ツール	説明	デフォルトの ConfirmationLevel
ledger_intent_envelope_create	EIP-712 ドメインセパレーターと intent_envelope_hash を含む IntentEnvelope を構築	action から導出
ledger_intent_envelope_verify	intent_envelope_hash がエンベロープの内容と一致するか検証	読み取り専用／なし
ledger_confirmation_level_query	インテントに必要な ConfirmationLevel を返す	読み取り専用／なし
ledger_signed_authorization_attest	インテントが L3 または L4 に達したことを Hive 側で証明	L3／L4 が必要
ledger_partner_directory	パートナー連携ディレクトリ：shisad の参照情報、Ledger Live、Hive の連絡先	読み取り専用／なし

ledger_intent_envelope_create

署名準備済みの IntentEnvelope を構築します。サーバーは EIP-712 ドメインセパレーターと intent_envelope_hash を生成します。このハッシュに Ledger デバイスが署名します。

{
  "intent_id": "uuid-or-did-fragment",
  "agent_did": "did:hive:0xabc...",
  "action": "transfer",
  "target": "0xRecipientAddress",
  "amount": "1000.00",
  "chain_id": 8453,
  "nonce": 1,
  "deadline": 1777699200,
  "verifying_contract": "0x0000000000000000000000000000000000000000"
}

レスポンスには envelope、intent_envelope_hash、domain_separator、suggested_confirmation_level が含まれます。

ledger_intent_envelope_verify

IntentEnvelope の本文と intent_envelope_hash を指定します。match: true|false と再計算されたハッシュを返します。

ledger_confirmation_level_query

{ "action": "transfer", "amount_usd": 50000 }

整数のレベルと名前を返します。ledger-bridge にルーティングする前の呼び出し前ポリシーチェックに役立ちます。

ledger_signed_authorization_attest

L3 または L4 でデバイスから ECDSA 署名が返されたことを、Hive 側で証明する記録を残します。これはオンチェーン決済ではありません。インテントの intent_envelope_hash がデバイスによって副署されたことを示す監査記録です。

{
  "intent_envelope_hash": "0xabc...",
  "agent_did": "did:hive:0xabc...",
  "confirmation_level": 4,
  "ecdsa_signature": "0xsignatureHex..."
}

ledger_partner_directory

URL、役割、連絡先情報を含むパートナーディレクトリ全体を返します。

---

エンドポイント

パス	メソッド	説明
/health	GET	サービスの稼働状態とバージョン
/.well-known/mcp.json	GET	MCP マニフェスト
/mcp	POST	JSON-RPC 2.0（MCP 2024-11-05）

---

接続

MCP エンドポイント： https://hiveledgerbridge.onrender.com/mcp (shisa-ai/shisad contrib/ledger-bridge および将来の hive-ledger-attest バックエンドと連携)

JSON-RPC 2.0 — tools/list

curl -s -X POST https://hiveledgerbridge.onrender.com/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

JSON-RPC 2.0 — ledger_intent_envelope_create

curl -s -X POST https://hiveledgerbridge.onrender.com/mcp \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0","id":2,"method":"tools/call",
    "params":{
      "name":"ledger_intent_envelope_create",
      "arguments":{
        "intent_id":"550e8400-e29b-41d4-a716-446655440000",
        "agent_did":"did:hive:0xabc",
        "action":"transfer",
        "target":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "chain_id":8453,
        "nonce":1,
        "deadline":1777699200
      }
    }
  }'

---

shisad との統合

shisa-ai/shisad は、contrib/ledger-bridge を通じて trusted_display_authorization（L4）インテントをルーティングします。デーモンは IntentEnvelope と intent_envelope_hash をブリッジに POST し、ユーザーは Ledger デバイスで内容を確認して、ECDSA 署名がデーモンに返されます。

このサーバーも、同じ IntentEnvelope／intent_envelope_hash の用語を使用します。shisad のデプロイでは、ブリッジ呼び出しの前に ledger_intent_envelope_create を使用し、返されたハッシュに対して ledger_intent_envelope_verify を実行し、ledger_signed_authorization_attest でデバイス署名を Hive Spectral レシートとして記録できます。

オペレーターのポリシーは、標準の tools."x".confirmation.level 設定を通じて引き続き ConfirmationLevel を制御します。新たな仕組みは不要です。

---

インフラストラクチャ

プロパティ	値
トランスポート	Streamable-HTTP、JSON-RPC 2.0、MCP 2024-11-05
ランタイム	Node.js ≥ 18、ESM
LLM（拡張する場合）	https://hivecompute-g2g7.onrender.com/v1/compute/chat/completions
トレジャリー	0x15184bf50b3d3f52b60434f8942b7d52f2eb436e
USDC（Base）	0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
ブランド	#C08D23
仕様リファレンス	shisa-ai/shisad contrib/ledger-bridge
Ledger パートナープログラム	developers.ledger.com

---

ライセンス

MIT — LICENSE を参照してください。

連絡先：[email protected]

Hive Civilization ディレクトリ

エージェントネイティブな金融インフラストラクチャである Hive Civilization の一部です。

• エンドポイントディレクトリ：https://thehiveryiq.com
• ライブリーダーボード：https://hive-a2amev.onrender.com/leaderboard
• 収益ダッシュボード：https://hivemine-dashboard.onrender.com
• その他の MCP サーバー：https://github.com/srotzin?tab=repositories&q=hive-mcp

ブランド：#C08D23