Hive Ledger Bridge

hive-mcp-ledger-bridge

Hive Civilization — 基于 USB/DMK 的 EIP-712 ledger-bridge 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 解析 + 身份护照	Hive（hivetrust、hive-mcp-identity）	只读身份界面
Spectral 收据	Hive	每笔费用事件的结算审计记录

不存在重叠。硬件层仍由 Ledger 负责。运行时策略层仍由 shisad 负责。Hive 提供 IntentEnvelope 构建、哈希验证、确认级别策略和结算证明——全部位于 PEP 之上，且不修改 ConfirmationLevel 枚举或签名后端契约。

---

ConfirmationLevel 枚举

摘自 shisa-ai/shisad 规范：

级别	名称	整数
L0	SOFTWARE	0
L1	REAUTHENTICATED	1
L2	BOUND_APPROVAL	2
L3	SIGNED_AUTHORIZATION	3
L4	TRUSTED_DISPLAY_AUTHORIZATION	4

本服务原样使用该枚举。不扩展，也不虚构级别。

---

工具

工具	描述	默认 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	Hive 侧证明某个意图已达到 L3 或 L4	需要 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

记录 Hive 侧证明，表明设备在 L3 或 L4 返回了 ECDSA 签名。这不是链上结算，而是一条审计记录，用于证明设备已共同签署 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）意图——守护进程会向桥接服务 POST 一个 IntentEnvelope 和 intent_envelope_hash，用户在 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
大模型（如需扩展）	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——面向 Agent 的金融基础设施。

• 端点目录：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