@velocity-exchange/sdk 0.1.0 → 0.2.0

package/lib/browser/auctionSubscriber/auctionSubscriber.d.ts

@@ -7,7 +7,7 @@ export declare class AuctionSubscriber {
     private opts;
     private resubOpts?;
     eventEmitter: StrictEventEmitter<EventEmitter, AuctionSubscriberEvents>;
-    private subscriber;
+    private subscriber?;
     constructor({ velocityClient, opts, resubTimeoutMs, logResubMessages, }: AuctionSubscriberConfig);
     subscribe(): Promise<void>;
     unsubscribe(): Promise<void>;

package/lib/browser/auctionSubscriber/auctionSubscriber.js

@@ -8,18 +8,20 @@ class AuctionSubscriber {
     constructor({ velocityClient, opts, resubTimeoutMs, logResubMessages, }) {
         // Type-system guarantees at least one of the two is supplied.
         this.velocityClient = velocityClient;
-        this.opts = opts || this.velocityClient.opts;
+        this.opts = opts || this.velocityClient.opts || {};
         this.eventEmitter = new events_1.EventEmitter();
         this.resubOpts = { resubTimeoutMs, logResubMessages };
     }
     async subscribe() {
-        if (!this.subscriber) {
-            this.subscriber = new webSocketProgramAccountSubscriber_1.WebSocketProgramAccountSubscriber('AuctionSubscriber', 'user', this.velocityClient.program, this.velocityClient.program.account.user.coder.accounts.decode.bind(this.velocityClient.program.account.user.coder.accounts), {
+        let subscriber = this.subscriber;
+        if (!subscriber) {
+            subscriber = new webSocketProgramAccountSubscriber_1.WebSocketProgramAccountSubscriber('AuctionSubscriber', 'user', this.velocityClient.program, this.velocityClient.program.account.user.coder.accounts.decode.bind(this.velocityClient.program.account.user.coder.accounts), {
                 filters: [(0, memcmp_1.getUserFilter)(), (0, memcmp_1.getUserWithAuctionFilter)()],
                 commitment: this.opts.commitment,
             }, this.resubOpts);
+            this.subscriber = subscriber;
         }
-        await this.subscriber.subscribe((accountId, data, context) => {
+        await subscriber.subscribe((accountId, data, context) => {
             this.eventEmitter.emit('onAccountUpdate', data, accountId, context.slot);
         });
     }

package/lib/browser/auctionSubscriber/auctionSubscriberGrpc.d.ts

@@ -8,7 +8,7 @@ export declare class AuctionSubscriberGrpc {
     private resubOpts?;
     private grpcConfigs?;
     eventEmitter: StrictEventEmitter<EventEmitter, AuctionSubscriberEvents>;
-    private subscriber;
+    private subscriber?;
     constructor({ velocityClient, opts, grpcConfigs, resubTimeoutMs, logResubMessages, }: AuctionSubscriberConfig);
     subscribe(): Promise<void>;
     unsubscribe(): Promise<void>;

package/lib/browser/auctionSubscriber/auctionSubscriberGrpc.js

@@ -8,18 +8,23 @@ class AuctionSubscriberGrpc {
     constructor({ velocityClient, opts, grpcConfigs, resubTimeoutMs, logResubMessages, }) {
         // Type-system guarantees at least one of the two is supplied.
         this.velocityClient = velocityClient;
-        this.opts = opts || this.velocityClient.opts;
+        this.opts = opts || this.velocityClient.opts || {};
         this.eventEmitter = new events_1.EventEmitter();
         this.resubOpts = { resubTimeoutMs, logResubMessages };
         this.grpcConfigs = grpcConfigs;
     }
     async subscribe() {
-        if (!this.subscriber) {
-            this.subscriber = await grpcProgramAccountSubscriber_1.grpcProgramAccountSubscriber.create(this.grpcConfigs, 'AuctionSubscriber', 'user', this.velocityClient.program, this.velocityClient.program.account.user.coder.accounts.decode.bind(this.velocityClient.program.account.user.coder.accounts), {
+        let subscriber = this.subscriber;
+        if (!subscriber) {
+            if (!this.grpcConfigs) {
+                throw new Error('grpcConfigs must be provided to use AuctionSubscriberGrpc');
+            }
+            subscriber = await grpcProgramAccountSubscriber_1.grpcProgramAccountSubscriber.create(this.grpcConfigs, 'AuctionSubscriber', 'user', this.velocityClient.program, this.velocityClient.program.account.user.coder.accounts.decode.bind(this.velocityClient.program.account.user.coder.accounts), {
                 filters: [(0, memcmp_1.getUserFilter)(), (0, memcmp_1.getUserWithAuctionFilter)()],
             }, this.resubOpts);
+            this.subscriber = subscriber;
         }
-        await this.subscriber.subscribe((accountId, data, context) => {
+        await subscriber.subscribe((accountId, data, context) => {
             this.eventEmitter.emit('onAccountUpdate', data, accountId, context.slot);
         });
     }

package/lib/browser/bankrun/bankrunConnection.d.ts

@@ -10,7 +10,7 @@ export type ClientSubscriptionId = number;
 export type Connection = SolanaConnection | BankrunConnection;
 type BankrunTransactionMetaNormalized = {
     logMessages: string[];
-    err: TransactionError;
+    err: TransactionError | null;
 };
 type BankrunTransactionRespose = {
     slot: number;
@@ -34,7 +34,8 @@ export declare class BankrunConnection {
     private readonly _banksClient;
     private readonly context;
     private transactionToMeta;
-    private clock;
+    private _clock?;
+    private get clock();
     private nextClientSubscriptionId;
     private onLogCallbacks;
     private onAccountChangeCallbacks;
@@ -43,14 +44,14 @@ export declare class BankrunConnection {
     getSlot(): Promise<bigint>;
     toConnection(): SolanaConnection;
     getTokenAccount(publicKey: PublicKey): Promise<Account>;
-    getMultipleAccountsInfo(publicKeys: PublicKey[], _commitmentOrConfig?: Commitment): Promise<AccountInfo<Buffer>[]>;
+    getMultipleAccountsInfo(publicKeys: PublicKey[], _commitmentOrConfig?: Commitment): Promise<(AccountInfo<Buffer> | null)[]>;
     getAccountInfo(publicKey: PublicKey): Promise<null | AccountInfo<Buffer>>;
     getAccountInfoAndContext(publicKey: PublicKey, _commitment?: Commitment): Promise<RpcResponseAndContext<null | AccountInfo<Buffer>>>;
     sendRawTransaction(rawTransaction: Buffer | Uint8Array | Array<number>, _options?: any): Promise<TransactionSignature>;
     sendTransaction(tx: Transaction | VersionedTransaction): Promise<TransactionSignature>;
     updateSlotAndClock(): Promise<void>;
     getTime(): number;
-    getParsedAccountInfo(publicKey: PublicKey): Promise<RpcResponseAndContext<AccountInfo<Buffer>>>;
+    getParsedAccountInfo(publicKey: PublicKey): Promise<RpcResponseAndContext<null | AccountInfo<Buffer>>>;
     getLatestBlockhash(commitment?: Commitment): Promise<Readonly<{
         blockhash: string;
         lastValidBlockHeight: number;
@@ -61,6 +62,7 @@ export declare class BankrunConnection {
      * There's really no direct equivalent to getTransaction exposed by SolanaProgramTest, so we do the best that we can here - it's a little hacky.
      */
     getTransaction(signature: string, _rawConfig?: GetTransactionConfig | GetVersionedTransactionConfig): Promise<BankrunTransactionRespose | null>;
+    private getTransactionMetaOrThrow;
     findComputeUnitConsumption(signature: string): bigint;
     printTxLogs(signature: string): void;
     simulateTransaction(transaction: Transaction | VersionedTransaction, _config?: SimulateTransactionConfig): Promise<RpcResponseAndContext<SimulatedTransactionResponse>>;

package/lib/browser/bankrun/bankrunConnection.js

@@ -78,6 +78,12 @@ class BankrunContextWrapper {
 }
 exports.BankrunContextWrapper = BankrunContextWrapper;
 class BankrunConnection {
+    get clock() {
+        if (!this._clock) {
+            throw new Error('BankrunConnection: clock accessed before updateSlotAndClock()');
+        }
+        return this._clock;
+    }
     constructor(banksClient, context, verifySignatures = true) {
         this.transactionToMeta = new Map();
         this.nextClientSubscriptionId = 0;
@@ -95,6 +101,9 @@ class BankrunConnection {
     }
     async getTokenAccount(publicKey) {
         const info = await this.getAccountInfo(publicKey);
+        if (info === null) {
+            throw new Error(`Account not found: ${publicKey.toBase58()}`);
+        }
         return (0, spl_token_1.unpackAccount)(publicKey, info, info.owner);
     }
     async getMultipleAccountsInfo(publicKeys, _commitmentOrConfig) {
@@ -132,9 +141,17 @@ class BankrunConnection {
             ? await internal.tryProcessVersionedTransaction(serialized)
             : await internal.tryProcessLegacyTransaction(serialized);
         const banksTransactionMeta = new solana_bankrun_1.BanksTransactionResultWithMeta(inner);
-        const signature = isVersioned
-            ? bs58_1.default.encode(tx.signatures[0])
-            : bs58_1.default.encode(tx.signatures[0].signature);
+        let signature;
+        if (isVersioned) {
+            signature = bs58_1.default.encode(tx.signatures[0]);
+        }
+        else {
+            const legacySignature = tx.signatures[0].signature;
+            if (legacySignature === null) {
+                throw new Error('BankrunConnection: transaction is missing its first signature');
+            }
+            signature = bs58_1.default.encode(legacySignature);
+        }
         if (banksTransactionMeta.result) {
             if (!banksTransactionMeta.result
                 .toString()
@@ -151,9 +168,12 @@ class BankrunConnection {
         }
         let finalizedCount = 0;
         while (finalizedCount < 10) {
-            const signatureStatus = (await this.getSignatureStatus(signature)).value
-                .confirmationStatus;
-            if (signatureStatus.toString() == '"finalized"') {
+            const statusValue = (await this.getSignatureStatus(signature)).value;
+            if (statusValue === null) {
+                throw new Error(`BankrunConnection: no signature status for ${signature}`);
+            }
+            const signatureStatus = statusValue.confirmationStatus;
+            if ((signatureStatus === null || signatureStatus === void 0 ? void 0 : signatureStatus.toString()) == '"finalized"') {
                 finalizedCount += 1;
             }
         }
@@ -167,18 +187,23 @@ class BankrunConnection {
         }
         if (this.onLogCallbacks.size > 0) {
             const transaction = await this.getTransaction(signature);
-            const context = { slot: transaction.slot };
-            const logs = {
-                logs: transaction.meta.logMessages,
-                err: transaction.meta.err,
-                signature,
-            };
-            for (const logCallback of this.onLogCallbacks.values()) {
-                logCallback(logs, context);
+            if (transaction !== null) {
+                const context = { slot: transaction.slot };
+                const logs = {
+                    logs: transaction.meta.logMessages,
+                    err: transaction.meta.err,
+                    signature,
+                };
+                for (const logCallback of this.onLogCallbacks.values()) {
+                    logCallback(logs, context);
+                }
             }
         }
         for (const [publicKey, callback,] of this.onAccountChangeCallbacks.values()) {
             const accountInfo = await this.getParsedAccountInfo(publicKey);
+            if (accountInfo.value === null) {
+                continue;
+            }
             callback(accountInfo.value, accountInfo.context);
         }
         return signature;
@@ -190,7 +215,7 @@ class BankrunConnection {
         const currentClock = await this._banksClient.getClock();
         const newClock = new solana_bankrun_1.Clock(nextSlot, currentClock.epochStartTimestamp, currentClock.epoch, currentClock.leaderScheduleEpoch, currentClock.unixTimestamp + BigInt(1));
         this.context.setClock(newClock);
-        this.clock = newClock;
+        this._clock = newClock;
     }
     getTime() {
         return Number(this.clock.unixTimestamp);
@@ -212,6 +237,9 @@ class BankrunConnection {
     }
     async getLatestBlockhash(commitment) {
         const blockhashAndBlockheight = await this._banksClient.getLatestBlockhash(commitment);
+        if (blockhashAndBlockheight === null) {
+            throw new Error('Failed to get latest blockhash');
+        }
         return {
             blockhash: blockhashAndBlockheight[0],
             lastValidBlockHeight: Number(blockhashAndBlockheight[1]),
@@ -258,6 +286,9 @@ class BankrunConnection {
             return null;
         }
         const transactionStatus = await this._banksClient.getTransactionStatus(signature);
+        if (transactionStatus === null) {
+            throw new Error(`tx has no status: ${signature}`);
+        }
         if (txMeta.meta === null) {
             throw new Error(`tx has no meta: ${JSON.stringify(txMeta)}`);
         }
@@ -270,36 +301,43 @@ class BankrunConnection {
             meta,
         };
     }
-    findComputeUnitConsumption(signature) {
+    getTransactionMetaOrThrow(signature) {
         const txMeta = this.transactionToMeta.get(signature);
         if (txMeta === undefined) {
             throw new Error('Transaction not found');
         }
-        return txMeta.meta.computeUnitsConsumed;
+        if (txMeta.meta === null) {
+            throw new Error(`tx has no meta: ${JSON.stringify(txMeta)}`);
+        }
+        return txMeta.meta;
+    }
+    findComputeUnitConsumption(signature) {
+        return this.getTransactionMetaOrThrow(signature).computeUnitsConsumed;
     }
     printTxLogs(signature) {
-        const txMeta = this.transactionToMeta.get(signature);
-        if (txMeta === undefined) {
-            throw new Error('Transaction not found');
-        }
-        console.log(txMeta.meta.logMessages);
+        console.log(this.getTransactionMetaOrThrow(signature).logMessages);
     }
     async simulateTransaction(transaction, _config) {
-        var _a, _b, _c, _d;
         const simulationResult = await this._banksClient.simulateTransaction(transaction);
-        const returnDataProgramId = (_b = (_a = simulationResult.meta) === null || _a === void 0 ? void 0 : _a.returnData) === null || _b === void 0 ? void 0 : _b.programId.toBase58();
-        const returnDataNormalized = Buffer.from((_d = (_c = simulationResult.meta) === null || _c === void 0 ? void 0 : _c.returnData) === null || _d === void 0 ? void 0 : _d.data).toString('base64');
-        const returnData = {
-            programId: returnDataProgramId,
-            data: [returnDataNormalized, 'base64'],
-        };
+        const meta = simulationResult.meta;
+        if (meta === null) {
+            throw new Error('BankrunConnection: simulation returned no meta');
+        }
+        let returnData;
+        if (meta.returnData !== null) {
+            const returnDataNormalized = Buffer.from(meta.returnData.data).toString('base64');
+            returnData = {
+                programId: meta.returnData.programId.toBase58(),
+                data: [returnDataNormalized, 'base64'],
+            };
+        }
         return {
             context: { slot: Number(await this._banksClient.getSlot()) },
             value: {
                 err: simulationResult.result,
-                logs: simulationResult.meta.logMessages,
+                logs: meta.logMessages,
                 accounts: undefined,
-                unitsConsumed: Number(simulationResult.meta.computeUnitsConsumed),
+                unitsConsumed: Number(meta.computeUnitsConsumed),
                 returnData,
             },
         };

package/lib/browser/blockhashSubscriber/BlockhashSubscriber.d.ts

@@ -11,7 +11,7 @@ export declare class BlockhashSubscriber {
     private updateIntervalMs;
     constructor(config: BlockhashSubscriberConfig);
     getBlockhashCacheSize(): number;
-    getLatestBlockHeight(): number;
+    getLatestBlockHeight(): number | undefined;
     getLatestBlockHeightContext(): Context | undefined;
     /**
      * Returns the latest cached blockhash, based on an offset from the latest obtained

package/lib/browser/blockhashSubscriber/BlockhashSubscriber.js

@@ -40,8 +40,9 @@ class BlockhashSubscriber {
         return this.blockhashes[this.blockhashes.length - 1 - clampedOffset];
     }
     pruneBlockhashes() {
-        if (this.latestBlockHeight) {
-            this.blockhashes = this.blockhashes.filter((blockhash) => blockhash.lastValidBlockHeight > this.latestBlockHeight);
+        if (this.latestBlockHeight !== undefined) {
+            const latestBlockHeight = this.latestBlockHeight;
+            this.blockhashes = this.blockhashes.filter((blockhash) => blockhash.lastValidBlockHeight > latestBlockHeight);
         }
     }
     async updateBlockhash() {

package/lib/browser/clock/clockSubscriber.d.ts

@@ -11,13 +11,13 @@ export interface ClockSubscriberEvent {
 }
 export declare class ClockSubscriber {
     private connection;
-    private _latestSlot;
-    private _currentTs;
-    private subscriptionId;
+    private _latestSlot?;
+    private _currentTs?;
+    private subscriptionId?;
     commitment: Commitment;
     eventEmitter: StrictEventEmitter<EventEmitter, ClockSubscriberEvent>;
-    get latestSlot(): number;
-    get currentTs(): number;
+    get latestSlot(): number | undefined;
+    get currentTs(): number | undefined;
     private timeoutId?;
     private resubTimeoutMs?;
     private isUnsubscribing;
@@ -25,7 +25,7 @@ export declare class ClockSubscriber {
     constructor(connection: Connection, config?: ClockSubscriberConfig);
     subscribe(): Promise<void>;
     private setTimeout;
-    getUnixTs(): number;
+    getUnixTs(): number | undefined;
     unsubscribe(onResub?: boolean): Promise<void>;
 }
 export {};

package/lib/browser/clock/clockSubscriber.js

@@ -18,7 +18,7 @@ class ClockSubscriber {
         this.eventEmitter = new events_1.EventEmitter();
         this.resubTimeoutMs = config === null || config === void 0 ? void 0 : config.resubTimeoutMs;
         this.commitment = (config === null || config === void 0 ? void 0 : config.commitment) || 'confirmed';
-        if (this.resubTimeoutMs < 1000) {
+        if (this.resubTimeoutMs !== undefined && this.resubTimeoutMs < 1000) {
             console.log('resubTimeoutMs should be at least 1000ms to avoid spamming resub');
         }
     }
@@ -34,8 +34,9 @@ class ClockSubscriber {
                     this.setTimeout();
                 }
                 this._latestSlot = context.slot;
-                this._currentTs = new anchor_1.BN(acctInfo.data.subarray(32, 39), undefined, 'le').toNumber();
-                this.eventEmitter.emit('clockUpdate', this.currentTs);
+                const currentTs = new anchor_1.BN(acctInfo.data.subarray(32, 39), undefined, 'le').toNumber();
+                this._currentTs = currentTs;
+                this.eventEmitter.emit('clockUpdate', currentTs);
             }
         }, this.commitment);
         if (this.resubTimeoutMs) {

package/lib/browser/config.d.ts

@@ -27,7 +27,7 @@ export interface VelocityConfig {
 export declare const VELOCITY_PROGRAM_ID = "vELoC1audYbSYVRXn1vPaV8Axoa9oU6BYmNGZZBDZ1P";
 export declare const VELOCITY_DEVNET_PROGRAM_ID = "vELoC1audYbSYVRXn1vPaV8Axoa9oU6BYmNGZZBDZ1P";
 export declare const VELOCITY_ORACLE_RECEIVER_ID = "G6EoTTTgpkNBtVXo96EQp2m6uwwVh2Kt6YidjkmQqoha";
-export declare const PTYH_LAZER_PROGRAM_ID = "pytd2yyk641x7ak7mkaasSJVXh6YYZnC7wTmtgAyxPt";
+export declare const PYTH_LAZER_PROGRAM_ID = "pytd2yyk641x7ak7mkaasSJVXh6YYZnC7wTmtgAyxPt";
 export declare const SB_ON_DEMAND_DEVNET_PID: PublicKey;
 export declare const SB_ON_DEMAND_MAINNET_PID: PublicKey;
 export declare const PYTH_LAZER_STORAGE_ACCOUNT_KEY: PublicKey;

package/lib/browser/config.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.findAllMarketAndOracles = exports.getMarketsAndOraclesForSubscription = exports.initialize = exports.getConfig = exports.configs = exports.DEFAULT_CONFIRMATION_OPTS = exports.PYTH_LAZER_STORAGE_ACCOUNT_KEY = exports.SB_ON_DEMAND_MAINNET_PID = exports.SB_ON_DEMAND_DEVNET_PID = exports.PTYH_LAZER_PROGRAM_ID = exports.VELOCITY_ORACLE_RECEIVER_ID = exports.VELOCITY_DEVNET_PROGRAM_ID = exports.VELOCITY_PROGRAM_ID = void 0;
+exports.findAllMarketAndOracles = exports.getMarketsAndOraclesForSubscription = exports.initialize = exports.getConfig = exports.configs = exports.DEFAULT_CONFIRMATION_OPTS = exports.PYTH_LAZER_STORAGE_ACCOUNT_KEY = exports.SB_ON_DEMAND_MAINNET_PID = exports.SB_ON_DEMAND_DEVNET_PID = exports.PYTH_LAZER_PROGRAM_ID = exports.VELOCITY_ORACLE_RECEIVER_ID = exports.VELOCITY_DEVNET_PROGRAM_ID = exports.VELOCITY_PROGRAM_ID = void 0;
 const web3_js_1 = require("@solana/web3.js");
 const perpMarkets_1 = require("./constants/perpMarkets");
 const spotMarkets_1 = require("./constants/spotMarkets");
@@ -8,7 +8,7 @@ const oracleId_1 = require("./oracles/oracleId");
 exports.VELOCITY_PROGRAM_ID = 'vELoC1audYbSYVRXn1vPaV8Axoa9oU6BYmNGZZBDZ1P';
 exports.VELOCITY_DEVNET_PROGRAM_ID = 'vELoC1audYbSYVRXn1vPaV8Axoa9oU6BYmNGZZBDZ1P';
 exports.VELOCITY_ORACLE_RECEIVER_ID = 'G6EoTTTgpkNBtVXo96EQp2m6uwwVh2Kt6YidjkmQqoha';
-exports.PTYH_LAZER_PROGRAM_ID = 'pytd2yyk641x7ak7mkaasSJVXh6YYZnC7wTmtgAyxPt';
+exports.PYTH_LAZER_PROGRAM_ID = 'pytd2yyk641x7ak7mkaasSJVXh6YYZnC7wTmtgAyxPt';
 exports.SB_ON_DEMAND_DEVNET_PID = new web3_js_1.PublicKey('Aio4gaXjXzJNVLtzwtNVmSqGKpANtXhybbkhtAC94ji2');
 exports.SB_ON_DEMAND_MAINNET_PID = new web3_js_1.PublicKey('SBondMDrcV3K4kxZR1HNVT7osZxAHVHgYXL5Ze1oMUv');
 exports.PYTH_LAZER_STORAGE_ACCOUNT_KEY = new web3_js_1.PublicKey('3rdJbqfnagQ4yx9HXJViD4zc4xpiSqmFsKpPuSCQVyQL');
@@ -70,8 +70,12 @@ const initialize = (props) => {
 };
 exports.initialize = initialize;
 function getMarketsAndOraclesForSubscription(env, perpMarkets, spotMarkets) {
-    const perpMarketsToUse = (perpMarkets === null || perpMarkets === void 0 ? void 0 : perpMarkets.length) > 0 ? perpMarkets : perpMarkets_1.PerpMarkets[env];
-    const spotMarketsToUse = (spotMarkets === null || spotMarkets === void 0 ? void 0 : spotMarkets.length) > 0 ? spotMarkets : spotMarkets_1.SpotMarkets[env];
+    const perpMarketsToUse = perpMarkets !== undefined && perpMarkets.length > 0
+        ? perpMarkets
+        : perpMarkets_1.PerpMarkets[env];
+    const spotMarketsToUse = spotMarkets !== undefined && spotMarkets.length > 0
+        ? spotMarkets
+        : spotMarkets_1.SpotMarkets[env];
     const perpMarketIndexes = [];
     const spotMarketIndexes = [];
     const oracleInfos = new Map();

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

@@ -1,9 +1,8 @@
 /**
  * Protocol constants: numeric precision bases, market indices, transaction size limits,
- * insurance fund parameters, and perp/spot market config arrays.
+ * and perp/spot market config arrays.
  * Import specific submodules to avoid pulling in unused market lists.
  */
-export * from './insuranceFund';
 export * from './numericConstants';
 export * from './perpMarkets';
 export * from './spotMarkets';

package/lib/browser/constants/index.js

@@ -16,10 +16,9 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 /**
  * Protocol constants: numeric precision bases, market indices, transaction size limits,
- * insurance fund parameters, and perp/spot market config arrays.
+ * and perp/spot market config arrays.
  * Import specific submodules to avoid pulling in unused market lists.
  */
-__exportStar(require("./insuranceFund"), exports);
 __exportStar(require("./numericConstants"), exports);
 __exportStar(require("./perpMarkets"), exports);
 __exportStar(require("./spotMarkets"), exports);

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.js

@@ -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/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;