@velocity-exchange/sdk 0.6.1 → 0.8.0

package/lib/node/blockhashSubscriber/BlockhashSubscriber.js

@@ -3,12 +3,21 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.BlockhashSubscriber = void 0;
 const web3_js_1 = require("@solana/web3.js");
 /**
- * BlockhashSubscriber — polls `getLatestBlockhashAndContext`/`getBlockHeight`
- * on a fixed interval and caches a short history of recent blockhashes, so
- * callers can grab a recent blockhash for transaction building without an
- * RPC round-trip per transaction. Nothing is populated until `subscribe()`
- * (or a manual `updateBlockhash()`) has completed at least once — all getters
- * return `undefined`/empty before then.
+ * A blockhash is valid for signing until 150 blocks after the block it was
+ * fetched from, so `getLatestBlockhash`'s `lastValidBlockHeight` is exactly
+ * `(block height of that blockhash) + 150`. Subtracting this offset recovers
+ * the current block height without a second RPC call.
+ */
+const BLOCKHASH_VALIDITY_BLOCKS = 150;
+/**
+ * BlockhashSubscriber — polls `getLatestBlockhashAndContext` on a fixed
+ * interval and caches a short history of recent blockhashes, so callers can
+ * grab a recent blockhash for transaction building without an RPC round-trip
+ * per transaction. The current block height is derived from the same response
+ * (`lastValidBlockHeight - 150`), so no paired `getBlockHeight` call is made.
+ * Nothing is populated until `subscribe()` (or a manual `updateBlockhash()`)
+ * has completed at least once — all getters return `undefined`/empty before
+ * then.
  */
 class BlockhashSubscriber {
     /**
@@ -34,9 +43,9 @@ class BlockhashSubscriber {
      * @returns The block height as of the most recent successful poll, or
      * `undefined` if `subscribe()`/`updateBlockhash()` has not yet completed
      * successfully at least once (including if every poll so far has errored).
-     * This value is a `getBlockHeight` snapshot taken alongside the latest
-     * blockhash fetch — it is not guaranteed to be perfectly in sync with the
-     * blockhash slot, only "recent as of the last poll".
+     * This value is derived from the latest blockhash fetch
+     * (`lastValidBlockHeight - 150`) — it is not guaranteed to be perfectly in
+     * sync with the blockhash slot, only "recent as of the last poll".
      */
     getLatestBlockHeight() {
         return this.latestBlockHeight;
@@ -69,22 +78,22 @@ class BlockhashSubscriber {
         }
     }
     /**
-     * Fetches the latest blockhash and block height in parallel and appends
-     * the blockhash to the cache (skipped if it's identical to the
-     * most-recently-cached one), then prunes expired entries. Errors (e.g. RPC
-     * failure) are caught and logged, not thrown — on error, `latestBlockHeight`
-     * is left at its previous value, but `pruneBlockhashes()` still runs in a
-     * `finally` block and may evict entries that expired in the meantime.
+     * Fetches the latest blockhash and appends it to the cache (skipped if it's
+     * identical to the most-recently-cached one), then prunes expired entries.
+     * The current block height is derived from the same response
+     * (`lastValidBlockHeight - 150`) rather than a paired `getBlockHeight` call.
+     * Errors (e.g. RPC failure) are caught and logged, not thrown — on error,
+     * `latestBlockHeight` is left at its previous value, but `pruneBlockhashes()`
+     * still runs in a `finally` block and may evict entries that expired in the
+     * meantime.
      */
     async updateBlockhash() {
         try {
-            const [resp, lastConfirmedBlockHeight] = await Promise.all([
-                this.connection.getLatestBlockhashAndContext({
-                    commitment: this.commitment,
-                }),
-                this.connection.getBlockHeight({ commitment: this.commitment }),
-            ]);
-            this.latestBlockHeight = lastConfirmedBlockHeight;
+            const resp = await this.connection.getLatestBlockhashAndContext({
+                commitment: this.commitment,
+            });
+            this.latestBlockHeight =
+                resp.value.lastValidBlockHeight - BLOCKHASH_VALIDITY_BLOCKS;
             this.latestBlockHeightContext = resp.context;
             // avoid caching duplicate blockhashes
             if (this.blockhashes.length > 0) {

package/lib/node/constants/numericConstants.d.ts

@@ -102,6 +102,8 @@ export declare const FUNDING_RATE_CLAMP_DENOMINATOR: BN;
 export declare const PRICE_TIMES_AMM_TO_QUOTE_PRECISION_RATIO: BN;
 /** 300 seconds. */
 export declare const FIVE_MINUTE: BN;
+/** Max age of the last fill before the trigger price's last-fill leg is treated as absent (oracle price substitutes). */
+export declare const TRIGGER_PRICE_LAST_FILL_MAX_AGE: BN;
 /** 3600 seconds. */
 export declare const ONE_HOUR: BN;
 /** 31,536,000 seconds (365 days). */

package/lib/node/constants/numericConstants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"numericConstants.d.ts","sourceRoot":"","sources":["../../../src/constants/numericConstants.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"numericConstants.d.ts","sourceRoot":"","sources":["../../../src/constants/numericConstants.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,EAAE,EAAE,MAAM,sBAAsB,CAAC;AAE1C,mZAAmZ;AACnZ,eAAO,MAAM,IAAI,IAAY,CAAC;AAC9B,eAAO,MAAM,GAAG,IAAY,CAAC;AAC7B,eAAO,MAAM,GAAG,IAAY,CAAC;AAC7B,eAAO,MAAM,KAAK,IAAY,CAAC;AAC/B,eAAO,MAAM,IAAI,IAAY,CAAC;AAC9B,eAAO,MAAM,IAAI,IAAY,CAAC;AAC9B,eAAO,MAAM,GAAG,IAAY,CAAC;AAC7B,eAAO,MAAM,KAAK,IAAY,CAAC;AAC/B,eAAO,MAAM,KAAK,IAAY,CAAC;AAC/B,eAAO,MAAM,IAAI,IAAY,CAAC;AAC9B,eAAO,MAAM,GAAG,IAAa,CAAC;AAC9B,eAAO,MAAM,YAAY,IAAgB,CAAC;AAC1C,wJAAwJ;AACxJ,eAAO,MAAM,MAAM,IAAkC,CAAC;AACtD,eAAO,MAAM,WAAW,IAAiC,CAAC;AAE1D,iHAAiH;AACjH,eAAO,MAAM,YAAY,IAAY,CAAC;AACtC,8GAA8G;AAC9G,eAAO,MAAM,uBAAuB,IAAiC,CAAC;AAEtE,iDAAiD;AACjD,eAAO,MAAM,wBAAwB,IAAY,CAAC;AAClD,kIAAkI;AAClI,eAAO,MAAM,oBAAoB,IAA2C,CAAC;AAC7E,qFAAqF;AACrF,eAAO,MAAM,uBAAuB,IAAuB,CAAC;AAE5D,4CAA4C;AAC5C,eAAO,MAAM,mBAAmB,IAAY,CAAC;AAC7C,6HAA6H;AAC7H,eAAO,MAAM,iCAAiC,IAAY,CAAC;AAC3D,4CAA4C;AAC5C,eAAO,MAAM,mBAAmB,IAAY,CAAC;AAC7C,iHAAiH;AACjH,eAAO,MAAM,0BAA0B,IAEtC,CAAC;AACF,0CAA0C;AAC1C,eAAO,MAAM,iBAAiB,IAAY,CAAC;AAC3C,qEAAqE;AACrE,eAAO,MAAM,yBAAyB,IAAY,CAAC;AAEnD,uDAAuD;AACvD,eAAO,MAAM,8BAA8B,IAAY,CAAC;AACxD,kGAAkG;AAClG,eAAO,MAAM,0BAA0B,IAEtC,CAAC;AAEF,uEAAuE;AACvE,eAAO,MAAM,6CAA6C,IAAa,CAAC;AACxE,oGAAoG;AACpG,eAAO,MAAM,yCAAyC,IAErD,CAAC;AAEF,8DAA8D;AAC9D,eAAO,MAAM,qCAAqC,IAAY,CAAC;AAC/D,mGAAmG;AACnG,eAAO,MAAM,iCAAiC,IAE7C,CAAC;AAEF,yJAAyJ;AACzJ,eAAO,MAAM,4BAA4B,IAAgB,CAAC;AAC1D,0DAA0D;AAC1D,eAAO,MAAM,iCAAiC,IAAY,CAAC;AAC3D,mNAAmN;AACnN,eAAO,MAAM,6BAA6B,IAEzC,CAAC;AACF,sDAAsD;AACtD,eAAO,MAAM,6BAA6B,IAAY,CAAC;AAEvD,4HAA4H;AAC5H,eAAO,MAAM,yBAAyB,IAErC,CAAC;AACF,sHAAsH;AACtH,eAAO,MAAM,yBAAyB,IAAkB,CAAC;AAEzD,uJAAuJ;AACvJ,eAAO,MAAM,eAAe,IAAsC,CAAC;AACnE,4FAA4F;AAC5F,eAAO,MAAM,eAAe,IAAsC,CAAC;AACnE,8JAA8J;AAC9J,eAAO,MAAM,sBAAsB,IAElC,CAAC;AACF,0FAA0F;AAC1F,eAAO,MAAM,6BAA6B,IAEzC,CAAC;AACF,mFAAmF;AACnF,eAAO,MAAM,aAAa,IAAoC,CAAC;AAE/D,gJAAgJ;AAChJ,eAAO,MAAM,qBAAqB,IAA4C,CAAC;AAE/E,4IAA4I;AAC5I,eAAO,MAAM,cAAc,IAAwB,CAAC;AACpD,eAAO,MAAM,kBAAkB,IAA4B,CAAC;AAE5D,yGAAyG;AACzG,eAAO,MAAM,4BAA4B,IACE,CAAC;AAC5C,sEAAsE;AACtE,eAAO,MAAM,aAAa,IAAqC,CAAC;AAChE,wEAAwE;AACxE,eAAO,MAAM,wBAAwB,IAAuC,CAAC;AAC7E,6HAA6H;AAC7H,eAAO,MAAM,sCAAsC,IACW,CAAC;AAC/D,2KAA2K;AAC3K,eAAO,MAAM,gBAAgB,IAAe,CAAC;AAC7C,kHAAkH;AAClH,eAAO,MAAM,aAAa,IAAe,CAAC;AAC1C,gJAAgJ;AAChJ,eAAO,MAAM,wBAAwB,IAAkB,CAAC;AACxD,mIAAmI;AACnI,eAAO,MAAM,yBAAyB,IAAe,CAAC;AACtD,yHAAyH;AACzH,eAAO,MAAM,+BAA+B,IAAe,CAAC;AAC5D,uHAAuH;AACvH,eAAO,MAAM,8BAA8B,IAE1C,CAAC;AACF,oFAAoF;AACpF,eAAO,MAAM,8BAA8B,IAAe,CAAC;AAC3D,iJAAiJ;AACjJ,eAAO,MAAM,wCAAwC,IAEpD,CAAC;AAEF,mBAAmB;AACnB,eAAO,MAAM,WAAW,IAAiB,CAAC;AAC1C,yHAAyH;AACzH,eAAO,MAAM,+BAA+B,IAAc,CAAC;AAC3D,oBAAoB;AACpB,eAAO,MAAM,QAAQ,IAAkB,CAAC;AACxC,qCAAqC;AACrC,eAAO,MAAM,QAAQ,IAAmB,CAAC;AAEzC,gGAAgG;AAChG,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC,mFAAmF;AACnF,eAAO,MAAM,kBAAkB,IAA2B,CAAC;AAC3D,oDAAoD;AACpD,eAAO,MAAM,YAAY,IAAuC,CAAC;AAEjE,2GAA2G;AAC3G,eAAO,MAAM,6BAA6B,IAAmC,CAAC;AAE9E,2MAA2M;AAC3M,eAAO,MAAM,iDAAiD,IAExC,CAAC;AAEvB,0HAA0H;AAC1H,eAAO,MAAM,mCAAmC,QAAoB,CAAC;AACrE,yHAAyH;AACzH,eAAO,MAAM,eAAe,OAAO,CAAC;AACpC,sHAAsH;AACtH,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAEzC,6HAA6H;AAC7H,eAAO,MAAM,kBAAkB,IAA4B,CAAC;AAE5D;;;;;;GAMG;AACH,eAAO,MAAM,oCAAoC,IAEhD,CAAC;AAEF,yIAAyI;AACzI,eAAO,MAAM,gCAAgC,KAAK,CAAC;AAMnD,wCAAwC;AACxC,eAAO,MAAM,OAAO,IAAgC,CAAC;AACrD,yCAAyC;AACzC,eAAO,MAAM,OAAO,IAAiC,CAAC"}

package/lib/node/constants/numericConstants.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MARGIN_PRECISION = exports.AMM_TIMES_PEG_TO_QUOTE_PRECISION_RATIO = exports.PRICE_TO_QUOTE_PRECISION = exports.PRICE_DIV_PEG = exports.AMM_TO_QUOTE_PRECISION_RATIO = exports.BASE_PRECISION_EXP = exports.BASE_PRECISION = exports.AMM_RESERVE_PRECISION = exports.PEG_PRECISION = exports.FUNDING_RATE_BUFFER_PRECISION = exports.FUNDING_RATE_PRECISION = exports.PRICE_PRECISION = exports.QUOTE_PRECISION = exports.LIQUIDATION_FEE_PRECISION = exports.SPOT_MARKET_IMF_PRECISION = exports.SPOT_MARKET_IMF_PRECISION_EXP = exports.SPOT_MARKET_BALANCE_PRECISION = exports.SPOT_MARKET_BALANCE_PRECISION_EXP = exports.SPOT_MARKET_WEIGHT_PRECISION = exports.SPOT_MARKET_UTILIZATION_PRECISION = exports.SPOT_MARKET_UTILIZATION_PRECISION_EXP = exports.SPOT_MARKET_CUMULATIVE_INTEREST_PRECISION = exports.SPOT_MARKET_CUMULATIVE_INTEREST_PRECISION_EXP = exports.SPOT_MARKET_RATE_PRECISION = exports.SPOT_MARKET_RATE_PRECISION_EXP = exports.AMM_RESERVE_PRECISION_EXP = exports.PEG_PRECISION_EXP = exports.FUNDING_RATE_PRECISION_EXP = exports.PRICE_PRECISION_EXP = exports.FUNDING_RATE_BUFFER_PRECISION_EXP = exports.QUOTE_PRECISION_EXP = exports.CONCENTRATION_PRECISION = exports.PERCENTAGE_PRECISION = exports.PERCENTAGE_PRECISION_EXP = exports.MAX_LEVERAGE_ORDER_SIZE = exports.MAX_LEVERAGE = exports.TEN_MILLION = exports.BN_MAX = exports.TEN_THOUSAND = exports.TEN = exports.NINE = exports.EIGHT = exports.SEVEN = exports.SIX = exports.FIVE = exports.FOUR = exports.THREE = exports.TWO = exports.ONE = exports.ZERO = void 0;
-exports.MIN_I64 = exports.MAX_I64 = exports.GET_MULTIPLE_ACCOUNTS_CHUNK_SIZE = exports.MAX_POSITIVE_UPNL_FOR_INITIAL_MARGIN = exports.DUST_POSITION_SIZE = exports.SLOT_TIME_ESTIMATE_MS = exports.IDLE_TIME_SLOTS = exports.ACCOUNT_AGE_DELETION_CUTOFF_SECONDS = exports.DEFAULT_REVENUE_SINCE_LAST_FUNDING_SPREAD_RETREAT = exports.OPEN_ORDER_MARGIN_REQUIREMENT = exports.LAMPORTS_EXP = exports.LAMPORTS_PRECISION = exports.QUOTE_SPOT_MARKET_INDEX = exports.ONE_YEAR = exports.ONE_HOUR = exports.FIVE_MINUTE = exports.PRICE_TIMES_AMM_TO_QUOTE_PRECISION_RATIO = exports.FUNDING_RATE_CLAMP_DENOMINATOR = exports.FUNDING_RATE_OFFSET_PERCENTAGE = exports.FUNDING_RATE_OFFSET_DENOMINATOR = exports.LIQUIDATION_PCT_PRECISION = exports.BID_ASK_SPREAD_PRECISION = exports.BPS_PRECISION = void 0;
+exports.MIN_I64 = exports.MAX_I64 = exports.GET_MULTIPLE_ACCOUNTS_CHUNK_SIZE = exports.MAX_POSITIVE_UPNL_FOR_INITIAL_MARGIN = exports.DUST_POSITION_SIZE = exports.SLOT_TIME_ESTIMATE_MS = exports.IDLE_TIME_SLOTS = exports.ACCOUNT_AGE_DELETION_CUTOFF_SECONDS = exports.DEFAULT_REVENUE_SINCE_LAST_FUNDING_SPREAD_RETREAT = exports.OPEN_ORDER_MARGIN_REQUIREMENT = exports.LAMPORTS_EXP = exports.LAMPORTS_PRECISION = exports.QUOTE_SPOT_MARKET_INDEX = exports.ONE_YEAR = exports.ONE_HOUR = exports.TRIGGER_PRICE_LAST_FILL_MAX_AGE = exports.FIVE_MINUTE = exports.PRICE_TIMES_AMM_TO_QUOTE_PRECISION_RATIO = exports.FUNDING_RATE_CLAMP_DENOMINATOR = exports.FUNDING_RATE_OFFSET_PERCENTAGE = exports.FUNDING_RATE_OFFSET_DENOMINATOR = exports.LIQUIDATION_PCT_PRECISION = exports.BID_ASK_SPREAD_PRECISION = exports.BPS_PRECISION = void 0;
 const web3_js_1 = require("@solana/web3.js");
 const anchor_1 = require("../isomorphic/anchor");
 /** Precision constants used throughout the SDK. Each mirrors an on-chain fixed-point scale — a raw `BN` amount at that precision represents `amount / 10^exponent` in human units (e.g. `PRICE_PRECISION` = 1e6, so a raw price of `1_500_000` is `$1.50`). Values must stay numerically identical to the Rust program's `math::constants` — a mismatch here silently mis-scales every derived SDK computation. */
@@ -107,6 +107,8 @@ exports.FUNDING_RATE_CLAMP_DENOMINATOR = new anchor_1.BN(2000);
 exports.PRICE_TIMES_AMM_TO_QUOTE_PRECISION_RATIO = exports.PRICE_PRECISION.mul(exports.AMM_TO_QUOTE_PRECISION_RATIO);
 /** 300 seconds. */
 exports.FIVE_MINUTE = new anchor_1.BN(60 * 5);
+/** Max age of the last fill before the trigger price's last-fill leg is treated as absent (oracle price substitutes). */
+exports.TRIGGER_PRICE_LAST_FILL_MAX_AGE = exports.FIVE_MINUTE;
 /** 3600 seconds. */
 exports.ONE_HOUR = new anchor_1.BN(60 * 60);
 /** 31,536,000 seconds (365 days). */

package/lib/node/core/VelocityCore.d.ts

@@ -224,6 +224,7 @@ export declare class VelocityCore {
      * @param args.state - the global `State` PDA.
      * @param args.filler - the keeper's `User` account submitting the trigger.
      * @param args.user - the order owner's `User` account.
+     * @param args.userStats - the order owner's `UserStats` account (authority-wide equity breaker).
      * @param args.authority - signer that must own or be a registered delegate of `filler`.
      * @param args.remainingAccounts - oracle/market `AccountMeta[]` for the order's market.
      * @returns the unsigned `triggerOrder` `TransactionInstruction`.
@@ -234,6 +235,7 @@ export declare class VelocityCore {
         state: PublicKey;
         filler: PublicKey;
         user: PublicKey;
+        userStats: PublicKey;
         authority: PublicKey;
         remainingAccounts: AccountMeta[];
     }): Promise<TransactionInstruction>;

package/lib/node/core/VelocityCore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VelocityCore.d.ts","sourceRoot":"","sources":["../../../src/core/VelocityCore.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"VelocityCore.d.ts","sourceRoot":"","sources":["../../../src/core/VelocityCore.ts"],"names":[],"mappings":";;AAAA,OAAO,KAAK,EACX,WAAW,EACX,UAAU,EACV,SAAS,EACT,sBAAsB,EACtB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,IAAI,MAAM,kBAAkB,CAAC;AACzC,OAAO,KAAK,SAAS,MAAM,cAAc,CAAC;AAE1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAEjD,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,mBAAmB,CAAC;AAsB5C,OAAO,KAAK,iBAAiB,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AAEzC;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG;IACjC,2BAA2B;IAC3B,SAAS,EAAE,SAAS,CAAC;IAErB,8EAA8E;IAC9E,GAAG,CAAC,EAAE,QAAQ,CAAC;CACf,CAAC;AAEF;;;;;;;;;GASG;AACH,qBAAa,YAAY;IACxB,kHAAkH;IAClH,MAAM,CAAC,QAAQ,CAAC,IAAI,cAAQ;IAE5B,wGAAwG;IACxG,MAAM,CAAC,QAAQ,CAAC,SAAS,mBAAa;IAEtC,6JAA6J;IAC7J,MAAM,CAAC,QAAQ,CAAC,iBAAiB,2BAAqB;IAEtD,2GAA2G;IAC3G,MAAM,CAAC,QAAQ,CAAC,SAAS,mBAAa;IAEtC,gGAAgG;IAChG,MAAM,CAAC,UAAU,IAAI,QAAQ;IAI7B;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,GAAG,GAAE,QAAoC,GAAG,gBAAgB;IAIzE;;;;;;;OAOG;IACH,MAAM,CAAC,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW;IAIrD;;;;;OAKG;WACU,gBAAgB,CAC5B,UAAU,EAAE,UAAU,EACtB,oBAAoB,EAAE,SAAS,GAC7B,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAK9B;;;;;;;;;;;;;;;;;;;;;OAqBG;WACU,uBAAuB,CAAC,IAAI,EAAE;QAC1C,OAAO,EAAE,eAAe,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,EAAE,CAAC;QACX,UAAU,EAAE,OAAO,CAAC;QACpB,KAAK,EAAE,SAAS,CAAC;QACjB,UAAU,EAAE,SAAS,CAAC;QACtB,eAAe,EAAE,SAAS,CAAC;QAC3B,IAAI,EAAE,SAAS,CAAC;QAChB,SAAS,EAAE,SAAS,CAAC;QACrB,gBAAgB,EAAE,SAAS,CAAC;QAC5B,SAAS,EAAE,SAAS,CAAC;QACrB,YAAY,EAAE,SAAS,CAAC;QACxB,iBAAiB,EAAE,WAAW,EAAE,CAAC;KACjC,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAInC;;;;;;;;;;;;;;;;;;;;OAoBG;WACU,wBAAwB,CAAC,IAAI,EAAE;QAC3C,OAAO,EAAE,eAAe,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,EAAE,CAAC;QACX,UAAU,EAAE,OAAO,CAAC;QACpB,KAAK,EAAE,SAAS,CAAC;QACjB,UAAU,EAAE,SAAS,CAAC;QACtB,eAAe,EAAE,SAAS,CAAC;QAC3B,cAAc,EAAE,SAAS,CAAC;QAC1B,IAAI,EAAE,SAAS,CAAC;QAChB,SAAS,EAAE,SAAS,CAAC;QACrB,gBAAgB,EAAE,SAAS,CAAC;QAC5B,SAAS,EAAE,SAAS,CAAC;QACrB,YAAY,EAAE,SAAS,CAAC;QACxB,iBAAiB,EAAE,WAAW,EAAE,CAAC;KACjC,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAInC;;;;;;;;;;;;OAYG;WACU,2BAA2B,CAAC,IAAI,EAAE;QAC9C,OAAO,EAAE,eAAe,CAAC;QACzB,eAAe,EAAE,GAAG,EAAE,CAAC;QACvB,KAAK,EAAE,SAAS,CAAC;QACjB,IAAI,EAAE,SAAS,CAAC;QAChB,SAAS,EAAE,SAAS,CAAC;QACrB,SAAS,EAAE,SAAS,CAAC;QACrB,iBAAiB,EAAE,WAAW,EAAE,CAAC;KACjC,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAInC;;;;;;;;;;;;;;;OAeG;WACU,4BAA4B,CAAC,IAAI,EAAE;QAC/C,OAAO,EAAE,eAAe,CAAC;QACzB,UAAU,EAAE,GAAG,CAAC;QAChB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,SAAS,EAAE,GAAG,CAAC;QACf,IAAI,EAAE,SAAS,CAAC;QAChB,KAAK,EAAE,SAAS,CAAC;QACjB,SAAS,EAAE,SAAS,CAAC;QACrB,SAAS,EAAE,SAAS,CAAC;QACrB,iBAAiB,EAAE,WAAW,EAAE,CAAC;KACjC,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAInC;;;;;;;;;;;;;;OAcG;WACU,6BAA6B,CAAC,IAAI,EAAE;QAChD,OAAO,EAAE,eAAe,CAAC;QACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,KAAK,EAAE,SAAS,CAAC;QACjB,MAAM,EAAE,SAAS,CAAC;QAClB,WAAW,EAAE,SAAS,CAAC;QACvB,IAAI,EAAE,SAAS,CAAC;QAChB,SAAS,EAAE,SAAS,CAAC;QACrB,SAAS,EAAE,SAAS,CAAC;QACrB,iBAAiB,EAAE,WAAW,EAAE,CAAC;KACjC,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAInC;;;;;;;;;;;;;;;OAeG;WACU,4BAA4B,CAAC,IAAI,EAAE;QAC/C,OAAO,EAAE,eAAe,CAAC;QACzB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,SAAS,CAAC;QACjB,MAAM,EAAE,SAAS,CAAC;QAClB,IAAI,EAAE,SAAS,CAAC;QAChB,SAAS,EAAE,SAAS,CAAC;QACrB,SAAS,EAAE,SAAS,CAAC;QACrB,iBAAiB,EAAE,WAAW,EAAE,CAAC;KACjC,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAInC;;;;;;;;;;;;OAYG;WACU,yBAAyB,CAAC,IAAI,EAAE;QAC5C,OAAO,EAAE,eAAe,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,EAAE,SAAS,CAAC;QACjB,SAAS,EAAE,SAAS,CAAC;QACrB,IAAI,EAAE,SAAS,CAAC;QAChB,eAAe,EAAE,SAAS,CAAC;QAC3B,iBAAiB,EAAE,WAAW,EAAE,CAAC;KACjC,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAInC;;;;;;;;;;;;;;;;OAgBG;WACU,6BAA6B,CAAC,IAAI,EAAE;QAChD,OAAO,EAAE,eAAe,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;QACpB,kBAAkB,EAAE,GAAG,CAAC;QACxB,UAAU,EAAE,GAAG,GAAG,IAAI,CAAC;QACvB,KAAK,EAAE,SAAS,CAAC;QACjB,SAAS,EAAE,SAAS,CAAC;QACrB,IAAI,EAAE,SAAS,CAAC;QAChB,SAAS,EAAE,SAAS,CAAC;QACrB,UAAU,EAAE,SAAS,CAAC;QACtB,eAAe,EAAE,SAAS,CAAC;QAC3B,iBAAiB,EAAE,WAAW,EAAE,CAAC;KACjC,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAInC;;;;;;;;;;;;OAYG;WACU,8BAA8B,CAAC,IAAI,EAAE;QACjD,OAAO,EAAE,eAAe,CAAC;QACzB,WAAW,EAAE,GAAG,CAAC;QACjB,KAAK,EAAE,SAAS,CAAC;QACjB,IAAI,EAAE,SAAS,CAAC;QAChB,SAAS,EAAE,SAAS,CAAC;QACrB,SAAS,EAAE,SAAS,CAAC;QACrB,iBAAiB,EAAE,WAAW,EAAE,CAAC;KACjC,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAInC;;;;;;;;;;;;;;;OAeG;WACU,qCAAqC,CAAC,IAAI,EAAE;QACxD,OAAO,EAAE,eAAe,CAAC;QACzB,WAAW,EAAE,GAAG,CAAC;QACjB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,KAAK,EAAE,SAAS,CAAC;QACjB,IAAI,EAAE,SAAS,CAAC;QAChB,SAAS,EAAE,SAAS,CAAC;QACrB,SAAS,EAAE,SAAS,CAAC;QACrB,iBAAiB,EAAE,WAAW,EAAE,CAAC;KACjC,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAInC;;;;;;;;;;;;;;;;;OAiBG;WACU,qCAAqC,CAAC,IAAI,EAAE;QACxD,OAAO,EAAE,eAAe,CAAC;QACzB,WAAW,EAAE,GAAG,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,KAAK,EAAE,SAAS,CAAC;QACjB,IAAI,EAAE,SAAS,CAAC;QAChB,SAAS,EAAE,SAAS,CAAC;QACrB,KAAK,EAAE,SAAS,CAAC;QACjB,UAAU,EAAE,SAAS,CAAC;QACtB,SAAS,EAAE,SAAS,CAAC;QACrB,iBAAiB,EAAE,WAAW,EAAE,CAAC;KACjC,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAInC;;;;;;;;;OASG;WACU,2BAA2B,CAAC,IAAI,EAAE;QAC9C,OAAO,EAAE,eAAe,CAAC;QACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,KAAK,EAAE,SAAS,CAAC;QACjB,IAAI,EAAE,SAAS,CAAC;QAChB,SAAS,EAAE,SAAS,CAAC;QACrB,iBAAiB,EAAE,WAAW,EAAE,CAAC;KACjC,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAInC;;;;;;;;;;;;OAYG;WACU,mCAAmC,CAAC,IAAI,EAAE;QACtD,OAAO,EAAE,eAAe,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,EAAE,SAAS,CAAC;QACjB,IAAI,EAAE,SAAS,CAAC;QAChB,SAAS,EAAE,SAAS,CAAC;QACrB,MAAM,EAAE,SAAS,CAAC;QAClB,iBAAiB,EAAE,WAAW,EAAE,CAAC;KACjC,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAInC;;;;;;;;;;OAUG;WACU,iCAAiC,CAAC,IAAI,EAAE;QACpD,OAAO,EAAE,eAAe,CAAC;QACzB,QAAQ,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;QAC/B,KAAK,EAAE,SAAS,CAAC;QACjB,IAAI,EAAE,SAAS,CAAC;QAChB,SAAS,EAAE,SAAS,CAAC;QACrB,iBAAiB,EAAE,WAAW,EAAE,CAAC;KACjC,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAInC;;;;;;;;;;;;OAYG;WACU,2BAA2B,CAAC,IAAI,EAAE;QAC9C,OAAO,EAAE,eAAe,CAAC;QACzB,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,GAAG,CAAC;QAClB,KAAK,EAAE,SAAS,CAAC;QACjB,IAAI,EAAE,SAAS,CAAC;QAChB,SAAS,EAAE,SAAS,CAAC;QACrB,SAAS,EAAE,SAAS,CAAC;QACrB,iBAAiB,EAAE,WAAW,EAAE,CAAC;KACjC,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAInC;;;;;;;;;;;;OAYG;WACU,mCAAmC,CAAC,IAAI,EAAE;QACtD,OAAO,EAAE,eAAe,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,GAAG,CAAC;QAClB,KAAK,EAAE,SAAS,CAAC;QACjB,IAAI,EAAE,SAAS,CAAC;QAChB,SAAS,EAAE,SAAS,CAAC;QACrB,SAAS,EAAE,SAAS,CAAC;QACrB,iBAAiB,EAAE,WAAW,EAAE,CAAC;KACjC,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAInC;;;;;;;;;;OAUG;WACU,iCAAiC,CAAC,IAAI,EAAE;QACpD,OAAO,EAAE,eAAe,CAAC;QACzB,eAAe,EAAE,MAAM,CAAC;QACxB,KAAK,EAAE,SAAS,CAAC;QACjB,UAAU,EAAE,SAAS,CAAC;QACtB,MAAM,EAAE,SAAS,CAAC;KAClB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAInC;;;;;OAKG;IACH,MAAM,CAAC,iBAAiB,CACvB,IAAI,EAAE,mBAAmB,GACvB,sBAAsB,EAAE;CAG3B"}

package/lib/node/core/VelocityCore.js

@@ -202,6 +202,7 @@ class VelocityCore {
      * @param args.state - the global `State` PDA.
      * @param args.filler - the keeper's `User` account submitting the trigger.
      * @param args.user - the order owner's `User` account.
+     * @param args.userStats - the order owner's `UserStats` account (authority-wide equity breaker).
      * @param args.authority - signer that must own or be a registered delegate of `filler`.
      * @param args.remainingAccounts - oracle/market `AccountMeta[]` for the order's market.
      * @returns the unsigned `triggerOrder` `TransactionInstruction`.

package/lib/node/core/instructions/trigger.d.ts

@@ -11,6 +11,9 @@ import type { VelocityProgram } from '../../config';
  * @param args.state - the global `State` PDA.
  * @param args.filler - the keeper's `User` account submitting the trigger.
  * @param args.user - the order owner's `User` account.
+ * @param args.userStats - the order owner's `UserStats` account (checked for the
+ *   authority-wide equity breaker; a risk-increasing trigger order is cancelled
+ *   rather than activated while the breaker is tripped).
  * @param args.authority - signer that must own or be a registered delegate of `filler`.
  * @param args.remainingAccounts - oracle/market `AccountMeta[]` for the order's market.
  * @returns the unsigned `triggerOrder` `TransactionInstruction`.
@@ -21,6 +24,7 @@ export declare function buildTriggerOrderInstruction(args: {
     state: PublicKey;
     filler: PublicKey;
     user: PublicKey;
+    userStats: PublicKey;
     authority: PublicKey;
     remainingAccounts: AccountMeta[];
 }): Promise<TransactionInstruction>;

package/lib/node/core/instructions/trigger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trigger.d.ts","sourceRoot":"","sources":["../../../../src/core/instructions/trigger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,WAAW,EACX,SAAS,EACT,sBAAsB,EACtB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,4BAA4B,CAAC,IAAI,EAAE;IACxD,OAAO,EAAE,eAAe,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,SAAS,CAAC;IAClB,IAAI,EAAE,SAAS,CAAC;IAChB,SAAS,EAAE,SAAS,CAAC;IACrB,iBAAiB,EAAE,WAAW,EAAE,CAAC;CACjC,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAUlC"}
+{"version":3,"file":"trigger.d.ts","sourceRoot":"","sources":["../../../../src/core/instructions/trigger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,WAAW,EACX,SAAS,EACT,sBAAsB,EACtB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,4BAA4B,CAAC,IAAI,EAAE;IACxD,OAAO,EAAE,eAAe,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,SAAS,CAAC;IAClB,IAAI,EAAE,SAAS,CAAC;IAChB,SAAS,EAAE,SAAS,CAAC;IACrB,SAAS,EAAE,SAAS,CAAC;IACrB,iBAAiB,EAAE,WAAW,EAAE,CAAC;CACjC,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAWlC"}

package/lib/node/core/instructions/trigger.js

@@ -12,6 +12,9 @@ exports.buildTriggerOrderInstruction = void 0;
  * @param args.state - the global `State` PDA.
  * @param args.filler - the keeper's `User` account submitting the trigger.
  * @param args.user - the order owner's `User` account.
+ * @param args.userStats - the order owner's `UserStats` account (checked for the
+ *   authority-wide equity breaker; a risk-increasing trigger order is cancelled
+ *   rather than activated while the breaker is tripped).
  * @param args.authority - signer that must own or be a registered delegate of `filler`.
  * @param args.remainingAccounts - oracle/market `AccountMeta[]` for the order's market.
  * @returns the unsigned `triggerOrder` `TransactionInstruction`.
@@ -22,6 +25,7 @@ async function buildTriggerOrderInstruction(args) {
             state: args.state,
             filler: args.filler,
             user: args.user,
+            userStats: args.userStats,
             authority: args.authority,
         },
         remainingAccounts: args.remainingAccounts,

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

@@ -8,7 +8,7 @@ export type Velocity = {
     "address": "vELoC1audYbSYVRXn1vPaV8Axoa9oU6BYmNGZZBDZ1P";
     "metadata": {
         "name": "velocity";
-        "version": "2.163.0";
+        "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": [
@@ -16163,6 +16274,31 @@ 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";
         }
     ];
     "types": [
@@ -21210,19 +21346,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 +23145,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 +23218,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";
                     }
                 ];
             };