@eco-incorp/sauce 0.99.0

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

@@ -0,0 +1,322 @@
+/**
+ * PancakeSwap (Solana 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 (PancakeSwap's Solana CLMM program is a verbatim fork
+ * of Raydium's `raydium-clmm` at the account/instruction level — GROUND-
+ * TRUTHED, not assumed, against real mainnet state 2026-07-31):
+ *   - pool account `DJNtGuBGEQiUCWE8F981M2C3ZghZt2XLD8f2sQdZ6rsZ` (SOL/USDC,
+ *     tickSpacing 10, live liquidity ~4.96e13): 1544 bytes, discriminator
+ *     f7 ed e3 f5 d7 c3 de 46, 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);
+ *   - its AmmConfig (117 bytes, disc da f4 21 68 cb cb 2b 6f) 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 tick-array addresses a real
+ *     PancakeSwap router transaction referenced on-chain for this pool
+ *     (signature 3Uz45LyKjerW9AuU5A7XQ3zmPmh8o7bSd3ZitgDHN3kPsy9bU5dsJtuWtz6U1Dqb8wjJQqjyZmrCyQ4yeoU3m3kV,
+ *     inner instruction targeting HpNfyc2Saw7RKkQd8nEL4khUcuPhQ7WwY1B2qjx8jxFq)
+ *     — the SAME `pool_tick_array_bitmap_extension` seed too;
+ *   - the swap instruction is Anchor `swap_v2` (log line "Instruction:
+ *     SwapV2"; discriminator sha256('global:swap_v2')[0..8] =
+ *     43 04 ed 0b 1a c9 1e 62, a pure function of the instruction NAME, so
+ *     necessarily identical for any Anchor program naming it the same) with
+ *     the IDENTICAL 41-byte layout (disc ++ amount u64 LE ++
+ *     other_amount_threshold u64 LE ++ sqrt_price_limit_x64 u128 LE ++
+ *     is_base_input u8) and the IDENTICAL 17-account order (payer, ammConfig,
+ *     pool, inputTokenAccount, outputTokenAccount, inputVault, outputVault,
+ *     observationState, tokenProgram, token2022Program, memoProgram,
+ *     inputVaultMint, outputVaultMint, bitmapExtension, ta0, ta1, ta2) —
+ *     confirmed against that same real transaction's inner-instruction data.
+ *
+ * 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 { TOKEN_2022_PROGRAM_ID, classifyMintProgram } from "../../token-program.js";
+import { parseMintExtensions } from "../../token-extensions.js";
+import { memoizedGetProgramDerivedAddress } from "../pda-memo.js";
+const SLUG = "pancakeswap-clmm";
+/** PancakeSwap's Solana CLMM program (a Raydium-CLMM-shaped Anchor fork). */
+export const PANCAKESWAP_CLMM_PROGRAM_ID = address("HpNfyc2Saw7RKkQd8nEL4khUcuPhQ7WwY1B2qjx8jxFq");
+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 PANCAKESWAP_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(PANCAKESWAP_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))));
+    // Batch the whole window into ONE coalesced round instead of an outward
+    // serial walk (identical rationale to raydium-clmm's resolveWindow): the
+    // tick-array PDAs are all derived above, so nothing here depends on a prior
+    // array's bytes. allSettled preserves the break-on-first-invalid contract
+    // exactly — a rejection is re-thrown only if the readable prefix reaches it,
+    // and a miss/rejection past the break degrades to the same readable prefix.
+    const loaded = await Promise.allSettled(tickArrays.map((addr) => load(addr)));
+    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 === PANCAKESWAP_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 PancakeSwap CLMM pool (see the header for the gate list)
+ * and freeze both directions' boundary windows. Read-only against the loader.
+ */
+export async function fetchPancakeswapClmmConfig(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 mi = 0; mi < mints.length; mi++) {
+        const mint = mints[mi];
+        const mintData = mintDatas[mi];
+        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(PANCAKESWAP_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 pancakeswapClmm = {
+    slug: SLUG,
+    programId: PANCAKESWAP_CLMM_PROGRAM_ID,
+    tokenProgram: TOKEN_PROGRAM,
+    token2022Program: TOKEN_2022_PROGRAM,
+    memoProgram: MEMO_PROGRAM,
+    fetchPoolConfig: fetchPancakeswapClmmConfig,
+};
+//# sourceMappingURL=index.js.map

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

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

package/sdk/dist/svm/venues/pda-memo.d.ts

@@ -0,0 +1,82 @@
+import type { Address } from "@solana/kit";
+export interface PdaMemoStats {
+    hits: number;
+    misses: number;
+}
+/**
+ * Default belt-and-suspenders cap on the memo's size — the real steady-state
+ * population is a small, bounded set of distinct (program, pool, window)
+ * tick-array/bin-array keys plus one oracle/bitmap/tick-array-map key per
+ * pool (tens of entries per actively-traded pool, across all eleven
+ * families), so this ceiling is never expected to bind in practice. A
+ * consumer running an unusually large pool universe can raise it via
+ * {@link configurePdaMemo}.
+ */
+export declare const DEFAULT_PDA_MEMO_MAX_ENTRIES = 100000;
+/**
+ * Memoized `getProgramDerivedAddress`. The cache key is derived internally
+ * from `(programAddress, seeds)` (see {@link memoKey}) — callers never
+ * supply or influence it, so this is a drop-in replacement for the inline
+ * `const [pda] = await getProgramDerivedAddress({ programAddress, seeds })`
+ * pattern: same two logical inputs, same resolved `Address` out.
+ *
+ * Evicts the least-recently-used entry once the memo exceeds
+ * {@link MAX_ENTRIES} (a `Map` re-inserted on every hit iterates in
+ * least-recently-used-first order, so the first key is always the eviction
+ * candidate).
+ */
+export declare function memoizedGetProgramDerivedAddress(programAddress: Address, seeds: readonly Uint8Array[]): Promise<Address>;
+/** Seeds for {@link memoizedFindAssociatedTokenPda} — the same shape `@solana-program/token`'s `findAssociatedTokenPda` takes (`tokenProgram` is part of the ATA seeds, so it is required just as it is there). */
+export interface AssociatedTokenSeeds {
+    owner: Address;
+    mint: Address;
+    tokenProgram: Address;
+}
+/**
+ * Memoized associated-token-account address — the drop-in, memoized twin of
+ * `@solana-program/token`'s `findAssociatedTokenPda`. BYTE-IDENTICAL to it: the
+ * same Associated-Token program id and the same `[owner, tokenProgram, mint]`
+ * seed order (`findAssociatedTokenPda`'s own definition), so it resolves to the
+ * exact same address — but through {@link memoizedGetProgramDerivedAddress}, so
+ * a repeated warm derive of the same ATA is a memo hit instead of a fresh
+ * SHA-256 bump-walk + ed25519 on-curve check. `findAssociatedTokenPda` is a
+ * distinct code path from the raw `getProgramDerivedAddress` calls this module's
+ * venues also route, so it needs its own memoized entry point to stop bypassing
+ * the memo. Returns the address only — the bump `findAssociatedTokenPda` also
+ * returns is unused at every venue call site this replaces (all destructure
+ * `const [ata] = …`).
+ */
+export declare function memoizedFindAssociatedTokenPda(seeds: AssociatedTokenSeeds): Promise<Address>;
+/** TEST/OBSERVABILITY SEAM: cumulative hit/miss counts since process start or the last reset. */
+export declare function __pdaMemoStats(): PdaMemoStats;
+/** TEST SEAM: current entry count, for asserting LRU eviction. */
+export declare function __pdaMemoSize(): number;
+/** Options for {@link configurePdaMemo}. */
+export interface PdaMemoConfig {
+    /**
+     * Maximum number of `(programAddress, seeds) -> address` entries the memo
+     * retains before evicting the least-recently-used one. Must be a positive
+     * integer. Defaults to {@link DEFAULT_PDA_MEMO_MAX_ENTRIES} (100 000).
+     */
+    maxEntries: number;
+}
+/**
+ * Tune the process-wide PDA-derivation memo. Call once at startup — the memo is
+ * a single process-lifetime cache shared across every CLMM/DLMM venue family,
+ * so this is global configuration, not per-call.
+ *
+ * A consumer whose pool universe is large enough to approach the default 100 000
+ * ceiling (each entry is one small `(program, pool, window)`-shaped key) can
+ * raise `maxEntries` to keep more derivations warm. Raising it is cheap — the
+ * memo only grows as far as real derivations demand. LOWERING it below the
+ * current population evicts the oldest entries eagerly to honor the new bound
+ * immediately (correct addresses always re-derive on the next miss).
+ *
+ * @throws if `maxEntries` is not a positive integer.
+ */
+export declare function configurePdaMemo(config: PdaMemoConfig): void;
+/** The memo's current maximum-entry cap (default {@link DEFAULT_PDA_MEMO_MAX_ENTRIES}). */
+export declare function getPdaMemoMaxEntries(): number;
+/** TEST SEAM: drop the memo, zero the counters, and restore the default cap. */
+export declare function __resetPdaMemoForTest(): void;
+//# sourceMappingURL=pda-memo.d.ts.map

package/sdk/dist/svm/venues/pda-memo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pda-memo.d.ts","sourceRoot":"","sources":["../../../src/svm/venues/pda-memo.ts"],"names":[],"mappings":"AAwCA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAG3C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,4BAA4B,SAAU,CAAC;AAmCpD;;;;;;;;;;;GAWG;AACH,wBAAsB,gCAAgC,CACpD,cAAc,EAAE,OAAO,EACvB,KAAK,EAAE,SAAS,UAAU,EAAE,GAC3B,OAAO,CAAC,OAAO,CAAC,CAuBlB;AAED,mNAAmN;AACnN,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,8BAA8B,CAClD,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,OAAO,CAAC,CAOlB;AAED,iGAAiG;AACjG,wBAAgB,cAAc,IAAI,YAAY,CAE7C;AAED,kEAAkE;AAClE,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,4CAA4C;AAC5C,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAa5D;AAED,2FAA2F;AAC3F,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED,gFAAgF;AAChF,wBAAgB,qBAAqB,IAAI,IAAI,CAK5C"}

package/sdk/dist/svm/venues/pda-memo.js

@@ -0,0 +1,189 @@
+/**
+ * Process-lifetime memo of Solana Program Derived Address DERIVATION ONLY —
+ * (programAddress, seeds) -> address. NEVER a cache of account STATE.
+ *
+ * WHY THIS IS SAFE: a PDA is a mathematical constant of its (programAddress,
+ * seeds) tuple — `getProgramDerivedAddress` (@solana/kit / @solana/addresses)
+ * is a PURE function: same inputs always produce the same address + bump,
+ * forever, for a given program. Caching that computation carries zero
+ * staleness risk because there is no "live" version of a derivation to go
+ * stale against. Every consumer of a memoized address still re-reads the
+ * ACCOUNT's live bytes (liquidity, sqrtPrice, tick-array bytes, the
+ * initialized flag, …) via its own `AccountLoader` on every call — this
+ * module never touches account data and is never itself a state read. A
+ * window-dependent seed (a tick-array/bin-array start index) is derived from
+ * the pool's LIVE spot on every call, so when the spot moves and the window
+ * shifts, the seed — and therefore the memo key — changes: a shifted window
+ * always produces a fresh miss and the correct new address, never a stale hit.
+ *
+ * VALUE — CPU/throughput, not single-quote latency. `getProgramDerivedAddress`
+ * is CPU-bound: it walks bump seeds 255→0 hashing SHA-256 over the seed bytes
+ * and does a synchronous on-curve check (a bigint mulmod ladder,
+ * `pow_2_252_3` in `@solana/addresses`) on the MAIN, SINGLE event-loop
+ * thread. Under N concurrent warm quotes those checks fully serialize —
+ * memoizing frees main-thread CPU proportional to N and raises the QPS a pod
+ * sustains before the event loop saturates; it does not shorten one isolated
+ * quote's own wall-clock time (which is network-bound on RPC round-trips).
+ *
+ * SCOPE — derivation memoized, addresses ONLY, across every CLMM/DLMM family
+ * that routes its tick-array/bin-array/per-tick PDA derivation through
+ * {@link memoizedGetProgramDerivedAddress} below (raydium-clmm, orca-whirlpool,
+ * pancakeswap-clmm, stabble-clmm, cropper, byreal, defituna, crema, invariant,
+ * meteora-dlmm, saros-dlmm). The memo key is derived INTERNALLY from
+ * `(programAddress, seeds)` — never supplied by the caller — so two families
+ * that happen to share an identical seed SHAPE (e.g. pancakeswap-clmm/
+ * stabble-clmm/byreal reuse raydium-clmm's `['tick_array', pool, startTick
+ * BE i32]` shape; cropper/defituna reuse orca-whirlpool's ASCII-encoded
+ * shape) under DISTINCT program ids can never collide: the program id is
+ * part of the key by construction, not by caller discipline.
+ */
+import { getAddressEncoder, getProgramDerivedAddress } from "@solana/kit";
+import { ASSOCIATED_TOKEN_PROGRAM_ADDRESS } from "@solana-program/token";
+/**
+ * Default belt-and-suspenders cap on the memo's size — the real steady-state
+ * population is a small, bounded set of distinct (program, pool, window)
+ * tick-array/bin-array keys plus one oracle/bitmap/tick-array-map key per
+ * pool (tens of entries per actively-traded pool, across all eleven
+ * families), so this ceiling is never expected to bind in practice. A
+ * consumer running an unusually large pool universe can raise it via
+ * {@link configurePdaMemo}.
+ */
+export const DEFAULT_PDA_MEMO_MAX_ENTRIES = 100_000;
+let maxEntries = DEFAULT_PDA_MEMO_MAX_ENTRIES;
+const memo = new Map();
+let hits = 0;
+let misses = 0;
+const HEX_TABLE = Array.from({ length: 256 }, (_, i) => i.toString(16).padStart(2, "0"));
+function toHex(bytes) {
+    let out = "";
+    for (let i = 0; i < bytes.length; i++)
+        out += HEX_TABLE[bytes[i]];
+    return out;
+}
+/**
+ * Derive the memo key from the EXACT tuple being derived: the program address
+ * plus every seed, each seed hex-encoded and joined with a `|` separator.
+ * Every seed is a `Uint8Array` (the type below enforces it — no `string`
+ * overload), so the key is provably 1:1 with `(programAddress, seeds)`: hex
+ * never emits `|`, so the separator unambiguously delimits seed boundaries
+ * (`[[0x01],[0x02]]` → `01|02` can never equal `[[0x01,0x02]]` → `0102`), and
+ * there is no string/byte domain to alias (`"ab"` vs `[0xab]` cannot both
+ * occur). No caller ever supplies or influences the key, so no venue can
+ * accidentally alias another venue's cached address.
+ */
+function memoKey(programAddress, seeds) {
+    let key = programAddress;
+    for (const seed of seeds) {
+        key += "|";
+        key += toHex(seed);
+    }
+    return key;
+}
+/**
+ * Memoized `getProgramDerivedAddress`. The cache key is derived internally
+ * from `(programAddress, seeds)` (see {@link memoKey}) — callers never
+ * supply or influence it, so this is a drop-in replacement for the inline
+ * `const [pda] = await getProgramDerivedAddress({ programAddress, seeds })`
+ * pattern: same two logical inputs, same resolved `Address` out.
+ *
+ * Evicts the least-recently-used entry once the memo exceeds
+ * {@link MAX_ENTRIES} (a `Map` re-inserted on every hit iterates in
+ * least-recently-used-first order, so the first key is always the eviction
+ * candidate).
+ */
+export async function memoizedGetProgramDerivedAddress(programAddress, seeds) {
+    const key = memoKey(programAddress, seeds);
+    const cached = memo.get(key);
+    if (cached !== undefined) {
+        hits += 1;
+        // Refresh recency: delete + re-set moves this key to the END of the
+        // Map's iteration order, so eviction below always removes the entry that
+        // has gone longest without a hit.
+        memo.delete(key);
+        memo.set(key, cached);
+        return cached;
+    }
+    misses += 1;
+    const [derived] = await getProgramDerivedAddress({
+        programAddress,
+        seeds: seeds,
+    });
+    if (memo.size >= maxEntries) {
+        const oldest = memo.keys().next().value;
+        if (oldest !== undefined)
+            memo.delete(oldest);
+    }
+    memo.set(key, derived);
+    return derived;
+}
+/**
+ * Memoized associated-token-account address — the drop-in, memoized twin of
+ * `@solana-program/token`'s `findAssociatedTokenPda`. BYTE-IDENTICAL to it: the
+ * same Associated-Token program id and the same `[owner, tokenProgram, mint]`
+ * seed order (`findAssociatedTokenPda`'s own definition), so it resolves to the
+ * exact same address — but through {@link memoizedGetProgramDerivedAddress}, so
+ * a repeated warm derive of the same ATA is a memo hit instead of a fresh
+ * SHA-256 bump-walk + ed25519 on-curve check. `findAssociatedTokenPda` is a
+ * distinct code path from the raw `getProgramDerivedAddress` calls this module's
+ * venues also route, so it needs its own memoized entry point to stop bypassing
+ * the memo. Returns the address only — the bump `findAssociatedTokenPda` also
+ * returns is unused at every venue call site this replaces (all destructure
+ * `const [ata] = …`).
+ */
+export async function memoizedFindAssociatedTokenPda(seeds) {
+    const encoder = getAddressEncoder();
+    return memoizedGetProgramDerivedAddress(ASSOCIATED_TOKEN_PROGRAM_ADDRESS, [
+        encoder.encode(seeds.owner),
+        encoder.encode(seeds.tokenProgram),
+        encoder.encode(seeds.mint),
+    ]);
+}
+/** TEST/OBSERVABILITY SEAM: cumulative hit/miss counts since process start or the last reset. */
+export function __pdaMemoStats() {
+    return { hits, misses };
+}
+/** TEST SEAM: current entry count, for asserting LRU eviction. */
+export function __pdaMemoSize() {
+    return memo.size;
+}
+/**
+ * Tune the process-wide PDA-derivation memo. Call once at startup — the memo is
+ * a single process-lifetime cache shared across every CLMM/DLMM venue family,
+ * so this is global configuration, not per-call.
+ *
+ * A consumer whose pool universe is large enough to approach the default 100 000
+ * ceiling (each entry is one small `(program, pool, window)`-shaped key) can
+ * raise `maxEntries` to keep more derivations warm. Raising it is cheap — the
+ * memo only grows as far as real derivations demand. LOWERING it below the
+ * current population evicts the oldest entries eagerly to honor the new bound
+ * immediately (correct addresses always re-derive on the next miss).
+ *
+ * @throws if `maxEntries` is not a positive integer.
+ */
+export function configurePdaMemo(config) {
+    const next = config.maxEntries;
+    if (!Number.isInteger(next) || next < 1) {
+        throw new Error(`configurePdaMemo: maxEntries must be a positive integer, got ${String(next)}`);
+    }
+    maxEntries = next;
+    // Honor a lowered cap immediately rather than waiting for the next miss to
+    // drain one entry at a time. Map iteration is least-recently-used-first.
+    while (memo.size > maxEntries) {
+        const oldest = memo.keys().next().value;
+        if (oldest === undefined)
+            break;
+        memo.delete(oldest);
+    }
+}
+/** The memo's current maximum-entry cap (default {@link DEFAULT_PDA_MEMO_MAX_ENTRIES}). */
+export function getPdaMemoMaxEntries() {
+    return maxEntries;
+}
+/** TEST SEAM: drop the memo, zero the counters, and restore the default cap. */
+export function __resetPdaMemoForTest() {
+    memo.clear();
+    hits = 0;
+    misses = 0;
+    maxEntries = DEFAULT_PDA_MEMO_MAX_ENTRIES;
+}
+//# sourceMappingURL=pda-memo.js.map

package/sdk/dist/svm/venues/pda-memo.js.map

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