@w3lib/solana-batch-call 0.4.0 → 0.5.0

package/dist/swap/clmmMath.js

@@ -0,0 +1,82 @@
+/**
+ * 集中流动性兑换一步的计算（只做按输入数量兑换），照搬 Raydium CLMM（libraries/swap_math.rs、sqrt_price_math.rs、liquidity_math.rs）
+ * 和 Orca Whirlpool（math/swap_math.rs、token_math.rs）。两个程序“手续费从输入扣”时的公式和取整完全相同；Raydium 另有“手续费从输出扣”的池子
+ */
+import { U64_MAX, mulDivCeil } from './common.js';
+const Q64 = 1n << 64n;
+export const FEE_RATE_DENOMINATOR = 1000000n;
+export class SwapMathError extends Error {
+}
+/** 价格从 a 到 b（任意顺序）对应的 token0 数量：L · 2^64 · (hi − lo) / (lo · hi) */
+export function amount0Delta(a, b, liquidity, roundUp) {
+    const [lo, hi] = a < b ? [a, b] : [b, a];
+    if (lo === 0n)
+        throw new SwapMathError('zero sqrt price');
+    const num = (liquidity * (hi - lo)) << 64n;
+    const den = lo * hi;
+    return roundUp ? (num + den - 1n) / den : num / den;
+}
+/** 价格从 a 到 b 对应的 token1 数量：L · (hi − lo) / 2^64 */
+export function amount1Delta(a, b, liquidity, roundUp) {
+    const [lo, hi] = a < b ? [a, b] : [b, a];
+    const p = liquidity * (hi - lo);
+    return roundUp ? (p + Q64 - 1n) >> 64n : p >> 64n;
+}
+/** 卖出 amount 后的 sqrt 价格（向不越过目标价格的方向取整）：卖 token0 时价格下降，卖 token1 时上升 */
+export function nextSqrtPriceFromInput(sqrtPrice, liquidity, amount, zeroForOne) {
+    if (liquidity === 0n)
+        throw new SwapMathError('zero liquidity');
+    if (amount === 0n)
+        return sqrtPrice;
+    if (zeroForOne) {
+        const num = liquidity << 64n;
+        const den = num + amount * sqrtPrice;
+        return mulDivCeil(num, sqrtPrice, den);
+    }
+    return sqrtPrice + (amount << 64n) / liquidity;
+}
+/**
+ * 一步兑换：从当前价格向目标价格，最多用 remaining 个输入。
+ * feeOnInput（Orca 和 Raydium 的默认）：输入先按费率扣手续费；否则（Raydium fee_on）：输出按费率扣
+ */
+export function computeSwapStep(sqrtCurrent, sqrtTarget, liquidity, remaining, feeRate, zeroForOne, feeOnInput, program) {
+    const amountForPrice = feeOnInput ? (remaining * (FEE_RATE_DENOMINATOR - feeRate)) / FEE_RATE_DENOMINATOR : remaining;
+    // 走到目标价格需要的输入（向上取整）和得到的输出（向下取整）；超过 u64 视为走不到
+    const inAtTarget = zeroForOne ? amount0Delta(sqrtTarget, sqrtCurrent, liquidity, true) : amount1Delta(sqrtCurrent, sqrtTarget, liquidity, true);
+    let sqrtNext;
+    let amountIn;
+    let amountOut;
+    const outAtTarget = () => (zeroForOne ? amount1Delta(sqrtTarget, sqrtCurrent, liquidity, false) : amount0Delta(sqrtCurrent, sqrtTarget, liquidity, false));
+    let reached = inAtTarget <= U64_MAX && amountForPrice >= inAtTarget;
+    // Raydium：目标价格处的输出超过 u64 也算走不到；Orca 照常走到目标（之后报错）
+    const out = reached ? outAtTarget() : 0n;
+    if (reached && program === 'raydium' && out > U64_MAX)
+        reached = false;
+    if (reached) {
+        sqrtNext = sqrtTarget;
+        amountIn = inAtTarget;
+        amountOut = out;
+    }
+    else {
+        sqrtNext = nextSqrtPriceFromInput(sqrtCurrent, liquidity, amountForPrice, zeroForOne);
+        amountIn = zeroForOne ? amount0Delta(sqrtNext, sqrtCurrent, liquidity, true) : amount1Delta(sqrtCurrent, sqrtNext, liquidity, true);
+        amountOut = zeroForOne ? amount1Delta(sqrtNext, sqrtCurrent, liquidity, false) : amount0Delta(sqrtCurrent, sqrtNext, liquidity, false);
+    }
+    if (amountIn > U64_MAX || amountOut > U64_MAX)
+        throw new SwapMathError('token amount exceeds u64');
+    if (zeroForOne ? sqrtNext < sqrtTarget : sqrtNext > sqrtTarget)
+        throw new SwapMathError('price moved past the target');
+    let feeAmount;
+    if (feeOnInput) {
+        feeAmount = sqrtNext !== sqrtTarget ? remaining - amountIn : mulDivCeil(amountIn, feeRate, FEE_RATE_DENOMINATOR - feeRate);
+    }
+    else {
+        feeAmount = mulDivCeil(amountOut, feeRate, FEE_RATE_DENOMINATOR);
+        amountOut -= feeAmount;
+        // 没走到目标价格：输入全部用掉（不足一个单位的零头归池子）
+        if (sqrtNext !== sqrtTarget)
+            amountIn = remaining;
+    }
+    return { sqrtPrice: sqrtNext, amountIn, amountOut, feeAmount };
+}
+//# sourceMappingURL=clmmMath.js.map

package/dist/swap/clmmMath.js.map

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

package/dist/swap/common.d.ts

@@ -0,0 +1,68 @@
+import { type AccountInfo } from '../layout.js';
+import { Bytes } from '../lp.js';
+import type { Instruction } from '../write/transaction.js';
+export type SolanaSwapProtocol = 'raydium-clmm' | 'orca-whirlpool' | 'raydium-cpmm' | 'raydium-amm';
+/** 报价时的链上环境：Clock sysvar 的时间（秒）和 epoch（Token-2022 转账手续费按 epoch 选配置；动态费率按时间衰减） */
+export interface SwapEnv {
+    timestamp: bigint;
+    epoch: bigint;
+}
+export declare const CLOCK_SYSVAR_ID = "SysvarC1ock11111111111111111111111111111111";
+/** Clock：slot u64、epoch_start_timestamp i64、epoch u64、leader_schedule_epoch u64、unix_timestamp i64 */
+export declare function parseClock(data: Uint8Array): SwapEnv;
+/** 读到的账户：address → 账户（不存在为 null）；没读的为 undefined */
+export type AccountGetter = (address: string) => AccountInfo | null | undefined;
+/** 池子不支持本地报价 / 兑换（跳过这个池子，原因在 plan 里能看到） */
+export declare class UnsupportedPool extends Error {
+}
+/** 报价还需要读这些账户（如兑换走得比预读的 tick 数组更远）：读完后重新报价 */
+export declare class NeedAccounts extends Error {
+    readonly addresses: string[];
+    constructor(addresses: string[]);
+}
+export declare const U64_MAX: bigint;
+export declare const mulDivFloor: (a: bigint, b: bigint, d: bigint) => bigint;
+export declare const mulDivCeil: (a: bigint, b: bigint, d: bigint) => bigint;
+export declare function need(get: AccountGetter, address: string, what: string): AccountInfo;
+/** 交易里要用的代币信息 */
+export interface SwapMint {
+    mint: string;
+    program: string;
+    decimals: number;
+    /** 原始 mint 账户（算 Token-2022 转账手续费） */
+    account: AccountInfo;
+}
+/**
+ * 解析池子里一种代币的 mint：SPL Token / Token-2022；带转账 hook（需要额外账户）的不支持。
+ * 带转账手续费的支持（按当前 epoch 的费率算）
+ */
+export declare function swapMint(mint: string, account: AccountInfo): SwapMint;
+/** Token-2022 转账手续费：ceil(amount × 费率 / 10000)，不超过单笔上限；SPL Token 为 0（与 Token-2022 的 calculate_epoch_fee 一致） */
+export declare function transferFee(mint: SwapMint, amount: bigint, epoch: bigint): bigint;
+/** 一跳的报价：用户付出 amountIn（含输入代币的转账手续费），实际收到 amountOut（已扣输出代币的转账手续费） */
+export interface HopQuote {
+    amountIn: bigint;
+    amountOut: bigint;
+    /** 交易里要传的额外账户（tick 数组等），由各协议的 instruction 使用 */
+    accounts: string[];
+    /** 集中流动性：穿过的已初始化 tick 数、成交的限价单 tick 数（Raydium） */
+    crossed?: number;
+    orders?: number;
+}
+/** 一个可以兑换的池子（已解析） */
+export interface SwapPool {
+    protocol: SolanaSwapProtocol;
+    address: string;
+    mint0: string;
+    mint1: string;
+    /** 报价要读的账户（池子账户之外）：按方向（zeroForOne：卖出 mint0） */
+    accounts(zeroForOne: boolean): string[];
+    /** 本地报价（只用读到的账户，纯计算）；池子不支持时抛 UnsupportedPool */
+    quote(get: AccountGetter, amountIn: bigint, zeroForOne: boolean, env: SwapEnv): HopQuote;
+    /** 兑换指令：从 input 代币账户卖出 amountIn，output 代币账户至少收到 minOut */
+    instruction(get: AccountGetter, owner: string, input: string, output: string, zeroForOne: boolean, quote: HopQuote, minOut: bigint): Instruction;
+    /** 两种代币的 mint 信息（报价后可用） */
+    mints(get: AccountGetter): [SwapMint, SwapMint];
+}
+export { Bytes };
+//# sourceMappingURL=common.d.ts.map

package/dist/swap/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/swap/common.ts"],"names":[],"mappings":"AACA,OAAO,EAAoD,KAAK,WAAW,EAAE,MAAM,cAAc,CAAA;AACjG,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAA;AAChC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAE1D,MAAM,MAAM,kBAAkB,GAAG,cAAc,GAAG,gBAAgB,GAAG,cAAc,GAAG,aAAa,CAAA;AAEnG,iFAAiF;AACjF,MAAM,WAAW,OAAO;IACtB,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;CACd;AAED,eAAO,MAAM,eAAe,gDAAgD,CAAA;AAE5E,sGAAsG;AACtG,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAIpD;AAED,mDAAmD;AACnD,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,WAAW,GAAG,IAAI,GAAG,SAAS,CAAA;AAE/E,2CAA2C;AAC3C,qBAAa,eAAgB,SAAQ,KAAK;CAAG;AAE7C,8CAA8C;AAC9C,qBAAa,YAAa,SAAQ,KAAK;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE;gBAAnB,SAAS,EAAE,MAAM,EAAE;CAGzC;AAED,eAAO,MAAM,OAAO,QAAmB,CAAA;AACvC,eAAO,MAAM,WAAW,GAAI,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,WAAgB,CAAA;AAC3E,eAAO,MAAM,UAAU,GAAI,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,WAAyB,CAAA;AAEnF,wBAAgB,IAAI,CAAC,GAAG,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAKnF;AAED,iBAAiB;AACjB,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,qCAAqC;IACrC,OAAO,EAAE,WAAW,CAAA;CACrB;AAID;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,QAAQ,CAWrE;AAED,8GAA8G;AAC9G,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAQjF;AAED,oEAAoE;AACpE,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,gDAAgD;IAChD,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,qBAAqB;AACrB,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,kBAAkB,CAAA;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,+CAA+C;IAC/C,QAAQ,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM,EAAE,CAAA;IACvC,gDAAgD;IAChD,KAAK,CAAC,GAAG,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,GAAG,QAAQ,CAAA;IACxF,0DAA0D;IAC1D,WAAW,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,CAAA;IAChJ,2BAA2B;IAC3B,KAAK,CAAC,GAAG,EAAE,aAAa,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;CAChD;AAED,OAAO,EAAE,KAAK,EAAE,CAAA"}

package/dist/swap/common.js

@@ -0,0 +1,65 @@
+import { TOKEN_2022_PROGRAM_ID, TOKEN_PROGRAM_ID } from '../constants.js';
+import { findExtension, parseMint, parseTransferFeeConfig } from '../layout.js';
+import { Bytes } from '../lp.js';
+export const CLOCK_SYSVAR_ID = 'SysvarC1ock11111111111111111111111111111111';
+/** Clock：slot u64、epoch_start_timestamp i64、epoch u64、leader_schedule_epoch u64、unix_timestamp i64 */
+export function parseClock(data) {
+    if (data.length < 40)
+        throw new Error('Unexpected Clock sysvar data');
+    const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
+    return { epoch: view.getBigUint64(16, true), timestamp: view.getBigInt64(32, true) };
+}
+/** 池子不支持本地报价 / 兑换（跳过这个池子，原因在 plan 里能看到） */
+export class UnsupportedPool extends Error {
+}
+/** 报价还需要读这些账户（如兑换走得比预读的 tick 数组更远）：读完后重新报价 */
+export class NeedAccounts extends Error {
+    addresses;
+    constructor(addresses) {
+        super(`Need ${addresses.length} more accounts`);
+        this.addresses = addresses;
+    }
+}
+export const U64_MAX = (1n << 64n) - 1n;
+export const mulDivFloor = (a, b, d) => (a * b) / d;
+export const mulDivCeil = (a, b, d) => (a * b + d - 1n) / d;
+export function need(get, address, what) {
+    const account = get(address);
+    if (account === undefined)
+        throw new Error(`${what} was not loaded: ${address}`);
+    if (account === null)
+        throw new UnsupportedPool(`${what} not found: ${address}`);
+    return account;
+}
+const EXTENSION_TRANSFER_HOOK = 14;
+/**
+ * 解析池子里一种代币的 mint：SPL Token / Token-2022；带转账 hook（需要额外账户）的不支持。
+ * 带转账手续费的支持（按当前 epoch 的费率算）
+ */
+export function swapMint(mint, account) {
+    if (account.owner !== TOKEN_PROGRAM_ID && account.owner !== TOKEN_2022_PROGRAM_ID) {
+        throw new UnsupportedPool(`${mint} is not a token mint`);
+    }
+    if (account.owner === TOKEN_2022_PROGRAM_ID) {
+        const hook = findExtension(account.data, EXTENSION_TRANSFER_HOOK);
+        if (hook && hook.length >= 64 && hook.subarray(32, 64).some((b) => b !== 0)) {
+            throw new UnsupportedPool(`${mint} has a transfer hook, which is not supported`);
+        }
+    }
+    return { mint, program: account.owner, decimals: parseMint(account.data).decimals, account };
+}
+/** Token-2022 转账手续费：ceil(amount × 费率 / 10000)，不超过单笔上限；SPL Token 为 0（与 Token-2022 的 calculate_epoch_fee 一致） */
+export function transferFee(mint, amount, epoch) {
+    if (mint.program !== TOKEN_2022_PROGRAM_ID || amount === 0n)
+        return 0n;
+    const config = parseTransferFeeConfig(mint.account.data);
+    if (!config)
+        return 0n;
+    const fee = epoch >= config.newer.epoch ? config.newer : config.older;
+    if (fee.basisPoints === 0)
+        return 0n;
+    const raw = (amount * BigInt(fee.basisPoints) + 9999n) / 10000n;
+    return raw < fee.maximumFee ? raw : fee.maximumFee;
+}
+export { Bytes };
+//# sourceMappingURL=common.js.map

package/dist/swap/common.js.map

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

package/dist/swap/cpmm.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Raydium CPMM 的兑换：swap_base_input。报价照搬程序（raydium-cp-swap curve/calculator.rs）：
+ * 交易费（含创建者手续费，从输入或输出扣）向上取整，恒定乘积向下取整，储备 = 金库余额 − 协议 / 基金 / 创建者手续费；输入输出的 Token-2022 转账手续费都算
+ */
+import { type AccountInfo } from '../layout.js';
+import { type SwapPool } from './common.js';
+interface CpmmState {
+    address: string;
+    config: string;
+    vault0: string;
+    vault1: string;
+    mint0: string;
+    mint1: string;
+    observation: string;
+    status: number;
+    openTime: bigint;
+    reserved0: bigint;
+    reserved1: bigint;
+    creatorFeeOn: number;
+    creatorFeeEnabled: boolean;
+}
+/** PoolState：amm_config 8、vault 72 / 104、mint 168 / 200、observation 296、status 329、协议 / 基金手续费 341…、open_time 373、creator_fee_on 389、enable_creator_fee 390、创建者手续费 397 / 405 */
+export declare function parseCpmmPool(account: AccountInfo): CpmmState | null;
+/** 恒定乘积的兑换（与程序 CurveCalculator::swap_base_input 一致），返回给用户的输出（未扣转账手续费） */
+export declare function cpmmSwapBaseInput(amountIn: bigint, reserveIn: bigint, reserveOut: bigint, tradeFeeRate: bigint, creatorFeeRate: bigint, creatorFeeOnInput: boolean): bigint;
+export declare function cpmmPool(state: CpmmState): SwapPool;
+export {};
+//# sourceMappingURL=cpmm.d.ts.map

package/dist/swap/cpmm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cpmm.d.ts","sourceRoot":"","sources":["../../src/swap/cpmm.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,cAAc,CAAA;AAIlE,OAAO,EAAgJ,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAA;AAKzL,UAAU,SAAS;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,EAAE,MAAM,CAAA;IACpB,iBAAiB,EAAE,OAAO,CAAA;CAC3B;AAED,+KAA+K;AAC/K,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,GAAG,SAAS,GAAG,IAAI,CAkBpE;AAED,yEAAyE;AACzE,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,EACtB,iBAAiB,EAAE,OAAO,GACzB,MAAM,CAUR;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ,CA6DnD"}

package/dist/swap/cpmm.js

@@ -0,0 +1,113 @@
+/**
+ * Raydium CPMM 的兑换：swap_base_input。报价照搬程序（raydium-cp-swap curve/calculator.rs）：
+ * 交易费（含创建者手续费，从输入或输出扣）向上取整，恒定乘积向下取整，储备 = 金库余额 − 协议 / 基金 / 创建者手续费；输入输出的 Token-2022 转账手续费都算
+ */
+import { parseTokenAccount } from '../layout.js';
+import { RAYDIUM_CPMM_AUTHORITY, RAYDIUM_CPMM_PROGRAM_ID } from '../lp.js';
+import { Writer, anchorIx, r, w } from '../liquidity/common.js';
+import { Bytes, UnsupportedPool, mulDivCeil, mulDivFloor, need, swapMint, transferFee } from './common.js';
+const FEE_DENOMINATOR = 1000000n;
+const POOL_SIZE = 637;
+/** PoolState：amm_config 8、vault 72 / 104、mint 168 / 200、observation 296、status 329、协议 / 基金手续费 341…、open_time 373、creator_fee_on 389、enable_creator_fee 390、创建者手续费 397 / 405 */
+export function parseCpmmPool(account) {
+    if (account.owner !== RAYDIUM_CPMM_PROGRAM_ID || account.data.length !== POOL_SIZE)
+        return null;
+    const b = new Bytes(account.data);
+    return {
+        address: account.address,
+        config: b.key(8),
+        vault0: b.key(72),
+        vault1: b.key(104),
+        mint0: b.key(168),
+        mint1: b.key(200),
+        observation: b.key(296),
+        status: b.u8(329),
+        openTime: b.u64(373),
+        reserved0: b.u64(341) + b.u64(357) + b.u64(397),
+        reserved1: b.u64(349) + b.u64(365) + b.u64(405),
+        creatorFeeOn: b.u8(389),
+        creatorFeeEnabled: b.u8(390) !== 0,
+    };
+}
+/** 恒定乘积的兑换（与程序 CurveCalculator::swap_base_input 一致），返回给用户的输出（未扣转账手续费） */
+export function cpmmSwapBaseInput(amountIn, reserveIn, reserveOut, tradeFeeRate, creatorFeeRate, creatorFeeOnInput) {
+    let afterFee;
+    if (creatorFeeOnInput) {
+        afterFee = amountIn - mulDivCeil(amountIn, tradeFeeRate + creatorFeeRate, FEE_DENOMINATOR);
+    }
+    else {
+        afterFee = amountIn - mulDivCeil(amountIn, tradeFeeRate, FEE_DENOMINATOR);
+    }
+    if (afterFee < 0n)
+        return 0n;
+    const swapped = mulDivFloor(afterFee, reserveOut, reserveIn + afterFee);
+    return creatorFeeOnInput ? swapped : swapped - mulDivCeil(swapped, creatorFeeRate, FEE_DENOMINATOR);
+}
+export function cpmmPool(state) {
+    const mints = (get) => [
+        swapMint(state.mint0, need(get, state.mint0, 'Token mint')),
+        swapMint(state.mint1, need(get, state.mint1, 'Token mint')),
+    ];
+    return {
+        protocol: 'raydium-cpmm',
+        address: state.address,
+        mint0: state.mint0,
+        mint1: state.mint1,
+        mints,
+        accounts: () => [state.config, state.vault0, state.vault1, state.mint0, state.mint1],
+        quote(get, amountIn, zeroForOne, env) {
+            // status 第 2 位（Swap）为 1 表示禁止兑换
+            if (state.status & 4)
+                throw new UnsupportedPool('Swap is disabled on this pool');
+            if (env.timestamp < state.openTime)
+                throw new UnsupportedPool('Pool is not open yet');
+            const [m0, m1] = mints(get);
+            const config = need(get, state.config, 'AMM config').data;
+            if (config.length < 124)
+                throw new UnsupportedPool('Unexpected AMM config');
+            const c = new Bytes(config);
+            // AmmConfig：trade_fee_rate 12、creator_fee_rate 108
+            const tradeFeeRate = c.u64(12);
+            const creatorFeeRate = state.creatorFeeEnabled ? c.u64(108) : 0n;
+            const v0 = parseTokenAccount(need(get, state.vault0, 'Pool vault').data).amount;
+            const v1 = parseTokenAccount(need(get, state.vault1, 'Pool vault').data).amount;
+            if (v0 < state.reserved0 || v1 < state.reserved1)
+                throw new UnsupportedPool('Pool vault is below the owed fees');
+            const [reserveIn, reserveOut] = zeroForOne ? [v0 - state.reserved0, v1 - state.reserved1] : [v1 - state.reserved1, v0 - state.reserved0];
+            const [mintIn, mintOut] = zeroForOne ? [m0, m1] : [m1, m0];
+            // 创建者手续费：0 两边都从输入扣；1 只收 token0；2 只收 token1（收哪种代币，卖出它时从输入扣，买入它时从输出扣）
+            const creatorOnInput = state.creatorFeeOn === 0 || (state.creatorFeeOn === 1 && zeroForOne) || (state.creatorFeeOn === 2 && !zeroForOne);
+            const actualIn = amountIn - transferFee(mintIn, amountIn, env.epoch);
+            if (actualIn <= 0n)
+                return { amountIn, amountOut: 0n, accounts: [] };
+            const out = cpmmSwapBaseInput(actualIn, reserveIn, reserveOut, tradeFeeRate, creatorFeeRate, creatorOnInput);
+            const received = out - transferFee(mintOut, out, env.epoch);
+            return { amountIn, amountOut: received > 0n ? received : 0n, accounts: [] };
+        },
+        instruction(get, owner, input, output, zeroForOne, quote, minOut) {
+            const [m0, m1] = mints(get);
+            const [mintIn, mintOut] = zeroForOne ? [m0, m1] : [m1, m0];
+            const [vaultIn, vaultOut] = zeroForOne ? [state.vault0, state.vault1] : [state.vault1, state.vault0];
+            return {
+                programId: RAYDIUM_CPMM_PROGRAM_ID,
+                keys: [
+                    r(owner, true),
+                    r(RAYDIUM_CPMM_AUTHORITY),
+                    r(state.config),
+                    w(state.address),
+                    w(input),
+                    w(output),
+                    w(vaultIn),
+                    w(vaultOut),
+                    r(mintIn.program),
+                    r(mintOut.program),
+                    r(mintIn.mint),
+                    r(mintOut.mint),
+                    w(state.observation),
+                ],
+                data: new Writer().bytes(anchorIx('swap_base_input')).u64(quote.amountIn).u64(minOut).build(),
+            };
+        },
+    };
+}
+//# sourceMappingURL=cpmm.js.map

package/dist/swap/cpmm.js.map

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

package/dist/swap/index.d.ts

@@ -0,0 +1,145 @@
+import type { SolanaClient } from '../client.js';
+import { type AccountInfo } from '../layout.js';
+import { type SolanaLpToken } from '../lp.js';
+import type { SendOptions, WriteResult, WriteStatus } from '../write/send.js';
+import { type SignerInput } from '../write/signer.js';
+import { type Instruction } from '../write/transaction.js';
+import { type SolanaSwapProtocol, type SwapPool } from './common.js';
+export type { SolanaSwapProtocol } from './common.js';
+/** 两跳默认的中间代币：Wrapped SOL、USDC、USDT */
+export declare const SWAP_INTERMEDIATES: readonly string[];
+/** 默认的协议：能按两个 mint 推导池子地址的三个，加上 pools 里给出的 AMM v4 池子 */
+export declare const SWAP_PROTOCOLS: readonly SolanaSwapProtocol[];
+type Amount = bigint | number | string;
+export interface SolanaSwapParams {
+    /** 卖出 / 买入的代币 mint；原生 SOL 用 NATIVE_MINT（So111…112）或客户端的 nativeMints，池子里按 Wrapped SOL */
+    tokenIn: string;
+    tokenOut: string;
+    /** 卖出的数量：amountIn（最小单位）和 amountInFormatted（按精度换算，如 '1.5'）二选一 */
+    amountIn?: Amount;
+    amountInFormatted?: string;
+}
+export interface SolanaSwapOptions {
+    /** 价格滑点（比例，0.005 = 0.5%），最少收到 = 报价 × (1 − slippage)，默认 0.005 */
+    slippage?: number;
+    /**
+     * Wrapped SOL 用 SOL 支付 / 收取（自动包装 / 解包），默认 true。
+     * 用的是 wSOL 的关联代币账户：原来没有时创建、用完关闭（换回 SOL）；原来就有时只补差额、不关闭（买入的 SOL 留在 wSOL 账户里）
+     */
+    native?: boolean;
+    /** 只用这些协议，默认 SWAP_PROTOCOLS（全部四个） */
+    protocols?: readonly SolanaSwapProtocol[];
+    /** 两跳的中间代币，默认 SWAP_INTERMEDIATES（Wrapped SOL、USDC、USDT）；传 [] 只找直接兑换 */
+    intermediates?: readonly string[];
+    /**
+     * 额外的池子地址（四个协议都可以，按账户所属程序识别）。Raydium AMM v4 的池子地址不能从两个 mint 推导，要用的话在这里给出；
+     * 用 seed_index 建的 Raydium CLMM 池子、非默认配置的 Orca 池子同样
+     */
+    pools?: readonly string[];
+    /** 按两个 mint 推导池子地址（Raydium CLMM / CPMM 的每个 AmmConfig、Orca 的每个费率档位），默认 true；false 时只用 pools 里的 */
+    discover?: boolean;
+    signal?: AbortSignal;
+}
+export interface SolanaSwapHop {
+    protocol: SolanaSwapProtocol;
+    protocolName: string;
+    pool: string;
+    tokenIn: string;
+    tokenOut: string;
+    /** 这一跳卖出的数量和预计收到的数量（已扣转账手续费） */
+    amountIn: string;
+    amountOut: string;
+    /** 这一跳的最少收到（按滑点），交易里的 other_amount_threshold */
+    amountOutMin: string;
+}
+export interface SolanaSwapRoute {
+    /** 经过的代币（池子里的 mint，SOL 是 Wrapped SOL） */
+    path: string[];
+    hops: SolanaSwapHop[];
+    /** 预计收到的数量（最小单位） */
+    amountOut: string;
+    /**
+     * 用于比较路线的数量：两跳时第二跳按第一跳的报价全部卖出能拿到的（实际第二跳只卖第一跳的最少收到，多出的中间代币留在账户里，见 leftover）；
+     * 直接兑换等于 amountOut
+     */
+    value: string;
+}
+export interface SolanaSwapStep {
+    /** setup：创建代币账户（能和兑换放进同一笔交易时会合并）；swap：包装 SOL、兑换、解包 */
+    kind: 'setup' | 'swap';
+    instructions: Instruction[];
+}
+/** 兑换的计划：报价 + 按顺序执行的指令。只读取、不签名，可以当作报价 */
+export interface SolanaSwapPlan {
+    owner: string;
+    tokenIn: SolanaLpToken;
+    tokenOut: SolanaLpToken;
+    amountIn: string;
+    amountInFormatted: string | null;
+    /** 预计收到的数量（按当前链上状态本地计算，与程序的取整一致）和最少收到的数量（按滑点） */
+    amountOut: string;
+    amountOutFormatted: string | null;
+    amountOutMin: string;
+    amountOutMinFormatted: string | null;
+    /** 1 个 tokenIn 换多少 tokenOut（按这笔的数量，路线的 value） */
+    price: number | null;
+    /** 价格影响（0~1）：这笔的价格比极小数量（1 / 10000）的价格差多少；算不出时为 null */
+    priceImpact: number | null;
+    route: SolanaSwapRoute;
+    /** 所有候选路线，按 value 从高到低（含选中的） */
+    routes: SolanaSwapRoute[];
+    /** 两跳时留在账户里的中间代币（第一跳报价 − 第一跳最少收到，按当前状态）；中间代币是 Wrapped SOL 且原来没有 wSOL 账户时随账户关闭换回 SOL */
+    leftover: {
+        mint: string;
+        amount: string;
+    } | null;
+    /** 哪一边用 SOL（自动包装 / 解包） */
+    native: 'tokenIn' | 'tokenOut' | null;
+    /** 没有用上的池子和原因（不支持的代币扩展、需要位图扩展、流动性不足等） */
+    skipped: Array<{
+        protocol: SolanaSwapProtocol;
+        pool: string;
+        reason: string;
+    }>;
+    steps: SolanaSwapStep[];
+}
+/** 按账户所属程序解析池子（包内使用，测试也用） */
+export declare function parseSwapPool(account: AccountInfo): SwapPool | null;
+/**
+ * 报价并构建兑换的指令（不签名）：选输出最多的路线，最少收到 = 报价 × (1 − slippage)。
+ *
+ * ```ts
+ * const plan = await buildSwap(client, owner, { tokenIn: NATIVE_MINT, tokenOut: USDC, amountInFormatted: '0.5' })
+ * plan.amountOutFormatted   // '93.41'
+ * plan.route.hops           // [{ protocol: 'raydium-clmm', pool: '3ucNos4N…', … }]
+ * ```
+ */
+export declare function buildSwap(client: SolanaClient, owner: string, params: SolanaSwapParams, options?: SolanaSwapOptions): Promise<SolanaSwapPlan>;
+export interface SolanaSwapSendOptions extends SolanaSwapOptions, Omit<SendOptions, 'onUpdate' | 'signal'> {
+    /** 发送前检查卖出的余额够不够，默认 true */
+    checkBalance?: boolean;
+    onUpdate?: (result: SolanaSwapStepResult) => void;
+}
+export interface SolanaSwapStepResult extends WriteResult {
+    kind: SolanaSwapStep['kind'];
+}
+export interface SolanaSwapResult {
+    plan: SolanaSwapPlan;
+    /** 与 plan.steps 一一对应 */
+    results: SolanaSwapStepResult[];
+    /** 兑换那一步的状态和签名 */
+    status: WriteStatus;
+    signature: string | null;
+}
+/**
+ * 兑换：构建（同 buildSwap）后用 from 签名发送（钱包同 /write 的 batchCall）。创建代币账户和兑换能放进同一笔交易时合并成一笔
+ *
+ * ```ts
+ * const r = await swap(client, secretKey, { tokenIn: USDC, tokenOut: NATIVE_MINT, amountInFormatted: '100' }, { slippage: 0.01 })
+ * r.status   // 'confirmed'
+ * ```
+ */
+export declare function swap(client: SolanaClient, from: SignerInput, params: SolanaSwapParams, options?: SolanaSwapSendOptions): Promise<SolanaSwapResult>;
+/** 卖出 SOL 时给手续费、wSOL 和收到代币的 ATA 租金留的 lamports（约 0.01 SOL） */
+export declare const SWAP_SOL_RESERVE = 10000000n;
+//# sourceMappingURL=index.d.ts.map

package/dist/swap/index.d.ts.map

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