@liquid-af/sdk 0.2.0 → 0.3.1

package/src/config.ts

@@ -17,32 +17,32 @@ export interface LiquidConfig {
 /** Mainnet program IDs */
 export const MAINNET_CONFIG: LiquidConfig = {
 	liquidProgramId: new PublicKey(
-		"LiquidsqH2a9gsPRf1M2QFhFqfLXWYTDZGzbsNQCDux"
+		"LiquidsqH2a9gsPRf1M2QFhFqfLXWYTDZGzbsNQCDux",
 	),
 	liquidSwapProgramId: new PublicKey(
-		"SwapMXcpJdXgnFG9BZak2fBZUiNeR2qYxzexF2ZxdW8"
+		"SwapMXcpJdXgnFG9BZak2fBZUiNeR2qYxzexF2ZxdW8",
 	),
 	liquidFeesProgramId: new PublicKey(
-		"FeesZQLb1xTeZbvaFRGnqzrZYzzmQtwhTYKQphbNGQru"
+		"FeesZQLb1xTeZbvaFRGnqzrZYzzmQtwhTYKQphbNGQru",
 	),
 	liquidStateProgramId: new PublicKey(
-		"State3HtEfi7cXdsTpAtRoBvrij8zSFCiGTAVWmYH2d"
+		"State3HtEfi7cXdsTpAtRoBvrij8zSFCiGTAVWmYH2d",
 	),
 } as const;
 
 /** Devnet program IDs (liquid differs, others same as mainnet) */
 export const DEVNET_CONFIG: LiquidConfig = {
 	liquidProgramId: new PublicKey(
-		"76sZav3FHaGLQmo2wHpyboeEk3Bc7wbL6bPibaSyhxnt"
+		"76sZav3FHaGLQmo2wHpyboeEk3Bc7wbL6bPibaSyhxnt",
 	),
 	liquidSwapProgramId: new PublicKey(
-		"DoBPPSQETr2xK5fKeTDR8wJ2Y4aTjtDbNwd9K72whhQB"
+		"DoBPPSQETr2xK5fKeTDR8wJ2Y4aTjtDbNwd9K72whhQB",
 	),
 	liquidFeesProgramId: new PublicKey(
-		"3iFrDQxt6ZQT5eTyoHSpdq9hpyj9QmXDjTNEopGYpvTh"
+		"3iFrDQxt6ZQT5eTyoHSpdq9hpyj9QmXDjTNEopGYpvTh",
 	),
 	liquidStateProgramId: new PublicKey(
-		"9ZcKPa3HAEVEKxwFX8fYD56ZJCKPEQgqjgr9rfUvtwKJ"
+		"9ZcKPa3HAEVEKxwFX8fYD56ZJCKPEQgqjgr9rfUvtwKJ",
 	),
 } as const;
 
@@ -51,12 +51,12 @@ export const LOCALNET_CONFIG: LiquidConfig = { ...MAINNET_CONFIG } as const;
 
 /** WSOL mint address */
 export const WSOL_MINT = new PublicKey(
-	"So11111111111111111111111111111111111111112"
+	"So11111111111111111111111111111111111111112",
 );
 
 /** Pyth Solana Receiver program ID (same across all networks and mock) */
 export const PYTH_RECEIVER_PROGRAM_ID = new PublicKey(
-	"rec5EKMGg6MxZYaMdyBfgwp4d5rB9T1VQH5pJv5LtFJ"
+	"rec5EKMGg6MxZYaMdyBfgwp4d5rB9T1VQH5pJv5LtFJ",
 );
 
 /** Basis points denominator (10,000 = 100%) */

package/src/errors.ts

@@ -30,7 +30,7 @@ export class LiquidError extends Error {
 	constructor(
 		readonly code: LiquidErrorCode,
 		message: string,
-		readonly cause?: unknown
+		readonly cause?: unknown,
 	) {
 		super(message);
 	}
@@ -58,7 +58,7 @@ export class LiquidError extends Error {
 				return new LiquidError(
 					LiquidErrorCode.AccountNotFound,
 					msg,
-					err
+					err,
 				);
 			}
 
@@ -66,7 +66,7 @@ export class LiquidError extends Error {
 				return new LiquidError(
 					LiquidErrorCode.TransactionTimeout,
 					msg,
-					err
+					err,
 				);
 			}
 
@@ -74,21 +74,21 @@ export class LiquidError extends Error {
 				return new LiquidError(
 					LiquidErrorCode.SimulationFailed,
 					msg,
-					err
+					err,
 				);
 			}
 
 			return new LiquidError(
 				LiquidErrorCode.TransactionBuildFailed,
 				msg,
-				err
+				err,
 			);
 		}
 
 		return new LiquidError(
 			LiquidErrorCode.TransactionBuildFailed,
 			String(err),
-			err
+			err,
 		);
 	}
 }

package/src/events/parser.ts

@@ -15,11 +15,11 @@ export interface ParsedEvent<T = unknown> {
  */
 export const parseTransactionEvents = (
 	logs: string[],
-	program: Program
+	program: Program,
 ): ParsedEvent[] => {
 	const parser = new EventParser(
 		program.programId,
-		new BorshCoder(program.idl)
+		new BorshCoder(program.idl),
 	);
 	const events: ParsedEvent[] = [];
 	const generator = parser.parseLogs(logs);
@@ -41,7 +41,7 @@ export const parseTransactionEvents = (
 export const addEventListener = <T>(
 	program: Program,
 	eventName: string,
-	callback: (event: T) => void
+	callback: (event: T) => void,
 ): number => {
 	return program.addEventListener(eventName, (data: T) => {
 		callback(data);
@@ -64,7 +64,7 @@ export async function waitForEvent<TEvent, TResult = string>(
 	program: Program<any>,
 	eventName: string,
 	trigger: () => Promise<TResult>,
-	timeoutMs = 5000
+	timeoutMs = 5000,
 ): Promise<{ result: TResult; event: TEvent }> {
 	let eventData: TEvent | null = null;
 	const listenerId = program.addEventListener(eventName, (data: TEvent) => {
@@ -79,7 +79,7 @@ export async function waitForEvent<TEvent, TResult = string>(
 		await program.removeEventListener(listenerId);
 		if (!eventData) {
 			throw new Error(
-				`Event '${eventName}' not received within ${timeoutMs}ms`
+				`Event '${eventName}' not received within ${timeoutMs}ms`,
 			);
 		}
 		return { result, event: eventData };

package/src/helpers/preview.ts

@@ -160,7 +160,7 @@ export interface SwapPrefetchedState {
 export function calculateBuyCurvePreview(
 	amountInQuote: BN,
 	state: CurvePreviewState,
-	options?: CurvePreviewOptions
+	options?: CurvePreviewOptions,
 ): BuyCurvePreview {
 	const { globalConfig, bondingCurve } = state;
 
@@ -176,7 +176,7 @@ export function calculateBuyCurvePreview(
 		bondingCurve,
 		feeConfig,
 		options?.hasCreatorRef ?? false,
-		options?.hasTraderRef ?? false
+		options?.hasTraderRef ?? false,
 	);
 
 	const priceBefore = bondingCurve.virtualQuoteReserves
@@ -222,7 +222,7 @@ export function calculateBuyCurvePreview(
 export function calculateSellCurvePreview(
 	amountInTokens: BN,
 	state: CurvePreviewState,
-	options?: CurvePreviewOptions
+	options?: CurvePreviewOptions,
 ): SellCurvePreview {
 	const { globalConfig, bondingCurve } = state;
 
@@ -238,7 +238,7 @@ export function calculateSellCurvePreview(
 		bondingCurve,
 		feeConfig,
 		options?.hasCreatorRef ?? false,
-		options?.hasTraderRef ?? false
+		options?.hasTraderRef ?? false,
 	);
 
 	const priceBefore = bondingCurve.virtualQuoteReserves
@@ -280,7 +280,7 @@ export function calculateSellCurvePreview(
  */
 export function calculateSwapBuyPreview(
 	amountOut: BN,
-	state: SwapPreviewState
+	state: SwapPreviewState,
 ): SwapPreview {
 	const { ammConfig, baseVaultBalance, quoteVaultBalance } = state;
 
@@ -292,7 +292,7 @@ export function calculateSwapBuyPreview(
 			lpFeeRate: ammConfig.lpFeeRate,
 			creatorFeeRate: ammConfig.creatorFeeRate,
 			protocolFeeRate: ammConfig.protocolFeeRate,
-		}
+		},
 	);
 
 	const priceBefore = quoteVaultBalance
@@ -331,7 +331,7 @@ export function calculateSwapBuyPreview(
  */
 export function calculateSwapSellPreview(
 	amountIn: BN,
-	state: SwapPreviewState
+	state: SwapPreviewState,
 ): SwapPreview {
 	const { ammConfig, baseVaultBalance, quoteVaultBalance } = state;
 
@@ -343,7 +343,7 @@ export function calculateSwapSellPreview(
 			lpFeeRate: ammConfig.lpFeeRate,
 			creatorFeeRate: ammConfig.creatorFeeRate,
 			protocolFeeRate: ammConfig.protocolFeeRate,
-		}
+		},
 	);
 
 	const priceBefore = quoteVaultBalance
@@ -383,7 +383,7 @@ export function calculateSwapSellPreview(
  */
 async function fetchCurveGlobalConfig(
 	connection: Connection,
-	config: LiquidConfig
+	config: LiquidConfig,
 ): Promise<
 	CurvePreviewState["globalConfig"] & { initialVirtualReserveUsd: BN }
 > {
@@ -414,7 +414,7 @@ async function resolveNativeCurve(
 	connection: Connection,
 	mint: PublicKey,
 	options: NativeCurveOptions,
-	config: LiquidConfig
+	config: LiquidConfig,
 ): Promise<CurvePreviewState> {
 	const pre = options.prefetched;
 
@@ -427,7 +427,7 @@ async function resolveNativeCurve(
 
 	const virtualSolReserves = calculateVirtualSolReserves(
 		BigInt(globalConfig.initialVirtualReserveUsd!.toString()),
-		BigInt(options.solPriceUsd.toString())
+		BigInt(options.solPriceUsd.toString()),
 	);
 
 	const bondingCurve = pre?.bondingCurve ?? {
@@ -456,7 +456,7 @@ async function resolveStableCurve(
 	connection: Connection,
 	mint: PublicKey,
 	options: StableCurveOptions,
-	config: LiquidConfig
+	config: LiquidConfig,
 ): Promise<CurvePreviewState> {
 	const pre = options.prefetched;
 
@@ -468,8 +468,8 @@ async function resolveStableCurve(
 					connection,
 					mint,
 					options.quoteMint,
-					config
-			  ),
+					config,
+				),
 	]);
 
 	const bondingCurve = pre?.bondingCurve ?? {
@@ -495,21 +495,21 @@ function resolveCurveState(
 	connection: Connection,
 	mint: PublicKey,
 	config: LiquidConfig,
-	options: CurveAsyncOptions
+	options: CurveAsyncOptions,
 ): Promise<CurvePreviewState> {
 	if (options.quoteMint) {
 		return resolveStableCurve(
 			connection,
 			mint,
 			options as StableCurveOptions,
-			config
+			config,
 		);
 	}
 	return resolveNativeCurve(
 		connection,
 		mint,
 		options as NativeCurveOptions,
-		config
+		config,
 	);
 }
 
@@ -548,7 +548,7 @@ export async function previewBuyOnCurve(
 	mint: PublicKey,
 	amountInQuote: BN,
 	config: LiquidConfig,
-	options: CurveAsyncOptions
+	options: CurveAsyncOptions,
 ): Promise<BuyCurvePreview> {
 	const state = await resolveCurveState(connection, mint, config, options);
 	return calculateBuyCurvePreview(amountInQuote, state, {
@@ -584,7 +584,7 @@ export async function previewSellOnCurve(
 	mint: PublicKey,
 	amountInTokens: BN,
 	config: LiquidConfig,
-	options: CurveAsyncOptions
+	options: CurveAsyncOptions,
 ): Promise<SellCurvePreview> {
 	const state = await resolveCurveState(connection, mint, config, options);
 	return calculateSellCurvePreview(amountInTokens, state, {
@@ -617,7 +617,7 @@ export async function previewSwapSell(
 	quoteMint: PublicKey,
 	amountIn: BN,
 	config: LiquidConfig,
-	options?: { prefetched?: SwapPrefetchedState; solPriceUsd?: BN }
+	options?: { prefetched?: SwapPrefetchedState; solPriceUsd?: BN },
 ): Promise<SwapPreview> {
 	const pre = options?.prefetched;
 
@@ -638,13 +638,13 @@ export async function previewSwapSell(
 				connection,
 				poolState.baseVault,
 				"confirmed",
-				poolState.baseTokenProgram
+				poolState.baseTokenProgram,
 			),
 			getAccount(
 				connection,
 				poolState.quoteVault,
 				"confirmed",
-				poolState.quoteTokenProgram
+				poolState.quoteTokenProgram,
 			),
 		]);
 		baseVaultBalance = new BN(baseVaultAccount.amount.toString());
@@ -668,7 +668,7 @@ export async function previewSwapSell(
 			connection,
 			poolState.baseMint,
 			"confirmed",
-			poolState.baseTokenProgram
+			poolState.baseTokenProgram,
 		);
 		const baseTotalSupply = new BN(baseMintAccount.supply.toString());
 
@@ -680,13 +680,13 @@ export async function previewSwapSell(
 				baseTotalSupply,
 				options.solPriceUsd,
 				poolState.quoteMint,
-				tiers
+				tiers,
 			);
 
 		feeRates = { lpFeeRate, protocolFeeRate, creatorFeeRate };
 	} else {
 		throw new Error(
-			"Either prefetched.feeRates or solPriceUsd must be provided for tiered fee calculations"
+			"Either prefetched.feeRates or solPriceUsd must be provided for tiered fee calculations",
 		);
 	}
 
@@ -721,7 +721,7 @@ export async function previewSwapBuy(
 	quoteMint: PublicKey,
 	amountOut: BN,
 	config: LiquidConfig,
-	options?: { prefetched?: SwapPrefetchedState; solPriceUsd?: BN }
+	options?: { prefetched?: SwapPrefetchedState; solPriceUsd?: BN },
 ): Promise<SwapPreview> {
 	const pre = options?.prefetched;
 
@@ -742,13 +742,13 @@ export async function previewSwapBuy(
 				connection,
 				poolState.baseVault,
 				"confirmed",
-				poolState.baseTokenProgram
+				poolState.baseTokenProgram,
 			),
 			getAccount(
 				connection,
 				poolState.quoteVault,
 				"confirmed",
-				poolState.quoteTokenProgram
+				poolState.quoteTokenProgram,
 			),
 		]);
 		baseVaultBalance = new BN(baseVaultAccount.amount.toString());
@@ -772,7 +772,7 @@ export async function previewSwapBuy(
 			connection,
 			poolState.baseMint,
 			"confirmed",
-			poolState.baseTokenProgram
+			poolState.baseTokenProgram,
 		);
 		const baseTotalSupply = new BN(baseMintAccount.supply.toString());
 
@@ -784,13 +784,13 @@ export async function previewSwapBuy(
 				baseTotalSupply,
 				options.solPriceUsd,
 				poolState.quoteMint,
-				tiers
+				tiers,
 			);
 
 		feeRates = { lpFeeRate, protocolFeeRate, creatorFeeRate };
 	} else {
 		throw new Error(
-			"Either prefetched.feeRates or solPriceUsd must be provided for tiered fee calculations"
+			"Either prefetched.feeRates or solPriceUsd must be provided for tiered fee calculations",
 		);
 	}
 

package/src/helpers/user.ts

@@ -11,7 +11,7 @@ import { TOKEN_PROGRAM_ID, TOKEN_2022_PROGRAM_ID } from "@solana/spl-token";
  */
 export const resolveTokenProgram = async (
 	connection: Connection,
-	mint: PublicKey
+	mint: PublicKey,
 ): Promise<PublicKey> => {
 	const account = await connection.getAccountInfo(mint);
 	if (!account) {

package/src/idl/index.ts

@@ -2,6 +2,7 @@ import { Program } from "@coral-xyz/anchor";
 import { Connection } from "@solana/web3.js";
 import type { LiquidConfig } from "../config.js";
 import { createReadonlyProvider } from "../provider.js";
+import { patchIdl } from "./patch-idl.js";
 
 import liquidIdl from "./liquid.json" with { type: "json" };
 import liquidSwapIdl from "./liquid_swap.json" with { type: "json" };
@@ -9,6 +10,7 @@ import liquidFeesIdl from "./liquid_fees.json" with { type: "json" };
 import liquidStateIdl from "./liquid_state.json" with { type: "json" };
 
 export { liquidIdl, liquidSwapIdl, liquidFeesIdl, liquidStateIdl };
+export { patchIdl } from "./patch-idl.js";
 
 // Re-export Anchor-generated IDL types
 export type { Liquid } from "./liquid.js";
@@ -31,10 +33,13 @@ import type { LiquidState } from "./liquid_state.js";
  */
 export function getLiquidProgram(
 	connection: Connection,
-	config?: LiquidConfig
+	config?: LiquidConfig,
 ): Program<Liquid> {
 	const idl = config
-		? { ...liquidIdl, address: config.liquidProgramId.toBase58() }
+		? patchIdl(
+				{ ...liquidIdl, address: config.liquidProgramId.toBase58() },
+				config,
+			)
 		: liquidIdl;
 	return new Program(idl as Liquid, createReadonlyProvider(connection));
 }
@@ -49,10 +54,16 @@ export function getLiquidProgram(
  */
 export function getLiquidSwapProgram(
 	connection: Connection,
-	config?: LiquidConfig
+	config?: LiquidConfig,
 ): Program<LiquidSwap> {
 	const idl = config
-		? { ...liquidSwapIdl, address: config.liquidSwapProgramId.toBase58() }
+		? patchIdl(
+				{
+					...liquidSwapIdl,
+					address: config.liquidSwapProgramId.toBase58(),
+				},
+				config,
+			)
 		: liquidSwapIdl;
 	return new Program(idl as LiquidSwap, createReadonlyProvider(connection));
 }
@@ -67,10 +78,16 @@ export function getLiquidSwapProgram(
  */
 export function getLiquidFeesProgram(
 	connection: Connection,
-	config?: LiquidConfig
+	config?: LiquidConfig,
 ): Program<LiquidFees> {
 	const idl = config
-		? { ...liquidFeesIdl, address: config.liquidFeesProgramId.toBase58() }
+		? patchIdl(
+				{
+					...liquidFeesIdl,
+					address: config.liquidFeesProgramId.toBase58(),
+				},
+				config,
+			)
 		: liquidFeesIdl;
 	return new Program(idl as LiquidFees, createReadonlyProvider(connection));
 }
@@ -85,10 +102,16 @@ export function getLiquidFeesProgram(
  */
 export function getLiquidStateProgram(
 	connection: Connection,
-	config?: LiquidConfig
+	config?: LiquidConfig,
 ): Program<LiquidState> {
 	const idl = config
-		? { ...liquidStateIdl, address: config.liquidStateProgramId.toBase58() }
+		? patchIdl(
+				{
+					...liquidStateIdl,
+					address: config.liquidStateProgramId.toBase58(),
+				},
+				config,
+			)
 		: liquidStateIdl;
 	return new Program(idl as LiquidState, createReadonlyProvider(connection));
 }