@eco-incorp/sauce 0.99.0

package/sdk/dist/svm/venues/bonkswap-fork/index.d.ts

@@ -0,0 +1,55 @@
+import type { Address } from "@solana/kit";
+import type { AccountLoader, PoolConfig } from "../types.js";
+export declare const OFF_TOKEN_X_RESERVE = 200;
+export declare const OFF_TOKEN_Y_RESERVE = 208;
+export declare const OFF_CONST_K = 312;
+export declare const OFF_LP_FEE = 344;
+export declare const OFF_BUYBACK_FEE = 360;
+export declare const OFF_PROJECT_FEE = 376;
+export declare const OFF_MERCANTI_FEE = 392;
+/** DEFAULT_DENOMINATOR — every fee field is a rate scaled by 1e12 (100%). */
+export declare const FEE_DENOMINATOR = 1000000000000n;
+declare function readUintLE(data: Uint8Array, offset: number, width: number): bigint;
+export interface BonkswapForkPoolConfig extends PoolConfig {
+    tokenX: Address;
+    tokenY: Address;
+    poolXAccount: Address;
+    poolYAccount: Address;
+    /** constK (Product, u128), split hi/lo — a liquidity-event invariant, baked at fetch time (mirrors obric-v2's bigK). */
+    constKHi: bigint;
+    constKLo: bigint;
+    /** Fee rates (ppt of 1e12) — admin-configured, baked at fetch time. */
+    lpFee: bigint;
+    buybackFee: bigint;
+    projectFee: bigint;
+    mercantiFee: bigint;
+    /** 'xToY' (default, tokenX in) | 'yToX'. */
+    direction: "xToY" | "yToX";
+}
+declare function forkConfig(slug: string, base: PoolConfig): BonkswapForkPoolConfig;
+export interface BonkswapForkAdapter {
+    slug: string;
+    programId: Address;
+    fetchPoolConfig(load: AccountLoader, pool: Address): Promise<BonkswapForkPoolConfig>;
+}
+/**
+ * One adapter per deployed Bonkswap fork — same layout/math (see module
+ * header), parameterized only by the fork's own program id.
+ */
+export declare function makeBonkswapForkAdapter(slug: string, programId: Address): BonkswapForkAdapter;
+export { forkConfig as bonkswapForkConfig, readUintLE as bonkswapReadUintLE };
+/** Bonkswap — the original deployment. */
+export declare const BONKSWAP_PROGRAM_ID: Address;
+/** Bonkswap's `state` PDA (seed "bonkswapstatev1") — verified via getProgramDerivedAddress and matches a real swap tx's account #0. */
+export declare const BONKSWAP_STATE: Address;
+/** Bonkswap's vault-owning authority PDA (State.programAuthority) — matches every pool's vault SPL-token `owner` field. */
+export declare const BONKSWAP_PROGRAM_AUTHORITY: Address;
+export declare const bonkswap: BonkswapForkAdapter;
+/** Guacswap — a whitelabel fork (see module header). */
+export declare const GUACSWAP_PROGRAM_ID: Address;
+/** Guacswap's `state` PDA (seed "guacswapstatev1"). */
+export declare const GUACSWAP_STATE: Address;
+/** Guacswap's vault-owning authority PDA. */
+export declare const GUACSWAP_PROGRAM_AUTHORITY: Address;
+export declare const guacswap: BonkswapForkAdapter;
+//# sourceMappingURL=index.d.ts.map

package/sdk/dist/svm/venues/bonkswap-fork/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/svm/venues/bonkswap-fork/index.ts"],"names":[],"mappings":"AAkGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAY7D,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,eAAO,MAAM,WAAW,MAAM,CAAC;AAC/B,eAAO,MAAM,UAAU,MAAM,CAAC;AAC9B,eAAO,MAAM,eAAe,MAAM,CAAC;AACnC,eAAO,MAAM,eAAe,MAAM,CAAC;AACnC,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAEpC,6EAA6E;AAC7E,eAAO,MAAM,eAAe,iBAAqB,CAAC;AAElD,iBAAS,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAI3E;AAED,MAAM,WAAW,sBAAuB,SAAQ,UAAU;IACxD,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;IACtB,wHAAwH;IACxH,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;CAC5B;AAED,iBAAS,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,sBAAsB,CAG1E;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,eAAe,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;CACtF;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,mBAAmB,CA2E7F;AAED,OAAO,EAAE,UAAU,IAAI,kBAAkB,EAAE,UAAU,IAAI,kBAAkB,EAAE,CAAC;AAE9E,0CAA0C;AAC1C,eAAO,MAAM,mBAAmB,EAAqD,OAAO,CAAC;AAC7F,uIAAuI;AACvI,eAAO,MAAM,cAAc,EAAqD,OAAO,CAAC;AACxF,2HAA2H;AAC3H,eAAO,MAAM,0BAA0B,EAAqD,OAAO,CAAC;AACpG,eAAO,MAAM,QAAQ,qBAA2D,CAAC;AAEjF,wDAAwD;AACxD,eAAO,MAAM,mBAAmB,EAAqD,OAAO,CAAC;AAC7F,uDAAuD;AACvD,eAAO,MAAM,cAAc,EAAqD,OAAO,CAAC;AACxF,6CAA6C;AAC7C,eAAO,MAAM,0BAA0B,EAAqD,OAAO,CAAC;AACpG,eAAO,MAAM,QAAQ,qBAA2D,CAAC"}

package/sdk/dist/svm/venues/bonkswap-fork/index.js

@@ -0,0 +1,208 @@
+/**
+ * Bonkswap / Guacswap — two independently-deployed Anchor programs that run
+ * BYTE-IDENTICAL account layouts, instruction lists, and swap math (Guacswap
+ * is a whitelabel fork of Bonkswap's `bonkswap` crate, confirmed via each
+ * program's own on-chain Anchor IDL account — `name:"bonkswap"` vs.
+ * `name:"guacswap"`, otherwise identical struct/instruction shapes). This
+ * module is a single parameterized factory instantiated once per program id,
+ * not two copies of the math — the SAME pattern `spl-token-swap-forks`
+ * already uses in this recipe for the analogous multi-deployment case.
+ *
+ * GROUND TRUTH — read directly off each program's own on-chain Anchor IDL
+ * account (the standard `createAddressWithSeed(findProgramAddress([],
+ * programId), "anchor:idl", programId)` PDA; both are populated on mainnet),
+ * NOT reverse-engineered from a third-party doc:
+ *   - Bonkswap `BSwp6bEBihVLdqJRKGgzjcGLHkcTuzmSo1TQkHepzH8p` — IDL
+ *     `version:"0.1.1"`, 81 live `Pool` (417-byte) pools measured
+ *     2026-07-31 via a keyless `getProgramAccounts` `dataSize` sweep, 0 live
+ *     `PoolV2` (514-byte) pools at the same measurement (the account TYPE
+ *     exists in the IDL and the `swap` ix's `pool` account carries no
+ *     Anchor-level type constraint — it's read manually — so a future
+ *     `PoolV2` pool decodes through the SAME offsets this module reads,
+ *     which only span the two structs' byte-identical common prefix; wired
+ *     anyway per the "wire both sizes" brief, at zero live cost today).
+ *   - Guacswap `Gswppe6ERWKpUTXvRPfXdzHhiCyJvLadVvXGfdpBqcE1` — IDL
+ *     `version:"0.1.1"`, 12 live `Pool` pools measured same date, no
+ *     `PoolV2` type in its IDL at all.
+ *   - Also cross-checked against the official BonkLabs Jupiter-AMM-interface
+ *     integration (github.com/BonkLabs/bonkswap-amm-integration, public,
+ *     TypeScript, `amm.ts`) for the reference quote math and account roles —
+ *     see ./ladder.ts's header for the ONE place that reference gets the
+ *     real program's rounding wrong (proven via real-CPI, not assumed).
+ *
+ * ACCOUNT LAYOUT — `Pool` (PoolV2's byte-identical prefix through the same
+ * offsets; discriminator sha256("account:Pool")[0..8] = f19a6d0411b16dbc for
+ * Pool, 5b0cd65707b9a737 for PoolV2 — both accepted, see `POOL_SIZE_V2`):
+ *   tokenX@8 (pubkey), tokenY@40, poolXAccount@72, poolYAccount@104,
+ *   admin@136, projectOwner@168, tokenXReserve@200 (Token=u64),
+ *   tokenYReserve@208, ..., constK@312 (Product=u128), price@328
+ *   (FixedPoint=u128, unused here — reserves are read live), lpFee@344
+ *   (FixedPoint=u128), buybackFee@360, projectFee@376, mercantiFee@392,
+ *   farmCount@408 (u64), bump@416 (u8) = 417 bytes total. Every fee is a
+ *   ppt-of-1e12 rate (`DEFAULT_DENOMINATOR` in the reference SDK): realistic
+ *   values never approach 2^64, so only the low 8 bytes of each 16-byte
+ *   FixedPoint fee field are read — `fetchPoolConfig` rejects any pool whose
+ *   fee's high word is nonzero rather than silently truncating it.
+ *
+ * SWAP INSTRUCTION — `swap(deltaIn: Token, priceLimit: FixedPoint, xToY:
+ * bool)`, disc sha256("global:swap")[0..8], 17 accounts (state, pool,
+ * tokenX, tokenY, poolXAccount, poolYAccount, swapperXAccount,
+ * swapperYAccount, swapper[signer], referrerXAccount, referrerYAccount,
+ * referrer, programAuthority, systemProgram, tokenProgram,
+ * associatedTokenProgram, rent) — read directly off the on-chain IDL and
+ * cross-checked against a real mainnet swap transaction's exact account
+ * list (`5MMaArf3.../3JmFx2bW...`, Bonkswap USDC/BONK).
+ *
+ * SELF-REFERRAL (this adapter's own choice, not merely a copy of the
+ * reference SDK's default `referrer = SystemProgram`): the `mercantiFee`
+ * slice of `deltaOut` is paid out as a REAL, DIRECT SPL transfer to whatever
+ * `referrerXAccount`/`referrerYAccount` the caller supplies — permissionless,
+ * confirmed via a real Guacswap mainnet transaction
+ * (`93tHLVugMrnoMaaHtvmXn8XnPR6eJhNpmCRE1KNdAVaE`, mercantiFee=250_000_000
+ * ppt = 0.025%) whose inner instructions show the mercanti-fee leg as a
+ * THIRD token transfer straight out of the pool vault to the referrer's own
+ * token account, distinct from the swapper's principal payout. This module's
+ * `buildSwapV2` therefore always sets `referrerXAccount = swapperXAccount`,
+ * `referrerYAccount = swapperYAccount`, `referrer = swapper` — the mercanti
+ * fee rebates back to the same trade, verified end-to-end via a REAL-CPI
+ * LiteSVM run against both dumped binaries (bit-exact against
+ * `referenceQuote`'s 3-fee model at 6/6 sizes×directions on the
+ * mercanti-nonzero Guacswap pool above, and again on a mercanti-zero
+ * Bonkswap pool). One Bonkswap tx observed live in the wild
+ * (`3JmFx2bW...`) already does exactly this (referrer == swapper's own
+ * accounts), so this is a real, already-used pattern, not a novel one.
+ *
+ * PRICE LIMIT — `priceLimit: FixedPoint` bounds the post-trade price: a
+ * MINIMUM for `xToY` (price only falls when selling X) and a MAXIMUM for
+ * `!xToY` (price only rises when selling Y) — derived from the reference
+ * SDK's `getPriceAfterSlippage` and confirmed by a real 100%-tolerance
+ * example computing exactly 0 for `xToY`. This adapter always disables the
+ * venue-native check (0 for `xToY`, u128::MAX for `!xToY` — the exact
+ * sentinel a real observed mainnet tx used for its `!xToY` leg) and relies
+ * on the recipe's own terminal `minOut`, the same convention every other
+ * wired SVM ladder uses for its venue-native slippage field.
+ *
+ * MATH — see ./ladder.ts's header for the constant-product formula and the
+ * ONE place it diverges from the reference SDK's own arithmetic (a rounding
+ * direction, proven wrong via real-CPI at 12/12 cases).
+ *
+ * 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 } from "@solana/kit";
+const POOL_SIZE_V1 = 417;
+const POOL_SIZE_V2 = 514;
+// sha256("account:Pool")[0..8] / sha256("account:PoolV2")[0..8].
+const POOL_DISCRIMINATOR = [0xf1, 0x9a, 0x6d, 0x04, 0x11, 0xb1, 0x6d, 0xbc];
+const POOL_V2_DISCRIMINATOR = [0x5b, 0x0c, 0xd6, 0x57, 0x07, 0xb9, 0xa7, 0x37];
+const OFF_TOKEN_X = 8;
+const OFF_TOKEN_Y = 40;
+const OFF_POOL_X_ACCOUNT = 72;
+const OFF_POOL_Y_ACCOUNT = 104;
+export const OFF_TOKEN_X_RESERVE = 200;
+export const OFF_TOKEN_Y_RESERVE = 208;
+export const OFF_CONST_K = 312; // u128 (Product)
+export const OFF_LP_FEE = 344; // u128 (FixedPoint), low u64 read
+export const OFF_BUYBACK_FEE = 360;
+export const OFF_PROJECT_FEE = 376;
+export const OFF_MERCANTI_FEE = 392;
+/** DEFAULT_DENOMINATOR — every fee field is a rate scaled by 1e12 (100%). */
+export const FEE_DENOMINATOR = 1000000000000n;
+function readUintLE(data, offset, width) {
+    let value = 0n;
+    for (let i = width - 1; i >= 0; i--)
+        value = (value << 8n) | BigInt(data[offset + i]);
+    return value;
+}
+function forkConfig(slug, base) {
+    if (base.venue !== slug)
+        throw new Error(`${slug} adapter got a '${base.venue}' pool config`);
+    return base;
+}
+/**
+ * One adapter per deployed Bonkswap fork — same layout/math (see module
+ * header), parameterized only by the fork's own program id.
+ */
+export function makeBonkswapForkAdapter(slug, programId) {
+    return {
+        slug,
+        programId,
+        async fetchPoolConfig(load, pool) {
+            const data = await load(pool);
+            if (data === null)
+                throw new Error(`${slug} pool ${pool} not found`);
+            if (data.length !== POOL_SIZE_V1 && data.length !== POOL_SIZE_V2) {
+                throw new Error(`${slug} pool ${pool} data is ${data.length} bytes, expected ${POOL_SIZE_V1} (Pool) or ${POOL_SIZE_V2} (PoolV2)`);
+            }
+            const expectedDisc = data.length === POOL_SIZE_V1 ? POOL_DISCRIMINATOR : POOL_V2_DISCRIMINATOR;
+            for (let i = 0; i < 8; i++) {
+                if (data[i] !== expectedDisc[i]) {
+                    throw new Error(`${slug} pool ${pool} has a wrong discriminator for its ${data.length}-byte size`);
+                }
+            }
+            const codec = getAddressCodec();
+            const pubkey = (offset) => codec.decode(data.subarray(offset, offset + 32));
+            const tokenXReserve = readUintLE(data, OFF_TOKEN_X_RESERVE, 8);
+            const tokenYReserve = readUintLE(data, OFF_TOKEN_Y_RESERVE, 8);
+            if (tokenXReserve === 0n || tokenYReserve === 0n) {
+                throw new Error(`${slug} pool ${pool} has an empty reserve (X=${tokenXReserve}, Y=${tokenYReserve})`);
+            }
+            const constKLo = readUintLE(data, OFF_CONST_K, 8);
+            const constKHi = readUintLE(data, OFF_CONST_K + 8, 8);
+            if (constKHi === 0n && constKLo === 0n)
+                throw new Error(`${slug} pool ${pool} has a zero constK`);
+            const feeAt = (offset, name) => {
+                const lo = readUintLE(data, offset, 8);
+                const hi = readUintLE(data, offset + 8, 8);
+                if (hi !== 0n)
+                    throw new Error(`${slug} pool ${pool} ${name} exceeds a u64 (hi word ${hi} nonzero) — refusing to truncate`);
+                return lo;
+            };
+            const lpFee = feeAt(OFF_LP_FEE, "lpFee");
+            const buybackFee = feeAt(OFF_BUYBACK_FEE, "buybackFee");
+            const projectFee = feeAt(OFF_PROJECT_FEE, "projectFee");
+            const mercantiFee = feeAt(OFF_MERCANTI_FEE, "mercantiFee");
+            const totalFee = lpFee + buybackFee + projectFee + mercantiFee;
+            if (totalFee > FEE_DENOMINATOR) {
+                throw new Error(`${slug} pool ${pool} total fee ${totalFee} exceeds 100% (${FEE_DENOMINATOR})`);
+            }
+            return {
+                venue: slug,
+                pool,
+                tokenX: pubkey(OFF_TOKEN_X),
+                tokenY: pubkey(OFF_TOKEN_Y),
+                poolXAccount: pubkey(OFF_POOL_X_ACCOUNT),
+                poolYAccount: pubkey(OFF_POOL_Y_ACCOUNT),
+                constKHi,
+                constKLo,
+                lpFee,
+                buybackFee,
+                projectFee,
+                mercantiFee,
+                direction: "xToY",
+            };
+        },
+    };
+}
+export { forkConfig as bonkswapForkConfig, readUintLE as bonkswapReadUintLE };
+/** Bonkswap — the original deployment. */
+export const BONKSWAP_PROGRAM_ID = "BSwp6bEBihVLdqJRKGgzjcGLHkcTuzmSo1TQkHepzH8p";
+/** Bonkswap's `state` PDA (seed "bonkswapstatev1") — verified via getProgramDerivedAddress and matches a real swap tx's account #0. */
+export const BONKSWAP_STATE = "2QWN6WjrJ3RAk51ecxLxaLPfFCYLAnmWJwJ1oKA92CRD";
+/** Bonkswap's vault-owning authority PDA (State.programAuthority) — matches every pool's vault SPL-token `owner` field. */
+export const BONKSWAP_PROGRAM_AUTHORITY = "8NyaPDJeC2eaBGpkRpZKnD9S448AZGgjSvumFe92DRK2";
+export const bonkswap = makeBonkswapForkAdapter("bonkswap", BONKSWAP_PROGRAM_ID);
+/** Guacswap — a whitelabel fork (see module header). */
+export const GUACSWAP_PROGRAM_ID = "Gswppe6ERWKpUTXvRPfXdzHhiCyJvLadVvXGfdpBqcE1";
+/** Guacswap's `state` PDA (seed "guacswapstatev1"). */
+export const GUACSWAP_STATE = "EzV4QKycvp4EDuAoTGjyY9HUS9Zn15vcmHkHJdNKHCnY";
+/** Guacswap's vault-owning authority PDA. */
+export const GUACSWAP_PROGRAM_AUTHORITY = "FRwL3qJHuT5iYTNopCyhU1tyDn1HwtHbSa1ieYF6q2m9";
+export const guacswap = makeBonkswapForkAdapter("guacswap", GUACSWAP_PROGRAM_ID);
+//# sourceMappingURL=index.js.map

package/sdk/dist/svm/venues/bonkswap-fork/index.js.map

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

package/sdk/dist/svm/venues/boop-fun/index.d.ts

@@ -0,0 +1,24 @@
+import type { Address } from "@solana/kit";
+import type { AccountLoader, PoolConfig } from "../types.js";
+declare const SLUG: "boop-fun";
+export declare const BOOP_FUN_PROGRAM_ID: Address;
+export interface BoopFunPoolConfig extends PoolConfig {
+    venue: typeof SLUG;
+    /** exactIn side: 'quoteToBase' (default, buy_token) | 'baseToQuote' (sell_token). */
+    direction: "quoteToBase" | "baseToQuote";
+    mint: Address;
+    /** Static per-curve constant (deploy-time, never mutated per trade — see module header). */
+    virtualSolReserves: bigint;
+    swapFeeBasisPoints: bigint;
+    bondingCurveVault: Address;
+    bondingCurveSolVault: Address;
+    tradingFeesVault: Address;
+}
+export declare const boopFun: {
+    slug: "boop-fun";
+    kind: "constant-product";
+    programId: Address;
+    fetchPoolConfig(load: AccountLoader, pool: Address): Promise<BoopFunPoolConfig>;
+};
+export {};
+//# sourceMappingURL=index.d.ts.map

package/sdk/dist/svm/venues/boop-fun/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/svm/venues/boop-fun/index.ts"],"names":[],"mappings":"AAyHA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAI7D,QAAA,MAAM,IAAI,EAAG,UAAmB,CAAC;AAEjC,eAAO,MAAM,mBAAmB,SAA0D,CAAC;AAoC3F,MAAM,WAAW,iBAAkB,SAAQ,UAAU;IACnD,KAAK,EAAE,OAAO,IAAI,CAAC;IACnB,qFAAqF;IACrF,SAAS,EAAE,aAAa,GAAG,aAAa,CAAC;IACzC,IAAI,EAAE,OAAO,CAAC;IACd,4FAA4F;IAC5F,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,oBAAoB,EAAE,OAAO,CAAC;IAC9B,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED,eAAO,MAAM,OAAO;;;;0BAIU,aAAa,QAAQ,OAAO,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAqFtF,CAAC"}

package/sdk/dist/svm/venues/boop-fun/index.js

@@ -0,0 +1,228 @@
+/**
+ * Boop.fun bonding curve (program `boop8hVGQGqehUK2iVEMEnMrL5RbjywRzHKBmBE7ry4`) — an Anchor
+ * launchpad curve, structurally the same FAMILY as the pump.fun bonding curve (already wired as
+ * `pumpfun-bonding-curve`): virtual+real SOL reserves against a real, depleting token reserve,
+ * a flat swap fee, `buy_token`/`sell_token` CPIs. A DIFFERENT program, DIFFERENT account layout,
+ * DIFFERENT (simpler, single-tier) fee model — its own family.
+ *
+ * GROUND TRUTH: the on-chain Anchor IDL (pulled from the program's own IDL account via the
+ * standard `createAddressWithSeed(findProgramAddress([], program).0, "anchor:idl", program)`
+ * derivation — 13,008 raw bytes / 7,288 zlib-compressed, 68,033 decompressed) gives every
+ * discriminator, PDA seed and account order below EXACTLY (no guessing): `BondingCurve` disc
+ * `17b7f83760d8ac60`, `buy_token` disc `8a7f0e5b26577369` (args `buy_amount:u64,
+ * amount_out_min:u64`), `sell_token` disc `6d3d28bbe6b087ae` (args `sell_amount:u64,
+ * amount_out_min:u64`), `Config` disc `9b0caae01efacc82`. Every PDA seed (`bonding_curve`,
+ * `bonding_curve_vault`, `bonding_curve_sol_vault`, `trading_fees_vault`, `config`,
+ * `vault_authority`) is the program's own declared seed list, not reverse-engineered.
+ *
+ * BONDING-CURVE ACCOUNT (`BondingCurve`, 125 fixed bytes — matches the IDL's field list
+ * exactly, confirmed against real fetched pool accounts):
+ *   creator pubkey @8   mint pubkey @40   virtual_sol_reserves u64 @72
+ *   virtual_token_reserves u64 @80 (DEPRECATED, see damping_term below — never read)
+ *   graduation_target u64 @88   graduation_fee u64 @96
+ *   sol_reserves u64 @104   token_reserves u64 @112
+ *   damping_term u8 @120   swap_fee_basis_points u8 @121
+ *   token_for_stakers_basis_points u16 @122 (a later distribution split, irrelevant to the
+ *   trader's own realized amount — never read)   status (BondingCurveStatus enum, u8) @124
+ * UNLIKE the already-wired pump.fun bonding curve, the mint IS embedded (@40) — no PDA-hint
+ * plumbing is needed for `fetchPoolConfig` itself; only DISCOVERY (finding a candidate pool
+ * address for a requested mint pair) needs the forward PDA derivation, because the account has no
+ * second stored mint to memcmp against (the quote side is always native SOL) — see
+ * `withBoopFunDiscovery` in the recipes repo's `the consuming app SVM discovery module`.
+ *
+ * TWO CURVE FORMULAS SHARE ONE ACCOUNT SHAPE — `damping_term` SELECTS WHICH (the IDL's own doc
+ * comment on `virtual_token_reserves`: "virtual token reserves is deprecated, we now use the xyk
+ * formula instead and it only requires virtual sol reserves ... to maintain backwards
+ * compatibility, if damping term is 30, we use the old formula"). MEASURED live (5 real
+ * `simulateTransaction`/on-chain-log validations below, `damping_term=31` throughout — the
+ * CURRENT `Config` default, confirmed by reading `Config` directly): the CURRENT formula is a
+ * plain constant-product AMM with the SOL side carrying a static virtual offset and the token
+ * side using the REAL depleting reserve directly, no virtual buffer:
+ *   x = virtual_sol_reserves + sol_reserves     (virtual_sol_reserves is a DEPLOY-TIME CONSTANT —
+ *       confirmed unchanged across multiple real trades on the same curve; it is NOT updated
+ *       per-trade the way pump.fun's own virtual reserves are)
+ *   y = token_reserves                          (real, depletes on every BUY)
+ *   BUY  (quoteToBase, buy_token):  fee = floor(buyAmount * feeBps / 10000); net = buyAmount - fee;
+ *        tokensOut = floor(y * net / (x + net))
+ *   SELL (baseToQuote, sell_token): gross = floor(x * tokensIn / (y + tokensIn));
+ *        fee = floor(gross * feeBps / 10000); solOut = gross - fee
+ * `damping_term == 30` (LEGACY, pre-migration curves) uses a MEASURABLY DIFFERENT formula — real
+ * `damping_term=30` trades diverge from the formula above by ~0.2-0.3% of output, a REAL
+ * difference, not rounding noise (measured against 7 real historical trades). This module does
+ * NOT model the legacy formula and REJECTS any `damping_term == 30` pool with a named gate error
+ * — a real, disclosed narrowing (see the pump.fun bonding curve's own mayhem/cashback scope note
+ * for the same shape of decision), not a refusal: every currently-deployable curve (`Config`'s own
+ * default is 31) is served.
+ *
+ * VALIDATION (`test/svm/venues/boop-fun.test.ts`, recipes repo, pins these as golden values) —
+ * REAL evidence at THREE-PLUS sizes, both directions, against the ACTUAL deployed program on REAL
+ * mainnet state:
+ *   - 2 REAL historical settled trades decoded from the program's own `TokenBoughtEvent` self-CPI
+ *     log (disc `4759de7cd7c0e68a`): pool `8uwipGAmbqzLFt6hky77C9YWEJzycLf9vgceEJyN1M7e` (mint
+ *     `KiHEYcvu2tSyVo4Ts9WwddcrhtqH1D8GACja1hVboop`), buyAmount 987,032 -> amountOut 33,197,204,730,517
+ *     (net fee 9,970) and, immediately after (same curve, updated reserves), buyAmount 1,047,302 ->
+ *     amountOut 35,221,877,455,153 (fee 10,578) — both reproduce EXACT or within 1 raw unit (a
+ *     genuine ~1e-13-relative on-chain rounding quirk that ALWAYS rounds in the trader's favor by
+ *     one raw token unit — this module's floor formula is the conservative, safe-direction bound).
+ *   - 1 REAL historical settled SELL decoded from the program's own `TokenSoldEvent` self-CPI log
+ *     (disc `ccefb64df1334d42`): pool `EXK9CcBLz2zn9QViPPCSGf9kJpPKvh33o7EGngeDuXXX` (mint
+ *     `EoFuCULaVELP5uESnvNJr3pkbyiVsd1qHGg7cViboop`), tokensIn 331,765,048,721,254 -> solOut
+ *     9,768,440 (fee 98,671), reproduced BIT-EXACT.
+ *   - 3 CONTROLLED `simulateTransaction` calls (`sigVerify:false`, impersonating the protocol's own
+ *     fee-recipient wallet `8QwU16Xe4BPyUD9MktHtgVjQQ5fAwywb9Zd5Hg1YTauF`, which genuinely holds
+ *     ~2,908 SOL on mainnet — no fabricated state) against the SAME REAL pool at THREE SIZES
+ *     spanning 3 orders of magnitude — 0.01 SOL (10,000,000 lamports, EXACT), 1 SOL (1,000,000,000
+ *     lamports, within 1 raw unit) and 5 SOL (5,000,000,000 lamports, within 1 raw unit) — every
+ *     one reproducing the program's own `TokenBoughtEvent` log.
+ *   - 1 CHAINED buy-then-sell simulation (2 SOL in, then sell every resulting token straight back
+ *     in the SAME transaction): the realized `TokenSoldEvent.amountOut` (1,960,200,000 lamports)
+ *     matches this module's predicted SELL net EXACTLY, even though the intermediate `gross`
+ *     figure is 1 raw unit off (the same on-chain rounding quirk noted above, which cancels out
+ *     through the fee floor here).
+ *
+ * CPI SHAPE (from the same on-chain IDL — 13 accounts for `buy_token`, 12 for `sell_token`, in
+ * this EXACT order; Anchor CPI account order is load-bearing):
+ *   buy_token:  mint, bonding_curve(w), trading_fees_vault(w), bonding_curve_vault(w),
+ *     bonding_curve_sol_vault(w), recipient_token_account(w), buyer(w,signer), config,
+ *     vault_authority, wsol, system_program, token_program, associated_token_program
+ *   sell_token: mint, bonding_curve(w), trading_fees_vault(w), bonding_curve_vault(w),
+ *     bonding_curve_sol_vault(w), seller_token_account(w), seller(w,signer), recipient(w),
+ *     config, system_program, token_program, associated_token_program
+ *
+ * `bonding_curve_sol_vault` is a PLAIN SYSTEM ACCOUNT (owner = System Program, zero data —
+ * confirmed live) holding NATIVE LAMPORTS, not a wSOL token account; `trading_fees_vault` IS a
+ * real SPL token account (owner = Token Program, mint = wSOL — confirmed live via a real
+ * `syncNative` inner instruction). NEITHER `buy_token` nor `sell_token` reads a buyer/seller-side
+ * wSOL account at all: a REAL mainnet transaction shows the program pulling the trade's SOL
+ * DIRECTLY from the `buyer` signer's native lamport balance via a nested `system_program::transfer`
+ * (there is no classic-vs-`_v2` split to route around here, unlike pump.fun's own bonding curve —
+ * this program has exactly one buy/sell instruction pair and it is native-SOL-settled both ways).
+ * CONSEQUENCE FOR A RECIPE'S SwapUser CONTRACT (real, disclosed, not a defect): a BUY's SOL leg is
+ * sourced from `user.owner`'s OWN NATIVE LAMPORT BALANCE (never `user.inAta` — the account is
+ * simply unused on the BUY side), and a SELL's SOL leg is credited directly to `user.owner`'s
+ * native balance too (via `recipient`, never `user.outAta`). The TOKEN side of both directions
+ * uses the normal `inAta`/`outAta` SPL contract. `config`/`vault_authority` are fixed, deploy-time
+ * PDAs (`["config"]` / `["vault_authority"]`, no per-pool seed) — hardcoded below, verified live.
+ *
+ * SCOPE (a real, disclosed narrowing): `damping_term == 30` legacy curves (above) and any
+ * non-`Trading`-status curve (graduated / mid-migration — `buy_token`/`sell_token` would not
+ * target the right venue anymore) both self-drop with a named gate error. `Config.is_paused`
+ * (the protocol-wide circuit breaker, offset 8 in `Config`, right after its own 8-byte
+ * discriminator — read BEFORE the variable-length `operators` vec, so no vec parsing is needed)
+ * is checked and gates loudly too: since SVM execution-time CPI catch/re-route is a platform
+ * impossibility (a launched CPI failure aborts the WHOLE cook, not just this slot), a paused
+ * protocol MUST be caught at fetch/prepare time, not left to fail on-chain. Only classic (Tokenkeg,
+ * 82-byte mint account) base mints are served — the CPI supplies exactly ONE `token_program`
+ * account (no separate base/quote token-program slot the way `pumpswap` has), so a Token-2022
+ * base mint has no correct program to route its own transfer through; such a mint is rejected with
+ * a named gate error rather than silently mis-targeted.
+ */
+import { getAddressDecoder, getAddressEncoder } from "@solana/kit";
+import { memoizedGetProgramDerivedAddress } from "../pda-memo.js";
+import { readUintLE } from "../math.js";
+import { TOKEN_2022_PROGRAM_ID, classifyMintProgram } from "../../token-program.js";
+import { parseMintExtensions } from "../../token-extensions.js";
+const SLUG = "boop-fun";
+export const BOOP_FUN_PROGRAM_ID = address_("boop8hVGQGqehUK2iVEMEnMrL5RbjywRzHKBmBE7ry4");
+/** PDA(["config"], PROGRAM) — fixed, deploy-time, verified live. */
+const CONFIG = address_("AbgFqRWjGWgUaVrZrLLWU5HDY5dktmAL6zT9aacQW7y1");
+const BONDING_CURVE_DISCRIMINATOR = [23, 183, 248, 55, 96, 216, 172, 96];
+const CONFIG_DISCRIMINATOR = [155, 12, 170, 224, 30, 250, 204, 130];
+/** Legacy pre-migration formula sentinel — out of scope, see the module header. */
+const LEGACY_DAMPING_TERM = 30;
+/** BondingCurveStatus::Trading — the only status this module serves. */
+const STATUS_TRADING = 0;
+function address_(s) {
+    return s;
+}
+function hasDiscriminator(data, discriminator) {
+    return data.length >= 8 && discriminator.every((byte, i) => data[i] === byte);
+}
+function pubkeyAt(data, offset) {
+    return getAddressDecoder().decode(data.subarray(offset, offset + 32));
+}
+async function pda(seeds, programAddress) {
+    const encoder = getAddressEncoder();
+    const rawSeeds = seeds.map((s) => typeof s === "string" ? new Uint8Array(encoder.encode(s)) : s);
+    return memoizedGetProgramDerivedAddress(programAddress, rawSeeds);
+}
+const SEED = (s) => new TextEncoder().encode(s);
+async function loadAccount(load, addr, what) {
+    const data = await load(addr);
+    if (data === null)
+        throw new Error(`boop-fun ${what} ${addr} not found`);
+    return data;
+}
+export const boopFun = {
+    slug: SLUG,
+    kind: "constant-product",
+    programId: BOOP_FUN_PROGRAM_ID,
+    async fetchPoolConfig(load, pool) {
+        const bcData = await loadAccount(load, pool, "bonding curve");
+        if (!hasDiscriminator(bcData, BONDING_CURVE_DISCRIMINATOR)) {
+            throw new Error(`boop-fun pool ${pool} discriminator mismatch (not a BondingCurve account)`);
+        }
+        if (bcData.length < 125) {
+            throw new Error(`boop-fun pool ${pool} data is ${bcData.length} bytes, expected at least 125`);
+        }
+        const mint = pubkeyAt(bcData, 40);
+        // Integrity check (defense in depth beyond the generic owner-verify every caller already
+        // performs): the pool account must be its OWN mint's canonical PDA, not merely SOME
+        // program-owned BondingCurve-shaped account handed to us by a bad discovery hint.
+        const expectedPool = await pda([SEED("bonding_curve"), mint], BOOP_FUN_PROGRAM_ID);
+        if (expectedPool !== pool) {
+            throw new Error(`boop-fun pool ${pool} does not derive from its own embedded mint ${mint} (expected bonding-curve PDA ${expectedPool})`);
+        }
+        const dampingTerm = bcData[120];
+        if (dampingTerm === LEGACY_DAMPING_TERM) {
+            throw new Error(`boop-fun pool ${pool} gate: damping_term is ${LEGACY_DAMPING_TERM} (the legacy pre-migration curve formula — unsupported, see the module header)`);
+        }
+        const status = bcData[124];
+        if (status !== STATUS_TRADING) {
+            throw new Error(`boop-fun pool ${pool} gate: status is ${status}, not Trading (${STATUS_TRADING}) — curve has graduated or is mid-migration`);
+        }
+        const virtualSolReserves = readUintLE(bcData, 72, 8);
+        const swapFeeBasisPoints = BigInt(bcData[121]);
+        const [mintData, configData, bondingCurveVault, bondingCurveSolVault, tradingFeesVault] = await Promise.all([
+            loadAccount(load, mint, "base mint"),
+            loadAccount(load, CONFIG, "config"),
+            pda([SEED("bonding_curve_vault"), mint], BOOP_FUN_PROGRAM_ID),
+            pda([SEED("bonding_curve_sol_vault"), mint], BOOP_FUN_PROGRAM_ID),
+            pda([SEED("trading_fees_vault"), mint], BOOP_FUN_PROGRAM_ID),
+        ]);
+        // The CPI supplies exactly ONE token_program account (no separate base/quote
+        // token-program slot), so the base mint's swap is legacy-SPL only: a
+        // Token-2022 base mint (or one carrying an un-routable extension) SELF-DROPS
+        // this pool. The thrown error is the graceful-drop signal the SvmRoute
+        // orchestrator catches. A classic 82-byte mint classifies legacy → no throw →
+        // config built byte-identically to before.
+        if (classifyMintProgram(mint, mintData) === TOKEN_2022_PROGRAM_ID) {
+            throw new Error(`boop-fun: 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(`boop-fun: dropping pool ${pool} — mint ${mint} is un-routable: ${blocking.join("; ")}`);
+        }
+        if (!hasDiscriminator(configData, CONFIG_DISCRIMINATOR)) {
+            throw new Error(`boop-fun config ${CONFIG} discriminator mismatch`);
+        }
+        // is_paused @ offset 8 (right after the 8-byte disc) — the FIRST field, so no need to parse
+        // the variable-length `operators` vec that follows it.
+        const isPaused = configData[8] !== 0;
+        if (isPaused) {
+            throw new Error(`boop-fun pool ${pool} gate: protocol Config.is_paused is set`);
+        }
+        return {
+            venue: SLUG,
+            pool,
+            direction: "quoteToBase",
+            mint,
+            virtualSolReserves,
+            swapFeeBasisPoints,
+            bondingCurveVault,
+            bondingCurveSolVault,
+            tradingFeesVault,
+        };
+    },
+};
+//# sourceMappingURL=index.js.map

package/sdk/dist/svm/venues/boop-fun/index.js.map

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

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

@@ -0,0 +1,27 @@
+import type { Address } from "@solana/kit";
+import type { AccountLoader } from "../types.js";
+import type { RaydiumClmmPoolConfig } from "../raydium-clmm/index.js";
+declare const SLUG: "byreal";
+/** Byreal's deployed program — a different program id than raydium-clmm's CAMMC... deployment. */
+export declare const BYREAL_PROGRAM_ID: Address<"REALQqNEomY6cQGZJUGwywTBD2UmDT32rZcNnfxQ5N2">;
+export interface ByrealPoolConfig extends Omit<RaydiumClmmPoolConfig, "venue"> {
+    venue: typeof SLUG;
+}
+/**
+ * Fetch + gate one Byreal pool and freeze both directions' boundary windows.
+ * A deliberate, minimal fork of fetchRaydiumClmmConfig — see the header for
+ * why (PDA derivation must use BYREAL_PROGRAM_ID, not raydium-clmm's).
+ * Read-only against the loader.
+ */
+export declare function fetchByrealPoolConfig(load: AccountLoader, pool: Address): Promise<ByrealPoolConfig>;
+/** Family facade for the recipe orchestrator (ladder-only, like raydium-clmm — no v1 adapter). */
+export declare const byreal: {
+    slug: "byreal";
+    programId: Address<"REALQqNEomY6cQGZJUGwywTBD2UmDT32rZcNnfxQ5N2">;
+    tokenProgram: Address<"TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA">;
+    token2022Program: Address<"TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb">;
+    memoProgram: Address<"MemoSq4gqABAXKb96qnH8TysNcWxMyWCqXgDLGmfcHr">;
+    fetchPoolConfig: typeof fetchByrealPoolConfig;
+};
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/svm/venues/byreal/index.ts"],"names":[],"mappings":"AA6DA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAU3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAEV,qBAAqB,EAEtB,MAAM,0BAA0B,CAAC;AAKlC,QAAA,MAAM,IAAI,EAAG,QAAiB,CAAC;AAE/B,kGAAkG;AAClG,eAAO,MAAM,iBAAiB,wDAAyD,CAAC;AAmCxF,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAAC,qBAAqB,EAAE,OAAO,CAAC;IAC5E,KAAK,EAAE,OAAO,IAAI,CAAC;CACpB;AAwHD;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,aAAa,EACnB,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,gBAAgB,CAAC,CA2G3B;AAED,kGAAkG;AAClG,eAAO,MAAM,MAAM;;;;;;;CAOlB,CAAC"}