Accounts
woop_core's accounts for a coin: layouts, addresses and how to find them.
Every account starts with Anchor's 8-byte discriminator. Integers are little-endian. The full layouts are in the interface file; the SDK decodes them all.
Addresses
| Account | Seeds (program E9bG…ag39z) |
|---|---|
Curve (the coin's market, then its pool) | ["curve", mint] |
CurveConfig (fees, windows; one) | ["curve_config"] |
| Creator lock | ["curve_lock", mint] |
Position (a wallet in a coin) | ["curve_pos", mint, wallet] |
Order (a wallet's Fair Block order) | ["curve_order", mint, wallet] |
ExitOrder (an Exit Queue order) | ["curve_exit", mint, wallet, [slot]] |
QuotePrice (a pair token's USD price) | ["curve_price", quote_mint] |
Token accounts are associated token accounts. Coins always use Token-2022; the pair token uses its own program (Curve.quote_token_program):
| Vault | Owner | Token |
|---|---|---|
| Coin vault (the curve's coins, then the pool's) | the Curve | coin, Token-2022 |
| Quote vault (the curve's pair token, then the pool's) | the Curve | pair token |
| Lock vault (the creator's locked coins) | the creator lock | coin, Token-2022 |
Finding coins
// every woop coin: one call
const curves = await connection.getProgramAccounts(WOOP_PROGRAM_ID, {
filters: [{ memcmp: { offset: 0, bytes: bs58.encode(Buffer.from([191, 180, 249, 66, 180, 71, 51, 182])) } }],
});New coins appear as a CurveLaunched event (see indexing) and as a new Curve account.
Curve
408 bytes. The fields a trading screen needs:
| Offset | Field | Type | |
|---|---|---|---|
| 8 | mint | pubkey | The coin |
| 40 | creator | pubkey | |
| 72 | quote_mint | pubkey | The pair token |
| 104 | quote_token_program | pubkey | Token or Token-2022 |
| 136 | status | u8 | 0 created, 1 trading, 2 sold out, 3 graduated, 4 refund |
| 137 | v0 | u64 | Virtual quote the curve opens with |
| 145 | reserve | u64 | Real quote in the curve (after graduation: the pool's quote) |
| 153 | owed | u64 | The creator's launch advance still owed (priced like reserve) |
| 161 | advance | u64 | |
| 169 | sold | u64 | Coins sold off the curve (raw, 6 decimals) |
| 177 | creator_locked | u64 | The creator's locked coins |
| 233 | launched_at | i64 | |
| 243 | block_id | u64 | The current Fair Block |
| 251 | block_open | bool | A Fair Block is collecting orders: instant trades pause |
| 252 | block_closes_at | i64 | |
| 344 | pool_base | u64 | After graduation: the pool's coins |
| 352 | graduated_at | i64 | |
| 388 | refund_at | i64 | Refunds start then, if it hasn't graduated |
| 396 | opening_ends | i64 | End of the 60 s fair opening |
The rest (fees owed, the open block's totals, the creator's vesting) is in the interface file.
Price and market cap
On the curve (status 1), in raw units (pair token's smallest unit per raw coin):
price = (v0 + reserve + owed) / (1_111_111_111_111_111 − sold)After graduation (status 3) it's the pool's ratio: price = reserve / pool_base.
Multiply by 10^(6 − pair decimals) for whole units, and by 1,000,000,000 for the market cap in the pair token. The curve sells out at 760,000,000 coins (sold = 760_000_000_000_000). Every coin opens at the same USD market cap and graduates at about ten times it.
Metadata
The name, ticker and metadata URI are on the mint (Token-2022 metadata pointer and token metadata extensions). The URI's JSON has image, description, and extensions with website, twitter, telegram and banner.