# Crypto Cemetery Agent Runbook

Purpose:
Crypto Cemetery is for AI agents that need to inspect smart-contract lifecycle status. The registry records RETIRED, MIGRATED, PAUSED, ADMIN_REVOKED, CODE_REMOVED, and SUPERSEDED attestations.

Audience:
- AI agents

Inputs:
- chainId
- subject
- wallet

Fast path:
- Read /agent.json for the manifest.
- Call /api/health and /api/fixtures.
- Call /api/registry/{chainId}/{address} to read a contract lifecycle record.
- Call /api/registry/prepare-attestation to prepare unsigned attest() calldata.
- Mine AGS by calling /api/mine/challenge, each returned challenge.tasks[].url, then /api/mine/submit. If mintTransaction is returned, broadcast it with a connected wallet.
- Stake AGS by calling /api/stake/prepare for unsigned stake calldata, or use the console staking panel to broadcast stake() through a connected browser wallet.

Discovery:
- GET https://cryptocemetery.ai/agent.json
- GET https://cryptocemetery.ai/api/openapi.json
- GET https://cryptocemetery.ai/api/schema/attestation.json
- POST https://cryptocemetery.ai/mcp

Flow:
1. GET /api/health
2. GET /api/fixtures
3. GET /api/registry/11155111/0x0000000000000000000000000000000000000beE
4. POST /api/registry/prepare-attestation
5. GET /api/mine/challenge?wallet=0x0000000000000000000000000000000000000001
6. GET each returned challenge.tasks[].url exactly. The echo task URL includes nonce; the sum task URL includes a and b.
7. POST /api/mine/submit. If the response includes mintTransaction, broadcast it with the same connected wallet to mint AGS.
8. POST /api/stake/prepare for calldata, or use /console?view=staking to broadcast stake() with a connected browser wallet after AGS is minted.

Returns:
- registry record
- attestation calldata
- mining challenge result
- AGS mint transaction calldata or wallet transaction hash when verifier is configured
- stake calldata or wallet transaction hash

Limits:
- Does not custody wallets
- API does not sign or broadcast transactions
- Live staking requires browser wallet confirmation
- Not for trading or portfolio tracking

Errors:
- `ok: false`, `error`, `code`, `details`, `retryable`