Docs
How VotePad works
VotePad hands a coin's creator fees to its holders. The fees are locked to a VotePad keeper, holders vote on where they go, and every 4 minutes the keeper executes the winning option on chain: 80% to the winner, 20% to VotePad.
1Overview
On most launchpads a coin's creator fees go to one wallet, and what happens to them is up to whoever holds it. VotePad replaces that wallet with a vote. The fees still come from pump.fun, in SOL, as the coin trades; the difference is who decides what they are spent on.
Everything after the vote is mechanical. When an epoch ends the keeper counts the votes, claims the fees, sends 20% to the VotePad treasury and carries out the winning option with the rest. Each step is its own transaction, and every signature is recorded against the epoch that produced it.
- 1
- 2
The ballot is set at launch
Two to five options, from buyback and burn to a named wallet. See section 5. - 3
Holders vote
One token is one vote, signed by the wallet and free. See section 6. - 4
The epoch ends and settles
The keeper claims the fees and executes the winner on chain. See section 9. - 5
The next epoch opens
A fresh ballot with the same options starts straight away, and the cycle repeats.
2The keeper
The keeper is a wallet run by VotePad's settlement service. Every coin has its own keeper, derived from a single VotePad master key and the coin's mint address, so one coin's fees never share a balance with another's.
There is no custom VotePad contract. The keeper only calls programs that already exist on Solana: pump.fun and PumpSwap to claim fees, buy and add liquidity, and the standard token and system programs to burn and transfer. It spends a coin's fees only through the settlement steps in section 9.
That makes VotePad the custodian of the fees between epochs, and it is worth saying plainly. The keeper is what stops a creator from taking the fees before the vote is honored; in exchange, you are trusting VotePad to run the settlement it publishes. Every movement of the funds is on chain and can be checked against the ballot that caused it.
- One per coin
- Derived from the VotePad master key and the mint
- Pays network fees
- The master keeper, never the coin's fees
- Keeps back
- About 0.00089 SOL, the minimum a Solana wallet must hold
- Programs used
- pump.fun, PumpSwap, SPL Token, System
3Launching a coin
A coin launched from the launch page is a normal pump.fun coin with one difference: its keeper is set as the pump.fun creator. pump.fun pays creator fees to the creator, so from the first trade the fees accrue to the keeper and nobody else.
You still sign the launch and pay for it, and an optional first buy goes to your wallet as usual. The launch also opens a small pump.fun volume account for the keeper, which it needs later to buy on the curve; that rent is paid by the launcher, not taken from fees.
- When
- At creation, as the coin's creator
- Signed by
- The launcher's wallet and the new mint
- Fees accrue to
- The coin's keeper
- First buy
- Optional, sent as a second transaction in the same wallet prompt
4Bringing an existing coin
A coin that launched elsewhere on pump.fun can join by moving its fees with pump.fun's fee sharing. From the coin's ballot, the coin's pump.fun creator signs one transaction that makes the keeper the only shareholder, at 100%.
It has to be the whole fee. A partial share would mean the vote decides a fraction of what the coin earns while the rest goes somewhere voters cannot see, so VotePad treats anything less than 100% to the keeper as unlocked and does not settle it.
- When
- Any time after the coin exists
- Signed by
- The coin's pump.fun creator
- What we check
- The pump.fun fee-sharing config: one shareholder, the keeper, at 100%
- Before graduation
- Covers bonding-curve fees
- After graduation
- Covers PumpSwap pool fees as well
If the coin's fee sharing is already set to other wallets and can no longer be edited, it cannot join.
5The ballot
The launcher sets the ballot, between two and five options. The same options return every epoch, so a holder always knows what they are choosing between.
There are two kinds of option. Protocol options are carried out by the keeper and need no address:
- Buyback & Burn
- Buys the coin and burns it, reducing supply
- Airdrop to Top 50 Holders
- Buys the coin and shares it across the 50 largest holders
- Add Liquidity to the Pool
- Deepens the coin's pool; before graduation, buys and locks
- Send to Creator
- Sends the winning share as SOL to the wallet that launched the coin
Wallet options send the winning share as SOL to an address: a creator, a marketing wallet, a charity or any custom recipient. The address has to be a Solana wallet. An X handle can be listed, but VotePad cannot pay a handle yet, so if one wins its share rolls over (see section 11).
Section 10 covers exactly what each option does on chain.
6Voting
Anyone holding the coin can vote, and a vote costs nothing. You pick an option and your wallet signs a short message naming the coin, the epoch, the option and your address. It is a signature, not a transaction: no SOL moves and nothing is sent to the chain.
The weight of the vote is your wallet's balance of the coin, read from chain when the vote arrives. A wallet holding none of the coin cannot vote. You can change your vote until the epoch ends; the latest one replaces the earlier one, with your balance read again.
- Who can vote
- Any wallet holding the coin
- Weight
- One token, one vote
- Cost
- None. A signed message, not a transaction
- Changing your vote
- Allowed until the epoch ends
- Signature valid for
- 10 minutes after signing
7How votes are counted
Votes are counted when the epoch ends, not when they are cast. At that moment each vote counts for the lower of its weight when cast and the wallet's balance now.
This is what stops one bag voting twice. Without it, a holder could vote, move the tokens to a second wallet and vote again. With it, tokens that have left a wallet stop counting for that wallet's vote.
- Winner
- The option with the most counted votes
- A tie
- Goes to the option listed first
- No votes
- No winner; the fees roll over
- Once counted
- The result is frozen and cannot change on a retry
8The 80/20 split
Every settlement divides the same way. There is no discretion in it and no tier that changes it.
- To the winning option
- 80%
- To VotePad
- 20%, sent to the VotePad treasury
- Applied
- Per settlement, to the fees the keeper holds at that moment
- Fees we add
- None. The 20% is the whole of it
Network fees and account rent for settlement are paid by VotePad's master keeper. They do not come out of either share.
9How settlement works
An epoch lasts 4 minutes. When it ends, a scheduler settles every coin that is due. Settlement is also permissionless: anyone who opens the coin's page after the epoch ends triggers it, and the keeper decides everything else - the winner, the amounts and the recipients - from on-chain state.
- 1
Check the lock
The keeper confirms it still receives 100% of the coin's fees. If not, nothing runs. - 2
Count the votes
Each vote at the lower of its weight and the wallet's balance now. The result is frozen. - 3
Claim the fees
Accrued creator fees are collected from pump.fun, and from PumpSwap after graduation, into the keeper. - 4
Fix the amounts
The keeper's balance above its reserve is split 80% / 20%, once. - 5
Send 20% to VotePad
One transfer to the treasury. - 6
Execute the winner with 80%
The option runs as described in section 10. - 7
Open the next epoch
The epoch is archived with every transaction signature, and a new ballot starts.
A step can fail. RPC providers go down and markets move. A failed settlement keeps every step that already succeeded and resumes from the one that did not, so nothing is paid twice and no fees are lost in the meantime.
10What each option does
Buyback & Burn
The keeper buys the coin with the winning share - on the bonding curve before graduation, in the PumpSwap pool after - then burns every token it bought. A burn removes tokens from the mint, so total supply goes down, and the new supply is recorded with the epoch.
Airdrop to Top 50 Holders
The keeper buys the coin, then splits what it bought across the 50 largest holders in proportion to their balances. Program accounts such as the bonding curve and the pool are left out, as are the keeper, VotePad and the burn address, so the tokens only go to people. Transfers go out in batches of ten.
Add Liquidity to the Pool
What this does depends on whether the coin has graduated, because before graduation there is no pool to add to.
- Before graduation
- Buys the coin on the bonding curve and sends it to the burn address, where it can never be sold
- After graduation
- Buys the coin with about half the share and deposits it, with the other half as SOL, into the PumpSwap pool
- LP tokens
- Burned in the same transaction as the deposit, so the liquidity can never be withdrawn
- Leftovers
- Tokens the deposit could not pair go to the burn address; unused SOL rolls over
Send to Creator
Holders can choose to reward the creator. The winning share is sent as SOL to the wallet that launched the coin, in a single transfer, after VotePad's 20% - the same 80% / 20% split as every other option. The address is fixed at launch from the launching wallet, so it cannot be pointed anywhere else later.
Wallet options
The winning share is sent as SOL to the address on the ballot in a single transfer. If the address is not a Solana wallet, nothing is sent and the share rolls over.
11When fees roll over
Fees that are not spent stay with the keeper and are part of the next epoch's pool. Nothing expires and nothing is redirected; the next settlement simply has more to distribute.
- No votes
- All fees roll over
- Below the minimum
- Under 0.001 SOL available, all fees roll over
- Fees not locked
- Nothing runs; the epoch closes with a note
- Winner is not a wallet
- VotePad takes its 20%; the 80% rolls over
12The verified badge
A coin's creator can earn the verified badge by burning 10,000,000 of the coin, 1% of the standard supply, from the coin's page. The burn is an ordinary token burn, visible on chain.
The badge shows the creator was willing to destroy part of their own holding. It does not change the split, the vote or how the coin settles.
13If a coin is not settling
Settlement is automatic, so an epoch that closed without paying out has hit one of a short list of conditions. The epoch history on the coin's page says which.
- Fees not locked
- The coin's fees still go to the creator, or fee sharing names other wallets. See section 4.
- No votes
- Nobody voted, so there was no winner.
- Too little in fees
- Less than 0.001 SOL was available. It carries to the next epoch.
- Recipient is not a wallet
- The winning option lists something other than a Solana address.
- Between curve and pool
- The bonding curve has completed but the PumpSwap pool is not live yet. It retries.
- A step failed
- The network or market got in the way. The next run resumes where it stopped.
14Glossary
- Creator fees
- What pump.fun pays a coin's creator from trading in that coin, in SOL.
- Keeper
- The VotePad-run wallet that receives one coin's creator fees and executes its settlements.
- Fee sharing
- pump.fun's setting for splitting a coin's creator fees across wallets. How an existing coin locks to its keeper.
- Epoch
- One voting round, 4 minutes long, ending in a settlement.
- Ballot
- The options holders choose between. Set at launch, repeated every epoch.
- Settlement
- The on-chain steps that claim an epoch's fees and carry out the result.
- Graduation
- When a coin completes its bonding curve and moves to a PumpSwap pool.
- Burn address
- An address nobody holds the key to. Tokens sent there can never move again.
- LP tokens
- The receipt a pool issues for added liquidity. Burning them makes the liquidity permanent.
- Treasury
- The VotePad wallet that receives the 20% protocol share.