Hypertoadz

Protocol reference

Rules for auctions, mutation, lifecycle, ownership, and deployed contracts.

1. Overview

Genesis Hypertoadz and Hypertoadz are separate ERC-721 collections. Genesis token IDs are created through auctions or the fixed creator allocation. Each mutation creates one sequential Hypertoadz ID.

Each token stores its traits, phenotype pointer, genome, generation, parent, birth time, and latest mutation time. Transfers do not alter this state.

2. Constants

Mutation cooldown1 day
Token lifespan30 days after birth or last mutation
Genesis inactivity period30 days after activation or the latest population mutation
Auction duration1 day
Extension window5 minutes
Minimum bid increase5%, rounded up to the nearest wei
Settler rewardConfigurable from 0% to 1% of the winning bid; initially 1%
Artist share3% per occupied revenue-bearing Genesis trait slot
Creator allocationGenesis position 0 and every 10th Genesis position
Creator royalty5% on both collections; optional for Genesis and enforced for Hypertoadz
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 the first bid or the Genesis cap.

Each later bid must be at least 5% above the current bid, rounded up to the nearest wei. The bidder may choose another recipient. A bid during the final 5 minutes moves the end time to 5 minutes after that bid. Extensions can repeat.

Refunds and settlement

An outbid bidder receives the full previous bid. If the ETH refund fails, the contract sends the same amount as WETH. After the auction ends, any address may settle it. Settlement mints one Genesis token to the selected recipient.

Each occupied Body, Mouth, Head, Eyes, Accessory II, and Accessory I slot accrues 3% to its registered artist. The settler receives the configured reward, capped at 1%. The treasury receives the remainder.

Creator allocation

The configured creator recipient receives Genesis position 0 and every 10th Genesis position. The protocol owner may redirect future allocations. Existing NFTs are unaffected. Hypertoadz mints do not affect Genesis positions.

4. Mutation

Early access allowlist

Early access applies until either the first 14 days after activation have elapsed or Hypertoadz #10,000 is the next child to mint, whichever happens first. During this period, the initiating wallet must be on the active allowlist and have unused quota. The initial limit is three mutations per wallet.

The website finds the connected wallet's Merkle proof and submits the claim and mutation in one transaction. The child may be sent to another recipient, including cold storage or a smart account.

During early access, the policy owner may replace the Merkle root or set another nonzero wallet limit. A new root requires a new proof, but mutations already consumed by a wallet never reset. The published address list and proof manifest make the tree reproducible.

Mutation rules

After early access, any address may mutate an eligible token. NFT ownership or approval is not required. The caller pays gas, and the protocol charges no mutation fee. The child may be sent to any recipient.

The parent must exist, be alive, and have completed its cooldown. A successful mutation mints one child in the Hypertoadz collection at the parent's generation plus one. The parent remains with its owner. Its cooldown and lifespan restart, while the child begins its own cooldown and lifespan at birth.

5. Life and death

A token dies 30 days after birth or its latest successful mutation. Its SVG fossilizes during this period. A successful mutation resets the parent's lifecycle immediately.

At death, the foreground becomes a terminal fossil and the background becomes Graveyard. A dead token cannot mutate or revive. Death does not burn the NFT or alter its owner, token ID, or provenance.

6. 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.

At the deadline, a bidless auction cannot start. A funded auction may finish its bidding extensions and settle, but settlement will not open another auction or create another creator allocation. Living tokens may still mutate after the cap. Later mutations cannot restart Genesis issuance.

7. Art and metadata

The contracts return Base64-encoded JSON metadata and SVG images. Genesis tokens use compatible CC0 CrypToadz-derived layers and a genome-derived celestial field. Descendants use inherited phenotypes and one of 13 planetary locations. Lifecycle rendering uses the current timestamp and death deadline.

The art registry may add traits and locations for future auctions. Registered art, attribution, naming data, and compatibility rules are immutable. Activation changes only unopened auctions. Planetary locations are attributed but do not receive an auction share. The contracts remain the source of record for token state, metadata, and rendering.

8. Authority

Royalties and transfers

Both collections expose ERC-2981 royalties and the ERC-721C creator-token transfer validation interface. Both currently signal a 5% royalty to the same receiver. Genesis uses permissive transfer rules, so its royalty is optional. Hypertoadz uses an enforcing ruleset. ERC-2981 alone is only a payment signal.

Protocol owner

The protocol owner can activate once, update future treasury and creator recipients, update the shared royalty receiver, reduce the shared royalty rate, configure transfer validation, and freeze royalty settings permanently. During early access, the owner may replace the Merkle root or set another nonzero wallet limit. Ownership transfers through a two-step handoff and cannot be renounced.

The owner cannot pause, deactivate, or upgrade the protocol; mint outside settlement and the creator cadence; change lifecycle constants; redirect existing NFTs; mutate dead tokens; alter stored phenotypes; withdraw arbitrary escrowed ETH; or raise the royalty rate.

Art owner

The art owner can register artists and immutable art records, activate or deactivate records for future auctions, and transfer authority through a two-step handoff. The art owner cannot edit registered material, change an open auction's art or payout snapshot, or alter an existing token.

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

9. Deployments

Ethereum · chain ID 1

This deployment uses a 1 day auction and a 1 day mutation cooldown.