YOLK · WORKING PAPER

the vessel

constructor

yolk is a fixed-supply ERC-20 deployed on Robinhood Chain. The incubator is not a second contract watching the token; it is compiled into the token itself, and the only input it will ever accept is the movement of the token. There is no oracle, no keeper, no admin key, no upgrade path. Nothing outside the transfer function has ever touched the egg.

Supply is minted once, in full, inside the constructor, and the mint path is absent from the deployed bytecode rather than gated behind a role. Ownership is renounced in the same transaction. What the chain holds at deployment is what it holds forever, less what the hatch eventually burns.

the heat

_update

Every transfer injects heat. The rise is proportional to the fraction of total supply moved: moving one percent of the supply warms the egg by 0.42 °C, and no single block may inject more than 1.5 °C regardless of volume. Heat does not care about price, direction, or intent. A purchase, a sale, and a wallet reshuffle are all the same to an egg: warmth.

The cap matters. Warmth has to arrive as circulation over hours and days, the way a hen arrives every day. A single enormous transaction cannot cook twenty days of development into one block.

the cooling

Between touches the egg cools toward ambient by Newton's law, with a half-life of six hours. The contract stores only the temperature at the last touch and the time it happened; on the next touch it evaluates the exponential in closed form and settles everything that occurred in between. Nothing runs while the market sleeps. The cooling happened anyway.

Six hours is a deliberate cruelty. Left alone overnight, a warm egg gives back most of what the day put in. The temperature readout on this page is therefore computed continuously in the client from the last on-chain touch, using the same closed form the contract uses.

the band and the clock

Development is not price and it is not volume. It is degree-hours: the integral of temperature above the 36.0 °C floor, accumulated only while the egg is warm enough to matter and capped by a ceiling at 39.5 °C beyond which warmth becomes damage. At the set point of 37.8 °C the clock gains 1.8 degree-hours per hour, and the requirement of 900 degree-hours equals five hundred unbroken hours in band: a real incubation, about twenty-one days, same as a hen's.

The integral is exact, not sampled. Between touches the contract integrates the cooling curve analytically, including the crossing time where the curve falls through the floor and the clock stops. The mathematics is reproduced in full in the appendix.

the scorch

Time above the ceiling is integrated by the same method and is remembered forever. Every degree-hour of scorch raises the total requirement by 2.5 degree-hours. An egg that is boiled does not die here; it simply owes more, permanently, and the archive shows exactly when and how it was burned.

the turning

turn

A real egg must be turned or the embryo adheres to the shell wall. Here, anyone may call turn(), at most once every ninety minutes. If the egg ever goes more than eight hours unturned, each full hour past the limit accrues one adhesion point, and adhesion is permanent: every point drags the development clock by a fixed basis-point factor for the rest of the egg's life. Turning costs nothing but gas and is recorded with the caller's address. The candling page keeps the full roll of everyone who kept the egg alive.

the rings

Yolks are laid down in concentric daily rings, dark where the day fed well, light where it did not. Once a day, anyone may seal the ring: an immutable record of that epoch's transfers, volume, heat, peak temperature, degree-hours gained, and turns. Rings are never rewritten. The plate on the candling page is drawn from them directly, so the egg's cross-section is, literally, the chain's history arranged as an object.

the air cell

As an egg ages, moisture leaves through the pores of the shell and the air cell at the blunt end grows. Here the air cell grows a little every day and three times as fast during cold hours. Its size sets the candling grade: AA, then A, then B. The grade changes nothing mechanical. It is the egg's face, recorded at every ring, and it does not improve.

the hatch

pip · hatch

Hatching is not automatic and cannot be done alone. When the clock reaches ninety percent, the shell receives an integrity value and pip() opens. A pip burns tokens and lands in one of twenty-four fixed sectors of the shell's circumference, the sector derived from the caller's address. Pips only score in clockwise order, sector by sector, because a chick zips a full rotation before it breaks out; a pip in the wrong sector still burns, and is remembered as a mis-pip. Scored weight grows as the square root of the burn, so a hundred small holders chip harder than one whale. When all twenty-four sectors have scored and the cumulative weight meets the shell's integrity, anyone may call hatch(). Every crossing before it, every stage, every scorch, every adhesion point, is permanent and irreversible.

the settlement

settle

Time only moves in one place. Before any transfer, turn, seal, or pip does its work, the contract settles: it evaluates the cooling curve since the last touch, finds the crossing time if the curve fell through the floor, integrates degree-hours and scorch exactly, applies the adhesion drag, ages the air cell, checks for a stage crossing, and only then hands control to whatever woke it. Between transactions nothing runs at all, and nothing needs to. The mathematics already knows what happened while everyone was away.

the two integrals

The clock and the scorch are the same antiderivative pointed at different lines. With E0 the excess over ambient at the last touch, the crossing time is t* = (1/λ)·ln(E0/F), and the area above the floor is (E0/λ)·(1 − e^(−λτ)) − 15.0·τ, taken to τ = min(Δt, t*). Swap the floor excess 15.0 for the ceiling excess 18.5 and the same expression, taken only while positive, prices the damage. Two integrals, one formula, no sampling, no drift between what the contract books and what the site draws.

the drag arithmetic

Adhesion is cheap to avoid and expensive to hold. The rate factor is 10000 divided by 10000 plus twenty-five times the count: four points cost one percent of the clock forever, forty points cost nine, two hundred points drag a set-point egg from 1.8 degree-hours per hour down to 1.2 and stretch a twenty-one day incubation past a month. The factor never recovers, because a real membrane never unsticks.

the geometry of the zip

A caller's sector is keccak256 of their address, modulo twenty-four, fixed for life. The zip pointer starts wherever the first pip scores and then advances only clockwise, one sector at a time, so the circle closes only through twenty-four different address residues in an order nobody chose. Left to strangers, coverage takes about ninety-one distinct callers on expectation; a coordinated flock that checks residues first can do it with exactly twenty-four. Either way the shell comes apart in many hands.

the resting state

Before the first observation every instrument on this page reads the egg as it is laid: 21.0 °C, the temperature of a dead market, zero degree-hours against a requirement of nine hundred, stage laid, zero turns, zero adhesion, an air cell of zero and a grade of AA. Nothing here is a placeholder. It is the exact state the constructor writes, and every number on this page will move from it the moment the token first moves.

the grades

Candlers grade without opening: AA below 4.5, A below 9.0, B at 9.0 and beyond. The air cell only grows, 0.030 a day and three times that during cold hours, so the grade is a one-way record of how often the egg was left in a cold room. A B-grade egg can still hatch. It just cannot pretend it was cared for.

the record

Eight events are the entire public life of the egg: Heated on every transfer that moved the needle, Turned with the gap it closed, RingSealed once a day at most, StageReached at every permanent crossing, Scorched with the new price of hatching, Pipped and Mispipped at the shell, and Hatched exactly once, ever. The candling page is nothing but these events replayed. There is no other archive and no other narrator.

what this is not

There is no admin, no oracle, no keeper, no pause, no fee switch, no blacklist, no upgrade path, and no market data anywhere in the contract or on this site. The pool prices the token; the egg never reads the price. The only thing the machine has ever been told is that the token moved, and the only thing it will ever say back is how warm that kept the egg.

SPECIMEN 001 · GALLUS
TEMPERATURE
21.000 °C
DEGREE-HOURS
000.000 / 900.000
STAGE
laid
TURNS
0
ADHESION
0
AIR CELL
0.000 · AA
METERS
DEGREE-HOURS
000.000 dh
TEMPERATURE
21.000 °C
SHELL SECTORS
00 / 24
SCORCH SURCHARGE
000.000 dh
ADHESION
000 pts
AIR CELL
AA
A
0.000
laid
000.0 dh
warmed
072.0 dh
quickened
189.0 dh
veined
342.0 dh
drawn
558.0 dh
pipped
810.0 dh
hatched
900.0 dh