Gumballs

A gumball is a machine full of prizes. Each spin costs a fixed price. Each spin gives you one prize, picked at random from the prizes still left in the machine. Every spin wins something. What changes is which prize you get.

You find live gumballs at rafffle.famousfoxes.com/gumballs.

Spinning a gumball

1. Open a gumball and connect your wallet.
2. Pick how many spins you want. You can do up to 10 spins at once.
3. Click to spin and approve the transaction in your wallet.
4. Watch the machine drop your prizes.

You pay the spin price in the gumball's currency for each spin. The machine runs out when every prize has been drawn.

You must claim (or sell back) the prizes you already drew before you can spin again.

Reading a gumball card

• Price is the cost of one spin.
• EV (expected value) compares the average value of the prizes left in the machine with the spin price. 0% means the prizes left are worth, on average, what one spin costs. A negative EV means they are worth less.
• Prize values come from current floor prices (NFTs) and market prices (tokens). If some prices can't be loaded, the card shows the value as a minimum (≥).

The prize list on a gumball page shows each prize, how many are left, and its floor price.

Holder-only gumballs

A creator can limit a gumball to holders of up to 3 NFT collections. To spin, you need an NFT from one of those collections in your connected wallet. An NFT moved to a staking escrow or kept in another wallet doesn't count.

Claiming your prizes

Prizes you draw stay in the machine until you claim them. Click Claim on the gumball page to send them to your wallet. You pay normal Solana network fees for the claim.

If you never claim, you don't lose the prize. When the creator collects their proceeds after the gumball ends, any unclaimed prize goes to the wallet that drew it.

Selling a prize back

Some gumballs offer buy back. If a gumball has it, you can sell a prize you just drew back to the creator instead of claiming it.

• The buy-back price is a percentage of the prize's value, which the creator picks between 60% and 98%. The gumball shows the percentage.
• Prize values for buy back are fixed when the gumball goes live. They don't follow the market after that.
• A prize whose buy-back price would be under 0.01 SOL can't be sold back.
• You have 1 hour after your latest spin to sell back. After that, you can only claim.
• You must sell back before you claim. A prize you have claimed can't be sold back.
• Buy-back payments come from funds the creator deposits in escrow, so you are paid straight away.
• You receive the full buy-back price. The 2% buy-back fee is paid by the creator from the escrow.

How a prize is picked

The gumball program picks your prize on chain when your spin transaction runs. It takes the most recent Solana slot hash and the current time, and uses them to choose one of the prizes still in the machine. That prize is then removed, so it can't be drawn again.

Nobody chooses the prize by hand, and the prize isn't known when you sign. Each spin is co-signed by the Rafffle server before it is sent, so spins only go through the Rafffle site.

You can check any spin on a Solana explorer. The spin transaction's logs show Drew item at index: N, which is the prize slot you drew.

Gumballs don't use the drand beacon that raffle draws use. See Provably fair for raffles.

Creating a gumball

Go to Create and choose a gumball, or open rafffle.famousfoxes.com/create_gumball.

Each wallet can run only one gumball at a time. End and close your current gumball before you create a new one.

Step 1: Set up the gumball

• Name: up to 32 characters.
• Start: start now (you launch it yourself once prizes are loaded) or schedule a start time. A scheduled gumball starts at that time even if you haven't loaded every prize.
• Duration: 1 to 30 days.
• Prize count: 2 to 1,000 prizes. The form shows the rent this needs.
• Price: the price of one spin, and the currency.
• Holder only mode (optional, under Advanced settings): enter up to 3 collection addresses. Only holders of those collections can spin. This costs extra; see Fees.

Read and accept the terms, then click Create Gumball and approve the transaction.

Currencies

You can price spins in SOL or in an SPL token from the Rafffle token list. The FFF team keeps this list and adds tokens over time. Only tokens enabled as a currency show up, and Token-2022 tokens can't be used for gumballs.

Step 2: Load prizes

Open the Load prizes tab. You can load:

• NFTs from verified collections: standard NFTs, programmable NFTs (pNFTs) and Metaplex Core assets.
• Tokens from the Rafffle prize token list (not Token-2022).

Compressed NFTs (cNFTs) are not supported.

Prizes move from your wallet into the gumball's escrow when you load them. The tab shows the total prize value, your maximum proceeds and the maximum ROI, so you can see if the machine is priced well.

You can remove prizes again until the gumball is live.

Step 3: Buy back settings (optional)

Turn on buy back to let winners sell prizes back to you right away. Pick the percentage of prize value you will pay (60% to 98%; default 85%). You then deposit enough SOL in escrow to cover buying back every prize, plus the 2% buy-back fee.

• You can only change buy back before the first spin. Once the gumball is live you can't turn it off.
• Prizes that winners sell back go to your wallet. With buy back on, you can top the machine up with them again from the Top-up tab while it is live.
• Any SOL left in escrow comes back to you when you close the gumball.

Step 4: Launch

From the Gumball studio tab, click Launch Gumball now once at least 2 prizes are loaded. The end time is set to launch time plus your chosen duration. A scheduled gumball launches on its own at the start time.

After launch you can't edit the gumball. You can change its end date only until the first spin. The new end date must be 24 hours to 30 days away.

Ending and closing a gumball

A gumball's sale ends when the last prize is drawn or when the end time passes. You can also end it early from the Gumball studio when one of these is true:

• No one has spun yet.
• No one has spun for at least 10 hours.
• The prizes left are worth, on average, less than 10% of the spin price (EV below −90%).

Once sales end:

1. Click Claim proceeds. This pays you the spin proceeds, sends any unclaimed prizes to their winners, and returns any prizes that were never drawn to your wallet.
2. Click Close Gumball. This returns the rent you paid at creation and any buy-back SOL left in escrow.

A closed gumball can't be restarted.

Fees

• FFF takes 5% of every spin. If you have a fox staked or on a mission when you create the gumball, the fee is 2.5%. See Fees for which foxes count. The fee comes out of each spin as it happens, so the proceeds you claim are already net of it.
• Holder-only mode costs 1 SOL when you create the gumball, or 0.5 SOL at the holder rate.
• You pay rent for the gumball account when you create it. You get it back when you close the gumball.
• Each buy back carries a 2% fee, paid by the creator from the buy-back escrow.

Creator royalties are not paid on gumball prizes. See Fees for all Rafffle fees.

Featured gumballs

The Featured row on the gumballs page shows live gumballs whose creator:

• had a fox staked or on a mission when they created the gumball (the same check as the holder rate), and
• meets the Featured standards.

Featured gumballs are ranked by EV. In the main list, gumballs from creators who meet the Featured standards are shown first.

Notifications

Rafffle doesn't send notifications for gumballs. Check the gumball page for your prizes, and the Gumball studio for your proceeds.

Addresses

Program	Address
Gumball machine (Mallow Gumball)	MGUMqztv7MHgoHBYWbvMyL3E3NJ4UHfTwgLJUQAbKGa
Gumball guard	GGRDy4ieS7ExrUu313QkszyuT9o3BvDLuc3H5VLgCpSF