@eco-incorp/sauce 0.99.0

package/sdk/dist/svm/venues/perps-jlp/index.js

@@ -0,0 +1,430 @@
+/**
+ * Jupiter Perpetuals (JLP pool) `swap2` venue adapter — a BASKET AMM, not a
+ * per-pair pool: one global `Pool` account (name "Pool", well-known address)
+ * holds N `Custody` accounts (one per supported mint — SOL/ETH/BTC/USDC/USDT
+ * plus any later addition), and `swap2` exchanges any two custodies' tokens
+ * at the Doves-oracle price, fee-adjusted by a target-weight tax/rebate.
+ *
+ * SHAPE MISMATCH WITH THE OTHER 13 FAMILIES (read this before touching
+ * discovery wiring): every other family's `pool` account embeds BOTH mints,
+ * so one address fully identifies a tradable pair. A JLP `Custody` embeds
+ * only ONE mint — the tradable unit is an (custodyIn, custodyOut) PAIR
+ * sharing one `Pool`. `fetchPoolConfig(load, custodyIn, mintOut)` self-
+ * discovers mintIn by decoding `custodyIn` directly (never taken on faith
+ * from a caller) and needs exactly ONE extra piece of information beyond
+ * every other family's `(load, pool)` shape: `mintOut`, the ONLY thing no
+ * single account embeds. The recipe threads it as a plain `direction` STRING
+ * (mintOut's base58) — not a struct — through `entry.fetch`'s existing
+ * `(load, pool, direction?)` field type (an additive widening: the other 13
+ * families' 2-arg fetchers stay assignable, ignoring the extra argument) —
+ * see the consuming app SVM solver entry's `directionForPair` hook and its perps-jlp
+ * FAMILIES entry for how both call sites (fresh discovery AND the
+ * pre-codegen re-fetch, which only ever has `spec.direction` in scope, never
+ * the original pair) supply it identically.
+ *
+ * PDA DERIVATION (verified against real mainnet state 2026-07-31):
+ *   custody   = findProgramAddress(["custody", pool, mint], PROGRAM_ID)
+ *   perpetuals = findProgramAddress(["perpetuals"], PROGRAM_ID)
+ *   transfer_authority = findProgramAddress(["transfer_authority"], PROGRAM_ID)
+ *   __event_authority  = findProgramAddress(["__event_authority"], PROGRAM_ID)
+ * (the Solana Labs `perpetuals` program template's canonical seeds — Jupiter
+ * Perps is a fork of it). `custody` was independently re-derived from the
+ * JLP pool address + the well-known SOL mint and matched the real SOL
+ * custody address (7xS2gz2bTp3fwCC7knJvUWTEU9Tycczu6VhJYKgi1wdz) byte-for-byte;
+ * `__event_authority` matched the community-published constant
+ * (37hJBDnntwqhGbK7L6M1bLyvccj4u55CCUiLPdYkiqBN). Both `perpetuals` and
+ * `transfer_authority` were independently fetched and confirmed owned by the
+ * program (transfer_authority: 0-byte pure-signer PDA; perpetuals: 120-byte
+ * config account, discriminator 1ca762bf68526cc4).
+ *
+ * FEE MODEL — swap2 uses ONLY the target-ratio tax/rebate fee
+ * (`swapBps`/`taxBps` or the `stableSwap*` variants when BOTH custodies are
+ * stable), never the position-only price-impact-buffer/tradeImpactFeeScalar
+ * additive fee. This is the one genuinely contestable call in this adapter,
+ * so it is triple-sourced rather than assumed:
+ *   (1) official docs (developers.jup.ag/docs/perps/custody-account):
+ *       tradeImpactFeeScalar "Sets the base value when calculating price
+ *       impact fees when opening or closing POSITIONS" (positions, not swaps);
+ *   (2) the on-chain program's OWN emitted events (the live IDL's `events`,
+ *       decoded from the on-chain Anchor IDL account 2026-07-31): PoolSwapEvent
+ *       carries a single blended `feeBps` field and no price-impact
+ *       component, while IncreasePositionEvent carries BOTH `positionFeeUsd`
+ *       AND a separate `priceImpactFeeUsd` — the program itself only
+ *       computes/reports a price-impact fee for position trades;
+ *   (3) the community-maintained swap-fee reference
+ *       (github.com/julianfssen/jupiter-perps-anchor-idl-parsing,
+ *       calculate-swap-amount-and-fee.ts) implements swap fees via
+ *       `getSwapFeeBps`/`getFeeBps` (the target-ratio tax model) and never
+ *       touches `priceImpactBuffer` or `tradeImpactFeeScalar`.
+ * Implemented EXACTLY (not simplified): both custodies' theoretically-owned
+ * balances (which fold in net internal-lending debt — material for USDC,
+ * whose real `debt` was ~$112.76M against ~$133.32M owned on 2026-07-31),
+ * the rebate-vs-tax branch, and the average-diff tax formula.
+ *
+ * externalSwapFeeMultiplierBps (a 2026 Custody field absent from the
+ * community IDL snapshot and from the official docs page at the time of
+ * writing — decoded here straight from the live on-chain Anchor IDL account):
+ * observed nonzero (10000-20000, i.e. 1x-2x) on every NON-stable mainnet
+ * custody and 0 on both stable custodies. Its exact on-chain semantics are
+ * not documented publicly; this adapter is a genuine external CPI caller (an
+ * on-chain program invoking swap2 directly, not Jupiter's own front end),
+ * which is the plain-language reading the field's name suggests applies to.
+ * Treated CONSERVATIVELY: baked as the LARGER of the two sides' stored
+ * multipliers (0 defaults to 10_000 = 1x, never a discount), so an
+ * unconfirmed guess can only make the predicted quote WORSE than reality,
+ * never better — one-sided safe for minOut, matching obric-v2's documented
+ * convention for its own fee-rebate simplification.
+ *
+ * BAKE THE SHAPE, READ THE STATE (the SAME split every other oracle-anchored
+ * family in this directory uses): decimals, isStable, targetRatioBps, the
+ * pool fee bps quadruple, the externalSwapFeeMultiplier and the Doves feed
+ * exponent are governance/feed CONSTANTS (baked as cfg params); the fragment
+ * reads LIVE on-chain: both custodies' assets.{owned,locked,guaranteedUsd}
+ * (+ debt/borrowLendInterestsAccured for a STABLE side only — for a
+ * non-stable side they algebraically cancel out of `owned − locked`, so the
+ * fragment skips both reads and the ceil-division entirely), the Pool's
+ * aumUsd, and both custodies' Doves price. Byte offsets verified against the
+ * on-chain Anchor IDL (decoded 2026-07-31; PDA seeds pinned in ladder.ts) and
+ * a real mainnet dump of the JLP pool + 6 custodies (SOL/ETH/BTC/USDC/USDT +
+ * a 6th newer stable asset) — every custody's byte range past offset 1117 is
+ * all-zero padding, confirming the field table below is the complete struct.
+ *
+ * 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, getProgramDerivedAddress, getUtf8Encoder, getAddressEncoder, } from "@solana/kit";
+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 = "perps-jlp";
+export const PERPS_JLP_PROGRAM_ID = address("PERPHjGBqRHArX4DySjwM6UJHiR3sWAatqfdBS2qQJu");
+const TOKEN_PROGRAM = address("TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA");
+/** The single production JLP pool (name "Pool", 6 custodies as of 2026-07-31). */
+export const JLP_POOL_ADDRESS = address("5BUwFW4nRbftYTDMbgxykoFWqWHPzahFSNAaaaJtVKsq");
+/** sha256('account:Custody')[0..8]. */
+const CUSTODY_DISCRIMINATOR = [0x01, 0xb8, 0x30, 0x51, 0x5d, 0x83, 0x3f, 0x91];
+/** sha256('account:Pool')[0..8]. */
+const POOL_DISCRIMINATOR = [0xf1, 0x9a, 0x6d, 0x04, 0x11, 0xb1, 0x6d, 0xbc];
+/** sha256('global:swap2')[0..8]. */
+export const SWAP2_DISCRIMINATOR = [0x41, 0x4b, 0x3f, 0x4c, 0xeb, 0x5b, 0x5b, 0x88];
+/** The full occupied Custody struct length (confirmed all-zero padding past this on 6 real mainnet custodies). */
+export const CUSTODY_ACCOUNT_SIZE = 1117;
+// Custody field offsets (from the disc-inclusive account start; IDL-verified,
+// see the module doc). Fields not read at all (oracle.buffer/maxPriceAgeSec,
+// pricing.*, permissions[1..6], fundingRateState, bump*, increase/decrease
+// PositionBps, maxPositionSizeUsd, jumpRateState, borrowLendParameters,
+// borrowsFundingRateState, most withdrawal-limit fields) are omitted.
+const OFF_MINT = 40;
+const OFF_TOKEN_ACCOUNT = 72;
+const OFF_DECIMALS = 104;
+const OFF_IS_STABLE = 105;
+const OFF_ORACLE_ACCOUNT = 106; // Pythnet price account (attached to the CPI, unread for pricing — see ladder.ts doc)
+const OFF_ALLOW_SWAP = 199; // Permissions.allowSwap (first of 7 bools)
+const OFF_TARGET_RATIO_BPS = 206;
+const OFF_DOVES_ORACLE = 320;
+const OFF_EXTERNAL_SWAP_FEE_MULTIPLIER_BPS = 1076;
+// Doves `priceFeed` account (program DoVEsk76QybCEHQGzkvYPWLQu9gzNoZZZt3TPiL597e):
+// pair[32] @8, signer[33] @40, price u64 @73, expo i8 @81, timestamp i64 @82, bump u8 @90.
+export const DOVES_PRICE_OFFSET = 73;
+export const DOVES_EXPO_OFFSET = 81;
+export const DOVES_TIMESTAMP_OFFSET = 82;
+export const DOVES_FEED_SIZE = 91;
+/**
+ * A "the feed is dead, not just latent" sanity ceiling (seconds) — the
+ * real on-chain custody enforces its OWN much tighter `oracle.maxPriceAgeSec`
+ * (observed 5s on the real mainnet SOL/USDC custodies 2026-07-31) at swap2
+ * execution time; that live, on-chain check is the authoritative freshness
+ * backstop and reverts the whole cook for this slot if violated, exactly
+ * like every other venue's runtime-failure self-drop. Trying to replicate a
+ * 5s bound OFF-CHAIN at prepare time would self-drop this venue almost
+ * unconditionally (any nonzero prepare-to-cook latency exceeds it) — a
+ * "NO PREMATURE GATING" violation, not a safety measure. This constant only
+ * catches a feed that has stopped updating entirely (an abandoned/broken
+ * Doves keeper), not ordinary staleness.
+ */
+export const DOVES_MAX_AGE_SEC = 3600n;
+const codec = getAddressCodec();
+const pubkeyAt = (data, offset) => codec.decode(data.subarray(offset, offset + 32));
+/**
+ * Baked scale for `floor(c1 * c2 * 10^(e1+e2-te))` — the shared shape of
+ * every `checkedDecimalMul(c1, e1, c2, e2, te)` call this venue's math uses
+ * (both the exchange-rate conversion and every USD conversion). Because
+ * decimals/exponents are all baked (governance/feed constants), the SIGN of
+ * `targetPower` is known off-chain, so the fragment never needs a runtime
+ * branch: exactly one of `scaleUp`/`scaleDown` is ever != 1, so
+ * `floor(c1 * c2 * scaleUp / scaleDown)` reproduces the reference's two-way
+ * branch with ONE unconditional expression.
+ */
+export function bakedDecimalScale(e1, e2, targetExponent) {
+    const targetPower = e1 + e2 - targetExponent;
+    if (targetPower >= 0)
+        return { scaleUp: 10n ** BigInt(targetPower), scaleDown: 1n };
+    return { scaleUp: 1n, scaleDown: 10n ** BigInt(-targetPower) };
+}
+/** USD conversion is always scaled to -6 (USDC_DECIMALS), per the reference SDK's `getAssetAmountUsd`. */
+const USD_TARGET_EXPONENT = -6;
+/** `getSwapPrice`'s ORACLE_PRICE_SCALE / ORACLE_EXPONENT_SCALE constants. */
+const ORACLE_PRICE_SCALE = 1000000000n;
+const ORACLE_EXPONENT_SCALE = -9;
+function perpsJlpConfig(cfg) {
+    if (cfg.venue !== SLUG)
+        throw new Error(`${SLUG} adapter got a config for venue '${cfg.venue}'`);
+    return cfg;
+}
+const utf8 = getUtf8Encoder();
+const addrEnc = getAddressEncoder();
+/** `findProgramAddress(["custody", pool, mint], PERPS_JLP_PROGRAM_ID)` — verified against real SOL custody. */
+export async function custodyPda(pool, mint) {
+    return memoizedGetProgramDerivedAddress(PERPS_JLP_PROGRAM_ID, [
+        utf8.encode("custody"),
+        addrEnc.encode(pool),
+        addrEnc.encode(mint),
+    ]);
+}
+let cachedTransferAuthority;
+let cachedPerpetuals;
+let cachedEventAuthority;
+/** `findProgramAddress(["transfer_authority"], PERPS_JLP_PROGRAM_ID)` — cached (program-wide constant). */
+export async function transferAuthorityPda() {
+    if (cachedTransferAuthority !== undefined)
+        return cachedTransferAuthority;
+    const [pda] = await getProgramDerivedAddress({
+        programAddress: PERPS_JLP_PROGRAM_ID,
+        seeds: [utf8.encode("transfer_authority")],
+    });
+    cachedTransferAuthority = pda;
+    return pda;
+}
+/** `findProgramAddress(["perpetuals"], PERPS_JLP_PROGRAM_ID)` — cached (program-wide constant). */
+export async function perpetualsPda() {
+    if (cachedPerpetuals !== undefined)
+        return cachedPerpetuals;
+    const [pda] = await getProgramDerivedAddress({
+        programAddress: PERPS_JLP_PROGRAM_ID,
+        seeds: [utf8.encode("perpetuals")],
+    });
+    cachedPerpetuals = pda;
+    return pda;
+}
+/** `findProgramAddress(["__event_authority"], PERPS_JLP_PROGRAM_ID)` — matches the published constant. */
+export async function eventAuthorityPda() {
+    if (cachedEventAuthority !== undefined)
+        return cachedEventAuthority;
+    const [pda] = await getProgramDerivedAddress({
+        programAddress: PERPS_JLP_PROGRAM_ID,
+        seeds: [utf8.encode("__event_authority")],
+    });
+    cachedEventAuthority = pda;
+    return pda;
+}
+function decodeCustody(addr, data) {
+    if (data.length < CUSTODY_ACCOUNT_SIZE) {
+        throw new Error(`${SLUG} custody ${addr} is ${data.length} bytes, expected >= ${CUSTODY_ACCOUNT_SIZE}`);
+    }
+    if (!CUSTODY_DISCRIMINATOR.every((b, i) => data[i] === b)) {
+        throw new Error(`${SLUG} custody ${addr} is not a Custody account (discriminator mismatch)`);
+    }
+    return {
+        mint: pubkeyAt(data, OFF_MINT),
+        tokenAccount: pubkeyAt(data, OFF_TOKEN_ACCOUNT),
+        decimals: data[OFF_DECIMALS],
+        isStable: data[OFF_IS_STABLE] === 1,
+        pythAccount: pubkeyAt(data, OFF_ORACLE_ACCOUNT),
+        allowSwap: data[OFF_ALLOW_SWAP] === 1,
+        targetRatioBps: readUintLE(data, OFF_TARGET_RATIO_BPS, 8),
+        dovesOracle: pubkeyAt(data, OFF_DOVES_ORACLE),
+        externalSwapFeeMultiplierBps: readUintLE(data, OFF_EXTERNAL_SWAP_FEE_MULTIPLIER_BPS, 8),
+    };
+}
+/**
+ * Decode the Pool account's DYNAMIC layout: `name` (string) and `custodies`
+ * (Vec<Pubkey>) are both variable-length, so every field after them shifts
+ * with the pool's name length and custody count. Computed fresh every fetch
+ * (never hardcoded) so a future custody addition never desyncs this adapter.
+ */
+function decodePool(pool, data) {
+    if (!POOL_DISCRIMINATOR.every((b, i) => data[i] === b)) {
+        throw new Error(`${SLUG} pool ${pool} is not a Pool account (discriminator mismatch)`);
+    }
+    const nameLen = Number(readUintLE(data, 8, 4));
+    let off = 12 + nameLen;
+    const custodyCount = Number(readUintLE(data, off, 4));
+    off += 4;
+    const custodies = [];
+    for (let i = 0; i < custodyCount; i++) {
+        custodies.push(pubkeyAt(data, off + 32 * i));
+    }
+    off += 32 * custodyCount;
+    const aumUsdOffset = BigInt(off);
+    off += 16; // aumUsd: u128
+    off += 16 + 16 + 8; // Limit: maxAumUsd(u128) + tokenWeightageBufferBps(u128) + buffer(u64)
+    const feesOffset = BigInt(off);
+    const feeU64 = (k) => readUintLE(data, off + 8 * k, 8);
+    return {
+        aumUsdOffset,
+        feesOffset,
+        custodies,
+        swapMultiplier: feeU64(0),
+        stableSwapMultiplier: feeU64(1),
+        swapBps: feeU64(3),
+        taxBps: feeU64(4),
+        stableSwapBps: feeU64(5),
+        stableSwapTaxBps: feeU64(6),
+    };
+}
+/**
+ * Fetch + gate one directed (mintIn -> mintOut) JLP swap. Unlike every other
+ * family, this takes the DIRECTED PAIR (not just a pool-hint address) — see
+ * the module doc for why. `poolHint` is accepted for API symmetry with the
+ * other families' `fetch(load, pool)` shape (and sanity-asserted equal to
+ * the freshly-derived custodyIn PDA) but is not otherwise used: the pair
+ * fully determines both custody PDAs.
+ */
+/**
+ * `custodyIn` is the account to decode DIRECTLY (its `mint` field IS mintIn —
+ * self-discovered, never taken on faith from a caller) — the address-source
+ * derives it deterministically from `pair.inMint` (see ladder discovery
+ * wiring), so this function never needs the input mint as a separate
+ * argument. `mintOut` is the ONE piece of information genuinely external:
+ * a basket has no single account embedding both sides, so SOMETHING must
+ * name which of the OTHER custodies this trade targets. Both this function's
+ * callers (the discovery resolver and the pre-codegen re-fetch) have it —
+ * the former from the requested pair directly, the latter from the spec's
+ * own `direction` string (this family stores `mintOut`'s base58 there, see
+ * the consuming app SVM solver entry's FAMILIES entry) — so `fetchPoolConfig` never needs
+ * a signature wider than every other family's `(load, pool)` PLUS this one
+ * extra, always-a-plain-string `direction` parameter already threads through
+ * both call sites unchanged.
+ */
+export async function fetchPerpsJlpConfig(load, custodyIn, mintOut, now = BigInt(Math.floor(Date.now() / 1000))) {
+    const [custodyInData, transferAuthority, perpetuals, eventAuthority] = await Promise.all([
+        load(custodyIn),
+        transferAuthorityPda(),
+        perpetualsPda(),
+        eventAuthorityPda(),
+    ]);
+    if (custodyInData === null)
+        throw new Error(`${SLUG}: custody ${custodyIn} not found`);
+    const dIn = decodeCustody(custodyIn, custodyInData);
+    if (dIn.mint === mintOut)
+        throw new Error(`${SLUG}: inMint and outMint must differ`);
+    const custodyOut = await custodyPda(JLP_POOL_ADDRESS, mintOut);
+    const [poolData, custodyOutData] = await Promise.all([load(JLP_POOL_ADDRESS), load(custodyOut)]);
+    if (poolData === null)
+        throw new Error(`${SLUG}: pool ${JLP_POOL_ADDRESS} account not found`);
+    if (custodyOutData === null)
+        throw new Error(`${SLUG}: custody ${custodyOut} (mint ${mintOut}) not found — mint not in the JLP basket`);
+    const pool = decodePool(JLP_POOL_ADDRESS, poolData);
+    if (!pool.custodies.includes(custodyIn) || !pool.custodies.includes(custodyOut)) {
+        throw new Error(`${SLUG}: derived custody not present in pool ${JLP_POOL_ADDRESS}'s custodies vec`);
+    }
+    const dOut = decodeCustody(custodyOut, custodyOutData);
+    if (dOut.mint !== mintOut)
+        throw new Error(`${SLUG}: custody ${custodyOut} mint ${dOut.mint} != requested ${mintOut}`);
+    if (!dIn.allowSwap)
+        throw new Error(`${SLUG}: custody ${custodyIn} has swap disabled (Permissions.allowSwap == false)`);
+    if (!dOut.allowSwap)
+        throw new Error(`${SLUG}: custody ${custodyOut} has swap disabled (Permissions.allowSwap == false)`);
+    // Tokenkeg-only (a Token-2022 transfer-fee/extension mint would desync wire
+    // amounts — same restriction obric-v2/quantum apply to their own venues), so
+    // detect a Token-2022 or un-routable mint via the shared data-shape resolver
+    // and SELF-DROP the pair (the thrown error is the graceful-drop signal the
+    // SvmRoute orchestrator catches). The LEGACY path is byte-identical: a classic
+    // 82-byte mint classifies Tokenkeg with no extensions.
+    const [mintInData, mintOutData] = await Promise.all([load(dIn.mint), load(mintOut)]);
+    for (const [mint, mintData] of [
+        [dIn.mint, mintInData],
+        [mintOut, mintOutData],
+    ]) {
+        if (mintData === null)
+            continue; // an unreadable mint falls back to the legacy assumption
+        if (classifyMintProgram(mint, mintData) === TOKEN_2022_PROGRAM_ID) {
+            throw new Error(`${SLUG}: dropping pair ${dIn.mint}/${mintOut} — mint ${mint} is Token-2022 (swap2 is legacy-SPL only here)`);
+        }
+        const { blocking } = parseMintExtensions(mintData);
+        if (blocking.length > 0) {
+            throw new Error(`${SLUG}: dropping pair ${dIn.mint}/${mintOut} — mint ${mint} is un-routable: ${blocking.join("; ")}`);
+        }
+    }
+    const [dovesInData, dovesOutData] = await Promise.all([
+        load(dIn.dovesOracle),
+        load(dOut.dovesOracle),
+    ]);
+    if (dovesInData === null || dovesOutData === null)
+        throw new Error(`${SLUG}: Doves price feed account(s) not found`);
+    if (dovesInData.length < DOVES_FEED_SIZE || dovesOutData.length < DOVES_FEED_SIZE) {
+        throw new Error(`${SLUG}: Doves price feed account(s) undersized`);
+    }
+    const expoInRaw = dovesInData[DOVES_EXPO_OFFSET];
+    const expoOutRaw = dovesOutData[DOVES_EXPO_OFFSET];
+    const expoIn = expoInRaw >= 128 ? expoInRaw - 256 : expoInRaw; // i8
+    const expoOut = expoOutRaw >= 128 ? expoOutRaw - 256 : expoOutRaw;
+    const tsIn = readUintLE(dovesInData, DOVES_TIMESTAMP_OFFSET, 8);
+    const tsOut = readUintLE(dovesOutData, DOVES_TIMESTAMP_OFFSET, 8);
+    if (now - tsIn > DOVES_MAX_AGE_SEC || now - tsOut > DOVES_MAX_AGE_SEC) {
+        throw new Error(`${SLUG}: a Doves feed is stale (age > ${DOVES_MAX_AGE_SEC}s) for pair ${dIn.mint}/${mintOut}`);
+    }
+    const swapExponent = expoIn + ORACLE_EXPONENT_SCALE - expoOut;
+    const fx = bakedDecimalScale(-dIn.decimals, swapExponent, -dOut.decimals);
+    const usdIn = bakedDecimalScale(-dIn.decimals, expoIn, USD_TARGET_EXPONENT);
+    const usdOut = bakedDecimalScale(-dOut.decimals, expoOut, USD_TARGET_EXPONENT);
+    const isStableSwap = dIn.isStable && dOut.isStable;
+    const baseFeeBps = isStableSwap ? pool.stableSwapBps : pool.swapBps;
+    const taxFeeBps = isStableSwap ? pool.stableSwapTaxBps : pool.taxBps;
+    const multiplier = isStableSwap ? pool.stableSwapMultiplier : pool.swapMultiplier;
+    const extIn = dIn.externalSwapFeeMultiplierBps === 0n ? 10000n : dIn.externalSwapFeeMultiplierBps;
+    const extOut = dOut.externalSwapFeeMultiplierBps === 0n ? 10000n : dOut.externalSwapFeeMultiplierBps;
+    const externalMultiplierBps = extIn > extOut ? extIn : extOut;
+    return {
+        venue: SLUG,
+        pool: JLP_POOL_ADDRESS,
+        mintIn: dIn.mint,
+        mintOut,
+        custodyIn,
+        custodyOut,
+        tokenAccountIn: dIn.tokenAccount,
+        tokenAccountOut: dOut.tokenAccount,
+        dovesOracleIn: dIn.dovesOracle,
+        dovesOracleOut: dOut.dovesOracle,
+        pythAccountIn: dIn.pythAccount,
+        pythAccountOut: dOut.pythAccount,
+        tokenProgram: TOKEN_PROGRAM,
+        transferAuthority,
+        perpetuals,
+        eventAuthority,
+        decimalsIn: dIn.decimals,
+        decimalsOut: dOut.decimals,
+        fxScaleUp: fx.scaleUp,
+        fxScaleDown: fx.scaleDown,
+        usdScaleUpIn: usdIn.scaleUp,
+        usdScaleDownIn: usdIn.scaleDown,
+        usdScaleUpOut: usdOut.scaleUp,
+        usdScaleDownOut: usdOut.scaleDown,
+        isStableIn: dIn.isStable,
+        isStableOut: dOut.isStable,
+        targetRatioBpsIn: dIn.targetRatioBps,
+        targetRatioBpsOut: dOut.targetRatioBps,
+        baseFeeBps,
+        taxFeeBps,
+        multiplier,
+        externalMultiplierBps,
+        poolAumUsdOffset: pool.aumUsdOffset,
+        poolFeesOffset: pool.feesOffset,
+    };
+}
+/** Family facade for the recipe orchestrator (ladder-only — not in the v1 registry; see quantum/solfi-v2). */
+export const perpsJlp = {
+    slug: SLUG,
+    programId: PERPS_JLP_PROGRAM_ID,
+    tokenProgram: TOKEN_PROGRAM,
+    fetchPoolConfig: fetchPerpsJlpConfig,
+};
+export { perpsJlpConfig, ORACLE_PRICE_SCALE };
+//# sourceMappingURL=index.js.map

package/sdk/dist/svm/venues/perps-jlp/index.js.map

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

package/sdk/dist/svm/venues/phoenix/index.d.ts

@@ -0,0 +1,90 @@
+import type { Address } from "@solana/kit";
+import type { AccountBytesMap, AccountLoader, PoolConfig } from "../types.js";
+declare const SLUG = "phoenix";
+export declare const PHOENIX_PROGRAM_ID: Address<"PhoeNiXZ8ByJGLkxNfZRnkUfjvmuYqLR89jjFHGqdXY">;
+/** u64 LE @0 — accounts.rs `check_discriminants` asserts this exact value for MarketHeader. */
+export declare const MARKET_DISCRIMINANT = 8167313896524341111n;
+export declare const OFF_TAKER_FEE_BPS: number;
+/** Node array start of the `bids` tree — market-invariant (the allocator header is fixed size). */
+export declare const BIDS_NODES_BASE: number;
+/**
+ * Shipped top-of-book levels per direction. Half of manifest's 16 (a
+ * heavier per-level walk: two budget checks plus the fee-adjusted-budget
+ * setup) — MEASURED (not guessed): 588,522 CU @2 rungs / 831,135 CU @4
+ * rungs on the real engine against the checked-in real SOL/USDC fixture
+ * (`the consuming app cu e2e test`, `CU_FAMILIES.phoenix` in budget.ts), both
+ * comfortably under the ~1.19M admission budget with room for a companion
+ * slot. At this depth the shipped bid window alone absorbs ~713 SOL before
+ * exhausting (see `docs/phoenix-evidence.md`) — far beyond a typical trade
+ * — so 8 is not a binding liquidity constraint at this snapshot; raise it
+ * only if a future measurement shows CU headroom AND a real market where 8
+ * levels genuinely caps absorption.
+ */
+export declare const PHOENIX_MAX_ORDERS = 8;
+export interface PhoenixOrder {
+    /** 1-based sokoban node index (register value, NOT a byte offset). */
+    nodeIndex: number;
+    /** Monotonic per-order id — the drift-invariant live identity anchor. */
+    orderSequenceNumber: bigint;
+}
+export interface PhoenixWindow {
+    /** Best-first resting orders (walk order) — the taker's match sequence. */
+    orders: PhoenixOrder[];
+}
+export interface PhoenixPoolConfig extends PoolConfig {
+    venue: typeof SLUG;
+    /** 'baseIn' (default) sells base for quote (matches BIDS); 'quoteIn' buys base with quote (matches ASKS). */
+    direction: "baseIn" | "quoteIn";
+    baseMint: Address;
+    quoteMint: Address;
+    baseVault: Address;
+    quoteVault: Address;
+    baseDecimals: number;
+    quoteDecimals: number;
+    /** Atoms per base lot (immutable post-init — no admin instruction mutates it). */
+    baseLotSize: bigint;
+    /** Atoms per quote lot (immutable post-init). */
+    quoteLotSize: bigint;
+    /** Base lots per whole base unit (immutable post-init). */
+    baseLotsPerBaseUnit: bigint;
+    /** Quote lots per base unit per tick (immutable post-init). */
+    tickSizeInQuoteLotsPerBaseUnit: bigint;
+    /** Node array start of the `asks` tree — per-market (depends on `bids_size`). */
+    asksNodesBase: number;
+    /** Direction-keyed prepare-declared order windows (see the header). */
+    windows: {
+        baseIn: PhoenixWindow;
+        quoteIn: PhoenixWindow;
+    };
+}
+/** The direction's window (the ladder adapter and the orchestrator gate read through this). */
+export declare function phoenixWindowFor(cfg: PhoenixPoolConfig): PhoenixWindow;
+/**
+ * Fetch + gate one Phoenix market (account size/discriminant, classic-SPL
+ * mints — the Swap ix has no separate mint accounts, so it is Tokenkeg-only,
+ * mirroring manifest's identical gate) and freeze both directions' top-of-book
+ * order windows. Read-only against the loader.
+ */
+export declare function fetchPhoenixConfig(load: AccountLoader, pool: Address): Promise<PhoenixPoolConfig>;
+/** Family facade for the recipe orchestrator (ladder-only — no v1 adapter). */
+export declare const phoenix: {
+    slug: string;
+    programId: Address<"PhoeNiXZ8ByJGLkxNfZRnkUfjvmuYqLR89jjFHGqdXY">;
+    tokenProgram: Address<"TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA">;
+    fetchPoolConfig: typeof fetchPhoenixConfig;
+};
+/**
+ * Exact mirror of the emitted fragment given the SAME cfg + params + live fee
+ * the blob was prepared with. `readFee` supplies `taker_fee_bps` from the SAME
+ * live account bytes (the fragment reads it live too — see the module header).
+ */
+export declare function referenceQuote(base: PoolConfig, state: AccountBytesMap, params: readonly bigint[]): (x: bigint) => bigint;
+/** Pointwise mirror of the emitted `lx` capacity booking — the productive gross input consumed. */
+export declare function referenceCapacities(base: PoolConfig, state: AccountBytesMap, params: readonly bigint[]): (grid: readonly bigint[]) => bigint[];
+/** Depth for the relative filter: the shipped top-of-book aggregate (atoms). */
+export declare function depthReserves(base: PoolConfig, state: AccountBytesMap): {
+    reserveIn: bigint;
+    reserveOut: bigint;
+};
+export {};
+//# sourceMappingURL=index.d.ts.map

package/sdk/dist/svm/venues/phoenix/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/svm/venues/phoenix/index.ts"],"names":[],"mappings":"AA8MA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAM9E,QAAA,MAAM,IAAI,YAAY,CAAC;AAEvB,eAAO,MAAM,kBAAkB,wDAAyD,CAAC;AAKzF,+FAA+F;AAC/F,eAAO,MAAM,mBAAmB,uBAA6B,CAAC;AAiB9D,eAAO,MAAM,iBAAiB,QAAmB,CAAC;AAElD,mGAAmG;AACnG,eAAO,MAAM,eAAe,QAAsB,CAAC;AAanD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,kBAAkB,IAAI,CAAC;AACpC,MAAM,WAAW,YAAY;IAC3B,sEAAsE;IACtE,SAAS,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,2EAA2E;IAC3E,MAAM,EAAE,YAAY,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,iBAAkB,SAAQ,UAAU;IACnD,KAAK,EAAE,OAAO,IAAI,CAAC;IACnB,6GAA6G;IAC7G,SAAS,EAAE,QAAQ,GAAG,SAAS,CAAC;IAChC,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,kFAAkF;IAClF,WAAW,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,YAAY,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,mBAAmB,EAAE,MAAM,CAAC;IAC5B,+DAA+D;IAC/D,8BAA8B,EAAE,MAAM,CAAC;IACvC,iFAAiF;IACjF,aAAa,EAAE,MAAM,CAAC;IACtB,uEAAuE;IACvE,OAAO,EAAE;QAAE,MAAM,EAAE,aAAa,CAAC;QAAC,OAAO,EAAE,aAAa,CAAA;KAAE,CAAC;CAC5D;AAED,+FAA+F;AAC/F,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,iBAAiB,GAAG,aAAa,CAEtE;AAgGD;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,aAAa,EACnB,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,iBAAiB,CAAC,CAsF5B;AA4BD,+EAA+E;AAC/E,eAAO,MAAM,OAAO;;;;;CAKnB,CAAC;AAiEF;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,eAAe,EACtB,MAAM,EAAE,SAAS,MAAM,EAAE,GACxB,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CA2CvB;AAED,mGAAmG;AACnG,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,eAAe,EACtB,MAAM,EAAE,SAAS,MAAM,EAAE,GACxB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,KAAK,MAAM,EAAE,CAwCvC;AAED,gFAAgF;AAChF,wBAAgB,aAAa,CAC3B,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,eAAe,GACrB;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAsB3C"}