snowball
Documentation

How Snowball works

Everything that happens to a creator fee, from the trade that pays it to the $SNOWBALL it burns. Plain words first, contract calls where they matter.

01

Overview

Snowball turns a token’s creator fees into activity for that token. Every token launched on Montra, Elysium’s launchpad, pays a fee on each trade, and part of that fee belongs to the token’s creator. Normally the creator claims it and keeps it. With Snowball the fee is paid to a vault contract the creator owns, and a keeper puts it back into the token: as trading volume, or as buybacks that burn supply.

A small cut of every cycle, 0.5%, is paid to the Snowball burner, which buys the platform token $SNOWBALL on Montra and burns it. The more tokens run on Snowball, the more is burned.

One rule shapes everything else: Snowball never holds a creator’s private key. The fees sit in a contract you control, and you can leave at any time. Snowball is an independent project built for Elysium; it is not affiliated with any similarly named project on another chain.

02

How it works

  1. Point the fees. Launch through Snowball (the new token names its vault as fee recipient from the first block) or register a token you already run: Snowball creates the vault, then you call Montra’s updateRecipient to pay it.
  2. Harvest. About every 85 minutes, or sooner once enough has built up, the keeper calls vault.harvest(), which claims the fees from Montra’s hook into the vault. Anyone may call it.
  3. Fund. In Volume and Omega mode the keeper sends a random split of the vault’s HYPE to the token’s four trader wallets, about every 46 minutes. The vault can send HYPE nowhere else.
  4. Cycle. Every five minutes or so each funded trader wallet buys with most of its HYPE, then sells in ten to thirteen smaller pieces two to three seconds apart, returning roughly what it bought.
  5. Burn. After each cycle the wallet pays 0.5% of the cycle’s size to the Snowball burner. When the burner has enough, it buys $SNOWBALL on Montra and burns it.

Every one of these steps is a transaction on Elysium, and the site reads them back from the chain: the status page shows when each last happened.

03

Modes

The creator picks a mode when the vault is made and can switch at any time from the dashboard or the bot.

Volume
Fees fund the four trader wallets, whose buy-then-sell cycles keep the chart moving and the token visible.
Omega
Volume, plus each cycle the trader wallets burn half of the tokens they hold, so supply shrinks as it trades.
Buyback
No trader wallets: the keeper calls vault.buyback, which pays 0.5% to the burner, buys the token with the rest at no more than 3% slippage, and burns every token bought.
04

Getting started

On Telegram

Open @elysnowballbot and send /start. The bot derives a wallet for you; fund it with a little HYPE on Elysium for gas and a first buy.

/deploy
Launch a new token on Montra step by step: name, symbol, picture, links, fee tier and mode.
/register <token>
Move a token you created to Snowball: creates its vault and points its fees there.
/tokens
Your tokens, with buttons to switch mode, pause, withdraw or leave.
/wallet
Balance, deposit address, withdraw, and export your key.
/dashboard
A one-time link that signs you in to the web dashboard for five minutes.

On the web

The dashboard works with a browser wallet (Rabby, MetaMask, any EIP-6963 wallet), a local wallet kept in your browser, or a Telegram sign-in. It does everything the bot does, and you sign each transaction yourself.

05

Fees

Montra pool fee
Chosen at launch: 1%, 2%, 3%, 5% or 10% of every trade, paid in HYPE. A recipient can lower it later or lock it.
Montra’s share
0.4% of every trade always goes to Montra’s protocol (70% buys back and burns MONTRA, 30% to its treasury). Nobody but Montra can waive it.
Liquidity providers
Once a pool passes Montra’s LP line, up to 1% of each trade is shared with liquidity providers.
Creator fee
Everything else, in HYPE. This is what the vault harvests.
Snowball
0.5% of each volume cycle’s size and of each buyback, paid to the burner and spent only on burning $SNOWBALL. Nothing else.
Gas
The keeper pays for harvests, funding and buybacks. Trader wallets pay their own trades’ gas from the HYPE they were sent.

What volume really costs

Every bot trade pays the pool’s fee like any other trade. With a 2% pool, a cycle that buys and sells back 1 HYPE pays about 0.04 HYPE in fees and a little gas. Most of that fee is the creator’s share, so it flows back into the vault at the next harvest and funds the next cycle. That loop is the compounding. The 0.4% to Montra, the 0.5% to the burner, gas and price impact are what the volume really costs.

06

Contracts

All on Elysium (chain 99901), with source verified on the explorer. Snowball’s own contracts are small: a factory that makes one vault per token, the vault, the burner and the Fight leaderboard.

The vault’s functions

  • harvest(), anyone: claims the pool’s creator fees into the vault.
  • fund(amounts), keeper only, Volume and Omega: sends HYPE to the four trader wallets fixed in the vault.
  • buyback(amountIn, minOut), keeper only: 0.5% to the burner, the rest buys the token, every token bought is burned.
  • setMode, setPaused, setTraders, withdraw, lowerFee, lockFee, exit: owner only.

Montra’s own reference: montramarkets.xyz/docs.

07

Trust model

You hold
The vault. Only its owner can pause it, change its mode or trader wallets, withdraw its HYPE, lower or lock the pool fee, or exit.
Exit
exit(to) harvests once more, points the pool’s fees at to and sends the vault’s HYPE there, in one transaction. Montra needs no second signature.
The keeper can
Claim fees into the vault, send the vault’s HYPE to its four trader wallets, and run buybacks with a slippage limit. It cannot send HYPE anywhere else.
Snowball’s server holds
The keys of the trader wallets. HYPE sent to them is spent on cycles; leftovers are swept back to the vault when a vault is paused, leaves, or switches to Buyback.
Nobody holds
Your private key. Snowball never asks for one. Telegram users get a wallet derived for them, which they can export.
08

Risks

  • Memecoins are speculative. Most go to zero, and nothing here changes that.
  • Volume from fees is not demand. It spends fees on trading costs and can make a chart look busier than the market behind it.
  • Smart contracts can have bugs. Snowball’s contracts are small and verified, but they are not audited.
  • Snowball depends on Montra’s contracts and API, on Elysium (a young chain), and on its keeper staying online. If the keeper stops, the fees simply wait in the vault.
  • HYPE sent to trader wallets is controlled by Snowball’s server until it is spent or swept back.
  • Trading costs are real: every round trip pays the pool fee, gas and price impact, even though most of the fee comes back.
09

FAQ

Do I need to send Snowball my private key?
No, never. Registering takes two transactions you sign: creating the vault and pointing your pool’s fees at it.
Can I stop?
Yes. Pause from the dashboard or the bot to stop everything at once, or exit to take the fees and the vault’s HYPE back.
How often does it trade?
Harvests about every 85 minutes, funding about every 46 minutes, and each trader wallet runs a cycle about every five minutes while it has HYPE.
Does volume make my token go up?
No. Cycles buy and then sell back about the same amount. They make a token active and visible; price is up to the market.
Which tokens can join?
Any Montra token paired with HYPE whose creator fee you control: one created through Snowball, or one you launched yourself.
Where is $SNOWBALL?
The burner collects HYPE until $SNOWBALL is set on it; from then on every burn appears on the landing page and the status page.
Does bot volume earn Montra points?
Do not count on it. Montra’s airdrop counts wallets acting as one as one, and its builder rewards exclude wash trades.
Is there a database?
No. Everything on this site is read from Elysium, Montra’s public API and the explorer.
10

Public API

Read-only, no key, open to any origin, cached for a few seconds. Amounts are integer strings in wei; times are milliseconds.

GET /api/stats
Tokens, active tokens, users, volume made, HYPE paid to the burner, $SNOWBALL burned.
GET /api/tokens
Every token, with its vault totals and four trader wallets. ?limit, ?offset, ?sort=top|active|recent, ?q.
GET /api/tokens/top|active|recent
The same list, sorted by market cap, by last activity (running vaults only), or newest first.
GET /api/tokens/{token}
One token in full: vault state and balances, trader wallets with balances, recent activity.
GET /api/tokens/{token}/candles
Price candles from Montra. ?interval=1m|5m|15m|1h|4h|1d.
GET /api/workers/status
Every service’s state, note, last activity and figures.
GET /api/events
Server-sent events: connected, token, fee, volume, burn, token_update.

Try /api/stats in your browser.