@liquid-af/sdk 0.11.7 → 0.11.9

package/dist/lut.d.ts

@@ -1,17 +1,18 @@
-import { PublicKey, type Connection, type AddressLookupTableAccount } from "@solana/web3.js";
+import { PublicKey, type Connection, type AddressLookupTableAccount, type TransactionInstruction } from "@solana/web3.js";
 import { type LiquidConfig } from "./config.js";
 /**
- * Returns the 21 account addresses for the global LUT.
+ * Returns the 26 account addresses for the global LUT.
  *
- * Programs (9): System, SPL Token, Token-2022, ATA, ComputeBudget, State, Events, Fees, Swap
+ * Programs (10): System, SPL Token, Token-2022, ATA, ComputeBudget, Liquid, State, Events, Fees, Swap
  * Liquid PDAs (2): global_config, cpi_authority
  * Swap PDAs (3): authority, global_config, cpi_authority
  * State PDAs (4): global_amm_volume, global_curve_volume, cashback_config, cpi_authority
- * Constants (2): WSOL mint, oracle price feed
+ * Fees PDAs (2): global_config, cpi_authority
+ * Constants (5): WSOL mint, oracle price feed, instructions sysvar, referrer cosigner, USDC mint
  *
  * @param config - Liquid protocol configuration
  * @param connection - Solana RPC connection (for fetching oracle price feed)
- * @returns Array of 21 public keys to populate the LUT
+ * @returns Array of 26 public keys to populate the LUT
  */
 export declare function getLutAccounts(config: LiquidConfig, connection: Connection): Promise<PublicKey[]>;
 /**
@@ -22,4 +23,69 @@ export declare function getLutAccounts(config: LiquidConfig, connection: Connect
  * @returns The AddressLookupTableAccount, or null if not found
  */
 export declare function fetchLut(connection: Connection, lutAddress: PublicKey): Promise<AddressLookupTableAccount | null>;
+export interface GetNativeTokenLutAccountsParams {
+    /** Token mint address */
+    mint: PublicKey;
+    /** Trading user's public key */
+    user: PublicKey;
+    /** Bonding curve creator's public key */
+    creator: PublicKey;
+    /** Protocol configuration */
+    config: LiquidConfig;
+}
+/**
+ * Returns the per-token + per-user addresses for a native (SOL) bonding curve LUT.
+ * These supplement the global LUT — no global accounts are included.
+ *
+ * Token PDAs (9): mint, bondingCurve, solVault, buybackVault, bondingCurveTokenAccount,
+ *   feeConfig, feeVault, feeVaultTokenAccount, tokenVolume
+ * User PDAs (3): userProperties, creatorUserProperties, userTokenAccount
+ */
+export declare function getNativeTokenLutAccounts(params: GetNativeTokenLutAccountsParams): PublicKey[];
+export interface GetStableTokenLutAccountsParams {
+    /** Token mint address */
+    mint: PublicKey;
+    /** Quote token mint address (e.g. USDC) */
+    quoteMint: PublicKey;
+    /** Trading user's public key */
+    user: PublicKey;
+    /** Bonding curve creator's public key */
+    creator: PublicKey;
+    /** Protocol configuration */
+    config: LiquidConfig;
+}
+/**
+ * Returns the per-token + per-user addresses for a stable (quote token) bonding curve LUT.
+ * These supplement the global LUT — no global accounts are included.
+ *
+ * Token PDAs (10): mint, quoteMint, bondingCurve, bondingCurveQuoteVault,
+ *   bondingCurveTokenAccount, buybackVault, feeConfig, feeVault, feeVaultTokenAccount, tokenVolume
+ * User PDAs (4): userProperties, creatorUserProperties, userTokenAccount, userQuoteAccount
+ */
+export declare function getStableTokenLutAccounts(params: GetStableTokenLutAccountsParams): PublicKey[];
+export interface BuildCreateTokenLutParams {
+    /** Solana RPC connection (to fetch a recent slot) */
+    connection: Connection;
+    /** Payer/authority public key for the LUT */
+    payer: PublicKey;
+    /** Addresses to populate the LUT with */
+    addresses: PublicKey[];
+}
+export interface CreateTokenLutResult {
+    /** The derived LUT address */
+    lutAddress: PublicKey;
+    /** Create + extend instructions to include in a transaction */
+    instructions: TransactionInstruction[];
+}
+/**
+ * Builds instructions to create an Address Lookup Table and populate it
+ * with the given addresses. Handles deduplication.
+ *
+ * The caller is responsible for including these instructions in a transaction,
+ * signing, and sending. The LUT must be active for at least 1 slot before
+ * it can be used in subsequent transactions.
+ *
+ * @returns The derived LUT address and the instructions to create + extend it
+ */
+export declare function buildCreateTokenLut(params: BuildCreateTokenLutParams): Promise<CreateTokenLutResult>;
 //# sourceMappingURL=lut.d.ts.map

package/dist/lut.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lut.d.ts","sourceRoot":"","sources":["../src/lut.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,SAAS,EAET,KAAK,UAAU,EACf,KAAK,yBAAyB,EAC9B,MAAM,iBAAiB,CAAC;AAMzB,OAAO,EAAE,KAAK,YAAY,EAAa,MAAM,aAAa,CAAC;AA0B3D;;;;;;;;;;;;GAYG;AACH,wBAAsB,cAAc,CACnC,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,UAAU,GACpB,OAAO,CAAC,SAAS,EAAE,CAAC,CAsDtB;AAED;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAC7B,UAAU,EAAE,UAAU,EACtB,UAAU,EAAE,SAAS,GACnB,OAAO,CAAC,yBAAyB,GAAG,IAAI,CAAC,CAG3C"}
+{"version":3,"file":"lut.d.ts","sourceRoot":"","sources":["../src/lut.ts"],"names":[],"mappings":"AAAA,OAAO,EAGN,SAAS,EAGT,KAAK,UAAU,EACf,KAAK,yBAAyB,EAC9B,KAAK,sBAAsB,EAC3B,MAAM,iBAAiB,CAAC;AAOzB,OAAO,EACN,KAAK,YAAY,EAGjB,MAAM,aAAa,CAAC;AAwCrB;;;;;;;;;;;;;GAaG;AACH,wBAAsB,cAAc,CACnC,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,UAAU,GACpB,OAAO,CAAC,SAAS,EAAE,CAAC,CAmEtB;AAED;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAC7B,UAAU,EAAE,UAAU,EACtB,UAAU,EAAE,SAAS,GACnB,OAAO,CAAC,yBAAyB,GAAG,IAAI,CAAC,CAG3C;AAED,MAAM,WAAW,+BAA+B;IAC/C,yBAAyB;IACzB,IAAI,EAAE,SAAS,CAAC;IAChB,gCAAgC;IAChC,IAAI,EAAE,SAAS,CAAC;IAChB,yCAAyC;IACzC,OAAO,EAAE,SAAS,CAAC;IACnB,6BAA6B;IAC7B,MAAM,EAAE,YAAY,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACxC,MAAM,EAAE,+BAA+B,GACrC,SAAS,EAAE,CA+Db;AAED,MAAM,WAAW,+BAA+B;IAC/C,yBAAyB;IACzB,IAAI,EAAE,SAAS,CAAC;IAChB,2CAA2C;IAC3C,SAAS,EAAE,SAAS,CAAC;IACrB,gCAAgC;IAChC,IAAI,EAAE,SAAS,CAAC;IAChB,yCAAyC;IACzC,OAAO,EAAE,SAAS,CAAC;IACnB,6BAA6B;IAC7B,MAAM,EAAE,YAAY,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACxC,MAAM,EAAE,+BAA+B,GACrC,SAAS,EAAE,CA6Eb;AAED,MAAM,WAAW,yBAAyB;IACzC,qDAAqD;IACrD,UAAU,EAAE,UAAU,CAAC;IACvB,6CAA6C;IAC7C,KAAK,EAAE,SAAS,CAAC;IACjB,yCAAyC;IACzC,SAAS,EAAE,SAAS,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,oBAAoB;IACpC,8BAA8B;IAC9B,UAAU,EAAE,SAAS,CAAC;IACtB,+DAA+D;IAC/D,YAAY,EAAE,sBAAsB,EAAE,CAAC;CACvC;AAED;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,CACxC,MAAM,EAAE,yBAAyB,GAC/B,OAAO,CAAC,oBAAoB,CAAC,CA8B/B"}

package/dist/lut.js

@@ -1,9 +1,10 @@
-import { ComputeBudgetProgram, PublicKey, SystemProgram, } from "@solana/web3.js";
-import { ASSOCIATED_TOKEN_PROGRAM_ID, TOKEN_2022_PROGRAM_ID, TOKEN_PROGRAM_ID, } from "@solana/spl-token";
-import { WSOL_MINT } from "./config.js";
+import { AddressLookupTableProgram, ComputeBudgetProgram, PublicKey, SYSVAR_INSTRUCTIONS_PUBKEY, SystemProgram, } from "@solana/web3.js";
+import { ASSOCIATED_TOKEN_PROGRAM_ID, TOKEN_2022_PROGRAM_ID, TOKEN_PROGRAM_ID, getAssociatedTokenAddressSync, } from "@solana/spl-token";
+import { REFERRER_COSIGNER, WSOL_MINT, } from "./config.js";
 import { getSwapAuthorityPDA, getSwapGlobalConfigPDA, } from "./pda/liquid-swap.js";
-import { getGlobalAmmVolumePDA, getGlobalCurveVolumePDA, getCashbackConfigPDA, } from "./pda/liquid-state.js";
-import { getLiquidGlobalConfigPDA } from "./pda/liquid.js";
+import { getGlobalAmmVolumePDA, getGlobalCurveVolumePDA, getCashbackConfigPDA, getUserPropertiesPDA, getTokenVolumePDA, } from "./pda/liquid-state.js";
+import { getLiquidGlobalConfigPDA, getBondingCurvePDA, getBondingCurveSolVaultPDA, getBuybackVaultPDA, getBondingCurveTokenAccount, getStableBondingCurvePDA, } from "./pda/liquid.js";
+import { getFeeConfigPDA, getFeeVaultPDA, getFeeGlobalConfigPDA } from "./pda/liquid-fees.js";
 import { fetchAmmConfig } from "./accounts/liquid-swap.js";
 const SEED_CPI_AUTHORITY = Buffer.from("cpi_authority");
 /**
@@ -14,17 +15,18 @@ function getCpiAuthorityPDA(programId) {
     return pda;
 }
 /**
- * Returns the 21 account addresses for the global LUT.
+ * Returns the 26 account addresses for the global LUT.
  *
- * Programs (9): System, SPL Token, Token-2022, ATA, ComputeBudget, State, Events, Fees, Swap
+ * Programs (10): System, SPL Token, Token-2022, ATA, ComputeBudget, Liquid, State, Events, Fees, Swap
  * Liquid PDAs (2): global_config, cpi_authority
  * Swap PDAs (3): authority, global_config, cpi_authority
  * State PDAs (4): global_amm_volume, global_curve_volume, cashback_config, cpi_authority
- * Constants (2): WSOL mint, oracle price feed
+ * Fees PDAs (2): global_config, cpi_authority
+ * Constants (5): WSOL mint, oracle price feed, instructions sysvar, referrer cosigner, USDC mint
  *
  * @param config - Liquid protocol configuration
  * @param connection - Solana RPC connection (for fetching oracle price feed)
- * @returns Array of 21 public keys to populate the LUT
+ * @returns Array of 26 public keys to populate the LUT
  */
 export async function getLutAccounts(config, connection) {
     const ammConfig = await fetchAmmConfig(connection, config);
@@ -41,6 +43,9 @@ export async function getLutAccounts(config, connection) {
     const [globalCurveVolume] = getGlobalCurveVolumePDA(config.liquidStateProgramId);
     const [cashbackConfig] = getCashbackConfigPDA(config.liquidStateProgramId);
     const stateCpiAuthority = getCpiAuthorityPDA(config.liquidStateProgramId);
+    // Fees PDAs
+    const [feeGlobalConfig] = getFeeGlobalConfigPDA(config.liquidFeesProgramId);
+    const feesCpiAuthority = getCpiAuthorityPDA(config.liquidFeesProgramId);
     return [
         // Programs
         SystemProgram.programId,
@@ -48,6 +53,7 @@ export async function getLutAccounts(config, connection) {
         TOKEN_2022_PROGRAM_ID,
         ASSOCIATED_TOKEN_PROGRAM_ID,
         ComputeBudgetProgram.programId,
+        config.liquidProgramId,
         config.liquidStateProgramId,
         config.liquidEventsProgramId,
         config.liquidFeesProgramId,
@@ -64,9 +70,15 @@ export async function getLutAccounts(config, connection) {
         globalCurveVolume,
         cashbackConfig,
         stateCpiAuthority,
+        // Fees global PDAs
+        feeGlobalConfig,
+        feesCpiAuthority,
         // Constants
         WSOL_MINT,
         oraclePriceFeed,
+        SYSVAR_INSTRUCTIONS_PUBKEY,
+        REFERRER_COSIGNER,
+        config.usdcMint,
     ];
 }
 /**
@@ -80,4 +92,122 @@ export async function fetchLut(connection, lutAddress) {
     const result = await connection.getAddressLookupTable(lutAddress);
     return result.value;
 }
+/**
+ * Returns the per-token + per-user addresses for a native (SOL) bonding curve LUT.
+ * These supplement the global LUT — no global accounts are included.
+ *
+ * Token PDAs (9): mint, bondingCurve, solVault, buybackVault, bondingCurveTokenAccount,
+ *   feeConfig, feeVault, feeVaultTokenAccount, tokenVolume
+ * User PDAs (3): userProperties, creatorUserProperties, userTokenAccount
+ */
+export function getNativeTokenLutAccounts(params) {
+    const { mint, user, creator, config } = params;
+    // Token PDAs
+    const [bondingCurve] = getBondingCurvePDA(mint, config.liquidProgramId);
+    const [solVault] = getBondingCurveSolVaultPDA(bondingCurve, config.liquidProgramId);
+    const [buybackVault] = getBuybackVaultPDA(bondingCurve, config.liquidProgramId);
+    const bondingCurveTokenAccount = getBondingCurveTokenAccount(mint, config.liquidProgramId);
+    const [feeConfig] = getFeeConfigPDA(mint, WSOL_MINT, config.liquidFeesProgramId);
+    const [feeVault] = getFeeVaultPDA(feeConfig, config.liquidFeesProgramId);
+    const feeVaultTokenAccount = getAssociatedTokenAddressSync(WSOL_MINT, feeVault, true, TOKEN_PROGRAM_ID);
+    const [tokenVolume] = getTokenVolumePDA(mint, config.liquidStateProgramId);
+    // User PDAs
+    const [userProperties] = getUserPropertiesPDA(user, config.liquidStateProgramId);
+    const [creatorUserProperties] = getUserPropertiesPDA(creator, config.liquidStateProgramId);
+    const userTokenAccount = getAssociatedTokenAddressSync(mint, user, true, TOKEN_2022_PROGRAM_ID);
+    return [
+        // Token PDAs
+        mint,
+        bondingCurve,
+        solVault,
+        buybackVault,
+        bondingCurveTokenAccount,
+        feeConfig,
+        feeVault,
+        feeVaultTokenAccount,
+        tokenVolume,
+        // User PDAs
+        userProperties,
+        creatorUserProperties,
+        userTokenAccount,
+    ];
+}
+/**
+ * Returns the per-token + per-user addresses for a stable (quote token) bonding curve LUT.
+ * These supplement the global LUT — no global accounts are included.
+ *
+ * Token PDAs (10): mint, quoteMint, bondingCurve, bondingCurveQuoteVault,
+ *   bondingCurveTokenAccount, buybackVault, feeConfig, feeVault, feeVaultTokenAccount, tokenVolume
+ * User PDAs (4): userProperties, creatorUserProperties, userTokenAccount, userQuoteAccount
+ */
+export function getStableTokenLutAccounts(params) {
+    const { mint, quoteMint, user, creator, config } = params;
+    // Token PDAs
+    const [bondingCurve] = getStableBondingCurvePDA(mint, config.liquidProgramId);
+    const bondingCurveQuoteVault = getAssociatedTokenAddressSync(quoteMint, bondingCurve, true, TOKEN_PROGRAM_ID);
+    const bondingCurveTokenAccount = getAssociatedTokenAddressSync(mint, bondingCurve, true, TOKEN_2022_PROGRAM_ID);
+    const [buybackVault] = getBuybackVaultPDA(bondingCurve, config.liquidProgramId);
+    const [feeConfig] = getFeeConfigPDA(mint, quoteMint, config.liquidFeesProgramId);
+    const [feeVault] = getFeeVaultPDA(feeConfig, config.liquidFeesProgramId);
+    const feeVaultTokenAccount = getAssociatedTokenAddressSync(quoteMint, feeVault, true, TOKEN_PROGRAM_ID);
+    const [tokenVolume] = getTokenVolumePDA(mint, config.liquidStateProgramId);
+    // User PDAs
+    const [userProperties] = getUserPropertiesPDA(user, config.liquidStateProgramId);
+    const [creatorUserProperties] = getUserPropertiesPDA(creator, config.liquidStateProgramId);
+    const userTokenAccount = getAssociatedTokenAddressSync(mint, user, true, TOKEN_2022_PROGRAM_ID);
+    const userQuoteAccount = getAssociatedTokenAddressSync(quoteMint, user, true, TOKEN_PROGRAM_ID);
+    return [
+        // Token PDAs
+        mint,
+        bondingCurve,
+        bondingCurveQuoteVault,
+        bondingCurveTokenAccount,
+        buybackVault,
+        feeConfig,
+        feeVault,
+        feeVaultTokenAccount,
+        tokenVolume,
+        // User PDAs
+        userProperties,
+        creatorUserProperties,
+        userTokenAccount,
+        userQuoteAccount,
+    ];
+}
+/**
+ * Builds instructions to create an Address Lookup Table and populate it
+ * with the given addresses. Handles deduplication.
+ *
+ * The caller is responsible for including these instructions in a transaction,
+ * signing, and sending. The LUT must be active for at least 1 slot before
+ * it can be used in subsequent transactions.
+ *
+ * @returns The derived LUT address and the instructions to create + extend it
+ */
+export async function buildCreateTokenLut(params) {
+    const { connection, payer, addresses } = params;
+    // Deduplicate addresses
+    const seen = new Set();
+    const unique = [];
+    for (const addr of addresses) {
+        const key = addr.toBase58();
+        if (!seen.has(key)) {
+            seen.add(key);
+            unique.push(addr);
+        }
+    }
+    const slot = await connection.getSlot();
+    const [createIx, lutAddress] = AddressLookupTableProgram.createLookupTable({
+        authority: payer,
+        payer,
+        recentSlot: slot,
+    });
+    const extendIx = AddressLookupTableProgram.extendLookupTable({
+        lookupTable: lutAddress,
+        authority: payer,
+        payer,
+        addresses: unique,
+    });
+    return { lutAddress, instructions: [createIx, extendIx] };
+}
 //# sourceMappingURL=lut.js.map

package/dist/lut.js.map

@@ -1 +1 @@
-{"version":3,"file":"lut.js","sourceRoot":"","sources":["../src/lut.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,oBAAoB,EACpB,SAAS,EACT,aAAa,GAGb,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACN,2BAA2B,EAC3B,qBAAqB,EACrB,gBAAgB,GAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAqB,SAAS,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EACN,mBAAmB,EACnB,sBAAsB,GACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACN,qBAAqB,EACrB,uBAAuB,EACvB,oBAAoB,GACpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D,MAAM,kBAAkB,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;AAExD;;GAEG;AACH,SAAS,kBAAkB,CAAC,SAAoB;IAC/C,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,sBAAsB,CAC7C,CAAC,kBAAkB,CAAC,EACpB,SAAS,CACT,CAAC;IACF,OAAO,GAAG,CAAC;AACZ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CACnC,MAAoB,EACpB,UAAsB;IAEtB,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAC3D,MAAM,eAAe,GAAG,SAAS,CAAC,eAA4B,CAAC;IAE/D,cAAc;IACd,MAAM,CAAC,kBAAkB,CAAC,GAAG,wBAAwB,CACpD,MAAM,CAAC,eAAe,CACtB,CAAC;IACF,MAAM,kBAAkB,GAAG,kBAAkB,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;IAEtE,YAAY;IACZ,MAAM,CAAC,aAAa,CAAC,GAAG,mBAAmB,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IACxE,MAAM,CAAC,gBAAgB,CAAC,GAAG,sBAAsB,CAChD,MAAM,CAAC,mBAAmB,CAC1B,CAAC;IACF,MAAM,gBAAgB,GAAG,kBAAkB,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAExE,aAAa;IACb,MAAM,CAAC,eAAe,CAAC,GAAG,qBAAqB,CAC9C,MAAM,CAAC,oBAAoB,CAC3B,CAAC;IACF,MAAM,CAAC,iBAAiB,CAAC,GAAG,uBAAuB,CAClD,MAAM,CAAC,oBAAoB,CAC3B,CAAC;IACF,MAAM,CAAC,cAAc,CAAC,GAAG,oBAAoB,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAC3E,MAAM,iBAAiB,GAAG,kBAAkB,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAE1E,OAAO;QACN,WAAW;QACX,aAAa,CAAC,SAAS;QACvB,gBAAgB;QAChB,qBAAqB;QACrB,2BAA2B;QAC3B,oBAAoB,CAAC,SAAS;QAC9B,MAAM,CAAC,oBAAoB;QAC3B,MAAM,CAAC,qBAAqB;QAC5B,MAAM,CAAC,mBAAmB;QAC1B,MAAM,CAAC,mBAAmB;QAC1B,qBAAqB;QACrB,kBAAkB;QAClB,kBAAkB;QAClB,mBAAmB;QACnB,aAAa;QACb,gBAAgB;QAChB,gBAAgB;QAChB,oBAAoB;QACpB,eAAe;QACf,iBAAiB;QACjB,cAAc;QACd,iBAAiB;QACjB,YAAY;QACZ,SAAS;QACT,eAAe;KACf,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC7B,UAAsB,EACtB,UAAqB;IAErB,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,qBAAqB,CAAC,UAAU,CAAC,CAAC;IAClE,OAAO,MAAM,CAAC,KAAK,CAAC;AACrB,CAAC"}
+{"version":3,"file":"lut.js","sourceRoot":"","sources":["../src/lut.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@liquid-af/sdk",
-	"version": "0.11.7",
+	"version": "0.11.9",
 	"description": "TypeScript SDK for the Liquid DeFi protocol on Solana",
 	"type": "module",
 	"publishConfig": {

package/src/client.ts

@@ -122,6 +122,14 @@ import {
 // Utility
 import { resolveTokenProgram as resolveTokenProgramFn } from "./helpers/user.js";
 
+// LUT helpers
+import {
+	getNativeTokenLutAccounts as getNativeTokenLutAccountsFn,
+	getStableTokenLutAccounts as getStableTokenLutAccountsFn,
+	type GetNativeTokenLutAccountsParams,
+	type GetStableTokenLutAccountsParams,
+} from "./lut.js";
+
 export interface LiquidClientConfig {
 	connection: Connection;
 	config?: LiquidConfig;
@@ -1148,6 +1156,20 @@ export class LiquidClient {
 		);
 	}
 
+	/** Returns per-token + per-user addresses for a native (SOL) bonding curve on-demand LUT. */
+	getNativeTokenLutAccounts(
+		params: Omit<GetNativeTokenLutAccountsParams, "config">,
+	): PublicKey[] {
+		return getNativeTokenLutAccountsFn({ ...params, config: this.config });
+	}
+
+	/** Returns per-token + per-user addresses for a stable (quote token) bonding curve on-demand LUT. */
+	getStableTokenLutAccounts(
+		params: Omit<GetStableTokenLutAccountsParams, "config">,
+	): PublicKey[] {
+		return getStableTokenLutAccountsFn({ ...params, config: this.config });
+	}
+
 	/**
 	 * Builds an unsigned Transaction from instructions, with optional compute
 	 * budget. Fetches a recent blockhash. Caller is responsible for signing.

package/src/config.ts

@@ -14,6 +14,8 @@ export interface LiquidConfig {
 	liquidStateProgramId: PublicKey;
 	/** Program ID for the events program */
 	liquidEventsProgramId: PublicKey;
+	/** USDC mint address (cluster-specific) */
+	usdcMint: PublicKey;
 	/** Address lookup table */
 	lut: PublicKey;
 }
@@ -35,7 +37,8 @@ export const MAINNET_CONFIG: LiquidConfig = {
 	liquidEventsProgramId: new PublicKey(
 		"EventsQeXA43nLKR69DhHwNsJ6aM512AweMCgG3wG8zG",
 	),
-	lut: new PublicKey("APVLYD9PAPM3TPa11LurrJgSchMShwTnzFsiH9o9Un6X"),
+	usdcMint: new PublicKey("EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"),
+	lut: new PublicKey("FUtGenyVu1wXbVWXtLGxYYe3vcosZ8ThZzPG6KCEiUqD"),
 } as const;
 
 /** Devnet program IDs (liquid differs, others same as mainnet) */
@@ -55,7 +58,8 @@ export const DEVNET_CONFIG: LiquidConfig = {
 	liquidEventsProgramId: new PublicKey(
 		"Bast7hBDiqSsxiwEmqazwvPvXC3N4z8UQR5ZmkqXnCiY",
 	),
-	lut: new PublicKey("74wpD6u2KdyVUs9cGM3Eu33FeMaLZ1pdoDrqn87V6EnM"),
+	usdcMint: new PublicKey("usdcbnypGfPKmn191M5DRNbRzPwvnbBgCEdKRsKG8XW"),
+	lut: new PublicKey("GwrLVF7ENm1mtdCvnhjsLmhFp2ux6Ymg5BjfDhLUuESD"),
 } as const;
 
 /** Localnet program IDs (same as mainnet per Anchor.toml) */

package/src/idl/liquid_fees.json

@@ -1621,6 +1621,11 @@
       "code": 6019,
       "name": "NotPendingAdmin",
       "msg": "Not the pending admin"
+    },
+    {
+      "code": 6020,
+      "name": "RecipientAccountsMismatch",
+      "msg": "Remaining accounts count must match recipient basis points count"
     }
   ],
   "types": [
@@ -1901,17 +1906,14 @@
         "kind": "struct",
         "fields": [
           {
-            "name": "recipients",
+            "name": "recipient_basis_points",
             "docs": [
-              "New recipients (optional, only valid for Recipients mode)."
+              "New recipient basis points (optional, only valid for Recipients mode).",
+              "Recipient pubkeys are passed via remaining accounts in matching order."
             ],
             "type": {
               "option": {
-                "vec": {
-                  "defined": {
-                    "name": "UpdateFeeRecipient"
-                  }
-                }
+                "vec": "u16"
               }
             }
           },
@@ -1926,31 +1928,6 @@
           }
         ]
       }
-    },
-    {
-      "name": "UpdateFeeRecipient",
-      "docs": [
-        "A fee recipient entry used when updating a fee configuration."
-      ],
-      "type": {
-        "kind": "struct",
-        "fields": [
-          {
-            "name": "pubkey",
-            "docs": [
-              "The public key of the fee recipient."
-            ],
-            "type": "pubkey"
-          },
-          {
-            "name": "basis_points",
-            "docs": [
-              "The recipient's share of fees in basis points (out of 10,000)."
-            ],
-            "type": "u16"
-          }
-        ]
-      }
     }
   ]
 }

package/src/idl/liquid_fees.ts

@@ -1627,6 +1627,11 @@ export type LiquidFees = {
       "code": 6019,
       "name": "notPendingAdmin",
       "msg": "Not the pending admin"
+    },
+    {
+      "code": 6020,
+      "name": "recipientAccountsMismatch",
+      "msg": "Remaining accounts count must match recipient basis points count"
     }
   ],
   "types": [
@@ -1907,17 +1912,14 @@ export type LiquidFees = {
         "kind": "struct",
         "fields": [
           {
-            "name": "recipients",
+            "name": "recipientBasisPoints",
             "docs": [
-              "New recipients (optional, only valid for Recipients mode)."
+              "New recipient basis points (optional, only valid for Recipients mode).",
+              "Recipient pubkeys are passed via remaining accounts in matching order."
             ],
             "type": {
               "option": {
-                "vec": {
-                  "defined": {
-                    "name": "updateFeeRecipient"
-                  }
-                }
+                "vec": "u16"
               }
             }
           },
@@ -1932,31 +1934,6 @@ export type LiquidFees = {
           }
         ]
       }
-    },
-    {
-      "name": "updateFeeRecipient",
-      "docs": [
-        "A fee recipient entry used when updating a fee configuration."
-      ],
-      "type": {
-        "kind": "struct",
-        "fields": [
-          {
-            "name": "pubkey",
-            "docs": [
-              "The public key of the fee recipient."
-            ],
-            "type": "pubkey"
-          },
-          {
-            "name": "basisPoints",
-            "docs": [
-              "The recipient's share of fees in basis points (out of 10,000)."
-            ],
-            "type": "u16"
-          }
-        ]
-      }
     }
   ]
 };

package/src/instructions/liquid-fees.ts

@@ -38,11 +38,7 @@ export function buildUpdateFeeConfig(
 	} = params;
 	const program = getCachedFeesProgram(config);
 
-	const formattedRecipients =
-		recipients?.map((r) => ({
-			pubkey: r.pubkey,
-			basisPoints: r.basisPoints,
-		})) ?? null;
+	const recipientBasisPoints = recipients?.map((r) => r.basisPoints) ?? null;
 
 	// When changing recipients, the token fee vault must be passed to verify it's drained
 	let tokenFeeVault: PublicKey | null = null;
@@ -63,9 +59,9 @@ export function buildUpdateFeeConfig(
 		);
 	}
 
-	return program.methods
+	const builder = program.methods
 		.updateFeeConfig({
-			recipients: formattedRecipients,
+			recipientBasisPoints,
 			newUpdateAuthority: newUpdateAuthority ?? null,
 		})
 		.accountsPartial({
@@ -73,8 +69,19 @@ export function buildUpdateFeeConfig(
 			tokenMint,
 			quoteMint,
 			tokenFeeVault,
-		})
-		.instruction();
+		});
+
+	if (recipients) {
+		builder.remainingAccounts(
+			recipients.map((r) => ({
+				pubkey: r.pubkey,
+				isSigner: false,
+				isWritable: false,
+			})),
+		);
+	}
+
+	return builder.instruction();
 }
 
 export interface BuildRevokeFeeConfigParams {