@eco-incorp/sauce 0.99.0

package/sdk/dist/svm/venues/spl-token-swap-forks/index.d.ts

@@ -0,0 +1,130 @@
+import type { Address } from "@solana/kit";
+import type { AccountBytesMap, AccountLoader, PoolConfig, SwapUser, VenueAccount, VenueSwap } from "../types.js";
+export interface SplTokenSwapForkPoolConfig extends PoolConfig {
+    /** Swap-authority PDA: create_program_address([pool, [bump_seed@2]], THIS fork's program). */
+    swapAuthority: Address;
+    /** token_program_id @3. */
+    tokenProgram: Address;
+    /** Vault of the input mint (token_a @35 — quote direction is A -> B). */
+    vaultIn: Address;
+    /** Vault of the output mint (token_b @67). */
+    vaultOut: Address;
+    /** pool_mint @99 — writable in the swap ix (owner fee is minted as LP tokens). */
+    poolMint: Address;
+    /** pool_fee_account @195 — pool-mint token account receiving the owner fee. */
+    poolFeeAccount: Address;
+    /** token_a_mint @131. */
+    inputMint: Address;
+    /** token_b_mint @163. */
+    outputMint: Address;
+    /** trade_fee_numerator @227 / trade_fee_denominator @235. */
+    tradeFeeNumerator: bigint;
+    tradeFeeDenominator: bigint;
+    /** owner_trade_fee_numerator @243 / owner_trade_fee_denominator @251. */
+    ownerTradeFeeNumerator: bigint;
+    ownerTradeFeeDenominator: bigint;
+    /** bump_seed @2 — the stored (not necessarily canonical) swap-authority nonce. */
+    bumpSeed: number;
+}
+export interface SplTokenSwapForkAdapter {
+    slug: string;
+    kind: "constant-product";
+    programId: Address;
+    fetchPoolConfig(load: AccountLoader, pool: Address): Promise<SplTokenSwapForkPoolConfig>;
+    quoteAccounts(cfg: SplTokenSwapForkPoolConfig): VenueAccount[];
+    emitQuote(cfg: SplTokenSwapForkPoolConfig, i: number, amountIn: bigint): string;
+    buildSwap(cfg: SplTokenSwapForkPoolConfig, user: SwapUser, amountIn: bigint): VenueSwap;
+    referenceQuote(cfg: SplTokenSwapForkPoolConfig, state: AccountBytesMap, amountIn: bigint, _now: bigint): bigint;
+}
+/**
+ * One adapter per deployed spl-token-swap fork — SAME math/layout as
+ * orca-legacy-token-swap (see module header), parameterized only by the
+ * fork's own program id (the CPI target AND the swap-authority PDA domain).
+ *
+ * `unresolvedGate`, when passed, makes `fetchPoolConfig` throw UNCONDITIONALLY
+ * for every pool of this family (naming the reason) — the SAME mechanism
+ * `orca-legacy-token-swap` uses to keep its stable-curve pools out of the
+ * electable universe (see that adapter's `curve_type` check), just applied to
+ * the WHOLE family instead of a per-pool byte. `resolveSvmPoolSpec` catches
+ * any `fetchPoolConfig` throw and drops the candidate — one venue's gate
+ * never breaks discovery or any other family, and (critically) it means the
+ * family is WIRED (program id, discovery filter, CU entry all present and
+ * exercised) while being STRUCTURALLY UNABLE to enter a cook until the gate
+ * is lifted, so there is zero production revert/mispricing risk from an
+ * unresolved integration question. See ./index.ts's `dexlab`/`saros`
+ * instantiations below for the two currently gated forks and exactly what
+ * each is waiting on.
+ */
+export declare function makeSplTokenSwapForkAdapter(slug: string, programId: Address, unresolvedGate?: string): SplTokenSwapForkAdapter;
+/** Token Swap — the original solana-labs/solana-program-library deployment. */
+export declare const TOKEN_SWAP_V1_PROGRAM_ID: Address;
+export declare const tokenSwapV1: SplTokenSwapForkAdapter;
+/**
+ * DexLab — GATED (see `unresolvedGate` above): a real-CPI probe against the
+ * live mainnet binary (a real SOL/USDC pool, `4KizLX56YSbTtc8NJQWDBz3iiwSTpJRHFUXAvB4v6MM3`,
+ * dumped 2026-07-31) shows the deployed `Swap` instruction reads MORE than
+ * the standard spl-token-swap 10 (or 11, with the optional host-fee account)
+ * accounts — it still fails `NotEnoughAccountKeys` with 10 or 11 provided,
+ * and only clears that check at 14 (10 + 4 arbitrary dummy reads), at which
+ * point it fails a DIFFERENT (custom code 24) check — meaning DexLab's fork
+ * genuinely extends the account list with something this repo hasn't
+ * identified (no public source was available to cross-reference). Gated
+ * rather than guessed at: a wrong account list here would revert every
+ * dexlab cook in production, and DexLab is otherwise the single
+ * deepest-liquidity fork of the six (2,097 live constant-product pools).
+ */
+export declare const DEXLAB_PROGRAM_ID: Address;
+export declare const dexlab: SplTokenSwapForkAdapter;
+/**
+ * Saros — UN-GATED (2026-08-03; was gated, see git history for the original
+ * `unresolvedGate` text). The original real-CPI probe against the live
+ * mainnet binary (a real WSOL/USDC pool,
+ * `Djxfn7zWFxFqYgwesXfq8BeAirfXwfhQmNcCousXh7G7`, dumped 2026-07-31) found
+ * the same fee-MODEL divergence this comment used to describe: REALIZED
+ * output across 14 independently-sampled real trades (27,995 to 6,089,579
+ * raw units) implies an effective swap fee of a clean, reproducible ~4 bps —
+ * NOT the 30 bps the pool's own on-chain `owner_trade_fee` field states
+ * (`trade_fee` reads 0 bps). The account layout is confirmed correct up
+ * through `pool_fee_account` (the swap only succeeds because that key check
+ * passes) — this is a genuine fee-MODEL divergence, not a decode bug: Saros's
+ * deployed program evidently does not compute the swap fee the vanilla
+ * spl-token-swap way from the fields at these offsets, and no public source
+ * was available to determine the real rule (the likely explanation, not
+ * confirmed: the stored `owner_trade_fee` sizes how many LP tokens this fork
+ * mints to `pool_fee_account` — confirmed growing consistent with invariant
+ * growth on every sampled trade — while the amount actually deducted from
+ * the trader's output is governed by a separate, unrecovered constant).
+ *
+ * Rather than continue gating on an unresolved exact rule, this adapter
+ * deliberately keeps the generic `makeSplTokenSwapForkAdapter` formula
+ * (the STORED, higher trade+owner fee rates as the netIn deduction) as a
+ * MEASURED, DELIBERATE safety margin: across all 14 sampled trades this
+ * model's predicted output was strictly <= the real realized output every
+ * time (margins of ~0.05%-0.26% of the trade) — never an over-promise, so
+ * quoting it is safe for election (a worse model never wins a share it
+ * doesn't deserve), the same closed-source-fork trade-off `gamma`'s
+ * dynamic-fee ceiling already makes. Proven end-to-end against the real
+ * deployed binary in LiteSVM at 2 and 4 rungs plus three additional sizes
+ * (`predicted <= realized` at every sampled size, never `===`, unlike the
+ * `orca-legacy-token-swap`/`token-swap-v1`/etc. siblings this fork's math was
+ * cloned from) — see the consuming app realcpi e2e test's `saros`
+ * describeWith block in sauce-recipes.
+ */
+export declare const SAROS_PROGRAM_ID: Address;
+export declare const saros: SplTokenSwapForkAdapter;
+/**
+ * Orca V1 — the ORIGINAL Orca token-swap deployment, a DIFFERENT program from
+ * the already-wired `orca-legacy-token-swap` ("Orca V2",
+ * `9W959DqEETiGZocYWCQPaJ6sBmUzgfxXfqGeTEdp3aQP`). Confirmed distinct live
+ * (routePlan ammKey `6fTRDD7sYxCN7oyoSQaN1AWC3P2m8A6gVZzGrpej9DvL`, owner
+ * `DjVE6JNiYqPL2QXyCUUh8rNjHrbz9hXHNYt99MQ59qw1`).
+ */
+export declare const ORCA_V1_PROGRAM_ID: Address;
+export declare const orcaV1: SplTokenSwapForkAdapter;
+/** Penguin. */
+export declare const PENGUIN_PROGRAM_ID: Address;
+export declare const penguin: SplTokenSwapForkAdapter;
+/** StepN (Dooar). */
+export declare const STEPN_PROGRAM_ID: Address;
+export declare const stepn: SplTokenSwapForkAdapter;
+//# sourceMappingURL=index.d.ts.map

package/sdk/dist/svm/venues/spl-token-swap-forks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/svm/venues/spl-token-swap-forks/index.ts"],"names":[],"mappings":"AAsDA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,SAAS,EACV,MAAM,aAAa,CAAC;AAyBrB,MAAM,WAAW,0BAA2B,SAAQ,UAAU;IAC5D,8FAA8F;IAC9F,aAAa,EAAE,OAAO,CAAC;IACvB,2BAA2B;IAC3B,YAAY,EAAE,OAAO,CAAC;IACtB,yEAAyE;IACzE,OAAO,EAAE,OAAO,CAAC;IACjB,8CAA8C;IAC9C,QAAQ,EAAE,OAAO,CAAC;IAClB,kFAAkF;IAClF,QAAQ,EAAE,OAAO,CAAC;IAClB,+EAA+E;IAC/E,cAAc,EAAE,OAAO,CAAC;IACxB,yBAAyB;IACzB,SAAS,EAAE,OAAO,CAAC;IACnB,yBAAyB;IACzB,UAAU,EAAE,OAAO,CAAC;IACpB,6DAA6D;IAC7D,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,yEAAyE;IACzE,sBAAsB,EAAE,MAAM,CAAC;IAC/B,wBAAwB,EAAE,MAAM,CAAC;IACjC,kFAAkF;IAClF,QAAQ,EAAE,MAAM,CAAC;CAClB;AA+CD,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,kBAAkB,CAAC;IACzB,SAAS,EAAE,OAAO,CAAC;IACnB,eAAe,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;IACzF,aAAa,CAAC,GAAG,EAAE,0BAA0B,GAAG,YAAY,EAAE,CAAC;IAC/D,SAAS,CAAC,GAAG,EAAE,0BAA0B,EAAE,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IAChF,SAAS,CAAC,GAAG,EAAE,0BAA0B,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IACxF,cAAc,CACZ,GAAG,EAAE,0BAA0B,EAC/B,KAAK,EAAE,eAAe,EACtB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,MAAM,CAAC;CACX;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,OAAO,EAClB,cAAc,CAAC,EAAE,MAAM,GACtB,uBAAuB,CAmIzB;AAED,+EAA+E;AAC/E,eAAO,MAAM,wBAAwB,EAAoD,OAAO,CAAC;AACjG,eAAO,MAAM,WAAW,yBAAyE,CAAC;AAElG;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,iBAAiB,EAAqD,OAAO,CAAC;AAC3F,eAAO,MAAM,MAAM,yBAIlB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,eAAO,MAAM,gBAAgB,EAAoD,OAAO,CAAC;AACzF,eAAO,MAAM,KAAK,yBAAyD,CAAC;AAE5E;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,EAAqD,OAAO,CAAC;AAC5F,eAAO,MAAM,MAAM,yBAA6D,CAAC;AAEjF,eAAe;AACf,eAAO,MAAM,kBAAkB,EAAoD,OAAO,CAAC;AAC3F,eAAO,MAAM,OAAO,yBAA6D,CAAC;AAElF,qBAAqB;AACrB,eAAO,MAAM,gBAAgB,EAAqD,OAAO,CAAC;AAC1F,eAAO,MAAM,KAAK,yBAAyD,CAAC"}

package/sdk/dist/svm/venues/spl-token-swap-forks/index.js

@@ -0,0 +1,335 @@
+/**
+ * spl-token-swap FORKS — six independently-deployed programs that all run the
+ * SAME open-source `solana-labs/solana-program-library` `token-swap` codebase
+ * (Token Swap itself, DexLab, Saros, Orca's ORIGINAL v1 fork, Penguin, StepN's
+ * Dooar): the identical 324-byte `SwapVersion::SwapV1` account layout (no
+ * discriminator, manual `Pack`), the identical `Swap` instruction (tag 1,
+ * `[amount_in u64 LE][minimum_amount_out u64 LE]`, the same 10-account order),
+ * and the identical constant-product-with-fees math the sibling
+ * `orca-legacy-token-swap` adapter (itself a
+ * SEPARATE spl-token-swap fork at program `9W959DqEETiGZocYWCQPaJ6sBmUzgfxXfqGeTEdp3aQP`)
+ * already decodes and quotes — see that adapter's header for the shared
+ * derivation. The only thing that differs PER FORK is the deployed program id
+ * (which changes both the `create_program_address` swap-authority PDA domain
+ * and the CPI target), so this module is a single parameterized factory
+ * instantiated once per program id below, not six copies of the math.
+ *
+ * GROUND TRUTH for the six program ids: Jupiter's own `program-id-to-label`
+ * capture (`benchmark/adapters/fixtures/jupiter-program-id-to-label.json`) —
+ * `SwaPpA9LAaLfeLi3a68M4DjnLqgtticKg6CnyNwgAC8` "Token Swap",
+ * `DSwpgjMvXhtGn6BsbqmacdBZyfLj6jSWf3HJpdJtmg6N` "DexLab",
+ * `SSwapUtytfBdBn1b9NUGG6foMVPtcWgpRU32HToDUZr` "Saros",
+ * `DjVE6JNiYqPL2QXyCUUh8rNjHrbz9hXHNYt99MQ59qw1` "Orca V1" (a GENUINELY
+ * DIFFERENT program from "Orca V2"'s `9W959D...` — confirmed live, see
+ * `benchmark/adapters/_svm-venues.ts`'s prior no-analogue note, now
+ * superseded by this wiring),
+ * `PSwapMdSai8tjrEXcxFeQth87xC4rRsa4VA5mhGhXkP` "Penguin",
+ * `Dooar9JkhdZ7J3LHN3A7YCuoGRUggXhQaG4kijfLGU2j` "StepN". Live pool counts at
+ * this 324-byte layout (measured 2026-07-31 via a keyless `getProgramAccounts`
+ * memcmp sweep, `curve_type` (offset 291) filtered to 0 = constant product):
+ * DexLab 2,097 / Saros 554 / Token Swap 339 / Orca V1 31 / Penguin 29 /
+ * StepN 6 pools.
+ *
+ * FIVE of the six are FULLY WIRED and real-CPI proven at 3+ sizes each
+ * against their own real mainnet fixture pool and their own real dumped
+ * binary (see the consuming app realcpi e2e test): token-swap-v1,
+ * orca-v1, penguin, stepn, and (2026-08-03, see `saros`'s own doc comment
+ * below for the conservative-margin resolution) saros. The remaining ONE —
+ * dexlab — is WIRED (program id, discovery filter, CU entry, all exercised
+ * the same as the other five) but GATED: `fetchPoolConfig` throws
+ * unconditionally for every pool of that family (see
+ * `makeSplTokenSwapForkAdapter`'s `unresolvedGate` parameter, and its own
+ * doc comment below for exactly what
+ * real-CPI testing found and why it isn't safe to guess at). A gated family
+ * can never enter the electable universe (`resolveSvmPoolSpec` drops any
+ * `fetchPoolConfig` throw) — so this is a zero-risk placeholder for a
+ * follow-up, not a shipped-but-wrong integration.
+ *
+ * The spl-token-swap STABLE curve (`curve_type` nonzero, an amplification
+ * coefficient in the calculator blob) is explicitly OUT OF SCOPE here, same
+ * as `orca-legacy-token-swap` — `fetchPoolConfig` throws on any nonzero
+ * `curve_type` rather than silently mis-pricing a stable pool with CP math.
+ */
+import { createHash } from "node:crypto";
+import { getAddressCodec } from "@solana/kit";
+// SwapVersion::pack writes version at byte 0 and the 323-byte SwapV1 body at
+// bytes 1..: 1 + 323 = 324, no discriminator, no padding — identical across
+// every spl-token-swap deployment (see module header).
+const POOL_SIZE = 324;
+/**
+ * Little-endian unsigned field read (the TS mirror of the compiler's
+ * accountUint(ref, offset, width)) and ceiling division — the same tiny pure
+ * helpers `@eco-incorp/sauce/svm`'s venue adapters use internally
+ * (`venues/math.js`, not part of the package's public `/svm` barrel export,
+ * so re-implemented here rather than deep-imported).
+ */
+function readUintLE(data, offset, width) {
+    let value = 0n;
+    for (let i = width - 1; i >= 0; i--)
+        value = (value << 8n) | BigInt(data[offset + i]);
+    return value;
+}
+/** Ceiling division: smallest q with q * b >= a. Non-negative dividends only. */
+function ceilDiv(a, b) {
+    return (a + b - 1n) / b;
+}
+/**
+ * fees.rs calculate_fee: zero when the rate or the amount is zero, otherwise
+ * floor(x * n / d) but at least 1 raw unit — identical across every
+ * spl-token-swap deployment (same open-source `fees.rs`).
+ */
+function swapFee(x, numerator, denominator) {
+    if (numerator === 0n || x === 0n)
+        return 0n;
+    const fee = (x * numerator) / denominator;
+    return fee === 0n ? 1n : fee;
+}
+/** Fees are baked into the emitted quote, so netIn is compile-time for a fixed amountIn. */
+function netAmountIn(slug, cfg, amountIn) {
+    if (amountIn <= 0n || amountIn >= 1n << 64n) {
+        throw new Error(`${slug} amountIn must be a positive u64, got ${amountIn}`);
+    }
+    const tradeFee = swapFee(amountIn, cfg.tradeFeeNumerator, cfg.tradeFeeDenominator);
+    const ownerFee = swapFee(amountIn, cfg.ownerTradeFeeNumerator, cfg.ownerTradeFeeDenominator);
+    const netIn = amountIn - tradeFee - ownerFee;
+    if (netIn <= 0n)
+        throw new Error(`${slug} amountIn ${amountIn} is consumed entirely by fees`);
+    return netIn;
+}
+/**
+ * create_program_address for the STORED bump (a pool may have been
+ * initialized with a non-canonical nonce, so find-style derivation is wrong
+ * here — see orca-legacy-token-swap's identical note). No on-curve rejection:
+ * the pool exists on-chain with this bump under THIS fork's program id, so
+ * the derivation is already known to be off-curve.
+ */
+function deriveSwapAuthority(programId, pool, bumpSeed) {
+    const codec = getAddressCodec();
+    return codec.decode(createHash("sha256")
+        .update(new Uint8Array(codec.encode(pool)))
+        .update(Uint8Array.of(bumpSeed))
+        .update(new Uint8Array(codec.encode(programId)))
+        .update("ProgramDerivedAddress")
+        .digest());
+}
+const poolRef = (slug, cfg, role) => `${slug}:${cfg.pool}:${role}`;
+/**
+ * One adapter per deployed spl-token-swap fork — SAME math/layout as
+ * orca-legacy-token-swap (see module header), parameterized only by the
+ * fork's own program id (the CPI target AND the swap-authority PDA domain).
+ *
+ * `unresolvedGate`, when passed, makes `fetchPoolConfig` throw UNCONDITIONALLY
+ * for every pool of this family (naming the reason) — the SAME mechanism
+ * `orca-legacy-token-swap` uses to keep its stable-curve pools out of the
+ * electable universe (see that adapter's `curve_type` check), just applied to
+ * the WHOLE family instead of a per-pool byte. `resolveSvmPoolSpec` catches
+ * any `fetchPoolConfig` throw and drops the candidate — one venue's gate
+ * never breaks discovery or any other family, and (critically) it means the
+ * family is WIRED (program id, discovery filter, CU entry all present and
+ * exercised) while being STRUCTURALLY UNABLE to enter a cook until the gate
+ * is lifted, so there is zero production revert/mispricing risk from an
+ * unresolved integration question. See ./index.ts's `dexlab`/`saros`
+ * instantiations below for the two currently gated forks and exactly what
+ * each is waiting on.
+ */
+export function makeSplTokenSwapForkAdapter(slug, programId, unresolvedGate) {
+    return {
+        slug,
+        kind: "constant-product",
+        programId,
+        async fetchPoolConfig(load, pool) {
+            if (unresolvedGate !== undefined) {
+                throw new Error(`${slug} pool ${pool}: family gated pending resolution — ${unresolvedGate}`);
+            }
+            const data = await load(pool);
+            if (data === null)
+                throw new Error(`${slug} pool ${pool} account not found`);
+            if (data.length !== POOL_SIZE) {
+                throw new Error(`${slug} pool ${pool} data must be ${POOL_SIZE} bytes (SwapVersion::SwapV1), got ${data.length}`);
+            }
+            if (data[0] !== 1)
+                throw new Error(`${slug} pool ${pool} version must be 1 (SwapV1), got ${data[0]}`);
+            if (data[1] !== 1)
+                throw new Error(`${slug} pool ${pool} is not initialized`);
+            // The stable curve (curve_type != 0, amp in the calculator blob) is out
+            // of scope — see module header.
+            if (data[291] !== 0) {
+                throw new Error(`${slug} pool ${pool} curve_type must be 0 (constant product), got ${data[291]}`);
+            }
+            const codec = getAddressCodec();
+            const pubkey = (offset) => codec.decode(data.subarray(offset, offset + 32));
+            const u64 = (offset) => readUintLE(data, offset, 8);
+            const tradeFeeNumerator = u64(227);
+            const tradeFeeDenominator = u64(235);
+            const ownerTradeFeeNumerator = u64(243);
+            const ownerTradeFeeDenominator = u64(251);
+            for (const [name, numerator, denominator] of [
+                ["trade", tradeFeeNumerator, tradeFeeDenominator],
+                ["owner trade", ownerTradeFeeNumerator, ownerTradeFeeDenominator],
+            ]) {
+                if (numerator !== 0n && denominator === 0n) {
+                    throw new Error(`${slug} pool ${pool} ${name} fee denominator is 0 with nonzero numerator ${numerator}`);
+                }
+            }
+            const bumpSeed = data[2];
+            return {
+                venue: slug,
+                pool,
+                swapAuthority: deriveSwapAuthority(programId, pool, bumpSeed),
+                // token_program_id @3 — the classic spl-token-swap `Swap` ix takes ONE
+                // token program used for BOTH vaults and the pool mint, so a per-side
+                // program does not exist for this family: a pool mixing legacy + T22
+                // mints cannot function under this program. This reads the pool's own
+                // stored program (legacy OR Token-2022), so a T22 pool threads T22 here
+                // with no hardcoded-legacy assumption — buildSwap forwards it verbatim.
+                tokenProgram: pubkey(3),
+                vaultIn: pubkey(35),
+                vaultOut: pubkey(67),
+                poolMint: pubkey(99),
+                inputMint: pubkey(131),
+                outputMint: pubkey(163),
+                poolFeeAccount: pubkey(195),
+                tradeFeeNumerator,
+                tradeFeeDenominator,
+                ownerTradeFeeNumerator,
+                ownerTradeFeeDenominator,
+                bumpSeed,
+            };
+        },
+        quoteAccounts(cfg) {
+            return [
+                { ref: poolRef(slug, cfg, "vault-in"), address: cfg.vaultIn },
+                { ref: poolRef(slug, cfg, "vault-out"), address: cfg.vaultOut },
+            ];
+        },
+        emitQuote(cfg, i, amountIn) {
+            const netIn = netAmountIn(slug, cfg, amountIn);
+            // Account model (RS compiler): quoteAccounts() order is [vault-in, vault-out],
+            // so vault-in is slot 0 (acc0) and vault-out slot 1 (acc1). accountUint lowered
+            // to CAST_LE and the SPL amount@64 is u64 LE, so `.toLe()` is the exact match.
+            return [
+                `const rIn${i} = svm.sload(acc0, 64, 8).toLe();`,
+                `const rOut${i} = svm.sload(acc1, 64, 8).toLe();`,
+                `const q${i} = rOut${i} - (rIn${i} * rOut${i} + rIn${i} + ${netIn - 1n}) / (rIn${i} + ${netIn});`,
+            ].join("\n");
+        },
+        buildSwap(cfg, user, amountIn) {
+            if (amountIn <= 0n || amountIn >= 1n << 64n) {
+                throw new Error(`${slug} amountIn must be a positive u64, got ${amountIn}`);
+            }
+            const data = new Uint8Array(17);
+            data[0] = 1;
+            new DataView(data.buffer).setBigUint64(1, amountIn, true);
+            new DataView(data.buffer).setBigUint64(9, 1n, true);
+            return {
+                programId,
+                data,
+                accounts: [
+                    { ref: poolRef(slug, cfg, "pool"), address: cfg.pool },
+                    { ref: poolRef(slug, cfg, "authority"), address: cfg.swapAuthority },
+                    { ref: user.owner, signer: true },
+                    { ref: user.inAta, writable: true },
+                    { ref: poolRef(slug, cfg, "vault-in"), address: cfg.vaultIn, writable: true },
+                    { ref: poolRef(slug, cfg, "vault-out"), address: cfg.vaultOut, writable: true },
+                    { ref: user.outAta, writable: true },
+                    { ref: poolRef(slug, cfg, "pool-mint"), address: cfg.poolMint, writable: true },
+                    { ref: poolRef(slug, cfg, "fee-account"), address: cfg.poolFeeAccount, writable: true },
+                    { ref: poolRef(slug, cfg, "token-program"), address: cfg.tokenProgram },
+                ],
+            };
+        },
+        referenceQuote(cfg, state, amountIn, _now) {
+            const vaults = [];
+            for (const vault of [cfg.vaultIn, cfg.vaultOut]) {
+                const data = state[vault];
+                if (data === undefined)
+                    throw new Error(`${slug} vault ${vault} missing from state`);
+                vaults.push(data);
+            }
+            const rsIn = readUintLE(vaults[0], 64, 8);
+            const rsOut = readUintLE(vaults[1], 64, 8);
+            const netIn = netAmountIn(slug, cfg, amountIn);
+            const invariant = rsIn * rsOut;
+            const newIn = rsIn + netIn;
+            if (invariant / newIn === 0n)
+                throw new Error(`${slug} swap fails on-chain (zero quotient)`);
+            const newOut = ceilDiv(invariant, newIn);
+            const amountOut = rsOut - newOut;
+            if (amountOut === 0n)
+                throw new Error(`${slug} swap fails on-chain (zero output)`);
+            return amountOut;
+        },
+    };
+}
+/** Token Swap — the original solana-labs/solana-program-library deployment. */
+export const TOKEN_SWAP_V1_PROGRAM_ID = "SwaPpA9LAaLfeLi3a68M4DjnLqgtticKg6CnyNwgAC8";
+export const tokenSwapV1 = makeSplTokenSwapForkAdapter("token-swap-v1", TOKEN_SWAP_V1_PROGRAM_ID);
+/**
+ * DexLab — GATED (see `unresolvedGate` above): a real-CPI probe against the
+ * live mainnet binary (a real SOL/USDC pool, `4KizLX56YSbTtc8NJQWDBz3iiwSTpJRHFUXAvB4v6MM3`,
+ * dumped 2026-07-31) shows the deployed `Swap` instruction reads MORE than
+ * the standard spl-token-swap 10 (or 11, with the optional host-fee account)
+ * accounts — it still fails `NotEnoughAccountKeys` with 10 or 11 provided,
+ * and only clears that check at 14 (10 + 4 arbitrary dummy reads), at which
+ * point it fails a DIFFERENT (custom code 24) check — meaning DexLab's fork
+ * genuinely extends the account list with something this repo hasn't
+ * identified (no public source was available to cross-reference). Gated
+ * rather than guessed at: a wrong account list here would revert every
+ * dexlab cook in production, and DexLab is otherwise the single
+ * deepest-liquidity fork of the six (2,097 live constant-product pools).
+ */
+export const DEXLAB_PROGRAM_ID = "DSwpgjMvXhtGn6BsbqmacdBZyfLj6jSWf3HJpdJtmg6N";
+export const dexlab = makeSplTokenSwapForkAdapter("dexlab", DEXLAB_PROGRAM_ID, "Swap instruction needs >11 accounts on the real deployed binary (confirmed via real-CPI probe); exact extra account(s) not yet identified");
+/**
+ * Saros — UN-GATED (2026-08-03; was gated, see git history for the original
+ * `unresolvedGate` text). The original real-CPI probe against the live
+ * mainnet binary (a real WSOL/USDC pool,
+ * `Djxfn7zWFxFqYgwesXfq8BeAirfXwfhQmNcCousXh7G7`, dumped 2026-07-31) found
+ * the same fee-MODEL divergence this comment used to describe: REALIZED
+ * output across 14 independently-sampled real trades (27,995 to 6,089,579
+ * raw units) implies an effective swap fee of a clean, reproducible ~4 bps —
+ * NOT the 30 bps the pool's own on-chain `owner_trade_fee` field states
+ * (`trade_fee` reads 0 bps). The account layout is confirmed correct up
+ * through `pool_fee_account` (the swap only succeeds because that key check
+ * passes) — this is a genuine fee-MODEL divergence, not a decode bug: Saros's
+ * deployed program evidently does not compute the swap fee the vanilla
+ * spl-token-swap way from the fields at these offsets, and no public source
+ * was available to determine the real rule (the likely explanation, not
+ * confirmed: the stored `owner_trade_fee` sizes how many LP tokens this fork
+ * mints to `pool_fee_account` — confirmed growing consistent with invariant
+ * growth on every sampled trade — while the amount actually deducted from
+ * the trader's output is governed by a separate, unrecovered constant).
+ *
+ * Rather than continue gating on an unresolved exact rule, this adapter
+ * deliberately keeps the generic `makeSplTokenSwapForkAdapter` formula
+ * (the STORED, higher trade+owner fee rates as the netIn deduction) as a
+ * MEASURED, DELIBERATE safety margin: across all 14 sampled trades this
+ * model's predicted output was strictly <= the real realized output every
+ * time (margins of ~0.05%-0.26% of the trade) — never an over-promise, so
+ * quoting it is safe for election (a worse model never wins a share it
+ * doesn't deserve), the same closed-source-fork trade-off `gamma`'s
+ * dynamic-fee ceiling already makes. Proven end-to-end against the real
+ * deployed binary in LiteSVM at 2 and 4 rungs plus three additional sizes
+ * (`predicted <= realized` at every sampled size, never `===`, unlike the
+ * `orca-legacy-token-swap`/`token-swap-v1`/etc. siblings this fork's math was
+ * cloned from) — see the consuming app realcpi e2e test's `saros`
+ * describeWith block in sauce-recipes.
+ */
+export const SAROS_PROGRAM_ID = "SSwapUtytfBdBn1b9NUGG6foMVPtcWgpRU32HToDUZr";
+export const saros = makeSplTokenSwapForkAdapter("saros", SAROS_PROGRAM_ID);
+/**
+ * Orca V1 — the ORIGINAL Orca token-swap deployment, a DIFFERENT program from
+ * the already-wired `orca-legacy-token-swap` ("Orca V2",
+ * `9W959DqEETiGZocYWCQPaJ6sBmUzgfxXfqGeTEdp3aQP`). Confirmed distinct live
+ * (routePlan ammKey `6fTRDD7sYxCN7oyoSQaN1AWC3P2m8A6gVZzGrpej9DvL`, owner
+ * `DjVE6JNiYqPL2QXyCUUh8rNjHrbz9hXHNYt99MQ59qw1`).
+ */
+export const ORCA_V1_PROGRAM_ID = "DjVE6JNiYqPL2QXyCUUh8rNjHrbz9hXHNYt99MQ59qw1";
+export const orcaV1 = makeSplTokenSwapForkAdapter("orca-v1", ORCA_V1_PROGRAM_ID);
+/** Penguin. */
+export const PENGUIN_PROGRAM_ID = "PSwapMdSai8tjrEXcxFeQth87xC4rRsa4VA5mhGhXkP";
+export const penguin = makeSplTokenSwapForkAdapter("penguin", PENGUIN_PROGRAM_ID);
+/** StepN (Dooar). */
+export const STEPN_PROGRAM_ID = "Dooar9JkhdZ7J3LHN3A7YCuoGRUggXhQaG4kijfLGU2j";
+export const stepn = makeSplTokenSwapForkAdapter("stepn", STEPN_PROGRAM_ID);
+//# sourceMappingURL=index.js.map

package/sdk/dist/svm/venues/spl-token-swap-forks/index.js.map

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

package/sdk/dist/svm/venues/stabble-clmm/index.d.ts

@@ -0,0 +1,93 @@
+import type { Address } from "@solana/kit";
+import type { AccountLoader, PoolConfig } from "../types.js";
+declare const SLUG = "stabble-clmm";
+/** Stabble's CLMM program (a Raydium-CLMM-shaped Anchor fork). */
+export declare const STABBLE_CLMM_PROGRAM_ID: Address<"6dMXqGZ3ga2dikrYS9ovDXgHGh5RUsb2RTUj6hrQXhk6">;
+export declare const POOL_ACCOUNT_SIZE = 1544;
+export declare const AMM_CONFIG_ACCOUNT_SIZE = 117;
+export declare const TICK_ARRAY_ACCOUNT_SIZE = 10240;
+export declare const TICK_ARRAY_SIZE = 60;
+export declare const OFF_AMM_CONFIG = 9;
+export declare const OFF_TOKEN_MINT_0 = 73;
+export declare const OFF_TOKEN_MINT_1 = 105;
+export declare const OFF_TOKEN_VAULT_0 = 137;
+export declare const OFF_TOKEN_VAULT_1 = 169;
+export declare const OFF_OBSERVATION_KEY = 201;
+export declare const OFF_TICK_SPACING = 235;
+export declare const OFF_LIQUIDITY = 237;
+export declare const OFF_SQRT_PRICE = 253;
+export declare const OFF_TICK_CURRENT = 269;
+export declare const OFF_STATUS = 389;
+export declare const OFF_FEE_ON = 390;
+export declare const OFF_OPEN_TIME = 1080;
+export declare const OFF_DYNAMIC_FEE_INFO = 1096;
+export declare const DYNAMIC_FEE_INFO_LEN = 80;
+/** AmmConfig: trade_fee_rate u32 @47 (hundredths of a bip, denominator 1e6). */
+export declare const OFF_CFG_TRADE_FEE_RATE = 47;
+export declare const OFF_TA_POOL = 8;
+export declare const OFF_TA_START = 40;
+export declare const OFF_TA_TICKS = 44;
+export declare const TICK_LEN = 168;
+export declare const OFF_TICK_LIQ_NET = 4;
+export declare const OFF_TICK_LIQ_GROSS = 20;
+export declare const OFF_TICK_ORDERS_AMOUNT = 124;
+export declare const OFF_TICK_PART_FILLED_ORDERS = 132;
+/**
+ * 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 declare const STABBLE_CLMM_MAX_BOUNDARIES = 4;
+export interface StabbleClmmBoundary {
+    arrayIndex: number;
+    offset: number;
+    tick: number;
+    sqrtPrice: bigint;
+}
+export interface StabbleClmmWindow {
+    tickArrays: [Address, Address, Address];
+    startTicks: [number, number, number];
+    boundaries: StabbleClmmBoundary[];
+    edge: {
+        tick: number;
+        sqrtPrice: bigint;
+    } | null;
+    readable: number;
+}
+export interface StabbleClmmPoolConfig extends PoolConfig {
+    venue: typeof SLUG;
+    direction: "0to1" | "1to0";
+    ammConfig: Address;
+    tokenMint0: Address;
+    tokenMint1: Address;
+    tokenVault0: Address;
+    tokenVault1: Address;
+    observation: Address;
+    bitmapExtension: Address;
+    tickSpacing: number;
+    tradeFeeRate: number;
+    liquidity: bigint;
+    sqrtPrice: bigint;
+    tickCurrentIndex: number;
+    windows: {
+        "0to1": StabbleClmmWindow;
+        "1to0": StabbleClmmWindow;
+    };
+}
+/**
+ * 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 declare function fetchStabbleClmmConfig(load: AccountLoader, pool: Address): Promise<StabbleClmmPoolConfig>;
+/** Family facade for the recipe orchestrator (ladder-only — no v1 adapter). */
+export declare const stabbleClmm: {
+    slug: string;
+    programId: Address<"6dMXqGZ3ga2dikrYS9ovDXgHGh5RUsb2RTUj6hrQXhk6">;
+    tokenProgram: Address<"TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA">;
+    token2022Program: Address<"TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb">;
+    memoProgram: Address<"MemoSq4gqABAXKb96qnH8TysNcWxMyWCqXgDLGmfcHr">;
+    fetchPoolConfig: typeof fetchStabbleClmmConfig;
+};
+export {};
+//# sourceMappingURL=index.d.ts.map

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

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