@velocity-exchange/sdk 0.2.5 → 0.4.0

package/lib/node/accounts/pollingTokenAccountSubscriber.js

@@ -4,13 +4,29 @@ exports.PollingTokenAccountSubscriber = void 0;
 const types_1 = require("./types");
 const events_1 = require("events");
 const token_1 = require("../token");
+/**
+ * Tracks an SPL token account's parsed balance/owner via a shared `BulkAccountLoader`. Used for
+ * things like a spot market's token vault or a user's wallet token account, where a dedicated
+ * WebSocket subscription per account is unnecessary.
+ */
 class PollingTokenAccountSubscriber {
+    /**
+     * @param publicKey Address of the SPL token account to track.
+     * @param accountLoader Shared `BulkAccountLoader` this subscriber registers its callback with.
+     */
     constructor(publicKey, accountLoader) {
         this.isSubscribed = false;
         this.publicKey = publicKey;
         this.accountLoader = accountLoader;
         this.eventEmitter = new events_1.EventEmitter();
     }
+    /**
+     * Registers this account with the shared `BulkAccountLoader`, then polls up to 5 times
+     * (once per `load()` cycle) until data has loaded, since the token account may not have been
+     * fetched by the shared loader on the very first poll. `isSubscribed` is only set `true` if
+     * data loaded within those retries.
+     * @returns `true` if account data loaded within the retry budget, `false` otherwise.
+     */
     async subscribe() {
         if (this.isSubscribed) {
             return true;
@@ -29,6 +45,7 @@ class PollingTokenAccountSubscriber {
         this.isSubscribed = subscriptionSucceeded;
         return subscriptionSucceeded;
     }
+    /** Registers this account and an error callback with the `BulkAccountLoader`. A no-op if already registered. */
     async addToAccountLoader() {
         if (this.callbackId) {
             return;
@@ -44,6 +61,7 @@ class PollingTokenAccountSubscriber {
             this.eventEmitter.emit('error', error);
         });
     }
+    /** Forces the shared `BulkAccountLoader` to load, then reads and parses this account's buffer from it if present. Does not check slot ordering against the previously cached value (the loader itself already filters out stale/unchanged buffers before invoking callbacks). */
     async fetch() {
         await this.accountLoader.load();
         const bufferAndSlot = this.accountLoader.getBufferAndSlot(this.publicKey);
@@ -59,6 +77,7 @@ class PollingTokenAccountSubscriber {
             slot,
         };
     }
+    /** Unregisters this account (and its error callback) from the `BulkAccountLoader`. A no-op if not subscribed. */
     async unsubscribe() {
         if (!this.isSubscribed) {
             return;
@@ -73,15 +92,18 @@ class PollingTokenAccountSubscriber {
         }
         this.isSubscribed = false;
     }
+    /** Throws `NotSubscribedError` if `subscribe()` has not been called. */
     assertIsSubscribed() {
         if (!this.isSubscribed) {
             throw new types_1.NotSubscribedError('You must call `subscribe` before using this function');
         }
     }
+    /** Throws `NotSubscribedError` if not subscribed. */
     getTokenAccountAndSlot() {
         this.assertIsSubscribed();
         return this.tokenAccountAndSlot;
     }
+    /** True once account data has been loaded, independent of `isSubscribed`. */
     didSubscriptionSucceed() {
         return !!this.tokenAccountAndSlot;
     }

package/lib/node/accounts/pollingUserAccountSubscriber.d.ts

@@ -8,6 +8,13 @@ import { EventEmitter } from 'events';
 import { PublicKey } from '@solana/web3.js';
 import { UserAccount } from '../types';
 import { BulkAccountLoader } from './bulkAccountLoader';
+/**
+ * `UserAccountSubscriber` backed by a shared `BulkAccountLoader` instead of a dedicated
+ * WebSocket subscription. Registers a callback for the user's `UserAccount` and relies on the
+ * loader's periodic batched `getMultipleAccounts` polling to detect changes. Prefer this over
+ * `WebSocketUserAccountSubscriber` when tracking many users concurrently (e.g. a keeper watching
+ * the whole DLOB) to keep the RPC/WS connection count bounded.
+ */
 export declare class PollingUserAccountSubscriber implements UserAccountSubscriber {
     isSubscribed: boolean;
     connection: Connection;
@@ -18,17 +25,42 @@ export declare class PollingUserAccountSubscriber implements UserAccountSubscrib
     errorCallbackId?: string;
     decode: (name: string, buffer: Buffer) => UserAccount;
     user?: DataAndSlot<UserAccount>;
+    /**
+     * @param connection Connection (or bankrun-compatible shim) used for the one-off `fetch()` fallback.
+     * @param userAccountPublicKey Address of the `UserAccount` to track.
+     * @param accountLoader Shared `BulkAccountLoader` this subscriber registers its callback with.
+     * @param decode Decode function for the raw account buffer (typically the program's Anchor coder).
+     */
     constructor(connection: Connection, userAccountPublicKey: PublicKey, accountLoader: BulkAccountLoader, decode: (name: string, buffer: Buffer) => UserAccount);
+    /**
+     * Registers this account with the shared `BulkAccountLoader` and, if no data has loaded yet
+     * (from a prior fetch or the optional `userAccount` seed), performs a one-off `fetch()` so the
+     * subscriber has data before returning. Idempotent: a no-op if already subscribed.
+     * @param userAccount Optional pre-fetched account data to seed with (at slot 0) instead of an immediate fetch.
+     */
     subscribe(userAccount?: UserAccount): Promise<boolean>;
+    /** Registers this user's account and an error callback with the `BulkAccountLoader`. A no-op if already registered. */
     addToAccountLoader(): Promise<void>;
+    /** Fetches via `fetch()` only if no data is cached yet; otherwise a no-op. */
     fetchIfUnloaded(): Promise<void>;
+    /** Fetches the account once directly via RPC (independent of the account loader's poll cycle), applying it only if the response's slot is newer than what's cached. Logs and swallows errors (e.g. account not yet initialized) rather than throwing. */
     fetch(): Promise<void>;
+    /** Type predicate: true once `user` has loaded, narrowing `this.user` to non-undefined for callers that check it first. */
     doesAccountExist(): this is {
         user: DataAndSlot<UserAccount>;
     };
+    /** Unregisters this account (and its error callback) from the `BulkAccountLoader`. A no-op if not subscribed. */
     unsubscribe(): Promise<void>;
+    /** Throws `NotSubscribedError` if `subscribe()` has not been called. */
     assertIsSubscribed(): void;
+    /** Throws `NotSubscribedError` if not subscribed. Returns undefined only if subscribed but no data has loaded yet. */
     getUserAccountAndSlot(): DataAndSlot<UserAccount> | undefined;
+    /**
+     * Applies an externally-obtained account update (e.g. relayed by the SDK's `User` wrapper) if
+     * `slot` is strictly newer than the currently cached slot (equal-slot updates are ignored).
+     * @param userAccount Decoded account data to apply.
+     * @param slot Slot the data was observed at.
+     */
     updateData(userAccount: UserAccount, slot: number): void;
 }
 //# sourceMappingURL=pollingUserAccountSubscriber.d.ts.map

package/lib/node/accounts/pollingUserAccountSubscriber.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pollingUserAccountSubscriber.d.ts","sourceRoot":"","sources":["../../../src/accounts/pollingUserAccountSubscriber.ts"],"names":[],"mappings":";;;AAAA,OAAO,EACN,WAAW,EAEX,iBAAiB,EACjB,qBAAqB,EACrB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,kBAAkB,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,qBAAa,4BAA6B,YAAW,qBAAqB;IACzE,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,EAAE,UAAU,CAAC;IACvB,YAAY,EAAE,kBAAkB,CAAC,YAAY,EAAE,iBAAiB,CAAC,CAAC;IAClE,oBAAoB,EAAE,SAAS,CAAC;IAEhC,aAAa,EAAE,iBAAiB,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,WAAW,CAAC;IAEtD,IAAI,CAAC,EAAE,WAAW,CAAC,WAAW,CAAC,CAAC;gBAG/B,UAAU,EAAE,UAAU,EACtB,oBAAoB,EAAE,SAAS,EAC/B,aAAa,EAAE,iBAAiB,EAChC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,WAAW;IAUhD,SAAS,CAAC,WAAW,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAsBtD,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IA4BnC,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAMhC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAuB5B,gBAAgB,IAAI,IAAI,IAAI;QAAE,IAAI,EAAE,WAAW,CAAC,WAAW,CAAC,CAAA;KAAE;IAIxD,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBlC,kBAAkB,IAAI,IAAI;IAQnB,qBAAqB,IAAI,WAAW,CAAC,WAAW,CAAC,GAAG,SAAS;IAK7D,UAAU,CAAC,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;CAO/D"}
+{"version":3,"file":"pollingUserAccountSubscriber.d.ts","sourceRoot":"","sources":["../../../src/accounts/pollingUserAccountSubscriber.ts"],"names":[],"mappings":";;;AAAA,OAAO,EACN,WAAW,EAEX,iBAAiB,EACjB,qBAAqB,EACrB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,kBAAkB,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD;;;;;;GAMG;AACH,qBAAa,4BAA6B,YAAW,qBAAqB;IACzE,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,EAAE,UAAU,CAAC;IACvB,YAAY,EAAE,kBAAkB,CAAC,YAAY,EAAE,iBAAiB,CAAC,CAAC;IAClE,oBAAoB,EAAE,SAAS,CAAC;IAEhC,aAAa,EAAE,iBAAiB,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,WAAW,CAAC;IAEtD,IAAI,CAAC,EAAE,WAAW,CAAC,WAAW,CAAC,CAAC;IAEhC;;;;;OAKG;gBAEF,UAAU,EAAE,UAAU,EACtB,oBAAoB,EAAE,SAAS,EAC/B,aAAa,EAAE,iBAAiB,EAChC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,WAAW;IAUtD;;;;;OAKG;IACG,SAAS,CAAC,WAAW,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAsB5D,uHAAuH;IACjH,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IA4BzC,8EAA8E;IACxE,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAMtC,yPAAyP;IACnP,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAuB5B,2HAA2H;IAC3H,gBAAgB,IAAI,IAAI,IAAI;QAAE,IAAI,EAAE,WAAW,CAAC,WAAW,CAAC,CAAA;KAAE;IAI9D,iHAAiH;IAC3G,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBlC,wEAAwE;IACxE,kBAAkB,IAAI,IAAI;IAQ1B,sHAAsH;IAC/G,qBAAqB,IAAI,WAAW,CAAC,WAAW,CAAC,GAAG,SAAS;IAKpE;;;;;OAKG;IACI,UAAU,CAAC,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;CAO/D"}

package/lib/node/accounts/pollingUserAccountSubscriber.js

@@ -3,7 +3,20 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.PollingUserAccountSubscriber = void 0;
 const types_1 = require("./types");
 const events_1 = require("events");
+/**
+ * `UserAccountSubscriber` backed by a shared `BulkAccountLoader` instead of a dedicated
+ * WebSocket subscription. Registers a callback for the user's `UserAccount` and relies on the
+ * loader's periodic batched `getMultipleAccounts` polling to detect changes. Prefer this over
+ * `WebSocketUserAccountSubscriber` when tracking many users concurrently (e.g. a keeper watching
+ * the whole DLOB) to keep the RPC/WS connection count bounded.
+ */
 class PollingUserAccountSubscriber {
+    /**
+     * @param connection Connection (or bankrun-compatible shim) used for the one-off `fetch()` fallback.
+     * @param userAccountPublicKey Address of the `UserAccount` to track.
+     * @param accountLoader Shared `BulkAccountLoader` this subscriber registers its callback with.
+     * @param decode Decode function for the raw account buffer (typically the program's Anchor coder).
+     */
     constructor(connection, userAccountPublicKey, accountLoader, decode) {
         this.isSubscribed = false;
         this.connection = connection;
@@ -12,6 +25,12 @@ class PollingUserAccountSubscriber {
         this.userAccountPublicKey = userAccountPublicKey;
         this.decode = decode;
     }
+    /**
+     * Registers this account with the shared `BulkAccountLoader` and, if no data has loaded yet
+     * (from a prior fetch or the optional `userAccount` seed), performs a one-off `fetch()` so the
+     * subscriber has data before returning. Idempotent: a no-op if already subscribed.
+     * @param userAccount Optional pre-fetched account data to seed with (at slot 0) instead of an immediate fetch.
+     */
     async subscribe(userAccount) {
         if (this.isSubscribed) {
             return true;
@@ -29,6 +48,7 @@ class PollingUserAccountSubscriber {
         this.isSubscribed = true;
         return true;
     }
+    /** Registers this user's account and an error callback with the `BulkAccountLoader`. A no-op if already registered. */
     async addToAccountLoader() {
         if (this.callbackId) {
             return;
@@ -49,11 +69,13 @@ class PollingUserAccountSubscriber {
             this.eventEmitter.emit('error', error);
         });
     }
+    /** Fetches via `fetch()` only if no data is cached yet; otherwise a no-op. */
     async fetchIfUnloaded() {
         if (!this.doesAccountExist()) {
             await this.fetch();
         }
     }
+    /** Fetches the account once directly via RPC (independent of the account loader's poll cycle), applying it only if the response's slot is newer than what's cached. Logs and swallows errors (e.g. account not yet initialized) rather than throwing. */
     async fetch() {
         var _a, _b;
         try {
@@ -71,9 +93,11 @@ class PollingUserAccountSubscriber {
             console.log(`PollingUserAccountSubscriber.fetch() UserAccount does not exist: ${err.message}-${err.stack}`);
         }
     }
+    /** Type predicate: true once `user` has loaded, narrowing `this.user` to non-undefined for callers that check it first. */
     doesAccountExist() {
         return this.user !== undefined;
     }
+    /** Unregisters this account (and its error callback) from the `BulkAccountLoader`. A no-op if not subscribed. */
     async unsubscribe() {
         if (!this.isSubscribed) {
             return;
@@ -88,15 +112,23 @@ class PollingUserAccountSubscriber {
         }
         this.isSubscribed = false;
     }
+    /** Throws `NotSubscribedError` if `subscribe()` has not been called. */
     assertIsSubscribed() {
         if (!this.isSubscribed) {
             throw new types_1.NotSubscribedError('You must call `subscribe` before using this function');
         }
     }
+    /** Throws `NotSubscribedError` if not subscribed. Returns undefined only if subscribed but no data has loaded yet. */
     getUserAccountAndSlot() {
         this.assertIsSubscribed();
         return this.user;
     }
+    /**
+     * Applies an externally-obtained account update (e.g. relayed by the SDK's `User` wrapper) if
+     * `slot` is strictly newer than the currently cached slot (equal-slot updates are ignored).
+     * @param userAccount Decoded account data to apply.
+     * @param slot Slot the data was observed at.
+     */
     updateData(userAccount, slot) {
         if (!this.user || this.user.slot < slot) {
             this.user = { data: userAccount, slot };

package/lib/node/accounts/pollingUserStatsAccountSubscriber.d.ts

@@ -6,6 +6,10 @@ import { EventEmitter } from 'events';
 import { PublicKey } from '@solana/web3.js';
 import { UserStatsAccount } from '../types';
 import { BulkAccountLoader } from './bulkAccountLoader';
+/**
+ * `UserStatsAccountSubscriber` backed by a shared `BulkAccountLoader` instead of a dedicated
+ * WebSocket subscription, mirroring `PollingUserAccountSubscriber` for `UserStatsAccount`.
+ */
 export declare class PollingUserStatsAccountSubscriber implements UserStatsAccountSubscriber {
     isSubscribed: boolean;
     program: VelocityProgram;
@@ -15,16 +19,34 @@ export declare class PollingUserStatsAccountSubscriber implements UserStatsAccou
     callbackId?: string;
     errorCallbackId?: string;
     userStats?: DataAndSlot<UserStatsAccount>;
+    /**
+     * @param program Anchor program used for the one-off `fetch()` fallback and account decoding.
+     * @param userStatsAccountPublicKey Address of the `UserStatsAccount` to track.
+     * @param accountLoader Shared `BulkAccountLoader` this subscriber registers its callback with.
+     */
     constructor(program: VelocityProgram, userStatsAccountPublicKey: PublicKey, accountLoader: BulkAccountLoader);
+    /**
+     * Registers this account with the shared `BulkAccountLoader` and, if no data has loaded yet
+     * (from a prior fetch or the optional `userStatsAccount` seed), performs a one-off `fetch()`
+     * so the subscriber has data before returning. Idempotent: a no-op if already subscribed.
+     * @param userStatsAccount Optional pre-fetched account data to seed with (at slot 0) instead of an immediate fetch.
+     */
     subscribe(userStatsAccount?: UserStatsAccount): Promise<boolean>;
+    /** Registers this user stats account and an error callback with the `BulkAccountLoader`. A no-op if already registered. */
     addToAccountLoader(): Promise<void>;
+    /** Fetches via `fetch()` only if no data is cached yet; otherwise a no-op. */
     fetchIfUnloaded(): Promise<void>;
+    /** Fetches the account once directly via `program.account.userStats.fetchAndContext` (independent of the account loader's poll cycle), applying it only if the response's slot is newer than what's cached. Logs and swallows errors rather than throwing. */
     fetch(): Promise<void>;
+    /** Type predicate: true once `userStats` has loaded, narrowing `this.userStats` to non-undefined. */
     doesAccountExist(): this is {
         userStats: DataAndSlot<UserStatsAccount>;
     };
+    /** Unregisters this account (and its error callback) from the `BulkAccountLoader`. A no-op if not subscribed. */
     unsubscribe(): Promise<void>;
+    /** Throws `NotSubscribedError` if `subscribe()` has not been called. */
     assertIsSubscribed(): void;
+    /** Throws `NotSubscribedError` if not subscribed. Returns undefined only if subscribed but no data has loaded yet. */
     getUserStatsAccountAndSlot(): DataAndSlot<UserStatsAccount> | undefined;
 }
 //# sourceMappingURL=pollingUserStatsAccountSubscriber.d.ts.map

package/lib/node/accounts/pollingUserStatsAccountSubscriber.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pollingUserStatsAccountSubscriber.d.ts","sourceRoot":"","sources":["../../../src/accounts/pollingUserStatsAccountSubscriber.ts"],"names":[],"mappings":";AAAA,OAAO,EACN,WAAW,EAEX,0BAA0B,EAC1B,sBAAsB,EACtB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,kBAAkB,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,qBAAa,iCACZ,YAAW,0BAA0B;IAErC,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE,eAAe,CAAC;IACzB,YAAY,EAAE,kBAAkB,CAAC,YAAY,EAAE,sBAAsB,CAAC,CAAC;IACvE,yBAAyB,EAAE,SAAS,CAAC;IAErC,aAAa,EAAE,iBAAiB,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,SAAS,CAAC,EAAE,WAAW,CAAC,gBAAgB,CAAC,CAAC;gBAGzC,OAAO,EAAE,eAAe,EACxB,yBAAyB,EAAE,SAAS,EACpC,aAAa,EAAE,iBAAiB;IAS3B,SAAS,CAAC,gBAAgB,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;IAuBhE,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IA+BnC,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAMhC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAuB5B,gBAAgB,IAAI,IAAI,IAAI;QAAE,SAAS,EAAE,WAAW,CAAC,gBAAgB,CAAC,CAAA;KAAE;IAIlE,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBlC,kBAAkB,IAAI,IAAI;IAQnB,0BAA0B,IAC9B,WAAW,CAAC,gBAAgB,CAAC,GAC7B,SAAS;CAIZ"}
+{"version":3,"file":"pollingUserStatsAccountSubscriber.d.ts","sourceRoot":"","sources":["../../../src/accounts/pollingUserStatsAccountSubscriber.ts"],"names":[],"mappings":";AAAA,OAAO,EACN,WAAW,EAEX,0BAA0B,EAC1B,sBAAsB,EACtB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,kBAAkB,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD;;;GAGG;AACH,qBAAa,iCACZ,YAAW,0BAA0B;IAErC,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE,eAAe,CAAC;IACzB,YAAY,EAAE,kBAAkB,CAAC,YAAY,EAAE,sBAAsB,CAAC,CAAC;IACvE,yBAAyB,EAAE,SAAS,CAAC;IAErC,aAAa,EAAE,iBAAiB,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,SAAS,CAAC,EAAE,WAAW,CAAC,gBAAgB,CAAC,CAAC;IAE1C;;;;OAIG;gBAEF,OAAO,EAAE,eAAe,EACxB,yBAAyB,EAAE,SAAS,EACpC,aAAa,EAAE,iBAAiB;IASjC;;;;;OAKG;IACG,SAAS,CAAC,gBAAgB,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;IAuBtE,2HAA2H;IACrH,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IA+BzC,8EAA8E;IACxE,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAMtC,8PAA8P;IACxP,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAuB5B,qGAAqG;IACrG,gBAAgB,IAAI,IAAI,IAAI;QAAE,SAAS,EAAE,WAAW,CAAC,gBAAgB,CAAC,CAAA;KAAE;IAIxE,iHAAiH;IAC3G,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBlC,wEAAwE;IACxE,kBAAkB,IAAI,IAAI;IAQ1B,sHAAsH;IAC/G,0BAA0B,IAC9B,WAAW,CAAC,gBAAgB,CAAC,GAC7B,SAAS;CAIZ"}

package/lib/node/accounts/pollingUserStatsAccountSubscriber.js

@@ -3,7 +3,16 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.PollingUserStatsAccountSubscriber = void 0;
 const types_1 = require("./types");
 const events_1 = require("events");
+/**
+ * `UserStatsAccountSubscriber` backed by a shared `BulkAccountLoader` instead of a dedicated
+ * WebSocket subscription, mirroring `PollingUserAccountSubscriber` for `UserStatsAccount`.
+ */
 class PollingUserStatsAccountSubscriber {
+    /**
+     * @param program Anchor program used for the one-off `fetch()` fallback and account decoding.
+     * @param userStatsAccountPublicKey Address of the `UserStatsAccount` to track.
+     * @param accountLoader Shared `BulkAccountLoader` this subscriber registers its callback with.
+     */
     constructor(program, userStatsAccountPublicKey, accountLoader) {
         this.isSubscribed = false;
         this.program = program;
@@ -11,6 +20,12 @@ class PollingUserStatsAccountSubscriber {
         this.eventEmitter = new events_1.EventEmitter();
         this.userStatsAccountPublicKey = userStatsAccountPublicKey;
     }
+    /**
+     * Registers this account with the shared `BulkAccountLoader` and, if no data has loaded yet
+     * (from a prior fetch or the optional `userStatsAccount` seed), performs a one-off `fetch()`
+     * so the subscriber has data before returning. Idempotent: a no-op if already subscribed.
+     * @param userStatsAccount Optional pre-fetched account data to seed with (at slot 0) instead of an immediate fetch.
+     */
     async subscribe(userStatsAccount) {
         if (this.isSubscribed) {
             return true;
@@ -28,6 +43,7 @@ class PollingUserStatsAccountSubscriber {
         this.isSubscribed = true;
         return true;
     }
+    /** Registers this user stats account and an error callback with the `BulkAccountLoader`. A no-op if already registered. */
     async addToAccountLoader() {
         if (this.callbackId !== undefined) {
             return;
@@ -48,11 +64,13 @@ class PollingUserStatsAccountSubscriber {
             this.eventEmitter.emit('error', error);
         });
     }
+    /** Fetches via `fetch()` only if no data is cached yet; otherwise a no-op. */
     async fetchIfUnloaded() {
         if (!this.doesAccountExist()) {
             await this.fetch();
         }
     }
+    /** Fetches the account once directly via `program.account.userStats.fetchAndContext` (independent of the account loader's poll cycle), applying it only if the response's slot is newer than what's cached. Logs and swallows errors rather than throwing. */
     async fetch() {
         var _a, _b;
         try {
@@ -68,9 +86,11 @@ class PollingUserStatsAccountSubscriber {
             console.log(`PollingUserStatsAccountSubscriber.fetch() UserStatsAccount does not exist: ${e instanceof Error ? e.message : String(e)}`);
         }
     }
+    /** Type predicate: true once `userStats` has loaded, narrowing `this.userStats` to non-undefined. */
     doesAccountExist() {
         return this.userStats !== undefined;
     }
+    /** Unregisters this account (and its error callback) from the `BulkAccountLoader`. A no-op if not subscribed. */
     async unsubscribe() {
         if (!this.isSubscribed) {
             return;
@@ -81,11 +101,13 @@ class PollingUserStatsAccountSubscriber {
         this.errorCallbackId = undefined;
         this.isSubscribed = false;
     }
+    /** Throws `NotSubscribedError` if `subscribe()` has not been called. */
     assertIsSubscribed() {
         if (!this.isSubscribed) {
             throw new types_1.NotSubscribedError('You must call `subscribe` before using this function');
         }
     }
+    /** Throws `NotSubscribedError` if not subscribed. Returns undefined only if subscribed but no data has loaded yet. */
     getUserStatsAccountAndSlot() {
         this.assertIsSubscribed();
         return this.userStats;

package/lib/node/accounts/pollingVelocityClientAccountSubscriber.d.ts

@@ -8,6 +8,15 @@ import { PublicKey } from '@solana/web3.js';
 import { OracleInfo, OraclePriceData } from '../oracles/types';
 import { OracleClientCache } from '../oracles/oracleClientCache';
 import { VelocityProgram } from '../config';
+/**
+ * `VelocityClientAccountSubscriber` that batches the `State`, every tracked `PerpMarket`/
+ * `SpotMarket`, and every tracked oracle behind a single `BulkAccountLoader` instead of one
+ * WebSocket subscription per account. Cheaper on connection count at the cost of update latency
+ * bounded by the loader's poll interval. `subscribe()` retries the initial load up to 5 times
+ * before giving up (returning `false`) if the `State` account never appears — `didSubscriptionSucceed`
+ * checks only for `state`, since market/oracle data can be added incrementally afterward via
+ * `addPerpMarket`/`addSpotMarket`/`addOracle`.
+ */
 export declare class PollingVelocityClientAccountSubscriber implements VelocityClientAccountSubscriber {
     isSubscribed: boolean;
     program: VelocityProgram;
@@ -34,7 +43,23 @@ export declare class PollingVelocityClientAccountSubscriber implements VelocityC
     private isSubscribing;
     private subscriptionPromiseResolver;
     private subscriptionPromise;
+    /**
+     * @param program Anchor program used to derive PDAs, decode accounts, and resolve oracle clients.
+     * @param accountLoader Shared `BulkAccountLoader` all state/market/oracle accounts are registered with.
+     * @param perpMarketIndexes Perp market indexes to track, if `shouldFindAllMarketsAndOracles` is false.
+     * @param spotMarketIndexes Spot market indexes to track, if `shouldFindAllMarketsAndOracles` is false.
+     * @param oracleInfos Oracles to track up front, if `shouldFindAllMarketsAndOracles` is false.
+     * @param shouldFindAllMarketsAndOracles If true, `subscribe()` first discovers every market/oracle from on-chain state, ignoring the index/info args above.
+     * @param delistedMarketSetting Behavior applied to delisted perp markets/oracles after subscribing; see `DelistedMarketSetting`.
+     */
     constructor(program: VelocityProgram, accountLoader: BulkAccountLoader, perpMarketIndexes: number[], spotMarketIndexes: number[], oracleInfos: OracleInfo[], shouldFindAllMarketsAndOracles: boolean, delistedMarketSetting: DelistedMarketSetting);
+    /**
+     * Registers state/market/oracle accounts with the `BulkAccountLoader` and retries the initial
+     * load up to 5 times until the `State` account has appeared. Idempotent: a no-op if already
+     * subscribed, and concurrent calls while a subscribe is in flight share the same result via
+     * `subscriptionPromise` rather than issuing duplicate loads.
+     * @returns `true` if `State` account data loaded within the retry budget, `false` otherwise.
+     */
     subscribe(): Promise<boolean>;
     updateAccountsToPoll(): Promise<void>;
     updatePerpMarketAccountsToPoll(): Promise<boolean>;
@@ -52,25 +77,83 @@ export declare class PollingVelocityClientAccountSubscriber implements VelocityC
     private storeDecodedAccount;
     addAccountToAccountLoader(accountToPoll: AccountToPoll): Promise<void>;
     addOracleToAccountLoader(oracleToPoll: OraclesToPoll): Promise<void>;
+    /** Forces the shared `BulkAccountLoader` to load, then re-decodes every tracked state/market/oracle account from the loader's cached buffers into this subscriber's maps. */
     fetch(): Promise<void>;
+    /** True once the `State` account has loaded, independent of `isSubscribed`. Market/oracle data is not required. */
     didSubscriptionSucceed(): boolean;
+    /** Removes every tracked state/market/oracle account and the error callback from the `BulkAccountLoader`, then clears internal maps. */
     unsubscribe(): Promise<void>;
+    /**
+     * Adds a spot market (and its oracle, via `setSpotOracleMap`) to be tracked, registering it
+     * with the `BulkAccountLoader`. Idempotent: returns `true` immediately if already tracked.
+     * @param marketIndex Spot market index to start tracking.
+     */
     addSpotMarket(marketIndex: number): Promise<boolean>;
+    /**
+     * Adds a perp market (and its oracle, via `setPerpOracleMap`) to be tracked, registering it
+     * with the `BulkAccountLoader`. Idempotent: returns `true` immediately if already tracked.
+     * @param marketIndex Perp market index to start tracking.
+     */
     addPerpMarket(marketIndex: number): Promise<boolean>;
+    /**
+     * Adds an oracle to be tracked, registering it with the `BulkAccountLoader` and waiting
+     * (polling up to 3 times at `accountLoader.pollingFrequency` intervals) for it to appear in
+     * the loader's buffer map before resolving. A no-op that resolves `true` immediately for the
+     * `PublicKey.default` sentinel (quote-asset "no oracle") or an oracle already tracked.
+     * @param oracleInfo Oracle pubkey and source to start tracking.
+     */
     addOracle(oracleInfo: OracleInfo): Promise<boolean>;
     private pauseForOracleToBeAdded;
+    /** Rebuilds `perpOracleMap`/`perpOracleStringMap` from currently cached perp markets, calling `addOracle` for any oracle not yet tracked. */
     setPerpOracleMap(): Promise<void>;
+    /** Rebuilds `spotOracleMap`/`spotOracleStringMap` from currently cached spot markets, calling `addOracle` for any oracle not yet tracked. */
     setSpotOracleMap(): Promise<void>;
+    /**
+     * Applies `delistedMarketSetting` to any perp market currently `status: delisted` (and its
+     * oracle, if not shared with a live spot market): removes the `BulkAccountLoader` registration,
+     * and additionally drops the market/oracle from internal maps if the setting is `Discard`. A
+     * no-op if the setting is `Subscribe`. Throws if internal bookkeeping is inconsistent (e.g. a
+     * delisted market missing from `accountsToPoll`), which would indicate a bug rather than an
+     * expected runtime condition.
+     */
     handleDelistedMarkets(): void;
+    /** Throws `NotSubscribedError` if `subscribe()` has not been called. */
     assertIsSubscribed(): void;
+    /** Throws `NotSubscribedError` if not subscribed. */
     getStateAccountAndSlot(): DataAndSlot<StateAccount>;
+    /** Returns the cached perp market, or undefined if `marketIndex` isn't tracked (or hasn't loaded yet). Does not throw `NotSubscribedError`. */
     getMarketAccountAndSlot(marketIndex: number): DataAndSlot<PerpMarketAccount> | undefined;
+    /** Returns every currently cached perp market. Does not throw `NotSubscribedError`. */
     getMarketAccountsAndSlots(): DataAndSlot<PerpMarketAccount>[];
+    /** Returns the cached spot market, or undefined if `marketIndex` isn't tracked (or hasn't loaded yet). Does not throw `NotSubscribedError`. */
     getSpotMarketAccountAndSlot(marketIndex: number): DataAndSlot<SpotMarketAccount> | undefined;
+    /** Returns every currently cached spot market. Does not throw `NotSubscribedError`. */
     getSpotMarketAccountsAndSlots(): DataAndSlot<SpotMarketAccount>[];
+    /**
+     * Looks up cached oracle price data by oracle id (see `getOracleId`). Special-cases the
+     * quote-asset default oracle id, returning the constant `QUOTE_ORACLE_PRICE_DATA` at slot 0
+     * rather than a map lookup, since that oracle is never actually subscribed to.
+     * @param oracleId Oracle id string from `getOracleId(publicKey, source)`.
+     * @returns Cached price data/slot, or undefined if not tracked. Throws `NotSubscribedError` if not subscribed.
+     */
     getOraclePriceDataAndSlot(oracleId: string): DataAndSlot<OraclePriceData> | undefined;
+    /**
+     * Convenience lookup: resolves the oracle price data currently mapped to a perp market's
+     * oracle. If the cached market's oracle pubkey has drifted from `perpOracleMap` (e.g. an admin
+     * changed it on-chain), triggers a background `setPerpOracleMap()` refresh and still returns
+     * the (possibly stale) mapping for this call.
+     * @param marketIndex Perp market index whose oracle price to look up.
+     */
     getOraclePriceDataAndSlotForPerpMarket(marketIndex: number): DataAndSlot<OraclePriceData> | undefined;
+    /**
+     * Convenience lookup: resolves the oracle price data currently mapped to a spot market's
+     * oracle. If the cached market's oracle pubkey has drifted from `spotOracleMap`, triggers a
+     * background `setSpotOracleMap()` refresh and still returns the (possibly stale) mapping for
+     * this call.
+     * @param marketIndex Spot market index whose oracle price to look up.
+     */
     getOraclePriceDataAndSlotForSpotMarket(marketIndex: number): DataAndSlot<OraclePriceData> | undefined;
+    /** Retunes the shared `BulkAccountLoader`'s poll interval (ms) for every account it batches (affects other subscribers sharing the same loader too). */
     updateAccountLoaderPollingFrequency(pollingFrequency: number): void;
 }
 //# sourceMappingURL=pollingVelocityClientAccountSubscriber.d.ts.map

package/lib/node/accounts/pollingVelocityClientAccountSubscriber.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pollingVelocityClientAccountSubscriber.d.ts","sourceRoot":"","sources":["../../../src/accounts/pollingVelocityClientAccountSubscriber.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"pollingVelocityClientAccountSubscriber.d.ts","sourceRoot":"","sources":["../../../src/accounts/pollingVelocityClientAccountSubscriber.ts"],"names":[],"mappings":"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"}