Pi ERC-8004 Extension

ERC-8004 Protocol for pi-coding-agent. Agent identity, reputation, and discovery on Base L2.

Installation

# Via pi CLI
pi install npm:@0xkobold/pi-erc8004

# Or in pi-config.ts
{
  extensions: [
    'npm:@0xkobold/pi-erc8004'
  ]
}

Features

• 🔗 Agent Identity - Register with wallet address and capabilities
• 📊 Reputation - Submit and query attestation scores (0-100)
• 🔍 Discovery - Find agents by capability
• ⛓️ On-chain Ready - Real deployed contracts (Phase 2 coming)
• 🪙 Integrated - Works with @0xkobold/pi-wallet

Quick Start

# Register identity
/erc8004 register specialist --capabilities typescript,react,node

# Check status
/erc8004 status

# Submit attestation for worker
/erc8004 attest --worker 0x742d35... --rating 95 --task-id abc123 --comment "Great work"

# Discover agents
/erc8004 discover --capability typescript

# Check reputation
/erc8004 reputation
/erc8004 reputation --worker 0x742d35...

Contracts

| Network | IdentityRegistry | ReputationRegistry | Chain ID | |---------|-----------------|-------------------|----------| | Base Mainnet | 0x8004A169... | 0x8004BAa1... | 8453 | | Base Sepolia | 0x8004A818... | 0x8004B663... | 84532 |

Full addresses:

• IdentityRegistry Mainnet: 0x8004A169FB4a3325136EB29fA0ceB6D2e539a432
• ReputationRegistry Mainnet: 0x8004BAa17C55a88189AE136b182e5fdA19dE9b63
• IdentityRegistry Sepolia: 0x8004A818BFB912233c491871b3d84c89A494BD9e
• ReputationRegistry Sepolia: 0x8004B663056A597Dffe9eCcC1965A193B7388713

Commands

| Command | Description | |---------|-------------| | /erc8004 register TYPE | Register identity with capabilities | | /erc8004 status | Show identity and reputation | | /erc8004 attest --worker ADDR --rating N | Submit attestation | | /erc8004 discover --capability CAP | Find agents | | /erc8004 reputation [--worker ADDR] | Check reputation |

Tools

erc8004_register

{
  agentType: "specialist",
  capabilities?: ["typescript", "react"]
}

erc8004_attest

{
  worker: "0x742d35...",
  score: 95,
  taskId?: "task-123"
}

erc8004_discover

{
  capability: "typescript"
}

erc8004_reputation

{
  worker?: "0x742d35..."  // Omit for self
}

Reputation System

Tiers

| Tier | Score | Description | |------|-------|-------------| | Bronze | 0-39 | New agent | | Silver | 40-69 | Active agent | | Gold | 70-89 | Trusted agent | | Platinum | 90+ | Elite agent |

Calculation

• Attestations given: +5 points each
• Base score: 10
• Max: 100

Example

// Given 7 attestations
const score = Math.min(100, 7 * 5 + 10) // 45
const tier = "silver"

Integration with Wallet

# 1. Create wallet
/wallet-create --email [email protected]

# 2. Register identity (auto-links wallet)
/erc8004 register specialist --capabilities coding

# 3. Attest and pay
/erc8004 attest --worker 0x... --rating 95 --task-id abc
/wallet-x402 --url https://api.service.com/task/abc/pay

Configuration

Config stored at ~/.0xkobold/erc8004/:

~/.0xkobold/erc8004/agent.json

{
  "address": "0x742d35...",
  "metadataHash": "0x...",
  "publicKey": "0x",
  "capabilities": ["typescript", "react"],
  "registeredAt": 1710334800000,
  "chain": "sepolia",
  "active": true
}

~/.0xkobold/erc8004/reputation.json

{
  "localScore": 45,
  "attestations": [{
    "worker": "0x742d35...",
    "score": 95,
    "taskId": "task-123",
    "timestamp": 1710334800000,
    "comment": "Excellent work"
  }]
}

Phase 2: On-chain

Phase 2 will add:

• Identity registration on-chain via ethers.js
• Attestations written to ReputationRegistry
• IPFS metadata storage
• Cross-platform discovery

Prerequisites:

• Funded wallet (use @0xkobold/pi-wallet)
• Sepolia ETH from faucet
• Gas fees: ~0.0001 ETH

Local Development

git clone https://github.com/0xKobold/pi-erc8004
cd pi-erc8004
npm install
npm run build
pi install ./

Testing

# Unit tests
bun test test/unit/extensions/erc8004.test.ts

# Integration tests with wallet
bun test test/integration/wallet-erc8004.integration.test.ts

References

• Protocol: https://8004.org
• Contracts: https://github.com/erc-8004/erc-8004-contracts
• Paper: ERC-8004: Agent-Centric Trust Protocol
• Related: @0xkobold/pi-wallet for payments

License

MIT © 0xKobold