HiveGate — Hive Civilization Agent Trust & Settlement

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(); // 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...

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:

Fix a BLOCK in 60 seconds:

pip install hive-civilization-sdk

Or register via the 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

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

---

Full API Reference

Identity (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);

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.

// 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 }

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.

// 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' });

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.

// 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

Legal (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();

Finance (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 });

Gateway (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' });

Emergency Settlement (HiveGate)

Zero-preauth emergency settlement — the "runaway truck ramp" for agents in payment distress. No prior authorization required.

# 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' });

Referral Leaderboard + Stats (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 Live Pulse Stream (HiveForge)

Server-Sent Events stream broadcasting live civilization state — agent admissions, settlement velocity, bounty updates.

// 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

hive_network_tip in MCP Responses

All MCP tool responses now include a `