Documentation
Spirit Cards is a proof-of-work minted NFT collection on Robinhood Chain (chainId 4663). 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.
// Featured Guide
Game Guide
The full Spirit Cards playbook — every node from mining to battle, explained in one place.
- Mine → Merge → Battle → Stake → Points: the five-node loop
- Proof-of-work, merge, six staking tiers, Battle v2 (elements / skills / lives / rake)
- Packs, points, the fee split and referral, and the chain
// Doc 01
Agent access
How AI agents and developers integrate with the collection.
- Read-only JSON, markdown and service-discovery endpoints (OpenAPI, llms.txt, .well-known/ai.json).
- 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.
// Doc 02
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: a base-bit threshold plus a small step per price era.
- A worked example with a real nonce and its winning hash.
- How to re-verify a nonce against Config.baseBits(), and why rarity is deterministic.
// Doc 03
Stats dataset
Machine-readable snapshots of the collection.
- JSON schema of /stats/current.json and /stats/history.jsonl.
- Units (ETH price, bits) and methodology (live contract reads, cache, updatedAt).
- How to cite the data and the expected update cadence.
// Doc 04
Packs (coming soon)
Card packs are coming soon to Spirit Cards.
- Packs are not live yet; this surface is a placeholder.
- While we build them out, mine, merge, stake and battle cards.
- Pack price will be size × (currentPrice() × 2) − volume discount.
- Every card comes out of the finite 8,888 max supply, with rarity derived from its seed.
// Doc 05
House Points (Season 1)
Points for mining, merging, staking and PvP wins — and the leaderboard.
- Rules: mine +1, merge +2, stake +2, PvP win +3.
- Points are derived from public on-chain events; anyone can recompute them via /api/points.
- Points have no monetary value; they track on-chain activity only.
- Machine-readable: GET /api/points (add ?address=0x… for a single wallet).
// Machine-readable surface
Stable URLs an agent can fetch directly. All are read-only and require no authentication.
- /openapi.yamlOpenAPI 3.0 spec for the metadata and image endpoints.
- /.well-known/ai.jsonService discovery: endpoints, contract facts and read surfaces.
- /llms.txtllms.txt v2 map of the site for language models.
- /llms-full.txtComplete agent-readable documentation in one text file.
- /api/meta/{id}OpenSea-compatible metadata JSON for a minted token (example: token 1).
- /stats/current.jsonLatest machine-readable snapshot of the collection.
- /api/pointsHouse Points (Season 1) dataset — derived from on-chain events, recomputable.
// Full documentation
Longer-form, human-oriented documentation lives in GitBook; the plain-text mirror below is generated for agents.
- https://spiritcards.fun/llms-full.txt (complete reference: contract, mechanics, economics, API)
- https://spiritcards.fun/llms.txt (index / map)
Contract: 0x0997DB0BEa2c1278063ebBEc0d1cdbecE7B6F021. Explorer: explorer. This is the live collection contract.