@velocity-exchange/sdk 0.4.0 → 0.6.0

package/src/math/utils.ts

@@ -1,183 +0,0 @@
-import { BN } from '../isomorphic/anchor';
-import { ONE, ZERO } from '../constants/numericConstants';
-
-/**
- * Clamps `x` to the inclusive range `[min, max]`.
- *
- * @param {BN} x - The value to clamp
- * @param {BN} min - The lower bound
- * @param {BN} max - The upper bound
- * @return {BN} `x` if within range, otherwise `min` or `max`
- */
-export function clampBN(x: BN, min: BN, max: BN): BN {
-	return BN.max(min, BN.min(x, max));
-}
-
-/**
- * Integer square root via binary recursion, floored to the nearest integer (i.e.
- * `squareRootBN(n) === Math.floor(Math.sqrt(n))` for values representable as a double). Used
- * throughout the AMM math wherever the program takes an integer sqrt of the constant-product
- * invariant.
- *
- * @param {BN} n - A non-negative integer
- * @return {BN} `floor(sqrt(n))`
- * @throws {Error} If `n` is negative
- */
-export const squareRootBN = (n: BN): BN => {
-	if (n.lt(new BN(0))) {
-		throw new Error('Sqrt only works on non-negtiave inputs');
-	}
-	if (n.lt(new BN(2))) {
-		return n;
-	}
-
-	const smallCand = squareRootBN(n.shrn(2)).shln(1);
-	const largeCand = smallCand.add(new BN(1));
-
-	if (largeCand.mul(largeCand).gt(n)) {
-		return smallCand;
-	} else {
-		return largeCand;
-	}
-};
-
-/**
- * Integer division rounded up (ceiling), mirroring the program's unsigned `safe_div_ceil` (e.g.
- * used for borrow token amounts, where rounding up favors the protocol/lenders over the
- * borrower). Only meaningful for non-negative operands — `bn.js`'s `.mod()` returns a remainder
- * with the sign of the dividend, so this is not a general-purpose ceiling division for signed
- * inputs.
- *
- * @param {BN} a - The dividend (expected non-negative)
- * @param {BN} b - The divisor (expected positive)
- * @return {BN} `ceil(a / b)`
- */
-export const divCeil = (a: BN, b: BN): BN => {
-	const quotient = a.div(b);
-
-	const remainder = a.mod(b);
-
-	if (remainder.gt(ZERO)) {
-		return quotient.add(ONE);
-	} else {
-		return quotient;
-	}
-};
-
-/**
- * Sign function returning ±1 (never 0).
- *
- * @param {BN} x - The value to test
- * @return {BN} `-1` if `x` is negative, otherwise `1` (including for zero)
- */
-export const sigNum = (x: BN): BN => {
-	return x.isNeg() ? new BN(-1) : new BN(1);
-};
-
-/**
- * Calculates the time remaining until the next update is eligible under a rounded, "on-the-hour"
- * update schedule. Used for perp funding rate updates and revenue-to-insurance-fund sweeps: if the
- * last update landed within 1/3 of `updatePeriod` of an hour boundary, the next update is allowed
- * on that boundary; otherwise it's pushed to the following boundary (two periods out) to avoid
- * drifting the schedule off-hour. Returns zero once the wait has already elapsed.
- *
- * @param {BN} now - Current unix timestamp, seconds
- * @param {BN} lastUpdateTs - Unix timestamp of the last update, seconds
- * @param {BN} updatePeriod - Desired interval between updates, seconds
- * @return {BN} Seconds remaining until the next update is eligible (zero if already due)
- */
-export function timeRemainingUntilUpdate(
-	now: BN,
-	lastUpdateTs: BN,
-	updatePeriod: BN
-): BN {
-	const timeSinceLastUpdate = now.sub(lastUpdateTs);
-
-	// round next update time to be available on the hour
-	let nextUpdateWait = updatePeriod;
-	if (updatePeriod.gt(new BN(1))) {
-		const lastUpdateDelay = lastUpdateTs.umod(updatePeriod);
-		if (!lastUpdateDelay.isZero()) {
-			const maxDelayForNextPeriod = updatePeriod.div(new BN(3));
-
-			const twoFundingPeriods = updatePeriod.mul(new BN(2));
-
-			if (lastUpdateDelay.gt(maxDelayForNextPeriod)) {
-				// too late for on the hour next period, delay to following period
-				nextUpdateWait = twoFundingPeriods.sub(lastUpdateDelay);
-			} else {
-				// allow update on the hour
-				nextUpdateWait = updatePeriod.sub(lastUpdateDelay);
-			}
-
-			if (nextUpdateWait.gt(twoFundingPeriods)) {
-				nextUpdateWait = nextUpdateWait.sub(updatePeriod);
-			}
-		}
-	}
-	const timeRemainingUntilUpdate = nextUpdateWait
-		.sub(timeSinceLastUpdate)
-		.isNeg()
-		? ZERO
-		: nextUpdateWait.sub(timeSinceLastUpdate);
-
-	return timeRemainingUntilUpdate;
-}
-
-/**
- * Compares two date strings for equality by calendar day (year/month/date), ignoring
- * time-of-day. Uses the local `getDate()`/`getMonth()`/`getFullYear()` getters, so the
- * comparison is against the process's local-timezone calendar day (not UTC).
- *
- * @param {string} dateString1 - A date string parseable by `new Date()`
- * @param {string} dateString2 - A date string parseable by `new Date()`
- * @return {boolean} Whether both parse to the same calendar day
- */
-export const checkSameDate = (dateString1: string, dateString2: string) => {
-	const date1 = new Date(dateString1);
-	const date2 = new Date(dateString2);
-
-	const isSameDate =
-		date1.getDate() === date2.getDate() &&
-		date1.getMonth() === date2.getMonth() &&
-		date1.getFullYear() === date2.getFullYear();
-
-	return isSameDate;
-};
-
-/**
- * True if `number` is within `Number.MAX_SAFE_INTEGER` (2^53 - 1), i.e. safe to convert to a
- * `BN` via a JS `number` without losing precision.
- *
- * @param {number} number - The value to check (typically already multiplied by a target precision)
- * @return {boolean} Whether `number` can be represented exactly as a JS number
- */
-export function isBNSafe(number: number): boolean {
-	return number <= 0x1fffffffffffff;
-}
-
-/**
- * Converts a human-readable JS `number` into a `BN` scaled by `precision`, routing through a
- * string conversion (`number.toString()` for whole numbers) instead of `number * precision` when
- * the naive multiplication would exceed `Number.MAX_SAFE_INTEGER` (per `isBNSafe`), avoiding
- * silent floating-point precision loss for large inputs. Note a fractional input whose scaled
- * value exceeds `Number.MAX_SAFE_INTEGER` has its fractional part truncated (`bn.js` accepts only
- * integer numbers); this is intentional and pinned by `tests/bn/test.ts`.
- *
- * @param {number} number - The human-readable amount to convert
- * @param {BN} precision - The target fixed-point precision (e.g. `QUOTE_PRECISION`, `BASE_PRECISION`)
- * @return {BN} `number` scaled by `precision`
- */
-export function numberToSafeBN(number: number, precision: BN): BN {
-	// check if number has decimals
-	const candidate = number * precision.toNumber();
-	if (isBNSafe(candidate)) {
-		return new BN(candidate);
-	} else {
-		if (number % 1 === 0) {
-			return new BN(number.toString()).mul(precision);
-		} else {
-			return new BN(number).mul(precision);
-		}
-	}
-}

package/src/memcmp.ts

@@ -1,279 +0,0 @@
-import { MemcmpFilter, PublicKey } from '@solana/web3.js';
-import bs58 from 'bs58';
-import { BorshAccountsCoder } from './isomorphic/anchor29';
-import { encodeName } from './userName';
-
-/**
- * Builds a `getProgramAccounts` memcmp filter matching the 8-byte Anchor discriminator of the
- * `User` account type at offset 0. Use to fetch all `User` (sub-account) accounts.
- * @returns A memcmp filter for `User` accounts.
- */
-export function getUserFilter(): MemcmpFilter {
-	return {
-		memcmp: {
-			offset: 0,
-			bytes: bs58.encode(BorshAccountsCoder.accountDiscriminator('User')),
-		},
-	};
-}
-
-/*
- * Byte offsets of the trailing scalar flags in the `User` account.
- *
- * These MUST match the on-chain `User` layout decoded in `decode/user.ts`. The
- * current Velocity layout is 4496 bytes, with the tail block laid out as
- * consecutive single bytes:
- *   status(4468) isMarginTradingEnabled(4469) idle(4470) openOrders(4471)
- *   hasOpenOrder(4472) openAuctions(4473) hasOpenAuction(4474) poolId(4475)
- *   specialUserStatus(4476)
- *
- * NOTE: these were previously hardcoded to the older (4376-byte) layout
- * (idle@4350, hasOpenOrder@4352, ...). After Velocity added fields to
- * `PerpPosition`, the account grew by 120 bytes and these flags shifted, but
- * the filters were not updated — so `getUserWithOrderFilter()` matched zero
- * accounts and the DLOB order book never populated. Keep these in sync with
- * `decode/user.ts` if the `User` layout changes again.
- */
-const USER_IDLE_OFFSET = 4470;
-const USER_HAS_OPEN_ORDER_OFFSET = 4472;
-const USER_HAS_OPEN_AUCTION_OFFSET = 4474;
-const USER_POOL_ID_OFFSET = 4475;
-
-/**
- * Builds a memcmp filter matching `User` accounts whose `idle` flag (offset 4470) is `false`.
- * Idle sub-accounts have no open positions/orders and have been inactive past the idle threshold;
- * this filter excludes them, e.g. when scanning for accounts that need active monitoring.
- * @returns A memcmp filter for non-idle `User` accounts.
- */
-export function getNonIdleUserFilter(): MemcmpFilter {
-	return {
-		memcmp: {
-			offset: USER_IDLE_OFFSET,
-			bytes: bs58.encode(Uint8Array.from([0])),
-		},
-	};
-}
-
-/**
- * Builds a memcmp filter matching `User` accounts with `hasOpenOrder` (offset 4472) set to `true`
- * — i.e. at least one live order. Used by the DLOB to fetch only accounts that can populate the
- * order book.
- * @returns A memcmp filter for `User` accounts with at least one open order.
- */
-export function getUserWithOrderFilter(): MemcmpFilter {
-	return {
-		memcmp: {
-			offset: USER_HAS_OPEN_ORDER_OFFSET,
-			bytes: bs58.encode(Uint8Array.from([1])),
-		},
-	};
-}
-
-/**
- * Builds a memcmp filter matching `User` accounts with `hasOpenOrder` (offset 4472) set to `false`
- * — i.e. no live orders.
- * @returns A memcmp filter for `User` accounts with no open orders.
- */
-export function getUserWithoutOrderFilter(): MemcmpFilter {
-	return {
-		memcmp: {
-			offset: USER_HAS_OPEN_ORDER_OFFSET,
-			bytes: bs58.encode(Uint8Array.from([0])),
-		},
-	};
-}
-
-/**
- * Builds a memcmp filter matching `User` accounts with `hasOpenAuction` (offset 4474) set to
- * `true` — i.e. at least one order still in its Dutch-auction window.
- * @returns A memcmp filter for `User` accounts with an active order auction.
- */
-export function getUserWithAuctionFilter(): MemcmpFilter {
-	return {
-		memcmp: {
-			offset: USER_HAS_OPEN_AUCTION_OFFSET,
-			bytes: bs58.encode(Uint8Array.from([1])),
-		},
-	};
-}
-
-/**
- * Builds a memcmp filter matching `User` accounts whose `name` field (32 bytes, offset 72) equals
- * `name` once encoded/padded the same way as on-chain.
- * @param name - Human-readable sub-account name to match; encoded via `encodeName` (UTF-8,
- * space-padded/truncated to 32 bytes) before comparison.
- * @returns A memcmp filter for `User` accounts with the given name.
- */
-export function getUserWithName(name: string): MemcmpFilter {
-	return {
-		memcmp: {
-			offset: 72,
-			bytes: bs58.encode(Uint8Array.from(encodeName(name))),
-		},
-	};
-}
-
-/**
- * Builds a memcmp filter matching `User` accounts whose `poolId` (single byte, offset 4475) equals
- * `poolId`. Used to scope account scans to a specific isolated pool.
- * @param poolId - Pool id byte (0 = main/cross pool) to match.
- * @returns A memcmp filter for `User` accounts in the given pool.
- */
-export function getUsersWithPoolId(poolId: number): MemcmpFilter {
-	return {
-		memcmp: {
-			offset: USER_POOL_ID_OFFSET,
-			bytes: bs58.encode(Uint8Array.from([poolId])),
-		},
-	};
-}
-
-/**
- * Builds a `getProgramAccounts` memcmp filter matching the 8-byte Anchor discriminator of the
- * `UserStats` account type at offset 0. Use to fetch all `UserStats` accounts.
- * @returns A memcmp filter for `UserStats` accounts.
- */
-export function getUserStatsFilter(): MemcmpFilter {
-	return {
-		memcmp: {
-			offset: 0,
-			bytes: bs58.encode(BorshAccountsCoder.accountDiscriminator('UserStats')),
-		},
-	};
-}
-
-/*
- * Byte offset of `referrer_status` in the `UserStats` account: 8 (discriminator)
- * + authority(32) + referrer(32) + fees(32) + maker/taker/filler volume 30d(24)
- * + last maker/taker/filler volume 30d ts(24) + if_staked_quote_asset_amount(8)
- * + number_of_sub_accounts(2) + number_of_sub_accounts_created(2) = 164.
- */
-const USER_STATS_REFERRER_STATUS_OFFSET = 164;
-
-/**
- * Builds a memcmp filter matching `UserStats` accounts whose `referrerStatus` bitflag byte (offset
- * 164) is exactly `ReferrerStatus.IsReferred` (2) — i.e. the account was referred and is *not*
- * also flagged `IsReferrer`. Because memcmp does an exact byte match rather than a bitwise test,
- * this excludes accounts that are both `IsReferrer` and `IsReferred` (byte value 3); use
- * `getUserStatsIsReferredOrReferrerFilter` for that combined case.
- * @returns A memcmp filter for `UserStats` accounts referred by (but not also referring) another user.
- */
-export function getUserStatsIsReferredFilter(): MemcmpFilter {
-	return {
-		memcmp: {
-			offset: USER_STATS_REFERRER_STATUS_OFFSET,
-			bytes: bs58.encode(Buffer.from(Uint8Array.from([2]))),
-		},
-	};
-}
-
-/**
- * Builds a memcmp filter matching `UserStats` accounts whose `referrerStatus` bitflag byte (offset
- * 164) is exactly 3 — i.e. `ReferrerStatus.IsReferrer | ReferrerStatus.IsReferred` both set on the
- * same account. Despite the name, this is an exact-byte match (memcmp can't test bits in
- * isolation), so it does *not* match an account that is only `IsReferrer` (1) or only `IsReferred`
- * (2) — use `getUserStatsIsReferredFilter` for the referred-only case.
- * @returns A memcmp filter for `UserStats` accounts with both the referrer and referred flags set.
- */
-export function getUserStatsIsReferredOrReferrerFilter(): MemcmpFilter {
-	return {
-		memcmp: {
-			offset: USER_STATS_REFERRER_STATUS_OFFSET,
-			bytes: bs58.encode(Buffer.from(Uint8Array.from([3]))),
-		},
-	};
-}
-
-/**
- * Builds a `getProgramAccounts` memcmp filter matching the 8-byte Anchor discriminator of the
- * `SignedMsgUserOrders` account type at offset 0. Use to fetch all swift/signed-message order
- * accounts.
- * @returns A memcmp filter for `SignedMsgUserOrders` accounts.
- */
-export function getSignedMsgUserOrdersFilter(): MemcmpFilter {
-	return {
-		memcmp: {
-			offset: 0,
-			bytes: bs58.encode(
-				BorshAccountsCoder.accountDiscriminator('SignedMsgUserOrders')
-			),
-		},
-	};
-}
-
-/**
- * Builds a `getProgramAccounts` memcmp filter matching the 8-byte Anchor discriminator of the
- * `PerpMarket` account type at offset 0. Use to fetch all perp market accounts.
- * @returns A memcmp filter for `PerpMarket` accounts.
- */
-export function getPerpMarketAccountsFilter(): MemcmpFilter {
-	return {
-		memcmp: {
-			offset: 0,
-			bytes: bs58.encode(BorshAccountsCoder.accountDiscriminator('PerpMarket')),
-		},
-	};
-}
-/**
- * Builds a `getProgramAccounts` memcmp filter matching the 8-byte Anchor discriminator of the
- * `SpotMarket` account type at offset 0. Use to fetch all spot market accounts.
- * @returns A memcmp filter for `SpotMarket` accounts.
- */
-export function getSpotMarketAccountsFilter(): MemcmpFilter {
-	return {
-		memcmp: {
-			offset: 0,
-			bytes: bs58.encode(BorshAccountsCoder.accountDiscriminator('SpotMarket')),
-		},
-	};
-}
-
-/**
- * Builds a `getProgramAccounts` memcmp filter matching the 8-byte Anchor discriminator of the
- * `RevenueShareEscrow` account type at offset 0. Use to fetch all revenue-share escrow accounts
- * (builder-fee approvals/referral state).
- * @returns A memcmp filter for `RevenueShareEscrow` accounts.
- */
-export function getRevenueShareEscrowFilter(): MemcmpFilter {
-	return {
-		memcmp: {
-			offset: 0,
-			bytes: bs58.encode(
-				BorshAccountsCoder.accountDiscriminator('RevenueShareEscrow')
-			),
-		},
-	};
-}
-
-/**
- * Builds a `getProgramAccounts` memcmp filter matching the 8-byte Anchor discriminator of the
- * `Constituent` account type at offset 0. Use to fetch all LP-pool constituent accounts.
- * @returns A memcmp filter for `Constituent` accounts.
- */
-export function getConstituentFilter(): MemcmpFilter {
-	return {
-		memcmp: {
-			offset: 0,
-			bytes: bs58.encode(
-				BorshAccountsCoder.accountDiscriminator('Constituent')
-			),
-		},
-	};
-}
-
-/**
- * Builds a memcmp filter matching `Constituent` accounts belonging to a specific LP pool, by
- * comparing the `lpPool` pubkey field (32 bytes, offset 72) against `lpPoolPublicKey`.
- * @param lpPoolPublicKey - The `LpPool` account's pubkey to match constituents against.
- * @returns A memcmp filter for `Constituent` accounts of the given LP pool.
- */
-export function getConstituentLpPoolFilter(
-	lpPoolPublicKey: PublicKey
-): MemcmpFilter {
-	return {
-		memcmp: {
-			offset: 72,
-			bytes: lpPoolPublicKey.toBase58(),
-		},
-	};
-}

package/src/oracles/oracleClientCache.ts

@@ -1,41 +0,0 @@
-import { OracleClient } from './types';
-import { OracleSource } from '../types';
-import { getOracleClient } from '../factory/oracleClient';
-import { Connection } from '@solana/web3.js';
-import { VelocityProgram } from '../config';
-
-/**
- * Caches one `OracleClient` instance per oracle *source kind* (not per account), so repeated
- * lookups for the same `OracleSource` variant (e.g. every `pyth1KPull` market) reuse a single
- * adapter instead of constructing a new one each time.
- */
-export class OracleClientCache {
-	cache = new Map<string, OracleClient>();
-	public constructor() {}
-
-	/**
-	 * Returns the cached `OracleClient` for `oracleSource`'s variant key, constructing and caching
-	 * one via `getOracleClient` on first use.
-	 * @param oracleSource - Oracle source variant (its top-level key, e.g. `"pyth"`, is the cache key —
-	 * note this means all sources sharing a variant name share one client instance regardless of any
-	 * other fields on the variant).
-	 * @param connection - RPC connection passed through to the client on construction.
-	 * @param program - Velocity Anchor program, used by clients that decode via the program's IDL coder.
-	 * @returns The `OracleClient` for this source variant.
-	 * @throws Error (via `getOracleClient`) if `oracleSource` is not a recognized variant.
-	 */
-	public get(
-		oracleSource: OracleSource,
-		connection: Connection,
-		program: VelocityProgram
-	) {
-		const key = Object.keys(oracleSource)[0];
-		if (this.cache.has(key)) {
-			return this.cache.get(key);
-		}
-
-		const client = getOracleClient(oracleSource, connection, program);
-		this.cache.set(key, client);
-		return client;
-	}
-}

package/src/oracles/oracleId.ts

@@ -1,99 +0,0 @@
-import { PublicKey } from '@solana/web3.js';
-import { OracleSource, OracleSourceNum } from '../types';
-
-/**
- * Maps an `OracleSource` enum-object (e.g. `{ pyth: {} }`) to its stable numeric encoding
- * (`OracleSourceNum`) used as part of an oracle id string. This encoding is SDK-internal — it
- * is not the on-chain Borsh discriminant (see `OracleSourceNum`).
- * @param source - The oracle source variant.
- * @returns The corresponding `OracleSourceNum` value.
- * @throws Error if `source` doesn't match any known variant.
- */
-export function getOracleSourceNum(source: OracleSource): number {
-	if ('pyth' in source) return OracleSourceNum.PYTH;
-	if ('pyth1K' in source) return OracleSourceNum.PYTH_1K;
-	if ('pyth1M' in source) return OracleSourceNum.PYTH_1M;
-	if ('pythPull' in source) return OracleSourceNum.PYTH_PULL;
-	if ('pyth1KPull' in source) return OracleSourceNum.PYTH_1K_PULL;
-	if ('pyth1MPull' in source) return OracleSourceNum.PYTH_1M_PULL;
-	if ('deprecatedSwitchboard' in source)
-		return OracleSourceNum.DEPRECATED_SWITCHBOARD;
-	if ('quoteAsset' in source) return OracleSourceNum.QUOTE_ASSET;
-	if ('pythStableCoin' in source) return OracleSourceNum.PYTH_STABLE_COIN;
-	if ('pythStableCoinPull' in source)
-		return OracleSourceNum.PYTH_STABLE_COIN_PULL;
-	if ('prelaunch' in source) return OracleSourceNum.PRELAUNCH;
-	if ('deprecatedSwitchboardOnDemand' in source)
-		return OracleSourceNum.DEPRECATED_SWITCHBOARD_ON_DEMAND;
-	if ('pythLazer' in source) return OracleSourceNum.PYTH_LAZER;
-	if ('pythLazer1K' in source) return OracleSourceNum.PYTH_LAZER_1K;
-	if ('pythLazer1M' in source) return OracleSourceNum.PYTH_LAZER_1M;
-	if ('pythLazerStableCoin' in source)
-		return OracleSourceNum.PYTH_LAZER_STABLE_COIN;
-	throw new Error('Invalid oracle source');
-}
-
-/**
- * Inverse of `getOracleSourceNum`: maps a numeric `OracleSourceNum` back to its `OracleSource`
- * enum-object.
- * @param sourceNum - Numeric oracle source encoding.
- * @returns The corresponding `OracleSource` variant.
- * @throws Error if `sourceNum` doesn't match any known `OracleSourceNum` value.
- */
-export function getOracleSourceFromNum(sourceNum: number): OracleSource {
-	if (sourceNum === OracleSourceNum.PYTH) return 'pyth';
-	if (sourceNum === OracleSourceNum.PYTH_1K) return 'pyth1K';
-	if (sourceNum === OracleSourceNum.PYTH_1M) return 'pyth1M';
-	if (sourceNum === OracleSourceNum.PYTH_PULL) return 'pythPull';
-	if (sourceNum === OracleSourceNum.PYTH_1K_PULL) return 'pyth1KPull';
-	if (sourceNum === OracleSourceNum.PYTH_1M_PULL) return 'pyth1MPull';
-	if (sourceNum === OracleSourceNum.DEPRECATED_SWITCHBOARD)
-		return 'deprecatedSwitchboard';
-	if (sourceNum === OracleSourceNum.QUOTE_ASSET) return 'quoteAsset';
-	if (sourceNum === OracleSourceNum.PYTH_STABLE_COIN) return 'pythStableCoin';
-	if (sourceNum === OracleSourceNum.PYTH_STABLE_COIN_PULL)
-		return 'pythStableCoinPull';
-	if (sourceNum === OracleSourceNum.PRELAUNCH) return 'prelaunch';
-	if (sourceNum === OracleSourceNum.DEPRECATED_SWITCHBOARD_ON_DEMAND)
-		return 'deprecatedSwitchboardOnDemand';
-	if (sourceNum === OracleSourceNum.PYTH_LAZER) return 'pythLazer';
-	if (sourceNum === OracleSourceNum.PYTH_LAZER_1K) return 'pythLazer1K';
-	if (sourceNum === OracleSourceNum.PYTH_LAZER_1M) return 'pythLazer1M';
-	if (sourceNum === OracleSourceNum.PYTH_LAZER_STABLE_COIN)
-		return 'pythLazerStableCoin';
-	throw new Error('Invalid oracle source');
-}
-
-/**
- * Builds a stable string id for an oracle account, uniquely identifying it by both its address
- * and the source/decoding scheme to use — the same pubkey can be interpreted under different
- * `OracleSource`s (e.g. `pyth` vs `pyth1K`) with different results, so the pubkey alone is not a
- * safe cache/map key.
- * @param publicKey - The oracle account's address.
- * @param source - The oracle source variant to decode it as.
- * @returns A string of the form `"<base58 pubkey>-<OracleSourceNum>"`.
- */
-export function getOracleId(
-	publicKey: PublicKey,
-	source: OracleSource
-): string {
-	return `${publicKey.toBase58()}-${getOracleSourceNum(source)}`;
-}
-
-/**
- * Inverse of `getOracleId`: parses an oracle id string back into its pubkey and `OracleSource`.
- * @param oracleId - An id string previously produced by `getOracleId`.
- * @returns The decoded `publicKey` and `source`.
- * @throws Error if the encoded source number doesn't match any known `OracleSourceNum` value, or
- * `PublicKey` construction fails on a malformed id.
- */
-export function getPublicKeyAndSourceFromOracleId(oracleId: string): {
-	publicKey: PublicKey;
-	source: OracleSource;
-} {
-	const [publicKey, source] = oracleId.split('-');
-	return {
-		publicKey: new PublicKey(publicKey),
-		source: getOracleSourceFromNum(parseInt(source)),
-	};
-}

package/src/oracles/prelaunchOracleClient.ts

@@ -1,63 +0,0 @@
-import { Connection, PublicKey } from '@solana/web3.js';
-import { OracleClient, OraclePriceData } from './types';
-import { VelocityProgram } from '../config';
-import { PrelaunchOracle } from '../types';
-import { getOracleAccountDataOrThrow } from './utils';
-
-/**
- * `OracleClient` for the `PrelaunchOracle` account type — a synthetic, program-managed "oracle"
- * used for perp markets that have not yet listed on a real price feed. Its price is admin/keeper
- * set (via `updatePrelaunchOracleParams`) rather than fed by an external network.
- */
-export class PrelaunchOracleClient implements OracleClient {
-	private connection: Connection;
-	private program: VelocityProgram;
-
-	public constructor(connection: Connection, program: VelocityProgram) {
-		this.connection = connection;
-		this.program = program;
-	}
-
-	/**
-	 * Fetches and decodes a `PrelaunchOracle` account's current price data.
-	 * @param pricePublicKey - The `PrelaunchOracle` account's address (see `getPrelaunchOraclePublicKey`).
-	 * @returns The decoded price data.
-	 * @throws Error if the account does not exist.
-	 */
-	public async getOraclePriceData(
-		pricePublicKey: PublicKey
-	): Promise<OraclePriceData> {
-		const data = await getOracleAccountDataOrThrow(
-			this.connection,
-			pricePublicKey,
-			'Prelaunch oracle'
-		);
-		return this.getOraclePriceDataFromBuffer(data);
-	}
-
-	/**
-	 * Decodes raw `PrelaunchOracle` account bytes into normalized `OraclePriceData`. Note `slot` is
-	 * populated from `ammLastUpdateSlot` (the last time the paired AMM used this price), not a
-	 * slot recorded by the oracle account itself, and `hasSufficientNumberOfDataPoints` is always
-	 * `true` since there is no publisher-count concept for this source.
-	 * @param buffer - Raw `PrelaunchOracle` account data.
-	 * @returns Price (`price`), confidence (`confidence`, both PRICE_PRECISION 1e6), and the
-	 * prelaunch-only upper bound (`maxPrice`, PRICE_PRECISION 1e6).
-	 */
-	public getOraclePriceDataFromBuffer(buffer: Buffer): OraclePriceData {
-		const prelaunchOracle = (
-			this.program.account as any
-		).prelaunchOracle.coder.accounts.decodeUnchecked(
-			'prelaunchOracle',
-			buffer
-		) as PrelaunchOracle;
-
-		return {
-			price: prelaunchOracle.price,
-			slot: prelaunchOracle.ammLastUpdateSlot,
-			confidence: prelaunchOracle.confidence,
-			hasSufficientNumberOfDataPoints: true,
-			maxPrice: prelaunchOracle.maxPrice,
-		};
-	}
-}