@coffer_so/sdk 1.0.0

package/dist/idl/cubic_pool.json

@@ -0,0 +1,4203 @@
+{
+    "address": "8iQtGj9mcUfFUGaiCpPy89swC3s8YTC8FhVZWfgeZhwu",
+    "metadata": {
+        "name": "cubic_pool",
+        "version": "0.5.1",
+        "spec": "0.1.0",
+        "description": "Cubic Pool DEX - Multi-pool DEX with virtual liquidity and leverage logic"
+    },
+    "instructions": [
+        {
+            "name": "accept_pool_admin_transfer",
+            "docs": [
+                "Step 2 — pending admin claims."
+            ],
+            "discriminator": [
+                155,
+                46,
+                127,
+                94,
+                247,
+                5,
+                46,
+                184
+            ],
+            "accounts": [
+                {
+                    "name": "pool",
+                    "writable": true
+                },
+                {
+                    "name": "new_admin",
+                    "signer": true
+                }
+            ],
+            "args": []
+        },
+        {
+            "name": "accept_protocol_admin_transfer",
+            "docs": [
+                "Step 2 — pending admin claims."
+            ],
+            "discriminator": [
+                109,
+                70,
+                85,
+                195,
+                244,
+                39,
+                244,
+                102
+            ],
+            "accounts": [
+                {
+                    "name": "config",
+                    "writable": true
+                },
+                {
+                    "name": "new_admin",
+                    "signer": true
+                }
+            ],
+            "args": []
+        },
+        {
+            "name": "add_liquidity",
+            "docs": [
+                "Add proportional liquidity and mint BPT to the user.",
+                "",
+                "# Parameters",
+                "* `token_amounts`     — per-token deposit amounts in pool order.",
+                "* `minimum_bpt_amount`— slippage floor on BPT received.",
+                "",
+                "# Used by",
+                "User wallets, single-token-liquidity helper."
+            ],
+            "discriminator": [
+                181,
+                157,
+                89,
+                67,
+                143,
+                182,
+                52,
+                72
+            ],
+            "accounts": [
+                {
+                    "name": "pool",
+                    "writable": true
+                },
+                {
+                    "name": "bpt_mint",
+                    "writable": true
+                },
+                {
+                    "name": "user_bpt_account",
+                    "writable": true
+                },
+                {
+                    "name": "user",
+                    "signer": true
+                },
+                {
+                    "name": "token_program",
+                    "docs": [
+                        "Token program for the BPT mint (same one used for `bpt_mint`).",
+                        "Per-token programs come via `remaining_accounts` because each",
+                        "pool token may use a different program."
+                    ]
+                }
+            ],
+            "args": [
+                {
+                    "name": "token_amounts",
+                    "type": {
+                        "vec": "u64"
+                    }
+                },
+                {
+                    "name": "minimum_bpt_amount",
+                    "type": "u64"
+                }
+            ]
+        },
+        {
+            "name": "cancel_pool_admin_transfer",
+            "docs": [
+                "Cancel a pending pool-admin transfer."
+            ],
+            "discriminator": [
+                151,
+                135,
+                205,
+                125,
+                93,
+                160,
+                135,
+                143
+            ],
+            "accounts": [
+                {
+                    "name": "pool",
+                    "writable": true
+                },
+                {
+                    "name": "authority",
+                    "signer": true
+                }
+            ],
+            "args": []
+        },
+        {
+            "name": "cancel_protocol_admin_transfer",
+            "docs": [
+                "Cancel a pending protocol-admin transfer."
+            ],
+            "discriminator": [
+                183,
+                26,
+                130,
+                6,
+                131,
+                36,
+                32,
+                186
+            ],
+            "accounts": [
+                {
+                    "name": "config",
+                    "writable": true
+                },
+                {
+                    "name": "authority",
+                    "signer": true
+                }
+            ],
+            "args": []
+        },
+        {
+            "name": "collect_protocol_fees",
+            "docs": [
+                "Sweep `protocol_fees_owed` for every token to caller-supplied",
+                "recipients and zero the counters.",
+                "",
+                "# Authority",
+                "`protocol_admin` AND Treasury PDA.",
+                "",
+                "# remaining_accounts",
+                "`[vault_i, recipient_i, token_program_i]` per token.",
+                "",
+                "# Used by",
+                "`protocol_admin::pool_collect_protocol_fees` (CPI)."
+            ],
+            "discriminator": [
+                22,
+                67,
+                23,
+                98,
+                150,
+                178,
+                70,
+                220
+            ],
+            "accounts": [
+                {
+                    "name": "config"
+                },
+                {
+                    "name": "pool",
+                    "writable": true
+                },
+                {
+                    "name": "authority",
+                    "signer": true
+                }
+            ],
+            "args": []
+        },
+        {
+            "name": "debug_withdraw_liquidity",
+            "docs": [
+                "Emergency drain — pool becomes BRICKED.",
+                "",
+                "`actual_balances` and `virtual_balances` are intentionally NOT",
+                "updated. Once vaults are drained out-of-band the invariant math",
+                "is meaningless, so the pool MUST stay `pool_enabled = false`",
+                "forever. Re-enabling would let users swap/join against stale",
+                "state and extract value at LP / protocol expense.",
+                "",
+                "# Authority",
+                "`protocol_admin` AND Treasury PDA.",
+                "",
+                "# Prerequisites",
+                "`pool.pool_enabled == false` (handler enforces).",
+                "",
+                "# Parameters",
+                "* `token_amounts` — per-token withdraw amounts (use 0 to skip).",
+                "",
+                "# Used by",
+                "`protocol_admin::pool_debug_withdraw_liquidity` (CPI),",
+                "driven by `admin-panel/03-emergency-withdraw.ts`."
+            ],
+            "discriminator": [
+                139,
+                40,
+                126,
+                103,
+                199,
+                34,
+                143,
+                137
+            ],
+            "accounts": [
+                {
+                    "name": "config"
+                },
+                {
+                    "name": "pool",
+                    "writable": true
+                },
+                {
+                    "name": "authority",
+                    "signer": true
+                }
+            ],
+            "args": [
+                {
+                    "name": "token_amounts",
+                    "type": {
+                        "vec": "u64"
+                    }
+                }
+            ]
+        },
+        {
+            "name": "disable_pool_admin",
+            "docs": [
+                "Permanently renounce pool-admin on this pool. Single-step,",
+                "irreversible."
+            ],
+            "discriminator": [
+                106,
+                106,
+                112,
+                255,
+                92,
+                31,
+                2,
+                138
+            ],
+            "accounts": [
+                {
+                    "name": "pool",
+                    "writable": true
+                },
+                {
+                    "name": "authority",
+                    "signer": true
+                }
+            ],
+            "args": []
+        },
+        {
+            "name": "get_pool_info",
+            "docs": [
+                "Read-only \"view\": emit a `PoolInfo` event with the pool's full",
+                "state. Intended for `simulate({ commitment: ... })` calls; not",
+                "useful as part of a signed transaction.",
+                "",
+                "# Used by",
+                "SDK helpers, frontend pool-detail pages, indexer health-check",
+                "fallback."
+            ],
+            "discriminator": [
+                9,
+                48,
+                220,
+                101,
+                22,
+                240,
+                78,
+                200
+            ],
+            "accounts": [
+                {
+                    "name": "pool"
+                }
+            ],
+            "args": []
+        },
+        {
+            "name": "initialize_config",
+            "docs": [
+                "Initialise a new `CubicPoolConfig`. Treasury wrapper passes the",
+                "Treasury PDA as both admin pubkeys; direct calls produce",
+                "Initialise a fresh `CubicPoolConfig`.",
+                "",
+                "# Parameters",
+                "* `protocol_admin`           — pubkey allowed to pause pools, set",
+                "`protocol_fee_rate`, collect fees, drain via debug-withdraw,",
+                "update banned extensions, and rotate itself via the",
+                "pending/accept flow.",
+                "* `default_protocol_fee_rate`— seeded onto every new pool under",
+                "this config (basis points, ≤ `MAX_PROTOCOL_FEE_RATE`).",
+                "",
+                "Pool-admin (level-1) is per-pool — set automatically to the wallet",
+                "that calls `initialize_cubic_pool`."
+            ],
+            "discriminator": [
+                208,
+                127,
+                21,
+                1,
+                194,
+                190,
+                196,
+                70
+            ],
+            "accounts": [
+                {
+                    "name": "config",
+                    "writable": true,
+                    "signer": true
+                },
+                {
+                    "name": "protocol_admin_treasury",
+                    "docs": [
+                        "Treasury PDA of the protocol-admin program. Validated two ways:",
+                        "the `seeds` + `seeds::program` constraint pins *which* account this",
+                        "must be, and the `Signer` type proves the call came through",
+                        "protocol-admin's admin-gated CPI (only that program can",
+                        "`invoke_signed` these seeds).",
+                        "",
+                        "The type must be `Signer` rather than an `UncheckedAccount` with an",
+                        "`is_signer` constraint: Anchor derives CPI account metas from the",
+                        "field TYPE, so an `UncheckedAccount` here would be emitted with",
+                        "`is_signer: false` and the caller's `invoke_signed` signature would",
+                        "never reach this program."
+                    ],
+                    "signer": true
+                },
+                {
+                    "name": "payer",
+                    "docs": [
+                        "Pays the rent for `config`. Must be a `Signer`."
+                    ],
+                    "writable": true,
+                    "signer": true
+                },
+                {
+                    "name": "system_program"
+                }
+            ],
+            "args": [
+                {
+                    "name": "default_protocol_fee_rate",
+                    "type": "u16"
+                }
+            ]
+        },
+        {
+            "name": "initialize_cubic_pool",
+            "docs": [
+                "Initialise a fresh pool under `config`. Creates the pool PDA and",
+                "BPT mint, validates token mints / weights / virtual balances, and",
+                "pins per-token programs.",
+                "",
+                "The pool's token set is the `remaining_accounts` list — one mint per",
+                "token, in the same order as the weights. There is no `tokens` argument:",
+                "it duplicated those accounts exactly and cost 324 bytes at 10 tokens,",
+                "which alone pushed a 10-token deploy past the transaction size limit.",
+                "",
+                "# Parameters",
+                "* `normalized_weights`       — basis points, sum = `WEIGHT_SCALE`.",
+                "* `initial_virtual_balances` — seed virtual balances (raw units),",
+                "each > 0.",
+                "* `swap_fee_rate`            — hundredths of bps,",
+                "≤ `MAX_SWAP_FEE_RATE`.",
+                "* `pool_id`                  — caller-chosen 64-bit salt baked",
+                "into PDA seeds. Unique per config.",
+                "",
+                "# remaining_accounts",
+                "One mint account per token in `tokens` order.",
+                "",
+                "# Used by",
+                "SDK `PoolFactoryClient.buildDeployPoolTx`, deploy-pool scripts."
+            ],
+            "discriminator": [
+                215,
+                148,
+                116,
+                207,
+                121,
+                104,
+                111,
+                131
+            ],
+            "accounts": [
+                {
+                    "name": "config",
+                    "docs": [
+                        "Parent governance config. Read-only — only its pubkey and the",
+                        "`default_protocol_fee_rate` / `banned_extensions` are consumed."
+                    ]
+                },
+                {
+                    "name": "pool",
+                    "docs": [
+                        "New pool PDA. Seeded so multiple pools per config are possible",
+                        "via distinct `pool_id` values."
+                    ],
+                    "writable": true
+                },
+                {
+                    "name": "bpt_mint",
+                    "docs": [
+                        "Brand-new BPT mint. Authority is the pool PDA, decimals fixed at",
+                        "`BPT_DECIMALS` (= 9). `mint::token_program` follows the",
+                        "`token_program` account passed below — this only constrains BPT,",
+                        "not the per-pool tokens."
+                    ],
+                    "writable": true
+                },
+                {
+                    "name": "payer",
+                    "writable": true,
+                    "signer": true
+                },
+                {
+                    "name": "token_program"
+                },
+                {
+                    "name": "associated_token_program"
+                },
+                {
+                    "name": "system_program"
+                }
+            ],
+            "args": [
+                {
+                    "name": "normalized_weights",
+                    "type": {
+                        "vec": "u64"
+                    }
+                },
+                {
+                    "name": "initial_virtual_balances",
+                    "type": {
+                        "vec": "u64"
+                    }
+                },
+                {
+                    "name": "swap_fee_rate",
+                    "type": "u32"
+                },
+                {
+                    "name": "pool_id",
+                    "type": "u64"
+                },
+                {
+                    "name": "banned_extensions_override",
+                    "type": {
+                        "option": "u64"
+                    }
+                }
+            ]
+        },
+        {
+            "name": "initialize_pool_alt",
+            "docs": [
+                "Provision a per-pool Address Lookup Table so client SDKs can build",
+                "`VersionedTransaction`s for `add_liquidity` / `remove_liquidity` on",
+                "pools whose account count exceeds the legacy 1232-byte ceiling",
+                "(≥ 7 tokens in practice).",
+                "",
+                "# Parameters",
+                "* `recent_slot` — recent slot used by the ALT program to derive",
+                "the table address. Caller should pass",
+                "`connection.getSlot('finalized')`.",
+                "",
+                "# Flow",
+                "One transaction performs three CPIs into the ALT program:",
+                "`create_lookup_table` → `extend_lookup_table` (pool, BPT mint,",
+                "vaults, mints, standard programs) → `freeze_lookup_table`.",
+                "The ALT becomes immutable forever — its rent (~0.005 SOL for a",
+                "7-token pool) is permanently locked.",
+                "",
+                "# Authority",
+                "`pool.pool_admin`. Idempotent: rejects with `AltAlreadyInitialized`",
+                "if `pool.lookup_table != Pubkey::default()`.",
+                "",
+                "# Used by",
+                "`scripts/cli/initialize-pool-alts.ts` (one-shot bootstrap for",
+                "existing prod pools), and `sdk` after `initialize_cubic_pool` on",
+                "fresh pools."
+            ],
+            "discriminator": [
+                251,
+                135,
+                66,
+                2,
+                244,
+                73,
+                12,
+                144
+            ],
+            "accounts": [
+                {
+                    "name": "pool",
+                    "docs": [
+                        "Pool to provision the ALT for. Must have `lookup_table ==",
+                        "Pubkey::default()`. The handler writes the new ALT address back",
+                        "onto this account."
+                    ],
+                    "writable": true
+                },
+                {
+                    "name": "config",
+                    "docs": [
+                        "`CubicPoolConfig` this pool inherits governance from. Pinned via",
+                        "`pool.config`. Reading it lets the handler also accept",
+                        "`config.protocol_admin` as an authority — which is the Treasury",
+                        "PDA, only signable through `protocol_admin.pool_initialize_alt`."
+                    ]
+                },
+                {
+                    "name": "authority",
+                    "docs": [
+                        "Authority. Must equal either `pool.pool_admin` (per-pool owner",
+                        "path) or `config.protocol_admin` (Treasury PDA via the",
+                        "protocol-admin CPI wrapper). Authorises the ALT creation; the",
+                        "derived ALT address is `[authority, recent_slot]`."
+                    ],
+                    "signer": true
+                },
+                {
+                    "name": "payer",
+                    "docs": [
+                        "Payer for ALT rent + per-extend top-ups. Decoupled from",
+                        "`authority` because Treasury PDA (the wrapper-path authority)",
+                        "owns data and so cannot be `from` in `system_program::transfer`.",
+                        "In the pool-admin path callers pass the same key for both — no",
+                        "behavioural change."
+                    ],
+                    "writable": true,
+                    "signer": true
+                },
+                {
+                    "name": "lookup_table",
+                    "docs": [
+                        "`[authority, recent_slot]` by the ALT program. Re-derived and",
+                        "matched against this account in the handler."
+                    ],
+                    "writable": true
+                },
+                {
+                    "name": "system_program"
+                },
+                {
+                    "name": "alt_program",
+                    "docs": [
+                        "`solana_address_lookup_table_interface::id()` in the handler."
+                    ]
+                }
+            ],
+            "args": [
+                {
+                    "name": "recent_slot",
+                    "type": "u64"
+                }
+            ]
+        },
+        {
+            "name": "initiate_pool_admin_transfer",
+            "docs": [
+                "Step 1 — current `pool.pool_admin` proposes a successor."
+            ],
+            "discriminator": [
+                10,
+                148,
+                147,
+                98,
+                73,
+                190,
+                31,
+                43
+            ],
+            "accounts": [
+                {
+                    "name": "pool",
+                    "writable": true
+                },
+                {
+                    "name": "authority",
+                    "signer": true
+                }
+            ],
+            "args": [
+                {
+                    "name": "new_admin",
+                    "type": "pubkey"
+                }
+            ]
+        },
+        {
+            "name": "initiate_protocol_admin_transfer",
+            "docs": [
+                "Step 1 — current `config.protocol_admin` proposes a successor."
+            ],
+            "discriminator": [
+                167,
+                129,
+                39,
+                182,
+                10,
+                106,
+                51,
+                148
+            ],
+            "accounts": [
+                {
+                    "name": "config",
+                    "writable": true
+                },
+                {
+                    "name": "authority",
+                    "signer": true
+                }
+            ],
+            "args": [
+                {
+                    "name": "new_admin",
+                    "type": "pubkey"
+                }
+            ]
+        },
+        {
+            "name": "migrate_to_v5",
+            "docs": [
+                "Pool storage migration entrypoint for the v4 → v5 layout change.",
+                "",
+                "**This instruction mutates state — it is not a no-op.** It backfills",
+                "`pool.banned_extensions` from the parent config when the pool still",
+                "reads `0` (the zeroed pre-upgrade `reserved` bytes), and, when",
+                "`reactivate_tokens` is set, flips every token's `is_active` back to",
+                "`true`.",
+                "",
+                "# Parameters",
+                "* `reactivate_tokens` — pass `true` ONLY on the one-shot v4 → v5 pass,",
+                "where `is_active` decodes as `false` because it lands on the old",
+                "zeroed `reserved` byte. Pass `false` on every later call: `true`",
+                "would silently re-open every token an admin deliberately disabled",
+                "with `set_token_active(i, false)`.",
+                "",
+                "# Authority",
+                "`pool.pool_admin` OR `config.protocol_admin`, neither being the",
+                "default key.",
+                "",
+                "Idempotent in both directions — a second run backfills nothing and",
+                "reactivates nothing."
+            ],
+            "discriminator": [
+                127,
+                60,
+                135,
+                204,
+                181,
+                90,
+                202,
+                249
+            ],
+            "accounts": [
+                {
+                    "name": "pool",
+                    "writable": true
+                },
+                {
+                    "name": "config",
+                    "docs": [
+                        "Parent config — authorises via `protocol_admin` and supplies the",
+                        "`banned_extensions` bitmap the migration backfills onto the pool."
+                    ]
+                },
+                {
+                    "name": "authority",
+                    "signer": true
+                },
+                {
+                    "name": "system_program"
+                }
+            ],
+            "args": [
+                {
+                    "name": "reactivate_tokens",
+                    "type": "bool"
+                }
+            ]
+        },
+        {
+            "name": "range_manager_update",
+            "docs": [
+                "Tweak any subset of `virtual_balances` and / or `normalized_weights`",
+                "within the configured envelope. Range-manager only.",
+                "",
+                "# Parameters",
+                "* `vb_changes`     — sparse `[(index, new_vb)]`; may be empty.",
+                "* `weight_changes` — sparse `[(index, new_weight_bps)]`; may be",
+                "empty. The resulting weight vector must sum to `WEIGHT_SCALE`",
+                "and stay within `[MIN_WEIGHT, MAX_WEIGHT]` per token, otherwise",
+                "the whole instruction reverts."
+            ],
+            "discriminator": [
+                245,
+                183,
+                35,
+                69,
+                200,
+                10,
+                172,
+                44
+            ],
+            "accounts": [
+                {
+                    "name": "pool",
+                    "docs": [
+                        "Mutated — handler writes new virtual_balances / normalized_weights",
+                        "and bumps `range_manager_last_updated`.",
+                        "",
+                        "`pool_enabled` is part of the gate: swaps and liquidity operations",
+                        "honour the kill switch, and a range manager that kept rewriting",
+                        "virtual balances and weights through a protocol-level pause would",
+                        "leave governance with no way to contain a misbehaving one (only the",
+                        "pool admin can un-appoint it)."
+                    ],
+                    "writable": true
+                },
+                {
+                    "name": "authority",
+                    "signer": true
+                }
+            ],
+            "args": [
+                {
+                    "name": "vb_changes",
+                    "type": {
+                        "vec": {
+                            "defined": {
+                                "name": "TokenChange"
+                            }
+                        }
+                    }
+                },
+                {
+                    "name": "weight_changes",
+                    "type": {
+                        "vec": {
+                            "defined": {
+                                "name": "TokenChange"
+                            }
+                        }
+                    }
+                }
+            ]
+        },
+        {
+            "name": "remove_liquidity",
+            "docs": [
+                "Burn BPT proportionally and pay out tokens.",
+                "",
+                "# Minimum-supply floor",
+                "The pool always retains at least `MINIMUM_INITIAL_BPT` of supply",
+                "so the proportional math never sees a zero-supply state. If the",
+                "caller's `bpt_amount` would push supply below the floor, the burn",
+                "is silently capped at `total_supply - MINIMUM_INITIAL_BPT` and",
+                "the residual BPT stays in the user's wallet.",
+                "",
+                "# Parameters",
+                "* `bpt_amount`            — caller's requested burn (raw BPT).",
+                "* `minimum_token_amounts` — per-token slippage floors against the",
+                "*effective* (capped) burn.",
+                "",
+                "# Used by",
+                "User wallets, SDK `LiquidityClient`."
+            ],
+            "discriminator": [
+                80,
+                85,
+                209,
+                72,
+                24,
+                206,
+                177,
+                108
+            ],
+            "accounts": [
+                {
+                    "name": "pool",
+                    "writable": true
+                },
+                {
+                    "name": "bpt_mint",
+                    "writable": true
+                },
+                {
+                    "name": "user_bpt_account",
+                    "writable": true
+                },
+                {
+                    "name": "user",
+                    "signer": true
+                },
+                {
+                    "name": "token_program"
+                }
+            ],
+            "args": [
+                {
+                    "name": "bpt_amount",
+                    "type": "u64"
+                },
+                {
+                    "name": "minimum_token_amounts",
+                    "type": {
+                        "vec": "u64"
+                    }
+                }
+            ]
+        },
+        {
+            "name": "set_banned_extensions",
+            "docs": [
+                "Update the Token-2022 banned-extensions bitmap on a config.",
+                "Only affects future pool inits.",
+                "",
+                "# Authority",
+                "`protocol_admin` AND Treasury PDA.",
+                "",
+                "# Used by",
+                "`protocol_admin::pool_set_banned_extensions` (CPI).",
+                "# Parameters",
+                "* `banned_extensions`      — the DEFAULT a pool creator inherits when",
+                "they pass no override. A creator may loosen it.",
+                "* `hard_banned_extensions` — the FLOOR a creator can never clear,",
+                "OR-ed into every new pool's effective bitmap. This is where",
+                "custody-reaching extensions belong (`PermanentDelegate`,",
+                "`TransferHook`). Governance can lower it to list an issuer whose",
+                "mint legitimately carries one — PYUSD-class stablecoins ship",
+                "`PermanentDelegate` for compliance seizure — which is a deliberate",
+                "decision to trust that issuer with vault custody."
+            ],
+            "discriminator": [
+                86,
+                95,
+                249,
+                149,
+                142,
+                105,
+                100,
+                151
+            ],
+            "accounts": [
+                {
+                    "name": "config",
+                    "writable": true
+                },
+                {
+                    "name": "authority",
+                    "signer": true
+                }
+            ],
+            "args": [
+                {
+                    "name": "banned_extensions",
+                    "type": "u64"
+                },
+                {
+                    "name": "hard_banned_extensions",
+                    "type": "u64"
+                }
+            ]
+        },
+        {
+            "name": "set_max_selloff",
+            "docs": [
+                "Set the per-token sell-off policy — sliding-window cap, period, and",
+                "the variable surge-fee curve — for every active token in one call.",
+                "Pool-admin only.",
+                "",
+                "# Parameters",
+                "* `params` — length == `token_count`, one",
+                "`instructions::set_max_selloff::SelloffParams` per token",
+                "(`max_selloff_pct`, `period_length`, `fee_threshold_pct`,",
+                "`fee_slope_low_pct`, `fee_slope_high_pct`; all `_pct` in",
+                "`PERCENT_SCALE` units). The surge fee rises convexly as the",
+                "window fills and is charged on the output token, 100% to the",
+                "protocol bucket."
+            ],
+            "discriminator": [
+                100,
+                44,
+                68,
+                198,
+                33,
+                58,
+                147,
+                254
+            ],
+            "accounts": [
+                {
+                    "name": "pool",
+                    "writable": true
+                },
+                {
+                    "name": "authority",
+                    "signer": true
+                }
+            ],
+            "args": [
+                {
+                    "name": "params",
+                    "type": {
+                        "vec": {
+                            "defined": {
+                                "name": "SelloffParams"
+                            }
+                        }
+                    }
+                }
+            ]
+        },
+        {
+            "name": "set_pool_enabled",
+            "docs": [
+                "Master pool kill-switch. When `enabled = false`, swaps and",
+                "add/remove liquidity all revert.",
+                "",
+                "# Authority",
+                "`protocol_admin` AND Treasury PDA.",
+                "",
+                "# Used by",
+                "`protocol_admin::pool_set_pool_enabled` (CPI)."
+            ],
+            "discriminator": [
+                53,
+                76,
+                170,
+                37,
+                55,
+                222,
+                63,
+                21
+            ],
+            "accounts": [
+                {
+                    "name": "config"
+                },
+                {
+                    "name": "pool",
+                    "writable": true
+                },
+                {
+                    "name": "authority",
+                    "signer": true
+                }
+            ],
+            "args": [
+                {
+                    "name": "enabled",
+                    "type": "bool"
+                }
+            ]
+        },
+        {
+            "name": "set_protocol_fee_rate",
+            "docs": [
+                "Set `pool.protocol_fee_rate`.",
+                "",
+                "# Authority",
+                "`protocol_admin` AND Treasury PDA.",
+                "",
+                "# Parameters",
+                "* `protocol_fee_rate` — basis points, ≤ `MAX_PROTOCOL_FEE_RATE`.",
+                "",
+                "# Used by",
+                "`protocol_admin::pool_set_protocol_fee_rate` (CPI)."
+            ],
+            "discriminator": [
+                95,
+                7,
+                4,
+                50,
+                154,
+                79,
+                156,
+                131
+            ],
+            "accounts": [
+                {
+                    "name": "config"
+                },
+                {
+                    "name": "pool",
+                    "writable": true
+                },
+                {
+                    "name": "authority",
+                    "signer": true
+                }
+            ],
+            "args": [
+                {
+                    "name": "protocol_fee_rate",
+                    "type": "u16"
+                }
+            ]
+        },
+        {
+            "name": "set_range_manager",
+            "docs": [
+                "Set or disable the range-manager pubkey on `pool`. Pool-admin only —",
+                "protocol-admin cannot reach this. Combine `new_manager =",
+                "Pubkey::default()` with `enabled = false` for the fully-disabled",
+                "state. New pools deploy with this off by default.",
+                "",
+                "# Parameters",
+                "* `new_manager` — pubkey allowed to call `range_manager_update`.",
+                "* `enabled`     — gate flag; `false` blocks the manager even if",
+                "pubkey is set."
+            ],
+            "discriminator": [
+                103,
+                102,
+                173,
+                112,
+                8,
+                2,
+                37,
+                132
+            ],
+            "accounts": [
+                {
+                    "name": "config"
+                },
+                {
+                    "name": "pool",
+                    "writable": true
+                },
+                {
+                    "name": "authority",
+                    "signer": true
+                }
+            ],
+            "args": [
+                {
+                    "name": "new_manager",
+                    "type": "pubkey"
+                },
+                {
+                    "name": "enabled",
+                    "type": "bool"
+                }
+            ]
+        },
+        {
+            "name": "set_range_manager_config",
+            "docs": [
+                "Configure the envelope the range-manager must stay within. Pool-",
+                "admin only. Limits are per-token (applied independently in the",
+                "update loop) and a percentage of the CURRENT value, in",
+                "`PERCENT_SCALE` units (10_000 = 100%).",
+                "",
+                "# Parameters",
+                "* `max_vb_change_pct`        — ≤ 10_000. 5% = 500.",
+                "* `max_weight_change_pct`    — ≤ 10_000.",
+                "* `min_update_interval_secs` — rate-limit between successive",
+                "`range_manager_update` calls.",
+                "* `max_leverage_bps`         — absolute band on",
+                "`virtual_balance / actual_balance` the manager must leave every",
+                "live token inside (10_000 = 1.0×; `0` disables that side). The",
+                "percentage caps above bound how FAST the manager may move; this",
+                "bounds how FAR.",
+                "* `min_leverage_bps` — the FLOOR of the same envelope, and the side",
+                "that actually protects capital. Output is priced off virtual",
+                "balances, so depressing one makes the pool believe it holds less than",
+                "it does and sells the other side's real reserves at a fabricated",
+                "rate. A ceiling alone never sees that coming. `0` disables it.",
+                "Appended at the END of the argument list — Borsh is positional."
+            ],
+            "discriminator": [
+                103,
+                211,
+                0,
+                200,
+                164,
+                189,
+                245,
+                205
+            ],
+            "accounts": [
+                {
+                    "name": "pool",
+                    "writable": true
+                },
+                {
+                    "name": "authority",
+                    "signer": true
+                }
+            ],
+            "args": [
+                {
+                    "name": "max_vb_change_pct",
+                    "type": "u16"
+                },
+                {
+                    "name": "max_weight_change_pct",
+                    "type": "u16"
+                },
+                {
+                    "name": "min_update_interval_secs",
+                    "type": "u32"
+                },
+                {
+                    "name": "max_leverage_bps",
+                    "type": "u32"
+                },
+                {
+                    "name": "min_leverage_bps",
+                    "type": "u32"
+                }
+            ]
+        },
+        {
+            "name": "set_swap_fee_rate",
+            "docs": [
+                "Set `pool.swap_fee_rate`.",
+                "",
+                "# Authority",
+                "`pool_admin` AND Treasury PDA.",
+                "",
+                "# Parameters",
+                "* `swap_fee_rate` — hundredths of bps, ≤ `MAX_SWAP_FEE_RATE`.",
+                "",
+                "# Used by",
+                "The pool admin's own wallet, and the admin panel. There is deliberately",
+                "NO `protocol_admin::pool_set_swap_fee_rate` wrapper: the swap fee is the",
+                "pool admin's parameter, not governance's, and the context requires the",
+                "pool admin to sign. Governance's lever over a pool's economics is",
+                "`pool_set_protocol_fee_rate`, which is a different field."
+            ],
+            "discriminator": [
+                144,
+                102,
+                81,
+                175,
+                135,
+                50,
+                36,
+                191
+            ],
+            "accounts": [
+                {
+                    "name": "pool",
+                    "docs": [
+                        "Mutated. `authority` must equal `pool.pool_admin` (storage-only",
+                        "admin pubkey; no hardcoded address)."
+                    ],
+                    "writable": true
+                },
+                {
+                    "name": "authority",
+                    "signer": true
+                }
+            ],
+            "args": [
+                {
+                    "name": "swap_fee_rate",
+                    "type": "u32"
+                }
+            ]
+        },
+        {
+            "name": "set_swaps_enabled",
+            "docs": [
+                "Per-pool swap toggle (less invasive than `set_pool_enabled` —",
+                "LPs can still add/remove liquidity).",
+                "",
+                "# Authority",
+                "`pool_admin` OR `protocol_admin`, AND Treasury PDA.",
+                "",
+                "# Used by",
+                "`protocol_admin::pool_set_swaps_enabled` (CPI)."
+            ],
+            "discriminator": [
+                144,
+                154,
+                205,
+                58,
+                241,
+                169,
+                64,
+                40
+            ],
+            "accounts": [
+                {
+                    "name": "config"
+                },
+                {
+                    "name": "pool",
+                    "writable": true
+                },
+                {
+                    "name": "authority",
+                    "signer": true
+                }
+            ],
+            "args": [
+                {
+                    "name": "enabled",
+                    "type": "bool"
+                }
+            ]
+        },
+        {
+            "name": "set_token_active",
+            "docs": [
+                "Set a token's `is_active` flag. When `false`, swaps whose INPUT token",
+                "is `token_index` revert (`TokenInactive`); the token can still be",
+                "bought (as output) and liquidity ops are unaffected.",
+                "",
+                "# Authority",
+                "`pool.pool_admin` OR `config.protocol_admin` (Treasury PDA). The",
+                "Treasury path is reachable by admin OR supervisor via",
+                "`protocol_admin::pool_set_token_active`."
+            ],
+            "discriminator": [
+                0,
+                158,
+                202,
+                35,
+                50,
+                139,
+                217,
+                18
+            ],
+            "accounts": [
+                {
+                    "name": "config"
+                },
+                {
+                    "name": "pool",
+                    "writable": true
+                },
+                {
+                    "name": "authority",
+                    "signer": true
+                }
+            ],
+            "args": [
+                {
+                    "name": "token_index",
+                    "type": "u8"
+                },
+                {
+                    "name": "is_active",
+                    "type": "bool"
+                }
+            ]
+        },
+        {
+            "name": "swap",
+            "docs": [
+                "Swap one pool token for another using `calc_out_given_in`.",
+                "",
+                "# Parameters",
+                "* `amount_in`         — raw input token units (pre-fee).",
+                "* `minimum_amount_out`— slippage floor.",
+                "* `token_in_index`    — index in `pool.token_mints`.",
+                "* `token_out_index`   — different index in `pool.token_mints`.",
+                "",
+                "# Used by",
+                "User wallets, SDK `SwapClient`, single-token-liquidity helper."
+            ],
+            "discriminator": [
+                248,
+                198,
+                158,
+                145,
+                225,
+                117,
+                135,
+                200
+            ],
+            "accounts": [
+                {
+                    "name": "pool",
+                    "writable": true
+                },
+                {
+                    "name": "token_mint_in"
+                },
+                {
+                    "name": "token_mint_out"
+                },
+                {
+                    "name": "user_token_account_in",
+                    "docs": [
+                        "User's input-token account. Mint and owner cross-checked."
+                    ],
+                    "writable": true
+                },
+                {
+                    "name": "user_token_account_out",
+                    "writable": true
+                },
+                {
+                    "name": "vault_in",
+                    "docs": [
+                        "Pool input vault. ATA(pool, mint_in, token_program_in) — verified",
+                        "in handler."
+                    ],
+                    "writable": true
+                },
+                {
+                    "name": "vault_out",
+                    "writable": true
+                },
+                {
+                    "name": "user",
+                    "signer": true
+                },
+                {
+                    "name": "token_program_in"
+                },
+                {
+                    "name": "token_program_out"
+                }
+            ],
+            "args": [
+                {
+                    "name": "amount_in",
+                    "type": "u64"
+                },
+                {
+                    "name": "minimum_amount_out",
+                    "type": "u64"
+                },
+                {
+                    "name": "token_in_index",
+                    "type": "u8"
+                },
+                {
+                    "name": "token_out_index",
+                    "type": "u8"
+                }
+            ]
+        },
+        {
+            "name": "withdraw_sol",
+            "docs": [
+                "Drain lamports from a cubic-pool-owned account, leaving at least",
+                "the rent-exempt minimum.",
+                "",
+                "# Authority",
+                "Treasury PDA only.",
+                "",
+                "# Parameters",
+                "* `amount` — lamports; must be > 0 and ≤",
+                "`source.lamports() - rent_exempt_minimum(source.data_len())`.",
+                "",
+                "# Used by",
+                "`protocol_admin::pool_withdraw_sol` (CPI)."
+            ],
+            "discriminator": [
+                145,
+                131,
+                74,
+                136,
+                65,
+                137,
+                42,
+                38
+            ],
+            "accounts": [
+                {
+                    "name": "config"
+                },
+                {
+                    "name": "source",
+                    "writable": true
+                },
+                {
+                    "name": "recipient",
+                    "writable": true
+                },
+                {
+                    "name": "authority",
+                    "signer": true
+                }
+            ],
+            "args": [
+                {
+                    "name": "amount",
+                    "type": "u64"
+                }
+            ]
+        }
+    ],
+    "accounts": [
+        {
+            "name": "CubicPool",
+            "discriminator": [
+                137,
+                210,
+                42,
+                22,
+                209,
+                156,
+                43,
+                78
+            ]
+        },
+        {
+            "name": "CubicPoolConfig",
+            "discriminator": [
+                4,
+                29,
+                243,
+                10,
+                142,
+                64,
+                232,
+                118
+            ]
+        }
+    ],
+    "events": [
+        {
+            "name": "BannedExtensionsUpdated",
+            "discriminator": [
+                107,
+                126,
+                13,
+                149,
+                182,
+                108,
+                139,
+                202
+            ]
+        },
+        {
+            "name": "ConfigInitialized",
+            "discriminator": [
+                181,
+                49,
+                200,
+                156,
+                19,
+                167,
+                178,
+                91
+            ]
+        },
+        {
+            "name": "DebugLiquidityWithdrawn",
+            "discriminator": [
+                174,
+                59,
+                149,
+                22,
+                135,
+                129,
+                129,
+                83
+            ]
+        },
+        {
+            "name": "LiquidityAdded",
+            "discriminator": [
+                154,
+                26,
+                221,
+                108,
+                238,
+                64,
+                217,
+                161
+            ]
+        },
+        {
+            "name": "LiquidityRemoved",
+            "discriminator": [
+                225,
+                105,
+                216,
+                39,
+                124,
+                116,
+                169,
+                189
+            ]
+        },
+        {
+            "name": "MaxSelloffSet",
+            "discriminator": [
+                134,
+                183,
+                49,
+                134,
+                82,
+                138,
+                85,
+                234
+            ]
+        },
+        {
+            "name": "MaxSelloffWindowAdvanced",
+            "discriminator": [
+                229,
+                227,
+                163,
+                30,
+                22,
+                183,
+                78,
+                57
+            ]
+        },
+        {
+            "name": "PoolAdminDisabled",
+            "discriminator": [
+                158,
+                98,
+                202,
+                37,
+                243,
+                57,
+                247,
+                87
+            ]
+        },
+        {
+            "name": "PoolAdminTransferCancelled",
+            "discriminator": [
+                238,
+                53,
+                38,
+                143,
+                194,
+                45,
+                206,
+                179
+            ]
+        },
+        {
+            "name": "PoolAdminTransferInitiated",
+            "discriminator": [
+                33,
+                195,
+                202,
+                133,
+                209,
+                42,
+                157,
+                78
+            ]
+        },
+        {
+            "name": "PoolAdminTransferred",
+            "discriminator": [
+                123,
+                48,
+                231,
+                186,
+                53,
+                67,
+                156,
+                254
+            ]
+        },
+        {
+            "name": "PoolAltInitialized",
+            "discriminator": [
+                61,
+                210,
+                86,
+                20,
+                100,
+                253,
+                41,
+                133
+            ]
+        },
+        {
+            "name": "PoolEnabledUpdated",
+            "discriminator": [
+                101,
+                47,
+                3,
+                240,
+                197,
+                181,
+                236,
+                142
+            ]
+        },
+        {
+            "name": "PoolInfo",
+            "discriminator": [
+                207,
+                20,
+                87,
+                97,
+                251,
+                212,
+                234,
+                45
+            ]
+        },
+        {
+            "name": "PoolInitialized",
+            "discriminator": [
+                100,
+                118,
+                173,
+                87,
+                12,
+                198,
+                254,
+                229
+            ]
+        },
+        {
+            "name": "PoolMigratedToV5",
+            "discriminator": [
+                95,
+                55,
+                157,
+                61,
+                92,
+                6,
+                79,
+                105
+            ]
+        },
+        {
+            "name": "PoolSolWithdrawn",
+            "discriminator": [
+                82,
+                220,
+                173,
+                175,
+                24,
+                165,
+                172,
+                233
+            ]
+        },
+        {
+            "name": "PoolStateLog",
+            "discriminator": [
+                59,
+                254,
+                237,
+                111,
+                163,
+                10,
+                140,
+                224
+            ]
+        },
+        {
+            "name": "ProtocolAdminTransferCancelled",
+            "discriminator": [
+                46,
+                120,
+                187,
+                57,
+                136,
+                63,
+                89,
+                7
+            ]
+        },
+        {
+            "name": "ProtocolAdminTransferInitiated",
+            "discriminator": [
+                78,
+                207,
+                188,
+                146,
+                26,
+                65,
+                40,
+                167
+            ]
+        },
+        {
+            "name": "ProtocolAdminTransferred",
+            "discriminator": [
+                140,
+                30,
+                55,
+                121,
+                105,
+                75,
+                148,
+                68
+            ]
+        },
+        {
+            "name": "ProtocolFeeRateUpdated",
+            "discriminator": [
+                189,
+                56,
+                7,
+                65,
+                0,
+                95,
+                192,
+                6
+            ]
+        },
+        {
+            "name": "ProtocolFeesCollected",
+            "discriminator": [
+                165,
+                34,
+                125,
+                155,
+                15,
+                86,
+                99,
+                191
+            ]
+        },
+        {
+            "name": "RangeManagerConfigSet",
+            "discriminator": [
+                187,
+                59,
+                98,
+                47,
+                108,
+                2,
+                229,
+                152
+            ]
+        },
+        {
+            "name": "RangeManagerSet",
+            "discriminator": [
+                62,
+                152,
+                235,
+                91,
+                195,
+                238,
+                83,
+                202
+            ]
+        },
+        {
+            "name": "RangeManagerUpdated",
+            "discriminator": [
+                132,
+                144,
+                100,
+                144,
+                149,
+                205,
+                212,
+                24
+            ]
+        },
+        {
+            "name": "Swap",
+            "discriminator": [
+                81,
+                108,
+                227,
+                190,
+                205,
+                208,
+                10,
+                196
+            ]
+        },
+        {
+            "name": "SwapFeeRateUpdated",
+            "discriminator": [
+                101,
+                132,
+                24,
+                255,
+                91,
+                253,
+                227,
+                101
+            ]
+        },
+        {
+            "name": "SwapsEnabledUpdated",
+            "discriminator": [
+                55,
+                116,
+                118,
+                138,
+                102,
+                26,
+                227,
+                223
+            ]
+        },
+        {
+            "name": "TokenActiveSet",
+            "discriminator": [
+                168,
+                221,
+                25,
+                146,
+                234,
+                230,
+                232,
+                100
+            ]
+        }
+    ],
+    "errors": [
+        {
+            "code": 6000,
+            "name": "InvalidTokenCount",
+            "msg": "Invalid token count. Must be between 2 and 10"
+        },
+        {
+            "code": 6001,
+            "name": "InvalidTokenIndex",
+            "msg": "Invalid token index"
+        },
+        {
+            "code": 6002,
+            "name": "InvalidWeights",
+            "msg": "Invalid weights. Must sum to 10000 (WEIGHT_SCALE)"
+        },
+        {
+            "code": 6003,
+            "name": "InvalidVirtualBalances",
+            "msg": "Invalid virtual balances. Must be greater than zero"
+        },
+        {
+            "code": 6004,
+            "name": "InsufficientLiquidity",
+            "msg": "Insufficient liquidity in the pool"
+        },
+        {
+            "code": 6005,
+            "name": "SlippageExceeded",
+            "msg": "Slippage tolerance exceeded"
+        },
+        {
+            "code": 6006,
+            "name": "InvalidAmounts",
+            "msg": "Invalid amounts provided"
+        },
+        {
+            "code": 6007,
+            "name": "InsufficientBptOut",
+            "msg": "Insufficient BPT minted"
+        },
+        {
+            "code": 6008,
+            "name": "InsufficientTokensOut",
+            "msg": "Insufficient tokens received"
+        },
+        {
+            "code": 6009,
+            "name": "FeeRateMaxExceeded",
+            "msg": "Fee rate exceeds maximum"
+        },
+        {
+            "code": 6010,
+            "name": "ProtocolFeeRateMaxExceeded",
+            "msg": "Protocol fee rate exceeds maximum"
+        },
+        {
+            "code": 6011,
+            "name": "MathOverflow",
+            "msg": "Math overflow"
+        },
+        {
+            "code": 6012,
+            "name": "MathUnderflow",
+            "msg": "Math underflow"
+        },
+        {
+            "code": 6013,
+            "name": "DivisionByZero",
+            "msg": "Division by zero"
+        },
+        {
+            "code": 6014,
+            "name": "TokenMintMismatch",
+            "msg": "Token mint mismatch"
+        },
+        {
+            "code": 6015,
+            "name": "InvalidTokenDecimals",
+            "msg": "Invalid token decimals"
+        },
+        {
+            "code": 6016,
+            "name": "AmountOutExceedsBalance",
+            "msg": "Amount out exceeds available balance"
+        },
+        {
+            "code": 6017,
+            "name": "InvalidBptAmount",
+            "msg": "Invalid BPT amount"
+        },
+        {
+            "code": 6018,
+            "name": "Unauthorized",
+            "msg": "Unauthorized"
+        },
+        {
+            "code": 6019,
+            "name": "InvalidMint",
+            "msg": "Invalid mint account"
+        },
+        {
+            "code": 6020,
+            "name": "PoolDisabled",
+            "msg": "Pool is disabled. No operations allowed."
+        },
+        {
+            "code": 6021,
+            "name": "SwapsDisabled",
+            "msg": "Swaps are disabled for this pool."
+        },
+        {
+            "code": 6022,
+            "name": "PoolMustBeDisabled",
+            "msg": "Pool must be disabled before debug operations."
+        },
+        {
+            "code": 6023,
+            "name": "ZeroAmount",
+            "msg": "Amount must be greater than zero"
+        },
+        {
+            "code": 6024,
+            "name": "ZeroFeeAmount",
+            "msg": "Swap amount is too small: fee rounds to zero"
+        },
+        {
+            "code": 6025,
+            "name": "BannedExtension",
+            "msg": "Token mint has a banned Token-2022 extension"
+        },
+        {
+            "code": 6026,
+            "name": "TokenProgramMismatch",
+            "msg": "Token program does not match pool's token program"
+        },
+        {
+            "code": 6027,
+            "name": "UserTokenAccountOwnerMismatch",
+            "msg": "User token account owner mismatch"
+        },
+        {
+            "code": 6028,
+            "name": "InitialLiquidityTooSmall",
+            "msg": "Initial liquidity too small - pool would be bricked"
+        },
+        {
+            "code": 6029,
+            "name": "InvalidTokenProgram",
+            "msg": "Invalid token program - must be SPL Token or Token-2022"
+        },
+        {
+            "code": 6030,
+            "name": "InvalidVault",
+            "msg": "Invalid vault account"
+        },
+        {
+            "code": 6031,
+            "name": "InvalidSourceOwner",
+            "msg": "Source account must be owned by this program"
+        },
+        {
+            "code": 6032,
+            "name": "WouldBreakRentExempt",
+            "msg": "Withdrawal would break rent exemption"
+        },
+        {
+            "code": 6033,
+            "name": "PoolAdminDisabled",
+            "msg": "Pool admin is disabled"
+        },
+        {
+            "code": 6034,
+            "name": "ProtocolAdminUnset",
+            "msg": "Protocol admin is unset"
+        },
+        {
+            "code": 6035,
+            "name": "NoPendingAdmin",
+            "msg": "No pending admin transfer"
+        },
+        {
+            "code": 6036,
+            "name": "NotPendingAdmin",
+            "msg": "Signer is not the pending admin"
+        },
+        {
+            "code": 6037,
+            "name": "InvalidPendingAdmin",
+            "msg": "Pending admin cannot be the zero pubkey"
+        },
+        {
+            "code": 6038,
+            "name": "ProtocolAdminNotTreasury",
+            "msg": "Deprecated: config admin is now pinned by account constraints, not this check"
+        },
+        {
+            "code": 6039,
+            "name": "RangeManagerDisabled",
+            "msg": "Range manager is not enabled for this pool"
+        },
+        {
+            "code": 6040,
+            "name": "RangeManagerUnauthorized",
+            "msg": "Signer is not the configured range manager"
+        },
+        {
+            "code": 6041,
+            "name": "RangeManagerUpdateTooFrequent",
+            "msg": "Range manager update too frequent — minimum interval not yet elapsed"
+        },
+        {
+            "code": 6042,
+            "name": "RangeManagerVbChangeTooLarge",
+            "msg": "Range manager virtual balance change exceeds configured percent cap"
+        },
+        {
+            "code": 6043,
+            "name": "RangeManagerWeightChangeTooLarge",
+            "msg": "Range manager weight change exceeds configured percent cap"
+        },
+        {
+            "code": 6044,
+            "name": "RangeManagerEmptyUpdate",
+            "msg": "Range manager update must change at least one virtual balance or weight"
+        },
+        {
+            "code": 6045,
+            "name": "RangeManagerInvalidPct",
+            "msg": "Range manager percent parameter exceeds 10000"
+        },
+        {
+            "code": 6046,
+            "name": "RangeManagerWeightSumInvalid",
+            "msg": "Resulting weights do not sum to WEIGHT_SCALE after range manager update"
+        },
+        {
+            "code": 6047,
+            "name": "RangeManagerDuplicateIndex",
+            "msg": "Duplicate token index in range manager update"
+        },
+        {
+            "code": 6048,
+            "name": "MaxSelloffInvalidConfig",
+            "msg": "max_selloff_period_length must be > 0 when max_selloff > 0"
+        },
+        {
+            "code": 6049,
+            "name": "MaxSelloffExceeded",
+            "msg": "Token max-selloff threshold exceeded for current window"
+        },
+        {
+            "code": 6050,
+            "name": "AltAlreadyInitialized",
+            "msg": "Pool already has an Address Lookup Table initialised"
+        },
+        {
+            "code": 6051,
+            "name": "AltAddressMismatch",
+            "msg": "ALT address mismatch — re-derived from recent_slot doesn't match passed account"
+        },
+        {
+            "code": 6052,
+            "name": "InvalidAltProgram",
+            "msg": "Invalid Address Lookup Table program id"
+        },
+        {
+            "code": 6053,
+            "name": "InvalidSurgeFeeConfig",
+            "msg": "Invalid surge fee curve config"
+        },
+        {
+            "code": 6054,
+            "name": "TokenInactive",
+            "msg": "Token is deactivated for swaps on the input side"
+        },
+        {
+            "code": 6055,
+            "name": "UnsupportedExtension",
+            "msg": "Mint has an unsupported Token-2022 extension"
+        },
+        {
+            "code": 6056,
+            "name": "MemoProgramMissing",
+            "msg": "Destination requires a memo; pass the SPL Memo program account"
+        },
+        {
+            "code": 6057,
+            "name": "TransferFeeCalculationMismatch",
+            "msg": "Transfer fee round-trip verification failed"
+        },
+        {
+            "code": 6058,
+            "name": "AmountFullyConsumedByTransferFee",
+            "msg": "Deposit amount is fully consumed by the token transfer fee"
+        },
+        {
+            "code": 6059,
+            "name": "SeedDepositNotPoolAdmin",
+            "msg": "Only the pool admin may make the pool's first (seed) deposit"
+        },
+        {
+            "code": 6060,
+            "name": "StldTokenExtensionsUnsupported",
+            "msg": "Deprecated: see single-token-liquidity's own TokenExtensionsUnsupported"
+        },
+        {
+            "code": 6061,
+            "name": "RangeManagerStaleValue",
+            "msg": "Range manager update is stale — expected_current does not match stored value"
+        },
+        {
+            "code": 6062,
+            "name": "RangeManagerLeverageBandExceeded",
+            "msg": "Range manager update exceeds the configured leverage band"
+        },
+        {
+            "code": 6063,
+            "name": "RangeManagerOverrideMustDisable",
+            "msg": "Protocol-admin range-manager override may only disable, not appoint"
+        },
+        {
+            "code": 6064,
+            "name": "InvalidArrayLength",
+            "msg": "Array length does not match the pool's token count"
+        },
+        {
+            "code": 6065,
+            "name": "FirstDepositRequiresNonzero",
+            "msg": "First deposit must fund at least one token"
+        },
+        {
+            "code": 6066,
+            "name": "TokenLivenessMismatch",
+            "msg": "Deposit would change a token's live/sidelined state"
+        },
+        {
+            "code": 6067,
+            "name": "DepositTooSmall",
+            "msg": "Deposit is too small to mint any BPT"
+        },
+        {
+            "code": 6068,
+            "name": "PoolNotSeeded",
+            "msg": "Pool holds no liquidity: every actual_balance is zero"
+        }
+    ],
+    "types": [
+        {
+            "name": "AssetConfig",
+            "docs": [
+                "`CubicPool` v4 — per-pool state for a weighted AMM with virtual liquidity.",
+                "",
+                "Storage layout: **Array-of-Structs (AoS)**. Per-token data lives in",
+                "`tokens: [TokenSlot; MAX_TOKENS]`. Each `TokenSlot` carries TWO nested",
+                "sub-structs:",
+                "",
+                "- `config: AssetConfig`     — admin-controlled, rarely changes (mint,",
+                "token_program, weight, max_selloff, period).",
+                "- `dynamics: AssetDynamics` — auto-updated by user txs (balances,",
+                "protocol_fees_owed, sliding-window selloff state).",
+                "",
+                "This mirrors Solend / MarginFi / Kamino's `Reserve { config, ... }`",
+                "pattern. Reading per-token data is a single struct lookup; auditors",
+                "see at a glance which fields a user can mutate vs which need pool",
+                "admin authority.",
+                "",
+                "## Storage layout — DO NOT REORDER",
+                "Backends (`onchainPoolFetcher.ts`, indexer) read fields by raw offset.",
+                "Adding fields is OK if appended at the END (before the trailing",
+                "`reserved`) and `reserved` shrinks accordingly. Inserting in the",
+                "middle would require rewriting existing accounts.",
+                "",
+                "## Derived (not stored) state",
+                "- `bpt_mint`        — derived as `[BPT_MINT_SEED, pool]` PDA.",
+                "- `bpt_total_supply`— read from `bpt_mint.supply` at runtime.",
+                "- `token_vaults[i]` — derived as ATA(pool, mint, tokens[i].config.token_program).",
+                "- `token_decimals`  — read from each mint account at runtime."
+            ],
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "mint",
+                        "docs": [
+                            "Token mint pubkey for this slot. `Pubkey::default()` past `token_count`."
+                        ],
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "token_program",
+                        "docs": [
+                            "SPL Token or Token-2022 program ID for this token's vault/transfers."
+                        ],
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "normalized_weight",
+                        "docs": [
+                            "Normalised weight in basis points (sum across active slots == 10_000)."
+                        ],
+                        "type": "u64"
+                    },
+                    {
+                        "name": "max_selloff_pct",
+                        "docs": [
+                            "Max cumulative sell volume of this token per sliding window,",
+                            "expressed as a **percentage of the token's `virtual_balance`**",
+                            "captured at window start, in units of `PERCENT_SCALE` (10_000 =",
+                            "100%, so 1000 = 10%; resolution 0.01%). `0` disables the check for",
+                            "this token. Must be `<= PERCENT_SCALE`. Set by pool_admin only.",
+                            "",
+                            "The absolute cap for a window is `floor(max_selloff_pct *",
+                            "vb_snapshot / PERCENT_SCALE)`, where `vb_snapshot` is",
+                            "`AssetDynamics::selloff_vb_snapshot` (taken at window open). Using a",
+                            "per-window snapshot — not the live `virtual_balance` — prevents an",
+                            "in-window base-inflation bypass (see `math::max_selloff`)."
+                        ],
+                        "type": "u16"
+                    },
+                    {
+                        "name": "max_selloff_period_length",
+                        "docs": [
+                            "Length of the sliding window in seconds. Ignored when",
+                            "`max_selloff_pct == 0`. Set by pool_admin only."
+                        ],
+                        "type": "u32"
+                    },
+                    {
+                        "name": "variable_fee_threshold_pct",
+                        "docs": [
+                            "Variable sell-off **surge fee** curve (per token, `PERCENT_SCALE`",
+                            "units; 10_000 = 100%). The fee rises as the token's max-selloff",
+                            "window fills and is charged on `amount_out`, routed 100% to the",
+                            "protocol bucket (`protocol_fees_owed`), never to LPs. See",
+                            "`math::surge_fee`. The fee is active only when `max_selloff_pct > 0`",
+                            "(it reads the window fill ratio) AND `fee_slope_high_pct > 0`.",
+                            "",
+                            "Window fill ratio at which the surge fee starts (below it the fee is",
+                            "0). E.g. 8000 = surge begins at 80% window fill."
+                        ],
+                        "type": "u16"
+                    },
+                    {
+                        "name": "variable_fee_slope_low_pct",
+                        "docs": [
+                            "Surge fee at the threshold (lower point of the curve)."
+                        ],
+                        "type": "u16"
+                    },
+                    {
+                        "name": "variable_fee_slope_high_pct",
+                        "docs": [
+                            "Surge fee at ~100% window fill (upper point of the curve). Must be",
+                            "`>= fee_slope_low_pct` and `<= PERCENT_SCALE`."
+                        ],
+                        "type": "u16"
+                    },
+                    {
+                        "name": "is_active",
+                        "docs": [
+                            "Per-token kill switch for the **input** side of swaps. When `false`,",
+                            "swaps whose INPUT token is this one revert (`TokenInactive`); the",
+                            "token can still be bought (as swap output) and liquidity ops are",
+                            "unaffected. Defaults to `true` (active). Flipped by `set_token_active`",
+                            "(pool-admin or protocol-admin/supervisor). Used to stop accepting a",
+                            "compromised token without pausing the whole pool."
+                        ],
+                        "type": "bool"
+                    },
+                    {
+                        "name": "variable_fee_slope_mid_pct",
+                        "docs": [
+                            "Surge fee at the KINK — the middle of the three points that define the",
+                            "curve. Between `variable_fee_threshold_pct` and this point the fee runs",
+                            "linearly from `variable_fee_slope_low_pct` to here; beyond it, linearly",
+                            "from here to `variable_fee_slope_high_pct` at full window fill.",
+                            "",
+                            "This is the \"target utilisation\" shape lending protocols use (Evaa,",
+                            "Aave, Compound): gentle while the window fills normally, steep once it",
+                            "is nearly exhausted. Must satisfy",
+                            "`slope_low <= slope_mid <= slope_high` — a fee that fell as the window",
+                            "filled would invert the brake."
+                        ],
+                        "type": "u16"
+                    },
+                    {
+                        "name": "variable_fee_kink_pct",
+                        "docs": [
+                            "Window fill at which the curve kinks, in WHOLE PERCENT (0..=100), not",
+                            "`PERCENT_SCALE` units — one byte is all that was left, and 1% is ample",
+                            "resolution for a breakpoint.",
+                            "",
+                            "`0` means \"no kink\": the curve degenerates to a single straight line",
+                            "from `slope_low` at the threshold to `slope_high` at full fill, which",
+                            "is what every pool written by the previous layout decodes as.",
+                            "",
+                            "Must sit strictly between the threshold and full fill when set."
+                        ],
+                        "type": "u8"
+                    }
+                ]
+            }
+        },
+        {
+            "name": "AssetDynamics",
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "virtual_balance",
+                        "docs": [
+                            "Virtual balance (raw token units) used by the cubic invariant",
+                            "math. Decoupled from `actual_balance` to enable concentrated",
+                            "liquidity. Updated by swap / add_liquidity / remove_liquidity."
+                        ],
+                        "type": "u64"
+                    },
+                    {
+                        "name": "actual_balance",
+                        "docs": [
+                            "The LP-owned portion of this token's vault, in raw units.",
+                            "",
+                            "It does NOT equal the vault's `amount`. The invariant is",
+                            "`vault.amount == actual_balance + protocol_fees_owed`: protocol fees",
+                            "sit in the same vault but are not LP capital, and `collect_protocol_fees`",
+                            "pays them out without touching `actual_balance`. Sizing a withdrawal or",
+                            "a deposit ratio against the raw vault balance would therefore hand LPs",
+                            "the protocol's uncollected fees.",
+                            "",
+                            "Reads of the vault should either use this field or subtract",
+                            "`protocol_fees_owed` explicitly; the two are only equal on a pool whose",
+                            "fees have just been collected."
+                        ],
+                        "type": "u64"
+                    },
+                    {
+                        "name": "protocol_fees_owed",
+                        "docs": [
+                            "Accumulated protocol fees for this token (raw units), awaiting",
+                            "`collect_protocol_fees`. Stored separately from `actual_balance`",
+                            "so LP value isn't diluted by uncollected fees."
+                        ],
+                        "type": "u64"
+                    },
+                    {
+                        "name": "previous_selloff",
+                        "docs": [
+                            "Sliding-window rate limiter: amount sold in the PREVIOUS window",
+                            "(Cloudflare-style approximation, Solend RateLimiter pattern)."
+                        ],
+                        "type": "u64"
+                    },
+                    {
+                        "name": "current_selloff",
+                        "docs": [
+                            "Amount sold in the CURRENT window."
+                        ],
+                        "type": "u64"
+                    },
+                    {
+                        "name": "window_start_timestamp",
+                        "docs": [
+                            "`Clock::unix_timestamp` when the current window started. Set to",
+                            "`now()` at pool init."
+                        ],
+                        "type": "i64"
+                    },
+                    {
+                        "name": "selloff_vb_snapshot",
+                        "docs": [
+                            "Snapshot of this token's `virtual_balance` taken when the current",
+                            "max-selloff window opened. The window's absolute cap is",
+                            "`floor(config.max_selloff_pct * selloff_vb_snapshot / PERCENT_SCALE)`.",
+                            "Snapshotting (rather than reading live `virtual_balance`) keeps the",
+                            "cap un-inflatable within a window — selling raises the live vb, but",
+                            "not this snapshot. `0` ⇒ uninitialised (re-captured on next check)."
+                        ],
+                        "type": "u64"
+                    }
+                ]
+            }
+        },
+        {
+            "name": "BannedExtensionsUpdated",
+            "docs": [
+                "Emitted by `set_banned_extensions`. Off-chain validators use this to",
+                "refresh the cached blocklist without rereading the config account."
+            ],
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "config",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "authority",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "old_value",
+                        "type": "u64"
+                    },
+                    {
+                        "name": "new_value",
+                        "type": "u64"
+                    },
+                    {
+                        "name": "timestamp",
+                        "type": "i64"
+                    },
+                    {
+                        "name": "old_hard_value",
+                        "docs": [
+                            "Before/after of the non-overridable floor a pool creator cannot",
+                            "clear. Appended (wire append-only)."
+                        ],
+                        "type": "u64"
+                    },
+                    {
+                        "name": "new_hard_value",
+                        "type": "u64"
+                    }
+                ]
+            }
+        },
+        {
+            "name": "ConfigInitialized",
+            "docs": [
+                "Emitted at the end of `initialize_config`. Marks a new `CubicPoolConfig`",
+                "account live, with `protocol_admin` pinned to the Treasury PDA.",
+                "",
+                "`initialize_config` creates the account from scratch, so there are no",
+                "\"old\" values to carry — every field is reported as its initial value.",
+                "",
+                "# Fields",
+                "* `config`                    — the new config PDA pubkey",
+                "* `protocol_admin`            — Treasury PDA the config is pinned to",
+                "* `default_protocol_fee_rate` — seeded onto every pool from this config",
+                "* `banned_extensions`         — initial Token-2022 extension blocklist",
+                "* `payer`                     — account that paid rent / signed init",
+                "* `timestamp`                 — `Clock::unix_timestamp` at init"
+            ],
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "config",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "protocol_admin",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "default_protocol_fee_rate",
+                        "type": "u16"
+                    },
+                    {
+                        "name": "banned_extensions",
+                        "type": "u64"
+                    },
+                    {
+                        "name": "payer",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "timestamp",
+                        "type": "i64"
+                    }
+                ]
+            }
+        },
+        {
+            "name": "CubicPool",
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "config",
+                        "docs": [
+                            "`CubicPoolConfig` this pool inherits governance from. Pinned at",
+                            "init, used both as a PDA seed and at runtime in admin-instruction",
+                            "constraints (`pool.config == config.key()`)."
+                        ],
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "bump",
+                        "docs": [
+                            "Bump seed for the pool PDA. Stored so signer-seed reconstruction is",
+                            "O(1) instead of an expensive `find_program_address` per CPI."
+                        ],
+                        "type": "u8"
+                    },
+                    {
+                        "name": "token_count",
+                        "docs": [
+                            "Number of active tokens in the pool, in [MIN_TOKENS, MAX_TOKENS] =",
+                            "[2, 10]. Slots beyond `token_count` are zeroed and ignored."
+                        ],
+                        "type": "u8"
+                    },
+                    {
+                        "name": "pool_id",
+                        "docs": [
+                            "User-chosen 64-bit salt baked into the PDA seeds, allowing multiple",
+                            "pools per config without re-deploying. Unique per (config, pool_id)."
+                        ],
+                        "type": "u64"
+                    },
+                    {
+                        "name": "swap_fee_rate",
+                        "docs": [
+                            "Swap fee in hundredths of a basis point (precision",
+                            "`SWAP_FEE_PRECISION` = 1_000_000). 100_000 = 10% (current cap)."
+                        ],
+                        "type": "u32"
+                    },
+                    {
+                        "name": "protocol_fee_rate",
+                        "docs": [
+                            "Share of each swap fee taken by the protocol, in basis points",
+                            "(precision `PROTOCOL_FEE_PRECISION` = 10_000). 5_000 = 50% (cap)."
+                        ],
+                        "type": "u16"
+                    },
+                    {
+                        "name": "created_at",
+                        "docs": [
+                            "Pool creation `Clock::unix_timestamp`. Informational only."
+                        ],
+                        "type": "i64"
+                    },
+                    {
+                        "name": "pool_enabled",
+                        "docs": [
+                            "Master kill switch — when `false`, swaps and add/remove liquidity",
+                            "all revert. Only `protocol_admin` can flip this."
+                        ],
+                        "type": "bool"
+                    },
+                    {
+                        "name": "swaps_enabled",
+                        "docs": [
+                            "Trading switch — `false` blocks swaps but still allows LP",
+                            "add/remove. Either `pool_admin` or `config.protocol_admin` can flip."
+                        ],
+                        "type": "bool"
+                    },
+                    {
+                        "name": "pool_admin",
+                        "docs": [
+                            "Per-pool admin. Owns: rotate swap_fee_rate, toggle swaps_enabled,",
+                            "set range_manager, set max_selloff, transfer/disable itself."
+                        ],
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "pending_pool_admin",
+                        "docs": [
+                            "Pending successor for `pool_admin` during a 2-step transfer."
+                        ],
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "range_manager",
+                        "docs": [
+                            "Pubkey allowed to call `range_manager_update`. `Pubkey::default()`",
+                            "⇒ no manager set."
+                        ],
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "range_manager_enabled",
+                        "docs": [
+                            "`false` ⇒ all `range_manager_update` calls revert."
+                        ],
+                        "type": "bool"
+                    },
+                    {
+                        "name": "range_manager_max_vb_change_pct",
+                        "docs": [
+                            "Max per-update change to a token's `virtual_balance`, as a",
+                            "percentage of its current value, in `PERCENT_SCALE` units",
+                            "(10_000 = 100%; 500 = 5%). Enforced per token in",
+                            "`range_manager_update`."
+                        ],
+                        "type": "u16"
+                    },
+                    {
+                        "name": "range_manager_max_weight_change_pct",
+                        "docs": [
+                            "Max per-update change to a token's `normalized_weight`, same",
+                            "`PERCENT_SCALE` units."
+                        ],
+                        "type": "u16"
+                    },
+                    {
+                        "name": "range_manager_min_update_interval_secs",
+                        "type": "u32"
+                    },
+                    {
+                        "name": "range_manager_last_updated",
+                        "type": "i64"
+                    },
+                    {
+                        "name": "tokens",
+                        "docs": [
+                            "All per-token state. Slot `i` is for the i-th token. Slots past",
+                            "`token_count` are zero-initialised and ignored."
+                        ],
+                        "type": {
+                            "array": [
+                                {
+                                    "defined": {
+                                        "name": "TokenSlot"
+                                    }
+                                },
+                                10
+                            ]
+                        }
+                    },
+                    {
+                        "name": "lookup_table",
+                        "docs": [
+                            "Per-pool Address Lookup Table address. Holds pool-scoped accounts",
+                            "(pool PDA, BPT mint, vaults, mints, token programs) so client SDKs",
+                            "can build VersionedTransactions for `add_liquidity` / `remove_liquidity`",
+                            "without hitting the 1232-byte legacy-tx ceiling on multi-token pools.",
+                            "",
+                            "`Pubkey::default()` ⇒ ALT not yet initialised. SDK falls back to",
+                            "legacy tx (will only work for small pools). Set by `initialize_pool_alt`,",
+                            "frozen on-chain so depositors don't worry about authority abuse."
+                        ],
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "banned_extensions",
+                        "docs": [
+                            "Token-2022 extension blocklist that was applied to THIS pool's tokens",
+                            "at creation, in the same bit layout as",
+                            "`CubicPoolConfig.banned_extensions` (bit `i` set ⇒ extension type `i`",
+                            "is forbidden). Chosen by the pool **creator** at init: if they passed",
+                            "an explicit override it is stored verbatim; otherwise the parent",
+                            "config's default was copied here.",
+                            "",
+                            "Recorded for transparency so indexers / depositors can see exactly",
+                            "which extension policy a pool's tokens were vetted against. It is a",
+                            "snapshot only — the pool's token set is fixed at creation, so changing",
+                            "this value later would not re-validate anything.",
+                            "",
+                            "NOTE (security): the creator chooses this bitmap freely ABOVE the",
+                            "protocol floor — `constants::HARD_BANNED_EXTENSIONS`",
+                            "(`PermanentDelegate`, `TransferHook`) is OR-ed in at creation and",
+                            "cannot be cleared, so no pool can admit a mint that reaches vault",
+                            "custody. Everything else is the creator's call, so LPs should still",
+                            "read this field and decide whether they trust the remaining policy",
+                            "before depositing. Pre-existing (pre-upgrade) pools read `0` here",
+                            "until `migrate_to_v5` backfills them from the parent config."
+                        ],
+                        "type": "u64"
+                    },
+                    {
+                        "name": "range_manager_max_leverage_bps",
+                        "docs": [
+                            "Absolute ceiling on `virtual_balance / actual_balance` that the range",
+                            "manager may leave a token at, in basis points (10_000 = 1.0×). `0`",
+                            "disables the band.",
+                            "",
+                            "The per-update percentage caps velocity, not distance: measured",
+                            "against the live value each call, 5% steps compound to ~2.65× in 20",
+                            "updates and ~131× in 100, so a manager — or a malfunctioning bot —",
+                            "can walk the pool price arbitrarily far using only individually legal",
+                            "moves. This band is the distance limit.",
+                            "",
+                            "Anchored to `actual_balance` rather than to a captured snapshot on",
+                            "purpose: real reserves only move when capital actually enters or",
+                            "leaves, so the baseline cannot go stale the way a stored snapshot",
+                            "does. Tokens with `actual_balance == 0` (sidelined) are exempt —",
+                            "there is no real capital to anchor against.",
+                            "",
+                            "Appended at the END (before `reserved`) per the layout rule above, so",
+                            "every pre-existing field keeps its byte offset. Pre-upgrade pools",
+                            "decode this as `0` (band disabled), which is the back-compatible",
+                            "reading."
+                        ],
+                        "type": "u32"
+                    },
+                    {
+                        "name": "range_manager_min_leverage_bps",
+                        "docs": [
+                            "Lower half of the range manager's absolute envelope: the SMALLEST",
+                            "`virtual_balance / actual_balance` ratio it may leave a token at, in",
+                            "`PERCENT_SCALE` units. `0` disables the floor.",
+                            "",
+                            "The ceiling alone was not an envelope. Output is priced off VIRTUAL",
+                            "balances, so DEPRESSING a token's virtual balance makes the pool",
+                            "believe it holds less than it does, and a sale into that token moves",
+                            "the price far more than it should — the seller takes the other side's",
+                            "real reserves at a fabricated rate. Fifty individually-legal 5% steps",
+                            "took a 1M/1M pool's virtual balance down to ~77k in testing, after",
+                            "which selling 100k returned ~565k instead of ~91k. Every step passed",
+                            "the ceiling, because the ceiling only ever looks upward.",
+                            "",
+                            "Checked on the same terms as the ceiling: only over the slots a call",
+                            "actually writes, and skipped for sidelined tokens (`actual_balance ==",
+                            "0`), which have no capital to anchor a ratio against."
+                        ],
+                        "type": "u32"
+                    },
+                    {
+                        "name": "reserved",
+                        "docs": [
+                            "Forward-compat padding for pool-level fields. Shrank 24 → 20 when",
+                            "`range_manager_max_leverage_bps` was carved out of it, then 20 → 16 for",
+                            "`range_manager_min_leverage_bps`, keeping `LEN` at the",
+                            "mainnet-compatible 1683."
+                        ],
+                        "type": {
+                            "array": [
+                                "u8",
+                                16
+                            ]
+                        }
+                    }
+                ]
+            }
+        },
+        {
+            "name": "CubicPoolConfig",
+            "docs": [
+                "`CubicPoolConfig` — protocol-level governance for every pool created",
+                "against this account.",
+                "",
+                "One config can host many pools (each pool stores `config: Pubkey`).",
+                "Per-pool admin (level-1: rotates `swap_fee_rate`, toggles `swaps_enabled`)",
+                "lives on `CubicPool::pool_admin`. This config carries only the",
+                "protocol-level admin (level-2) plus protocol-wide defaults."
+            ],
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "protocol_admin",
+                        "docs": [
+                            "Protocol-level admin. Allowed to: pause pools, change",
+                            "`protocol_fee_rate`, collect protocol fees, drain via",
+                            "`debug_withdraw_liquidity`, update `banned_extensions`, withdraw",
+                            "SOL from program-owned accounts, and rotate itself via the",
+                            "pending/accept flow. Set to a designated authority (typically the",
+                            "Treasury PDA of the `protocol-admin` program) at config init."
+                        ],
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "pending_protocol_admin",
+                        "docs": [
+                            "Pending successor for `protocol_admin` during a 2-step transfer.",
+                            "`Pubkey::default()` ⇒ no transfer in flight."
+                        ],
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "default_protocol_fee_rate",
+                        "docs": [
+                            "Default `protocol_fee_rate` (in basis points, max 5000 = 50%) seeded",
+                            "onto every new pool created against this config. Pools may diverge",
+                            "later via `set_protocol_fee_rate`."
+                        ],
+                        "type": "u16"
+                    },
+                    {
+                        "name": "banned_extensions",
+                        "docs": [
+                            "Bitmap of banned Token-2022 extension types. Bit N set ⇒ extension",
+                            "type N is rejected at pool init. Maintained by `protocol_admin` via",
+                            "`set_banned_extensions`. Defaults to `DEFAULT_BANNED_EXTENSIONS`",
+                            "(TransferFee, ConfidentialTransfer, NonTransferable, …)."
+                        ],
+                        "type": "u64"
+                    },
+                    {
+                        "name": "hard_banned_extensions",
+                        "docs": [
+                            "Extension bits that **no pool creator may clear**, whatever",
+                            "`banned_extensions_override` they pass to `initialize_cubic_pool`.",
+                            "OR-ed into the effective bitmap at pool creation.",
+                            "",
+                            "`banned_extensions` above is only a *default* — a creator passing",
+                            "`Some(0)` un-bans everything, which would let a mint with",
+                            "`PermanentDelegate` (issuer can empty the vault) or an armed",
+                            "`TransferHook` (issuer can make every exit revert) into pool custody,",
+                            "with the loss landing on whoever supplied the other side.",
+                            "",
+                            "Seeded from `constants::HARD_BANNED_EXTENSIONS` at config creation",
+                            "and movable only by `protocol_admin`. It is governance state rather",
+                            "than a compile-time constant on purpose: several regulated",
+                            "stablecoins (PYUSD, USDG, AUSD) ship `PermanentDelegate` for",
+                            "compliance seizure, so listing them is a deliberate protocol",
+                            "decision about trusting a named issuer — not something a pool",
+                            "creator may self-authorise, and not something a hardcoded constant",
+                            "should decide for every deployment.",
+                            "",
+                            "Pre-upgrade configs decode this as `0`; `initialize_config` seeds it",
+                            "for new ones, and `set_banned_extensions` can set it explicitly."
+                        ],
+                        "type": "u64"
+                    },
+                    {
+                        "name": "reserved",
+                        "docs": [
+                            "Forward-compatibility padding so future fields can be added without",
+                            "migrating existing config accounts. Shrank 120 → 112 when",
+                            "`hard_banned_extensions` was carved out of the tail."
+                        ],
+                        "type": {
+                            "array": [
+                                "u8",
+                                112
+                            ]
+                        }
+                    }
+                ]
+            }
+        },
+        {
+            "name": "DebugLiquidityWithdrawn",
+            "docs": [
+                "Emitted by `debug_withdraw_liquidity`. Listening for this event is the",
+                "canonical way for off-chain monitors to know that a pool has",
+                "transitioned to the \"bricked\" state — `actual_balances` and",
+                "`virtual_balances` no longer match vault holdings after this fires."
+            ],
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "pool",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "authority",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "token_amounts",
+                        "type": {
+                            "vec": "u64"
+                        }
+                    },
+                    {
+                        "name": "timestamp",
+                        "type": "i64"
+                    }
+                ]
+            }
+        },
+        {
+            "name": "LiquidityAdded",
+            "docs": [
+                "Emitted by `add_liquidity` after BPT is minted.",
+                "",
+                "# Fields",
+                "* `token_amounts` — what the user actually deposited (raw units, in",
+                "pool order)",
+                "* `bpt_amount`    — BPT minted to the user"
+            ],
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "pool",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "user",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "token_amounts",
+                        "type": {
+                            "vec": "u64"
+                        }
+                    },
+                    {
+                        "name": "bpt_amount",
+                        "type": "u64"
+                    },
+                    {
+                        "name": "timestamp",
+                        "type": "i64"
+                    }
+                ]
+            }
+        },
+        {
+            "name": "LiquidityRemoved",
+            "docs": [
+                "Emitted by `remove_liquidity` after BPT is burned. `bpt_amount` is the",
+                "**effective** burn (capped to `total_supply - MINIMUM_INITIAL_BPT`),",
+                "not the original request — clients reading this know exactly how much",
+                "supply changed."
+            ],
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "pool",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "user",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "bpt_amount",
+                        "type": "u64"
+                    },
+                    {
+                        "name": "token_amounts",
+                        "type": {
+                            "vec": "u64"
+                        }
+                    },
+                    {
+                        "name": "timestamp",
+                        "type": "i64"
+                    }
+                ]
+            }
+        },
+        {
+            "name": "MaxSelloffSet",
+            "docs": [
+                "Emitted by `set_max_selloff`. `max_selloff_pct` and",
+                "`max_selloff_period_length` are the post-update arrays of length",
+                "`token_count`. `max_selloff_pct[i]` is a percent of token i's virtual",
+                "balance in `PERCENT_SCALE` units (10_000 = 100%); `0` disables the",
+                "check for token i."
+            ],
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "pool",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "authority",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "max_selloff_pct",
+                        "type": {
+                            "vec": "u16"
+                        }
+                    },
+                    {
+                        "name": "max_selloff_period_length",
+                        "type": {
+                            "vec": "u32"
+                        }
+                    },
+                    {
+                        "name": "fee_threshold_pct",
+                        "docs": [
+                            "Surge-fee curve, per token (PERCENT_SCALE units)."
+                        ],
+                        "type": {
+                            "vec": "u16"
+                        }
+                    },
+                    {
+                        "name": "fee_slope_low_pct",
+                        "type": {
+                            "vec": "u16"
+                        }
+                    },
+                    {
+                        "name": "fee_slope_high_pct",
+                        "type": {
+                            "vec": "u16"
+                        }
+                    },
+                    {
+                        "name": "timestamp",
+                        "type": "i64"
+                    },
+                    {
+                        "name": "old_max_selloff_pct",
+                        "docs": [
+                            "Pre-update arrays (same length/order as the `*_pct` arrays above)",
+                            "for each of the five mutated per-token fields. Appended (wire",
+                            "append-only) so indexers get the full before/after of the policy."
+                        ],
+                        "type": {
+                            "vec": "u16"
+                        }
+                    },
+                    {
+                        "name": "old_max_selloff_period_length",
+                        "type": {
+                            "vec": "u32"
+                        }
+                    },
+                    {
+                        "name": "old_fee_threshold_pct",
+                        "type": {
+                            "vec": "u16"
+                        }
+                    },
+                    {
+                        "name": "old_fee_slope_low_pct",
+                        "type": {
+                            "vec": "u16"
+                        }
+                    },
+                    {
+                        "name": "old_fee_slope_high_pct",
+                        "type": {
+                            "vec": "u16"
+                        }
+                    }
+                ]
+            }
+        },
+        {
+            "name": "MaxSelloffWindowAdvanced",
+            "docs": [
+                "Emitted from inside `swap` whenever the sliding-window check for",
+                "`token_in_index` runs — this is the per-swap max-selloff WINDOW-FILL log.",
+                "Window fill = `effective_selloff / max_selloff_cap` (0..1). Carries the",
+                "resolved absolute cap and the vb-snapshot it was resolved against, plus",
+                "the raw window components (previous/current selloff, window_start).",
+                "",
+                "The static config `max_selloff_pct` is intentionally NOT included here",
+                "(it does not change during a swap) — it is logged by `MaxSelloffSet`",
+                "when the policy changes, and `cap = pct * vb_snapshot / PERCENT_SCALE`."
+            ],
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "pool",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "token_index",
+                        "type": "u8"
+                    },
+                    {
+                        "name": "effective_selloff",
+                        "type": "u64"
+                    },
+                    {
+                        "name": "max_selloff_cap",
+                        "type": "u64"
+                    },
+                    {
+                        "name": "vb_snapshot",
+                        "type": "u64"
+                    },
+                    {
+                        "name": "previous_selloff",
+                        "type": "u64"
+                    },
+                    {
+                        "name": "current_selloff",
+                        "type": "u64"
+                    },
+                    {
+                        "name": "window_start_timestamp",
+                        "type": "i64"
+                    },
+                    {
+                        "name": "timestamp",
+                        "type": "i64"
+                    }
+                ]
+            }
+        },
+        {
+            "name": "PoolAdminDisabled",
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "pool",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "old_admin",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "timestamp",
+                        "type": "i64"
+                    }
+                ]
+            }
+        },
+        {
+            "name": "PoolAdminTransferCancelled",
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "pool",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "admin",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "cancelled_pending",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "timestamp",
+                        "type": "i64"
+                    }
+                ]
+            }
+        },
+        {
+            "name": "PoolAdminTransferInitiated",
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "pool",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "current_admin",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "pending_admin",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "timestamp",
+                        "type": "i64"
+                    }
+                ]
+            }
+        },
+        {
+            "name": "PoolAdminTransferred",
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "pool",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "old_admin",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "new_admin",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "timestamp",
+                        "type": "i64"
+                    }
+                ]
+            }
+        },
+        {
+            "name": "PoolAltInitialized",
+            "docs": [
+                "Emitted by `initialize_pool_alt` once the ALT is created, extended",
+                "with all pool-scoped addresses, and frozen. Off-chain SDK / indexer",
+                "uses this as the signal that v0 transactions are usable for this pool."
+            ],
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "pool",
+                        "docs": [
+                            "Pool PDA."
+                        ],
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "lookup_table",
+                        "docs": [
+                            "Address Lookup Table account created."
+                        ],
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "authority",
+                        "docs": [
+                            "Wallet that authored creation (matches `pool.pool_admin` at the",
+                            "time of the call). After freeze the ALT has no authority."
+                        ],
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "address_count",
+                        "docs": [
+                            "Number of addresses written into the ALT."
+                        ],
+                        "type": "u8"
+                    },
+                    {
+                        "name": "timestamp",
+                        "docs": [
+                            "`Clock::unix_timestamp` at initialisation."
+                        ],
+                        "type": "i64"
+                    }
+                ]
+            }
+        },
+        {
+            "name": "PoolEnabledUpdated",
+            "docs": [
+                "Emitted by `set_pool_enabled`."
+            ],
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "pool",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "authority",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "old_value",
+                        "type": "bool"
+                    },
+                    {
+                        "name": "new_value",
+                        "type": "bool"
+                    },
+                    {
+                        "name": "timestamp",
+                        "type": "i64"
+                    }
+                ]
+            }
+        },
+        {
+            "name": "PoolInfo",
+            "docs": [
+                "Read-only view event emitted by the simulation-only `get_pool_info`",
+                "instruction. Off-chain clients call `simulate({ commitment: ... })`",
+                "and parse this event from the returned logs. Strictly more verbose",
+                "than `PoolStateLog` (also includes derived addresses)."
+            ],
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "pool",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "config",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "bpt_mint",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "token_count",
+                        "type": "u8"
+                    },
+                    {
+                        "name": "pool_id",
+                        "type": "u64"
+                    },
+                    {
+                        "name": "tokens",
+                        "type": {
+                            "vec": "pubkey"
+                        }
+                    },
+                    {
+                        "name": "token_vaults",
+                        "type": {
+                            "vec": "pubkey"
+                        }
+                    },
+                    {
+                        "name": "normalized_weights",
+                        "type": {
+                            "vec": "u64"
+                        }
+                    },
+                    {
+                        "name": "virtual_balances",
+                        "type": {
+                            "vec": "u64"
+                        }
+                    },
+                    {
+                        "name": "actual_balances",
+                        "type": {
+                            "vec": "u64"
+                        }
+                    },
+                    {
+                        "name": "protocol_fees_owed",
+                        "type": {
+                            "vec": "u64"
+                        }
+                    },
+                    {
+                        "name": "swap_fee_rate",
+                        "type": "u32"
+                    },
+                    {
+                        "name": "protocol_fee_rate",
+                        "type": "u16"
+                    },
+                    {
+                        "name": "pool_enabled",
+                        "type": "bool"
+                    },
+                    {
+                        "name": "swaps_enabled",
+                        "type": "bool"
+                    },
+                    {
+                        "name": "token_programs",
+                        "type": {
+                            "vec": "pubkey"
+                        }
+                    },
+                    {
+                        "name": "timestamp",
+                        "type": "i64"
+                    }
+                ]
+            }
+        },
+        {
+            "name": "PoolInitialized",
+            "docs": [
+                "Emitted at the end of `initialize_cubic_pool`. Marks a new pool live.",
+                "",
+                "# Fields",
+                "* `pool`        — pool PDA pubkey",
+                "* `config`      — parent config pubkey",
+                "* `token_count` — active tokens (2..=10)",
+                "* `bpt_mint`    — BPT mint PDA pubkey",
+                "* `timestamp`   — `Clock::unix_timestamp` at init",
+                "* `banned_extensions` — the effective Token-2022 extension blocklist the",
+                "creator's tokens were vetted against (override, or the config default)."
+            ],
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "pool",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "config",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "token_count",
+                        "type": "u8"
+                    },
+                    {
+                        "name": "bpt_mint",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "timestamp",
+                        "type": "i64"
+                    },
+                    {
+                        "name": "banned_extensions",
+                        "docs": [
+                            "Appended (wire append-only): effective per-pool banned-extensions bitmap."
+                        ],
+                        "type": "u64"
+                    }
+                ]
+            }
+        },
+        {
+            "name": "PoolMigratedToV5",
+            "docs": [
+                "Emitted by `migrate_to_v5`. Marks an in-place storage migration that",
+                "re-interprets the (same-size, 1683-byte) v4 account under a newer field",
+                "layout: the bytes that previously held `max_selloff: u64` /",
+                "`max_selloff_period_length: u32` / `reserved` now decode as",
+                "`max_selloff_pct` + the surge-fee curve + `is_active`. The only field",
+                "that needs a value rewrite is `is_active` — pre-migration it decodes as",
+                "`false` (old `reserved[0] == 0`), so the migration flips every active",
+                "token's `is_active` back to `true` (the intended default)."
+            ],
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "pool",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "authority",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "token_count",
+                        "type": "u8"
+                    },
+                    {
+                        "name": "reactivated",
+                        "docs": [
+                            "How many token slots were flipped from inactive→active (0 ⇒ pool was",
+                            "already migrated / created post-upgrade — idempotent no-op)."
+                        ],
+                        "type": "u8"
+                    },
+                    {
+                        "name": "timestamp",
+                        "type": "i64"
+                    }
+                ]
+            }
+        },
+        {
+            "name": "PoolSolWithdrawn",
+            "docs": [
+                "Emitted by `withdraw_sol` when SOL is recovered from a cubic-pool-owned",
+                "account."
+            ],
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "source",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "authority",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "recipient",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "amount",
+                        "type": "u64"
+                    },
+                    {
+                        "name": "timestamp",
+                        "type": "i64"
+                    }
+                ]
+            }
+        },
+        {
+            "name": "PoolStateLog",
+            "docs": [
+                "Mutating-instruction state snapshot consumed by the backend indexer to",
+                "keep its denormalised pool table in sync without an additional account",
+                "fetch. Emitted by `swap`, `add_liquidity`, and `remove_liquidity`.",
+                "",
+                "NOTE: BPT total supply is intentionally NOT included — it is redundant",
+                "with the BPT mint account (which indexers already stream) and was a",
+                "misleading hardcoded `0` on `swap`. Read supply from the mint at the",
+                "tx slot instead."
+            ],
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "pool",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "virtual_balances",
+                        "type": {
+                            "vec": "u64"
+                        }
+                    },
+                    {
+                        "name": "actual_balances",
+                        "type": {
+                            "vec": "u64"
+                        }
+                    },
+                    {
+                        "name": "protocol_fees_owed",
+                        "type": {
+                            "vec": "u64"
+                        }
+                    },
+                    {
+                        "name": "timestamp",
+                        "type": "i64"
+                    }
+                ]
+            }
+        },
+        {
+            "name": "ProtocolAdminTransferCancelled",
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "config",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "admin",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "cancelled_pending",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "timestamp",
+                        "type": "i64"
+                    }
+                ]
+            }
+        },
+        {
+            "name": "ProtocolAdminTransferInitiated",
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "config",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "current_admin",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "pending_admin",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "timestamp",
+                        "type": "i64"
+                    }
+                ]
+            }
+        },
+        {
+            "name": "ProtocolAdminTransferred",
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "config",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "old_admin",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "new_admin",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "timestamp",
+                        "type": "i64"
+                    }
+                ]
+            }
+        },
+        {
+            "name": "ProtocolFeeRateUpdated",
+            "docs": [
+                "Emitted by `set_protocol_fee_rate`."
+            ],
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "pool",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "old_rate",
+                        "type": "u16"
+                    },
+                    {
+                        "name": "new_rate",
+                        "type": "u16"
+                    },
+                    {
+                        "name": "timestamp",
+                        "type": "i64"
+                    },
+                    {
+                        "name": "authority",
+                        "docs": [
+                            "Protocol admin (Treasury PDA) that changed the rate. Appended."
+                        ],
+                        "type": "pubkey"
+                    }
+                ]
+            }
+        },
+        {
+            "name": "ProtocolFeesCollected",
+            "docs": [
+                "Emitted by `collect_protocol_fees` once per call (one event covers all",
+                "tokens, with zero-amounts kept in `token_amounts` to preserve order)."
+            ],
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "pool",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "authority",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "token_amounts",
+                        "type": {
+                            "vec": "u64"
+                        }
+                    },
+                    {
+                        "name": "timestamp",
+                        "type": "i64"
+                    }
+                ]
+            }
+        },
+        {
+            "name": "RangeManagerConfigSet",
+            "docs": [
+                "Emitted by `set_range_manager_config`. Carries the full effective",
+                "envelope so off-chain indexers don't need to re-fetch the pool."
+            ],
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "pool",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "authority",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "max_vb_change_pct",
+                        "docs": [
+                            "New percent-of-current-value change caps, in `PERCENT_SCALE` units",
+                            "(10_000 = 100%)."
+                        ],
+                        "type": "u16"
+                    },
+                    {
+                        "name": "max_weight_change_pct",
+                        "type": "u16"
+                    },
+                    {
+                        "name": "min_update_interval_secs",
+                        "type": "u32"
+                    },
+                    {
+                        "name": "timestamp",
+                        "type": "i64"
+                    },
+                    {
+                        "name": "old_max_vb_change_pct",
+                        "docs": [
+                            "Pre-update values of the three fields above. Appended (wire",
+                            "append-only) so indexers get the full before/after."
+                        ],
+                        "type": "u16"
+                    },
+                    {
+                        "name": "old_max_weight_change_pct",
+                        "type": "u16"
+                    },
+                    {
+                        "name": "old_min_update_interval_secs",
+                        "type": "u32"
+                    },
+                    {
+                        "name": "old_max_leverage_bps",
+                        "docs": [
+                            "Absolute `virtual/actual` band the manager must stay inside, in bps",
+                            "(`0` = disabled). Appended (wire append-only)."
+                        ],
+                        "type": "u32"
+                    },
+                    {
+                        "name": "new_max_leverage_bps",
+                        "type": "u32"
+                    }
+                ]
+            }
+        },
+        {
+            "name": "RangeManagerSet",
+            "docs": [
+                "Emitted by `set_range_manager`. Both the pubkey and the enabled flag",
+                "are bundled into a single event. `new_manager == Pubkey::default()`",
+                "AND `enabled = false` is the \"fully disabled\" state."
+            ],
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "pool",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "authority",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "old_manager",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "new_manager",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "enabled",
+                        "docs": [
+                            "New value of `range_manager_enabled` (kept for back-compat; the",
+                            "`old_enabled`/`new_enabled` pair below carries the full before/after)."
+                        ],
+                        "type": "bool"
+                    },
+                    {
+                        "name": "timestamp",
+                        "type": "i64"
+                    },
+                    {
+                        "name": "old_enabled",
+                        "docs": [
+                            "Before/after of `range_manager_enabled`. Appended (wire append-only)."
+                        ],
+                        "type": "bool"
+                    },
+                    {
+                        "name": "new_enabled",
+                        "type": "bool"
+                    }
+                ]
+            }
+        },
+        {
+            "name": "RangeManagerUpdated",
+            "docs": [
+                "Emitted by `range_manager_update` after every check passes and state",
+                "is committed. `vb_indices` / `vb_new_values` and `weight_indices` /",
+                "`weight_new_values` are aligned slices (may be empty)."
+            ],
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "pool",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "manager",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "vb_indices",
+                        "type": "bytes"
+                    },
+                    {
+                        "name": "vb_new_values",
+                        "type": {
+                            "vec": "u64"
+                        }
+                    },
+                    {
+                        "name": "weight_indices",
+                        "type": "bytes"
+                    },
+                    {
+                        "name": "weight_new_values",
+                        "type": {
+                            "vec": "u64"
+                        }
+                    },
+                    {
+                        "name": "timestamp",
+                        "type": "i64"
+                    }
+                ]
+            }
+        },
+        {
+            "name": "SelloffParams",
+            "docs": [
+                "Per-token sell-off policy. One entry per active token (in pool order).",
+                "",
+                "All `_pct` fields are in `PERCENT_SCALE` units (10_000 = 100%)."
+            ],
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "max_selloff_pct",
+                        "docs": [
+                            "Max cumulative sell volume per window, as a percent of the token's",
+                            "virtual balance (snapshot at window open). `0` disables the cap",
+                            "AND the surge fee for this token. Must be `<= PERCENT_SCALE`."
+                        ],
+                        "type": "u16"
+                    },
+                    {
+                        "name": "period_length",
+                        "docs": [
+                            "Sliding-window length in seconds. Must be `> 0` when",
+                            "`max_selloff_pct > 0`."
+                        ],
+                        "type": "u32"
+                    },
+                    {
+                        "name": "fee_threshold_pct",
+                        "docs": [
+                            "Surge fee: window-fill ratio at which the fee starts (below it the",
+                            "fee is 0). Must be `< PERCENT_SCALE` when `fee_slope_high_pct > 0`."
+                        ],
+                        "type": "u16"
+                    },
+                    {
+                        "name": "fee_slope_low_pct",
+                        "docs": [
+                            "Surge fee at the threshold (lower curve point)."
+                        ],
+                        "type": "u16"
+                    },
+                    {
+                        "name": "fee_slope_high_pct",
+                        "docs": [
+                            "Surge fee at ~100% window fill (upper curve point). `0` disables the",
+                            "surge fee. Must be `>= fee_slope_mid_pct` and `<= PERCENT_SCALE`."
+                        ],
+                        "type": "u16"
+                    },
+                    {
+                        "name": "fee_slope_mid_pct",
+                        "docs": [
+                            "Surge fee at the KINK — the middle of the three points.",
+                            "",
+                            "Appended at the END of this struct, not slotted next to the other two",
+                            "slope fields: Borsh encodes instruction arguments positionally, so",
+                            "inserting mid-struct would silently reinterpret every later field for",
+                            "clients built against the previous IDL.",
+                            "",
+                            "Must satisfy `fee_slope_low_pct <= fee_slope_mid_pct <=",
+                            "fee_slope_high_pct`."
+                        ],
+                        "type": "u16"
+                    },
+                    {
+                        "name": "fee_kink_pct",
+                        "docs": [
+                            "Window fill at which the curve kinks, in WHOLE PERCENT (0..=100).",
+                            "",
+                            "`0` means \"no kink\": one straight line from `fee_slope_low_pct` at the",
+                            "threshold to `fee_slope_high_pct` at full fill. When non-zero it must",
+                            "sit STRICTLY between the threshold and full fill — a kink at either",
+                            "end degenerates one of the two segments to zero width."
+                        ],
+                        "type": "u8"
+                    }
+                ]
+            }
+        },
+        {
+            "name": "Swap",
+            "docs": [
+                "Emitted by `swap` after the trade executes.",
+                "",
+                "# Fields",
+                "* `pool`               — pool PDA",
+                "* `user`               — signer that initiated the swap",
+                "* `token_in/out`       — mint pubkeys of the two legs",
+                "* `amount_in/out`      — raw token units (pre-fee on input side)",
+                "* `fee_amount`         — total swap fee (raw units, in token_in)",
+                "* `protocol_fee_amount`— share of `fee_amount` that went to the",
+                "protocol-fees-owed bucket (raw units, in token_in)",
+                "* `timestamp`          — `Clock::unix_timestamp`"
+            ],
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "pool",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "user",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "token_in",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "token_out",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "amount_in",
+                        "type": "u64"
+                    },
+                    {
+                        "name": "amount_out",
+                        "docs": [
+                            "Amount the user RECEIVES — net of the variable sell-off surge fee."
+                        ],
+                        "type": "u64"
+                    },
+                    {
+                        "name": "fee_amount",
+                        "docs": [
+                            "Total base swap fee (raw units, in token_in)."
+                        ],
+                        "type": "u64"
+                    },
+                    {
+                        "name": "protocol_fee_amount",
+                        "docs": [
+                            "Protocol share of the base swap fee (raw units, in token_in)."
+                        ],
+                        "type": "u64"
+                    },
+                    {
+                        "name": "timestamp",
+                        "type": "i64"
+                    },
+                    {
+                        "name": "surge_fee_amount",
+                        "docs": [
+                            "Variable sell-off surge fee taken from the OUTPUT token and routed",
+                            "100% to the protocol bucket. `0` in the common case.",
+                            "",
+                            "Borsh encodes positionally, so every field added after the original",
+                            "`timestamp` tail must stay AFTER it — otherwise an indexer decoding a",
+                            "pre-upgrade event with the new IDL misreads every following field."
+                        ],
+                        "type": "u64"
+                    }
+                ]
+            }
+        },
+        {
+            "name": "SwapFeeRateUpdated",
+            "docs": [
+                "Emitted by `set_swap_fee_rate`. Carries both old and new for cheap",
+                "audit reconstruction without re-reading prior state."
+            ],
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "pool",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "old_rate",
+                        "type": "u32"
+                    },
+                    {
+                        "name": "new_rate",
+                        "type": "u32"
+                    },
+                    {
+                        "name": "timestamp",
+                        "type": "i64"
+                    },
+                    {
+                        "name": "authority",
+                        "docs": [
+                            "Pool admin that changed the rate. Appended (wire-format append-only)."
+                        ],
+                        "type": "pubkey"
+                    }
+                ]
+            }
+        },
+        {
+            "name": "SwapsEnabledUpdated",
+            "docs": [
+                "Emitted by `set_swaps_enabled`."
+            ],
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "pool",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "authority",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "old_value",
+                        "type": "bool"
+                    },
+                    {
+                        "name": "new_value",
+                        "type": "bool"
+                    },
+                    {
+                        "name": "timestamp",
+                        "type": "i64"
+                    }
+                ]
+            }
+        },
+        {
+            "name": "TokenActiveSet",
+            "docs": [
+                "Emitted by `set_token_active`. Carries the token index, the old/new",
+                "`is_active` flag, and the authority that flipped it."
+            ],
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "pool",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "authority",
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "token_index",
+                        "type": "u8"
+                    },
+                    {
+                        "name": "old_value",
+                        "type": "bool"
+                    },
+                    {
+                        "name": "new_value",
+                        "type": "bool"
+                    },
+                    {
+                        "name": "timestamp",
+                        "type": "i64"
+                    }
+                ]
+            }
+        },
+        {
+            "name": "TokenChange",
+            "docs": [
+                "Single change entry: \"I believe slot `index` currently holds",
+                "`expected_current`; set it to `new_value`\".",
+                "",
+                "`expected_current` is a compare-and-swap guard, not decoration. The",
+                "manager computes `new_value` off-chain against whatever it last observed,",
+                "then submits a transaction that lands some slots later. Without the",
+                "guard the write is unconditional, so any swap or liquidity operation that",
+                "landed in between is silently reset — and that window is a property of",
+                "Solana's read-then-submit latency, not of operator care, so a careful",
+                "manager cannot avoid it. Anyone able to time a swap into the gap can have",
+                "its price effect erased."
+            ],
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "index",
+                        "type": "u8"
+                    },
+                    {
+                        "name": "expected_current",
+                        "type": "u64"
+                    },
+                    {
+                        "name": "new_value",
+                        "type": "u64"
+                    }
+                ]
+            }
+        },
+        {
+            "name": "TokenSlot",
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "config",
+                        "type": {
+                            "defined": {
+                                "name": "AssetConfig"
+                            }
+                        }
+                    },
+                    {
+                        "name": "dynamics",
+                        "type": {
+                            "defined": {
+                                "name": "AssetDynamics"
+                            }
+                        }
+                    }
+                ]
+            }
+        }
+    ]
+}