Docs

Overview

Hooxy is a Solana launchpad where every token launches with a game built in. A Token-2022 transfer hook watches every trade on the token's Meteora Dynamic Bonding Curve (DBC) and updates on-chain game state. Trading fees fill a pot, and the winner of each round takes a share of it.

The core constraint shapes the product: DBC runs transfer-hook pools only while the bonding curve is live. At graduation Meteora revokes the hook from the mint and migrates liquidity to a DAMM v2 pool with a plain Token-2022 mint. So the curve is the game. Graduation is the grand finale: the last round settles, the pot pays out, and from then on the token trades like any other.

Program id: GD2GSp6nFQqV4VHZBZe1b1FGCKPs2tbNFkRfqTzxfDwW. Meteora DBC: dbcij3LWUppWqq96dh6gJWwBifmcGfLSB5D4DuSMaqN.

How the hook works

The hook observes and never refuses. Token-2022 calls it on every transfer of a Hooxy token. It classifies the transfer, updates the game, and returns OK for every valid call, because any error would revert the trader's swap. The only calls it rejects are spoofed ones: a wrong mint or a wrong game account.

To classify, it reads the owner of the source and destination token accounts. DBC's pool authority (FhVo3mqL8PW5pH5U2CN4XE33DokiyZnUwuGpH2hmHLuM) owns the pool vaults, so:

Fees are collected in SOL (collectFeeMode: QuoteToken), so DBC never moves the token for fees or referrals. A token transfer out of the vault is always a real buy.

• Tiny by design: no CPIs, no loops over lists, no account creation, under 15k compute units.
• No allow or deny logic, so it cannot be turned into a sell blocker.
• Emits events into logs (NewLeader, TimerReset, LeaderVoided, RoundClosed) that the indexer, bots and this site read.
• Buys are valued in SOL: the hook converts the token amount with the pool's sqrt_price, so Crown ranks by SOL spent and min buys are set in SOL.

Games

5 games ship now. Each is decided in constant time inside the hook. Each card shows the classic name too, so you know what you are playing.

Anti-gaming

• Min buy, in SOL. Any size trades normally. The creator sets the smallest buy that counts for the game (default 0.01 SOL, range 0 to 0.1 SOL; 0 means every buy counts), so dust spam can't relight a fuse or pad a Bullseye count.
• Exits void leadership. In Crown and Fuse, if the leader sells or moves tokens, they lose the spot. No buy-and-dump. In Combo, any sell breaks the chain.
• Self-trading pays. Every trade pays the 2% fee, which feeds the pot, so wash trading to game a round costs more than it wins.
• Sybils are fine. Every wallet still has to be the biggest, the last, or the Nth.

Game catalog

Twelve games fit inside a DBC transfer hook. They sort into tiers by what the hook needs: tier A runs on game state alone and ships now, tier B adds opt-in player accounts, tier C needs randomness at settle time.

Not possible on DBC

DBC creates the mint itself with only the transfer-hook extension, so Splits (Scaled UI Amount) and Mortal coins (permanent delegate) would need a launch flow outside DBC. They are not on the list.

Round engine & player accounts

One round engine

Rounds, lazy rollover, settle_round, Prize and claim_prize work the same for every game. A game only decides who the current leader is; the engine handles timing and payouts. That is why each new tier A game is about half a day of work once Crown works.

The hook can also read the DBC pool (quote_reserve, sqrt_price) as an extra account, which is how Summit knows when the curve crosses a checkpoint. Overlays run on every game: the graduation jackpot is always on, and Summit checkpoints can be added on top of any primary game.

Player accounts (opt-in)

Tier B games need per-wallet state. A player account is a PDA with seeds ["player", mint, wallet], created on this site for about 0.002 SOL of rent, refunded when you close it. The hook receives the source and destination owners' player accounts as extra accounts. If one is not initialized, the hook skips it, so unregistered wallets and trading terminals still trade normally; they just don't play the tier B game.

End goals

The end goal is how much SOL the curve raises before it graduates. DBC bakes that threshold (migrationQuoteThreshold) into its immutable config, so each end goal is its own platform config: 3 configs in total, shared by every game. The game itself (Crown, Fuse, and so on) lives in the Hooxy game state and is set by init_game, not in the DBC config.

Pot & fees

Hooxy takes nothing. Of each trade's 2% fee, Meteora keeps its fixed protocol cut, the token's creator gets 25% of the rest, and everything else goes to the game's pot: about 1.20% of all curve volume. Every 100 SOL traded adds about 1.20 SOL to the prize.

The pot's share is claimed by a program PDA (["fee_authority"]), not a hot wallet, and swept on-chain straight into the game's pot vault; no wallet of ours ever holds it.

Graduation adds a migration fee to the finale. When the curve completes, DBC takes a 3% migration fee on the SOL raised, and all of it is swept into the pot: about 2.55 SOL on a Sprint game and 24.00 SOL on a Marathon game, on top of everything still in the pot. That makes the finale much bigger than any single round.

Rounds & payouts

• Lazy rollover. A round can end with no transaction at that moment, so rollover happens in whichever runs first: the hook on the next trade, or settle_round. The winner is copied to a pending slot, the round id bumps, and the new trade counts for the new round. Nobody loses a win.
• Payouts are a share of the free pot (vault balance minus prizes still owed), so the program can never promise more than it holds.
• Pull-based claims. Each settled round creates a Prize account. The winner claims it from the site, a Blink or an embed; the program unwraps wSOL into SOL.
• 7-day expiry. A prize nobody claims within 7 days goes back into the pot for the next rounds.
• Grand finale. When the curve completes, start_finale freezes the game and runs Winner Takes All. See Grand finale.

Grand finale

Winner Takes All. When the curve completes, the leader of the final round takes 100% of the pot plus the migration fee. No leader at that moment? The buy that completes the curve takes it all.

• Who wins. The leader of the final round under the game's own rules: the biggest buy for Crown, the last buyer for Fuse, the longest-combo keeper for Combo. If there is no leader at that moment (a voided crown, a Bullseye count not hit, or Summit), the buy that completes the curve wins. The hook records that graduating_buyer with the pool read it already does, so every game has a finale winner.
• Final stretch. Once curve progress passes 90%, normal round payouts stop and rounds roll over, so the whole pot builds up for the finale. Summit's 75% checkpoint still pays. Game pages show a “Final stretch” state and mark the 90% line on the curve bar.
• The prize. 100% of the free pot plus the swept partner migration fee (finale_bps fixed at 10000).
• Endless. No finale unless its ~50,000 SOL ceiling is ever reached; if it is, the same Winner Takes All runs.

Keeper & permissionless cranks

The keeper is a convenience, not a trust point. Every instruction except init_game and claim_prize is permissionless and idempotent, so if the keeper goes down anyone can settle a round, including the winner, from this site.

The keeper loops every few seconds: sweep fees about once a minute, settle rounds as they end, start the finale when the curve completes, expire old prizes hourly.

Embed, API, SDK

All game state is a public account, so any creator can show the live game on their own site. Three ways, from zero code to raw.

1. Embed widget

<script src="https://gamepad.fun/embed.js" data-mint="<MINT>" data-theme="dark" async></script>

Or as an iframe: https://gamepad.fun/embed/<MINT>. Every game page has an “Embed this game” button with the snippet filled in.

2. Public HTTP API

{
  "mint": "…", "name": "Throne Goblin", "ticker": "GOBLN",
  "mechanic": "crown", "endGoal": "sprint", "status": "live",
  "round": { "id": 14, "endsAt": 1759140000, "secondsLeft": 212 },
  "leader": { "wallet": "7xKp…3fQ", "amount": 1250000 },
  "pot": { "sol": 38.2, "nextPayoutSol": 19.1 },
  "lastWinner": { "wallet": "9aQ…", "sol": 12.4, "round": 13 },
  "curve": { "progressPct": 64.2, "graduated": false, "targetSol": 85, "raisedSol": 54.6 },
  "tradeCount": 1840, "createdAt": 1759100000
}

Try it: /api/games. It serves real on-chain games (each tagged "source": "chain").

3. TypeScript SDK

import { GamePad } from "@gamepad/sdk";

const gp = new GamePad(connection);
const game = await gp.getGame(mint);          // decoded GameState + pot balance
const stop = gp.onGameChange(mint, cb);       // accountSubscribe on GameState
const tx   = await gp.buildBuyTx({ mint, owner, solIn, slippageBps });
const ctx  = await gp.buildClaimPrizeTx({ mint, round, winner });
const url  = gp.blinkUrl(mint);               // shareable Blink

The SDK reads the chain directly and builds swaps with the hook's extra accounts already resolved. It has no dependency on our servers.

Safety & limits

• Immutable mint authority. Launches use DBC's Immutable token authority: nobody keeps mint or update authority, which removes the mint rug.
• Locked liquidity. 100% of migrated liquidity is permanently locked at graduation.
• The hook cannot block sells. It has no allow or deny logic and returns OK for every valid transfer. The worst a game bug can do is score a round wrong, not trap your tokens.
• Upgradeable and unaudited. The team holds the upgrade key for the hackathon; it gets frozen after an audit. The program hash is published.
• An emergency pot cap. The admin can cap every pot in one transaction, without a redeploy; fees above the cap wait in the curve until prizes pay out.

Known limits

• During the curve, trades must go through DBC's transfer-hook swap. Some terminals and aggregators may not route it yet, so early trading may happen on this site, Blinks and embeds only. After graduation the token trades everywhere.
• Crown ranks by SOL spent, measured at the post-swap pool price, so a buy's value is slightly generous (the price has already moved up by that buy). The effect is small and the same for everyone.
• The game only runs until graduation. After that the hook is gone.

FAQ