@velocity-exchange/sdk 0.4.0 → 0.6.0

package/src/blockhashSubscriber/BlockhashSubscriber.ts

@@ -1,160 +0,0 @@
-import {
-	BlockhashWithExpiryBlockHeight,
-	Commitment,
-	Connection,
-	Context,
-} from '@solana/web3.js';
-import { BlockhashSubscriberConfig } from './types';
-
-/**
- * BlockhashSubscriber — polls `getLatestBlockhashAndContext`/`getBlockHeight`
- * on a fixed interval and caches a short history of recent blockhashes, so
- * callers can grab a recent blockhash for transaction building without an
- * RPC round-trip per transaction. Nothing is populated until `subscribe()`
- * (or a manual `updateBlockhash()`) has completed at least once — all getters
- * return `undefined`/empty before then.
- */
-export class BlockhashSubscriber {
-	private connection: Connection;
-	private isSubscribed = false;
-	private latestBlockHeight: number | undefined;
-	private latestBlockHeightContext: Context | undefined;
-	private blockhashes: Array<BlockhashWithExpiryBlockHeight> = [];
-	private updateBlockhashIntervalId: ReturnType<typeof setTimeout> | undefined;
-	private commitment: Commitment;
-	private updateIntervalMs: number;
-
-	/**
-	 * @param config Either `connection` or `rpcUrl` must be provided (a `Connection` is created from `rpcUrl` if `connection` is omitted). `commitment` defaults to `'confirmed'`; `updateIntervalMs` defaults to 1000ms.
-	 * @throws If neither `config.connection` nor `config.rpcUrl` is provided.
-	 */
-	constructor(config: BlockhashSubscriberConfig) {
-		if (!config.connection && !config.rpcUrl) {
-			throw new Error(
-				'BlockhashSubscriber requires one of connection or rpcUrl must be provided'
-			);
-		}
-		this.connection = config.connection || new Connection(config.rpcUrl!);
-		this.commitment = config.commitment ?? 'confirmed';
-		this.updateIntervalMs = config.updateIntervalMs ?? 1000;
-	}
-
-	/** @returns The number of blockhashes currently cached (not-yet-expired, per `pruneBlockhashes`). */
-	getBlockhashCacheSize(): number {
-		return this.blockhashes.length;
-	}
-
-	/**
-	 * @returns The block height as of the most recent successful poll, or
-	 * `undefined` if `subscribe()`/`updateBlockhash()` has not yet completed
-	 * successfully at least once (including if every poll so far has errored).
-	 * This value is a `getBlockHeight` snapshot taken alongside the latest
-	 * blockhash fetch — it is not guaranteed to be perfectly in sync with the
-	 * blockhash slot, only "recent as of the last poll".
-	 */
-	getLatestBlockHeight(): number | undefined {
-		return this.latestBlockHeight;
-	}
-
-	/** @returns The RPC `Context` (including `slot`) captured with the most recent successful blockhash poll, or `undefined` before the first successful poll. */
-	getLatestBlockHeightContext(): Context | undefined {
-		return this.latestBlockHeightContext;
-	}
-
-	/**
-	 * Returns the latest cached blockhash, based on an offset from the latest obtained
-	 * @param offset Offset to use, defaulting to 0
-	 * @param offsetType If 'seconds', it will use calculate the actual element offset based on the update interval; otherwise it will return a fixed index
-	 * @returns Cached blockhash at the given offset, or undefined
-	 */
-	getLatestBlockhash(
-		offset = 0,
-		offsetType: 'index' | 'seconds' = 'index'
-	): BlockhashWithExpiryBlockHeight | undefined {
-		if (this.blockhashes.length === 0) {
-			return undefined;
-		}
-
-		const elementOffset =
-			offsetType == 'seconds'
-				? Math.floor((offset * 1000) / this.updateIntervalMs)
-				: offset;
-
-		const clampedOffset = Math.max(
-			0,
-			Math.min(this.blockhashes.length - 1, elementOffset)
-		);
-
-		return this.blockhashes[this.blockhashes.length - 1 - clampedOffset];
-	}
-
-	/** Drops cached blockhashes whose `lastValidBlockHeight` is at or below `latestBlockHeight` (i.e. already expired for transaction signing). Called automatically after every `updateBlockhash`. No-ops if `latestBlockHeight` hasn't been set yet. */
-	pruneBlockhashes() {
-		if (this.latestBlockHeight !== undefined) {
-			const latestBlockHeight = this.latestBlockHeight;
-			this.blockhashes = this.blockhashes.filter(
-				(blockhash) => blockhash.lastValidBlockHeight > latestBlockHeight
-			);
-		}
-	}
-
-	/**
-	 * Fetches the latest blockhash and block height in parallel and appends
-	 * the blockhash to the cache (skipped if it's identical to the
-	 * most-recently-cached one), then prunes expired entries. Errors (e.g. RPC
-	 * failure) are caught and logged, not thrown — on error, `latestBlockHeight`
-	 * is left at its previous value, but `pruneBlockhashes()` still runs in a
-	 * `finally` block and may evict entries that expired in the meantime.
-	 */
-	async updateBlockhash() {
-		try {
-			const [resp, lastConfirmedBlockHeight] = await Promise.all([
-				this.connection.getLatestBlockhashAndContext({
-					commitment: this.commitment,
-				}),
-				this.connection.getBlockHeight({ commitment: this.commitment }),
-			]);
-			this.latestBlockHeight = lastConfirmedBlockHeight;
-			this.latestBlockHeightContext = resp.context;
-
-			// avoid caching duplicate blockhashes
-			if (this.blockhashes.length > 0) {
-				if (
-					resp.value.blockhash ===
-					this.blockhashes[this.blockhashes.length - 1].blockhash
-				) {
-					return;
-				}
-			}
-
-			this.blockhashes.push(resp.value);
-		} catch (e) {
-			console.error('Error updating blockhash:\n', e);
-		} finally {
-			this.pruneBlockhashes();
-		}
-	}
-
-	/** Performs an immediate `updateBlockhash()` and then starts polling on `updateIntervalMs`. Idempotent — a second call while already subscribed is a no-op. */
-	async subscribe() {
-		if (this.isSubscribed) {
-			return;
-		}
-		this.isSubscribed = true;
-
-		await this.updateBlockhash();
-		this.updateBlockhashIntervalId = setInterval(
-			this.updateBlockhash.bind(this),
-			this.updateIntervalMs
-		);
-	}
-
-	/** Stops the polling interval. Cached blockhashes and `latestBlockHeight` are left in place (not cleared). */
-	unsubscribe() {
-		if (this.updateBlockhashIntervalId) {
-			clearInterval(this.updateBlockhashIntervalId);
-			this.updateBlockhashIntervalId = undefined;
-		}
-		this.isSubscribed = false;
-	}
-}

package/src/blockhashSubscriber/index.ts

@@ -1,6 +0,0 @@
-/**
- * `BlockhashSubscriber` — polls and caches recent blockhashes/block heights so
- * transaction builders can grab a recent blockhash without an RPC round-trip
- * per transaction.
- */
-export * from './BlockhashSubscriber';

package/src/blockhashSubscriber/types.ts

@@ -1,13 +0,0 @@
-import { Commitment, Connection } from '@solana/web3.js';
-
-/** Configuration for `BlockhashSubscriber`. */
-export type BlockhashSubscriberConfig = {
-	/** RPC URL to poll block hashes from; a `Connection` is constructed from it if `connection` is not provided. One of `rpcUrl`/`connection` must be supplied. */
-	rpcUrl?: string;
-	/** Existing `Connection` to poll block hashes on, taking precedence over `rpcUrl` if both are given. One of `rpcUrl`/`connection` must be supplied. */
-	connection?: Connection;
-	/** Commitment level for both the blockhash and block-height polls; defaults to `'confirmed'`. */
-	commitment?: Commitment;
-	/** Poll interval in milliseconds; defaults to `1000`. */
-	updateIntervalMs?: number;
-};

package/src/clock/clockSubscriber.ts

@@ -1,146 +0,0 @@
-import { Commitment, Connection, SYSVAR_CLOCK_PUBKEY } from '@solana/web3.js';
-import { EventEmitter } from 'events';
-import StrictEventEmitter from 'strict-event-emitter-types/types/src';
-import { BN } from '../isomorphic/anchor';
-
-// eslint-disable-next-line @typescript-eslint/ban-types
-type ClockSubscriberConfig = {
-	commitment: Commitment;
-	resubTimeoutMs?: number;
-};
-
-/** Events emitted on `ClockSubscriber.eventEmitter`. */
-export interface ClockSubscriberEvent {
-	/** Fired with the new on-chain unix timestamp (seconds) whenever a strictly-newer `Clock` sysvar update is observed. */
-	clockUpdate: (ts: number) => void;
-}
-
-/**
- * ClockSubscriber — tracks the on-chain unix timestamp by subscribing to the
- * `Clock` sysvar via `connection.onAccountChange`, with an optional
- * stall-detection resubscribe. Useful for reading "on-chain now" without a
- * per-call RPC round-trip (e.g. for evaluating time-based order/auction
- * conditions the same way the program would). Nothing is populated until
- * `subscribe()` completes its first update — `currentTs`/`getUnixTs()` return
- * `undefined` until then.
- */
-export class ClockSubscriber {
-	private _latestSlot?: number;
-	private _currentTs?: number;
-	private subscriptionId?: number;
-	commitment: Commitment;
-	eventEmitter: StrictEventEmitter<EventEmitter, ClockSubscriberEvent>;
-
-	/** Slot of the most recently observed `Clock` sysvar update, or `undefined` before the first update. */
-	public get latestSlot(): number | undefined {
-		return this._latestSlot;
-	}
-
-	/** On-chain unix timestamp (seconds) as of the most recently observed `Clock` sysvar update, or `undefined` before the first update. */
-	public get currentTs(): number | undefined {
-		return this._currentTs;
-	}
-
-	// Reconnection
-	private timeoutId?: ReturnType<typeof setTimeout>;
-	private resubTimeoutMs?: number;
-	private isUnsubscribing = false;
-	private receivingData = false;
-
-	/**
-	 * @param connection RPC connection to subscribe on.
-	 * @param config.commitment Commitment for the account-change subscription; defaults to `'confirmed'`.
-	 * @param config.resubTimeoutMs If set to a positive value, resubscribe when no update arrives for this many ms; `0` (or unset) disables the resubscribe watchdog. Positive values below 1000ms log a warning but are still honored.
-	 */
-	public constructor(
-		private connection: Connection,
-		config?: ClockSubscriberConfig
-	) {
-		this.eventEmitter = new EventEmitter();
-		this.resubTimeoutMs = config?.resubTimeoutMs;
-		this.commitment = config?.commitment || 'confirmed';
-		if (this.resubTimeoutMs !== undefined && this.resubTimeoutMs < 1000) {
-			console.log(
-				'resubTimeoutMs should be at least 1000ms to avoid spamming resub'
-			);
-		}
-	}
-
-	/** Subscribes to `Clock` sysvar account changes. Unlike `SlotSubscriber`/`SlothashSubscriber`, does not perform an initial RPC fetch — `currentTs`/`latestSlot` stay `undefined` until the first account-change notification arrives. Idempotent while already subscribed. */
-	public async subscribe(): Promise<void> {
-		if (this.subscriptionId != null) {
-			return;
-		}
-
-		this.subscriptionId = this.connection.onAccountChange(
-			SYSVAR_CLOCK_PUBKEY,
-			(acctInfo, context) => {
-				if (!this.latestSlot || this.latestSlot < context.slot) {
-					if (this.resubTimeoutMs && !this.isUnsubscribing) {
-						this.receivingData = true;
-						clearTimeout(this.timeoutId);
-						this.setTimeout();
-					}
-					this._latestSlot = context.slot;
-					const currentTs = new BN(
-						acctInfo.data.subarray(32, 39),
-						undefined,
-						'le'
-					).toNumber();
-					this._currentTs = currentTs;
-					this.eventEmitter.emit('clockUpdate', currentTs);
-				}
-			},
-			this.commitment
-		);
-
-		if (this.resubTimeoutMs) {
-			this.receivingData = true;
-			this.setTimeout();
-		}
-	}
-
-	private setTimeout(): void {
-		this.timeoutId = setTimeout(async () => {
-			if (this.isUnsubscribing) {
-				// If we are in the process of unsubscribing, do not attempt to resubscribe
-				return;
-			}
-
-			if (this.receivingData) {
-				console.log(
-					`No new slot in ${this.resubTimeoutMs}ms, slot subscriber resubscribing`
-				);
-				await this.unsubscribe(true);
-				this.receivingData = false;
-				await this.subscribe();
-			}
-		}, this.resubTimeoutMs);
-	}
-
-	/** @returns The on-chain unix timestamp (seconds) as of the last update, or `undefined` if `subscribe()` hasn't received an update yet. Equivalent to the `currentTs` getter. */
-	public getUnixTs(): number | undefined {
-		return this.currentTs;
-	}
-
-	/**
-	 * Removes the `onAccountChange` listener and cancels the resub timeout.
-	 * @param onResub Internal flag used when unsubscribing as part of an automatic resubscribe cycle; when `false`, also permanently disables future auto-resubscribe by clearing `resubTimeoutMs`.
-	 */
-	public async unsubscribe(onResub = false): Promise<void> {
-		if (!onResub) {
-			this.resubTimeoutMs = undefined;
-		}
-		this.isUnsubscribing = true;
-		clearTimeout(this.timeoutId);
-		this.timeoutId = undefined;
-
-		if (this.subscriptionId != null) {
-			await this.connection.removeAccountChangeListener(this.subscriptionId);
-			this.subscriptionId = undefined;
-			this.isUnsubscribing = false;
-		} else {
-			this.isUnsubscribing = false;
-		}
-	}
-}

package/src/config.ts

@@ -1,312 +0,0 @@
-import { ConfirmOptions, PublicKey } from '@solana/web3.js';
-import {
-	isVariant,
-	OracleSource,
-	PerpMarketAccount,
-	SpotMarketAccount,
-} from './types';
-import {
-	DevnetPerpMarkets,
-	MainnetPerpMarkets,
-	PerpMarketConfig,
-	PerpMarkets,
-} from './constants/perpMarkets';
-import {
-	SpotMarketConfig,
-	SpotMarkets,
-	DevnetSpotMarkets,
-	MainnetSpotMarkets,
-} from './constants/spotMarkets';
-import { OracleInfo } from './oracles/types';
-import { Program, ProgramAccount } from './isomorphic/anchor';
-import { getOracleId } from './oracles/oracleId';
-import { Velocity } from './idl/velocity';
-
-/** The Anchor `Program` client type for the velocity IDL, parameterized over the generated `Velocity` type. */
-export type VelocityProgram = Program<Velocity>;
-
-/** Supported deployment environments. */
-export type VelocityEnv = 'devnet' | 'mainnet-beta';
-
-/** Widened env type accepted by `initialize()`; `'master'` is a legacy alias for `'devnet'`. */
-export type LegacyVelocityEnv = VelocityEnv | 'master';
-
-/** Per-environment addresses, program ids, and default market lists returned by `getConfig()`/`initialize()`. */
-export interface VelocityConfig {
-	ENV: VelocityEnv;
-	/** Legacy Pyth oracle mapping account address for this environment (push-oracle discovery; not used by pull/Lazer sources). */
-	PYTH_ORACLE_MAPPING_ADDRESS: string;
-	/** Deployed velocity program id for this environment, base58. */
-	VELOCITY_PROGRAM_ID: string;
-	/** Deployed jit-proxy program id, base58, if jit-proxy is available in this environment. */
-	JIT_PROXY_PROGRAM_ID?: string;
-	/** Velocity's oracle-receiver program id (verifies/receives pushed oracle updates), base58. */
-	VELOCITY_ORACLE_RECEIVER_ID: string;
-	/** Mint address of the protocol's quote asset (e.g. USDC) for this environment, base58. */
-	QUOTE_MINT_ADDRESS: string;
-	/** Mint address of the legacy v2-alpha ticket token for this environment, base58. */
-	V2_ALPHA_TICKET_MINT_ADDRESS: string;
-	/** Default perp market configs to subscribe to when the caller doesn't supply an explicit list. */
-	PERP_MARKETS: PerpMarketConfig[];
-	/** Default spot market configs to subscribe to when the caller doesn't supply an explicit list. */
-	SPOT_MARKETS: SpotMarketConfig[];
-	/** @deprecated use MARKET_LOOKUP_TABLES */
-	MARKET_LOOKUP_TABLE: string;
-	/** Address lookup table accounts (base58) used to fit market/oracle accounts into versioned transactions. */
-	MARKET_LOOKUP_TABLES: string[];
-	/** Deployed Switchboard On-Demand program id for this environment. */
-	SB_ON_DEMAND_PID: PublicKey;
-}
-
-/** Mainnet-beta velocity program id, base58. */
-export const VELOCITY_PROGRAM_ID =
-	'vELoC1audYbSYVRXn1vPaV8Axoa9oU6BYmNGZZBDZ1P';
-
-/** Devnet velocity program id, base58. */
-export const VELOCITY_DEVNET_PROGRAM_ID =
-	'vELoC1audYbSYVRXn1vPaV8Axoa9oU6BYmNGZZBDZ1P';
-
-/** Velocity's oracle-receiver program id, base58 (same across devnet and mainnet-beta). */
-export const VELOCITY_ORACLE_RECEIVER_ID =
-	'G6EoTTTgpkNBtVXo96EQp2m6uwwVh2Kt6YidjkmQqoha';
-
-/** Pyth Lazer program id, base58. */
-export const PYTH_LAZER_PROGRAM_ID =
-	'pytd2yyk641x7ak7mkaasSJVXh6YYZnC7wTmtgAyxPt';
-
-/** Switchboard On-Demand program id on devnet. */
-export const SB_ON_DEMAND_DEVNET_PID = new PublicKey(
-	'Aio4gaXjXzJNVLtzwtNVmSqGKpANtXhybbkhtAC94ji2'
-);
-/** Switchboard On-Demand program id on mainnet-beta. */
-export const SB_ON_DEMAND_MAINNET_PID = new PublicKey(
-	'SBondMDrcV3K4kxZR1HNVT7osZxAHVHgYXL5Ze1oMUv'
-);
-/** Pyth Lazer storage account holding feed metadata, shared across environments. */
-export const PYTH_LAZER_STORAGE_ACCOUNT_KEY = new PublicKey(
-	'3rdJbqfnagQ4yx9HXJViD4zc4xpiSqmFsKpPuSCQVyQL'
-);
-
-/** Default `ConfirmOptions` (both preflight and confirmation at `'confirmed'` commitment) used across the SDK's tx senders unless overridden. */
-export const DEFAULT_CONFIRMATION_OPTS: ConfirmOptions = {
-	preflightCommitment: 'confirmed',
-	commitment: 'confirmed',
-};
-
-/** Built-in `VelocityConfig` presets for each supported environment. */
-export const configs: { [key in VelocityEnv]: VelocityConfig } = {
-	devnet: {
-		ENV: 'devnet',
-		PYTH_ORACLE_MAPPING_ADDRESS: 'BmA9Z6FjioHJPpjT39QazZyhDRUdZy2ezwx4GiDdE2u2',
-		VELOCITY_PROGRAM_ID: VELOCITY_DEVNET_PROGRAM_ID,
-		JIT_PROXY_PROGRAM_ID: 'J1TnP8zvVxbtF5KFp5xRmWuvG9McnhzmBd9XGfCyuxFP',
-		QUOTE_MINT_ADDRESS: 'GqmEqYsy8EyvofDpmtFxK8zhYrgWgNokAtYoduQdL7v6',
-		V2_ALPHA_TICKET_MINT_ADDRESS:
-			'DeEiGWfCMP9psnLGkxGrBBMEAW5Jv8bBGMN8DCtFRCyB',
-		PERP_MARKETS: DevnetPerpMarkets,
-		SPOT_MARKETS: DevnetSpotMarkets,
-		/** @deprecated use MARKET_LOOKUP_TABLES */
-		MARKET_LOOKUP_TABLE: 'FaMS3U4uBojvGn5FSDEPimddcXsCfwkKsFgMVVnDdxGb',
-		MARKET_LOOKUP_TABLES: ['FaMS3U4uBojvGn5FSDEPimddcXsCfwkKsFgMVVnDdxGb'],
-		VELOCITY_ORACLE_RECEIVER_ID,
-		SB_ON_DEMAND_PID: SB_ON_DEMAND_DEVNET_PID,
-	},
-	'mainnet-beta': {
-		ENV: 'mainnet-beta',
-		PYTH_ORACLE_MAPPING_ADDRESS: 'AHtgzX45WTKfkPG53L6WYhGEXwQkN1BVknET3sVsLL8J',
-		VELOCITY_PROGRAM_ID,
-		JIT_PROXY_PROGRAM_ID: 'J1TnP8zvVxbtF5KFp5xRmWuvG9McnhzmBd9XGfCyuxFP',
-		// Relaunch quote market (spot 0) is USDT — see
-		// deploy-scripts/params/relaunch-spot-markets.json.
-		QUOTE_MINT_ADDRESS: 'Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB',
-		V2_ALPHA_TICKET_MINT_ADDRESS:
-			'Cmvhycb6LQvvzaShGw4iDHRLzeSSryioAsU98DSSkMNa',
-		PERP_MARKETS: MainnetPerpMarkets,
-		SPOT_MARKETS: MainnetSpotMarkets,
-		/** @deprecated use MARKET_LOOKUP_TABLES */
-		MARKET_LOOKUP_TABLE: 'Fpys8GRa5RBWfyeN7AaDUwFGD1zkDCA4z3t4CJLV8dfL',
-		MARKET_LOOKUP_TABLES: [
-			'Fpys8GRa5RBWfyeN7AaDUwFGD1zkDCA4z3t4CJLV8dfL',
-			'EiWSskK5HXnBTptiS5DH6gpAJRVNQ3cAhTKBGaiaysAb',
-		],
-		VELOCITY_ORACLE_RECEIVER_ID,
-		SB_ON_DEMAND_PID: SB_ON_DEMAND_MAINNET_PID,
-	},
-};
-
-/** Module-level active config; defaults to the `devnet` preset until `initialize()` is called. */
-let currentConfig: VelocityConfig = configs.devnet;
-
-/**
- * Returns the SDK's currently active `VelocityConfig` (the `devnet` preset by default, or
- * whatever was last set via `initialize()`).
- * @returns The active config.
- */
-export const getConfig = (): VelocityConfig => currentConfig;
-
-/**
- * Sets the SDK's active environment/config, read thereafter via `getConfig()`. This mutates
- * process-wide module state — call it once at startup before constructing clients, not
- * concurrently with multiple environments in the same process.
- *
- * Defaults to the `devnet` preset if you never call this function.
- * @param props.env - Environment to activate; `'master'` is accepted as a legacy alias for `'devnet'`.
- * @param props.overrideEnv - Partial fields to overlay on top of the selected preset (e.g. a custom `VELOCITY_PROGRAM_ID`).
- * @returns The resulting active `VelocityConfig` (preset merged with `overrideEnv`).
- */
-export const initialize = (props: {
-	env: LegacyVelocityEnv;
-	overrideEnv?: Partial<VelocityConfig>;
-}): VelocityConfig => {
-	const override = props.overrideEnv ?? {};
-	const normalizedEnv: VelocityEnv =
-		props.env === 'master' ? 'devnet' : props.env;
-
-	currentConfig = { ...configs[normalizedEnv], ...override };
-	return currentConfig;
-};
-
-/**
- * Whether the SDK can construct an `OracleClient` for `source` — mirrors the throwing branches in
- * `getOracleClient`. Markets whose oracle source is unsupported (retired Switchboard feeds and
- * removed Pyth pull feeds) are still listed/indexed, but their oracles must not be added to
- * subscription lists, since building a client for them throws and would abort the whole subscribe.
- */
-function isOracleSourceSubscribable(source: OracleSource): boolean {
-	return !(
-		isVariant(source, 'deprecatedSwitchboard') ||
-		isVariant(source, 'deprecatedSwitchboardOnDemand') ||
-		isVariant(source, 'pythPull') ||
-		isVariant(source, 'pyth1KPull') ||
-		isVariant(source, 'pyth1MPull') ||
-		isVariant(source, 'pythStableCoinPull')
-	);
-}
-
-/**
- * Builds the market-index and oracle-subscription lists a `VelocityClient` needs to subscribe to,
- * from static market configs (no RPC calls) — the fast, offline alternative to
- * `findAllMarketAndOracles`. Oracles are de-duplicated by `getOracleId` (pubkey + source), so a
- * pubkey shared across multiple markets under the same source only appears once.
- * @param env - Environment whose built-in market lists (`PerpMarkets[env]`/`SpotMarkets[env]`) are
- * used as the fallback when `perpMarkets`/`spotMarkets` aren't supplied.
- * @param perpMarkets - Explicit perp market configs to use instead of the environment default; if
- * omitted or empty, falls back to `PerpMarkets[env]`.
- * @param spotMarkets - Explicit spot market configs to use instead of the environment default; if
- * omitted or empty, falls back to `SpotMarkets[env]`.
- * @returns `perpMarketIndexes`/`spotMarketIndexes` for every market considered, and the
- * de-duplicated `oracleInfos` needed to subscribe to their oracles.
- */
-export function getMarketsAndOraclesForSubscription(
-	env: VelocityEnv,
-	perpMarkets?: PerpMarketConfig[],
-	spotMarkets?: SpotMarketConfig[]
-): {
-	perpMarketIndexes: number[];
-	spotMarketIndexes: number[];
-	oracleInfos: OracleInfo[];
-} {
-	const perpMarketsToUse =
-		perpMarkets !== undefined && perpMarkets.length > 0
-			? perpMarkets
-			: PerpMarkets[env];
-	const spotMarketsToUse =
-		spotMarkets !== undefined && spotMarkets.length > 0
-			? spotMarkets
-			: SpotMarkets[env];
-
-	const perpMarketIndexes = [];
-	const spotMarketIndexes = [];
-	const oracleInfos = new Map<string, OracleInfo>();
-
-	for (const market of perpMarketsToUse) {
-		perpMarketIndexes.push(market.marketIndex);
-		if (isOracleSourceSubscribable(market.oracleSource)) {
-			oracleInfos.set(getOracleId(market.oracle, market.oracleSource), {
-				publicKey: market.oracle,
-				source: market.oracleSource,
-			});
-		}
-	}
-
-	for (const spotMarket of spotMarketsToUse) {
-		spotMarketIndexes.push(spotMarket.marketIndex);
-		if (isOracleSourceSubscribable(spotMarket.oracleSource)) {
-			oracleInfos.set(getOracleId(spotMarket.oracle, spotMarket.oracleSource), {
-				publicKey: spotMarket.oracle,
-				source: spotMarket.oracleSource,
-			});
-		}
-	}
-
-	return {
-		perpMarketIndexes: perpMarketIndexes,
-		spotMarketIndexes: spotMarketIndexes,
-		oracleInfos: Array.from(oracleInfos.values()),
-	};
-}
-
-/**
- * Discovers every perp/spot market currently deployed under `program`'s program id via
- * `getProgramAccounts` (`perpMarket.all()`/`spotMarket.all()`), rather than relying on a static
- * config list — use this to pick up markets added after the SDK's bundled configs were published,
- * or when running against a custom/unlisted deployment. Oracles are de-duplicated by `getOracleId`
- * (pubkey + source).
- * @param program - Anchor program client used to fetch all `PerpMarket`/`SpotMarket` accounts.
- * @returns Market indexes and full decoded accounts for every discovered perp/spot market, plus
- * the de-duplicated `oracleInfos` needed to subscribe to their oracles.
- */
-export async function findAllMarketAndOracles(
-	program: VelocityProgram
-): Promise<{
-	perpMarketIndexes: number[];
-	perpMarketAccounts: PerpMarketAccount[];
-	spotMarketIndexes: number[];
-	oracleInfos: OracleInfo[];
-	spotMarketAccounts: SpotMarketAccount[];
-}> {
-	const perpMarketIndexes = [];
-	const spotMarketIndexes = [];
-	const oracleInfos = new Map<string, OracleInfo>();
-
-	const perpMarketProgramAccounts = (await (
-		program.account as any
-	).perpMarket.all()) as ProgramAccount<PerpMarketAccount>[];
-	const spotMarketProgramAccounts = (await (
-		program.account as any
-	).spotMarket.all()) as ProgramAccount<SpotMarketAccount>[];
-
-	for (const perpMarketProgramAccount of perpMarketProgramAccounts) {
-		const perpMarket = perpMarketProgramAccount.account as PerpMarketAccount;
-		perpMarketIndexes.push(perpMarket.marketIndex);
-		if (isOracleSourceSubscribable(perpMarket.oracleSource)) {
-			oracleInfos.set(getOracleId(perpMarket.oracle, perpMarket.oracleSource), {
-				publicKey: perpMarket.oracle,
-				source: perpMarket.oracleSource,
-			});
-		}
-	}
-
-	for (const spotMarketProgramAccount of spotMarketProgramAccounts) {
-		const spotMarket = spotMarketProgramAccount.account as SpotMarketAccount;
-		spotMarketIndexes.push(spotMarket.marketIndex);
-		if (isOracleSourceSubscribable(spotMarket.oracleSource)) {
-			oracleInfos.set(getOracleId(spotMarket.oracle, spotMarket.oracleSource), {
-				publicKey: spotMarket.oracle,
-				source: spotMarket.oracleSource,
-			});
-		}
-	}
-
-	return {
-		perpMarketIndexes,
-		perpMarketAccounts: perpMarketProgramAccounts.map(
-			(account) => account.account
-		),
-		spotMarketIndexes,
-		spotMarketAccounts: spotMarketProgramAccounts.map(
-			(account) => account.account
-		),
-		oracleInfos: Array.from(oracleInfos.values()),
-	};
-}

package/src/constants/index.ts

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