DOCUMENTATION

How Bitborn actually works.

Every mechanic below is written, compiled, and tested before it ships. No promises without the code behind them.

"Built & tested" means exactly that: the code exists and has been verified. It goes live on-chain at launch, not before, and Season 2 mechanics go live with Season 2.

00

Network

Bitborn runs on Robinhood Chain mainnet.

4663
ETH
L2 Mainnet
RPCrpc.mainnet.chain.robinhood.com
Explorerrobinhoodchain.blockscout.com
01
Built & tested

The artwork

The whole collection was created for Bitborn, pixel by pixel. No borrowed base, no asset pack: every bloodline and every trait started from an empty grid.

Made from scratch

Nothing in Bitborn is borrowed. Plenty of on-chain pixel art starts from shared, freely reusable assets. This collection does not: it was built from an empty 30 by 30 grid.

Four original bloodlines

Human, Zombie, Ape and Alien were all created for Bitborn. They do not exist anywhere else.

Every trait made for this collection

All 293 layers were made specifically for Bitborn. Every bloodline-specific trait, every rare piece composition, was assembled here.

The system behind it

The rendering engine, the Genesis desaturation, the restoration system, the proof-of-work mining protocol. None of that came from anywhere else, and none of it exists in any other collection.

02
Built & tested

Mining

Bitborn is not minted, it is mined. No whitelist, no mint phases, no raffle. Every piece is found by real work your device performs, verifiable by anyone once it is done. Mining ends when the last piece is found, and at the latest after 60 days: what is not found by then will never exist.

Unlock mining once

A small, fixed, one-time amount per wallet: 0.0004 ETH. It does not stop anyone from joining, but it puts a real cost on multiplying accounts to bend the rules.

Mine without limit, without fee

Your browser or computer searches for a solution. It runs in the background, and progress stays visible the whole time, never a silent wait for a miracle.

Claim what you find

Each discovery has a price, set by how far the collection has come when you find it, never by who you are or how many wallets you have opened. From 0.0004 ETH for the first Bitborn to 0.0074 ETH for the 20,500th, never more.

Mining early costs less, because the risk taken is greater. As the collection advances and the project proves itself, the claim price follows, gradually and continuously, never in sharp steps that could be timed. The price always stays bounded: the last Bitborn will never cost a fortune. Bitborn is not a token: no buyback, nothing that depends on another asset's price to keep working. What you mine, you own.

03
Final

The collection & rarity

The collection is complete: every one of the 20,500 mineable pieces already exists, and no two share the same traits. The numbers below are final, nothing will be added. Rarity comes in layers: the kind of character, its background, then its traits.

20,317
100
50
18
15
500

Five kinds of mined Bitborn

Humans are the heart of the collection. Zombie, Ape and Alien are the rare bloodlines, drawn for Bitborn and found nowhere else: about one find in 205 is a Zombie, one in 410 an Ape, one in 1,139 an Alien. The 15 one-of-ones are single pieces made by hand: each exists once, hidden somewhere in the mining order. Genesis are apart: they are not mined but won, see Genesis.

Human20,317
Zombie100
Ape50
Alien18
1/115

Bitborn #1

The only piece with a fixed place. The very first Bitborn found is a Human in the Black Tuxedo, on a Checkerboard background, with a Scar III. Whoever mines first takes it home.

Skin

Every Human has one of four skins: Origin, Sand, Cocoa and Ink, about one in four each. Skin is variety, not rarity.

Background

Twelve backgrounds. Nine plain colours share most of the collection; three are rare, and Glitch is the rarest of all.

Brick2,123
Ivory2,074
Indigo2,066
Crimson2,065
Magenta2,048
Graphite2,037
Cobalt2,029
Emerald2,017
Tangerine2,002
White Marble1,167
Checkerboard639
Glitch232

Hash Scar

Every mined Bitborn carries a Hash Scar, the trace of the work that found it: a few pixels torn out of the character, outlined in white. Four shapes, each on about one piece in four. Scar I and II tear pixels out, Scar III and IV also shift some of them sideways. Only one-of-ones can be found without one. A holder can restore a scarred piece for good (0.002 ETH to the Vault): the scar stays in its history, and every restoration makes the scarred ones rarer.

Eyes

Most characters keep their own eyes, and a character wearing glasses or a mask always does. The rest get special eyes. Bit Eyes are the rarest.

Base eyes17,962
Closed Eyes609
Red Eyes438
Stoned Eyes379
Ronin Eyes261
Demon Eyes134
Bit Eyes58

The rarest traits

261 traits in total. Some appear on only a handful of pieces out of 20,500:

Wizard BTB Robe28
Broken TV27
Spliff23
Transparent Outfit18
UFO Blue15
Broken Hoodie14
Pink Pipe14
Superman Cap13
Wizard Staff13
Gold Earring4
Head Mirror2
Gold Cuban Chain2
Lab Coat1

The Collection page lets you filter every piece by bloodline and trait once it has been found.

04
Sealed

Provenance, proof of a fair order

Which piece each miner receives was decided once, before mining opens, and cannot be changed afterwards. You do not have to trust us on that: here is how to check it.

One shuffle, done once

All 20,500 mineable pieces were put in a single order by a cryptographic random generator. Bitborn #1 is the only fixed position. Everything after it, Humans, Zombies, Apes, Aliens and one-of-ones, is spread at random.

The Nth find gets the Nth piece

Mining decides when you find a Bitborn, the order decides which one. Price, wallet, or how long you mined play no part in it.

The fingerprint is public now

The whole order is summed up in a SHA-256 fingerprint, published below before the first Bitborn is found. Change a single piece, or swap two positions, and the fingerprint no longer matches.

The full list is published when mining closes

It stays private while mining is open, so nobody can read what comes next. When mining closes, the list is published. Take the piece IDs in order, join them with commas, hash them with SHA-256, and compare with the fingerprint below.

70f68e3f10c5025f812b5d57baaa347532a73b8215d4804466c8a1cf0d4fd7c4

Check it yourself in any browser console, once the list is out: crypto.subtle.digest("SHA-256", new TextEncoder().encode(order.join(","))). The Genesis draws follow the same idea: each draw is locked to a future block before its result can be known, and anyone can trigger the reveal.

05
Built & tested

Forge

Soft the Forge with a declared commitment. Your Bitborn never leaves your wallet and custody never transfers. Points accrue every day it stays in the Forge.

Soft
Never leaves wallet
30 to 180 days
Birth Points
Birth Points

Register, don't transfer

Forging a Bitborn records a timestamp on-chain. The piece itself stays exactly where it is, in your wallet, tradeable at any moment. What it earns is Birth Points, not ETH.

Choose your lock

Pick a commitment when you forge: none (×1), 30 days (×1.5) or 180 days (×2). The multiplier applies to your Birth Points. Points accrue from day one, and the multiplier applies for as long as you keep the commitment.

Extend, never shorten

Locked in at 30 days but want a higher multiplier? Extend the commitment at any time for a bigger share. It only moves forward, extending is always allowed, reducing never is.

Leaving is free

Leaving early confiscates nothing. You simply drop back to the lower multiplier and stop earning the bonus. The piece never left your wallet in the first place with their own commitment.

Points, not payouts

No epochs, no distribution date, no claim. Points accrue continuously, day by day, for as long as the piece sits in the Forge.

The reward-per-share accounting was rebuilt and tested end to end after switching from a locked to a soft model, including a rounding bug caught and fixed during testing. The commitment system (choosing a duration, extending it) was added and tested on top of that same accounting.

06
Built & tested

Burn & Save Season 2

Opens when mining closes. Burning destroys a Bitborn and earns the most Birth Points. But for one hour, anyone can bid to save it instead.

You put a piece up to burn

You receive no ETH, in either case. What you get is Birth Points, that is the whole reward, and it is what makes the sacrifice real.

One hour, open to everyone

The price is read live on OpenSea: the best offer made on that piece or the collection floor, whichever is higher. The owner's own asking price is never used, since the owner sets it. Bidding opens 10% above it, and each bid must beat the last by at least 1%. A bid placed in the last five minutes pushes the end back to five minutes after it, so nobody can take a piece at the last second. You cannot bid on your own burn otherwise you could drive the price up and make a real saver overpay.

Highest bid wins the piece

The winner gets the Bitborn and its history the burn attempt and the save are recorded on the piece itself. Everyone outbid is refunded straight away.

Everything paid goes to the Vault

Not to the person burning. This is the one source of funding that does not depend on marketplaces honouring royalties the money arrives in the contract directly.

If nobody bids, it burns

Destroyed on-chain, irreversible. Genesis pieces can never be burned that is a lock in the contract, not a rule enforced by hand.

07
Built & tested

Revenue Split

Every secondary sale splits automatically, the moment it happens.

80%
20%

Funded by trading activity, not by minting new tokens or diluting anything. If nobody trades, nothing flows. If the collection stays active, so does the Vault.

08
Wallet built & tested, draw in development

Genesis, and its own wallet

500 Genesis are sealed in the contract from day one. They cannot be bought or mined: they are won with Birth Points, 125 at each of the 4 epochs. What a Genesis looks like stays sealed until it is born. Full Genesis page.

Every point is a ticket

When an epoch unlocks, 125 Genesis are drawn among everyone holding Birth Points, weighted by points: 2,000 points give twice the chance of 1,000. The draw is locked to a future block and anyone can trigger the reveal, so nobody can pick a winner.

Winning spends your points

A winner's points go back to zero, and they can win again later. Everyone else keeps their points for the next epoch. One Genesis per wallet per draw. With 500 Genesis for 20,500 mined pieces, most participants will never win one.

Every Genesis has its own address

Each Genesis has its own on-chain account, built on ERC-6551, an open Ethereum standard. The address is computed from the NFT contract and the token ID: it exists from the day the collection is deployed, and it always belongs to whoever holds the Genesis. Regular Bitborn do not have one: giving 20,500 pieces an account each would cost gas without changing anything.

The weekly share lands there

Once the fourth epoch is out, the Vault pays out every week, in ETH, into the account of every Genesis engaged in the Forge. Only the current holder can move it out, to their personal wallet or anywhere else.

Value travels with the piece

Sell a Genesis before withdrawing, and whatever sits in its account goes to the new holder automatically. Your profile shows the combined balance across every Genesis you hold.

Genesis cannot be burned: that is a lock in the contract. A Genesis sitting idle outside the Forge is left out of that week's share.

09
Pending deployment

Contract Addresses

Live mainnet addresses on Robinhood Chain. Filled in at deployment.

ContractAddress
Bitborn NFTTBD
BitbornStakingTBD
BitbornSharesTBD
BitbornVaultTBD
BitbornGenesisTBD
BitbornRevenueSplitterTBD
10

ABI Quick Reference

Key entry points for anyone integrating directly with the contracts.

ContractFunctionPurpose
BitbornStakingregisterStakeDeclare the Forge with a chosen lock (30 to 180 days), no NFT transfer
BitbornStakingunregisterStakeStop the Forge, no NFT transfer
BitbornStakingclaimRead your accrued Birth Points
BitbornStakingextendCommitmentExtend the lock for a higher multiplier, never shortens it
BitbornStakingisUnlockedCheck whether a piece's lock has ended
BitbornStakingreclaimStaleStakeFree up a sold piece's stale registration
BitbornVaultclaimWithdraw a Genesis's weekly share
BitbornRevenueSplittersplitManuallyRoute incoming revenue 90/10
11

Security

A few principles we hold to across every contract in this system.

No private keys, ever, in any client-side code

Every claim, forge, and burn is signed by the holder's own wallet. Bitborn's contracts never hold a key that could move funds without the owner's signature.

Written, compiled, tested, in that order

Nothing here is described before it's built. Every mechanic above exists as compiled, tested code before it's documented on this page.

External audit before mainnet

Every contract handling real funds goes through independent review before deployment. This documentation reflects the design and testing, not a substitute for that audit.

How the protocol works

The Forge

Put a Bitborn in the Forge and it earns Birth Points for as long as it stays there. The piece never leaves your wallet. Take it out whenever you want, the points you already earned stay yours, the piece simply stops earning new ones. There is no lock and no penalty for leaving.

Birth Points

Birth Points measure what you contribute, not what you own. Four ways to earn them:

They are not a token. They cannot be bought, sold or transferred, and holding more pieces does not earn them faster. Someone with two Bitborn who participates can outrank someone with thirty who does nothing.

Burning, and being saved

Burning destroys a Bitborn. But it does not happen instantly: for one hour, the piece is visible to everyone, and anyone can bid to save it.

The person burning receives no ETH, in either case. Everything paid goes to the Vault. What they get is Birth Points, that is the whole reward, and it is what makes the sacrifice real.

Where the money goes

Every secondary sale carries an 8% royalty, split by the contract:

The Vault also receives every restoration and, from Season 2, everything paid to save a burning Bitborn. None of that depends on a marketplace honouring royalties, the money arrives in the contract directly.

Forging itself pays no ETH. It earns Birth Points, and every point is a ticket in the Genesis draw. The Vault is what a Genesis is worth once it exists, the Forge is how you become eligible for one.

Genesis

500 Genesis are sealed in the contract from day one: they exist, but they are not distributed. They are released in 4 epochs of 125, each unlocked once the mining protocol reaches a milestone: 25%, 50%, 75% and finally 100% of the 20,500 mineable Bitborn found. No minimum wait between epochs, if the collection is mined out in a week, every epoch unlocks that week.

At each epoch, 125 Genesis are drawn among everyone holding Birth Points, one point, one ticket. The draw is locked to a future block and anyone can reveal it. A winner's points go back to zero; everyone else keeps theirs for the next draw.

What a Genesis looks like is not disclosed until it is born, that is the point. What is public: they hold their own on-chain account, and cannot be burned. That is a lock in the contract, not a rule enforced by hand.

A Genesis only receives the weekly share while it sits engaged in the Forge. Move it out, and it is left out of that week's share, even if it has been born for months. This is the same rule that governs every other Bitborn's rewards, applied without exception to the pieces that pay the most.

How the Vault pays out

Nothing is paid out while the collection is being mined: the Vault only accumulates. Once the fourth epoch is released, every week, part of the Vault is shared equally between every Genesis engaged in the Forge. No lottery, no weighting. Then it starts again the next week. The fewer Genesis in the Forge, the larger each share. Anyone can trigger the weekly payout: nobody, not even the team, can block it.

The Vault is fed only by what the collection does once it exists: royalties, restorations, and from Season 2, saves.

Restoration

Every mined Bitborn carries a Hash Scar. Its holder can choose to restore it: the torn pixels come back, the displaced ones return to their place, and the white outline disappears. The original colours were sealed with each piece in the same fingerprint as the mining order, so nobody can invent a restoration.

A restoration costs 0.002 ETH, paid to the Vault, and earns 200 Birth Points. It is permanent, and only the holder can decide it. The piece keeps its Hash Scar in its attributes and gains Condition: Restored; every piece still scarred shows Condition: Scarred. Each restoration makes the scarred ones rarer. Genesis and one-of-ones cannot be restored.

History belongs to the piece

Burn attempts, saves, restoration and forge time are recorded on the Bitborn itself, not on your wallet. Sell it and the history goes with it. Two pieces with the same traits are not the same piece if one of them was saved from the fire.