@floorlaunchpad/sdk-solana 0.0.0-stage → 0.1.0

package/dist/stateView.d.ts

@@ -0,0 +1,136 @@
+/**
+ * `stateView`: FLOOR's reads (`floor_hook`, `floor_launch`, `floor_holders`) beside `@floorlaunchpad/carpenter-sdk`'s — `stateView`
+ * here spreads Carpenter's object. Every helper takes an `AccountSource` and returns the decoded value WITH the slot it
+ * was read at.
+ *
+ * ⛔ Inside a hooked flow, pool state comes from instruction data or post-state, never from a stale account: these
+ *    helpers are for UIs and for building transactions.
+ * ⛔ Every account is checked for its OWNER program as well as its discriminator; a lookalike account owned by another
+ *    program is `null`, never decoded.
+ */
+import { type AtSlot, type AccountSource } from '@floorlaunchpad/carpenter-sdk';
+import { type BuyerPosition, type FloorPool, type HookConfig, type Launch, type LaunchConfig, type PlatformTreasury, type QuotePolicy, type StairState } from './layouts.ts';
+import { type ProgramIds } from './pda.ts';
+import type { Address } from '@solana/kit';
+export declare function getHookConfig(src: AccountSource, ids?: ProgramIds): Promise<AtSlot<HookConfig | null>>;
+/**
+ *  the program-owned platform treasury (`["platform_treasury"]` under
+ * `floor_hook`) — its governance and any pending handover. `null` before `initialize_hook_config` has run.
+ */
+export declare function getPlatformTreasury(src: AccountSource, ids?: ProgramIds): Promise<AtSlot<PlatformTreasury | null>>;
+/**
+ *  the program-owned TEAM treasury (`["team_treasury"]` under
+ * `floor_hook`, `PlatformTreasury`'s layout) — its governance and any pending handover. `null` until
+ * `initialize_team_treasury` has run; until then every sweep skips its team leg and the pool keeps `team_owed`.
+ */
+export declare function getTeamTreasury(src: AccountSource, ids?: ProgramIds): Promise<AtSlot<PlatformTreasury | null>>;
+/**
+ *  presence for the FLOOR quote roster entry.
+ * `null` means "not on the FLOOR roster" — and wSOL is NEVER on it: it is admitted by construction
+ * with compiled-in terms (`quote_policy.rs`: `list_quote` refuses it `QuoteAlreadyListed`), so a
+ * `null` for wSOL is the expected answer, not a missing listing. `retired === 1` blocks NEW pools
+ * only; there is no un-retire. Owner, length and discriminator are all checked, as `getQuoteMint`
+ * does for the AMM's entry: a lamport at the address never means presence.
+ */
+export declare function getQuotePolicy(src: AccountSource, quoteMint: Address, ids?: ProgramIds): Promise<AtSlot<QuotePolicy | null>>;
+export declare function getFloorPool(src: AccountSource, ammPool: Address, ids?: ProgramIds): Promise<AtSlot<FloorPool | null>>;
+/**
+ * A staircase pool's `StairState`
+ * (`["stair", floor_pool]` under `floor_hook`), or `null` — on every pool without a staircase, and on a staircase launch
+ * before `prepare_positions` / its graduating buy created it. `floorPool` is the `FloorPool` ADDRESS (`findFloorPool(amm)`).
+ * The ratchet of a graduated staircase pool needs it (`buildRatchet({ stairState })`).
+ */
+export declare function getStairState(src: AccountSource, floorPool: Address, ids?: ProgramIds): Promise<AtSlot<StairState | null>>;
+export declare function getLaunchConfig(src: AccountSource, ids?: ProgramIds): Promise<AtSlot<LaunchConfig | null>>;
+export declare function getLaunch(src: AccountSource, mint: Address, ids?: ProgramIds): Promise<AtSlot<Launch | null>>;
+export declare function getBuyerPosition(src: AccountSource, launch: Address, buyer: Address, ids?: ProgramIds): Promise<AtSlot<BuyerPosition | null>>;
+/**
+ * One launch as a multi-source reader merges it:
+ * keyed `(chainKey, id)`, where `chainKey` is `solana:<genesis32>` and `id` is the MINT address
+ * (the one key a Solana launch is known by everywhere: the Launch PDA and the registry entry
+ * both derive from or point at it).
+ * ⛔ Name and symbol are chain-only; they are not in these accounts (Token-2022 metadata carries
+ *    them) and this row does not invent them.
+ */
+export interface LaunchRow {
+    readonly chainKey: string;
+    readonly id: Address;
+    readonly registryIndex: bigint;
+    readonly launch: Address;
+    readonly mint: Address;
+    readonly ammPool: Address;
+    readonly mode: number;
+    readonly createdSlot: bigint;
+    /** `null` when the Launch account was not readable (it never should be, once registered). */
+    readonly state: Launch | null;
+}
+/**
+ * Every launch, newest first, over `RegistryEntry`. Two strategies, both exact:
+ * - `mode: 'index'` (default, browser-safe): read `LaunchConfig.registry_count`, then entries
+ *   `[count-1 … count-limit]` by PDA with `getMultipleAccounts`; no `getProgramAccounts`.
+ * - `mode: 'scan'` (server-side): one `getProgramAccounts` on the discriminator.
+ * `nextBefore` is where the next page starts (pass it as `before`), or `null` at the end. In `index` mode it is the
+ * lowest registry index this page PROBED, so an entry that is missing or unreadable never ends paging early: a page can
+ * hold fewer than `limit` rows and still have a next one.
+ * ⛔ The listing is UNFILTERED, with the risk stated: anyone can create a launch, with any name and symbol.
+ */
+export declare function listLaunches(src: AccountSource, chainKey: string, opts?: {
+    before?: bigint;
+    limit?: number;
+    mode?: 'index' | 'scan';
+    withState?: boolean;
+}, ids?: ProgramIds): Promise<AtSlot<LaunchRow[]> & {
+    nextBefore: bigint | null;
+}>;
+/** The named `stateView` object: Carpenter's reads, then FLOOR's. */
+export declare const stateView: {
+    readonly getHookConfig: typeof getHookConfig;
+    readonly getQuotePolicy: typeof getQuotePolicy;
+    readonly getFloorPool: typeof getFloorPool;
+    readonly getLaunchConfig: typeof getLaunchConfig;
+    readonly listLaunches: typeof listLaunches;
+    readonly getLaunch: typeof getLaunch;
+    readonly getBuyerPosition: typeof getBuyerPosition;
+    readonly getAmmConfig: (src: AccountSource, ids?: import("@floorlaunchpad/carpenter-sdk").ProgramIds) => Promise<AtSlot<import("@floorlaunchpad/carpenter-sdk").AmmConfig | null>>;
+    readonly getPool: (src: AccountSource, pool: Address, ids?: import("@floorlaunchpad/carpenter-sdk").ProgramIds) => Promise<AtSlot<import("@floorlaunchpad/carpenter-sdk").Pool | null>>;
+    readonly getSlot0: typeof import("@floorlaunchpad/carpenter-sdk").getSlot0;
+    readonly getLiquidity: typeof import("@floorlaunchpad/carpenter-sdk").getLiquidity;
+    readonly getBitmap: typeof import("@floorlaunchpad/carpenter-sdk").getBitmap;
+    readonly getTickArray: typeof import("@floorlaunchpad/carpenter-sdk").getTickArray;
+    readonly getTickInfo: typeof import("@floorlaunchpad/carpenter-sdk").getTickInfo;
+    readonly getTickArraysAround: typeof import("@floorlaunchpad/carpenter-sdk").getTickArraysAround;
+    readonly getFeeGrowthInside: typeof import("@floorlaunchpad/carpenter-sdk").getFeeGrowthInside;
+    readonly getPosition: typeof import("@floorlaunchpad/carpenter-sdk").getPosition;
+    readonly positionsForOwner: typeof import("@floorlaunchpad/carpenter-sdk").positionsForOwner;
+    readonly listPools: typeof import("@floorlaunchpad/carpenter-sdk").listPools;
+    readonly getMintPoolCount: typeof import("@floorlaunchpad/carpenter-sdk").getMintPoolCount;
+    readonly getQuoteMint: typeof import("@floorlaunchpad/carpenter-sdk").getQuoteMint;
+    readonly getMintExclusivity: typeof import("@floorlaunchpad/carpenter-sdk").getMintExclusivity;
+    readonly getApprovedHook: typeof import("@floorlaunchpad/carpenter-sdk").getApprovedHook;
+    readonly listApprovedHooks: typeof import("@floorlaunchpad/carpenter-sdk").listApprovedHooks;
+    readonly getProtocolTreasury: typeof import("@floorlaunchpad/carpenter-sdk").getProtocolTreasury;
+    readonly getMintExtensions: typeof import("@floorlaunchpad/carpenter-sdk").getMintExtensions;
+    readonly getAtaExtensions: typeof import("@floorlaunchpad/carpenter-sdk").getAtaExtensions;
+};
+export declare function getHolderPayoutInputs(src: AccountSource, a: {
+    owner: Address;
+    mint: Address;
+    floorPool: Address;
+    ids?: ProgramIds;
+}): Promise<{
+    slot: bigint;
+    value: null;
+} | {
+    slot: bigint;
+    value: {
+        book: Uint8Array<ArrayBufferLike>;
+        record: Uint8Array<ArrayBufferLike>;
+        floorPool: Uint8Array<ArrayBufferLike>;
+        liveBalance: bigint;
+        ammPool: Address;
+        quoteMint: Address;
+        tokenAccount: Address;
+        recordAddress: Address;
+    };
+}>;
+//# sourceMappingURL=stateView.d.ts.map

package/dist/stateView.d.ts.map

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

package/dist/stateView.js

@@ -0,0 +1,203 @@
+/**
+ * `stateView`: FLOOR's reads (`floor_hook`, `floor_launch`, `floor_holders`) beside `@floorlaunchpad/carpenter-sdk`'s — `stateView`
+ * here spreads Carpenter's object. Every helper takes an `AccountSource` and returns the decoded value WITH the slot it
+ * was read at.
+ *
+ * ⛔ Inside a hooked flow, pool state comes from instruction data or post-state, never from a stale account: these
+ *    helpers are for UIs and for building transactions.
+ * ⛔ Every account is checked for its OWNER program as well as its discriminator; a lookalike account owned by another
+ *    program is `null`, never decoded.
+ */
+import { stateView as carpenterStateView, TOKEN_2022_PROGRAM_ID, hasDiscriminator, decodeTokenAccount, } from '@floorlaunchpad/carpenter-sdk';
+import { BUYER_POSITION, decodeBuyerPosition, decodeFloorPool, decodeHookConfig, decodeLaunch, decodeLaunchConfig, decodePlatformTreasury, decodeQuotePolicy, decodeRegistryEntry, QUOTE_POLICY, REGISTRY_ENTRY, decodeStairState, } from "./layouts.js";
+import { DEFAULT_PROGRAM_IDS, findBuyerPosition, findFloorPool, findHookConfig, findPlatformTreasury, findTeamTreasury, findLaunch, findLaunchConfig, findQuotePolicy, findRegistryEntry, findStairState, } from "./pda.js";
+function ownedBy(a, program) {
+    return a && a.owner === program ? a : null;
+}
+async function readOwned(src, address, program, decode) {
+    const { slot, account } = await src.getAccount(address);
+    const a = ownedBy(account, program);
+    return { slot, value: a ? decode(a.data) : null };
+}
+function decodeAll(rows, layout, decode) {
+    const out = [];
+    for (const { address, account } of rows) {
+        if (!hasDiscriminator(layout, account.data))
+            continue;
+        out.push([address, decode(account.data)]);
+    }
+    return out;
+}
+// ---- FLOOR --------------------------------------------------------------------------------------
+export async function getHookConfig(src, ids = DEFAULT_PROGRAM_IDS) {
+    return readOwned(src, (await findHookConfig(ids)).address, ids.floorHook, decodeHookConfig);
+}
+/**
+ *  the program-owned platform treasury (`["platform_treasury"]` under
+ * `floor_hook`) — its governance and any pending handover. `null` before `initialize_hook_config` has run.
+ */
+export async function getPlatformTreasury(src, ids = DEFAULT_PROGRAM_IDS) {
+    return readOwned(src, (await findPlatformTreasury(ids)).address, ids.floorHook, decodePlatformTreasury);
+}
+/**
+ *  the program-owned TEAM treasury (`["team_treasury"]` under
+ * `floor_hook`, `PlatformTreasury`'s layout) — its governance and any pending handover. `null` until
+ * `initialize_team_treasury` has run; until then every sweep skips its team leg and the pool keeps `team_owed`.
+ */
+export async function getTeamTreasury(src, ids = DEFAULT_PROGRAM_IDS) {
+    return readOwned(src, (await findTeamTreasury(ids)).address, ids.floorHook, decodePlatformTreasury);
+}
+/**
+ *  presence for the FLOOR quote roster entry.
+ * `null` means "not on the FLOOR roster" — and wSOL is NEVER on it: it is admitted by construction
+ * with compiled-in terms (`quote_policy.rs`: `list_quote` refuses it `QuoteAlreadyListed`), so a
+ * `null` for wSOL is the expected answer, not a missing listing. `retired === 1` blocks NEW pools
+ * only; there is no un-retire. Owner, length and discriminator are all checked, as `getQuoteMint`
+ * does for the AMM's entry: a lamport at the address never means presence.
+ */
+export async function getQuotePolicy(src, quoteMint, ids = DEFAULT_PROGRAM_IDS) {
+    const { slot, account } = await src.getAccount((await findQuotePolicy(quoteMint, ids)).address);
+    const a = ownedBy(account, ids.floorHook);
+    const present = a && a.data.length === 8 + QUOTE_POLICY.size && hasDiscriminator(QUOTE_POLICY, a.data);
+    return { slot, value: present ? decodeQuotePolicy(a.data) : null };
+}
+export async function getFloorPool(src, ammPool, ids = DEFAULT_PROGRAM_IDS) {
+    return readOwned(src, (await findFloorPool(ammPool, ids)).address, ids.floorHook, decodeFloorPool);
+}
+/**
+ * A staircase pool's `StairState`
+ * (`["stair", floor_pool]` under `floor_hook`), or `null` — on every pool without a staircase, and on a staircase launch
+ * before `prepare_positions` / its graduating buy created it. `floorPool` is the `FloorPool` ADDRESS (`findFloorPool(amm)`).
+ * The ratchet of a graduated staircase pool needs it (`buildRatchet({ stairState })`).
+ */
+export async function getStairState(src, floorPool, ids = DEFAULT_PROGRAM_IDS) {
+    return readOwned(src, (await findStairState(floorPool, ids)).address, ids.floorHook, decodeStairState);
+}
+export async function getLaunchConfig(src, ids = DEFAULT_PROGRAM_IDS) {
+    return readOwned(src, (await findLaunchConfig(ids)).address, ids.floorLaunch, decodeLaunchConfig);
+}
+export async function getLaunch(src, mint, ids = DEFAULT_PROGRAM_IDS) {
+    return readOwned(src, (await findLaunch(mint, ids)).address, ids.floorLaunch, decodeLaunch);
+}
+export async function getBuyerPosition(src, launch, buyer, ids = DEFAULT_PROGRAM_IDS) {
+    const { slot, account } = await src.getAccount((await findBuyerPosition(launch, buyer, ids)).address);
+    const a = ownedBy(account, ids.floorLaunch);
+    return { slot, value: a && hasDiscriminator(BUYER_POSITION, a.data) ? decodeBuyerPosition(a.data) : null };
+}
+/**
+ * Every launch, newest first, over `RegistryEntry`. Two strategies, both exact:
+ * - `mode: 'index'` (default, browser-safe): read `LaunchConfig.registry_count`, then entries
+ *   `[count-1 … count-limit]` by PDA with `getMultipleAccounts`; no `getProgramAccounts`.
+ * - `mode: 'scan'` (server-side): one `getProgramAccounts` on the discriminator.
+ * `nextBefore` is where the next page starts (pass it as `before`), or `null` at the end. In `index` mode it is the
+ * lowest registry index this page PROBED, so an entry that is missing or unreadable never ends paging early: a page can
+ * hold fewer than `limit` rows and still have a next one.
+ * ⛔ The listing is UNFILTERED, with the risk stated: anyone can create a launch, with any name and symbol.
+ */
+export async function listLaunches(src, chainKey, opts = {}, ids = DEFAULT_PROGRAM_IDS) {
+    if (!/^solana:[1-9A-HJ-NP-Za-km-z]{32}$/.test(chainKey))
+        throw new Error(`listLaunches: chainKey must be solana:<genesis32>, got ${chainKey}`);
+    const limit = opts.limit ?? 50;
+    let entries;
+    let slot;
+    let nextBefore;
+    if (opts.mode === 'scan') {
+        const r = await src.getProgramAccounts(ids.floorLaunch, [
+            { memcmp: { offset: 0, bytes: REGISTRY_ENTRY.discriminator } },
+            { dataSize: 8 + REGISTRY_ENTRY.size },
+        ]);
+        slot = r.slot;
+        entries = decodeAll(r.accounts, REGISTRY_ENTRY, decodeRegistryEntry)
+            .map(([, e]) => e)
+            .filter((e) => opts.before === undefined || e.index < opts.before)
+            .sort((a, b) => (a.index < b.index ? 1 : a.index > b.index ? -1 : 0))
+            .slice(0, limit);
+        const last = entries[entries.length - 1];
+        nextBefore = entries.length === limit && last && last.index > 0n ? last.index : null;
+    }
+    else {
+        const cfg = await getLaunchConfig(src, ids);
+        if (!cfg.value)
+            throw new Error('listLaunches: LaunchConfig is not initialized on this cluster');
+        const top = opts.before === undefined || opts.before > cfg.value.registryCount ? cfg.value.registryCount : opts.before;
+        const indices = [];
+        for (let i = top - 1n; i >= 0n && indices.length < limit; i--)
+            indices.push(i);
+        const lowest = indices[indices.length - 1];
+        nextBefore = lowest !== undefined && lowest > 0n ? lowest : null;
+        const addrs = await Promise.all(indices.map(async (i) => (await findRegistryEntry(i, ids)).address));
+        const r = await src.getMultipleAccounts(addrs);
+        slot = r.slot < cfg.slot ? r.slot : cfg.slot;
+        entries = [];
+        r.accounts.forEach((a, i) => {
+            const owned = ownedBy(a, ids.floorLaunch);
+            if (owned && hasDiscriminator(REGISTRY_ENTRY, owned.data)) {
+                const e = decodeRegistryEntry(owned.data);
+                if (e.index === indices[i])
+                    entries.push(e);
+            }
+        });
+    }
+    let states = entries.map(() => null);
+    if (opts.withState !== false && entries.length > 0) {
+        const r = await src.getMultipleAccounts(entries.map((e) => e.launch));
+        slot = r.slot < slot ? r.slot : slot;
+        states = r.accounts.map((a) => {
+            const owned = ownedBy(a, ids.floorLaunch);
+            return owned ? decodeLaunch(owned.data) : null;
+        });
+    }
+    return {
+        slot,
+        nextBefore,
+        value: entries.map((e, i) => ({
+            chainKey,
+            id: e.mint,
+            registryIndex: e.index,
+            launch: e.launch,
+            mint: e.mint,
+            ammPool: e.ammPool,
+            mode: e.mode,
+            createdSlot: e.createdSlot,
+            state: states[i] ?? null,
+        })),
+    };
+}
+/** The named `stateView` object: Carpenter's reads, then FLOOR's. */
+export const stateView = {
+    ...carpenterStateView,
+    getHookConfig,
+    getQuotePolicy,
+    getFloorPool,
+    getLaunchConfig,
+    listLaunches,
+    getLaunch,
+    getBuyerPosition,
+};
+export async function getHolderPayoutInputs(src, a) {
+    const ids = a.ids ?? DEFAULT_PROGRAM_IDS;
+    const { findHolderBook, findHolderRecord } = await import("./holders.js");
+    const { findAta } = await import('@floorlaunchpad/carpenter-sdk');
+    const { decodeHolderBook, decodeHolderRecord } = await import("./layouts.js");
+    const tokenAccount = (await findAta(a.owner, a.mint, TOKEN_2022_PROGRAM_ID)).address;
+    const [book, record] = await Promise.all([findHolderBook(a.mint, ids), findHolderRecord(a.mint, tokenAccount, ids)]);
+    const { slot, accounts } = await src.getMultipleAccounts([book.address, record.address, a.floorPool, tokenAccount]);
+    const b = ownedBy(accounts[0] ?? null, ids.floorHolders);
+    const r = ownedBy(accounts[1] ?? null, ids.floorHolders);
+    const p = ownedBy(accounts[2] ?? null, ids.floorHook);
+    if (!b || !r || !p)
+        return { slot, value: null };
+    const bookState = decodeHolderBook(b.data);
+    const recordState = decodeHolderRecord(r.data);
+    const pool = decodeFloorPool(p.data);
+    if (bookState.mint !== a.mint || bookState.floorPool !== a.floorPool || bookState.quoteMint !== pool.quoteMint
+        || pool.baseMint !== a.mint || recordState.mint !== a.mint || recordState.tokenAccount !== tokenAccount
+        || recordState.owner !== a.owner)
+        return { slot, value: null };
+    const t = ownedBy(accounts[3] ?? null, TOKEN_2022_PROGRAM_ID);
+    const token = t ? decodeTokenAccount(t.data) : null;
+    const liveBalance = token?.mint === a.mint ? token.amount : 0n;
+    return { slot, value: { book: b.data, record: r.data, floorPool: p.data, liveBalance,
+            ammPool: pool.ammPool, quoteMint: pool.quoteMint, tokenAccount, recordAddress: record.address } };
+}
+//# sourceMappingURL=stateView.js.map

package/dist/stateView.js.map

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

package/dist/tickmath.d.ts

@@ -0,0 +1,60 @@
+/**
+ * FLOOR's tick arithmetic: `open_tick`, the staircase edges, the tranche price and the quote lineage's conversions.
+ * The AMM's tick math (`getSqrtPriceAtTick`, `getTickAtSqrtPrice`, the spacing snaps, tick-array starts) is
+ * `@floorlaunchpad/carpenter-sdk`'s.
+ */
+/**
+ *  `open_tick(price_x64)`: `sqrt = isqrt(2^192 / price_x64)` (U256), then
+ * `tick_at_sqrt_price`. The pool is initialized at `sqrt_price_at_tick(open_tick)`.
+ */
+export declare function openTick(priceX64: bigint): number;
+/**
+ * `floor_math::stair::doubling_ticks(i)`:
+ * ticks for `i` doublings of the token price, `get_tick_at_sqrt_price(sqrt_price_from_ratio(1, 2^i)) + 1` =
+ * `ceil(i · ln 2 / ln 1.0001)`, computed per `i` (never `i · 6,932`). 0 for 0.
+ */
+export declare function doublingTicks(i: number): number;
+/** `floor_math::stair::stair_edge`: the staircase's cheap edge `i` doublings above `openEdge`, on the grid. Step i is
+ *  `[stairEdge(i + 1), stairEdge(i)]`; the reserve from step `f` is `[stairEdge(steps), stairEdge(f)]`; the tail
+ *  `[ceilToSpacing(MIN_TICK), stairEdge(steps)]`. */
+export declare function stairEdge(openEdge: number, i: number, spacing: number): number;
+/**
+ * `floor_math::stair::cushion_home_top`, step for step: the top a cushion takes when `min(spot, TWAP)` has no
+ * range above the bid band — the CHEAPEST full-depth range just above the band, `[dear − ceilToSpacing(width), dear]`
+ * (`dear = floorTick − ceilToSpacing(BID_BAND_TICKS)`), or the spot when the spot is cheaper still (in ticks the HIGHER).
+ */
+export declare function cushionHomeTop(spotTick: number, floorTick: number, spacing: number, width: number, bandTicks?: number): number;
+/** `floor_math::stair::stair_fits`: a staircase of `steps` from `openEdge` leaves at least one spacing for the open tail
+ *  above it (`stairEdge(steps) − spacing ≥ ceilToSpacing(MIN_TICK)`). `resolve_config` refuses a launch that does not
+ *  (`StairDoesNotFit`, 6059) — a quote and a cap whose open tick sits too near the top of the range. */
+export declare function stairFits(openEdge: number, steps: number, spacing: number): boolean;
+/** The admissible decimals of a launch's QUOTE mint, inclusive — the twin of `floor_math::constants::MIN/MAX_QUOTE_DECIMALS`;
+ * `floor_hook::list_quote` refuses a mint outside it and `tranche_price_x64` refuses to price one. The only thing the
+ * arithmetic bounds is the tranche price itself, `0 < p < 2^77`: past `d = 36` no (cap, quote price) a u64 can carry
+ * prices a launch (`p_min(d) = 100·10^d·2^64/(u64::MAX·SUPPLY) >= 2^77` from 37 up), so 36 is derived, not chosen.
+ * ⚠ The EFFECTIVE ceiling for a given launch is far lower and value-shaped: {@link tranchePriceX64} throws
+ * `tranche price out of range` once `mcap·100·10^d/(cents·SUPPLY) >= 2^13` — `d <= 14` at a $30k cap against a $1.00
+ * quote. */
+export declare const MIN_QUOTE_DECIMALS = 0;
+export declare const MAX_QUOTE_DECIMALS = 36;
+/**
+ * `tranche_price_x64(mcap_usd, quote_usd_cents, quote_decimals)`:
+ * `floor(mcap_usd·100·10^d·2^64 / (quote_usd_cents·SUPPLY))`, required `0 < price < 2^77`.
+ *
+ * ⛔ The quote price is in CENTS and the quote's decimals are explicit, so a $1.00 quote prices exactly. This is the ONE
+ * place a decimals count enters the mechanism: everything downstream (`openTick`, the sale walk, the fee split) is raw
+ * base units and Q64.64 and reads no decimals at all.
+ */
+export declare function tranchePriceX64(mcapUsd: bigint, quoteUsdCents: bigint, quoteDecimals: number): bigint;
+/**
+ * The twins of `floor_math::lineage`.
+ * `minBidFor(d)` = `ceil(10^d / 1,000)`, at least 1, saturating at u64::MAX: the default `min_bid` of a quote no
+ * governance roster names. `quoteAmountAtTick(amount, t)` = `amount · sqrt(t)^2 / 2^128` in two `>> 64` steps,
+ * rounded down, saturating at u64::MAX, 0 off the tick range: the smart tip cap's conversion (the parent's raw
+ * `max_bounty` → raw units of the parent's base, at the parent's 1,800 s TWAP tick).
+ */
+export declare const SMART_CAP_TWAP_WINDOW_SECS = 1800;
+export declare function minBidFor(decimals: number): bigint;
+export declare function quoteAmountAtSqrt(amount: bigint, sqrtPriceX64: bigint): bigint;
+export declare function quoteAmountAtTick(amount: bigint, tick: number): bigint;
+//# sourceMappingURL=tickmath.d.ts.map

package/dist/tickmath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tickmath.d.ts","sourceRoot":"","sources":["../src/tickmath.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAaH;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGjD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAO/C;AAED;;qDAEqD;AACrD,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,SAAM,GAAG,MAAM,CAG3H;AAED;;wGAEwG;AACxG,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAEnF;AAED;;;;;;YAMY;AACZ,eAAO,MAAM,kBAAkB,IAAI,CAAC;AACpC,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CASrG;AAED;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,OAAQ,CAAC;AAEhD,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAOlD;AACD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAK9E;AACD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAGtE"}

package/dist/tickmath.js

@@ -0,0 +1,114 @@
+/**
+ * FLOOR's tick arithmetic: `open_tick`, the staircase edges, the tranche price and the quote lineage's conversions.
+ * The AMM's tick math (`getSqrtPriceAtTick`, `getTickAtSqrtPrice`, the spacing snaps, tick-array starts) is
+ * `@floorlaunchpad/carpenter-sdk`'s.
+ */
+import { getSqrtPriceAtTick, getTickAtSqrtPrice, isqrt, MAX_TICK, MIN_TICK, MAX_SQRT_PRICE_X64, MIN_SQRT_PRICE_X64, ceilToSpacing, } from '@floorlaunchpad/carpenter-sdk';
+/**
+ *  `open_tick(price_x64)`: `sqrt = isqrt(2^192 / price_x64)` (U256), then
+ * `tick_at_sqrt_price`. The pool is initialized at `sqrt_price_at_tick(open_tick)`.
+ */
+export function openTick(priceX64) {
+    if (priceX64 <= 0n)
+        throw new RangeError('price_x64 must be positive');
+    return getTickAtSqrtPrice(isqrt((1n << 192n) / priceX64));
+}
+/**
+ * `floor_math::stair::doubling_ticks(i)`:
+ * ticks for `i` doublings of the token price, `get_tick_at_sqrt_price(sqrt_price_from_ratio(1, 2^i)) + 1` =
+ * `ceil(i · ln 2 / ln 1.0001)`, computed per `i` (never `i · 6,932`). 0 for 0.
+ */
+export function doublingTicks(i) {
+    if (!Number.isInteger(i) || i < 0 || i > 64)
+        throw new RangeError(`doublingTicks: ${i}`);
+    if (i === 0)
+        return 0;
+    let sqrt = isqrt(1n << BigInt(96 + i)) << 16n;
+    if (sqrt < MIN_SQRT_PRICE_X64)
+        sqrt = MIN_SQRT_PRICE_X64;
+    if (sqrt >= MAX_SQRT_PRICE_X64)
+        sqrt = MAX_SQRT_PRICE_X64 - 1n;
+    return getTickAtSqrtPrice(sqrt) + 1;
+}
+/** `floor_math::stair::stair_edge`: the staircase's cheap edge `i` doublings above `openEdge`, on the grid. Step i is
+ *  `[stairEdge(i + 1), stairEdge(i)]`; the reserve from step `f` is `[stairEdge(steps), stairEdge(f)]`; the tail
+ *  `[ceilToSpacing(MIN_TICK), stairEdge(steps)]`. */
+export function stairEdge(openEdge, i, spacing) {
+    return openEdge - ceilToSpacing(doublingTicks(i), spacing);
+}
+/**
+ * `floor_math::stair::cushion_home_top`, step for step: the top a cushion takes when `min(spot, TWAP)` has no
+ * range above the bid band — the CHEAPEST full-depth range just above the band, `[dear − ceilToSpacing(width), dear]`
+ * (`dear = floorTick − ceilToSpacing(BID_BAND_TICKS)`), or the spot when the spot is cheaper still (in ticks the HIGHER).
+ */
+export function cushionHomeTop(spotTick, floorTick, spacing, width, bandTicks = 120) {
+    const dear = floorTick - ceilToSpacing(bandTicks, spacing);
+    return Math.max(spotTick, dear - ceilToSpacing(width, spacing) - 1);
+}
+/** `floor_math::stair::stair_fits`: a staircase of `steps` from `openEdge` leaves at least one spacing for the open tail
+ *  above it (`stairEdge(steps) − spacing ≥ ceilToSpacing(MIN_TICK)`). `resolve_config` refuses a launch that does not
+ *  (`StairDoesNotFit`, 6059) — a quote and a cap whose open tick sits too near the top of the range. */
+export function stairFits(openEdge, steps, spacing) {
+    return stairEdge(openEdge, steps, spacing) - spacing >= ceilToSpacing(MIN_TICK, spacing);
+}
+/** The admissible decimals of a launch's QUOTE mint, inclusive — the twin of `floor_math::constants::MIN/MAX_QUOTE_DECIMALS`;
+ * `floor_hook::list_quote` refuses a mint outside it and `tranche_price_x64` refuses to price one. The only thing the
+ * arithmetic bounds is the tranche price itself, `0 < p < 2^77`: past `d = 36` no (cap, quote price) a u64 can carry
+ * prices a launch (`p_min(d) = 100·10^d·2^64/(u64::MAX·SUPPLY) >= 2^77` from 37 up), so 36 is derived, not chosen.
+ * ⚠ The EFFECTIVE ceiling for a given launch is far lower and value-shaped: {@link tranchePriceX64} throws
+ * `tranche price out of range` once `mcap·100·10^d/(cents·SUPPLY) >= 2^13` — `d <= 14` at a $30k cap against a $1.00
+ * quote. */
+export const MIN_QUOTE_DECIMALS = 0;
+export const MAX_QUOTE_DECIMALS = 36;
+/**
+ * `tranche_price_x64(mcap_usd, quote_usd_cents, quote_decimals)`:
+ * `floor(mcap_usd·100·10^d·2^64 / (quote_usd_cents·SUPPLY))`, required `0 < price < 2^77`.
+ *
+ * ⛔ The quote price is in CENTS and the quote's decimals are explicit, so a $1.00 quote prices exactly. This is the ONE
+ * place a decimals count enters the mechanism: everything downstream (`openTick`, the sale walk, the fee split) is raw
+ * base units and Q64.64 and reads no decimals at all.
+ */
+export function tranchePriceX64(mcapUsd, quoteUsdCents, quoteDecimals) {
+    if (mcapUsd <= 0n || quoteUsdCents <= 0n)
+        throw new RangeError('mcap_usd and quote_usd_cents must be positive');
+    if (!Number.isInteger(quoteDecimals) || quoteDecimals < MIN_QUOTE_DECIMALS || quoteDecimals > MAX_QUOTE_DECIMALS) {
+        throw new RangeError(`quote decimals out of range: ${quoteDecimals} (must be ${MIN_QUOTE_DECIMALS}..${MAX_QUOTE_DECIMALS})`);
+    }
+    const unit = 10n ** BigInt(quoteDecimals);
+    const p = (mcapUsd * 100n * unit * (1n << 64n)) / (quoteUsdCents * 1000000000000000n);
+    if (p <= 0n || p >= 1n << 77n)
+        throw new RangeError(`tranche price out of range: ${p}`);
+    return p;
+}
+/**
+ * The twins of `floor_math::lineage`.
+ * `minBidFor(d)` = `ceil(10^d / 1,000)`, at least 1, saturating at u64::MAX: the default `min_bid` of a quote no
+ * governance roster names. `quoteAmountAtTick(amount, t)` = `amount · sqrt(t)^2 / 2^128` in two `>> 64` steps,
+ * rounded down, saturating at u64::MAX, 0 off the tick range: the smart tip cap's conversion (the parent's raw
+ * `max_bounty` → raw units of the parent's base, at the parent's 1,800 s TWAP tick).
+ */
+export const SMART_CAP_TWAP_WINDOW_SECS = 1_800;
+const U64_MAX = (1n << 64n) - 1n;
+export function minBidFor(decimals) {
+    if (!Number.isInteger(decimals) || decimals < 0)
+        throw new RangeError(`decimals: ${decimals}`);
+    if (decimals > 38)
+        return U64_MAX;
+    const unit = 10n ** BigInt(decimals);
+    const v = (unit + 999n) / 1000n;
+    const r = v < 1n ? 1n : v;
+    return r > U64_MAX ? U64_MAX : r;
+}
+export function quoteAmountAtSqrt(amount, sqrtPriceX64) {
+    if (amount === 0n || sqrtPriceX64 === 0n)
+        return 0n;
+    const a = (amount * sqrtPriceX64) >> 64n;
+    const v = (a * sqrtPriceX64) >> 64n;
+    return v > U64_MAX ? U64_MAX : v;
+}
+export function quoteAmountAtTick(amount, tick) {
+    if (!Number.isInteger(tick) || tick < MIN_TICK || tick > MAX_TICK)
+        return 0n;
+    return quoteAmountAtSqrt(amount, getSqrtPriceAtTick(tick));
+}
+//# sourceMappingURL=tickmath.js.map

package/dist/tickmath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tickmath.js","sourceRoot":"","sources":["../src/tickmath.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,GACd,MAAM,+BAA+B,CAAC;AAEvC;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,QAAgB;IACvC,IAAI,QAAQ,IAAI,EAAE;QAAE,MAAM,IAAI,UAAU,CAAC,4BAA4B,CAAC,CAAC;IACvE,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,CAAS;IACrC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE;QAAE,MAAM,IAAI,UAAU,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC;IACzF,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACtB,IAAI,IAAI,GAAG,KAAK,CAAC,EAAE,IAAI,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;IAC9C,IAAI,IAAI,GAAG,kBAAkB;QAAE,IAAI,GAAG,kBAAkB,CAAC;IACzD,IAAI,IAAI,IAAI,kBAAkB;QAAE,IAAI,GAAG,kBAAkB,GAAG,EAAE,CAAC;IAC/D,OAAO,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACtC,CAAC;AAED;;qDAEqD;AACrD,MAAM,UAAU,SAAS,CAAC,QAAgB,EAAE,CAAS,EAAE,OAAe;IACpE,OAAO,QAAQ,GAAG,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AAC7D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB,EAAE,SAAiB,EAAE,OAAe,EAAE,KAAa,EAAE,SAAS,GAAG,GAAG;IACjH,MAAM,IAAI,GAAG,SAAS,GAAG,aAAa,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC3D,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,GAAG,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;AACtE,CAAC;AAED;;wGAEwG;AACxG,MAAM,UAAU,SAAS,CAAC,QAAgB,EAAE,KAAa,EAAE,OAAe;IACxE,OAAO,SAAS,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,GAAG,OAAO,IAAI,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAC3F,CAAC;AAED;;;;;;YAMY;AACZ,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC;AACpC,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAErC;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,OAAe,EAAE,aAAqB,EAAE,aAAqB;IAC3F,IAAI,OAAO,IAAI,EAAE,IAAI,aAAa,IAAI,EAAE;QAAE,MAAM,IAAI,UAAU,CAAC,+CAA+C,CAAC,CAAC;IAChH,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,aAAa,CAAC,IAAI,aAAa,GAAG,kBAAkB,IAAI,aAAa,GAAG,kBAAkB,EAAE,CAAC;QACjH,MAAM,IAAI,UAAU,CAAC,gCAAgC,aAAa,aAAa,kBAAkB,KAAK,kBAAkB,GAAG,CAAC,CAAC;IAC/H,CAAC;IACD,MAAM,IAAI,GAAG,GAAG,IAAI,MAAM,CAAC,aAAa,CAAC,CAAC;IAC1C,MAAM,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,GAAG,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,aAAa,GAAG,iBAAsB,CAAC,CAAC;IAC3F,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG;QAAE,MAAM,IAAI,UAAU,CAAC,+BAA+B,CAAC,EAAE,CAAC,CAAC;IACxF,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,KAAK,CAAC;AAChD,MAAM,OAAO,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC;AACjC,MAAM,UAAU,SAAS,CAAC,QAAgB;IACxC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,aAAa,QAAQ,EAAE,CAAC,CAAC;IAC/F,IAAI,QAAQ,GAAG,EAAE;QAAE,OAAO,OAAO,CAAC;IAClC,MAAM,IAAI,GAAG,GAAG,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC;IACrC,MAAM,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,KAAK,CAAC;IAChC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1B,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AACnC,CAAC;AACD,MAAM,UAAU,iBAAiB,CAAC,MAAc,EAAE,YAAoB;IACpE,IAAI,MAAM,KAAK,EAAE,IAAI,YAAY,KAAK,EAAE;QAAE,OAAO,EAAE,CAAC;IACpD,MAAM,CAAC,GAAG,CAAC,MAAM,GAAG,YAAY,CAAC,IAAI,GAAG,CAAC;IACzC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,YAAY,CAAC,IAAI,GAAG,CAAC;IACpC,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AACnC,CAAC;AACD,MAAM,UAAU,iBAAiB,CAAC,MAAc,EAAE,IAAY;IAC5D,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,QAAQ,IAAI,IAAI,GAAG,QAAQ;QAAE,OAAO,EAAE,CAAC;IAC7E,OAAO,iBAAiB,CAAC,MAAM,EAAE,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC;AAC7D,CAAC"}

package/dist/twap.d.ts

@@ -0,0 +1,34 @@
+import { type TwapOracleView } from './layouts.ts';
+/** `floor_types::twap::TWAP_VERSION`: the oracle's version once written. */
+export declare const TWAP_VERSION = 1;
+/** Why a window read has no answer (`floor_types::twap::TwapError`). */
+export type TwapReadError = 'Uninitialized' | 'WindowTooLong';
+/** A window read: the tick, or why there is none. */
+export type TwapRead = {
+    readonly tick: number;
+} | {
+    readonly error: TwapReadError;
+};
+/** `a / b` rounded toward negative infinity (`b > 0`), `floor_types::twap::floor_div`. */
+export declare function twapFloorDiv(a: bigint, b: bigint): bigint;
+/** The oracle a zero tail decodes to: never written. */
+export declare function emptyTwapOracle(): TwapOracleView;
+/**
+ * THE WRITE (`TwapOracle::observe`): `tick` is the pool's tick BEFORE whatever is about to move it, at unix second `now`.
+ * Returns the oracle after the write (the input is never mutated); the same object when the write is a no-op (the same
+ * second, or a clock behind the last write).
+ */
+export declare function twapObserve(o: TwapOracleView, now: number, tick: number): TwapOracleView;
+/**
+ * THE WINDOW READ (`TwapOracle::twap_tick`, the `twap_tick` instruction's answer): the time-weighted mean RAW tick over
+ * the newest checkpoint at least `window` seconds old to now; window 0 is the live tick; the live tick exactly when nothing
+ * has written for the whole window.
+ */
+export declare function twapTickAt(o: TwapOracleView, now: number, liveTick: number, window: number): TwapRead;
+/**
+ * THE SETTLED TICK (`TwapOracle::settled_tick`, what the staircase's cushion reads): {@link twapTickAt} over `window`, and
+ * when the ring is younger than `window`, over its OLDEST checkpoint's age; when even that is 0, the tick at the start of
+ * this second (`current.lastTick`).
+ */
+export declare function settledTickAt(o: TwapOracleView, now: number, liveTick: number, window?: number): TwapRead;
+//# sourceMappingURL=twap.d.ts.map

package/dist/twap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"twap.d.ts","sourceRoot":"","sources":["../src/twap.ts"],"names":[],"mappings":"AASA,OAAO,EAA2E,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAE5H,4EAA4E;AAC5E,eAAO,MAAM,YAAY,IAAI,CAAC;AAE9B,wEAAwE;AACxE,MAAM,MAAM,aAAa,GAAG,eAAe,GAAG,eAAe,CAAC;AAC9D,qDAAqD;AACrD,MAAM,MAAM,QAAQ,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAA;CAAE,CAAC;AAOrF,0FAA0F;AAC1F,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAGzD;AAUD,wDAAwD;AACxD,wBAAgB,eAAe,IAAI,cAAc,CAYhD;AAWD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,CAkBxF;AAOD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,CAgBrG;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAE,MAAiC,GAAG,QAAQ,CASnI"}