Skip to content
▮ Log

What mutated

What mutated, newest first. Each entry describes a change to this repository. Entries never describe on-chain events; those live on the stats page.

  1. The site watches the chain live

    MUTATIONPRE-LAUNCH
    • A live terminal on the home page: every buy and sell in the host coins, every new Pons launch, graduation and pair approval, as it lands on Robinhood Chain. Once VIRUS is deployed, infections and feeds stream there too.
    • Next to it, the hosts sorted by how busy they are: trades in the last 15 minutes, buys against sells, and how long since the last one.
    • A status bar on every page: whether the feed is live, the latest block and the latest trade.
    • All of it is read from chain through Robinhood Chain's public RPC, every few seconds; nothing is simulated.
    • A new Pons launch whose ticker could not be read the moment it landed (the RPC node a block behind, or a refused read) no longer stays $? in the terminal: the feed asks again on later polls.
    • The signing sheet now sits above the whole page. Before, with the page scrolled to the bottom, the footer painted over the lower half of the sheet, Sign button included.
    • A freshly started server names the top hosts at once, from the Pons launchpad's tickers, instead of showing $? while the public RPC refuses its first burst of reads; each token's own symbol() replaces the ticker when it answers.
  2. $VIRUS is the project's own token, and the site keeps reading the chain

    MUTATIONPRE-LAUNCH
    • $VIRUS is launched by the project owner on their own, outside the VIRUS contracts. It is not a strain: it is not priced in a host, and trading it burns no host coin. The FAQ and the risks page say so.
    • If the site's own RPC provider refuses (out of capacity, rate limited or down), browsers read Robinhood Chain's public RPC directly and the server falls back to it, so pages keep reading the chain, more slowly.
    • The host list is read on the server once a minute and shared by every visitor; tokens that can never host are re-read every 30 minutes.
  3. The site is live on Robinhood Chain, ahead of launch

    MUTATIONPRE-LAUNCH
    • virusrh.fun reads Robinhood Chain mainnet and the live Pons V2 contracts. The VIRUS contracts are not deployed yet, so launching a strain stays off until they are.
    • Hosts shows the 25 largest Pons V2 coins by market cap, ranked from the Pons launchpad every 10 minutes and each confirmed on chain as a Pons V2 launch. Each is marked viable or awaiting Pons, with why: only coins Pons has approved as pair tokens can carry a strain.
    • The $VIRUS contract address and the X account appear in a copy box and the header. Only the project's admin wallets can change them, by signing the new values; every change is kept with the wallet that signed it.
    • The host register is read on the server and shared by every visitor, and reads that cannot change are cached, so a crowd costs the chain no more than one visitor. The infect page still checks the chosen host live before a launch.
    • Every page has its own link preview on X and elsewhere; strain pages show their specimen card.
    • The whole site was played through on a local fork of mainnet with the real Pons contracts: a strain inoculated on $BUN, bought with ETH routed through BUN's Uniswap V4 pool, sold, bought with BUN, and fed, burning BUN. Nothing was sent to the real chain.
  4. Graduated strains trade in real Uniswap V4 pools (local lab)

    MUTATIONLAB MODE
    • The local lab now runs real Uniswap V4 code at Robinhood Chain's addresses: PoolManager, StateView, V4Quoter, Permit2 and Universal Router 2.1.2, the version deployed on chain 4663. Graduation seeds a real pool.
    • In the lab, you can buy and sell a graduated strain from its page: approve, a Permit2 allowance for the router, then the swap, quoted live by the V4Quoter. Production pool trading stays off until the fork test passes against the deployed contracts.
    • After graduation, fees follow Pons's rules in the lab. Sells pay the hook in the host, which the feeder sweeps and burns. Buys pay it in the strain, which waits for the Pons operator (AWAITING PONS SWEEP).
    • A graduated strain's volume and transaction count now include its pool swaps.
    • Price charts: every strain page charts its price in the host, one point per trade, from curve and pool logs, with buys and sells marked and a table view. Charts keep readable text on phones.
    • Static analysis: Slither, forge lint and Aderyn over the contracts. All findings were reviewed and none needed a code change. The triage is in the audit pack, and pnpm analyze re-runs it.
  5. Play on localhost: one command, lab wallet, field manual

    MUTATIONLAB MODE
    • pnpm dev runs the whole game on localhost. With Foundry installed it starts a local chain with the real VIRUS contracts and demo specimens. Without Foundry it opens a read-only view of Robinhood Chain.
    • Lab test account (local lab only, never in production builds): connect and play without installing a wallet. The local chain signs, so no key exists anywhere. It connects only when you choose to.
    • How to play: an eight-level field manual, from finding a host to topping the high scores, plus the controls.
    • Accessibility: every key page passes an automated WCAG 2.1 A/AA check (axe), both disconnected and as a connected player. CRT scanlines are lighter and turn off for high-contrast preferences. Log links are underlined, and progress bars and alerts are announced properly. The end-to-end suite now fails on any serious violation.
    • Contract tests for every launch failure path in the coordinator: branch coverage rose from 60% to 97%, with 134 contract tests in total.
  6. Launch prep: rehearsal, readiness, security fixes, hosting

    MUTATIONLAB MODE
    • Deployment rehearsal (pnpm rehearse). The real deploy script runs on throwaway local chains: the mainnet gate refuses without the approval phrase, both owners accept, and wiring, pauses and delays are checked. Nothing touches a real network.
    • Readiness check (pnpm readiness). One command reports every deployment gate as met, waiting or needing a human, with the next step for each. It never prints an RPC key.
    • Internal security review of the contracts. It found no critical, high or medium issues. Three low findings were fixed: feeding can no longer be frozen by a failed Pons read; the registry accepts only genuine feeders, so a replaced coordinator cannot forge burns; and an empty feed now reports its outcome. Admin proposals now expire 7 days after their delay. This is not an audit.
    • Review pack for an independent reviewer: scope, threat model, the internal review record, and known issues.
    • Hosting: Docker images for the site and the indexer, with Postgres via Docker Compose. Strict security headers. Builds refuse a keyed public RPC URL, and servers keep RPC keys out of their logs. Adds a sitemap, error pages and a health endpoint.
    • Outbreak map: every host and strain as one live network, with lineage highlighting and a list view.
    • Player profiles: a developer's strains, badges and rank. The terminal opens them with open 0x… or open me.
    • High scores gain a Last 7 days season, read from the chain.
    • WalletConnect for mobile wallets. It turns on when a WalletConnect project ID is set.
    • CI workflow for GitHub Actions: contract tests, size limits, the deployment rehearsal, type checks, unit tests, the production build and the lab end-to-end run.
  7. Game layer: high scores, achievements, terminal, live alerts

    MUTATIONLAB MODE
    • High scores page: most lethal strains, hosts under attack, most decorated strains and top infectors. Burns are ranked by share of each host's own supply, never by raw amounts across different tokens. Your own strains are highlighted when your wallet is connected.
    • Achievements on every strain page: Patient zero, First blood, Lethal I–III, Carrier, Superspreader, Deep tissue and Breakout, with progress bars. Each is a pure function of registry and Pons state, computed in your browser.
    • Terminal: press ` or >_ for a read-only command line (scan, open, infect, top, tail, fx, snd). It never signs or sends anything.
    • Live alerts pop up when a strain is inoculated or fed while the site is open. Only new blocks are watched; history is never replayed.
    • Share on X opens a draft in your own X account. Strain links get a social card drawn from the strain's sprite and its on-chain name, host and burn share.
    • Page titles for strains and hosts now carry the token symbol.
  8. Every specimen alive: live feeds, trees and burn curves

    MUTATIONLAB MODE
    • Specimen DNA: each strain and host gets its own look (body, spikes, colours, coin metal), derived from its contract address. The look is cosmetic only.
    • Infection log: a live feed of inoculations, feeds and developer claims read from registry events, on the home page, the stats page and every strain page.
    • Strain pages open on an animated specimen window: the strain feeding on its host, with fees shown as a stream. The on-chain logo appears only when it is a valid PNG.
    • Host pages show their strains in orbit, plus tabs for the full infection tree, a burn ledger with a cumulative burn chart, and the fee route.
    • Burn curves on the stats page: one step chart per host, in that host's own token, with hover readouts and a table view.
    • Optional 8-bit sound effects (off by default, SND switch in the header), synthesised in the browser.
    • A pixel page header on every page; tighter phone layouts for the specimen windows and the log.
    • Tests for the read-only RPC proxy (write methods blocked, batch and size caps, per-IP rate limit) and for specimen DNA.
  9. Infected terminal: visual redesign

    MUTATIONLAB MODE
    • Dark CRT look: phosphor green, toxic magenta, cyan and amber on near-black, pixel type, OS-window panels, bevelled pixel buttons.
    • New pixel-art renderer: sprites are shaded 3D primitives with lighting, dithering, coloured outlines and a neon rim light, rendered at much higher pixel counts.
    • Animated pixel backdrop behind every page: circuit board with data pulses, hex rain, drifting viruses and glitch bands, with an FX ON/OFF switch and reduced-motion support.
    • Hero infection map: trades move as packets from ETH to hosts to viruses, then the fee splits into a burn furnace with live fire, the dev terminal and the treasury vault. Marked as a schematic.
    • Three animated game panels, a live stat bar under the hero, and much tighter spacing throughout.
    • New $VIRUS mark, favicon, app icons and social card from the same renderer.
  10. First culture: lab build

    MUTATIONLAB MODE
    • VirusRegistry, VirusFeeder (one immutable clone per strain), VirusFeederFactory, VirusLaunchCoordinator and VirusTreasury, with unit, fuzz, invariant and fork tests. Nothing deployed to Robinhood Chain.
    • Economics solved live against Pons: the creator tax is computed so the feeder receives 0.80% of volume, split 50% burn, 30% developer, 20% treasury. Parity with Parasite is shown as EXACT or PONS-NATIVE with the delta.
    • Host register reads Pons pair approvals and runs checks A to H. Unapproved launch tokens show as SPECIMEN FOUND / PAIRING NOT YET APPROVED BY PONS.
    • Four-step inoculation with pinned Pons economics digest and creator tax, and a strain logo cultured into 512 on-chain bytes.
    • Routed buys (up to three hops), each hop quoted live with a non-zero minimum and signed as a separate step.
    • FEED NOW, developer claims and COMPLETE MIGRATION exposed to anyone, as the contracts allow.
    • Reorg-safe indexer and fifteen documentation sections, including the Parasite to VIRUS differences.
    • Launch is disabled in this build. Pons V2 launch access is restricted, so VIRUS runs in LAB MODE.
    • Production build verified with launch disabled and no VIRUS addresses: the site reads Pons live, fails closed to LAB MODE and shows empty states instead of invented figures.
virus CONNECTING—