@eco-incorp/sauce 0.99.0

package/sdk/dist/svm/venues/obric-v2/index.js

@@ -0,0 +1,301 @@
+/**
+ * Obric V2 venue adapter — the prop-AMM oracle-anchored (P-A) family.
+ *
+ * Obric is an oracle-priced shifted-constant-product AMM: reserves ride a
+ * virtual bigK curve RE-CENTERED on a live oracle mid, so the marginal price
+ * at the center is the oracle ratio and bigK sets the depth. Unlike the other
+ * SVM families (whose price is fully in the pool/vault state), Obric reads the
+ * fast-moving LEVEL from a SEPARATE oracle account the swap already passes in
+ * — the SVM analog of the EVM net-cache: bake the drift-invariant SHAPE (bigK,
+ * targetX, fee, the reserves), read the fast oracle MID live and re-anchor.
+ *
+ * WHY P-A (the build-now prop-AMM): (1) the price level lives in a separate,
+ * live-readable oracle account (Pyth-v2-format relay — documented layout:
+ * expo i32 @20, agg.price i64 @208, agg.status u32 @224); (2) the swap is a
+ * plain 12-account Anchor ix with NO instructions-sysvar introspection and no
+ * maker-allowlist account (any signer with token accounts may swap); (3) the
+ * quote curve is known (the official obric-solana SDK / IDL). Obric already
+ * sits in third-party router CPI target sets. See docs/svm-venues.md for the
+ * ranked prop-AMM ledger and the CPI-acceptance probe.
+ *
+ * The oracle-derivation caveat (honest): the on-chain program recomputes
+ * multX/multY from the live oracle at swap time; the exact scaling is
+ * transcribed from the official SDK (getPrice → expo −3, × decimalMult) and
+ * cross-checked against the pool's STORED multX/multY (which the program
+ * writes each swap) — the USDC feed's 1e10 @ expo −8 reproduces stored
+ * multY=100000 exactly. The program is closed-source, so venue-exactness rests
+ * on that SDK==program assumption plus the terminal minOut backstop; the
+ * lamport-exact gate (fragment == referenceQuote) is unconditional. The
+ * adapter is conservative on the fee REBATE (it charges the full feeMillionth,
+ * omitting the rebalancing-trade discount) so predicted <= realized — one-
+ * sided safe for minOut.
+ *
+ * Byte offsets verified against the obric_solana IDL (SSTradingPair) and a
+ * real mainnet dump of pool AJ5HfGY32igLgUbDtfNRdrkjTSYkCVKdhmnFFfcZMJ1E.
+ */
+import { address, getAddressCodec } 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 { INSTRUCTIONS_SYSVAR } from "../../cpi-probe.js";
+const SLUG = "obric-v2";
+export const OBRIC_V2_PROGRAM_ID = address("obriQD1zbpyLz95G5n7nJe6a4DPjpFwa5XYPoNm113y");
+const TOKEN_PROGRAM = address("TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA");
+/** The Pyth-v2-format relay program Obric migrated onto (documented layout). */
+export const PYTH_V2_RELAY_OWNER = "Feed29BgSBmKrK5jQsLR4VcwJpJr1eHfg5sX4TQbLGrV";
+/** Pyth-v2 magic at feed[0..4] LE (0xa1b2c3d4). */
+const PYTH_V2_MAGIC = 0xa1b2c3d4n;
+/** Pyth-v2 feed field offsets. */
+const FEED_MAGIC_OFF = 0;
+const FEED_EXPO_OFF = 20; // i32 LE
+const FEED_PRICE_OFF = 208; // agg.price i64 LE
+const FEED_STATUS_OFF = 224; // agg.status u32 LE (1 == Trading)
+/** sha256('account:SSTradingPair')[0..8]. */
+const POOL_DISCRIMINATOR = [0x3b, 0xde, 0x0f, 0xec, 0x62, 0x66, 0x5a, 0xe0];
+/** sha256('global:swap')[0..8] (Obric's unified swap; == meteora's, both "global:swap"). */
+export const OBRIC_SWAP_DISCRIMINATOR = [248, 198, 158, 145, 225, 117, 135, 200];
+const POOL_ACCOUNT_SIZE = 666;
+// SSTradingPair offsets (IDL-derived; see the field table in docs/svm-venues.md).
+export const OFF_INITIALIZED = 8;
+export const OFF_X_FEED = 9;
+export const OFF_Y_FEED = 41;
+export const OFF_RESERVE_X = 73;
+export const OFF_RESERVE_Y = 105;
+export const OFF_PROTO_FEE_X = 137;
+export const OFF_PROTO_FEE_Y = 169;
+export const OFF_MINT_X = 202;
+export const OFF_MINT_Y = 234;
+export const OFF_BIG_K = 274; // u128
+export const OFF_TARGET_X = 290; // u64
+export const OFF_MULT_X = 306; // u64 (stored — the sanity-band anchor)
+export const OFF_MULT_Y = 314; // u64
+export const OFF_FEE_MILLIONTH = 322; // u64
+export const OFF_REBATE_PCT = 330; // u64
+export const OFF_PROTO_FEE_SHARE = 338; // u64
+const U64_MAX = (1n << 64n) - 1n;
+/** Default sanity band (bps of the stored mult ratio): a wide gross-corruption guard for the documented P-A feed. */
+export const OBRIC_DEFAULT_BAND_BPS = 2500n;
+const codec = getAddressCodec();
+const pubkeyAt = (data, offset) => codec.decode(data.subarray(offset, offset + 32));
+/** decimalMult per the SDK's updateTradingPairPrice (normalizes the price ratio to token units). */
+function decimalMults(xDecimals, yDecimals) {
+    if (xDecimals > yDecimals)
+        return { decMultX: 1n, decMultY: 10n ** BigInt(xDecimals - yDecimals) };
+    if (yDecimals > xDecimals)
+        return { decMultX: 10n ** BigInt(yDecimals - xDecimals), decMultY: 1n };
+    return { decMultX: 1n, decMultY: 1n };
+}
+/**
+ * Pyth-v2-relay feed scaling to the SDK's expo −3, folded with the token
+ * decimalMult: mult = floor(rawPrice / div) * mul. For expo e:
+ *   e < −3  → div = 10^(−3−e), mul = decimalMult;
+ *   e >= −3 → div = 1,        mul = 10^(e+3) · decimalMult.
+ */
+function feedScale(expo, decimalMult) {
+    if (expo < -3)
+        return { div: 10n ** BigInt(-3 - expo), mul: decimalMult };
+    return { div: 1n, mul: 10n ** BigInt(expo + 3) * decimalMult };
+}
+/**
+ * Classify + decode a feed by its documented Pyth-v2 magic (0xa1b2c3d4 @0) —
+ * the bare AccountLoader gives bytes, not owner, so the magic (a stable
+ * discriminator) is the layout anchor. Doves (0x17fc67bd) / Minimox
+ * (0xcab93a6d) fail the magic and are treated as P-B (unpinned layout).
+ */
+function decodeFeed(data) {
+    if (data.length < FEED_STATUS_OFF + 4)
+        return { expo: 0, known: false };
+    if (readUintLE(data, FEED_MAGIC_OFF, 4) !== PYTH_V2_MAGIC)
+        return { expo: 0, known: false };
+    const raw = readUintLE(data, FEED_EXPO_OFF, 4);
+    const expo = raw >= 1n << 31n ? Number(raw - (1n << 32n)) : Number(raw); // i32
+    return { expo, known: true };
+}
+/** Decode + shape-gate the SSTradingPair account (named errors). */
+function decodePool(pool, data) {
+    if (data.length !== POOL_ACCOUNT_SIZE) {
+        throw new Error(`obric-v2 pool ${pool} account data is ${data.length} bytes, expected ${POOL_ACCOUNT_SIZE}`);
+    }
+    if (!POOL_DISCRIMINATOR.every((byte, i) => data[i] === byte)) {
+        throw new Error(`obric-v2 pool ${pool} is not an SSTradingPair account (discriminator mismatch)`);
+    }
+    if (data[OFF_INITIALIZED] !== 1)
+        throw new Error(`obric-v2 pool ${pool} is not initialized`);
+    const bigK = readUintLE(data, OFF_BIG_K, 16);
+    if (bigK === 0n) {
+        throw new Error(`obric-v2 pool ${pool} has bigK=0 (drained / never seeded) — no curve to quote`);
+    }
+    return {
+        feedX: pubkeyAt(data, OFF_X_FEED),
+        feedY: pubkeyAt(data, OFF_Y_FEED),
+        reserveXVault: pubkeyAt(data, OFF_RESERVE_X),
+        reserveYVault: pubkeyAt(data, OFF_RESERVE_Y),
+        protocolFeeX: pubkeyAt(data, OFF_PROTO_FEE_X),
+        protocolFeeY: pubkeyAt(data, OFF_PROTO_FEE_Y),
+        mintX: pubkeyAt(data, OFF_MINT_X),
+        mintY: pubkeyAt(data, OFF_MINT_Y),
+        bigK,
+        targetX: readUintLE(data, OFF_TARGET_X, 8),
+        feeMillionth: readUintLE(data, OFF_FEE_MILLIONTH, 8),
+        storedMultX: readUintLE(data, OFF_MULT_X, 8),
+        storedMultY: readUintLE(data, OFF_MULT_Y, 8),
+    };
+}
+function obricConfig(cfg) {
+    if (cfg.venue !== SLUG)
+        throw new Error(`obric-v2 adapter got a config for venue '${cfg.venue}'`);
+    const c = cfg;
+    if (c.direction !== "xToY" && c.direction !== "yToX") {
+        throw new Error(`obric-v2 direction must be 'xToY' or 'yToX', got '${c.direction}'`);
+    }
+    return c;
+}
+export const obricV2 = {
+    slug: SLUG,
+    kind: "constant-product",
+    programId: OBRIC_V2_PROGRAM_ID,
+    /**
+     * Off-chain gate + oracle classification. Rejects: wrong size/disc,
+     * uninitialized, bigK=0 (drained), token-2022 mints (Tokenkeg-only class),
+     * and — the CPI-acceptance discriminant — a feed pointing at the
+     * instructions sysvar (the introspecting P-C pools) or a feed whose layout
+     * is not the documented Pyth-v2 relay (Doves/Minimox — P-B, unpinned layout).
+     */
+    async fetchPoolConfig(load, pool) {
+        const data = await load(pool);
+        if (data === null)
+            throw new Error(`obric-v2 pool ${pool} account not found`);
+        const d = decodePool(pool, data);
+        // CPI-acceptance static screen: a feed slot pointing at the instructions
+        // sysvar means the swap introspects the enclosing transaction (P-C).
+        if (d.feedX === INSTRUCTIONS_SYSVAR || d.feedY === INSTRUCTIONS_SYSVAR) {
+            throw new Error(`obric-v2 pool ${pool} references the instructions sysvar as a price feed (introspecting swap — tier P-C, excluded)`);
+        }
+        // Both mints must be classic Tokenkeg (the swap carries one token program).
+        const [mintXData, mintYData] = await Promise.all([load(d.mintX), load(d.mintY)]);
+        if (mintXData === null || mintYData === null) {
+            throw new Error(`obric-v2 pool ${pool} mint account(s) not found`);
+        }
+        const [feedXData, feedYData] = await Promise.all([load(d.feedX), load(d.feedY)]);
+        if (feedXData === null || feedYData === null) {
+            throw new Error(`obric-v2 pool ${pool} price feed account(s) not found`);
+        }
+        // Mint owner = token program; the recipe is Tokenkeg-only (a token-2022
+        // mint / transfer-fee extension would desync wire amounts from the curve).
+        const dec = (mint, mintData) => {
+            if (mintData.length < 45)
+                throw new Error(`obric-v2 pool ${pool} mint ${mint} is ${mintData.length} bytes, not an SPL mint`);
+            return mintData[44];
+        };
+        const xDecimals = dec(d.mintX, mintXData);
+        const yDecimals = dec(d.mintY, mintYData);
+        // Token-2022 safety: the swap carries one token program (Tokenkeg), 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. We
+        // reuse the mint bytes already loaded above for the decimals decode.
+        for (const [mint, mintData] of [
+            [d.mintX, mintXData],
+            [d.mintY, mintYData],
+        ]) {
+            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("; ")}`);
+            }
+        }
+        // Classify each feed by its documented Pyth-v2 layout (magic + expo).
+        const feedX = decodeFeed(feedXData);
+        const feedY = decodeFeed(feedYData);
+        if (!feedX.known || !feedY.known) {
+            throw new Error(`obric-v2 pool ${pool} uses a non-Pyth-v2 relay feed (Doves/Minimox — layout not pinned; tier P-B, documented-but-not-built)`);
+        }
+        const { decMultX, decMultY } = decimalMults(xDecimals, yDecimals);
+        const sx = feedScale(feedX.expo, decMultX);
+        const sy = feedScale(feedY.expo, decMultY);
+        return {
+            venue: SLUG,
+            pool,
+            direction: "xToY",
+            mintX: d.mintX,
+            mintY: d.mintY,
+            reserveXVault: d.reserveXVault,
+            reserveYVault: d.reserveYVault,
+            protocolFeeX: d.protocolFeeX,
+            protocolFeeY: d.protocolFeeY,
+            feedX: d.feedX,
+            feedY: d.feedY,
+            tokenProgram: TOKEN_PROGRAM,
+            bigK: d.bigK,
+            targetX: d.targetX,
+            feeMillionth: d.feeMillionth,
+            divX: sx.div,
+            mulX: sx.mul,
+            divY: sy.div,
+            mulY: sy.mul,
+            priceOffX: BigInt(FEED_PRICE_OFF),
+            priceOffY: BigInt(FEED_PRICE_OFF),
+            bandBps: OBRIC_DEFAULT_BAND_BPS,
+            storedMultX: d.storedMultX,
+            storedMultY: d.storedMultY,
+            cpiTier: "P-A",
+        };
+    },
+    quoteAccounts(cfg) {
+        const c = obricConfig(cfg);
+        return [
+            { ref: c.pool, address: c.pool },
+            { ref: c.feedX, address: c.feedX },
+            { ref: c.feedY, address: c.feedY },
+            { ref: c.reserveXVault, address: c.reserveXVault },
+            { ref: c.reserveYVault, address: c.reserveYVault },
+        ];
+    },
+    /** v1 swap CPI (amount baked) — the unified `swap` ix. */
+    buildSwap(cfg, user, amountIn) {
+        const c = obricConfig(cfg);
+        if (amountIn <= 0n || amountIn > U64_MAX)
+            throw new Error(`obric-v2 buildSwap amountIn must be a positive u64, got ${amountIn}`);
+        const xToY = c.direction === "xToY";
+        const data = new Uint8Array(8 + 1 + 8 + 8);
+        data.set(OBRIC_SWAP_DISCRIMINATOR, 0);
+        data[8] = xToY ? 1 : 0; // isXToY
+        for (let b = 0; b < 8; b++)
+            data[9 + b] = Number((amountIn >> BigInt(8 * b)) & 0xffn);
+        data[17] = 1; // minOutputAmt = 1 (the recipe's terminal delta owns the bound)
+        return {
+            programId: OBRIC_V2_PROGRAM_ID,
+            data,
+            accounts: swapAccounts(c, user, (ref, addr, w) => fixed(ref, addr, w)),
+        };
+    },
+};
+const fixed = (ref, addr, writable) => writable ? { ref, address: addr, writable: true } : { ref, address: addr };
+/** The 12-account order for Obric's unified `swap` (shared by v1 buildSwap and v2 buildSwapV2). */
+export function swapAccounts(c, user, make, refFor) {
+    const xToY = c.direction === "xToY";
+    const r = refFor ?? ((role) => role);
+    const userX = xToY ? user.inAta : user.outAta; // userTokenAccountX
+    const userY = xToY ? user.outAta : user.inAta; // userTokenAccountY
+    const protoFee = xToY ? c.protocolFeeY : c.protocolFeeX; // output-side protocol fee vault
+    return [
+        make(r("pool"), c.pool, true),
+        make(r("mx"), c.mintX),
+        make(r("my"), c.mintY),
+        make(r("vx"), c.reserveXVault, true),
+        make(r("vy"), c.reserveYVault, true),
+        { ref: userX, writable: true },
+        { ref: userY, writable: true },
+        make(r("pf"), protoFee, true),
+        make(r("fx"), c.feedX),
+        make(r("fy"), c.feedY),
+        { ref: user.owner, signer: true },
+        make(r("tp"), c.tokenProgram),
+    ];
+}
+//# sourceMappingURL=index.js.map

package/sdk/dist/svm/venues/obric-v2/index.js.map

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

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

@@ -0,0 +1,51 @@
+import type { Address } from "@solana/kit";
+import type { AccountLoader, PoolConfig, VenueAccount } from "../types.js";
+declare const SLUG = "obsidian";
+export declare const OBSIDIAN_PROGRAM_ID: Address<"HBVw6bZtcCaezhcBrmfyXBSBRWCdv72271xQ4GPvms2z">;
+export declare const OFF_MINT_A = 80;
+export declare const OFF_MINT_B = 112;
+export declare const OFF_VAULT_A = 144;
+export declare const OFF_VAULT_B = 176;
+export declare const OFF_LAST_UPDATE_SLOT = 536;
+export declare const OFF_PRICE = 544;
+/** SPL mint account decimals field offset (standard layout: after COption<Pubkey> + u64 supply). */
+export declare const MINT_DECIMALS_OFF = 44;
+/**
+ * Freshness bound for the off-chain prepare gate (slots; ~600 slots is ~4
+ * minutes at 400ms/slot). Conservative-tight by design: we have no ground
+ * truth for the program's own enforced threshold (only that ~15.9M slots of
+ * staleness reverts), and under-estimating freshness only costs a missed
+ * quote — over-estimating risks admitting a pool that reverts on-chain,
+ * which aborts the WHOLE cook (see the file header). Re-tune once the real
+ * threshold is known (e.g. once a keeper is observed refreshing on a known
+ * cadence).
+ */
+export declare const MAX_STALE_SLOTS = 600n;
+export interface ObsidianPoolConfig extends PoolConfig {
+    venue: typeof SLUG;
+    /** 0 = mintA in / mintB out, 1 = mintB in / mintA out (POSITIONAL BY MINT — see the file header). */
+    direction: 0 | 1;
+    mintA: Address;
+    mintB: Address;
+    vaultA: Address;
+    vaultB: Address;
+    decimalsA: number;
+    decimalsB: number;
+}
+/**
+ * Off-chain gate + decode. Rejects: wrong pool size, a missing mint/decimals
+ * read, and — the load-bearing check — a STALE crank price (see the file
+ * header "Live-state honesty"). direction is caller-supplied (0 or 1); both
+ * directions share one pool account.
+ */
+declare function fetchPoolConfig(load: AccountLoader, pool: Address, direction?: 0 | 1): Promise<ObsidianPoolConfig>;
+declare function quoteAccounts(base: PoolConfig): VenueAccount[];
+export declare const obsidian: {
+    slug: string;
+    kind: "constant-product";
+    programId: Address<"HBVw6bZtcCaezhcBrmfyXBSBRWCdv72271xQ4GPvms2z">;
+    fetchPoolConfig: typeof fetchPoolConfig;
+    quoteAccounts: typeof quoteAccounts;
+};
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/svm/venues/obsidian/index.ts"],"names":[],"mappings":"AAoFA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3E,QAAA,MAAM,IAAI,aAAa,CAAC;AACxB,eAAO,MAAM,mBAAmB,yDAA0D,CAAC;AAG3F,eAAO,MAAM,UAAU,KAAK,CAAC;AAC7B,eAAO,MAAM,UAAU,MAAM,CAAC;AAC9B,eAAO,MAAM,WAAW,MAAM,CAAC;AAC/B,eAAO,MAAM,WAAW,MAAM,CAAC;AAC/B,eAAO,MAAM,oBAAoB,MAAM,CAAC;AACxC,eAAO,MAAM,SAAS,MAAM,CAAC;AAC7B,oGAAoG;AACpG,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAKpC;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,OAAO,CAAC;AAMpC,MAAM,WAAW,kBAAmB,SAAQ,UAAU;IACpD,KAAK,EAAE,OAAO,IAAI,CAAC;IACnB,qGAAqG;IACrG,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAwBD;;;;;GAKG;AACH,iBAAe,eAAe,CAC5B,IAAI,EAAE,aAAa,EACnB,IAAI,EAAE,OAAO,EACb,SAAS,GAAE,CAAC,GAAG,CAAK,GACnB,OAAO,CAAC,kBAAkB,CAAC,CAwC7B;AAED,iBAAS,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,YAAY,EAAE,CAOvD;AAED,eAAO,MAAM,QAAQ;;;;;;CAMpB,CAAC"}

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

@@ -0,0 +1,188 @@
+/**
+ * Obsidian venue adapter — a closed-source prop AMM / push-quote PMM
+ * (program `HBVw6bZtcCaezhcBrmfyXBSBRWCdv72271xQ4GPvms2z`). No on-chain IDL
+ * ships for this program, so everything below is recovered by binary/account
+ * inspection plus real mainnet transaction archaeology (the same method that
+ * produced obric-v2 / quantum / solfi-v2 / bisonfi) and cross-checked with
+ * our own `simulateTransaction` calls (`sigVerify:false`) against the live
+ * program.
+ *
+ * ── Method (2026-07-31) ──
+ * `getSignaturesForAddress` + `getTransaction` over the program's real
+ * history recovered 18 real LANDED swaps (both directions, sizes spanning
+ * ~22M to ~8.3B raw units — over 2.5 orders of magnitude) plus the
+ * "update_crank_params" keeper instruction. The program binary itself
+ * (dumped from its `ProgramData` account — a real .so, no IDL, but NOT
+ * stripped of Rust source paths) confirms the instruction names via panic
+ * unwind strings: `obsidian-amm/src/instruction/swap.rs` (disc 0x01, this
+ * adapter) and `obsidian-amm/src/instruction/update_crank_params.rs`
+ * (disc 0x00, a keeper-only price-feed refresh this adapter never emits).
+ *
+ * ── Account layout (pool account, 2216 bytes) ──
+ * Located the same way as bisonfi/solfi-v2 (known vault/mint addresses found
+ * as raw bytes inside a real pool account):
+ *   OFF_MINT_A         = 80   (pubkey)
+ *   OFF_MINT_B         = 112  (pubkey)
+ *   OFF_VAULT_A        = 144  (pubkey — SPL vault for mintA)
+ *   OFF_VAULT_B        = 176  (pubkey — SPL vault for mintB)
+ *   OFF_LAST_UPDATE_SLOT = 536 (u64 — the crank's last-write slot; VERIFIED:
+ *     the live SOL/USDC pool's current value, 420596559, is EXACTLY the slot
+ *     of the last real transaction ever landed against this program — an
+ *     unrecoverable coincidence otherwise)
+ *   OFF_PRICE          = 544 (u64 — mid price, quoteB-per-baseA scaled 1e6;
+ *     the SAME 8 bytes the update_crank_params payload writes at this offset;
+ *     see ladder.ts's "Quote model" for the wei-level fit against the 18 real
+ *     fills)
+ *
+ * ── Swap instruction (disc 0x01, 9 bytes: disc(1) ++ amountIn u64 LE) ──
+ * Recovered from the 18 real fills (`getTransaction` + inner-instruction
+ * stack-height correlation): NO min_out field and NO direction byte — the
+ * program infers direction from which mint the caller's source ATA holds.
+ *
+ * ── Accounts (8, POSITIONAL BY ROLE — vaultA/vaultB are POSITIONAL BY MINT,
+ * same trap as solfi-v2/Quantum: their slots are FIXED to mintA/mintB
+ * regardless of trade direction, and the program auto-detects direction from
+ * the caller's source-ATA mint, confirmed by observing the SAME account
+ * order used for BOTH directions across the 18 real fills) ──
+ *   0 authority (signer)     — owner of the source ATA (a real signer in a
+ *                              direct/non-aggregated call; a delegate PDA
+ *                              when routed through an aggregator's
+ *                              shared-accounts flow — either is accepted)
+ *   1 pool      (writable)   — the 2216-byte pool state account
+ *   2 vaultA    (writable)   — mintA's SPL vault (FIXED identity)
+ *   3 vaultB    (writable)   — mintB's SPL vault (FIXED identity)
+ *   4 userSrcAta (writable)  — caller's source-mint ATA (tokenIn)
+ *   5 userDstAta (writable)  — caller's dest-mint ATA (tokenOut)
+ *   6 TOKEN_PROGRAM (readonly)
+ *   7 SYSVAR_INSTRUCTIONS (readonly)
+ * Verified structurally via our OWN simulateTransaction against the live
+ * program (real dev keypair, real wrapped-SOL balance, no impersonation):
+ * the instruction reached 353 CU of real program logic (well past account
+ * deserialization) before reverting with a business-logic `custom program
+ * error: 0xb` — see "Live-state honesty" below for why every currently-known
+ * pool reverts there.
+ *
+ * ── Live-state honesty (2026-07-31) ──
+ * ALL THREE currently-known Obsidian pools are stale: `OFF_LAST_UPDATE_SLOT`
+ * reads 420596559 / 371375264 / 0 against a live cluster slot near
+ * 436,466,828 — the keeper has not refreshed any of them in months. This
+ * adapter's own prepare-time freshness gate (see `fetchPoolConfig`) reflects
+ * that reality and self-drops every currently-known pool — this is NOT a
+ * permission/whitelist refusal, it mirrors the real program's OWN enforced
+ * staleness check (our simulateTransaction probe against the live SOL/USDC
+ * pool reverted with `custom program error: 0xb` at exactly this staleness,
+ * consistent with a stale-crank gate) and exists because an execution-time
+ * CPI failure aborts the WHOLE cook on SVM (no partial-catch) — admitting a
+ * pool doomed to revert would take down every other venue in the same
+ * transaction, not just this one. The integration is complete and correct;
+ * it will start serving quotes the moment the keeper (or any keeper) refreshes
+ * a pool, with zero code changes — sequencing, not a gate on the feature.
+ *
+ * This file is the off-chain decode + CPI-account layer (PoolConfig,
+ * fetchPoolConfig, quoteAccounts).
+ */
+import { address, getAddressCodec } from "@solana/kit";
+import { readUintLE } from "../math.js";
+const SLUG = "obsidian";
+export const OBSIDIAN_PROGRAM_ID = address("HBVw6bZtcCaezhcBrmfyXBSBRWCdv72271xQ4GPvms2z");
+const POOL_ACCOUNT_SIZE = 2216;
+export const OFF_MINT_A = 80;
+export const OFF_MINT_B = 112;
+export const OFF_VAULT_A = 144;
+export const OFF_VAULT_B = 176;
+export const OFF_LAST_UPDATE_SLOT = 536;
+export const OFF_PRICE = 544;
+/** SPL mint account decimals field offset (standard layout: after COption<Pubkey> + u64 supply). */
+export const MINT_DECIMALS_OFF = 44;
+/** Clock sysvar `slot` field offset (first u64 of the Clock struct). */
+const CLOCK_SLOT_OFF = 0;
+const CLOCK_SYSVAR = address("SysvarC1ock11111111111111111111111111111111");
+/**
+ * Freshness bound for the off-chain prepare gate (slots; ~600 slots is ~4
+ * minutes at 400ms/slot). Conservative-tight by design: we have no ground
+ * truth for the program's own enforced threshold (only that ~15.9M slots of
+ * staleness reverts), and under-estimating freshness only costs a missed
+ * quote — over-estimating risks admitting a pool that reverts on-chain,
+ * which aborts the WHOLE cook (see the file header). Re-tune once the real
+ * threshold is known (e.g. once a keeper is observed refreshing on a known
+ * cadence).
+ */
+export const MAX_STALE_SLOTS = 600n;
+const codec = getAddressCodec();
+const pubkeyAt = (data, offset) => codec.decode(data.subarray(offset, offset + 32));
+/** Shared by index.ts and ladder.ts; not exported (mirrors the solfi-v2 split). */
+function obsidianConfig(cfg) {
+    if (cfg.venue !== SLUG)
+        throw new Error(`${SLUG} ladder adapter got a '${cfg.venue}' pool config`);
+    const c = cfg;
+    if (c.direction !== 0 && c.direction !== 1) {
+        throw new Error(`${SLUG} direction must be 0 or 1, got '${c.direction}'`);
+    }
+    return c;
+}
+async function fetchDecimals(load, mint) {
+    const data = await load(mint);
+    if (data === null)
+        throw new Error(`${SLUG} mint ${mint} account not found`);
+    if (data.length <= MINT_DECIMALS_OFF) {
+        throw new Error(`${SLUG} mint ${mint} account is ${data.length} bytes, too small for an SPL Mint`);
+    }
+    return data[MINT_DECIMALS_OFF];
+}
+/**
+ * Off-chain gate + decode. Rejects: wrong pool size, a missing mint/decimals
+ * read, and — the load-bearing check — a STALE crank price (see the file
+ * header "Live-state honesty"). direction is caller-supplied (0 or 1); both
+ * directions share one pool account.
+ */
+async function fetchPoolConfig(load, pool, direction = 0) {
+    const data = await load(pool);
+    if (data === null)
+        throw new Error(`${SLUG} pool ${pool} account not found`);
+    if (data.length !== POOL_ACCOUNT_SIZE) {
+        throw new Error(`${SLUG} pool ${pool} account data is ${data.length} bytes, expected ${POOL_ACCOUNT_SIZE}`);
+    }
+    const clockData = await load(CLOCK_SYSVAR);
+    if (clockData === null)
+        throw new Error(`${SLUG} could not read the Clock sysvar to gate pool ${pool} freshness`);
+    const liveSlot = readUintLE(clockData, CLOCK_SLOT_OFF, 8);
+    const lastUpdateSlot = readUintLE(data, OFF_LAST_UPDATE_SLOT, 8);
+    if (liveSlot > lastUpdateSlot && liveSlot - lastUpdateSlot > MAX_STALE_SLOTS) {
+        throw new Error(`${SLUG} pool ${pool} price is stale: last updated slot ${lastUpdateSlot}, live slot ${liveSlot} (>${MAX_STALE_SLOTS} slots old) — self-dropping to avoid a cook-aborting revert`);
+    }
+    const mintA = pubkeyAt(data, OFF_MINT_A);
+    const mintB = pubkeyAt(data, OFF_MINT_B);
+    const vaultA = pubkeyAt(data, OFF_VAULT_A);
+    const vaultB = pubkeyAt(data, OFF_VAULT_B);
+    const [decimalsA, decimalsB] = await Promise.all([
+        fetchDecimals(load, mintA),
+        fetchDecimals(load, mintB),
+    ]);
+    return {
+        venue: SLUG,
+        pool,
+        direction,
+        mintA,
+        mintB,
+        vaultA,
+        vaultB,
+        decimalsA,
+        decimalsB,
+    };
+}
+function quoteAccounts(base) {
+    const cfg = obsidianConfig(base);
+    return [
+        { ref: cfg.pool, address: cfg.pool },
+        { ref: cfg.vaultA, address: cfg.vaultA },
+        { ref: cfg.vaultB, address: cfg.vaultB },
+    ];
+}
+export const obsidian = {
+    slug: SLUG,
+    kind: "constant-product",
+    programId: OBSIDIAN_PROGRAM_ID,
+    fetchPoolConfig,
+    quoteAccounts,
+};
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/svm/venues/obsidian/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkFG;AACH,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEvD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGxC,MAAM,IAAI,GAAG,UAAU,CAAC;AACxB,MAAM,CAAC,MAAM,mBAAmB,GAAG,OAAO,CAAC,8CAA8C,CAAC,CAAC;AAE3F,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAC/B,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,CAAC;AAC7B,MAAM,CAAC,MAAM,UAAU,GAAG,GAAG,CAAC;AAC9B,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,CAAC;AAC/B,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,CAAC;AAC/B,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,CAAC;AACxC,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,CAAC;AAC7B,oGAAoG;AACpG,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AACpC,wEAAwE;AACxE,MAAM,cAAc,GAAG,CAAC,CAAC;AACzB,MAAM,YAAY,GAAG,OAAO,CAAC,6CAA6C,CAAC,CAAC;AAE5E;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC;AAEpC,MAAM,KAAK,GAAG,eAAe,EAAE,CAAC;AAChC,MAAM,QAAQ,GAAG,CAAC,IAAgB,EAAE,MAAc,EAAW,EAAE,CAC7D,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC;AAcnD,mFAAmF;AACnF,SAAS,cAAc,CAAC,GAAe;IACrC,IAAI,GAAG,CAAC,KAAK,KAAK,IAAI;QACpB,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,0BAA0B,GAAG,CAAC,KAAK,eAAe,CAAC,CAAC;IAC7E,MAAM,CAAC,GAAG,GAAyB,CAAC;IACpC,IAAI,CAAC,CAAC,SAAS,KAAK,CAAC,IAAI,CAAC,CAAC,SAAS,KAAK,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,mCAAmC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,IAAmB,EAAE,IAAa;IAC7D,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,IAAI,KAAK,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,SAAS,IAAI,oBAAoB,CAAC,CAAC;IAC7E,IAAI,IAAI,CAAC,MAAM,IAAI,iBAAiB,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CACb,GAAG,IAAI,SAAS,IAAI,eAAe,IAAI,CAAC,MAAM,mCAAmC,CAClF,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC,iBAAiB,CAAC,CAAC;AACjC,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,eAAe,CAC5B,IAAmB,EACnB,IAAa,EACb,YAAmB,CAAC;IAEpB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,IAAI,KAAK,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,SAAS,IAAI,oBAAoB,CAAC,CAAC;IAC7E,IAAI,IAAI,CAAC,MAAM,KAAK,iBAAiB,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CACb,GAAG,IAAI,SAAS,IAAI,oBAAoB,IAAI,CAAC,MAAM,oBAAoB,iBAAiB,EAAE,CAC3F,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,CAAC;IAC3C,IAAI,SAAS,KAAK,IAAI;QACpB,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,iDAAiD,IAAI,YAAY,CAAC,CAAC;IAC5F,MAAM,QAAQ,GAAG,UAAU,CAAC,SAAS,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC;IAC1D,MAAM,cAAc,GAAG,UAAU,CAAC,IAAI,EAAE,oBAAoB,EAAE,CAAC,CAAC,CAAC;IACjE,IAAI,QAAQ,GAAG,cAAc,IAAI,QAAQ,GAAG,cAAc,GAAG,eAAe,EAAE,CAAC;QAC7E,MAAM,IAAI,KAAK,CACb,GAAG,IAAI,SAAS,IAAI,sCAAsC,cAAc,eAAe,QAAQ,MAAM,eAAe,6DAA6D,CAClL,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAC3C,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC/C,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC;QAC1B,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC;KAC3B,CAAC,CAAC;IAEH,OAAO;QACL,KAAK,EAAE,IAAI;QACX,IAAI;QACJ,SAAS;QACT,KAAK;QACL,KAAK;QACL,MAAM;QACN,MAAM;QACN,SAAS;QACT,SAAS;KACV,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,IAAgB;IACrC,MAAM,GAAG,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACjC,OAAO;QACL,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,IAAI,EAAE;QACpC,EAAE,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE;QACxC,EAAE,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE;KACzC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,IAAI,EAAE,IAAI;IACV,IAAI,EAAE,kBAA2B;IACjC,SAAS,EAAE,mBAAmB;IAC9B,eAAe;IACf,aAAa;CACd,CAAC"}

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

@@ -0,0 +1,42 @@
+import type { Address } from "@solana/kit";
+import type { AccountLoader, PoolConfig } from "../types.js";
+declare const SLUG = "omnipair";
+export declare const OMNIPAIR_PROGRAM_ID: Address<"omnixgS8fnqHfCcTGKWj6JtKjzpJZ1Y5y9pyFkQDkYE">;
+export declare const PAIR_ACCOUNT_SIZE = 350;
+/** sha256('account:Pair')[0..8]. */
+export declare const PAIR_DISCRIMINATOR: number[];
+export interface OmnipairPoolConfig extends PoolConfig {
+    venue: typeof SLUG;
+    /** 'aToB' (default, token0 in / token1 out) | 'bToA'. */
+    direction: "aToB" | "bToA";
+    token0Mint: Address;
+    token1Mint: Address;
+    rateModel: Address;
+    futarchyAuthority: Address;
+    eventAuthority: Address;
+    reserveVault0: Address;
+    reserveVault1: Address;
+    /** Immutable per-pair Borsh option-tag offset for reserve0 (147 tag=None, 149 tag=Some) — part of the shape key. */
+    reserveBase: 147 | 149;
+    token0Decimals: number;
+    token1Decimals: number;
+}
+/** Fetch + decode one Pair, deriving the fixed accounts the swap CPI needs. Read-only against the loader. */
+export declare function fetchOmnipairPoolConfig(load: AccountLoader, pool: Address): Promise<OmnipairPoolConfig>;
+/** Family facade for the recipe orchestrator (ladder-only, like orca-whirlpool/raydium-clmm/defituna). */
+export declare const omnipair: {
+    slug: string;
+    programId: Address<"omnixgS8fnqHfCcTGKWj6JtKjzpJZ1Y5y9pyFkQDkYE">;
+    tokenProgram: Address<"TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA">;
+    fetchPoolConfig: typeof 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 declare function omnipairCapacity(reserveIn: bigint, reserveOut: bigint, cashOut: bigint, feeBps: bigint): bigint;
+/** The COLD (venue-exact) quote for gross input x, saturating at the capacity clamp. */
+export declare function omnipairQuote(x: bigint, ri: bigint, ro: bigint, fb: bigint, icap: bigint): bigint;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/svm/venues/omnipair/index.ts"],"names":[],"mappings":"AA4GA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAI7D,QAAA,MAAM,IAAI,aAAa,CAAC;AACxB,eAAO,MAAM,mBAAmB,wDAAyD,CAAC;AAE1F,eAAO,MAAM,iBAAiB,MAAM,CAAC;AACrC,oCAAoC;AACpC,eAAO,MAAM,kBAAkB,UAAmD,CAAC;AAWnF,MAAM,WAAW,kBAAmB,SAAQ,UAAU;IACpD,KAAK,EAAE,OAAO,IAAI,CAAC;IACnB,yDAAyD;IACzD,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,cAAc,EAAE,OAAO,CAAC;IACxB,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,OAAO,CAAC;IACvB,oHAAoH;IACpH,WAAW,EAAE,GAAG,GAAG,GAAG,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB;AAYD,6GAA6G;AAC7G,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,aAAa,EACnB,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,kBAAkB,CAAC,CAiF7B;AAED,0GAA0G;AAC1G,eAAO,MAAM,QAAQ;;;;;CAKpB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,MAAM,CAUR;AAED,wFAAwF;AACxF,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAKjG"}