@floorlaunchpad/sdk-solana 0.0.0-stage → 0.1.0

package/dist/constants.d.ts

@@ -0,0 +1,257 @@
+/**
+ * FLOOR's constants shared with the `floor_hook` / `floor_launch` / `floor_holders` / `floor_vesting` programs: ids,
+ * seeds, the account and fee constants a reader or a trade needs, and the compute-unit rows. Every value is a copy of the
+ * programs' Rust constants (`crates/floor-types`); `test/rust-parity.test.ts` checks them when the program source is
+ * present.
+ * ⚠ `SEEDS` and `CU_LIMITS` here are the UNION — `@floorlaunchpad/carpenter-sdk`'s rows spread first, then FLOOR's — so one table
+ *   serves every builder.
+ */
+import { type Address } from '@solana/kit';
+export declare const FLOOR_HOOK_PROGRAM_ID: Address;
+export declare const FLOOR_LAUNCH_PROGRAM_ID: Address;
+/** `floor_holders` — the Token-2022 TRANSFER-HOOK holder tally. Equal to `floor_types::holders::FLOOR_HOLDERS_ID`. */
+export declare const FLOOR_HOLDERS_PROGRAM_ID: Address;
+/** `floor_vesting`, for reading its accounts. */
+export declare const FLOOR_VESTING_PROGRAM_ID: Address;
+export declare const SEEDS: {
+    readonly hookConfig: Uint8Array<ArrayBufferLike>;
+    readonly floorPool: Uint8Array<ArrayBufferLike>;
+    readonly launchConfig: Uint8Array<ArrayBufferLike>;
+    readonly registryEntry: Uint8Array<ArrayBufferLike>;
+    readonly launch: Uint8Array<ArrayBufferLike>;
+    readonly saleVault: Uint8Array<ArrayBufferLike>;
+    readonly buyer: Uint8Array<ArrayBufferLike>;
+    readonly mint: Uint8Array<ArrayBufferLike>;
+    readonly mintAuthority: Uint8Array<ArrayBufferLike>;
+    readonly lockAuthority: Uint8Array<ArrayBufferLike>;
+    readonly launchAuthority: Uint8Array<ArrayBufferLike>;
+    /** `["quote", quote_mint]` under `floor_hook` — the FLOOR quote roster entry a launch on any quote but wSOL is
+     * created against. */
+    readonly quotePolicy: Uint8Array<ArrayBufferLike>;
+    readonly gradRent: Uint8Array<ArrayBufferLike>;
+    /** `["stair_rent", amm_pool]` under floor_hook. */
+    readonly stairRent: Uint8Array<ArrayBufferLike>;
+    /** `["stair", floor_pool]` under `floor_hook`, a staircase pool's
+     *  `StairState` — created by `prepare_positions` (or inside the graduating buy), filled by graduation. */
+    readonly stair: Uint8Array<ArrayBufferLike>;
+    /** `["platform_treasury"]` under `floor_hook` — the program-owned PLATFORM TREASURY. Its ADDRESS owns every token
+     * account the 2.5 % `$FLOOR` cut is swept into (`ATA(treasury, quote)`, one per quote); its DATA is the governance that
+     * alone may withdraw. No private key exists for it. */
+    readonly platformTreasury: Uint8Array<ArrayBufferLike>;
+    /** `["team_treasury"]` under `floor_hook` — the program-owned
+     * TEAM treasury, `PlatformTreasury`'s layout. Its ADDRESS owns every token account the platform fee
+     * is swept into (`ATA(team, quote)`, opened by the first sweep that moves a team fee in that quote);
+     * its DATA is the governance that alone may `withdraw_team`. Never crosses the platform treasury. */
+    readonly teamTreasury: Uint8Array<ArrayBufferLike>;
+    /** `["floor_platform_pool"]`
+     * under `floor_hook` — the ONE record of `$FLOOR`'s pool (`FloorPlatformPool`), set once by
+     * `designate_floor_pool`; its ADDRESS owns the wSOL TRANSIT account `credit_floor_pool` stages a cut
+     * through (`ATA(record, wSOL)`, zero at rest). Never a treasury. */
+    readonly floorPlatformPool: Uint8Array<ArrayBufferLike>;
+    /** `["trader_link", trader]` under `floor_launch`. */
+    readonly traderLink: Uint8Array<ArrayBufferLike>;
+    /** `["trader_ref", trader, quote_mint]` under `floor_hook` — a trader's bucket in one quote. */
+    readonly traderRef: Uint8Array<ArrayBufferLike>;
+    /** `["trader_ref_vault"]` under `floor_hook` — the shared vault's authority (one ATA per quote). */
+    readonly traderRefVault: Uint8Array<ArrayBufferLike>;
+    /** `["trader_ref_sale", launch]` under `floor_launch` — a launch's sale-path referral account. */
+    readonly traderRefSale: Uint8Array<ArrayBufferLike>;
+    readonly ammConfig: Uint8Array<ArrayBufferLike>;
+    readonly approvedHook: Uint8Array<ArrayBufferLike>;
+    readonly mintExclusivity: Uint8Array<ArrayBufferLike>;
+    readonly mintPools: Uint8Array<ArrayBufferLike>;
+    readonly quoteMint: Uint8Array<ArrayBufferLike>;
+    readonly pool: Uint8Array<ArrayBufferLike>;
+    readonly bitmap: Uint8Array<ArrayBufferLike>;
+    readonly tickArray: Uint8Array<ArrayBufferLike>;
+    readonly position: Uint8Array<ArrayBufferLike>;
+    readonly poolIndex: Uint8Array<ArrayBufferLike>;
+    readonly vault: Uint8Array<ArrayBufferLike>;
+    readonly eventAuthority: Uint8Array<ArrayBufferLike>;
+    readonly hookAuthority: Uint8Array<ArrayBufferLike>;
+    readonly hookSettle: Uint8Array<ArrayBufferLike>;
+    readonly protocolTreasury: Uint8Array<ArrayBufferLike>;
+};
+/**
+ * `floor_holders`' seeds, every one under `FLOOR_HOLDERS_PROGRAM_ID`.
+ * ⚠ `extraAccountMetas` is the Token-2022 transfer-hook INTERFACE's own seed, `["extra-account-metas", mint]` with a
+ *   HYPHEN — `spl_transfer_hook_interface::get_extra_account_metas_address` derives it under the hook program, and
+ *   Token-2022 looks the account up by exactly that address.
+ */
+export declare const HOLDERS_SEEDS: {
+    /** `["holders_authority"]` — signs `floor_hook::pay_holder` (the only door holder money leaves by). */
+    readonly holdersAuthority: Uint8Array<ArrayBufferLike>;
+    /** `["holder_book", mint]` — one launch's tally (acc, eligible, indexed, unallocated, paid). */
+    readonly holderBook: Uint8Array<ArrayBufferLike>;
+    /** `["extra-account-metas", mint]` — the transfer-hook interface's validation account. */
+    readonly extraAccountMetas: Uint8Array<ArrayBufferLike>;
+    /** `["holder", mint, token_account]` — ONE holder's record, keyed by its ATA, never its wallet. */
+    readonly holderRecord: Uint8Array<ArrayBufferLike>;
+};
+/** `0x20CC | 0x4000`. */
+export declare const FLOOR_HOOK_FLAGS = 24780;
+/**
+ * The accounts every FLOOR hook callback takes (`ApprovedHook.callback_accounts`, copied into each pool as
+ * `Pool.hook_callback_accounts`): `[floor_pool w, trader_bucket w, floor_hook event_authority r, floor_hook r]`. The
+ * program set this SDK builds for carries 4; an older set carries fewer, and `createSolanaAdapter` refuses to build
+ * trades against it (`program_version`).
+ */
+export declare const FLOOR_CALLBACK_ACCOUNTS = 4;
+export declare const FLOOR_TICK_SPACING = 60;
+export declare const TOKEN_DECIMALS = 6;
+export declare const SUPPLY = 1000000000000000n;
+/** The standard supply split: 30 / 10 / 60 (sale / POL / ladder). */
+export declare const SALE_TOKENS = 300000000000000n;
+export declare const POL_TOKENS = 100000000000000n;
+export declare const LADDER_TOKENS = 600000000000000n;
+export declare const TICKS_PER_DOUBLING = 6932;
+/**
+ * The bid is a BAND `[floor_tick − W, floor_tick]`, `W = ceil_to_spacing(BID_BAND_TICKS, s)` — 120 at
+ * spacing 60 (`floor_types::constants::BID_BAND_TICKS`, `floor_math::band`). The SDK reads it to
+ * predict the bid's arrays at graduation.
+ */
+export declare const BID_BAND_TICKS = 120;
+export declare const LP_FEE_PIPS = 2500;
+export declare const PLATFORM_BPS = 250;
+/**
+ * THE FLOOR PLATFORM FEE ("team fee" in code): a SALE rate and a POOL rate, each a governance-set CURRENT SETTING in
+ * `LaunchConfig` under a cap, COPIED into each launch / pool at its creation and kept for life. ⛔ Informational: every
+ * figure uses the ACCOUNT's own `Launch.teamBps` / `FloorPool.teamFeeBps` (0 on older accounts), and "what a new launch
+ * pays now" is `launchConfigTeamSaleBps` / `launchConfigTeamPoolBps` on the decoded config — never these defaults.
+ */
+/** The sale's default, on every bonding-sale buy AND sell-back — 1 %. */
+export declare const TEAM_SALE_FEE_BPS_DEFAULT = 100;
+/** The most `set_team_fees` may set for the sale — 1 %. */
+export declare const TEAM_SALE_FEE_BPS_MAX = 100;
+/** The pool's default, on every swap after graduation — 0.25 %. */
+export declare const TEAM_POOL_FEE_BPS_DEFAULT = 25;
+/** The most `set_team_fees` may set for a pool — 0.5 %. */
+export declare const TEAM_POOL_FEE_BPS_MAX = 50;
+/** The FAR skim cap per side, 10 %. The sell skim ramps to its at-floor endpoint (`skimSellAtFloorBps`). */
+export declare const MAX_SKIM_FAR_BPS = 1000;
+/** The creator fee cap per side: 5 %. */
+export declare const MAX_CREATOR_BPS = 500;
+/** The holder rate cap per side: 10 %. */
+export declare const MAX_HOLDER_BPS = 1000;
+export declare const SALT_BID = 1n;
+export declare const SALT_SEED = 3n;
+/** The staircase's position salts (`floor_types::constants`): the open tail
+ *  above the staircase, the cushion, the POL re-list, the RESERVE and step i's `SALT_STAIR_STEP0 + i`. Found BY KEY. */
+export declare const SALT_STAIR_TAIL = 102n;
+export declare const SALT_CUSHION = 103n;
+export declare const SALT_POL_RELIST = 104n;
+export declare const SALT_STAIR_RESERVE = 105n;
+export declare const SALT_STAIR_STEP0 = 110n;
+export declare const MAX_STAIR_STEPS = 16;
+/** One staircase operation per ratchet (the compute budget); what is left sets `FloorPool.needsRatchet`. */
+export declare const STAIR_STEPS_PER_RATCHET = 1;
+/** `Launch.state`: the bonding sale, then graduated. Any other value is a launch that is not trading (read as `pending`). */
+export declare const LAUNCH_STATE_BONDING = 0;
+export declare const LAUNCH_STATE_GRADUATED = 1;
+/** At most five slots in a list. */
+export declare const MAX_SLOTS = 5;
+/** A list's shares sum to exactly this. */
+export declare const SLOTS_TOTAL_BPS = 10000;
+/** 1 X / twitter, 2 github, 3 discord, 4 telegram; 0 = an address slot. */
+export declare const MAX_SLOT_PLATFORM = 4;
+/** The `PayeeSlots` tail's ACCOUNT offset in a `FloorPool` account: straight after the TWAP oracle (1,008). */
+export declare const PAYEE_SLOTS_OFFSET = 1008;
+/** `size_of::<PayeeSlot>()`. */
+export declare const PAYEE_SLOT_SIZE = 56;
+/** `size_of::<PayeeSlots>()`. */
+export declare const PAYEE_SLOTS_SIZE = 568;
+/** The `FloorPool` account `register_pool` creates: 1,008 + 568 = 1,576 bytes. */
+export declare const FLOOR_POOL_ACCOUNT_LEN_WITH_SLOTS: number;
+/**
+ * The team's per-slot books (`floor_types::slots::TeamParts`), the `FloorPool` account's tail after the slots —
+ * `out_mask` u128 @0 (bit 5·i + s: slot s exited step i), `part_tokens` @16, `part_quote` @24, `token_credit[5]` @32,
+ * `quote_credit[5]` @72, `pending_ask[5]` @112.
+ */
+export declare const TEAM_PARTS_OFFSET: number;
+/** `size_of::<TeamParts>()`. */
+export declare const TEAM_PARTS_SIZE = 152;
+/** The `FloorPool` account `register_pool` creates: 1,576 + 152 = 1,728 bytes. */
+export declare const FLOOR_POOL_ACCOUNT_LEN_WITH_PARTS: number;
+/** `PayeeSlots.version` once `register_pool` wrote the lists. */
+export declare const PAYEE_SLOTS_VERSION = 1;
+/** `PayeeSlot.state`: an address slot from creation. */
+export declare const SLOT_STATE_WALLET = 0;
+/** A handle slot still waiting for its claim (`key` is the pending id; the share is HELD). */
+export declare const SLOT_STATE_PENDING = 1;
+/** A handle slot claimed (`key` is the claimed wallet; the pending id is in the `PayeeSlotsSet` event). */
+export declare const SLOT_STATE_RESOLVED = 2;
+/** Which list (`PayeeSlotsSet`'s `creator` / `team` list). */
+export declare const SLOT_KIND_CREATOR = 0;
+export declare const SLOT_KIND_TEAM = 1;
+/** `FloorPool.stair_kind`: the staircase's parameter set — the presets' (0) or `$FLOOR`'s (1). */
+export declare const STAIR_KIND_PRESET = 0;
+export declare const STAIR_KIND_GENESIS = 1;
+/**
+ * The mode byte (`Launch.mode`, `FloorPool.mode`): 0 Custom, 1 Moonshot, 2 Cook, 3 Bluechip — the EVM's `FloorModes.Mode`
+ * ordinals too. A zeroed byte is Custom.
+ * ⛔ A DECODER MUST REFUSE AN ORDINAL IT CANNOT PLACE, never fall through to a default. Further modes append (4..=31).
+ */
+export declare const MODE_CUSTOM = 0;
+export declare const MODE_MOONSHOT = 1;
+export declare const MODE_COOK = 2;
+export declare const MODE_BLUECHIP = 3;
+/** Every mode byte the programs define, in `floor_math::Mode` order. */
+export declare const MODES: readonly [0, 1, 2, 3];
+export declare const PENDING_PLATFORM_NONE = 0;
+export declare const PENDING_PLATFORM_TWITTER = 1;
+export declare const PENDING_PLATFORM_GITHUB = 2;
+export declare const PENDING_PLATFORM_DISCORD = 3;
+export declare const PENDING_PLATFORM_TELEGRAM = 4;
+/** Ticks from the price down to 0.9 × the price (`floor_math::stair::CUSHION_TICKS`): the cushion's width. */
+export declare const CUSHION_TICKS = 1054;
+/** No protocol listing within ~3 % above the floor: `floor_math::stair::STAIR_CLEAR_TICKS`. */
+export declare const STAIR_CLEAR_TICKS = 254;
+/** The cushion's re-list cost markup, 1.03× in ticks (`floor_math::stair::RELIST_COST_MARKUP_TICKS`). */
+export declare const RELIST_COST_MARKUP_TICKS = 296;
+/** `floor_types::twap::CUSHION_TWAP_WINDOW_SECS`: the cushion sits under min(spot, the pool's TWAP over this window). */
+export declare const CUSHION_TWAP_WINDOW_SECS = 900;
+/** The cushion follows net buying: the net-flow meter's memory H in bps of the market cap
+ *  (`floor_math::netflow::STAIR_CUSHION_NETFLOW_BPS`); 0 would be off. */
+export declare const STAIR_CUSHION_NETFLOW_BPS: number;
+/** The meter's catch-up by volume K (`floor_math::netflow::STAIR_CUSHION_NETFLOW_RELAX_BPS`); 0 = none. */
+export declare const STAIR_CUSHION_NETFLOW_RELAX_BPS: number;
+/** The half rule: a buy is remembered by its own last slice of quote, and one buy takes at most half of a meter that
+ *  holds anything. */
+export declare const STAIR_CUSHION_NETFLOW_HALF_RULE: boolean;
+/**
+ * `SetComputeUnitLimit` values: each an estimate (`[est.]`) or a measured figure × 1.5, capped at the 1.4 M
+ * per-transaction limit. ⛔ Every builder prepends one: an unset limit is 0 under v1 transactions.
+ */
+export declare const CU_LIMITS: {
+    readonly swapFloorBuy: 218000;
+    readonly swapFloorSell: 520000;
+    readonly buyFinal: 1400000;
+    readonly prepareGraduation: 900000;
+    readonly sellBack: 60000;
+    readonly closeBuyerPosition: 20000;
+    /** `touch` / `open_record`: catch_up, a prefund-safe record create, one settle, emit_cpi [est.]. */
+    readonly holdersTouch: 60000;
+    /** `sync`: catch_up + one settle; no create, no CPI [est.]. */
+    readonly holdersSync: 40000;
+    readonly linkTrader: 90000;
+    readonly saleTraderRef: 30000;
+    readonly swapPlain: 90000;
+    readonly modifyLiquidity: 90000;
+    readonly initializePool: 120000;
+    readonly initializeTickArray: 30000;
+    readonly closePosition: 20000;
+    readonly closeTickArray: 30000;
+    readonly hookedTransfer: 80000;
+    readonly ataCreate: 30000;
+    readonly burnChecked: 20000;
+};
+export type CuLimitKey = keyof typeof CU_LIMITS;
+/**
+ * `RequestHeapFrame` sizes, in bytes (a multiple of 1,024, from 32 KiB to 256 KiB). `finalize` places one right after the
+ * `SetComputeUnitLimit` of every builder whose `CU_LIMITS` key is listed here; none of this package's builders needs
+ * more than the default 32 KiB.
+ */
+export declare const HEAP_FRAMES: Readonly<Partial<Record<CuLimitKey, number>>>;
+/** The Instructions sysvar, which `link_trader` introspects for the attestor's Ed25519 signature. */
+export declare const INSTRUCTIONS_SYSVAR_ID: Address<"Sysvar1nstructions1111111111111111111111111">;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAW,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAKpD,eAAO,MAAM,qBAAqB,EAAE,OAAiE,CAAC;AACtG,eAAO,MAAM,uBAAuB,EAAE,OAAiE,CAAC;AACxG,sHAAsH;AACtH,eAAO,MAAM,wBAAwB,EAAE,OAAiE,CAAC;AACzG,iDAAiD;AACjD,eAAO,MAAM,wBAAwB,EAAE,OAAiE,CAAC;AAIzG,eAAO,MAAM,KAAK;;;;;;;;;;;;IAahB;0BACsB;;;IAItB,mDAAmD;;IAEnD;8GAC0G;;IAE1G;;2DAEuD;;IAEvD;;;yGAGqG;;IAErG;;;wEAGoE;;IAEpE,sDAAsD;;IAEtD,gGAAgG;;IAEhG,oGAAoG;;IAEpG,kGAAkG;;;;;;;;;;;;;;;;;CAE1F,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,aAAa;IACxB,uGAAuG;;IAEvG,gGAAgG;;IAEhG,0FAA0F;;IAE1F,mGAAmG;;CAE3F,CAAC;AAEX,yBAAyB;AACzB,eAAO,MAAM,gBAAgB,QAAS,CAAC;AACvC;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAGzC,eAAO,MAAM,kBAAkB,KAAK,CAAC;AACrC,eAAO,MAAM,cAAc,IAAI,CAAC;AAChC,eAAO,MAAM,MAAM,oBAAyB,CAAC;AAC7C,qEAAqE;AACrE,eAAO,MAAM,WAAW,mBAAuB,CAAC;AAChD,eAAO,MAAM,UAAU,mBAAuB,CAAC;AAC/C,eAAO,MAAM,aAAa,mBAAuB,CAAC;AAClD,eAAO,MAAM,kBAAkB,OAAQ,CAAC;AACxC;;;;GAIG;AACH,eAAO,MAAM,cAAc,MAAM,CAAC;AAClC,eAAO,MAAM,WAAW,OAAQ,CAAC;AACjC,eAAO,MAAM,YAAY,MAAM,CAAC;AAChC;;;;;GAKG;AACH,yEAAyE;AACzE,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAC7C,2DAA2D;AAC3D,eAAO,MAAM,qBAAqB,MAAM,CAAC;AACzC,mEAAmE;AACnE,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAC5C,2DAA2D;AAC3D,eAAO,MAAM,qBAAqB,KAAK,CAAC;AACxC,4GAA4G;AAC5G,eAAO,MAAM,gBAAgB,OAAQ,CAAC;AACtC,yCAAyC;AACzC,eAAO,MAAM,eAAe,MAAM,CAAC;AACnC,0CAA0C;AAC1C,eAAO,MAAM,cAAc,OAAQ,CAAC;AAEpC,eAAO,MAAM,QAAQ,KAAK,CAAC;AAC3B,eAAO,MAAM,SAAS,KAAK,CAAC;AAC5B;wHACwH;AACxH,eAAO,MAAM,eAAe,OAAO,CAAC;AACpC,eAAO,MAAM,YAAY,OAAO,CAAC;AACjC,eAAO,MAAM,eAAe,OAAO,CAAC;AACpC,eAAO,MAAM,kBAAkB,OAAO,CAAC;AACvC,eAAO,MAAM,gBAAgB,OAAO,CAAC;AACrC,eAAO,MAAM,eAAe,KAAK,CAAC;AAClC,4GAA4G;AAC5G,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC,6HAA6H;AAC7H,eAAO,MAAM,oBAAoB,IAAI,CAAC;AACtC,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAKxC,oCAAoC;AACpC,eAAO,MAAM,SAAS,IAAI,CAAC;AAC3B,2CAA2C;AAC3C,eAAO,MAAM,eAAe,QAAS,CAAC;AACtC,2EAA2E;AAC3E,eAAO,MAAM,iBAAiB,IAAI,CAAC;AACnC,+GAA+G;AAC/G,eAAO,MAAM,kBAAkB,OAAQ,CAAC;AACxC,gCAAgC;AAChC,eAAO,MAAM,eAAe,KAAK,CAAC;AAClC,iCAAiC;AACjC,eAAO,MAAM,gBAAgB,MAAM,CAAC;AACpC,kFAAkF;AAClF,eAAO,MAAM,iCAAiC,QAAwC,CAAC;AACvF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,QAAoC,CAAC;AACnE,gCAAgC;AAChC,eAAO,MAAM,eAAe,MAAM,CAAC;AACnC,kFAAkF;AAClF,eAAO,MAAM,iCAAiC,QAAsC,CAAC;AACrF,iEAAiE;AACjE,eAAO,MAAM,mBAAmB,IAAI,CAAC;AACrC,wDAAwD;AACxD,eAAO,MAAM,iBAAiB,IAAI,CAAC;AACnC,8FAA8F;AAC9F,eAAO,MAAM,kBAAkB,IAAI,CAAC;AACpC,2GAA2G;AAC3G,eAAO,MAAM,mBAAmB,IAAI,CAAC;AACrC,8DAA8D;AAC9D,eAAO,MAAM,iBAAiB,IAAI,CAAC;AACnC,eAAO,MAAM,cAAc,IAAI,CAAC;AAChC,kGAAkG;AAClG,eAAO,MAAM,iBAAiB,IAAI,CAAC;AACnC,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC;;;;GAIG;AACH,eAAO,MAAM,WAAW,IAAI,CAAC;AAC7B,eAAO,MAAM,aAAa,IAAI,CAAC;AAC/B,eAAO,MAAM,SAAS,IAAI,CAAC;AAC3B,eAAO,MAAM,aAAa,IAAI,CAAC;AAC/B,wEAAwE;AACxE,eAAO,MAAM,KAAK,uBAAkE,CAAC;AAErF,eAAO,MAAM,qBAAqB,IAAI,CAAC;AACvC,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAC1C,eAAO,MAAM,uBAAuB,IAAI,CAAC;AACzC,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAC1C,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C,8GAA8G;AAC9G,eAAO,MAAM,aAAa,OAAQ,CAAC;AACnC,+FAA+F;AAC/F,eAAO,MAAM,iBAAiB,MAAM,CAAC;AACrC,yGAAyG;AACzG,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAC5C,yHAAyH;AACzH,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAC5C;0EAC0E;AAC1E,eAAO,MAAM,yBAAyB,EAAE,MAAY,CAAC;AACrD,2GAA2G;AAC3G,eAAO,MAAM,+BAA+B,EAAE,MAAU,CAAC;AACzD;sBACsB;AACtB,eAAO,MAAM,+BAA+B,EAAE,OAAc,CAAC;AAC7D;;;GAGG;AACH,eAAO,MAAM,SAAS;;;;;;;IAcpB,oGAAoG;;IAEpG,+DAA+D;;;;;;;;;;;;;CAKvD,CAAC;AACX,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,SAAS,CAAC;AAEhD;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAM,CAAC;AAE7E,qGAAqG;AACrG,eAAO,MAAM,sBAAsB,wDAAyD,CAAC"}

package/dist/constants.js

@@ -0,0 +1,250 @@
+/**
+ * FLOOR's constants shared with the `floor_hook` / `floor_launch` / `floor_holders` / `floor_vesting` programs: ids,
+ * seeds, the account and fee constants a reader or a trade needs, and the compute-unit rows. Every value is a copy of the
+ * programs' Rust constants (`crates/floor-types`); `test/rust-parity.test.ts` checks them when the program source is
+ * present.
+ * ⚠ `SEEDS` and `CU_LIMITS` here are the UNION — `@floorlaunchpad/carpenter-sdk`'s rows spread first, then FLOOR's — so one table
+ *   serves every builder.
+ */
+import { address } from '@solana/kit';
+import { CU_LIMITS as CARPENTER_CU_LIMITS, SEEDS as CARPENTER_SEEDS, MAX_TICK, MIN_TICK } from '@floorlaunchpad/carpenter-sdk';
+// ---- program ids ----------------
+export const FLOOR_HOOK_PROGRAM_ID = address('9uXLyyZginMWdUeu22kp7XV7cpV8183xfsVqUxKi5Viy');
+export const FLOOR_LAUNCH_PROGRAM_ID = address('8vfdPWfaA3b9GtJoFUwc36JKDaMfVCJ4oT9HrCrQ6Tdi');
+/** `floor_holders` — the Token-2022 TRANSFER-HOOK holder tally. Equal to `floor_types::holders::FLOOR_HOLDERS_ID`. */
+export const FLOOR_HOLDERS_PROGRAM_ID = address('2EUkJXSwCdRAuhesw2D9FXyGfbi6Kw2yZDyQUnCwc7te');
+/** `floor_vesting`, for reading its accounts. */
+export const FLOOR_VESTING_PROGRAM_ID = address('HHiwbXs3egRwtgEPEKx1PHpBU8gq5VSbhfrGrcCd4CSC');
+// ---- seeds ---------------------------------------------------------
+const utf8 = (s) => new TextEncoder().encode(s);
+export const SEEDS = {
+    ...CARPENTER_SEEDS,
+    hookConfig: utf8('hook_config'),
+    floorPool: utf8('floor_pool'),
+    launchConfig: utf8('launch_config'),
+    registryEntry: utf8('entry'),
+    launch: utf8('launch'),
+    saleVault: utf8('sale_vault'),
+    buyer: utf8('buyer'),
+    mint: utf8('mint'),
+    mintAuthority: utf8('mint_authority'),
+    lockAuthority: utf8('lock_authority'),
+    launchAuthority: utf8('launch_authority'),
+    /** `["quote", quote_mint]` under `floor_hook` — the FLOOR quote roster entry a launch on any quote but wSOL is
+     * created against. */
+    quotePolicy: utf8('quote'),
+    // `["grad_rent", launch]`, the launch's graduation rent reserve.
+    gradRent: utf8('grad_rent'),
+    /** `["stair_rent", amm_pool]` under floor_hook. */
+    stairRent: utf8('stair_rent'),
+    /** `["stair", floor_pool]` under `floor_hook`, a staircase pool's
+     *  `StairState` — created by `prepare_positions` (or inside the graduating buy), filled by graduation. */
+    stair: utf8('stair'),
+    /** `["platform_treasury"]` under `floor_hook` — the program-owned PLATFORM TREASURY. Its ADDRESS owns every token
+     * account the 2.5 % `$FLOOR` cut is swept into (`ATA(treasury, quote)`, one per quote); its DATA is the governance that
+     * alone may withdraw. No private key exists for it. */
+    platformTreasury: utf8('platform_treasury'),
+    /** `["team_treasury"]` under `floor_hook` — the program-owned
+     * TEAM treasury, `PlatformTreasury`'s layout. Its ADDRESS owns every token account the platform fee
+     * is swept into (`ATA(team, quote)`, opened by the first sweep that moves a team fee in that quote);
+     * its DATA is the governance that alone may `withdraw_team`. Never crosses the platform treasury. */
+    teamTreasury: utf8('team_treasury'),
+    /** `["floor_platform_pool"]`
+     * under `floor_hook` — the ONE record of `$FLOOR`'s pool (`FloorPlatformPool`), set once by
+     * `designate_floor_pool`; its ADDRESS owns the wSOL TRANSIT account `credit_floor_pool` stages a cut
+     * through (`ATA(record, wSOL)`, zero at rest). Never a treasury. */
+    floorPlatformPool: utf8('floor_platform_pool'),
+    /** `["trader_link", trader]` under `floor_launch`. */
+    traderLink: utf8('trader_link'),
+    /** `["trader_ref", trader, quote_mint]` under `floor_hook` — a trader's bucket in one quote. */
+    traderRef: utf8('trader_ref'),
+    /** `["trader_ref_vault"]` under `floor_hook` — the shared vault's authority (one ATA per quote). */
+    traderRefVault: utf8('trader_ref_vault'),
+    /** `["trader_ref_sale", launch]` under `floor_launch` — a launch's sale-path referral account. */
+    traderRefSale: utf8('trader_ref_sale'),
+};
+/**
+ * `floor_holders`' seeds, every one under `FLOOR_HOLDERS_PROGRAM_ID`.
+ * ⚠ `extraAccountMetas` is the Token-2022 transfer-hook INTERFACE's own seed, `["extra-account-metas", mint]` with a
+ *   HYPHEN — `spl_transfer_hook_interface::get_extra_account_metas_address` derives it under the hook program, and
+ *   Token-2022 looks the account up by exactly that address.
+ */
+export const HOLDERS_SEEDS = {
+    /** `["holders_authority"]` — signs `floor_hook::pay_holder` (the only door holder money leaves by). */
+    holdersAuthority: utf8('holders_authority'),
+    /** `["holder_book", mint]` — one launch's tally (acc, eligible, indexed, unallocated, paid). */
+    holderBook: utf8('holder_book'),
+    /** `["extra-account-metas", mint]` — the transfer-hook interface's validation account. */
+    extraAccountMetas: utf8('extra-account-metas'),
+    /** `["holder", mint, token_account]` — ONE holder's record, keyed by its ATA, never its wallet. */
+    holderRecord: utf8('holder'),
+};
+/** `0x20CC | 0x4000`. */
+export const FLOOR_HOOK_FLAGS = 0x60cc;
+/**
+ * The accounts every FLOOR hook callback takes (`ApprovedHook.callback_accounts`, copied into each pool as
+ * `Pool.hook_callback_accounts`): `[floor_pool w, trader_bucket w, floor_hook event_authority r, floor_hook r]`. The
+ * program set this SDK builds for carries 4; an older set carries fewer, and `createSolanaAdapter` refuses to build
+ * trades against it (`program_version`).
+ */
+export const FLOOR_CALLBACK_ACCOUNTS = 4;
+// ---- FLOOR --------------------------------------
+export const FLOOR_TICK_SPACING = 60;
+export const TOKEN_DECIMALS = 6;
+export const SUPPLY = 1000000000000000n;
+/** The standard supply split: 30 / 10 / 60 (sale / POL / ladder). */
+export const SALE_TOKENS = 300000000000000n;
+export const POL_TOKENS = 100000000000000n;
+export const LADDER_TOKENS = 600000000000000n;
+export const TICKS_PER_DOUBLING = 6_932;
+/**
+ * The bid is a BAND `[floor_tick − W, floor_tick]`, `W = ceil_to_spacing(BID_BAND_TICKS, s)` — 120 at
+ * spacing 60 (`floor_types::constants::BID_BAND_TICKS`, `floor_math::band`). The SDK reads it to
+ * predict the bid's arrays at graduation.
+ */
+export const BID_BAND_TICKS = 120;
+export const LP_FEE_PIPS = 2_500;
+export const PLATFORM_BPS = 250;
+/**
+ * THE FLOOR PLATFORM FEE ("team fee" in code): a SALE rate and a POOL rate, each a governance-set CURRENT SETTING in
+ * `LaunchConfig` under a cap, COPIED into each launch / pool at its creation and kept for life. ⛔ Informational: every
+ * figure uses the ACCOUNT's own `Launch.teamBps` / `FloorPool.teamFeeBps` (0 on older accounts), and "what a new launch
+ * pays now" is `launchConfigTeamSaleBps` / `launchConfigTeamPoolBps` on the decoded config — never these defaults.
+ */
+/** The sale's default, on every bonding-sale buy AND sell-back — 1 %. */
+export const TEAM_SALE_FEE_BPS_DEFAULT = 100;
+/** The most `set_team_fees` may set for the sale — 1 %. */
+export const TEAM_SALE_FEE_BPS_MAX = 100;
+/** The pool's default, on every swap after graduation — 0.25 %. */
+export const TEAM_POOL_FEE_BPS_DEFAULT = 25;
+/** The most `set_team_fees` may set for a pool — 0.5 %. */
+export const TEAM_POOL_FEE_BPS_MAX = 50;
+/** The FAR skim cap per side, 10 %. The sell skim ramps to its at-floor endpoint (`skimSellAtFloorBps`). */
+export const MAX_SKIM_FAR_BPS = 1_000;
+/** The creator fee cap per side: 5 %. */
+export const MAX_CREATOR_BPS = 500;
+/** The holder rate cap per side: 10 %. */
+export const MAX_HOLDER_BPS = 1_000;
+export const SALT_BID = 1n;
+export const SALT_SEED = 3n;
+/** The staircase's position salts (`floor_types::constants`): the open tail
+ *  above the staircase, the cushion, the POL re-list, the RESERVE and step i's `SALT_STAIR_STEP0 + i`. Found BY KEY. */
+export const SALT_STAIR_TAIL = 102n;
+export const SALT_CUSHION = 103n;
+export const SALT_POL_RELIST = 104n;
+export const SALT_STAIR_RESERVE = 105n;
+export const SALT_STAIR_STEP0 = 110n;
+export const MAX_STAIR_STEPS = 16;
+/** One staircase operation per ratchet (the compute budget); what is left sets `FloorPool.needsRatchet`. */
+export const STAIR_STEPS_PER_RATCHET = 1;
+/** `Launch.state`: the bonding sale, then graduated. Any other value is a launch that is not trading (read as `pending`). */
+export const LAUNCH_STATE_BONDING = 0;
+export const LAUNCH_STATE_GRADUATED = 1;
+// ---- the PayeeSlots tail ----
+// A launch names up to five creator-fee recipients and up to five team-buy payees; each slot is an ADDRESS (platform 0)
+// or a PENDING HANDLE id (platform 1..=4).
+/** At most five slots in a list. */
+export const MAX_SLOTS = 5;
+/** A list's shares sum to exactly this. */
+export const SLOTS_TOTAL_BPS = 10_000;
+/** 1 X / twitter, 2 github, 3 discord, 4 telegram; 0 = an address slot. */
+export const MAX_SLOT_PLATFORM = 4;
+/** The `PayeeSlots` tail's ACCOUNT offset in a `FloorPool` account: straight after the TWAP oracle (1,008). */
+export const PAYEE_SLOTS_OFFSET = 1_008;
+/** `size_of::<PayeeSlot>()`. */
+export const PAYEE_SLOT_SIZE = 56;
+/** `size_of::<PayeeSlots>()`. */
+export const PAYEE_SLOTS_SIZE = 568;
+/** The `FloorPool` account `register_pool` creates: 1,008 + 568 = 1,576 bytes. */
+export const FLOOR_POOL_ACCOUNT_LEN_WITH_SLOTS = PAYEE_SLOTS_OFFSET + PAYEE_SLOTS_SIZE;
+/**
+ * The team's per-slot books (`floor_types::slots::TeamParts`), the `FloorPool` account's tail after the slots —
+ * `out_mask` u128 @0 (bit 5·i + s: slot s exited step i), `part_tokens` @16, `part_quote` @24, `token_credit[5]` @32,
+ * `quote_credit[5]` @72, `pending_ask[5]` @112.
+ */
+export const TEAM_PARTS_OFFSET = FLOOR_POOL_ACCOUNT_LEN_WITH_SLOTS;
+/** `size_of::<TeamParts>()`. */
+export const TEAM_PARTS_SIZE = 152;
+/** The `FloorPool` account `register_pool` creates: 1,576 + 152 = 1,728 bytes. */
+export const FLOOR_POOL_ACCOUNT_LEN_WITH_PARTS = TEAM_PARTS_OFFSET + TEAM_PARTS_SIZE;
+/** `PayeeSlots.version` once `register_pool` wrote the lists. */
+export const PAYEE_SLOTS_VERSION = 1;
+/** `PayeeSlot.state`: an address slot from creation. */
+export const SLOT_STATE_WALLET = 0;
+/** A handle slot still waiting for its claim (`key` is the pending id; the share is HELD). */
+export const SLOT_STATE_PENDING = 1;
+/** A handle slot claimed (`key` is the claimed wallet; the pending id is in the `PayeeSlotsSet` event). */
+export const SLOT_STATE_RESOLVED = 2;
+/** Which list (`PayeeSlotsSet`'s `creator` / `team` list). */
+export const SLOT_KIND_CREATOR = 0;
+export const SLOT_KIND_TEAM = 1;
+/** `FloorPool.stair_kind`: the staircase's parameter set — the presets' (0) or `$FLOOR`'s (1). */
+export const STAIR_KIND_PRESET = 0;
+export const STAIR_KIND_GENESIS = 1;
+/**
+ * The mode byte (`Launch.mode`, `FloorPool.mode`): 0 Custom, 1 Moonshot, 2 Cook, 3 Bluechip — the EVM's `FloorModes.Mode`
+ * ordinals too. A zeroed byte is Custom.
+ * ⛔ A DECODER MUST REFUSE AN ORDINAL IT CANNOT PLACE, never fall through to a default. Further modes append (4..=31).
+ */
+export const MODE_CUSTOM = 0;
+export const MODE_MOONSHOT = 1;
+export const MODE_COOK = 2;
+export const MODE_BLUECHIP = 3;
+/** Every mode byte the programs define, in `floor_math::Mode` order. */
+export const MODES = [MODE_CUSTOM, MODE_MOONSHOT, MODE_COOK, MODE_BLUECHIP];
+export const PENDING_PLATFORM_NONE = 0;
+export const PENDING_PLATFORM_TWITTER = 1;
+export const PENDING_PLATFORM_GITHUB = 2;
+export const PENDING_PLATFORM_DISCORD = 3;
+export const PENDING_PLATFORM_TELEGRAM = 4;
+/** Ticks from the price down to 0.9 × the price (`floor_math::stair::CUSHION_TICKS`): the cushion's width. */
+export const CUSHION_TICKS = 1_054;
+/** No protocol listing within ~3 % above the floor: `floor_math::stair::STAIR_CLEAR_TICKS`. */
+export const STAIR_CLEAR_TICKS = 254;
+/** The cushion's re-list cost markup, 1.03× in ticks (`floor_math::stair::RELIST_COST_MARKUP_TICKS`). */
+export const RELIST_COST_MARKUP_TICKS = 296;
+/** `floor_types::twap::CUSHION_TWAP_WINDOW_SECS`: the cushion sits under min(spot, the pool's TWAP over this window). */
+export const CUSHION_TWAP_WINDOW_SECS = 900;
+/** The cushion follows net buying: the net-flow meter's memory H in bps of the market cap
+ *  (`floor_math::netflow::STAIR_CUSHION_NETFLOW_BPS`); 0 would be off. */
+export const STAIR_CUSHION_NETFLOW_BPS = 130;
+/** The meter's catch-up by volume K (`floor_math::netflow::STAIR_CUSHION_NETFLOW_RELAX_BPS`); 0 = none. */
+export const STAIR_CUSHION_NETFLOW_RELAX_BPS = 0;
+/** The half rule: a buy is remembered by its own last slice of quote, and one buy takes at most half of a meter that
+ *  holds anything. */
+export const STAIR_CUSHION_NETFLOW_HALF_RULE = true;
+/**
+ * `SetComputeUnitLimit` values: each an estimate (`[est.]`) or a measured figure × 1.5, capped at the 1.4 M
+ * per-transaction limit. ⛔ Every builder prepends one: an unset limit is 0 under v1 transactions.
+ */
+export const CU_LIMITS = {
+    ...CARPENTER_CU_LIMITS,
+    // A graduated BUY on a HOOKED pool, the transfer-hook accounts appended (Token-2022's `execute` CPI into
+    // floor_holders on the base leg): measured 144,895 CU; × 1.5 rounded up. Unhooked it measured 91,007.
+    swapFloorBuy: 218_000,
+    // A SELL: the in-swap bid re-place (up to 3 rounds + bisection) plus the hooked base leg's `execute`. A hooked sell
+    // measured 243,762 CU (× 1.5 = 365,643); 520,000 [est.] is kept as the ceiling for the re-place's worst case.
+    swapFloorSell: 520_000,
+    buyFinal: 1_400_000, // 1.0M [est.] × 1.5, capped at the 1.4M tx limit. ⛔ EVERY sale buy uses it.
+    // `initialize_pool` + up to four `initialize_tick_array` + four `initialize_position` [est.], deliberately generous:
+    // the instruction is idempotent, so a call that runs out of compute is re-run rather than lost.
+    prepareGraduation: 900_000,
+    sellBack: 60_000, // 40k [est.] × 1.5
+    closeBuyerPosition: 20_000, // [est.]
+    /** `touch` / `open_record`: catch_up, a prefund-safe record create, one settle, emit_cpi [est.]. */
+    holdersTouch: 60_000,
+    /** `sync`: catch_up + one settle; no create, no CPI [est.]. */
+    holdersSync: 40_000,
+    // The trader link: Ed25519 read + the TraderLink create + the open_trader_bucket CPI + emit_cpi [est.].
+    linkTrader: 90_000,
+    saleTraderRef: 30_000, // a referred sale trade's extra: the credit_trader_bucket CPI + a transfer + emit_cpi [est.]
+};
+/**
+ * `RequestHeapFrame` sizes, in bytes (a multiple of 1,024, from 32 KiB to 256 KiB). `finalize` places one right after the
+ * `SetComputeUnitLimit` of every builder whose `CU_LIMITS` key is listed here; none of this package's builders needs
+ * more than the default 32 KiB.
+ */
+export const HEAP_FRAMES = {};
+/** The Instructions sysvar, which `link_trader` introspects for the attestor's Ed25519 signature. */
+export const INSTRUCTIONS_SYSVAR_ID = address('Sysvar1nstructions1111111111111111111111111');
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

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

package/dist/deployments.d.ts

@@ -0,0 +1,109 @@
+/**
+ * FLOOR's deployments on Solana: `floor_hook` / `floor_launch` / `floor_holders` / `floor_vesting` per cluster, keyed by
+ * CAIP-2 id, with FLOOR's singleton accounts, the deployment address lookup table and the hook roster's quote terms.
+ * `carpenter_amm`'s rows are `@floorlaunchpad/carpenter-sdk`'s `deployments.json`.
+ *
+ * ⛔ `deploymentFor` returns the JOINED row — Carpenter's row and FLOOR's for the same cluster (`programs.carpenterAmm`
+ *    beside FLOOR's ids) — because every FLOOR builder names the AMM it is hooked on. It throws BY NAME when EITHER file
+ *    lacks the cluster: a missing row must never read as a cluster with no launches.
+ * ⛔ Program ids come from these files, never a constant in an app. A row may name program ids other than the shipped
+ *    IDLs' `address` (another cluster's deployment); every builder, PDA and read takes the ids it is given
+ *    (`programIdsFromDeployment(row)`). The devnet and local rows are the ones generation pins to the IDLs.
+ * ⛔ `alt` is FLOOR's deployment lookup table (FLOOR's programs, configs and PDAs beside the AMM's); read its contents
+ *    from the chain.
+ * ⛔ A `quotes` entry is a RECORD of a listing, never an authority: the rosters on chain are.
+ */
+import { type ClusterDeployment as CarpenterClusterDeployment, type DeploymentsFile as CarpenterDeploymentsFile } from '@floorlaunchpad/carpenter-sdk';
+import { DEPLOYMENTS } from './generated/deployments.ts';
+export type { AnchorIdl, AnchorIdlAccountItem, AnchorIdlInstruction } from '@floorlaunchpad/carpenter-sdk';
+export { DEPLOYMENTS };
+/**
+ * FLOOR's four deployable programs, by their Anchor crate name (the IDL file stem).
+ */
+export type ProgramName = 'floor_hook' | 'floor_launch' | 'floor_holders' | 'floor_vesting';
+export declare const PROGRAM_NAMES: readonly ProgramName[];
+/** One cluster's FLOOR row in this package's `deployments.json`. */
+export interface FloorClusterDeployment {
+    readonly name: 'mainnet' | 'devnet' | 'testnet' | 'local';
+    readonly chainKey: string | null;
+    readonly programs: {
+        readonly floorHook: string;
+        readonly floorLaunch: string;
+        readonly floorHolders: string;
+        readonly floorVesting: string;
+    };
+    readonly accounts: {
+        readonly hookConfig: string;
+        readonly launchConfig: string;
+        /** The team treasury PDA, where a row records it. */
+        readonly teamTreasury?: string;
+    };
+    /** The per-deployment address lookup table; `null` until created. */
+    readonly alt: string | null;
+    /** Each deployed ProgramData's EXECUTABLE hash; `null` until recorded. */
+    readonly programDataHash: {
+        readonly floorHook: string | null;
+        readonly floorLaunch: string | null;
+        readonly floorHolders: string | null;
+        readonly floorVesting: string | null;
+    };
+    /** The quote mints listed on the HOOK's roster (`["quote", mint]`), with their terms (raw units, decimal strings). */
+    readonly quotes?: Readonly<Record<string, HookQuoteListingRecord>>;
+}
+/** One quote on the hook's roster: the listing state, the terms and the hook's `QuotePolicy` account. */
+export interface HookQuoteListingRecord {
+    /** `listed` on both rosters, `retired` on both, or the split the script could only half-finish. */
+    readonly state: 'listed' | 'retired' | 'amm-only' | 'hook-only';
+    readonly decimals: number;
+    readonly tokenProgram: string;
+    readonly terms: {
+        readonly minBidFloor: string;
+        readonly minBidCeil: string;
+        readonly maxBountyCeil: string;
+        readonly minBid: string;
+        readonly maxBounty: string;
+    };
+    readonly hook: {
+        readonly policy: string;
+    };
+}
+export interface DeploymentsFile {
+    readonly version: 1;
+    readonly clusters: Readonly<Record<string, FloorClusterDeployment>>;
+}
+/** One listed quote, both rosters' records joined: the AMM's `QuoteMint` entry and caps beside the hook's terms. */
+export interface QuoteListingRecord extends HookQuoteListingRecord {
+    readonly caps: number;
+    readonly capNames: readonly string[];
+    readonly amm: {
+        readonly entry: string;
+        readonly listedSlot: string | null;
+    };
+}
+/** The JOINED row: Carpenter's and FLOOR's for one cluster. */
+export interface ClusterDeployment {
+    readonly name: 'mainnet' | 'devnet' | 'testnet' | 'local';
+    readonly chainKey: string | null;
+    readonly programs: {
+        readonly carpenterAmm: string;
+    } & FloorClusterDeployment['programs'];
+    readonly accounts: CarpenterClusterDeployment['accounts'] & FloorClusterDeployment['accounts'];
+    readonly alt: string | null;
+    readonly programDataHash: {
+        readonly carpenterAmm: string | null;
+    } & FloorClusterDeployment['programDataHash'];
+    readonly quotes?: Readonly<Record<string, QuoteListingRecord>>;
+}
+/**
+ * Join one cluster's Carpenter row and FLOOR row. ⛔ Refuses rows of two different clusters by name (a `chainKey` or
+ * `name` mismatch), and a quote the hook's roster records that the AMM's does not (the hook refuses a listing the AMM
+ * has not made, so such a record is a half-finished script run the joined shape cannot express — it keeps the hook's
+ * half and reads `caps` 0, `capNames` [] and an empty `amm`).
+ */
+export declare function joinDeployment(carpenter: CarpenterClusterDeployment, floor: FloorClusterDeployment): ClusterDeployment;
+/**
+ * The JOINED deployment for a cluster key, over both shipped files by default. Throws BY NAME on a key either file
+ * lacks: a missing row must never read as a cluster with no launches.
+ */
+export declare function deploymentFor(clusterKey: string, file?: DeploymentsFile, carpenterFile?: CarpenterDeploymentsFile): ClusterDeployment;
+//# sourceMappingURL=deployments.d.ts.map

package/dist/deployments.d.ts.map

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