@velocity-exchange/sdk 0.0.5 → 0.1.0

package/lib/browser/idl/{drift.json → velocity.json}

@@ -1,7 +1,7 @@
 {
     "address": "vELoC1audYbSYVRXn1vPaV8Axoa9oU6BYmNGZZBDZ1P",
     "metadata": {
-        "name": "drift",
+        "name": "velocity",
         "version": "2.162.0",
         "spec": "0.1.0",
         "description": "Created with Anchor"
@@ -250,7 +250,7 @@
                     }
                 },
                 {
-                    "name": "drift_signer"
+                    "name": "velocity_signer"
                 },
                 {
                     "name": "user_token_account",
@@ -537,7 +537,7 @@
                     "name": "token_program"
                 },
                 {
-                    "name": "drift_signer"
+                    "name": "velocity_signer"
                 }
             ],
             "args": [
@@ -662,7 +662,7 @@
                     "name": "token_program"
                 },
                 {
-                    "name": "drift_signer"
+                    "name": "velocity_signer"
                 },
                 {
                     "name": "instructions",
@@ -934,7 +934,7 @@
                     "name": "token_program"
                 },
                 {
-                    "name": "drift_signer"
+                    "name": "velocity_signer"
                 },
                 {
                     "name": "instructions",
@@ -1534,7 +1534,7 @@
                     }
                 },
                 {
-                    "name": "drift_signer"
+                    "name": "velocity_signer"
                 },
                 {
                     "name": "token_program"
@@ -1958,7 +1958,7 @@
                     "name": "token_program"
                 },
                 {
-                    "name": "drift_signer"
+                    "name": "velocity_signer"
                 }
             ],
             "args": [
@@ -2087,7 +2087,7 @@
                     "writable": true
                 },
                 {
-                    "name": "drift_signer"
+                    "name": "velocity_signer"
                 },
                 {
                     "name": "quote_spot_market",
@@ -2450,7 +2450,7 @@
                     "name": "token_program"
                 },
                 {
-                    "name": "drift_signer"
+                    "name": "velocity_signer"
                 },
                 {
                     "name": "instructions",
@@ -2714,7 +2714,7 @@
                     "name": "token_program"
                 },
                 {
-                    "name": "drift_signer"
+                    "name": "velocity_signer"
                 },
                 {
                     "name": "instructions",
@@ -2873,7 +2873,7 @@
                     "signer": true
                 },
                 {
-                    "name": "drift_signer"
+                    "name": "velocity_signer"
                 }
             ],
             "args": []
@@ -2884,11 +2884,11 @@
                 "Devnet-only escape hatch: cleans up accounts stranded by a layout-breaking",
                 "program upgrade (or by a partial re-init). For each account passed via",
                 "`remaining_accounts`:",
-                "- drift-owned PDA → drain lamports (runtime GCs at end of tx)",
-                "- token-program owned vault (drift_signer close-authority) → CPI",
+                "- velocity-owned PDA → drain lamports (runtime GCs at end of tx)",
+                "- token-program owned vault (velocity_signer close-authority) → CPI",
                 "`close_account`, rent refunded to admin",
                 "Admin gate reads State's first pubkey field at raw offset 8..40 so it",
-                "works regardless of the State layout currently on chain. `drift_signer_nonce`",
+                "works regardless of the State layout currently on chain. `velocity_signer_nonce`",
                 "must match `State.signer_nonce`; mismatch fails the token CPI signature.",
                 "Stripped from mainnet builds via `mainnet-beta`."
             ],
@@ -2915,7 +2915,7 @@
                     ]
                 },
                 {
-                    "name": "drift_signer",
+                    "name": "velocity_signer",
                     "docs": [
                         "at CPI time when closing token vaults; ignored otherwise."
                     ]
@@ -2926,7 +2926,7 @@
             ],
             "args": [
                 {
-                    "name": "drift_signer_nonce",
+                    "name": "velocity_signer_nonce",
                     "type": "u8"
                 }
             ]
@@ -2957,11 +2957,14 @@
                             {
                                 "kind": "const",
                                 "value": [
-                                    100,
-                                    114,
+                                    118,
+                                    101,
+                                    108,
+                                    111,
+                                    99,
                                     105,
-                                    102,
                                     116,
+                                    121,
                                     95,
                                     115,
                                     116,
@@ -2977,7 +2980,7 @@
                     "name": "quote_asset_mint"
                 },
                 {
-                    "name": "drift_signer"
+                    "name": "velocity_signer"
                 },
                 {
                     "name": "rent",
@@ -4552,7 +4555,7 @@
                     }
                 },
                 {
-                    "name": "drift_signer"
+                    "name": "velocity_signer"
                 },
                 {
                     "name": "state",
@@ -5053,17 +5056,9 @@
                     "name": "liquidator",
                     "writable": true
                 },
-                {
-                    "name": "liquidator_stats",
-                    "writable": true
-                },
                 {
                     "name": "user",
                     "writable": true
-                },
-                {
-                    "name": "user_stats",
-                    "writable": true
                 }
             ],
             "args": [
@@ -5111,18 +5106,10 @@
                     "name": "liquidator",
                     "writable": true
                 },
-                {
-                    "name": "liquidator_stats",
-                    "writable": true
-                },
                 {
                     "name": "user",
                     "writable": true
                 },
-                {
-                    "name": "user_stats",
-                    "writable": true
-                },
                 {
                     "name": "liability_spot_market_vault",
                     "writable": true,
@@ -5203,7 +5190,7 @@
                     "name": "token_program"
                 },
                 {
-                    "name": "drift_signer"
+                    "name": "velocity_signer"
                 },
                 {
                     "name": "instructions",
@@ -5252,18 +5239,10 @@
                     "name": "liquidator",
                     "writable": true
                 },
-                {
-                    "name": "liquidator_stats",
-                    "writable": true
-                },
                 {
                     "name": "user",
                     "writable": true
                 },
-                {
-                    "name": "user_stats",
-                    "writable": true
-                },
                 {
                     "name": "liability_spot_market_vault",
                     "writable": true,
@@ -5344,7 +5323,7 @@
                     "name": "token_program"
                 },
                 {
-                    "name": "drift_signer"
+                    "name": "velocity_signer"
                 },
                 {
                     "name": "instructions",
@@ -5576,7 +5555,7 @@
                     "name": "state"
                 },
                 {
-                    "name": "drift_signer"
+                    "name": "velocity_signer"
                 },
                 {
                     "name": "lp_pool",
@@ -6875,7 +6854,7 @@
                     }
                 },
                 {
-                    "name": "drift_signer"
+                    "name": "velocity_signer"
                 },
                 {
                     "name": "user_token_account",
@@ -7300,7 +7279,7 @@
                     }
                 },
                 {
-                    "name": "drift_signer"
+                    "name": "velocity_signer"
                 },
                 {
                     "name": "token_program"
@@ -7409,7 +7388,7 @@
                     }
                 },
                 {
-                    "name": "drift_signer"
+                    "name": "velocity_signer"
                 },
                 {
                     "name": "token_program"
@@ -7534,7 +7513,7 @@
                     }
                 },
                 {
-                    "name": "drift_signer"
+                    "name": "velocity_signer"
                 },
                 {
                     "name": "token_program"
@@ -7903,7 +7882,7 @@
                     "name": "token_program"
                 },
                 {
-                    "name": "drift_signer"
+                    "name": "velocity_signer"
                 }
             ],
             "args": []
@@ -8055,7 +8034,7 @@
                     }
                 },
                 {
-                    "name": "drift_signer"
+                    "name": "velocity_signer"
                 },
                 {
                     "name": "insurance_fund_vault",
@@ -8225,6 +8204,86 @@
                 }
             ]
         },
+        {
+            "name": "transfer_deposit_by_delegate",
+            "discriminator": [
+                141,
+                171,
+                241,
+                161,
+                17,
+                31,
+                135,
+                29
+            ],
+            "accounts": [
+                {
+                    "name": "from_user",
+                    "writable": true
+                },
+                {
+                    "name": "to_user",
+                    "writable": true
+                },
+                {
+                    "name": "user_stats"
+                },
+                {
+                    "name": "delegate",
+                    "signer": true,
+                    "relations": [
+                        "from_user",
+                        "to_user"
+                    ]
+                },
+                {
+                    "name": "state"
+                },
+                {
+                    "name": "spot_market_vault",
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const",
+                                "value": [
+                                    115,
+                                    112,
+                                    111,
+                                    116,
+                                    95,
+                                    109,
+                                    97,
+                                    114,
+                                    107,
+                                    101,
+                                    116,
+                                    95,
+                                    118,
+                                    97,
+                                    117,
+                                    108,
+                                    116
+                                ]
+                            },
+                            {
+                                "kind": "arg",
+                                "path": "market_index"
+                            }
+                        ]
+                    }
+                }
+            ],
+            "args": [
+                {
+                    "name": "market_index",
+                    "type": "u16"
+                },
+                {
+                    "name": "amount",
+                    "type": "u64"
+                }
+            ]
+        },
         {
             "name": "transfer_fee_and_pnl_pool",
             "discriminator": [
@@ -8634,7 +8693,7 @@
                     }
                 },
                 {
-                    "name": "drift_signer"
+                    "name": "velocity_signer"
                 }
             ],
             "args": [
@@ -8768,7 +8827,7 @@
                     "name": "token_program"
                 },
                 {
-                    "name": "drift_signer"
+                    "name": "velocity_signer"
                 }
             ],
             "args": [
@@ -12619,6 +12678,61 @@
                 }
             ]
         },
+        {
+            "name": "update_user_allow_delegate_transfer",
+            "discriminator": [
+                235,
+                106,
+                172,
+                39,
+                223,
+                238,
+                167,
+                204
+            ],
+            "accounts": [
+                {
+                    "name": "user_stats",
+                    "writable": true,
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const",
+                                "value": [
+                                    117,
+                                    115,
+                                    101,
+                                    114,
+                                    95,
+                                    115,
+                                    116,
+                                    97,
+                                    116,
+                                    115
+                                ]
+                            },
+                            {
+                                "kind": "account",
+                                "path": "authority"
+                            }
+                        ]
+                    }
+                },
+                {
+                    "name": "authority",
+                    "signer": true,
+                    "relations": [
+                        "user_stats"
+                    ]
+                }
+            ],
+            "args": [
+                {
+                    "name": "allow_delegate_transfer",
+                    "type": "bool"
+                }
+            ]
+        },
         {
             "name": "update_user_custom_margin_ratio",
             "discriminator": [
@@ -13472,7 +13586,7 @@
             ],
             "accounts": [
                 {
-                    "name": "drift_signer"
+                    "name": "velocity_signer"
                 },
                 {
                     "name": "state"
@@ -13656,7 +13770,7 @@
                     }
                 },
                 {
-                    "name": "drift_signer"
+                    "name": "velocity_signer"
                 },
                 {
                     "name": "user_token_account",
@@ -13748,7 +13862,7 @@
                     }
                 },
                 {
-                    "name": "drift_signer"
+                    "name": "velocity_signer"
                 },
                 {
                     "name": "user_token_account",
@@ -13795,7 +13909,7 @@
                     "signer": true
                 },
                 {
-                    "name": "drift_signer"
+                    "name": "velocity_signer"
                 },
                 {
                     "name": "constituent",
@@ -14135,16 +14249,16 @@
             ]
         },
         {
-            "name": "CurveRecord",
+            "name": "AmmCurveChanged",
             "discriminator": [
-                101,
-                238,
-                40,
-                228,
-                70,
-                46,
-                61,
-                117
+                116,
+                12,
+                114,
+                18,
+                175,
+                31,
+                153,
+                5
             ]
         },
         {
@@ -15834,7 +15948,7 @@
         {
             "code": 6274,
             "name": "OracleWrongWriteAuthority",
-            "msg": "Oracle post update atomic price feed account must be drift program"
+            "msg": "Oracle post update atomic price feed account must be velocity program"
         },
         {
             "code": 6275,
@@ -16232,24 +16346,6 @@
             "type": {
                 "kind": "struct",
                 "fields": [
-                    {
-                        "name": "oracle",
-                        "docs": [
-                            "oracle price data public key"
-                        ],
-                        "type": "pubkey"
-                    },
-                    {
-                        "name": "historical_oracle_data",
-                        "docs": [
-                            "stores historically witnessed oracle data"
-                        ],
-                        "type": {
-                            "defined": {
-                                "name": "HistoricalOracleData"
-                            }
-                        }
-                    },
                     {
                         "name": "fee_pool",
                         "docs": [
@@ -16305,7 +16401,7 @@
                     {
                         "name": "sqrt_k",
                         "docs": [
-                            "`sqrt(k)` in constant product mm formula (x * y = k). stored to avoid drift caused by integer math issues",
+                            "`sqrt(k)` in constant product mm formula (x * y = k). stored to avoid velocity caused by integer math issues",
                             "precision: AMM_RESERVE_PRECISION"
                         ],
                         "type": "u128"
@@ -16326,22 +16422,6 @@
                         ],
                         "type": "u128"
                     },
-                    {
-                        "name": "base_asset_amount_long",
-                        "docs": [
-                            "always non-negative. tracks number of total longs in market (regardless of counterparty)",
-                            "precision: BASE_PRECISION"
-                        ],
-                        "type": "i128"
-                    },
-                    {
-                        "name": "base_asset_amount_short",
-                        "docs": [
-                            "always non-positive. tracks number of total shorts in market (regardless of counterparty)",
-                            "precision: BASE_PRECISION"
-                        ],
-                        "type": "i128"
-                    },
                     {
                         "name": "base_asset_amount_with_amm",
                         "docs": [
@@ -16351,232 +16431,71 @@
                         "type": "i128"
                     },
                     {
-                        "name": "max_open_interest",
+                        "name": "total_fee",
                         "docs": [
-                            "max allowed open interest, blocks trades that breach this value",
-                            "precision: BASE_PRECISION"
+                            "total fees collected by this perp market",
+                            "precision: QUOTE_PRECISION"
                         ],
-                        "type": "u128"
+                        "type": "i128"
                     },
                     {
-                        "name": "quote_asset_amount",
+                        "name": "total_mm_fee",
                         "docs": [
-                            "sum of all user's perp quote_asset_amount in market",
+                            "total fees collected by the vAMM's bid/ask spread",
                             "precision: QUOTE_PRECISION"
                         ],
                         "type": "i128"
                     },
                     {
-                        "name": "quote_entry_amount_long",
+                        "name": "total_fee_minus_distributions",
                         "docs": [
-                            "sum of all long user's quote_entry_amount in market",
+                            "total fees minus any recognized upnl and pool withdraws",
                             "precision: QUOTE_PRECISION"
                         ],
                         "type": "i128"
                     },
                     {
-                        "name": "quote_entry_amount_short",
+                        "name": "total_fee_withdrawn",
                         "docs": [
-                            "sum of all short user's quote_entry_amount in market",
+                            "sum of all fees from fee pool withdrawn to revenue pool",
                             "precision: QUOTE_PRECISION"
                         ],
-                        "type": "i128"
+                        "type": "u128"
                     },
                     {
-                        "name": "quote_break_even_amount_long",
+                        "name": "ask_base_asset_reserve",
                         "docs": [
-                            "sum of all long user's quote_break_even_amount in market",
-                            "precision: QUOTE_PRECISION"
+                            "Cached spread-adjusted reserves for the ask (long-take) side, derived",
+                            "from `long_spread` + `reference_price_offset`. Refreshed by",
+                            "[`crate::vlp::amm::math::spread::update_amm_quote_state`] on every AMM crank",
+                            "/ fill `setup`; quote/fill paths read these directly instead of",
+                            "recomputing per quote. Also surfaced to dashboards/tracking.",
+                            "precision: AMM_RESERVE_PRECISION"
                         ],
-                        "type": "i128"
+                        "type": "u128"
                     },
                     {
-                        "name": "quote_break_even_amount_short",
+                        "name": "ask_quote_asset_reserve",
                         "docs": [
-                            "sum of all short user's quote_break_even_amount in market",
-                            "precision: QUOTE_PRECISION"
+                            "precision: AMM_RESERVE_PRECISION"
                         ],
-                        "type": "i128"
+                        "type": "u128"
                     },
                     {
-                        "name": "last_funding_rate",
+                        "name": "bid_base_asset_reserve",
                         "docs": [
-                            "last funding rate in this perp market (unit is quote per base)",
-                            "precision: FUNDING_RATE_PRECISION"
+                            "Cached spread-adjusted reserves for the bid (short-take) side.",
+                            "precision: AMM_RESERVE_PRECISION"
                         ],
-                        "type": "i64"
+                        "type": "u128"
                     },
                     {
-                        "name": "last_funding_rate_long",
+                        "name": "bid_quote_asset_reserve",
                         "docs": [
-                            "last funding rate for longs in this perp market (unit is quote per base)",
-                            "precision: FUNDING_RATE_PRECISION"
-                        ],
-                        "type": "i64"
-                    },
-                    {
-                        "name": "last_funding_rate_short",
-                        "docs": [
-                            "last funding rate for shorts in this perp market (unit is quote per base)",
-                            "precision: QUOTE_PRECISION"
-                        ],
-                        "type": "i64"
-                    },
-                    {
-                        "name": "last_24h_avg_funding_rate",
-                        "docs": [
-                            "estimate of last 24h of funding rate perp market (unit is quote per base)",
-                            "precision: QUOTE_PRECISION"
-                        ],
-                        "type": "i64"
-                    },
-                    {
-                        "name": "total_fee",
-                        "docs": [
-                            "total fees collected by this perp market",
-                            "precision: QUOTE_PRECISION"
-                        ],
-                        "type": "i128"
-                    },
-                    {
-                        "name": "total_mm_fee",
-                        "docs": [
-                            "total fees collected by the vAMM's bid/ask spread",
-                            "precision: QUOTE_PRECISION"
-                        ],
-                        "type": "i128"
-                    },
-                    {
-                        "name": "total_exchange_fee",
-                        "docs": [
-                            "total fees collected by exchange fee schedule",
-                            "precision: QUOTE_PRECISION"
-                        ],
-                        "type": "u128"
-                    },
-                    {
-                        "name": "total_fee_minus_distributions",
-                        "docs": [
-                            "total fees minus any recognized upnl and pool withdraws",
-                            "precision: QUOTE_PRECISION"
-                        ],
-                        "type": "i128"
-                    },
-                    {
-                        "name": "total_fee_withdrawn",
-                        "docs": [
-                            "sum of all fees from fee pool withdrawn to revenue pool",
-                            "precision: QUOTE_PRECISION"
-                        ],
-                        "type": "u128"
-                    },
-                    {
-                        "name": "total_liquidation_fee",
-                        "docs": [
-                            "all fees collected by market for liquidations",
-                            "precision: QUOTE_PRECISION"
-                        ],
-                        "type": "u128"
-                    },
-                    {
-                        "name": "cumulative_funding_rate_long",
-                        "docs": [
-                            "accumulated funding rate for longs since inception in market"
-                        ],
-                        "type": "i128"
-                    },
-                    {
-                        "name": "cumulative_funding_rate_short",
-                        "docs": [
-                            "accumulated funding rate for shorts since inception in market"
-                        ],
-                        "type": "i128"
-                    },
-                    {
-                        "name": "total_social_loss",
-                        "docs": [
-                            "accumulated social loss paid by users since inception in market"
-                        ],
-                        "type": "u128"
-                    },
-                    {
-                        "name": "ask_base_asset_reserve",
-                        "docs": [
-                            "transformed base_asset_reserve for users going long",
                             "precision: AMM_RESERVE_PRECISION"
                         ],
                         "type": "u128"
                     },
-                    {
-                        "name": "ask_quote_asset_reserve",
-                        "docs": [
-                            "transformed quote_asset_reserve for users going long",
-                            "precision: AMM_RESERVE_PRECISION"
-                        ],
-                        "type": "u128"
-                    },
-                    {
-                        "name": "bid_base_asset_reserve",
-                        "docs": [
-                            "transformed base_asset_reserve for users going short",
-                            "precision: AMM_RESERVE_PRECISION"
-                        ],
-                        "type": "u128"
-                    },
-                    {
-                        "name": "bid_quote_asset_reserve",
-                        "docs": [
-                            "transformed quote_asset_reserve for users going short",
-                            "precision: AMM_RESERVE_PRECISION"
-                        ],
-                        "type": "u128"
-                    },
-                    {
-                        "name": "last_oracle_normalised_price",
-                        "docs": [
-                            "the last seen oracle price partially shrunk toward the amm reserve price",
-                            "precision: PRICE_PRECISION"
-                        ],
-                        "type": "i64"
-                    },
-                    {
-                        "name": "last_oracle_reserve_price_spread_pct",
-                        "docs": [
-                            "the gap between the oracle price and the reserve price = y * peg_multiplier / x"
-                        ],
-                        "type": "i64"
-                    },
-                    {
-                        "name": "last_bid_price_twap",
-                        "docs": [
-                            "average estimate of bid price over funding_period",
-                            "precision: PRICE_PRECISION"
-                        ],
-                        "type": "u64"
-                    },
-                    {
-                        "name": "last_ask_price_twap",
-                        "docs": [
-                            "average estimate of ask price over funding_period",
-                            "precision: PRICE_PRECISION"
-                        ],
-                        "type": "u64"
-                    },
-                    {
-                        "name": "last_mark_price_twap",
-                        "docs": [
-                            "average estimate of (bid+ask)/2 price over funding_period",
-                            "precision: PRICE_PRECISION"
-                        ],
-                        "type": "u64"
-                    },
-                    {
-                        "name": "last_mark_price_twap_5min",
-                        "docs": [
-                            "average estimate of (bid+ask)/2 price over FIVE_MINUTES"
-                        ],
-                        "type": "u64"
-                    },
                     {
                         "name": "last_update_slot",
                         "docs": [
@@ -16584,14 +16503,6 @@
                         ],
                         "type": "u64"
                     },
-                    {
-                        "name": "last_oracle_conf_pct",
-                        "docs": [
-                            "the pct size of the oracle confidence interval",
-                            "precision: PERCENTAGE_PRECISION"
-                        ],
-                        "type": "u64"
-                    },
                     {
                         "name": "net_revenue_since_last_funding",
                         "docs": [
@@ -16601,103 +16512,44 @@
                         "type": "i64"
                     },
                     {
-                        "name": "last_funding_rate_ts",
+                        "name": "last_cumulative_funding_rate_long",
                         "docs": [
-                            "the last funding rate update unix_timestamp"
+                            "AMM's last-seen cumulative funding rates. Mirrors",
+                            "`PerpPosition::last_cumulative_funding_rate` on user positions —",
+                            "the AMM settles its own funding payment from",
+                            "`(market.cumulative_funding_rate_* − own_last) ×",
+                            "counterparty_position`, same math shape user positions use. The",
+                            "AMM is the counterparty for the net imbalance, so the relevant",
+                            "cum rate is the LONG one when the AMM is net long",
+                            "(base_asset_amount_with_amm < 0, i.e. users net short) and the",
+                            "SHORT one when the AMM is net short."
                         ],
                         "type": "i64"
                     },
                     {
-                        "name": "funding_period",
-                        "docs": [
-                            "the peridocity of the funding rate updates"
-                        ],
+                        "name": "last_cumulative_funding_rate_short",
                         "type": "i64"
                     },
                     {
-                        "name": "order_step_size",
-                        "docs": [
-                            "the base step size (increment) of orders",
-                            "precision: BASE_PRECISION"
-                        ],
-                        "type": "u64"
-                    },
-                    {
-                        "name": "order_tick_size",
-                        "docs": [
-                            "the price tick size of orders",
-                            "precision: PRICE_PRECISION"
-                        ],
-                        "type": "u64"
-                    },
-                    {
-                        "name": "min_order_size",
-                        "docs": [
-                            "the minimum base size of an order",
-                            "precision: BASE_PRECISION"
-                        ],
-                        "type": "u64"
-                    },
-                    {
-                        "name": "mm_oracle_slot",
-                        "docs": [
-                            "the max base size a single user can have",
-                            "precision: BASE_PRECISION"
-                        ],
-                        "type": "u64"
-                    },
-                    {
-                        "name": "volume_24h",
-                        "docs": [
-                            "estimated total of volume in market",
-                            "QUOTE_PRECISION"
-                        ],
-                        "type": "u64"
-                    },
-                    {
-                        "name": "long_intensity_volume",
-                        "docs": [
-                            "the volume intensity of long fills against AMM"
-                        ],
-                        "type": "u64"
-                    },
-                    {
-                        "name": "short_intensity_volume",
-                        "docs": [
-                            "the volume intensity of short fills against AMM"
-                        ],
-                        "type": "u64"
-                    },
-                    {
-                        "name": "last_trade_ts",
+                        "name": "last_oracle_reserve_price_spread_pct",
                         "docs": [
-                            "the blockchain unix timestamp at the time of the last trade"
+                            "Cached oracle-vs-reserve price spread (signed, BID_ASK_SPREAD_PRECISION),",
+                            "the spread input that seeds `calculate_spread`. Refreshed alongside the",
+                            "other cached spread fields by `update_amm_quote_state`."
                         ],
                         "type": "i64"
                     },
                     {
-                        "name": "mark_std",
+                        "name": "last_spread_update_slot",
                         "docs": [
-                            "estimate of standard deviation of the fill (mark) prices",
-                            "precision: PRICE_PRECISION"
+                            "Blockchain slot at which the cached spread state (`long_spread`,",
+                            "`short_spread`, `reference_price_offset`, the ask/bid reserves, and",
+                            "`last_oracle_reserve_price_spread_pct`) was last refreshed. Lets",
+                            "quote paths skip recompute within a slot and lets dashboards reason",
+                            "about cache staleness independently of `last_update_slot`."
                         ],
                         "type": "u64"
                     },
-                    {
-                        "name": "oracle_std",
-                        "docs": [
-                            "estimate of standard deviation of the oracle price at each update",
-                            "precision: PRICE_PRECISION"
-                        ],
-                        "type": "u64"
-                    },
-                    {
-                        "name": "last_mark_price_twap_ts",
-                        "docs": [
-                            "the last unix_timestamp the mark twap was updated"
-                        ],
-                        "type": "i64"
-                    },
                     {
                         "name": "base_spread",
                         "docs": [
@@ -16715,23 +16567,26 @@
                     {
                         "name": "long_spread",
                         "docs": [
-                            "the spread for asks vs the reserve price"
+                            "Cached spread applied to the ask (long-take) side, in",
+                            "BID_ASK_SPREAD_PRECISION. Refreshed by `update_amm_quote_state`."
                         ],
                         "type": "u32"
                     },
                     {
                         "name": "short_spread",
                         "docs": [
-                            "the spread for bids vs the reserve price"
+                            "Cached spread applied to the bid (short-take) side, in",
+                            "BID_ASK_SPREAD_PRECISION. Refreshed by `update_amm_quote_state`."
                         ],
                         "type": "u32"
                     },
                     {
-                        "name": "mm_oracle_price",
+                        "name": "reference_price_offset",
                         "docs": [
-                            "MM oracle price"
+                            "Cached reference-price offset (signed, PRICE_PRECISION) applied to both",
+                            "sides' quotes. Refreshed by `update_amm_quote_state`."
                         ],
-                        "type": "i64"
+                        "type": "i32"
                     },
                     {
                         "name": "max_fill_reserve_fraction",
@@ -16762,32 +16617,6 @@
                         ],
                         "type": "u8"
                     },
-                    {
-                        "name": "oracle_source",
-                        "docs": [
-                            "the oracle provider information. used to decode/scale the oracle public key"
-                        ],
-                        "type": {
-                            "defined": {
-                                "name": "OracleSource"
-                            }
-                        }
-                    },
-                    {
-                        "name": "last_oracle_valid",
-                        "docs": [
-                            "tracks whether the oracle was considered valid at the last AMM update"
-                        ],
-                        "type": "bool"
-                    },
-                    {
-                        "name": "oracle_low_risk_slot_delay_override",
-                        "docs": [
-                            "the override for the state.min_perp_auction_duration",
-                            "0 is no override, -1 is disable speed bump, 1-100 is literal speed bump"
-                        ],
-                        "type": "i8"
-                    },
                     {
                         "name": "amm_spread_adjustment",
                         "docs": [
@@ -16795,34 +16624,6 @@
                         ],
                         "type": "i8"
                     },
-                    {
-                        "name": "oracle_slot_delay_override",
-                        "type": "i8"
-                    },
-                    {
-                        "name": "padding_pre_mm_oracle_sequence",
-                        "docs": [
-                            "alignment padding for the following u64 (Rust would otherwise insert 5 implicit bytes here)"
-                        ],
-                        "type": {
-                            "array": [
-                                "u8",
-                                5
-                            ]
-                        }
-                    },
-                    {
-                        "name": "mm_oracle_sequence_id",
-                        "type": "u64"
-                    },
-                    {
-                        "name": "net_unsettled_funding_pnl",
-                        "type": "i64"
-                    },
-                    {
-                        "name": "reference_price_offset",
-                        "type": "i32"
-                    },
                     {
                         "name": "amm_inventory_spread_adjustment",
                         "docs": [
@@ -16835,27 +16636,11 @@
                         "type": "u8"
                     },
                     {
-                        "name": "padding_pre_last_funding",
-                        "type": {
-                            "array": [
-                                "u8",
-                                2
-                            ]
-                        }
-                    },
-                    {
-                        "name": "last_funding_oracle_twap",
-                        "type": "i64"
-                    },
-                    {
-                        "name": "padding_trailing",
-                        "docs": [
-                            "trailing alignment padding (struct alignment is 16 due to u128 fields)"
-                        ],
+                        "name": "padding_post_amm",
                         "type": {
                             "array": [
                                 "u8",
-                                8
+                                3
                             ]
                         }
                     }
@@ -17032,6 +16817,84 @@
                 ]
             }
         },
+        {
+            "name": "AmmCurveChanged",
+            "docs": [
+                "AMM-side curve change: peg / reserves / sqrt_k moved, and the AMM",
+                "debited the adjustment cost from its books. Emitted by the AMM itself",
+                "(from `on_market_event(FundingUpdated)`'s k-update branch, from",
+                "`snap_to_oracle`, and from the admin `repeg` ix). PerpMarket-side",
+                "state at the time of the change (`base_asset_amount_long/short`,",
+                "`number_of_users`) lives on a separate `FundingRateRecord` or can be",
+                "queried by consumers correlating on `(ts, market_index)`."
+            ],
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "ts",
+                        "type": "i64"
+                    },
+                    {
+                        "name": "market_index",
+                        "type": "u16"
+                    },
+                    {
+                        "name": "peg_multiplier_before",
+                        "type": "u128"
+                    },
+                    {
+                        "name": "base_asset_reserve_before",
+                        "type": "u128"
+                    },
+                    {
+                        "name": "quote_asset_reserve_before",
+                        "type": "u128"
+                    },
+                    {
+                        "name": "sqrt_k_before",
+                        "type": "u128"
+                    },
+                    {
+                        "name": "peg_multiplier_after",
+                        "type": "u128"
+                    },
+                    {
+                        "name": "base_asset_reserve_after",
+                        "type": "u128"
+                    },
+                    {
+                        "name": "quote_asset_reserve_after",
+                        "type": "u128"
+                    },
+                    {
+                        "name": "sqrt_k_after",
+                        "type": "u128"
+                    },
+                    {
+                        "name": "adjustment_cost",
+                        "docs": [
+                            "precision: QUOTE_PRECISION"
+                        ],
+                        "type": "i128"
+                    },
+                    {
+                        "name": "total_fee_minus_distributions_after",
+                        "docs": [
+                            "precision: QUOTE_PRECISION — AMM's TFMD after the change."
+                        ],
+                        "type": "i128"
+                    },
+                    {
+                        "name": "oracle_price",
+                        "docs": [
+                            "precision: PRICE_PRECISION"
+                        ],
+                        "type": "i64"
+                    }
+                ]
+            }
+        },
         {
             "name": "AssetTier",
             "type": {
@@ -17601,139 +17464,30 @@
                         "name": "C"
                     },
                     {
-                        "name": "Speculative"
-                    },
-                    {
-                        "name": "HighlySpeculative"
-                    },
-                    {
-                        "name": "Isolated"
-                    }
-                ]
-            }
-        },
-        {
-            "name": "ContractType",
-            "type": {
-                "kind": "enum",
-                "variants": [
-                    {
-                        "name": "Perpetual"
-                    },
-                    {
-                        "name": "DeprecatedFuture"
-                    },
-                    {
-                        "name": "DeprecatedPrediction"
-                    }
-                ]
-            }
-        },
-        {
-            "name": "CurveRecord",
-            "type": {
-                "kind": "struct",
-                "fields": [
-                    {
-                        "name": "ts",
-                        "type": "i64"
-                    },
-                    {
-                        "name": "record_id",
-                        "type": "u64"
-                    },
-                    {
-                        "name": "peg_multiplier_before",
-                        "type": "u128"
-                    },
-                    {
-                        "name": "base_asset_reserve_before",
-                        "type": "u128"
-                    },
-                    {
-                        "name": "quote_asset_reserve_before",
-                        "type": "u128"
-                    },
-                    {
-                        "name": "sqrt_k_before",
-                        "type": "u128"
-                    },
-                    {
-                        "name": "peg_multiplier_after",
-                        "type": "u128"
-                    },
-                    {
-                        "name": "base_asset_reserve_after",
-                        "type": "u128"
-                    },
-                    {
-                        "name": "quote_asset_reserve_after",
-                        "type": "u128"
-                    },
-                    {
-                        "name": "sqrt_k_after",
-                        "type": "u128"
-                    },
-                    {
-                        "name": "base_asset_amount_long",
-                        "docs": [
-                            "precision: BASE_PRECISION"
-                        ],
-                        "type": "u128"
-                    },
-                    {
-                        "name": "base_asset_amount_short",
-                        "docs": [
-                            "precision: BASE_PRECISION"
-                        ],
-                        "type": "u128"
-                    },
-                    {
-                        "name": "base_asset_amount_with_amm",
-                        "docs": [
-                            "precision: BASE_PRECISION"
-                        ],
-                        "type": "i128"
-                    },
-                    {
-                        "name": "total_fee",
-                        "docs": [
-                            "precision: QUOTE_PRECISION"
-                        ],
-                        "type": "i128"
-                    },
-                    {
-                        "name": "total_fee_minus_distributions",
-                        "docs": [
-                            "precision: QUOTE_PRECISION"
-                        ],
-                        "type": "i128"
+                        "name": "Speculative"
                     },
                     {
-                        "name": "adjustment_cost",
-                        "docs": [
-                            "precision: QUOTE_PRECISION"
-                        ],
-                        "type": "i128"
+                        "name": "HighlySpeculative"
                     },
                     {
-                        "name": "oracle_price",
-                        "docs": [
-                            "precision: PRICE_PRECISION"
-                        ],
-                        "type": "i64"
-                    },
+                        "name": "Isolated"
+                    }
+                ]
+            }
+        },
+        {
+            "name": "ContractType",
+            "type": {
+                "kind": "enum",
+                "variants": [
                     {
-                        "name": "fill_record",
-                        "type": "u128"
+                        "name": "Perpetual"
                     },
                     {
-                        "name": "number_of_users",
-                        "type": "u32"
+                        "name": "DeprecatedFuture"
                     },
                     {
-                        "name": "market_index",
-                        "type": "u16"
+                        "name": "DeprecatedPrediction"
                     }
                 ]
             }
@@ -17966,11 +17720,16 @@
                         }
                     },
                     {
-                        "name": "referrer_reward_epoch_upper_bound",
+                        "name": "flat_filler_fee",
                         "type": "u64"
                     },
                     {
-                        "name": "flat_filler_fee",
+                        "name": "padding",
+                        "docs": [
+                            "Reserved padding. Kept so `size_of::<FeeStructure>()` stays a multiple of 16",
+                            "(OrderFillerRewardStructure's u128 forces 16-byte alignment on host x86_64);",
+                            "removing it would diverge host vs. SBF layout."
+                        ],
                         "type": "u64"
                     }
                 ]
@@ -18145,18 +17904,74 @@
                         "type": "u64"
                     },
                     {
-                        "name": "period_revenue",
+                        "name": "base_asset_amount_with_amm",
                         "docs": [
-                            "precision: QUOTE_PRECISION"
+                            "precision: BASE_PRECISION"
                         ],
-                        "type": "i64"
+                        "type": "i128"
+                    }
+                ]
+            }
+        },
+        {
+            "name": "HedgeConfig",
+            "docs": [
+                "Per-market configuration of a perp market's relationship to its hedge (LP)",
+                "pool: which pool it routes to, whether hedging is enabled, which hedge",
+                "operations are paused, and the fee-routing scalars. Admin-set; never mutated",
+                "per fill. Embedded at the tail of `PerpMarket` next to `amm` so the whole VLP",
+                "region is contiguous."
+            ],
+            "serialization": "bytemuckunsafe",
+            "repr": {
+                "kind": "c"
+            },
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "pool_id",
+                        "docs": [
+                            "The LP pool this market hedges into (`LPPool.pool_id`)."
+                        ],
+                        "type": "u8"
                     },
                     {
-                        "name": "base_asset_amount_with_amm",
+                        "name": "status",
                         "docs": [
-                            "precision: BASE_PRECISION"
+                            "Hedging enabled for this market; 0 disables it."
                         ],
-                        "type": "i128"
+                        "type": "u8"
+                    },
+                    {
+                        "name": "paused_operations",
+                        "docs": [
+                            "Bitflags of paused `ConstituentLpOperation`s."
+                        ],
+                        "type": "u8"
+                    },
+                    {
+                        "name": "exchange_fee_exclusion_scalar",
+                        "docs": [
+                            "Scalar excluding a share of exchange fees from hedge routing."
+                        ],
+                        "type": "u8"
+                    },
+                    {
+                        "name": "fee_transfer_scalar",
+                        "docs": [
+                            "Scalar for the share of fees transferred to the hedge pool."
+                        ],
+                        "type": "u8"
+                    },
+                    {
+                        "name": "padding",
+                        "type": {
+                            "array": [
+                                "u8",
+                                11
+                            ]
+                        }
                     }
                 ]
             }
@@ -19555,109 +19370,330 @@
                         }
                     },
                     {
-                        "name": "liquidate_borrow_for_perp_pnl",
-                        "type": {
-                            "defined": {
-                                "name": "LiquidateBorrowForPerpPnlRecord"
-                            }
-                        }
+                        "name": "liquidate_borrow_for_perp_pnl",
+                        "type": {
+                            "defined": {
+                                "name": "LiquidateBorrowForPerpPnlRecord"
+                            }
+                        }
+                    },
+                    {
+                        "name": "liquidate_perp_pnl_for_deposit",
+                        "type": {
+                            "defined": {
+                                "name": "LiquidatePerpPnlForDepositRecord"
+                            }
+                        }
+                    },
+                    {
+                        "name": "perp_bankruptcy",
+                        "type": {
+                            "defined": {
+                                "name": "PerpBankruptcyRecord"
+                            }
+                        }
+                    },
+                    {
+                        "name": "spot_bankruptcy",
+                        "type": {
+                            "defined": {
+                                "name": "SpotBankruptcyRecord"
+                            }
+                        }
+                    },
+                    {
+                        "name": "bit_flags",
+                        "type": "u8"
+                    }
+                ]
+            }
+        },
+        {
+            "name": "LiquidationType",
+            "type": {
+                "kind": "enum",
+                "variants": [
+                    {
+                        "name": "LiquidatePerp"
+                    },
+                    {
+                        "name": "LiquidateSpot"
+                    },
+                    {
+                        "name": "LiquidateBorrowForPerpPnl"
+                    },
+                    {
+                        "name": "LiquidatePerpPnlForDeposit"
+                    },
+                    {
+                        "name": "PerpBankruptcy"
+                    },
+                    {
+                        "name": "SpotBankruptcy"
+                    }
+                ]
+            }
+        },
+        {
+            "name": "LpPoolParams",
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "max_settle_quote_amount",
+                        "type": {
+                            "option": "u64"
+                        }
+                    },
+                    {
+                        "name": "volatility",
+                        "type": {
+                            "option": "u64"
+                        }
+                    },
+                    {
+                        "name": "gamma_execution",
+                        "type": {
+                            "option": "u8"
+                        }
+                    },
+                    {
+                        "name": "xi",
+                        "type": {
+                            "option": "u8"
+                        }
+                    },
+                    {
+                        "name": "max_aum",
+                        "type": {
+                            "option": "u128"
+                        }
+                    },
+                    {
+                        "name": "whitelist_mint",
+                        "type": {
+                            "option": "pubkey"
+                        }
+                    }
+                ]
+            }
+        },
+        {
+            "name": "MarketStats",
+            "docs": [
+                "Historic market data shared across all makers, updated on every fill",
+                "regardless of which maker filled (vAMM, DLOB resting order, JIT participant,",
+                "future quoter types). Holds mark/oracle TWAPs, rolling std, volume,",
+                "intensity, mm-oracle snapshot, `historical_oracle_data`,",
+                "`last_oracle_normalised_price`, `last_oracle_valid`.",
+                "",
+                "Update-cadence rule: anything that needs to refresh on every market event",
+                "lives here. Anything AMM-private (reserves, peg, spreads — only matters",
+                "when the AMM specifically is the counterparty) lives on `AMM`. See",
+                "`docs/amm-decoupling-and-maker-interface.md`."
+            ],
+            "serialization": "bytemuckunsafe",
+            "repr": {
+                "kind": "c"
+            },
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "last_mark_price_twap",
+                        "docs": [
+                            "Average estimate of (bid+ask)/2 price over funding_period.",
+                            "precision: PRICE_PRECISION"
+                        ],
+                        "type": "u64"
+                    },
+                    {
+                        "name": "last_mark_price_twap_5min",
+                        "docs": [
+                            "Average estimate of (bid+ask)/2 price over FIVE_MINUTES."
+                        ],
+                        "type": "u64"
+                    },
+                    {
+                        "name": "last_mark_price_twap_ts",
+                        "docs": [
+                            "The last unix_timestamp the mark twap was updated."
+                        ],
+                        "type": "i64"
+                    },
+                    {
+                        "name": "last_bid_price_twap",
+                        "docs": [
+                            "Average estimate of bid price over funding_period.",
+                            "precision: PRICE_PRECISION"
+                        ],
+                        "type": "u64"
+                    },
+                    {
+                        "name": "last_ask_price_twap",
+                        "docs": [
+                            "Average estimate of ask price over funding_period.",
+                            "precision: PRICE_PRECISION"
+                        ],
+                        "type": "u64"
+                    },
+                    {
+                        "name": "mark_std",
+                        "docs": [
+                            "Estimate of standard deviation of fill (mark) prices.",
+                            "precision: PRICE_PRECISION"
+                        ],
+                        "type": "u64"
+                    },
+                    {
+                        "name": "oracle_std",
+                        "docs": [
+                            "Estimate of standard deviation of the oracle price at each update.",
+                            "precision: PRICE_PRECISION"
+                        ],
+                        "type": "u64"
+                    },
+                    {
+                        "name": "last_oracle_conf_pct",
+                        "docs": [
+                            "The pct size of the oracle confidence interval.",
+                            "precision: PERCENTAGE_PRECISION"
+                        ],
+                        "type": "u64"
                     },
                     {
-                        "name": "liquidate_perp_pnl_for_deposit",
-                        "type": {
-                            "defined": {
-                                "name": "LiquidatePerpPnlForDepositRecord"
-                            }
-                        }
+                        "name": "volume_24h",
+                        "docs": [
+                            "Estimated total of volume in market.",
+                            "QUOTE_PRECISION"
+                        ],
+                        "type": "u64"
                     },
                     {
-                        "name": "perp_bankruptcy",
-                        "type": {
-                            "defined": {
-                                "name": "PerpBankruptcyRecord"
-                            }
-                        }
+                        "name": "long_intensity_volume",
+                        "docs": [
+                            "The volume intensity of long fills (across all makers)."
+                        ],
+                        "type": "u64"
                     },
                     {
-                        "name": "spot_bankruptcy",
-                        "type": {
-                            "defined": {
-                                "name": "SpotBankruptcyRecord"
-                            }
-                        }
+                        "name": "short_intensity_volume",
+                        "docs": [
+                            "The volume intensity of short fills (across all makers)."
+                        ],
+                        "type": "u64"
                     },
                     {
-                        "name": "bit_flags",
-                        "type": "u8"
-                    }
-                ]
-            }
-        },
-        {
-            "name": "LiquidationType",
-            "type": {
-                "kind": "enum",
-                "variants": [
-                    {
-                        "name": "LiquidatePerp"
+                        "name": "last_trade_ts",
+                        "docs": [
+                            "The blockchain unix_timestamp at the time of the last trade."
+                        ],
+                        "type": "i64"
                     },
                     {
-                        "name": "LiquidateSpot"
+                        "name": "last_24h_avg_funding_rate",
+                        "docs": [
+                            "estimate of last 24h of funding rate perp market (unit is quote per base)",
+                            "Market-wide config / rolling stat — read by the AMM when computing",
+                            "`reference_price_offset` and by funding-rate updates. Migrated from",
+                            "`PerpMarket` so the AMM reads only from `MarketStats`.",
+                            "precision: QUOTE_PRECISION"
+                        ],
+                        "type": "i64"
                     },
                     {
-                        "name": "LiquidateBorrowForPerpPnl"
+                        "name": "funding_period",
+                        "docs": [
+                            "the periodicity of the funding rate updates. Market-wide config used",
+                            "across the funding path. Migrated from `PerpMarket`."
+                        ],
+                        "type": "i64"
                     },
                     {
-                        "name": "LiquidatePerpPnlForDeposit"
+                        "name": "min_order_size",
+                        "docs": [
+                            "the minimum base size of an order. Market-wide config read by the AMM",
+                            "when computing fallback prices / spread reserves. Migrated from",
+                            "`PerpMarket`.",
+                            "precision: BASE_PRECISION"
+                        ],
+                        "type": "u64"
                     },
                     {
-                        "name": "PerpBankruptcy"
+                        "name": "mm_oracle_price",
+                        "docs": [
+                            "MM oracle price snapshot (set by the native handler)."
+                        ],
+                        "type": "i64"
                     },
                     {
-                        "name": "SpotBankruptcy"
-                    }
-                ]
-            }
-        },
-        {
-            "name": "LpPoolParams",
-            "type": {
-                "kind": "struct",
-                "fields": [
+                        "name": "mm_oracle_slot",
+                        "docs": [
+                            "Slot at which the mm_oracle_* fields were last updated."
+                        ],
+                        "type": "u64"
+                    },
                     {
-                        "name": "max_settle_quote_amount",
-                        "type": {
-                            "option": "u64"
-                        }
+                        "name": "mm_oracle_sequence_id",
+                        "docs": [
+                            "Monotonically increasing sequence id for mm_oracle updates."
+                        ],
+                        "type": "u64"
                     },
                     {
-                        "name": "volatility",
-                        "type": {
-                            "option": "u64"
-                        }
+                        "name": "last_oracle_normalised_price",
+                        "docs": [
+                            "Canonical sanitised/clamped oracle price — the latest oracle reading",
+                            "after normalisation (any quoter's view, not AMM-specific)."
+                        ],
+                        "type": "i64"
                     },
                     {
-                        "name": "gamma_execution",
-                        "type": {
-                            "option": "u8"
-                        }
+                        "name": "last_reference_price_offset",
+                        "docs": [
+                            "Previous reference price offset, written by `_update_amm` after a",
+                            "successful repeg/k_update. Read by `update_amm_quote_state` to",
+                            "implement the legacy time-decayed reference-price-offset smoothing",
+                            "transition — when the freshly computed offset's sign flips relative",
+                            "to this cached value AND `curve_update_intensity > 100`, the",
+                            "transition is clamped per-slot rather than snapping. Migrated from",
+                            "`AMM.reference_price_offset` (which was deleted in the AMM-decoupling",
+                            "refactor) so the smoothing behaviour is preserved across cranks.",
+                            "precision: PRICE_PRECISION"
+                        ],
+                        "type": "i32"
                     },
                     {
-                        "name": "xi",
-                        "type": {
-                            "option": "u8"
-                        }
+                        "name": "last_oracle_valid",
+                        "docs": [
+                            "Whether the oracle was valid at the most recent `_update_amm`.",
+                            "Read by settlement and fill paths to gate operations."
+                        ],
+                        "type": "bool"
                     },
                     {
-                        "name": "max_aum",
+                        "name": "padding",
+                        "docs": [
+                            "Padding so historical_oracle_data is 8-aligned."
+                        ],
                         "type": {
-                            "option": "u128"
+                            "array": [
+                                "u8",
+                                11
+                            ]
                         }
                     },
                     {
-                        "name": "whitelist_mint",
+                        "name": "historical_oracle_data",
+                        "docs": [
+                            "Historical oracle readings — TWAPs, last raw price, confidence, delay,",
+                            "timestamp. Market-wide data (any quoter would want it), updated by",
+                            "`_update_amm` / funding paths. Migrated from AMM."
+                        ],
                         "type": {
-                            "option": "pubkey"
+                            "defined": {
+                                "name": "HistoricalOracleData"
+                            }
                         }
                     }
                 ]
@@ -20698,6 +20734,26 @@
                         "type": {
                             "option": "i64"
                         }
+                    },
+                    {
+                        "name": "builder_idx",
+                        "docs": [
+                            "the index into the placing user's RevenueShareEscrow.approved_builders list, if this order",
+                            "carries a builder code. Only honored for non-swift orders; swift orders carry the builder",
+                            "info in the signed message envelope instead."
+                        ],
+                        "type": {
+                            "option": "u8"
+                        }
+                    },
+                    {
+                        "name": "builder_fee_tenth_bps",
+                        "docs": [
+                            "the builder fee on this order, in tenths of a bps, e.g. 100 = 0.01%"
+                        ],
+                        "type": {
+                            "option": "u16"
+                        }
                     }
                 ]
             }
@@ -20843,58 +20899,156 @@
                         "type": "u16"
                     },
                     {
-                        "name": "pnl",
+                        "name": "pnl",
+                        "type": "i128"
+                    },
+                    {
+                        "name": "if_payment",
+                        "type": "u128"
+                    },
+                    {
+                        "name": "clawback_user",
+                        "type": {
+                            "option": "pubkey"
+                        }
+                    },
+                    {
+                        "name": "clawback_user_payment",
+                        "type": {
+                            "option": "u128"
+                        }
+                    },
+                    {
+                        "name": "cumulative_funding_rate_delta",
+                        "type": "i128"
+                    }
+                ]
+            }
+        },
+        {
+            "name": "PerpMarket",
+            "serialization": "bytemuckunsafe",
+            "repr": {
+                "kind": "c"
+            },
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "pubkey",
+                        "docs": [
+                            "The perp market's address. It is a pda of the market index"
+                        ],
+                        "type": "pubkey"
+                    },
+                    {
+                        "name": "base_asset_amount_long",
+                        "docs": [
+                            "always non-negative. tracks number of total longs in market (regardless of counterparty)",
+                            "precision: BASE_PRECISION"
+                        ],
+                        "type": "i128"
+                    },
+                    {
+                        "name": "base_asset_amount_short",
+                        "docs": [
+                            "always non-positive. tracks number of total shorts in market (regardless of counterparty)",
+                            "precision: BASE_PRECISION"
+                        ],
+                        "type": "i128"
+                    },
+                    {
+                        "name": "quote_asset_amount",
+                        "docs": [
+                            "sum of all user's perp quote_asset_amount in market",
+                            "precision: QUOTE_PRECISION"
+                        ],
+                        "type": "i128"
+                    },
+                    {
+                        "name": "quote_entry_amount_long",
+                        "docs": [
+                            "sum of all long user's quote_entry_amount in market",
+                            "precision: QUOTE_PRECISION"
+                        ],
+                        "type": "i128"
+                    },
+                    {
+                        "name": "quote_entry_amount_short",
+                        "docs": [
+                            "sum of all short user's quote_entry_amount in market",
+                            "precision: QUOTE_PRECISION"
+                        ],
+                        "type": "i128"
+                    },
+                    {
+                        "name": "quote_break_even_amount_long",
+                        "docs": [
+                            "sum of all long user's quote_break_even_amount in market",
+                            "precision: QUOTE_PRECISION"
+                        ],
+                        "type": "i128"
+                    },
+                    {
+                        "name": "quote_break_even_amount_short",
+                        "docs": [
+                            "sum of all short user's quote_break_even_amount in market",
+                            "precision: QUOTE_PRECISION"
+                        ],
                         "type": "i128"
                     },
                     {
-                        "name": "if_payment",
+                        "name": "max_open_interest",
+                        "docs": [
+                            "max allowed open interest, blocks trades that breach this value",
+                            "precision: BASE_PRECISION"
+                        ],
                         "type": "u128"
                     },
                     {
-                        "name": "clawback_user",
-                        "type": {
-                            "option": "pubkey"
-                        }
+                        "name": "total_social_loss",
+                        "docs": [
+                            "accumulated social loss paid by users since inception in market",
+                            "precision: QUOTE_PRECISION"
+                        ],
+                        "type": "u128"
                     },
                     {
-                        "name": "clawback_user_payment",
-                        "type": {
-                            "option": "u128"
-                        }
+                        "name": "cumulative_funding_rate_long",
+                        "docs": [
+                            "accumulated funding rate for longs since inception in market"
+                        ],
+                        "type": "i128"
                     },
                     {
-                        "name": "cumulative_funding_rate_delta",
+                        "name": "cumulative_funding_rate_short",
+                        "docs": [
+                            "accumulated funding rate for shorts since inception in market"
+                        ],
                         "type": "i128"
-                    }
-                ]
-            }
-        },
-        {
-            "name": "PerpMarket",
-            "serialization": "bytemuckunsafe",
-            "repr": {
-                "kind": "c"
-            },
-            "type": {
-                "kind": "struct",
-                "fields": [
+                    },
                     {
-                        "name": "pubkey",
+                        "name": "total_exchange_fee",
                         "docs": [
-                            "The perp market's address. It is a pda of the market index"
+                            "total fees collected by exchange fee schedule",
+                            "precision: QUOTE_PRECISION"
                         ],
-                        "type": "pubkey"
+                        "type": "u128"
                     },
                     {
-                        "name": "amm",
+                        "name": "total_liquidation_fee",
                         "docs": [
-                            "The automated market maker"
+                            "all fees collected by market for liquidations",
+                            "precision: QUOTE_PRECISION"
                         ],
-                        "type": {
-                            "defined": {
-                                "name": "AMM"
-                            }
-                        }
+                        "type": "u128"
+                    },
+                    {
+                        "name": "oracle",
+                        "docs": [
+                            "oracle price data public key"
+                        ],
+                        "type": "pubkey"
                     },
                     {
                         "name": "pnl_pool",
@@ -20931,6 +21085,67 @@
                             }
                         }
                     },
+                    {
+                        "name": "last_funding_rate",
+                        "docs": [
+                            "last funding rate in this perp market (unit is quote per base)",
+                            "precision: FUNDING_RATE_PRECISION"
+                        ],
+                        "type": "i64"
+                    },
+                    {
+                        "name": "last_funding_rate_long",
+                        "docs": [
+                            "last funding rate for longs in this perp market (unit is quote per base)",
+                            "precision: FUNDING_RATE_PRECISION"
+                        ],
+                        "type": "i64"
+                    },
+                    {
+                        "name": "last_funding_rate_short",
+                        "docs": [
+                            "last funding rate for shorts in this perp market (unit is quote per base)",
+                            "precision: QUOTE_PRECISION"
+                        ],
+                        "type": "i64"
+                    },
+                    {
+                        "name": "last_funding_rate_ts",
+                        "docs": [
+                            "the last funding rate update unix_timestamp"
+                        ],
+                        "type": "i64"
+                    },
+                    {
+                        "name": "net_unsettled_funding_pnl",
+                        "docs": [
+                            "unsettled funding pnl across the market (protocol-wide)"
+                        ],
+                        "type": "i64"
+                    },
+                    {
+                        "name": "last_funding_oracle_twap",
+                        "docs": [
+                            "oracle TWAP captured at last funding update"
+                        ],
+                        "type": "i64"
+                    },
+                    {
+                        "name": "order_step_size",
+                        "docs": [
+                            "the base step size (increment) of orders",
+                            "precision: BASE_PRECISION"
+                        ],
+                        "type": "u64"
+                    },
+                    {
+                        "name": "order_tick_size",
+                        "docs": [
+                            "the price tick size of orders",
+                            "precision: PRICE_PRECISION"
+                        ],
+                        "type": "u64"
+                    },
                     {
                         "name": "unrealized_pnl_max_imbalance",
                         "docs": [
@@ -20970,13 +21185,6 @@
                         ],
                         "type": "u64"
                     },
-                    {
-                        "name": "next_curve_record_id",
-                        "docs": [
-                            "Every amm k updated has a record id. This is the next id to be used"
-                        ],
-                        "type": "u64"
-                    },
                     {
                         "name": "imf_factor",
                         "docs": [
@@ -21117,6 +21325,21 @@
                         ],
                         "type": "i16"
                     },
+                    {
+                        "name": "_padding_align_lfp",
+                        "docs": [
+                            "Explicit padding so the IDL records the 6 bytes the Rust compiler",
+                            "inserts to 8-align `last_fill_price`. Without this the JS borsh",
+                            "decoder (which reads sequentially after the variable-span enum",
+                            "`status`) reads every field past `fee_adjustment` 6 bytes early."
+                        ],
+                        "type": {
+                            "array": [
+                                "u8",
+                                6
+                            ]
+                        }
+                    },
                     {
                         "name": "last_fill_price",
                         "type": "u64"
@@ -21135,37 +21358,122 @@
                         }
                     },
                     {
-                        "name": "lp_fee_transfer_scalar",
-                        "type": "u8"
+                        "name": "_padding_hedge",
+                        "docs": [
+                            "Was `lp_fee_transfer_scalar`, `lp_status`, `lp_paused_operations`,",
+                            "`lp_exchange_fee_excluscion_scalar`, `lp_pool_id` (5×u8). Relocated into",
+                            "`hedge_config` at the tail; kept as reserved bytes so existing account",
+                            "byte offsets (and snapshots) are undisturbed."
+                        ],
+                        "type": {
+                            "array": [
+                                "u8",
+                                5
+                            ]
+                        }
                     },
                     {
-                        "name": "lp_status",
+                        "name": "market_config",
                         "type": "u8"
                     },
                     {
-                        "name": "lp_paused_operations",
-                        "type": "u8"
+                        "name": "oracle_source",
+                        "docs": [
+                            "the oracle provider information. used to decode/scale the oracle public key"
+                        ],
+                        "type": {
+                            "defined": {
+                                "name": "OracleSource"
+                            }
+                        }
                     },
                     {
-                        "name": "lp_exchange_fee_excluscion_scalar",
-                        "type": "u8"
+                        "name": "oracle_slot_delay_override",
+                        "docs": [
+                            "override for the per-fill slot delay required from the oracle (default -1 = use state default)"
+                        ],
+                        "type": "i8"
                     },
                     {
-                        "name": "lp_pool_id",
-                        "type": "u8"
+                        "name": "oracle_low_risk_slot_delay_override",
+                        "docs": [
+                            "the override for the state.min_perp_auction_duration",
+                            "0 is no override, -1 is disable speed bump, 1-100 is literal speed bump"
+                        ],
+                        "type": "i8"
                     },
                     {
-                        "name": "market_config",
-                        "type": "u8"
+                        "name": "padding",
+                        "docs": [
+                            "Trailing padding so `market_stats` lands at the offset Rust naturally",
+                            "computes via `repr(C)` alignment and the `(SIZE - 8) % 16 == 0`",
+                            "invariant holds. Bumped to 36 bytes (was 28) when `next_curve_record_id`",
+                            "was removed."
+                        ],
+                        "type": {
+                            "array": [
+                                "u8",
+                                36
+                            ]
+                        }
                     },
                     {
-                        "name": "padding",
+                        "name": "market_stats",
+                        "docs": [
+                            "Market-wide stats shared across all makers: mark/oracle TWAPs, std,",
+                            "volume, intensity, mm-oracle snapshot, `historical_oracle_data`,",
+                            "`last_oracle_normalised_price`, `last_oracle_valid`. Writers (e.g.",
+                            "`MarketStats::update_mark_std`, `update_volume_24h`, native",
+                            "`handle_update_mm_oracle_native`) update this directly."
+                        ],
+                        "type": {
+                            "defined": {
+                                "name": "MarketStats"
+                            }
+                        }
+                    },
+                    {
+                        "name": "_padding_align_amm",
+                        "docs": [
+                            "8 bytes of explicit padding so MarketStats (216 bytes) plus this",
+                            "padding equals 224 bytes — the offset Rust naturally inserts to",
+                            "16-align AMM's leading u128. Making it explicit keeps the IDL byte",
+                            "layout aligned with `repr(C)`."
+                        ],
                         "type": {
                             "array": [
                                 "u8",
-                                30
+                                8
                             ]
                         }
+                    },
+                    {
+                        "name": "amm",
+                        "docs": [
+                            "The automated market maker. Last field so future quoter modules can",
+                            "land in the trailing region without disturbing earlier byte offsets",
+                            "— in the target architecture this account holds back-to-back",
+                            "per-quoter state slices (AMM, DLOB-maker state, future propAMM-style",
+                            "participants, …) and each module owns a contiguous span starting at",
+                            "a known offset."
+                        ],
+                        "type": {
+                            "defined": {
+                                "name": "AMM"
+                            }
+                        }
+                    },
+                    {
+                        "name": "hedge_config",
+                        "docs": [
+                            "This market's hedge (LP pool) configuration. Sits immediately after `amm`",
+                            "so the trailing `[amm, hedge_config]` span is the contiguous VLP region."
+                        ],
+                        "type": {
+                            "defined": {
+                                "name": "HedgeConfig"
+                            }
+                        }
                     }
                 ]
             }
@@ -21573,28 +21881,12 @@
                         "name": "referrer",
                         "type": "pubkey"
                     },
-                    {
-                        "name": "referrer_boost_expire_ts",
-                        "type": "u32"
-                    },
-                    {
-                        "name": "referrer_reward_offset",
-                        "type": "i8"
-                    },
-                    {
-                        "name": "referee_fee_numerator_offset",
-                        "type": "i8"
-                    },
-                    {
-                        "name": "referrer_boost_numerator",
-                        "type": "i8"
-                    },
                     {
                         "name": "reserved_fixed",
                         "type": {
                             "array": [
                                 "u8",
-                                17
+                                24
                             ]
                         }
                     },
@@ -23718,22 +24010,6 @@
                             "precision: QUOTE_PRECISION"
                         ],
                         "type": "u64"
-                    },
-                    {
-                        "name": "total_referrer_reward",
-                        "docs": [
-                            "Total reward to referrer",
-                            "precision: QUOTE_PRECISION"
-                        ],
-                        "type": "u64"
-                    },
-                    {
-                        "name": "current_epoch_referrer_reward",
-                        "docs": [
-                            "Total reward to referrer this epoch",
-                            "precision: QUOTE_PRECISION"
-                        ],
-                        "type": "u64"
                     }
                 ]
             }
@@ -23772,14 +24048,6 @@
                             }
                         }
                     },
-                    {
-                        "name": "next_epoch_ts",
-                        "docs": [
-                            "The timestamp of the next epoch",
-                            "Epoch is used to limit referrer rewards earned in single epoch"
-                        ],
-                        "type": "i64"
-                    },
                     {
                         "name": "maker_volume_30d",
                         "docs": [
@@ -23871,12 +24139,19 @@
                         ],
                         "type": "u64"
                     },
+                    {
+                        "name": "delegate_permissions",
+                        "docs": [
+                            "Delegate permissions across all sub accounts"
+                        ],
+                        "type": "u8"
+                    },
                     {
                         "name": "padding",
                         "type": {
                             "array": [
                                 "u8",
-                                40
+                                63
                             ]
                         }
                     }
@@ -23913,7 +24188,7 @@
         {
             "name": "_SignedMsgOrderParamsExport",
             "docs": [
-                "unusued placeholder event to force include signed msg types into drift IDL"
+                "unusued placeholder event to force include signed msg types into velocity IDL"
             ],
             "type": {
                 "kind": "struct",