@liquid-af/sdk 0.11.11 → 1.0.0

package/src/client.ts

@@ -20,7 +20,6 @@ import {
 // Instruction builders
 import {
 	buildCreateNativeCurve,
-	buildBumpNative,
 	buildBuyExactInNative,
 	buildBuyExactInNativeAutoResolve,
 	buildSellExactInNative,
@@ -113,11 +112,7 @@ import {
 } from "./helpers/preview.js";
 
 // PDA helpers (used internally by buildDeposit/buildWithdraw)
-import {
-	getPoolPDA,
-	getPoolLpMintPDA,
-	getPoolVaultPDA,
-} from "./pda/index.js";
+import { getPoolPDA, getPoolLpMintPDA, getPoolVaultPDA } from "./pda/index.js";
 
 // Utility
 import { resolveTokenProgram as resolveTokenProgramFn } from "./helpers/user.js";
@@ -159,7 +154,6 @@ export class LiquidClient {
 	buildCreateNativeCurve(params: {
 		creator: PublicKey;
 		mint: PublicKey;
-		pythPriceFeed: PublicKey;
 		name: string;
 		symbol: string;
 		uri: string;
@@ -167,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 });
 	}
@@ -188,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,
@@ -201,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 });
 	}
@@ -222,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,
@@ -240,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 });
 	}
@@ -254,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,
@@ -272,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 });
 	}
@@ -286,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,
@@ -339,7 +333,7 @@ export class LiquidClient {
 	buildExecuteBuybackNative(params: {
 		payer: PublicKey;
 		mint: PublicKey;
-		pythPriceFeed: PublicKey;
+		pythPriceFeed?: PublicKey;
 	}): Promise<TransactionInstruction> {
 		return buildExecuteBuybackNative({ ...params, config: this.config });
 	}
@@ -353,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;
@@ -945,7 +931,6 @@ export class LiquidClient {
 		return buildInitializeUser({ ...params, config: this.config });
 	}
 
-
 	/** Builds a setCashbackMode instruction. Toggles between earning and spending mode. */
 	buildSetCashbackMode(params: {
 		user: PublicKey;
@@ -1083,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(
@@ -1105,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/parser.ts

@@ -12,14 +12,12 @@ export interface ParsedEvent<T = unknown> {
 /** Minimal transaction shape needed for event parsing. */
 export interface TransactionForEventParsing {
 	meta: {
-		innerInstructions?:
-			| Array<{
-					instructions: Array<{
-						programIdIndex: number;
-						data: string;
-					}>;
-			  }>
-			| null;
+		innerInstructions?: Array<{
+			instructions: Array<{
+				programIdIndex: number;
+				data: string;
+			}>;
+		}> | null;
 	} | null;
 	transaction: {
 		message:
@@ -137,10 +135,7 @@ export const parseTransactionEvents = (
  * @returns Object containing the trigger result and the captured event data
  * @throws If the event is not received within the timeout period
  */
-export async function waitForEvent<
-	N extends LiquidEventName,
-	TResult = string,
->(
+export async function waitForEvent<N extends LiquidEventName, TResult = string>(
 	program: Program<LiquidEvents>,
 	eventName: N,
 	trigger: () => Promise<TResult>,
@@ -151,13 +146,10 @@ export async function waitForEvent<
 
 	// Subscribe to logs to capture the transaction signature
 	// (invoke/exit logs are always present even without emit!)
-	const subscriptionId = connection.onLogs(
-		program.programId,
-		(logInfo) => {
-			if (logInfo.err) return;
-			capturedSignature = logInfo.signature;
-		},
-	);
+	const subscriptionId = connection.onLogs(program.programId, (logInfo) => {
+		if (logInfo.err) return;
+		capturedSignature = logInfo.signature;
+	});
 
 	try {
 		const result = await trigger();
@@ -193,7 +185,7 @@ export async function waitForEvent<
 		if (!event) {
 			throw new Error(
 				`Event '${eventName}' not found in transaction ${capturedSignature}. ` +
-				`Found events: [${events.map((e) => e.name).join(", ")}]`,
+					`Found events: [${events.map((e) => e.name).join(", ")}]`,
 			);
 		}
 

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/cashback.ts

@@ -1,9 +1,13 @@
 import type { Connection, PublicKey } from "@solana/web3.js";
 import type { LiquidConfig } from "../config.js";
-import type { CashbackBreakdown } from "../math/cashback.js";
-import { getCashbackBreakdown } from "../math/cashback.js";
-import { fetchUserProperties } from "../accounts/liquid-state.js";
-import { fetchCashbackConfig } from "../accounts/liquid-state.js";
+import {
+	getCashbackBreakdown,
+	type CashbackBreakdown,
+} from "../math/cashback.js";
+import {
+	fetchUserProperties,
+	fetchCashbackConfig,
+} from "../accounts/liquid-state.js";
 
 /**
  * Fetches a user's cashback balance and config from chain, then computes
@@ -24,5 +28,8 @@ export async function fetchCashbackBreakdown(
 		fetchCashbackConfig(connection, config),
 	]);
 
-	return getCashbackBreakdown(userProps.cashbackCredits, cashbackConfig.ranges);
+	return getCashbackBreakdown(
+		userProps.cashbackCredits,
+		cashbackConfig.ranges,
+	);
 }

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 { calculateVirtualSolReserves } 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.
-	 * Include `initialVirtualReserveUsd` when previewing native curves without
-	 * a prefetched `bondingCurve` (needed to compute virtual SOL reserves).
-	 */
+	/** Fee configuration from the global config account. */
 	globalConfig?: {
 		protocolFeeBasisPoints: number;
 		creatorFeeBasisPoints: number;
 		creatorReferralRewardBasisPoints: number;
 		traderReferralRewardBasisPoints: number;
-		initialVirtualReserveUsd?: BN;
 	};
 	/**
 	 * Bonding curve reserves.
-	 * For native curves, `virtualQuoteReserves` must already be oracle-adjusted
-	 * (i.e. computed via `calculateVirtualSolReserves`).
+	 * Virtual quote = `initialVirtualQuoteReserves + realQuoteReserves`.
+	 * Both native and stable curves store `initialVirtualQuoteReserves` directly.
 	 */
 	bondingCurve?: {
-		virtualQuoteReserves: BN;
+		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
  */
@@ -423,15 +411,21 @@ async function resolveNativeCurve(
 			: fetchNativeBondingCurve(connection, mint, config),
 	]);
 
-	const virtualSolReserves = calculateVirtualSolReserves(
-		BigInt(globalConfig.initialVirtualReserveUsd!.toString()),
-		BigInt(options.solPriceUsd.toString()),
-	);
-
-	const bondingCurve = pre?.bondingCurve ?? {
-		virtualQuoteReserves: new BN(virtualSolReserves.toString()),
+	const src = pre?.bondingCurve ?? {
+		realQuoteReserves: nativeCurve!.realQuoteReserves,
 		virtualTokenReserves: nativeCurve!.virtualTokenReserves,
 		realTokenReserves: nativeCurve!.realTokenReserves,
+		initialVirtualQuoteReserves: nativeCurve!.initialVirtualQuoteReserves,
+	};
+
+	const virtualQuoteReserves = src.initialVirtualQuoteReserves.add(
+		src.realQuoteReserves,
+	);
+
+	const bondingCurve = {
+		virtualQuoteReserves,
+		virtualTokenReserves: src.virtualTokenReserves,
+		realTokenReserves: src.realTokenReserves,
 	};
 
 	return { globalConfig, bondingCurve };
@@ -441,8 +435,8 @@ async function resolveNativeCurve(
  * Resolves {@link CurvePreviewState} for stable (e.g. USDC) curves.
  *
  * Fetches the global config and stable bonding curve in parallel (skipping
- * any that are prefetched). `virtualQuoteReserves` is read directly from
- * the on-chain account.
+ * any that are prefetched). Virtual quote reserves are computed as
+ * `initialVirtualQuoteReserves + realQuoteReserves`.
  *
  * @param connection - Solana RPC connection
  * @param mint - Token mint address of the stable bonding curve
@@ -465,10 +459,21 @@ async function resolveStableCurve(
 			: fetchStableBondingCurve(connection, mint, config),
 	]);
 
-	const bondingCurve = pre?.bondingCurve ?? {
-		virtualQuoteReserves: stableCurve!.virtualQuoteReserves,
+	const src = pre?.bondingCurve ?? {
+		realQuoteReserves: stableCurve!.realQuoteReserves,
 		virtualTokenReserves: stableCurve!.virtualTokenReserves,
 		realTokenReserves: stableCurve!.realTokenReserves,
+		initialVirtualQuoteReserves: stableCurve!.initialVirtualQuoteReserves,
+	};
+
+	const virtualQuoteReserves = src.initialVirtualQuoteReserves.add(
+		src.realQuoteReserves,
+	);
+
+	const bondingCurve = {
+		virtualQuoteReserves,
+		virtualTokenReserves: src.virtualTokenReserves,
+		realTokenReserves: src.realTokenReserves,
 	};
 
 	return { globalConfig, bondingCurve };
@@ -522,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
@@ -565,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