@velocity-exchange/sdk 0.2.4 → 0.3.0

package/CHANGELOG.md

@@ -1,25 +1,81 @@
 # @velocity-exchange/sdk
 
+## 0.3.0
+
+### Minor Changes
+
+- [#172](https://github.com/velocity-exchange/velocity-v1/pull/172) [`b7d15b9`](https://github.com/velocity-exchange/velocity-v1/commit/b7d15b970a74d267aeaf20bb644d5344b9aadc61) Thanks [@0xahzam](https://github.com/0xahzam)! - Decouple solvency-repair from the withdraw pause. The `resolve_perp_pnl_deficit`,
+  `resolve_perp_bankruptcy`, and `resolve_spot_bankruptcy` instructions are now gated by a
+  new `State.solvencyStatus` bitfield instead of `WithdrawPaused`, so user withdrawals can
+  be halted while solvency repair keeps running (or repair can be frozen on its own). Adds
+  the `SolvencyStatus` enum, `StateAccount.solvencyStatus`, a `solvencyRepairPaused()`
+  helper, `AdminClient.updateSolvencyStatus`, and the `exchange set-solvency-status` admin
+  CLI command.
+
+- [#141](https://github.com/velocity-exchange/velocity-v1/pull/141) [`3f148f8`](https://github.com/velocity-exchange/velocity-v1/commit/3f148f8b477e4176e11e0660adb0e67dd5163d3b) Thanks [@ChewingGlass](https://github.com/ChewingGlass)! - Harden the native fast-path admin handlers. The
+  `update_amm_spread_adjustment_native` instruction now requires the program
+  `State` account: `getUpdateAmmSpreadAdjustmentNativeIx` is now **async** and
+  returns a `Promise<TransactionInstruction>` (it derives and appends the state
+  account), and its compute-unit budget was raised to cover the on-chain account
+  validation. Direct callers must `await` the builder. Two new program error
+  codes are surfaced in the IDL: `InvalidNativeStateAccount` (6355) and
+  `InvalidNativePerpMarketAccount` (6356).
+
+### Patch Changes
+
+- [#173](https://github.com/velocity-exchange/velocity-v1/pull/173) [`2f6c64d`](https://github.com/velocity-exchange/velocity-v1/commit/2f6c64d54f1146d8e7f9ee4ab556929c6bf8b920) Thanks [@ChesterSim](https://github.com/ChesterSim)! - Fix stale `User` account byte offsets in `memcmp` filters and `OrderSubscriber`.
+
+  The Velocity `User` account is 4496 bytes, but the memcmp filters and the
+  `OrderSubscriber` staleness check still used offsets from the older 4376-byte
+  layout. As a result `getUserWithOrderFilter()` matched zero accounts, so any
+  consumer that bulk-loads users-with-orders (e.g. the DLOB server's
+  `OrderSubscriber.fetch()`) loaded no orders and produced an empty order book
+  (vAMM-only L2, empty L3). Offsets for `idle`, `hasOpenOrder`, `hasOpenAuction`,
+  `poolId`, and `lastActiveSlot` are corrected to match the on-chain layout.
+
+## 0.2.6
+
+### Patch Changes
+
+- [#156](https://github.com/velocity-exchange/velocity-v1/pull/156) [`d3b58ab`](https://github.com/velocity-exchange/velocity-v1/commit/d3b58ab7e3ad33f0e6634ff87e9b150915b3aa13) Thanks [@ChesterSim](https://github.com/ChesterSim)! - Fix account decoder to pass account names as-is instead of capitalizing them. The
+  Anchor v1 IDL program constructor already camelCases account names, so the extra
+  `capitalize()` call was incorrect and caused decoding failures in the gRPC and
+  WebSocket subscribers.
+
+## 0.2.5
+
+### Patch Changes
+
+- [#155](https://github.com/velocity-exchange/velocity-v1/pull/155) [`15073bc`](https://github.com/velocity-exchange/velocity-v1/commit/15073bc0b740b2d1cad471126a00368e72655bd5) Thanks [@ChesterSim](https://github.com/ChesterSim)! - Make the `UserAccountSubscriber` "not subscribed" contract consistent and fix a
+  misleading error message. `getUserAccountAndSlot()` now throws `NotSubscribedError`
+  when called before `subscribe()` on the gRPC-multi and WebSocket-program subscribers
+  too (the WebSocket and polling subscribers already did) — so `User.getUserAccount()`
+  uniformly throws when not subscribed and returns `undefined` only when subscribed but
+  the account was not found on chain. `getUserAccountOrThrow()` /
+  `getUserAccountAndSlotOrThrow()` now throw `User account not found: <pubkey>` (was
+  `User account not loaded`), since after `subscribe()` resolves a missing account means
+  "not found", not "still loading".
+
 ## 0.2.4
 
 ### Patch Changes
 
-- [#127](https://github.com/drift-labs/protocol-v2-shadow/pull/127) [`4f8e7aa`](https://github.com/drift-labs/protocol-v2-shadow/commit/4f8e7aaef0e35b190fc0b91cd29314d902d1ccab) Thanks [@ChesterSim](https://github.com/ChesterSim)! - reflect Typescript types on IDL changes
+- [#127](https://github.com/velocity-exchange/velocity-v1/pull/127) [`4f8e7aa`](https://github.com/velocity-exchange/velocity-v1/commit/4f8e7aaef0e35b190fc0b91cd29314d902d1ccab) Thanks [@ChesterSim](https://github.com/ChesterSim)! - reflect Typescript types on IDL changes
 
 ## 0.2.3
 
 ### Patch Changes
 
-- [#100](https://github.com/drift-labs/protocol-v2-shadow/pull/100) [`ae78769`](https://github.com/drift-labs/protocol-v2-shadow/commit/ae78769ef58355202c030435c2796ef045fe30a0) Thanks [@ChesterSim](https://github.com/ChesterSim)! - add back ForwardOnlyTxSender and calculateMaxRemainingDeposit
+- [#100](https://github.com/velocity-exchange/velocity-v1/pull/100) [`ae78769`](https://github.com/velocity-exchange/velocity-v1/commit/ae78769ef58355202c030435c2796ef045fe30a0) Thanks [@ChesterSim](https://github.com/ChesterSim)! - add back ForwardOnlyTxSender and calculateMaxRemainingDeposit
 
 ## 0.2.2
 
 ### Patch Changes
 
-- [#97](https://github.com/drift-labs/protocol-v2-shadow/pull/97) [`022a949`](https://github.com/drift-labs/protocol-v2-shadow/commit/022a949cb1802171ca57a61260f86c8908f94f34) Thanks [@ChewingGlass](https://github.com/ChewingGlass)! - Re-export `PriceUpdateAccount` from the package root and declare `@types/node` as a devDependency (fixes the SDK build under isolated installs). Enables downstream apps (dlob-server, keeper-bots-v2) to consume the velocity SDK without reaching into subpaths.
+- [#97](https://github.com/velocity-exchange/velocity-v1/pull/97) [`022a949`](https://github.com/velocity-exchange/velocity-v1/commit/022a949cb1802171ca57a61260f86c8908f94f34) Thanks [@ChewingGlass](https://github.com/ChewingGlass)! - Re-export `PriceUpdateAccount` from the package root and declare `@types/node` as a devDependency (fixes the SDK build under isolated installs). Enables downstream apps (dlob-server, keeper-bots-v2) to consume the velocity SDK without reaching into subpaths.
 
 ## 0.2.1
 
 ### Patch Changes
 
-- [`4fd7462`](https://github.com/drift-labs/protocol-v2-shadow/commit/4fd7462bfa3c55e31e3457b1b65f519cf052a6fa) Thanks [@ChewingGlass](https://github.com/ChewingGlass)! - Testing new changelog based package publishing flow
+- [`4fd7462`](https://github.com/velocity-exchange/velocity-v1/commit/4fd7462bfa3c55e31e3457b1b65f519cf052a6fa) Thanks [@ChewingGlass](https://github.com/ChewingGlass)! - Testing new changelog based package publishing flow

package/README.md

@@ -1,11 +1,11 @@
 <div align="center">
-  <img height="120" src="https://raw.githubusercontent.com/drift-labs/protocol-v2-shadow/master/assets/velocity-logo.svg" />
+  <img height="120" src="https://raw.githubusercontent.com/velocity-exchange/velocity-v1/master/assets/velocity-logo.svg" />
 
   <h1 style="margin-top:20px;">Velocity Exchange</h1>
 
   <p>
     <a href="https://www.npmjs.com/package/@velocity-exchange/sdk"><img alt="SDK npm package" src="https://img.shields.io/npm/v/@velocity-exchange/sdk" /></a>
-    <a href="https://drift-labs.github.io/protocol-v2/sdk/"><img alt="Docs" src="https://img.shields.io/badge/docs-tutorials-blueviolet" /></a>
+    <a href="https://velocity-exchange.github.io/protocol-v2/sdk/"><img alt="Docs" src="https://img.shields.io/badge/docs-tutorials-blueviolet" /></a>
     <a href="https://discord.com/channels/849494028176588802/878700556904980500"><img alt="Discord Chat" src="https://img.shields.io/discord/889577356681945098?color=blueviolet" /></a>
     <a href="https://opensource.org/licenses/Apache-2.0"><img alt="License" src="https://img.shields.io/github/license/project-serum/anchor?color=blueviolet" /></a>
   </p>
@@ -21,18 +21,18 @@ npm i @velocity-exchange/sdk
 
 _Start here if you're integrating with Velocity!_
 
-- [Velocity v2-teacher + API Docs](https://drift-labs.github.io/v2-teacher/)
+- [Velocity v2-teacher + API Docs](https://velocity-exchange.github.io/v2-teacher/)
   - Docs and examples for using the SDK in Typescript and Python
   - Useful concepts and examples when integrating Velocity
   - Docs for Velocity's "Data API"
-- [Typescript API docs](https://drift-labs.github.io/protocol-v2/sdk/)
-  - JSDoc automated documentation for the Velocity v2 Typescript SDK
+- [Typescript API docs](https://velocity-exchange.github.io/protocol-v2/sdk/)
+  - JSDoc automated documentation for the Velocity v1 Typescript SDK
 - [Velocity docs](https://docs.drift.trade/)
   - Comprehensive universal docs for Velocity
 
 ---
 
-The below is a light overview of using Solana and Velocity's typescript sdk. If you want comprehensive docs with examples of how to integrate with Velocity you should use the [v2-teacher docs](https://drift-labs.github.io/v2-teacher/).
+The below is a light overview of using Solana and Velocity's typescript sdk. If you want comprehensive docs with examples of how to integrate with Velocity you should use the [v2-teacher docs](https://velocity-exchange.github.io/v2-teacher/).
 
 ### Setting up a wallet for your program
 
@@ -210,7 +210,7 @@ const main = async () => {
 			provider.wallet.publicKey.toString()
 		);
 
-		//// Create a Velocity V2 account by Depositing some USDC ($10,000 in this case)
+		//// Create a Velocity V1 account by Depositing some USDC ($10,000 in this case)
 		const depositAmount = new BN(10000).mul(QUOTE_PRECISION);
 		await velocityClient.initializeUserAccountAndDepositCollateral(
 			depositAmount,
@@ -267,7 +267,7 @@ main();
 
 ## License
 
-Velocity Protocol v2 is licensed under [Apache 2.0](./LICENSE).
+Velocity Protocol v1 is licensed under [Apache 2.0](./LICENSE).
 
 Unless you explicitly state otherwise, any contribution intentionally submitted
 for inclusion in Velocity SDK by you, as defined in the Apache-2.0 license, shall be

package/lib/browser/accounts/grpcMultiAccountSubscriber.d.ts

@@ -34,5 +34,4 @@ export declare class grpcMultiAccountSubscriber<T, U = undefined> {
     removeAccounts(accounts: PublicKey[]): Promise<void>;
     unsubscribe(): Promise<void>;
     private setTimeout;
-    private capitalize;
 }

package/lib/browser/accounts/grpcMultiAccountSubscriber.js

@@ -125,7 +125,7 @@ class grpcMultiAccountSubscriber {
                             buffer: newBuffer,
                             slot: currentSlot,
                         });
-                        const accountDecoded = this.program.coder.accounts.decode(this.capitalize(this.accountName), newBuffer);
+                        const accountDecoded = this.program.coder.accounts.decode(this.accountName, newBuffer);
                         this.setAccountData(accountId, accountDecoded, currentSlot);
                     }
                 }
@@ -220,7 +220,7 @@ class grpcMultiAccountSubscriber {
             const handleDataBuffer = (context, buffer, accountProps) => {
                 const data = this.decodeBufferFn
                     ? this.decodeBufferFn(buffer, accountPubkey, accountProps)
-                    : this.program.coder.accounts.decode(this.capitalize(this.accountName), buffer);
+                    : this.program.coder.accounts.decode(this.accountName, buffer);
                 const handler = this.onChangeMap.get(accountPubkey);
                 if (handler) {
                     handler(data, context, buffer, accountProps);
@@ -377,10 +377,5 @@ class grpcMultiAccountSubscriber {
             }
         }, (_a = this.resubOpts) === null || _a === void 0 ? void 0 : _a.resubTimeoutMs);
     }
-    capitalize(value) {
-        if (!value)
-            return value;
-        return value.charAt(0).toUpperCase() + value.slice(1);
-    }
 }
 exports.grpcMultiAccountSubscriber = grpcMultiAccountSubscriber;

package/lib/browser/accounts/grpcMultiUserAccountSubscriber.js

@@ -146,6 +146,9 @@ class grpcMultiUserAccountSubscriber {
                 isSubscribed = false;
             },
             getUserAccountAndSlot() {
+                if (!isSubscribed) {
+                    throw new types_1.NotSubscribedError('You must call `subscribe` before using this function');
+                }
                 return parent.userData.get(key);
             },
         };

package/lib/browser/accounts/webSocketAccountSubscriberV2.js

@@ -4,7 +4,6 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WebSocketAccountSubscriberV2 = void 0;
-const utils_1 = require("./utils");
 const gill_1 = require("gill");
 const bs58_1 = __importDefault(require("bs58"));
 /**
@@ -376,7 +375,7 @@ class WebSocketAccountSubscriberV2 {
             return this.decodeBufferFn(buffer);
         }
         else {
-            return this.program.coder.accounts.decode((0, utils_1.capitalize)(this.accountName), buffer);
+            return this.program.coder.accounts.decode(this.accountName, buffer);
         }
     }
     unsubscribe(onResub = false) {

package/lib/browser/accounts/websocketProgramUserAccountSubscriber.js

@@ -45,6 +45,9 @@ class WebSocketProgramUserAccountSubscriber {
         this.isSubscribed = false;
     }
     getUserAccountAndSlot() {
+        if (!this.isSubscribed) {
+            throw new types_1.NotSubscribedError('You must call `subscribe` before using this function');
+        }
         return this.userAccountAndSlot;
     }
 }

package/lib/browser/adminClient.d.ts

@@ -7,7 +7,7 @@
  * pause/unpause exchange, and all ~126 admin instruction handlers in `instructions/admin.rs`.
  */
 import { AddressLookupTableAccount, Keypair, PublicKey, TransactionInstruction, TransactionSignature } from '@solana/web3.js';
-import { FeeStructure, OracleGuardRails, OracleSource, ExchangeStatus, MarketStatus, ContractTier, AssetTier, TxParams, AddAmmConstituentMappingDatum, SwapReduceOnly, InitializeConstituentParams, ConstituentStatus, LPPoolAccount, TransferFeeAndPnlPoolDirection, MarketType } from './types';
+import { FeeStructure, OracleGuardRails, OracleSource, ExchangeStatus, SolvencyStatus, MarketStatus, ContractTier, AssetTier, TxParams, AddAmmConstituentMappingDatum, SwapReduceOnly, InitializeConstituentParams, ConstituentStatus, LPPoolAccount, TransferFeeAndPnlPoolDirection, MarketType } from './types';
 import { BN } from './isomorphic/anchor';
 import { VelocityClient } from './velocityClient';
 import { JupiterClient, QuoteResponse } from './jupiter/jupiterClient';
@@ -182,6 +182,8 @@ export declare class AdminClient extends VelocityClient {
     getUpdatePerpMarketContractTierIx(perpMarketIndex: number, contractTier: ContractTier): Promise<TransactionInstruction>;
     updateExchangeStatus(exchangeStatus: ExchangeStatus): Promise<TransactionSignature>;
     getUpdateExchangeStatusIx(exchangeStatus: ExchangeStatus): Promise<TransactionInstruction>;
+    updateSolvencyStatus(solvencyStatus: SolvencyStatus): Promise<TransactionSignature>;
+    getUpdateSolvencyStatusIx(solvencyStatus: SolvencyStatus): Promise<TransactionInstruction>;
     updatePerpAuctionDuration(minDuration: BN | number): Promise<TransactionSignature>;
     getUpdatePerpAuctionDurationIx(minDuration: BN | number): Promise<TransactionInstruction>;
     updateSpotAuctionDuration(defaultAuctionDuration: number): Promise<TransactionSignature>;

package/lib/browser/adminClient.js

@@ -1501,6 +1501,22 @@ class AdminClient extends velocityClient_1.VelocityClient {
             },
         });
     }
+    async updateSolvencyStatus(solvencyStatus) {
+        const updateSolvencyStatusIx = await this.getUpdateSolvencyStatusIx(solvencyStatus);
+        const tx = await this.buildTransaction(updateSolvencyStatusIx);
+        const { txSig } = await this.sendTransaction(tx, [], this.opts);
+        return txSig;
+    }
+    async getUpdateSolvencyStatusIx(solvencyStatus) {
+        return await this.program.instruction.updateSolvencyStatus(solvencyStatus, {
+            accounts: {
+                admin: this.isSubscribed
+                    ? this.getStateAccount().coldAdmin
+                    : this.wallet.publicKey,
+                state: await this.getStatePublicKey(),
+            },
+        });
+    }
     async updatePerpAuctionDuration(minDuration) {
         const updatePerpAuctionDurationIx = await this.getUpdatePerpAuctionDurationIx(minDuration);
         const tx = await this.buildTransaction(updatePerpAuctionDurationIx);

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

@@ -11074,6 +11074,35 @@ export type Velocity = {
                 }
             ];
         },
+        {
+            "name": "updateSolvencyStatus";
+            "discriminator": [
+                81,
+                136,
+                15,
+                6,
+                24,
+                165,
+                44,
+                133
+            ];
+            "accounts": [
+                {
+                    "name": "admin";
+                    "signer": true;
+                },
+                {
+                    "name": "state";
+                    "writable": true;
+                }
+            ];
+            "args": [
+                {
+                    "name": "solvencyStatus";
+                    "type": "u8";
+                }
+            ];
+        },
         {
             "name": "updateSpecialUserStatus";
             "discriminator": [
@@ -15978,6 +16007,16 @@ export type Velocity = {
             "code": 6354;
             "name": "insufficientProtocolFees";
             "msg": "Insufficient protocol fees available to withdraw";
+        },
+        {
+            "code": 6355;
+            "name": "invalidNativeStateAccount";
+            "msg": "Native dispatch: supplied state account is not the canonical Velocity state PDA";
+        },
+        {
+            "code": 6356;
+            "name": "invalidNativePerpMarketAccount";
+            "msg": "Native dispatch: supplied market account is not a Velocity perp market";
         }
     ];
     "types": [
@@ -23213,6 +23252,16 @@ export type Velocity = {
                         "name": "lpPoolFeatureBitFlags";
                         "type": "u8";
                     },
+                    {
+                        "name": "solvencyStatus";
+                        "docs": [
+                            "Bitmask of `SolvencyStatus` flags. Gates internal solvency-repair flows",
+                            "(bankruptcy / pnl-deficit resolution) independently of `WithdrawPaused`,",
+                            "so user withdrawals can be halted while repair keeps running, or repair",
+                            "can be frozen on its own when an oracle is suspect. `0` = repair allowed."
+                        ];
+                        "type": "u8";
+                    },
                     {
                         "name": "protocolFeeRecipientPerp";
                         "docs": [
@@ -23247,7 +23296,7 @@ export type Velocity = {
                         "type": {
                             "array": [
                                 "u8",
-                                272
+                                271
                             ];
                         };
                     }

package/lib/browser/idl/velocity.json

@@ -11068,6 +11068,35 @@
                 }
             ]
         },
+        {
+            "name": "update_solvency_status",
+            "discriminator": [
+                81,
+                136,
+                15,
+                6,
+                24,
+                165,
+                44,
+                133
+            ],
+            "accounts": [
+                {
+                    "name": "admin",
+                    "signer": true
+                },
+                {
+                    "name": "state",
+                    "writable": true
+                }
+            ],
+            "args": [
+                {
+                    "name": "solvency_status",
+                    "type": "u8"
+                }
+            ]
+        },
         {
             "name": "update_special_user_status",
             "discriminator": [
@@ -15972,6 +16001,16 @@
             "code": 6354,
             "name": "InsufficientProtocolFees",
             "msg": "Insufficient protocol fees available to withdraw"
+        },
+        {
+            "code": 6355,
+            "name": "InvalidNativeStateAccount",
+            "msg": "Native dispatch: supplied state account is not the canonical Velocity state PDA"
+        },
+        {
+            "code": 6356,
+            "name": "InvalidNativePerpMarketAccount",
+            "msg": "Native dispatch: supplied market account is not a Velocity perp market"
         }
     ],
     "types": [
@@ -23207,6 +23246,16 @@
                         "name": "lp_pool_feature_bit_flags",
                         "type": "u8"
                     },
+                    {
+                        "name": "solvency_status",
+                        "docs": [
+                            "Bitmask of `SolvencyStatus` flags. Gates internal solvency-repair flows",
+                            "(bankruptcy / pnl-deficit resolution) independently of `WithdrawPaused`,",
+                            "so user withdrawals can be halted while repair keeps running, or repair",
+                            "can be frozen on its own when an oracle is suspect. `0` = repair allowed."
+                        ],
+                        "type": "u8"
+                    },
                     {
                         "name": "protocol_fee_recipient_perp",
                         "docs": [
@@ -23241,7 +23290,7 @@
                         "type": {
                             "array": [
                                 "u8",
-                                272
+                                271
                             ]
                         }
                     }

package/lib/browser/math/exchangeStatus.d.ts

@@ -1,5 +1,6 @@
 import { PerpMarketAccount, PerpOperation, SpotMarketAccount, SpotOperation, StateAccount, InsuranceFundOperation, MarketConfigFlag } from '../types';
 export declare function exchangePaused(state: StateAccount): boolean;
+export declare function solvencyRepairPaused(state: StateAccount): boolean;
 export declare function fillPaused(state: StateAccount, market: PerpMarketAccount | SpotMarketAccount): boolean;
 export declare function ammPaused(state: StateAccount, market: PerpMarketAccount | SpotMarketAccount): boolean;
 export declare function isOperationPaused(pausedOperations: number, operation: PerpOperation | SpotOperation | InsuranceFundOperation): boolean;

package/lib/browser/math/exchangeStatus.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isFormulaicKUpdateDisabled = exports.isMarketConfigFlagSet = exports.isAmmDrawdownPause = exports.isOperationPaused = exports.ammPaused = exports.fillPaused = exports.exchangePaused = void 0;
+exports.isFormulaicKUpdateDisabled = exports.isMarketConfigFlagSet = exports.isAmmDrawdownPause = exports.isOperationPaused = exports.ammPaused = exports.fillPaused = exports.solvencyRepairPaused = exports.exchangePaused = void 0;
 const numericConstants_1 = require("../constants/numericConstants");
 const types_1 = require("../types");
 const anchor_1 = require("../isomorphic/anchor");
@@ -8,6 +8,13 @@ function exchangePaused(state) {
     return state.exchangeStatus !== types_1.ExchangeStatus.ACTIVE;
 }
 exports.exchangePaused = exchangePaused;
+// Mirror of the program's `State::solvency_repair_paused`. Gates the resolve
+// bankruptcy / pnl-deficit instructions, independent of WITHDRAW_PAUSED.
+function solvencyRepairPaused(state) {
+    return ((state.solvencyStatus & types_1.SolvencyStatus.SOLVENCY_REPAIR_PAUSED) ===
+        types_1.SolvencyStatus.SOLVENCY_REPAIR_PAUSED);
+}
+exports.solvencyRepairPaused = solvencyRepairPaused;
 function fillPaused(state, market) {
     if ((state.exchangeStatus & types_1.ExchangeStatus.FILL_PAUSED) ===
         types_1.ExchangeStatus.FILL_PAUSED) {

package/lib/browser/math/orders.d.ts

@@ -26,5 +26,8 @@ export declare function calculateOrderBaseAssetAmount(order: Order, existingBase
  * Returns:
  * - BN size (>=0) if bounded
  * - null if impossible (target < liabilityWeight) OR imfFactor == 0 (unbounded)
+ *
+ * Note: a market.maxOpenInterest of 0 means "no configured cap" and is treated
+ * as unlimited rather than a hard cap of 0.
  */
 export declare function maxSizeForTargetLiabilityWeightBN(target: BN, imfFactor: BN, liabilityWeight: BN, market: PerpMarketAccount): BN | null;

package/lib/browser/math/orders.js

@@ -181,6 +181,9 @@ exports.calculateOrderBaseAssetAmount = calculateOrderBaseAssetAmount;
  * Returns:
  * - BN size (>=0) if bounded
  * - null if impossible (target < liabilityWeight) OR imfFactor == 0 (unbounded)
+ *
+ * Note: a market.maxOpenInterest of 0 means "no configured cap" and is treated
+ * as unlimited rather than a hard cap of 0.
  */
 function maxSizeForTargetLiabilityWeightBN(target, imfFactor, liabilityWeight, market) {
     if (target.lt(liabilityWeight))
@@ -212,9 +215,10 @@ function maxSizeForTargetLiabilityWeightBN(target, imfFactor, liabilityWeight, m
             hi = mid.sub(numericConstants_1.ONE);
         }
     }
-    // cap at max OI
+    // cap at max OI. A maxOpenInterest of 0 means no configured cap (unlimited),
+    // matching the on-chain convention — do not treat it as a hard cap of 0.
     const maxOpenInterest = market.maxOpenInterest;
-    if (lo.gt(maxOpenInterest)) {
+    if (!maxOpenInterest.isZero() && lo.gt(maxOpenInterest)) {
         return maxOpenInterest;
     }
     return lo;

package/lib/browser/math/state.js

@@ -12,7 +12,7 @@ function calculateInitUserFee(stateAccount) {
     const accountSpaceUtilization = stateAccount.numberOfSubAccounts
         .addn(1)
         .mul(numericConstants_1.PERCENTAGE_PRECISION)
-        .div(getMaxNumberOfSubAccounts(stateAccount));
+        .div(anchor_1.BN.max(getMaxNumberOfSubAccounts(stateAccount), new anchor_1.BN(1)));
     if (accountSpaceUtilization.gt(targetUtilization)) {
         return maxInitFee
             .mul(accountSpaceUtilization.sub(targetUtilization))

package/lib/browser/memcmp.js

@@ -16,10 +16,31 @@ function getUserFilter() {
     };
 }
 exports.getUserFilter = getUserFilter;
+/*
+ * Byte offsets of the trailing scalar flags in the `User` account.
+ *
+ * These MUST match the on-chain `User` layout decoded in `decode/user.ts`. The
+ * current Velocity layout is 4496 bytes, with the tail block laid out as
+ * consecutive single bytes:
+ *   status(4468) isMarginTradingEnabled(4469) idle(4470) openOrders(4471)
+ *   hasOpenOrder(4472) openAuctions(4473) hasOpenAuction(4474) poolId(4475)
+ *   specialUserStatus(4476)
+ *
+ * NOTE: these were previously hardcoded to the older (4376-byte) layout
+ * (idle@4350, hasOpenOrder@4352, ...). After Velocity added fields to
+ * `PerpPosition`, the account grew by 120 bytes and these flags shifted, but
+ * the filters were not updated — so `getUserWithOrderFilter()` matched zero
+ * accounts and the DLOB order book never populated. Keep these in sync with
+ * `decode/user.ts` if the `User` layout changes again.
+ */
+const USER_IDLE_OFFSET = 4470;
+const USER_HAS_OPEN_ORDER_OFFSET = 4472;
+const USER_HAS_OPEN_AUCTION_OFFSET = 4474;
+const USER_POOL_ID_OFFSET = 4475;
 function getNonIdleUserFilter() {
     return {
         memcmp: {
-            offset: 4350,
+            offset: USER_IDLE_OFFSET,
             bytes: bs58_1.default.encode(Uint8Array.from([0])),
         },
     };
@@ -28,7 +49,7 @@ exports.getNonIdleUserFilter = getNonIdleUserFilter;
 function getUserWithOrderFilter() {
     return {
         memcmp: {
-            offset: 4352,
+            offset: USER_HAS_OPEN_ORDER_OFFSET,
             bytes: bs58_1.default.encode(Uint8Array.from([1])),
         },
     };
@@ -37,7 +58,7 @@ exports.getUserWithOrderFilter = getUserWithOrderFilter;
 function getUserWithoutOrderFilter() {
     return {
         memcmp: {
-            offset: 4352,
+            offset: USER_HAS_OPEN_ORDER_OFFSET,
             bytes: bs58_1.default.encode(Uint8Array.from([0])),
         },
     };
@@ -46,7 +67,7 @@ exports.getUserWithoutOrderFilter = getUserWithoutOrderFilter;
 function getUserWithAuctionFilter() {
     return {
         memcmp: {
-            offset: 4354,
+            offset: USER_HAS_OPEN_AUCTION_OFFSET,
             bytes: bs58_1.default.encode(Uint8Array.from([1])),
         },
     };
@@ -64,7 +85,7 @@ exports.getUserWithName = getUserWithName;
 function getUsersWithPoolId(poolId) {
     return {
         memcmp: {
-            offset: 4356,
+            offset: USER_POOL_ID_OFFSET,
             bytes: bs58_1.default.encode(Uint8Array.from([poolId])),
         },
     };

package/lib/browser/orderSubscriber/OrderSubscriber.js

@@ -13,6 +13,15 @@ const user_1 = require("../decode/user");
 const grpcSubscription_1 = require("./grpcSubscription");
 const orders_1 = require("../math/orders");
 const numericConstants_1 = require("../constants/numericConstants");
+/*
+ * Byte offset of `lastActiveSlot` (u64) in the `User` account, used here to
+ * cheaply detect stale updates without fully decoding the buffer. Must match
+ * the on-chain `User` layout (see `decode/user.ts`). The previous value (4328)
+ * was for the older 4376-byte layout; the current Velocity layout is 4496
+ * bytes, shifting this field +120 bytes. With the wrong offset this read 8
+ * zero-padding bytes, so the staleness guard rejected every post-load update.
+ */
+const USER_LAST_ACTIVE_SLOT_OFFSET = 4448;
 class OrderSubscriber {
     constructor(config) {
         var _a, _b, _c, _d, _e;
@@ -121,7 +130,7 @@ class OrderSubscriber {
             if (dataType === 'raw') {
                 // @ts-ignore
                 const buffer = buffer_1.Buffer.from(data[0], data[1]);
-                const newLastActiveSlot = new anchor_1.BN(buffer.subarray(4328, 4328 + 8), undefined, 'le');
+                const newLastActiveSlot = new anchor_1.BN(buffer.subarray(USER_LAST_ACTIVE_SLOT_OFFSET, USER_LAST_ACTIVE_SLOT_OFFSET + 8), undefined, 'le');
                 if (slotAndUserAccount &&
                     slotAndUserAccount.userAccount.lastActiveSlot.gt(newLastActiveSlot)) {
                     return;
@@ -130,7 +139,7 @@ class OrderSubscriber {
             }
             else if (dataType === 'buffer') {
                 const buffer = data;
-                const newLastActiveSlot = new anchor_1.BN(buffer.subarray(4328, 4328 + 8), undefined, 'le');
+                const newLastActiveSlot = new anchor_1.BN(buffer.subarray(USER_LAST_ACTIVE_SLOT_OFFSET, USER_LAST_ACTIVE_SLOT_OFFSET + 8), undefined, 'le');
                 if (slotAndUserAccount &&
                     slotAndUserAccount.userAccount.lastActiveSlot.gt(newLastActiveSlot)) {
                     return;

package/lib/browser/swift/swiftOrderSubscriber.js

@@ -71,8 +71,8 @@ class SwiftOrderSubscriber {
         this.onOrder = onOrder;
         const env = this.config.velocityEnv;
         const endpoint = (_a = this.config.endpoint) !== null && _a !== void 0 ? _a : (env === 'devnet'
-            ? 'wss://master.swift.drift.trade/ws'
-            : 'wss://swift.drift.trade/ws');
+            ? 'wss://swift.master.velocity.exchange/ws'
+            : 'wss://swift.velocity.exchange/ws');
         const ws = new ws_1.default(endpoint + '?pubkey=' + this.config.keypair.publicKey.toBase58());
         this.ws = ws;
         ws.on('open', async () => {

package/lib/browser/tokenFaucet.d.ts

@@ -1,5 +1,5 @@
-import * as anchor from './isomorphic/anchor29';
-import { AnchorProvider, Program } from './isomorphic/anchor29';
+import * as anchor from './isomorphic/anchor';
+import { AnchorProvider, Program } from './isomorphic/anchor';
 import { Account } from '@solana/spl-token';
 import { ConfirmOptions, Connection, PublicKey, TransactionInstruction, TransactionSignature } from '@solana/web3.js';
 import { IWallet } from './types';