@liquid-af/sdk 0.3.0 → 0.4.0

package/src/instructions/liquid-swap.ts

@@ -26,7 +26,7 @@ export interface BuildCreatePoolParams {
  * @returns Transaction instruction
  */
 export function buildCreatePool(
-	params: BuildCreatePoolParams
+	params: BuildCreatePoolParams,
 ): Promise<TransactionInstruction> {
 	const {
 		signer,
@@ -46,13 +46,13 @@ export function buildCreatePool(
 		baseMint,
 		signer,
 		false,
-		baseTokenProgram
+		baseTokenProgram,
 	);
 	const creatorQuote = getAssociatedTokenAddressSync(
 		quoteMint,
 		signer,
 		false,
-		quoteTokenProgram
+		quoteTokenProgram,
 	);
 
 	return program.methods
@@ -91,7 +91,7 @@ export interface BuildSwapBuyParams {
  * @returns Transaction instruction
  */
 export function buildSwapBuy(
-	params: BuildSwapBuyParams
+	params: BuildSwapBuyParams,
 ): Promise<TransactionInstruction> {
 	const {
 		payer,
@@ -113,13 +113,13 @@ export function buildSwapBuy(
 		baseMint,
 		payer,
 		false,
-		baseTokenProgram
+		baseTokenProgram,
 	);
 	const quoteTokenAccount = getAssociatedTokenAddressSync(
 		quoteMint,
 		payer,
 		false,
-		quoteTokenProgram
+		quoteTokenProgram,
 	);
 	return program.methods
 		.buy(maxAmountIn, amountOut)
@@ -163,7 +163,7 @@ export interface BuildSwapSellParams {
  * @returns Transaction instruction
  */
 export function buildSwapSell(
-	params: BuildSwapSellParams
+	params: BuildSwapSellParams,
 ): Promise<TransactionInstruction> {
 	const {
 		payer,
@@ -185,13 +185,13 @@ export function buildSwapSell(
 		baseMint,
 		payer,
 		false,
-		baseTokenProgram
+		baseTokenProgram,
 	);
 	const quoteTokenAccount = getAssociatedTokenAddressSync(
 		quoteMint,
 		payer,
 		false,
-		quoteTokenProgram
+		quoteTokenProgram,
 	);
 	return program.methods
 		.sell(amountIn, minimumAmountOut)
@@ -237,7 +237,7 @@ export interface BuildDepositParams {
  * @returns Transaction instruction
  */
 export function buildDeposit(
-	params: BuildDepositParams
+	params: BuildDepositParams,
 ): Promise<TransactionInstruction> {
 	const {
 		owner,
@@ -261,19 +261,19 @@ export function buildDeposit(
 		lpMint,
 		owner,
 		false,
-		TOKEN_PROGRAM_ID
+		TOKEN_PROGRAM_ID,
 	);
 	const baseAccount = getAssociatedTokenAddressSync(
 		baseMint,
 		owner,
 		false,
-		baseTokenProgram
+		baseTokenProgram,
 	);
 	const quoteAccount = getAssociatedTokenAddressSync(
 		quoteMint,
 		owner,
 		false,
-		quoteTokenProgram
+		quoteTokenProgram,
 	);
 
 	return program.methods
@@ -316,7 +316,7 @@ export interface BuildWithdrawParams {
  * @returns Transaction instruction
  */
 export function buildWithdraw(
-	params: BuildWithdrawParams
+	params: BuildWithdrawParams,
 ): Promise<TransactionInstruction> {
 	const {
 		owner,
@@ -340,19 +340,19 @@ export function buildWithdraw(
 		lpMint,
 		owner,
 		false,
-		TOKEN_PROGRAM_ID
+		TOKEN_PROGRAM_ID,
 	);
 	const baseAccount = getAssociatedTokenAddressSync(
 		baseMint,
 		owner,
 		false,
-		baseTokenProgram
+		baseTokenProgram,
 	);
 	const quoteAccount = getAssociatedTokenAddressSync(
 		quoteMint,
 		owner,
 		false,
-		quoteTokenProgram
+		quoteTokenProgram,
 	);
 
 	return program.methods
@@ -389,7 +389,7 @@ export interface BuildSwapExecuteBuybackParams {
  * @returns Transaction instruction
  */
 export function buildSwapExecuteBuyback(
-	params: BuildSwapExecuteBuybackParams
+	params: BuildSwapExecuteBuybackParams,
 ): Promise<TransactionInstruction> {
 	const {
 		payer,

package/src/instructions/liquid.ts

@@ -54,14 +54,14 @@ export interface BuildCreateNativeCurveParams {
  * @returns Transaction instruction
  */
 export function buildCreateNativeCurve(
-	params: BuildCreateNativeCurveParams
+	params: BuildCreateNativeCurveParams,
 ): Promise<TransactionInstruction> {
 	const { creator, mint, pythPriceFeed, name, symbol, uri, config } = params;
 	const program = getCachedLiquidProgram(config);
 
 	const bondingCurveTokenAccount = getBondingCurveTokenAccount(
 		mint,
-		config.liquidProgramId
+		config.liquidProgramId,
 	);
 	return program.methods
 		.createNativeCurve({
@@ -93,7 +93,7 @@ export interface BuildBumpNativeParams {
  * @returns Transaction instruction
  */
 export function buildBumpNative(
-	params: BuildBumpNativeParams
+	params: BuildBumpNativeParams,
 ): Promise<TransactionInstruction> {
 	const { mint, pythPriceFeed, config } = params;
 	const program = getCachedLiquidProgram(config);
@@ -128,7 +128,7 @@ export interface BuildBuyNativeParams {
  * @returns Transaction instruction
  */
 export function buildBuyNative(
-	params: BuildBuyNativeParams
+	params: BuildBuyNativeParams,
 ): Promise<TransactionInstruction> {
 	const {
 		user,
@@ -148,7 +148,7 @@ export function buildBuyNative(
 	// Derive creator-related accounts that Anchor can't auto-resolve
 	const [creatorUserProperties] = getUserPropertiesPDA(
 		creator,
-		config.liquidStateProgramId
+		config.liquidStateProgramId,
 	);
 
 	return program.methods
@@ -179,12 +179,12 @@ export function buildBuyNative(
  */
 export async function buildBuyNativeAutoResolve(
 	connection: Connection,
-	params: Omit<BuildBuyNativeParams, "creator">
+	params: Omit<BuildBuyNativeParams, "creator">,
 ): Promise<TransactionInstruction> {
 	const curve = await fetchNativeBondingCurve(
 		connection,
 		params.mint,
-		params.config
+		params.config,
 	);
 	return buildBuyNative({
 		...params,
@@ -214,7 +214,7 @@ export interface BuildSellNativeParams {
  * @returns Transaction instruction
  */
 export function buildSellNative(
-	params: BuildSellNativeParams
+	params: BuildSellNativeParams,
 ): Promise<TransactionInstruction> {
 	const {
 		user,
@@ -234,7 +234,7 @@ export function buildSellNative(
 	// Derive creator-related accounts that Anchor can't auto-resolve
 	const [creatorUserProperties] = getUserPropertiesPDA(
 		creator,
-		config.liquidStateProgramId
+		config.liquidStateProgramId,
 	);
 
 	return program.methods
@@ -265,12 +265,12 @@ export function buildSellNative(
  */
 export async function buildSellNativeAutoResolve(
 	connection: Connection,
-	params: Omit<BuildSellNativeParams, "creator">
+	params: Omit<BuildSellNativeParams, "creator">,
 ): Promise<TransactionInstruction> {
 	const curve = await fetchNativeBondingCurve(
 		connection,
 		params.mint,
-		params.config
+		params.config,
 	);
 	return buildSellNative({
 		...params,
@@ -293,7 +293,7 @@ export interface BuildMigrateNativeParams {
  * @returns Transaction instruction
  */
 export function buildMigrateNative(
-	params: BuildMigrateNativeParams
+	params: BuildMigrateNativeParams,
 ): Promise<TransactionInstruction> {
 	const { migrator, mint, config } = params;
 	const program = getCachedLiquidProgram(config);
@@ -303,28 +303,28 @@ export function buildMigrateNative(
 	const [ammPoolState] = getPoolPDA(
 		mint,
 		WSOL_MINT,
-		config.liquidSwapProgramId
+		config.liquidSwapProgramId,
 	);
 	const [ammLpMint] = getPoolLpMintPDA(
 		ammPoolState,
-		config.liquidSwapProgramId
+		config.liquidSwapProgramId,
 	);
 	const [ammBaseVault] = getPoolVaultPDA(
 		ammPoolState,
 		mint,
-		config.liquidSwapProgramId
+		config.liquidSwapProgramId,
 	);
 	const [ammQuoteVault] = getPoolVaultPDA(
 		ammPoolState,
 		WSOL_MINT,
-		config.liquidSwapProgramId
+		config.liquidSwapProgramId,
 	);
 	const [ammObservationState] = getObservationPDA(
 		ammPoolState,
-		config.liquidSwapProgramId
+		config.liquidSwapProgramId,
 	);
 	const [ammGlobalConfig] = getSwapGlobalConfigPDA(
-		config.liquidSwapProgramId
+		config.liquidSwapProgramId,
 	);
 	const [ammAuthority] = getSwapAuthorityPDA(config.liquidSwapProgramId);
 	const [tokenVolume] = getTokenVolumePDA(mint, config.liquidStateProgramId);
@@ -332,12 +332,12 @@ export function buildMigrateNative(
 		ammLpMint,
 		bondingCurve,
 		true,
-		TOKEN_PROGRAM_ID
+		TOKEN_PROGRAM_ID,
 	);
 	const [ammBuybackVault] = getSwapBuybackVaultPDA(
 		ammPoolState,
 		WSOL_MINT,
-		config.liquidSwapProgramId
+		config.liquidSwapProgramId,
 	);
 	return program.methods
 		.migrate()
@@ -370,7 +370,7 @@ export interface BuildInitializeNativeReferralVaultParams {
  * @returns Transaction instruction
  */
 export function buildInitializeNativeReferralVault(
-	params: BuildInitializeNativeReferralVaultParams
+	params: BuildInitializeNativeReferralVaultParams,
 ): Promise<TransactionInstruction> {
 	const { user, config } = params;
 	const program = getCachedLiquidProgram(config);
@@ -393,7 +393,7 @@ export interface BuildWithdrawReferralRewardsParams {
  * @returns Transaction instruction
  */
 export function buildWithdrawReferralRewards(
-	params: BuildWithdrawReferralRewardsParams
+	params: BuildWithdrawReferralRewardsParams,
 ): Promise<TransactionInstruction> {
 	const { user, config } = params;
 	const program = getCachedLiquidProgram(config);
@@ -419,7 +419,7 @@ export interface BuildExecuteBuybackNativeParams {
  * @returns Transaction instruction
  */
 export function buildExecuteBuybackNative(
-	params: BuildExecuteBuybackNativeParams
+	params: BuildExecuteBuybackNativeParams,
 ): Promise<TransactionInstruction> {
 	const { payer, mint, pythPriceFeed, config } = params;
 	const program = getCachedLiquidProgram(config);
@@ -449,7 +449,7 @@ export interface BuildExecuteBuybackTokenParams {
  * @returns Transaction instruction
  */
 export function buildExecuteBuybackToken(
-	params: BuildExecuteBuybackTokenParams
+	params: BuildExecuteBuybackTokenParams,
 ): Promise<TransactionInstruction> {
 	const { payer, mint, quoteMint, config } = params;
 	const program = getCachedLiquidProgram(config);
@@ -486,7 +486,7 @@ export interface BuildCreateStableCurveParams {
  * @returns Transaction instruction
  */
 export function buildCreateStableCurve(
-	params: BuildCreateStableCurveParams
+	params: BuildCreateStableCurveParams,
 ): Promise<TransactionInstruction> {
 	const { creator, mint, quoteMint, name, symbol, uri, config } = params;
 	const program = getCachedLiquidProgram(config);
@@ -526,7 +526,7 @@ export interface BuildBuyStableParams {
  * @returns Transaction instruction
  */
 export function buildBuyStable(
-	params: BuildBuyStableParams
+	params: BuildBuyStableParams,
 ): Promise<TransactionInstruction> {
 	const {
 		user,
@@ -548,13 +548,13 @@ export function buildBuyStable(
 		quoteMint,
 		feeRecipient,
 		true,
-		TOKEN_PROGRAM_ID
+		TOKEN_PROGRAM_ID,
 	);
 
 	// Derive creator-related accounts that Anchor can't auto-resolve
 	const [creatorUserProperties] = getUserPropertiesPDA(
 		creator,
-		config.liquidStateProgramId
+		config.liquidStateProgramId,
 	);
 
 	return program.methods
@@ -585,13 +585,12 @@ export function buildBuyStable(
  */
 export async function buildBuyStableAutoResolve(
 	connection: Connection,
-	params: Omit<BuildBuyStableParams, "creator">
+	params: Omit<BuildBuyStableParams, "creator">,
 ): Promise<TransactionInstruction> {
 	const curve = await fetchStableBondingCurve(
 		connection,
 		params.mint,
-		params.quoteMint,
-		params.config
+		params.config,
 	);
 	return buildBuyStable({ ...params, creator: curve.creator });
 }
@@ -617,7 +616,7 @@ export interface BuildSellStableParams {
  * @returns Transaction instruction
  */
 export function buildSellStable(
-	params: BuildSellStableParams
+	params: BuildSellStableParams,
 ): Promise<TransactionInstruction> {
 	const {
 		user,
@@ -639,13 +638,13 @@ export function buildSellStable(
 		quoteMint,
 		feeRecipient,
 		true,
-		TOKEN_PROGRAM_ID
+		TOKEN_PROGRAM_ID,
 	);
 
 	// Derive creator-related accounts that Anchor can't auto-resolve
 	const [creatorUserProperties] = getUserPropertiesPDA(
 		creator,
-		config.liquidStateProgramId
+		config.liquidStateProgramId,
 	);
 
 	return program.methods
@@ -676,13 +675,12 @@ export function buildSellStable(
  */
 export async function buildSellStableAutoResolve(
 	connection: Connection,
-	params: Omit<BuildSellStableParams, "creator">
+	params: Omit<BuildSellStableParams, "creator">,
 ): Promise<TransactionInstruction> {
 	const curve = await fetchStableBondingCurve(
 		connection,
 		params.mint,
-		params.quoteMint,
-		params.config
+		params.config,
 	);
 	return buildSellStable({ ...params, creator: curve.creator });
 }
@@ -702,7 +700,7 @@ export interface BuildMigrateStableParams {
  * @returns Transaction instruction
  */
 export function buildMigrateStable(
-	params: BuildMigrateStableParams
+	params: BuildMigrateStableParams,
 ): Promise<TransactionInstruction> {
 	const { migrator, mint, quoteMint, config } = params;
 	const program = getCachedLiquidProgram(config);
@@ -710,34 +708,33 @@ export function buildMigrateStable(
 	// Derive AMM PDAs
 	const [bondingCurve] = getStableBondingCurvePDA(
 		mint,
-		quoteMint,
-		config.liquidProgramId
+		config.liquidProgramId,
 	);
 	const [ammPoolState] = getPoolPDA(
 		mint,
 		quoteMint,
-		config.liquidSwapProgramId
+		config.liquidSwapProgramId,
 	);
 	const [ammLpMint] = getPoolLpMintPDA(
 		ammPoolState,
-		config.liquidSwapProgramId
+		config.liquidSwapProgramId,
 	);
 	const [ammBaseVault] = getPoolVaultPDA(
 		ammPoolState,
 		mint,
-		config.liquidSwapProgramId
+		config.liquidSwapProgramId,
 	);
 	const [ammQuoteVault] = getPoolVaultPDA(
 		ammPoolState,
 		quoteMint,
-		config.liquidSwapProgramId
+		config.liquidSwapProgramId,
 	);
 	const [ammObservationState] = getObservationPDA(
 		ammPoolState,
-		config.liquidSwapProgramId
+		config.liquidSwapProgramId,
 	);
 	const [ammGlobalConfig] = getSwapGlobalConfigPDA(
-		config.liquidSwapProgramId
+		config.liquidSwapProgramId,
 	);
 	const [ammAuthority] = getSwapAuthorityPDA(config.liquidSwapProgramId);
 	const [tokenVolume] = getTokenVolumePDA(mint, config.liquidStateProgramId);
@@ -745,12 +742,12 @@ export function buildMigrateStable(
 		ammLpMint,
 		bondingCurve,
 		true,
-		TOKEN_PROGRAM_ID
+		TOKEN_PROGRAM_ID,
 	);
 	const [ammBuybackVault] = getSwapBuybackVaultPDA(
 		ammPoolState,
 		quoteMint,
-		config.liquidSwapProgramId
+		config.liquidSwapProgramId,
 	);
 	return program.methods
 		.migrateStable()
@@ -788,7 +785,7 @@ export interface BuildInitializeFeeRecipientVaultsParams {
  * @returns Transaction instruction
  */
 export function buildInitializeFeeRecipientVaults(
-	params: BuildInitializeFeeRecipientVaultsParams
+	params: BuildInitializeFeeRecipientVaultsParams,
 ): Promise<TransactionInstruction> {
 	const { payer, quoteMint, feeRecipients, config } = params;
 
@@ -831,7 +828,7 @@ export interface BuildInitializeReferralTokenVaultParams {
  * @returns Transaction instruction
  */
 export function buildInitializeReferralTokenVault(
-	params: BuildInitializeReferralTokenVaultParams
+	params: BuildInitializeReferralTokenVaultParams,
 ): Promise<TransactionInstruction> {
 	const { user, quoteMint, config } = params;
 	const program = getCachedLiquidProgram(config);

package/src/instructions/program-cache.ts

@@ -1,6 +1,7 @@
 import { Program } from "@coral-xyz/anchor";
 import type { LiquidConfig } from "../config.js";
 import { createStubProvider } from "../provider.js";
+import { patchIdl } from "../idl/patch-idl.js";
 
 import liquidIdl from "../idl/liquid.json" with { type: "json" };
 import liquidSwapIdl from "../idl/liquid_swap.json" with { type: "json" };
@@ -22,21 +23,25 @@ const cache = new Map<string, Program<any>>();
 
 /**
  * Returns a cached Program instance or creates one if it doesn't exist.
+ * Deep-patches the IDL to replace all embedded mainnet program addresses
+ * with the addresses from the provided config.
  *
  * @param key - Cache key prefix (e.g., "liquid", "swap")
  * @param idl - Raw IDL JSON object
  * @param address - Program address as a base58 string
+ * @param config - Liquid protocol configuration
  * @returns Cached or newly created Program instance
  */
 function getOrCreate<T extends Liquid | LiquidSwap | LiquidFees | LiquidState>(
 	key: string,
 	idl: Record<string, unknown>,
-	address: string
+	address: string,
+	config: LiquidConfig,
 ): Program<T> {
 	const cacheKey = `${key}:${address}`;
 	let prog = cache.get(cacheKey) as Program<T> | undefined;
 	if (!prog) {
-		const patchedIdl = { ...idl, address };
+		const patchedIdl = patchIdl({ ...idl, address }, config);
 		prog = new Program(patchedIdl as T, createStubProvider());
 		cache.set(cacheKey, prog);
 	}
@@ -53,7 +58,8 @@ export function getCachedLiquidProgram(config: LiquidConfig): Program<Liquid> {
 	return getOrCreate<Liquid>(
 		"liquid",
 		liquidIdl,
-		config.liquidProgramId.toBase58()
+		config.liquidProgramId.toBase58(),
+		config,
 	);
 }
 
@@ -64,12 +70,13 @@ export function getCachedLiquidProgram(config: LiquidConfig): Program<Liquid> {
  * @returns Cached Program instance typed as LiquidSwap
  */
 export function getCachedSwapProgram(
-	config: LiquidConfig
+	config: LiquidConfig,
 ): Program<LiquidSwap> {
 	return getOrCreate<LiquidSwap>(
 		"swap",
 		liquidSwapIdl,
-		config.liquidSwapProgramId.toBase58()
+		config.liquidSwapProgramId.toBase58(),
+		config,
 	);
 }
 
@@ -80,12 +87,13 @@ export function getCachedSwapProgram(
  * @returns Cached Program instance typed as LiquidFees
  */
 export function getCachedFeesProgram(
-	config: LiquidConfig
+	config: LiquidConfig,
 ): Program<LiquidFees> {
 	return getOrCreate<LiquidFees>(
 		"fees",
 		liquidFeesIdl,
-		config.liquidFeesProgramId.toBase58()
+		config.liquidFeesProgramId.toBase58(),
+		config,
 	);
 }
 
@@ -96,11 +104,12 @@ export function getCachedFeesProgram(
  * @returns Cached Program instance typed as LiquidState
  */
 export function getCachedStateProgram(
-	config: LiquidConfig
+	config: LiquidConfig,
 ): Program<LiquidState> {
 	return getOrCreate<LiquidState>(
 		"state",
 		liquidStateIdl,
-		config.liquidStateProgramId.toBase58()
+		config.liquidStateProgramId.toBase58(),
+		config,
 	);
 }

package/src/math/amm.ts

@@ -23,7 +23,7 @@ export const calculateAmmSellOutput = (
 	amountIn: BN,
 	baseVault: BN,
 	quoteVault: BN,
-	fees: AmmFeeRates
+	fees: AmmFeeRates,
 ): AmmSellOutput => {
 	// Gross output: (amountIn * quoteVault) / (baseVault + amountIn)
 	const grossQuoteOut = amountIn.mul(quoteVault).div(baseVault.add(amountIn));
@@ -64,7 +64,7 @@ export const calculateAmmBuyInput = (
 	amountOut: BN,
 	baseVault: BN,
 	quoteVault: BN,
-	fees: AmmFeeRates
+	fees: AmmFeeRates,
 ): AmmBuyInput => {
 	const denom = new BN(FEE_RATE_DENOMINATOR);
 
@@ -119,7 +119,7 @@ export const calculateLpToTokens = (
 	lpSupply: BN,
 	baseVault: BN,
 	quoteVault: BN,
-	roundUp: boolean = false
+	roundUp: boolean = false,
 ): LpTokenAmounts => {
 	let baseAmount: BN;
 	let quoteAmount: BN;

package/src/math/bonding-curve.ts

@@ -21,13 +21,13 @@ export const calculateBuyExpectation = (
 	curveState: { virtualQuoteReserves: BN; virtualTokenReserves: BN },
 	config: FeeConfig,
 	hasCreatorRef: boolean,
-	hasTraderRef: boolean
+	hasTraderRef: boolean,
 ): BondingCurveBuyResult => {
 	const fees = calculateFees(
 		amountInGross,
 		config,
 		hasCreatorRef,
-		hasTraderRef
+		hasTraderRef,
 	);
 
 	// Net quote amount that goes into the curve after fees
@@ -35,7 +35,7 @@ export const calculateBuyExpectation = (
 
 	// Constant product: k = x * y
 	const k = curveState.virtualQuoteReserves.mul(
-		curveState.virtualTokenReserves
+		curveState.virtualTokenReserves,
 	);
 
 	// New quote reserves after adding net amount
@@ -80,11 +80,11 @@ export const calculateSellExpectation = (
 	curveState: { virtualQuoteReserves: BN; virtualTokenReserves: BN },
 	config: FeeConfig,
 	hasCreatorRef: boolean,
-	hasTraderRef: boolean
+	hasTraderRef: boolean,
 ): BondingCurveSellResult => {
 	// Constant product: k = x * y
 	const k = curveState.virtualQuoteReserves.mul(
-		curveState.virtualTokenReserves
+		curveState.virtualTokenReserves,
 	);
 
 	// New token reserves after adding sold tokens
@@ -101,7 +101,7 @@ export const calculateSellExpectation = (
 		quoteOutGross,
 		config,
 		hasCreatorRef,
-		hasTraderRef
+		hasTraderRef,
 	);
 
 	// Net quote amount user receives