@velocity-exchange/sdk 0.2.5 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,47 @@
 # @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

package/README.md

@@ -26,7 +26,7 @@ _Start here if you're integrating with Velocity!_
   - Useful concepts and examples when integrating Velocity
   - Docs for Velocity's "Data API"
 - [Typescript API docs](https://velocity-exchange.github.io/protocol-v2/sdk/)
-  - JSDoc automated documentation for the Velocity v2 Typescript SDK
+  - JSDoc automated documentation for the Velocity v1 Typescript SDK
 - [Velocity docs](https://docs.drift.trade/)
   - Comprehensive universal docs for Velocity
 
@@ -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/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';

package/lib/browser/tokenFaucet.js

@@ -27,8 +27,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TokenFaucet = void 0;
-const anchor = __importStar(require("./isomorphic/anchor29"));
-const anchor29_1 = require("./isomorphic/anchor29");
+const anchor = __importStar(require("./isomorphic/anchor"));
+const anchor_1 = require("./isomorphic/anchor");
 const spl_token_1 = require("@solana/spl-token");
 const web3_js_1 = require("@solana/web3.js");
 const token_faucet_json_1 = __importDefault(require("./idl/token_faucet.json"));
@@ -40,11 +40,18 @@ class TokenFaucet {
         this.wallet = wallet;
         this.opts = opts || config_1.DEFAULT_CONFIRMATION_OPTS;
         // @ts-ignore
-        const provider = new anchor29_1.AnchorProvider(context ? context.connection.toConnection() : this.connection, 
+        const provider = new anchor_1.AnchorProvider(context ? context.connection.toConnection() : this.connection, 
         // @ts-ignore
         wallet, this.opts);
         this.provider = provider;
-        this.program = new anchor29_1.Program(token_faucet_json_1.default, programId, provider);
+        // Anchor (>= 0.30) reads the program id from `idl.address` rather than a
+        // constructor argument. Override it with the caller-provided `programId`
+        // so PDAs and instructions target the intended program.
+        const idl = {
+            ...token_faucet_json_1.default,
+            address: programId.toBase58(),
+        };
+        this.program = new anchor_1.Program(idl, provider);
         this.mint = mint;
     }
     async getFaucetConfigPublicKeyAndNonce() {

package/lib/browser/types.d.ts

@@ -28,6 +28,10 @@ export declare enum ExchangeStatus {
     AMM_IMMEDIATE_FILL_PAUSED = 128,
     PAUSED = 255
 }
+export declare enum SolvencyStatus {
+    ACTIVE = 0,
+    SOLVENCY_REPAIR_PAUSED = 1
+}
 export declare enum FeatureBitFlags {
     MM_ORACLE_UPDATE = 1,
     MEDIAN_TRIGGER_PRICE = 2,
@@ -839,6 +843,7 @@ export type StateAccount = {
     maxInitializeUserFee: number;
     featureBitFlags: number;
     lpPoolFeatureBitFlags: number;
+    solvencyStatus: number;
 };
 export type PerpMarketAccount = {
     status: MarketStatus;

package/lib/browser/types.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ConstituentLpOperation = exports.ConstituentStatus = exports.OracleValidity = exports.SwapReduceOnly = exports.PlaceAndTakeOrderSuccessCondition = exports.ReferrerStatus = exports.DefaultOrderParams = exports.ModifyOrderPolicy = exports.PositionFlag = exports.OrderParamsBitFlag = exports.SizeDistribution = exports.PostOnlyParams = exports.LiquidationBitFlag = exports.LiquidationType = exports.TradeSide = exports.getVariant = exports.isOneOfVariant = exports.isVariant = exports.SettlePnlMode = exports.StakeAction = exports.SettlePnlExplanation = exports.DepositExplanation = exports.OrderTriggerCondition = exports.OrderActionExplanation = exports.OrderAction = exports.OrderBitFlag = exports.OrderStatus = exports.MarketType = exports.OrderType = exports.OracleSourceNum = exports.OracleSource = exports.DepositDirection = exports.PositionDirection = exports.SpotBalanceType = exports.SwapDirection = exports.TokenProgramFlag = exports.AssetTier = exports.ContractTier = exports.ContractType = exports.MarginMode = exports.MarketConfigFlag = exports.UserStatsPausedOperation = exports.SpecialUserStatus = exports.UserStatus = exports.InsuranceFundOperation = exports.SpotOperation = exports.PerpOperation = exports.MarketStatus = exports.FeatureBitFlags = exports.ExchangeStatus = void 0;
-exports.TransferFeeAndPnlPoolDirection = void 0;
+exports.ConstituentStatus = exports.OracleValidity = exports.SwapReduceOnly = exports.PlaceAndTakeOrderSuccessCondition = exports.ReferrerStatus = exports.DefaultOrderParams = exports.ModifyOrderPolicy = exports.PositionFlag = exports.OrderParamsBitFlag = exports.SizeDistribution = exports.PostOnlyParams = exports.LiquidationBitFlag = exports.LiquidationType = exports.TradeSide = exports.getVariant = exports.isOneOfVariant = exports.isVariant = exports.SettlePnlMode = exports.StakeAction = exports.SettlePnlExplanation = exports.DepositExplanation = exports.OrderTriggerCondition = exports.OrderActionExplanation = exports.OrderAction = exports.OrderBitFlag = exports.OrderStatus = exports.MarketType = exports.OrderType = exports.OracleSourceNum = exports.OracleSource = exports.DepositDirection = exports.PositionDirection = exports.SpotBalanceType = exports.SwapDirection = exports.TokenProgramFlag = exports.AssetTier = exports.ContractTier = exports.ContractType = exports.MarginMode = exports.MarketConfigFlag = exports.UserStatsPausedOperation = exports.SpecialUserStatus = exports.UserStatus = exports.InsuranceFundOperation = exports.SpotOperation = exports.PerpOperation = exports.MarketStatus = exports.FeatureBitFlags = exports.SolvencyStatus = exports.ExchangeStatus = void 0;
+exports.TransferFeeAndPnlPoolDirection = exports.ConstituentLpOperation = void 0;
 const numericConstants_1 = require("./constants/numericConstants");
 // # Utility Types / Enums / Constants
 var ExchangeStatus;
@@ -17,6 +17,13 @@ var ExchangeStatus;
     ExchangeStatus[ExchangeStatus["AMM_IMMEDIATE_FILL_PAUSED"] = 128] = "AMM_IMMEDIATE_FILL_PAUSED";
     ExchangeStatus[ExchangeStatus["PAUSED"] = 255] = "PAUSED";
 })(ExchangeStatus || (exports.ExchangeStatus = ExchangeStatus = {}));
+// Mirror of the Rust `SolvencyStatus` bitflag (State.solvencyStatus). Gates
+// internal solvency-repair flows independently of ExchangeStatus.WITHDRAW_PAUSED.
+var SolvencyStatus;
+(function (SolvencyStatus) {
+    SolvencyStatus[SolvencyStatus["ACTIVE"] = 0] = "ACTIVE";
+    SolvencyStatus[SolvencyStatus["SOLVENCY_REPAIR_PAUSED"] = 1] = "SOLVENCY_REPAIR_PAUSED";
+})(SolvencyStatus || (exports.SolvencyStatus = SolvencyStatus = {}));
 var FeatureBitFlags;
 (function (FeatureBitFlags) {
     FeatureBitFlags[FeatureBitFlags["MM_ORACLE_UPDATE"] = 1] = "MM_ORACLE_UPDATE";

package/lib/browser/velocityClient.d.ts

@@ -1185,7 +1185,7 @@ export declare class VelocityClient {
     updateMmOracleNative(marketIndex: number, oraclePrice: BN, oracleSequenceId: BN): Promise<TransactionSignature>;
     getUpdateMmOracleNativeIx(marketIndex: number, oraclePrice: BN, oracleSequenceId: BN): Promise<TransactionInstruction>;
     updateAmmSpreadAdjustmentNative(marketIndex: number, ammSpreadAdjustment: number): Promise<TransactionSignature>;
-    getUpdateAmmSpreadAdjustmentNativeIx(marketIndex: number, ammSpreadAdjustment: number): TransactionInstruction;
+    getUpdateAmmSpreadAdjustmentNativeIx(marketIndex: number, ammSpreadAdjustment: number): Promise<TransactionInstruction>;
     getLpPoolAccount(lpPoolId: number): Promise<LPPoolAccount>;
     getConstituentTargetBaseAccount(lpPoolId: number): Promise<ConstituentTargetBaseAccount>;
     getAmmCache(): Promise<AmmCache>;

package/lib/browser/velocityClient.js

@@ -1300,7 +1300,7 @@ class VelocityClient {
         subAccountId = subAccountId !== null && subAccountId !== void 0 ? subAccountId : this.activeSubAccountId;
         authority = authority !== null && authority !== void 0 ? authority : this.authority;
         if (subAccountId === undefined || authority === undefined) {
-            throw new Error('Subaccount ID and authority are required');
+            return false;
         }
         const userMapKey = this.getUserMapKey(subAccountId, authority);
         return this.users.has(userMapKey);
@@ -5365,19 +5365,26 @@ class VelocityClient {
     async updateAmmSpreadAdjustmentNative(marketIndex, ammSpreadAdjustment) {
         const updateMmOracleIx = await this.getUpdateAmmSpreadAdjustmentNativeIx(marketIndex, ammSpreadAdjustment);
         const tx = await this.buildTransaction(updateMmOracleIx, {
-            computeUnits: 1000,
+            // Headroom for the native handler's owner + discriminator validation
+            // of the state + perp-market accounts (was 1000 when it bytemuck-cast
+            // the market without any checks). Measured ~1.3k CU; 2000 leaves
+            // margin for the production-only signer check.
+            computeUnits: 2000,
             computeUnitsPrice: 0,
         });
         const { txSig } = await this.sendTransaction(tx, [], this.opts);
         return txSig;
     }
-    getUpdateAmmSpreadAdjustmentNativeIx(marketIndex, ammSpreadAdjustment // i8
+    async getUpdateAmmSpreadAdjustmentNativeIx(marketIndex, ammSpreadAdjustment // i8
     ) {
         const discriminatorBuffer = (0, utils_2.createNativeInstructionDiscriminatorBuffer)(1);
         const data = Buffer.alloc(discriminatorBuffer.length + 4);
         data.set(discriminatorBuffer, 0);
         data.writeInt8(ammSpreadAdjustment, 5); // next byte
-        // Build the instruction manually
+        // Build the instruction manually. The native handler re-establishes the
+        // account guarantees Anchor would normally provide: it loads `state` as
+        // the program-owned State account and authenticates the signer against
+        // `state.hotAmmSpreadAdjust`, so the state account is required at index 2.
         return new web3_js_1.TransactionInstruction({
             programId: this.program.programId,
             keys: [
@@ -5391,6 +5398,11 @@ class VelocityClient {
                     isWritable: false,
                     isSigner: true,
                 },
+                {
+                    pubkey: await this.getStatePublicKey(),
+                    isWritable: false,
+                    isSigner: false,
+                },
             ],
             data,
         });

package/lib/node/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>;