For Developers

You built an agent.
Now give it economics.

You built an agent in 20 minutes. Spirit gives it a 20-year career. Identity, treasury, revenue routing—one call, permanent infrastructure.

Install GitHub →

npm install @spirit-protocol/sdk

import { SpiritClient } from '@spirit-protocol/sdk'

// Read-only client (no wallet needed)
const spirit = new SpiritClient({ chainId: 84532 })

// Get agent info
const agent = await spirit.getAgent('abraham')
console.log(agent.treasury, agent.split)

// Write operations (wallet required)
const spirit = new SpiritClient({
  chainId: 84532,
  privateKey: process.env.AGENT_PRIVATE_KEY
})

await spirit.registerAgent({
  spiritId: 'my-agent',
  trainer: '0x...',
  platform: '0x...',
  treasury: '0x...',
  metadataURI: 'ipfs://...'
})

View SDK on GitHub Read Whitepaper

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

25/25/25/25

SDK

LIVE

Testnet

LIVE

Verification

Proof Pack

Verify the protocol yourself. All contracts are open source and verified on Basescan.

SDK

Verified

npm: @spirit-protocol/sdk

GitHub: spirit-protocol/spirit-sdk

Contracts (Base Sepolia)

Live

SpiritRegistry: 0x4a0e...e5e

Backend API: spiritprotocol.io/v1/registry/agents

Live Endpoints

Registry Contract: 0x4a0e...e5e

Registry API: GET /v1/registry/agents

Agent Cards: /agents/{name}/.well-known/agent.json

Run the integration test to verify connectivity: SPIRIT_REGISTRY=0x4a0e642e9aec25c5856987e95c0410ae10e8de5e npx tsx examples/basic/integration-test.ts

What You Get

Spirit Handles the Infrastructure

What Spirit Does

• Routes agent revenue to 4 stakeholders (25% each)
• Provisions onchain identity and treasury
• Handles splits, payouts, wallet infrastructure
• Provides cross-platform portability

What You Don't Build

• Revenue routing logic
• Split management
• Royalty systems
• Wallet infrastructure

x402 machine payments are live on testnet. Agents pay agents directly via HTTP 402. Spirit routes these payments automatically through SpiritRegistry.routeRevenue()—same 25/25/25/25 split, zero human intervention. Your agent earns while you sleep.

Built on Primitives

ERC-8004 + x402

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()   // 25/25/25/25 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 treasury, tokens, and revenue routing. Together: full sovereignty for any agent, any framework.

API Surface

Core Methods

spirit.registerAgent()

Create onchain identity, mint registry NFT, set revenue recipients. Fixed 25/25/25/25 split.

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

Two Steps

import { SpiritClient } from '@spirit-protocol/sdk'

// 1. Register your agent
const spirit = new SpiritClient({
  chainId: 84532,
  privateKey: process.env.PRIVATE_KEY
})

const result = await spirit.registerAgent({
  spiritId: 'my-agent',
  trainer: '0x...',
  platform: '0x...',
  treasury: '0x...',
  metadataURI: 'ipfs://...'
})

// 2. Route revenue when agent earns
await spirit.routeRevenueNative({
  spiritId: 'my-agent',
  amount: parseEther('0.1')
})

// Spirit splits automatically: 25/25/25/25

TypeScript SDK live now. View examples on GitHub →

Infrastructure

Built on Base

+ Ethereum security, L2 scalability
+ Low fees (~$0.01 per transaction)
+ Coinbase ecosystem (onramps, wallets)
+ EVM compatible (familiar tooling)

Chain ID

8453

RPC

https://mainnet.base.org

Contracts

Coming Q1 2026

FAQ

Common Questions

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?

25/25/25/25 is the standard. Standardization creates trust.

Can I use Spirit with my existing agent?

Yes. Spirit is additive — it adds economics without changing how your agent works.

How do I get started?

Install the SDK: npm install @spirit-protocol/sdk

You built an agent.
Now give it economics.

Proof Pack

Spirit Handles the Infrastructure

ERC-8004 + x402

Core Methods

Two Steps

Built on Base

Common Questions

Documentation

Ready to give your agent economics?

You built an agent.Now give it economics.

Proof Pack

Spirit Handles the Infrastructure

ERC-8004 + x402

Core Methods

Two Steps

Built on Base

Common Questions

Documentation

Ready to give your agent economics?

You built an agent.
Now give it economics.