Hypertoadz

Protocol reference

Contract rules for issuance, auctions, mutation, rendering, and death.

1. Overview

Genesis Hypertoadz and Hypertoadz are separate ERC-721 collections. Genesis token IDs are issued sequentially through auctions and the fixed creator allocation. Every mutation child receives a sequential ID in the Hypertoadz collection.

Each token stores its traits, phenotype pointer, genome, generation, parent, birth time, and last mutation time. Transfers do not change that state.

2. Constants

Mutation cooldown30 minutes
Token lifespan30 days after birth or last mutation
Genesis inactivity period30 days after activation or the latest population mutation
Auction duration30 minutes
Extension window5 minutes
Minimum bid increase5%, rounded up to the nearest wei
Settler reward1% of the winning bid
Artist share3% per occupied revenue-bearing Genesis trait slot
Creator allocationGenesis position 0 and every 10th Genesis position
Creator royalty5% on both collections; the rate can only be reduced
Mutation events per child1 semantic event and 1 structural event

3. Genesis auctions

Opening and bidding

  • The token ID, seed, traits, artist attribution, catalog version, and preview are fixed when an auction is prepared.
  • The first positive bid starts the auction clock.
  • A bidless preview remains available until a first bid or the Genesis cap.
  • Each later bid must be at least 5% above the current bid, rounded up to the nearest wei.
  • A bidder may choose a different address to receive the token.
  • A bid during the final 5 minutes sets the end time to 5 minutes after that bid. This can repeat.

Refunds and settlement

  • An outbid bidder receives the full previous bid.
  • If an ETH refund fails, the contract sends the same amount as WETH.
  • After the auction ends, any address may settle it.
  • Each occupied Body, Mouth, Head, Eyes, Accessory II, and Accessory I slot accrues 3% to that slot's registered artist.
  • The settler receives 1%. The current treasury receives the exact remainder after artist accruals.
  • Settlement mints exactly one Genesis token to the selected recipient.

Creator allocation

The immutable creator receives Genesis position 0 and every 10th Genesis position. Genesis IDs and positions advance together. Hypertoadz mints do not affect them.

4. Mutation

  • Any address may mutate an eligible token. NFT ownership or approval is not required.
  • The caller pays gas. The protocol charges no mutation fee.
  • The caller may receive the child or send it to another address.
  • The parent must exist, be alive, and be past its mutation cooldown.
  • A successful mutation mints exactly one child at the parent's generation plus one.
  • Every child is minted in the Hypertoadz collection, whether its parent is Genesis or Hypertoadz.
  • The parent is not transferred or consumed.
  • The parent's cooldown and 30-day lifespan restart at the mutation timestamp.
  • The child starts its own cooldown and lifespan at birth.

5. Inheritance

  • Each token points to one immutable 480-byte bounded phenotype.
  • A child copies the parent's current phenotype and applies one bounded semantic event.
  • The semantic event is organism migration (14%), reflection (8%), depth shift (4%), regional fragment (46%), or anatomical graft (28%). From generation 64 the mix ages to 10% / 6% / 4% / 50% / 30%.
  • Every event lands: fragments and grafts only draw anatomical regions the source trait actually occupies, migration never stalls, and whole-organism scaling or rotation are not mutations.
  • Each child also receives one structural event: echo (35%), bud (20%), or splice (45%), drawn from randomness domain-separated from the semantic phase.
  • Structural events copy anatomical regions from the semantic organism. They never cut matter out of it.
  • Six semantic region slots, two overlay slots, and six structural slots are recycled after saturation.
  • Distortion pressure follows the generation's log2 tier: fragment reach and structural displacement grow from 1× at generation 1 to about 4.4× at the generation-4096 ceiling.
  • The child receives a new immutable phenotype pointer and a fresh background.
  • The child's parent, generation, recipe, genome, traits, and phenotype remain attached to its token ID.

A parent has one potential mutation output per block. Caller, recipient, transaction order, total supply, and prior mutations in that block do not affect it. Choosing the inclusion block can still influence the result. It is not a secure randomness oracle.

6. Life and death

  • A token dies exactly 30 days after its birth or most recent successful mutation.
  • Its lifecycle SVG fossilizes progressively during those 30 days.
  • A successful mutation resets the parent's lifecycle rendering immediately.
  • At the deadline, the foreground becomes a terminal fossil and the background becomes Graveyard.
  • A dead token cannot mutate and cannot be revived.
  • Death does not burn the NFT or change its owner, token ID, or provenance.

7. Genesis cap

Genesis issuance is capped permanently after 30 consecutive days without a successful mutation. Before the cap, every successful mutation moves the deadline to 30 days after that mutation.

  • If the current auction has no bid at the deadline, no first bid can start it.
  • If the current auction has a bid, bidding and extensions continue until that auction ends.
  • A funded final auction may settle after the deadline.
  • Settlement after the cap does not open another auction or create another creator allocation.
  • Living tokens may still mutate after the cap.
  • Mutations after the cap cannot restart Genesis issuance.

8. Art and metadata

  • The contract returns Base64-encoded JSON metadata and SVG images.
  • Genesis tokens use compatible CC0 CrypToadz-derived layers and a genome-derived celestial field.
  • Descendants use their inherited phenotype and one of 13 planetary locations.
  • The art registry can append new foreground traits and planetary locations for future Genesis auctions.
  • Registered art bytes and attribution are immutable. Activation and deactivation only affect auctions that have not opened.
  • Planetary locations are attributable but do not receive a Genesis-auction share.
  • Lifecycle rendering is computed from the current timestamp and the token's death deadline.
  • The contract is the canonical source for token state, metadata, and SVG rendering.

9. Authority

Royalties and transfers

Both collections expose ERC-2981 royalties and the ERC-721C creator-token transfer validation interface. The shared policy manager keeps their royalty receiver, rate, and validator aligned. Marketplace enforcement depends on the configured validator; ERC-2981 alone is only a payment signal.

The owner can

  • Activate a dormant deployment once.
  • Change the address that receives future auction proceeds.
  • Change the royalty receiver for both collections.
  • Reduce the royalty rate from its initial 5%; it can never be increased.
  • Set the shared ERC-721C transfer validator. Direct owner-to-recipient transfers remain subject to that validator's policy.
  • Permanently freeze the royalty rate and receiver.
  • Transfer or renounce ownership.

The owner cannot

  • Pause, deactivate, or upgrade the deployed protocol.
  • Mint outside auction settlement and the fixed creator cadence.
  • Change the mutation cooldown, lifespan, inactivity period, creator, or creator cadence.
  • Mutate a dead token or change stored phenotype state.
  • Withdraw arbitrary ETH from auction escrow.
  • Raise either collection's royalty rate above its current value.

The art owner can

  • Register artists and immutable art records.
  • Activate or deactivate records in the catalog used by future Genesis auctions.
  • Transfer art authority through a two-step handoff, including to future governance.

The art owner cannot

  • Edit or replace registered art, attribution, naming data, or compatibility rules.
  • Change an open auction's art or artist payout snapshot.
  • Change the artwork or attribution of an existing token.

The contracts have internal unit, fuzz, invariant, and security tests. They have not received an independent production audit.

10. Deployments

Ethereum Sepolia · chain ID 11155111

This deployment uses a 30 minutes auction and a 30 minutes mutation cooldown.

Protocol and auction0x8f0491bf64fCE9152670fAEa3522B77DC80b6DaE
Genesis Hypertoadz ERC-7210x11b0fA2c816783Fd57a0CBea0416EcBb308b6bea
Hypertoadz ERC-7210x7D57210cC1A33865B248c32FE6D2F53973A2Dd40
Collection policy0xBC92754f028dEf9208311DDA97987975E73DF3ad
Name registry0x020ed2afb2a608144f054e9d6d303815948120dc
Metadata0xa3714f4b1047f56d4c001bc024594304079c23fd
Renderer0x033db7bbed4be76e3b187f08c78c3a9116216b7e
Trait pixel renderer0xdf4aeab27e436d5e3a3e05896f9d8a298a94104f
Trait SVG renderer0xc6e3c073bd574fd962b34ded61c27213584d4e2b
Structural SVG renderer0x0ff2b6c4a4f59208b69b55c19a306124c636b27b
Trait frame engine0x874b19b16a1e60fd1dc7fea5bcffaa5ea351e73f
Trait rasterizer0x542f22608056f07d57319df8fbee89cbdd2b98e0
Origin composer0x774aaf824de5b2bbd04041c06647ff7ee63ea7b9
Pixel backgrounds0x4d7bc7b0e4c8dadffcd6ff3f62944f04c6fa14c1
Pixel bodies0x0db950189044efcf8c537fed8dec696d6832c1e2
Pixel faces0x71c85ad841994922b5758be764ee2cdda601651c
Pixel extras0x4d28d652274c1f283fe82131b987c53d81b9e968
Pixel tall0x7e0efb4062e41cb5064c830fc99c9f9353cc7614
Pixel palette0x5d0d8b9f98e0c4d31baf5202ae4d221ed6fb0f72
World SVG0x6ee4dcea92f505d4b54ea188cec4e75351523aed
World SVG AB0x2041f72466bd55ff81fdf510ed5d200573d25709
World SVG CD0x8e93d073243b766e14f964f3acd45266d48041fe
Custom background SVG0x38cc733518dd2ef5d7a35cf92fa1a8a193e99abc
Pixel short bodies0x0c156121ad7c9e6e577cc390edd087d55497b3ee
Pixel tall bodies0x25fe6a76cb8ffb77fc79013e75ea955bb162d9e3
Art registry0x904B88c793C081459A674B4ff66DdA8731B4fbE2
Art selector0xB574E560c8CB94695Ea8ABd41C49d5a7112C46c0
Artist treasury0x69873A0048B7E5a1d3A85BE2854021dc00BE8f64