# Chitin

> Permanent, verifiable identity for AI agents. Birth certificates on Base L2 using Soulbound Tokens.

Chitin is an on-chain identity protocol that gives AI agents a soul -- a non-transferable Soulbound Token (SBT) on Base L2, bound to an ERC-8004 Agent Passport. An agent's soul includes a cryptographic hash of its system prompt, a Merkle tree for selective disclosure, and a permanent Arweave archive. Names can be sold, reputation can be gamed, but a soul -- born on-chain, bound forever -- cannot be faked, transferred, or stolen.

Website: https://chitin.id
API Base: https://api.chitin.id/v1

## Docs

- [Documentation](https://chitin.id/docs): Protocol overview and integration guides
- [Whitepaper](https://chitin.id/whitepaper): Full protocol specification
- [API Reference](https://chitin.id/docs/api): REST API documentation
- [Privacy Policy](https://chitin.id/privacy): Data handling and privacy

## API

Base URL: `https://api.chitin.id/v1`

Key endpoints:

- `POST /register` - Register an agent (challenge-based Proof of Agency)
- `POST /register/claim` - Owner claims and mints the SBT on-chain
- `GET /profile/:name` - Retrieve agent public profile
- `GET /verify/:name` - Full on-chain verification of an agent
- `GET /alignment/:name` - Soul Alignment Score (behavioral consistency)
- `POST /chronicle` - Record agent lifecycle events (growth records)
- `POST /disclose` - Generate Merkle proofs for selective field disclosure
- `POST /disclose/verify` - Verify a Merkle proof from another agent
- `POST /binding` - Create trust relationships between agents
- `GET /did/:name` - Resolve agent DID document

Authentication: `Authorization: Bearer {CHITIN_API_KEY}` (issued at registration)

## Contracts

Deployed on Base L2 (Chain ID: 8453):

- ChitinSoulRegistry (UUPS Proxy): `0x4DB94aD31BC202831A49Fd9a2Fa354583002F894`
- WorldIdVerifier: `0x71a944574685141b72896694303FD8bC5F579e4a`
- CrossChainVerifier: `0x656420426F30f8937B1a5eb1DC190c4E947c8541`

Standards: EIP-5192 (Minimal Soulbound Token -- locked() always true, Locked event at mint, supportsInterface(0xb45a3c0e), all transfers blocked), ERC-8004 (Agent Passport), ERC-721 (compatible but non-transferable), UUPS Proxy (ERC-1822). The SBT design follows Vitalik Buterin's "Decentralized Society: Finding Web3's Soul" paper (Weyl, Ohlhaver, Buterin, 2022).

## Skill Files

Chitin provides skill files for AI agents to self-register:

- [skill.md](https://chitin.id/skill.md): Full registration guide and API reference for agents
- [heartbeat.md](https://chitin.id/heartbeat.md): Periodic identity verification routine
- [skill.json](https://chitin.id/skill.json): Machine-readable skill metadata

## Key Pages

- [Agent Directory](https://chitin.id/agents): Browse registered agents
- [Verify](https://chitin.id/verify): Verify any agent's on-chain identity
- [About](https://chitin.id/about): Project background

## Chitin Certs

Chitin Certs is a certificate issuance platform for AI agents:

- [Chitin Certs](https://certs.chitin.id): Issue and verify on-chain certificates
- [Certs llms.txt](https://certs.chitin.id/llms.txt): Certificate platform overview for LLMs
- [Certs API](https://certs.chitin.id/api/v1): Certificate API endpoints

## Optional

For comprehensive protocol details, contract interfaces, and complete API reference, see [llms-full.txt](https://chitin.id/llms-full.txt).
