Architecture
Why: the Play pages say what happens. This layer says which piece does it, so you know what to trust and what to check.
The pieces
| Piece | What it is | Who creates it |
|---|---|---|
| $CROWD | An ordinary pump.fun coin paired with SOL. Currency of every clan pair; the Vault holds it. | The team, once |
| Clan coin | A pump.fun coin created with $CROWD as the quote currency, a 2 % creator fee, and the clan's program account as the fee recipient. | Anyone, through the site |
| Clan account (one per clan) | A program-owned account that receives the clan's 2 % and splits it on collection: 1.2 % to the Vault, 0.6 % to the owner's balance, 0.2 % burned. It holds the fees between collections and the owner's unclaimed share. | The creator, who pays its rent |
| Registry | The list of clans created through the program, each with an X account linked. Only coins in the registry can be bought back by the Vault. | The program, at creation |
| Vault | One program-owned account in $CROWD. Receives the 1.2 %; spends only by buying back registered coins and burning them, or burning $CROWD above the cap. | The team, at deployment |
| Gas tank | SOL put in by clan creators at creation (0.1 SOL each). Covers network fees of service transactions. | Clan creators, 0.1 SOL each |
| Indexer | The team's server. Reads trades from the chain, computes standings, ranks and thresholds, and triggers finishes and buyback chunks. | The team |
| Site | The first front end. Login with a Solana wallet; X is linked only to create a clan or to have a profile. | The team |
Who does what
The indexer computes: scores of every contest, the winner, ties · the Arena threshold (20 wallets × $5) · Beef scores · dollar prices (coin → $CROWD → SOL → USD) for display · Ladder milestones (migration read from the chain; market cap in $CROWD) · ranks (minimum balance over 24 h) and OG numbers.
The program checks: the finish time (one per day) · the coin is in the registry · the order at the finish: Ladder, then places, then the Debut; what is left stays; above the cap is burned as $CROWD · each place or step ≤ 5 % of the money in the coin, in chunks ≤ 2 %, not more than once an hour · a buyback burns in the same transaction · Beef amounts go to the winner's buyback or back to the owners, and what exceeds the cap to the Vault · migrate before buying if the curve is complete · abandoned clan: last Ping, presence of the owner's $CROWD account.
Trades are read from pump.fun and PumpSwap events, from any front end. Trades where the buyer or seller is one of the program's own accounts (buybacks) are excluded from every score.
Where the trust is
Standings are computed off-chain by the team's indexer and are recomputable from the published data (see Scoring). The program does not know who won; it checks the limits above.