Specimen (ERC-721)
Registers an existing ERC-20 as a type card.
token address pair address contenthash bytes32 templateId uint32 parentId uint256 bornBlock uint64
Settlement layer · type specimens
One card per
canonical object.
A registry of primary specimens on Ethereum L1. Identity and lineage live in contract state. Everything else is decoration.
00 · pepe sees the stack
.--.
|o_o | pepe: "where is truth"
|:_/ |
// \ \
(| | )
/'\_ _/`\
\___)=(___/
|
v
┌───────────────────┐
│ website / ui │ ← feels
│ (not canon) │
└─────────┬─────────┘
│ reads
v
┌───────────────────┐
│ L1 Lectotype │ ← IS canon
│ ERC-721 specimen │
│ + events │
└─────────┬─────────┘
│ points at
v
┌───────────────────┐
│ existing ERC-20 │
│ + Uni pair │
└───────────────────┘
pepe rule: if not on L1, it didn't happen
01 · Doctrine
- If it is not in L1 state or events, it is not canon.
- No strings in storage — only
bytes32contenthashes. - No AMM. No launcher. Pairs are pointers, not products.
- One specimen per token address. Parent edge optional.
02 · register flow (pepe path)
pepe finds token on L1
|
v
┌────────────────────┐
│ does Uni pair exist│
│ + liq floor ok? │
└─────────┬──────────┘
no / \ yes
/ \
v v
┌────────┐ ┌─────────────────┐
│ sad │ │ post bond │
│ pepe │ │ register(...) │
│ exit │ │ mint specimen │
└────────┘ └────────┬────────┘
|
v
┌─────────────────┐
│ challenge window│
│ (N days) │
└────────┬────────┘
/ \
nobody someone
disputes disputes
| |
v v
┌────────────┐ ┌─────────────┐
│ bond back │ │ arb writes │
│ card final │ │ winning │
│ │ │ contenthash │
└────────────┘ └─────────────┘
rare pepe: one specimen per token. forever.
03 · On-chain shape
Templates
Archetype IDs. Thin enum, not lore.
id → labelHash permissionless or gated
Relations
Genealogy as state + events.
Forked(child, parent) Migrated(from, to) parentId on specimen
Caught (later)
Proof of historical balance → stamp.
storage / Merkle proof verify on L1 soulbound or 1155
04 · lineage brain (big brain pepe)
┌──────────┐
│ template │
│ #0001 │
└────┬─────┘
│
┌────────────┼────────────┐
v v v
┌──────────┐ ┌──────────┐ ┌──────────┐
│ specimen │ │ specimen │ │ specimen │
│ α │ │ β │ │ γ │
│ parent:0 │ │ parent:α │ │ parent:α │
└────┬─────┘ └──────────┘ └──────────┘
│
v
┌──────────┐
│ specimen │
│ δ │
│ parent:α │ ← fork / rename / migrate
└──────────┘
galactus pepe: the graph IS the product
chart sites decorate. we own the edges.
05 · Anti-spam
Permissionless mint without friction fills the shelf with noise. Draft gate:
- Bond — posted at register; returned if unchallenged after N days.
- Liquidity floor — primary pair must clear a minimum at register time.
- Challenge window — contested
contenthash/ parent / template can be disputed; winner written back on L1.
spam pepe ──post──► [register]
|
liq too smol?
/ \
yes no
| |
v v
REVERT bond locked
|
wait N days
|
challenged?
/ \
yes no
| |
v v
resolve bond → pepe
on L1 card stays
06 · Cost posture
Expect roughly 200–400k gas per register. Pack structs. Fat events for indexers; skinny SSTORE. Multicall for curator backfill of historical specimens. Immutable v1 preferred; if upgradeable, UUPS + timelock.
┌─────────────────────────────────────┐
│ fat EVENT logs cheap to emit │
│ skinny SSTORE expensive, rare │
│ bytes32 only no strings fren │
│ multicall backfill curator pays │
└─────────────────────────────────────┘
|
v
pepe pays gas once → canon forever
07 · Ship ladder
- Specimen NFT + one-per-token + contenthash + parentId
- Curator-funded backfill of the historical set (so the shelf isn’t empty)
- Permissionless register with bond + liquidity floor
- Read-only explorer (state + logs only)
- Caught proofs, if collection gameplay is wanted
[1 NFT] → [2 backfill] → [3 open mint]
|
v
[4 explorer]
|
v
[5 caught?]
apu: "we ship when pepe can read a card on-chain"
08 · Explicit non-goals
- Basket / index token
- Off-chain “source of truth” with a decorative registry
- Trading UI, bonding curves, launch pads
- Discoverable public name in this draft
┌─────────┐ ┌─────────┐ ┌─────────┐
│ basket │ │ launch │ │ trade │
│ token │ │ pad │ │ ui │
└────┬────┘ └────┬────┘ └────┬────┘
│ │ │
└───────────────┴───────────────┘
|
v
NO. (clueless pepe leaves)