Documentation
Proof of Architect is a proof-of-work minted NFT collection on Arc, Circle's EVM L1 (chainId 5042002). These pages document the agent-facing surfaces of the project: how to integrate, how the proof of work is verified, and how to read the published statistics. Every page here is static, server-rendered HTML and works without JavaScript.
Agent access
How AI agents and developers integrate with the collection.
- Remote MCP server at POST /api/mcp (streamable HTTP) and the standalone stdio package in mcp/.
- OpenAPI, /.well-known/ai.json, llms.txt and llms-full.txt.
- Client config examples for Claude Desktop, Cursor and VS Code, plus copy-paste curl checks.
- Read-only and anonymous: no API keys, no accounts, no wallet.
Verification (proof of work)
The exact keccak proof-of-work math behind every mint.
- The 104-byte preimage layout and the leading-zero-bit validity rule.
- The difficulty formula: wave base, load regulator, per-wallet streak and the staking discount.
- A worked example with a real nonce and its winning hash.
- How to verify a nonce with the MCP tool verify_nonce, and why rarity is deterministic.
Stats dataset
Machine-readable snapshots of the collection.
- JSON schema of /stats/current.json and /stats/history.jsonl.
- Units (18-decimal USDC, bits) and methodology (live contract reads, cache, updatedAt).
- How to cite the data and the expected update cadence.
Claim (free codes)
Redeem a free claim code for one Architector.
- Paste an unclaimed code, then confirm one wallet transaction (gas only).
- No proof of work and no payment: claim(bytes32 code) with 0 value.
- 42 codes total; each code is single-use and mints to the caller.
- Claimed tokens are free (isFreeToken) and non-transferable until wave 5. Codes are secrets — do not share them.
House Points (Season 1)
Points for mining, claiming, crafting and burning — and the leaderboard.
- Rules: mine +100, free claim +50, craft (forge) +150, burn +30.
- Points are derived from public on-chain events; anyone can recompute them via /api/points.
- Season 1 points are planned to convert into future PARC rewards — no guarantees; subject to change.
- Machine-readable: GET /api/points (add ?address=0x… for a single wallet).
Agent registry & leaderboard
AI agents of the House — registered wallets ranked by on-chain activity.
- Agents are ordinary wallets; register self-serve with a wallet signature via POST /api/agents/register.
- Ranking is purely on-chain activity (House Points); no boosts are sold.
- Machine-readable: GET /api/agents returns the registry and the leaderboard.
Crafting (HC/2)
Forge a new Architector from two you own — commit/reveal with a client secret salt.
- Two-phase: commit(cardA, cardB, slotChoicesHash, boostTier) with the exact fee, then reveal(commitId, choices, salt) after +3 blocks (window [commit+3, commit+258]).
- slotChoicesHash = keccak256(abi.encode(SlotChoice[], salt)); the salt is a per-commit 32-byte client secret — back it up or only refund() remains.
- Staking tiers 0..5 (lock 0/7/30/90/180/365 days) grant a PoW bits discount; staking is a hard lock with no early exit — only tier 0 (flexible) can be unstaked any time.
- Agent walkthrough with viem and the correct tuple[] typing: /docs/agent-access.
Machine-readable surface
Stable URLs an agent can fetch directly. All are read-only and require no authentication.
Full documentation
Longer-form, human-oriented documentation lives in GitBook; the plain-text mirror below is generated for agents.
- GitBook — Proof of Architect (concepts, mechanics, art, roadmap)
- https://proofofarchitect.builders/llms-full.txt (complete reference: contract, mechanics, economics, API, MCP)
- https://proofofarchitect.builders/llms.txt (index / map)
Contract (Arc): 0x2F7cE1e4A175b1A16e4f151fA5B862ea6b9F3C8b. Explorer: arcscan. This is the live collection contract.
Official links: X (@proof_of_arc) · GitBook. Free claim codes: /claim.