@velocity-exchange/sdk 0.0.5 → 0.2.0

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

@@ -13,7 +13,6 @@ export declare const NINE: BN;
 export declare const TEN: BN;
 export declare const TEN_THOUSAND: BN;
 export declare const BN_MAX: BN;
-export declare const TEN_MILLION: BN;
 export declare const MAX_LEVERAGE: BN;
 export declare const MAX_LEVERAGE_ORDER_SIZE: BN;
 export declare const PERCENTAGE_PRECISION_EXP: BN;
@@ -53,13 +52,13 @@ export declare const MARGIN_PRECISION: BN;
 export declare const BID_ASK_SPREAD_PRECISION: BN;
 export declare const LIQUIDATION_PCT_PRECISION: BN;
 export declare const FUNDING_RATE_OFFSET_DENOMINATOR: BN;
+export declare const FUNDING_RATE_OFFSET_PERCENTAGE: BN;
 export declare const FUNDING_RATE_CLAMP_DENOMINATOR: BN;
 export declare const PRICE_TIMES_AMM_TO_QUOTE_PRECISION_RATIO: BN;
 export declare const FIVE_MINUTE: BN;
 export declare const ONE_HOUR: BN;
 export declare const ONE_YEAR: BN;
 export declare const QUOTE_SPOT_MARKET_INDEX = 0;
-export declare const GOV_SPOT_MARKET_INDEX = 15;
 export declare const LAMPORTS_PRECISION: BN;
 export declare const LAMPORTS_EXP: BN;
 export declare const OPEN_ORDER_MARGIN_REQUIREMENT: BN;
@@ -69,5 +68,4 @@ export declare const IDLE_TIME_SLOTS = 9000;
 export declare const SLOT_TIME_ESTIMATE_MS = 400;
 export declare const DUST_POSITION_SIZE: BN;
 export declare const GET_MULTIPLE_ACCOUNTS_CHUNK_SIZE = 99;
-export declare const MAX_I64: BN;
 export declare const MIN_I64: BN;

package/lib/browser/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.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.GOV_SPOT_MARKET_INDEX = 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_DENOMINATOR = exports.LIQUIDATION_PCT_PRECISION = exports.BID_ASK_SPREAD_PRECISION = void 0;
+exports.BID_ASK_SPREAD_PRECISION = 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.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.GET_MULTIPLE_ACCOUNTS_CHUNK_SIZE = 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 = void 0;
 const web3_js_1 = require("@solana/web3.js");
 const anchor_1 = require("../isomorphic/anchor");
 const bigNum_1 = require("../factory/bigNum");
@@ -18,7 +18,6 @@ exports.NINE = new anchor_1.BN(9);
 exports.TEN = new anchor_1.BN(10);
 exports.TEN_THOUSAND = new anchor_1.BN(10000);
 exports.BN_MAX = new anchor_1.BN(Number.MAX_SAFE_INTEGER);
-exports.TEN_MILLION = exports.TEN_THOUSAND.mul(exports.TEN_THOUSAND);
 exports.MAX_LEVERAGE = new anchor_1.BN(5);
 exports.MAX_LEVERAGE_ORDER_SIZE = new anchor_1.BN('18446744073709551615');
 exports.PERCENTAGE_PRECISION_EXP = new anchor_1.BN(6);
@@ -58,13 +57,13 @@ exports.MARGIN_PRECISION = exports.TEN_THOUSAND;
 exports.BID_ASK_SPREAD_PRECISION = new anchor_1.BN(1000000); // 10^6
 exports.LIQUIDATION_PCT_PRECISION = exports.TEN_THOUSAND;
 exports.FUNDING_RATE_OFFSET_DENOMINATOR = new anchor_1.BN(3333);
+exports.FUNDING_RATE_OFFSET_PERCENTAGE = exports.FUNDING_RATE_PRECISION.div(exports.FUNDING_RATE_OFFSET_DENOMINATOR);
 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);
 exports.FIVE_MINUTE = new anchor_1.BN(60 * 5);
 exports.ONE_HOUR = new anchor_1.BN(60 * 60);
 exports.ONE_YEAR = new anchor_1.BN(31536000);
 exports.QUOTE_SPOT_MARKET_INDEX = 0;
-exports.GOV_SPOT_MARKET_INDEX = 15;
 exports.LAMPORTS_PRECISION = new anchor_1.BN(web3_js_1.LAMPORTS_PER_SOL);
 exports.LAMPORTS_EXP = new anchor_1.BN(Math.log10(web3_js_1.LAMPORTS_PER_SOL));
 exports.OPEN_ORDER_MARGIN_REQUIREMENT = exports.QUOTE_PRECISION.div(new anchor_1.BN(100));
@@ -75,5 +74,4 @@ exports.SLOT_TIME_ESTIMATE_MS = 400;
 exports.DUST_POSITION_SIZE = exports.QUOTE_PRECISION.divn(100); // Dust position is any position smaller than 1c
 exports.GET_MULTIPLE_ACCOUNTS_CHUNK_SIZE = 99;
 // integer constants
-exports.MAX_I64 = bigNum_1.BigNum.fromPrint('9223372036854775807').val;
 exports.MIN_I64 = bigNum_1.BigNum.fromPrint('-9223372036854775808').val;

package/lib/browser/constituentMap/constituentMap.d.ts

@@ -4,8 +4,6 @@ import { ConstituentAccount } from '../types';
 import { VelocityClient } from '../velocityClient';
 export type ConstituentMapConfig = {
     velocityClient?: VelocityClient;
-    /** @deprecated Use `velocityClient` instead. `driftClient` will be removed in a future major. */
-    driftClient?: VelocityClient;
     connection?: Connection;
     subscriptionConfig: {
         type: 'polling';

package/lib/browser/constituentMap/constituentMap.js

@@ -9,20 +9,20 @@ const pda_1 = require("../addresses/pda");
 const MAX_CONSTITUENT_SIZE_BYTES = 480; // TODO: update this when account is finalized
 class ConstituentMap {
     constructor(config) {
-        var _a, _b, _c;
+        var _a, _b;
         this.constituentMap = new Map();
         this.constituentIndexToKeyMap = new Map();
         this.spotMarketIndexToKeyMap = new Map();
-        const velocityClient = (_a = config.velocityClient) !== null && _a !== void 0 ? _a : config.driftClient;
+        const velocityClient = config.velocityClient;
         if (!velocityClient) {
-            throw new Error('ConstituentMap: velocityClient (or deprecated driftClient) must be provided');
+            throw new Error('ConstituentMap: velocityClient must be provided');
         }
         this.velocityClient = velocityClient;
         this.additionalFilters = config.additionalFilters;
         this.commitment = config.subscriptionConfig.commitment;
         this.connection = config.connection || this.velocityClient.connection;
-        this.lpPoolId = (_b = config.lpPoolId) !== null && _b !== void 0 ? _b : 0;
-        this.decoder = (_c = config.decoder) !== null && _c !== void 0 ? _c : 'base64+zstd';
+        this.lpPoolId = (_a = config.lpPoolId) !== null && _a !== void 0 ? _a : 0;
+        this.decoder = (_b = config.decoder) !== null && _b !== void 0 ? _b : 'base64+zstd';
         if (config.subscriptionConfig.type === 'polling') {
             this.constituentAccountSubscriber =
                 new pollingConstituentAccountSubscriber_1.PollingConstituentAccountSubscriber(this, this.velocityClient.program, config.subscriptionConfig.frequency, config.subscriptionConfig.commitment, this.getFilters());
@@ -31,6 +31,9 @@ class ConstituentMap {
             this.constituentAccountSubscriber =
                 new webSocketConstituentAccountSubscriber_1.WebSocketConstituentAccountSubscriber(this, this.velocityClient.program, config.subscriptionConfig.resubTimeoutMs, config.subscriptionConfig.commitment, this.getFilters());
         }
+        else {
+            throw new Error(`ConstituentMap: unsupported subscriptionConfig type: ${config.subscriptionConfig.type}`);
+        }
         // Listen for account updates from the subscriber
         this.constituentAccountSubscriber.eventEmitter.on('onAccountUpdate', (account, pubkey, slot) => {
             this.updateConstituentAccount(pubkey.toString(), account, slot);
@@ -91,7 +94,8 @@ class ConstituentMap {
             await Promise.all(promises);
         }
         catch (error) {
-            console.log(`ConstituentMap.sync() error: ${error.message}`);
+            const message = error instanceof Error ? error.message : String(error);
+            console.log(`ConstituentMap.sync() error: ${message}`);
         }
     }
     async subscribe() {

package/lib/browser/constituentMap/pollingConstituentAccountSubscriber.js

@@ -34,8 +34,9 @@ class PollingConstituentAccountSubscriber {
             this.eventEmitter.emit('update');
         }
         catch (error) {
-            console.log(`PollingConstituentAccountSubscriber.sync() error: ${error.message}`);
-            this.eventEmitter.emit('error', error);
+            const normalizedError = error instanceof Error ? error : new Error(String(error));
+            console.log(`PollingConstituentAccountSubscriber.sync() error: ${normalizedError.message}`);
+            this.eventEmitter.emit('error', normalizedError);
         }
     }
     async unsubscribe() {

package/lib/browser/constituentMap/webSocketConstituentAccountSubscriber.d.ts

@@ -4,8 +4,6 @@ import { VelocityProgram } from '../config';
 import StrictEventEmitter from 'strict-event-emitter-types';
 import { EventEmitter } from 'events';
 import { Commitment, MemcmpFilter } from '@solana/web3.js';
-import { ConstituentAccount } from '../types';
-import { WebSocketProgramAccountSubscriber } from '../accounts/webSocketProgramAccountSubscriber';
 import { ConstituentMap } from './constituentMap';
 export declare class WebSocketConstituentAccountSubscriber implements ConstituentAccountSubscriber {
     isSubscribed: boolean;
@@ -13,7 +11,8 @@ export declare class WebSocketConstituentAccountSubscriber implements Constituen
     commitment?: Commitment;
     program: VelocityProgram;
     eventEmitter: StrictEventEmitter<EventEmitter, ConstituentAccountEvents>;
-    constituentDataAccountSubscriber: WebSocketProgramAccountSubscriber<ConstituentAccount>;
+    private _constituentDataAccountSubscriber?;
+    private get constituentDataAccountSubscriber();
     constituentMap: ConstituentMap;
     private additionalFilters?;
     constructor(constituentMap: ConstituentMap, program: VelocityProgram, resubTimeoutMs?: number, commitment?: Commitment, additionalFilters?: MemcmpFilter[]);

package/lib/browser/constituentMap/webSocketConstituentAccountSubscriber.js

@@ -6,6 +6,12 @@ const events_1 = require("events");
 const webSocketProgramAccountSubscriber_1 = require("../accounts/webSocketProgramAccountSubscriber");
 const memcmp_1 = require("../memcmp");
 class WebSocketConstituentAccountSubscriber {
+    get constituentDataAccountSubscriber() {
+        if (!this._constituentDataAccountSubscriber) {
+            throw new Error('WebSocketConstituentAccountSubscriber: constituentDataAccountSubscriber accessed before subscribe()');
+        }
+        return this._constituentDataAccountSubscriber;
+    }
     constructor(constituentMap, program, resubTimeoutMs, commitment, additionalFilters) {
         this.constituentMap = constituentMap;
         this.isSubscribed = false;
@@ -19,7 +25,7 @@ class WebSocketConstituentAccountSubscriber {
         if (this.isSubscribed) {
             return true;
         }
-        this.constituentDataAccountSubscriber =
+        this._constituentDataAccountSubscriber =
             new webSocketProgramAccountSubscriber_1.WebSocketProgramAccountSubscriber('LpPoolConstituent', 'constituent', this.program, this.program.account.constituent.coder.accounts.decode.bind(this.program.account.constituent.coder.accounts), {
                 filters: [(0, memcmp_1.getConstituentFilter)(), ...(this.additionalFilters || [])],
                 commitment: this.commitment,
@@ -38,8 +44,9 @@ class WebSocketConstituentAccountSubscriber {
             this.eventEmitter.emit('update');
         }
         catch (error) {
-            console.log(`WebSocketConstituentAccountSubscriber.sync() error: ${error.message}`);
-            this.eventEmitter.emit('error', error);
+            const err = error instanceof Error ? error : new Error(String(error));
+            console.log(`WebSocketConstituentAccountSubscriber.sync() error: ${err.message}`);
+            this.eventEmitter.emit('error', err);
         }
     }
     async unsubscribe() {

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

@@ -5,20 +5,18 @@ import type { AccountMeta, Connection, PublicKey, TransactionInstruction } from
 import * as pdas from '../addresses/pda';
 import * as constants from '../constants';
 import { CustomBorshCoder } from '../decode/customCoder';
-import type { Drift } from '../idl/drift';
+import type { Velocity } from '../idl/velocity';
 import type { UserAccount } from '../types';
 import type { VelocityProgram } from '../config';
 import type { BN } from '@coral-xyz/anchor';
 import * as remainingAccounts from './remainingAccounts';
 import * as signedMsg from './signedMsg';
 export type VelocityCoreContext = {
-    /** Drift program id. */
+    /** Velocity program id. */
     programId: PublicKey;
-    /** Anchor IDL json for Drift (defaults to bundled `idl/drift.json`). */
-    idl?: Drift;
+    /** Anchor IDL json for Velocity (defaults to bundled `idl/velocity.json`). */
+    idl?: Velocity;
 };
-/** @deprecated Use `VelocityCoreContext` instead. `DriftCoreContext` will be removed in a future major. */
-export type DriftCoreContext = VelocityCoreContext;
 /**
  * VelocityCore is the minimal, core SDK surface:
  * - No subscriptions / polling / websockets.
@@ -34,11 +32,11 @@ export declare class VelocityCore {
     /** Re-export remaining-accounts logic (pure). */
     static readonly remainingAccounts: typeof remainingAccounts;
     static readonly signedMsg: typeof signedMsg;
-    static defaultIdl(): Drift;
-    static coder(idl?: Drift): CustomBorshCoder;
-    /** Decode a Drift `User` account buffer without creating a Program. */
+    static defaultIdl(): Velocity;
+    static coder(idl?: Velocity): CustomBorshCoder;
+    /** Decode a Velocity `User` account buffer without creating a Program. */
     static decodeUserAccount(buffer: Buffer): UserAccount;
-    /** Fetch and decode a Drift `User` account. */
+    /** Fetch and decode a Velocity `User` account. */
     static fetchUserAccount(connection: Connection, userAccountPublicKey: PublicKey): Promise<UserAccount | null>;
     static buildDepositInstruction(args: {
         program: VelocityProgram;
@@ -63,7 +61,7 @@ export declare class VelocityCore {
         state: PublicKey;
         spotMarket: PublicKey;
         spotMarketVault: PublicKey;
-        driftSigner: PublicKey;
+        velocitySigner: PublicKey;
         user: PublicKey;
         userStats: PublicKey;
         userTokenAccount: PublicKey;
@@ -224,7 +222,3 @@ export declare class VelocityCore {
      */
     static buildInstructions(_ctx: VelocityCoreContext): TransactionInstruction[];
 }
-/** @deprecated Use `VelocityCore` instead. `DriftCore` will be removed in a future major. */
-export declare const DriftCore: typeof VelocityCore;
-/** @deprecated Use `VelocityCore` instead. `DriftCore` will be removed in a future major. */
-export type DriftCore = VelocityCore;

package/lib/browser/core/VelocityCore.js

@@ -26,12 +26,12 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DriftCore = exports.VelocityCore = void 0;
+exports.VelocityCore = void 0;
 const pdas = __importStar(require("../addresses/pda"));
 const constants = __importStar(require("../constants"));
 const user_1 = require("../decode/user");
 const customCoder_1 = require("../decode/customCoder");
-const drift_json_1 = __importDefault(require("../idl/drift.json"));
+const velocity_json_1 = __importDefault(require("../idl/velocity.json"));
 const fetch_1 = require("../accounts/fetch");
 const deposit_1 = require("./instructions/deposit");
 const withdraw_1 = require("./instructions/withdraw");
@@ -53,16 +53,16 @@ const signedMsg = __importStar(require("./signedMsg"));
  */
 class VelocityCore {
     static defaultIdl() {
-        return drift_json_1.default;
+        return velocity_json_1.default;
     }
     static coder(idl = VelocityCore.defaultIdl()) {
         return new customCoder_1.CustomBorshCoder(idl);
     }
-    /** Decode a Drift `User` account buffer without creating a Program. */
+    /** Decode a Velocity `User` account buffer without creating a Program. */
     static decodeUserAccount(buffer) {
         return (0, user_1.decodeUser)(buffer);
     }
-    /** Fetch and decode a Drift `User` account. */
+    /** Fetch and decode a Velocity `User` account. */
     static async fetchUserAccount(connection, userAccountPublicKey) {
         const data = await (0, fetch_1.fetchAccount)(connection, userAccountPublicKey);
         return data ? VelocityCore.decodeUserAccount(data) : null;
@@ -136,5 +136,3 @@ VelocityCore.constants = constants;
 /** Re-export remaining-accounts logic (pure). */
 VelocityCore.remainingAccounts = remainingAccounts;
 VelocityCore.signedMsg = signedMsg;
-/** @deprecated Use `VelocityCore` instead. `DriftCore` will be removed in a future major. */
-exports.DriftCore = VelocityCore;

package/lib/browser/core/instructions/perpOrders.d.ts

@@ -31,6 +31,20 @@ export declare function buildPlaceAndMakePerpOrderInstruction(args: {
     authority: PublicKey;
     remainingAccounts: AccountMeta[];
 }): Promise<TransactionInstruction>;
+/**
+ * Build a raw `cancelOrder` instruction.
+ *
+ * Pass `orderId: null` to cancel the user's most recently placed order. The program
+ * resolves a `null` ID on-chain via `get_last_order_id`, which makes this safe to use
+ * in a multi-instruction transaction where a place instruction precedes the cancel and
+ * the program-assigned order ID is not yet known at build time — e.g.:
+ *
+ *   [placePerpOrder] → [cancelOrder(orderId: null)]
+ *
+ * The on-chain `order_id` counter is a monotonically incrementing u32 on the user
+ * account, so `get_last_order_id` reliably points to the order placed in the preceding
+ * instruction of the same transaction.
+ */
 export declare function buildCancelOrderInstruction(args: {
     program: VelocityProgram;
     orderId: number | null;

package/lib/browser/core/instructions/perpOrders.js

@@ -39,6 +39,20 @@ async function buildPlaceAndMakePerpOrderInstruction(args) {
     });
 }
 exports.buildPlaceAndMakePerpOrderInstruction = buildPlaceAndMakePerpOrderInstruction;
+/**
+ * Build a raw `cancelOrder` instruction.
+ *
+ * Pass `orderId: null` to cancel the user's most recently placed order. The program
+ * resolves a `null` ID on-chain via `get_last_order_id`, which makes this safe to use
+ * in a multi-instruction transaction where a place instruction precedes the cancel and
+ * the program-assigned order ID is not yet known at build time — e.g.:
+ *
+ *   [placePerpOrder] → [cancelOrder(orderId: null)]
+ *
+ * The on-chain `order_id` counter is a monotonically incrementing u32 on the user
+ * account, so `get_last_order_id` reliably points to the order placed in the preceding
+ * instruction of the same transaction.
+ */
 async function buildCancelOrderInstruction(args) {
     return await args.program.instruction.cancelOrder(args.orderId, {
         accounts: {

package/lib/browser/core/instructions/withdraw.d.ts

@@ -10,7 +10,7 @@ export declare function buildWithdrawInstruction(args: {
     state: PublicKey;
     spotMarket: PublicKey;
     spotMarketVault: PublicKey;
-    driftSigner: PublicKey;
+    velocitySigner: PublicKey;
     user: PublicKey;
     userStats: PublicKey;
     userTokenAccount: PublicKey;

package/lib/browser/core/instructions/withdraw.js

@@ -7,7 +7,7 @@ async function buildWithdrawInstruction(args) {
             state: args.state,
             spotMarket: args.spotMarket,
             spotMarketVault: args.spotMarketVault,
-            driftSigner: args.driftSigner,
+            velocitySigner: args.velocitySigner,
             user: args.user,
             userStats: args.userStats,
             userTokenAccount: args.userTokenAccount,

package/lib/browser/core/remainingAccounts.d.ts

@@ -13,10 +13,10 @@ export type RemainingAccountsContext = {
     getPerpMarketAccount: (marketIndex: number) => PerpMarketAccount;
     getSpotMarketAccount: (marketIndex: number) => SpotMarketAccount;
     /** Used to resolve user's last slot for cache invalidation. */
-    getUserAccountAndSlot: (subAccountId: number, authority: PublicKey) => {
+    getUserAccountAndSlot: (subAccountId: number | undefined, authority: PublicKey) => {
         slot: number;
     } | undefined;
-    activeSubAccountId: number;
+    activeSubAccountId: number | undefined;
     authority: PublicKey;
     /** Mutable caches + forced-market sets (owned by caller). */
     perpMarketLastSlotCache: Map<number, number>;

package/lib/browser/core/remainingAccounts.js

@@ -16,7 +16,7 @@ function getRemainingAccounts(ctx, params) {
             ? params.userAccounts[0].authority
             : ctx.authority)) === null || _a === void 0 ? void 0 : _a.slot;
         for (const [marketIndex, slot] of ctx.perpMarketLastSlotCache.entries()) {
-            if (slot > lastUserSlot) {
+            if (lastUserSlot !== undefined && slot > lastUserSlot) {
                 addPerpMarketToRemainingAccountMaps(ctx, marketIndex, false, oracleAccountMap, spotMarketAccountMap, perpMarketAccountMap);
             }
             else {
@@ -24,7 +24,7 @@ function getRemainingAccounts(ctx, params) {
             }
         }
         for (const [marketIndex, slot] of ctx.spotMarketLastSlotCache.entries()) {
-            if (slot > lastUserSlot) {
+            if (lastUserSlot !== undefined && slot > lastUserSlot) {
                 addSpotMarketToRemainingAccountMaps(ctx, marketIndex, false, oracleAccountMap, spotMarketAccountMap);
             }
             else {
@@ -75,9 +75,9 @@ function addPerpMarketToRemainingAccountMaps(ctx, marketIndex, writable, oracleA
         isSigner: false,
         isWritable: writable,
     });
-    const oracleWritable = writable && (0, types_1.isVariant)(perpMarketAccount.amm.oracleSource, 'prelaunch');
-    oracleAccountMap.set(perpMarketAccount.amm.oracle.toString(), {
-        pubkey: perpMarketAccount.amm.oracle,
+    const oracleWritable = writable && (0, types_1.isVariant)(perpMarketAccount.oracleSource, 'prelaunch');
+    oracleAccountMap.set(perpMarketAccount.oracle.toString(), {
+        pubkey: perpMarketAccount.oracle,
         isSigner: false,
         isWritable: oracleWritable,
     });

package/lib/browser/decode/user.js

@@ -156,6 +156,9 @@ function decodeUser(buffer) {
         else if (orderStatusNum === 1) {
             status = types_1.OrderStatus.OPEN;
         }
+        else {
+            throw new Error(`decodeUser: unknown order status ${orderStatusNum}`);
+        }
         offset += 1;
         const orderTypeNum = buffer.readUInt8(offset);
         let orderType;
@@ -174,6 +177,9 @@ function decodeUser(buffer) {
         else if (orderTypeNum === 4) {
             orderType = types_1.OrderType.ORACLE;
         }
+        else {
+            throw new Error(`decodeUser: unknown order type ${orderTypeNum}`);
+        }
         offset += 1;
         const marketTypeNum = buffer.readUInt8(offset);
         let marketType;
@@ -224,6 +230,9 @@ function decodeUser(buffer) {
         else if (triggerConditionNum === 3) {
             triggerCondition = types_1.OrderTriggerCondition.TRIGGERED_BELOW;
         }
+        else {
+            throw new Error(`decodeUser: unknown trigger condition ${triggerConditionNum}`);
+        }
         offset += 1;
         const auctionDuration = buffer.readUInt8(offset);
         offset += 1;
@@ -236,7 +245,6 @@ function decodeUser(buffer) {
             slot,
             price,
             baseAssetAmount,
-            quoteAssetAmount: undefined,
             baseAssetAmountFilled,
             quoteAssetAmountFilled,
             triggerPrice,

package/lib/browser/dlob/DLOB.d.ts

@@ -74,6 +74,10 @@ export declare class DLOB {
     initialized: boolean;
     constructor();
     private init;
+    private getOpenOrdersForMarketType;
+    private getOrderListsForMarketType;
+    private tryGetMarketNodeLists;
+    private getMarketNodeLists;
     clear(): void;
     /**
      * initializes a new DLOB instance
@@ -86,6 +90,7 @@ export declare class DLOB {
     addOrderList(marketType: MarketTypeStr, marketIndex: number): void;
     delete(order: Order, userAccount: PublicKey, slot: number, onDelete?: OrderBookCallback): void;
     getListForOnChainOrder(order: Order, slot: number): NodeList<any> | undefined;
+    private getListForOnChainOrderOrThrow;
     updateRestingLimitOrders(slot: number): void;
     updateRestingLimitOrdersForMarketType(slot: number, marketTypeStr: MarketTypeStr): void;
     getOrder(orderId: number, userAccount: PublicKey): Order | undefined;
@@ -111,7 +116,7 @@ export declare class DLOB {
     } ? SpotMarketAccount : PerpMarketAccount, fallbackAsk: BN | undefined, fallbackBid?: BN | undefined): NodeToFill[];
     findTakingNodesCrossingMakerNodes<T extends MarketType>(marketIndex: number, slot: number, marketType: T, oraclePriceData: T extends {
         spot: unknown;
-    } ? OraclePriceData : MMOraclePriceData, takerNodeGenerator: Generator<DLOBNode>, makerNodeGeneratorFn: (marketIndex: number, slot: number, marketType: MarketType, oraclePriceData: T extends {
+    } ? OraclePriceData : MMOraclePriceData, takerNodeGenerator: Generator<DLOBNode>, makerNodeGeneratorFn: (marketIndex: number, slot: number, marketType: T, oraclePriceData: T extends {
         spot: unknown;
     } ? OraclePriceData : MMOraclePriceData) => Generator<DLOBNode>, doesCross: (takerPrice: BN | undefined, makerPrice: BN) => boolean): NodeToFill[];
     findNodesCrossingFallbackLiquidity<T extends MarketType>(marketType: T, slot: number, oraclePriceData: T extends {
@@ -179,7 +184,7 @@ export declare class DLOB {
     getTakeProfitMarkets(marketIndex: number, marketType: MarketType, direction: PositionDirection): Generator<DLOBNode>;
     getTakeProfitLimits(marketIndex: number, marketType: MarketType, direction: PositionDirection): Generator<DLOBNode>;
     findNodesToTrigger(marketIndex: number, slot: number, triggerPrice: BN, marketType: MarketType, stateAccount: StateAccount): NodeToTrigger[];
-    printTop(driftClient: VelocityClient, slotSubscriber: SlotSubscriber, marketIndex: number, marketType: MarketType): void;
+    printTop(velocityClient: VelocityClient, slotSubscriber: SlotSubscriber, marketIndex: number, marketType: MarketType): void;
     getDLOBOrders(): DLOBOrders;
     getNodeLists(): Generator<NodeList<DLOBNodeType>>;
     /**