@velocity-exchange/sdk 0.7.0 → 0.9.0

package/lib/browser/idl/velocity.d.ts

@@ -8,7 +8,7 @@ export type Velocity = {
     "address": "vELoC1audYbSYVRXn1vPaV8Axoa9oU6BYmNGZZBDZ1P";
     "metadata": {
         "name": "velocity";
-        "version": "2.163.1";
+        "version": "2.164.0";
         "spec": "0.1.0";
         "description": "Created with Anchor";
     };
@@ -4426,6 +4426,9 @@ export type Velocity = {
                     "name": "liquidator";
                     "writable": true;
                 },
+                {
+                    "name": "liquidatorStats";
+                },
                 {
                     "name": "user";
                     "writable": true;
@@ -6289,6 +6292,9 @@ export type Velocity = {
                 52
             ];
             "accounts": [
+                {
+                    "name": "state";
+                },
                 {
                     "name": "spotMarket";
                     "writable": true;
@@ -6333,6 +6339,40 @@ export type Velocity = {
                         "userStats"
                     ];
                 },
+                {
+                    "name": "spotMarketVault";
+                    "writable": true;
+                    "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": "marketIndex";
+                            }
+                        ];
+                    };
+                },
                 {
                     "name": "insuranceFundVault";
                     "writable": true;
@@ -6369,6 +6409,12 @@ export type Velocity = {
                             }
                         ];
                     };
+                },
+                {
+                    "name": "velocitySigner";
+                },
+                {
+                    "name": "tokenProgram";
                 }
             ];
             "args": [
@@ -6544,12 +6590,6 @@ export type Velocity = {
                 },
                 {
                     "name": "authority";
-                    "relations": [
-                        "user"
-                    ];
-                },
-                {
-                    "name": "user";
                 },
                 {
                     "name": "payer";
@@ -8244,6 +8284,9 @@ export type Velocity = {
                 {
                     "name": "user";
                     "writable": true;
+                },
+                {
+                    "name": "userStats";
                 }
             ];
             "args": [
@@ -11437,6 +11480,42 @@ export type Velocity = {
             ];
             "args": [];
         },
+        {
+            "name": "updateSpotMarketDepositCap";
+            "discriminator": [
+                76,
+                21,
+                179,
+                154,
+                28,
+                161,
+                174,
+                107
+            ];
+            "accounts": [
+                {
+                    "name": "admin";
+                    "signer": true;
+                },
+                {
+                    "name": "state";
+                },
+                {
+                    "name": "spotMarket";
+                    "writable": true;
+                }
+            ];
+            "args": [
+                {
+                    "name": "depositGuardThreshold";
+                    "type": "u64";
+                },
+                {
+                    "name": "maxDepositBpsPerDay";
+                    "type": "u16";
+                }
+            ];
+        },
         {
             "name": "updateSpotMarketExpiry";
             "discriminator": [
@@ -12076,6 +12155,38 @@ export type Velocity = {
                 }
             ];
         },
+        {
+            "name": "updateSpotMarketWithdrawCircuitBreaker";
+            "discriminator": [
+                2,
+                97,
+                135,
+                97,
+                117,
+                169,
+                65,
+                223
+            ];
+            "accounts": [
+                {
+                    "name": "admin";
+                    "signer": true;
+                },
+                {
+                    "name": "state";
+                },
+                {
+                    "name": "spotMarket";
+                    "writable": true;
+                }
+            ];
+            "args": [
+                {
+                    "name": "withdrawCircuitBreakerBps";
+                    "type": "u16";
+                }
+            ];
+        },
         {
             "name": "updateStateMaxInitializeUserFee";
             "discriminator": [
@@ -12355,6 +12466,10 @@ export type Velocity = {
                 {
                     "name": "equityFloor";
                     "type": "u64";
+                },
+                {
+                    "name": "equityFloorBuffer";
+                    "type": "u64";
                 }
             ];
         },
@@ -12776,6 +12891,63 @@ export type Velocity = {
             ];
             "args": [];
         },
+        {
+            "name": "updateUserVaultOwned";
+            "docs": [
+                "Mark a User as vault-owned (its authority is a vault PDA and its equity",
+                "prices vault depositor shares). Set-only and authority-gated: only the",
+                "User's authority may call it, and it is CPI'd by the vaults program at",
+                "vault init. A vault-owned User is skipped by the revenue-share sweep so a",
+                "builder/referral reward can never enter vault NAV (OtterSec #91/#92/#93)."
+            ];
+            "discriminator": [
+                50,
+                156,
+                218,
+                143,
+                216,
+                94,
+                68,
+                93
+            ];
+            "accounts": [
+                {
+                    "name": "user";
+                    "writable": true;
+                    "pda": {
+                        "seeds": [
+                            {
+                                "kind": "const";
+                                "value": [
+                                    117,
+                                    115,
+                                    101,
+                                    114
+                                ];
+                            },
+                            {
+                                "kind": "account";
+                                "path": "authority";
+                            },
+                            {
+                                "kind": "arg";
+                                "path": "subAccountId";
+                            }
+                        ];
+                    };
+                },
+                {
+                    "name": "authority";
+                    "signer": true;
+                }
+            ];
+            "args": [
+                {
+                    "name": "subAccountId";
+                    "type": "u16";
+                }
+            ];
+        },
         {
             "name": "updateWarmAdmin";
             "discriminator": [
@@ -16163,6 +16335,41 @@ export type Velocity = {
             "code": 6359;
             "name": "invalidEquityFloorTransfer";
             "msg": "Invalid equity floor transfer between subaccounts";
+        },
+        {
+            "code": 6360;
+            "name": "ifDepositMintsZeroShares";
+            "msg": "Insurance fund deposit would mint zero shares";
+        },
+        {
+            "code": 6361;
+            "name": "liquidationWorsensAccountHealth";
+            "msg": "Liquidation would worsen the account's margin shortage";
+        },
+        {
+            "code": 6362;
+            "name": "perpBankruptcyMustPrecedeSpot";
+            "msg": "Perp bankruptcies must be resolved before spot bankruptcies";
+        },
+        {
+            "code": 6363;
+            "name": "invalidRevenueShareRecipient";
+            "msg": "Revenue share recipient user must be sub_account_id 0";
+        },
+        {
+            "code": 6364;
+            "name": "dailyDepositLimit";
+            "msg": "Spot market daily deposit limit hit";
+        },
+        {
+            "code": 6365;
+            "name": "reservedSpotMarketName";
+            "msg": "The name 'USDT' is reserved for the quote spot market (index 0)";
+        },
+        {
+            "code": 6366;
+            "name": "cannotModifyBuilderOrder";
+            "msg": "Cannot modify a builder-coded order; cancel and re-place instead";
         }
     ];
     "types": [
@@ -21210,19 +21417,24 @@ export type Velocity = {
                         };
                     },
                     {
-                        "name": "paddingAlignAmm";
+                        "name": "pendingRevenueShare";
                         "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)`."
+                            "Aggregate accrued builder/referrer revenue-share owed out of this",
+                            "market's `pnl_pool` but not yet paid: incremented as builder and",
+                            "referrer fees accrue on fills (mirrors the per-order",
+                            "`RevenueShareOrder.fees_accrued` writes) and decremented as",
+                            "`sweep_completed_revenue_share_for_market` pays them. The",
+                            "permissionless fee sweep reserves it (like `max(net_user_pnl, 0)` and",
+                            "the floored IF tranche) so a protocol-fee drain can't move the tokens",
+                            "backing already-owed revenue share out of the pnl pool and leave those",
+                            "claims temporarily unpayable. precision: QUOTE_PRECISION.",
+                            "",
+                            "Occupies the 8 bytes Rust naturally inserts to 16-align AMM's leading",
+                            "u128 (formerly explicit `_padding_align_amm`): a u64 at the same",
+                            "8-aligned offset keeps every downstream byte offset and the total size",
+                            "unchanged, so legacy accounts read 0 (nothing owed) until fees accrue."
                         ];
-                        "type": {
-                            "array": [
-                                "u8",
-                                8
-                            ];
-                        };
+                        "type": "u64";
                     },
                     {
                         "name": "amm";
@@ -23004,15 +23216,44 @@ export type Velocity = {
                     {
                         "name": "paddingAlignPfp";
                         "docs": [
-                            "Aligns `protocol_fee_pool`'s leading u128 to a 16-byte struct offset so",
-                            "host (x86_64, align 16) and SBF (align 8) layouts agree. Do not reorder."
+                            "Explicit filler carved from the alignment gap before `protocol_fee_pool`",
+                            "(which must stay at struct offset 752 so host/SBF layouts agree and the",
+                            "borsh/IDL packed offset matches). The gap is 13 bytes; the three",
+                            "configurable-limit fields below plus this 1-byte filler fill it exactly,",
+                            "so `protocol_fee_pool` and every field after it keep their offsets and the",
+                            "account size is unchanged. Reads 0 on markets created before these fields",
+                            "existed. Every byte is explicit so no implicit `#[repr(C)]` pad desyncs",
+                            "off-chain borsh decoders. Do not reorder or resize."
                         ];
-                        "type": {
-                            "array": [
-                                "u8",
-                                8
-                            ];
-                        };
+                        "type": "u8";
+                    },
+                    {
+                        "name": "withdrawCircuitBreakerBps";
+                        "docs": [
+                            "Daily withdraw circuit-breaker size: the max fraction of the 24h deposit",
+                            "TWAP that may be withdrawn per 24h window. `0` is treated as the default",
+                            "(2500 bps = 25%) so markets created before this field existed keep prior",
+                            "behavior. precision: basis points (10_000 = 100%)"
+                        ];
+                        "type": "u16";
+                    },
+                    {
+                        "name": "maxDepositBpsPerDay";
+                        "docs": [
+                            "Daily deposit rate limit: the max fraction above the 24h deposit TWAP that",
+                            "resulting deposits may reach per 24h window. Disabled when `0`.",
+                            "precision: basis points (10_000 = 100%)"
+                        ];
+                        "type": "u16";
+                    },
+                    {
+                        "name": "depositGuardThreshold";
+                        "docs": [
+                            "No deposit rate limit when resulting deposits are below this threshold.",
+                            "Mirrors `withdraw_guard_threshold` on the deposit side.",
+                            "precision: token mint precision"
+                        ];
+                        "type": "u64";
                     },
                     {
                         "name": "protocolFeePool";
@@ -23048,13 +23289,33 @@ export type Velocity = {
                         "type": "u32";
                     },
                     {
-                        "name": "padding";
-                        "type": {
-                            "array": [
-                                "u8",
-                                8
-                            ];
-                        };
+                        "name": "ifLastSettleVaultAmount";
+                        "docs": [
+                            "Donation-proof accounted balance of the insurance-fund vault. It is moved",
+                            "by the same signed delta as the real SPL vault on *every* instruction that",
+                            "moves the vault, so it stays a faithful shadow of the vault minus raw",
+                            "donations. Inflows grow it: staker deposits (`add_insurance_fund_stake`)",
+                            "and settled revenue (`settle_revenue_to_insurance_fund`). Outflows/draws",
+                            "shrink it (saturating at 0): staker withdrawals",
+                            "(`remove_insurance_fund_stake`) and every IF draw that covers a loss —",
+                            "`resolve_perp_pnl_deficit`, `resolve_perp_bankruptcy`,",
+                            "`resolve_spot_bankruptcy`. The one movement deliberately *excluded* is a",
+                            "raw SPL transfer straight into the vault: it runs no instruction, so it",
+                            "never enters this balance — that is exactly the donation the shadow must",
+                            "not see. Consumed by the per-period revenue-settle APR cap in",
+                            "`settle_revenue_to_insurance_fund`, sized off `min(live_if_vault, this)`,",
+                            "so a donation spiked into the live vault right before a settle cannot",
+                            "inflate the cap while legitimate stakes and real settled revenue (which",
+                            "this balance tracks) still do. (The unstake-cancel share forfeiture is",
+                            "donation-proofed differently — by withdraw-and-restake at the active share",
+                            "price — and does *not* read this field.) Repurposed from trailing padding —",
+                            "layout/size unchanged; `0` means \"uninitialized\" (existing account",
+                            "pre-upgrade, or an accounted balance legitimately drained to empty — an",
+                            "empty IF vault has no user shares, so this is safe), and is seeded from the",
+                            "live balance on the next add/settle and treated as \"fall back to live\" by",
+                            "the consumers."
+                        ];
+                        "type": "u64";
                     }
                 ];
             };
@@ -23875,21 +24136,24 @@ export type Velocity = {
                     {
                         "name": "equityFloor";
                         "docs": [
-                            "Minimum account equity (cross-margin total collateral) required for",
-                            "risk-increasing orders, fills, withdrawals and deposit transfers.",
-                            "Settable only by the warm/cold admin; 0 disables the check.",
+                            "Minimum account equity (cross-margin total collateral). Below this the",
+                            "permissionless breaker can trip. Risk-increasing orders, fills,",
+                            "withdrawals and deposit transfers must clear `equity_floor +",
+                            "equity_floor_buffer`. Settable only by the warm/cold admin; 0 disables",
+                            "both checks.",
                             "precision: QUOTE_PRECISION"
                         ];
                         "type": "u64";
                     },
                     {
-                        "name": "padding2";
-                        "type": {
-                            "array": [
-                                "u8",
-                                8
-                            ];
-                        };
+                        "name": "equityFloorBuffer";
+                        "docs": [
+                            "Extra headroom above `equity_floor` required by risk-increasing",
+                            "actions, so an account cannot legally end an action at the trip",
+                            "threshold. No effect while `equity_floor` is 0.",
+                            "precision: QUOTE_PRECISION"
+                        ];
+                        "type": "u64";
                     }
                 ];
             };