@floorlaunchpad/sdk-solana 0.0.0-stage → 0.1.0

package/dist/predict.js

@@ -0,0 +1,403 @@
+/**
+ * `predict`: the graduation accounts a sale buy needs before it is sent.
+ *
+ * - `graduationAccounts`: the 29 fixed accounts graduation reads (`hook_programdata` at 4, `pool_index_entry` from the
+ *   pool key, `graduation_rent` at 28) then the tick arrays — and the rent the final buyer pays, from which `buildBuy`
+ *   sets `max_graduation_lamports` = rent × 1.1. The bid's arrays cover every tick its band can take, out to
+ *   `graduationFloorBound` — the floor solved on the vault LESS the pool's `min_bid` reserve.
+ *
+ * ⛔ Every address is DERIVED, then cross-checked against what the chain recorded (`Launch.amm_pool`,
+ *    `Launch.floor_pool`); a disagreement throws by name instead of building a transaction against the wrong pool.
+ */
+import { AccountRole } from '@solana/kit';
+import { BID_BAND_TICKS, FLOOR_TICK_SPACING, PLATFORM_BPS, SALE_TOKENS, SALT_BID, SALT_SEED, SALT_STAIR_RESERVE, SALT_STAIR_STEP0, SALT_STAIR_TAIL, } from "./constants.js";
+import { DYNAMIC_FEE_FLAG, MAX_TICK, MIN_TICK, SPL_TOKEN_PROGRAM_ID, SYSTEM_PROGRAM_ID, WSOL_MINT, MINT_POOL_COUNT, POOL, POOL_INDEX_ENTRY, POSITION, TICK_ARRAY_LEN_V2, findAmmConfig, findApprovedHook, findBitmap, findEventAuthority, findMintExclusivity, findMintPools, findQuoteMint, findPool, findPoolIndexEntry, findPosition, findProgramData, findTickArray, findVault, bitmapAccountLen, ceilToSpacing, floorToSpacing, getSqrtPriceAtTick, tickArrayStartIndex, } from '@floorlaunchpad/carpenter-sdk';
+import { DEFAULT_PROGRAM_IDS, findFloorPool, findGraduationRent, findHookAuthority, findHookConfig, findLaunch, findLaunchConfig, findStairState, } from "./pda.js";
+import { openTick, stairEdge } from "./tickmath.js";
+/** An Anchor account's on-chain length: the 8-byte discriminator over the layout's struct size. */
+const accountLen = (layout) => 8 + layout.size;
+/**
+ * Account lengths the final buy creates. ⛔ Lengths, never lamports: rent is read at runtime.
+ * ⛔ DERIVED from the layouts, never typed — the program derives its own the same way (`graduation_rent.rs`
+ *    `POSITION_LEN = 8 + Position::SIZE`). The two token-account lengths are SPL / Token-2022 shapes and stay written out.
+ */
+export const GRADUATION_ACCOUNT_LENS = {
+    pool: accountLen(POOL),
+    vaultSplToken: 165,
+    /** A Token-2022 account for a Pausable mint: 165 + account_type + a zero-length `PausableAccount` TLV. */
+    vaultToken2022Pausable: 170,
+    /** The base vault of a HOOKED launch mint — 170 + the 5-byte `TransferHookAccount` TLV (`floor_launch` `base_vault_len`). */
+    vaultToken2022PausableHooked: 175,
+    poolIndexEntry: accountLen(POOL_INDEX_ENTRY),
+    mintPoolCount: accountLen(MINT_POOL_COUNT),
+    position: accountLen(POSITION),
+    /** The `StairState` account, `8 + floor_types::layout::StairState::SIZE` (584). */
+    stairState: 8 + 584,
+    /** An owner pool's `StairState` carries the owner books' 440-byte tail —
+     *  `floor_types::owners::STAIR_STATE_ACCOUNT_LEN_WITH_OWNERS` (a team-buy launch, `$FLOOR`'s genesis). */
+    stairStateWithOwners: 8 + 584 + 440,
+    /** A tick array as created: the 3,888-byte body, then its 32-byte rent owner (3,920). */
+    tickArray: TICK_ARRAY_LEN_V2,
+};
+/**
+ * The bid window: how far above the open tick the graduation bid is ASSUMED to land without a pool's `min_bid`.
+ * ⚠ `[est.]`: a wSOL launch's day-one bid ≈ 96 % of open, ≈ 408 ticks; 1,200 ticks (≈ 11 %) covers it with margin and
+ *   adds at most one tick array at spacing 60.
+ * ⛔ A FLOOR, NEVER THE WHOLE ANSWER: graduation's ratchet solves the floor on `vault − min(vault, min_bid)`, and a
+ *   token-quoted launch's `min_bid` can be a large share of its vault (one share of a stock quote), which lands the bid
+ *   outside this window (`AccountNotEnoughKeys`, 3005, inside `floor_hook::Ratchet`). The window reaches
+ *   {@link graduationFloorBound} whenever that is further, and is never narrower than this.
+ */
+export const GRADUATION_BID_WINDOW_TICKS = 1_200;
+/**
+ * Slack on the sellable supply in {@link graduationFloorBound}: `SALE_TOKENS / 10,000` (≈ 1 tick).
+ * At graduation the ratchet's `sellable(t ≥ open) = C − pol_base` is `SALE_TOKENS` plus the POL's and
+ * the ladder's liquidity-rounding dust (`graduate.rs` steps 6–7: the POL's refund is re-deposited as
+ * ladder and cancels; what is left is each position's `amount1(L)` rounding). That dust is at most
+ * `(√p_b − √p_a)/2^64 + 1` base units per position — ≈ 1.5e9 at the highest admissible open
+ * (443,516), 2.7e-6 of the sale — so 1e-4 of the sale covers it 37× over.
+ */
+const SELLABLE_SLACK_DIVISOR = 10000n;
+/** `floor_math::position::quote_cost`: quote units to buy `base` at `tick`,
+ * `floor(floor(base·2^64/sp)·2^64/sp)` — the solve's own cost function, exact. */
+function quoteCost(base, tick) {
+    const sp = getSqrtPriceAtTick(tick);
+    return (((base << 64n) / sp) << 64n) / sp;
+}
+/**
+ * The CHEAPEST (highest) tick graduation's ratchet can publish as the floor, i.e. the furthest above
+ * the open the bid band `[floor − W, floor]` can land — from what the launch fixed at create
+ * (`price_x64`) and the pool's own `FloorPool.min_bid` (the quote's base units). Pure: no read.
+ *
+ * It is `floor_math::solve::solve_floor_tick_with` (the bisection, step for step) then
+ * `band::publish`, run on the two WORST inputs the ratchet can meet at graduation:
+ * - `q = backing_at_sellout(price_x64, PLATFORM_BPS) − min_bid` — the LEAST quote the solve can see.
+ *   The vault is `intake(seedable − team_owed)`; step 4 requires `seedable ≥ raised + team_owed` (the sale's FLOOR
+ *   Platform fee goes to the pool's `team_owed`, never through `intake`); the bound below still holds, `seedable − team_owed ≥ raised ≥ floor(SALE·p/2^64)` (`graduate.rs`
+ *   step 4; a buy rounds its cost UP and a sell-back never pays out more than its tokens cost, so
+ *   `contributed / allocation ≥ p` for every buyer); `intake` is monotone in its input and
+ *   `PLATFORM_BPS` is the only cut `register_pool` admits; the reserve is `min(vault, min_bid) ≤
+ *   min_bid`; and nothing leaves the vault before the solve — no bounty (`unpaid_skim` is 0: no swap
+ *   precedes graduation), no teardown (no position exists yet). A donation only RAISES `q`.
+ * - `sellable = SALE_TOKENS + SALE_TOKENS/10,000` — the MOST supply the bid must absorb above the
+ *   open (`SELLABLE_SLACK_DIVISOR`).
+ * `quote_cost` falls with the tick and rises with the base, so the smallest grid tick whose cost on
+ * these inputs fits `q` is at or above the one the real solve finds: the real floor can only be
+ * DEARER (a lower tick) than this, never cheaper.
+ * ⚠ `q ≤ 0` (a launch created with `backing == min_bid`, which `create_launch` admits) returns the
+ *   top of the grid — the floor stays undefined and a bid, if placed, sits there — and the window it
+ *   implies is dozens of arrays: correct, and too large for one transaction.
+ * ⚠ Assumes `min_sellable` ≤ the circulating supply at graduation. Above it the solve keeps the undefined floor and this does not apply.
+ */
+export function graduationFloorBound(args) {
+    const s = args.spacing ?? FLOOR_TICK_SPACING;
+    // The LAUNCH's own `sale_tokens` when known; `SALE_TOKENS` otherwise.
+    const sale = args.saleTokens ?? SALE_TOKENS;
+    const raised = (sale * args.priceX64) >> 64n; // sale.rs backing_at_sellout
+    const backing = raised - (raised * BigInt(PLATFORM_BPS)) / 10000n;
+    const q = backing - args.minBid;
+    const base = sale + sale / SELLABLE_SLACK_DIVISOR;
+    let hi = ceilToSpacing(MAX_TICK, s); // solve.rs :946
+    let lo = ceilToSpacing(MIN_TICK, s); // :947
+    if (q > 0n && quoteCost(base, hi) <= q) {
+        // :954-961. (`q ≤ 0` is `vault ≤ reserve`: no solve, the floor stays `ceil_to_spacing(MAX_TICK)`;
+        // `cost(hi) > q` is :952. Both leave `hi`.)
+        while (hi - lo > s) {
+            let mid = ceilToSpacing(lo + Math.floor((hi - lo) / 2), s);
+            if (mid >= hi)
+                mid = hi - s;
+            if (mid <= lo)
+                mid = lo + s;
+            if (quoteCost(base, mid) <= q)
+                hi = mid;
+            else
+                lo = mid;
+        }
+    }
+    return ceilToSpacing(hi + ceilToSpacing(BID_BAND_TICKS, s), s); // band::publish
+}
+/**
+ * Graduation's ladder range, as `graduate.rs::ladder_range(open)` computes it:
+ * `[ceil_to_spacing(MIN_TICK), floor_to_spacing(open)]`, the POL's own edges (so the POL's two arrays), which
+ * `seed_inventory` STORES and places nothing over.
+ */
+export function ladderRange(openTick, s = FLOOR_TICK_SPACING) {
+    return [ceilToSpacing(MIN_TICK, s), floorToSpacing(openTick, s)];
+}
+/**
+ * The names of graduation's 29 fixed accounts, in order — `programs/floor_launch/src/graduate.rs`'s `idx::*` constants.
+ * The tick arrays follow them.
+ */
+export const GRADUATION_ACCOUNT_NAMES = [
+    'launch_config',
+    'carpenter_amm',
+    'amm_config',
+    'approved_hook',
+    'hook_programdata',
+    'pool',
+    'bitmap',
+    'vault0',
+    'vault1',
+    'pool_index_entry',
+    'wsol_mint',
+    'spl_token',
+    'mint_exclusivity0',
+    'mint_exclusivity1',
+    'mint_pools0',
+    'mint_pools1',
+    'floor_hook',
+    'hook_config',
+    'floor_pool',
+    'hook_authority',
+    'position_seed',
+    'position_bid',
+    'system_program',
+    'amm_event_authority',
+    'hook_event_authority',
+    'wsol_vault',
+    'graduation_rent',
+    // The AMM quote roster: two REQUIRED trailing slots on `initialize_pool` — the QUOTE's entry, then the base mint's.
+    'quote_mint0',
+    'quote_mint1',
+    // The pool's StairState and the three positions the graduating buy opens on a staircase pool — step 0, the reserve,
+    // the open tail.
+    'stair_state',
+    'position_stair_step0',
+    'position_stair_reserve',
+    'position_stair_tail',
+];
+/**
+ * Graduation's POL range, as `graduate.rs::pol_range(open)` computes it: `[ceil_to_spacing(MIN_TICK, s),
+ * floor_to_spacing(open, s)]` — the FULL-RANGE tail, with the `upper <= lower → upper = lower + s` defence (unreachable
+ * at every spacing). Graduation seeds the tail, so the array at the bottom of the grid (`start_index` −446,400 at spacing
+ * 60) is in EVERY graduation's set; a list without it fails `AccountNotEnoughKeys` naming `tick_array`.
+ */
+export function polRange(openTick, s = FLOOR_TICK_SPACING) {
+    const lower = ceilToSpacing(MIN_TICK, s);
+    let upper = floorToSpacing(openTick, s);
+    if (upper <= lower)
+        upper = lower + s;
+    return [lower, upper];
+}
+/**
+ *  `launch` is the decoded `Launch`; `rent` reads rent at runtime (`rentFromRpc`).
+ * `existing` lists addresses already created (e.g. a tick array an outside LP opened), whose rent
+ * the buyer will not pay.
+ */
+export async function graduationAccounts(args) {
+    const ids = args.ids ?? DEFAULT_PROGRAM_IDS;
+    const { mint } = args.launch;
+    const s = FLOOR_TICK_SPACING;
+    const quoteMint = args.quote?.mint ?? WSOL_MINT;
+    const quoteProgram = args.quote?.tokenProgram ?? SPL_TOKEN_PROGRAM_ID;
+    const pool = (await findPool({ mint0: quoteMint, mint1: mint, fee: DYNAMIC_FEE_FLAG, tickSpacing: s, hook: ids.floorHook }, ids)).address;
+    if (pool !== args.launch.ammPool)
+        throw new Error(`graduationAccounts: derived pool ${pool} != Launch.amm_pool ${args.launch.ammPool}`);
+    const floorPool = (await findFloorPool(pool, ids)).address;
+    if (floorPool !== args.launch.floorPool)
+        throw new Error(`graduationAccounts: derived floor_pool ${floorPool} != Launch.floor_pool ${args.launch.floorPool}`);
+    const open = openTick(args.launch.priceX64);
+    if (open !== args.launch.openTick)
+        throw new Error(`graduationAccounts: open_tick(price_x64) = ${open} but Launch.open_tick = ${args.launch.openTick}`);
+    const stairSteps = args.stairSteps ?? args.floorPool?.stairSteps ?? 0;
+    if (!Number.isInteger(stairSteps) || stairSteps < 1) {
+        throw new Error(`graduationAccounts: needs the pool's \`stairSteps\` (\`floorPool.stairSteps\`, or \`stairSteps\`; got ${String(stairSteps)}) — every pool is a staircase, and graduation's buy places it, so a list without its arrays is refused AccountNotEnoughKeys`);
+    }
+    // Tick arrays: the BOUNDS of every position graduation opens (a ModifyPosition needs only the
+    // arrays of its two bounds): the POL (`polRange`, the full-range tail — its lower bound
+    // is the bottom array of the grid, ~440,000 ticks below `open`, ONE extra array, never the run
+    // up to it), the ladder's stored edges (the POL's own two), the bid, and the staircase's inner edges.
+    const [seedLower, seedUpper] = polRange(open, s);
+    const [ladderLower, ladderUpper] = ladderRange(open, s);
+    // deploy_bid: lower = max(floor_tick − W, ceil_to_spacing(current + 1)), upper = floor_tick; the
+    // market is the open (nothing swaps before graduation) and the closing clamp keeps the floor at or
+    // above `stand = ceil_to_spacing(open + 1 + W)` (ratchet.rs). So the bid's two bounds lie in
+    // `[bidFloor, floor]`, and `floor` is at most `graduationFloorBound` (or `stand`, which the fixed
+    // window below always covers: `stand ≤ bidFloor + W + s`).
+    const band = ceilToSpacing(BID_BAND_TICKS, s);
+    const bidFloor = ceilToSpacing(open + 1, s);
+    const span = 60 * s;
+    const starts = new Set();
+    for (const t of [seedLower, seedUpper, ladderLower, ladderUpper])
+        starts.add(tickArrayStartIndex(t, s));
+    // the arrays of the staircase's inner edges — `graduate.rs::stair_array_starts`, the
+    // one spelling graduation asks and `prepare_graduation` plants.
+    {
+        const openEdge = floorToSpacing(open, s); // a staircase reads no minimum start (graduate.rs step 7)
+        for (const i of [1, stairSteps])
+            starts.add(tickArrayStartIndex(stairEdge(openEdge, i, s), s));
+    }
+    if (args.bidLowerHint !== undefined) {
+        // [lower, lower + W] spans at most two arrays (W < 60·s), so its two ends name them both. It was
+        // `lower + s` — the one-spacing bid that predates the band.
+        const lower = Math.max(args.bidLowerHint, bidFloor);
+        starts.add(tickArrayStartIndex(lower, s)).add(tickArrayStartIndex(lower + band, s));
+    }
+    else {
+        const quoted = quoteMint !== WSOL_MINT;
+        if (quoted && !args.floorPool) {
+            throw new Error(`graduationAccounts: a launch quoted in ${quoteMint} needs \`floorPool\` (its FloorPool's min_bid) — graduation holds that reserve back before it solves the floor, and a token quote's reserve can put the bid past the fixed ${GRADUATION_BID_WINDOW_TICKS}-tick window (AccountNotEnoughKeys in floor_hook::Ratchet)`);
+        }
+        // The historical window is the FLOOR of the prediction, never narrowed; the reserve-derived bound
+        // extends it wherever it is further (a stock quote's one-share `min_bid`).
+        let highest = bidFloor + GRADUATION_BID_WINDOW_TICKS + s;
+        if (args.floorPool) {
+            highest = Math.max(highest, graduationFloorBound({
+                priceX64: args.launch.priceX64,
+                minBid: args.floorPool.minBid,
+                spacing: s,
+                ...(args.launch.saleTokens !== undefined ? { saleTokens: args.launch.saleTokens } : {}),
+            }));
+        }
+        const from = tickArrayStartIndex(bidFloor, s);
+        const to = tickArrayStartIndex(highest, s);
+        for (let st = from; st <= to; st += span)
+            starts.add(st);
+    }
+    const tickArrayStarts = [...starts].sort((a, b) => a - b);
+    return assembleGraduation({
+        mint, pool, floorPool, quoteMint, quoteProgram, open, tickArrayStarts,
+        launchAddress: args.launchAddress ?? (await findLaunch(mint, ids)).address,
+        wsolVault: args.launch.wsolVault, quoted: !!args.quote, stair: true, rent: args.rent, ids,
+        // a launch with team steps graduates into an owner pool (its StairState carries the books)
+        ownerBooks: (args.launch.teamStepTokens ?? 0n) > 0n,
+        ...(args.existing ? { existing: args.existing } : {}),
+        ...(args.hooked ? { hooked: true } : {}),
+    });
+}
+/**
+ * The list once its tick arrays are chosen: the 32 fixed accounts, the arrays (writable), and the
+ * rent of everything graduation creates ({@link graduationAccounts}: a sale's final buy and `prepare_graduation` send
+ * the same list).
+ */
+async function assembleGraduation(args) {
+    const { mint, pool, floorPool, quoteMint, quoteProgram, open, tickArrayStarts, launchAddress, ids } = args;
+    const s = FLOOR_TICK_SPACING;
+    const hookAuthority = (await findHookAuthority(ids.floorHook)).address;
+    const [launchConfig, ammConfig, approvedHook, programData, bitmap, vault0, vault1, poolIndexEntry, excl0, excl1, pools0, pools1, hookConfig, posSeed, posBid, ammEvents, hookEvents, graduationRent, quoteMint0, quoteMint1, stairState, posStairStep0, posStairReserve, posStairTail,] = await Promise.all([
+        findLaunchConfig(ids),
+        findAmmConfig(ids),
+        findApprovedHook(ids.floorHook, ids),
+        findProgramData(ids.floorHook),
+        findBitmap(pool, ids),
+        findVault(pool, quoteMint, ids),
+        findVault(pool, mint, ids),
+        findPoolIndexEntry(pool, ids),
+        findMintExclusivity(quoteMint, ids),
+        findMintExclusivity(mint, ids),
+        findMintPools(quoteMint, ids),
+        findMintPools(mint, ids),
+        findHookConfig(ids),
+        findPosition(pool, hookAuthority, SALT_SEED, ids),
+        findPosition(pool, hookAuthority, SALT_BID, ids),
+        findEventAuthority(ids.carpenterAmm),
+        findEventAuthority(ids.floorHook),
+        findGraduationRent(launchAddress, ids),
+        findQuoteMint(quoteMint, ids),
+        findQuoteMint(mint, ids),
+        findStairState(floorPool, ids),
+        findPosition(pool, hookAuthority, SALT_STAIR_STEP0, ids),
+        findPosition(pool, hookAuthority, SALT_STAIR_RESERVE, ids),
+        findPosition(pool, hookAuthority, SALT_STAIR_TAIL, ids),
+    ]);
+    const R = AccountRole.READONLY;
+    const W = AccountRole.WRITABLE;
+    const fixed = [
+        [launchConfig.address, R], // 0
+        [ids.carpenterAmm, R], // 1
+        [ammConfig.address, R], // 2
+        [approvedHook.address, R], // 3
+        [programData.address, R], // 4 hook_programdata
+        [pool, W], // 5
+        [bitmap.address, W], // 6
+        [vault0.address, W], // 7 the QUOTE's vault (wSOL's unless `quote` says otherwise)
+        [vault1.address, W], // 8 mint
+        [poolIndexEntry.address, W], // 9
+        [quoteMint, R], // 10 the quote mint
+        [quoteProgram, R], // 11 its token program
+        [excl0.address, R], // 12
+        [excl1.address, R], // 13
+        // 14: the QUOTE's MintPoolCount. Read-only on a wSOL launch (never written: wSOL is a LEGACY
+        // quote) and WRITABLE on every other (the AMM's roster: a ROSTER quote is
+        // COUNTED and its counter is created by the first pool on it; `graduate.rs::check_accounts_of`
+        // requires the slot writable for every quote but wSOL, a legacy-array quote included).
+        [pools0.address, args.quoted ? W : R], // 14
+        [pools1.address, W], // 15
+        [ids.floorHook, R], // 16
+        [hookConfig.address, R], // 17
+        [floorPool, W], // 18
+        [hookAuthority, R], // 19
+        [posSeed.address, W], // 20
+        [posBid.address, W], // 21
+        [SYSTEM_PROGRAM_ID, R], // 22
+        [ammEvents.address, R], // 23
+        [hookEvents.address, R], // 24
+        [args.wsolVault, W], // 25
+        // `graduation_rent`: its lamports pay for everything graduation creates.
+        [graduationRent.address, W], // 26
+        // The AMM's quote ROSTER: `initialize_pool` takes `quote_mint0` /
+        // `quote_mint1` as two REQUIRED trailing slots. 27 is the QUOTE's entry — absent on wSOL (the implied quote), present on
+        // a roster quote — and 28 the base mint's, which never exists. Both read-only.
+        [quoteMint0.address, R], // 27
+        [quoteMint1.address, R], // 28
+        // The staircase: writable on every launch, created by `prepare_graduation` or inside the graduating buy.
+        [stairState.address, W], // 29
+        [posStairStep0.address, W], // 30
+        [posStairReserve.address, W], // 31
+        [posStairTail.address, W], // 32
+    ];
+    const arrays = await Promise.all(tickArrayStarts.map(async (st) => (await findTickArray(pool, st, ids)).address));
+    // Rent of everything created, lengths from
+    const existing = args.existing ?? new Set();
+    const created = [
+        [pool, GRADUATION_ACCOUNT_LENS.pool],
+        [bitmap.address, bitmapAccountLen(s)],
+        [vault0.address, GRADUATION_ACCOUNT_LENS.vaultSplToken],
+        [vault1.address, args.hooked ? GRADUATION_ACCOUNT_LENS.vaultToken2022PausableHooked : GRADUATION_ACCOUNT_LENS.vaultToken2022Pausable],
+        [poolIndexEntry.address, GRADUATION_ACCOUNT_LENS.poolIndexEntry],
+        [pools1.address, GRADUATION_ACCOUNT_LENS.mintPoolCount],
+        // The QUOTE's counter, priced on every non-wSOL launch exactly as `graduation_rent.rs`'s
+        // `quote_pools` row prices it; `existing` credits it when a prior pool made it.
+        ...(args.quoted ? [[pools0.address, GRADUATION_ACCOUNT_LENS.mintPoolCount]] : []),
+        // the SEED and BID positions
+        [posSeed.address, GRADUATION_ACCOUNT_LENS.position],
+        [posBid.address, GRADUATION_ACCOUNT_LENS.position],
+        // the staircase: its StairState and three positions, on a staircase pool only (`graduation_rent.rs` `stair`).
+        ...(args.stair
+            ? [
+                [stairState.address, args.ownerBooks ? GRADUATION_ACCOUNT_LENS.stairStateWithOwners : GRADUATION_ACCOUNT_LENS.stairState],
+                [posStairStep0.address, GRADUATION_ACCOUNT_LENS.position],
+                [posStairReserve.address, GRADUATION_ACCOUNT_LENS.position],
+                [posStairTail.address, GRADUATION_ACCOUNT_LENS.position],
+            ]
+            : []),
+        ...arrays.map((a) => [a, GRADUATION_ACCOUNT_LENS.tickArray]),
+    ];
+    let rentLamports = 0n;
+    for (const [addr, len] of created)
+        if (!existing.has(addr))
+            rentLamports += BigInt(await args.rent(len));
+    return {
+        accounts: [...fixed.map(([address, role]) => ({ address, role })), ...arrays.map((address) => ({ address, role: W }))],
+        names: [...GRADUATION_ACCOUNT_NAMES, ...tickArrayStarts.map((st) => `tick_array[${st}]`)],
+        pool,
+        openTick: open,
+        tickArrayStarts,
+        rentLamports,
+        maxGraduationLamports: maxGraduationLamports(rentLamports),
+    };
+}
+/** The predicted graduation rent × 1.1, rounded up. */
+export function maxGraduationLamports(rentLamports) {
+    return (rentLamports * 11n + 9n) / 10n;
+}
+// floor_math::sale::{team_fee_of, team_net_of, team_gross_for} integer for integer (predict.test.ts
+// pins the Rust vectors). `teamBps` is the LAUNCH's own Launch.teamBps (the config's sale setting
+// at the launch's creation, kept for life), never a constant and never the config's CURRENT setting.
+/** The platform fee on a sale amount (a buy's cost, a sell-back's payout): `floor(amount · teamBps / 10 000)`. */
+export const saleTeamFee = (amount, teamBps) => (amount * BigInt(teamBps)) / 10000n;
+/** What a GROSS `lamportsIn` buys with: `floor(gross · 10 000 / (10 000 + teamBps))` — the program's own net. */
+export const saleNetOf = (gross, teamBps) => (gross * 10000n) / (10000n + BigInt(teamBps));
+/** The client's one ceiling: the gross whose net is exactly `net` — `ceil(net · (10 000 + teamBps) / 10 000)`. */
+export const saleGrossFor = (net, teamBps) => (net * (10000n + BigInt(teamBps)) + 9999n) / 10000n;
+//# sourceMappingURL=predict.js.map

package/dist/predict.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"predict.js","sourceRoot":"","sources":["../src/predict.ts"],"names":[],"mappings":"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"}

package/dist/quote/quoter.d.ts

@@ -0,0 +1,212 @@
+/**
+ * The typed quoter over FLOOR's `floor_quote_bg.wasm` (`rust/crates/floor-quote-wasm`): the AMM walk with the FLOOR
+ * hook's callbacks (`quoteSwap`, with FLOOR's fee breakdown and the in-swap bid re-place), the liquidity / position /
+ * tick helpers, and FLOOR's own four — the sale's buy and sell-back, the holder tally's claimable and the three referral
+ * tiers' dues. Each number is the program's own arithmetic compiled to wasm, never a JS copy.
+ *
+ * The wire:
+ * - accounts go in as their RAW BYTES exactly as `getAccountInfo` returns them (discriminator included); tick arrays go
+ *   in CONCATENATED, each its 3,888-byte body in a 3,888-byte stride (this wrapper slices a 3,920-byte account); an
+ *   empty `bitmap` / `floor_pool` means "not supplied";
+ * - integers that can exceed 2^53 cross as decimal strings; ticks, decimals and spacings are numbers;
+ * - every export returns `{"ok": …}` or `{"err": "<Name>", …}` (`<Name>` is the program's error name, the
+ *   `QuoteError.code`) — except `version` (its object bare) and `holder_claimable` (u64 in and out as a bigint, which
+ *   THROWS `Error(name)`).
+ * Nothing here computes a number. This module never imports the wasm glue, so tests run it over a fake `QuoteFns`.
+ * The quoter is advisory; `simulateTransaction` stays the final check before a wallet signs.
+ */
+import { QuoteError } from '@floorlaunchpad/carpenter-sdk';
+export { QuoteError };
+/** Every wasm-bindgen export the wrapper calls (`wasm/floor_quote.d.ts`). */
+export interface QuoteFns {
+    quote_swap(pool_key: Uint8Array, pool: Uint8Array, bitmap: Uint8Array, tick_arrays: Uint8Array, floor_pool: Uint8Array, zero_for_one: boolean, amount_specified: string, sqrt_price_limit_x64: string, supply1: string): string;
+    amounts_for_liquidity(sqrt_price_x64: string, tick_current: number, tick_lower: number, tick_upper: number, liquidity_delta: string): string;
+    quote_liquidity(sqrt_price_x64: string, tick_lower: number, tick_upper: number, amount0_max: string, amount1_max: string): string;
+    fees_owed(pool_key: Uint8Array, pool: Uint8Array, position: Uint8Array, lower_array: Uint8Array, upper_array: Uint8Array): string;
+    sqrt_price_at_tick(tick: number): string;
+    tick_at_sqrt_price(sqrt_price_x64: string): string;
+    tick_at_price_ui(price_ui: number, decimals0: number, decimals1: number): string;
+    price_ui_at_tick(tick: number, decimals0: number, decimals1: number): number;
+    floor_to_spacing(tick: number, spacing: number): string;
+    ceil_to_spacing(tick: number, spacing: number): string;
+    sale_buy(launch: Uint8Array, lamports_in: string): string;
+    sale_sell_back(launch: Uint8Array, buyer_position: Uint8Array, tokens: string): string;
+    /** u64 in/out as bigint; THROWS `Error(name)` (`WrongMint` / `NotHooked` / `QuoteBadAccount`). */
+    holder_claimable(book_data: Uint8Array, record_data: Uint8Array, floor_pool_data: Uint8Array, live_balance: bigint): bigint;
+    /** `{"ok":{"due1","due2","due3"}}`, decimal strings. */
+    referral_tier_dues(floor_pool_data: Uint8Array): string;
+    version(): string;
+}
+/** A tick array's 3,888-byte BODY (discriminator ‖ struct): what the wasm takes, in a 3,888-byte stride. */
+export declare const TICK_ARRAY_BODY_LEN = 3888;
+/** The lengths accepted for one tick array: its body, or the 3,920-byte account as `getAccountInfo` returns it. */
+export declare const TICK_ARRAY_ACCOUNT_LENS: readonly number[];
+/** Concatenate tick arrays as 3,888-byte bodies; any other length is refused `QuoteBadAccount`, naming the index. */
+export declare function concatTickArrays(arrays: readonly Uint8Array[]): Uint8Array;
+export interface SwapQuoteInput {
+    /** The pool's address bytes (32). */
+    poolKey: Uint8Array;
+    /** `Pool` account data. */
+    pool: Uint8Array;
+    /** `TickArrayBitmap` account data; omit only when every needed array is supplied. */
+    bitmap?: Uint8Array | null;
+    /** Every tick array the walk (and the bid re-place) may read; each the 3,920-byte account or its body. */
+    tickArrays: readonly Uint8Array[];
+    /** `FloorPool` account data on a FLOOR pool (required there); omit on a plain pool. */
+    floorPool?: Uint8Array | null;
+    zeroForOne: boolean;
+    /** v4 sign: `< 0` exact-in (spend `−amountSpecified`), `> 0` exact-out. FLOOR pools refuse exact-out. */
+    amountSpecified: bigint;
+    /** Omit for "no limit". */
+    sqrtPriceLimitX64?: bigint | null;
+    /** The base mint's supply (currency 1), handed to FLOOR's callbacks. */
+    supply1?: bigint | null;
+}
+export type HookActionQuote = {
+    kind: 'swap';
+    zeroForOne: boolean;
+    amountSpecified: bigint;
+    sqrtPriceLimitX64: bigint;
+} | {
+    kind: 'modify_position';
+    salt: bigint;
+    tickLower: number;
+    tickUpper: number;
+    liquidityDelta: bigint;
+};
+/** The in-swap bid re-place: what `after_actions` booked, and where the price stood before and after the nudge. */
+export interface ReplaceQuote {
+    /** Tokens the closed bid held; joined inventory at cost. */
+    absorbed: bigint;
+    /** Quote the close returned to the vault. */
+    ethBack: bigint;
+    /** What the nudge spent and got (both `0n` across an empty gap). */
+    nudgeSpent: bigint;
+    nudgeGot: bigint;
+    /** The closed band's lower tick. */
+    fromLower: number;
+    /** Whether a new band was deployed; when `false` the three `to*` fields describe no live band. */
+    redeployed: boolean;
+    toLower: number;
+    toUpper: number;
+    bidEthDeployed: bigint;
+    bidLiquidity: bigint;
+    /** True when the close's fees are not the position's real accrued fees (the quoter replays the actions without a `Position` account). */
+    feesUnknown: boolean;
+    /** The tick the sell left the market at (before the close and the nudge). */
+    fromTick: number;
+    /** The tick after the nudge (where the new band was sized). */
+    toTick: number;
+}
+/** A FLOOR pool's fee breakdown. Every part is in the quote currency except `lp` (the INPUT currency). */
+export interface SwapQuoteFees {
+    /** The LPs' fee, in the input currency (the Carpenter Platform fee is never inside it). */
+    lp: bigint;
+    /** The floor skim (the `$FLOOR` cut, `platformCut`, is inside it). */
+    skim: bigint;
+    creator: bigint;
+    /** The holder fee (0 on a launch with no holder rate). */
+    holder: bigint;
+    /** The part of `skim` accrued to the platform. */
+    platformCut: bigint;
+    /** The FLOOR Platform fee, charged on top (never inside `skim`). */
+    team: bigint;
+    /** The Carpenter Platform fee the trader's walk pays, in currency `protocolCurrency` — on a FLOOR pool the quote: off
+     *  the input on a buy, off the OUTPUT on a sell (`amountOut` is already net of it). */
+    protocol: bigint;
+    protocolCurrency: 0 | 1;
+}
+export interface SwapQuote {
+    /** What the trader pays. */
+    amountIn: bigint;
+    /** What the trader receives. */
+    amountOut: bigint;
+    fees: SwapQuoteFees;
+    /** The pool price after the whole swap, actions included. */
+    sqrtAfter: bigint;
+    tickAfter: number;
+    /** The price after the trader's walk, before any action. */
+    sqrtAfterTrade: bigint;
+    tickAfterTrade: number;
+    /** Start indices of the arrays the trader's walk read. */
+    arraysTouched: number[];
+    /** Start indices the actions' walks read. */
+    actionArrays: number[];
+    /** `arraysTouched ∪ actionArrays`, deduplicated: every array the transaction must carry. */
+    allArrays: number[];
+    /** The actions the hook requested and the AMM executed, every round in order. */
+    replaceActions: HookActionQuote[];
+    /** The in-swap bid re-place, when the sell triggers one. */
+    replace: ReplaceQuote | null;
+    signals: number;
+    /** The hook delta credited to claims, signed. */
+    hookDelta0: bigint;
+    hookDelta1: bigint;
+}
+export interface QuoterVersion {
+    floorQuoteWasm: string;
+    hookInterface: number;
+    /** Hex of the `floor_hook` program id the quoter was built against. */
+    floorHookId: string;
+}
+export interface SaleBuyQuote {
+    tokens: bigint;
+    /** The RAISE part: `ceil(tokens · price_x64 / 2^64)`. */
+    cost: bigint;
+    /** The FLOOR Platform fee on top, `floor(cost · Launch.team_bps / 10 000)`. */
+    teamFee: bigint;
+    /** What leaves the buyer for the tokens: `cost + teamFee` ≤ `lamportsIn` (the gross cap). */
+    spent: bigint;
+    /** This buy sells the sale out and graduates the launch inside it (the buyer then also pays the graduation accounts' rent, bounded by `max_graduation_lamports`). */
+    graduates: boolean;
+}
+/** A sell-back pays the gross payout LESS the FLOOR Platform fee. The position is read only to check that it covers `tokens`. */
+export interface SaleSellBackQuote {
+    /** The gross payout, `floor(tokens · price_x64 / 2^64)` at the sale price. */
+    payout: bigint;
+    /** `floor(payout · Launch.team_bps / 10 000)`. */
+    teamFee: bigint;
+    /** What the seller receives: `payout − teamFee`. */
+    received: bigint;
+}
+export interface Quoter {
+    readonly version: QuoterVersion;
+    quoteSwap(input: SwapQuoteInput): SwapQuote;
+    amountsForLiquidity(sqrtPriceX64: bigint, tickCurrent: number, tickLower: number, tickUpper: number, liquidityDelta: bigint): {
+        amount0: bigint;
+        amount1: bigint;
+    };
+    quoteLiquidity(sqrtPriceX64: bigint, tickLower: number, tickUpper: number, amount0Max: bigint, amount1Max: bigint): bigint;
+    /** `lowerArray` / `upperArray`: the arrays holding the position's two ticks; every account must name `poolKey`'s pool. */
+    feesOwed(poolKey: Uint8Array, pool: Uint8Array, position: Uint8Array, lowerArray: Uint8Array, upperArray: Uint8Array): {
+        fees0: bigint;
+        fees1: bigint;
+    };
+    sqrtPriceAtTick(tick: number): bigint;
+    tickAtSqrtPrice(sqrtPriceX64: bigint): number;
+    tickAtPriceUi(priceUi: number, decimals0: number, decimals1: number): number;
+    /** Display only; `NaN` for a tick out of range. */
+    priceUiAtTick(tick: number, decimals0: number, decimals1: number): number;
+    floorToSpacing(tick: number, spacing: number): number;
+    ceilToSpacing(tick: number, spacing: number): number;
+    saleBuy(launch: Uint8Array, lamportsIn: bigint): SaleBuyQuote;
+    saleSellBack(launch: Uint8Array, buyerPosition: Uint8Array, tokens: bigint): SaleSellBackQuote;
+    /**
+     * What `floor_holders::claim` would pay this record now. Full account data: the `HolderBook`, the `HolderRecord`, the
+     * launch's `FloorPool`, and the token account's live balance (0 for a closed one). A refusal is a `QuoteError`
+     * (`WrongMint`, `NotHooked`, `QuoteBadAccount`).
+     */
+    holderClaimable(book: Uint8Array, record: Uint8Array, floorPool: Uint8Array, liveBalance: bigint): bigint;
+    /** What `claim_referral_fees(tier)` would pay each tier now, `[due1, due2, due3]`, from the full `FloorPool` data. */
+    referralTierDues(floorPool: Uint8Array): [bigint, bigint, bigint];
+}
+type Json = Record<string, unknown>;
+/** The wasm parses integers with Rust's `parse`, so only a plain decimal is acceptable. */
+export declare function toDecimal(v: bigint): string;
+/** `quote_swap`'s `ok` object → `SwapQuote`. */
+export declare function decodeSwapQuote(o: Json): SwapQuote;
+/** `version()` returns its object bare (no `{"ok"}` envelope). */
+export declare function decodeVersion(text: string): QuoterVersion;
+/** Build the typed `Quoter` over the wasm's exports (or a fake, in tests). */
+export declare function createQuoter(fns: QuoteFns): Quoter;
+//# sourceMappingURL=quoter.d.ts.map