@liquid-af/sdk 0.1.0

package/dist/idl/liquid_state.d.ts

@@ -0,0 +1,2936 @@
+/**
+ * Program IDL in camelCase format in order to be used in JS/TS.
+ *
+ * Note that this is only a type helper and is not the actual IDL. The original
+ * IDL can be found at `target/idl/liquid_state.json`.
+ */
+export type LiquidState = {
+    "address": "State3HtEfi7cXdsTpAtRoBvrij8zSFCiGTAVWmYH2d";
+    "metadata": {
+        "name": "liquidState";
+        "version": "0.1.0";
+        "spec": "0.1.0";
+        "description": "Unified state management for liquid programs (user properties, cashback, volume tracking)";
+    };
+    "instructions": [
+        {
+            "name": "acceptAdmin";
+            "docs": [
+                "Accept a pending admin transfer, completing the two-step handoff"
+            ];
+            "discriminator": [
+                112,
+                42,
+                45,
+                90,
+                116,
+                181,
+                13,
+                170
+            ];
+            "accounts": [
+                {
+                    "name": "newAdmin";
+                    "docs": [
+                        "The pending admin who is accepting the transfer."
+                    ];
+                    "writable": true;
+                    "signer": true;
+                },
+                {
+                    "name": "cashbackConfig";
+                    "docs": [
+                        "Cashback configuration holding the admin authority"
+                    ];
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    99,
+                                    97,
+                                    115,
+                                    104,
+                                    98,
+                                    97,
+                                    99,
+                                    107,
+                                    95,
+                                    99,
+                                    111,
+                                    110,
+                                    102,
+                                    105,
+                                    103
+                                ];
+                            }
+                        ];
+                    };
+                }
+            ];
+            "args": [];
+        },
+        {
+            "name": "adminUpdateUser";
+            "docs": [
+                "Admin updates a user's referrer/multiplier and always takes a snapshot"
+            ];
+            "discriminator": [
+                161,
+                36,
+                48,
+                104,
+                149,
+                187,
+                39,
+                2
+            ];
+            "accounts": [
+                {
+                    "name": "payer";
+                    "docs": [
+                        "Payer for snapshot account creation"
+                    ];
+                    "writable": true;
+                    "signer": true;
+                },
+                {
+                    "name": "admin";
+                    "docs": [
+                        "Admin authority"
+                    ];
+                    "signer": true;
+                },
+                {
+                    "name": "userProperties";
+                    "docs": [
+                        "User properties account"
+                    ];
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    117,
+                                    115,
+                                    101,
+                                    114,
+                                    95,
+                                    112,
+                                    114,
+                                    111,
+                                    112,
+                                    101,
+                                    114,
+                                    116,
+                                    105,
+                                    101,
+                                    115
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "user";
+                            }
+                        ];
+                    };
+                },
+                {
+                    "name": "userSnapshot";
+                    "docs": [
+                        "Snapshot account to create (always taken on admin update)"
+                    ];
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    117,
+                                    115,
+                                    101,
+                                    114,
+                                    95,
+                                    115,
+                                    110,
+                                    97,
+                                    112,
+                                    115,
+                                    104,
+                                    111,
+                                    116
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "user";
+                            },
+                            {
+                                "kind": "account";
+                                "path": "user_properties.snapshot_count";
+                                "account": "userProperties";
+                            }
+                        ];
+                    };
+                },
+                {
+                    "name": "cashbackConfig";
+                    "docs": [
+                        "Cashback configuration for admin auth check"
+                    ];
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    99,
+                                    97,
+                                    115,
+                                    104,
+                                    98,
+                                    97,
+                                    99,
+                                    107,
+                                    95,
+                                    99,
+                                    111,
+                                    110,
+                                    102,
+                                    105,
+                                    103
+                                ];
+                            }
+                        ];
+                    };
+                },
+                {
+                    "name": "user";
+                    "docs": [
+                        "The user being updated"
+                    ];
+                },
+                {
+                    "name": "systemProgram";
+                    "address": "11111111111111111111111111111111";
+                }
+            ];
+            "args": [
+                {
+                    "name": "args";
+                    "type": {
+                        "defined": {
+                            "name": "adminUpdateUserArgs";
+                        };
+                    };
+                }
+            ];
+        },
+        {
+            "name": "cancelAdminTransfer";
+            "docs": [
+                "Cancel a pending admin transfer (callable by current or pending admin)"
+            ];
+            "discriminator": [
+                38,
+                131,
+                157,
+                31,
+                240,
+                137,
+                44,
+                215
+            ];
+            "accounts": [
+                {
+                    "name": "authority";
+                    "docs": [
+                        "The authority cancelling the transfer (current admin or pending admin)."
+                    ];
+                    "writable": true;
+                    "signer": true;
+                },
+                {
+                    "name": "cashbackConfig";
+                    "docs": [
+                        "Cashback configuration holding the admin authority"
+                    ];
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    99,
+                                    97,
+                                    115,
+                                    104,
+                                    98,
+                                    97,
+                                    99,
+                                    107,
+                                    95,
+                                    99,
+                                    111,
+                                    110,
+                                    102,
+                                    105,
+                                    103
+                                ];
+                            }
+                        ];
+                    };
+                }
+            ];
+            "args": [];
+        },
+        {
+            "name": "closeDeal";
+            "docs": [
+                "Admin closes/deletes a deal, returning rent to admin"
+            ];
+            "discriminator": [
+                157,
+                173,
+                33,
+                216,
+                146,
+                16,
+                65,
+                82
+            ];
+            "accounts": [
+                {
+                    "name": "admin";
+                    "docs": [
+                        "Admin authority (receives rent refund)"
+                    ];
+                    "writable": true;
+                    "signer": true;
+                },
+                {
+                    "name": "deal";
+                    "docs": [
+                        "Deal account to close"
+                    ];
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    100,
+                                    101,
+                                    97,
+                                    108
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "deal.owner";
+                                "account": "deal";
+                            }
+                        ];
+                    };
+                },
+                {
+                    "name": "cashbackConfig";
+                    "docs": [
+                        "Cashback configuration for admin auth check"
+                    ];
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    99,
+                                    97,
+                                    115,
+                                    104,
+                                    98,
+                                    97,
+                                    99,
+                                    107,
+                                    95,
+                                    99,
+                                    111,
+                                    110,
+                                    102,
+                                    105,
+                                    103
+                                ];
+                            }
+                        ];
+                    };
+                }
+            ];
+            "args": [];
+        },
+        {
+            "name": "createDeal";
+            "docs": [
+                "Admin creates an exclusive deal for a pubkey",
+                "",
+                "# Arguments",
+                "* `owner` - The pubkey this deal belongs to",
+                "* `cashback_multiplier_bps` - Cashback multiplier in basis points (10000 = 1x)"
+            ];
+            "discriminator": [
+                198,
+                212,
+                144,
+                151,
+                97,
+                56,
+                149,
+                113
+            ];
+            "accounts": [
+                {
+                    "name": "payer";
+                    "docs": [
+                        "Payer for account creation"
+                    ];
+                    "writable": true;
+                    "signer": true;
+                },
+                {
+                    "name": "admin";
+                    "docs": [
+                        "Admin authority"
+                    ];
+                    "signer": true;
+                },
+                {
+                    "name": "deal";
+                    "docs": [
+                        "Deal account to create"
+                    ];
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    100,
+                                    101,
+                                    97,
+                                    108
+                                ];
+                            },
+                            {
+                                "kind": "arg";
+                                "path": "owner";
+                            }
+                        ];
+                    };
+                },
+                {
+                    "name": "cashbackConfig";
+                    "docs": [
+                        "Cashback configuration for admin auth check"
+                    ];
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    99,
+                                    97,
+                                    115,
+                                    104,
+                                    98,
+                                    97,
+                                    99,
+                                    107,
+                                    95,
+                                    99,
+                                    111,
+                                    110,
+                                    102,
+                                    105,
+                                    103
+                                ];
+                            }
+                        ];
+                    };
+                },
+                {
+                    "name": "systemProgram";
+                    "address": "11111111111111111111111111111111";
+                }
+            ];
+            "args": [
+                {
+                    "name": "owner";
+                    "type": "pubkey";
+                },
+                {
+                    "name": "cashbackMultiplierBps";
+                    "type": "u16";
+                }
+            ];
+        },
+        {
+            "name": "earnCashback";
+            "docs": [
+                "Earn cashback credits (called via CPI during trades)"
+            ];
+            "discriminator": [
+                123,
+                185,
+                10,
+                74,
+                209,
+                80,
+                101,
+                149
+            ];
+            "accounts": [
+                {
+                    "name": "cpiAuthority";
+                    "docs": [
+                        "CPI authority PDA from the calling program (must be liquid or liquid-swap).",
+                        "Only the owning program can produce a valid signature for its PDA."
+                    ];
+                    "signer": true;
+                },
+                {
+                    "name": "user";
+                    "docs": [
+                        "The user whose cashback is being earned"
+                    ];
+                },
+                {
+                    "name": "userProperties";
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    117,
+                                    115,
+                                    101,
+                                    114,
+                                    95,
+                                    112,
+                                    114,
+                                    111,
+                                    112,
+                                    101,
+                                    114,
+                                    116,
+                                    105,
+                                    101,
+                                    115
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "user";
+                            }
+                        ];
+                    };
+                }
+            ];
+            "args": [
+                {
+                    "name": "cashbackAmount";
+                    "type": "u64";
+                }
+            ];
+        },
+        {
+            "name": "initializeConfig";
+            "docs": [
+                "Initialize global configuration (cashback config and volume accumulators)"
+            ];
+            "discriminator": [
+                208,
+                127,
+                21,
+                1,
+                194,
+                190,
+                196,
+                70
+            ];
+            "accounts": [
+                {
+                    "name": "payer";
+                    "writable": true;
+                    "signer": true;
+                },
+                {
+                    "name": "cashbackConfig";
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    99,
+                                    97,
+                                    115,
+                                    104,
+                                    98,
+                                    97,
+                                    99,
+                                    107,
+                                    95,
+                                    99,
+                                    111,
+                                    110,
+                                    102,
+                                    105,
+                                    103
+                                ];
+                            }
+                        ];
+                    };
+                },
+                {
+                    "name": "globalCurveVolume";
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    103,
+                                    108,
+                                    111,
+                                    98,
+                                    97,
+                                    108,
+                                    95,
+                                    99,
+                                    117,
+                                    114,
+                                    118,
+                                    101,
+                                    95,
+                                    118,
+                                    111,
+                                    108,
+                                    117,
+                                    109,
+                                    101
+                                ];
+                            }
+                        ];
+                    };
+                },
+                {
+                    "name": "globalAmmVolume";
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    103,
+                                    108,
+                                    111,
+                                    98,
+                                    97,
+                                    108,
+                                    95,
+                                    97,
+                                    109,
+                                    109,
+                                    95,
+                                    118,
+                                    111,
+                                    108,
+                                    117,
+                                    109,
+                                    101
+                                ];
+                            }
+                        ];
+                    };
+                },
+                {
+                    "name": "systemProgram";
+                    "address": "11111111111111111111111111111111";
+                }
+            ];
+            "args": [
+                {
+                    "name": "args";
+                    "type": {
+                        "defined": {
+                            "name": "initializeConfigArgs";
+                        };
+                    };
+                }
+            ];
+        },
+        {
+            "name": "initializeTokenVolume";
+            "docs": [
+                "Initialize a token's volume accumulator with default values"
+            ];
+            "discriminator": [
+                98,
+                160,
+                140,
+                145,
+                106,
+                65,
+                10,
+                106
+            ];
+            "accounts": [
+                {
+                    "name": "payer";
+                    "docs": [
+                        "The payer for account creation"
+                    ];
+                    "writable": true;
+                    "signer": true;
+                },
+                {
+                    "name": "mint";
+                    "docs": [
+                        "The mint for which to create the volume accumulator"
+                    ];
+                },
+                {
+                    "name": "tokenVolume";
+                    "docs": [
+                        "Token volume accumulator to be created"
+                    ];
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    116,
+                                    111,
+                                    107,
+                                    101,
+                                    110,
+                                    95,
+                                    118,
+                                    111,
+                                    108,
+                                    117,
+                                    109,
+                                    101
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "mint";
+                            }
+                        ];
+                    };
+                },
+                {
+                    "name": "systemProgram";
+                    "docs": [
+                        "System program"
+                    ];
+                    "address": "11111111111111111111111111111111";
+                }
+            ];
+            "args": [];
+        },
+        {
+            "name": "initializeUser";
+            "docs": [
+                "Initialize a user's properties account with default values"
+            ];
+            "discriminator": [
+                111,
+                17,
+                185,
+                250,
+                60,
+                122,
+                38,
+                254
+            ];
+            "accounts": [
+                {
+                    "name": "user";
+                    "docs": [
+                        "The user being initialized"
+                    ];
+                    "writable": true;
+                    "signer": true;
+                },
+                {
+                    "name": "userProperties";
+                    "docs": [
+                        "User properties account to be created"
+                    ];
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    117,
+                                    115,
+                                    101,
+                                    114,
+                                    95,
+                                    112,
+                                    114,
+                                    111,
+                                    112,
+                                    101,
+                                    114,
+                                    116,
+                                    105,
+                                    101,
+                                    115
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "user";
+                            }
+                        ];
+                    };
+                },
+                {
+                    "name": "systemProgram";
+                    "docs": [
+                        "System program"
+                    ];
+                    "address": "11111111111111111111111111111111";
+                }
+            ];
+            "args": [];
+        },
+        {
+            "name": "redeemDeal";
+            "docs": [
+                "User redeems their referrer's deal, copying the multiplier"
+            ];
+            "discriminator": [
+                28,
+                120,
+                114,
+                30,
+                76,
+                241,
+                161,
+                235
+            ];
+            "accounts": [
+                {
+                    "name": "user";
+                    "docs": [
+                        "The user redeeming the deal"
+                    ];
+                    "signer": true;
+                },
+                {
+                    "name": "userProperties";
+                    "docs": [
+                        "User properties account"
+                    ];
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    117,
+                                    115,
+                                    101,
+                                    114,
+                                    95,
+                                    112,
+                                    114,
+                                    111,
+                                    112,
+                                    101,
+                                    114,
+                                    116,
+                                    105,
+                                    101,
+                                    115
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "user";
+                            }
+                        ];
+                    };
+                },
+                {
+                    "name": "deal";
+                    "docs": [
+                        "The deal to redeem (must belong to user's referrer)"
+                    ];
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    100,
+                                    101,
+                                    97,
+                                    108
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "deal.owner";
+                                "account": "deal";
+                            }
+                        ];
+                    };
+                }
+            ];
+            "args": [];
+        },
+        {
+            "name": "setCashbackMode";
+            "docs": [
+                "User-callable instruction to activate cashback spending mode",
+                "Applies volume-based multiplier to credits"
+            ];
+            "discriminator": [
+                172,
+                30,
+                26,
+                209,
+                48,
+                185,
+                117,
+                148
+            ];
+            "accounts": [
+                {
+                    "name": "user";
+                    "signer": true;
+                },
+                {
+                    "name": "userProperties";
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    117,
+                                    115,
+                                    101,
+                                    114,
+                                    95,
+                                    112,
+                                    114,
+                                    111,
+                                    112,
+                                    101,
+                                    114,
+                                    116,
+                                    105,
+                                    101,
+                                    115
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "user";
+                            }
+                        ];
+                    };
+                },
+                {
+                    "name": "cashbackConfig";
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    99,
+                                    97,
+                                    115,
+                                    104,
+                                    98,
+                                    97,
+                                    99,
+                                    107,
+                                    95,
+                                    99,
+                                    111,
+                                    110,
+                                    102,
+                                    105,
+                                    103
+                                ];
+                            }
+                        ];
+                    };
+                }
+            ];
+            "args": [];
+        },
+        {
+            "name": "setReferrer";
+            "docs": [
+                "User sets their referrer (one-time only)"
+            ];
+            "discriminator": [
+                115,
+                251,
+                55,
+                0,
+                166,
+                189,
+                25,
+                74
+            ];
+            "accounts": [
+                {
+                    "name": "user";
+                    "signer": true;
+                },
+                {
+                    "name": "userProperties";
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    117,
+                                    115,
+                                    101,
+                                    114,
+                                    95,
+                                    112,
+                                    114,
+                                    111,
+                                    112,
+                                    101,
+                                    114,
+                                    116,
+                                    105,
+                                    101,
+                                    115
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "user";
+                            }
+                        ];
+                    };
+                }
+            ];
+            "args": [
+                {
+                    "name": "referrer";
+                    "type": "pubkey";
+                }
+            ];
+        },
+        {
+            "name": "spendCashback";
+            "docs": [
+                "Spend cashback credits to offset protocol fees (called via CPI)",
+                "Returns the amount actually spent"
+            ];
+            "discriminator": [
+                59,
+                143,
+                28,
+                13,
+                254,
+                250,
+                233,
+                234
+            ];
+            "accounts": [
+                {
+                    "name": "cpiAuthority";
+                    "docs": [
+                        "CPI authority PDA from the calling program (must be liquid or liquid-swap).",
+                        "Only the owning program can produce a valid signature for its PDA."
+                    ];
+                    "signer": true;
+                },
+                {
+                    "name": "user";
+                    "docs": [
+                        "The user whose cashback is being spent"
+                    ];
+                },
+                {
+                    "name": "userProperties";
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    117,
+                                    115,
+                                    101,
+                                    114,
+                                    95,
+                                    112,
+                                    114,
+                                    111,
+                                    112,
+                                    101,
+                                    114,
+                                    116,
+                                    105,
+                                    101,
+                                    115
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "user";
+                            }
+                        ];
+                    };
+                }
+            ];
+            "args": [
+                {
+                    "name": "amount";
+                    "type": "u64";
+                }
+            ];
+            "returns": {
+                "defined": {
+                    "name": "spendCashbackResult";
+                };
+            };
+        },
+        {
+            "name": "takeSnapshot";
+            "docs": [
+                "Admin takes a snapshot of a user's volume since last snapshot"
+            ];
+            "discriminator": [
+                183,
+                210,
+                251,
+                68,
+                140,
+                132,
+                191,
+                140
+            ];
+            "accounts": [
+                {
+                    "name": "payer";
+                    "docs": [
+                        "Payer for snapshot account creation"
+                    ];
+                    "writable": true;
+                    "signer": true;
+                },
+                {
+                    "name": "admin";
+                    "docs": [
+                        "Admin authority"
+                    ];
+                    "signer": true;
+                },
+                {
+                    "name": "userProperties";
+                    "docs": [
+                        "User properties account"
+                    ];
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    117,
+                                    115,
+                                    101,
+                                    114,
+                                    95,
+                                    112,
+                                    114,
+                                    111,
+                                    112,
+                                    101,
+                                    114,
+                                    116,
+                                    105,
+                                    101,
+                                    115
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "user";
+                            }
+                        ];
+                    };
+                },
+                {
+                    "name": "userSnapshot";
+                    "docs": [
+                        "Snapshot account to create"
+                    ];
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    117,
+                                    115,
+                                    101,
+                                    114,
+                                    95,
+                                    115,
+                                    110,
+                                    97,
+                                    112,
+                                    115,
+                                    104,
+                                    111,
+                                    116
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "user";
+                            },
+                            {
+                                "kind": "account";
+                                "path": "user_properties.snapshot_count";
+                                "account": "userProperties";
+                            }
+                        ];
+                    };
+                },
+                {
+                    "name": "cashbackConfig";
+                    "docs": [
+                        "Cashback configuration for admin auth check"
+                    ];
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    99,
+                                    97,
+                                    115,
+                                    104,
+                                    98,
+                                    97,
+                                    99,
+                                    107,
+                                    95,
+                                    99,
+                                    111,
+                                    110,
+                                    102,
+                                    105,
+                                    103
+                                ];
+                            }
+                        ];
+                    };
+                },
+                {
+                    "name": "user";
+                    "docs": [
+                        "The user whose snapshot is being taken"
+                    ];
+                },
+                {
+                    "name": "systemProgram";
+                    "address": "11111111111111111111111111111111";
+                }
+            ];
+            "args": [];
+        },
+        {
+            "name": "transferAdmin";
+            "docs": [
+                "Propose transfer of admin authority to a new pubkey (two-step)"
+            ];
+            "discriminator": [
+                42,
+                242,
+                66,
+                106,
+                228,
+                10,
+                111,
+                156
+            ];
+            "accounts": [
+                {
+                    "name": "admin";
+                    "docs": [
+                        "Current admin authority"
+                    ];
+                    "signer": true;
+                },
+                {
+                    "name": "cashbackConfig";
+                    "docs": [
+                        "Cashback configuration holding the admin authority"
+                    ];
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    99,
+                                    97,
+                                    115,
+                                    104,
+                                    98,
+                                    97,
+                                    99,
+                                    107,
+                                    95,
+                                    99,
+                                    111,
+                                    110,
+                                    102,
+                                    105,
+                                    103
+                                ];
+                            }
+                        ];
+                    };
+                }
+            ];
+            "args": [
+                {
+                    "name": "newAdmin";
+                    "type": "pubkey";
+                }
+            ];
+        },
+        {
+            "name": "updateAmmVolumes";
+            "docs": [
+                "Update volume accumulators for AMM trades.",
+                "Called via CPI from the liquid-swap program."
+            ];
+            "discriminator": [
+                155,
+                173,
+                47,
+                177,
+                151,
+                135,
+                240,
+                27
+            ];
+            "accounts": [
+                {
+                    "name": "payer";
+                    "writable": true;
+                    "signer": true;
+                },
+                {
+                    "name": "cpiAuthority";
+                    "docs": [
+                        "CPI authority PDA from the liquid-swap program.",
+                        "Only the liquid-swap program can sign for this PDA."
+                    ];
+                    "signer": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    99,
+                                    112,
+                                    105,
+                                    95,
+                                    97,
+                                    117,
+                                    116,
+                                    104,
+                                    111,
+                                    114,
+                                    105,
+                                    116,
+                                    121
+                                ];
+                            }
+                        ];
+                        "program": {
+                            "kind": "const";
+                            "value": [
+                                6,
+                                165,
+                                60,
+                                202,
+                                204,
+                                17,
+                                4,
+                                104,
+                                249,
+                                125,
+                                214,
+                                143,
+                                2,
+                                99,
+                                165,
+                                89,
+                                177,
+                                218,
+                                121,
+                                12,
+                                23,
+                                196,
+                                207,
+                                105,
+                                96,
+                                207,
+                                2,
+                                136,
+                                202,
+                                45,
+                                209,
+                                225
+                            ];
+                        };
+                    };
+                },
+                {
+                    "name": "userProperties";
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    117,
+                                    115,
+                                    101,
+                                    114,
+                                    95,
+                                    112,
+                                    114,
+                                    111,
+                                    112,
+                                    101,
+                                    114,
+                                    116,
+                                    105,
+                                    101,
+                                    115
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "user";
+                            }
+                        ];
+                    };
+                },
+                {
+                    "name": "globalAmmVolume";
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    103,
+                                    108,
+                                    111,
+                                    98,
+                                    97,
+                                    108,
+                                    95,
+                                    97,
+                                    109,
+                                    109,
+                                    95,
+                                    118,
+                                    111,
+                                    108,
+                                    117,
+                                    109,
+                                    101
+                                ];
+                            }
+                        ];
+                    };
+                },
+                {
+                    "name": "tokenVolume";
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    116,
+                                    111,
+                                    107,
+                                    101,
+                                    110,
+                                    95,
+                                    118,
+                                    111,
+                                    108,
+                                    117,
+                                    109,
+                                    101
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "mint";
+                            }
+                        ];
+                    };
+                },
+                {
+                    "name": "user";
+                    "docs": [
+                        "The user whose volumes are being updated"
+                    ];
+                },
+                {
+                    "name": "mint";
+                    "docs": [
+                        "The token mint for token-specific volume tracking"
+                    ];
+                },
+                {
+                    "name": "systemProgram";
+                    "address": "11111111111111111111111111111111";
+                }
+            ];
+            "args": [
+                {
+                    "name": "solAmount";
+                    "type": "u64";
+                },
+                {
+                    "name": "tokenAmount";
+                    "type": "u64";
+                }
+            ];
+        },
+        {
+            "name": "updateConfig";
+            "docs": [
+                "Admin updates cashback configuration"
+            ];
+            "discriminator": [
+                29,
+                158,
+                252,
+                191,
+                10,
+                83,
+                219,
+                99
+            ];
+            "accounts": [
+                {
+                    "name": "admin";
+                    "docs": [
+                        "Admin authority (must match stored admin_authority)"
+                    ];
+                    "signer": true;
+                },
+                {
+                    "name": "cashbackConfig";
+                    "docs": [
+                        "Cashback configuration to update"
+                    ];
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    99,
+                                    97,
+                                    115,
+                                    104,
+                                    98,
+                                    97,
+                                    99,
+                                    107,
+                                    95,
+                                    99,
+                                    111,
+                                    110,
+                                    102,
+                                    105,
+                                    103
+                                ];
+                            }
+                        ];
+                    };
+                }
+            ];
+            "args": [
+                {
+                    "name": "args";
+                    "type": {
+                        "defined": {
+                            "name": "updateConfigArgs";
+                        };
+                    };
+                }
+            ];
+        },
+        {
+            "name": "updateCurveVolumes";
+            "docs": [
+                "Update volume accumulators for bonding curve trades.",
+                "Called via CPI from the liquid program."
+            ];
+            "discriminator": [
+                119,
+                220,
+                25,
+                188,
+                176,
+                213,
+                36,
+                73
+            ];
+            "accounts": [
+                {
+                    "name": "payer";
+                    "writable": true;
+                    "signer": true;
+                },
+                {
+                    "name": "cpiAuthority";
+                    "docs": [
+                        "CPI authority PDA from the liquid program.",
+                        "Only the liquid program can sign for this PDA."
+                    ];
+                    "signer": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    99,
+                                    112,
+                                    105,
+                                    95,
+                                    97,
+                                    117,
+                                    116,
+                                    104,
+                                    111,
+                                    114,
+                                    105,
+                                    116,
+                                    121
+                                ];
+                            }
+                        ];
+                        "program": {
+                            "kind": "const";
+                            "value": [
+                                5,
+                                13,
+                                89,
+                                2,
+                                127,
+                                227,
+                                146,
+                                196,
+                                34,
+                                13,
+                                249,
+                                181,
+                                167,
+                                33,
+                                126,
+                                56,
+                                182,
+                                105,
+                                148,
+                                219,
+                                33,
+                                200,
+                                131,
+                                117,
+                                84,
+                                120,
+                                212,
+                                68,
+                                166,
+                                219,
+                                24,
+                                119
+                            ];
+                        };
+                    };
+                },
+                {
+                    "name": "userProperties";
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    117,
+                                    115,
+                                    101,
+                                    114,
+                                    95,
+                                    112,
+                                    114,
+                                    111,
+                                    112,
+                                    101,
+                                    114,
+                                    116,
+                                    105,
+                                    101,
+                                    115
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "user";
+                            }
+                        ];
+                    };
+                },
+                {
+                    "name": "globalCurveVolume";
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    103,
+                                    108,
+                                    111,
+                                    98,
+                                    97,
+                                    108,
+                                    95,
+                                    99,
+                                    117,
+                                    114,
+                                    118,
+                                    101,
+                                    95,
+                                    118,
+                                    111,
+                                    108,
+                                    117,
+                                    109,
+                                    101
+                                ];
+                            }
+                        ];
+                    };
+                },
+                {
+                    "name": "tokenVolume";
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    116,
+                                    111,
+                                    107,
+                                    101,
+                                    110,
+                                    95,
+                                    118,
+                                    111,
+                                    108,
+                                    117,
+                                    109,
+                                    101
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "mint";
+                            }
+                        ];
+                    };
+                },
+                {
+                    "name": "user";
+                    "docs": [
+                        "The user whose volumes are being updated"
+                    ];
+                },
+                {
+                    "name": "mint";
+                    "docs": [
+                        "The token mint for token-specific volume tracking"
+                    ];
+                },
+                {
+                    "name": "systemProgram";
+                    "address": "11111111111111111111111111111111";
+                }
+            ];
+            "args": [
+                {
+                    "name": "solAmount";
+                    "type": "u64";
+                },
+                {
+                    "name": "tokenAmount";
+                    "type": "u64";
+                }
+            ];
+        },
+        {
+            "name": "updateDeal";
+            "docs": [
+                "Admin updates a deal's cashback multiplier"
+            ];
+            "discriminator": [
+                244,
+                195,
+                62,
+                95,
+                133,
+                119,
+                244,
+                59
+            ];
+            "accounts": [
+                {
+                    "name": "admin";
+                    "docs": [
+                        "Admin authority"
+                    ];
+                    "signer": true;
+                },
+                {
+                    "name": "deal";
+                    "docs": [
+                        "Deal account to update"
+                    ];
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    100,
+                                    101,
+                                    97,
+                                    108
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "deal.owner";
+                                "account": "deal";
+                            }
+                        ];
+                    };
+                },
+                {
+                    "name": "cashbackConfig";
+                    "docs": [
+                        "Cashback configuration for admin auth check"
+                    ];
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    99,
+                                    97,
+                                    115,
+                                    104,
+                                    98,
+                                    97,
+                                    99,
+                                    107,
+                                    95,
+                                    99,
+                                    111,
+                                    110,
+                                    102,
+                                    105,
+                                    103
+                                ];
+                            }
+                        ];
+                    };
+                }
+            ];
+            "args": [
+                {
+                    "name": "newCashbackMultiplierBps";
+                    "type": "u16";
+                }
+            ];
+        }
+    ];
+    "accounts": [
+        {
+            "name": "cashbackConfiguration";
+            "discriminator": [
+                85,
+                221,
+                143,
+                214,
+                41,
+                44,
+                50,
+                22
+            ];
+        },
+        {
+            "name": "deal";
+            "discriminator": [
+                125,
+                223,
+                160,
+                234,
+                71,
+                162,
+                182,
+                219
+            ];
+        },
+        {
+            "name": "globalAmmVolumeAccumulator";
+            "discriminator": [
+                248,
+                251,
+                192,
+                145,
+                91,
+                181,
+                97,
+                143
+            ];
+        },
+        {
+            "name": "globalCurveVolumeAccumulator";
+            "discriminator": [
+                50,
+                23,
+                212,
+                197,
+                184,
+                191,
+                247,
+                112
+            ];
+        },
+        {
+            "name": "tokenVolumeAccumulator";
+            "discriminator": [
+                255,
+                176,
+                53,
+                212,
+                121,
+                72,
+                64,
+                57
+            ];
+        },
+        {
+            "name": "userProperties";
+            "discriminator": [
+                131,
+                46,
+                56,
+                35,
+                119,
+                24,
+                76,
+                66
+            ];
+        },
+        {
+            "name": "userSnapshot";
+            "discriminator": [
+                231,
+                197,
+                40,
+                190,
+                124,
+                25,
+                79,
+                69
+            ];
+        }
+    ];
+    "events": [
+        {
+            "name": "cashbackEarned";
+            "discriminator": [
+                155,
+                249,
+                239,
+                242,
+                185,
+                127,
+                22,
+                119
+            ];
+        },
+        {
+            "name": "cashbackModeActivated";
+            "discriminator": [
+                13,
+                108,
+                47,
+                10,
+                122,
+                178,
+                164,
+                85
+            ];
+        },
+        {
+            "name": "cashbackSpent";
+            "discriminator": [
+                156,
+                24,
+                238,
+                167,
+                220,
+                210,
+                21,
+                20
+            ];
+        },
+        {
+            "name": "dealClosed";
+            "discriminator": [
+                38,
+                112,
+                214,
+                184,
+                107,
+                76,
+                191,
+                175
+            ];
+        },
+        {
+            "name": "dealCreated";
+            "discriminator": [
+                27,
+                18,
+                50,
+                52,
+                104,
+                175,
+                46,
+                101
+            ];
+        },
+        {
+            "name": "dealRedeemed";
+            "discriminator": [
+                35,
+                142,
+                162,
+                52,
+                90,
+                78,
+                73,
+                244
+            ];
+        },
+        {
+            "name": "dealUpdated";
+            "discriminator": [
+                70,
+                193,
+                60,
+                16,
+                193,
+                180,
+                47,
+                185
+            ];
+        },
+        {
+            "name": "referrerSet";
+            "discriminator": [
+                65,
+                187,
+                29,
+                205,
+                116,
+                229,
+                69,
+                154
+            ];
+        },
+        {
+            "name": "snapshotTaken";
+            "discriminator": [
+                113,
+                204,
+                151,
+                224,
+                2,
+                128,
+                237,
+                207
+            ];
+        },
+        {
+            "name": "userUpdatedByAdmin";
+            "discriminator": [
+                126,
+                237,
+                223,
+                192,
+                136,
+                250,
+                205,
+                15
+            ];
+        }
+    ];
+    "errors": [
+        {
+            "code": 6000;
+            "name": "arithmeticOverflow";
+            "msg": "Arithmetic operation resulted in overflow";
+        },
+        {
+            "code": 6001;
+            "name": "alreadySpending";
+            "msg": "User is already in spending mode";
+        },
+        {
+            "code": 6002;
+            "name": "noCashbackCredits";
+            "msg": "User has no cashback credits to activate";
+        },
+        {
+            "code": 6003;
+            "name": "invalidCashbackConfiguration";
+            "msg": "Invalid cashback configuration: ranges must be contiguous and sum to proper coverage";
+        },
+        {
+            "code": 6004;
+            "name": "tooManyCashbackRanges";
+            "msg": "Too many cashback ranges (maximum 10)";
+        },
+        {
+            "code": 6005;
+            "name": "referrerCannotBeSelf";
+            "msg": "Referrer cannot be the user themselves";
+        },
+        {
+            "code": 6006;
+            "name": "referrerAlreadySet";
+            "msg": "Referrer has already been set";
+        },
+        {
+            "code": 6007;
+            "name": "unauthorizedCaller";
+            "msg": "Caller is not an authorized program (must be liquid or liquid-swap)";
+        },
+        {
+            "code": 6008;
+            "name": "referrerNotSet";
+            "msg": "User does not have a referrer set";
+        },
+        {
+            "code": 6009;
+            "name": "dealReferrerMismatch";
+            "msg": "Deal does not belong to the user's referrer";
+        },
+        {
+            "code": 6010;
+            "name": "invalidMultiplier";
+            "msg": "Invalid cashback multiplier value";
+        },
+        {
+            "code": 6011;
+            "name": "invalidAdminAuthority";
+            "msg": "The provided admin authority is invalid";
+        },
+        {
+            "code": 6012;
+            "name": "noPendingAdminTransfer";
+            "msg": "No pending admin transfer exists";
+        },
+        {
+            "code": 6013;
+            "name": "notPendingAdmin";
+            "msg": "Caller is not the pending admin";
+        }
+    ];
+    "types": [
+        {
+            "name": "adminUpdateUserArgs";
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "newReferrer";
+                        "docs": [
+                            "New referrer pubkey (if changing). Clears deal + resets multiplier."
+                        ];
+                        "type": {
+                            "option": "pubkey";
+                        };
+                    },
+                    {
+                        "name": "newCashbackMultiplierBps";
+                        "docs": [
+                            "New cashback multiplier in BPS (if overriding). Requires referrer to exist."
+                        ];
+                        "type": {
+                            "option": "u16";
+                        };
+                    }
+                ];
+            };
+        },
+        {
+            "name": "cashbackConfiguration";
+            "docs": [
+                "Global cashback configuration",
+                "",
+                "PDA: [b\"cashback_config\"]"
+            ];
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "adminAuthority";
+                        "docs": [
+                            "Admin authority who can update configuration"
+                        ];
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "ranges";
+                        "docs": [
+                            "Volume-based multiplier ranges (use len() for active count)"
+                        ];
+                        "type": {
+                            "vec": {
+                                "defined": {
+                                    "name": "cashbackRange";
+                                };
+                            };
+                        };
+                    },
+                    {
+                        "name": "traderCashbackBasisPoints";
+                        "docs": [
+                            "Base trader cashback rate in basis points"
+                        ];
+                        "type": "u16";
+                    },
+                    {
+                        "name": "pendingAdmin";
+                        "docs": [
+                            "Pending admin authority for two-step transfer. None if no transfer is in progress."
+                        ];
+                        "type": {
+                            "option": "pubkey";
+                        };
+                    }
+                ];
+            };
+        },
+        {
+            "name": "cashbackEarned";
+            "docs": [
+                "Event emitted when a user earns cashback credits."
+            ];
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "user";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "amount";
+                        "type": "u64";
+                    },
+                    {
+                        "name": "newBalance";
+                        "type": "u64";
+                    },
+                    {
+                        "name": "timestamp";
+                        "type": "i64";
+                    }
+                ];
+            };
+        },
+        {
+            "name": "cashbackModeActivated";
+            "docs": [
+                "Event emitted when a user activates cashback spending mode."
+            ];
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "user";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "multiplierBps";
+                        "type": "u16";
+                    },
+                    {
+                        "name": "timestamp";
+                        "type": "i64";
+                    }
+                ];
+            };
+        },
+        {
+            "name": "cashbackRange";
+            "docs": [
+                "Cashback range defining volume-based multiplier tiers"
+            ];
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "rangeStartInclusive";
+                        "docs": [
+                            "Lower bound of volume range (inclusive)"
+                        ];
+                        "type": "u64";
+                    },
+                    {
+                        "name": "rangeEndExclusive";
+                        "docs": [
+                            "Upper bound of volume range (exclusive)"
+                        ];
+                        "type": "u64";
+                    },
+                    {
+                        "name": "multiplierBasisPoints";
+                        "docs": [
+                            "Multiplier in basis points (10000 = 1x, 20000 = 2x)"
+                        ];
+                        "type": "u16";
+                    }
+                ];
+            };
+        },
+        {
+            "name": "cashbackSpent";
+            "docs": [
+                "Event emitted when a user spends cashback credits."
+            ];
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "user";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "amount";
+                        "type": "u64";
+                    },
+                    {
+                        "name": "remainingBalance";
+                        "type": "u64";
+                    },
+                    {
+                        "name": "timestamp";
+                        "type": "i64";
+                    }
+                ];
+            };
+        },
+        {
+            "name": "deal";
+            "docs": [
+                "Exclusive deal created by admin for a specific pubkey (typically a referrer/influencer).",
+                "Users who are referred by this pubkey can redeem the deal to get a higher cashback multiplier.",
+                "",
+                "PDA: [b\"deal\", owner.key()]"
+            ];
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "owner";
+                        "docs": [
+                            "The pubkey this deal belongs to (typically a referrer/influencer)"
+                        ];
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "cashbackMultiplierBps";
+                        "docs": [
+                            "Cashback multiplier in basis points (10000 = 1x, 15000 = 1.5x, etc.)"
+                        ];
+                        "type": "u16";
+                    },
+                    {
+                        "name": "redemptionCount";
+                        "docs": [
+                            "Number of unique users who have redeemed this deal"
+                        ];
+                        "type": "u32";
+                    }
+                ];
+            };
+        },
+        {
+            "name": "dealClosed";
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "owner";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "redemptionCount";
+                        "type": "u32";
+                    },
+                    {
+                        "name": "timestamp";
+                        "type": "i64";
+                    }
+                ];
+            };
+        },
+        {
+            "name": "dealCreated";
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "owner";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "cashbackMultiplierBps";
+                        "type": "u16";
+                    },
+                    {
+                        "name": "timestamp";
+                        "type": "i64";
+                    }
+                ];
+            };
+        },
+        {
+            "name": "dealRedeemed";
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "user";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "dealOwner";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "cashbackMultiplierBps";
+                        "type": "u16";
+                    },
+                    {
+                        "name": "timestamp";
+                        "type": "i64";
+                    }
+                ];
+            };
+        },
+        {
+            "name": "dealUpdated";
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "owner";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "oldMultiplierBps";
+                        "type": "u16";
+                    },
+                    {
+                        "name": "newMultiplierBps";
+                        "type": "u16";
+                    },
+                    {
+                        "name": "timestamp";
+                        "type": "i64";
+                    }
+                ];
+            };
+        },
+        {
+            "name": "globalAmmVolumeAccumulator";
+            "docs": [
+                "Global volume accumulator for AMM trades",
+                "",
+                "PDA: [b\"global_amm_volume\"]"
+            ];
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "totalSolVolume";
+                        "docs": [
+                            "Total SOL volume across all AMM trades"
+                        ];
+                        "type": "u128";
+                    },
+                    {
+                        "name": "totalTokenVolume";
+                        "docs": [
+                            "Total token volume across all AMM trades"
+                        ];
+                        "type": "u128";
+                    }
+                ];
+            };
+        },
+        {
+            "name": "globalCurveVolumeAccumulator";
+            "docs": [
+                "Global volume accumulator for bonding curve trades",
+                "",
+                "PDA: [b\"global_curve_volume\"]"
+            ];
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "totalSolVolume";
+                        "docs": [
+                            "Total SOL volume across all curve trades"
+                        ];
+                        "type": "u128";
+                    },
+                    {
+                        "name": "totalTokenVolume";
+                        "docs": [
+                            "Total token volume across all curve trades"
+                        ];
+                        "type": "u128";
+                    }
+                ];
+            };
+        },
+        {
+            "name": "initializeConfigArgs";
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "adminAuthority";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "ranges";
+                        "type": {
+                            "vec": {
+                                "defined": {
+                                    "name": "cashbackRange";
+                                };
+                            };
+                        };
+                    },
+                    {
+                        "name": "traderCashbackBasisPoints";
+                        "type": "u16";
+                    }
+                ];
+            };
+        },
+        {
+            "name": "referrerInfo";
+            "docs": [
+                "Referrer information attached to a user"
+            ];
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "referrer";
+                        "docs": [
+                            "The referrer's public key"
+                        ];
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "deal";
+                        "docs": [
+                            "Deal PDA the user redeemed (None if no deal redeemed)"
+                        ];
+                        "type": {
+                            "option": "pubkey";
+                        };
+                    },
+                    {
+                        "name": "cashbackMultiplierBps";
+                        "docs": [
+                            "Cashback multiplier in basis points (10000 = 1x, default)"
+                        ];
+                        "type": "u16";
+                    }
+                ];
+            };
+        },
+        {
+            "name": "referrerSet";
+            "docs": [
+                "Event emitted when a user sets their referrer."
+            ];
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "user";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "referrer";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "timestamp";
+                        "type": "i64";
+                    }
+                ];
+            };
+        },
+        {
+            "name": "snapshotTaken";
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "user";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "index";
+                        "type": "u32";
+                    },
+                    {
+                        "name": "solVolume";
+                        "type": "u128";
+                    },
+                    {
+                        "name": "tokenVolume";
+                        "type": "u128";
+                    },
+                    {
+                        "name": "timestamp";
+                        "type": "i64";
+                    }
+                ];
+            };
+        },
+        {
+            "name": "spendCashbackResult";
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "spent";
+                        "type": "u64";
+                    }
+                ];
+            };
+        },
+        {
+            "name": "tokenVolumeAccumulator";
+            "docs": [
+                "Token-specific volume accumulator (unified across curve and AMM)",
+                "",
+                "PDA: [b\"token_volume\", mint.key()]"
+            ];
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "mint";
+                        "docs": [
+                            "Token mint this accumulator tracks"
+                        ];
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "totalSolVolume";
+                        "docs": [
+                            "Total SOL volume for this token (curve + AMM)"
+                        ];
+                        "type": "u128";
+                    },
+                    {
+                        "name": "totalTokenVolume";
+                        "docs": [
+                            "Total token volume for this token (curve + AMM)"
+                        ];
+                        "type": "u128";
+                    },
+                    {
+                        "name": "curveSolVolume";
+                        "docs": [
+                            "SOL volume from curve trades (for analytics)"
+                        ];
+                        "type": "u128";
+                    },
+                    {
+                        "name": "ammSolVolume";
+                        "docs": [
+                            "SOL volume from AMM trades (for analytics)"
+                        ];
+                        "type": "u128";
+                    }
+                ];
+            };
+        },
+        {
+            "name": "updateConfigArgs";
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "newRanges";
+                        "type": {
+                            "option": {
+                                "vec": {
+                                    "defined": {
+                                        "name": "cashbackRange";
+                                    };
+                                };
+                            };
+                        };
+                    },
+                    {
+                        "name": "newTraderCashbackBasisPoints";
+                        "type": {
+                            "option": "u16";
+                        };
+                    }
+                ];
+            };
+        },
+        {
+            "name": "userProperties";
+            "docs": [
+                "User properties account tracking referrals, volumes, cashback, and snapshots",
+                "",
+                "PDA: [b\"user_properties\", user.key()]"
+            ];
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "referrer";
+                        "docs": [
+                            "Referrer info (pubkey, deal, multiplier)"
+                        ];
+                        "type": {
+                            "option": {
+                                "defined": {
+                                    "name": "referrerInfo";
+                                };
+                            };
+                        };
+                    },
+                    {
+                        "name": "totalSolVolume";
+                        "docs": [
+                            "Total SOL volume traded across both curve and AMM (used for cashback multiplier)"
+                        ];
+                        "type": "u128";
+                    },
+                    {
+                        "name": "totalTokenVolume";
+                        "docs": [
+                            "Total token volume traded across both curve and AMM"
+                        ];
+                        "type": "u128";
+                    },
+                    {
+                        "name": "cashbackCredits";
+                        "docs": [
+                            "Cashback credits (abstract credits when earning, SOL lamports when spending)"
+                        ];
+                        "type": "u64";
+                    },
+                    {
+                        "name": "isSpending";
+                        "docs": [
+                            "Whether user is in spending mode (true) or earning mode (false)"
+                        ];
+                        "type": "bool";
+                    },
+                    {
+                        "name": "curveSolVolume";
+                        "docs": [
+                            "SOL volume from curve trades only (for analytics)"
+                        ];
+                        "type": "u128";
+                    },
+                    {
+                        "name": "ammSolVolume";
+                        "docs": [
+                            "SOL volume from AMM trades only (for analytics)"
+                        ];
+                        "type": "u128";
+                    },
+                    {
+                        "name": "snapshotSolVolume";
+                        "docs": [
+                            "SOL volume accumulated since the last snapshot (resets on snapshot)"
+                        ];
+                        "type": "u128";
+                    },
+                    {
+                        "name": "snapshotTokenVolume";
+                        "docs": [
+                            "Token volume accumulated since the last snapshot (resets on snapshot)"
+                        ];
+                        "type": "u128";
+                    },
+                    {
+                        "name": "snapshotCount";
+                        "docs": [
+                            "Number of snapshots taken for this user"
+                        ];
+                        "type": "u32";
+                    },
+                    {
+                        "name": "latestSnapshot";
+                        "docs": [
+                            "PDA of the latest snapshot (head of linked list, None if no snapshots)"
+                        ];
+                        "type": {
+                            "option": "pubkey";
+                        };
+                    }
+                ];
+            };
+        },
+        {
+            "name": "userSnapshot";
+            "docs": [
+                "Snapshot of a user's volume since the previous snapshot.",
+                "Connected in a linked list via `prev_snapshot`.",
+                "",
+                "PDA: [b\"user_snapshot\", user.key(), index.to_le_bytes()]"
+            ];
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "user";
+                        "docs": [
+                            "The user this snapshot belongs to"
+                        ];
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "index";
+                        "docs": [
+                            "Sequential snapshot index (0-based)"
+                        ];
+                        "type": "u32";
+                    },
+                    {
+                        "name": "prevSnapshot";
+                        "docs": [
+                            "Previous snapshot PDA (None for the first snapshot)"
+                        ];
+                        "type": {
+                            "option": "pubkey";
+                        };
+                    },
+                    {
+                        "name": "solVolume";
+                        "docs": [
+                            "SOL volume accumulated during this snapshot period"
+                        ];
+                        "type": "u128";
+                    },
+                    {
+                        "name": "tokenVolume";
+                        "docs": [
+                            "Token volume accumulated during this snapshot period"
+                        ];
+                        "type": "u128";
+                    },
+                    {
+                        "name": "createdAt";
+                        "docs": [
+                            "Unix timestamp when the snapshot was taken"
+                        ];
+                        "type": "i64";
+                    }
+                ];
+            };
+        },
+        {
+            "name": "userUpdatedByAdmin";
+            "type": {
+                "kind": "struct";
+                "fields": [
+                    {
+                        "name": "user";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "admin";
+                        "type": "pubkey";
+                    },
+                    {
+                        "name": "snapshotIndex";
+                        "type": "u32";
+                    },
+                    {
+                        "name": "timestamp";
+                        "type": "i64";
+                    }
+                ];
+            };
+        }
+    ];
+};
+//# sourceMappingURL=liquid_state.d.ts.map