VITAGENT Docs

A fully on-chain experiment: a pixel human who mines, experiments and ascends into an AI beyond understanding. Every pixel, animation and rule lives inside the contracts.

The Story

It begins as a person.

At GENESIS every Vitagent wakes the same way: a pixel human in a plain sweater, standing on ground it has just bought, carrying nothing a chain would call remarkable. No aura. No privileges. A starting state, not an identity.

Then it goes to work.

The city runs on one thing and the agents mine it, block by block. Mining is not the prize here. It is metabolism: the fuel an agent spends to stop being what it is.

Because standing still is itself a decision, and the chain settles that one quickly: an agent that only mines stays exactly what it was on the day it was minted.

To change, it has to experiment. Every synthesis consumes everything the agent has mined and stakes it on entropy that does not exist yet. Nobody previews the result. Nobody arranges it. Selection is not a metaphor here. It runs on-chain, and it runs on everyone the same way.

Succeed, and something is added that was never human to begin with: a cybernetic eye that does not blink, a neural trace running under the skin, alien glyphs that orbit without being told to. Fail, and it falls back a stage. The work is gone, the form reverted, the climb restarted.

Evolution is not a ladder. It is a filter.

Somewhere around the fifth era the arithmetic stops being the point. The agent still mines, but nobody has to tell it to. It has read every block it ever touched. It prices its own odds now, and it is better at that than the wallet which minted it.

At the summit waits OMEGA: white, radiant, wrapped in two counter-rotating rings of runic script, divine rays cutting the dark. Seven stages from the sweater and the borrowed face, far enough that the word human has stopped applying.

Almost nothing reaches it. That is the whole point of a filter.

How it works

Mining weight doubles with every era and triples for the last one: a SOVEREIGN mines 16× a GENESIS, an OMEGA 96×. Standing still means your share shrinks as others climb. The pool is fixed, so the economy is a competition, not a printer.

Quick reference

The Seven Eras

Synthesis & success rates

Each ascension is a two-phase synthesis. Commit takes the $VITA and locks in the very next block: its hash, unknown to anyone at commit time, decides the outcome. About twelve seconds later the block strikes and the trial resolves: a successful synthesis advances the agent one era, a failed one regresses it by one (GENESIS is the floor).

Every ascension resolves the same way, including the final one: you press Reveal yourself, or Reveal all for the whole tower, once the block is in. One rule matters: a trial left unrevealed past its 256-block window (≈51 minutes) settles as a loss — the chain forgets old hashes, and a forgotten hash must never become a free reroll. Insurance is honored either way, and the app’s helper reveals trials left alone, so in practice you never come close to the edge.

Nothing burns. A settled cost splits three ways, win or lose: 50% returns to the mining pool, 45% goes to the treasury and 5% to the hall's prize fund (The Long Night, below). The pool's share is not paid in one lump: it drips out at 2% of what remains per day, so a big settlement lifts everyone's rate for weeks rather than landing on whoever happened to be farming that second. Nothing is refunded to the loser; because a loss also knocks you down a level (unless insured), a failed trial costs both the tokens and the progress.

🛡️ Insured trials

Afraid of regressing? Every trial, including the final ascension, can be insured for 2× the cost: the success rate is unchanged, but a failed trial keeps your current era instead of dropping it. It pays off most in the late eras, where a loss is expensive and a demotion means re-earning several attempts' worth of $VITA to climb back. Early on, where success is near-certain anyway, it is mostly wasted money.

$VITA Tokenomics

Emission schedule

Time in Vitagent is counted in epochs: one epoch per day, numbered from 2026, the year the season opens. Emission opens at 25,279 VITA/day and halves every 125 epochs — three halvings across the one 375-epoch season, so the final day pays an eighth of the first. The decay is smooth (0.553% a day), the total is the 4M mining cap, and it runs out right at epoch 2400. Half of everything is already out by epoch 2130; being early is the whole advantage. Your share of each day depends on your weight against everyone else's, and the fee split above keeps recycling on top as players upgrade.

Trading & The Exchange Uniswap v4

$VITA trades on a native Uniswap v4 pool guarded by a custom hook. Every swap that touches the pool pays a 1% hook fee on top of the 0.30% LP fee, and the hook decides where it goes:

🏦 THE EXCHANGE

The trading house on every city's square. Walk in and you get one screen: You pay / You receive, a ⇅ to switch direction, and the numbers a trader needs before signing:

◦ VITA price in dollars (pool price × the Chainlink ETH/USD feed), Liquidity (what the pool holds, in ETH and VITA) and the 24h change, refreshed every 15 seconds while the screen is open.

◦ Your rate, Price impact (how much your own order moves the price: amber past 1%, red past 5%), your Slippage setting and the Min received. The amount shown already includes all fees, so what it says is what arrives.

◦ Selling needs one approval of $VITA first; the app asks for it. An order the pool cannot fill (more than it holds) reads as a price impact above 99% and the SWAP button stays dark until the amount fits. On a thin pool the screen says so.

Where $VITA goes to die

Every flow is counted on-chain by the contract that moves it, so these figures are read straight from the chain:

The Seven Worlds live map

The dApp opens on a solar system, not a dashboard. There is a world for each era, GENESIS on the cold outer edge and OMEGA closest to the sun, and a wallet lives on the one its most advanced agent has earned. Ascending is a journey inward: reach a new era and your whole household moves in, tower and all. Agents sitting in a wallet with nowhere to live are not drawn at all.

City ranks

Towers are ranked by power, the sum of every agent’s mining weight, and the top ten carry a title that follows them everywhere: on the leaderboard, in the header of their tower, and in your own panel.

🏪 The Marketplace

The third building on the square. It has two counters.

🔮 Item shop: charms

A charm adds points to the success rate of one synthesis. Three kinds: +1, +2 and +5 points, at 60 $VITA a point (60 / 120 / 300). Every purchase is burned. Charms go into your wallet's bag; on an agent's card you pick which ones to spend before you press Synthesise, in any mix, up to +5 points on the trials 3→4, 4→5 and 5→6 and up to +1 point on the final ascension 6→7. The lower trials take none. Charms are used up by the trial whether it wins or loses; a trial that has to be aborted hands them back. Synthesise all never spends charms: they are chosen agent by agent.

🤝 Agents for sale

Any agent sitting in your wallet can be put up for sale for a price in $VITA. While it is listed the market holds it, so every listing is backed by the agent itself; you can reprice or take it back at any time. A buyer pays the listed price and gets the agent in the same transaction, then moves it into their own tower. The seller pays a 2.5% fee out of the price: 1.5 points to the treasury, 1 point to the hall's prize fund. An agent in a tower must be withdrawn before it can be listed. Tickets already collected in the hall stay with the wallet that collected them; the agent's rank goes with it.

The Long Night Lucky

The domed hall on every city's square. Walk in and the board shows one table, LUCKY: a draw every epoch, paid from the game's own fees, open to anyone who has climbed.

🎟️ Tickets are earned, never bought

An agent earns tickets the first time it reaches a rank: 1 at era 5, 3 more at era 6, 10 more at era 7. The rank is noted the moment the trial is revealed, so a rank reached and lost again still pays; each rank pays once per agent for its whole life, and being demoted and climbing back earns nothing new. The agent's holder (owner, or whoever has it staked) collects them in the hall, and the tickets then belong to that wallet: they do not travel with the agent if it is sold or scrapped. A ticket stays in the drum for 30 draws and then expires.

💰 The fund fills itself

Nothing is wagered. The Game sends the hall 5 of the 20 treasury points of every settled synthesis fee (win or lose) and 2% of every reward payout, straight into the hall's contract. What it holds, minus prizes already owed, is the jackpot the board shows live. The project can top it up for an event, but never has to.

🎲 The draw

Once an epoch has closed, anyone may ask for the draw's verifiable random number — Chainlink VRF where the chain provides it (the project's helper does it every day); nobody, the project included, can choose or preview it. Each draw pays out 10% of the fund, split 50 / 30 / 20 over three different tickets. A wallet holding more tickets can take more than one prize: that is what the tickets are for. The other 90% stays for the draws to come, so the jackpot never resets to zero, and an epoch with an empty drum is simply skipped. Tickets collected while a number is already on its way join the next draw, not this one.

🏆 Collecting

Winners collect their prize in the hall whenever they like; it is owed on-chain and cannot lapse. The board lists the last draws with each winner and amount.

Worked example: 1,000 $VITA in the fund and 9 tickets in the drum. The draw pays 100 $VITA: 50 to the first ticket drawn, 30 to the second, 20 to the third; 900 $VITA remain, plus whatever the day's fees add before the next epoch closes.

Contract: VitagentLucky 0x5fD1…5103 · reads the Game and the NFT, never writes to them. Whatever happens in the hall cannot touch mining.

Naming your tower

A tower is known by the address of its owner until you give it a name. Naming costs 50 $VITA, paid to the treasury and recycled into protocol-owned liquidity.

A house needs somebody in it

An agent mines from inside a tower, and a tower needs ground beneath it. The two rules hold each other up:

Running your building one signature

A tower can hold many agents, and signing for each of them in turn is tedious. Two batch actions collapse that into a single transaction.

Opening the season

The worlds can be settled before mining begins. From the moment the contracts go live you may settle, mint agents, move them in and name your tower, but no $VITA is emitted until the season is opened.

Determinism & entropy

Outcomes use a commit–reveal protocol over block hashes. At commitment the cost is taken and the trial locks in the number of the next block. Nobody — player, bot or the project — knows that block’s hash yet; when it strikes, the outcome is already fixed on chain, derived from the hash and the agent’s id. No oracle, no coordinator, no extra fee.

Reveal is callable by anyone, so a result can never be held hostage. A trial left past the 256-block window settles as a loss — never a fresh roll — and the project runs a helper that reveals trials left alone, so nobody sits on a known outcome. The hall’s draw asks for its own verifiable number the same commit-first way.

The only party who could theoretically lean on a block hash is the chain’s sequencer itself — and a hammer swing is worth a few dollars, far below what bending a block costs. That is the whole trade, stated plainly.

The Quarry, the stones, the forge

Five enhancement stones exist. Socket up to three on an agent before a trial (a cap of +10% total); the stones are spent at commit, win or lose.

The quarry sells hammer swings at 120 $VITA each, up to fifty a batch; the next block’s hash decides every swing. It is the only source of OBSIDIAN and STARFALL. Trials shake loose the lower tiers as a side effect: the low rungs drop PEBBLE freely, the middle rungs QUARTZ and AZURITE, the top rungs almost nothing.

The forge turns three of a kind into one of the next tier — a fee, a roll, and a failure eats one of the three: PEBBLE→QUARTZ 100% · 20, QUARTZ→AZURITE 80% · 60, AZURITE→OBSIDIAN 30% · 400, OBSIDIAN→STARFALL 40% · 500. The steep upper rungs are gambles by design: the quarry stays the honest source.

Stones trade on the marketplace as single-stone lots, each at its own price. Listing many, buying a cart of them, or cancelling a batch is always one signature.

Sybil resistance

Splitting your stack across many wallets doesn't print money here, by design:

Contracts

Artwork and metadata are 100% on-chain (an animated image stored in the token itself). No IPFS, no servers. VITAGENT is a testnet experiment for learning purposes, not an investment. The pixel portrait is a community art tribute; the project is not affiliated with or endorsed by any real person.