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.

TradesKeeperWinnerVotePad80%20%Vote closes
Fees accrue to the keeper as the coin trades. When the epoch's vote closes, 80% goes to the winning option and 20% to VotePad.
  1. 1

    The fees are locked to a keeper

    A coin launched on VotePad names its keeper as creator from the start. An existing pump.fun coin can move 100% of its fees to the keeper. See sections 3 and 4.
  2. 2

    The ballot is set at launch

    Two to five options, from buyback and burn to a named wallet. See section 5.
  3. 3

    Holders vote

    One token is one vote, signed by the wallet and free. See section 6.
  4. 4

    The epoch ends and settles

    The keeper claims the fees and executes the winner on chain. See section 9.
  5. 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.

Your wallet12,500$TKNSign messageVote: BurnSigned ✓Off chain · 0 SOLBurnAirdropLiquidity+12,500
A vote is a signed message, not a transaction. Its weight is the wallet's balance of the coin.

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.

Wallet Aholds 1,000holds 0Wallet Bholds 0holds 1,000voted 1,000voted 1,000Counted1,0002,000?same tokens twice1,000A counts itsbalance now: 0
Wallet A votes, moves its tokens to wallet B, and B votes too. At the close each vote counts for the lower of its weight and the wallet's balance now, so the tokens count once.
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. 1

    Check the lock

    The keeper confirms it still receives 100% of the coin's fees. If not, nothing runs.
  2. 2

    Count the votes

    Each vote at the lower of its weight and the wallet's balance now. The result is frozen.
  3. 3

    Claim the fees

    Accrued creator fees are collected from pump.fun, and from PumpSwap after graduation, into the keeper.
  4. 4

    Fix the amounts

    The keeper's balance above its reserve is split 80% / 20%, once.
  5. 5

    Send 20% to VotePad

    One transfer to the treasury.
  6. 6

    Execute the winner with 80%

    The option runs as described in section 10.
  7. 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.

Total supplySOLbuyburn
SOL buys the coin, every token bought is burned, and total supply shrinks.

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.

bought
The keeper's tokens are split across the 50 largest holders, pro rata: a bigger holder gets a bigger share.

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
SOLtokensPoolLPLP burned
After graduation, SOL and the coin go into the PumpSwap pool together. The LP tokens the pool issues are burned, so the liquidity can never be withdrawn.

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.

KeeperEpoch 10.0006 SOL · under the 0.001 minimumRolls overNothing is sent and nothing is lostEpoch 20.0021 SOL · enough to settleSettled80% to the winner · 20% to VotePad
Fees that are not spent stay with the keeper. The next epoch adds to them and settles the combined amount.
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.