@liquid-af/sdk 0.11.1 → 0.11.2

package/dist/idl/liquid_swap.json

@@ -2094,12 +2094,12 @@
         {
             "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,
@@ -2826,12 +2826,12 @@
         {
             "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,
@@ -2847,12 +2847,15 @@
                 {
                     "name": "owner",
                     "docs": [
-                        "Pays to mint the position."
+                        "The owner depositing liquidity into the pool."
                     ],
                     "signer": true
                 },
                 {
                     "name": "pool_state",
+                    "docs": [
+                        "Pool state account validated against base/quote vaults and LP mint."
+                    ],
                     "writable": true
                 },
                 {
@@ -4120,10 +4123,16 @@
             "accounts": [
                 {
                     "name": "admin",
+                    "docs": [
+                        "The admin authorized to pause the protocol."
+                    ],
                     "signer": true
                 },
                 {
                     "name": "global_config",
+                    "docs": [
+                        "Global configuration account to be updated."
+                    ],
                     "writable": true,
                     "pda": {
                         "seeds": [
@@ -6343,10 +6352,16 @@
             "accounts": [
                 {
                     "name": "admin",
+                    "docs": [
+                        "The admin authorized to unpause the protocol."
+                    ],
                     "signer": true
                 },
                 {
                     "name": "global_config",
+                    "docs": [
+                        "Global configuration account to be updated."
+                    ],
                     "writable": true,
                     "pda": {
                         "seeds": [
@@ -6500,12 +6515,12 @@
         {
             "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,
@@ -6521,14 +6536,14 @@
                 {
                     "name": "owner",
                     "docs": [
-                        "Pays to mint the position."
+                        "The owner withdrawing liquidity from the pool."
                     ],
                     "signer": true
                 },
                 {
                     "name": "pool_state",
                     "docs": [
-                        "Pool state account."
+                        "Pool state account validated against base/quote vaults and LP mint."
                     ],
                     "writable": true
                 },
@@ -7179,6 +7194,9 @@
         },
         {
             "name": "FeeMode",
+            "docs": [
+                "The fee distribution mode for a token's fee configuration."
+            ],
             "repr": {
                 "kind": "rust"
             },
@@ -7196,6 +7214,9 @@
         },
         {
             "name": "FeeRecipient",
+            "docs": [
+                "A fee recipient with their allocation and vault PDA bump."
+            ],
             "repr": {
                 "kind": "c"
             },
@@ -7204,18 +7225,30 @@
                 "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"
                     },
                     {
                         "name": "vault_bump",
+                        "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",
@@ -7573,6 +7606,11 @@
         },
         {
             "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/dist/lut.d.ts

@@ -22,17 +22,4 @@ 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>;
-/**
- * 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 declare function buildCreateLutInstructions(authority: PublicKey, payer: PublicKey, accounts: PublicKey[], recentSlot: number): {
-    lutAddress: PublicKey;
-    instructions: import("@solana/web3.js").TransactionInstruction[];
-};
 //# 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,EAGN,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;AAED;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CACzC,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,SAAS,EAAE,EACrB,UAAU,EAAE,MAAM;;;EAgBlB"}
+{"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"}

package/dist/lut.js

@@ -1,4 +1,4 @@
-import { AddressLookupTableProgram, ComputeBudgetProgram, PublicKey, SystemProgram, } from "@solana/web3.js";
+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 { getSwapAuthorityPDA, getSwapGlobalConfigPDA, } from "./pda/liquid-swap.js";
@@ -80,27 +80,4 @@ export async function fetchLut(connection, lutAddress) {
     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, payer, accounts, recentSlot) {
-    const [createIx, lutAddress] = AddressLookupTableProgram.createLookupTable({
-        authority,
-        payer,
-        recentSlot,
-    });
-    const extendIx = AddressLookupTableProgram.extendLookupTable({
-        payer,
-        authority,
-        lookupTable: lutAddress,
-        addresses: accounts,
-    });
-    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":"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"}
+{"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.1",
+	"version": "0.11.2",
 	"description": "TypeScript SDK for the Liquid DeFi protocol on Solana",
 	"type": "module",
 	"publishConfig": {

package/src/idl/liquid.json

@@ -12521,7 +12521,7 @@
         "* `trader_referral_reward_basis_points` - Optional new value for trader referral reward",
         "* `protocol_fee_basis_points` - Optional new value for protocol fee basis points",
         "* `quote_mints` - Optional new list of valid quote mints",
-        "* `sol_usd_price_feed` - Optional new Pyth SOL/USD price feed account"
+        "* `sol_usd_price_feed` - Optional new Pyth SOL/USD price feed account."
       ],
       "discriminator": [
         219,
@@ -13379,6 +13379,9 @@
     },
     {
       "name": "FeeMode",
+      "docs": [
+        "The fee distribution mode for a token's fee configuration."
+      ],
       "repr": {
         "kind": "rust"
       },
@@ -13396,6 +13399,9 @@
     },
     {
       "name": "FeeRecipient",
+      "docs": [
+        "A fee recipient with their allocation and vault PDA bump."
+      ],
       "repr": {
         "kind": "c"
       },
@@ -13404,18 +13410,30 @@
         "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"
           },
           {
             "name": "vault_bump",
+            "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",
@@ -13834,6 +13852,11 @@
     },
     {
       "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/idl/liquid.ts

@@ -12527,7 +12527,7 @@ export type Liquid = {
         "* `trader_referral_reward_basis_points` - Optional new value for trader referral reward",
         "* `protocol_fee_basis_points` - Optional new value for protocol fee basis points",
         "* `quote_mints` - Optional new list of valid quote mints",
-        "* `sol_usd_price_feed` - Optional new Pyth SOL/USD price feed account"
+        "* `sol_usd_price_feed` - Optional new Pyth SOL/USD price feed account."
       ],
       "discriminator": [
         219,
@@ -13385,6 +13385,9 @@ export type Liquid = {
     },
     {
       "name": "feeMode",
+      "docs": [
+        "The fee distribution mode for a token's fee configuration."
+      ],
       "repr": {
         "kind": "rust"
       },
@@ -13402,6 +13405,9 @@ export type Liquid = {
     },
     {
       "name": "feeRecipient",
+      "docs": [
+        "A fee recipient with their allocation and vault PDA bump."
+      ],
       "repr": {
         "kind": "c"
       },
@@ -13410,18 +13416,30 @@ export type Liquid = {
         "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",
@@ -13840,6 +13858,11 @@ export type Liquid = {
     },
     {
       "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/idl/liquid_events.json

@@ -1085,6 +1085,9 @@
     },
     {
       "name": "BuyAmounts",
+      "docs": [
+        "Amounts for a buy trade (quote in, tokens out)."
+      ],
       "type": {
         "kind": "struct",
         "fields": [
@@ -2209,6 +2212,9 @@
     },
     {
       "name": "SellAmounts",
+      "docs": [
+        "Amounts for a sell trade (tokens in, quote out)."
+      ],
       "type": {
         "kind": "struct",
         "fields": [

package/src/idl/liquid_events.ts

@@ -1091,6 +1091,9 @@ export type LiquidEvents = {
     },
     {
       "name": "buyAmounts",
+      "docs": [
+        "Amounts for a buy trade (quote in, tokens out)."
+      ],
       "type": {
         "kind": "struct",
         "fields": [
@@ -2215,6 +2218,9 @@ export type LiquidEvents = {
     },
     {
       "name": "sellAmounts",
+      "docs": [
+        "Amounts for a sell trade (tokens in, quote out)."
+      ],
       "type": {
         "kind": "struct",
         "fields": [