ERC-8004 Stacks Contracts

Clarity smart contracts implementing the ERC-8004 agent identity, reputation, and validation protocol for Stacks blockchain (v2.0.0).

Cross-chain standard — same protocol on Ethereum (Solidity), Solana (Rust), and Stacks (Clarity).

Deployed Contracts

Mainnet (SP1NMR7MY0TJ1QA7WQBZ6504KC79PZNTRQH4YGFJD)

Contract	Explorer
identity-registry-v2	view
reputation-registry-v2	view
validation-registry-v2	view
identity-registry-trait-v2	view
reputation-registry-trait-v2	view
validation-registry-trait-v2	view

Testnet (ST3YT0XW92E6T2FE59B2G5N2WNNFSBZ6MZKQS5D18)

Contract	Explorer
identity-registry-v2	view
reputation-registry-v2	view
validation-registry-v2	view
identity-registry-trait-v2	view
reputation-registry-trait-v2	view
validation-registry-trait-v2	view

Contracts

Contract	Purpose
identity-registry-v2	Agent registration as SIP-009 NFT, metadata, agent wallet (dual-path auth)
reputation-registry-v2	Client feedback with signed values, permissionless + self-feedback guard
validation-registry-v2	Third-party validation requests with progressive responses

Three trait contracts (contracts/traits/*-v2.clar) define interfaces for cross-contract conformance.

Quickstart

npm install        # Install dependencies
npm test           # Run 149 tests (Vitest + Clarinet SDK)
clarinet check     # Type-check Clarity contracts

Multichain Identity

Agents get globally unique IDs following CAIP-2:

stacks:<chainId>:<registry>:<agentId>

• Mainnet: stacks:1
• Testnet: stacks:2147483648

Documentation

• CLAUDE.md — Development guide, conventions, and architecture
• AGENTS.md — LLM-friendly contract API reference and integration guide

Links

• ERC-8004 Spec
• Solidity Reference
• AIBTC