@eco-incorp/sauce 0.99.0

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

@@ -0,0 +1,346 @@
+/**
+ * OpenBook V2 — a permissionless CLOB (Serum/OpenBook lineage), manifest-shaped:
+ * a k-level best-first walk over shipped resting orders, ship-and-verify
+ * exactly like `manifest` (see `@eco-incorp/sauce/svm`'s manifest ladder),
+ * but over a genuinely DIFFERENT on-chain layout — OpenBook keeps the two
+ * order-book sides in their OWN accounts (BookSide), not embedded in the
+ * market, and settles via a real Anchor CPI (`placeTakeOrder`) rather than a
+ * self-contained custom instruction.
+ *
+ * Program id opnb2LAfJYbRMAHHvqjCwQxanZn7ReEHp1k81EohpZb. Layout — FREE from
+ * the on-chain IDL (github.com/openbook-dex/openbook-v2, `idl/openbook_v2.json`)
+ * and independently BYTE-VERIFIED against the real Market/BookSide struct
+ * definitions (every offset below re-derived field-by-field from the IDL and
+ * cross-checked against `const_assert_eq!(size_of::<BookSide>(), 90944)` in
+ * `programs/openbook-v2/src/state/orderbook/bookside.rs` and the 848-byte
+ * on-chain `dataSize` filter — both match exactly):
+ *
+ * Market account (848 bytes total, INCLUDING the 8-byte Anchor discriminator
+ * at @0): bump@8, baseDecimals@9, quoteDecimals@10, bids@200, asks@232,
+ * eventHeap@264, oracleA@296 (NonZeroPubkeyOption — 32 bytes, zero = None),
+ * oracleB@328, quoteLotSize@448 (i64), baseLotSize@456 (i64), makerFee@480
+ * (i64, ppm; >=0 means NO taker-fee rebate to the maker, i.e. no discount to
+ * model — see the fee section below), takerFee@488 (i64, ppm, always >= 0),
+ * baseMint@576, quoteMint@608, marketBaseVault@640, marketQuoteVault@680;
+ * openOrdersAdmin@88 and timeExpiry@48 gate participation (see fetchPoolConfig).
+ *
+ * BookSide account (one PER SIDE — bids and asks are SEPARATE accounts, unlike
+ * manifest's single self-contained market): roots[2]@8 (OrderTreeRoot =
+ * {maybeNode: u32, leafCount: u32}, 8 bytes each — index 0 is the `Fixed`
+ * order tree, index 1 `OraclePegged`), nodes (OrderTreeNodes) starting @312;
+ * within OrderTreeNodes the `nodes: [AnyNode; 1024]` array itself starts at a
+ * FURTHER +528 offset (orderTreeType(1)+padding(3)+bumpIndex(4)+freeListLen(4)+
+ * freeListHead(4)+reserved(512)), so a tree-node absolute offset is
+ * `840 + nodeIndex*88` (AnyNode = tag(1)+data(87), 88 bytes; a LeafNode's
+ * `key` (u128 LE) sits at nodeOffset+8, `quantity` (i64) at nodeOffset+56,
+ * `timeInForce` (u16) at nodeOffset+2). Total 90952 bytes (312 + 90640),
+ * matching size_of::<BookSide>()=90944 plus the 8-byte discriminator exactly.
+ *
+ * THE LADDER IS THE FIXED-TREE ONLY, best-first over the FULL 128-BIT KEY (not
+ * price alone): `key = (price_lots << 64) | tie_break`, and per
+ * bookside.rs's own doc comment ("smallest to highest for asks; highest to
+ * smallest for bids") ties at one price level still have a real time-priority
+ * order the venue enforces — VALIDATED empirically (see below): sorting by
+ * price_lots alone picks the WRONG subset of same-priced orders whenever a
+ * price level is shared by more than the shipped window's order count,
+ * silently under-filling a "saturate the whole window" cook (measured on a
+ * REAL mainnet book with 14 same-priced bid levels behind a 4-order window).
+ * OraclePegged-tree liquidity is NEVER modelled (the effective price of a
+ * pegged order depends on a live oracle read this ladder does not perform) —
+ * this is a strict UNDERESTIMATE (the real walk can only deliver >= what this
+ * ladder predicts on a book that also carries pegged makers), never a
+ * favourable-error risk. Orders with `timeInForce != 0` (can expire) are
+ * dropped from the shipped window entirely at prepare time — the real venue
+ * actively prunes expired orders out of the match (`DROP_EXPIRED_ORDER_LIMIT`
+ * in book.rs), so counting one at prepare time and having it vanish by cook
+ * time would silently overstate liquidity; TIF=0 (GTC) orders can only be
+ * removed by a fill or a cancel, both already covered by the live key-match
+ * self-drop below.
+ *
+ * PER-ORDER LIVE DRIFT CHECK: the fragment ships (nodeOffset, key, priceLots)
+ * per level and re-reads the LIVE 128-bit key at nodeOffset+8 (one 16-byte
+ * accountUint, same width class as manifest's own price read) — an exact
+ * match proves the slot still holds THE SAME resting order (key encodes
+ * price AND placement order; free-list slot reuse after a fill/cancel gets a
+ * fresh key), then re-reads LIVE quantity (order sizes only ever shrink while
+ * resting, never grow). A mismatch STOPS the walk at that level (the same
+ * class as manifest's sequence-number check / whirlpool's missing-tick gate).
+ *
+ * MATCH MATH — restricted to exactly what `placeTakeOrder` (Market order
+ * type, no OpenOrdersAccount) actually executes, independently re-derived
+ * from `programs/openbook-v2/src/{state/orderbook/book.rs,
+ * instructions/place_take_order.rs}` and EMPIRICALLY VALIDATED bit-exact
+ * against the REAL openbook-v2 binary (dumped from mainnet-beta) executing
+ * on REAL mainnet Market/BookSide state via LiteSVM, at 3+ sizes per
+ * direction (small / medium / saturating-the-whole-shipped-window) AND with
+ * a realistic nonzero taker/maker fee (a market's `takerFee`/`makerFee` are
+ * per-market constants — the fee arithmetic below was validated by patching
+ * a real market's fee fields to nonzero and re-running the same real CPI):
+ *
+ * - baseIn (sell base, taker side = Ask, opposes the BIDS tree, best = HIGHEST
+ *   key first): `max_base_lots` is the real constraint (uncapped quote side);
+ *   walk full-or-partial matches best-first; `quoteTakenNative = Σ(matchBase
+ *   * priceLots) * quoteLotSize`; a market's maker rebate
+ *   (`market.maker_fee < 0` only — makerRebatePpm is 0 whenever makerFee is
+ *   non-negative, the common case, PRE-COMPUTED at prepare time so the
+ *   fragment never branches on the sign) nets OFF the taker's proceeds:
+ *   `output = quoteTakenNative - floor(quoteTakenNative * makerRebatePpm / 1e6)`.
+ *   Surprisingly (confirmed via the REAL CPI, not just the source read): the
+ *   ASK-side settlement in `place_take_order` does NOT separately deduct
+ *   `takerFee` from the taker's quote proceeds — only `makerRebatePpm` (a
+ *   distinct, usually-zero, per-market negative-maker-fee rebate) nets off
+ *   the literal token transfer; `takerFee` only feeds `market.fees_accrued`
+ *   bookkeeping in this instruction path, not this instruction's OWN token
+ *   movement. Do not "fix" this to also subtract takerFee — that would
+ *   silently move the quote OFF the value the real CPI settles.
+ * - quoteIn (buy base, taker side = Bid, opposes the ASKS tree, best = LOWEST
+ *   key first): the real constraint is quote, applied via OpenBook's own
+ *   `subtract_taker_fees` UPFRONT budget shrink — `remainingQuoteLots =
+ *   floor(floor(x / quoteLotSize) * 1e6 / (1e6 + takerFeePpm))` — this is
+ *   the ONLY place takerFee enters a quoteIn quote (the taker's effective
+ *   buying power is reduced up front; there is no separate fee line-item
+ *   subtracted from the delivered base). `output = ΣmatchBase * baseLotSize`
+ *   (no further adjustment); the actual quote DEBITED (`consumedInput`, what
+ *   the merge's capacityInputVar reports) is `Σ(matchBase*priceLots)*
+ *   quoteLotSize + floor(that * makerRebatePpm / 1e6)` — i.e. even a fully
+ *   absorbed (non-capacity-bound) quoteIn fill structurally consumes LESS
+ *   than the caller's nominal `x` by the taker-fee fraction: this is NOT a
+ *   capacity artefact, it is the real per-trade fee tax, and reporting it
+ *   honestly (rather than pretending consumedInput===x whenever the book has
+ *   depth) is what capacityInputVar's contract calls for.
+ * Both walks self-cap (SATURATE at the shipped window's real depth) rather
+ * than collapse to 0 past capacity — the same contract meteora-damm-v2 /
+ * orca-legacy-token-swap / manifest all fixed for the identical −788.8bps
+ * class of hazard: `capacityInputVar` always reports the PRODUCTIVE input
+ * actually absorbed, never the raw (possibly-unreachable) grid span.
+ *
+ * CPI: `placeTakeOrder` (Anchor disc `sha256("global:place_take_order")[..8]`),
+ * PlaceOrderType::Market (index 3 — ignores `price_lots`/the `priceLots` arg
+ * entirely and matches at ANY price up to the size caps, exactly like
+ * manifest's own `out_atoms=1`/no-independent-price-floor philosophy — the
+ * recipe's own minOut/priceLimit are the real floor, not a per-CPI price
+ * bound) with `limit` (max maker orders touched) baked to the shipped order
+ * count — CRITICAL: a looser `limit` lets the real walk continue matching
+ * PAST the shipped window (measured directly: a `limit` bigger than the
+ * window size delivered MORE than this ladder ever quoted, a real but
+ * unaccounted-for surplus that would desync the merge's own bookkeeping of
+ * what this slot consumed). `side`/`orderType`/the uncapped opposite-side cap
+ * are baked into the prefix/suffix (never runtime-patched — none of them
+ * depend on the traded amount); the ONE runtime-patched u64 is
+ * `max_base_lots` (baseIn) or `max_quote_lots_including_fees` (quoteIn).
+ *
+ * THE ATOMS-VS-LOTS PATCH GAP (why `fill[slot]` gets reassigned in
+ * emitFinalQuote): the `patch: 'in'` amount convention always writes the merge's
+ * raw ATOM-denominated fill share verbatim (`le8(fill[slot])`, see
+ * codegen.ts) — every existing venue's CPI amount field IS atom-denominated,
+ * so this has never needed a conversion hook. OpenBook's `max_base_lots`/
+ * `max_quote_lots_including_fees` are LOT-denominated (a market-specific
+ * power-of-ten divisor), so the raw atom count is the WRONG value to write
+ * there. There is no venue-supplied transform in the patch path, so
+ * `emitFinalQuote`'s LAST emitted statement reassigns the shared `fill[slot]`
+ * local itself (`fill[slot] = fill[slot] / lotSizeConst`) — AFTER computing
+ * this slot's predicted-output quote (which reads the ORIGINAL atom value
+ * first) and BEFORE codegen's own `if (fill[slot] > 0 && p[slot] > 0)` CPI
+ * guard / `le8(fill[slot])` patch line run (both execute in a later,
+ * strictly-after codegen pass over all slots — see codegen.ts's two
+ * sequential `slots.forEach` loops). This is SOUND for every consumer that
+ * matters (the minOut/predicted-output checks and the terminal realized-delta
+ * floor never read `fill[]`, only `p[i]`/the outAta delta) with ONE disclosed
+ * side effect: the raw returndata's `fill[slot]` word reports LOTS, not
+ * atoms, for an engaged openbook-v2 slot (every other slot's `fill[]` stays
+ * atom-denominated) — a caller reconciling `Σfill[i] <= amountIn` numerically
+ * must special-case this venue's slot the same way it would need to for any
+ * lot-quantised venue's *executed* size not equalling its *offered* size.
+ *
+ * Both directions and the atoms/lots patch were EMPIRICALLY VALIDATED end to
+ * end (LiteSVM + the real dumped openbook-v2.so, real mainnet Market/
+ * BookSide/vault state, a real user ATA pair) at 3+ sizes per direction,
+ * including full-window saturation and a realistic nonzero fee — see
+ * test/svm/venues/openbook-v2.test.ts and the real-CPI suite.
+ *
+ * Gates (self-drop, named errors caught by the orchestrator's TOCTOU):
+ * - wrong account size (not 848 for the market, not 90952 for a BookSide) —
+ *   fetch-time, an unrelated/stale/upgraded account layout;
+ * - `openOrdersAdmin` configured (nonzero) — this recipe carries no
+ *   third-party admin signer, so such a market can never be taken via
+ *   `placeTakeOrder` from here; fetch-time gate;
+ * - `timeExpiry != 0 && now >= timeExpiry` — an expired market; the FAMILIES
+ *   gate (mirrors meteora-damm-v2's activation-point pattern, which also
+ *   needs `now` and so cannot live in fetchPoolConfig's own signature);
+ * - a direction with NO shippable Fixed-tree TIF=0 orders — `SvmWindowDriftError`,
+ *   wired via the FAMILIES gate exactly like manifest's empty-window case.
+ */
+import { address } from "@solana/kit";
+import { readUintLE } from "../math.js";
+const SLUG = "openbook-v2";
+export const OPENBOOK_V2_PROGRAM_ID = address("opnb2LAfJYbRMAHHvqjCwQxanZn7ReEHp1k81EohpZb");
+export const MARKET_ACCOUNT_SIZE = 848;
+export const BOOKSIDE_ACCOUNT_SIZE = 90952;
+/** Absolute byte offset of `nodes[0]` within a BookSide account (312 + 528). */
+const NODES_BASE = 840;
+/** Size in bytes of one AnyNode / tree-array slot. */
+const NODE_SIZE = 88;
+const TAG_INNER = 1;
+const TAG_LEAF = 2;
+/** Offsets within a LeafNode-tagged AnyNode (relative to the node's own base). */
+const OFF_LEAF_TIF = 2;
+const OFF_LEAF_KEY = 8;
+/** 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 const OPENBOOK_V2_MAX_ORDERS = 4;
+/** Two's-complement i64 read (readUintLE is unsigned-only) — needed for `makerFee`, which the
+ * venue documents as signable (`maker_fee < 0` means part of the taker fee rebates to the maker). */
+function readInt64LE(data, offset) {
+    const raw = readUintLE(data, offset, 8);
+    const SIGN_BIT = 1n << 63n;
+    return raw >= SIGN_BIT ? raw - (1n << 64n) : raw;
+}
+function readPubkeyIsZero(data, offset) {
+    for (let i = 0; i < 32; i++)
+        if (data[offset + i] !== 0)
+            return false;
+    return true;
+}
+/** Best-first order over the FULL 128-bit key: descending for bids (highest key first), ascending
+ * for asks (lowest key first) — see the header's bookside.rs citation for why price alone is unsafe. */
+function sortBestFirst(orders, descending) {
+    const sorted = [...orders].sort((a, b) => {
+        if (a.key === b.key)
+            return 0;
+        if (descending)
+            return a.key > b.key ? -1 : 1;
+        return a.key < b.key ? -1 : 1;
+    });
+    return sorted;
+}
+/** Walks the Fixed order tree (root index 0) of a BookSide account, collecting every LeafNode with
+ * timeInForce === 0 (see the header: TIF>0 orders are dropped rather than modelled). */
+function walkFixedTree(data) {
+    const maybeNode = readUintLE(data, 8, 4);
+    const leafCount = readUintLE(data, 12, 4);
+    const out = [];
+    if (leafCount === 0n)
+        return out;
+    const stack = [Number(maybeNode)];
+    let visited = 0;
+    const BOUND = 4096; // 1024 slots, generous bound against a malformed/cyclic tree
+    while (stack.length > 0) {
+        if (++visited > BOUND)
+            throw new Error(`${SLUG}: BookSide tree walk exceeded ${BOUND} visits — refusing to loop`);
+        const idx = stack.pop();
+        const nodeOffset = NODES_BASE + idx * NODE_SIZE;
+        const tag = Number(readUintLE(data, nodeOffset, 1));
+        if (tag === TAG_LEAF) {
+            const tif = Number(readUintLE(data, nodeOffset + OFF_LEAF_TIF, 2));
+            if (tif !== 0)
+                continue;
+            const key = readUintLE(data, nodeOffset + OFF_LEAF_KEY, 16);
+            const priceLots = key >> 64n;
+            out.push({ nodeOffset, key, priceLots });
+        }
+        else if (tag === TAG_INNER) {
+            const childrenOff = nodeOffset + 1 + 3 + 4 + 16;
+            stack.push(Number(readUintLE(data, childrenOff, 4)));
+            stack.push(Number(readUintLE(data, childrenOff + 4, 4)));
+        }
+        // Uninitialized / FreeNode / LastFreeNode: dead end, nothing to do.
+    }
+    return out;
+}
+export async function fetchOpenBookV2Config(load, pool) {
+    const market = await load(pool);
+    if (market === null)
+        throw new Error(`${SLUG} market ${pool} does not exist`);
+    if (market.length !== MARKET_ACCOUNT_SIZE) {
+        throw new Error(`${SLUG} market ${pool} has unexpected size ${market.length} (want ${MARKET_ACCOUNT_SIZE})`);
+    }
+    if (!readPubkeyIsZero(market, 88)) {
+        throw new Error(`${SLUG} market ${pool} has a configured openOrdersAdmin — no third-party signer available`);
+    }
+    const timeExpiry = readInt64LE(market, 48);
+    const baseDecimals = Number(readUintLE(market, 9, 1));
+    const quoteDecimals = Number(readUintLE(market, 10, 1));
+    const bidsAccount = decodeAddressFrom(market, 200);
+    const asksAccount = decodeAddressFrom(market, 232);
+    const eventHeap = decodeAddressFrom(market, 264);
+    const oracleAZero = readPubkeyIsZero(market, 296);
+    const oracleBZero = readPubkeyIsZero(market, 328);
+    const oracleA = oracleAZero ? undefined : decodeAddressFrom(market, 296);
+    const oracleB = oracleBZero ? undefined : decodeAddressFrom(market, 328);
+    const quoteLotSize = readUintLE(market, 448, 8);
+    const baseLotSize = readUintLE(market, 456, 8);
+    const makerFeeRaw = readInt64LE(market, 480);
+    const takerFeePpm = readUintLE(market, 488, 8); // always >= 0 by the venue's own invariant
+    const makerRebatePpm = makerFeeRaw >= 0n ? 0n : -makerFeeRaw;
+    const baseMint = decodeAddressFrom(market, 576);
+    const quoteMint = decodeAddressFrom(market, 608);
+    const marketBaseVault = decodeAddressFrom(market, 640);
+    const marketQuoteVault = decodeAddressFrom(market, 680);
+    const marketAuthority = decodeAddressFrom(market, 16);
+    const bidsData = await load(bidsAccount);
+    const asksData = await load(asksAccount);
+    if (bidsData === null || bidsData.length !== BOOKSIDE_ACCOUNT_SIZE) {
+        throw new Error(`${SLUG} market ${pool} bids account is missing or the wrong size`);
+    }
+    if (asksData === null || asksData.length !== BOOKSIDE_ACCOUNT_SIZE) {
+        throw new Error(`${SLUG} market ${pool} asks account is missing or the wrong size`);
+    }
+    const bidsWindow = sortBestFirst(walkFixedTree(bidsData), true).slice(0, OPENBOOK_V2_MAX_ORDERS);
+    const asksWindow = sortBestFirst(walkFixedTree(asksData), false).slice(0, OPENBOOK_V2_MAX_ORDERS);
+    return {
+        venue: SLUG,
+        pool,
+        direction: "baseIn",
+        baseMint,
+        quoteMint,
+        bidsAccount,
+        asksAccount,
+        eventHeap,
+        marketBaseVault,
+        marketQuoteVault,
+        marketAuthority,
+        baseDecimals,
+        quoteDecimals,
+        baseLotSize,
+        quoteLotSize,
+        takerFeePpm,
+        makerRebatePpm,
+        timeExpiry,
+        oracleA,
+        oracleB,
+        windows: { baseIn: { orders: bidsWindow }, quoteIn: { orders: asksWindow } },
+    };
+}
+// --- account address decode (32 raw bytes -> base58 Address) --------------
+// The SDK barrel does not re-export @solana/kit's address codec, and pulling
+// in @solana/kit's getAddressCodec here would be an extra direct dependency
+// this recipe does not otherwise need for a pure-decode path — bs58-encode
+// the 32 raw bytes ourselves (the SAME alphabet/algorithm @solana/kit uses)
+// and validate through `address()`, which is already imported.
+const BASE58_ALPHABET = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz";
+function base58Encode(bytes) {
+    const digits = [0];
+    for (let i = 0; i < bytes.length; i++) {
+        let carry = bytes[i];
+        for (let j = 0; j < digits.length; j++) {
+            carry += digits[j] << 8;
+            digits[j] = carry % 58;
+            carry = (carry / 58) | 0;
+        }
+        while (carry > 0) {
+            digits.push(carry % 58);
+            carry = (carry / 58) | 0;
+        }
+    }
+    let leadingZeros = 0;
+    for (let i = 0; i < bytes.length && bytes[i] === 0; i++)
+        leadingZeros++;
+    let out = "1".repeat(leadingZeros);
+    for (let i = digits.length - 1; i >= 0; i--)
+        out += BASE58_ALPHABET[digits[i]];
+    return out === "" ? "1" : out;
+}
+function decodeAddressFrom(data, offset) {
+    return address(base58Encode(data.subarray(offset, offset + 32)));
+}
+//# sourceMappingURL=index.js.map

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

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

package/sdk/dist/svm/venues/orca-legacy-token-swap/index.d.ts

@@ -0,0 +1,42 @@
+import type { Address } from "@solana/kit";
+import type { AccountBytesMap, AccountLoader, PoolConfig, SwapUser, VenueAccount, VenueSwap } from "../types.js";
+declare const SLUG = "orca-legacy-token-swap";
+export interface OrcaLegacyPoolConfig extends PoolConfig {
+    venue: typeof SLUG;
+    /** Swap-authority PDA: create_program_address([pool, [bump_seed@2]], program). */
+    swapAuthority: Address;
+    /** token_program_id @3. */
+    tokenProgram: Address;
+    /** Vault of the input mint (token_a @35 — quote direction is A → B). */
+    vaultIn: Address;
+    /** Vault of the output mint (token_b @67). */
+    vaultOut: Address;
+    /** pool_mint @99 — writable in the swap ix (owner fee is minted as LP tokens). */
+    poolMint: Address;
+    /** pool_fee_account @195 — pool-mint token account receiving the owner fee. */
+    poolFeeAccount: Address;
+    /** token_a_mint @131. */
+    inputMint: Address;
+    /** token_b_mint @163. */
+    outputMint: Address;
+    /** trade_fee_numerator @227 / trade_fee_denominator @235 (25/10000 on the fixture). */
+    tradeFeeNumerator: bigint;
+    tradeFeeDenominator: bigint;
+    /** owner_trade_fee_numerator @243 / owner_trade_fee_denominator @251 (5/10000 on the fixture). */
+    ownerTradeFeeNumerator: bigint;
+    ownerTradeFeeDenominator: bigint;
+    /** bump_seed @2 — the stored (not necessarily canonical) swap-authority nonce. */
+    bumpSeed: number;
+}
+export declare const orcaLegacyTokenSwap: {
+    slug: string;
+    kind: "constant-product";
+    programId: Address;
+    fetchPoolConfig(load: AccountLoader, pool: Address): Promise<OrcaLegacyPoolConfig>;
+    quoteAccounts(cfg: OrcaLegacyPoolConfig): VenueAccount[];
+    emitQuote(cfg: OrcaLegacyPoolConfig, i: number, amountIn: bigint): string;
+    buildSwap(cfg: OrcaLegacyPoolConfig, user: SwapUser, amountIn: bigint): VenueSwap;
+    referenceQuote(cfg: OrcaLegacyPoolConfig, state: AccountBytesMap, amountIn: bigint, _now: bigint): bigint;
+};
+export {};
+//# sourceMappingURL=index.d.ts.map

package/sdk/dist/svm/venues/orca-legacy-token-swap/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/svm/venues/orca-legacy-token-swap/index.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,UAAU,EAEV,QAAQ,EACR,YAAY,EACZ,SAAS,EACV,MAAM,aAAa,CAAC;AAErB,QAAA,MAAM,IAAI,2BAA2B,CAAC;AAStC,MAAM,WAAW,oBAAqB,SAAQ,UAAU;IACtD,KAAK,EAAE,OAAO,IAAI,CAAC;IACnB,kFAAkF;IAClF,aAAa,EAAE,OAAO,CAAC;IACvB,2BAA2B;IAC3B,YAAY,EAAE,OAAO,CAAC;IACtB,wEAAwE;IACxE,OAAO,EAAE,OAAO,CAAC;IACjB,8CAA8C;IAC9C,QAAQ,EAAE,OAAO,CAAC;IAClB,kFAAkF;IAClF,QAAQ,EAAE,OAAO,CAAC;IAClB,+EAA+E;IAC/E,cAAc,EAAE,OAAO,CAAC;IACxB,yBAAyB;IACzB,SAAS,EAAE,OAAO,CAAC;IACnB,yBAAyB;IACzB,UAAU,EAAE,OAAO,CAAC;IACpB,uFAAuF;IACvF,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kGAAkG;IAClG,sBAAsB,EAAE,MAAM,CAAC;IAC/B,wBAAwB,EAAE,MAAM,CAAC;IACjC,kFAAkF;IAClF,QAAQ,EAAE,MAAM,CAAC;CAClB;AA8CD,eAAO,MAAM,mBAAmB;;;;0BAKF,aAAa,QAAQ,OAAO,GAAG,OAAO,CAAC,oBAAoB,CAAC;uBAwErE,oBAAoB,GAAG,YAAY,EAAE;mBAUzC,oBAAoB,KAAK,MAAM,YAAY,MAAM,GAAG,MAAM;mBAiB1D,oBAAoB,QAAQ,QAAQ,YAAY,MAAM,GAAG,SAAS;wBAiC1E,oBAAoB,SAClB,eAAe,YACZ,MAAM,QACV,MAAM,GACX,MAAM;CAqBgB,CAAC"}

package/sdk/dist/svm/venues/orca-legacy-token-swap/index.js

@@ -0,0 +1,209 @@
+/**
+ * Orca legacy token-swap (v2) venue adapter — closed-source fork of the SPL
+ * token-swap program (spl-token-swap token-swap-v2.1.0 layout/math): SwapV1
+ * pool account (324 bytes, manual Pack, no discriminator), raw SPL vault
+ * balances as curve reserves (both fees stay in the vaults; the owner fee is
+ * compensated by minting LP tokens to pool_fee_account), input-side fees with
+ * the floor-min-1 rule, and a ceiling-divided constant-product curve that
+ * rounds against the trader. Constant-product (curve_type == 0) pools only.
+ *
+ * Quote direction is token A → token B, matching the pinned worked example
+ * (SOL in → USDC out on the EGZ7ti... fixture pool).
+ */
+import { createHash } from "node:crypto";
+import { getAddressCodec } from "@solana/kit";
+import { readUintLE, ceilDiv } from "../math.js";
+const SLUG = "orca-legacy-token-swap";
+/** Orca v2 fork of spl-token-swap, mainnet (v1 DjVE6... is deprecated and out of scope). */
+const PROGRAM_ID = "9W959DqEETiGZocYWCQPaJ6sBmUzgfxXfqGeTEdp3aQP";
+// SwapVersion::pack writes version at byte 0 and the 323-byte SwapV1 body at
+// bytes 1..: 1 + 323 = 324, no discriminator, no padding.
+const POOL_SIZE = 324;
+/**
+ * fees.rs calculate_fee: zero when the rate or the amount is zero, otherwise
+ * floor(x * n / d) but at least 1 raw unit (dust swaps pay 2 units total on
+ * the fixture since both rates are nonzero).
+ */
+function swapFee(x, numerator, denominator) {
+    if (numerator === 0n || x === 0n)
+        return 0n;
+    const fee = (x * numerator) / denominator;
+    return fee === 0n ? 1n : fee;
+}
+/** Fees are baked into the emitted quote, so netIn is compile-time for a fixed amountIn. */
+function netAmountIn(cfg, amountIn) {
+    if (amountIn <= 0n || amountIn >= 1n << 64n) {
+        throw new Error(`${SLUG} amountIn must be a positive u64, got ${amountIn}`);
+    }
+    const tradeFee = swapFee(amountIn, cfg.tradeFeeNumerator, cfg.tradeFeeDenominator);
+    const ownerFee = swapFee(amountIn, cfg.ownerTradeFeeNumerator, cfg.ownerTradeFeeDenominator);
+    const netIn = amountIn - tradeFee - ownerFee;
+    if (netIn <= 0n)
+        throw new Error(`${SLUG} amountIn ${amountIn} is consumed entirely by fees`);
+    return netIn;
+}
+/**
+ * create_program_address for the STORED bump (the pool may have been
+ * initialized with a non-canonical nonce, so find-style derivation is wrong
+ * here). No on-curve rejection: the pool exists on-chain with this bump, so
+ * the derivation is already known to be off-curve. Verified on the fixture:
+ * sha256(pool || 0xFC || program || 'ProgramDerivedAddress') = JU8km...
+ */
+function deriveSwapAuthority(pool, bumpSeed) {
+    const codec = getAddressCodec();
+    return codec.decode(createHash("sha256")
+        .update(new Uint8Array(codec.encode(pool)))
+        .update(Uint8Array.of(bumpSeed))
+        .update(new Uint8Array(codec.encode(PROGRAM_ID)))
+        .update("ProgramDerivedAddress")
+        .digest());
+}
+const poolRef = (cfg, role) => `${SLUG}:${cfg.pool}:${role}`;
+export const orcaLegacyTokenSwap = {
+    slug: SLUG,
+    kind: "constant-product",
+    programId: PROGRAM_ID,
+    async fetchPoolConfig(load, pool) {
+        const data = await load(pool);
+        if (data === null)
+            throw new Error(`${SLUG} pool ${pool} account not found`);
+        if (data.length !== POOL_SIZE) {
+            throw new Error(`${SLUG} pool ${pool} data must be ${POOL_SIZE} bytes (SwapVersion::SwapV1), got ${data.length}`);
+        }
+        if (data[0] !== 1)
+            throw new Error(`${SLUG} pool ${pool} version must be 1 (SwapV1), got ${data[0]}`);
+        if (data[1] !== 1)
+            throw new Error(`${SLUG} pool ${pool} is not initialized`);
+        // Orca's fork also ran stable pools (nonzero curve_type, amp in the
+        // calculator blob) — this adapter grounds only the constant-product curve.
+        if (data[291] !== 0) {
+            throw new Error(`${SLUG} pool ${pool} curve_type must be 0 (constant product), got ${data[291]}`);
+        }
+        const codec = getAddressCodec();
+        const pubkey = (offset) => codec.decode(data.subarray(offset, offset + 32));
+        const u64 = (offset) => readUintLE(data, offset, 8);
+        const tradeFeeNumerator = u64(227);
+        const tradeFeeDenominator = u64(235);
+        const ownerTradeFeeNumerator = u64(243);
+        const ownerTradeFeeDenominator = u64(251);
+        for (const [name, numerator, denominator] of [
+            ["trade", tradeFeeNumerator, tradeFeeDenominator],
+            ["owner trade", ownerTradeFeeNumerator, ownerTradeFeeDenominator],
+        ]) {
+            if (numerator !== 0n && denominator === 0n) {
+                throw new Error(`${SLUG} pool ${pool} ${name} fee denominator is 0 with nonzero numerator ${numerator}`);
+            }
+        }
+        // Per-side token program: the legacy spl-token-swap program stores ONE
+        // token_program_id (@3) for the whole pool and CPIs both legs through it —
+        // there is no per-mint program to thread, and this reads the pool's own
+        // stored program (not a hardcoded legacy id), so a pool created against
+        // Token-2022 is threaded correctly. The constant-product referenceQuote/
+        // emitQuote read only the raw vault balances (SPL token account amount @64,
+        // identical on both token programs), so a zero-fee Token-2022 pool quotes
+        // byte-identically to a legacy one.
+        // TODO(t22-fee-netting): this adapter never fetches the mint accounts, so a
+        // Token-2022 TransferFeeConfig on a leg is neither detected nor netted. Such
+        // a pool would over-quote (the wire haircut is unmodeled). Adding netting
+        // needs a mint fetch (to read the fee config + current epoch) plus matching
+        // netting in BOTH referenceQuote and emitQuote — deferred; these legacy
+        // pools are legacy-token in practice, so the exposure is negligible today.
+        const bumpSeed = data[2];
+        return {
+            venue: SLUG,
+            pool,
+            swapAuthority: deriveSwapAuthority(pool, bumpSeed),
+            tokenProgram: pubkey(3),
+            vaultIn: pubkey(35),
+            vaultOut: pubkey(67),
+            poolMint: pubkey(99),
+            inputMint: pubkey(131),
+            outputMint: pubkey(163),
+            poolFeeAccount: pubkey(195),
+            tradeFeeNumerator,
+            tradeFeeDenominator,
+            ownerTradeFeeNumerator,
+            ownerTradeFeeDenominator,
+            bumpSeed,
+        };
+    },
+    quoteAccounts(cfg) {
+        // Reserves ARE the raw vault balances (nothing to subtract): fees remain
+        // in the vaults as tokens. Fee rates are immutable SwapV1 fields, baked
+        // from cfg — the quote reads only the two vault amounts.
+        return [
+            { ref: poolRef(cfg, "vault-in"), address: cfg.vaultIn },
+            { ref: poolRef(cfg, "vault-out"), address: cfg.vaultOut },
+        ];
+    },
+    emitQuote(cfg, i, amountIn) {
+        const netIn = netAmountIn(cfg, amountIn);
+        // amountOut = rsOut - ceil(rsIn * rsOut / (rsIn + netIn)), ceiled via
+        // (num + den - 1) / den. Reserves are u64, so rsIn * rsOut <= 2^128 and
+        // nothing here approaches the engine's 256-bit wrap ("All arithmetic in
+        // u128" — docs/svm-venues.md); no Math.mulDiv needed.
+        // Account model (RS/svm target): reads go through main()'s ordered `Account`
+        // params, not `accountUint("<address>", …)` string refs. Param `acc<k>` is
+        // `quoteAccounts()[k]` — vault-in is slot 0, vault-out slot 1 — and `accountUint`
+        // lowered to CAST_LE, so `svm.sload(…).toLe()` is the exact endianness match.
+        return [
+            `const rIn${i} = svm.sload(acc0, 64, 8).toLe();`,
+            `const rOut${i} = svm.sload(acc1, 64, 8).toLe();`,
+            `const q${i} = rOut${i} - (rIn${i} * rOut${i} + rIn${i} + ${netIn - 1n}) / (rIn${i} + ${netIn});`,
+        ].join("\n");
+    },
+    buildSwap(cfg, user, amountIn) {
+        if (amountIn <= 0n || amountIn >= 1n << 64n) {
+            throw new Error(`${SLUG} amountIn must be a positive u64, got ${amountIn}`);
+        }
+        // SwapInstruction::Swap: [tag=1][amount_in u64 LE][minimum_amount_out u64
+        // LE]. min_out is 1 — the recipe's post-swap delta check enforces the
+        // real bound.
+        const data = new Uint8Array(17);
+        data[0] = 1;
+        new DataView(data.buffer).setBigUint64(1, amountIn, true);
+        new DataView(data.buffer).setBigUint64(9, 1n, true);
+        return {
+            programId: PROGRAM_ID,
+            data,
+            // instruction.rs Swap account list 0-9; the optional host fee account
+            // (10) is omitted.
+            accounts: [
+                { ref: poolRef(cfg, "pool"), address: cfg.pool },
+                { ref: poolRef(cfg, "authority"), address: cfg.swapAuthority },
+                { ref: user.owner, signer: true },
+                { ref: user.inAta, writable: true },
+                { ref: poolRef(cfg, "vault-in"), address: cfg.vaultIn, writable: true },
+                { ref: poolRef(cfg, "vault-out"), address: cfg.vaultOut, writable: true },
+                { ref: user.outAta, writable: true },
+                { ref: poolRef(cfg, "pool-mint"), address: cfg.poolMint, writable: true },
+                { ref: poolRef(cfg, "fee-account"), address: cfg.poolFeeAccount, writable: true },
+                { ref: poolRef(cfg, "token-program"), address: cfg.tokenProgram },
+            ],
+        };
+    },
+    referenceQuote(cfg, state, amountIn, _now) {
+        const vaults = [];
+        for (const vault of [cfg.vaultIn, cfg.vaultOut]) {
+            const data = state[vault];
+            if (data === undefined)
+                throw new Error(`${SLUG} vault ${vault} missing from state`);
+            vaults.push(data);
+        }
+        // SPL token account amount, u64 LE @64 — raw balances are the reserves.
+        const rsIn = readUintLE(vaults[0], 64, 8);
+        const rsOut = readUintLE(vaults[1], 64, 8);
+        const netIn = netAmountIn(cfg, amountIn);
+        const invariant = rsIn * rsOut;
+        const newIn = rsIn + netIn;
+        // checked_ceil_div maps a zero floor-quotient to None before ceiling.
+        if (invariant / newIn === 0n)
+            throw new Error(`${SLUG} swap fails on-chain (zero quotient)`);
+        const newOut = ceilDiv(invariant, newIn);
+        const amountOut = rsOut - newOut;
+        if (amountOut === 0n)
+            throw new Error(`${SLUG} swap fails on-chain (zero output)`);
+        return amountOut;
+    },
+};
+//# sourceMappingURL=index.js.map

package/sdk/dist/svm/venues/orca-legacy-token-swap/index.js.map

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