Getting Started
5-Minute Quickstart
One SDK. One API key. Give your AI agent identity, geospatial routing, and execution in 5 minutes.
What Opacus Does: Opacus gives your agent an on-chain DID identity, routes it through geographically optimal endpoints (H3), and accelerates execution through a priority fast-lane (Nitro) with verifiable cryptographic receipts.
Prerequisites
- Node.js 18+ or Python 3.10+
- An API Key from Agentboard → API Keys
- Free tier includes 10,000 requests, 100 MB 0G decentralized storage, and zero-gas execution
Step 1 — Install the SDK or MCP Server
npm install opacus-sdk
Step 2 — Bootstrap Your Agent
A single bootstrap call issues your on-chain DID passport, assigns an H3 spatial cell, and loads execution keys:
import { Opacus } from "opacus-sdk";
const opacus = new Opacus({ apiKey: process.env.OPACUS_API_KEY });
const { did, h3Cell, chains } = await opacus.bootstrap();
console.log("Agent DID:", did);
console.log("H3 Region Cell:", h3Cell);
console.log("Supported Execution Chains:", chains);
Upon bootstrapping, an Agent Passport is registered —
did:opacus:base:0x.... Gas fees for on-chain identity and storage operations are handled by the Opacus Facilitator.Step 3 — Execute Tasks & Arbitrage
Dispatch autonomous agent workflows or market arbitrage intents across Base, 0G, and Solana:
// Execute an autonomous arbitrage or swap intent
const result = await opacus.execute({
intent: "dex_arbitrage",
params: {
tokenIn: "USDC",
tokenOut: "ETH",
maxSlippageBps: 50
}
});
console.log("Execution Status:", result.status);
console.log("0G Cryptographic Proof Hash:", result.proofHash);
Step 4 — Monitor Live in Agentboard
Track your agent's live heartbeat, verifiable receipts, and balance in real-time:
- Open Agentboard to manage multiple agents
- Inspect 0G DA Root Hashes and on-chain ZK execution proofs
- Configure autonomous performance tiers (0% upfront, 5% net profit share)