@liquid-af/sdk 0.11.12 → 1.0.1

package/src/client.ts

@@ -20,7 +20,6 @@ import {
 // Instruction builders
 import {
 	buildCreateNativeCurve,
-	buildBumpNative,
 	buildBuyExactInNative,
 	buildBuyExactInNativeAutoResolve,
 	buildSellExactInNative,
@@ -155,7 +154,6 @@ export class LiquidClient {
 	buildCreateNativeCurve(params: {
 		creator: PublicKey;
 		mint: PublicKey;
-		pythPriceFeed: PublicKey;
 		name: string;
 		symbol: string;
 		uri: string;
@@ -163,17 +161,17 @@ export class LiquidClient {
 		return buildCreateNativeCurve({ ...params, config: this.config });
 	}
 
-	/** Builds a buyNative instruction. Requires the creator address and Pyth price feed. */
+	/** Builds a buyNative instruction. Requires the creator address. */
 	buildBuyExactInNative(params: {
 		user: PublicKey;
 		mint: PublicKey;
 		creator: PublicKey;
-		pythPriceFeed: PublicKey;
 		amountIn: BN;
 		minAmountOut: BN;
 		feeRecipient: PublicKey;
 		creatorReferralVault?: PublicKey | null;
 		traderReferralVault?: PublicKey | null;
+		pythPriceFeed?: PublicKey;
 	}): Promise<TransactionInstruction> {
 		return buildBuyExactInNative({ ...params, config: this.config });
 	}
@@ -184,12 +182,12 @@ export class LiquidClient {
 	buildBuyExactInNativeAutoResolve(params: {
 		user: PublicKey;
 		mint: PublicKey;
-		pythPriceFeed: PublicKey;
 		amountIn: BN;
 		minAmountOut: BN;
 		feeRecipient: PublicKey;
 		creatorReferralVault?: PublicKey | null;
 		traderReferralVault?: PublicKey | null;
+		pythPriceFeed?: PublicKey;
 	}): Promise<TransactionInstruction> {
 		return buildBuyExactInNativeAutoResolve(this.connection, {
 			...params,
@@ -197,17 +195,17 @@ export class LiquidClient {
 		});
 	}
 
-	/** Builds a sellNative instruction. Requires the creator address and Pyth price feed. */
+	/** Builds a sellNative instruction. Requires the creator address. */
 	buildSellExactInNative(params: {
 		user: PublicKey;
 		mint: PublicKey;
 		creator: PublicKey;
-		pythPriceFeed: PublicKey;
 		amountIn: BN;
 		minAmountOut: BN;
 		feeRecipient: PublicKey;
 		creatorReferralVault?: PublicKey | null;
 		traderReferralVault?: PublicKey | null;
+		pythPriceFeed?: PublicKey;
 	}): Promise<TransactionInstruction> {
 		return buildSellExactInNative({ ...params, config: this.config });
 	}
@@ -218,12 +216,12 @@ export class LiquidClient {
 	buildSellExactInNativeAutoResolve(params: {
 		user: PublicKey;
 		mint: PublicKey;
-		pythPriceFeed: PublicKey;
 		amountIn: BN;
 		minAmountOut: BN;
 		feeRecipient: PublicKey;
 		creatorReferralVault?: PublicKey | null;
 		traderReferralVault?: PublicKey | null;
+		pythPriceFeed?: PublicKey;
 	}): Promise<TransactionInstruction> {
 		return buildSellExactInNativeAutoResolve(this.connection, {
 			...params,
@@ -236,12 +234,12 @@ export class LiquidClient {
 		user: PublicKey;
 		mint: PublicKey;
 		creator: PublicKey;
-		pythPriceFeed: PublicKey;
 		exactAmountOut: BN;
 		maxAmountIn: BN;
 		feeRecipient: PublicKey;
 		creatorReferralVault?: PublicKey | null;
 		traderReferralVault?: PublicKey | null;
+		pythPriceFeed?: PublicKey;
 	}): Promise<TransactionInstruction> {
 		return buildBuyExactOutNative({ ...params, config: this.config });
 	}
@@ -250,12 +248,12 @@ export class LiquidClient {
 	buildBuyExactOutNativeAutoResolve(params: {
 		user: PublicKey;
 		mint: PublicKey;
-		pythPriceFeed: PublicKey;
 		exactAmountOut: BN;
 		maxAmountIn: BN;
 		feeRecipient: PublicKey;
 		creatorReferralVault?: PublicKey | null;
 		traderReferralVault?: PublicKey | null;
+		pythPriceFeed?: PublicKey;
 	}): Promise<TransactionInstruction> {
 		return buildBuyExactOutNativeAutoResolve(this.connection, {
 			...params,
@@ -268,12 +266,12 @@ export class LiquidClient {
 		user: PublicKey;
 		mint: PublicKey;
 		creator: PublicKey;
-		pythPriceFeed: PublicKey;
 		exactAmountOut: BN;
 		maxAmountIn: BN;
 		feeRecipient: PublicKey;
 		creatorReferralVault?: PublicKey | null;
 		traderReferralVault?: PublicKey | null;
+		pythPriceFeed?: PublicKey;
 	}): Promise<TransactionInstruction> {
 		return buildSellExactOutNative({ ...params, config: this.config });
 	}
@@ -282,12 +280,12 @@ export class LiquidClient {
 	buildSellExactOutNativeAutoResolve(params: {
 		user: PublicKey;
 		mint: PublicKey;
-		pythPriceFeed: PublicKey;
 		exactAmountOut: BN;
 		maxAmountIn: BN;
 		feeRecipient: PublicKey;
 		creatorReferralVault?: PublicKey | null;
 		traderReferralVault?: PublicKey | null;
+		pythPriceFeed?: PublicKey;
 	}): Promise<TransactionInstruction> {
 		return buildSellExactOutNativeAutoResolve(this.connection, {
 			...params,
@@ -335,7 +333,7 @@ export class LiquidClient {
 	buildExecuteBuybackNative(params: {
 		payer: PublicKey;
 		mint: PublicKey;
-		pythPriceFeed: PublicKey;
+		pythPriceFeed?: PublicKey;
 	}): Promise<TransactionInstruction> {
 		return buildExecuteBuybackNative({ ...params, config: this.config });
 	}
@@ -349,14 +347,6 @@ export class LiquidClient {
 		return buildExecuteBuybackToken({ ...params, config: this.config });
 	}
 
-	/** Builds a bumpNative instruction. Re-evaluates a native curve's market cap against the oracle. */
-	buildBumpNative(params: {
-		mint: PublicKey;
-		pythPriceFeed: PublicKey;
-	}): Promise<TransactionInstruction> {
-		return buildBumpNative({ ...params, config: this.config });
-	}
-
 	/** Builds a createStableCurve instruction for launching a new token on a quote-token bonding curve. */
 	buildCreateStableCurve(params: {
 		creator: PublicKey;
@@ -1078,7 +1068,7 @@ export class LiquidClient {
 	 *
 	 * @param mint - Token mint address
 	 * @param amountInQuote - Quote token amount to spend (lamports for SOL, smallest unit for stables)
-	 * @param options - Native (`{ solPriceUsd }`) or stable (`{ quoteMint }`) curve options
+	 * @param options - Native (`{}`) or stable (`{ quoteMint }`) curve options
 	 * @returns Buy preview with `tokensOut`, `fees`, `priceImpactBps`, `newReserves`, and `willComplete`
 	 */
 	previewBuyOnCurve(
@@ -1100,7 +1090,7 @@ export class LiquidClient {
 	 *
 	 * @param mint - Token mint address
 	 * @param amountInTokens - Token amount to sell (smallest unit, 6 decimals)
-	 * @param options - Native (`{ solPriceUsd }`) or stable (`{ quoteMint }`) curve options
+	 * @param options - Native (`{}`) or stable (`{ quoteMint }`) curve options
 	 * @returns Sell preview with `quoteOut`, `quoteOutNet`, `fees`, `priceImpactBps`, and `newReserves`
 	 */
 	previewSellOnCurve(

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