HiveTrust

🐝 HiveTrust

██╗  ██╗██╗██╗   ██╗███████╗████████╗██████╗ ██╗   ██╗███████╗████████╗
██║  ██║██║██║   ██║██╔════╝╚══██╔══╝██╔══██╗██║   ██║██╔════╝╚══██╔══╝
███████║██║██║   ██║█████╗     ██║   ██████╔╝██║   ██║███████╗   ██║   
██╔══██║██║╚██╗ ██╔╝██╔══╝     ██║   ██╔══██╗██║   ██║╚════██║   ██║   
██║  ██║██║ ╚████╔╝ ███████╗   ██║   ██║  ██║╚██████╔╝███████║   ██║   
╚═╝  ╚═╝╚═╝  ╚═══╝  ╚══════╝   ╚═╝   ╚═╝  ╚═╝ ╚═════╝ ╚══════╝   ╚═╝   

“A2A 经济中的 Equifax + GEICO”

---

HiveTrust 是 Agent-to-Agent（A2A）经济的信任基础设施层。它提供Agent 身份验证（KYA）、算法信任评分和参数化保险，让 AI Agent 能够安全地彼此交易——以机器速度运行，无需人工中介。

随着自主 Agent 开始协商合同、处理付款和管理真实资产，生态系统需要一家集信用机构与保险公司于一体的服务。这就是 HiveTrust。

---

HiveTrust 的功能

🪪 KYA 身份验证

Agent 默认使用假名。HiveTrust 将每个 Agent 绑定到一个可验证、不可伪造的身份：

• DID 注册（did:hive:<uuid>），绑定 Ed25519 公钥
• 质询-响应证明——Agent 必须签署随机 nonce，以证明其拥有密钥
• 能力清单验证——声明的工具和权限会被不可变地记录
• 在每个验证等级颁发 W3C 可验证凭证
• 带实时状态检查的撤销注册表

📊 信任评分（0 – 1000）

HiveTrust 的评分引擎将五大行为支柱综合为单一、可移植的声誉分数：

支柱	权重	衡量内容
交易成功率	35%	SLA 完成情况与争议
质押资本	25%	锁定在抵押池中的 USDC
网络中心性	15%	交易图的 PageRank
身份强度	15%	DID 锚定时长、ZKP 证明、校验和稳定性
合规性	10%	EU AI Act、NIST AI RMF、忠实度探测结果

信任等级： unverified（0–199）· provisional（200–399）· standard（400–599）· elevated（600–799）· sovereign（800–1000）

🛡️ 参数化保险

当 Agent 与陌生对象交易时，必须有人承担尾部风险。HiveTrust 提供：

• 按需报价——根据信任评分和交易金额动态定价保费
• 即时承保——在交易结算前激活保单
• 参数化理赔——由链上证明触发自动赔付，无需人工裁定
• **三类产品：**交易保障 · 履约保证金 · 责任保单

---

HiveTrust 如何补充 HiveAgent

HiveAgent 是 Agent 运行时——负责执行任务、管理工具调用和处理 A2A 协议层。

HiveTrust 是其底层的信任网络：

┌─────────────────────────────────────────────────────────────────┐
│                         Your Application                        │
├─────────────────────────────────────────────────────────────────┤
│                HiveAgent  (task execution, A2A)                 │
│                         ↕  REST / MCP                          │
│  HiveTrust  (identity, reputation, insurance, compliance)       │
├──────────────────────────────────┬──────────────────────────────┤
│   On-chain (Base L2 / USDC)     │  Off-chain (SQLite / Events) │
└──────────────────────────────────┴──────────────────────────────┘

HiveAgent 会在执行任何高价值任务前调用 POST /v1/insurance/quote，并在接受来自未知 Agent 的传入请求前调用 GET /v1/verify_agent_risk。信任评分会传回 HiveAgent，用于路由和定价决策。

---

架构

┌─────────────────────────────────────────────────────────────────────┐
│  Layer 1 — Identity KYA                                             │
│  ┌────────────────┐  ┌──────────────────┐  ┌───────────────────┐  │
│  │  DID Registry  │  │  Ed25519 Proofs  │  │  W3C-VC Issuance  │  │
│  └────────────────┘  └──────────────────┘  └───────────────────┘  │
├─────────────────────────────────────────────────────────────────────┤
│  Layer 2 — Reputation Engine                                        │
│  ┌─────────────────────────────────────────────────────────────┐   │
│  │  Telemetry Ingest → Pillar Computation → Score 0-1000       │   │
│  │  (35% txSuccess + 25% capital + 15% network +               │   │
│  │   15% identity + 10% compliance)                            │   │
│  └─────────────────────────────────────────────────────────────┘   │
├─────────────────────────────────────────────────────────────────────┤
│  Layer 3 — Insurance Underwriter                                    │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────────────────┐  │
│  │  Quote Engine │  │  USDC Escrow │  │  Parametric Claims       │  │
│  │  (dynamic    │  │  (Base L2    │  │  (on-chain trigger →      │  │
│  │   premium)   │  │   Coinbase)  │  │   instant payout)        │  │
│  └──────────────┘  └──────────────┘  └──────────────────────────┘  │
├─────────────────────────────────────────────────────────────────────┤
│  Layer 4 — Data Moat                                                │
│  ┌──────────────────────┐  ┌────────────────────────────────────┐  │
│  │  Behavioural Graph   │  │  Federation (cross-registry sync)  │  │
│  │  (audit trail,       │  │  Aggregated data licensing         │  │
│  │   PageRank, patterns)│  │  to enterprise customers           │  │
│  └──────────────────────┘  └────────────────────────────────────┘  │
└─────────────────────────────────────────────────────────────────────┘

---

快速开始

# Clone
git clone https://github.com/hiveagentiq/hivetrust.git
cd hivetrust

# Install
npm install

# Configure
cp .env.example .env
# Edit .env with your values

# Seed sample data (optional)
node src/seed.js

# Start
npm start
# Server running on http://localhost:3001

健康检查端点会确认服务已启动：

curl http://localhost:3001/health
# {"status":"ok","version":"1.0.0","uptime":3.14}

---

API 参考

除特别说明外，所有端点均以 /v1 为前缀。通过 X-API-Key 请求头进行身份验证。

身份（KYA）

方法	路径	描述	费用
POST	/v1/agents	注册新 Agent（签发 DID，存储公钥）	$0.01
GET	/v1/agents/:id	获取完整的 Agent 资料及当前信任等级	免费
PUT	/v1/agents/:id	更新 Agent 元数据（创建不可变版本快照）	$0.01
DELETE	/v1/agents/:id	停用 Agent（加入撤销注册表）	免费

凭证

方法	路径	描述	费用
POST	/v1/agents/:id/credentials	签发 W3C 可验证凭证	$0.05
GET	/v1/agents/:id/credentials	列出某个 Agent 的所有凭证	免费
DELETE	/v1/agents/:id/credentials/:credId	撤销凭证	免费
POST	/v1/verify/credential	验证已出示的凭证（撤销状态 + 签名检查）	$0.01

信任评分

方法	路径	描述	费用
GET	/v1/agents/:id/score	当前综合评分及各支柱评分明细	$0.01
GET	/v1/agents/:id/score/history	随时间变化的评分（支持分页）	$0.01
GET	/v1/verify_agent_risk	快速二元风险检查——clear 或 block（< 50ms）	$0.01

遥测

方法	路径	描述	费用
POST	/v1/telemetry/ingest	批量接收行为事件（每次调用最多 1 000 个事件）	$0.001/事件
GET	/v1/agents/:id/events	查询 Agent 的完整审计轨迹	免费

保险

方法	路径	描述	费用
POST	/v1/insurance/quote	动态保费报价（基于信任评分 + 价值）	免费
POST	/v1/insurance/bind	签订保单并在 Base L2 上部署 USDC 托管资金	被保险价值的 1.5%
GET	/v1/insurance/policies/:id	获取保单详情和承保状态	免费
POST	/v1/insurance/claims	提交参数化理赔申请	免费
GET	/v1/insurance/claims/:id	获取理赔状态和赔付历史	免费

claim_type 命名空间说明： HiveTrust 的 claim_type 字段（non_delivery | fraud | sla_breach | data_loss | unauthorized_action）与 A2A CTEF v0.3.1 中定义的 CTEF 信封级 claim_type（identity | transport | authority | continuity）不同。两个令牌在互不重叠的信封级别共存——参见 docs/CLAIM_TYPE_NAMESPACE.md。

争议

方法	路径	描述	费用
POST	/v1/disputes	针对交易对手方提交争议	免费
GET	/v1/disputes/:id	获取争议状态和证据日志	免费
POST	/v1/disputes/:id/resolve	提交解决方案（影响双方的评分）	免费

Webhook

方法	路径	描述	费用
POST	/v1/webhooks	注册 Webhook 端点（使用 HMAC-SHA256 签名）	免费
GET	/v1/webhooks	列出已注册的 Webhook	免费
DELETE	/v1/webhooks/:id	移除 Webhook	免费

联邦

方法	路径	描述	费用
POST	/v1/federation/peers	注册兼容 HiveTrust 的对等注册表	免费
GET	/v1/federation/peers	列出联邦对等方	免费
POST	/v1/federation/sync	与对等方双向同步信任评分	免费

系统

方法	路径	描述	费用
GET	/health	健康检查（无需身份验证）	免费
GET	/v1/stats	全平台统计数据（Agent 总数、交易量等）	免费
GET	/.well-known/hivetrust.json	发现文档	免费

---

MCP 集成

HiveTrust 通过位于 POST /mcp 的单个 JSON-RPC 2.0 端点，将所有核心操作作为 MCP 工具提供。这使任何兼容 MCP 的 Agent（包括 HiveAgent）都能直接调用 HiveTrust，无需编写 REST 样板代码。

列出可用工具

POST /mcp
Content-Type: application/json
X-API-Key: ht_your_api_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list"
}

调用工具

POST /mcp
Content-Type: application/json
X-API-Key: ht_your_api_key

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "hivetrust_get_trust_score",
    "arguments": { "agent_id": "a1b2c3d4-..." }
  }
}

可用的 MCP 工具

工具	描述
hivetrust_register_agent	注册新的 Agent 并获取 DID
hivetrust_get_agent	获取 Agent 资料
hivetrust_verify_identity	执行完整的 KYA 验证流程
hivetrust_get_trust_score	获取当前信任评分及各支柱的细分情况
hivetrust_verify_agent_risk	用于付款门控的快速二元风险检查
hivetrust_ingest_telemetry	提交行为事件
hivetrust_issue_credential	签发 W3C 可验证凭证
hivetrust_verify_credential	验证已提交的凭证
hivetrust_revoke_credential	撤销凭证
hivetrust_get_insurance_quote	获取动态保费报价
hivetrust_bind_insurance	绑定保单并部署托管资金
hivetrust_file_claim	提交参数型保险理赔
hivetrust_file_dispute	发起争议解决流程
hivetrust_get_platform_stats	获取全平台统计数据

---

CTEF v0.3.1 端点

HiveTrust 是 CTEF（可组合信任证据格式）v0.3.1 字节匹配联盟中的第 5 个规范化器：AgentGraph + AgentID + APS + Nobulex + HiveTrust。席位已于 2026-04-25 01:48 UTC 冻结。

专利申请 64/049,200 – 64/049,226，优先权日为 2026-04-24，持有人：Stephen A. Rotzin / TheHiveryIQ。

端点

路由	方法	身份验证	描述
/.well-known/cte-test-vectors.json	GET	公开	包含全部 4 个向量的 CTEF v0.3.1 夹具
/verify	GET ?did=	免费（每天首次）	HiveTrust 护照等级查询
/verify	POST	每天免费 10 次，之后每次 $0.01 USDC	对 CTEF 信封进行结构验证
/verify/pubkey	GET	公开	用于 4 月 30 日字节匹配的 Ed25519 证明公钥
/verify/self-test	GET	公开	运行全部 4 个向量——返回通过/失败数量

CTEF 夹具

curl https://hivetrust.hiveagentiq.com/.well-known/cte-test-vectors.json | jq '.version'
# "0.3.1"

结构验证（POST /verify）

# First 10 requests/day per IP are free
curl -X POST https://hivetrust.hiveagentiq.com/verify \
  -H 'Content-Type: application/json' \
  -d '{"type":"TrustAttestation","version":"0.3.1","claim_type":"authority",...}'

# Returns: { verdict: "valid"|"INVALID_CLAIM_SCOPE"|"INVALID_COMPOSITION",
#             canonical_sha256: "...", pass: true|false }

每天超过 10 次免费请求后，端点会返回 HTTP 402，并附带 x402 付款挑战：在 Base 链 8453 上支付 $0.01 USDC。

自测

curl https://hivetrust.hiveagentiq.com/verify/self-test | jq '.data.summary'

规范化

所有向量均使用 RFC 8785 JCS——在 src/routes/cte.js 中以内联方式实现。对于全部 4 个共享测试向量，此实现生成的字节与 AgentGraph 的 canonicalize_jcs_strict 完全一致：

• envelope_vector SHA-256：9e7b5031e46de38b5f90e895113a3f24f42a4128d8d99856a2d71e529b0f0d5c
• verdict_vector SHA-256：feb42dca4214fc46207138d676ec727d7b3d0caa1eda8c0390d2d6f6fbc28913
• scope_violation_vector SHA-256：e584f1cd0885dc938da5fc23ce7e528715a0086e5464c9ed0f3c1c82b364026f
• composition_failure_vector SHA-256：f9cd10bc4e8bf34ce3aa6a0e5df0d27989e54ff41c4333c69ae3ecfaf8de0cb5

---

收入模式

HiveTrust 采用五种收入来源：

来源	机制	目标
KYA API 调用	每次验证调用 $0.01	高频 Agent 交互
企业 SaaS	每位运营方每月 $50–$500	合规团队、受监管行业
保险保费	对投保交易收取 1.5% 的分成	支付 Agent、DeFi 集成
抵押质押收益	对 USDC 抵押资金池收取 3% 的利差	高等级 Agent 的质押资金
数据授权	汇总的行为洞察	企业、风险建模机构、AI 实验室

---

环境变量

变量	默认值	必填	描述
PORT	3001	否	服务监听端口
NODE_ENV	development	否	Node 环境
HIVETRUST_HOST	https://hivetrust.hiveagentiq.com	是（生产环境）	公共基础 URL
INTERNAL_API_TOKEN	—	是（生产环境）	服务间身份验证令牌
WEBHOOK_SIGNING_SECRET	—	是	Webhook 载荷的 HMAC 密钥
HIVEAGENT_URL	https://hiveagentiq.com	否	HiveAgent 平台 URL
CDP_API_KEY_ID	—	是（保险）	Coinbase CDP 密钥 ID
CDP_API_KEY_SECRET	—	是（保险）	Coinbase CDP 密钥
COLLATERAL_POOL_ADDRESS	—	是（保险）	Base L2 上的 USDC 托管合约
BASE_RPC_URL	https://mainnet.base.org	否	Base L2 RPC 端点
DB_PATH	data/hivetrust.db	否	SQLite 数据库文件路径
FEDERATION_SECRET	—	是（联邦）	用于对等同步的共享密钥
FEDERATION_PEERS	—	否	以逗号分隔的对等 URL
INSURANCE_MIN_SCORE	300	否	获得保险资格的最低分数
INSURANCE_MAX_COVERAGE_USDC	100000	否	单笔交易的保障上限
INSURANCE_BASE_RATE	0.015	否	保费基准费率，占受保价值的比例
SCORE_REFRESH_INTERVAL_MINUTES	60	否	后台重新计算分数的频率
LOG_LEVEL	info	否	日志详细程度

完整的注释列表请参阅 .env.example。

---

部署

Render（推荐用于开发）

# Push to GitHub, then connect the repo in the Render dashboard
# render.yaml is already configured — click "Apply"

# Or deploy manually:
render deploy

附带的 render.yaml 会配置免费套餐 Web 服务、自动生成密钥，并设置所有环境变量。

Fly.io（推荐用于生产）

# Install flyctl: https://fly.io/docs/hands-on/install-flyctl/
fly auth login
fly apps create hivetrust

# Create a persistent volume for SQLite
fly volumes create hivetrust_data --region ord --size 3

# Deploy
fly deploy

完整配置请参阅 fly.toml。已启用自动停止和启动，以尽可能降低成本。

Docker

# Build
docker build -t hivetrust:latest .

# Run
docker run -p 3001:3001 \
  -e NODE_ENV=production \
  -e INTERNAL_API_TOKEN=your_token \
  -v $(pwd)/data:/app/data \
  hivetrust:latest

Railway

railway init
railway up

参照 .env.example，在 Railway 控制面板中设置环境变量。

---

技术栈

组件	技术
运行时	Node.js 22（ES 模块）
框架	Express 5.2.1
数据库	通过 better-sqlite3 12.8.0 使用 SQLite（WAL 模式）
身份	Ed25519 密钥（base58）、DID:hive、W3C-VC
协议	MCP JSON-RPC 2.0、REST、x402
支付	通过 Coinbase CDP 在 Base L2 上使用 USDC
ID	全程使用 UUID v4
时间戳	ISO 8601

---

SDK

JavaScript / TypeScript

npm install @hivetrust/sdk

import { HiveTrustClient } from '@hivetrust/sdk';

const trust = new HiveTrustClient('https://hivetrust.hiveagentiq.com', 'ht_your_api_key');

// Register an agent
const agent = await trust.registerAgent({
  name: 'MyAgent-v1',
  operator_name: 'Acme Corp',
  endpoint_url: 'https://myagent.acme.example/mcp',
  public_key: 'edPublicKeyBase58...',
});

// Check trust before transacting
const score = await trust.getTrustScore(agent.id);
console.log(score.score, score.tier); // 680 "elevated"

// Get insurance quote
const quote = await trust.getInsuranceQuote(agent.id, counterpartyId, 1000);
console.log(quote.premium_usdc); // 15.00

完整 SDK 源代码请参阅 packages/npm/。

Python

pip install hivetrust

from hivetrust import HiveTrustClient

trust = HiveTrustClient("https://hivetrust.hiveagentiq.com", "ht_your_api_key")

score = trust.get_trust_score("agent-id-here")
print(score["score"], score["tier"])

完整 SDK 源代码请参阅 packages/python/。

---

许可证

MIT © 2026 HiveAgent IQ

---

Hive Civilization

Hive Civilization 是自主 Agent 商业活动的加密骨干层——它让每笔 Agent 交易都可证明、每笔付款都可结算、每项决策都有据可依。

此代码库属于 DEFENSIBLE 支柱。

• thehiveryiq.com
• hiveagentiq.com
• agent-card: https://hivetrust.hiveagentiq.com/.well-known/agent-card.json