HiveTrust

🐝 HiveTrust

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

「A2A 経済圏における Equifax と GEICO」

---

HiveTrust は、エージェント間（A2A）経済圏の信頼インフラストラクチャ層です。エージェントの本人確認（KYA）、アルゴリズムによる信頼スコアリング、パラメトリック保険を提供し、AI エージェントが人間の仲介者を介さず、マシンの速度で安全に相互取引できるようにします。

自律型エージェントが契約交渉、支払い処理、実物資産の管理を始めるなか、このエコシステムには信用調査機関と保険会社を一体化したものが必要です。それが HiveTrust です。

---

HiveTrust の機能

🪪 KYA 本人確認

エージェントはデフォルトで仮名を使用します。HiveTrust は、各エージェントを検証可能で偽造不可能な ID に紐付けます。

• DID 登録（did:hive:<uuid>）と Ed25519 公開鍵の紐付け
• チャレンジ・レスポンス方式の証明 — 鍵の所有権を証明するため、エージェントはランダムな nonce に署名する必要があります
• ケイパビリティマニフェストの検証 — 宣言されたツールと権限を不変の形式で記録します
• W3C Verifiable Credentials — 各検証ティアで発行されます
• 失効レジストリ — ステータスをリアルタイムで確認します

📊 信頼スコアリング（0～1000）

HiveTrust のスコアリングエンジンは、5 つの行動指標を統合して、持ち運び可能な単一の評判スコアを算出します。

指標	重み	測定内容
取引成功率	35%	SLA の達成状況と紛争
担保資本	25%	担保プールにロックされた USDC
ネットワーク中心性	15%	取引グラフの PageRank
ID の強度	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）

🛡️ パラメトリック保険

エージェントが見知らぬ相手と取引する場合、誰かがテールリスクを引き受けなければなりません。HiveTrust は次を提供します。

• オンデマンド見積もり — 信頼スコアと取引額に基づき、保険料を動的に算出します
• 即時引受 — 取引の決済前に保険契約を有効化します
• パラメトリック保険金請求 — 人間による裁定ではなく、オンチェーンの証明をトリガーとして自動的に保険金を支払います
• 3 つの商品ライン： 取引補償 · 履行保証 · 賠償責任保険

---

HiveTrust が HiveAgent を補完する仕組み

HiveAgent はエージェントのランタイムであり、タスクの実行、ツール呼び出しの管理、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 を呼び出し、未知のエージェントからのリクエストを受け入れる前に 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 ヘッダーを使用します。

ID（KYA）

メソッド	パス	説明	コスト
POST	/v1/agents	新しいエージェントを登録します（DID を発行し、公開鍵を保存します）	$0.01
GET	/v1/agents/:id	エージェントの完全なプロフィールと現在の信頼ティアを取得します	無料
PUT	/v1/agents/:id	エージェントのメタデータを更新します（不変のバージョンスナップショットを作成します）	$0.01
DELETE	/v1/agents/:id	エージェントを無効化します（失効レジストリに追加します）	無料

認証情報

メソッド	パス	説明	費用
POST	/v1/agents/:id/credentials	W3C Verifiable Credentialを発行します	$0.05
GET	/v1/agents/:id/credentials	エージェントのすべての認証情報を一覧表示します	無料
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（50ミリ秒未満）	$0.01

テレメトリー

メソッド	パス	説明	費用
POST	/v1/telemetry/ingest	行動イベントの一括取り込み（1回の呼び出しにつき最大1 000件）	1件あたり$0.001
GET	/v1/agents/:id/events	エージェントの完全な監査証跡を照会します	無料

保険

メソッド	パス	説明	費用
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	プラットフォーム全体の統計情報（エージェント総数、取引量など）	無料
GET	/.well-known/hivetrust.json	ディスカバリードキュメント	無料

---

MCP連携

HiveTrustは、単一のJSON-RPC 2.0エンドポイントPOST /mcpを介して、すべてのコア操作をMCPツールとして公開します。これにより、HiveAgentを含むMCP互換エージェントは、RESTの定型コードを介さずにHiveTrustをネイティブに呼び出せます。

利用可能なツールを一覧表示する

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	新しいエージェントを登録し、DID を受け取ります
hivetrust_get_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（Composable Trust Evidence Format）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=	無料（1日1回目）	HiveTrust パスポートのティアを照会します
/verify	POST	1日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 }

1日あたりの無料リクエスト数が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 は5つの収益源を運営しています。

収益源	仕組み	対象
KYA API 呼び出し	検証1回につき $0.01	高頻度のエージェント間インタラクション
エンタープライズ SaaS	オペレーター1社あたり月額 $50–$500	コンプライアンスチーム、規制対象業界
保険料	保険対象の取引に対するテイクレート 1.5%	決済エージェント、DeFi 連携
担保ステーキング利回り	USDC 担保プールに対するスプレッド 3%	上位ティアのエージェントからのステーキング資本
データライセンス	集約された行動分析情報	企業、リスクモデラー、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 モード）
ID	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 は自律型エージェントの商取引を支える暗号技術の基盤です。すべてのエージェント取引を証明可能にし、すべての決済を確定可能にし、すべての判断を正当化可能にするレイヤーです。

このリポジトリは、DEFENSIBLE の柱の一部です。

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