@liquid-af/sdk 0.2.0 → 0.3.1

package/src/idl/patch-idl.ts

@@ -0,0 +1,80 @@
+import { PublicKey } from "@solana/web3.js";
+import { MAINNET_CONFIG, type LiquidConfig } from "../config.js";
+
+interface ProgramReplacement {
+	mainnetAddress: string;
+	mainnetBytes: number[];
+	targetAddress: string;
+	targetBytes: number[];
+}
+
+function buildReplacementMap(config: LiquidConfig): ProgramReplacement[] {
+	const pairs: [PublicKey, PublicKey][] = [
+		[MAINNET_CONFIG.liquidProgramId, config.liquidProgramId],
+		[MAINNET_CONFIG.liquidSwapProgramId, config.liquidSwapProgramId],
+		[MAINNET_CONFIG.liquidFeesProgramId, config.liquidFeesProgramId],
+		[MAINNET_CONFIG.liquidStateProgramId, config.liquidStateProgramId],
+	];
+	return pairs
+		.filter(([mainnet, target]) => !mainnet.equals(target))
+		.map(([mainnet, target]) => ({
+			mainnetAddress: mainnet.toBase58(),
+			mainnetBytes: Array.from(mainnet.toBytes()),
+			targetAddress: target.toBase58(),
+			targetBytes: Array.from(target.toBytes()),
+		}));
+}
+
+function deepPatch(
+	node: unknown,
+	stringMap: Map<string, string>,
+	byteMap: Map<string, number[]>,
+): unknown {
+	if (node === null || node === undefined) return node;
+	if (typeof node !== "object") return node;
+
+	if (Array.isArray(node)) {
+		if (node.length === 32 && typeof node[0] === "number") {
+			const key = JSON.stringify(node);
+			const replacement = byteMap.get(key);
+			if (replacement) return replacement;
+		}
+		return node.map((item) => deepPatch(item, stringMap, byteMap));
+	}
+
+	const result: Record<string, unknown> = {};
+	for (const [key, value] of Object.entries(
+		node as Record<string, unknown>,
+	)) {
+		if (key === "address" && typeof value === "string") {
+			result[key] = stringMap.get(value) ?? value;
+		} else {
+			result[key] = deepPatch(value, stringMap, byteMap);
+		}
+	}
+	return result;
+}
+
+/**
+ * Deep-patches an Anchor IDL JSON object, replacing all embedded mainnet
+ * program addresses (both string and byte-array forms) with the addresses
+ * from the provided config.
+ *
+ * Returns the original IDL unchanged if config matches mainnet.
+ */
+export function patchIdl<T extends Record<string, unknown>>(
+	idl: T,
+	config: LiquidConfig,
+): T {
+	const replacements = buildReplacementMap(config);
+	if (replacements.length === 0) return idl;
+
+	const stringMap = new Map<string, string>();
+	const byteMap = new Map<string, number[]>();
+	for (const r of replacements) {
+		stringMap.set(r.mainnetAddress, r.targetAddress);
+		byteMap.set(JSON.stringify(r.mainnetBytes), r.targetBytes);
+	}
+
+	return deepPatch(idl, stringMap, byteMap) as T;
+}

package/src/index.ts

@@ -100,4 +100,5 @@ export {
 	liquidSwapIdl,
 	liquidFeesIdl,
 	liquidStateIdl,
+	patchIdl,
 } from "./idl/index.js";

package/src/instructions/liquid-fees.ts

@@ -27,7 +27,7 @@ export interface BuildUpdateFeeConfigParams {
  * @returns Transaction instruction
  */
 export function buildUpdateFeeConfig(
-	params: BuildUpdateFeeConfigParams
+	params: BuildUpdateFeeConfigParams,
 ): Promise<TransactionInstruction> {
 	const {
 		authority,
@@ -50,16 +50,16 @@ export function buildUpdateFeeConfig(
 	if (recipients && quoteMint) {
 		const [feeConfig] = getFeeConfigPDA(
 			tokenMint,
-			config.liquidFeesProgramId
+			config.liquidFeesProgramId,
 		);
 		const [feeVault] = getFeeVaultPDA(
 			feeConfig,
-			config.liquidFeesProgramId
+			config.liquidFeesProgramId,
 		);
 		tokenFeeVault = getAssociatedTokenAddressSync(
 			quoteMint,
 			feeVault,
-			true
+			true,
 		);
 	}
 
@@ -92,7 +92,7 @@ export interface BuildRevokeFeeConfigParams {
  * @returns Transaction instruction
  */
 export function buildRevokeFeeConfig(
-	params: BuildRevokeFeeConfigParams
+	params: BuildRevokeFeeConfigParams,
 ): Promise<TransactionInstruction> {
 	const { authority, tokenMint, quoteMint, config } = params;
 	const program = getCachedFeesProgram(config);
@@ -103,7 +103,7 @@ export function buildRevokeFeeConfig(
 	const tokenFeeVault = getAssociatedTokenAddressSync(
 		quoteMint,
 		feeVault,
-		true
+		true,
 	);
 
 	return program.methods
@@ -133,7 +133,7 @@ export interface BuildDistributeFeesParams {
  * @returns Transaction instruction
  */
 export function buildDistributeFees(
-	params: BuildDistributeFeesParams
+	params: BuildDistributeFeesParams,
 ): Promise<TransactionInstruction> {
 	const { payer, tokenMint, recipientVaults, config } = params;
 	const program = getCachedFeesProgram(config);
@@ -149,7 +149,7 @@ export function buildDistributeFees(
 				pubkey: vault,
 				isSigner: false,
 				isWritable: true,
-			}))
+			})),
 		)
 		.instruction();
 }
@@ -177,7 +177,7 @@ export interface BuildDistributeTokenFeesParams {
  * @returns Transaction instruction
  */
 export function buildDistributeTokenFees(
-	params: BuildDistributeTokenFeesParams
+	params: BuildDistributeTokenFeesParams,
 ): Promise<TransactionInstruction> {
 	const { payer, tokenMint, quoteMint, recipientVaultPairs, config } = params;
 	const program = getCachedFeesProgram(config);
@@ -213,7 +213,7 @@ export interface BuildClaimFeesParams {
  * @returns Transaction instruction
  */
 export function buildClaimFees(
-	params: BuildClaimFeesParams
+	params: BuildClaimFeesParams,
 ): Promise<TransactionInstruction> {
 	const { recipient, tokenMint, config } = params;
 	const program = getCachedFeesProgram(config);
@@ -244,7 +244,7 @@ export interface BuildClaimTokenFeesParams {
  * @returns Transaction instruction
  */
 export function buildClaimTokenFees(
-	params: BuildClaimTokenFeesParams
+	params: BuildClaimTokenFeesParams,
 ): Promise<TransactionInstruction> {
 	const { recipient, tokenMint, quoteMint, config } = params;
 	const program = getCachedFeesProgram(config);
@@ -273,19 +273,19 @@ export function deriveRecipientVaultPairs(
 	tokenMint: PublicKey,
 	recipients: PublicKey[],
 	quoteMint: PublicKey,
-	config: LiquidConfig
+	config: LiquidConfig,
 ): RecipientVaultPair[] {
 	const [feeConfig] = getFeeConfigPDA(tokenMint, config.liquidFeesProgramId);
 	return recipients.map((recipient) => {
 		const [vaultPda] = getRecipientVaultPDA(
 			feeConfig,
 			recipient,
-			config.liquidFeesProgramId
+			config.liquidFeesProgramId,
 		);
 		const vaultAta = getAssociatedTokenAddressSync(
 			quoteMint,
 			vaultPda,
-			true
+			true,
 		);
 		return { vaultPda, vaultAta };
 	});

package/src/instructions/liquid-state.ts

@@ -16,7 +16,7 @@ export interface BuildInitializeUserParams {
  * @returns Transaction instruction
  */
 export function buildInitializeUser(
-	params: BuildInitializeUserParams
+	params: BuildInitializeUserParams,
 ): Promise<TransactionInstruction> {
 	const { user, config } = params;
 	const program = getCachedStateProgram(config);
@@ -38,7 +38,7 @@ export interface BuildSetReferrerParams {
  * @returns Transaction instruction
  */
 export function buildSetReferrer(
-	params: BuildSetReferrerParams
+	params: BuildSetReferrerParams,
 ): Promise<TransactionInstruction> {
 	const { user, referrer, config } = params;
 	const program = getCachedStateProgram(config);
@@ -62,7 +62,7 @@ export interface BuildSetCashbackModeParams {
  * @returns Transaction instruction
  */
 export function buildSetCashbackMode(
-	params: BuildSetCashbackModeParams
+	params: BuildSetCashbackModeParams,
 ): Promise<TransactionInstruction> {
 	const { user, config } = params;
 	const program = getCachedStateProgram(config);
@@ -84,7 +84,7 @@ export interface BuildRedeemDealParams {
  * @returns Transaction instruction
  */
 export function buildRedeemDeal(
-	params: BuildRedeemDealParams
+	params: BuildRedeemDealParams,
 ): Promise<TransactionInstruction> {
 	const { user, dealOwner, config } = params;
 	const program = getCachedStateProgram(config);

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,