STONK/SOLSolanaBack
Documentation

How StonkSol works.

This page explains the whole protocol in short sentences. Read it in order. Each part uses only the words the part before it defined.

The collection 01

StonkSol is a collection of 4,444 brokers on Solana. Each broker is an NFT. Each broker has a wallet of its own.

A broker does one job. It earns a share of the money the protocol collects. Each round turns that share into the tokenized stock the holder chose.

$STONKSOL is the token of the collection. The supply is fixed at 1,975,109,136 tokens. That number is 4,444 brokers multiplied by 444,444 tokens. No wallet can make more of it.

Note: ownership is the NFT. The protocol reads the wallet that holds the broker at that moment. It never reads a name that it cached before.

TRADEswap · snipe · sellfee in SOL · 10% or 15%ANVIL VAULTfees wait here30%TREASURYpays for the work70%THE POTheld in USDCanyone opens a roundROUNDelections are countedone swap for each stockROUND VAULTstock waits hereyour broker pullsTOKENIZED STOCKin your walletone signature4,444 brokers · one pot · no push
Fig. 01The money pathEvery trade pays a fee in SOL. The pot holds the brokers' side in USDC. The round buys the stock, and your broker pulls its part.

The Anvil 02

The Anvil is the vault that trades brokers. One broker always costs 444,444 $STONKSOL. The price never moves. There is no curve and no auction.

The vault holds brokers on a shelf. You can do three things with it.

ActionWhat you getFee
SwapThe next broker on the shelf10%
SnipeThe broker you choose15%
Sell444,444 $STONKSOL back10%

You pay the fee in SOL. The fee is a percentage of the SOL value of one broker. It is not a percentage of the token price.

A snipe costs 5% more than a swap. That difference is the price of the choice. A swap gives you the broker at the front of the shelf, and a snipe gives you the one you point at.

A sell gives you back the same 444,444 $STONKSOL that a swap cost. The vault never pays less for a broker than it charges for one.

THE SHELF · 444,444 $STONKSOL EACHfront#1#2#3#4#5…SWAPfee 10%SNIPEfee 15%any slot you nameSELLfee 10%a sell goes to the tailthe price never moves · no curve · no auction
Fig. 02The AnvilThe vault holds brokers on a shelf at one price. A swap takes the front one. A snipe takes the one you point at.

Fees 03

Trade fees stay in the vault until someone collects them. Anyone can start the collection. The collection splits the fees in one step.

Goes toShareUse
The pot70%Paid to active brokers
The treasury30%Pays for the work on the protocol

Marketplace sales pay a royalty of 6.66% to the treasury. The royalty is enforced by the NFT standard, so a marketplace cannot skip it.

Activation 04

A broker earns nothing until you activate it. Activation costs $STONKSOL. The protocol burns half of that cost, and the treasury gets the other half.

There are five tiers. A higher tier takes a larger share of every round.

TierCost in $STONKSOLShare
Base44,4441.00x
T1111,1111.25x
T2244,4441.60x
T3444,4442.00x
T41,111,1113.33x

You can move a broker to a higher tier at any time. You pay only the difference between the two tiers.

Note: a broker that changes owner becomes inactive. The new owner must activate it again. This rule stops a sold broker from paying its old owner.

Payouts 05

The money from fees collects in a pot. The pot counts in USDC. Anyone can open a round.

A round freezes the USDC that the pot holds at that moment. Money that arrives after that belongs to the next round.

Each holder elects a stock from a short menu. The election tells the round where to send the share of that broker. A new election applies from the next round.

A round has three steps. First, the round counts the active brokers and their elections. Then, the round buys each elected stock once, for all the brokers that chose it. Last, each broker pulls its own stock.

A keeper service runs the first two steps. Any wallet can run them too. No single server can stop a round.

The protocol pushes nothing to anybody. Stock that nobody pulls waits in the vault of the round. A claim does not expire.

You end the claim with stock in the wallet of your broker. One more step moves the stock to your own wallet, in the same signature.

THE ROUND · TALLY, SWAP, CLAIMTHE POTUSDC, frozenONE SWAPfor each elected stockROUND VAULTstock waits for youyour claim pulls your part out of the vault — one signature, stock in your walletthe round holds the stock until you claim ita swap below the floor is refused
Fig. 03One round, three stepsThe round counts the elections, buys each stock once, and holds it. Your claim pulls your part with one signature.

Why the round buys the stock

A pot needs one unit to divide. USDC is that unit. It is a step inside the round, and it is not the thing you keep.

Three facts make one swap for each stock the better design:

  • One swap has one price. The round buys a stock once, for every broker that elected it. Many small buys would each pay a spread.
  • Every broker gets the same rate. Two brokers that chose the same stock share the same swap. Nobody can front-run one broker alone.
  • A swap has a floor. Each stock on the menu has a minimum rate per USDC. The round refuses a swap that delivers less.

Note: this is the design of the prior art on another chain. It swaps the whole round, then holds the stock until each owner claims it. StonkSol does the same, on Solana.

Note: a broker with no election is sent to the default stock. A broker can also elect USDC and skip the swap.

Loans 06

You can borrow against a broker. A loan gives you the tokens without a sale, and you keep the right to take the broker back.

To take a loan:

  1. Put the broker into escrow.
  2. Get 444,444 $STONKSOL, the full flat price.
  3. Pay the loan fee in SOL at the start.
  4. To get the broker back, repay the same 444,444 $STONKSOL.

The rate is 15% a year. The shortest term is seven days, and a shorter loan still pays for seven days. This floor stops a loan from being cheaper than a trade.

The pot gets 70% of every loan fee. The treasury gets the rest. A broker in escrow is inactive, so it earns nothing until you take it back.

Safety Deposit Box 07

The Safety Deposit Box holds liquidity positions and will not give them back before a date that the lock records.

The launch liquidity goes into this box for six months. Anyone can read the lock on chain and see the date.

Other teams can use the same box. A locker fee goes to the pot, so a lock by another team pays the brokers as well.

Stock desk 08

Stake your stocks. Get USDC.

Your broker pays you in tokenized stock. That stock then sits in your wallet and does no work. The stock desk gives it work.

To borrow against your stock:

  1. Deposit the stock you earned.
  2. Draw USDC against it.
  3. Repay the USDC to release the stock.

You keep the stock and you keep the gain on it. You do not sell it, so you do not close your position to get cash.

You can take the other side instead. Supply USDC to the desk, and earn what the borrowers pay. The rate rises when more people borrow.

Three rules make equity collateral safe to lend against:

  • One market for each stock. A fall in one market cannot reach the collateral in another.
  • A stale price stops the market. Stock feeds stop at the weekend. A market with an old price freezes instead of trading.
  • A cap for each market. The desk can never put too much of the supply behind one name.
HOLDERLENDERYOUR STOCKearned from roundsdepositUSDCfrom lenderssupplyONE MARKETone stock · one capdrawUSDC TO SPENDinterestLENDER IS PAIDyou keep the stockrepay the USDC and the stock comes back
Fig. 04The stock deskPost the stock you earned. Draw USDC against it. The stock stays yours, and you can take it back.

Note: the stock desk is planned work. It is not live. See the roadmap below.

The mint 09

The launch is a stealth launch. We do not publish a date. The terminal and the mint open at the same time.

Each wallet can mint two brokers, at no cost. You pay only the Solana network fee. This limit gives the collection a wide distribution.

A wide distribution matters here. Payouts follow brokers, so a collection in many hands pays many people.

Roadmap 10

There are no dates on this roadmap. A stealth launch announces no date. A date on a later step is a guess.

  1. 01

    Build

    done
    • Six programs are written and deployed to devnet.
    • Every program passes its verification run.
    • The art is final: 4,444 images and their metadata.
  2. 02

    Launch

    next
    • The mint opens with no published date.
    • Each wallet can mint two brokers, at no cost.
    • The Anvil opens in the same hour as the mint.
    • The launch liquidity goes into the Safety Deposit Box for six months.
  3. 03

    Payouts

    after launch
    • Holders activate their brokers and elect their stocks.
    • The first round opens when the pot holds enough USDC.
    • Each active broker pulls its own share.
  4. 04

    Stock desk

    planned
    • Holders post the stock they earned as collateral.
    • They draw USDC against it and keep the stock.
    • Lenders supply USDC and earn what the borrowers pay.
  5. 05

    Open books

    planned
    • A public page shows every fee, round and payout.
    • The treasury address and its balance stay public.
    • The activation authority moves to a multi-signature wallet.
BuildingPrograms · 6UTC