@floorlaunchpad/sdk-solana 0.0.0-stage → 0.1.1

package/dist/pda.js

@@ -0,0 +1,85 @@
+/**
+ * FLOOR's PDAs (`floor_hook`, `floor_launch`), derived exactly as the programs derive them. `ProgramIds` here EXTENDS
+ * `@floorlaunchpad/carpenter-sdk`'s with FLOOR's program ids.
+ * ⛔ Integers in seeds are LITTLE-endian. ⛔ A pool PDA takes the mints already sorted; `sortMints` is the one place
+ *    that sorts.
+ */
+import {} from '@solana/kit';
+import { findHookAuthority as findHookAuthorityOf, findAta, findPda, addressToBytes, u64le, CARPENTER_AMM_PROGRAM_ID, } from '@floorlaunchpad/carpenter-sdk';
+import { FLOOR_HOLDERS_PROGRAM_ID, FLOOR_HOOK_PROGRAM_ID, FLOOR_LAUNCH_PROGRAM_ID, SEEDS } from "./constants.js";
+export const DEFAULT_PROGRAM_IDS = {
+    carpenterAmm: CARPENTER_AMM_PROGRAM_ID,
+    floorHook: FLOOR_HOOK_PROGRAM_ID,
+    floorLaunch: FLOOR_LAUNCH_PROGRAM_ID,
+    floorHolders: FLOOR_HOLDERS_PROGRAM_ID,
+};
+const k = addressToBytes;
+// ---- floor_hook ---------------------------------------------------------------------
+export const findHookConfig = (ids = DEFAULT_PROGRAM_IDS) => findPda(ids.floorHook, [SEEDS.hookConfig]);
+export const findFloorPool = (ammPool, ids = DEFAULT_PROGRAM_IDS) => findPda(ids.floorHook, [SEEDS.floorPool, k(ammPool)]);
+/**
+ * A trader's `TraderBucket` in one
+ * quote, `["trader_ref", trader, quote_mint]` under `floor_hook`. It is the SECOND account of every FLOOR swap's hook slice
+ * (`FLOOR_CALLBACK_ACCOUNTS` = 4: `[floor_pool w, trader_bucket w, hook event_authority r, floor_hook r]`), where `trader` is the swap's SIGNER and `quoteMint` the
+ * pool's `mint0`. Always pass the derived PDA, writable: the hook books
+ * nothing for an absent / uninitialised bucket and never fails the swap over it.
+ */
+export const findTraderBucket = (trader, quoteMint, ids = DEFAULT_PROGRAM_IDS) => findPda(ids.floorHook, [SEEDS.traderRef, k(trader), k(quoteMint)]);
+/** `["trader_ref_vault"]` under `floor_hook` — the WALLET of every quote's
+ *  trader-referral vault (off-curve); it signs only `claim_trader_referral`'s payouts. */
+export const findTraderRefVaultAuthority = (ids = DEFAULT_PROGRAM_IDS) => findPda(ids.floorHook, [SEEDS.traderRefVault]);
+/** One quote's trader-referral vault, `ATA(["trader_ref_vault"], quoteMint, tokenProgram)`. */
+export const findTraderRefVault = async (quoteMint, tokenProgram, ids = DEFAULT_PROGRAM_IDS) => findAta((await findTraderRefVaultAuthority(ids)).address, quoteMint, tokenProgram);
+/** `["stair", floor_pool]` under `floor_hook`. */
+export const findStairState = (floorPool, ids = DEFAULT_PROGRAM_IDS) => findPda(ids.floorHook, [SEEDS.stair, k(floorPool)]);
+/**
+ * `["stair_rent", amm_pool]` under floor_hook — a zero-data, SYSTEM-owned PDA
+ * holding the launch's prepaid SOL for its staircase's tick arrays. `fund_stair_rent` fills it once after graduation; a
+ * ratchet that passes it (writable, among the remaining accounts) with a zero `rent_owner` is adopted; and
+ * `reclaim_stair_array` returns a closed array's rent to it.
+ */
+export const findStairRent = (ammPool, ids = DEFAULT_PROGRAM_IDS) => findPda(ids.floorHook, [SEEDS.stairRent, k(ammPool)]);
+/** One per hook program. */
+export const findHookAuthority = (hookProgram = DEFAULT_PROGRAM_IDS.floorHook) => findHookAuthorityOf(hookProgram);
+/**
+ *  the program-owned platform treasury, `["platform_treasury"]` — the owner
+ * of every token account the platform cut lands in (`findAta(treasury, quote, quoteTokenProgram)`,
+ * off-curve), and the `PlatformTreasury` account holding its governance.
+ */
+export const findPlatformTreasury = (ids = DEFAULT_PROGRAM_IDS) => findPda(ids.floorHook, [SEEDS.platformTreasury]);
+/**
+ *  the program-owned TEAM treasury, `["team_treasury"]` — the owner
+ * of every token account the platform fee is swept into (`findAta(team, quote, quoteTokenProgram)`, off-curve),
+ * and a `PlatformTreasury`-layout account holding ITS governance. Never the platform treasury.
+ */
+export const findTeamTreasury = (ids = DEFAULT_PROGRAM_IDS) => findPda(ids.floorHook, [SEEDS.teamTreasury]);
+/**
+ * `["floor_platform_pool"]` — `$FLOOR`'s pool record
+ * (decode with `decodeFloorPlatformPool`; absent until the genesis launch designates it) and the owner of the
+ * wSOL transit account (`findAta(record, WSOL_MINT, SPL_TOKEN_PROGRAM_ID)`, off-curve).
+ */
+export const findFloorPlatformPool = (ids = DEFAULT_PROGRAM_IDS) => findPda(ids.floorHook, [SEEDS.floorPlatformPool]);
+// ---- floor_launch -------------------------------------------------------------------
+export const findLaunchConfig = (ids = DEFAULT_PROGRAM_IDS) => findPda(ids.floorLaunch, [SEEDS.launchConfig]);
+export const findRegistryEntry = (index, ids = DEFAULT_PROGRAM_IDS) => findPda(ids.floorLaunch, [SEEDS.registryEntry, u64le(index)]);
+export const findLaunch = (mint, ids = DEFAULT_PROGRAM_IDS) => findPda(ids.floorLaunch, [SEEDS.launch, k(mint)]);
+export const findSaleVault = (launch, ids = DEFAULT_PROGRAM_IDS) => findPda(ids.floorLaunch, [SEEDS.saleVault, k(launch)]);
+/**
+ * `["grad_rent", launch]`, the launch's graduation rent reserve. The CREATOR funds it at `create_launch`, graduation spends
+ * it, and `close_graduation_rent` reclaims what is left — so the last buy of a sale carries no step change of permanent
+ * rent. Zero data, program-owned, lamports only; ⚠ anyone may top it up with a plain SOL transfer.
+ */
+export const findGraduationRent = (launch, ids = DEFAULT_PROGRAM_IDS) => findPda(ids.floorLaunch, [SEEDS.gradRent, k(launch)]);
+/** `["quote", quote_mint]` under `floor_hook`, the FLOOR quote roster entry. */
+export const findQuotePolicy = (quoteMint, ids = DEFAULT_PROGRAM_IDS) => findPda(ids.floorHook, [SEEDS.quotePolicy, k(quoteMint)]);
+export const findBuyerPosition = (launch, buyer, ids = DEFAULT_PROGRAM_IDS) => findPda(ids.floorLaunch, [SEEDS.buyer, k(launch), k(buyer)]);
+/**  B1D: `["mint", creator, nonce u64 LE]`. */
+export const findLaunchMint = (creator, nonce, ids = DEFAULT_PROGRAM_IDS) => findPda(ids.floorLaunch, [SEEDS.mint, k(creator), u64le(nonce)]);
+export const findMintAuthority = (ids = DEFAULT_PROGRAM_IDS) => findPda(ids.floorLaunch, [SEEDS.mintAuthority]);
+export const findLockAuthority = (ids = DEFAULT_PROGRAM_IDS) => findPda(ids.floorLaunch, [SEEDS.lockAuthority]);
+export const findLaunchAuthority = (ids = DEFAULT_PROGRAM_IDS) => findPda(ids.floorLaunch, [SEEDS.launchAuthority]);
+/** `["trader_link", trader]` under `floor_launch` — the trader's three tiers. */
+export const findTraderLink = (trader, ids = DEFAULT_PROGRAM_IDS) => findPda(ids.floorLaunch, [SEEDS.traderLink, k(trader)]);
+/** Trader referrals: `["trader_ref_sale", launch]` — the launch's SALE referral token account. */
+export const findTraderRefSale = (launch, ids = DEFAULT_PROGRAM_IDS) => findPda(ids.floorLaunch, [SEEDS.traderRefSale, k(launch)]);
+//# sourceMappingURL=pda.js.map

package/dist/pda.js.map

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

package/dist/predict.d.ts

@@ -0,0 +1,169 @@
+/**
+ * `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 { type AccountMeta, type Address } from '@solana/kit';
+import { type RentExemptMinimum } from '@floorlaunchpad/carpenter-sdk';
+import type { FloorPool, Launch } from './layouts.ts';
+import { type ProgramIds } from './pda.ts';
+/**
+ * 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 declare const GRADUATION_ACCOUNT_LENS: {
+    readonly pool: number;
+    readonly vaultSplToken: 165;
+    /** A Token-2022 account for a Pausable mint: 165 + account_type + a zero-length `PausableAccount` TLV. */
+    readonly vaultToken2022Pausable: 170;
+    /** The base vault of a HOOKED launch mint — 170 + the 5-byte `TransferHookAccount` TLV (`floor_launch` `base_vault_len`). */
+    readonly vaultToken2022PausableHooked: 175;
+    readonly poolIndexEntry: number;
+    readonly mintPoolCount: number;
+    readonly position: number;
+    /** The `StairState` account, `8 + floor_types::layout::StairState::SIZE` (584). */
+    readonly stairState: number;
+    /** 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). */
+    readonly stairStateWithOwners: number;
+    /** A tick array as created: the 3,888-byte body, then its 32-byte rent owner (3,920). */
+    readonly tickArray: number;
+};
+/**
+ * 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 declare const GRADUATION_BID_WINDOW_TICKS = 1200;
+/**
+ * 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 declare function graduationFloorBound(args: {
+    priceX64: bigint;
+    minBid: bigint;
+    spacing?: number;
+    saleTokens?: bigint;
+}): number;
+/**
+ * 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 declare function ladderRange(openTick: number, s?: number): [lower: number, upper: number];
+/**
+ * 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 declare const GRADUATION_ACCOUNT_NAMES: readonly ["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", "quote_mint0", "quote_mint1", "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 declare function polRange(openTick: number, s?: number): [lower: number, upper: number];
+export interface GraduationPrediction {
+    /** 33 fixed accounts then the tick arrays (writable). */
+    readonly accounts: AccountMeta[];
+    /** `GRADUATION_ACCOUNT_NAMES` then `tick_array[<start>]` per array. */
+    readonly names: string[];
+    readonly pool: Address;
+    readonly openTick: number;
+    readonly tickArrayStarts: number[];
+    /** Σ rent of every account the final buy creates (those not in `existing`). */
+    readonly rentLamports: bigint;
+    /** `ceil(rentLamports × 1.1)`. */
+    readonly maxGraduationLamports: bigint;
+}
+/**
+ *  `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 declare function graduationAccounts(args: {
+    launch: Pick<Launch, 'mint' | 'priceX64' | 'openTick' | 'ammPool' | 'floorPool' | 'wsolVault'> & Partial<Pick<Launch, 'saleTokens' | 'teamStepTokens'>>;
+    /**
+     * The launch's quote when it is not wSOL — `launchQuoteMint(launch)` names the mint, the caller supplies its token
+     * program. Slots 7, 10, 11, 12 and 14 of the list are the QUOTE's; omitted, they are wSOL's. ⛔ A wrong quote fails here, not on chain: the derived pool would not be `Launch.amm_pool`.
+     */
+    quote?: {
+        mint: Address;
+        tokenProgram: Address;
+    };
+    /** The `Launch` PDA, for `["grad_rent", launch]` (index 28). `findLaunch(mint)` when omitted. */
+    launchAddress?: Address;
+    rent: RentExemptMinimum;
+    existing?: ReadonlySet<Address>;
+    /**
+     * The bid's DEAR edge as a solve placed it. Pins the bid to the arrays of `[lower, lower + W]`
+     * (the band, `W = ceil_to_spacing(BID_BAND_TICKS, s)`) and drops the window; a hint below the
+     * lowest the bid can land (`ceil_to_spacing(open + 1)`) is raised to it.
+     */
+    bidLowerHint?: number;
+    /**
+     * The launch's decoded `FloorPool` (it exists from `create_launch`; `getFloorPool(src,
+     * Launch.amm_pool)`), for its `min_bid` — the reserve graduation's ratchet holds back before it
+     * solves the floor. With it the window reaches {@link graduationFloorBound}. ⛔ The POOL's value,
+     * never `QuotePolicy.min_bid`: governance may retune the policy after the launch registered, and
+     * the pool keeps what it was registered with.
+     * ⛔ REQUIRED on a token-quoted launch (no `bidLowerHint`): without it this throws BY NAME rather
+     * than predict a fixed window that can be short. Optional on wSOL, where omitting it keeps the fixed window.
+     */
+    floorPool?: Pick<FloorPool, 'minBid'> & Partial<Pick<FloorPool, 'stairSteps'>>;
+    /**
+     * The pool's `FloorPool.stairSteps` (read
+     * from `floorPool` when omitted). A staircase pool's graduating buy places step 0, the reserve and the open tail INSIDE it
+     * the arrays of the staircase's inner edges (`stairEdge(1)`,
+     * `stairEdge(steps)`) ride in the list, with the StairState's and the three positions' rent priced. ⛔ REQUIRED since
+     * (every pool is a staircase — a Custom launch's derived from its cap): 0 / absent throws by name.
+     */
+    stairSteps?: number;
+    /**
+     * The launch mint carries FLOOR's transfer-hook slot — its AMM
+     * base vault is then 175 B, not 170 (`floor_launch` `base_vault_len`). Omitted = unhooked.
+     */
+    hooked?: boolean;
+    ids?: ProgramIds;
+}): Promise<GraduationPrediction>;
+/** The predicted graduation rent × 1.1, rounded up. */
+export declare function maxGraduationLamports(rentLamports: bigint): bigint;
+/** The platform fee on a sale amount (a buy's cost, a sell-back's payout): `floor(amount · teamBps / 10 000)`. */
+export declare const saleTeamFee: (amount: bigint, teamBps: number) => bigint;
+/** What a GROSS `lamportsIn` buys with: `floor(gross · 10 000 / (10 000 + teamBps))` — the program's own net. */
+export declare const saleNetOf: (gross: bigint, teamBps: number) => bigint;
+/** The client's one ceiling: the gross whose net is exactly `net` — `ceil(net · (10 000 + teamBps) / 10 000)`. */
+export declare const saleGrossFor: (net: bigint, teamBps: number) => bigint;
+//# sourceMappingURL=predict.d.ts.map

package/dist/predict.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"predict.d.ts","sourceRoot":"","sources":["../src/predict.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAe,KAAK,WAAW,EAAE,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAa1E,OAAO,EAyBL,KAAK,iBAAiB,EAMvB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAI,MAAM,cAAc,CAAC;AACxD,OAAO,EASL,KAAK,UAAU,EAChB,MAAM,UAAU,CAAC;AAMlB;;;;GAIG;AACH,eAAO,MAAM,uBAAuB;;;IAGlC,0GAA0G;;IAE1G,6HAA6H;;;;;IAK7H,mFAAmF;;IAEnF;8GAC0G;;IAE1G,yFAAyF;;CAEjF,CAAC;AAEX;;;;;;;;GAQG;AACH,eAAO,MAAM,2BAA2B,OAAQ,CAAC;AAmBjD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAsB9H;AAGD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,GAAE,MAA2B,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAE5G;AAED;;;GAGG;AACH,eAAO,MAAM,wBAAwB,kjBAqC3B,CAAC;AAEX;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,GAAE,MAA2B,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAKzG;AAED,MAAM,WAAW,oBAAoB;IACnC,yDAAyD;IACzD,QAAQ,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAC;IACjC,uEAAuE;IACvE,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,eAAe,EAAE,MAAM,EAAE,CAAC;IACnC,+EAA+E;IAC/E,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,kCAAkC;IAClC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;CACxC;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,GAAG,WAAW,GAAG,WAAW,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,YAAY,GAAG,gBAAgB,CAAC,CAAC,CAAC;IACxJ;;;OAGG;IACH,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,YAAY,EAAE,OAAO,CAAA;KAAE,CAAC;IACjD,iGAAiG;IACjG,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,IAAI,EAAE,iBAAiB,CAAC;IACxB,QAAQ,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAChC;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC;IAC/E;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,UAAU,CAAC;CAClB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA+EhC;AAkJD,uDAAuD;AACvD,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAElE;AAKD,kHAAkH;AAClH,eAAO,MAAM,WAAW,GAAI,QAAQ,MAAM,EAAE,SAAS,MAAM,KAAG,MAA8C,CAAC;AAC7G,iHAAiH;AACjH,eAAO,MAAM,SAAS,GAAI,OAAO,MAAM,EAAE,SAAS,MAAM,KAAG,MAAyD,CAAC;AACrH,kHAAkH;AAClH,eAAO,MAAM,YAAY,GAAI,KAAK,MAAM,EAAE,SAAS,MAAM,KAAG,MAAgE,CAAC"}