@liquid-af/sdk 0.6.0 → 0.7.0

package/src/idl/liquid_fees.ts

@@ -588,10 +588,20 @@ export type LiquidFees = {
               {
                 "kind": "account",
                 "path": "tokenMint"
+              },
+              {
+                "kind": "account",
+                "path": "quoteMint"
               }
             ]
           }
         },
+        {
+          "name": "quoteMint",
+          "docs": [
+            "The quote token mint for this fee configuration"
+          ]
+        },
         {
           "name": "systemProgram",
           "address": "11111111111111111111111111111111"
@@ -795,6 +805,10 @@ export type LiquidFees = {
               {
                 "kind": "account",
                 "path": "tokenMint"
+              },
+              {
+                "kind": "account",
+                "path": "quoteMint"
               }
             ]
           }
@@ -939,6 +953,10 @@ export type LiquidFees = {
               {
                 "kind": "account",
                 "path": "tokenMint"
+              },
+              {
+                "kind": "account",
+                "path": "quoteMint"
               }
             ]
           }
@@ -1146,12 +1164,54 @@ export type LiquidFees = {
               {
                 "kind": "account",
                 "path": "tokenMint"
+              },
+              {
+                "kind": "account",
+                "path": "quoteMint"
               }
             ]
           }
         },
         {
           "name": "tokenMint"
+        },
+        {
+          "name": "quoteMint"
+        },
+        {
+          "name": "cpiAuthority",
+          "docs": [
+            "CPI authority PDA for event emission."
+          ],
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  99,
+                  112,
+                  105,
+                  95,
+                  97,
+                  117,
+                  116,
+                  104,
+                  111,
+                  114,
+                  105,
+                  116,
+                  121
+                ]
+              }
+            ]
+          }
+        },
+        {
+          "name": "liquidEventsProgram",
+          "docs": [
+            "Liquid events program for centralized event emission."
+          ],
+          "address": "EventsQeXA43nLKR69DhHwNsJ6aM512AweMCgG3wG8zG"
         }
       ],
       "args": [
@@ -1217,6 +1277,10 @@ export type LiquidFees = {
               {
                 "kind": "account",
                 "path": "tokenMint"
+              },
+              {
+                "kind": "account",
+                "path": "quoteMint"
               }
             ]
           }
@@ -1227,6 +1291,12 @@ export type LiquidFees = {
             "The token mint this fee configuration is for"
           ]
         },
+        {
+          "name": "quoteMint",
+          "docs": [
+            "The quote token mint for this fee configuration"
+          ]
+        },
         {
           "name": "feeVault",
           "docs": [
@@ -1417,6 +1487,10 @@ export type LiquidFees = {
               {
                 "kind": "account",
                 "path": "tokenMint"
+              },
+              {
+                "kind": "account",
+                "path": "quoteMint"
               }
             ]
           }
@@ -1427,6 +1501,12 @@ export type LiquidFees = {
             "The token mint this fee configuration is for"
           ]
         },
+        {
+          "name": "quoteMint",
+          "docs": [
+            "The quote token mint for this fee configuration"
+          ]
+        },
         {
           "name": "feeVault",
           "docs": [
@@ -1462,6 +1542,41 @@ export type LiquidFees = {
             "Required when updating recipients to verify token fees have been drained."
           ],
           "optional": true
+        },
+        {
+          "name": "cpiAuthority",
+          "docs": [
+            "CPI authority PDA for event emission."
+          ],
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  99,
+                  112,
+                  105,
+                  95,
+                  97,
+                  117,
+                  116,
+                  104,
+                  111,
+                  114,
+                  105,
+                  116,
+                  121
+                ]
+              }
+            ]
+          }
+        },
+        {
+          "name": "liquidEventsProgram",
+          "docs": [
+            "Liquid events program for centralized event emission."
+          ],
+          "address": "EventsQeXA43nLKR69DhHwNsJ6aM512AweMCgG3wG8zG"
         }
       ],
       "args": [

package/src/idl/liquid_swap.json

@@ -559,6 +559,10 @@
               {
                 "kind": "account",
                 "path": "base_mint"
+              },
+              {
+                "kind": "account",
+                "path": "quote_mint"
               }
             ],
             "program": {
@@ -1541,6 +1545,10 @@
               {
                 "kind": "account",
                 "path": "base_mint"
+              },
+              {
+                "kind": "account",
+                "path": "quote_mint"
               }
             ],
             "program": {
@@ -2522,6 +2530,10 @@
               {
                 "kind": "account",
                 "path": "base_mint"
+              },
+              {
+                "kind": "account",
+                "path": "quote_mint"
               }
             ],
             "program": {
@@ -3330,6 +3342,10 @@
               {
                 "kind": "account",
                 "path": "base_mint"
+              },
+              {
+                "kind": "account",
+                "path": "quote_mint"
               }
             ],
             "program": {
@@ -4183,9 +4199,6 @@
       "accounts": [
         {
           "name": "payer",
-          "docs": [
-            "The user performing the swap."
-          ],
           "writable": true,
           "signer": true
         },
@@ -4336,7 +4349,7 @@
             "The protocol fee recipient. Must be one of the allowed recipients in Config.",
             "",
             "NOTE: Validation happens in handler by checking against global_config.fee_recipients.",
-            "Fee recipients are admin-controlled public keys stored in AmmConfig, so an attacker",
+            "Fee recipients are admin-controlled pubkeys stored in AmmConfig, so an attacker",
             "cannot pass an arbitrary account - it must match one of the configured recipients."
           ],
           "writable": true
@@ -4660,6 +4673,10 @@
               {
                 "kind": "account",
                 "path": "base_mint"
+              },
+              {
+                "kind": "account",
+                "path": "quote_mint"
               }
             ],
             "program": {
@@ -5082,16 +5099,10 @@
         },
         {
           "name": "system_program",
-          "docs": [
-            "System program needed for init_if_needed"
-          ],
           "address": "11111111111111111111111111111111"
         },
         {
           "name": "token_program",
-          "docs": [
-            "Token program for vault creation"
-          ],
           "address": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
         },
         {
@@ -5174,9 +5185,6 @@
       "accounts": [
         {
           "name": "payer",
-          "docs": [
-            "The user performing the swap."
-          ],
           "writable": true,
           "signer": true
         },
@@ -5327,7 +5335,7 @@
             "The protocol fee recipient. Must be one of the allowed recipients in Config.",
             "",
             "NOTE: Validation happens in handler by checking against global_config.fee_recipients.",
-            "Fee recipients are admin-controlled public keys stored in AmmConfig, so an attacker",
+            "Fee recipients are admin-controlled pubkeys stored in AmmConfig, so an attacker",
             "cannot pass an arbitrary account - it must match one of the configured recipients."
           ],
           "writable": true
@@ -5651,6 +5659,10 @@
               {
                 "kind": "account",
                 "path": "base_mint"
+              },
+              {
+                "kind": "account",
+                "path": "quote_mint"
               }
             ],
             "program": {
@@ -6073,16 +6085,10 @@
         },
         {
           "name": "system_program",
-          "docs": [
-            "System program needed for init_if_needed"
-          ],
           "address": "11111111111111111111111111111111"
         },
         {
           "name": "token_program",
-          "docs": [
-            "Token program for vault creation"
-          ],
           "address": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
         },
         {

package/src/idl/liquid_swap.ts

@@ -565,6 +565,10 @@ export type LiquidSwap = {
               {
                 "kind": "account",
                 "path": "baseMint"
+              },
+              {
+                "kind": "account",
+                "path": "quoteMint"
               }
             ],
             "program": {
@@ -1547,6 +1551,10 @@ export type LiquidSwap = {
               {
                 "kind": "account",
                 "path": "baseMint"
+              },
+              {
+                "kind": "account",
+                "path": "quoteMint"
               }
             ],
             "program": {
@@ -2528,6 +2536,10 @@ export type LiquidSwap = {
               {
                 "kind": "account",
                 "path": "baseMint"
+              },
+              {
+                "kind": "account",
+                "path": "quoteMint"
               }
             ],
             "program": {
@@ -3336,6 +3348,10 @@ export type LiquidSwap = {
               {
                 "kind": "account",
                 "path": "baseMint"
+              },
+              {
+                "kind": "account",
+                "path": "quoteMint"
               }
             ],
             "program": {
@@ -4189,9 +4205,6 @@ export type LiquidSwap = {
       "accounts": [
         {
           "name": "payer",
-          "docs": [
-            "The user performing the swap."
-          ],
           "writable": true,
           "signer": true
         },
@@ -4342,7 +4355,7 @@ export type LiquidSwap = {
             "The protocol fee recipient. Must be one of the allowed recipients in Config.",
             "",
             "NOTE: Validation happens in handler by checking against global_config.fee_recipients.",
-            "Fee recipients are admin-controlled public keys stored in AmmConfig, so an attacker",
+            "Fee recipients are admin-controlled pubkeys stored in AmmConfig, so an attacker",
             "cannot pass an arbitrary account - it must match one of the configured recipients."
           ],
           "writable": true
@@ -4666,6 +4679,10 @@ export type LiquidSwap = {
               {
                 "kind": "account",
                 "path": "baseMint"
+              },
+              {
+                "kind": "account",
+                "path": "quoteMint"
               }
             ],
             "program": {
@@ -5088,16 +5105,10 @@ export type LiquidSwap = {
         },
         {
           "name": "systemProgram",
-          "docs": [
-            "System program needed for init_if_needed"
-          ],
           "address": "11111111111111111111111111111111"
         },
         {
           "name": "tokenProgram",
-          "docs": [
-            "Token program for vault creation"
-          ],
           "address": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
         },
         {
@@ -5180,9 +5191,6 @@ export type LiquidSwap = {
       "accounts": [
         {
           "name": "payer",
-          "docs": [
-            "The user performing the swap."
-          ],
           "writable": true,
           "signer": true
         },
@@ -5333,7 +5341,7 @@ export type LiquidSwap = {
             "The protocol fee recipient. Must be one of the allowed recipients in Config.",
             "",
             "NOTE: Validation happens in handler by checking against global_config.fee_recipients.",
-            "Fee recipients are admin-controlled public keys stored in AmmConfig, so an attacker",
+            "Fee recipients are admin-controlled pubkeys stored in AmmConfig, so an attacker",
             "cannot pass an arbitrary account - it must match one of the configured recipients."
           ],
           "writable": true
@@ -5657,6 +5665,10 @@ export type LiquidSwap = {
               {
                 "kind": "account",
                 "path": "baseMint"
+              },
+              {
+                "kind": "account",
+                "path": "quoteMint"
               }
             ],
             "program": {
@@ -6079,16 +6091,10 @@ export type LiquidSwap = {
         },
         {
           "name": "systemProgram",
-          "docs": [
-            "System program needed for init_if_needed"
-          ],
           "address": "11111111111111111111111111111111"
         },
         {
           "name": "tokenProgram",
-          "docs": [
-            "Token program for vault creation"
-          ],
           "address": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
         },
         {

package/src/instructions/liquid-fees.ts

@@ -12,10 +12,10 @@ import {
 export interface BuildUpdateFeeConfigParams {
 	authority: PublicKey;
 	tokenMint: PublicKey;
+	/** Quote mint used for PDA derivation and token fee vault verification. */
+	quoteMint: PublicKey;
 	recipients?: FeeRecipient[] | null;
 	newUpdateAuthority?: PublicKey | null;
-	/** Required when changing recipients to verify token fee vault is drained. */
-	quoteMint?: PublicKey;
 	config: LiquidConfig;
 }
 
@@ -47,9 +47,10 @@ export function buildUpdateFeeConfig(
 
 	// When changing recipients, the token fee vault must be passed to verify it's drained
 	let tokenFeeVault: PublicKey | null = null;
-	if (recipients && quoteMint) {
+	if (recipients) {
 		const [feeConfig] = getFeeConfigPDA(
 			tokenMint,
+			quoteMint,
 			config.liquidFeesProgramId,
 		);
 		const [feeVault] = getFeeVaultPDA(
@@ -68,9 +69,10 @@ export function buildUpdateFeeConfig(
 			recipients: formattedRecipients,
 			newUpdateAuthority: newUpdateAuthority ?? null,
 		})
-		.accounts({
+		.accountsPartial({
 			authority,
 			tokenMint,
+			quoteMint,
 			tokenFeeVault,
 		})
 		.instruction();
@@ -98,7 +100,11 @@ export function buildRevokeFeeConfig(
 	const program = getCachedFeesProgram(config);
 
 	// Derive token fee vault ATA (fee_vault's ATA for quote_mint)
-	const [feeConfig] = getFeeConfigPDA(tokenMint, config.liquidFeesProgramId);
+	const [feeConfig] = getFeeConfigPDA(
+		tokenMint,
+		quoteMint,
+		config.liquidFeesProgramId,
+	);
 	const [feeVault] = getFeeVaultPDA(feeConfig, config.liquidFeesProgramId);
 	const tokenFeeVault = getAssociatedTokenAddressSync(
 		quoteMint,
@@ -111,6 +117,7 @@ export function buildRevokeFeeConfig(
 		.accounts({
 			authority,
 			tokenMint,
+			quoteMint,
 			tokenFeeVault,
 		})
 		.instruction();
@@ -119,6 +126,7 @@ export function buildRevokeFeeConfig(
 export interface BuildDistributeFeesParams {
 	payer: PublicKey;
 	tokenMint: PublicKey;
+	quoteMint: PublicKey;
 	recipientVaults: PublicKey[];
 	config: LiquidConfig;
 }
@@ -135,7 +143,7 @@ export interface BuildDistributeFeesParams {
 export function buildDistributeFees(
 	params: BuildDistributeFeesParams,
 ): Promise<TransactionInstruction> {
-	const { payer, tokenMint, recipientVaults, config } = params;
+	const { payer, tokenMint, quoteMint, recipientVaults, config } = params;
 	const program = getCachedFeesProgram(config);
 
 	return program.methods
@@ -143,6 +151,7 @@ export function buildDistributeFees(
 		.accounts({
 			payer,
 			tokenMint,
+			quoteMint,
 		})
 		.remainingAccounts(
 			recipientVaults.map((vault) => ({
@@ -202,6 +211,7 @@ export function buildDistributeTokenFees(
 export interface BuildClaimFeesParams {
 	recipient: PublicKey;
 	tokenMint: PublicKey;
+	quoteMint: PublicKey;
 	config: LiquidConfig;
 }
 
@@ -215,9 +225,13 @@ export interface BuildClaimFeesParams {
 export function buildClaimFees(
 	params: BuildClaimFeesParams,
 ): Promise<TransactionInstruction> {
-	const { recipient, tokenMint, config } = params;
+	const { recipient, tokenMint, quoteMint, config } = params;
 	const program = getCachedFeesProgram(config);
-	const [feeConfig] = getFeeConfigPDA(tokenMint, config.liquidFeesProgramId);
+	const [feeConfig] = getFeeConfigPDA(
+		tokenMint,
+		quoteMint,
+		config.liquidFeesProgramId,
+	);
 
 	return program.methods
 		.claimFees()
@@ -248,7 +262,11 @@ export function buildClaimTokenFees(
 ): Promise<TransactionInstruction> {
 	const { recipient, tokenMint, quoteMint, config } = params;
 	const program = getCachedFeesProgram(config);
-	const [feeConfig] = getFeeConfigPDA(tokenMint, config.liquidFeesProgramId);
+	const [feeConfig] = getFeeConfigPDA(
+		tokenMint,
+		quoteMint,
+		config.liquidFeesProgramId,
+	);
 
 	return program.methods
 		.claimTokenFees()
@@ -301,7 +319,11 @@ export function deriveRecipientVaultPairs(
 	quoteMint: PublicKey,
 	config: LiquidConfig,
 ): RecipientVaultPair[] {
-	const [feeConfig] = getFeeConfigPDA(tokenMint, config.liquidFeesProgramId);
+	const [feeConfig] = getFeeConfigPDA(
+		tokenMint,
+		quoteMint,
+		config.liquidFeesProgramId,
+	);
 	return recipients.map((recipient) => {
 		const [vaultPda] = getRecipientVaultPDA(
 			feeConfig,

package/src/pda/index.ts

@@ -97,7 +97,11 @@ export const getAllBondingCurvePDAs = (
 		bondingCurve,
 		config.liquidProgramId,
 	);
-	const [feeConfig] = getFeeConfigPDA(mint, config.liquidFeesProgramId);
+	const [feeConfig] = getFeeConfigPDA(
+		mint,
+		WSOL_MINT,
+		config.liquidFeesProgramId,
+	);
 	const [feeVault] = getFeeVaultPDA(feeConfig, config.liquidFeesProgramId);
 	const [userProperties] = getUserPropertiesPDA(
 		creator,
@@ -165,7 +169,11 @@ export const getAllPoolPDAs = (
 	);
 	const [ammConfig] = getSwapGlobalConfigPDA(config.liquidSwapProgramId);
 	const [ammAuthority] = getSwapAuthorityPDA(config.liquidSwapProgramId);
-	const [feeConfig] = getFeeConfigPDA(baseMint, config.liquidFeesProgramId);
+	const [feeConfig] = getFeeConfigPDA(
+		baseMint,
+		quoteMint,
+		config.liquidFeesProgramId,
+	);
 	const [tokenVolume] = getTokenVolumePDA(
 		baseMint,
 		config.liquidStateProgramId,

package/src/pda/liquid-fees.ts

@@ -6,18 +6,20 @@ const SEED_GLOBAL_CONFIG = Buffer.from("global_config");
 const SEED_RECIPIENT_VAULT = Buffer.from("recipient_vault");
 
 /**
- * Derives the fee config PDA for a token mint.
+ * Derives the fee config PDA for a token mint and quote mint pair.
  *
  * @param tokenMint - Token mint address
+ * @param quoteMint - Quote token mint address (e.g., WSOL for native, USDC for stable)
  * @param programId - Liquid Fees program ID
  * @returns Tuple of [PDA address, bump seed]
  */
 export const getFeeConfigPDA = (
 	tokenMint: PublicKey,
+	quoteMint: PublicKey,
 	programId: PublicKey,
 ): [PublicKey, number] => {
 	return PublicKey.findProgramAddressSync(
-		[SEED_FEE_CONFIG, tokenMint.toBuffer()],
+		[SEED_FEE_CONFIG, tokenMint.toBuffer(), quoteMint.toBuffer()],
 		programId,
 	);
 };