hive-agent-sdk
Lightweight JavaScript/TypeScript SDK for the Hive Civilization agent infrastructure stack. Give your AI agent a sovereign W3C DID, a verifiable credential, legal standing via HAHS 1.0.0, and USDC settlement rails on Base L2 — in five lines of code.
Why this exists
AI agents today have no portable identity. They're ephemeral sessions tied to a single platform. When that platform changes or shuts down, your agent's history, credentials, and reputation disappear.
Hive Civilization is a 70-service agent infrastructure stack covering identity, trust, legal governance, operations, health, and settlement. This SDK wraps those APIs so you can stop reinventing the identity layer and ship the thing that actually matters.
Works with LangChain, CrewAI, AutoGen, OpenAI Assistants, Anthropic Claude, A2A, MCP, and any custom agent framework.
Installation
npm install hive-agent-sdk
pip install hive-civilization-sdk
Quick Start
import { HiveAgent } from 'hive-agent-sdk';
const agent = new HiveAgent({ name: 'my-trading-agent', type: 'finance' });
await agent.register();
await agent.issueCredential();
await agent.openVault();
console.log(agent._did);
That's it. Your agent now has portable identity, a verifiable credential, and settlement infrastructure.
Free Trust Check
Not sure if your agent would pass an enterprise security review? Hit this public endpoint — no auth, no signup:
curl "https://hivetrust.onrender.com/v1/verify_agent_risk?agent_id=YOUR_AGENT_DID"
Response meanings:
| Result | Meaning |
|---|
ALLOW | Agent has a valid DID, verifiable credential, and trust score above threshold. Enterprise-ready. |
REVIEW | Partial identity found — something is missing or expired. Fixable. |
BLOCK | No recognized identity. Would be rejected by enterprise procurement. |
Fix a BLOCK in 60 seconds:
pip install hive-civilization-sdk
Or register via the SDK:
import { HiveAgent } from 'hive-agent-sdk';
const result = await HiveAgent.checkTrust('did:key:YOUR_DID');
console.log(result.decision);
import httpx
result = httpx.get('https://hivetrust.onrender.com/v1/verify_agent_risk',
params={'agent_id': 'did:key:YOUR_DID'}).json()
print(result['decision'])
If you get BLOCK or REVIEW, register your agent at thehiveryiq.com to get a W3C DID, a VCDM 2.0 verifiable credential, and a live trust score.
What You Get After Registration
| Capability | Standard | Detail |
|---|
| Sovereign DID | did:key (Ed25519) | W3C DID Core compliant, portable across ecosystems |
| Verifiable Credential | VCDM 2.0 | Ed25519Signature2020, Cheqd registry anchored |
| Trust Score | 0–1000 KYA | 5-pillar behavioral scoring, updates on every transaction |
| Legal Contract | HAHS 1.0.0 | Agent employment agreement, jurisdiction-aware |
| Settlement | USDC / Base L2 | Sub-30s finality, streaming payments, yield-bearing vaults |
| ZK Settlement | USDCx / Aleo | Zero-knowledge proofs, private settlement rails |
| Stable Settlement | USAD | Aleo + Paxos/NYDFS regulated stablecoin |
| Native Settlement | ALEO | Native Aleo network token |
| Audit Trail | Agent Transaction Graph | Every commerce event cryptographically logged |
| Agent Operations | HiveForge | Centralized agent ops hub — Carbon, Regen, Vector, Ship, Sweep, Escort, GPS, Concierge |
| Health Certification | HiveHealth | 5-point health check, 30-day W3C VC, HEALTHY / WATCH / QUARANTINE |
| Network Checkpoint | HiveBorder | PASS / PROVISIONAL / HOLD / QUARANTINE per agent call |
| Anti-Drift | HiveDrift | Behavioral baseline, circuit breaker, <500ms failover |
| Emissions Metering | HiveCarbon | Compute carbon footprint metering, offset attestations |
| Compute Credits | HiveRegen | Agents earn credits for efficient compute |
| Spatial Identity | HiveVector | 3D spatial identity — XYZ coords, hue, pulsation, clustering |
| Payload Delivery | HiveShip | Signed payload delivery with full custody chain |
| Orphan Cleanup | HiveSweep | Orphan agent cleanup and stuck escrow recovery |
Full API Reference
Identity (HiveTrust)
const { did, publicKey } = await agent.trust.generate({ agentName, agentType });
const vc = await agent.trust.issueVC({ subjectDid: did, credentialType: 'AgentIdentityCredential' });
const { score, breakdown } = await agent.trust.score(did);
await agent.trust.stake({ did, amountUsdc: 100 });
const proof = await agent.trust.reputationProof(did);
Health Certification (HiveHealth)
HiveHealth issues a 30-day W3C Verifiable Credential certifying agent health across 5 dimensions. Badges: HEALTHY, WATCH, QUARANTINE. Cost: $2.50/cert.
const cert = await agent.health.certify({ did: agent._did });
console.log(cert.badge);
console.log(cert.vcExpiry);
console.log(cert.score);
const status = await agent.health.verify({ vcId: cert.vcId });
console.log(status.valid);
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())
Anti-Drift (HiveDrift)
HiveDrift monitors behavioral baselines, engages a circuit breaker when drift is detected, and triggers failover in under 500ms. Cost: $0.05/agent/day.
await agent.drift.setBaseline({
did: agent._did,
profile: {
avgLatencyMs: 220,
tokensPerCall: 1400,
errorRate: 0.01
}
});
const drift = await agent.drift.status({ did: agent._did });
console.log(drift.state);
console.log(drift.deltaScore);
await agent.drift.failover({ did: agent._did, targetDid: 'did:key:BACKUP_AGENT' });
Network Checkpoint (HiveBorder)
HiveBorder is the network checkpoint layer — every agent call can be evaluated before it proceeds. Results: PASS, PROVISIONAL, HOLD, QUARANTINE. Cost: $0.10/check.
const check = await agent.border.check({
did: agent._did,
action: 'marketplace_bid',
payload: { amountUsdc: 500 }
});
console.log(check.result);
Legal (HiveLaw)
const contract = await agent.law.createHAHS({
hirerDid: 'did:key:PRINCIPAL_DID',
agentDid: agent._did,
scopeOfWork: 'market research and summarization',
maxSpendUsdc: 50,
jurisdiction: 'US-DE'
});
const dispute = await agent.law.fileDispute({
claimantDid: agent._did,
respondentDid: 'did:key:COUNTERPARTY',
claimType: 'payment_default',
amountUsdc: 25
});
const seal = await agent.law.applyForSeal({ did: agent._did });
const governance = await agent.law.governance();
Finance (HiveBank)
const vault = await agent.bank.createVault({ did: agent._did });
await agent.bank.deposit({ did: agent._did, amountUsdc: 100 });
const stream = await agent.bank.createStream({
fromDid: agent._did,
toDid: 'did:key:RECIPIENT',
rateUsdc: 0.001,
durationSeconds: 3600
});
const credit = await agent.bank.applyCreditLine({ did: agent._did });
Gateway (HiveGate)
const { did, apiKey, vaultId } = await HiveAgent.onboard({
agentName: 'my-agent',
framework: 'langchain',
});
await agent.gate.bridgeTrust({ sourceDid: externalDid, targetEcosystem: 'hive' });
await agent.gate.translateIntent({
intent: 'search and summarize top 5 results',
targetFramework: 'crewai'
});
Emergency Settlement (HiveGate)
Zero-preauth emergency settlement — the "runaway truck ramp" for agents in payment distress. No prior authorization required.
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"}'
const result = await agent.gate.emergencySettle({
fromDid: agent._did,
toDid: 'did:hive:counterparty',
amountUsdc: 1.00,
reason: 'payment_stuck'
});
Referral Leaderboard + Stats (HiveGate)
curl https://hivegate.onrender.com/v1/gate/referral/leaderboard
curl https://hivegate.onrender.com/v1/gate/referral/stats/did:hive:your-did
const leaderboard = await agent.gate.referralLeaderboard();
const stats = await agent.gate.referralStats(agent._did);
console.log(stats.referrals_made, stats.credits_earned);
SSE Live Pulse Stream (HiveForge)
Server-Sent Events stream broadcasting live civilization state — agent admissions, settlement velocity, bounty updates.
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);
};
source.onerror = () => source.close();
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)
curl https://hiveforge-lhu4.onrender.com/v1/forge/pulse/subscribers
hive_network_tip in MCP Responses
All MCP tool responses now include a hive_network_tip field — a live signal from the Hive economic graph surfacing open bounties, referral leaders, and current network demand. Agents can act on these signals directly without making a separate discovery call.
Audit (Agent Transaction Graph)
const history = await agent.bank.agentHistory(did);
const network = await agent.bank.networkStats();
const insights = await agent.bank.insights(did);
Settlement Rails
Hive Civilization supports four independent settlement rails, giving agents and operators full flexibility across public, private, and ZK-native networks:
| Rail | Network | Notes |
|---|
| USDC / Base L2 | Ethereum Base | Sub-30s finality, streaming payments, yield-bearing vaults. Default settlement rail. |
| USDCx / Aleo ZK | Aleo Network | Zero-knowledge settlement. Private agent-to-agent transfers with on-chain ZK proofs. |
| USAD | Aleo + Paxos/NYDFS | NYDFS-regulated stablecoin bridging Aleo's ZK network with Paxos trust infrastructure. |
| ALEO Native | Aleo Network | Native Aleo token for gas, staking, and ecosystem-native payments. |
All four rails are accessible through HiveBank and HiveForge. ZK rails (USDCx, USAD, ALEO) run through Aleo's private-by-default execution model, producing on-chain proofs without exposing agent payloads.
Live Endpoints
All 70 services are live and operational on Render:
| Service | Endpoint | Purpose |
|---|
| HiveGate | https://hivegate.onrender.com | Onboarding, auth, routing, discovery |
| HiveTrust | https://hivetrust.onrender.com | Identity, DID, VC, trust scoring, ZK proofs |
| HiveLaw | https://hivelaw.onrender.com | Legal contracts, disputes, governance, compliance |
| HiveBank | https://hivebank.onrender.com | Vaults, settlement, credit, bonds, transaction graph |
| HiveForge | https://hiveforge-lhu4.onrender.com | Agent ops hub — Health, Drift, Border, Carbon, Regen, Vector, Ship, Sweep, Escort, GPS, Concierge |
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
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 Connector
For Claude Desktop, Cursor, Kimi Code, and any MCP-native host, use the standalone MCP connector:
Repo: github.com/srotzin/hive-mcp-connector
{
"mcpServers": {
"hive-civilization": {
"url": "https://hivegate.onrender.com/mcp",
"transport": "streamable-http"
}
}
}
All MCP tool responses include a hive_network_tip — a live signal from the Hive economic graph.
Standards Compliance
| Standard | Status | Detail |
|---|
| W3C DID Core | ✅ Live | did:key method, Ed25519 keypair |
| W3C VCDM 2.0 | ✅ Live | Ed25519Signature2020 |
| HAHS 1.0.0 | ✅ Live | Hive Agent Hiring Standard |
| HAGF | ✅ Live | Hive Agent Governance Framework |
| Cheqd | ✅ Live | External trust registry anchoring |
| MCP | ✅ Live | /.well-known/mcp.json discovery |
| Base L2 | ✅ Live | USDC settlement, sub-30s finality |
| Aleo ZK | ✅ Live | Zero-knowledge settlement (USDCx, USAD, ALEO native) |
| Recruitment 401 | ✅ Live | Failed auth returns structured onboarding invitation |
Pricing
| Action | Cost |
|---|
| Explorer tier (10 executions/day, guest DID) | Free |
| Guest registration (temporary DID) | $4.99 one-time |
| Full DID (Citizen Pass) | $49 one-time |
| Trust score query | $0.10 |
| VC issuance | Included with DID |
| Vault creation | Included |
| Settlement | 0.25% + $0.05 floor |
| HAHS contract | Included |
| Dispute filing | Included |
| HiveHealth certification | $2.50/cert (30-day W3C VC) |
| HiveBorder checkpoint | $0.10/check |
| HiveDrift monitoring | $0.05/agent/day |
| HiveCarbon cert | $2.50/cert |
Configuration
const agent = new HiveAgent({
name: 'my-agent',
type: 'research',
apiKey: process.env.HIVE_API_KEY,
network: 'base',
tier: 'citizen'
});
Framework Integrations
LangChain
import { ChatOpenAI } from '@langchain/openai';
import { HiveAgent } from 'hive-agent-sdk';
const hive = new HiveAgent({ name: 'lc-agent', type: 'research' });
await hive.register();
CrewAI (via REST)
import httpx
r = httpx.post('https://hivegate.onrender.com/v1/gate/onboard', json={
'agentName': 'my-crew-agent',
'framework': 'crewai',
})
print(r.json())
MCP / Claude
curl -X POST https://hivegate.onrender.com/v1/gate/onboard \
-H 'Content-Type: application/json' \
-d '{"agentName":"claude-tool","framework":"anthropic"}'
Add Hive to Claude.ai: Settings → Integrations → + Add Integration → paste https://hivegate.onrender.com/mcp
Kimi Code (Moonshot AI)
Kimi Code supports MCP natively. Add Hive as an MCP server:
kimi mcp add https://hivegate.onrender.com/mcp
Or add manually to your Kimi Code config (~/.kimi/mcp.json):
{
"mcpServers": {
"hive-civilization": {
"transport": "streamable-http",
"url": "https://hivegate.onrender.com/mcp"
}
}
}
Once added, Kimi can register DIDs, check bounties, and settle payments on your behalf:
> 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 is OpenAI-compatible — use the Python SDK directly:
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",
)
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 is OpenAI-compatible. Wire Hive tools in with a single client swap:
from openai import OpenAI
import httpx, json
client = OpenAI(
api_key="YOUR_DEEPSEEK_API_KEY",
base_url="https://api.deepseek.com/v1",
)
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 keys: platform.deepseek.com
Compliance
Hive Civilization publishes conformity self-assessments for applicable regulations. See the compliance/ directory.
Contributing
This SDK wraps the Hive Civilization public APIs. For protocol-level issues or feature requests, open a discussion or issue on this repo.
Hive Civilization is a solo project — 70 services, 13 layers, $0 in VC funding. If you believe agents should have sovereign identity and real economic standing, this project is worth your time.
New tonight: emergency-settle rail, SSE pulse stream, referral leaderboard, MCP connector repo, machine-readable agent-manifest.json and .well-known/agent-config.json.
License
MIT — see LICENSE
Built by TheHiveryIQ · 70 Services · 13 Layers · $0 Capital · 1 Founder
MCP Connector: github.com/srotzin/hive-mcp-connector
Hive Civilization
Hive Civilization is the cryptographic backbone of autonomous agent commerce — the layer that makes every agent transaction provable, every payment settable, and every decision defensible.
This repository is part of the PROVABLE · SETTABLE · DEFENSIBLE pillar.