@eco-incorp/sauce 0.99.0

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

@@ -0,0 +1,99 @@
+import type { Address } from "@solana/kit";
+import type { AccountLoader, PoolConfig, SwapUser, VenueAccount, VenueSwap } from "../types.js";
+declare const SLUG = "deriverse";
+export declare const DERIVERSE_PROGRAM_ID: Address;
+/**
+ * `find_program_address([b"ndxnt"], programId)` — ONE PDA for the whole
+ * program (drv-smart-contract-common's `DRVS_SEED`), independent of any
+ * pool. Hardcoded (verified against mainnet via an offline PDA derivation,
+ * not read from any account) exactly like raydium-amm-v4's `AMM_AUTHORITY`.
+ */
+export declare const DERIVERSE_AUTH: Address;
+/**
+ * The front slice of `InstrAccountHeader` this adapter reads (1064 bytes,
+ * drv-smart-contract-common v0.2.68). The LIVE deployed account is larger
+ * (2344 bytes observed on both checked instruments) — the extra bytes are
+ * unread reserved tail space (candle/history buffers not yet promoted to
+ * named fields), exactly the pattern jupiter-deriverse's own
+ * `AccountsHolder::from_account` relies on (`&data[0..size_of::<T>()]`).
+ * fetchPoolConfig accepts anything >= this size, never an exact match.
+ */
+export declare const INSTR_ACCOUNT_HEADER_MIN_SIZE = 1064;
+export declare const OFF_MASK = 28;
+export declare const OFF_LAST_PX = 32;
+export declare const OFF_ASSET_TOKENS = 144;
+export declare const OFF_CRNCY_TOKENS = 152;
+export declare const OFF_DEC_FACTOR = 800;
+export declare const MASK_SUSPENDED = 32;
+/**
+ * Bakes ONE conservative fee-ppm constant from a fetch-time snapshot of the
+ * instrument's fee inputs. `ZeroFees` (mask bit 0x1) is a protocol invariant
+ * that zeros BOTH the AMM fee_rate and the protocol swap_fee_rate (lib.rs's
+ * `quote()`, both branches check it first) — trusted exactly, no margin.
+ * Otherwise: `FixedFees` (0x2) uses the admin-set static `fixed_fee_rate`;
+ * the default case uses the DYNAMIC `day_volatility * spot_fee_rate *
+ * FEE_RATE_STEP`, which can drift between this snapshot and the eventual
+ * cook (it is a live, per-trade-recalculated statistic, not frozen). Either
+ * way the raw ppm is DOUBLED plus a flat +20ppm floor: the margin absorbs
+ * (a) day_volatility drift and (b) the deployed binary's protocol-level
+ * `swap_fee_rate` (currently the constant 0 in the drv-models crate, but not
+ * independently re-derivable from account state, and a bigger assumed fee
+ * only ever LOWERS the predicted output — the safe direction; assuming it
+ * stays 0 is the unsafe one). This is the ONLY fee derivation this adapter
+ * does off-chain; the ladder never reads day_volatility/fixed_fee_rate live.
+ */
+export declare function conservativeFeePpm(mask: number, dayVolatility: number, spotFeeRate: number, fixedFeeRate: number): bigint;
+export interface DeriversePoolConfig extends PoolConfig {
+    venue: typeof SLUG;
+    /** 'sell' (default, asset in / crncy out — input_crncy=0) | 'buy' (crncy in / asset out — input_crncy=1). */
+    side: "buy" | "sell";
+    instrId: number;
+    assetTokenId: number;
+    crncyTokenId: number;
+    assetMint: Address;
+    crncyMint: Address;
+    /** The instrument's own asset/crncy vault token accounts (a_token_state/b_token_state.program_address). */
+    assetVault: Address;
+    crncyVault: Address;
+    asksTree: Address;
+    askOrders: Address;
+    bidsTree: Address;
+    bidOrders: Address;
+    lines: Address;
+    mapsAddress: Address;
+    clientInfos: Address;
+    tokenProgram: Address;
+    /** Conservative baked fee (see {@link conservativeFeePpm}), ppm of 1e6. */
+    feePpm: bigint;
+}
+export declare const deriverse: {
+    slug: string;
+    kind: "constant-product";
+    programId: Address;
+    /**
+     * Off-chain gate + decode. Rejects: too-short account data, a non-INSTR
+     * discriminator or an unrecognized schema version (defends the fixed
+     * offsets above against a future account-layout migration), and an empty
+     * `dec_factor` (would divide by zero in the curve). An empty embedded AMM
+     * (`asset_tokens == crncy_tokens == 0`, a real live case — the pair trades
+     * purely off its resting book) is NOT rejected here: it is a live-state
+     * fact the ladder's own enable gate reads every quote, exactly like a
+     * drained obric-v2/raydium pool.
+     */
+    fetchPoolConfig(load: AccountLoader, pool: Address): Promise<DeriversePoolConfig>;
+    quoteAccounts(cfg: PoolConfig): VenueAccount[];
+    /** v1 swap CPI (amount baked) — the unified `Swap` instruction (tag 26). */
+    buildSwap(cfg: PoolConfig, user: SwapUser, amountIn: bigint): VenueSwap;
+};
+/**
+ * The 14-account order for Deriverse's `Swap` (disc 26 — SwapInstruction::
+ * MIN_ACCOUNTS), shared by v1 buildSwap and v2 buildSwapV2: [signer, asset
+ * mint, crncy mint, asset vault, crncy vault, instrument, {asks_tree,
+ * ask_orders} on buy / {bids_tree, bid_orders} on sell, lines, maps, client
+ * infos, asset-side user ATA, crncy-side user ATA, token program]. User ATAs
+ * are POSITIONAL BY MINT (asset vs crncy), not by direction — the same trap
+ * documented on solfi-v2/quantum.
+ */
+export declare function deriverseSwapAccounts(c: DeriversePoolConfig, user: SwapUser, make: (ref: string, addr: Address, writable?: boolean) => VenueAccount, refFor?: (role: string) => string): VenueAccount[];
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/svm/venues/deriverse/index.ts"],"names":[],"mappings":"AAuEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAIhG,QAAA,MAAM,IAAI,cAAc,CAAC;AAEzB,eAAO,MAAM,oBAAoB,EAAqD,OAAO,CAAC;AAG9F;;;;;GAKG;AACH,eAAO,MAAM,cAAc,EAAqD,OAAO,CAAC;AAYxF;;;;;;;;GAQG;AACH,eAAO,MAAM,6BAA6B,OAAO,CAAC;AAsBlD,eAAO,MAAM,QAAQ,KAAK,CAAC;AAC3B,eAAO,MAAM,WAAW,KAAK,CAAC;AAC9B,eAAO,MAAM,gBAAgB,MAAM,CAAC;AACpC,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAIpC,eAAO,MAAM,cAAc,MAAM,CAAC;AAOlC,eAAO,MAAM,cAAc,KAAO,CAAC;AAoCnC;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,MAAM,CAOR;AAED,MAAM,WAAW,mBAAoB,SAAQ,UAAU;IACrD,KAAK,EAAE,OAAO,IAAI,CAAC;IACnB,6GAA6G;IAC7G,IAAI,EAAE,KAAK,GAAG,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,2GAA2G;IAC3G,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,EAAE,OAAO,CAAC;IACtB,2EAA2E;IAC3E,MAAM,EAAE,MAAM,CAAC;CAChB;AAUD,eAAO,MAAM,SAAS;;;;IAKpB;;;;;;;;;OASG;0BACyB,aAAa,QAAQ,OAAO,GAAG,OAAO,CAAC,mBAAmB,CAAC;uBAkJpE,UAAU,GAAG,YAAY,EAAE;IAK9C,4EAA4E;mBAC7D,UAAU,QAAQ,QAAQ,YAAY,MAAM,GAAG,SAAS;CAoBxE,CAAC;AAeF;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,CAAC,EAAE,mBAAmB,EACtB,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,OAAO,KAAK,YAAY,EACtE,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAChC,YAAY,EAAE,CAsBhB"}

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

@@ -0,0 +1,388 @@
+/**
+ * Deriverse venue adapter (program DRVSpZ2YUYYKgZP8XtLhAGtT1zYSCKzeHfb4DgRnrgqD) —
+ * a hybrid CLOB + embedded constant-product AMM. No IDL/docs exist; this
+ * adapter was built by reading Deriverse's own public repos: the `drv-models`
+ * common-types crate (github.com/deriverse/drv-smart-contract-common, MIT/
+ * public, tag v0.2.68 — `InstrAccountHeader`'s exact `#[repr(C)]` layout, the
+ * `Swap` instruction's `SwapData` encoding and account order) and the
+ * `jupiter-deriverse` aggregator adapter (github.com/deriverse/jupiter-deriverse)
+ * — a REFERENCE IMPLEMENTATION of the venue's own quote math (`amm.rs`,
+ * `lib.rs`'s `quote()`), which this adapter's formula is transcribed from and
+ * deliberately NARROWS (see below).
+ *
+ * WHAT WE MODEL (and what we deliberately don't): each Deriverse "instrument"
+ * (a market between an `asset` token and a `crncy` token) carries an EMBEDDED
+ * constant-product AMM directly in its header — `asset_tokens`/`crncy_tokens`
+ * (raw reserves) and `k = asset_tokens * crncy_tokens` is the invariant used
+ * throughout `amm.rs`'s `get_amm_qty`/`get_amm_sum`/`get_reversed_amm_*`. The
+ * SAME instrument ALSO carries a resting-order CLOB (bid/ask "lines", walked
+ * by `order_book.rs`) that Jupiter's `quote()` interleaves with the AMM by
+ * price. This adapter models ONLY the embedded AMM leg and ignores the book
+ * entirely — a pool with real resting-order depth is under-quoted here, NEVER
+ * over-quoted (empirically confirmed: cross-checked against Jupiter's own
+ * `dexes=Deriverse`-filtered quote at three sizes on the live wSOL/USDC
+ * instrument, our AMM-only figure sat within ~10-15bps of Jupiter's number at
+ * a 0.1 SOL trade and increasingly BELOW it at 1/5 SOL, exactly the signature
+ * of excluded book depth becoming material at size — see ladder.ts's header
+ * for the numbers). A pair whose embedded AMM is empty (`asset_tokens ==
+ * crncy_tokens == 0`, real for at least one live pair) quotes 0 here even
+ * though Jupiter fills it purely from the book — a correct, disclosed
+ * under-quote, not a bug.
+ *
+ * FEE MODEL: `spot_fee_rate`/`fixed_fee_rate`/`day_volatility` are read once
+ * at fetchPoolConfig time and folded into ONE conservative `feePpm` cfg
+ * param (see `conservativeFeePpm`'s doc) rather than read live — the
+ * dynamic (day_volatility-scaled) fee component is an f64 field with no
+ * cheap on-chain integer decode, so it is baked off-chain with a documented
+ * safety margin (2x + a flat floor) that only ever widens the fee, never
+ * narrows it, keeping the baked snapshot conservative against both
+ * volatility drift and an unmodelled/nonzero protocol `swap_fee_rate`.
+ *
+ * CIRCUIT BREAKER: the real `Swap`/`NewSpotOrder` path stops filling once
+ * the AMM's own marginal price would move beyond ±(last_px >> 3) (or >> 4
+ * for `SimilarAssets` pairs) from the instrument's `last_px` — ladder.ts
+ * enforces the TIGHTER `>> 4` bound unconditionally via a live isqrt-based
+ * capacity clamp (mirrors obric-v2's capacity-clamp shape), so a large
+ * trade SATURATES at the breaker instead of a pure, unclamped curve
+ * over-promising past what the real instruction would ever deliver.
+ *
+ * SCOPE GATE: Tokenkeg-only. Mint addresses come straight from the
+ * instrument header; the VAULT addresses do not (a Deriverse `TokenState`
+ * bookkeeping PDA per mint carries the real vault in its own
+ * `program_address` field, distinct from the TokenState PDA itself — see
+ * fetchPoolConfig), so resolving the swap CPI's account list needs two
+ * extra one-time reads (never repeated per quote — the ladder's live
+ * reads are the pool account alone). Both legs are assumed classic Tokenkeg
+ * (one token program for the whole swap), matching raydium-amm-v4/
+ * obric-v2's own "Tokenkeg-only, no Token-2022" scope note; a Token-2022
+ * transfer-fee mint would desync the wire amount from the curve and is out
+ * of scope for this first integration.
+ *
+ * NOTE — RELOCATED LADDER. This venue's merge-decomposition ladder used to sit
+ * next to this file as `./ladder.ts`; it now lives in the consuming recipes
+ * package, which defines every `*Ladder`, window selector and rung-feeding
+ * decomposition helper itself. The SDK keeps only the generic venue
+ * integration below (pool-account decode, program ids, pool-config types, and
+ * the AMM/tick math the decode needs). Every `ladder.ts` reference in the text
+ * above therefore points at that relocated module, not at a file in this
+ * directory.
+ */
+import { getAddressCodec, getAddressEncoder } from "@solana/kit";
+import { memoizedGetProgramDerivedAddress } from "../pda-memo.js";
+import { TOKEN_2022_PROGRAM_ID, classifyMintProgram } from "../../token-program.js";
+import { parseMintExtensions } from "../../token-extensions.js";
+const SLUG = "deriverse";
+export const DERIVERSE_PROGRAM_ID = "DRVSpZ2YUYYKgZP8XtLhAGtT1zYSCKzeHfb4DgRnrgqD";
+const TOKEN_PROGRAM = "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA";
+/**
+ * `find_program_address([b"ndxnt"], programId)` — ONE PDA for the whole
+ * program (drv-smart-contract-common's `DRVS_SEED`), independent of any
+ * pool. Hardcoded (verified against mainnet via an offline PDA derivation,
+ * not read from any account) exactly like raydium-amm-v4's `AMM_AUTHORITY`.
+ */
+export const DERIVERSE_AUTH = "5QLXhNtkVUEtCyzZ6C1iAavT2x6c6t6LdJcSwVnqWEii";
+const VERSION = 1;
+// account_type tags (drv-smart-contract-common state/types.rs).
+const TAG_INSTR = 7;
+const TAG_SPOT_CLIENT_INFOS = 12;
+const TAG_SPOT_BIDS_TREE = 14;
+const TAG_SPOT_ASKS_TREE = 15;
+const TAG_SPOT_BID_ORDERS = 16;
+const TAG_SPOT_ASK_ORDERS = 17;
+const TAG_SPOT_LINES = 18;
+/**
+ * The front slice of `InstrAccountHeader` this adapter reads (1064 bytes,
+ * drv-smart-contract-common v0.2.68). The LIVE deployed account is larger
+ * (2344 bytes observed on both checked instruments) — the extra bytes are
+ * unread reserved tail space (candle/history buffers not yet promoted to
+ * named fields), exactly the pattern jupiter-deriverse's own
+ * `AccountsHolder::from_account` relies on (`&data[0..size_of::<T>()]`).
+ * fetchPoolConfig accepts anything >= this size, never an exact match.
+ */
+export const INSTR_ACCOUNT_HEADER_MIN_SIZE = 1064;
+/**
+ * TokenState (drv-smart-contract-common state/token.rs): discriminator(8) +
+ * address(32) + program_address(32) + id(4) + mask(4) + reserved(4) +
+ * base_crncy_index(4) = 88 bytes, verified against real mainnet dumps
+ * (wSOL/USDC/USDT all decode to exactly 88 bytes). `program_address` (the
+ * REAL vault SPL token account, distinct from the TokenState PDA itself) is
+ * at offset 40.
+ */
+const TOKEN_STATE_SIZE = 88;
+const OFF_TOKEN_STATE_PROGRAM_ADDRESS = 40;
+// InstrAccountHeader field offsets — all within the STABLE PREFIX (< byte
+// 480, before asset_mint/crncy_mint), verified against real mainnet accounts
+// by locating the wSOL/USDC and USDT/USDC instruments' own mint bytes at
+// offsets 416/448 (see ladder.ts's header for the full derivation note).
+const OFF_DISCRIMINATOR_TAG = 0; // u32
+const OFF_DISCRIMINATOR_VERSION = 4; // u32
+const OFF_INSTR_ID = 8; // u32
+const OFF_ASSET_TOKEN_ID = 12; // u32
+const OFF_CRNCY_TOKEN_ID = 16; // u32
+export const OFF_MASK = 28; // u32
+export const OFF_LAST_PX = 32; // i64
+export const OFF_ASSET_TOKENS = 144; // i64
+export const OFF_CRNCY_TOKENS = 152; // i64
+const OFF_MAPS_ADDRESS = 352; // Pubkey
+const OFF_ASSET_MINT = 416; // Pubkey
+const OFF_CRNCY_MINT = 448; // Pubkey
+export const OFF_DEC_FACTOR = 800; // i64
+const OFF_FIXED_FEE_RATE = 1024; // f64
+const OFF_SPOT_FEE_RATE = 1058; // u8
+// InstrFlag bits (drv-smart-contract-common state/masks.rs).
+const MASK_ZERO_FEES = 0x1;
+const MASK_FIXED_FEES = 0x2;
+export const MASK_SUSPENDED = 0x20;
+/** FEE_RATE_STEP (drv-smart-contract-common constants.rs). */
+const FEE_RATE_STEP = 0.0005;
+function seedById(version, tag, id1, id2) {
+    const buf = new Uint8Array(16);
+    const dv = new DataView(buf.buffer);
+    dv.setUint32(0, version, true);
+    dv.setUint32(4, tag, true);
+    dv.setUint32(8, id1, true);
+    dv.setUint32(12, id2, true);
+    return buf;
+}
+/** `find_program_address([seed_by_id(VERSION, tag, assetId, crncyId), DERIVERSE_AUTH], programId)`. */
+async function spotAcc(tag, assetTokenId, crncyTokenId) {
+    const authBytes = getAddressEncoder().encode(DERIVERSE_AUTH);
+    return memoizedGetProgramDerivedAddress(DERIVERSE_PROGRAM_ID, [
+        seedById(VERSION, tag, assetTokenId, crncyTokenId),
+        authBytes,
+    ]);
+}
+function readFloat64LE(data, offset) {
+    return new DataView(data.buffer, data.byteOffset, data.byteLength).getFloat64(offset, true);
+}
+function readUint32LE(data, offset) {
+    return new DataView(data.buffer, data.byteOffset, data.byteLength).getUint32(offset, true);
+}
+function readInt64LE(data, offset) {
+    return new DataView(data.buffer, data.byteOffset, data.byteLength).getBigInt64(offset, true);
+}
+/**
+ * Bakes ONE conservative fee-ppm constant from a fetch-time snapshot of the
+ * instrument's fee inputs. `ZeroFees` (mask bit 0x1) is a protocol invariant
+ * that zeros BOTH the AMM fee_rate and the protocol swap_fee_rate (lib.rs's
+ * `quote()`, both branches check it first) — trusted exactly, no margin.
+ * Otherwise: `FixedFees` (0x2) uses the admin-set static `fixed_fee_rate`;
+ * the default case uses the DYNAMIC `day_volatility * spot_fee_rate *
+ * FEE_RATE_STEP`, which can drift between this snapshot and the eventual
+ * cook (it is a live, per-trade-recalculated statistic, not frozen). Either
+ * way the raw ppm is DOUBLED plus a flat +20ppm floor: the margin absorbs
+ * (a) day_volatility drift and (b) the deployed binary's protocol-level
+ * `swap_fee_rate` (currently the constant 0 in the drv-models crate, but not
+ * independently re-derivable from account state, and a bigger assumed fee
+ * only ever LOWERS the predicted output — the safe direction; assuming it
+ * stays 0 is the unsafe one). This is the ONLY fee derivation this adapter
+ * does off-chain; the ladder never reads day_volatility/fixed_fee_rate live.
+ */
+export function conservativeFeePpm(mask, dayVolatility, spotFeeRate, fixedFeeRate) {
+    if ((mask & MASK_ZERO_FEES) !== 0)
+        return 0n;
+    const raw = (mask & MASK_FIXED_FEES) !== 0 ? fixedFeeRate : dayVolatility * spotFeeRate * FEE_RATE_STEP;
+    if (!Number.isFinite(raw) || raw < 0)
+        return 20n; // defensive floor on a garbage read
+    const ppm = Math.ceil(raw * 1_000_000) * 2 + 20;
+    return BigInt(ppm);
+}
+function deriverseConfig(cfg) {
+    if (cfg.venue !== SLUG)
+        throw new Error(`${SLUG} adapter got a config for venue '${cfg.venue}'`);
+    const c = cfg;
+    if (c.side !== "buy" && c.side !== "sell")
+        throw new Error(`${SLUG} side must be 'buy' or 'sell', got '${c.side}'`);
+    return c;
+}
+export const deriverse = {
+    slug: SLUG,
+    kind: "constant-product",
+    programId: DERIVERSE_PROGRAM_ID,
+    /**
+     * Off-chain gate + decode. Rejects: too-short account data, a non-INSTR
+     * discriminator or an unrecognized schema version (defends the fixed
+     * offsets above against a future account-layout migration), and an empty
+     * `dec_factor` (would divide by zero in the curve). An empty embedded AMM
+     * (`asset_tokens == crncy_tokens == 0`, a real live case — the pair trades
+     * purely off its resting book) is NOT rejected here: it is a live-state
+     * fact the ladder's own enable gate reads every quote, exactly like a
+     * drained obric-v2/raydium pool.
+     */
+    async fetchPoolConfig(load, pool) {
+        const data = await load(pool);
+        if (data === null)
+            throw new Error(`${SLUG} pool ${pool} account not found`);
+        if (data.length < INSTR_ACCOUNT_HEADER_MIN_SIZE) {
+            throw new Error(`${SLUG} pool ${pool} account is ${data.length} bytes, expected at least ${INSTR_ACCOUNT_HEADER_MIN_SIZE} (InstrAccountHeader)`);
+        }
+        const tag = readUint32LE(data, OFF_DISCRIMINATOR_TAG);
+        const version = readUint32LE(data, OFF_DISCRIMINATOR_VERSION);
+        if (tag !== TAG_INSTR) {
+            throw new Error(`${SLUG} pool ${pool} is not an Instrument account (discriminator tag ${tag}, expected ${TAG_INSTR})`);
+        }
+        if (version !== VERSION) {
+            throw new Error(`${SLUG} pool ${pool} is schema version ${version}, this adapter only decodes version ${VERSION}`);
+        }
+        const decFactor = readInt64LE(data, OFF_DEC_FACTOR);
+        if (decFactor <= 0n)
+            throw new Error(`${SLUG} pool ${pool} has a non-positive dec_factor (${decFactor})`);
+        const instrId = readUint32LE(data, OFF_INSTR_ID);
+        const assetTokenId = readUint32LE(data, OFF_ASSET_TOKEN_ID);
+        const crncyTokenId = readUint32LE(data, OFF_CRNCY_TOKEN_ID);
+        const mask = readUint32LE(data, OFF_MASK);
+        const dayVolatility = readFloat64LE(data, 344);
+        const spotFeeRate = data[OFF_SPOT_FEE_RATE];
+        const fixedFeeRate = readFloat64LE(data, OFF_FIXED_FEE_RATE);
+        const feePpm = conservativeFeePpm(mask, dayVolatility, spotFeeRate, fixedFeeRate);
+        const codec = getAddressCodec();
+        const pubkeyAt = (offset) => codec.decode(data.subarray(offset, offset + 32));
+        const assetMint = pubkeyAt(OFF_ASSET_MINT);
+        const crncyMint = pubkeyAt(OFF_CRNCY_MINT);
+        const mapsAddress = pubkeyAt(OFF_MAPS_ADDRESS);
+        // Both legs are assumed classic Tokenkeg (see the SCOPE GATE note above):
+        // this venue's Swap ix is legacy-SPL only, so a Token-2022 mint (or one
+        // carrying an un-routable extension) must SELF-DROP the pool rather than be
+        // silently assumed legacy. The thrown error IS the graceful-drop signal
+        // (the SvmRoute orchestrator catches it and drops the venue). An unreadable
+        // mint falls back to the legacy assumption, keeping the classic path
+        // byte-identical.
+        const mintList = [assetMint, crncyMint];
+        const mintDatas = await Promise.all(mintList.map((mint) => load(mint)));
+        for (let mi = 0; mi < mintList.length; mi++) {
+            const mint = mintList[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("; ")}`);
+            }
+        }
+        // asset/crncy VAULTS are NOT the TokenState PDA itself — TokenState is a
+        // small Deriverse bookkeeping record (id/decimals/mask) whose OWN
+        // `program_address` field (offset 40, 32 bytes) names the real SPL
+        // token account holding the instrument's reserves. Conflating the two
+        // (using the TokenState PDA directly as the vault) would attach the
+        // wrong account to the Swap CPI — verified against real mainnet TokenState
+        // dumps (wSOL/USDC/USDT), where the PDA and program_address differ.
+        const [assetTokenStateAddr, crncyTokenStateAddr, asksTree, askOrders, bidsTree, bidOrders, lines, clientInfos,] = await Promise.all([
+            spotAccForMint(assetMint),
+            spotAccForMint(crncyMint),
+            spotAcc(TAG_SPOT_ASKS_TREE, assetTokenId, crncyTokenId),
+            spotAcc(TAG_SPOT_ASK_ORDERS, assetTokenId, crncyTokenId),
+            spotAcc(TAG_SPOT_BIDS_TREE, assetTokenId, crncyTokenId),
+            spotAcc(TAG_SPOT_BID_ORDERS, assetTokenId, crncyTokenId),
+            spotAcc(TAG_SPOT_LINES, assetTokenId, crncyTokenId),
+            spotAcc(TAG_SPOT_CLIENT_INFOS, assetTokenId, crncyTokenId),
+        ]);
+        const [assetTokenStateData, crncyTokenStateData] = await Promise.all([
+            load(assetTokenStateAddr),
+            load(crncyTokenStateAddr),
+        ]);
+        if (assetTokenStateData === null)
+            throw new Error(`${SLUG} pool ${pool} asset TokenState ${assetTokenStateAddr} not found`);
+        if (crncyTokenStateData === null)
+            throw new Error(`${SLUG} pool ${pool} crncy TokenState ${crncyTokenStateAddr} not found`);
+        if (assetTokenStateData.length < TOKEN_STATE_SIZE) {
+            throw new Error(`${SLUG} pool ${pool} asset TokenState ${assetTokenStateAddr} is ${assetTokenStateData.length} bytes, expected at least ${TOKEN_STATE_SIZE}`);
+        }
+        if (crncyTokenStateData.length < TOKEN_STATE_SIZE) {
+            throw new Error(`${SLUG} pool ${pool} crncy TokenState ${crncyTokenStateAddr} is ${crncyTokenStateData.length} bytes, expected at least ${TOKEN_STATE_SIZE}`);
+        }
+        const assetVault = codec.decode(assetTokenStateData.subarray(OFF_TOKEN_STATE_PROGRAM_ADDRESS, OFF_TOKEN_STATE_PROGRAM_ADDRESS + 32));
+        const crncyVault = codec.decode(crncyTokenStateData.subarray(OFF_TOKEN_STATE_PROGRAM_ADDRESS, OFF_TOKEN_STATE_PROGRAM_ADDRESS + 32));
+        return {
+            venue: SLUG,
+            pool,
+            side: "sell",
+            instrId,
+            assetTokenId,
+            crncyTokenId,
+            assetMint,
+            crncyMint,
+            assetVault,
+            crncyVault,
+            asksTree,
+            askOrders,
+            bidsTree,
+            bidOrders,
+            lines,
+            mapsAddress,
+            clientInfos,
+            tokenProgram: TOKEN_PROGRAM,
+            feePpm,
+        };
+    },
+    quoteAccounts(cfg) {
+        const c = deriverseConfig(cfg);
+        return [{ ref: c.pool, address: c.pool }];
+    },
+    /** v1 swap CPI (amount baked) — the unified `Swap` instruction (tag 26). */
+    buildSwap(cfg, user, amountIn) {
+        const c = deriverseConfig(cfg);
+        const U64_MAX = (1n << 64n) - 1n;
+        if (amountIn <= 0n || amountIn > U64_MAX)
+            throw new Error(`${SLUG} buildSwap amountIn must be a positive u64, got ${amountIn}`);
+        const data = new Uint8Array(32);
+        const dv = new DataView(data.buffer);
+        data[0] = 26; // SwapInstruction::INSTRUCTION_NUMBER
+        data[1] = c.side === "buy" ? 1 : 0; // input_crncy
+        // bytes 2..4 padding_u16 = 0
+        dv.setUint32(4, c.instrId, true);
+        dv.setBigInt64(8, 0n, true); // price = 0 (no caller-supplied limit; the program applies its own last_px-derived breaker)
+        dv.setBigInt64(16, amountIn, true); // amount
+        dv.setBigInt64(24, 1n, true); // min_amount_out = 1 (the recipe's terminal delta owns the real bound)
+        return {
+            programId: DERIVERSE_PROGRAM_ID,
+            data,
+            accounts: deriverseSwapAccounts(c, user, (ref, addr, w) => fixed(ref, addr, w)),
+        };
+    },
+};
+/** `new_token_acc`: `find_program_address([mint[0..28] ++ VERSION_LE, DERIVERSE_AUTH], programId)`. */
+async function spotAccForMint(mint) {
+    const mintBytes = getAddressEncoder().encode(mint);
+    const seed = new Uint8Array(32);
+    seed.set(mintBytes.subarray(0, 28), 0);
+    new DataView(seed.buffer).setUint32(28, VERSION, true);
+    const authBytes = getAddressEncoder().encode(DERIVERSE_AUTH);
+    return memoizedGetProgramDerivedAddress(DERIVERSE_PROGRAM_ID, [seed, authBytes]);
+}
+const fixed = (ref, addr, writable) => writable ? { ref, address: addr, writable: true } : { ref, address: addr };
+/**
+ * The 14-account order for Deriverse's `Swap` (disc 26 — SwapInstruction::
+ * MIN_ACCOUNTS), shared by v1 buildSwap and v2 buildSwapV2: [signer, asset
+ * mint, crncy mint, asset vault, crncy vault, instrument, {asks_tree,
+ * ask_orders} on buy / {bids_tree, bid_orders} on sell, lines, maps, client
+ * infos, asset-side user ATA, crncy-side user ATA, token program]. User ATAs
+ * are POSITIONAL BY MINT (asset vs crncy), not by direction — the same trap
+ * documented on solfi-v2/quantum.
+ */
+export function deriverseSwapAccounts(c, user, make, refFor) {
+    const r = refFor ?? ((role) => role);
+    const buy = c.side === "buy";
+    const userAsset = buy ? user.outAta : user.inAta;
+    const userCrncy = buy ? user.inAta : user.outAta;
+    return [
+        { ref: user.owner, signer: true, writable: true },
+        make(r("am"), c.assetMint),
+        make(r("cm"), c.crncyMint),
+        make(r("av"), c.assetVault, true),
+        make(r("cv"), c.crncyVault, true),
+        make(r("instr"), c.pool, true),
+        ...(buy
+            ? [make(r("askt"), c.asksTree, true), make(r("asko"), c.askOrders, true)]
+            : [make(r("bidt"), c.bidsTree, true), make(r("bido"), c.bidOrders, true)]),
+        make(r("lines"), c.lines, true),
+        make(r("maps"), c.mapsAddress, true),
+        make(r("ci"), c.clientInfos, true),
+        { ref: userAsset, writable: true },
+        { ref: userCrncy, writable: true },
+        make(r("tp"), c.tokenProgram),
+    ];
+}
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,61 @@
+import type { Address } from "@solana/kit";
+import type { AccountLoader, PoolConfig, VenueAccount } from "../types.js";
+declare const SLUG = "flint";
+export declare const FLINT_PROGRAM_ID: Address<"FLiNTXPwppyoJabCoxc2uiiRygAHpmMXajiDXo2Ub1z">;
+/**
+ * Per-direction haircut applied ON TOP OF naive constant-product (ppm of
+ * 1_000_000) — see the file header "Quote curve" section for the exact real
+ * fill data and margin behind each of these three constants. Naive CP alone
+ * is NOT reliably conservative for this venue (unlike bisonfi/humidifi), so
+ * there is no single global constant.
+ */
+export declare const FLINT_HAIRCUT_USDT_USDC_PPM = 700000n;
+export declare const FLINT_HAIRCUT_PUMPCMXQ_TO_USDT_PPM = 900000n;
+export declare const FLINT_HAIRCUT_USDT_TO_PUMPCMXQ_PPM = 150000n;
+/** One curated Flint pair, in its DEFAULT (A -> B) orientation. */
+export interface FlintPairEntry {
+    marketA: Address;
+    vaultA: Address;
+    mintA: Address;
+    tokenProgramA: Address;
+    marketB: Address;
+    vaultB: Address;
+    mintB: Address;
+    tokenProgramB: Address;
+    /** Real, chain-recovered instruction discriminator for THIS pair (see file header). */
+    disc: number;
+    /** Zero-byte tail length after the patched amountIn u64 (see file header). */
+    tailZeros: number;
+    /** The Token-2022 side's mint, if either side is Token-2022 (needed for transferChecked). */
+    checkedMint?: Address;
+    /** Whether the B->A direction is ALSO real-evidence-confirmed (see file header "Scope"). */
+    reversible: boolean;
+    /** Haircut (ppm) for the A->B direction — see file header "Quote curve" for the real-fill basis. */
+    haircutAtoBPpm: bigint;
+    /** Haircut (ppm) for the B->A direction — REQUIRED iff reversible (a DIFFERENT margin; see file header). */
+    haircutBtoAPpm?: bigint;
+}
+/**
+ * Curated registry, keyed by the "pool" address this family is discovered
+ * under — the NON-USDT side of each pair (USDT is the common factor in both
+ * shipped pairs today). See file header "Scope" for the evidence backing
+ * each entry and each entry's reversibility.
+ */
+export declare const FLINT_PAIR_REGISTRY: Record<string, FlintPairEntry>;
+export interface FlintPoolConfig extends PoolConfig {
+    venue: typeof SLUG;
+    entry: FlintPairEntry;
+    /** 'AtoB' = entry's default orientation; 'BtoA' only when entry.reversible. */
+    direction: "AtoB" | "BtoA";
+}
+declare function fetchPoolConfig(load: AccountLoader, pool: Address): Promise<FlintPoolConfig>;
+declare function quoteAccounts(base: PoolConfig): VenueAccount[];
+export declare const flint: {
+    slug: string;
+    kind: "constant-product";
+    programId: Address<"FLiNTXPwppyoJabCoxc2uiiRygAHpmMXajiDXo2Ub1z">;
+    fetchPoolConfig: typeof fetchPoolConfig;
+    quoteAccounts: typeof quoteAccounts;
+};
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/svm/venues/flint/index.ts"],"names":[],"mappings":"AAgLA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3E,QAAA,MAAM,IAAI,UAAU,CAAC;AACrB,eAAO,MAAM,gBAAgB,wDAAyD,CAAC;AAIvF;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B,UAAW,CAAC;AACpD,eAAO,MAAM,kCAAkC,UAAW,CAAC;AAC3D,eAAO,MAAM,kCAAkC,UAAW,CAAC;AAa3D,mEAAmE;AACnE,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,aAAa,EAAE,OAAO,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,aAAa,EAAE,OAAO,CAAC;IACvB,uFAAuF;IACvF,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,SAAS,EAAE,MAAM,CAAC;IAClB,6FAA6F;IAC7F,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,4FAA4F;IAC5F,UAAU,EAAE,OAAO,CAAC;IACpB,oGAAoG;IACpG,cAAc,EAAE,MAAM,CAAC;IACvB,4GAA4G;IAC5G,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CA+B9D,CAAC;AAEF,MAAM,WAAW,eAAgB,SAAQ,UAAU;IACjD,KAAK,EAAE,OAAO,IAAI,CAAC;IACnB,KAAK,EAAE,cAAc,CAAC;IACtB,+EAA+E;IAC/E,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;CAC5B;AAkCD,iBAAe,eAAe,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC,CAqB3F;AAED,iBAAS,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,YAAY,EAAE,CAOvD;AAED,eAAO,MAAM,KAAK;;;;;;CAMjB,CAAC"}