@picon-finance/dlmm-sdk 1.8.0 → 1.9.0

package/README.md

@@ -117,6 +117,23 @@ Both are computed entirely from cached position + bin array data — `getBinInfo
 const { transferFeeX, transferFeeY } = await pool.getTransferFees();
 ```
 
+`Pool.getFeeRates(now?)` returns the base/dynamic/total fee rate the pool would charge for a swap at `now` (defaults to the current time) — decays the dynamic fee state first, the same "clock sim" the on-chain program runs right before pricing a real swap, so this reflects what a swap would actually pay rather than the raw, potentially stale, stored volatility accumulator:
+
+```ts
+const { baseFeeRate, dynamicFeeRate, totalFeeRate } = await pool.getFeeRates();
+```
+
+`swap`/`quote`/`quoteAndSwap`/`sync` all accept an optional `binArrayCount` (default: the protocol max for that instruction) to cap how many bin arrays get included — useful for capping compute/account budget on a swap you know won't need the full range. It must be at least 2 (one below the active bin array's index and the active bin array itself, or vice versa — the active bin array is always required):
+
+```ts
+const instructions = await pool.swap(userSigner, {
+  xToY: true,
+  amountIn: 1_000_000n,
+  minAmountOut: 0n,
+  binArrayCount: 4,
+});
+```
+
 Refresh a position's cached state after it changes on-chain (e.g. after a deposit lands):
 
 ```ts

package/dist/entities/dlmm_program.d.ts

@@ -22,16 +22,19 @@ export declare class DlmmProgram {
         xToY: boolean;
         amountIn: bigint;
         minAmountOut: bigint;
+        binArrayCount?: number;
     }, config?: FetchAccountConfig): Promise<Instruction[]>;
     quote(poolAddress: Address, params: {
         xToY: boolean;
         amountIn: bigint;
         slippageToleranceBps: number;
+        binArrayCount?: number;
     }, config?: FetchAccountConfig): Promise<QuoteOutput>;
     quoteAndSwap(user: TransactionSigner, poolAddress: Address, params: {
         xToY: boolean;
         amountIn: bigint;
         slippageToleranceBps: number;
+        binArrayCount?: number;
     }, config?: FetchAccountConfig): Promise<{
         quoteOutput: QuoteOutput;
         instructions: Instruction[];

package/dist/entities/dlmm_program.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dlmm_program.d.ts","sourceRoot":"","sources":["../../src/entities/dlmm_program.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EAEf,KAAK,OAAO,EACZ,KAAK,OAAO,EACZ,KAAK,WAAW,EAEhB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EAGzB,MAAM,aAAa,CAAC;AAOrB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EACL,IAAI,EAEL,MAAM,QAAQ,CAAC;AAWhB,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAE/B,qBAAa,WAAW;;IAItB,YACE,GAAG,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,EACvC,cAAc,GAAE,OAAiC,EAIlD;IAED,IAAW,GAAG,+5nBAAwB;IACtC,IAAW,cAAc,YAAmC;IAE/C,OAAO,CAClB,OAAO,EAAE,OAAO,EAChB,MAAM,CAAC,EAAE,kBAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAEf;IAEY,UAAU,CACrB,SAAS,EAAE,iBAAiB,EAC5B,MAAM,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,aAAa,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,OAAO,CAAC;QACpB,UAAU,EAAE,OAAO,CAAC;QACpB,aAAa,EAAE,OAAO,CAAC;QACvB,aAAa,EAAE,OAAO,CAAC;KACxB,GACA,OAAO,CAAC,WAAW,CAAC,CAKtB;IAEY,IAAI,CACf,IAAI,EAAE,iBAAiB,EACvB,WAAW,EAAE,OAAO,EACpB,MAAM,EAAE;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,EACjE,MAAM,CAAC,EAAE,kBAAkB,GAC1B,OAAO,CAAC,WAAW,EAAE,CAAC,CAGxB;IAEY,KAAK,CAChB,WAAW,EAAE,OAAO,EACpB,MAAM,EAAE;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,oBAAoB,EAAE,MAAM,CAAA;KAAE,EACzE,MAAM,CAAC,EAAE,kBAAkB,GAC1B,OAAO,CAAC,WAAW,CAAC,CAGtB;IAEY,YAAY,CACvB,IAAI,EAAE,iBAAiB,EACvB,WAAW,EAAE,OAAO,EACpB,MAAM,EAAE;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,oBAAoB,EAAE,MAAM,CAAA;KAAE,EACzE,MAAM,CAAC,EAAE,kBAAkB,GAC1B,OAAO,CAAC;QAAE,WAAW,EAAE,WAAW,CAAC;QAAC,YAAY,EAAE,WAAW,EAAE,CAAA;KAAE,CAAC,CAGpE;IAEY,0BAA0B,CACrC,KAAK,EAAE,OAAO,EACd,MAAM,CAAC,EAAE,mBAAmB,GAC3B,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,CA+BlC;IAEY,iBAAiB,CAC5B,QAAQ,EAAE,iBAAiB,EAC3B,MAAM,EAAE;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,uBAAuB,CAAC,EAAE,OAAO,CAAA;KAAE,GAChE,OAAO,CAAC,WAAW,CAAC,CAKtB;IAEY,sBAAsB,CACjC,SAAS,EAAE,iBAAiB,EAC5B,YAAY,EAAE,OAAO,GACpB,OAAO,CAAC,WAAW,CAAC,CAKtB;IAEY,oBAAoB,CAC/B,gBAAgB,EAAE,iBAAiB,GAClC,OAAO,CAAC,WAAW,CAAC,CAKtB;IAEY,0BAA0B,CACrC,SAAS,EAAE,iBAAiB,EAC5B,uBAAuB,EAAE,OAAO,GAC/B,OAAO,CAAC,WAAW,CAAC,CAKtB;IAEY,cAAc,CACzB,MAAM,CAAC,EAAE,kBAAkB,GAC1B,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAKzC;IAEY,mBAAmB,CAC9B,MAAM,CAAC,EAAE,kBAAkB,GAC1B,OAAO,CAAC,OAAO,CAAC,CAKlB;CACF"}
+{"version":3,"file":"dlmm_program.d.ts","sourceRoot":"","sources":["../../src/entities/dlmm_program.ts"],"names":[],"mappings":"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"}

package/dist/entities/pool.d.ts

@@ -1,6 +1,6 @@
 import { createSolanaRpc, type Address, type Account, type Instruction, type TransactionSigner, type FetchAccountConfig, type FetchAccountsConfig } from "@solana/kit";
 import { generated } from "..";
-import { type QuoteOutput, type TransferFee } from "../quote";
+import { type FeeRates, type QuoteOutput, type TransferFee } from "../quote";
 import { Position } from "./position";
 import { type ProgramConfig } from "./types";
 export declare class Pool {
@@ -23,6 +23,7 @@ export declare class Pool {
         transferFeeX?: TransferFee;
         transferFeeY?: TransferFee;
     }>;
+    getFeeRates(now?: bigint): Promise<FeeRates>;
     refresh(data: Account<generated.Pool>): Promise<void>;
     refresh(config?: FetchAccountConfig): Promise<void>;
     getPosition(address: Address, config?: FetchAccountsConfig): Promise<Position>;
@@ -33,25 +34,28 @@ export declare class Pool {
         upperBinId: number;
     }): Promise<Instruction[]>;
     closePosition(owner: TransactionSigner, positionMint: Address): Promise<Instruction>;
-    swap(user: TransactionSigner, { xToY, amountIn, minAmountOut, }: {
+    swap(user: TransactionSigner, { xToY, amountIn, minAmountOut, binArrayCount, }: {
         xToY: boolean;
         amountIn: bigint;
         minAmountOut: bigint;
+        binArrayCount?: number;
     }): Promise<Instruction[]>;
-    quote({ xToY, amountIn, slippageToleranceBps, }: {
+    quote({ xToY, amountIn, slippageToleranceBps, binArrayCount, }: {
         xToY: boolean;
         amountIn: bigint;
         slippageToleranceBps: number;
+        binArrayCount?: number;
     }): Promise<QuoteOutput>;
-    quoteAndSwap(user: TransactionSigner, { xToY, amountIn, slippageToleranceBps, }: {
+    quoteAndSwap(user: TransactionSigner, { xToY, amountIn, slippageToleranceBps, binArrayCount, }: {
         xToY: boolean;
         amountIn: bigint;
         slippageToleranceBps: number;
+        binArrayCount?: number;
     }): Promise<{
         quoteOutput: QuoteOutput;
         instructions: Instruction[];
     }>;
-    sync(user: TransactionSigner, desiredBinId: number): Promise<Instruction[]>;
+    sync(user: TransactionSigner, desiredBinId: number, binArrayCount?: number): Promise<Instruction[]>;
     setDynamicFeeConfig(authority: TransactionSigner, dynamicFeeConfig: generated.DynamicFeeConfig): Promise<Instruction>;
     setProtocolShare(authority: TransactionSigner, protocolShare: number): Promise<Instruction>;
     claimProtocolFee(authority: TransactionSigner): Promise<Instruction[]>;

package/dist/entities/pool.d.ts.map

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

package/dist/entities/pool.js

@@ -1,13 +1,14 @@
 import { AccountRole, } from "@solana/kit";
 import { fetchAllMint, } from "@solana-program/token-2022";
 import { generated } from "..";
-import { quote, } from "../quote";
+import { quote, getPoolFeeRates, } from "../quote";
 import { isAccount } from "../utils/type_guards";
+import { assertInRange } from "../utils/assert";
 import { resolveAdminConfigAddress } from "./admin_config";
 import { processAssociatedTokenAccountPair } from "../utils/ata";
 import { generateBinArrayIndicesForSwap, generateBinArrayIndicesForSync, } from "../utils/bin_location";
 import { resolveTransferFee } from "../utils/transfer_fee";
-import { MAX_BIN_ARRAYS_PER_SWAP, MAX_BIN_ARRAYS_PER_SYNC, } from "../utils/constants";
+import { MAX_BIN_ARRAYS_PER_SWAP, MIN_BIN_ARRAYS_PER_SWAP, MAX_BIN_ARRAYS_PER_SYNC, MIN_BIN_ARRAYS_PER_SYNC, } from "../utils/constants";
 import { Position, openPosition, closePosition, findPositionAddress, findAllPositionAddresses, } from "./position";
 import { findAllBinArrayAddresses } from "./bin_array";
 export class Pool {
@@ -43,6 +44,9 @@ export class Pool {
             transferFeeY: resolveTransferFee(this.#mintY.data, epoch),
         };
     }
+    async getFeeRates(now = BigInt(Math.floor(Date.now() / 1000))) {
+        return await getPoolFeeRates(this.data, now);
+    }
     async refresh(arg) {
         if (!isAccount(arg)) {
             arg = await generated.fetchPool(this.#rpc, this.address, arg);
@@ -66,8 +70,9 @@ export class Pool {
     async closePosition(owner, positionMint) {
         return await closePosition({ owner, positionMint }, { programAddress: this.#programAddress });
     }
-    async swap(user, { xToY, amountIn, minAmountOut, }) {
-        const indices = generateBinArrayIndicesForSwap(this.activeBinId, xToY, MAX_BIN_ARRAYS_PER_SWAP);
+    async swap(user, { xToY, amountIn, minAmountOut, binArrayCount = MAX_BIN_ARRAYS_PER_SWAP, }) {
+        assertInRange(binArrayCount, MIN_BIN_ARRAYS_PER_SWAP, MAX_BIN_ARRAYS_PER_SWAP, "binArrayCount");
+        const indices = generateBinArrayIndicesForSwap(this.activeBinId, xToY, binArrayCount);
         const [binArrayAddresses, { ataX: tokenUserAccountX, ataY: tokenUserAccountY, preInstructions, postInstructions, }] = await Promise.all([
             findAllBinArrayAddresses({ pool: this.address, indices }, { programAddress: this.#programAddress }),
             processAssociatedTokenAccountPair({
@@ -99,8 +104,9 @@ export class Pool {
         const swapIxWithBinArrays = { ...swapIx, accounts: [...swapIx.accounts, ...remainingAccounts] };
         return [...preInstructions, swapIxWithBinArrays, ...postInstructions];
     }
-    async quote({ xToY, amountIn, slippageToleranceBps, }) {
-        const indices = generateBinArrayIndicesForSwap(this.activeBinId, xToY, MAX_BIN_ARRAYS_PER_SWAP);
+    async quote({ xToY, amountIn, slippageToleranceBps, binArrayCount = MAX_BIN_ARRAYS_PER_SWAP, }) {
+        assertInRange(binArrayCount, MIN_BIN_ARRAYS_PER_SWAP, MAX_BIN_ARRAYS_PER_SWAP, "binArrayCount");
+        const indices = generateBinArrayIndicesForSwap(this.activeBinId, xToY, binArrayCount);
         const binArrayAddresses = await findAllBinArrayAddresses({ pool: this.address, indices }, { programAddress: this.#programAddress });
         const [maybeBinArrays, { transferFeeX, transferFeeY }] = await Promise.all([
             generated.fetchAllMaybeBinArray(this.#rpc, binArrayAddresses),
@@ -118,13 +124,14 @@ export class Pool {
             binArrays,
         });
     }
-    async quoteAndSwap(user, { xToY, amountIn, slippageToleranceBps, }) {
-        const quoteOutput = await this.quote({ xToY, amountIn, slippageToleranceBps });
-        const instructions = await this.swap(user, { xToY, amountIn, minAmountOut: quoteOutput.minAmountOut });
+    async quoteAndSwap(user, { xToY, amountIn, slippageToleranceBps, binArrayCount = MAX_BIN_ARRAYS_PER_SWAP, }) {
+        const quoteOutput = await this.quote({ xToY, amountIn, slippageToleranceBps, binArrayCount });
+        const instructions = await this.swap(user, { xToY, amountIn, minAmountOut: quoteOutput.minAmountOut, binArrayCount });
         return { quoteOutput, instructions };
     }
-    async sync(user, desiredBinId) {
-        const indices = generateBinArrayIndicesForSync(this.activeBinId, desiredBinId, MAX_BIN_ARRAYS_PER_SYNC);
+    async sync(user, desiredBinId, binArrayCount = MAX_BIN_ARRAYS_PER_SYNC) {
+        assertInRange(binArrayCount, MIN_BIN_ARRAYS_PER_SYNC, MAX_BIN_ARRAYS_PER_SYNC, "binArrayCount");
+        const indices = generateBinArrayIndicesForSync(this.activeBinId, desiredBinId, binArrayCount);
         const binArrayAddresses = await findAllBinArrayAddresses({ pool: this.address, indices }, { programAddress: this.#programAddress });
         const syncPoolIx = generated.getSyncPoolInstruction({ user, pool: this.address, desiredBinId }, { programAddress: this.#programAddress });
         const remainingAccounts = binArrayAddresses.map(address => ({ address, role: AccountRole.READONLY }));

package/dist/entities/position.d.ts.map

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

package/dist/entities/position.js

@@ -5,9 +5,9 @@ import { findPositionTokenAccount, processAssociatedTokenAccountPair, } from "..
 import { getBinIndex, getBinArrayIndex, getPositionBinArrayIndices, } from "../utils/bin_location";
 import { assertRangeWithinRange, assertPositionBelongsToPool, } from "../utils/assert";
 import { isUndefined } from "../utils/type_guards";
-import { chunk, fetchInChunks } from "../utils/chunk";
+import { chunk, fetchInChunks, } from "../utils/chunk";
 import { resolveAdminConfigAddress } from "./admin_config";
-import { MAX_ACCOUNTS_PER_RPC_BATCH, MAX_POSITIONS_PER_CLAIM } from "../utils/constants";
+import { MAX_POSITIONS_PER_CLAIM, MAX_ACCOUNTS_PER_RPC_BATCH, } from "../utils/constants";
 import { BinArray, decodeAllBinArrays, createAllBinArrays, fetchAllBinArraysChunked, } from "./bin_array";
 export class Position {
     #pool;

package/dist/index.d.ts

@@ -4,6 +4,6 @@ export * as events from "./events";
 export * from "./entities";
 export * from "./utils/constants";
 export { NATIVE_MINT_ADDRESS } from "./utils/ata";
-export type { QuoteOutput, TransferFee } from "./quote";
+export type { QuoteOutput, TransferFee, FeeRates } from "./quote";
 export * from "./program_addresses";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACxD,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAClE,cAAc,qBAAqB,CAAC"}

package/dist/quote/index.d.ts

@@ -1,5 +1,6 @@
-import { type QuoteInput, type QuoteOutput, type PoolState, type TransferFee } from "#wasm";
-export type { QuoteInput, QuoteOutput, PoolState, TransferFee };
+import { type QuoteInput, type QuoteOutput, type PoolState, type TransferFee, type FeeRates } from "#wasm";
+export type { QuoteInput, QuoteOutput, PoolState, TransferFee, FeeRates };
 export declare function quote(input: QuoteInput): Promise<QuoteOutput>;
 export declare function applyTransferFee(amount: bigint, fee?: TransferFee): Promise<bigint>;
+export declare function getPoolFeeRates(poolState: PoolState, now: bigint): Promise<FeeRates>;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/quote/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,WAAW,EACjB,MAAM,OAAO,CAAC;AAEf,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC;AAEhE,wBAAsB,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CAGnE;AAED,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAGzF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/quote/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,QAAQ,EACd,MAAM,OAAO,CAAC;AAEf,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC;AAE1E,wBAAsB,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CAGnE;AAED,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAGzF;AAKD,wBAAsB,eAAe,CAAC,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAG1F"}

package/dist/quote/index.js

@@ -7,3 +7,10 @@ export async function applyTransferFee(amount, fee) {
     const wasm = await loadWasm();
     return wasm.applyTransferFee(amount, fee);
 }
+// Decays the dynamic fee state to `now` first (the same "clock sim" the program does on-chain
+// right before pricing a real swap), so the returned rates reflect what a swap would actually
+// pay right now rather than the raw, potentially stale, stored volatility_accumulator.
+export async function getPoolFeeRates(poolState, now) {
+    const wasm = await loadWasm();
+    return wasm.getPoolFeeRates(poolState, now);
+}

package/dist/quote/wasm-node/picon_dlmm_quote.d.ts

@@ -27,6 +27,12 @@ export interface DynamicFeeState {
     lastUpdateTimestamp: bigint;
 }
 
+export interface FeeRates {
+    baseFeeRate: bigint;
+    dynamicFeeRate: bigint;
+    totalFeeRate: bigint;
+}
+
 export interface PoolState {
     binStep: number;
     feeRate: number;
@@ -67,4 +73,12 @@ export interface TransferFee {
  */
 export function applyTransferFee(amount: bigint, fee?: TransferFee | null): bigint;
 
+/**
+ * Base/dynamic/total fee rate `pool_state` would charge for a swap happening at `now` —
+ * decays the dynamic fee state to `now` first (the same "clock sim" `decay_dynamic_fee` does
+ * on-chain right before pricing a real swap), so this reflects what a swap would actually pay
+ * rather than the raw, potentially stale, stored `volatility_accumulator`.
+ */
+export function getPoolFeeRates(pool_state: PoolState, now: bigint): FeeRates;
+
 export function quote(input: QuoteInput): QuoteOutput;

package/dist/quote/wasm-node/picon_dlmm_quote.js

@@ -17,6 +17,20 @@ export function applyTransferFee(amount, fee) {
     return BigInt.asUintN(64, ret[0]);
 }
 
+/**
+ * Base/dynamic/total fee rate `pool_state` would charge for a swap happening at `now` —
+ * decays the dynamic fee state to `now` first (the same "clock sim" `decay_dynamic_fee` does
+ * on-chain right before pricing a real swap), so this reflects what a swap would actually pay
+ * rather than the raw, potentially stale, stored `volatility_accumulator`.
+ * @param {PoolState} pool_state
+ * @param {bigint} now
+ * @returns {FeeRates}
+ */
+export function getPoolFeeRates(pool_state, now) {
+    const ret = wasm.getPoolFeeRates(pool_state, now);
+    return ret;
+}
+
 /**
  * @param {QuoteInput} input
  * @returns {QuoteOutput}

package/dist/quote/wasm-node/picon_dlmm_quote_bg.wasm.d.ts

@@ -2,6 +2,7 @@
 /* eslint-disable */
 export const memory: WebAssembly.Memory;
 export const applyTransferFee: (a: bigint, b: number) => [bigint, number, number];
+export const getPoolFeeRates: (a: any, b: bigint) => any;
 export const quote: (a: any) => [number, number, number];
 export const __wbindgen_malloc: (a: number, b: number) => number;
 export const __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;

package/dist/quote/wasm-web/picon_dlmm_quote.d.ts

@@ -27,6 +27,12 @@ export interface DynamicFeeState {
     lastUpdateTimestamp: bigint;
 }
 
+export interface FeeRates {
+    baseFeeRate: bigint;
+    dynamicFeeRate: bigint;
+    totalFeeRate: bigint;
+}
+
 export interface PoolState {
     binStep: number;
     feeRate: number;
@@ -67,6 +73,14 @@ export interface TransferFee {
  */
 export function applyTransferFee(amount: bigint, fee?: TransferFee | null): bigint;
 
+/**
+ * Base/dynamic/total fee rate `pool_state` would charge for a swap happening at `now` —
+ * decays the dynamic fee state to `now` first (the same "clock sim" `decay_dynamic_fee` does
+ * on-chain right before pricing a real swap), so this reflects what a swap would actually pay
+ * rather than the raw, potentially stale, stored `volatility_accumulator`.
+ */
+export function getPoolFeeRates(pool_state: PoolState, now: bigint): FeeRates;
+
 export function quote(input: QuoteInput): QuoteOutput;
 
 export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembly.Module;
@@ -74,6 +88,7 @@ export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembl
 export interface InitOutput {
     readonly memory: WebAssembly.Memory;
     readonly applyTransferFee: (a: bigint, b: number) => [bigint, number, number];
+    readonly getPoolFeeRates: (a: any, b: bigint) => any;
     readonly quote: (a: any) => [number, number, number];
     readonly __wbindgen_malloc: (a: number, b: number) => number;
     readonly __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;

package/dist/quote/wasm-web/picon_dlmm_quote.js

@@ -15,6 +15,20 @@ export function applyTransferFee(amount, fee) {
     return BigInt.asUintN(64, ret[0]);
 }
 
+/**
+ * Base/dynamic/total fee rate `pool_state` would charge for a swap happening at `now` —
+ * decays the dynamic fee state to `now` first (the same "clock sim" `decay_dynamic_fee` does
+ * on-chain right before pricing a real swap), so this reflects what a swap would actually pay
+ * rather than the raw, potentially stale, stored `volatility_accumulator`.
+ * @param {PoolState} pool_state
+ * @param {bigint} now
+ * @returns {FeeRates}
+ */
+export function getPoolFeeRates(pool_state, now) {
+    const ret = wasm.getPoolFeeRates(pool_state, now);
+    return ret;
+}
+
 /**
  * @param {QuoteInput} input
  * @returns {QuoteOutput}

package/dist/quote/wasm-web/picon_dlmm_quote_bg.wasm.d.ts

@@ -2,6 +2,7 @@
 /* eslint-disable */
 export const memory: WebAssembly.Memory;
 export const applyTransferFee: (a: bigint, b: number) => [bigint, number, number];
+export const getPoolFeeRates: (a: any, b: bigint) => any;
 export const quote: (a: any) => [number, number, number];
 export const __wbindgen_malloc: (a: number, b: number) => number;
 export const __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;

package/dist/utils/assert.d.ts

@@ -1,6 +1,7 @@
 import type { Address } from "@solana/kit";
 import type { BinIdRange } from "./bin_location";
 export declare function assertRangeWithinRange(inner: BinIdRange, outer: BinIdRange): void;
+export declare function assertInRange(value: number, min: number, max: number, label: string): void;
 export declare function assertPositionBelongsToPool(position: {
     pool: Address;
 }, pool: {

package/dist/utils/assert.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assert.d.ts","sourceRoot":"","sources":["../../src/utils/assert.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,UAAU,GAChB,IAAI,CAMN;AAED,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,EAC3B,IAAI,EAAE;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,GACzB,IAAI,CAMN"}
+{"version":3,"file":"assert.d.ts","sourceRoot":"","sources":["../../src/utils/assert.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,UAAU,GAChB,IAAI,CAMN;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAI1F;AAED,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,EAC3B,IAAI,EAAE;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,GACzB,IAAI,CAMN"}

package/dist/utils/assert.js

@@ -3,6 +3,11 @@ export function assertRangeWithinRange(inner, outer) {
         throw new RangeError(`Range (${inner.lowerBinId} to ${inner.upperBinId}) must be inside range (${outer.lowerBinId} to ${outer.upperBinId})`);
     }
 }
+export function assertInRange(value, min, max, label) {
+    if (value < min || value > max) {
+        throw new RangeError(`${label} (${value}) must be between ${min} and ${max}`);
+    }
+}
 export function assertPositionBelongsToPool(position, pool) {
     if (position.pool !== pool.address) {
         throw new Error(`Position's pool (${position.pool}) does not match expected pool (${pool.address})`);

package/dist/utils/constants.d.ts

@@ -9,5 +9,7 @@ export declare const MAX_PROTOCOL_SHARE: number;
 export declare const MAX_BASIS_POINTS: number;
 export declare const DYNAMIC_FEE_DIVISOR: bigint;
 export declare const MAX_POSITIONS_PER_CLAIM = 3;
+export declare const MIN_BIN_ARRAYS_PER_SWAP = 2;
+export declare const MIN_BIN_ARRAYS_PER_SYNC = 2;
 export declare const MAX_ACCOUNTS_PER_RPC_BATCH = 100;
 //# sourceMappingURL=constants.d.ts.map

package/dist/utils/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"AA6BA,eAAO,MAAM,kBAAkB,QAA6C,CAAC;AAC7E,eAAO,MAAM,2BAA2B,QAAsD,CAAC;AAC/F,eAAO,MAAM,uBAAuB,QAAkD,CAAC;AACvF,eAAO,MAAM,uBAAuB,QAAkD,CAAC;AAEvF,eAAO,MAAM,aAAa,QAAwC,CAAC;AACnE,eAAO,MAAM,gBAAgB,QAA2C,CAAC;AACzE,eAAO,MAAM,YAAY,QAAuC,CAAC;AACjE,eAAO,MAAM,kBAAkB,QAA6C,CAAC;AAC7E,eAAO,MAAM,gBAAgB,QAA2C,CAAC;AACzE,eAAO,MAAM,mBAAmB,QAA8C,CAAC;AAE/E,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAGzC,eAAO,MAAM,0BAA0B,MAAM,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"AA6BA,eAAO,MAAM,kBAAkB,QAA6C,CAAC;AAC7E,eAAO,MAAM,2BAA2B,QAAsD,CAAC;AAC/F,eAAO,MAAM,uBAAuB,QAAkD,CAAC;AACvF,eAAO,MAAM,uBAAuB,QAAkD,CAAC;AAEvF,eAAO,MAAM,aAAa,QAAwC,CAAC;AACnE,eAAO,MAAM,gBAAgB,QAA2C,CAAC;AACzE,eAAO,MAAM,YAAY,QAAuC,CAAC;AACjE,eAAO,MAAM,kBAAkB,QAA6C,CAAC;AAC7E,eAAO,MAAM,gBAAgB,QAA2C,CAAC;AACzE,eAAO,MAAM,mBAAmB,QAA8C,CAAC;AAE/E,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAMzC,eAAO,MAAM,uBAAuB,IAAI,CAAC;AACzC,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAGzC,eAAO,MAAM,0BAA0B,MAAM,CAAC"}

package/dist/utils/constants.js

@@ -34,5 +34,11 @@ export const MAX_PROTOCOL_SHARE = getIdlNumberConstant("MAX_PROTOCOL_SHARE");
 export const MAX_BASIS_POINTS = getIdlNumberConstant("MAX_BASIS_POINTS");
 export const DYNAMIC_FEE_DIVISOR = getIdlBigIntConstant("DYNAMIC_FEE_DIVISOR");
 export const MAX_POSITIONS_PER_CLAIM = 3;
+// Client-side floor, not a protocol constant: generateBinArrayIndicesForSwap/ForSync's index
+// math (utils/bin_location.ts) always excludes the pool's active bin array when the count is 1
+// — 2 is the smallest binArrayCount that's guaranteed to include it, which the on-chain program
+// requires (see Pool.swap/quote/sync in entities/pool.ts).
+export const MIN_BIN_ARRAYS_PER_SWAP = 2;
+export const MIN_BIN_ARRAYS_PER_SYNC = 2;
 // Solana RPC's own hard cap on addresses per getMultipleAccounts request.
 export const MAX_ACCOUNTS_PER_RPC_BATCH = 100;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@picon-finance/dlmm-sdk",
-  "version": "1.8.0",
+  "version": "1.9.0",
   "description": "Typescript SDK for interacting with the Picon DLMM protocol",
   "author": "Picon Finance",
   "license": "MIT",

package/src/entities/dlmm_program.ts

@@ -78,7 +78,7 @@ export class DlmmProgram {
   public async swap(
     user: TransactionSigner,
     poolAddress: Address,
-    params: { xToY: boolean, amountIn: bigint, minAmountOut: bigint },
+    params: { xToY: boolean, amountIn: bigint, minAmountOut: bigint, binArrayCount?: number },
     config?: FetchAccountConfig,
   ): Promise<Instruction[]> {
     const pool = await this.getPool(poolAddress, config);
@@ -87,7 +87,7 @@ export class DlmmProgram {
 
   public async quote(
     poolAddress: Address,
-    params: { xToY: boolean, amountIn: bigint, slippageToleranceBps: number },
+    params: { xToY: boolean, amountIn: bigint, slippageToleranceBps: number, binArrayCount?: number },
     config?: FetchAccountConfig,
   ): Promise<QuoteOutput> {
     const pool = await this.getPool(poolAddress, config);
@@ -97,7 +97,7 @@ export class DlmmProgram {
   public async quoteAndSwap(
     user: TransactionSigner,
     poolAddress: Address,
-    params: { xToY: boolean, amountIn: bigint, slippageToleranceBps: number },
+    params: { xToY: boolean, amountIn: bigint, slippageToleranceBps: number, binArrayCount?: number },
     config?: FetchAccountConfig,
   ): Promise<{ quoteOutput: QuoteOutput, instructions: Instruction[] }> {
     const pool = await this.getPool(poolAddress, config);

package/src/entities/pool.ts

@@ -16,10 +16,13 @@ import {
 import { generated } from "..";
 import {
   quote,
+  getPoolFeeRates,
+  type FeeRates,
   type QuoteOutput,
   type TransferFee,
 } from "../quote";
 import { isAccount } from "../utils/type_guards";
+import { assertInRange } from "../utils/assert";
 import { resolveAdminConfigAddress } from "./admin_config";
 import { processAssociatedTokenAccountPair } from "../utils/ata";
 import {
@@ -29,7 +32,9 @@ import {
 import { resolveTransferFee } from "../utils/transfer_fee";
 import {
   MAX_BIN_ARRAYS_PER_SWAP,
+  MIN_BIN_ARRAYS_PER_SWAP,
   MAX_BIN_ARRAYS_PER_SYNC,
+  MIN_BIN_ARRAYS_PER_SYNC,
 } from "../utils/constants";
 import {
   Position,
@@ -90,6 +95,10 @@ export class Pool {
     };
   }
 
+  public async getFeeRates(now: bigint = BigInt(Math.floor(Date.now() / 1000))): Promise<FeeRates> {
+    return await getPoolFeeRates(this.data, now);
+  }
+
   public async refresh(data: Account<generated.Pool>): Promise<void>;
   public async refresh(config?: FetchAccountConfig): Promise<void>;
   public async refresh(arg?: Account<generated.Pool> | FetchAccountConfig) {
@@ -156,13 +165,16 @@ export class Pool {
       xToY,
       amountIn,
       minAmountOut,
+      binArrayCount = MAX_BIN_ARRAYS_PER_SWAP,
     }: {
       xToY: boolean,
       amountIn: bigint,
       minAmountOut: bigint,
+      binArrayCount?: number,
     }
   ): Promise<Instruction[]> {
-    const indices = generateBinArrayIndicesForSwap(this.activeBinId, xToY, MAX_BIN_ARRAYS_PER_SWAP);
+    assertInRange(binArrayCount, MIN_BIN_ARRAYS_PER_SWAP, MAX_BIN_ARRAYS_PER_SWAP, "binArrayCount");
+    const indices = generateBinArrayIndicesForSwap(this.activeBinId, xToY, binArrayCount);
     const [binArrayAddresses, {
       ataX: tokenUserAccountX,
       ataY: tokenUserAccountY,
@@ -211,13 +223,16 @@ export class Pool {
       xToY,
       amountIn,
       slippageToleranceBps,
+      binArrayCount = MAX_BIN_ARRAYS_PER_SWAP,
     }: {
       xToY: boolean,
       amountIn: bigint,
       slippageToleranceBps: number,
+      binArrayCount?: number,
     }
   ): Promise<QuoteOutput> {
-    const indices = generateBinArrayIndicesForSwap(this.activeBinId, xToY, MAX_BIN_ARRAYS_PER_SWAP);
+    assertInRange(binArrayCount, MIN_BIN_ARRAYS_PER_SWAP, MAX_BIN_ARRAYS_PER_SWAP, "binArrayCount");
+    const indices = generateBinArrayIndicesForSwap(this.activeBinId, xToY, binArrayCount);
     const binArrayAddresses = await findAllBinArrayAddresses(
       { pool: this.address, indices },
       { programAddress: this.#programAddress },
@@ -247,22 +262,26 @@ export class Pool {
       xToY,
       amountIn,
       slippageToleranceBps,
+      binArrayCount = MAX_BIN_ARRAYS_PER_SWAP,
     }: {
       xToY: boolean,
       amountIn: bigint,
       slippageToleranceBps: number,
+      binArrayCount?: number,
     }
   ): Promise<{ quoteOutput: QuoteOutput, instructions: Instruction[] }> {
-    const quoteOutput = await this.quote({ xToY, amountIn, slippageToleranceBps });
-    const instructions = await this.swap(user, { xToY, amountIn, minAmountOut: quoteOutput.minAmountOut });
+    const quoteOutput = await this.quote({ xToY, amountIn, slippageToleranceBps, binArrayCount });
+    const instructions = await this.swap(user, { xToY, amountIn, minAmountOut: quoteOutput.minAmountOut, binArrayCount });
     return { quoteOutput, instructions };
   }
 
   public async sync(
     user: TransactionSigner,
     desiredBinId: number,
+    binArrayCount: number = MAX_BIN_ARRAYS_PER_SYNC,
   ): Promise<Instruction[]> {
-    const indices = generateBinArrayIndicesForSync(this.activeBinId, desiredBinId, MAX_BIN_ARRAYS_PER_SYNC);
+    assertInRange(binArrayCount, MIN_BIN_ARRAYS_PER_SYNC, MAX_BIN_ARRAYS_PER_SYNC, "binArrayCount");
+    const indices = generateBinArrayIndicesForSync(this.activeBinId, desiredBinId, binArrayCount);
     const binArrayAddresses = await findAllBinArrayAddresses(
       { pool: this.address, indices },
       { programAddress: this.#programAddress },

package/src/entities/position.ts

@@ -28,9 +28,15 @@ import {
   assertPositionBelongsToPool,
 } from "../utils/assert";
 import { isUndefined } from "../utils/type_guards";
-import { chunk, fetchInChunks } from "../utils/chunk";
+import { 
+  chunk,
+  fetchInChunks,
+} from "../utils/chunk";
 import { resolveAdminConfigAddress } from "./admin_config";
-import { MAX_ACCOUNTS_PER_RPC_BATCH, MAX_POSITIONS_PER_CLAIM } from "../utils/constants";
+import { 
+  MAX_POSITIONS_PER_CLAIM,
+  MAX_ACCOUNTS_PER_RPC_BATCH,
+} from "../utils/constants";
 
 import { Pool } from "./pool";
 import {

package/src/index.ts

@@ -4,5 +4,5 @@ export * as events from "./events";
 export * from "./entities";
 export * from "./utils/constants";
 export { NATIVE_MINT_ADDRESS } from "./utils/ata";
-export type { QuoteOutput, TransferFee } from "./quote";
+export type { QuoteOutput, TransferFee, FeeRates } from "./quote";
 export * from "./program_addresses";

package/src/quote/index.ts

@@ -4,9 +4,10 @@ import {
   type QuoteOutput,
   type PoolState,
   type TransferFee,
+  type FeeRates,
 } from "#wasm";
 
-export type { QuoteInput, QuoteOutput, PoolState, TransferFee };
+export type { QuoteInput, QuoteOutput, PoolState, TransferFee, FeeRates };
 
 export async function quote(input: QuoteInput): Promise<QuoteOutput> {
   const wasm = await loadWasm();
@@ -17,3 +18,11 @@ export async function applyTransferFee(amount: bigint, fee?: TransferFee): Promi
   const wasm = await loadWasm();
   return wasm.applyTransferFee(amount, fee);
 }
+
+// Decays the dynamic fee state to `now` first (the same "clock sim" the program does on-chain
+// right before pricing a real swap), so the returned rates reflect what a swap would actually
+// pay right now rather than the raw, potentially stale, stored volatility_accumulator.
+export async function getPoolFeeRates(poolState: PoolState, now: bigint): Promise<FeeRates> {
+  const wasm = await loadWasm();
+  return wasm.getPoolFeeRates(poolState, now);
+}

package/src/quote/wasm-node/picon_dlmm_quote.d.ts

@@ -27,6 +27,12 @@ export interface DynamicFeeState {
     lastUpdateTimestamp: bigint;
 }
 
+export interface FeeRates {
+    baseFeeRate: bigint;
+    dynamicFeeRate: bigint;
+    totalFeeRate: bigint;
+}
+
 export interface PoolState {
     binStep: number;
     feeRate: number;
@@ -67,4 +73,12 @@ export interface TransferFee {
  */
 export function applyTransferFee(amount: bigint, fee?: TransferFee | null): bigint;
 
+/**
+ * Base/dynamic/total fee rate `pool_state` would charge for a swap happening at `now` —
+ * decays the dynamic fee state to `now` first (the same "clock sim" `decay_dynamic_fee` does
+ * on-chain right before pricing a real swap), so this reflects what a swap would actually pay
+ * rather than the raw, potentially stale, stored `volatility_accumulator`.
+ */
+export function getPoolFeeRates(pool_state: PoolState, now: bigint): FeeRates;
+
 export function quote(input: QuoteInput): QuoteOutput;

package/src/quote/wasm-node/picon_dlmm_quote.js

@@ -17,6 +17,20 @@ export function applyTransferFee(amount, fee) {
     return BigInt.asUintN(64, ret[0]);
 }
 
+/**
+ * Base/dynamic/total fee rate `pool_state` would charge for a swap happening at `now` —
+ * decays the dynamic fee state to `now` first (the same "clock sim" `decay_dynamic_fee` does
+ * on-chain right before pricing a real swap), so this reflects what a swap would actually pay
+ * rather than the raw, potentially stale, stored `volatility_accumulator`.
+ * @param {PoolState} pool_state
+ * @param {bigint} now
+ * @returns {FeeRates}
+ */
+export function getPoolFeeRates(pool_state, now) {
+    const ret = wasm.getPoolFeeRates(pool_state, now);
+    return ret;
+}
+
 /**
  * @param {QuoteInput} input
  * @returns {QuoteOutput}

package/src/quote/wasm-node/picon_dlmm_quote_bg.wasm.d.ts

@@ -2,6 +2,7 @@
 /* eslint-disable */
 export const memory: WebAssembly.Memory;
 export const applyTransferFee: (a: bigint, b: number) => [bigint, number, number];
+export const getPoolFeeRates: (a: any, b: bigint) => any;
 export const quote: (a: any) => [number, number, number];
 export const __wbindgen_malloc: (a: number, b: number) => number;
 export const __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;

package/src/quote/wasm-web/picon_dlmm_quote.d.ts

@@ -27,6 +27,12 @@ export interface DynamicFeeState {
     lastUpdateTimestamp: bigint;
 }
 
+export interface FeeRates {
+    baseFeeRate: bigint;
+    dynamicFeeRate: bigint;
+    totalFeeRate: bigint;
+}
+
 export interface PoolState {
     binStep: number;
     feeRate: number;
@@ -67,6 +73,14 @@ export interface TransferFee {
  */
 export function applyTransferFee(amount: bigint, fee?: TransferFee | null): bigint;
 
+/**
+ * Base/dynamic/total fee rate `pool_state` would charge for a swap happening at `now` —
+ * decays the dynamic fee state to `now` first (the same "clock sim" `decay_dynamic_fee` does
+ * on-chain right before pricing a real swap), so this reflects what a swap would actually pay
+ * rather than the raw, potentially stale, stored `volatility_accumulator`.
+ */
+export function getPoolFeeRates(pool_state: PoolState, now: bigint): FeeRates;
+
 export function quote(input: QuoteInput): QuoteOutput;
 
 export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembly.Module;
@@ -74,6 +88,7 @@ export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembl
 export interface InitOutput {
     readonly memory: WebAssembly.Memory;
     readonly applyTransferFee: (a: bigint, b: number) => [bigint, number, number];
+    readonly getPoolFeeRates: (a: any, b: bigint) => any;
     readonly quote: (a: any) => [number, number, number];
     readonly __wbindgen_malloc: (a: number, b: number) => number;
     readonly __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;

package/src/quote/wasm-web/picon_dlmm_quote.js

@@ -15,6 +15,20 @@ export function applyTransferFee(amount, fee) {
     return BigInt.asUintN(64, ret[0]);
 }
 
+/**
+ * Base/dynamic/total fee rate `pool_state` would charge for a swap happening at `now` —
+ * decays the dynamic fee state to `now` first (the same "clock sim" `decay_dynamic_fee` does
+ * on-chain right before pricing a real swap), so this reflects what a swap would actually pay
+ * rather than the raw, potentially stale, stored `volatility_accumulator`.
+ * @param {PoolState} pool_state
+ * @param {bigint} now
+ * @returns {FeeRates}
+ */
+export function getPoolFeeRates(pool_state, now) {
+    const ret = wasm.getPoolFeeRates(pool_state, now);
+    return ret;
+}
+
 /**
  * @param {QuoteInput} input
  * @returns {QuoteOutput}

package/src/quote/wasm-web/picon_dlmm_quote_bg.wasm.d.ts

@@ -2,6 +2,7 @@
 /* eslint-disable */
 export const memory: WebAssembly.Memory;
 export const applyTransferFee: (a: bigint, b: number) => [bigint, number, number];
+export const getPoolFeeRates: (a: any, b: bigint) => any;
 export const quote: (a: any) => [number, number, number];
 export const __wbindgen_malloc: (a: number, b: number) => number;
 export const __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;

package/src/utils/assert.ts

@@ -13,6 +13,12 @@ export function assertRangeWithinRange(
   }
 }
 
+export function assertInRange(value: number, min: number, max: number, label: string): void {
+  if (value < min || value > max) {
+    throw new RangeError(`${label} (${value}) must be between ${min} and ${max}`);
+  }
+}
+
 export function assertPositionBelongsToPool(
   position: { pool: Address },
   pool: { address: Address },

package/src/utils/constants.ts

@@ -41,5 +41,12 @@ export const DYNAMIC_FEE_DIVISOR = getIdlBigIntConstant("DYNAMIC_FEE_DIVISOR");
 
 export const MAX_POSITIONS_PER_CLAIM = 3;
 
+// Client-side floor, not a protocol constant: generateBinArrayIndicesForSwap/ForSync's index
+// math (utils/bin_location.ts) always excludes the pool's active bin array when the count is 1
+// — 2 is the smallest binArrayCount that's guaranteed to include it, which the on-chain program
+// requires (see Pool.swap/quote/sync in entities/pool.ts).
+export const MIN_BIN_ARRAYS_PER_SWAP = 2;
+export const MIN_BIN_ARRAYS_PER_SYNC = 2;
+
 // Solana RPC's own hard cap on addresses per getMultipleAccounts request.
 export const MAX_ACCOUNTS_PER_RPC_BATCH = 100;