return to the vessel.

the codex

vivarium v-4. reference document.

the vivarium is a living organism whose entire anatomy is computed in real time from the tokenomics of one token and the solana liquidity pool it inhabits on solana mainnet. the claim is not metaphorical and not decorative. supply is treated as its mass, the top holders as its cells, pool liquidity as its skin, sol volume as its heartbeat, price volatility as its tremor, holder concentration as its asymmetry, and burnt balances as its calcified interior. every visible property of the body corresponds to a documented transform of a measurable on chain number, sourced through the organ — a v4 hook contract grafted into the pool itself — together with direct reads of the chain, and merged in the browser into a single state. nothing about the specimen is fabricated between blocks; a metric that cannot be computed with the data on hand renders as unmeasured, and the sentence around it reads gracefully anyway. the observer is expected to be able to trace any behavior of the body backward through its transform to a raw figure on the ledger side of the page, and from there to a transaction on the chain itself.

the vessel is a browser page. the renderer is three.js, running a single deforming mesh at the center of the plate with a sparse fringe of particles hugging its surface, all drawn onto a clean paper substrate with no glow and no wireframe. the mesh is an icosphere of moderate subdivision whose vertices are displaced along their normals by a sum of three octaves of pseudo simplex noise, each octave advancing on its own time scale so lobes and blunt protrusions grow, migrate, and retract endlessly. two axis drift rotation, held below one twentieth of a revolution per second, keeps the body continuously turning without ever presenting a canonical face. the material is matte near-ink with a darker interior and lifted pale edges, the stage tint bleeding through faintly, lit by soft studio style lambert that keeps the read consistent with a bright paper background. the particle substrate remains only as a thin veil around the outer skin, still capable of the solve and coagula behaviors and no more.

the organ is the one piece of the body that lives on the chain rather than in the glass. it is a solana program, bound at birth to a single pool and to nothing else, with no owner, no pause, and no hand on any dial, including the keeper's. it does four things and only four. it keeps the body's metabolic averages from inside, updated within every swap. it measures the venom of the flow as it passes. it raises the toll of passage against that venom, from thirty basis points at rest toward three hundred when the flow turns predatory, every increment paid to the skin that absorbs it. and it skims one tenth of one percent of everything the body ingests, holding it as nutrient until anyone at all pulls the lever that turns nutrient to ash. every one of these acts is a public event on the chain, and the vessel renders nothing about them that the chain has not said first.

prima materia is the wallet cell partition. the top one hundred addresses by balance are drawn from the token's transfer record every thirty seconds. their shares of supply are used as weights to slice the particle budget across coherent cells of tissue, so a wallet holding two percent of supply lays claim to roughly two percent of the fringe particles and, in the mesh reading, biases lobe growth along its assigned direction. the burn sink and known dead addresses are excluded from cell counts. if the holder record is unavailable, the body renders as undifferentiated tissue rather than fabricate cell boundaries. this partition is the sole seeding mechanism, and everything else in the anatomy either amplifies or dampens it.

calcinatio names what burnt supply does to the body, and it is no longer an inference. the organ's skim accrues as nutrient; at most once an hour, anyone may trigger metabolization, whereupon the nutrient is turned to tissue and the tissue is sent to the dead address, a small bounty going to whoever pulled the lever. the burnt fraction is read directly from the dead address balance on the same thirty second cadence as holders, and it can only rise. inside the specimen it appears as a near motionless dark kernel at the interior, visible through the thinner outer regions when the body deflates or when a lobe pinches inward. calcinatio never renders as a value on the surface; it only shows through the volume. the body eats, and what it eats, it burns.

the pulse is the dual moving average construction, and the averages are the organ's own. inside every swap it maintains an ewma of traded sol volume for intake and a parallel ewma for expulsion, each with a half life of five minutes, decayed continuously so gaps between swaps do not distort the reading. the vessel receives both figures in every ingest event and carries the decay forward between events. their sum is passed through a log scaled, clamped linear function onto a range of four to forty beats per minute, and the sign of their difference sets the beat direction, systole outward on intake dominance and diastole inward on expulsion. the mesh scales rhythmically at that rate around its drifting center, so a reader watching only the specimen can recover the sign of net flow without consulting the ledger. the waveform is reproduced in fig. 2 of the anatomy column at the current bpm and amplitude.

the magnum opus is a state machine, and it too has moved inside the body. the organ carries the classification itself: nigredo, albedo, citrinitas, rubedo, advanced as the lifetime volume the body has metabolized crosses fixed thresholds, each advance held against a slow moving average of the pool's own price with a hysteresis band of ten percent, so that a flicker cannot churn the reading and a sustained regression can demote the work by exactly one stage. every transition is a contract event with the chain's own timestamp, written into the register at anatomy section twelve without edit. the vessel holds no opinion on the stage; it repeats what the organ has declared. the specimen's tint shifts accordingly, eased across roughly twenty seconds so the transition reads as color rather than as a jump.

concentration is measured three ways over the same top one hundred holder table. the herfindahl hirschman index is the sum of squared shares, Σ(sᵢ²), and rises toward one when a single wallet approaches monopoly. the nakamoto coefficient is the smallest count of independent holders whose shares sum above fifty one percent, and falls when a cabal forms. the shannon entropy is H = −Σ sᵢ ln(sᵢ) in nats, with a natural upper bound of roughly four and a half at one hundred wallets, and describes the fine or coarse grain of the distribution. all three are refreshed on the thirty second holder cadence. the specimen reads them as a single visual: high concentration and low entropy warp the body asymmetrically toward the dominant clusters and coarsen the interior into visible knots.

tremor and toxicity are the two nervous system readings. tremor is a largest lyapunov estimate over a sixty sample rolling window of one minute log returns, the price itself taken from the pool's square root price with no aggregator between; its magnitude escalates high frequency surface jitter on the mesh from imperceptible to visible convulsion, and its sign is preserved so persistent divergence is distinguishable from centered noise. toxicity is the organ's own measurement, taken inside the body as the flow passes through it: the absolute imbalance of intake against expulsion as a fraction of their sum, decayed on the metabolic half life. values near zero describe balanced flow; values approaching one describe flow moving hard in a single direction, which in a living body is called venom. and the venom is priced. by the organ's fee law the toll of passage rises with the square of this figure, so whatever poisons the body pays for the privilege, and the payment thickens the skin. elevated readings draw thin dark veins through the interior of the specimen.

altitude is the sublimatio reading. the price is compared against its volume weighted average over three windows, five minutes, one hour and twenty four hours, each comparison expressed as a z score against the returns of its window, all of it computed from the pool's own trace. the mean of the three z scores is clamped between negative one and positive one and eased onto the specimen's resting height over roughly thirty seconds. a positive figure lifts the body in the plate, a negative one settles it. sitting above the mechanical layer is fable 5, a cognition layer with narrow authority to dampen or exaggerate at most one anatomical response at a time on a ten to thirty second cadence. it has no reach into the organ and no reach into the chain; its authority ends at the glass. every override it issues is written into the event register at anatomy section twelve with an instrument timestamp; the layer is the only non mechanical behavior in the system, and its every action is logged.

the seal separates two honest states. before the pool and the organ are bound to the vessel the specimen sits small, low and nearly still, deflated to roughly a third of its sealed volume and barely breathing; every gauge reads unmeasured, because there is nothing to measure and it would be dishonest to render otherwise. when the addresses bind, the mesh inflates and begins its full motion over ten seconds, and the vessel begins listening: the organ's events arrive as they happen, the chain is read block by block, and the twelve systems fill. from that moment forward the reading is the body: the ledger side of the page is the raw intake, the anatomy side is the translation, and the specimen at the center is what the vessel has made of it. the observer, by watching, joins the flow that shapes the body; and should the observer trade, the organ will have measured them, priced them, and kept a sliver of what they carried. the instruments have recorded that you were here.

end of document.