@liquid-af/sdk 0.10.2 → 0.10.3

package/src/idl/liquid.ts

@@ -220,7 +220,7 @@ export type Liquid = {
         {
           "name": "user",
           "docs": [
-            "The user buying tokens."
+            "The user executing the trade."
           ],
           "writable": true,
           "signer": true
@@ -371,14 +371,14 @@ export type Liquid = {
         {
           "name": "userTokenAccount",
           "docs": [
-            "User's token account to receive bought tokens."
+            "User's token account for the traded token."
           ],
           "writable": true
         },
         {
           "name": "feeVault",
           "docs": [
-            "The fee vault (for Direct/Recipients mode, from liquid-fees)."
+            "The fee vault (for Recipients mode, from liquid-fees)."
           ],
           "writable": true,
           "pda": {
@@ -521,7 +521,7 @@ export type Liquid = {
         {
           "name": "mint",
           "docs": [
-            "The mint of the token being bought."
+            "The mint of the traded token."
           ]
         },
         {
@@ -534,7 +534,7 @@ export type Liquid = {
         {
           "name": "feeConfig",
           "docs": [
-            "The fee configuration for this token."
+            "The fee configuration for this token (from liquid-fees program)."
           ],
           "pda": {
             "seeds": [
@@ -1146,7 +1146,7 @@ export type Liquid = {
         {
           "name": "user",
           "docs": [
-            "The user buying tokens."
+            "The user executing the trade."
           ],
           "writable": true,
           "signer": true
@@ -1313,21 +1313,21 @@ export type Liquid = {
         {
           "name": "userTokenAccount",
           "docs": [
-            "User's base token account to receive bought tokens."
+            "User's base token account for the traded token."
           ],
           "writable": true
         },
         {
           "name": "userQuoteAccount",
           "docs": [
-            "User's quote token account (e.g., USDC) to pay from."
+            "User's quote token account (e.g., USDC)."
           ],
           "writable": true
         },
         {
           "name": "feeVault",
           "docs": [
-            "The fee vault (for Direct/Recipients mode, from liquid-fees)."
+            "The fee vault (for Recipients mode, from liquid-fees)."
           ],
           "writable": true,
           "pda": {
@@ -1539,7 +1539,7 @@ export type Liquid = {
         {
           "name": "mint",
           "docs": [
-            "The base token mint being bought."
+            "The base token mint being traded."
           ]
         },
         {
@@ -2164,7 +2164,7 @@ export type Liquid = {
         {
           "name": "user",
           "docs": [
-            "The user buying tokens."
+            "The user executing the trade."
           ],
           "writable": true,
           "signer": true
@@ -2315,14 +2315,14 @@ export type Liquid = {
         {
           "name": "userTokenAccount",
           "docs": [
-            "User's token account to receive bought tokens."
+            "User's token account for the traded token."
           ],
           "writable": true
         },
         {
           "name": "feeVault",
           "docs": [
-            "The fee vault (for Direct/Recipients mode, from liquid-fees)."
+            "The fee vault (for Recipients mode, from liquid-fees)."
           ],
           "writable": true,
           "pda": {
@@ -2465,7 +2465,7 @@ export type Liquid = {
         {
           "name": "mint",
           "docs": [
-            "The mint of the token being bought."
+            "The mint of the traded token."
           ]
         },
         {
@@ -2478,7 +2478,7 @@ export type Liquid = {
         {
           "name": "feeConfig",
           "docs": [
-            "The fee configuration for this token."
+            "The fee configuration for this token (from liquid-fees program)."
           ],
           "pda": {
             "seeds": [
@@ -3090,7 +3090,7 @@ export type Liquid = {
         {
           "name": "user",
           "docs": [
-            "The user buying tokens."
+            "The user executing the trade."
           ],
           "writable": true,
           "signer": true
@@ -3257,21 +3257,21 @@ export type Liquid = {
         {
           "name": "userTokenAccount",
           "docs": [
-            "User's base token account to receive bought tokens."
+            "User's base token account for the traded token."
           ],
           "writable": true
         },
         {
           "name": "userQuoteAccount",
           "docs": [
-            "User's quote token account (e.g., USDC) to pay from."
+            "User's quote token account (e.g., USDC)."
           ],
           "writable": true
         },
         {
           "name": "feeVault",
           "docs": [
-            "The fee vault (for Direct/Recipients mode, from liquid-fees)."
+            "The fee vault (for Recipients mode, from liquid-fees)."
           ],
           "writable": true,
           "pda": {
@@ -3483,7 +3483,7 @@ export type Liquid = {
         {
           "name": "mint",
           "docs": [
-            "The base token mint being bought."
+            "The base token mint being traded."
           ]
         },
         {
@@ -8395,7 +8395,7 @@ export type Liquid = {
         {
           "name": "user",
           "docs": [
-            "The user selling tokens."
+            "The user executing the trade."
           ],
           "writable": true,
           "signer": true
@@ -8546,14 +8546,14 @@ export type Liquid = {
         {
           "name": "userTokenAccount",
           "docs": [
-            "User's token account to send sold tokens from."
+            "User's token account for the traded token."
           ],
           "writable": true
         },
         {
           "name": "feeVault",
           "docs": [
-            "The fee vault (for Direct/Recipients mode, from liquid-fees)."
+            "The fee vault (for Recipients mode, from liquid-fees)."
           ],
           "writable": true,
           "pda": {
@@ -8696,7 +8696,7 @@ export type Liquid = {
         {
           "name": "mint",
           "docs": [
-            "The mint of the token being sold."
+            "The mint of the traded token."
           ]
         },
         {
@@ -8779,7 +8779,7 @@ export type Liquid = {
         {
           "name": "creatorUserProperties",
           "docs": [
-            "Creator's user properties from liquid-state"
+            "Creator's user properties from liquid-state."
           ],
           "pda": {
             "seeds": [
@@ -9321,7 +9321,7 @@ export type Liquid = {
         {
           "name": "user",
           "docs": [
-            "The user selling tokens."
+            "The user executing the trade."
           ],
           "writable": true,
           "signer": true
@@ -9488,21 +9488,21 @@ export type Liquid = {
         {
           "name": "userTokenAccount",
           "docs": [
-            "User's base token account to send sold tokens from."
+            "User's base token account for the traded token."
           ],
           "writable": true
         },
         {
           "name": "userQuoteAccount",
           "docs": [
-            "User's quote token account (e.g., USDC) to receive payment."
+            "User's quote token account (e.g., USDC)."
           ],
           "writable": true
         },
         {
           "name": "feeVault",
           "docs": [
-            "The fee vault (for Direct/Recipients mode, from liquid-fees)."
+            "The fee vault (for Recipients mode, from liquid-fees)."
           ],
           "writable": true,
           "pda": {
@@ -9714,7 +9714,7 @@ export type Liquid = {
         {
           "name": "mint",
           "docs": [
-            "The base token mint being sold."
+            "The base token mint being traded."
           ]
         },
         {
@@ -10339,7 +10339,7 @@ export type Liquid = {
         {
           "name": "user",
           "docs": [
-            "The user selling tokens."
+            "The user executing the trade."
           ],
           "writable": true,
           "signer": true
@@ -10490,14 +10490,14 @@ export type Liquid = {
         {
           "name": "userTokenAccount",
           "docs": [
-            "User's token account to send sold tokens from."
+            "User's token account for the traded token."
           ],
           "writable": true
         },
         {
           "name": "feeVault",
           "docs": [
-            "The fee vault (for Direct/Recipients mode, from liquid-fees)."
+            "The fee vault (for Recipients mode, from liquid-fees)."
           ],
           "writable": true,
           "pda": {
@@ -10640,7 +10640,7 @@ export type Liquid = {
         {
           "name": "mint",
           "docs": [
-            "The mint of the token being sold."
+            "The mint of the traded token."
           ]
         },
         {
@@ -10723,7 +10723,7 @@ export type Liquid = {
         {
           "name": "creatorUserProperties",
           "docs": [
-            "Creator's user properties from liquid-state"
+            "Creator's user properties from liquid-state."
           ],
           "pda": {
             "seeds": [
@@ -11265,7 +11265,7 @@ export type Liquid = {
         {
           "name": "user",
           "docs": [
-            "The user selling tokens."
+            "The user executing the trade."
           ],
           "writable": true,
           "signer": true
@@ -11432,21 +11432,21 @@ export type Liquid = {
         {
           "name": "userTokenAccount",
           "docs": [
-            "User's base token account to send sold tokens from."
+            "User's base token account for the traded token."
           ],
           "writable": true
         },
         {
           "name": "userQuoteAccount",
           "docs": [
-            "User's quote token account (e.g., USDC) to receive payment."
+            "User's quote token account (e.g., USDC)."
           ],
           "writable": true
         },
         {
           "name": "feeVault",
           "docs": [
-            "The fee vault (for Direct/Recipients mode, from liquid-fees)."
+            "The fee vault (for Recipients mode, from liquid-fees)."
           ],
           "writable": true,
           "pda": {
@@ -11658,7 +11658,7 @@ export type Liquid = {
         {
           "name": "mint",
           "docs": [
-            "The base token mint being sold."
+            "The base token mint being traded."
           ]
         },
         {
@@ -13225,7 +13225,9 @@ export type Liquid = {
           {
             "name": "ranges",
             "docs": [
-              "Volume-based multiplier ranges (use len() for active count)"
+              "Balance-based multiplier ranges (use len() for active count).",
+              "Thresholds refer to the user's cashback credit balance. Multiplier is",
+              "applied progressively as credits are earned, not at mode-switch."
             ],
             "type": {
               "vec": {
@@ -13257,7 +13259,12 @@ export type Liquid = {
     {
       "name": "cashbackRange",
       "docs": [
-        "Cashback range defining volume-based multiplier tiers"
+        "Cashback range defining balance-based multiplier tiers.",
+        "",
+        "Each range maps a cashback balance interval to a multiplier. When a user earns",
+        "cashback, the earned amount is multiplied by the tier corresponding to their",
+        "current balance. If earning crosses a tier boundary, the amount is split so",
+        "each portion receives its respective tier's multiplier."
       ],
       "type": {
         "kind": "struct",
@@ -13265,14 +13272,14 @@ export type Liquid = {
           {
             "name": "rangeStartInclusive",
             "docs": [
-              "Lower bound of volume range (inclusive)"
+              "Lower bound of balance range (inclusive), in USD with 6 decimals"
             ],
             "type": "u64"
           },
           {
             "name": "rangeEndExclusive",
             "docs": [
-              "Upper bound of volume range (exclusive)"
+              "Upper bound of balance range (exclusive), in USD with 6 decimals"
             ],
             "type": "u64"
           },
@@ -13569,9 +13576,9 @@ export type Liquid = {
         "kind": "struct",
         "fields": [
           {
-            "name": "totalSolVolume",
+            "name": "totalUsdVolume",
             "docs": [
-              "Total SOL volume across all curve trades"
+              "Total USD volume across all curve trades (6 decimals)"
             ],
             "type": "u128"
           },
@@ -13801,9 +13808,9 @@ export type Liquid = {
             "type": "pubkey"
           },
           {
-            "name": "totalSolVolume",
+            "name": "totalUsdVolume",
             "docs": [
-              "Total SOL volume for this token (curve + AMM)"
+              "Total USD volume for this token (curve + AMM, 6 decimals)"
             ],
             "type": "u128"
           },
@@ -13815,16 +13822,16 @@ export type Liquid = {
             "type": "u128"
           },
           {
-            "name": "curveSolVolume",
+            "name": "curveUsdVolume",
             "docs": [
-              "SOL volume from curve trades (for analytics)"
+              "USD volume from curve trades (for analytics)"
             ],
             "type": "u128"
           },
           {
-            "name": "ammSolVolume",
+            "name": "ammUsdVolume",
             "docs": [
-              "SOL volume from AMM trades (for analytics)"
+              "USD volume from AMM trades (for analytics)"
             ],
             "type": "u128"
           }
@@ -13939,9 +13946,9 @@ export type Liquid = {
             }
           },
           {
-            "name": "totalSolVolume",
+            "name": "totalUsdVolume",
             "docs": [
-              "Total SOL volume traded across both curve and AMM (used for cashback multiplier)"
+              "Total USD volume traded across both curve and AMM"
             ],
             "type": "u128"
           },
@@ -13967,23 +13974,23 @@ export type Liquid = {
             "type": "bool"
           },
           {
-            "name": "curveSolVolume",
+            "name": "curveUsdVolume",
             "docs": [
-              "SOL volume from curve trades only (for analytics)"
+              "USD volume from curve trades only (for analytics)"
             ],
             "type": "u128"
           },
           {
-            "name": "ammSolVolume",
+            "name": "ammUsdVolume",
             "docs": [
-              "SOL volume from AMM trades only (for analytics)"
+              "USD volume from AMM trades only (for analytics)"
             ],
             "type": "u128"
           },
           {
-            "name": "snapshotSolVolume",
+            "name": "snapshotUsdVolume",
             "docs": [
-              "SOL volume accumulated since the last snapshot (resets on snapshot)"
+              "USD volume accumulated since the last snapshot (resets on snapshot)"
             ],
             "type": "u128"
           },

package/src/idl/liquid_events.json

@@ -1159,13 +1159,6 @@
             ],
             "type": "pubkey"
           },
-          {
-            "name": "multiplier_bps",
-            "docs": [
-              "Cashback multiplier in basis points."
-            ],
-            "type": "u16"
-          },
           {
             "name": "timestamp",
             "docs": [
@@ -2266,9 +2259,9 @@
             "type": "u32"
           },
           {
-            "name": "sol_volume",
+            "name": "usd_volume",
             "docs": [
-              "SOL volume at snapshot time."
+              "USD volume at snapshot time."
             ],
             "type": "u128"
           },
@@ -2622,7 +2615,7 @@
     {
       "name": "TradeAmounts",
       "docs": [
-        "Trade amount variants for bonding curve trades."
+        "Trade amount variants for bonding curve and AMM trades."
       ],
       "type": {
         "kind": "enum",

package/src/idl/liquid_events.ts

@@ -1165,13 +1165,6 @@ export type LiquidEvents = {
             ],
             "type": "pubkey"
           },
-          {
-            "name": "multiplierBps",
-            "docs": [
-              "Cashback multiplier in basis points."
-            ],
-            "type": "u16"
-          },
           {
             "name": "timestamp",
             "docs": [
@@ -2272,9 +2265,9 @@ export type LiquidEvents = {
             "type": "u32"
           },
           {
-            "name": "solVolume",
+            "name": "usdVolume",
             "docs": [
-              "SOL volume at snapshot time."
+              "USD volume at snapshot time."
             ],
             "type": "u128"
           },
@@ -2628,7 +2621,7 @@ export type LiquidEvents = {
     {
       "name": "tradeAmounts",
       "docs": [
-        "Trade amount variants for bonding curve trades."
+        "Trade amount variants for bonding curve and AMM trades."
       ],
       "type": {
         "kind": "enum",

package/src/idl/liquid_fees.json

@@ -10,10 +10,7 @@
     {
       "name": "accept_admin",
       "docs": [
-        "Accept a pending admin transfer (step 2 of 2).",
-        "",
-        "# Arguments",
-        "* `ctx` - Context containing the pending admin signer."
+        "Accept a pending admin transfer (step 2 of 2)."
       ],
       "discriminator": [
         112,
@@ -69,12 +66,7 @@
     {
       "name": "claim_fees",
       "docs": [
-        "Claim accumulated SOL fees from a recipient's vault PDA.",
-        "",
-        "# Arguments",
-        "The recipient must sign the transaction. The vault PDA is derived",
-        "from the fee_config and recipient pubkey, ensuring only the rightful",
-        "recipient can claim."
+        "Claim accumulated SOL fees from a recipient's vault PDA."
       ],
       "discriminator": [
         82,
@@ -186,11 +178,7 @@
     {
       "name": "claim_token_fees",
       "docs": [
-        "Claim accumulated token fees from a recipient's vault ATA.",
-        "",
-        "# Arguments",
-        "The recipient must sign the transaction. After claiming, the vault",
-        "ATA is closed and rent is returned to the recipient."
+        "Claim accumulated token fees from a recipient's vault ATA."
       ],
       "discriminator": [
         205,
@@ -806,7 +794,10 @@
         "",
         "This should be called when creating a new bonding curve.",
         "The fee configuration is keyed by token_mint, so it persists",
-        "across migration from bonding curve to AMM."
+        "across migration from bonding curve to AMM.",
+        "",
+        "# Arguments",
+        "* `args` - Fee recipients, basis points, and update authority."
       ],
       "discriminator": [
         62,
@@ -931,10 +922,7 @@
     {
       "name": "initialize_global_config",
       "docs": [
-        "Initialize the global configuration for the liquid-fees program.",
-        "",
-        "# Arguments",
-        "* `ctx` - Context containing the admin signer and global config PDA."
+        "Initialize the global configuration for the liquid-fees program."
       ],
       "discriminator": [
         113,
@@ -997,7 +985,6 @@
         "Override the update authority on a fee configuration.",
         "",
         "# Arguments",
-        "* `ctx` - Context containing the admin, global config, and target fee config.",
         "* `args` - Contains the new update authority public key."
       ],
       "discriminator": [
@@ -1283,7 +1270,6 @@
         "Transfer admin authority to a new address (step 1 of 2).",
         "",
         "# Arguments",
-        "* `ctx` - Context containing the current admin signer.",
         "* `new_admin` - The new admin authority public key."
       ],
       "discriminator": [
@@ -1349,7 +1335,10 @@
         "",
         "Can update recipients or transfer update authority.",
         "Cannot be used to revoke - use `revoke_fee_config` instead.",
-        "Cannot be called on revoked configurations."
+        "Cannot be called on revoked configurations.",
+        "",
+        "# Arguments",
+        "* `args` - New recipients and/or new update authority."
       ],
       "discriminator": [
         104,