Skip to content

Epochs

At 100×, every reading shrinks the losing side’s NAV sharply. When players keep refilling the beaten side, its token count keeps growing, because each refill buys at a crushed price. Solana token amounts are 64-bit numbers, so instead of capping the count, a side rolls to a new epoch.

Just before a buy would take a side past 263 base units (about 9.2 trillion tokens), that buy’s own settlement starts a new epoch for the side:

  • A fresh side token takes over the side’s buys. It is named after the first with the epoch number: Sagitta BONK UP #1, BONKUP1 (and BONKDN1 for DOWN), at an address the market program derives from the market, the side and the epoch.
  • Every old token is now worth a fixed number of new tokens, set at the roll: the old NAV divided by the starting NAV. The market records that ratio on chain (the EpochRolled event).
  • Nothing else changes. No SOL moves, the pots stay where they are, and the buy that triggered the roll fills at the same price it would have. The roll rounds toward the pots, so the side’s holders give up at most a few lamports.

The roll itself only updates the market’s books, so it never holds up the queue. The new mint is created by a separate call, prepare_epoch, which anyone can make; keepers make it right after a roll. Its deposit comes from the market’s burn share when that covers it, else from whoever sends the call. Until the new mint exists, the shares of a filled buy wait in its ticket, and its delivery follows once the mint is there.

A side can roll 4,294,967,295 times, so no market will run out. A stock or a quiet coin rolls about once every week or two when both pots are kept funded; the busiest memecoins can roll several times a day.

Old-epoch tokens stay ordinary tokens in your wallet, and they keep their full value.

You want to You do
Hold Nothing. Your position and its P&L carry through every roll.
Move to a later epoch convert burns your old tokens and mints the tokens they are worth in the epoch you name, up to the current one. Anyone can convert their own tokens, any time, in any market status.
Cash out Convert, then commit the cash-out, with the last convert in the same transaction as the cash-out; the site and the trading API’s sell build it that way. You get exactly what converting and then cashing out pays.

A conversion rounds down. The tiny remainder stays with the other holders of the same old epoch, so the last converter collects it and the epoch’s tokens convert to exactly what the roll set aside. Tokens several epochs old convert hop by hop, through each epoch between. A cash-out that was waiting when its side rolled still fills at its own reading, with its tokens carried through the roll.

Far behind. Each epoch a convert passes through takes room in its transaction, so tokens many epochs behind catch up over several transactions. Each converts to an epoch you name, as far as one transaction holds, and the last goes to the current epoch, with the cash-out beside it when you are cashing out. The site plans the steps and sends them in order; the trading API’s sell answers with the first one, and the same sell sent again goes on from where it landed.

Once nothing of an old epoch is left, no tokens, no shares owed in it and no older epoch still converting through it, anyone can close its mint and its record with close_epoch. Their deposits go to the burn vault, less a small fee to the caller (see Rent and deposits). An epoch whose last tokens were burned by their holders closes the same way.

  • Fills are still delayed NAV fills at the first reading after your commit.
  • Fees, refunds and the exit without the site work exactly as before.
  • No admin can roll, convert or touch your tokens. Rolls happen only inside a buy’s settlement, by the market’s own rule.
  • Side tokens of any epoch can never be listed as a memecoin market’s coin.