@liquid-af/sdk 0.11.0 → 0.11.2

package/src/idl/liquid_swap.ts

@@ -2100,12 +2100,12 @@ export type LiquidSwap = {
     {
       "name": "create",
       "docs": [
-        "Creates a pool for the given token pair and the initial price.",
+        "Creates an AMM pool for the given token pair with an initial deposit.",
         "",
         "# Arguments",
-        "* `init_amount_base` - the initial amount_0 to deposit",
-        "* `init_amount_quote` - the initial amount_1 to deposit",
-        "* `creator` - the creator of the pool"
+        "* `init_amount_base` - Initial base token amount to deposit into the pool.",
+        "* `init_amount_quote` - Initial quote token amount to deposit into the pool.",
+        "* `creator` - Optional creator pubkey (for program-initiated migration pools)."
       ],
       "discriminator": [
         24,
@@ -2832,12 +2832,12 @@ export type LiquidSwap = {
     {
       "name": "deposit",
       "docs": [
-        "Deposit lp token to the pool.",
+        "Deposits liquidity into the pool, minting LP tokens to the owner.",
         "",
         "# Arguments",
-        "* `lp_token_amount` - Increased number of LPs",
-        "* `maximum_base_token_amount` -  Maximum base token amount to deposit, prevents excessive slippage",
-        "* `maximum_quote_token_amount` - Maximum quote token amount to deposit, prevents excessive slippage"
+        "* `lp_token_amount` - Number of LP tokens to mint.",
+        "* `maximum_base_token_amount` - Maximum base tokens willing to deposit (slippage protection).",
+        "* `maximum_quote_token_amount` - Maximum quote tokens willing to deposit (slippage protection)."
       ],
       "discriminator": [
         242,
@@ -2853,12 +2853,15 @@ export type LiquidSwap = {
         {
           "name": "owner",
           "docs": [
-            "Pays to mint the position."
+            "The owner depositing liquidity into the pool."
           ],
           "signer": true
         },
         {
           "name": "poolState",
+          "docs": [
+            "Pool state account validated against base/quote vaults and LP mint."
+          ],
           "writable": true
         },
         {
@@ -4126,10 +4129,16 @@ export type LiquidSwap = {
       "accounts": [
         {
           "name": "admin",
+          "docs": [
+            "The admin authorized to pause the protocol."
+          ],
           "signer": true
         },
         {
           "name": "globalConfig",
+          "docs": [
+            "Global configuration account to be updated."
+          ],
           "writable": true,
           "pda": {
             "seeds": [
@@ -6349,10 +6358,16 @@ export type LiquidSwap = {
       "accounts": [
         {
           "name": "admin",
+          "docs": [
+            "The admin authorized to unpause the protocol."
+          ],
           "signer": true
         },
         {
           "name": "globalConfig",
+          "docs": [
+            "Global configuration account to be updated."
+          ],
           "writable": true,
           "pda": {
             "seeds": [
@@ -6506,12 +6521,12 @@ export type LiquidSwap = {
     {
       "name": "withdraw",
       "docs": [
-        "Withdraw lp for base token and quote token.",
+        "Withdraws liquidity from the pool, burning LP tokens and returning base and quote tokens.",
         "",
         "# Arguments",
-        "* `lp_token_amount` - Amount of pool tokens to burn. User receives an output of token a and b based on the percentage of the pool tokens that are returned.",
-        "* `minimum_base_amount` -  Minimum amount of base token to receive, prevents excessive slippage",
-        "* `minimum_quote_amount` -  Minimum amount of quote token to receive, prevents excessive slippage"
+        "* `lp_token_amount` - Number of LP tokens to burn.",
+        "* `minimum_base_amount` - Minimum base tokens expected to receive (slippage protection).",
+        "* `minimum_quote_amount` - Minimum quote tokens expected to receive (slippage protection)."
       ],
       "discriminator": [
         183,
@@ -6527,14 +6542,14 @@ export type LiquidSwap = {
         {
           "name": "owner",
           "docs": [
-            "Pays to mint the position."
+            "The owner withdrawing liquidity from the pool."
           ],
           "signer": true
         },
         {
           "name": "poolState",
           "docs": [
-            "Pool state account."
+            "Pool state account validated against base/quote vaults and LP mint."
           ],
           "writable": true
         },
@@ -7185,6 +7200,9 @@ export type LiquidSwap = {
     },
     {
       "name": "feeMode",
+      "docs": [
+        "The fee distribution mode for a token's fee configuration."
+      ],
       "repr": {
         "kind": "rust"
       },
@@ -7202,6 +7220,9 @@ export type LiquidSwap = {
     },
     {
       "name": "feeRecipient",
+      "docs": [
+        "A fee recipient with their allocation and vault PDA bump."
+      ],
       "repr": {
         "kind": "c"
       },
@@ -7210,18 +7231,30 @@ export type LiquidSwap = {
         "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"
           },
           {
             "name": "vaultBump",
+            "docs": [
+              "The bump seed for the recipient's vault PDA."
+            ],
             "type": "u8"
           },
           {
             "name": "padding",
+            "docs": [
+              "Padding to align to 8-byte boundary (32 + 2 + 1 + 5 = 40 bytes)."
+            ],
             "type": {
               "array": [
                 "u8",
@@ -7579,6 +7612,11 @@ export type LiquidSwap = {
     },
     {
       "name": "unifiedFeeConfiguration",
+      "docs": [
+        "Unified fee configuration for a token, supporting both Recipients and Revoked modes.",
+        "",
+        "Stored as a zero-copy account for efficient access in hot paths."
+      ],
       "serialization": "bytemuckunsafe",
       "repr": {
         "kind": "c",

package/src/instructions/index.ts

@@ -78,6 +78,7 @@ export {
 	buildInitializeGlobalConfig,
 	buildUpdateFeeConfig,
 	buildRevokeFeeConfig,
+	buildRevokeUpdateAuthority,
 	buildDistributeFees,
 	buildDistributeTokenFees,
 	buildClaimFees,
@@ -88,6 +89,7 @@ export type {
 	BuildInitializeGlobalConfigParams,
 	BuildUpdateFeeConfigParams,
 	BuildRevokeFeeConfigParams,
+	BuildRevokeUpdateAuthorityParams,
 	BuildDistributeFeesParams,
 	BuildDistributeTokenFeesParams,
 	BuildClaimFeesParams,

package/src/instructions/liquid-fees.ts

@@ -1,4 +1,4 @@
-import type { PublicKey, TransactionInstruction } from "@solana/web3.js";
+import { PublicKey, type TransactionInstruction } from "@solana/web3.js";
 import { getAssociatedTokenAddressSync } from "@solana/spl-token";
 import type { LiquidConfig } from "../config.js";
 import type { FeeRecipient } from "../types.js";
@@ -122,6 +122,29 @@ export function buildRevokeFeeConfig(
 		.instruction();
 }
 
+export interface BuildRevokeUpdateAuthorityParams {
+	authority: PublicKey;
+	tokenMint: PublicKey;
+	quoteMint: PublicKey;
+	config: LiquidConfig;
+}
+
+/**
+ * Builds an updateFeeConfig instruction that permanently revokes the update authority
+ * by setting it to the default public key (all zeros). Irreversible.
+ *
+ * @param params - {@link BuildRevokeUpdateAuthorityParams}
+ * @returns Transaction instruction
+ */
+export function buildRevokeUpdateAuthority(
+	params: BuildRevokeUpdateAuthorityParams,
+): Promise<TransactionInstruction> {
+	return buildUpdateFeeConfig({
+		...params,
+		newUpdateAuthority: PublicKey.default,
+	});
+}
+
 export interface BuildDistributeFeesParams {
 	payer: PublicKey;
 	tokenMint: PublicKey;

package/src/lut.ts

@@ -1,5 +1,4 @@
 import {
-	AddressLookupTableProgram,
 	ComputeBudgetProgram,
 	PublicKey,
 	SystemProgram,
@@ -122,35 +121,4 @@ export async function fetchLut(
 ): Promise<AddressLookupTableAccount | null> {
 	const result = await connection.getAddressLookupTable(lutAddress);
 	return result.value;
-}
-
-/**
- * Creates instructions to create and extend an Address Lookup Table.
- *
- * @param authority - The LUT authority (usually admin keypair)
- * @param payer - The rent payer
- * @param accounts - The accounts to add to the LUT
- * @param recentSlot - A recent slot for LUT derivation
- * @returns The LUT address and the create + extend instructions
- */
-export function buildCreateLutInstructions(
-	authority: PublicKey,
-	payer: PublicKey,
-	accounts: PublicKey[],
-	recentSlot: number,
-) {
-	const [createIx, lutAddress] = AddressLookupTableProgram.createLookupTable({
-		authority,
-		payer,
-		recentSlot,
-	});
-
-	const extendIx = AddressLookupTableProgram.extendLookupTable({
-		payer,
-		authority,
-		lookupTable: lutAddress,
-		addresses: accounts,
-	});
-
-	return { lutAddress, instructions: [createIx, extendIx] };
-}
+}