@eco-incorp/sauce 0.99.0

package/sdk/dist/svm/venues/sanctum-stake-pool/index.js

@@ -0,0 +1,342 @@
+/**
+ * Sanctum stake-pool family — four on-chain program deploys of the SAME
+ * SPL-Stake-Pool-lineage bytecode (Jupiter's `program-id-to-label` labels ALL
+ * FOUR "Sanctum"): `SPoo1Ku8WFXoNDMHPsrGSTSG1Y47rzgn41SLUNakuHy` (the
+ * canonical public `spl-stake-pool` program — confirmed live via scnSOL,
+ * JitoSOL, BNSOL below), `SP12tWFxD9oJsVWNavTTBZvMbA6gkAmxtVgxdqvyvhY`
+ * (confirmed live via dSOL), `SPMBzsVUuoHA4Jm6KunbsotaahvVikZs1JyTW6iJvbn`
+ * (confirmed live via jupSOL), and `stkitrT1Uoy18Dk1fTrgPw8W6MVzoCfYoAFT4MLsmhq`
+ * (zero `getProgramAccounts`-visible pools as of 2026-07-31 — a spare/reserve
+ * deploy Sanctum keeps ready; wired anyway per this repo's no-premature-
+ * gating policy, so a future pool created under it self-activates with no
+ * code change). One adapter factory (`makeSanctumStakePoolLadder`) serves
+ * all four — the account layout and instruction ABI are byte-identical
+ * across the four deploys.
+ *
+ * LAYOUT — the public `solana-program/stake-pool` `StakePool` struct
+ * (`program/src/state.rs`), Borsh-serialized. NOT a fixed-offset struct in
+ * the general case: `next_epoch_fee`/`next_stake_withdrawal_fee`/
+ * `next_sol_withdrawal_fee` are `FutureEpoch<Fee>` (1-byte tag, +16 bytes iff
+ * `One`/`Two`) and `preferred_deposit_validator_vote_address`/
+ * `preferred_withdraw_validator_vote_address`/`sol_deposit_authority`/
+ * `sol_withdraw_authority` are `Option<Pubkey>` (1-byte tag, +32 iff `Some`)
+ * — so this decoder is a SEQUENTIAL CURSOR, not a fixed-offset table,
+ * correctly handling any pool regardless of which optional fields are set
+ * (measured live: 2,288 of 2,306 `getProgramAccounts`-visible pools across
+ * the three active programs are the "everything None" 611-byte shape, but
+ * the cursor decodes the other sizes — 664/1024/2320 bytes observed live —
+ * identically; `stake_pool.is_valid()`'s own account_type==1 gate, mirrored
+ * here as the leading byte check, is the only shape precondition). Crucially,
+ * `total_lamports`/`pool_token_supply` sit BEFORE every optional field
+ * (offsets 258/266 are universal constants regardless of what's Some/None
+ * later in the struct) — the two live values this adapter's on-chain
+ * fragment reads at cook time — so the compiled shape needs no per-pool
+ * offset variance at all; `sol_deposit_fee` (which DOES sit after the
+ * variable-length prefix) is read once off-chain at fetch time and ridden
+ * as a per-trade PARAM instead, exactly like raydium-amm-v4's fee bps.
+ *
+ * QUOTE MATH — ground-truthed against the REAL deployed program, not
+ * reverse-engineered: `calc_pool_tokens_for_deposit`/
+ * `calc_pool_tokens_sol_deposit_fee`/`Fee::apply` in the SAME public
+ * `program/src/state.rs` give the exact closed form —
+ * `minted = floor(x * pool_token_supply / total_lamports)` (or `= x` when
+ * either is 0, the bootstrap case) and `fee = ceil(minted * sol_deposit_fee
+ * .numerator / sol_deposit_fee.denominator)` (0 if `denominator == 0`),
+ * `out = minted - fee`. Validated 2026-07-31 via `simulateTransaction`
+ * (`sigVerify:false`, `accounts:` state read-back) against FOUR real
+ * mainnet pools spanning all three currently-live programs — BNSOL
+ * (`SPoo1…`), JitoSOL (`SPoo1…`), jupSOL (`SPMBzs…`), dSOL (`SP12tW…`) — at
+ * three sizes each (0.001 / ~0.14 / 1–3 SOL): the manager's own token
+ * account was used as depositor+dest+referrer (any existing wallet works
+ * for a dry-run CPI; nothing was submitted for real), and every one of the
+ * 11 sampled deliveries matched this formula bit-for-bit. The formula is
+ * exactly affine in `x` (monotone AND concave trivially — no curvature to
+ * misrepresent on a coarse ladder), so `defaultRungs` is pinned at the
+ * framework floor (`MIN_RUNGS` = 2): a straight line loses nothing to a
+ * coarser grid. This adapter is conservative on the fee rounding
+ * specifically: it computes `ceil` via `floor + 1` whenever the fee is
+ * nonzero (never re-deriving the exact remainder, which would need a second
+ * wide multiply this repo's `Math.mulDiv` intrinsic doesn't expose) — this
+ * NEVER over-predicts the real payout (ceil ≥ true ceil always), matching
+ * the "a model more favourable than reality is a liveness hazard" rule; the
+ * TS `referenceQuote` mirrors the exact same rounding, so the two stay
+ * lockstep even though the last-lamport-of-fee case is a deliberate,
+ * documented pessimistic simplification versus the real program's own
+ * remainder-exact ceiling.
+ *
+ * A REAL, LIVE gate this adapter enforces and the validation run above
+ * surfaced directly: `process_deposit_sol` reverts
+ * (`StakeListAndPoolOutOfDate`, custom error 0x11) whenever
+ * `last_update_epoch < clock.epoch` — i.e. a pool whose daily crank hasn't
+ * run yet THIS epoch cannot accept a deposit at all. Three of the small/mid
+ * pools sampled during validation hit exactly this revert; the three
+ * majors (BNSOL/JitoSOL/jupSOL/dSOL) were current. Because a launched CPI
+ * failure aborts the whole cook on SVM (no execution-time catch — see
+ * the consuming app SVM README's parity verdicts), this MUST be a prepare-time
+ * self-drop, not an on-chain guard: `fetchPoolConfig` reads the Clock
+ * sysvar via the SAME `load` (a second, ordinary account read — the same
+ * multi-read pattern obric-v2's fetch already uses for its price feeds) and
+ * throws when the pool is stale, exactly like every other family's
+ * out-of-scope gate.
+ *
+ * DIRECTION — SOL deposit only (`DepositSol`, ix tag 14). The reverse
+ * (`WithdrawSol`) pays out NATIVE lamports to a wallet, not an SPL account,
+ * and is explicitly deferred (this venue's own integration plan calls for
+ * implementing deposit first and self-dropping withdraw for now — no
+ * `REVERSE_DIRECTION` entry, `applyDirection` throws on any non-default
+ * direction, same shape as orca-legacy-token-swap/saber-stableswap/
+ * meteora-damm-v1-stable).
+ *
+ * ACCOUNTS ARE NATIVE-SOL, NOT `inAta` — a DELIBERATE, DOCUMENTED deviation
+ * from every sibling family. `DepositSol`'s `from_user_lamports_info` is a
+ * plain System-owned wallet debited via a raw `system_instruction::transfer`
+ * CPI (`processor.rs`'s `sol_transfer`) — NOT an SPL token account; a wSOL
+ * ATA is Token-Program-owned and the System Program's transfer instruction
+ * hard-rejects a non-System-owned source (`ExternalAccountLamportSpend`),
+ * so `user.inAta` cannot serve this role at all, and there is no partial
+ * "unwrap some of my wSOL ATA into lamports" SPL primitive to bridge it
+ * (`CloseAccount` reclaims a whole account's lamports, never a slice). This
+ * adapter instead debits `user.owner` — the SAME wallet already attached as
+ * signer for every other family's token-authority role, and the
+ * Solana-idiomatic way every real SOL-deposit integration (Sanctum's own
+ * UI, Jupiter's stake widget) sources the deposit lamports directly from
+ * the connected wallet rather than a pre-wrapped ATA. `user.outAta` (the
+ * LST destination) and `owner` (signer) are the only `SwapUser` refs this
+ * family uses; `inAta` is unused. `mints()` still reports `inMint =`
+ * the well-known wSOL mint for pair-matching (this is the recipe's only
+ * vocabulary for "the user is trading SOL"), so the caveat that follows is
+ * real and worth stating plainly rather than glossing over: in the
+ * `amountIn=0` balance-input sentinel specifically, "amountIn" is derived
+ * on-chain from `inAta`'s LIVE balance alone (see the consuming app SVM README),
+ * so this family's owner-wallet-sourced contribution is NOT reflected in
+ * that derivation — a sized (`amountIn>0`) request has no such gap (the
+ * merge never assigns any slot more than the trade's own declared budget,
+ * regardless of which underlying account physically funds it, and the
+ * signer's signature on the whole transaction is the consent boundary for
+ * whatever it debits from their own wallet either way).
+ *
+ * CPI — `DepositSol(u64)`: tag `14` (`StakePoolInstruction`'s 15th variant,
+ * confirmed against `program/src/instruction.rs`, not the `15` a naive
+ * off-by-one read of the enum would produce) ++ patched amount, no trailing
+ * bytes (no on-chain min-out param on the plain variant — this repo's own
+ * terminal outAta delta check is the real bound, matching every other
+ * family). Ten accounts, order confirmed against BOTH `instruction.rs`'s
+ * doc comment and a live simulated + a real historical DepositStake tx's
+ * withdraw-authority account (bit-identical to this file's own PDA
+ * derivation): stake pool (w), withdraw authority (r), reserve stake (w),
+ * depositor (`user.owner`, signer, w), dest pool-token account
+ * (`user.outAta`, w), manager fee account (w), referrer fee account (w —
+ * this adapter reuses the pool's own manager fee account as referrer, a
+ * standard no-referral-program integrator default: it is guaranteed to
+ * already be a valid token account of the right mint, so it needs no extra
+ * account from the caller), pool mint (w), system program, token program.
+ * `withdraw_authority` is `create_program_address([pool, "withdraw",
+ * [stake_withdraw_bump_seed]], programId)` — the STORED bump, not a fresh
+ * `find_program_address` search (`lib.rs`'s `AUTHORITY_WITHDRAW = b"withdraw"`
+ * literal); this file's derivation matched a real, unrelated, live
+ * DepositStake transaction's own withdraw-authority account bit-for-bit
+ * during validation.
+ *
+ * CU — `../budget.ts` cites the measurement method (real `simulateTransaction`
+ * runs against four live mainnet pools, ~11.3k–11.9k CU for the CPI itself)
+ * and the calibration this file's header does not repeat.
+ */
+import { address, getAddressDecoder, getAddressEncoder } from "@solana/kit";
+import { createHash } from "node:crypto";
+import { TOKEN_2022_PROGRAM_ID, classifyMintProgram } from "../../token-program.js";
+import { parseMintExtensions } from "../../token-extensions.js";
+export const SANCTUM_STAKE_POOL_PROGRAM_ID = address("SPoo1Ku8WFXoNDMHPsrGSTSG1Y47rzgn41SLUNakuHy");
+export const SANCTUM_STAKE_POOL_2_PROGRAM_ID = address("SP12tWFxD9oJsVWNavTTBZvMbA6gkAmxtVgxdqvyvhY");
+export const SANCTUM_STAKE_POOL_3_PROGRAM_ID = address("SPMBzsVUuoHA4Jm6KunbsotaahvVikZs1JyTW6iJvbn");
+export const SANCTUM_STAKE_POOL_4_PROGRAM_ID = address("stkitrT1Uoy18Dk1fTrgPw8W6MVzoCfYoAFT4MLsmhq");
+const CLOCK_SYSVAR = address("SysvarC1ock11111111111111111111111111111111");
+/** The recipe-wide vocabulary for "the user is trading SOL" — see module header's ACCOUNTS caveat. */
+export const WSOL_MINT = address("So11111111111111111111111111111111111111112");
+const ACCOUNT_TYPE_STAKE_POOL = 1;
+const OFF_TOTAL_LAMPORTS = 258;
+class Cursor {
+    buf;
+    o = 0;
+    constructor(buf) {
+        this.buf = buf;
+    }
+    offset() {
+        return this.o;
+    }
+    u8() {
+        const v = this.buf[this.o];
+        if (v === undefined)
+            throw new Error("sanctum-stake-pool: truncated account data");
+        this.o += 1;
+        return v;
+    }
+    u64() {
+        if (this.o + 8 > this.buf.length)
+            throw new Error("sanctum-stake-pool: truncated account data");
+        let v = 0n;
+        for (let i = 7; i >= 0; i--)
+            v = (v << 8n) | BigInt(this.buf[this.o + i]);
+        this.o += 8;
+        return v;
+    }
+    pubkey() {
+        if (this.o + 32 > this.buf.length)
+            throw new Error("sanctum-stake-pool: truncated account data");
+        const slice = this.buf.subarray(this.o, this.o + 32);
+        this.o += 32;
+        return getAddressDecoder().decode(slice);
+    }
+    fee() {
+        const denominator = this.u64();
+        const numerator = this.u64();
+        return { numerator, denominator };
+    }
+    /** `FutureEpoch<Fee>`: tag 0 = None, 1/2 = One/Two(Fee). */
+    skipFutureEpochFee() {
+        const tag = this.u8();
+        if (tag === 0)
+            return;
+        if (tag === 1 || tag === 2) {
+            this.fee();
+            return;
+        }
+        throw new Error(`sanctum-stake-pool: unexpected FutureEpoch<Fee> tag ${tag}`);
+    }
+    /** `Option<Pubkey>`: tag 0 = None, 1 = Some. */
+    optionPubkey() {
+        const tag = this.u8();
+        if (tag === 0)
+            return undefined;
+        if (tag === 1)
+            return this.pubkey();
+        throw new Error(`sanctum-stake-pool: unexpected Option<Pubkey> tag ${tag}`);
+    }
+}
+function withdrawAuthorityAddress(programId, pool, bump) {
+    const decoder = getAddressDecoder();
+    // create_program_address(seeds=[pool, "withdraw", [bump]], programId):
+    // sha256(seed_1 || ... || programId || "ProgramDerivedAddress").
+    const h = createHash("sha256");
+    h.update(Buffer.from(getPubkeyBytes(pool)));
+    h.update(Buffer.from("withdraw"));
+    h.update(Buffer.from([bump]));
+    h.update(Buffer.from(getPubkeyBytes(programId)));
+    h.update(Buffer.from("ProgramDerivedAddress"));
+    return decoder.decode(new Uint8Array(h.digest()));
+}
+// @solana/kit's Address is a branded base58 string; decoding it back to raw
+// bytes for the PDA hash needs the matching encoder — the only place in the
+// adapter that needs raw pubkey bytes rather than an opaque Address.
+function getPubkeyBytes(addr) {
+    return Uint8Array.from(getAddressEncoder().encode(addr));
+}
+async function fetchSanctumStakePoolConfig(load, pool, programId, slug) {
+    const data = await load(pool);
+    if (data === null)
+        throw new Error(`${slug} pool ${pool} account not found`);
+    const c = new Cursor(data);
+    const accountType = c.u8();
+    if (accountType !== ACCOUNT_TYPE_STAKE_POOL) {
+        throw new Error(`${slug} pool ${pool} account_type must be ${ACCOUNT_TYPE_STAKE_POOL} (StakePool), got ${accountType}`);
+    }
+    c.pubkey(); // manager
+    c.pubkey(); // staker
+    c.pubkey(); // stake_deposit_authority
+    const stakeWithdrawBumpSeed = c.u8();
+    c.pubkey(); // validator_list
+    const reserveStake = c.pubkey();
+    const poolMint = c.pubkey();
+    const managerFeeAccount = c.pubkey();
+    c.pubkey(); // token_program_id — no longer gated here; the mint T22 detection below supersedes it
+    // DepositSol mints the LST to the user via the classic Tokenkeg program, so a
+    // Token-2022 pool mint (or one carrying an un-routable extension) must
+    // SELF-DROP. Detect the real token program from the mint's own account via the
+    // shared data-shape resolver, replacing the old stored-token_program_id guard;
+    // the thrown error IS the graceful drop (SvmRoute catches a fetchPoolConfig
+    // throw and drops the venue). LEGACY path unchanged: a classic 82-byte mint
+    // classifies Tokenkeg, parses no extensions, config built as before. An
+    // unreadable mint falls back to the legacy assumption (keeps existing tests green).
+    const poolMintData = await load(poolMint);
+    if (poolMintData !== null) {
+        if (classifyMintProgram(poolMint, poolMintData) === TOKEN_2022_PROGRAM_ID) {
+            throw new Error(`${slug}: dropping pool ${pool} — mint ${poolMint} is Token-2022 (this venue's swap is legacy-SPL only)`);
+        }
+        const { blocking } = parseMintExtensions(poolMintData);
+        if (blocking.length > 0) {
+            throw new Error(`${slug}: dropping pool ${pool} — mint ${poolMint} is un-routable: ${blocking.join("; ")}`);
+        }
+    }
+    if (c.offset() !== OFF_TOTAL_LAMPORTS) {
+        // total_lamports/pool_token_supply are meant to sit at fixed offsets —
+        // this only fails if a future stake-pool version reorders the struct
+        // prefix, in which case the on-chain fragment's baked accountUint
+        // offsets below would silently read the wrong field. Fail loudly.
+        throw new Error(`${slug} pool ${pool}: unexpected prefix length ${c.offset()}, expected total_lamports at ${OFF_TOTAL_LAMPORTS}`);
+    }
+    c.u64(); // total_lamports (read LIVE on-chain via accountUint, not baked)
+    c.u64(); // pool_token_supply (read LIVE on-chain via accountUint, not baked)
+    c.u64(); // last_update_epoch (re-derived below via a fresh cursor read — see note)
+    c.u64(); // lockup.unix_timestamp
+    c.u64(); // lockup.epoch
+    c.pubkey(); // lockup.custodian
+    c.fee(); // epoch_fee
+    c.skipFutureEpochFee(); // next_epoch_fee
+    c.optionPubkey(); // preferred_deposit_validator_vote_address
+    c.optionPubkey(); // preferred_withdraw_validator_vote_address
+    c.fee(); // stake_deposit_fee
+    c.fee(); // stake_withdrawal_fee
+    c.skipFutureEpochFee(); // next_stake_withdrawal_fee
+    c.u8(); // stake_referral_fee
+    const solDepositAuthority = c.optionPubkey();
+    const solDepositFee = c.fee();
+    if (solDepositAuthority !== undefined) {
+        throw new Error(`${slug} pool ${pool} requires a sol_deposit_authority signature — permissioned pools are not implemented by this adapter`);
+    }
+    if (solDepositFee.numerator !== 0n && solDepositFee.denominator === 0n) {
+        throw new Error(`${slug} pool ${pool} sol_deposit_fee denominator is 0 with nonzero numerator ${solDepositFee.numerator}`);
+    }
+    // Re-read last_update_epoch directly (fixed offset 274, right after
+    // pool_token_supply) rather than threading it out of the sequential
+    // cursor above, and gate it against the LIVE cluster epoch: DepositSol
+    // reverts (StakeListAndPoolOutOfDate, custom error 0x11) whenever the
+    // pool's stored snapshot predates the current epoch — see module header.
+    const lastUpdateEpoch = readU64(data, OFF_TOTAL_LAMPORTS + 16);
+    const clockData = await load(CLOCK_SYSVAR);
+    if (clockData === null)
+        throw new Error("sanctum-stake-pool: Clock sysvar account not found");
+    const currentEpoch = readU64(clockData, 16);
+    if (lastUpdateEpoch < currentEpoch) {
+        throw new Error(`${slug} pool ${pool} is stale (last_update_epoch ${lastUpdateEpoch} < current epoch ${currentEpoch}) — needs its crank run this epoch before it can accept a deposit`);
+    }
+    return {
+        venue: slug,
+        pool,
+        poolMint,
+        reserveStake,
+        managerFeeAccount,
+        withdrawAuthority: withdrawAuthorityAddress(programId, pool, stakeWithdrawBumpSeed),
+        solDepositFeeNumerator: solDepositFee.numerator,
+        solDepositFeeDenominator: solDepositFee.denominator,
+        direction: "solToLst",
+    };
+}
+function readU64(buf, offset) {
+    if (offset + 8 > buf.length)
+        throw new Error("sanctum-stake-pool: truncated account data");
+    let v = 0n;
+    for (let i = 7; i >= 0; i--)
+        v = (v << 8n) | BigInt(buf[offset + i]);
+    return v;
+}
+function makeSanctumStakePool(slug, programId) {
+    return {
+        slug,
+        programId,
+        fetchPoolConfig: (load, pool) => fetchSanctumStakePoolConfig(load, pool, programId, slug),
+    };
+}
+export const sanctumStakePool = makeSanctumStakePool("sanctum-stake-pool", SANCTUM_STAKE_POOL_PROGRAM_ID);
+export const sanctumStakePool2 = makeSanctumStakePool("sanctum-stake-pool-2", SANCTUM_STAKE_POOL_2_PROGRAM_ID);
+export const sanctumStakePool3 = makeSanctumStakePool("sanctum-stake-pool-3", SANCTUM_STAKE_POOL_3_PROGRAM_ID);
+export const sanctumStakePool4 = makeSanctumStakePool("sanctum-stake-pool-4", SANCTUM_STAKE_POOL_4_PROGRAM_ID);
+//# sourceMappingURL=index.js.map

package/sdk/dist/svm/venues/sanctum-stake-pool/index.js.map

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

package/sdk/dist/svm/venues/saros-dlmm/index.d.ts

@@ -0,0 +1,93 @@
+import type { Address } from "@solana/kit";
+import type { AccountLoader, PoolConfig } from "../types.js";
+declare const SLUG = "saros-dlmm";
+export declare const SAROS_DLMM_PROGRAM_ID: Address<"1qbkdrr3z4ryLA7pZykqxvxWPoeifcVKo6ZG9CfkvVE">;
+declare const MEMO_PROGRAM: Address<"MemoSq4gqABAXKb96qnH8TysNcWxMyWCqXgDLGmfcHr">;
+export declare const PAIR_ACCOUNT_SIZE = 204;
+export declare const BIN_ARRAY_ACCOUNT_SIZE = 8248;
+/** sha256('account:Pair')[0..8]. */
+export declare const PAIR_DISCRIMINATOR: number[];
+/** sha256('account:BinArray')[0..8] — identical to meteora-dlmm's (same type name). */
+export declare const BIN_ARRAY_DISCRIMINATOR: number[];
+export declare const BINS_PER_ARRAY = 256;
+export declare const CENTER_BIN_ID = 8388608;
+/**
+ * Shipped liquid bins per direction — the meteora-dlmm-style bounded walk,
+ * sized the same as METEORA_DLMM_MAX_BINS pending CU re-measurement against
+ * this family's own compiled ladder (see budget.ts CU_FAMILIES).
+ */
+export declare const SAROS_DLMM_MAX_BINS = 8;
+export declare const OFF_ACTIVE_ID = 127;
+export declare const OFF_LAST_UPDATE = 131;
+export declare const OFF_VOLATILITY_ACC = 139;
+export declare const OFF_VOLATILITY_REF = 143;
+export declare const OFF_INDEX_REF = 147;
+export declare const OFF_BA_INDEX = 8232;
+export declare const OFF_BA_BINS = 40;
+export declare const BIN_LEN = 32;
+export declare const OFF_BIN_RESERVE_X = 16;
+export declare const OFF_BIN_RESERVE_Y = 24;
+export interface SarosDlmmBin {
+    /** Index into the window's [binArrayLower, binArrayUpper] pair (0 or 1). */
+    arrayIndex: 0 | 1;
+    /** Bin offset within that array (0..255). */
+    offset: number;
+    /** The RAW (already-biased) bin id — active_id's own units. */
+    binId: number;
+    /** priceFromId-equivalent: (1+binStep/1e4)^(binId-CENTER_BIN_ID) in Q64.64. */
+    price: bigint;
+}
+export interface SarosDlmmWindow {
+    /** The two bracketing bin-array PDAs (ascending index; both ALWAYS required by the swap ix). */
+    binArrayLower: Address;
+    binArrayUpper: Address;
+    lowerIndex: number;
+    upperIndex: number;
+    /** Liquid bins in walk order (<= SAROS_DLMM_MAX_BINS); empty when either bracket array is missing/invalid. */
+    bins: SarosDlmmBin[];
+}
+export interface SarosDlmmPoolConfig extends PoolConfig {
+    venue: typeof SLUG;
+    /** Trade direction: 'xToY' (default) sells token_x for token_y (swap_for_y, price down). */
+    direction: "xToY" | "yToX";
+    tokenXMint: Address;
+    tokenYMint: Address;
+    vaultX: Address;
+    vaultY: Address;
+    binStep: number;
+    activeId: number;
+    baseFactor: number;
+    variableFeeControl: number;
+    maxVolatilityAccumulator: number;
+    reductionFactor: number;
+    filterPeriod: number;
+    decayPeriod: number;
+    windows: {
+        xToY: SarosDlmmWindow;
+        yToX: SarosDlmmWindow;
+    };
+}
+/**
+ * The two bracketing bin-array indices for `activeId` — matching the real
+ * program's own swap-account convention (cross-validated: the pair chosen
+ * this way is exactly what a real swap accepts, both directions, at every
+ * tested size — see the module header). `lowerIndex < upperIndex` always;
+ * both cover `SAROS_DLMM_MAX_BINS` worth of headroom on either side of
+ * `activeId` (256-bin arrays, an 8-bin walk never needs a third array).
+ */
+export declare function pairArrayIndexes(activeId: number): [number, number];
+export declare function priceFromId(binId: number, binStep: number): bigint;
+/**
+ * Fetch + gate one Saros DLMM pair (see the module header for the gate list)
+ * and freeze both directions' bin windows. Read-only against the loader.
+ */
+export declare function fetchSarosDlmmConfig(load: AccountLoader, pair: Address): Promise<SarosDlmmPoolConfig>;
+/** Family facade for the recipe orchestrator (ladder-only — no v1 adapter). */
+export declare const sarosDlmm: {
+    slug: string;
+    programId: Address<"1qbkdrr3z4ryLA7pZykqxvxWPoeifcVKo6ZG9CfkvVE">;
+    tokenProgram: Address<"TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA">;
+    fetchPoolConfig: typeof fetchSarosDlmmConfig;
+};
+export { MEMO_PROGRAM as SAROS_DLMM_MEMO_PROGRAM };
+//# sourceMappingURL=index.d.ts.map

package/sdk/dist/svm/venues/saros-dlmm/index.d.ts.map

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