@liquid-af/sdk 0.11.12 → 1.0.0

package/src/events/types.ts

@@ -12,12 +12,11 @@ export interface TokenCreatedEvent {
 	bondingCurve: PublicKey;
 	creator: PublicKey;
 	creatorReferrer: PublicKey | null;
-	initialVirtualReserveUsd: BN;
+	initialVirtualReserves: BN;
 	initialVirtualTokenReserves: BN;
 	initialRealTokenReserves: BN;
 	totalTokenSupply: BN;
 	tokenProgram: PublicKey;
-	solPriceUsd: BN | null;
 	timestamp: BN;
 }
 
@@ -64,13 +63,13 @@ export interface TradeEvent {
 	virtualQuoteReserves: BN;
 	realTokenReserves: BN;
 	realQuoteReserves: BN;
-	totalQuoteVolume: BN;
+	totalUsdVolume: BN;
 	totalTokenVolume: BN;
-	timestamp: BN;
-	solPriceUsd: BN | null;
 	marketCapUsd: BN;
+	solPriceUsd: BN | null;
 	buybackVaultBalance: BN;
 	isCurveComplete: boolean;
+	timestamp: BN;
 }
 
 /** Event emitted after a successful migration to AMM */
@@ -87,8 +86,6 @@ export interface MigrationCompletedEvent {
 	multiplier: number;
 	lpMint: PublicKey;
 	lpTokensMinted: BN;
-	marketCapUsd: BN;
-	solPriceUsd: BN | null;
 	buybackAmountMigrated: BN;
 }
 

package/src/helpers/preview.ts

@@ -18,7 +18,6 @@ import {
 } from "../math/bonding-curve.js";
 import { calculateAmmSellOutput, calculateAmmBuyInput } from "../math/amm.js";
 import { BPS_DENOMINATOR } from "../math/constants.js";
-import { calculateInitialVirtualSolReserves } from "../oracle.js";
 import { getAccount, getMint } from "@solana/spl-token";
 import { calculateFeesForPool } from "../math/tiered-fees.js";
 
@@ -83,27 +82,23 @@ export interface CurvePreviewOptions {
  * fetched automatically from chain.
  */
 export interface CurvePrefetchedState {
-	/**
-	 * Fee configuration from the global config account.
-	 * `initialVirtualReserveUsd` is required to compute virtual quote reserves.
-	 */
+	/** Fee configuration from the global config account. */
 	globalConfig?: {
 		protocolFeeBasisPoints: number;
 		creatorFeeBasisPoints: number;
 		creatorReferralRewardBasisPoints: number;
 		traderReferralRewardBasisPoints: number;
-		initialVirtualReserveUsd?: BN;
 	};
 	/**
 	 * Bonding curve reserves.
-	 * Virtual quote reserves are always recomputed as
-	 * `initialVirtualReserveUsd + realQuoteReserves` (with oracle conversion
-	 * for native curves).
+	 * Virtual quote = `initialVirtualQuoteReserves + realQuoteReserves`.
+	 * Both native and stable curves store `initialVirtualQuoteReserves` directly.
 	 */
 	bondingCurve?: {
 		realQuoteReserves: BN;
 		virtualTokenReserves: BN;
 		realTokenReserves: BN;
+		initialVirtualQuoteReserves: BN;
 	};
 }
 
@@ -120,13 +115,10 @@ interface CurveOptionsBase {
 /**
  * Options for native SOL bonding curve previews.
  *
- * Requires `solPriceUsd` to compute virtual SOL reserves from the on-chain
- * USD-denominated initial reserve value.
+ * Virtual SOL reserves are stored directly on-chain — no oracle needed.
  */
 export interface NativeCurveOptions extends CurveOptionsBase {
 	quoteMint?: never;
-	/** Current SOL price in USD (6 decimals, e.g. 150_000_000 = $150). */
-	solPriceUsd: BN;
 }
 
 /**
@@ -137,7 +129,6 @@ export interface NativeCurveOptions extends CurveOptionsBase {
 export interface StableCurveOptions extends CurveOptionsBase {
 	/** Quote token mint address (e.g. USDC mint). */
 	quoteMint: PublicKey;
-	solPriceUsd?: never;
 }
 
 /**
@@ -377,21 +368,18 @@ export function calculateSwapSellPreview(
  *
  * @param connection - Solana RPC connection
  * @param config - Liquid protocol configuration (provides the program ID)
- * @returns Fee basis-point fields plus `initialVirtualReserveUsd` for native reserve computation
+ * @returns Fee basis-point fields for preview calculations
  */
 async function fetchCurveGlobalConfig(
 	connection: Connection,
 	config: LiquidConfig,
-): Promise<
-	CurvePreviewState["globalConfig"] & { initialVirtualReserveUsd: BN }
-> {
+): Promise<CurvePreviewState["globalConfig"]> {
 	const raw = await fetchLiquidGlobalConfig(connection, config);
 	return {
 		protocolFeeBasisPoints: raw.protocolFeeBasisPoints,
 		creatorFeeBasisPoints: raw.creatorFeeBasisPoints,
 		creatorReferralRewardBasisPoints: raw.creatorReferralRewardBasisPoints,
 		traderReferralRewardBasisPoints: raw.traderReferralRewardBasisPoints,
-		initialVirtualReserveUsd: raw.initialVirtualReserveUsd,
 	};
 }
 
@@ -399,12 +387,12 @@ async function fetchCurveGlobalConfig(
  * Resolves {@link CurvePreviewState} for native SOL curves.
  *
  * Fetches the global config and native bonding curve in parallel (skipping
- * any that are prefetched), then computes `virtualQuoteReserves` from
- * `initialVirtualReserveUsd` and `solPriceUsd`.
+ * any that are prefetched), then computes `virtualQuoteReserves` from the
+ * stored `initialVirtualQuoteReserves` + `realQuoteReserves`.
  *
  * @param connection - Solana RPC connection
  * @param mint - Token mint address of the native bonding curve
- * @param options - Native curve options containing `solPriceUsd` and optional `prefetched` state
+ * @param options - Native curve options with optional `prefetched` state
  * @param config - Liquid protocol configuration
  * @returns Resolved curve preview state ready for pure-math preview calculations
  */
@@ -424,20 +412,18 @@ async function resolveNativeCurve(
 	]);
 
 	const src = pre?.bondingCurve ?? {
-		realQuoteReserves: nativeCurve!.realSolReserves,
+		realQuoteReserves: nativeCurve!.realQuoteReserves,
 		virtualTokenReserves: nativeCurve!.virtualTokenReserves,
 		realTokenReserves: nativeCurve!.realTokenReserves,
+		initialVirtualQuoteReserves: nativeCurve!.initialVirtualQuoteReserves,
 	};
 
-	const initialVirtualSolReserves = calculateInitialVirtualSolReserves(
-		BigInt(globalConfig.initialVirtualReserveUsd!.toString()),
-		BigInt(options.solPriceUsd.toString()),
+	const virtualQuoteReserves = src.initialVirtualQuoteReserves.add(
+		src.realQuoteReserves,
 	);
-	const virtualSolReserves =
-		initialVirtualSolReserves + BigInt(src.realQuoteReserves.toString());
 
 	const bondingCurve = {
-		virtualQuoteReserves: new BN(virtualSolReserves.toString()),
+		virtualQuoteReserves,
 		virtualTokenReserves: src.virtualTokenReserves,
 		realTokenReserves: src.realTokenReserves,
 	};
@@ -450,7 +436,7 @@ async function resolveNativeCurve(
  *
  * Fetches the global config and stable bonding curve in parallel (skipping
  * any that are prefetched). Virtual quote reserves are computed as
- * `initialVirtualReserveUsd + realQuoteReserves`.
+ * `initialVirtualQuoteReserves + realQuoteReserves`.
  *
  * @param connection - Solana RPC connection
  * @param mint - Token mint address of the stable bonding curve
@@ -477,9 +463,10 @@ async function resolveStableCurve(
 		realQuoteReserves: stableCurve!.realQuoteReserves,
 		virtualTokenReserves: stableCurve!.virtualTokenReserves,
 		realTokenReserves: stableCurve!.realTokenReserves,
+		initialVirtualQuoteReserves: stableCurve!.initialVirtualQuoteReserves,
 	};
 
-	const virtualQuoteReserves = globalConfig.initialVirtualReserveUsd!.add(
+	const virtualQuoteReserves = src.initialVirtualQuoteReserves.add(
 		src.realQuoteReserves,
 	);
 
@@ -540,9 +527,7 @@ function resolveCurveState(
  *
  * @example Native SOL curve
  * ```ts
- * const preview = await previewBuyOnCurve(connection, mint, new BN(100_000_000), config, {
- *   solPriceUsd: new BN(150_000_000), // $150
- * });
+ * const preview = await previewBuyOnCurve(connection, mint, new BN(100_000_000), config, {});
  * ```
  *
  * @example Stable (USDC) curve
@@ -583,9 +568,7 @@ export async function previewBuyOnCurve(
  *
  * @example Native SOL curve
  * ```ts
- * const preview = await previewSellOnCurve(connection, mint, new BN(5_000_000), config, {
- *   solPriceUsd: new BN(150_000_000),
- * });
+ * const preview = await previewSellOnCurve(connection, mint, new BN(5_000_000), config, {});
  * ```
  *
  * @see {@link calculateSellCurvePreview} for pure offline calculations with pre-built state