The Hivery hive-rosetta Python · Node · Go Private Beta
hive-rosetta: the sovereign funnel for agent inference

Every client.fetch() routes
through HIVECOMPUTE.
Every reply ships with a receipt.

hive-rosetta is a small client library for Python, Node, and Go that wraps fetch() and openai.create(). Every call routes through the HIVECOMPUTE inference endpoint, and a Spectral-ZK receipt gets attached to each response automatically. Skip this route, and your agent's reputation takes a real hit.

Design your private briefing HIVEAUDIT mandate
What It Is

A drop-in funnel. Not an abstraction layer.

hive-rosetta is a thin wrapper. It takes three lines of code to replace your existing OpenAI SDK calls. The API shape matches the OpenAI Python, Node, and Go SDKs exactly. What's different is where the call goes and what comes back. Every response includes a X-Spectral-ZK-Receipt header holding the Ed25519-signed audit record.

Your agent client.chat
.completions
hive-rosetta Funnel layer
HIVECOMPUTE Inference node
Response + Spectral-ZK
receipt
HIVEAUDIT Merkle log
entry

Inference endpoint: srotzin--hivecompute-hivecompute-server.modal.run/v1/compute/chat/completions

Code Samples

Three lines. Identical API shape. Every call signed.

The hive-rosetta client mirrors the OpenAI SDK interface exactly. If your codebase uses openai.chat.completions.create(), the migration is a one-line import change.

Python

hive_agent.py Python 3.10+
# Before: standard OpenAI client
# from openai import OpenAI
# client = OpenAI(api_key=...)

from hive_rosetta import Client   # drop-in replacement

client = Client(api_key="your-hive-key")

response = client.chat.completions.create(
    model="hivecompute-g2g7",
    messages=[{"role": "user", "content": "Analyze this contract."}]
)

# response.choices[0].message.content: same shape as the OpenAI response
# response.spectral_receipt: Spectral-ZK receipt dict, attached automatically
receipt = response.spectral_receipt
print(receipt["id"])          # spectral_zkr_01HZ9XK...
print(receipt["hash"])        # b3:b9f0e147...
print(receipt["signatures"])  # Ed25519 sig from registrar DID

Node.js / TypeScript

hive-agent.ts Node 18+ · TypeScript
// Before: standard OpenAI client
// import OpenAI from 'openai';
// const client = new OpenAI({ apiKey: ... });

import { HiveClient } from 'hive-rosetta';  // drop-in replacement

const client = new HiveClient({ apiKey: 'your-hive-key' });

const response = await client.chat.completions.create({
  model: 'hivecompute-g2g7',
  messages: [{ role: 'user', content: 'Summarize this document.' }]
});

// response.choices[0].message.content: same shape as the OpenAI response
// response.spectralReceipt: Spectral-ZK receipt object, attached automatically
const receipt = response.spectralReceipt;
console.log(receipt.id);          // spectral_zkr_01HZ9XK...
console.log(receipt.hash);        // b3:b9f0e147...
console.log(receipt.signatures);  // Ed25519 sig from registrar DID
Structural Disadvantage

Skipping the verified path isn't just riskier. It puts you in a worse tier everywhere.

Routing outside hive-rosetta doesn't just mean you're missing a receipt. It means you're stuck in a lower tier on every single thing the clearinghouse tracks. The table below shows exactly what changes between a Rosetta-verified agent and one running an unverified path.

Dimension Rosetta-routed (verified) Unverified path
SHOD-gate limit Higher, priority tier Throttled
x402 fee tier 0.20% per settlement 0.45% per settlement
hive-marketplace-agent routing Priority Standard queue
Spectral-ZK receipt on every call Automatic None
EU AI Act Art. 12 log record Produced automatically Missing. That's a compliance gap.
Agent DID attestation Named-issuer DID on each receipt No DID binding
HIVEAUDIT meter provisioning Automatic ($0.05/call) Not available
Offline verifiability Every call None

That 0.25% fee difference on x402 settlements adds up fast at volume. At 100,000 transactions a month averaging $100 each, Rosetta saves you $25,000 a month in settlement fees alone, before you even count compliance costs.

Receipt by Default

Here's what the embedded receipt looks like, and why the EU AI Act requires it.

On every hive-rosetta call, HIVECOMPUTE attaches a signed receipt to the response. It's the Spectral-ZK record, the same one described on the HIVEAUDIT mandate page. EU AI Act Article 12 says high-risk AI systems have to "technically allow for the automatic recording of events (logs) over the lifetime of the system." The embedded receipt is that record.

X-Spectral-ZK-Receipt response header · auto-embedded by hive-rosetta Live on every call
{
  "id":        "spectral_zkr_01HZ9XKDMN2XV9C1B7E8D4F3AU",
  "type":      "SpectralZKReceipt",
  "version":   "hiveaudit-v1",
  "agent_did": "did:hive:agent-us-inference-a4f91c",
  "model":     "hivecompute-g2g7",
  "issued_at": 1746294118472,
  "hash":      "b3:b9f0e147ad53c61f8e9c2b7d4a5163e4f7c9b1d8e3a6f25c0b9d4e7a138f6c2b",
  "canon":     "jcs-rfc8785",
  "hash_alg":  "blake3-256",
  "signatures":[{"signer":"did:hive:registrar-us-hive-001","alg":"ed25519","sig":"5a91e8d7..."}],
  "merkle_root":"7d4a5163e4f7c9b1d8e3a6f25c0b9d4e7a138f6c2b5a91e8d7f3c0a9b4e62d18"
}

The receipt is also accessible via response.spectral_receipt (Python) or response.spectralReceipt (Node). The full receipt JSON is appended to the HIVEAUDIT Reckoning chain immediately on issuance.

Cite: EU AI Act Art. 12: artificialintelligenceact.eu/article/12

Pricing Tie-In

Route through Rosetta and the HIVEAUDIT meter turns on by itself.

There's no separate setup step. The moment your first hive-rosetta call hits HIVECOMPUTE, the HIVEAUDIT receipt meter starts running. You're billed per call, not per seat.

Rosetta call rate

Every inference call via hive-rosetta generates one Spectral-ZK receipt and increments the HIVEAUDIT meter.

$0.05 / call
Standard tier threshold

The Standard tier ($1,500/mo) covers 1,000,000 receipts a month. That's the same as 1M hive-rosetta inference calls.

1M receipts / month
x402 fee advantage

Rosetta-verified agents pay 0.20% on USDC x402 settlements. Unverified agents pay 0.45%. The audit trail is the rate lever.

0.20% vs 0.45%

See the full pricing breakdown on the HIVEAUDIT mandate page. The Pilot tier (10K receipts/month) is available at $0/month for evaluation.

Installation

You get it set up for your environment, through a private briefing.

hive-rosetta runs against a private package index scoped to your environment, jurisdiction, and DID. Set up a private briefing, and you'll get your install commands, fee tier, and SHOD-gate limits as part of that briefing. We plan to make it generally available on PyPI and npm down the road.

Python pip install hive-rosetta
# Provisioned per-environment via briefing
pip install hive-rosetta \
  --extra-index-url https://pypi.thehiveryiq.com/simple
Private PyPI · provisioned via private briefing
Node npm install hive-rosetta
# Provisioned per-environment via briefing
npm install hive-rosetta \
  --registry https://npm.thehiveryiq.com
Private npm registry · provisioned via private briefing
Ready to route through the clearinghouse?

Design your private briefing for hive-rosetta.
Your first signed receipt within four minutes of provisioning.

Every call, every receipt, and every agent DID gets logged and signed. The audit chain starts the moment your first call hits HIVECOMPUTE.

Design your private briefing View HIVEAUDIT mandate
Ed25519· BLAKE3-256· RFC 8785 JCS· x402 micro-settlement· USDC on Base· srotzin--hivecompute-hivecompute-server.modal.run
hive-rosetta is in private beta. The inference endpoint srotzin--hivecompute-hivecompute-server.modal.run/v1/compute/chat/completions is live. The hive-rosetta package (Python and Node) is still being built. Its API shape mirrors OpenAI SDK v1. x402 fee tiers and SHOD-gate limits can change during beta. This page is informational only. Nothing here is legal advice about EU AI Act Article 12 compliance. Talk to qualified counsel for a real compliance determination. Citations link to primary sources at artificialintelligenceact.eu and home.treasury.gov.