How to run a token airdrop or an allowlist claim on Solana without a smart contract
An airdrop people claim needs a list, an amount for each wallet, a deadline, and a way to stop anyone claiming twice. Here that is one grant in a JSON file on loot, a Solana program every project shares. The list stays in your file, and only its Merkle root goes on chain.
Devnet by default. Everything on this page runs on Solana devnet, where nothing is real money. The same file runs on mainnet when it says "network": "mainnet", and then it is real money. The program, loot, has not been independently audited. The fees quoted are devnet’s: the player fee is 0.002 SOL there and 0.0005 SOL on mainnet (read from the chain on 2026-11-21; the platform sets it, and the program caps it at 0.01 SOL).
What this is, and what it is not
This is a claim: each wallet on the list comes to your page and signs for its share. It is not a push that drops tokens into wallets that never act. A claim costs you nothing for wallets that never show up, and what they leave stays in your pool.
What you need
Node 22 or later, and your list of wallets. No Rust, no Anchor, no Solana CLI. With an AI coding agent you type a sentence and it runs the commands below; the toolkit’s page has the install lines.
1. Say what you want
“An airdrop of my new token to the wallets on this list, a different amount for each, claimable for 30 days, one claim a wallet.”
npx -y @xgamesfun/solana@0.29.3 examples airdrop to a list of wallets2. The spec
{
"version": 2,
"network": "devnet",
"name": "Holder Airdrop",
"currency": "drop",
"tokens": [
{ "key": "sol", "source": "sol" },
{ "key": "drop", "source": "project", "name": "Drop", "symbol": "DROP", "supply": 1000000 }
],
"collection": false,
"pools": [{ "key": "airdrop", "currency": "drop", "seed": 500000 }],
"grants": [
{
"key": "airdrop",
"name": "Holder airdrop",
"prize": { "gives": "tokens", "amount": 250, "currency": "drop", "from": "pool:airdrop" },
"list": [
{ "wallet": "<a wallet's address>", "amount": 100 },
{ "wallet": "<another wallet's address>", "amount": 250 }
],
"limits": { "perWallet": 1, "until": "publish+30d" },
"fund": 0.05
}
]
}tokensmakes DROP with a fixed supply of one million. To airdrop a coin that already exists, name it by its mint instead.poolsputs half of it in a pool, which is all the airdrop can ever pay.listis the wallets, each with its own amount. The grant’samountis the most any one claim takes.limitsis one claim a wallet, and no claim after 30 days.fundis SOL that pays the small record each claim leaves, so claimers do not pay rent.
3. Check it
npx -y @xgamesfun/solana@0.29.3 check xsolana.jsonThis spec is ready. The checker says how a claim can end:
“Holder airdrop”, every way a claim ends: A claim past a limit in all (1 a wallet): refused for good.
Its prize can’t be given (its pool run dry): refused, and it keeps its round: claimed again once there
is something to give. After … UTC: no claim is taken, whatever was signed before.And it works out how far the fund goes: 0.05 SOL pays about 223 claims, at 0.00022352 SOL each. After that each claimer pays their own rent, so size fund for the wallets you expect.
4. Price it
npx -y @xgamesfun/solana@0.29.3 cost xsolana.jsonGoing live takes 3 transactions and about 0.076900046 SOL:
rent 0.01683004 SOL for 8 accounts; program fees 0.00005 SOL; network fees 0.000020006 SOL;
Token Metadata’s fees 0.01 SOL (a token’s name on chain); seeds 500000 DROP.
…
claim “Holder airdrop” (the winner, who signs every claim (anyone may pay its fees)): 0.002 SOL
fee + 0.000005 SOL network. Only the winning wallet can claim: it signs, whatever proves it won (a
voucher, a list, an open grant). …
The total includes the SOL put in grants’ funds, which pays their claims; what is left goes back to you
when a grant closes.(… marks where the output is cut.)
5. Read it the way a cheater would
npx -y @xgamesfun/solana@0.29.3 review xsolana.json- grant “Holder airdrop” (grant:airdrop)
Who: a wallet on the list
The program keeps: 1 per wallet; not after publish+30d; each round pays a wallet once; a voucher
names its wallet, grant and incarnation, so it can’t be moved or replayed; only the receiving wallet
signs the claim
Trusts off the chain: the list of 2 wallets in the spec
Most one cheater gets: 250 DROP from “airdrop”, only the 2 listed wallets: 1 per wallet, each round
once.The list is the one thing trusted off the chain: whoever writes the file decides who is on it.
6. Go live, signed on your own computer
npx -y @xgamesfun/solana@0.29.3 keygen ~/.config/xsolana/airdrop.json
npx -y @xgamesfun/solana@0.29.3 approve xsolana.json --keypair ~/.config/xsolana/airdrop.jsonkeygen makes a key file for the project and prints its address, never the key. approve lists every transaction and what it pays, ends with a code, and sends nothing; run it again with --yes and that code to send exactly what it listed. Nothing asks for a seed phrase or for the key of a wallet you already have.
7. Let people claim
npm install @xgamesfun/solanaimport { solanaApp, walletStandardSigner } from '@xgamesfun/solana/play';
const spec = await (await fetch('./xsolana.json')).json(); // the live spec, with the list, served with the page
const app = solanaApp({ spec, rpcUrl: 'https://api.devnet.solana.com', wallet: walletStandardSigner(wallet, account) });
await app.claimGrant('airdrop'); // a wallet on the grant's list signs its own claimThe app reference shows a whole page, the wallet connection included.
What else a grant can do
- Holders only. A gate on a collection in place of a list: any wallet that shows one of its NFTs claims.
- Promo codes. One key a code, any number of them, each paying once.
- A collectible instead of tokens. A badge for everyone who came, as a compressed NFT if you expect thousands.
- Vesting. The same wallet listed for several rounds, each with its own amount.
Other ways to do it
- Send the tokens yourself. A script that transfers to each wallet is the simplest thing for a short list. You pay every transfer, and the rent of every token account that does not exist yet, whether its owner ever looks.
- A Merkle distributor program. Open-source ones exist. You deploy and operate the program, and build the claim page around it.
- A shared program, as here. Nothing to deploy, and the claim is one call from your page. The trade-off: a grant can only be what the spec can say.
Questions people ask
How do I airdrop a token to a list of wallets on Solana without writing a program?
Write a grant with a "list" of wallets, an amount for each, and a pool that holds the tokens. Run xsolana check, then put it live with a key file on your own computer. Each listed wallet claims its amount from your page. It runs on loot, one Solana program that every project shares.
Does the airdrop send tokens to wallets by itself?
No. This is an airdrop people claim: each wallet signs its own claim, and tokens move then. Sending tokens to wallets that never act is not something loot does. A claim is also why an unclaimed share stays in your pool instead of landing in dead wallets.
Is the whole list stored on chain?
No. The list stays in the spec file, up to 100,000 wallets, and only its Merkle root goes on chain. What grows with the number of claimers is the fund: each claim leaves a small record, which the grant’s fund pays for.
What does an airdrop cost?
This one takes 3 transactions and about 0.077 SOL to put live: 0.05 SOL of that is the grant’s fund, which pays the small record each claim leaves and comes back when the grant closes, and 0.01 SOL is Token Metadata’s fee for naming the token. A claim costs a player fee (0.002 SOL on devnet, 0.0005 SOL on mainnet today) and a network fee.
Do claimers need SOL in their wallet?
Not if you pay their fees. Only the listed wallet can sign its claim, but anyone may pay the claim’s fees, so your server can sponsor them with @xgamesfun/solana/sponsor. The tokens still go only to the listed wallet.
Can someone claim twice, or claim for another wallet?
No. The program pays a wallet once for each round, and only the receiving wallet signs its claim. One thing to know: if you close the grant and make it again with the same list, those wallets can claim again.
Can I airdrop only to holders of an NFT collection?
Yes, two ways. Take a snapshot of holders and use it as the list. Or leave the list out and put a gate on the grant, with a limit a wallet: any wallet that shows an NFT of the collection claims, and each NFT shown is counted as well.
Does it run on mainnet?
Yes. The same file runs on mainnet when it says "network": "mainnet", and then the tokens are real. The program has not been independently audited, so try the claim on devnet first.
More how-tos
- Make a loot box or gacha: Odds, prizes and a roll nobody can steer, in one JSON file.
- Add NFT staking: Lock tiers and rewards for any collection, one you did not mint too.
- Run an NFT raffle or a lottery: The winner gets the NFT before the seller is paid; a short round refunds.
- Run an NFT auction: A reserve, a late-bid extension, and every outbid bidder refunded at once.
- Pay players token rewards: A server that checks, a voucher it signs, and caps a leaked key cannot pass.
- Add Solana to a browser game: Payments, loot boxes and token rewards in a game you already made.
- Solana MCP servers and plugins, by job: Which one for docs, programs, chain data, NFTs, wallets, trading and economies.
- Host a web game with xcore: A link anyone can play, with sign-in, saves, multiplayer and an economy.
- The whole toolkit: what else it builds, and how to install it in Claude Code, Codex, Cursor or a chat app.
Checked against @xgamesfun/solana 0.29.3 on 2026-11-21.