@liquid-af/sdk 0.10.2 → 0.10.4

package/src/idl/liquid_state.json

@@ -1,5 +1,5 @@
 {
-  "address": "State3HtEfi7cXdsTpAtRoBvrij8zSFCiGTAVWmYH2d",
+  "address": "9ZcKPa3HAEVEKxwFX8fYD56ZJCKPEQgqjgr9rfUvtwKJ",
   "metadata": {
     "name": "liquid_state",
     "version": "0.1.0",
@@ -68,7 +68,10 @@
     {
       "name": "admin_update_user",
       "docs": [
-        "Admin updates a user's referrer/multiplier and always takes a snapshot"
+        "Admin updates a user's referrer/multiplier and always takes a snapshot.",
+        "",
+        "# Arguments",
+        "* `args` - Optional new referrer and cashback multiplier override."
       ],
       "discriminator": [
         161,
@@ -238,7 +241,7 @@
           "docs": [
             "Liquid events program for centralized event emission."
           ],
-          "address": "EventsQeXA43nLKR69DhHwNsJ6aM512AweMCgG3wG8zG"
+          "address": "Bast7hBDiqSsxiwEmqazwvPvXC3N4z8UQR5ZmkqXnCiY"
         },
         {
           "name": "system_program",
@@ -426,7 +429,7 @@
           "docs": [
             "Liquid events program for centralized event emission."
           ],
-          "address": "EventsQeXA43nLKR69DhHwNsJ6aM512AweMCgG3wG8zG"
+          "address": "Bast7hBDiqSsxiwEmqazwvPvXC3N4z8UQR5ZmkqXnCiY"
         }
       ],
       "args": []
@@ -553,7 +556,7 @@
           "docs": [
             "Liquid events program for centralized event emission."
           ],
-          "address": "EventsQeXA43nLKR69DhHwNsJ6aM512AweMCgG3wG8zG"
+          "address": "Bast7hBDiqSsxiwEmqazwvPvXC3N4z8UQR5ZmkqXnCiY"
         },
         {
           "name": "system_program",
@@ -574,7 +577,10 @@
     {
       "name": "earn_cashback",
       "docs": [
-        "Earn cashback credits (called via CPI during trades)"
+        "Earn cashback credits (called via CPI during trades).",
+        "",
+        "# Arguments",
+        "* `cashback_amount` - Base cashback amount in USD (6 decimals) before multiplier adjustment."
       ],
       "discriminator": [
         123,
@@ -666,7 +672,37 @@
           "docs": [
             "Liquid events program for centralized event emission."
           ],
-          "address": "EventsQeXA43nLKR69DhHwNsJ6aM512AweMCgG3wG8zG"
+          "address": "Bast7hBDiqSsxiwEmqazwvPvXC3N4z8UQR5ZmkqXnCiY"
+        },
+        {
+          "name": "cashback_config",
+          "docs": [
+            "Cashback configuration for balance-based multiplier tiers."
+          ],
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  99,
+                  97,
+                  115,
+                  104,
+                  98,
+                  97,
+                  99,
+                  107,
+                  95,
+                  99,
+                  111,
+                  110,
+                  102,
+                  105,
+                  103
+                ]
+              }
+            ]
+          }
         }
       ],
       "args": [
@@ -679,7 +715,10 @@
     {
       "name": "initialize_config",
       "docs": [
-        "Initialize global configuration (cashback config and volume accumulators)"
+        "Initialize global configuration (cashback config and volume accumulators).",
+        "",
+        "# Arguments",
+        "* `args` - Admin authority, cashback ranges, and trader cashback basis points."
       ],
       "discriminator": [
         208,
@@ -1060,7 +1099,7 @@
           "docs": [
             "Liquid events program for centralized event emission."
           ],
-          "address": "EventsQeXA43nLKR69DhHwNsJ6aM512AweMCgG3wG8zG"
+          "address": "Bast7hBDiqSsxiwEmqazwvPvXC3N4z8UQR5ZmkqXnCiY"
         }
       ],
       "args": []
@@ -1118,33 +1157,6 @@
             ]
           }
         },
-        {
-          "name": "cashback_config",
-          "pda": {
-            "seeds": [
-              {
-                "kind": "const",
-                "value": [
-                  99,
-                  97,
-                  115,
-                  104,
-                  98,
-                  97,
-                  99,
-                  107,
-                  95,
-                  99,
-                  111,
-                  110,
-                  102,
-                  105,
-                  103
-                ]
-              }
-            ]
-          }
-        },
         {
           "name": "cpi_authority",
           "docs": [
@@ -1178,7 +1190,7 @@
           "docs": [
             "Liquid events program for centralized event emission."
           ],
-          "address": "EventsQeXA43nLKR69DhHwNsJ6aM512AweMCgG3wG8zG"
+          "address": "Bast7hBDiqSsxiwEmqazwvPvXC3N4z8UQR5ZmkqXnCiY"
         }
       ],
       "args": []
@@ -1186,7 +1198,10 @@
     {
       "name": "set_referrer",
       "docs": [
-        "User sets their referrer (one-time only)"
+        "User sets their referrer (one-time only).",
+        "",
+        "# Arguments",
+        "* `referrer` - The referrer's public key."
       ],
       "discriminator": [
         115,
@@ -1276,7 +1291,7 @@
           "docs": [
             "Liquid events program for centralized event emission."
           ],
-          "address": "EventsQeXA43nLKR69DhHwNsJ6aM512AweMCgG3wG8zG"
+          "address": "Bast7hBDiqSsxiwEmqazwvPvXC3N4z8UQR5ZmkqXnCiY"
         }
       ],
       "args": [
@@ -1289,8 +1304,13 @@
     {
       "name": "spend_cashback",
       "docs": [
-        "Spend cashback credits to offset protocol fees (called via CPI)",
-        "Returns the amount actually spent"
+        "Spend cashback credits to offset protocol fees (called via CPI).",
+        "",
+        "# Arguments",
+        "* `amount` - Maximum USD credits to spend (6 decimals).",
+        "",
+        "# Returns",
+        "* `SpendCashbackResult` - The amount of credits actually spent."
       ],
       "discriminator": [
         59,
@@ -1382,7 +1402,7 @@
           "docs": [
             "Liquid events program for centralized event emission."
           ],
-          "address": "EventsQeXA43nLKR69DhHwNsJ6aM512AweMCgG3wG8zG"
+          "address": "Bast7hBDiqSsxiwEmqazwvPvXC3N4z8UQR5ZmkqXnCiY"
         }
       ],
       "args": [
@@ -1570,7 +1590,7 @@
           "docs": [
             "Liquid events program for centralized event emission."
           ],
-          "address": "EventsQeXA43nLKR69DhHwNsJ6aM512AweMCgG3wG8zG"
+          "address": "Bast7hBDiqSsxiwEmqazwvPvXC3N4z8UQR5ZmkqXnCiY"
         },
         {
           "name": "system_program",
@@ -1582,7 +1602,10 @@
     {
       "name": "transfer_admin",
       "docs": [
-        "Propose transfer of admin authority to a new pubkey (two-step)"
+        "Propose transfer of admin authority to a new pubkey (two-step).",
+        "",
+        "# Arguments",
+        "* `new_admin` - The proposed new admin authority public key."
       ],
       "discriminator": [
         42,
@@ -1645,7 +1668,11 @@
       "name": "update_amm_volumes",
       "docs": [
         "Update volume accumulators for AMM trades.",
-        "Called via CPI from the liquid-swap program."
+        "Called via CPI from the liquid-swap program.",
+        "",
+        "# Arguments",
+        "* `usd_amount` - Trade volume in USD (6 decimals).",
+        "* `token_amount` - Trade volume in base token units."
       ],
       "discriminator": [
         155,
@@ -1694,38 +1721,38 @@
             "program": {
               "kind": "const",
               "value": [
-                6,
-                165,
-                60,
-                202,
-                204,
-                17,
-                4,
-                104,
-                249,
-                125,
-                214,
-                143,
+                190,
+                32,
+                180,
+                44,
+                45,
+                199,
+                191,
+                169,
+                16,
+                36,
+                248,
+                54,
+                24,
+                28,
+                56,
+                136,
+                88,
                 2,
-                99,
-                165,
-                89,
-                177,
-                218,
-                121,
-                12,
-                23,
-                196,
-                207,
-                105,
-                96,
-                207,
+                74,
+                47,
+                84,
+                229,
+                29,
+                26,
+                30,
+                90,
+                41,
+                109,
                 2,
-                136,
-                202,
-                45,
-                209,
-                225
+                14,
+                50,
+                160
               ]
             }
           }
@@ -1840,7 +1867,7 @@
       ],
       "args": [
         {
-          "name": "sol_amount",
+          "name": "usd_amount",
           "type": "u64"
         },
         {
@@ -1852,7 +1879,10 @@
     {
       "name": "update_config",
       "docs": [
-        "Admin updates cashback configuration"
+        "Admin updates cashback configuration.",
+        "",
+        "# Arguments",
+        "* `args` - New cashback ranges and/or trader cashback basis points."
       ],
       "discriminator": [
         29,
@@ -1919,7 +1949,11 @@
       "name": "update_curve_volumes",
       "docs": [
         "Update volume accumulators for bonding curve trades.",
-        "Called via CPI from the liquid program."
+        "Called via CPI from the liquid program.",
+        "",
+        "# Arguments",
+        "* `usd_amount` - Trade volume in USD (6 decimals).",
+        "* `token_amount` - Trade volume in base token units."
       ],
       "discriminator": [
         119,
@@ -1968,38 +2002,38 @@
             "program": {
               "kind": "const",
               "value": [
-                5,
-                13,
-                89,
-                2,
-                127,
-                227,
-                146,
-                196,
-                34,
-                13,
-                249,
-                181,
+                90,
                 167,
-                33,
-                126,
-                56,
-                182,
-                105,
-                148,
-                219,
-                33,
-                200,
-                131,
-                117,
-                84,
-                120,
-                212,
-                68,
-                166,
-                219,
-                24,
-                119
+                50,
+                46,
+                85,
+                64,
+                55,
+                53,
+                224,
+                209,
+                144,
+                181,
+                201,
+                225,
+                70,
+                30,
+                252,
+                64,
+                238,
+                96,
+                113,
+                137,
+                55,
+                211,
+                9,
+                69,
+                233,
+                207,
+                149,
+                20,
+                99,
+                193
               ]
             }
           }
@@ -2116,7 +2150,7 @@
       ],
       "args": [
         {
-          "name": "sol_amount",
+          "name": "usd_amount",
           "type": "u64"
         },
         {
@@ -2128,7 +2162,10 @@
     {
       "name": "update_deal",
       "docs": [
-        "Admin updates a deal's cashback multiplier"
+        "Admin updates a deal's cashback multiplier.",
+        "",
+        "# Arguments",
+        "* `new_cashback_multiplier_bps` - New cashback multiplier in basis points (10000 = 1x)."
       ],
       "discriminator": [
         244,
@@ -2236,7 +2273,7 @@
           "docs": [
             "Liquid events program for centralized event emission."
           ],
-          "address": "EventsQeXA43nLKR69DhHwNsJ6aM512AweMCgG3wG8zG"
+          "address": "Bast7hBDiqSsxiwEmqazwvPvXC3N4z8UQR5ZmkqXnCiY"
         }
       ],
       "args": [
@@ -2464,7 +2501,9 @@
           {
             "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": {
@@ -2496,7 +2535,12 @@
     {
       "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",
@@ -2504,14 +2548,14 @@
           {
             "name": "range_start_inclusive",
             "docs": [
-              "Lower bound of volume range (inclusive)"
+              "Lower bound of balance range (inclusive), in USD with 6 decimals"
             ],
             "type": "u64"
           },
           {
             "name": "range_end_exclusive",
             "docs": [
-              "Upper bound of volume range (exclusive)"
+              "Upper bound of balance range (exclusive), in USD with 6 decimals"
             ],
             "type": "u64"
           },
@@ -2571,9 +2615,9 @@
         "kind": "struct",
         "fields": [
           {
-            "name": "total_sol_volume",
+            "name": "total_usd_volume",
             "docs": [
-              "Total SOL volume across all AMM trades"
+              "Total USD volume across all AMM trades (6 decimals)"
             ],
             "type": "u128"
           },
@@ -2598,9 +2642,9 @@
         "kind": "struct",
         "fields": [
           {
-            "name": "total_sol_volume",
+            "name": "total_usd_volume",
             "docs": [
-              "Total SOL volume across all curve trades"
+              "Total USD volume across all curve trades (6 decimals)"
             ],
             "type": "u128"
           },
@@ -2704,9 +2748,9 @@
             "type": "pubkey"
           },
           {
-            "name": "total_sol_volume",
+            "name": "total_usd_volume",
             "docs": [
-              "Total SOL volume for this token (curve + AMM)"
+              "Total USD volume for this token (curve + AMM, 6 decimals)"
             ],
             "type": "u128"
           },
@@ -2718,16 +2762,16 @@
             "type": "u128"
           },
           {
-            "name": "curve_sol_volume",
+            "name": "curve_usd_volume",
             "docs": [
-              "SOL volume from curve trades (for analytics)"
+              "USD volume from curve trades (for analytics)"
             ],
             "type": "u128"
           },
           {
-            "name": "amm_sol_volume",
+            "name": "amm_usd_volume",
             "docs": [
-              "SOL volume from AMM trades (for analytics)"
+              "USD volume from AMM trades (for analytics)"
             ],
             "type": "u128"
           }
@@ -2784,9 +2828,9 @@
             }
           },
           {
-            "name": "total_sol_volume",
+            "name": "total_usd_volume",
             "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"
           },
@@ -2812,23 +2856,23 @@
             "type": "bool"
           },
           {
-            "name": "curve_sol_volume",
+            "name": "curve_usd_volume",
             "docs": [
-              "SOL volume from curve trades only (for analytics)"
+              "USD volume from curve trades only (for analytics)"
             ],
             "type": "u128"
           },
           {
-            "name": "amm_sol_volume",
+            "name": "amm_usd_volume",
             "docs": [
-              "SOL volume from AMM trades only (for analytics)"
+              "USD volume from AMM trades only (for analytics)"
             ],
             "type": "u128"
           },
           {
-            "name": "snapshot_sol_volume",
+            "name": "snapshot_usd_volume",
             "docs": [
-              "SOL volume accumulated since the last snapshot (resets on snapshot)"
+              "USD volume accumulated since the last snapshot (resets on snapshot)"
             ],
             "type": "u128"
           },
@@ -2893,9 +2937,9 @@
             }
           },
           {
-            "name": "sol_volume",
+            "name": "usd_volume",
             "docs": [
-              "SOL volume accumulated during this snapshot period"
+              "USD volume accumulated during this snapshot period"
             ],
             "type": "u128"
           },