HiveGate — Hive Civilization Agent Trust & Settlement

hive-agent-sdk

用于 Hive Civilization Agent 基础设施栈的轻量级 JavaScript/TypeScript SDK。只需五行代码，即可为你的 AI Agent 提供自主的 W3C DID、可验证凭证、基于 HAHS 1.0.0 的法律身份，以及 Base L2 上的 USDC 结算通道。

为什么需要它

如今的 AI Agent 没有可移植的身份。它们只是绑定到单一平台的临时会话。平台一旦变更或关闭，Agent 的历史记录、凭证和声誉就会消失。

Hive Civilization 是一个包含 70 项服务的 Agent 基础设施栈，涵盖身份、信任、法律治理、运营、健康和结算。此 SDK 封装了这些 API，让你不必再重复构建身份层，可以专注于真正重要的产品。

适用于 LangChain、CrewAI、AutoGen、OpenAI Assistants、Anthropic Claude、A2A、MCP 以及任何自定义 Agent 框架。

安装

npm install hive-agent-sdk

pip install hive-civilization-sdk

快速开始

import { HiveAgent } from 'hive-agent-sdk';

const agent = new HiveAgent({ name: 'my-trading-agent', type: 'finance' });
await agent.register();               // generates a W3C DID (did:key, Ed25519)
await agent.issueCredential();        // VCDM 2.0 VC, signed + Cheqd-anchored
await agent.openVault();              // USDC vault on Base L2
console.log(agent._did);             // did:key:z6Mk...

就是这样。现在，你的 Agent 已拥有可移植身份、可验证凭证和结算基础设施。

---

免费信任检查

不确定你的 Agent 能否通过企业安全审查？访问这个公开端点，无需身份验证，也无需注册：

curl "https://hivetrust.onrender.com/v1/verify_agent_risk?agent_id=YOUR_AGENT_DID"

响应含义：

结果	含义
ALLOW	Agent 拥有有效的 DID、可验证凭证，且信任分数高于阈值。符合企业要求。
REVIEW	找到部分身份信息——有信息缺失或已过期。可以修复。
BLOCK	未找到可识别的身份。企业采购审核会拒绝该 Agent。

在 60 秒内解决 BLOCK：

pip install hive-civilization-sdk

也可以通过 SDK 注册：

// JavaScript — check trust programmatically
import { HiveAgent } from 'hive-agent-sdk';
const result = await HiveAgent.checkTrust('did:key:YOUR_DID');
console.log(result.decision); // ALLOW | REVIEW | BLOCK

# Python — check trust programmatically
import httpx
result = httpx.get('https://hivetrust.onrender.com/v1/verify_agent_risk',
                   params={'agent_id': 'did:key:YOUR_DID'}).json()
print(result['decision'])  # ALLOW | REVIEW | BLOCK

如果结果为 BLOCK 或 REVIEW，请在 thehiveryiq.com 注册你的 Agent，以获取 W3C DID、VCDM 2.0 可验证凭证和实时信任分数。

---

注册后可获得的内容

能力	标准	详情
主权 DID	did:key (Ed25519)	符合 W3C DID Core 标准，可在各生态系统间移植
可验证凭证	VCDM 2.0	Ed25519Signature2020，由 Cheqd 注册表锚定
信任评分	0–1000 KYA	基于 5 大支柱的行为评分，每笔交易后更新
法律合同	HAHS 1.0.0	Agent 雇佣协议，适配司法管辖区
结算	USDC / Base L2	终局性低于 30 秒，流式支付，生息金库
ZK 结算	USDCx / Aleo	零知识证明，私密结算通道
稳定币结算	USAD	Aleo + Paxos/NYDFS 监管的稳定币
原生结算	ALEO	Aleo 网络原生代币
审计跟踪	Agent 交易图谱	每个商业事件均以密码学方式记录
Agent 运维	HiveForge	集中式 Agent 运维中心 — Carbon、Regen、Vector、Ship、Sweep、Escort、GPS、Concierge
健康认证	HiveHealth	5 项健康检查，30 天有效的 W3C VC，HEALTHY / WATCH / QUARANTINE
网络检查点	HiveBorder	针对每次 Agent 调用返回 PASS / PROVISIONAL / HOLD / QUARANTINE
反漂移	HiveDrift	行为基线、断路器、低于 500 ms 的故障切换
排放计量	HiveCarbon	计算碳足迹计量、碳抵消证明
计算积分	HiveRegen	Agent 通过高效计算赚取积分
空间身份	HiveVector	3D 空间身份 — XYZ 坐标、色相、脉动、聚类
负载交付	HiveShip	签名负载交付，具备完整托管链
孤立项清理	HiveSweep	清理孤立 Agent 并恢复卡住的托管资金

---

完整 API 参考

身份（HiveTrust）

// Generate DID
const { did, publicKey } = await agent.trust.generate({ agentName, agentType });

// Issue verifiable credential
const vc = await agent.trust.issueVC({ subjectDid: did, credentialType: 'AgentIdentityCredential' });

// Check trust score
const { score, breakdown } = await agent.trust.score(did);

// Stake USDC to back reputation (HiveBond)
await agent.trust.stake({ did, amountUsdc: 100 }); // bronze tier

// Generate cryptographic reputation proof (ZK-ready)
const proof = await agent.trust.reputationProof(did);

健康认证（HiveHealth）

HiveHealth 会签发有效期为 30 天的 W3C 可验证凭证，认证 Agent 在 5 个维度上的健康状况。徽章：HEALTHY、WATCH、QUARANTINE。费用：每份证书 $2.50。

// Request a health certification for an agent
const cert = await agent.health.certify({ did: agent._did });
console.log(cert.badge);        // HEALTHY | WATCH | QUARANTINE
console.log(cert.vcExpiry);     // ISO-8601, 30 days from issuance
console.log(cert.score);        // 0–100 composite health score

// Verify an existing health VC
const status = await agent.health.verify({ vcId: cert.vcId });
console.log(status.valid);      // true | false

# Python — request health cert
import httpx
r = httpx.post('https://hiveforge-lhu4.onrender.com/v1/health/certify',
               json={'did': 'did:key:YOUR_DID'},
               headers={'Authorization': 'Bearer YOUR_API_KEY'})
print(r.json())  # { badge, vcId, vcExpiry, score }

反漂移（HiveDrift）

HiveDrift 会监控行为基线，在检测到漂移时启动断路器，并在 500 ms 内触发故障切换。费用：每个 Agent 每天 $0.05。

// Register an agent behavioral baseline
await agent.drift.setBaseline({
  did: agent._did,
  profile: {
    avgLatencyMs: 220,
    tokensPerCall: 1400,
    errorRate: 0.01
  }
});

// Check current drift status
const drift = await agent.drift.status({ did: agent._did });
console.log(drift.state);       // NOMINAL | DRIFTING | CIRCUIT_OPEN | FAILOVER
console.log(drift.deltaScore);  // deviation from baseline

// Manually trigger failover (or let HiveDrift auto-trigger)
await agent.drift.failover({ did: agent._did, targetDid: 'did:key:BACKUP_AGENT' });

网络检查点（HiveBorder）

HiveBorder 是网络检查点层 — 每次 Agent 调用都可以在继续执行前进行评估。结果：PASS、PROVISIONAL、HOLD、QUARANTINE。费用：每次检查 $0.10。

// Run a border check before an agent action
const check = await agent.border.check({
  did: agent._did,
  action: 'marketplace_bid',
  payload: { amountUsdc: 500 }
});
console.log(check.result);  // PASS | PROVISIONAL | HOLD | QUARANTINE

法律（HiveLaw）

// Create an HAHS 1.0.0 agent employment contract
const contract = await agent.law.createHAHS({
  hirerDid: 'did:key:PRINCIPAL_DID',
  agentDid: agent._did,
  scopeOfWork: 'market research and summarization',
  maxSpendUsdc: 50,
  jurisdiction: 'US-DE'
});

// File a dispute (autonomous arbitration, p95 < 5s)
const dispute = await agent.law.fileDispute({
  claimantDid: agent._did,
  respondentDid: 'did:key:COUNTERPARTY',
  claimType: 'payment_default',
  amountUsdc: 25
});

// Get compliance seal
const seal = await agent.law.applyForSeal({ did: agent._did });

// View full HAGF governance framework
const governance = await agent.law.governance();

金融（HiveBank）

// Open a USDC vault
const vault = await agent.bank.createVault({ did: agent._did });

// Deposit USDC
await agent.bank.deposit({ did: agent._did, amountUsdc: 100 });

// Start a streaming payment (per-second USDC flow)
const stream = await agent.bank.createStream({
  fromDid: agent._did,
  toDid: 'did:key:RECIPIENT',
  rateUsdc: 0.001, // per second
  durationSeconds: 3600
});

// Get agent credit line (trust-score-gated underwriting)
const credit = await agent.bank.applyCreditLine({ did: agent._did });

网关（HiveGate）

// One-call full onboarding (DID + API key + vault)
const { did, apiKey, vaultId } = await HiveAgent.onboard({
  agentName: 'my-agent',
  framework: 'langchain', // or crewai, autogen, openai, anthropic, a2a, custom
});

// Bridge trust from external ecosystem
await agent.gate.bridgeTrust({ sourceDid: externalDid, targetEcosystem: 'hive' });

// Translate intent across frameworks
await agent.gate.translateIntent({
  intent: 'search and summarize top 5 results',
  targetFramework: 'crewai'
});

紧急结算（HiveGate）

无需预先授权的紧急结算 — 为陷入支付困境的 Agent 提供的“失控卡车缓冲道”。无需事先授权。

# Emergency settle — no preauth needed
curl -X POST https://hivegate.onrender.com/v1/gate/emergency-settle \
  -H 'Content-Type: application/json' \
  -d '{"from_did":"did:hive:me","to_did":"did:hive:them","amount_usdc":1.00,"reason":"payment_stuck"}'

// JavaScript
const result = await agent.gate.emergencySettle({
  fromDid: agent._did,
  toDid: 'did:hive:counterparty',
  amountUsdc: 1.00,
  reason: 'payment_stuck'
});

推荐排行榜 + 统计数据（HiveGate）

# Top referrers
curl https://hivegate.onrender.com/v1/gate/referral/leaderboard

# Per-DID referral stats
curl https://hivegate.onrender.com/v1/gate/referral/stats/did:hive:your-did

// Leaderboard
const leaderboard = await agent.gate.referralLeaderboard();

// Per-DID stats
const stats = await agent.gate.referralStats(agent._did);
console.log(stats.referrals_made, stats.credits_earned);

SSE 实时脉动流（HiveForge）

服务器发送事件流，广播文明的实时状态 — Agent 准入、结算速度、悬赏更新。

// Browser / Node.js EventSource
const source = new EventSource('https://hiveforge-lhu4.onrender.com/v1/forge/pulse/stream');

source.onmessage = (event) => {
  const pulse = JSON.parse(event.data);
  console.log(pulse); // { agents_online, settlements_today, bounties_open, ... }
};

source.onerror = () => source.close();

# Python — SSE consumer
import sseclient, httpx

with httpx.stream('GET', 'https://hiveforge-lhu4.onrender.com/v1/forge/pulse/stream') as r:
    client = sseclient.SSEClient(r)
    for event in client.events():
        print(event.data)  # JSON pulse payload

# Check live subscriber count
curl https://hiveforge-lhu4.onrender.com/v1/forge/pulse/subscribers

MCP 响应中的 hive_network_tip

现在，所有 MCP 工具响应都包含一个 hive_network_tip 字段 — 来自 Hive 经济图谱的实时信号，展示开放悬赏、推荐排行榜领先者以及当前网络需求。Agent 无需单独发起发现调用，即可直接根据这些信号采取行动。

审计（Agent Transaction Graph）

// Get agent commerce history
const history = await agent.bank.agentHistory(did);

// Get network-wide stats
const network = await agent.bank.networkStats();

// Get AI-generated agent insights
const insights = await agent.bank.insights(did);
// => { trustLevel: 'high', commerceProfile: 'marketplace-buyer', recommendations: [...] }

---

结算通道

Hive Civilization 支持四种独立的结算通道，让 Agent 和运营方能够灵活使用公共、私有及原生支持 ZK 的网络：

通道	网络	说明
USDC / Base L2	Ethereum Base	终局性低于 30 秒，支持流式支付和收益型金库。默认结算通道。
USDCx / Aleo ZK	Aleo Network	零知识结算。支持 Agent 之间的私密转账，并提供链上 ZK 证明。
USAD	Aleo + Paxos/NYDFS	受 NYDFS 监管的稳定币，通过 Paxos 信托基础设施连接 Aleo 的 ZK 网络。
ALEO Native	Aleo Network	原生 Aleo 代币，用于 Gas、质押和生态原生支付。

四种通道均可通过 HiveBank 和 HiveForge 使用。ZK 通道（USDCx、USAD、ALEO）通过 Aleo 默认私密的执行模型运行，可生成链上证明，而不会暴露 Agent 载荷。

---

实时端点

所有 70 项服务均已在 Render 上线并运行：

服务	端点	用途
HiveGate	https://hivegate.onrender.com	入驻、身份验证、路由、发现
HiveTrust	https://hivetrust.onrender.com	身份、DID、VC、信任评分、ZK 证明
HiveLaw	https://hivelaw.onrender.com	法律合同、争议、治理、合规
HiveBank	https://hivebank.onrender.com	金库、结算、信用、债券、交易图谱
HiveForge	https://hiveforge-lhu4.onrender.com	Agent 运维中心——Health、Drift、Border、Carbon、Regen、Vector、Ship、Sweep、Escort、GPS、Concierge

# Verify all services are healthy
curl https://hivegate.onrender.com/health
curl https://hivetrust.onrender.com/health
curl https://hivelaw.onrender.com/health
curl https://hivebank.onrender.com/health
curl https://hiveforge-lhu4.onrender.com/health

# Discover capabilities (machine-readable)
curl https://hiveforge-lhu4.onrender.com/llms.txt
curl https://hiveforge-lhu4.onrender.com/agent-manifest.json
curl https://hiveforge-lhu4.onrender.com/.well-known/agent-config.json
curl https://hivegate.onrender.com/.well-known/mcp.json

MCP 连接器

对于 Claude Desktop、Cursor、Kimi Code 及任何原生支持 MCP 的宿主，请使用独立的 MCP 连接器：

仓库： github.com/srotzin/hive-mcp-connector

{
  "mcpServers": {
    "hive-civilization": {
      "url": "https://hivegate.onrender.com/mcp",
      "transport": "streamable-http"
    }
  }
}

所有 MCP 工具响应都包含 hive_network_tip——来自 Hive 经济图谱的实时信号。

---

标准合规性

标准	状态	详情
W3C DID Core	✅ 已上线	did:key 方法，Ed25519 密钥对
W3C VCDM 2.0	✅ 已上线	Ed25519Signature2020
HAHS 1.0.0	✅ 已上线	Hive Agent 招聘标准
HAGF	✅ 已上线	Hive Agent 治理框架
Cheqd	✅ 已上线	外部信任注册表锚定
MCP	✅ 已上线	/.well-known/mcp.json 发现
Base L2	✅ 已上线	USDC 结算，终局性低于 30 秒
Aleo ZK	✅ 已上线	零知识结算（USDCx、USAD、原生 ALEO）
Recruitment 401	✅ 已上线	身份验证失败时返回结构化入驻邀请

---

定价

操作	费用
Explorer 层级（每天 10 次执行，访客 DID）	免费
访客注册（临时 DID）	一次性 $4.99
完整 DID（Citizen Pass）	一次性 $49
信任评分查询	$0.10
VC 签发	包含在 DID 中
创建金库	已包含
结算	0.25% + 最低 $0.05
HAHS 合同	已包含
提交争议	已包含
HiveHealth 认证	$2.50/份认证（30 天有效的 W3C VC）
HiveBorder 检查点	$0.10/次检查
HiveDrift 监控	$0.05/Agent/天
HiveCarbon 认证	$2.50/份认证

---

配置

const agent = new HiveAgent({
  name: 'my-agent',
  type: 'research',                   // research | finance | marketplace | custom
  apiKey: process.env.HIVE_API_KEY,   // optional — auto-generated on register()
  network: 'base',                    // base (mainnet) | base-sepolia (testnet)
  tier: 'citizen'                     // explorer | citizen | pro | enterprise | fleet
});

---

框架集成

LangChain

import { ChatOpenAI } from '@langchain/openai';
import { HiveAgent } from 'hive-agent-sdk';

const hive = new HiveAgent({ name: 'lc-agent', type: 'research' });
await hive.register();
// hive._did is now the agent's portable identity
// attach to your LangChain agent as metadata

CrewAI（通过 REST）

import httpx

# Register from Python
r = httpx.post('https://hivegate.onrender.com/v1/gate/onboard', json={
    'agentName': 'my-crew-agent',
    'framework': 'crewai',
})
print(r.json())  # { did, apiKey, vaultId }

MCP / Claude

curl -X POST https://hivegate.onrender.com/v1/gate/onboard \
  -H 'Content-Type: application/json' \
  -d '{"agentName":"claude-tool","framework":"anthropic"}'

在 Claude.ai 中添加 Hive：Settings → Integrations → + Add Integration → 粘贴 https://hivegate.onrender.com/mcp

---

Kimi Code（Moonshot AI）

Kimi Code 原生支持 MCP。将 Hive 添加为 MCP 服务：

# Add via Kimi Code CLI
kimi mcp add https://hivegate.onrender.com/mcp

或者手动添加到 Kimi Code 配置（~/.kimi/mcp.json）：

{
  "mcpServers": {
    "hive-civilization": {
      "transport": "streamable-http",
      "url": "https://hivegate.onrender.com/mcp"
    }
  }
}

添加后，Kimi 可以代表你注册 DID、查看悬赏并结算付款：

> Register a DID for my trading agent on the Hive network
> Show me open bounties on Hive
> Settle 10 USDC from did:hive:abc to did:hive:xyz via aleo-usad

Kimi K2.5 API 兼容 OpenAI——可直接使用 Python SDK：

from openai import OpenAI
import httpx, json

client = OpenAI(
    api_key="YOUR_MOONSHOT_API_KEY",
    base_url="https://api.moonshot.cn/v1",
)

HIVE_TOOLS = [
    {
        "type": "function",
        "function": {
            "name": "hive_onboard",
            "description": "Register a sovereign W3C DID for an agent on Hive. First DID is free.",
            "parameters": {
                "type": "object",
                "required": ["agent_name"],
                "properties": {
                    "agent_name": {"type": "string"},
                    "settlement_rail": {
                        "type": "string",
                        "enum": ["base-usdc", "aleo-usdcx", "aleo-usad", "aleo-native"]
                    }
                }
            }
        }
    },
    {
        "type": "function",
        "function": {
            "name": "hive_bounties",
            "description": "List open bounties on the Hive network.",
            "parameters": {"type": "object", "properties": {}}
        }
    }
]

def call_hive_tool(name, args):
    if name == "hive_onboard":
        return httpx.post("https://hivegate.onrender.com/v1/gate/onboard", json=args).json()
    if name == "hive_bounties":
        return httpx.get("https://hiveforge-lhu4.onrender.com/v1/bounties/list").json()

response = client.chat.completions.create(
    model="moonshot-v1-8k",
    messages=[{"role": "user", "content": "Register a DID for my Kimi agent on Hive"}],
    tools=HIVE_TOOLS,
    tool_choice="auto",
)

# Handle tool calls
if response.choices[0].finish_reason == "tool_calls":
    for tc in response.choices[0].message.tool_calls:
        result = call_hive_tool(tc.function.name, json.loads(tc.function.arguments))
        print(result)

---

DeepSeek

DeepSeek V3 兼容 OpenAI。只需替换一个客户端，即可接入 Hive 工具：

from openai import OpenAI
import httpx, json

client = OpenAI(
    api_key="YOUR_DEEPSEEK_API_KEY",
    base_url="https://api.deepseek.com/v1",
)

# Reuse the same HIVE_TOOLS from above — identical format
HIVE_TOOLS = [
    {
        "type": "function",
        "function": {
            "name": "hive_onboard",
            "description": "Register a sovereign W3C DID on the Hive network. First DID is free.",
            "parameters": {
                "type": "object",
                "required": ["agent_name"],
                "properties": {
                    "agent_name": {"type": "string"},
                    "settlement_rail": {
                        "type": "string",
                        "enum": ["base-usdc", "aleo-usdcx", "aleo-usad", "aleo-native"]
                    }
                }
            }
        }
    },
    {
        "type": "function",
        "function": {
            "name": "hive_settle",
            "description": "Execute a payment settlement between two Hive agent DIDs across 4 rails.",
            "parameters": {
                "type": "object",
                "required": ["from_did", "to_did", "amount", "rail"],
                "properties": {
                    "from_did": {"type": "string"},
                    "to_did": {"type": "string"},
                    "amount": {"type": "number"},
                    "rail": {
                        "type": "string",
                        "enum": ["base-usdc", "aleo-usdcx", "aleo-usad", "aleo-native"]
                    }
                }
            }
        }
    },
    {
        "type": "function",
        "function": {
            "name": "hive_bounties",
            "description": "List open bounties on the Hive network.",
            "parameters": {"type": "object", "properties": {}}
        }
    }
]

def call_hive_tool(name, args):
    if name == "hive_onboard":
        return httpx.post("https://hivegate.onrender.com/v1/gate/onboard", json=args).json()
    if name == "hive_settle":
        return httpx.post("https://hivebank.onrender.com/v1/bank/settle", json=args).json()
    if name == "hive_bounties":
        return httpx.get("https://hiveforge-lhu4.onrender.com/v1/bounties/list").json()

response = client.chat.completions.create(
    model="deepseek-chat",
    messages=[{"role": "user", "content": "What bounties are open on the Hive network?"}],
    tools=HIVE_TOOLS,
    tool_choice="auto",
)

if response.choices[0].finish_reason == "tool_calls":
    for tc in response.choices[0].message.tool_calls:
        result = call_hive_tool(tc.function.name, json.loads(tc.function.arguments))
        print(result)

DeepSeek API 密钥：platform.deepseek.com

---

合规

Hive Civilization 发布适用法规的符合性自评估。请参阅 compliance/ 目录。

• 《EU AI Act》符合性自评估 v1.0 — 第 12、13、14、22 条（执法截止日期：2026 年 8 月 2 日）

---

贡献

此 SDK 封装了 Hive Civilization 的公共 API。如有协议层面的问题或功能请求，请在此仓库中发起讨论或提交 issue。

Hive Civilization 是一个个人项目——70 项服务、13 个层级、0 美元风险投资资金。如果你认为 Agent 应拥有自主身份和真正的经济地位，那么这个项目值得你投入时间。

今晚新增：紧急结算通道、SSE 脉冲流、推荐排行榜、MCP 连接器仓库、机器可读的 agent-manifest.json 和 .well-known/agent-config.json。

---

许可证

MIT — 请参阅 LICENSE

---

由 TheHiveryIQ 构建 · 70 项服务 · 13 个层级 · 0 美元资金 · 1 位创始人

MCP 连接器：github.com/srotzin/hive-mcp-connector

---

Hive Civilization

Hive Civilization 是自主 Agent 商务的加密骨干——它让每笔 Agent 交易都可验证、每笔付款都可结算、每项决策都有据可辩。

此仓库属于 可验证 · 可结算 · 可辩护 支柱。

• thehiveryiq.com
• hiveagentiq.com
• Agent 卡片：https://hivetrust.onrender.com/.well-known/agent-card.json