@eco-incorp/sauce 0.99.0

package/sdk/dist/svm/venues/stabble-clmm/index.js

@@ -0,0 +1,324 @@
+/**
+ * Stabble CLMM venue — pool decoding, scope gates and the prepare-declared
+ * tick-boundary WINDOW for the SvmRoute ladder fragment (./ladder.ts).
+ *
+ * It is, byte-for-byte, the same PoolState/AmmConfig/
+ * TickArrayState account layout as the sibling
+ * raydium-clmm venue (Stabble's CLMM program is a verbatim fork of Raydium's
+ * `raydium-clmm` at the account level — GROUND-TRUTHED, not assumed, against
+ * real mainnet state 2026-07-31, program `6dMXqGZ3ga2dikrYS9ovDXgHGh5RUsb2RTUj6hrQXhk6`,
+ * Jupiter's own label "Stabble CLMM" per `benchmark/adapters/fixtures/jupiter-program-id-to-label.json`):
+ *   - `getProgramAccounts` filtered to `dataSize: 1544` returns exactly 17 live
+ *     pool accounts (matching the venue brief's "17 live pools measured at
+ *     dataSize 1544");
+ *   - pool account `EK72FNtzoGJvXtq8r3bn7jB8ascHw1euFmnoemZ61D9g` (STB/USDC,
+ *     tickSpacing 1, live liquidity 854392897124, tick -135413): 1544 bytes,
+ *     discriminator f7 ed e3 f5 d7 c3 de 46 (IDENTICAL to raydium-clmm's —
+ *     shared with raydium-cp-swap too, size+owner discriminate), field
+ *     offsets IDENTICAL to raydium-clmm's (token_mint_0@73, token_mint_1@105,
+ *     token_vault_0@137, token_vault_1@169, observation_key@201,
+ *     tick_spacing@235, liquidity@237, sqrt_price@253, tick_current@269,
+ *     status@389, fee_on@390 — all zero/matching the classic gate,
+ *     dynamic_fee_info@1096..1176 all-zero);
+ *   - its AmmConfig (`4th9ZwRvFX9yJQp1yFXVkCYQxbCAxPLKKh2RyTLbuVXP`, 117
+ *     bytes, disc da f4 21 68 cb cb 2b 6f, trade_fee_rate@47 = 2500 i.e. 25
+ *     bps) and TickArrayState accounts (10240 bytes, disc
+ *     c0 9b 55 cd 31 f9 81 2a) decode with the SAME offsets;
+ *   - `tick_array` PDA seeds (['tick_array', pool, be(startTick)], this
+ *     program's id) reproduce the exact live tick array address
+ *     `7zRBaaTg8x1GBpAQJYiEBqGEXn6HH5j2VRxZsU5V6i2d` (owner-confirmed against
+ *     this program id, discriminator-confirmed as TickArrayState) — the SAME
+ *     `pool_tick_array_bitmap_extension` seed derives
+ *     `DQPu2HQXL889S3AifYcPZzEHVZPRRTLWFDAcAxaLS7G9`, which also exists
+ *     on-chain owned by this program;
+ *   - the Anchor discriminator for `swap_v2` (sha256('global:swap_v2')[0..8]
+ *     = 43 04 ed 0b 1a c9 1e 62) is a PURE function of the instruction name,
+ *     so it is necessarily identical for any Anchor program naming its swap
+ *     instruction the same — this module's ladder (./ladder.ts) drives a
+ *     REAL `swap_v2` CPI into the mainnet-dumped `stabble-clmm.so` binary
+ *     against this exact pool's real account state
+ *     (the consuming app realcpi e2e test's 'stabble-clmm' cell) and
+ *     the resulting realized output matches this ladder's predicted quote
+ *     exactly at three sizes — proving the account order/writability and
+ *     instruction layout, not just the struct offsets.
+ *
+ * Given the confirmed byte-identical layout, this module reuses raydium-clmm's
+ * PURE math and PDA-independent helpers straight from the `@eco-incorp/sauce/svm`
+ * barrel (raydiumSqrtPriceAtTick, the tick-math constants,
+ * RAYDIUM_CLMM_MAX_BOUNDARIES, the account discriminators, and the
+ * PROGRAM-INDEPENDENT arrayStartIndex / windowStartTicks) — nothing here
+ * reinvents that arithmetic. Only the parts that are genuinely PROGRAM-BOUND
+ * (the PDA derivations and the CPI target) are reimplemented, against this
+ * venue's own program id.
+ *
+ * Gates mirror raydium-clmm's exactly (see that adapter's header for the full
+ * rationale): account size/discriminator, `fee_on != 0`, a nonzero
+ * `dynamic_fee_info`, active limit orders on any scanned window tick, the
+ * swap-disabled status bit, non-classic-SPL mints, and a direction with no
+ * shipped boundaries/edge (gated by the orchestrator via windowFor).
+ *
+ * NOTE — RELOCATED LADDER. This venue's merge-decomposition ladder used to sit
+ * next to this file as `./ladder.ts`; it now lives in the consuming recipes
+ * package, which defines every `*Ladder`, window selector and rung-feeding
+ * decomposition helper itself. The SDK keeps only the generic venue
+ * integration below (pool-account decode, program ids, pool-config types, and
+ * the AMM/tick math the decode needs). Every `ladder.ts` reference in the text
+ * above therefore points at that relocated module, not at a file in this
+ * directory.
+ */
+import { address, getAddressCodec } from "@solana/kit";
+import { AMM_CONFIG_DISCRIMINATOR as RAYDIUM_CLMM_AMM_CONFIG_DISCRIMINATOR, POOL_DISCRIMINATOR as RAYDIUM_CLMM_POOL_DISCRIMINATOR, TICK_ARRAY_DISCRIMINATOR as RAYDIUM_CLMM_TICK_ARRAY_DISCRIMINATOR, windowStartTicks as raydiumClmmWindowStartTicks, } from "../raydium-clmm/index.js";
+import { MAX_TICK as RAYDIUM_MAX_TICK, MIN_TICK as RAYDIUM_MIN_TICK, } from "../raydium-clmm/tick-math.js";
+import { raydiumSqrtPriceAtTick } from "../raydium-clmm/tick-math.js";
+import { readUintLE } from "../math.js";
+import { memoizedGetProgramDerivedAddress } from "../pda-memo.js";
+import { TOKEN_2022_PROGRAM_ID, classifyMintProgram } from "../../token-program.js";
+import { parseMintExtensions } from "../../token-extensions.js";
+const SLUG = "stabble-clmm";
+/** Stabble's CLMM program (a Raydium-CLMM-shaped Anchor fork). */
+export const STABBLE_CLMM_PROGRAM_ID = address("6dMXqGZ3ga2dikrYS9ovDXgHGh5RUsb2RTUj6hrQXhk6");
+const TOKEN_PROGRAM = address("TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA");
+const TOKEN_2022_PROGRAM = address("TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb");
+const MEMO_PROGRAM = address("MemoSq4gqABAXKb96qnH8TysNcWxMyWCqXgDLGmfcHr");
+export const POOL_ACCOUNT_SIZE = 1544;
+export const AMM_CONFIG_ACCOUNT_SIZE = 117;
+export const TICK_ARRAY_ACCOUNT_SIZE = 10240;
+export const TICK_ARRAY_SIZE = 60;
+// PoolState offsets (ABSOLUTE = struct offset + 8 anchor disc), IDENTICAL to raydium-clmm.
+export const OFF_AMM_CONFIG = 9;
+export const OFF_TOKEN_MINT_0 = 73;
+export const OFF_TOKEN_MINT_1 = 105;
+export const OFF_TOKEN_VAULT_0 = 137;
+export const OFF_TOKEN_VAULT_1 = 169;
+export const OFF_OBSERVATION_KEY = 201;
+export const OFF_TICK_SPACING = 235;
+export const OFF_LIQUIDITY = 237;
+export const OFF_SQRT_PRICE = 253;
+export const OFF_TICK_CURRENT = 269;
+export const OFF_STATUS = 389;
+export const OFF_FEE_ON = 390;
+export const OFF_OPEN_TIME = 1080;
+export const OFF_DYNAMIC_FEE_INFO = 1096;
+export const DYNAMIC_FEE_INFO_LEN = 80;
+/** AmmConfig: trade_fee_rate u32 @47 (hundredths of a bip, denominator 1e6). */
+export const OFF_CFG_TRADE_FEE_RATE = 47;
+// TickArrayState offsets: pool_id @8, start_tick_index i32 @40, ticks[60] @44.
+export const OFF_TA_POOL = 8;
+export const OFF_TA_START = 40;
+export const OFF_TA_TICKS = 44;
+export const TICK_LEN = 168;
+export const OFF_TICK_LIQ_NET = 4;
+export const OFF_TICK_LIQ_GROSS = 20;
+export const OFF_TICK_ORDERS_AMOUNT = 124;
+export const OFF_TICK_PART_FILLED_ORDERS = 132;
+/** Swap-disabled status bit (PoolStatusBitIndex::Swap = 4). */
+const STATUS_SWAP_BIT = 4;
+/**
+ * Shipped initialized-tick boundaries per direction (same walk-step budget as
+ * raydium-clmm — an independent constant, not imported, so a future SDK
+ * change to raydium-clmm's own bound can never silently reshape this venue's
+ * fragment; kept numerically equal by design).
+ */
+export const STABBLE_CLMM_MAX_BOUNDARIES = 4;
+const readI32 = (data, offset) => {
+    const u = Number(readUintLE(data, offset, 4));
+    return u >= 0x8000_0000 ? u - 0x1_0000_0000 : u;
+};
+function hasDiscriminator(data, discriminator) {
+    return discriminator.every((byte, i) => data[i] === byte);
+}
+function getAddressEncoded(value) {
+    return new Uint8Array(getAddressCodec().encode(value));
+}
+async function deriveTickArrayPda(pool, startTick) {
+    const be = new Uint8Array(4);
+    new DataView(be.buffer).setInt32(0, startTick, false); // start_tick_index.to_be_bytes()
+    return memoizedGetProgramDerivedAddress(STABBLE_CLMM_PROGRAM_ID, [
+        new TextEncoder().encode("tick_array"),
+        getAddressEncoded(pool),
+        be,
+    ]);
+}
+/** Whether a tick cell is initialized (liquidity_gross != 0). */
+function tickInitialized(array, offset) {
+    return readUintLE(array, OFF_TA_TICKS + offset * TICK_LEN + OFF_TICK_LIQ_GROSS, 16) !== 0n;
+}
+/** Whether a tick cell carries ACTIVE limit orders (see raydium-clmm's header — same semantics). */
+function tickHasLimitOrders(array, offset) {
+    const base = OFF_TA_TICKS + offset * TICK_LEN;
+    return (readUintLE(array, base + OFF_TICK_ORDERS_AMOUNT, 8) !== 0n ||
+        readUintLE(array, base + OFF_TICK_PART_FILLED_ORDERS, 8) !== 0n);
+}
+/**
+ * Scan the readable window for initialized-tick boundaries in walk order —
+ * next_initialized_tick semantics, identical to raydium-clmm's resolveWindow.
+ */
+async function resolveWindow(load, pool, tickCurrentIndex, tickSpacing, zeroForOne) {
+    const startTicks = raydiumClmmWindowStartTicks(tickCurrentIndex, tickSpacing, zeroForOne);
+    const tickArrays = (await Promise.all(startTicks.map((start) => deriveTickArrayPda(pool, start))));
+    // allSettled (not all) keeps the break-on-first-invalid contract exact: a
+    // rejection is re-thrown only if the readable prefix actually reaches it.
+    const loaded = await Promise.allSettled(tickArrays.map((a) => load(a)));
+    const arrays = [];
+    let readable = 0;
+    for (let i = 0; i < 3; i++) {
+        const settled = loaded[i];
+        if (settled.status === "rejected")
+            throw settled.reason;
+        const data = settled.value;
+        const valid = data !== null &&
+            data.length >= TICK_ARRAY_ACCOUNT_SIZE &&
+            hasDiscriminator(data, RAYDIUM_CLMM_TICK_ARRAY_DISCRIMINATOR) &&
+            readI32(data, OFF_TA_START) === startTicks[i];
+        if (!valid)
+            break;
+        arrays.push(data);
+        readable += 1;
+    }
+    const boundaries = [];
+    let maxStopped = false;
+    for (let a = 0; a < readable && !maxStopped; a++) {
+        const data = arrays[a];
+        const start = startTicks[a];
+        let offset;
+        if (a === 0) {
+            const raw = Math.floor((tickCurrentIndex - start) / tickSpacing);
+            offset = zeroForOne ? raw : raw + 1;
+        }
+        else {
+            offset = zeroForOne ? TICK_ARRAY_SIZE - 1 : 0;
+        }
+        if (!zeroForOne && offset < 0)
+            offset = 0;
+        while (offset >= 0 && offset < TICK_ARRAY_SIZE) {
+            if (tickHasLimitOrders(data, offset)) {
+                throw new Error(`${SLUG}: pool ${pool} has active limit orders at tick ${start + offset * tickSpacing} ` +
+                    "— the ladder does not model limit-order matching");
+            }
+            if (tickInitialized(data, offset)) {
+                const tick = start + offset * tickSpacing;
+                boundaries.push({ arrayIndex: a, offset, tick, sqrtPrice: raydiumSqrtPriceAtTick(tick) });
+                if (boundaries.length === STABBLE_CLMM_MAX_BOUNDARIES) {
+                    maxStopped = true;
+                    break;
+                }
+            }
+            offset += zeroForOne ? -1 : 1;
+        }
+    }
+    let edge = null;
+    if (readable > 0 && !maxStopped) {
+        const lastStart = startTicks[readable - 1];
+        let tick;
+        if (zeroForOne) {
+            tick = Math.max(lastStart, RAYDIUM_MIN_TICK);
+        }
+        else {
+            tick = lastStart + TICK_ARRAY_SIZE * tickSpacing - 1;
+            if (lastStart + TICK_ARRAY_SIZE * tickSpacing > RAYDIUM_MAX_TICK)
+                tick = RAYDIUM_MAX_TICK;
+        }
+        edge = { tick, sqrtPrice: raydiumSqrtPriceAtTick(tick) };
+    }
+    return { tickArrays, startTicks, boundaries, edge, readable };
+}
+/**
+ * Fetch + gate one Stabble CLMM pool (see the header for the gate list) and
+ * freeze both directions' boundary windows. Read-only against the loader.
+ */
+export async function fetchStabbleClmmConfig(load, pool) {
+    const data = await load(pool);
+    if (data === null)
+        throw new Error(`${SLUG}: pool account ${pool} not found`);
+    if (data.length !== POOL_ACCOUNT_SIZE) {
+        throw new Error(`${SLUG}: pool ${pool} has ${data.length} bytes, expected ${POOL_ACCOUNT_SIZE}`);
+    }
+    if (!hasDiscriminator(data, RAYDIUM_CLMM_POOL_DISCRIMINATOR)) {
+        throw new Error(`${SLUG}: pool ${pool} has a foreign discriminator (not a PoolState account)`);
+    }
+    const status = data[OFF_STATUS];
+    if ((status & (1 << STATUS_SWAP_BIT)) !== 0) {
+        throw new Error(`${SLUG}: pool ${pool} has swaps disabled (status bit ${STATUS_SWAP_BIT})`);
+    }
+    const feeOn = data[OFF_FEE_ON];
+    if (feeOn !== 0) {
+        throw new Error(`${SLUG}: pool ${pool} uses fee_on ${feeOn} (Token0Only/Token1Only) — the ladder walks the fee-on-input path only`);
+    }
+    for (let i = 0; i < DYNAMIC_FEE_INFO_LEN; i++) {
+        if (data[OFF_DYNAMIC_FEE_INFO + i] !== 0) {
+            throw new Error(`${SLUG}: pool ${pool} has a dynamic fee configured — its swap walks tick-spacing-bounded steps with a per-step ` +
+                "volatility fee the in-VM quote does not model");
+        }
+    }
+    const codec = getAddressCodec();
+    const ammConfig = codec.decode(data.subarray(OFF_AMM_CONFIG, OFF_AMM_CONFIG + 32));
+    const tokenMint0 = codec.decode(data.subarray(OFF_TOKEN_MINT_0, OFF_TOKEN_MINT_0 + 32));
+    const tokenMint1 = codec.decode(data.subarray(OFF_TOKEN_MINT_1, OFF_TOKEN_MINT_1 + 32));
+    // The on-chain swap ix here is legacy-SPL only; detect a Token-2022 mint (or
+    // one carrying an un-routable extension) via the shared data-shape resolver
+    // and SELF-DROP the pool. The thrown error is the graceful-drop signal — the
+    // SvmRoute orchestrator catches a fetchPoolConfig throw and drops the venue.
+    // The LEGACY path stays byte-identical: a classic 82-byte mint classifies as
+    // Tokenkeg, parses no extensions, and the config is built unchanged. An
+    // unreadable mint falls back to the legacy assumption (keeps fixtures green).
+    const _mints = [tokenMint0, tokenMint1];
+    const _mintDatas = await Promise.all(_mints.map((mint) => load(mint)));
+    for (let _i = 0; _i < _mints.length; _i++) {
+        const mint = _mints[_i];
+        const mintData = _mintDatas[_i];
+        if (mintData === null)
+            continue;
+        if (classifyMintProgram(mint, mintData) === TOKEN_2022_PROGRAM_ID) {
+            throw new Error(`${SLUG}: dropping pool ${pool} — mint ${mint} is Token-2022 (this venue's swap is legacy-SPL only)`);
+        }
+        const { blocking } = parseMintExtensions(mintData);
+        if (blocking.length > 0) {
+            throw new Error(`${SLUG}: dropping pool ${pool} — mint ${mint} is un-routable: ${blocking.join("; ")}`);
+        }
+    }
+    const cfgData = await load(ammConfig);
+    if (cfgData === null)
+        throw new Error(`${SLUG}: AmmConfig ${ammConfig} of pool ${pool} not found`);
+    if (cfgData.length !== AMM_CONFIG_ACCOUNT_SIZE ||
+        !hasDiscriminator(cfgData, RAYDIUM_CLMM_AMM_CONFIG_DISCRIMINATOR)) {
+        throw new Error(`${SLUG}: AmmConfig ${ammConfig} of pool ${pool} has an unexpected size/discriminator`);
+    }
+    const tickSpacing = Number(readUintLE(data, OFF_TICK_SPACING, 2));
+    const tickCurrentIndex = readI32(data, OFF_TICK_CURRENT);
+    const [zeroForOne, oneForZero, bitmapExtension] = await Promise.all([
+        resolveWindow(load, pool, tickCurrentIndex, tickSpacing, true),
+        resolveWindow(load, pool, tickCurrentIndex, tickSpacing, false),
+        memoizedGetProgramDerivedAddress(STABBLE_CLMM_PROGRAM_ID, [
+            new TextEncoder().encode("pool_tick_array_bitmap_extension"),
+            getAddressEncoded(pool),
+        ]),
+    ]);
+    return {
+        venue: SLUG,
+        pool,
+        direction: "0to1",
+        ammConfig,
+        tokenMint0,
+        tokenMint1,
+        tokenVault0: codec.decode(data.subarray(OFF_TOKEN_VAULT_0, OFF_TOKEN_VAULT_0 + 32)),
+        tokenVault1: codec.decode(data.subarray(OFF_TOKEN_VAULT_1, OFF_TOKEN_VAULT_1 + 32)),
+        observation: codec.decode(data.subarray(OFF_OBSERVATION_KEY, OFF_OBSERVATION_KEY + 32)),
+        bitmapExtension,
+        tickSpacing,
+        tradeFeeRate: Number(readUintLE(cfgData, OFF_CFG_TRADE_FEE_RATE, 4)),
+        liquidity: readUintLE(data, OFF_LIQUIDITY, 16),
+        sqrtPrice: readUintLE(data, OFF_SQRT_PRICE, 16),
+        tickCurrentIndex,
+        windows: { "0to1": zeroForOne, "1to0": oneForZero },
+    };
+}
+/** Family facade for the recipe orchestrator (ladder-only — no v1 adapter). */
+export const stabbleClmm = {
+    slug: SLUG,
+    programId: STABBLE_CLMM_PROGRAM_ID,
+    tokenProgram: TOKEN_PROGRAM,
+    token2022Program: TOKEN_2022_PROGRAM,
+    memoProgram: MEMO_PROGRAM,
+    fetchPoolConfig: fetchStabbleClmmConfig,
+};
+//# sourceMappingURL=index.js.map

package/sdk/dist/svm/venues/stabble-clmm/index.js.map

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

package/sdk/dist/svm/venues/stabble-common.d.ts

@@ -0,0 +1,206 @@
+import type { Address } from "@solana/kit";
+export declare const STABLE_SWAP_PROGRAM_ID: Address<"swapNyd8XiQwJ6ianp9snpu4brUqFxadzvHebnAXjJZ">;
+export declare const WEIGHTED_SWAP_PROGRAM_ID: Address<"swapFpHZwjELNnjvThjajtiVmkz3yPQEHjLtka2fwHW">;
+export declare const STABBLE_VAULT_PROGRAM_ID: Address<"vo1tWgqZMjG61Z2T9qUaMYKqZ75CYzMuaZ2LZP1n7HV">;
+export declare const STABBLE_TOKEN_PROGRAM_ID: Address<"TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA">;
+export declare const STABBLE_TOKEN_2022_PROGRAM_ID: Address<"TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb">;
+export declare const STABBLE_ATA_PROGRAM_ID: Address<"ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL">;
+/** sha256("account:Pool")[..8] — shared by BOTH variants (Anchor discriminators are name-, not program-, keyed; verified against live pool accounts of both programs). */
+export declare const STABBLE_POOL_DISCRIMINATOR: Uint8Array<ArrayBuffer>;
+/** sha256("account:Vault")[..8]. */
+export declare const STABBLE_VAULT_DISCRIMINATOR: Uint8Array<ArrayBuffer>;
+/** sha256("global:swap")[..8] — the v1 `swap(amount_in: Option<u64>, minimum_amount_out: u64)` entry point. */
+export declare const STABBLE_SWAP_DISCRIMINATOR: Uint8Array<ArrayBuffer>;
+export declare const STABBLE_ONE = 1000000000n;
+declare const U64_MAX: bigint;
+/** floor(a*n/d) — the engine's DIV rule (a zero divisor yields 0, never throws), matched here for parity with the on-chain fragment. */
+export declare function mulDivDown(a: bigint, n: bigint, d: bigint): bigint;
+/** ceil(a*n/d), 0 on a zero divisor (engine DIV-rule parity). */
+export declare function mulDivUp(a: bigint, n: bigint, d: bigint): bigint;
+/** ceil(a/d), 0 on a zero divisor (engine DIV-rule parity). */
+export declare function divUpRaw(a: bigint, d: bigint): bigint;
+export declare function mulDown(a: bigint, b: bigint): bigint;
+export declare function mulUp(a: bigint, b: bigint): bigint;
+export declare function divDown(a: bigint, b: bigint): bigint;
+export declare function divUp(a: bigint, b: bigint): bigint;
+export declare function complement(a: bigint): bigint;
+export interface StabbleTokenScale {
+    scalingUp: boolean;
+    scalingFactor: bigint;
+}
+export declare function calcWrappedAmount(amount: bigint, token: StabbleTokenScale): bigint;
+export declare function calcUnwrappedAmount(amount: bigint, token: StabbleTokenScale): bigint;
+export declare function calcRoundedAmount(amount: bigint, token: StabbleTokenScale): bigint;
+export interface StabblePoolTokenBase {
+    mint: Address;
+    decimals: number;
+    scalingUp: boolean;
+    scalingFactor: bigint;
+    balance: bigint;
+}
+export interface StabbleVaultInfo {
+    admin: Address;
+    withdrawAuthority: Address;
+    withdrawAuthorityBump: number;
+    authorityBump: number;
+    isActive: boolean;
+    beneficiary: Address;
+    beneficiaryFee: bigint;
+}
+export declare function decodeStabbleVault(pool: Address, data: Uint8Array | null): StabbleVaultInfo;
+export declare function decodeStabblePoolCommon(pool: Address, data: Uint8Array | null, programLabel: string, tokensOffset: number, tokenSize: number, weighted: boolean, minLength: number): {
+    vault: Address<string>;
+    mint: Address<string>;
+    authorityBump: number;
+    isActive: boolean;
+    tokens: (StabblePoolTokenBase & {
+        weight?: bigint;
+    })[];
+};
+/**
+ * sha256(seeds... || programId || "ProgramDerivedAddress") — the raw
+ * create_program_address with a KNOWN bump (never find_program_address:
+ * would be wrong if the stored bump isn't the canonical one, and here it's
+ * always read straight off the Vault account, never searched).
+ */
+export declare function createProgramAddress(seeds: Uint8Array[], programId: Address): Address;
+/** vault_authority = create_program_address(["vault_authority", vault, [bump]], VAULT_PROGRAM_ID) — verified against live mainnet vaults. */
+export declare function deriveStabbleVaultAuthority(vault: Address, authorityBump: number): Address;
+/** Canonical ATA(owner, mint) under the classic SPL Token program — a real find_program_address (off-curve search), needed once per pool at fetch time. */
+export declare function findStabbleAta(owner: Address, mint: Address): Promise<Address>;
+declare function assertU64AmountIn(amountIn: bigint, label: string): void;
+export { assertU64AmountIn as assertStabbleU64AmountIn, U64_MAX as STABBLE_U64_MAX };
+export declare const STABLE_AMP_PRECISION = 1000n;
+export declare const STABLE_MIN_TOKENS = 2;
+export declare const STABLE_MAX_TOKENS = 5;
+/** calc_invariant — Newton-Raphson D, <=64 rounds, converged when |D - Dprev| <= 100 (NOT 1 — Stabble's own default threshold, distinct from the 2-coin curve's threshold of 1). */
+export declare function stableCalcInvariantN(amplification: bigint, balances: readonly bigint[]): bigint;
+/** get_token_balance_given_invariant_n_all_other_balances — cold start (the venue's own initial guess), see stableSolveY for the shared Newton loop. */
+export declare function stableGetBalanceGivenInvariant(amplification: bigint, balances: readonly bigint[], invariant: bigint, excludedBalance: bigint): bigint;
+/** Ladder warm-start variant: same Newton recursion, starting from a caller-supplied y0 (the previous rung's converged y) instead of the cold initial guess. Passing y0 = invariant reproduces the cold start exactly. */
+export declare function stableGetBalanceGivenInvariantWarm(amplification: bigint, balances: readonly bigint[], invariant: bigint, excludedBalance: bigint, y0: bigint): bigint;
+/** calc_out_given_in — the exact-in quote (wrapped units, no fee applied yet). Returns 0 (not throw) on a degenerate/dust input the venue's own checked_sub would fail on, matching the engine's div-by-zero-yields-0 convention used throughout this codebase for quote fragments. */
+export declare function stableCalcOutGivenIn(amplification: bigint, balances: readonly bigint[], tokenIndexIn: number, tokenIndexOut: number, amountIn: bigint, invariant: bigint): bigint;
+/** get_amplification: linear ramp interpolation, clamped at the ramp window's ends (60s-quantized elapsed, matching the on-chain `checked_div(60)?.checked_mul(60)?`). */
+export declare function stableGetAmplification(ampInitialFactor: number, ampTargetFactor: number, rampStartTs: bigint, rampStopTs: bigint, currentTs: bigint): bigint;
+/**
+ * SauceScript SOURCE for a self-contained N-token stable quote helper, FIXED
+ * to tokenIndexIn=0, tokenIndexOut=1 (this repo's declared AtoB-only scope —
+ * see stabble-stable-swap's module doc). One helper per N (2..5); the ladder
+ * dedupes by name, so every pool sharing an N reuses the identical source
+ * (the `helpers()` dedupe invariant in ../types.js).
+ *
+ * A line-for-line transliteration of `stableCalcInvariantN` +
+ * `stableGetBalanceGivenInvariant` + `stableCalcOutGivenIn` above (see those
+ * for the bit-exact-verified bigint reference this mirrors): D-Newton
+ * (<=64 rounds, converge |Δ|<=100) then the excluded-balance Y-Newton
+ * (<=64 rounds, converge |Δ|<=1), both COLD (no cross-rung warm-start — the
+ * ladder calls this fresh per rung/final quote; see the ladder's module doc
+ * for why that tradeoff was made). Ceiling divisions (`checked_mul_div_up`/
+ * `checked_div_up` in the Rust source) are emitted as plain
+ * `(num + den - 1) / den` — safe without Math.mulDiv's 512-bit path because
+ * every product here stays far below 256 bits for realistic pool
+ * magnitudes (MAX_SAFE_BALANCE = 3e18 ~ 2^62; D and its square stay under
+ * ~2^130, AMP_PRECISION-scaled terms add a handful more bits) — bounds
+ * documented in docs/svm-venues.md-style fashion inline below is skipped
+ * only because this module doc already states them once for the whole file.
+ * A zero divisor anywhere (an empty side) yields 0 (the engine's DIV rule),
+ * never a revert — matched here so a degenerate pool quotes 0 instead of
+ * poisoning the merge.
+ */
+/**
+ * SauceScript SOURCE for the N-token D-Newton ALONE (calc_invariant) — the
+ * ladder's warm-start split of `stableQuoteHelperSource`: an N-token pool's
+ * D depends only on the reserves, so it is computed ONCE per trade (in
+ * `emitSetup`), not once per rung. Same <=64 rounds / converge |Δ|<=100 as
+ * the combined helper; see that function's doc for the ceiling-division and
+ * zero-divisor conventions (identical here).
+ */
+export declare function stableDHelperSource(n: number): {
+    name: string;
+    source: string;
+};
+/**
+ * SauceScript SOURCE for the excluded-balance Y-Newton ALONE, WARM-STARTABLE
+ * from a caller-supplied `y0` (the ladder's warm-start split of
+ * `stableQuoteHelperSource`): identical math to
+ * `stableGetBalanceGivenInvariant` EXCEPT the cold initial-guess formula is
+ * replaced by the caller's `y0` — passing `y0 = d` (the venue's own cold
+ * start) reproduces the venue-exact final quote; a ladder thread the
+ * PREVIOUS rung's converged y instead, cutting iterations to ~1-2 (a larger
+ * cumulative input means a smaller y, so the previous rung's y still
+ * approaches the fixed point from above — exactly `stableYW`'s justification
+ * for the 2-coin case, unchanged by generalizing to N tokens). Same
+ * ceiling-division / zero-divisor conventions as `stableQuoteHelperSource`.
+ */
+export declare function stableYWarmHelperSource(n: number): {
+    name: string;
+    source: string;
+};
+export declare function stableQuoteHelperSource(n: number): {
+    name: string;
+    source: string;
+};
+export declare const WEIGHTED_MAX_IN_RATIO = 300000000n;
+export declare const WEIGHTED_MIN_TOKENS = 2;
+export declare const WEIGHTED_MAX_TOKENS = 4;
+/**
+ * Integer floor(sqrt(n)), Newton's method. Exported (like every other helper
+ * in this module) so its byte-identity and iteration count are directly
+ * testable — see stabble-isqrt.test.ts.
+ *
+ * The seed `1n << ceil(bits/2)` (bits = n's bit length) is picked so the
+ * FIRST iterate already sits >= floor(sqrt(n)) for every n >= 2: n < 2^bits
+ * implies sqrt(n) < 2^(bits/2) <= 2^ceil(bits/2), so the seed's square,
+ * 2^(2*ceil(bits/2)), is >= 2^bits > n. Newton's iteration for floor-sqrt is
+ * monotonically non-increasing once started at or above the true root and
+ * converges to exactly floor(sqrt(n)) regardless of the starting point (the
+ * classical property this loop has always relied on — only the seed changed
+ * here) — so the RESULT for every n is unchanged; only the number of
+ * iterations needed drops, from ~bits/2 with the old `x = n` seed (each
+ * early iteration barely halves x) to ~5-8 total once seeded this close to
+ * the root. This matters here specifically because `weightedPowUp`'s
+ * fractional-exponent path feeds `sqrtInternalCeil` an ISCALE(1e18)-inflated
+ * operand — routinely ~110-130 bits — so the old seed cost ~55-70 slow
+ * halving iterations per sqrt call, repeated up to POW_FRAC_BITS(64) times
+ * per `weightedPowUp` invocation.
+ */
+export declare function isqrtFloor(n: bigint): bigint;
+/** OVER-estimate of base^exponent (base in (0, ONE], exponent >= 0, both ONE(1e9)-scaled). */
+export declare function weightedPowUp(base: bigint, exponent: bigint): bigint;
+/** calc_out_given_in (wrapped units) — null (not throw) once amountIn exceeds MAX_IN_RATIO, the venue's real hard capacity cap (`None` on-chain, would panic the instruction; the ladder must clamp to this, never quote past it). */
+export declare function weightedCalcOutGivenIn(balanceIn: bigint, weightIn: bigint, balanceOut: bigint, weightOut: bigint, amountIn: bigint): bigint | null;
+/**
+ * SauceScript SOURCE mirror of `weightedPowUp` — since `weightIn`/`weightOut`
+ * are pool constants (immutable in practice; treated as such here, matching
+ * this codebase's convention of baking genuinely-immutable curve constants),
+ * the exponent — and therefore the ENTIRE bit-decomposition schedule (how
+ * many squarings for the integer part, how many sqrt iterations for the
+ * fraction, and which of them land a "multiply into result" — is fully
+ * determined at COMPILE TIME. So unlike the runtime loop `weightedPowUp`
+ * runs in TS, the emitted fragment needs NO loop and NO data-dependent
+ * branch at all: this function TRACES the same schedule off-chain and
+ * emits a flat, unrolled sequence of ceiling-sqrt/ceiling-multiply lines —
+ * cheaper AND simpler than a generic runtime loop, and naturally short for
+ * "nice" ratios (50/50, 80/20, ...) since the fractional remainder can hit
+ * exactly 0 after only 1-2 iterations. `baseVar` must already be bound to
+ * the ONE(1e9)-scaled runtime base (`divUp(balanceIn, balanceIn+amountIn)`);
+ * `out` becomes a `const` holding the ONE-scaled, ceiling-biased power.
+ * The three exact-integer special cases (ONE/TWO/THREE/FOUR) reproduce the
+ * real program's own fast path bit-for-bit (mulUp composition, no
+ * approximation); everything else uses the conservative sqrt ladder (see
+ * `weightedPowUp`'s doc for the accuracy/conservatism proof).
+ */
+export declare function weightedPowUpSource(weightIn: bigint, weightOut: bigint, baseVar: string, out: string): string[];
+/**
+ * Full weighted-swap core quote (wrapped-space, NO fee applied yet — the
+ * caller applies swap_fee, matching the real program's own function
+ * boundary): `${outVar}` becomes the wrapped gross output for a wrapped
+ * gross-input expression `wrappedXExpr` (0 when the expression is 0, never
+ * negative, never throws on a zero/degenerate denominator — matches the
+ * engine's DIV rule). `tag` must be unique per call site (rung index or
+ * "final") so nested locals across multiple emissions in one fragment don't
+ * collide.
+ */
+export declare function weightedCoreQuoteLines(tag: string, balInVar: string, balOutVar: string, weightIn: bigint, weightOut: bigint, wrappedXExpr: string, outVar: string): string[];
+//# sourceMappingURL=stabble-common.d.ts.map

package/sdk/dist/svm/venues/stabble-common.d.ts.map

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