Every Solana token is a building.

00 Utility

01 Data model

A tower is a pure function of the token's live numbers. Nothing is placed by hand.

// height in city pixels, log scale so $40K and $4B fit on one screen
const height = clamp(10 * (Math.log10(Math.max(mcap, 1e4)) - 4) + 12, 10, 84) + 8;
// lit windows: a lit window is a holder
const lit = Math.min(0.95, Math.log10(holders + 10) / 5.2);
// what the roof shows
if (ageHours < 24)                      state = 'new';   // crane
else if (chg1h >= 8 || chg24h >= 30)   state = 'pump';  // beacon
else if (chg24h <= -20 || chg1h <= -10) state = 'dump';  // fire
else                                    state = 'hold';

Refreshed every 30 seconds. Heights ease to the new value, so a pump grows on screen.

02 Neighborhoods

Each neighborhood is a query over the same live token set, deduplicated so a token lives in one place.

03 Bag Square

Twelve landmarks around the bag. Each one does one job, from inside the city.

On a phone, every app opens inside Phantom, Solflare or Backpack so it can connect to your wallet.

04 Wallets

Connect is read-only. We never ask for a signature; we read the public token accounts for your address.

const programs = ['Tokenkeg…', 'Tokenz…'];            // SPL Token and Token-2022
for (const programId of programs)
  rpc('getTokenAccountsByOwner', [wallet, { programId }, { encoding: 'jsonParsed' }]);
// amount > 0  → that token's tower lights up gold
// amount == 0 → an empty account: rent you can reclaim at the Incinerator

05 Live data

browser ──▶ Cloudflare Worker (edge cache) ──┬─▶ Jupiter        market cap, holders, activity
   │                                          ├─▶ DEX Screener   pairs, liquidity, links
   │                                          ├─▶ CoinGecko      candles, trades, terminal
   │                                          ├─▶ Magic Eden     collections, floors
   │                                          └─▶ Solana node    TPS, slot, wallets, $BAG supply
   └──▶ WebSocket ──▶ Durable Object          city chat, one shared room

06 API

The city runs on these endpoints. Read-only JSON, cached at the edge. Hit Run to see a live response.

07 City chat

const ws = new WebSocket('wss://bagcity.fun/api/chat');
ws.send(JSON.stringify({ type: 'say', name: 'Neon Cabbie 33', text: 'gm' }));
// ← { type: 'hello', history: [...40], online: n }
// ← { type: 'msg', name, text, at }   every message pops a bubble on the street

• No links
• No addresses except the $BAG CA
• No team-sounding names
• 1 message / 1.5s
• 200 characters

08 $BAG

// every 10 minutes, on a Cloudflare cron, from a wallet that only ever holds the buyback share
await pumpSdk.distributeCreatorFees(BAG);          // permissionless: pays each shareholder, 30% lands here
const solIn  = await balance(SOL) - reserve;       // keeps a little SOL for fees
const bagOut = await swap(SOL, BAG, solIn);        // best Jupiter route, capped slippage
await burn(BAG, bagOut);                           // SPL burn: supply goes down, on-chain

// verify it yourself: burned = launch supply − supply now
const { value } = await rpc('getTokenSupply', [BAG]);
const burned = 1_000_000_000 - Number(value.uiAmountString);