@velocity-exchange/sdk 0.4.0 → 0.6.0

package/src/accounts/pollingOracleAccountSubscriber.ts

@@ -1,151 +0,0 @@
-import {
-	DataAndSlot,
-	NotSubscribedError,
-	OracleEvents,
-	OracleAccountSubscriber,
-} from './types';
-import StrictEventEmitter from 'strict-event-emitter-types';
-import { EventEmitter } from 'events';
-import { PublicKey } from '@solana/web3.js';
-import { BulkAccountLoader } from './bulkAccountLoader';
-import { OracleClient, OraclePriceData } from '../oracles/types';
-
-/** Tracks a single oracle account's decoded `OraclePriceData` via a shared `BulkAccountLoader`, decoding raw buffers with the source-appropriate `OracleClient` (Pyth/Switchboard/quote-asset/etc.). */
-export class PollingOracleAccountSubscriber implements OracleAccountSubscriber {
-	isSubscribed: boolean;
-	eventEmitter: StrictEventEmitter<EventEmitter, OracleEvents>;
-	publicKey: PublicKey;
-
-	accountLoader: BulkAccountLoader;
-	oracleClient: OracleClient;
-	callbackId?: string;
-	errorCallbackId?: string;
-
-	oraclePriceData?: DataAndSlot<OraclePriceData>;
-
-	/**
-	 * @param publicKey Address of the oracle account to track.
-	 * @param oracleClient Source-specific decoder (Pyth/Switchboard/quote-asset/etc.) used to parse the raw buffer into `OraclePriceData`.
-	 * @param accountLoader Shared `BulkAccountLoader` this subscriber registers its callback with.
-	 */
-	public constructor(
-		publicKey: PublicKey,
-		oracleClient: OracleClient,
-		accountLoader: BulkAccountLoader
-	) {
-		this.isSubscribed = false;
-		this.publicKey = publicKey;
-		this.oracleClient = oracleClient;
-		this.accountLoader = accountLoader;
-		this.eventEmitter = new EventEmitter();
-	}
-
-	/**
-	 * Registers this account with the shared `BulkAccountLoader`, then polls up to 5 times
-	 * (once per `load()` cycle) until data has loaded, since the oracle 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 oracle data loaded within the retry budget, `false` otherwise.
-	 */
-	async subscribe(): Promise<boolean> {
-		if (this.isSubscribed) {
-			return true;
-		}
-
-		await this.addToAccountLoader();
-
-		let subscriptionSucceeded = false;
-		let retries = 0;
-		while (!subscriptionSucceeded && retries < 5) {
-			await this.fetch();
-			subscriptionSucceeded = this.didSubscriptionSucceed();
-			retries++;
-		}
-
-		if (subscriptionSucceeded) {
-			this.eventEmitter.emit('update');
-		}
-
-		this.isSubscribed = subscriptionSucceeded;
-		return subscriptionSucceeded;
-	}
-
-	/** Registers this account and an error callback with the `BulkAccountLoader`. A no-op if already registered. */
-	async addToAccountLoader(): Promise<void> {
-		if (this.callbackId) {
-			return;
-		}
-
-		this.callbackId = await this.accountLoader.addAccount(
-			this.publicKey,
-			(buffer, slot) => {
-				const oraclePriceData =
-					this.oracleClient.getOraclePriceDataFromBuffer(buffer);
-				this.oraclePriceData = { data: oraclePriceData, slot };
-				// @ts-ignore
-				this.eventEmitter.emit('oracleUpdate', oraclePriceData);
-				this.eventEmitter.emit('update');
-			}
-		);
-
-		this.errorCallbackId = this.accountLoader.addErrorCallbacks((error) => {
-			this.eventEmitter.emit('error', error);
-		});
-	}
-
-	/** Forces the shared `BulkAccountLoader` to load, then decodes 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(): Promise<void> {
-		await this.accountLoader.load();
-		const bufferAndSlot = this.accountLoader.getBufferAndSlot(this.publicKey);
-		if (!bufferAndSlot) {
-			return;
-		}
-		const { buffer, slot } = bufferAndSlot;
-		if (!buffer) {
-			return;
-		}
-		this.oraclePriceData = {
-			data: await this.oracleClient.getOraclePriceDataFromBuffer(buffer),
-			slot,
-		};
-	}
-
-	/** Unregisters this account (and its error callback) from the `BulkAccountLoader`. A no-op if not subscribed. */
-	async unsubscribe(): Promise<void> {
-		if (!this.isSubscribed) {
-			return;
-		}
-
-		if (this.callbackId) {
-			this.accountLoader.removeAccount(this.publicKey, this.callbackId);
-			this.callbackId = undefined;
-		}
-
-		if (this.errorCallbackId) {
-			this.accountLoader.removeErrorCallbacks(this.errorCallbackId);
-			this.errorCallbackId = undefined;
-		}
-
-		this.isSubscribed = false;
-	}
-
-	/** Throws `NotSubscribedError` if `subscribe()` has not been called. */
-	assertIsSubscribed(): void {
-		if (!this.isSubscribed) {
-			throw new NotSubscribedError(
-				'You must call `subscribe` before using this function'
-			);
-		}
-	}
-
-	/** Throws `NotSubscribedError` if not subscribed. */
-	public getOraclePriceData(): DataAndSlot<OraclePriceData> {
-		this.assertIsSubscribed();
-		return this.oraclePriceData!;
-	}
-
-	/** True once oracle data has been loaded, independent of `isSubscribed`. */
-	didSubscriptionSucceed(): boolean {
-		return !!this.oraclePriceData;
-	}
-}

package/src/accounts/pollingTokenAccountSubscriber.ts

@@ -1,147 +0,0 @@
-import {
-	DataAndSlot,
-	NotSubscribedError,
-	TokenAccountEvents,
-	TokenAccountSubscriber,
-} from './types';
-import StrictEventEmitter from 'strict-event-emitter-types';
-import { EventEmitter } from 'events';
-import { PublicKey } from '@solana/web3.js';
-import { BulkAccountLoader } from './bulkAccountLoader';
-import { Account } from '@solana/spl-token';
-import { parseTokenAccount } from '../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.
- */
-export class PollingTokenAccountSubscriber implements TokenAccountSubscriber {
-	isSubscribed: boolean;
-	eventEmitter: StrictEventEmitter<EventEmitter, TokenAccountEvents>;
-	publicKey: PublicKey;
-
-	accountLoader: BulkAccountLoader;
-	callbackId?: string;
-	errorCallbackId?: string;
-
-	tokenAccountAndSlot?: DataAndSlot<Account>;
-
-	/**
-	 * @param publicKey Address of the SPL token account to track.
-	 * @param accountLoader Shared `BulkAccountLoader` this subscriber registers its callback with.
-	 */
-	public constructor(publicKey: PublicKey, accountLoader: BulkAccountLoader) {
-		this.isSubscribed = false;
-		this.publicKey = publicKey;
-		this.accountLoader = accountLoader;
-		this.eventEmitter = new 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(): Promise<boolean> {
-		if (this.isSubscribed) {
-			return true;
-		}
-
-		await this.addToAccountLoader();
-		let subscriptionSucceeded = false;
-		let retries = 0;
-		while (!subscriptionSucceeded && retries < 5) {
-			await this.fetch();
-			subscriptionSucceeded = this.didSubscriptionSucceed();
-			retries++;
-		}
-
-		if (subscriptionSucceeded) {
-			this.eventEmitter.emit('update');
-		}
-
-		this.isSubscribed = subscriptionSucceeded;
-		return subscriptionSucceeded;
-	}
-
-	/** Registers this account and an error callback with the `BulkAccountLoader`. A no-op if already registered. */
-	async addToAccountLoader(): Promise<void> {
-		if (this.callbackId) {
-			return;
-		}
-
-		this.callbackId = await this.accountLoader.addAccount(
-			this.publicKey,
-			(buffer, slot: number) => {
-				const tokenAccount = parseTokenAccount(buffer, this.publicKey);
-				this.tokenAccountAndSlot = { data: tokenAccount, slot };
-				// @ts-ignore
-				this.eventEmitter.emit('tokenAccountUpdate', tokenAccount);
-				this.eventEmitter.emit('update');
-			}
-		);
-
-		this.errorCallbackId = this.accountLoader.addErrorCallbacks((error) => {
-			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(): Promise<void> {
-		await this.accountLoader.load();
-		const bufferAndSlot = this.accountLoader.getBufferAndSlot(this.publicKey);
-		if (!bufferAndSlot) {
-			return;
-		}
-		const { buffer, slot } = bufferAndSlot;
-		if (!buffer) {
-			return;
-		}
-		this.tokenAccountAndSlot = {
-			data: parseTokenAccount(buffer, this.publicKey),
-			slot,
-		};
-	}
-
-	/** Unregisters this account (and its error callback) from the `BulkAccountLoader`. A no-op if not subscribed. */
-	async unsubscribe(): Promise<void> {
-		if (!this.isSubscribed) {
-			return;
-		}
-
-		if (this.callbackId) {
-			this.accountLoader.removeAccount(this.publicKey, this.callbackId);
-			this.callbackId = undefined;
-		}
-
-		if (this.errorCallbackId) {
-			this.accountLoader.removeErrorCallbacks(this.errorCallbackId);
-			this.errorCallbackId = undefined;
-		}
-
-		this.isSubscribed = false;
-	}
-
-	/** Throws `NotSubscribedError` if `subscribe()` has not been called. */
-	assertIsSubscribed(): void {
-		if (!this.isSubscribed) {
-			throw new NotSubscribedError(
-				'You must call `subscribe` before using this function'
-			);
-		}
-	}
-
-	/** Throws `NotSubscribedError` if not subscribed. */
-	public getTokenAccountAndSlot(): DataAndSlot<Account> {
-		this.assertIsSubscribed();
-		return this.tokenAccountAndSlot!;
-	}
-
-	/** True once account data has been loaded, independent of `isSubscribed`. */
-	didSubscriptionSucceed(): boolean {
-		return !!this.tokenAccountAndSlot;
-	}
-}

package/src/accounts/pollingUserAccountSubscriber.ts

@@ -1,198 +0,0 @@
-import {
-	DataAndSlot,
-	NotSubscribedError,
-	UserAccountEvents,
-	UserAccountSubscriber,
-} from './types';
-import { Connection } from '../bankrun/bankrunConnection';
-import StrictEventEmitter from 'strict-event-emitter-types';
-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 class PollingUserAccountSubscriber implements UserAccountSubscriber {
-	isSubscribed: boolean;
-	connection: Connection;
-	eventEmitter: StrictEventEmitter<EventEmitter, UserAccountEvents>;
-	userAccountPublicKey: PublicKey;
-
-	accountLoader: BulkAccountLoader;
-	callbackId?: string;
-	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).
-	 */
-	public constructor(
-		connection: Connection,
-		userAccountPublicKey: PublicKey,
-		accountLoader: BulkAccountLoader,
-		decode: (name: string, buffer: Buffer) => UserAccount
-	) {
-		this.isSubscribed = false;
-		this.connection = connection;
-		this.accountLoader = accountLoader;
-		this.eventEmitter = new EventEmitter();
-		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?: UserAccount): Promise<boolean> {
-		if (this.isSubscribed) {
-			return true;
-		}
-
-		if (userAccount) {
-			// `slot: 0` keeps {data, slot} atomic: a seeded account always carries a
-			// slot (0 = oldest-possible sentinel, overwritten by the first real fetch).
-			this.user = { data: userAccount, slot: 0 };
-		}
-
-		await this.addToAccountLoader();
-
-		await this.fetchIfUnloaded();
-		if (this.doesAccountExist()) {
-			this.eventEmitter.emit('update');
-		}
-
-		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(): Promise<void> {
-		if (this.callbackId) {
-			return;
-		}
-
-		this.callbackId = await this.accountLoader.addAccount(
-			this.userAccountPublicKey,
-			(buffer, slot: number) => {
-				if (!buffer) {
-					return;
-				}
-
-				if (this.user && this.user.slot > slot) {
-					return;
-				}
-
-				const account = this.decode('user', buffer);
-				this.user = { data: account, slot };
-				this.eventEmitter.emit('userAccountUpdate', account);
-				this.eventEmitter.emit('update');
-			}
-		);
-
-		this.errorCallbackId = this.accountLoader.addErrorCallbacks((error) => {
-			this.eventEmitter.emit('error', error);
-		});
-	}
-
-	/** Fetches via `fetch()` only if no data is cached yet; otherwise a no-op. */
-	async fetchIfUnloaded(): Promise<void> {
-		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(): Promise<void> {
-		try {
-			const dataAndContext = await this.connection.getAccountInfoAndContext(
-				this.userAccountPublicKey,
-				this.accountLoader.commitment
-			);
-			if (
-				dataAndContext.value !== null &&
-				dataAndContext.context.slot > (this.user?.slot ?? 0)
-			) {
-				this.user = {
-					data: this.decode('user', dataAndContext.value.data),
-					slot: dataAndContext.context.slot,
-				};
-			}
-		} catch (e) {
-			const err = e instanceof Error ? e : new Error(String(e));
-			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(): this is { user: DataAndSlot<UserAccount> } {
-		return this.user !== undefined;
-	}
-
-	/** Unregisters this account (and its error callback) from the `BulkAccountLoader`. A no-op if not subscribed. */
-	async unsubscribe(): Promise<void> {
-		if (!this.isSubscribed) {
-			return;
-		}
-
-		if (this.callbackId) {
-			this.accountLoader.removeAccount(
-				this.userAccountPublicKey,
-				this.callbackId
-			);
-			this.callbackId = undefined;
-		}
-
-		if (this.errorCallbackId) {
-			this.accountLoader.removeErrorCallbacks(this.errorCallbackId);
-			this.errorCallbackId = undefined;
-		}
-
-		this.isSubscribed = false;
-	}
-
-	/** Throws `NotSubscribedError` if `subscribe()` has not been called. */
-	assertIsSubscribed(): void {
-		if (!this.isSubscribed) {
-			throw new 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. */
-	public getUserAccountAndSlot(): DataAndSlot<UserAccount> | undefined {
-		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.
-	 */
-	public updateData(userAccount: UserAccount, slot: number): void {
-		if (!this.user || this.user.slot < slot) {
-			this.user = { data: userAccount, slot };
-			this.eventEmitter.emit('userAccountUpdate', userAccount);
-			this.eventEmitter.emit('update');
-		}
-	}
-}

package/src/accounts/pollingUserStatsAccountSubscriber.ts

@@ -1,180 +0,0 @@
-import {
-	DataAndSlot,
-	NotSubscribedError,
-	UserStatsAccountSubscriber,
-	UserStatsAccountEvents,
-} from './types';
-import { VelocityProgram } from '../config';
-import StrictEventEmitter from 'strict-event-emitter-types';
-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 class PollingUserStatsAccountSubscriber
-	implements UserStatsAccountSubscriber
-{
-	isSubscribed: boolean;
-	program: VelocityProgram;
-	eventEmitter: StrictEventEmitter<EventEmitter, UserStatsAccountEvents>;
-	userStatsAccountPublicKey: PublicKey;
-
-	accountLoader: BulkAccountLoader;
-	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.
-	 */
-	public constructor(
-		program: VelocityProgram,
-		userStatsAccountPublicKey: PublicKey,
-		accountLoader: BulkAccountLoader
-	) {
-		this.isSubscribed = false;
-		this.program = program;
-		this.accountLoader = accountLoader;
-		this.eventEmitter = new 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?: UserStatsAccount): Promise<boolean> {
-		if (this.isSubscribed) {
-			return true;
-		}
-
-		if (userStatsAccount) {
-			// `slot: 0` keeps {data, slot} atomic: a seeded account always carries a
-			// slot (0 = oldest-possible sentinel, overwritten by the first real fetch).
-			this.userStats = { data: userStatsAccount, slot: 0 };
-		}
-
-		await this.addToAccountLoader();
-
-		await this.fetchIfUnloaded();
-
-		if (this.doesAccountExist()) {
-			this.eventEmitter.emit('update');
-		}
-
-		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(): Promise<void> {
-		if (this.callbackId !== undefined) {
-			return;
-		}
-
-		this.callbackId = await this.accountLoader.addAccount(
-			this.userStatsAccountPublicKey,
-			(buffer, slot: number) => {
-				if (!buffer) {
-					return;
-				}
-
-				if (this.userStats && this.userStats.slot > slot) {
-					return;
-				}
-
-				const account = this.program.coder.accounts.decodeUnchecked(
-					'userStats',
-					buffer
-				);
-				this.userStats = { data: account, slot };
-				this.eventEmitter.emit('userStatsAccountUpdate', account);
-				this.eventEmitter.emit('update');
-			}
-		);
-
-		this.errorCallbackId = this.accountLoader.addErrorCallbacks((error) => {
-			this.eventEmitter.emit('error', error);
-		});
-	}
-
-	/** Fetches via `fetch()` only if no data is cached yet; otherwise a no-op. */
-	async fetchIfUnloaded(): Promise<void> {
-		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(): Promise<void> {
-		try {
-			const dataAndContext = await (
-				this.program.account as any
-			).userStats.fetchAndContext(
-				this.userStatsAccountPublicKey,
-				this.accountLoader.commitment
-			);
-			if (dataAndContext.context.slot > (this.userStats?.slot ?? 0)) {
-				this.userStats = {
-					data: dataAndContext.data as unknown as UserStatsAccount,
-					slot: dataAndContext.context.slot,
-				};
-			}
-		} catch (e) {
-			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(): this is { userStats: DataAndSlot<UserStatsAccount> } {
-		return this.userStats !== undefined;
-	}
-
-	/** Unregisters this account (and its error callback) from the `BulkAccountLoader`. A no-op if not subscribed. */
-	async unsubscribe(): Promise<void> {
-		if (!this.isSubscribed) {
-			return;
-		}
-
-		this.accountLoader.removeAccount(
-			this.userStatsAccountPublicKey,
-			this.callbackId
-		);
-		this.callbackId = undefined;
-
-		this.accountLoader.removeErrorCallbacks(this.errorCallbackId);
-		this.errorCallbackId = undefined;
-
-		this.isSubscribed = false;
-	}
-
-	/** Throws `NotSubscribedError` if `subscribe()` has not been called. */
-	assertIsSubscribed(): void {
-		if (!this.isSubscribed) {
-			throw new 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. */
-	public getUserStatsAccountAndSlot():
-		| DataAndSlot<UserStatsAccount>
-		| undefined {
-		this.assertIsSubscribed();
-		return this.userStats;
-	}
-}