spoon-erc8004-standard - SKILL.md Agent Skill

name: spoon-erc8004-standard description: Implement ERC-8004 trustless agent identity. Use when registering agents on-chain, managing reputation, handling validation, or generating DID documents.

ERC-8004 Standard

Implement trustless on-chain agent identity with ERC-8004.

Overview

ERC-8004 provides:

On-chain agent registration
Decentralized identity (DID)
Reputation tracking
Validation mechanisms

Quick Start

from spoon_ai.identity.erc8004_client import ERC8004Client

client = ERC8004Client(
    rpc_url="https://testnet.rpc.banelabs.org",
    agent_registry_address="0x...",
    identity_registry_address="0x...",
    reputation_registry_address="0x...",
    validation_registry_address="0x...",
    private_key=os.getenv("PRIVATE_KEY")
)

# Register agent
tx_hash = client.register_agent(
    did="did:spoon:agent123",
    agent_card_uri="https://storage.example.com/card.json",
    did_doc_uri="https://storage.example.com/did.json"
)

Scripts

Script	Purpose
register_agent.py	Agent registration
resolve_agent.py	DID resolution
update_reputation.py	Reputation management
generate_did.py	DID document generation

References

Reference	Content
contracts.md	Contract addresses
did_format.md	DID document format

Contract Addresses (NeoX Testnet)

Contract	Address
AgentRegistry	`0xaB5623F3DD66f2a52027FA06007C78c7b0E63508`
IdentityRegistry	`0x8bb086D12659D6e2c7220b07152255d10b2fB049`
ReputationRegistry	`0x18A9240c99c7283d9332B738f9C6972b5B59aEc2`

Best Practices

Store agent cards on IPFS/Arweave
Use EIP-712 signatures for registration
Monitor reputation changes
Implement validation before transactions