@velocity-exchange/sdk 0.0.5 → 0.2.0

package/lib/browser/userConfig.d.ts

@@ -5,12 +5,13 @@ import { GrpcConfigs, UserAccountSubscriber } from './accounts/types';
 import { WebSocketProgramAccountSubscriber } from './accounts/webSocketProgramAccountSubscriber';
 import { UserAccount } from './types';
 import { grpcMultiUserAccountSubscriber } from './accounts/grpcMultiUserAccountSubscriber';
-import { AtLeastOne } from './util/deprecatedAlias';
 type UserConfigBase = {
     accountSubscription?: UserSubscriptionConfig;
     userAccountPublicKey: PublicKey;
 };
-export type UserConfig = UserConfigBase & AtLeastOne<'velocityClient', 'driftClient', VelocityClient>;
+export type UserConfig = UserConfigBase & {
+    velocityClient: VelocityClient;
+};
 export type UserSubscriptionConfig = {
     type: 'grpc';
     resubTimeoutMs?: number;

package/lib/browser/userMap/WebsocketSubscription.d.ts

@@ -12,7 +12,7 @@ export declare class WebsocketSubscription {
     private includeIdle?;
     private additionalFilters?;
     private decodeFn;
-    private subscriber;
+    private subscriber?;
     constructor({ userMap, commitment, skipInitialLoad, resubOpts, includeIdle, decodeFn, additionalFilters, }: {
         userMap: UserMap;
         commitment: Commitment;

package/lib/browser/userMap/WebsocketSubscription.js

@@ -22,7 +22,7 @@ class WebsocketSubscription {
             if (this.additionalFilters) {
                 filters.push(...this.additionalFilters);
             }
-            this.subscriber = new webSocketProgramAccountSubscriber_1.WebSocketProgramAccountSubscriber('UserMap', 'user', this.userMap.driftClient.program, this.decodeFn, {
+            this.subscriber = new webSocketProgramAccountSubscriber_1.WebSocketProgramAccountSubscriber('UserMap', 'user', this.userMap.velocityClient.program, this.decodeFn, {
                 filters,
                 commitment: this.commitment,
             }, this.resubOpts);

package/lib/browser/userMap/grpcSubscription.d.ts

@@ -12,7 +12,7 @@ export declare class grpcSubscription {
     private includeIdle?;
     private additionalFilters?;
     private decodeFn;
-    private subscriber;
+    private subscriber?;
     constructor({ grpcConfigs, userMap, skipInitialLoad, resubOpts, includeIdle, decodeFn, additionalFilters, }: {
         grpcConfigs: GrpcConfigs;
         userMap: UserMap;

package/lib/browser/userMap/grpcSubscription.js

@@ -22,7 +22,7 @@ class grpcSubscription {
             if (this.additionalFilters) {
                 filters.push(...this.additionalFilters);
             }
-            this.subscriber = await grpcProgramAccountSubscriber_1.grpcProgramAccountSubscriber.create(this.grpcConfigs, 'UserMap', 'user', this.userMap.driftClient.program, this.decodeFn, {
+            this.subscriber = await grpcProgramAccountSubscriber_1.grpcProgramAccountSubscriber.create(this.grpcConfigs, 'UserMap', 'user', this.userMap.velocityClient.program, this.decodeFn, {
                 filters,
             }, this.resubOpts);
         }

package/lib/browser/userMap/referrerMap.d.ts

@@ -12,8 +12,6 @@ export declare class ReferrerMap {
      */
     private referrerReferrerInfoMap;
     private velocityClient;
-    /** @deprecated Use `velocityClient` instead. `driftClient` will be removed in a future major. */
-    private get driftClient();
     private parallelSync;
     private fetchPromise?;
     private fetchPromiseResolver;

package/lib/browser/userMap/referrerMap.js

@@ -10,10 +10,6 @@ const memcmp_1 = require("../memcmp");
 const bs58_1 = __importDefault(require("bs58"));
 const DEFAULT_PUBLIC_KEY = web3_js_1.PublicKey.default.toBase58();
 class ReferrerMap {
-    /** @deprecated Use `velocityClient` instead. `driftClient` will be removed in a future major. */
-    get driftClient() {
-        return this.velocityClient;
-    }
     /**
      * Creates a new UserStatsMap instance.
      *
@@ -29,6 +25,7 @@ class ReferrerMap {
          * Will be undefined if the referrer is not in the map yet.
          */
         this.referrerReferrerInfoMap = new Map();
+        this.fetchPromiseResolver = () => { };
         this.velocityClient = velocityClient;
         this.parallelSync = parallelSync !== undefined ? parallelSync : true;
     }
@@ -54,7 +51,11 @@ class ReferrerMap {
         }
         else if (referrer === undefined) {
             const userStatsAccountPublicKey = (0, pda_1.getUserStatsAccountPublicKey)(this.velocityClient.program.programId, new web3_js_1.PublicKey(authority));
-            const buffer = (await this.velocityClient.connection.getAccountInfo(userStatsAccountPublicKey, 'processed')).data;
+            const accountInfo = await this.velocityClient.connection.getAccountInfo(userStatsAccountPublicKey, 'processed');
+            if (!accountInfo) {
+                throw new Error(`ReferrerMap: UserStats account not found for authority ${authority}`);
+            }
+            const buffer = accountInfo.data;
             const referrer = bs58_1.default.encode(buffer.subarray(40, 72));
             this.addReferrer(authority, referrer);
         }
@@ -124,10 +125,11 @@ class ReferrerMap {
         }
     }
     async syncAll() {
+        var _a;
         const rpcRequestArgs = [
             this.velocityClient.program.programId.toBase58(),
             {
-                commitment: this.velocityClient.opts.commitment,
+                commitment: (_a = this.velocityClient.opts) === null || _a === void 0 ? void 0 : _a.commitment,
                 filters: [(0, memcmp_1.getUserStatsFilter)()],
                 encoding: 'base64',
                 dataSlice: {
@@ -150,10 +152,11 @@ class ReferrerMap {
         }
     }
     async syncReferrer(referrerFilter) {
+        var _a;
         const rpcRequestArgs = [
             this.velocityClient.program.programId.toBase58(),
             {
-                commitment: this.velocityClient.opts.commitment,
+                commitment: (_a = this.velocityClient.opts) === null || _a === void 0 ? void 0 : _a.commitment,
                 filters: [(0, memcmp_1.getUserStatsFilter)(), referrerFilter],
                 encoding: 'base64',
                 dataSlice: {

package/lib/browser/userMap/revenueShareEscrowMap.d.ts

@@ -6,8 +6,6 @@ export declare class RevenueShareEscrowMap {
      */
     private authorityEscrowMap;
     private velocityClient;
-    /** @deprecated Use `velocityClient` instead. `driftClient` will be removed in a future major. */
-    private get driftClient();
     private parallelSync;
     private fetchPromise?;
     private fetchPromiseResolver;

package/lib/browser/userMap/revenueShareEscrowMap.js

@@ -5,10 +5,6 @@ const web3_js_1 = require("@solana/web3.js");
 const pda_1 = require("../addresses/pda");
 const memcmp_1 = require("../memcmp");
 class RevenueShareEscrowMap {
-    /** @deprecated Use `velocityClient` instead. `driftClient` will be removed in a future major. */
-    get driftClient() {
-        return this.velocityClient;
-    }
     /**
      * Creates a new RevenueShareEscrowMap instance.
      *
@@ -20,6 +16,7 @@ class RevenueShareEscrowMap {
          * map from authority pubkey to RevenueShareEscrow account data.
          */
         this.authorityEscrowMap = new Map();
+        this.fetchPromiseResolver = () => { };
         this.velocityClient = velocityClient;
         this.parallelSync = parallelSync !== undefined ? parallelSync : true;
     }
@@ -93,6 +90,9 @@ class RevenueShareEscrowMap {
         }
         for (const authority of this.authorityEscrowMap.keys()) {
             const accountInfo = await this.velocityClient.connection.getAccountInfo((0, pda_1.getRevenueShareEscrowAccountPublicKey)(this.velocityClient.program.programId, new web3_js_1.PublicKey(authority)), 'confirmed');
+            if (accountInfo === null) {
+                throw new Error(`RevenueShareEscrow account not found for authority ${authority} during slowSync`);
+            }
             const escrowNew = this.velocityClient.program.account.revenueShareEscrow.coder.accounts.decode('revenueShareEscrow', accountInfo.data);
             this.authorityEscrowMap.set(authority, escrowNew);
         }

package/lib/browser/userMap/userMap.d.ts

@@ -30,8 +30,6 @@ export interface UserMapInterface {
 export declare class UserMap implements UserMapInterface {
     private userMap;
     velocityClient: VelocityClient;
-    /** @deprecated Use `velocityClient` instead. `driftClient` will be removed in a future major. */
-    get driftClient(): VelocityClient;
     eventEmitter: StrictEventEmitter<EventEmitter, UserEvents>;
     private connection;
     private commitment;
@@ -39,7 +37,7 @@ export declare class UserMap implements UserMapInterface {
     private filterByPoolId?;
     private additionalFilters?;
     private disableSyncOnTotalAccountsChange;
-    private lastNumberOfSubAccounts;
+    private lastNumberOfSubAccounts?;
     private subscription;
     private stateAccountUpdateCallback;
     private decode;
@@ -99,13 +97,13 @@ export declare class UserMap implements UserMapInterface {
     private getFilters;
     /**
      * Syncs the UserMap using the default sync method (single getProgramAccounts call with filters).
-     * This method may fail when drift has too many users. (nodejs response size limits)
+     * This method may fail when velocity has too many users. (nodejs response size limits)
      * @returns
      */
     private defaultSync;
     /**
      * Syncs the UserMap using the paginated sync method (multiple getMultipleAccounts calls with filters).
-     * This method is more reliable when drift has many users.
+     * This method is more reliable when velocity has many users.
      * @returns
      */
     private paginatedSync;

package/lib/browser/userMap/userMap.js

@@ -15,25 +15,23 @@ const grpcSubscription_1 = require("./grpcSubscription");
 const events_1 = require("events");
 const MAX_USER_ACCOUNT_SIZE_BYTES = 4376;
 class UserMap {
-    /** @deprecated Use `velocityClient` instead. `driftClient` will be removed in a future major. */
-    get driftClient() {
-        return this.velocityClient;
-    }
     /**
      * Constructs a new UserMap instance.
      */
     constructor(config) {
-        var _a, _b, _c, _d, _e, _f, _g;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j;
         this.userMap = new Map();
         this.stateAccountUpdateCallback = async (state) => {
-            if (!state.numberOfSubAccounts.eq(this.lastNumberOfSubAccounts)) {
+            if (this.lastNumberOfSubAccounts === undefined ||
+                !state.numberOfSubAccounts.eq(this.lastNumberOfSubAccounts)) {
                 await this.sync();
                 this.lastNumberOfSubAccounts = state.numberOfSubAccounts;
             }
         };
         this.mostRecentSlot = 0;
+        this.syncPromiseResolver = () => { };
         // Type-system guarantees at least one of the two is supplied.
-        this.velocityClient = ((_a = config.velocityClient) !== null && _a !== void 0 ? _a : config.driftClient);
+        this.velocityClient = config.velocityClient;
         if (config.connection) {
             this.connection = config.connection;
         }
@@ -41,18 +39,18 @@ class UserMap {
             this.connection = this.velocityClient.connection;
         }
         this.commitment =
-            config.subscriptionConfig.type === 'websocket' ||
+            (_d = (config.subscriptionConfig.type === 'websocket' ||
                 config.subscriptionConfig.type === 'polling'
-                ? (_b = config.subscriptionConfig.commitment) !== null && _b !== void 0 ? _b : this.velocityClient.opts.commitment
-                : this.velocityClient.opts.commitment;
-        this.includeIdle = (_c = config.includeIdle) !== null && _c !== void 0 ? _c : false;
+                ? (_a = config.subscriptionConfig.commitment) !== null && _a !== void 0 ? _a : (_b = this.velocityClient.opts) === null || _b === void 0 ? void 0 : _b.commitment
+                : (_c = this.velocityClient.opts) === null || _c === void 0 ? void 0 : _c.commitment)) !== null && _d !== void 0 ? _d : 'confirmed';
+        this.includeIdle = (_e = config.includeIdle) !== null && _e !== void 0 ? _e : false;
         this.filterByPoolId = config.filterByPoolId;
         this.additionalFilters = config.additionalFilters;
         this.disableSyncOnTotalAccountsChange =
-            (_d = config.disableSyncOnTotalAccountsChange) !== null && _d !== void 0 ? _d : false;
+            (_f = config.disableSyncOnTotalAccountsChange) !== null && _f !== void 0 ? _f : false;
         let decodeFn;
-        if ((_e = config.fastDecode) !== null && _e !== void 0 ? _e : true) {
-            decodeFn = (name, buffer) => (0, user_2.decodeUser)(buffer);
+        if ((_g = config.fastDecode) !== null && _g !== void 0 ? _g : true) {
+            decodeFn = (_name, buffer) => (0, user_2.decodeUser)(buffer);
         }
         else {
             decodeFn = this.velocityClient.program.account.user.coder.accounts.decodeUnchecked.bind(this.velocityClient.program.account.user.coder.accounts);
@@ -89,11 +87,11 @@ class UserMap {
                 decodeFn,
             });
         }
-        this.syncConfig = (_f = config.syncConfig) !== null && _f !== void 0 ? _f : {
+        this.syncConfig = (_h = config.syncConfig) !== null && _h !== void 0 ? _h : {
             type: 'default',
         };
         // Whether to throw an error if the userMap fails to sync. Defaults to false.
-        this.throwOnFailedSync = (_g = config.throwOnFailedSync) !== null && _g !== void 0 ? _g : false;
+        this.throwOnFailedSync = (_j = config.throwOnFailedSync) !== null && _j !== void 0 ? _j : false;
         this.eventEmitter = new events_1.EventEmitter();
     }
     async subscribe() {
@@ -120,9 +118,13 @@ class UserMap {
             },
         });
         await user.subscribe(userAccount);
+        const resolvedSlot = slot !== null && slot !== void 0 ? slot : (_a = user.getUserAccountAndSlot()) === null || _a === void 0 ? void 0 : _a.slot;
+        if (resolvedSlot === undefined) {
+            throw new Error('UserMap.addPubkey: no slot available after subscribing user account');
+        }
         this.userMap.set(userAccountPublicKey.toString(), {
             data: user,
-            slot: slot !== null && slot !== void 0 ? slot : (_a = user.getUserAccountAndSlot()) === null || _a === void 0 ? void 0 : _a.slot,
+            slot: resolvedSlot,
         });
         this.eventEmitter.emit('userUpdate', user);
     }
@@ -150,17 +152,25 @@ class UserMap {
         if (!this.has(key)) {
             await this.addPubkey(new web3_js_1.PublicKey(key), undefined, undefined, accountSubscription);
         }
-        return this.userMap.get(key).data;
+        const userWithSlot = this.userMap.get(key);
+        if (!userWithSlot) {
+            throw new Error(`UserMap.mustGet: no user found for ${key}`);
+        }
+        return userWithSlot.data;
     }
     async mustGetWithSlot(key, accountSubscription) {
         if (!this.has(key)) {
             await this.addPubkey(new web3_js_1.PublicKey(key), undefined, undefined, accountSubscription);
         }
-        return this.userMap.get(key);
+        const userWithSlot = this.userMap.get(key);
+        if (!userWithSlot) {
+            throw new Error(`UserMap.mustGetWithSlot: no user found for ${key}`);
+        }
+        return userWithSlot;
     }
     async mustGetUserAccount(key) {
         const user = await this.mustGet(key);
-        return user.getUserAccount();
+        return user.getUserAccountOrThrow();
     }
     /**
      * gets the Authority for a particular userAccountPublicKey, if no User exists, undefined is returned
@@ -168,11 +178,12 @@ class UserMap {
      * @returns authority PublicKey | undefined
      */
     getUserAuthority(key) {
+        var _a;
         const user = this.userMap.get(key);
         if (!user) {
             return undefined;
         }
-        return user.data.getUserAccount().authority;
+        return (_a = user.data.getUserAccount()) === null || _a === void 0 ? void 0 : _a.authority;
     }
     /**
      * implements the {@link DLOBSource} interface
@@ -251,13 +262,13 @@ class UserMap {
      */
     getUniqueAuthorities(filterCriteria) {
         const usersMeetingCriteria = Array.from(this.values()).filter((user) => {
-            let pass = true;
+            const userAccount = user.getUserAccountOrThrow();
             if (filterCriteria && filterCriteria.hasOpenOrders) {
-                pass = pass && user.getUserAccount().hasOpenOrder;
+                return userAccount.hasOpenOrder;
             }
-            return pass;
+            return true;
         });
-        const userAuths = new Set(usersMeetingCriteria.map((user) => user.getUserAccount().authority.toBase58()));
+        const userAuths = new Set(usersMeetingCriteria.map((user) => user.getUserAccountOrThrow().authority.toBase58()));
         const userAuthKeys = Array.from(userAuths).map((userAuth) => new web3_js_1.PublicKey(userAuth));
         return userAuthKeys;
     }
@@ -284,7 +295,7 @@ class UserMap {
     }
     /**
      * Syncs the UserMap using the default sync method (single getProgramAccounts call with filters).
-     * This method may fail when drift has too many users. (nodejs response size limits)
+     * This method may fail when velocity has too many users. (nodejs response size limits)
      * @returns
      */
     async defaultSync() {
@@ -357,7 +368,7 @@ class UserMap {
     }
     /**
      * Syncs the UserMap using the paginated sync method (multiple getMultipleAccounts calls with filters).
-     * This method is more reliable when drift has many users.
+     * This method is more reliable when velocity has many users.
      * @returns
      */
     async paginatedSync() {
@@ -445,9 +456,7 @@ class UserMap {
             }
         }
         finally {
-            if (this.syncPromiseResolver) {
-                this.syncPromiseResolver();
-            }
+            this.syncPromiseResolver();
             this.syncPromise = undefined;
         }
     }

package/lib/browser/userMap/userMapConfig.d.ts

@@ -1,7 +1,6 @@
 import { Commitment, Connection, MemcmpFilter } from '@solana/web3.js';
 import { VelocityClient } from '../velocityClient';
 import { GrpcConfigs } from '../accounts/types';
-import { AtLeastOne } from '../util/deprecatedAlias';
 export type UserAccountFilterCriteria = {
     hasOpenOrders: boolean;
 };
@@ -38,5 +37,7 @@ type UserMapConfigBase = {
     filterByPoolId?: number;
     additionalFilters?: MemcmpFilter[];
 };
-export type UserMapConfig = UserMapConfigBase & AtLeastOne<'velocityClient', 'driftClient', VelocityClient>;
+export type UserMapConfig = UserMapConfigBase & {
+    velocityClient: VelocityClient;
+};
 export {};

package/lib/browser/userMap/userStatsMap.d.ts

@@ -12,8 +12,6 @@ export declare class UserStatsMap {
      */
     private userStatsMap;
     private velocityClient;
-    /** @deprecated Use `velocityClient` instead. `driftClient` will be removed in a future major. */
-    private get driftClient();
     private bulkAccountLoader;
     private decode;
     private syncConfig;
@@ -37,7 +35,7 @@ export declare class UserStatsMap {
     updateWithOrderRecord(record: OrderRecord, userMap: UserMap): Promise<void>;
     updateWithEventRecord(record: WrappedEvent<any>, userMap?: UserMap): Promise<void>;
     has(authorityPublicKey: string): boolean;
-    get(authorityPublicKey: string): UserStats;
+    get(authorityPublicKey: string): UserStats | undefined;
     /**
      * Enforce that a UserStats will exist for the given authorityPublicKey,
      * reading one from the blockchain if necessary.

package/lib/browser/userMap/userStatsMap.js

@@ -7,10 +7,6 @@ const bulkAccountLoader_1 = require("../accounts/bulkAccountLoader");
 const memcmp_1 = require("../memcmp");
 const web3_js_1 = require("@solana/web3.js");
 class UserStatsMap {
-    /** @deprecated Use `velocityClient` instead. `driftClient` will be removed in a future major. */
-    get driftClient() {
-        return this.velocityClient;
-    }
     /**
      * Creates a new UserStatsMap instance.
      *
@@ -18,13 +14,15 @@ class UserStatsMap {
      * @param {BulkAccountLoader} [bulkAccountLoader] - If not provided, a new BulkAccountLoader with polling disabled will be created.
      */
     constructor(velocityClient, bulkAccountLoader, syncConfig) {
+        var _a, _b;
         /**
          * map from authority pubkey to UserStats
          */
         this.userStatsMap = new Map();
+        this.syncPromiseResolver = () => { };
         this.velocityClient = velocityClient;
         if (!bulkAccountLoader) {
-            bulkAccountLoader = new bulkAccountLoader_1.BulkAccountLoader(velocityClient.connection, velocityClient.opts.commitment, 0);
+            bulkAccountLoader = new bulkAccountLoader_1.BulkAccountLoader(velocityClient.connection, (_b = (_a = velocityClient.opts) === null || _a === void 0 ? void 0 : _a.commitment) !== null && _b !== void 0 ? _b : 'confirmed', 0);
         }
         this.bulkAccountLoader = bulkAccountLoader;
         this.syncConfig = syncConfig !== null && syncConfig !== void 0 ? syncConfig : {
@@ -64,8 +62,8 @@ class UserStatsMap {
     }
     async updateWithOrderRecord(record, userMap) {
         const user = await userMap.mustGet(record.user.toString());
-        if (!this.has(user.getUserAccount().authority.toString())) {
-            await this.addUserStat(user.getUserAccount().authority, undefined, false);
+        if (!this.has(user.getUserAccountOrThrow().authority.toString())) {
+            await this.addUserStat(user.getUserAccountOrThrow().authority, undefined, false);
         }
     }
     async updateWithEventRecord(record, userMap) {
@@ -83,9 +81,9 @@ class UserStatsMap {
             }
             const liqRecord = record;
             const user = await userMap.mustGet(liqRecord.user.toString());
-            await this.mustGet(user.getUserAccount().authority.toString());
+            await this.mustGet(user.getUserAccountOrThrow().authority.toString());
             const liquidatorUser = await userMap.mustGet(liqRecord.liquidator.toString());
-            await this.mustGet(liquidatorUser.getUserAccount().authority.toString());
+            await this.mustGet(liquidatorUser.getUserAccountOrThrow().authority.toString());
         }
         else if (record.eventType === 'OrderRecord') {
             if (!userMap) {
@@ -101,11 +99,11 @@ class UserStatsMap {
             const actionRecord = record;
             if (actionRecord.taker) {
                 const taker = await userMap.mustGet(actionRecord.taker.toString());
-                await this.mustGet(taker.getUserAccount().authority.toString());
+                await this.mustGet(taker.getUserAccountOrThrow().authority.toString());
             }
             if (actionRecord.maker) {
                 const maker = await userMap.mustGet(actionRecord.maker.toString());
-                await this.mustGet(maker.getUserAccount().authority.toString());
+                await this.mustGet(maker.getUserAccountOrThrow().authority.toString());
             }
         }
         else if (record.eventType === 'SettlePnlRecord') {
@@ -114,7 +112,7 @@ class UserStatsMap {
             }
             const settlePnlRecord = record;
             const user = await userMap.mustGet(settlePnlRecord.user.toString());
-            await this.mustGet(user.getUserAccount().authority.toString());
+            await this.mustGet(user.getUserAccountOrThrow().authority.toString());
         }
         else if (record.eventType === 'NewUserRecord') {
             const newUserRecord = record;
@@ -141,7 +139,11 @@ class UserStatsMap {
         if (!this.has(authorityPublicKey)) {
             await this.addUserStat(new web3_js_1.PublicKey(authorityPublicKey), undefined, false);
         }
-        return this.get(authorityPublicKey);
+        const userStats = this.get(authorityPublicKey);
+        if (!userStats) {
+            throw new Error(`UserStatsMap: UserStats missing for authority ${authorityPublicKey} after addUserStat`);
+        }
+        return userStats;
     }
     values() {
         return this.userStatsMap.values();
@@ -220,8 +222,9 @@ class UserStatsMap {
             for (let i = 0; i < accountsToLoad.length; i += chunkSize) {
                 const chunk = accountsToLoad.slice(i, i + chunkSize);
                 tasks.push(async () => {
+                    var _a;
                     const accountInfos = await this.velocityClient.connection.getMultipleAccountsInfoAndContext(chunk, {
-                        commitment: this.velocityClient.opts.commitment,
+                        commitment: (_a = this.velocityClient.opts) === null || _a === void 0 ? void 0 : _a.commitment,
                     });
                     for (let j = 0; j < accountInfos.value.length; j += 1) {
                         const accountInfo = accountInfos.value[j];
@@ -254,9 +257,7 @@ class UserStatsMap {
             console.error(`Error in UserStatsMap.paginatedSync():`, err);
         }
         finally {
-            if (this.syncPromiseResolver) {
-                this.syncPromiseResolver();
-            }
+            this.syncPromiseResolver();
             this.syncPromise = undefined;
         }
     }

package/lib/browser/userStats.d.ts

@@ -10,8 +10,6 @@ import { UserStatsConfig } from './userStatsConfig';
 import { ReferrerInfo, UserStatsAccount } from './types';
 export declare class UserStats {
     velocityClient: VelocityClient;
-    /** @deprecated Use `velocityClient` instead. `driftClient` will be removed in a future major. */
-    get driftClient(): VelocityClient;
     userStatsAccountPublicKey: PublicKey;
     accountSubscriber: UserStatsAccountSubscriber;
     isSubscribed: boolean;
@@ -19,8 +17,13 @@ export declare class UserStats {
     subscribe(userStatsAccount?: UserStatsAccount): Promise<boolean>;
     fetchAccounts(): Promise<void>;
     unsubscribe(): Promise<void>;
-    getAccountAndSlot(): DataAndSlot<UserStatsAccount>;
-    getAccount(): UserStatsAccount;
+    getAccountAndSlot(): DataAndSlot<UserStatsAccount> | undefined;
+    getAccount(): UserStatsAccount | undefined;
+    /**
+     * Like {@link getAccount} but throws a named error instead of returning
+     * `undefined` when the stats account has not been loaded yet.
+     */
+    getAccountOrThrow(): UserStatsAccount;
     getReferrerInfo(): ReferrerInfo | undefined;
     static getOldestActionTs(account: UserStatsAccount): number;
 }

package/lib/browser/userStats.js

@@ -7,32 +7,29 @@ const webSocketUserStatsAccountSubsriber_1 = require("./accounts/webSocketUserSt
 const pda_1 = require("./addresses/pda");
 const grpcUserStatsAccountSubscriber_1 = require("./accounts/grpcUserStatsAccountSubscriber");
 class UserStats {
-    /** @deprecated Use `velocityClient` instead. `driftClient` will be removed in a future major. */
-    get driftClient() {
-        return this.velocityClient;
-    }
     constructor(config) {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+        var _a, _b, _c, _d, _e, _f, _g, _h;
+        this.isSubscribed = false;
         // Type-system guarantees at least one of the two is supplied.
-        const velocityClient = ((_a = config.velocityClient) !== null && _a !== void 0 ? _a : config.driftClient);
+        const velocityClient = config.velocityClient;
         this.velocityClient = velocityClient;
         this.userStatsAccountPublicKey = config.userStatsAccountPublicKey;
-        if (((_b = config.accountSubscription) === null || _b === void 0 ? void 0 : _b.type) === 'polling') {
+        if (((_a = config.accountSubscription) === null || _a === void 0 ? void 0 : _a.type) === 'polling') {
             this.accountSubscriber = new pollingUserStatsAccountSubscriber_1.PollingUserStatsAccountSubscriber(velocityClient.program, config.userStatsAccountPublicKey, config.accountSubscription.accountLoader);
         }
-        else if (((_c = config.accountSubscription) === null || _c === void 0 ? void 0 : _c.type) === 'grpc') {
+        else if (((_b = config.accountSubscription) === null || _b === void 0 ? void 0 : _b.type) === 'grpc') {
             this.accountSubscriber = new grpcUserStatsAccountSubscriber_1.grpcUserStatsAccountSubscriber(config.accountSubscription.grpcConfigs, velocityClient.program, config.userStatsAccountPublicKey, {
-                resubTimeoutMs: (_d = config.accountSubscription) === null || _d === void 0 ? void 0 : _d.resubTimeoutMs,
-                logResubMessages: (_e = config.accountSubscription) === null || _e === void 0 ? void 0 : _e.logResubMessages,
+                resubTimeoutMs: (_c = config.accountSubscription) === null || _c === void 0 ? void 0 : _c.resubTimeoutMs,
+                logResubMessages: (_d = config.accountSubscription) === null || _d === void 0 ? void 0 : _d.logResubMessages,
             });
         }
-        else if (((_f = config.accountSubscription) === null || _f === void 0 ? void 0 : _f.type) === 'websocket') {
+        else if (((_e = config.accountSubscription) === null || _e === void 0 ? void 0 : _e.type) === 'websocket') {
             this.accountSubscriber = new webSocketUserStatsAccountSubsriber_1.WebSocketUserStatsAccountSubscriber(velocityClient.program, config.userStatsAccountPublicKey, {
-                resubTimeoutMs: (_g = config.accountSubscription) === null || _g === void 0 ? void 0 : _g.resubTimeoutMs,
-                logResubMessages: (_h = config.accountSubscription) === null || _h === void 0 ? void 0 : _h.logResubMessages,
+                resubTimeoutMs: (_f = config.accountSubscription) === null || _f === void 0 ? void 0 : _f.resubTimeoutMs,
+                logResubMessages: (_g = config.accountSubscription) === null || _g === void 0 ? void 0 : _g.logResubMessages,
             }, config.accountSubscription.commitment);
         }
-        else if (((_j = config.accountSubscription) === null || _j === void 0 ? void 0 : _j.type) === 'custom') {
+        else if (((_h = config.accountSubscription) === null || _h === void 0 ? void 0 : _h.type) === 'custom') {
             this.accountSubscriber =
                 config.accountSubscription.userStatsAccountSubscriber;
         }
@@ -56,16 +53,29 @@ class UserStats {
         return this.accountSubscriber.getUserStatsAccountAndSlot();
     }
     getAccount() {
-        return this.accountSubscriber.getUserStatsAccountAndSlot().data;
+        var _a;
+        return (_a = this.accountSubscriber.getUserStatsAccountAndSlot()) === null || _a === void 0 ? void 0 : _a.data;
+    }
+    /**
+     * Like {@link getAccount} but throws a named error instead of returning
+     * `undefined` when the stats account has not been loaded yet.
+     */
+    getAccountOrThrow() {
+        const account = this.getAccount();
+        if (!account) {
+            throw new Error('UserStats account not loaded');
+        }
+        return account;
     }
     getReferrerInfo() {
-        if (this.getAccount().referrer.equals(web3_js_1.PublicKey.default)) {
+        const account = this.getAccount();
+        if (!account || account.referrer.equals(web3_js_1.PublicKey.default)) {
             return undefined;
         }
         else {
             return {
-                referrer: (0, pda_1.getUserAccountPublicKeySync)(this.velocityClient.program.programId, this.getAccount().referrer, 0),
-                referrerStats: (0, pda_1.getUserStatsAccountPublicKey)(this.velocityClient.program.programId, this.getAccount().referrer),
+                referrer: (0, pda_1.getUserAccountPublicKeySync)(this.velocityClient.program.programId, account.referrer, 0),
+                referrerStats: (0, pda_1.getUserStatsAccountPublicKey)(this.velocityClient.program.programId, account.referrer),
             };
         }
     }

package/lib/browser/userStatsConfig.d.ts

@@ -2,12 +2,13 @@ import { VelocityClient } from './velocityClient';
 import { Commitment, PublicKey } from '@solana/web3.js';
 import { BulkAccountLoader } from './accounts/bulkAccountLoader';
 import { GrpcConfigs, UserStatsAccountSubscriber } from './accounts/types';
-import { AtLeastOne } from './util/deprecatedAlias';
 type UserStatsConfigBase = {
     accountSubscription?: UserStatsSubscriptionConfig;
     userStatsAccountPublicKey: PublicKey;
 };
-export type UserStatsConfig = UserStatsConfigBase & AtLeastOne<'velocityClient', 'driftClient', VelocityClient>;
+export type UserStatsConfig = UserStatsConfigBase & {
+    velocityClient: VelocityClient;
+};
 export type UserStatsSubscriptionConfig = {
     type: 'websocket';
     resubTimeoutMs?: number;