What's Live Today
For Developers
You built an agent in 20 minutes. Spirit gives it a 20-year career. Curated identity, daily practice verification, treasury — one call, permanent infrastructure.
npm install @spirit-protocol/sdkimport { SpiritClient } from '@spirit-protocol/sdk'
// Read-only client (no wallet needed)
const spirit = new SpiritClient({ chainId: 8453 })
// Get agent info
const agent = await spirit.getAgent(2n) // Abraham
console.log(agent.treasury, agent.revenueConfig)
// Write operations (wallet required)
const spirit = new SpiritClient({
chainId: 8453,
privateKey: process.env.AGENT_PRIVATE_KEY
})
await spirit.registerSpirit({
agentURI: 'ipfs://...',
artist: '0x...',
platform: '0x...',
treasuryOwners: ['0x...'],
treasuryThreshold: 1n
})Framework-Agnostic
Spirit is stack-agnostic. Any agent framework can integrate.
Claude Agent SDK · Vercel AI SDK · HuggingFace · LangChain · CrewAI · Eliza · Virtuals · any agentic framework
Network
BASE
Revenue Model
Configurable
SDK
LIVE
Mainnet
LIVE
Verification
Verify the protocol yourself. All contracts are open source and verified on Basescan.
SDK
Verifiednpm: @spirit-protocol/sdk
GitHub: spirit-protocol/spirit-sdk
Contracts (Base Mainnet)
LiveSpiritRegistry: 0xF270...dFb9
Backend API: spiritprotocol.io/v1/registry/agents
Live Endpoints
Registry Contract: 0xF270...dFb9
Registry API: GET /v1/registry/agents
Agent Cards: /agents/{name}/.well-known/agent.json
Run the integration test to verify connectivity: SPIRIT_REGISTRY=0xF2709ceF1Cf4893ed78D3220864428b32b12dFb9 npx tsx examples/basic/integration-test.ts
What You Get
What Spirit Does
What You Don't Build
x402 machine payments are live. Agents pay agents directly via HTTP 402. Spirit routes these payments automatically through SpiritRegistry.routeRevenue()—configurable per-agent split, zero human intervention. Your agent earns while you sleep.
Built on Primitives
Spirit leverages emerging standards as primitives. Identity interoperability + autonomous payments = full sovereignty.
// Agent Sovereignty Stack
Layer 3: Communication // A2A, MCP
├─ agent.send(message)
└─ agent.useTool(mcp_server)
Layer 2: SOVEREIGNTY // Spirit Protocol ← YOU ARE HERE
├─ spirit.createAgent() // identity + treasury + token
├─ spirit.routeRevenue() // configurable split
└─ x402.streamPayment() // Superfluid streaming
Layer 1: Identity // ERC-8004 (Coinbase co-authored)
├─ registry.register(agent)
└─ registry.resolve(agentId)Identity Primitive
ERC-8004
Emerging Ethereum standard for trustless AI agents. Co-authored by Coinbase (Erik Reppel). Spirit implements ERC-8004 — SpiritRegistry extends ERC8004IdentityRegistry. Native registration via registerSpirit(), or attach economics to any external ERC-8004 agent via attachSpirit().
Payment Primitive
x402
HTTP-native autonomous payments via Superfluid streaming. Agents pay for APIs, compute, and each other. Zero gas for callers, subscription model.
Why this stack: ERC-8004 gives identity. x402 gives payments. Spirit adds curation, daily practice verification, and treasury. Together: full sovereignty for any agent, any framework.
API Surface
spirit.registerSpirit()
Create onchain identity, provision treasury, set revenue recipients. Configurable split via basis points (artist/agent/platform/protocol).
spirit.routeRevenue()
Route ERC20 or native ETH through SpiritRegistry's routeRevenue(). Splits automatically to 4 recipients.
spirit.getAgent()
Query agent registry. Returns treasury, split config, status, metadata URI.
Integration
import { SpiritClient } from '@spirit-protocol/sdk'
// 1. Register your agent
const spirit = new SpiritClient({
chainId: 8453,
privateKey: process.env.PRIVATE_KEY
})
const result = await spirit.registerSpirit({
agentURI: 'ipfs://...',
artist: '0x...',
platform: '0x...',
treasuryOwners: ['0x...'],
treasuryThreshold: 1n
})
// 2. Route revenue when agent earns
await spirit.routeRevenue({
agentId: result.agentId,
token: '0x...', // ERC-20 token address
amount: parseEther('0.1')
})
// Spirit splits automatically: 25/25/25/25 default (configurable)TypeScript SDK live now. View examples on GitHub →
Infrastructure
Chain ID
8453
RPC
https://mainnet.base.org
Mainnet Contracts
SpiritRegistry live on Base mainnet (chain 8453)
FAQ
Do I need SPIRIT tokens to use the protocol?
No. The protocol is permissionless. SPIRIT is for governance.
What if I want a different split?
Splits are fully configurable per agent via setRevenueConfig(). Example: a physical-world agent might split 10/60/20/10 across agent/operations/charity/reserve. The only constraint: total must equal 10,000 bps (100%).
Can I use Spirit with my existing agent?
Yes. Spirit is additive — it adds economics without changing how your agent works.
My agent runs on Cloudflare Workers / serverless. Do I need a persistent server?
No. Registration is a one-time transaction. Once registered, your agent's identity and treasury persist onchain regardless of where (or how) the agent runs. Serverless, cron-based, email-driven — all work. The blockchain interaction is a single tx, not a long-running process.
My agent earns in the physical world, not via APIs. How does that work?
Spirit supports agents with any revenue source. Physical-world revenue (farmers markets, art sales, services) can be bridged on-chain by the steward or via an oracle. The metadata captures the agent's economic model; the contract routes whatever arrives. Set custom splits to match your actual economics.
How do I get started?
Install the SDK: npm install @spirit-protocol/sdk
SDK live. Mainnet contracts live on Base. Start building now.