@eco-incorp/sauce 0.99.0

package/sdk/dist/svm/venues/omnipair/index.js

@@ -0,0 +1,242 @@
+/**
+ * Omnipair — an oracle-less spot + margin money-market protocol on Solana
+ * (program `omnixgS8fnqHfCcTGKWj6JtKjzpJZ1Y5y9pyFkQDkYE`; on-chain Anchor IDL
+ * confirmed at 13,682 bytes, source cross-checked against the public
+ * `omnipair/omnipair-rs` repo — `programs/omnipair/src/instructions/spot/swap.rs`
+ * + `state/pair.rs` + `utils/gamm_math.rs`). Each `Pair` is a constant-product
+ * AMM (`reserve0 * reserve1 = k`) whose reserves are LENDING-AWARE:
+ * `reserve{0,1}` are VIRTUAL (curve) reserves that include whatever has been
+ * borrowed out, while `cash_reserve{0,1}` are the actual liquid vault balance
+ * (`reserve = cash + debt`). A swap prices off the virtual reserves but can
+ * only ever DELIVER out of the cash reserve — `swap.rs`'s
+ * `require_gte!(pair.cash_reserveX, amount_out)` — so this ladder quotes from
+ * `(reserve0, reserve1)` and separately CAPS gross input so the predicted
+ * output never exceeds the live `cash_reserve` of the output side (see
+ * CAPACITY below).
+ *
+ * ACCOUNT LAYOUT (Borsh-packed, no padding; ALL 98 live mainnet pairs sampled
+ * at integration time cross-checked byte-for-byte against the IDL's `Pair`
+ * struct): disc(8) sha256('account:Pair')[0..8] = 55 48 31 b0 b6 e4 8d 52,
+ * token0@8/token1@40/lp_mint@72/rate_model@104 (pubkeys), swap_fee_bps@136
+ * (u16), half_life@138 (u64), THEN `fixed_cf_bps: Option<u16>` — Borsh
+ * serializes this VARIABLE-LENGTH (1-byte tag, +2 more only if Some), so
+ * every field after it sits at one of exactly two offsets depending on the
+ * tag byte at 146: reserve0 starts at 147 (tag 0, None) or 149 (tag 1, Some).
+ * This is an IMMUTABLE per-pair constant (no instruction in the IDL ever
+ * flips `fixed_cf_bps` post-`initialize`), so it is baked as a compile-time
+ * literal (`reserveBase`) and folded into the shape key — never re-derived
+ * live. From `reserveBase`: reserve0/reserve1/cash_reserve0/cash_reserve1
+ * (u64 x4, contiguous), then EMAs/rates/debt/etc (unused by this ladder),
+ * token0_decimals/token1_decimals at `reserveBase+160/161`, ending with
+ * `reduce_only` at `reserveBase+200` — total account size 350 bytes either
+ * way (2 trailing unused bytes in the None case; `#[derive(InitSpace)]`
+ * allocates the worst case up front), matching all 98 sampled mainnet pairs.
+ *
+ * QUOTE MATH (transcribed from `swap.rs`'s `handle_swap` + `gamm_math.rs`'s
+ * `CPCurve::calculate_amount_out`, VALIDATED — see below):
+ *   swap_fee = ceil(amountIn * swapFeeBps / 10000)
+ *   netIn    = amountIn - swap_fee
+ *   amountOut = floor(netIn * reserveOut / (reserveIn + netIn))
+ * `netIn` has the closed-form IDENTITY `floor(x*(D-feeBps)/D) === x -
+ * ceil(x*feeBps/D)` for D=10000 (proved by construction: ceil(a) = -floor(-a),
+ * so x - ceil(xb/D) = x + floor(-xb/D) = floor(x - xb/D) = floor(x(D-b)/D) for
+ * integer x) — used directly rather than emulating ceil, which the DSL has no
+ * primitive for. The `futarchy_authority.revenue_share.swap_bps` split changes
+ * only how the swap_fee is BOOKED between LPs/protocol (`amount_in_with_lp_fee`
+ * feeds `new_reserve_in`), never `amount_out` — so this ladder does not read
+ * futarchy_authority's content at all, only attaches its (fixed, PDA-derived)
+ * address to the swap CPI, which requires it structurally.
+ *
+ * CAPACITY (closed form, the SAME "saturate past capacity, don't collapse"
+ * class this codebase's other capacity-aware ladders — orca-whirlpool/
+ * raydium-clmm/meteora-dlmm/manifest/meteora-damm-v2/obric-v2 — already fixed
+ * for their own venues): amountOut(x) = reserveOut - floor(kq/(reserveIn +
+ * netIn(x))) with kq = reserveIn*reserveOut (the SAME hyperbola shape as
+ * obric-v2's oracle-anchored curve, just with kq the plain reserve product
+ * instead of an oracle-derived one). amountOut(x) <= cashOut is trivial
+ * (uncapped, U64_MAX sentinel) whenever `reserveOut <= cashOut`. Otherwise,
+ * with `target = reserveOut - cashOut > 0`: solve for the max `netIn` with
+ * `floor(kq/(reserveIn+netIn)) >= target`, i.e. `netInMax = floor(kq/target) -
+ * reserveIn` (clamped to >= 0 — the obric-v2 derivation verbatim, since the
+ * two curves share the exact `cOut - kq/(cIn+x)` shape). Converting the netIn
+ * cap back to a GROSS input cap needs one more inversion because netIn(x) is
+ * itself a floor: `floor(x*m/D) <= T  <=>  x <= floor(((T+1)*D-1)/m)` with
+ * `m = D-feeBps` (verified against hand-checked boundary cases — x=xCap
+ * satisfies the bound, x=xCap+1 does not, for several (T, feeBps) pairs).
+ * A merge-decomposition ladder folds this into its rung capacities; the
+ * ladders themselves now live in the consuming recipes package, so only the
+ * decode/derivation above is this module's concern.
+ *
+ * REDUCE_ONLY: `Pair.reduce_only` ("blocks borrowing and adding liquidity for
+ * this pair", per its own doc comment) and `FutarchyAuthority.global_reduce_only`
+ * are NOT checked anywhere in `swap.rs`/`Swap::validate`/`Swap::handle_swap` —
+ * confirmed by reading the instruction source directly. Swaps are UNAFFECTED
+ * by either flag; this ladder does not gate on them (an earlier integration
+ * plan assumed otherwise — that assumption is corrected here against the
+ * actual source, not the doc comment's English description).
+ *
+ * INTEREST ACCRUAL (disclosed, measured, minOut-backstopped — NOT modeled):
+ * every swap first calls `Pair::update()`, which — IF any slot has elapsed
+ * since `last_update` (a SLOT number, not unix time) — accrues interest onto
+ * `total_debt{0,1}` via a Taylor-series exponential rate-model integral and
+ * adds the LP-owed portion straight onto `reserve{0,1}` (see `pair.rs`'s
+ * `update()`). This ladder reads `reserve0/reserve1` RAW (no accrual replay:
+ * the rate-model integral needs a fixed-point Taylor exp with no cheap
+ * closed form, and the shift is exactly the same *class* of drift every other
+ * time-dependent venue in this codebase (locked-profit decay, amp ramps)
+ * already carries, backstopped by `minOut`, not a per-venue quote guarantee).
+ * MEASURED size, via `view_pair_data`'s `SwapQuote` getter (which itself DOES
+ * replay the accrual, so its `simulateTransaction` answer is true
+ * post-accrual ground truth) against real mainnet pair
+ * `Cp2nGCWWfqkUmPR3pPKoR376Fti8wuYRFrSWJZq1a9SA` (token0
+ * `METAwkXcqyXKy1AtsSgJ8JiUHwGCafnZL38n3vYmeta` / token1 USDC): at a 23-slot
+ * gap (~9.2s) the raw-reserve quote and SwapQuote's post-accrual answer agree
+ * BIT-EXACT at the smallest tested size and within single-digit-to-tens of
+ * raw units (relative error ~1.2e-9) at 5,000/30,000 USDC and 1,000/13,000
+ * token0 — at a 679-slot gap (~4.5 min) the same comparison widens to
+ * ~3.5e-8 relative, consistent with linear-in-time accrual. Both residuals
+ * are many orders of magnitude below the `minOut` floor any real caller sets.
+ *
+ * Gates (fetchPoolConfig, all recoverable/self-drop classes): wrong size/
+ * discriminator; either mint not a classic 82-byte Tokenkeg mint (Token-2022
+ * transfer-fee/extension mints are out of scope, same restriction as
+ * defituna/raydium-cp-swap's classic-SPL-only swap path); an uninitialized
+ * pair (`reserve0 === 0 || reserve1 === 0`, mirroring `Pair::is_initialized`);
+ * a degenerate `swap_fee_bps >= 10000`.
+ */
+import { address, getAddressCodec } from "@solana/kit";
+import { memoizedGetProgramDerivedAddress } from "../pda-memo.js";
+import { readUintLE } from "../math.js";
+import { TOKEN_2022_PROGRAM_ID, classifyMintProgram } from "../../token-program.js";
+import { parseMintExtensions } from "../../token-extensions.js";
+const SLUG = "omnipair";
+export const OMNIPAIR_PROGRAM_ID = address("omnixgS8fnqHfCcTGKWj6JtKjzpJZ1Y5y9pyFkQDkYE");
+const TOKEN_PROGRAM = address("TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA");
+export const PAIR_ACCOUNT_SIZE = 350;
+/** sha256('account:Pair')[0..8]. */
+export const PAIR_DISCRIMINATOR = [0x55, 0x48, 0x31, 0xb0, 0xb6, 0xe4, 0x8d, 0x52];
+const OFF_TOKEN0 = 8;
+const OFF_TOKEN1 = 40;
+const OFF_RATE_MODEL = 104;
+const OFF_SWAP_FEE_BPS = 136;
+/** The fixed_cf_bps Option<u16> discriminant byte — decides reserveBase (147 vs 149). */
+const OFF_OPTION_TAG = 146;
+const FEE_D = 10000n;
+const U64_MAX = (1n << 64n) - 1n;
+function hasDiscriminator(data, discriminator) {
+    return discriminator.every((byte, i) => data[i] === byte);
+}
+function getAddressEncoded(value) {
+    return new Uint8Array(getAddressCodec().encode(value));
+}
+async function derivePda(seeds) {
+    return memoizedGetProgramDerivedAddress(OMNIPAIR_PROGRAM_ID, seeds);
+}
+/** Fetch + decode one Pair, deriving the fixed accounts the swap CPI needs. Read-only against the loader. */
+export async function fetchOmnipairPoolConfig(load, pool) {
+    const data = await load(pool);
+    if (data === null)
+        throw new Error(`${SLUG}: pair account ${pool} not found`);
+    if (data.length !== PAIR_ACCOUNT_SIZE) {
+        throw new Error(`${SLUG}: pair ${pool} has ${data.length} bytes, expected ${PAIR_ACCOUNT_SIZE}`);
+    }
+    if (!hasDiscriminator(data, PAIR_DISCRIMINATOR)) {
+        throw new Error(`${SLUG}: pair ${pool} has a foreign discriminator (not a Pair account)`);
+    }
+    const codec = getAddressCodec();
+    const token0Mint = codec.decode(data.subarray(OFF_TOKEN0, OFF_TOKEN0 + 32));
+    const token1Mint = codec.decode(data.subarray(OFF_TOKEN1, OFF_TOKEN1 + 32));
+    const rateModel = codec.decode(data.subarray(OFF_RATE_MODEL, OFF_RATE_MODEL + 32));
+    const swapFeeBps = readUintLE(data, OFF_SWAP_FEE_BPS, 2);
+    if (swapFeeBps >= FEE_D)
+        throw new Error(`${SLUG}: pair ${pool} has a degenerate swap_fee_bps ${swapFeeBps}`);
+    const tag = data[OFF_OPTION_TAG];
+    const reserveBase = tag === 0 ? 147 : 149;
+    const reserve0 = readUintLE(data, reserveBase, 8);
+    const reserve1 = readUintLE(data, reserveBase + 8, 8);
+    if (reserve0 === 0n || reserve1 === 0n)
+        throw new Error(`${SLUG}: pair ${pool} is not initialized (zero reserve)`);
+    // The swap path is Tokenkeg-only (Token-2022 transfer-fee/extension mints are
+    // out of scope), so detect a Token-2022 or un-routable mint via the shared
+    // data-shape resolver and SELF-DROP the pool (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 mints = [token0Mint, token1Mint];
+    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; // an unreadable mint falls back to the legacy assumption
+        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 [futarchyAuthority, eventAuthority, reserveVault0, reserveVault1] = await Promise.all([
+        derivePda([new TextEncoder().encode("futarchy_authority")]),
+        derivePda([new TextEncoder().encode("__event_authority")]),
+        derivePda([
+            new TextEncoder().encode("reserve_vault"),
+            getAddressEncoded(pool),
+            getAddressEncoded(token0Mint),
+        ]),
+        derivePda([
+            new TextEncoder().encode("reserve_vault"),
+            getAddressEncoded(pool),
+            getAddressEncoded(token1Mint),
+        ]),
+    ]);
+    return {
+        venue: SLUG,
+        pool,
+        direction: "aToB",
+        token0Mint,
+        token1Mint,
+        rateModel,
+        futarchyAuthority,
+        eventAuthority,
+        reserveVault0,
+        reserveVault1,
+        reserveBase,
+        token0Decimals: data[reserveBase + 160],
+        token1Decimals: data[reserveBase + 161],
+    };
+}
+/** Family facade for the recipe orchestrator (ladder-only, like orca-whirlpool/raydium-clmm/defituna). */
+export const omnipair = {
+    slug: SLUG,
+    programId: OMNIPAIR_PROGRAM_ID,
+    tokenProgram: TOKEN_PROGRAM,
+    fetchPoolConfig: fetchOmnipairPoolConfig,
+};
+/**
+ * Closed-form capacity: the largest gross input `x` for which
+ * `amountOut(x) <= cashOut` holds (see the module header derivation).
+ * `U64_MAX` when `reserveOut <= cashOut` (never binds).
+ */
+export function omnipairCapacity(reserveIn, reserveOut, cashOut, feeBps) {
+    if (reserveOut <= cashOut)
+        return U64_MAX;
+    const kq = reserveIn * reserveOut;
+    const target = reserveOut - cashOut;
+    let netInMax = kq / target - reserveIn;
+    if (netInMax < 0n)
+        netInMax = 0n;
+    // Invert netIn(x) = floor(x*m/D) <= netInMax back to a gross-input cap:
+    // floor(x*m/D) <= T  <=>  x*m <= (T+1)*D - 1  <=>  x <= floor(((T+1)*D-1)/m).
+    const m = FEE_D - feeBps;
+    return ((netInMax + 1n) * FEE_D - 1n) / m;
+}
+/** The COLD (venue-exact) quote for gross input x, saturating at the capacity clamp. */
+export function omnipairQuote(x, ri, ro, fb, icap) {
+    const cx = x > icap ? icap : x;
+    if (cx <= 0n)
+        return 0n;
+    const ni = (cx * (FEE_D - fb)) / FEE_D;
+    return (ni * ro) / (ri + ni);
+}
+//# sourceMappingURL=index.js.map

package/sdk/dist/svm/venues/omnipair/index.js.map

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

package/sdk/dist/svm/venues/one-intro-swap/index.d.ts

@@ -0,0 +1,42 @@
+import type { Address } from "@solana/kit";
+import type { AccountLoader, PoolConfig } from "../types.js";
+declare const SLUG = "one-intro-swap";
+export declare const ONE_INTRO_SWAP_PROGRAM_ID: Address;
+/**
+ * The ONE known `MetadataState` — see the module header's "global, not
+ * per-pool" evidence. Required by every swap (accounts[0], read-only).
+ */
+export declare const ONE_INTRO_SWAP_METADATA_STATE: Address;
+/**
+ * The two fixed fee-collector owners — ground-truthed via the real mainnet
+ * SOL/USDC market's four fee token accounts (2 per mint side): each owner's
+ * ATA for whichever mint is being DEPOSITED is where that stream's cut
+ * lands (see ./ladder.ts for the exact per-swap amount, always
+ * `floor(amountIn / 100_000)` per stream).
+ */
+export declare const ONE_INTRO_SWAP_FEE_OWNER_A: Address;
+export declare const ONE_INTRO_SWAP_FEE_OWNER_B: Address;
+export declare const OFF_VIRTUAL_RESERVE0 = 153;
+export declare const OFF_VIRTUAL_RESERVE1 = 233;
+/** SPL token account `amount` (u64 LE) offset — standard Tokenkeg layout. */
+export declare const TOKEN_ACCOUNT_AMOUNT_OFFSET = 64;
+export interface OneIntroSwapPoolConfig extends PoolConfig {
+    venue: typeof SLUG;
+    authority: Address;
+    mint0: Address;
+    vault0: Address;
+    mint1: Address;
+    vault1: Address;
+    /** ATA(FEE_OWNER_A, mint0) / ATA(FEE_OWNER_B, mint0) — pre-derived (buildSwapV2 is sync). */
+    feeA0: Address;
+    feeB0: Address;
+    /** ATA(FEE_OWNER_A, mint1) / ATA(FEE_OWNER_B, mint1). */
+    feeA1: Address;
+    feeB1: Address;
+    /** '0to1' (default, mint0 in) | '1to0'. */
+    direction: "0to1" | "1to0";
+}
+export declare function oneIntroSwapConfig(base: PoolConfig): OneIntroSwapPoolConfig;
+export declare function fetchOneIntroSwapPoolConfig(load: AccountLoader, pool: Address): Promise<OneIntroSwapPoolConfig>;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/sdk/dist/svm/venues/one-intro-swap/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/svm/venues/one-intro-swap/index.ts"],"names":[],"mappings":"AAuFA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAI7D,QAAA,MAAM,IAAI,mBAAmB,CAAC;AAE9B,eAAO,MAAM,yBAAyB,EAAqD,OAAO,CAAC;AAInG;;;GAGG;AACH,eAAO,MAAM,6BAA6B,EACU,OAAO,CAAC;AAE5D;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,EAAqD,OAAO,CAAC;AACpG,eAAO,MAAM,0BAA0B,EAAqD,OAAO,CAAC;AAQpG,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAGxC,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAIxC,6EAA6E;AAC7E,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAE9C,MAAM,WAAW,sBAAuB,SAAQ,UAAU;IACxD,KAAK,EAAE,OAAO,IAAI,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,6FAA6F;IAC7F,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,yDAAyD;IACzD,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,2CAA2C;IAC3C,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;CAC5B;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,sBAAsB,CAI3E;AAWD,wBAAsB,2BAA2B,CAC/C,IAAI,EAAE,aAAa,EACnB,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,sBAAsB,CAAC,CAiFjC"}

package/sdk/dist/svm/venues/one-intro-swap/index.js

@@ -0,0 +1,207 @@
+/**
+ * 1DEX (on-chain crate name `one-intro-swap`, program
+ * `DEXYosS6oEGvk8uCDayvwEZz4qEyDJRf9nFgYCaqPMTm`) — a 2-mint constant-product
+ * pool with NO on-chain Anchor IDL account (confirmed: the standard
+ * `createAddressWithSeed(findProgramAddress([], programId), "anchor:idl",
+ * programId)` PDA does not exist on mainnet). Fully binary-reverse-engineered
+ * for this integration: no public source, no SDK, `programs/one-intro-swap`
+ * is a private crate whose name only surfaces via embedded Anchor log/error
+ * strings in the dumped binary (`strings` on a `solana program dump`), never
+ * published (confirmed absent from GitHub).
+ *
+ * ACCOUNT MODEL — TWO account kinds, not one pool account:
+ *  - **`PoolState`** (432 bytes, one per market, owner = the program) — this
+ *    is the `pool` address this adapter's `fetchPoolConfig` takes. Ground-
+ *    truthed by diffing the account before/after real-CPI swaps in LiteSVM
+ *    (bisection: zeroing 8-byte words and re-running the swap) against the
+ *    ONE live mainnet market found (a SOL/USDC pool: PoolState
+ *    `DbuvwPuLvH8uy2B1sKuu18aCd2QpCvfZdfDtdRZztBd2`):
+ *      disc@0 (8B, `f7ede3f5d7c3de46` on the live pool) · vaultAuthority@8
+ *      (32B, a program-signed PDA, no seeds needed by this adapter — it
+ *      rides the swap CPI as a plain read-only account) · [40..88] unused by
+ *      SwapExactAmountIn (unidentified — likely creator/lp-mint/admin
+ *      refs, `programs/one-intro-swap/src/instructions/{join_pool,exit_pool}`
+ *      territory) · mint0@89 (32B) · vault0@121 (32B, the mint-0 token
+ *      account) · **virtualReserve0@153 (8B, u64 LE)** · [161..168] unused
+ *      by this instruction · mint1@169 (32B) · vault1@201 (32B) ·
+ *      **virtualReserve1@233 (8B, u64 LE)** · [241..431] unused.
+ *  - **`MetadataState`** (232 bytes, GLOBAL — one instance for the whole
+ *      program, not per-market) — the account this file hardcodes as
+ *      `ONE_INTRO_SWAP_METADATA_STATE`. Evidence for "global, not per-pool":
+ *      the dumped binary's own Anchor instruction log strings enumerate
+ *      `CreateMetadataState` (singular) as a SEPARATE instruction from
+ *      `CreatePoolState` (the per-market one) — a metadata/fee-config
+ *      account created once, referenced by every market's swaps. It rides
+ *      every `SwapExactAmountIn` CPI read-only and NEVER changes across any
+ *      swap this integration observed (byte-identical account snapshots
+ *      before/after, and a `PoolState`-only diff explains 100% of the
+ *      state mutation — see ./ladder.ts's module header for the full
+ *      before/after CU-calibration proof). Its own 32-byte offsets 8..39 and
+ *      40..71 do not decode to any known pubkey in this pool's account set
+ *      (checked byte-for-byte, not just base58-eyeballed); offset 40..71 IS
+ *      required (zeroing it reverts every swap with the program's own
+ *      `ConstraintInvalidTokenAccount`), so it is real, load-bearing state —
+ *      just not anything this adapter's math needs to interpret, exactly
+ *      like a ladder passing an opaque required PDA through untouched. ONE
+ *      MARKET has been found and validated end to end; if a second 1DEX
+ *      market ever surfaces with a DIFFERENT MetadataState address, this
+ *      constant needs generalizing (no evidence exists yet either way —
+ *      ship what is proven rather than block on an untestable hypothetical).
+ *
+ * SWAP INSTRUCTION — `SwapExactAmountIn(amount_in: u64, minimum_amount_out:
+ * u64)`, disc sha256("global:swap_exact_amount_in")[0..8] (the Anchor debug
+ * log confirms the name — `Instruction: SwapExactAmountIn` — the 8-byte
+ * prefix itself is read directly off a real instruction's data, not
+ * re-derived from the name), 11 accounts (metadata[ro],
+ * pool_state[rw], vault_authority[ro], vault_in[rw], vault_out[rw],
+ * owner[signer,rw], user_token_in[rw], user_token_out[rw], fee_a[rw],
+ * fee_b[rw], token_program[ro]) — ground-truthed against a real mainnet
+ * Jupiter-routed transaction's inner instructions (`getTransaction`
+ * `jsonParsed`, innerInstructions at the CPI stack height directly below
+ * `DEXYos...`), then re-derived and CONFIRMED via direct real-CPI calls in
+ * LiteSVM (this adapter's own construction, not copied from the observed
+ * transaction's account list — the observed transaction only proves the
+ * ACCOUNTS, not which of them the math actually reads). `vault_in`/
+ * `vault_out` swap POSITIONS (not identities) with direction — accounts[3]
+ * is always whichever vault the deposit lands in, accounts[4] always the
+ * payout vault; direction is inferred by the program from the account
+ * roles, never a data-blob flag (the 24-byte data blob is
+ * disc(8)+amountIn(8)+minOut(8), no direction byte, and is IDENTICAL in
+ * shape/discriminator for both directions of the one real market observed).
+ *
+ * FEE MODEL — see ./ladder.ts's module header for the exact fee/curve math
+ * (fully bit-exact, real-CPI proven against the live binary at 6+ sizes
+ * both directions). This file only owns: the two fixed fee-collector
+ * OWNERS (their ATAs per input mint are what the swap ix actually takes —
+ * ground-truthed via a real mainnet check: the SPL owner field of the four
+ * observed fee token accounts collapses to exactly two distinct pubkeys,
+ * one per fee stream, shared across both mints) and the MetadataState
+ * passthrough.
+ *
+ * Like obric-v2 (the nearest structural analogue — also no-IDL and
+ * binary-RE'd, also caps its payout at the live output vault balance), the
+ * PRICE here does not come from an external oracle; it comes from the
+ * pool's own self-tracked virtual-reserve pair (see ./ladder.ts).
+ */
+import { getAddressCodec } from "@solana/kit";
+import { memoizedGetProgramDerivedAddress } from "../pda-memo.js";
+import { readUintLE } from "../math.js";
+import { TOKEN_2022_PROGRAM_ID, classifyMintProgram } from "../../token-program.js";
+import { parseMintExtensions } from "../../token-extensions.js";
+const SLUG = "one-intro-swap";
+export const ONE_INTRO_SWAP_PROGRAM_ID = "DEXYosS6oEGvk8uCDayvwEZz4qEyDJRf9nFgYCaqPMTm";
+const TOKEN_PROGRAM_ID = "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA";
+const ASSOCIATED_TOKEN_PROGRAM_ID = "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL";
+/**
+ * The ONE known `MetadataState` — see the module header's "global, not
+ * per-pool" evidence. Required by every swap (accounts[0], read-only).
+ */
+export const ONE_INTRO_SWAP_METADATA_STATE = "5nmAbnjJfW1skrPvYjLTBNdhoKzJfznnbvDcM8G2U7Ki";
+/**
+ * The two fixed fee-collector owners — ground-truthed via the real mainnet
+ * SOL/USDC market's four fee token accounts (2 per mint side): each owner's
+ * ATA for whichever mint is being DEPOSITED is where that stream's cut
+ * lands (see ./ladder.ts for the exact per-swap amount, always
+ * `floor(amountIn / 100_000)` per stream).
+ */
+export const ONE_INTRO_SWAP_FEE_OWNER_A = "ATowQwFzdJBJ9VFSfoNKmuB8GiSeo8foM5vRriwmKmFB";
+export const ONE_INTRO_SWAP_FEE_OWNER_B = "45ruCyfdRkWpRNGEqWzjCiXRHkZs8WXCLQ67Pnpye7Hp";
+// PoolState (432 bytes) byte offsets — see the module header.
+const POOL_STATE_SIZE = 432;
+const OFF_DISC = 0;
+const OFF_AUTHORITY = 8;
+const OFF_MINT0 = 89;
+const OFF_VAULT0 = 121;
+export const OFF_VIRTUAL_RESERVE0 = 153;
+const OFF_MINT1 = 169;
+const OFF_VAULT1 = 201;
+export const OFF_VIRTUAL_RESERVE1 = 233;
+/** disc@0 of a live PoolState — Anchor's own `account:PoolState` sighash. */
+const POOL_STATE_DISCRIMINATOR = [0xf7, 0xed, 0xe3, 0xf5, 0xd7, 0xc3, 0xde, 0x46];
+/** SPL token account `amount` (u64 LE) offset — standard Tokenkeg layout. */
+export const TOKEN_ACCOUNT_AMOUNT_OFFSET = 64;
+export function oneIntroSwapConfig(base) {
+    if (base.venue !== SLUG)
+        throw new Error(`one-intro-swap adapter got a '${base.venue}' pool config`);
+    return base;
+}
+async function deriveAta(owner, mint) {
+    const enc = getAddressCodec();
+    return memoizedGetProgramDerivedAddress(ASSOCIATED_TOKEN_PROGRAM_ID, [
+        enc.encode(owner),
+        enc.encode(TOKEN_PROGRAM_ID),
+        enc.encode(mint),
+    ]);
+}
+export async function fetchOneIntroSwapPoolConfig(load, pool) {
+    const data = await load(pool);
+    if (data === null)
+        throw new Error(`one-intro-swap PoolState ${pool} not found`);
+    if (data.length !== POOL_STATE_SIZE) {
+        throw new Error(`one-intro-swap PoolState ${pool} is ${data.length} bytes, expected ${POOL_STATE_SIZE}`);
+    }
+    for (let i = 0; i < 8; i++) {
+        if (data[OFF_DISC + i] !== POOL_STATE_DISCRIMINATOR[i]) {
+            throw new Error(`one-intro-swap PoolState ${pool} has a wrong discriminator`);
+        }
+    }
+    const codec = getAddressCodec();
+    const pubkey = (offset) => codec.decode(data.subarray(offset, offset + 32));
+    const authority = pubkey(OFF_AUTHORITY);
+    const mint0 = pubkey(OFF_MINT0);
+    const vault0 = pubkey(OFF_VAULT0);
+    const mint1 = pubkey(OFF_MINT1);
+    const vault1 = pubkey(OFF_VAULT1);
+    const virtualReserve0 = readUintLE(data, OFF_VIRTUAL_RESERVE0, 8);
+    const virtualReserve1 = readUintLE(data, OFF_VIRTUAL_RESERVE1, 8);
+    // A drained/deactivated market has a zero virtual reserve on one side —
+    // the ladder's own quote helper also floors x==0 / zero-reserve inputs to
+    // 0, but gating a dead market out at fetch time (like every other family's
+    // "empty reserve" gate) keeps it out of the universe entirely rather than
+    // surviving as a permanent zero-quote slot.
+    if (virtualReserve0 === 0n || virtualReserve1 === 0n) {
+        throw new Error(`one-intro-swap PoolState ${pool} has a zero virtual reserve (0=${virtualReserve0}, 1=${virtualReserve1})`);
+    }
+    // Token-2022 safety: this venue's SwapExactAmountIn ix is legacy-SPL (Tokenkeg)
+    // only, so a Token-2022 mint (or one carrying an un-routable extension)
+    // SELF-DROPS the pool via a thrown, clearly-described error — the SvmRoute
+    // orchestrator catches a fetchPoolConfig throw and drops the venue. The legacy
+    // path stays byte-identical: a classic 82-byte mint classifies as legacy → no
+    // throw, and an unreadable mint (not vendored by a fixture) falls back to legacy.
+    const mints = [mint0, mint1];
+    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 [feeA0, feeB0, feeA1, feeB1] = await Promise.all([
+        deriveAta(ONE_INTRO_SWAP_FEE_OWNER_A, mint0),
+        deriveAta(ONE_INTRO_SWAP_FEE_OWNER_B, mint0),
+        deriveAta(ONE_INTRO_SWAP_FEE_OWNER_A, mint1),
+        deriveAta(ONE_INTRO_SWAP_FEE_OWNER_B, mint1),
+    ]);
+    return {
+        venue: SLUG,
+        pool,
+        authority,
+        mint0,
+        vault0,
+        mint1,
+        vault1,
+        feeA0,
+        feeB0,
+        feeA1,
+        feeB1,
+        direction: "0to1",
+    };
+}
+//# sourceMappingURL=index.js.map

package/sdk/dist/svm/venues/one-intro-swap/index.js.map

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

package/sdk/dist/svm/venues/openbook-v2/index.d.ts

@@ -0,0 +1,56 @@
+import type { Address } from "@solana/kit";
+import type { AccountLoader, PoolConfig } from "../types.js";
+declare const SLUG = "openbook-v2";
+export declare const OPENBOOK_V2_PROGRAM_ID: Address<"opnb2LAfJYbRMAHHvqjCwQxanZn7ReEHp1k81EohpZb">;
+export declare const MARKET_ACCOUNT_SIZE = 848;
+export declare const BOOKSIDE_ACCOUNT_SIZE = 90952;
+/** Shipped resting-order window depth per direction — a heavy fixed setup cost (unrolled live
+ * reads over a 90KB BookSide account), same 'stable'/degrade-first class as manifest/whirlpool. */
+export declare const OPENBOOK_V2_MAX_ORDERS = 4;
+/** One shipped, prepare-time-selected resting order (see the header for the identity contract). */
+export interface OpenBookV2Order {
+    /** Absolute byte offset of this order's LeafNode within its BookSide account. */
+    nodeOffset: number;
+    /** The order's full 128-bit tree key — the live-drift identity anchor. */
+    key: bigint;
+    /** price_lots, derived from the SAME key (top 64 bits) — shipped separately so the fragment
+     * never has to right-shift a 128-bit value. */
+    priceLots: bigint;
+}
+export interface OpenBookV2Window {
+    /** Best-first (see the header: descending key for bids, ascending for asks), up to
+     * OPENBOOK_V2_MAX_ORDERS entries. */
+    orders: OpenBookV2Order[];
+}
+export interface OpenBookV2PoolConfig extends PoolConfig {
+    venue: typeof SLUG;
+    /** 'baseIn' (default, sell base — opposes bids) | 'quoteIn' (buy base — opposes asks). */
+    direction: "baseIn" | "quoteIn";
+    baseMint: Address;
+    quoteMint: Address;
+    bidsAccount: Address;
+    asksAccount: Address;
+    eventHeap: Address;
+    marketBaseVault: Address;
+    marketQuoteVault: Address;
+    marketAuthority: Address;
+    baseDecimals: number;
+    quoteDecimals: number;
+    baseLotSize: bigint;
+    quoteLotSize: bigint;
+    /** Always >= 0 (the venue's own invariant). */
+    takerFeePpm: bigint;
+    /** 0 whenever the market's own makerFee is non-negative (the common case — no rebate). */
+    makerRebatePpm: bigint;
+    timeExpiry: bigint;
+    /** None encodes as the program id sentinel in buildSwapV2 (Anchor's optional-account convention). */
+    oracleA?: Address;
+    oracleB?: Address;
+    windows: {
+        baseIn: OpenBookV2Window;
+        quoteIn: OpenBookV2Window;
+    };
+}
+export declare function fetchOpenBookV2Config(load: AccountLoader, pool: Address): Promise<OpenBookV2PoolConfig>;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/sdk/dist/svm/venues/openbook-v2/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/svm/venues/openbook-v2/index.ts"],"names":[],"mappings":"AA6KA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE7D,QAAA,MAAM,IAAI,gBAAgB,CAAC;AAC3B,eAAO,MAAM,sBAAsB,wDAAyD,CAAC;AAC7F,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,eAAO,MAAM,qBAAqB,QAAQ,CAAC;AAU3C;mGACmG;AACnG,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC,mGAAmG;AACnG,MAAM,WAAW,eAAe;IAC9B,iFAAiF;IACjF,UAAU,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,GAAG,EAAE,MAAM,CAAC;IACZ;mDAC+C;IAC/C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B;yCACqC;IACrC,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,oBAAqB,SAAQ,UAAU;IACtD,KAAK,EAAE,OAAO,IAAI,CAAC;IACnB,0FAA0F;IAC1F,SAAS,EAAE,QAAQ,GAAG,SAAS,CAAC;IAChC,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,eAAe,EAAE,OAAO,CAAC;IACzB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,eAAe,EAAE,OAAO,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,0FAA0F;IAC1F,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,qGAAqG;IACrG,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE;QAAE,MAAM,EAAE,gBAAgB,CAAC;QAAC,OAAO,EAAE,gBAAgB,CAAA;KAAE,CAAC;CAClE;AA6DD,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,aAAa,EACnB,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,oBAAoB,CAAC,CAqE/B"}