@liquid-af/sdk 0.11.12 → 1.0.0

package/src/idl/liquid_events.json

@@ -2037,22 +2037,6 @@
             ],
             "type": "u64"
           },
-          {
-            "name": "market_cap_usd",
-            "docs": [
-              "Market cap in USD at migration (6 decimals)."
-            ],
-            "type": "u64"
-          },
-          {
-            "name": "sol_price_usd",
-            "docs": [
-              "SOL price in USD at migration (6 decimals). None for stable curves."
-            ],
-            "type": {
-              "option": "u64"
-            }
-          },
           {
             "name": "buyback_amount_migrated",
             "docs": [
@@ -2558,7 +2542,7 @@
             }
           },
           {
-            "name": "initial_virtual_reserve_usd",
+            "name": "initial_virtual_reserves",
             "docs": [
               "Initial virtual reserves in USD (6 decimals)."
             ],
@@ -2592,15 +2576,6 @@
             ],
             "type": "pubkey"
           },
-          {
-            "name": "sol_price_usd",
-            "docs": [
-              "SOL price in USD at creation (6 decimals). None for stable curves."
-            ],
-            "type": {
-              "option": "u64"
-            }
-          },
           {
             "name": "timestamp",
             "docs": [
@@ -2833,9 +2808,9 @@
             "type": "u64"
           },
           {
-            "name": "total_quote_volume",
+            "name": "total_usd_volume",
             "docs": [
-              "Total quote volume (SOL or quote token)."
+              "Total USD volume (6 decimals)."
             ],
             "type": "u128"
           },

package/src/idl/liquid_events.ts

@@ -2043,22 +2043,6 @@ export type LiquidEvents = {
             ],
             "type": "u64"
           },
-          {
-            "name": "marketCapUsd",
-            "docs": [
-              "Market cap in USD at migration (6 decimals)."
-            ],
-            "type": "u64"
-          },
-          {
-            "name": "solPriceUsd",
-            "docs": [
-              "SOL price in USD at migration (6 decimals). None for stable curves."
-            ],
-            "type": {
-              "option": "u64"
-            }
-          },
           {
             "name": "buybackAmountMigrated",
             "docs": [
@@ -2564,7 +2548,7 @@ export type LiquidEvents = {
             }
           },
           {
-            "name": "initialVirtualReserveUsd",
+            "name": "initialVirtualReserves",
             "docs": [
               "Initial virtual reserves in USD (6 decimals)."
             ],
@@ -2598,15 +2582,6 @@ export type LiquidEvents = {
             ],
             "type": "pubkey"
           },
-          {
-            "name": "solPriceUsd",
-            "docs": [
-              "SOL price in USD at creation (6 decimals). None for stable curves."
-            ],
-            "type": {
-              "option": "u64"
-            }
-          },
           {
             "name": "timestamp",
             "docs": [
@@ -2839,9 +2814,9 @@ export type LiquidEvents = {
             "type": "u64"
           },
           {
-            "name": "totalQuoteVolume",
+            "name": "totalUsdVolume",
             "docs": [
-              "Total quote volume (SOL or quote token)."
+              "Total USD volume (6 decimals)."
             ],
             "type": "u128"
           },

package/src/instructions/index.ts

@@ -1,6 +1,5 @@
 export {
 	buildCreateNativeCurve,
-	buildBumpNative,
 	buildBuyExactInNative,
 	buildBuyExactInNativeAutoResolve,
 	buildSellExactInNative,
@@ -31,7 +30,6 @@ export {
 } from "./liquid.js";
 export type {
 	BuildCreateNativeCurveParams,
-	BuildBumpNativeParams,
 	BuildBuyExactInNativeParams,
 	BuildSellExactInNativeParams,
 	BuildBuyExactOutNativeParams,

package/src/instructions/liquid.ts

@@ -9,7 +9,11 @@ import {
 	TOKEN_2022_PROGRAM_ID,
 } from "@solana/spl-token";
 import type BN from "bn.js";
-import { WSOL_MINT, type LiquidConfig } from "../config.js";
+import {
+	PYTH_SOL_USD_PRICE_FEED,
+	WSOL_MINT,
+	type LiquidConfig,
+} from "../config.js";
 import {
 	getBondingCurvePDA,
 	getBondingCurveTokenAccount,
@@ -38,7 +42,6 @@ import {
 export interface BuildCreateNativeCurveParams {
 	creator: PublicKey;
 	mint: PublicKey;
-	pythPriceFeed: PublicKey;
 	name: string;
 	symbol: string;
 	uri: string;
@@ -58,7 +61,7 @@ export interface BuildCreateNativeCurveParams {
 export function buildCreateNativeCurve(
 	params: BuildCreateNativeCurveParams,
 ): Promise<TransactionInstruction> {
-	const { creator, mint, pythPriceFeed, name, symbol, uri, config } = params;
+	const { creator, mint, name, symbol, uri, config } = params;
 	const program = getCachedLiquidProgram(config);
 
 	const bondingCurveTokenAccount = getBondingCurveTokenAccount(
@@ -74,58 +77,28 @@ export function buildCreateNativeCurve(
 		.accounts({
 			creator,
 			mint,
-			pythPriceFeed,
 			bondingCurveTokenAccount,
 		})
 		.instruction();
 }
 
-export interface BuildBumpNativeParams {
-	mint: PublicKey;
-	pythPriceFeed: PublicKey;
-	config: LiquidConfig;
-}
-
-/**
- * Builds a bumpNative instruction.
- * Re-evaluates a native bonding curve's market cap against the current oracle price
- * and marks it as complete if the threshold is exceeded. Permissionless.
- *
- * @param params - {@link BuildBumpNativeParams}
- * @returns Transaction instruction
- */
-export function buildBumpNative(
-	params: BuildBumpNativeParams,
-): Promise<TransactionInstruction> {
-	const { mint, pythPriceFeed, config } = params;
-	const program = getCachedLiquidProgram(config);
-
-	return program.methods
-		.bumpNative()
-		.accounts({
-			mint,
-			pythPriceFeed,
-		})
-		.instruction();
-}
-
 export interface BuildBuyExactInNativeParams {
 	user: PublicKey;
 	mint: PublicKey;
 	creator: PublicKey;
-	pythPriceFeed: PublicKey;
 	amountIn: BN;
 	minAmountOut: BN;
 	feeRecipient: PublicKey;
 	creatorReferralVault?: PublicKey | null;
 	traderReferralVault?: PublicKey | null;
 	userTokenAccount?: PublicKey;
+	pythPriceFeed?: PublicKey;
 	config: LiquidConfig;
 }
 
 /**
  * Builds a buyNative instruction.
- * Requires the bonding curve creator and Pyth price feed to be known.
+ * Requires the bonding curve creator to be known.
  *
  * @param params - {@link BuildBuyExactInNativeParams}
  * @returns Transaction instruction
@@ -137,13 +110,13 @@ export function buildBuyExactInNative(
 		user,
 		mint,
 		creator,
-		pythPriceFeed,
 		amountIn,
 		minAmountOut,
 		feeRecipient,
 		creatorReferralVault,
 		traderReferralVault,
 		userTokenAccount,
+		pythPriceFeed,
 		config,
 	} = params;
 
@@ -165,7 +138,7 @@ export function buildBuyExactInNative(
 			user,
 			feeRecipient,
 			mint,
-			pythPriceFeed,
+			pythPriceFeed: pythPriceFeed ?? PYTH_SOL_USD_PRICE_FEED,
 			creatorUserProperties,
 			userTokenAccount: resolvedUserTokenAccount,
 			creatorReferralVault: creatorReferralVault ?? null,
@@ -198,7 +171,6 @@ export async function buildBuyExactInNativeAutoResolve(
 	return buildBuyExactInNative({
 		...params,
 		creator: curve.creator,
-		pythPriceFeed: params.pythPriceFeed,
 	});
 }
 
@@ -206,19 +178,19 @@ export interface BuildSellExactInNativeParams {
 	user: PublicKey;
 	mint: PublicKey;
 	creator: PublicKey;
-	pythPriceFeed: PublicKey;
 	amountIn: BN;
 	minAmountOut: BN;
 	feeRecipient: PublicKey;
 	creatorReferralVault?: PublicKey | null;
 	traderReferralVault?: PublicKey | null;
 	userTokenAccount?: PublicKey;
+	pythPriceFeed?: PublicKey;
 	config: LiquidConfig;
 }
 
 /**
  * Builds a sellNative instruction.
- * Requires the bonding curve creator and Pyth price feed to be known.
+ * Requires the bonding curve creator to be known.
  *
  * @param params - {@link BuildSellExactInNativeParams}
  * @returns Transaction instruction
@@ -230,13 +202,13 @@ export function buildSellExactInNative(
 		user,
 		mint,
 		creator,
-		pythPriceFeed,
 		amountIn,
 		minAmountOut,
 		feeRecipient,
 		creatorReferralVault,
 		traderReferralVault,
 		userTokenAccount,
+		pythPriceFeed,
 		config,
 	} = params;
 
@@ -258,7 +230,7 @@ export function buildSellExactInNative(
 			user,
 			feeRecipient,
 			mint,
-			pythPriceFeed,
+			pythPriceFeed: pythPriceFeed ?? PYTH_SOL_USD_PRICE_FEED,
 			creatorUserProperties,
 			userTokenAccount: resolvedUserTokenAccount,
 			creatorReferralVault: creatorReferralVault ?? null,
@@ -291,7 +263,6 @@ export async function buildSellExactInNativeAutoResolve(
 	return buildSellExactInNative({
 		...params,
 		creator: curve.creator,
-		pythPriceFeed: params.pythPriceFeed,
 	});
 }
 
@@ -299,13 +270,13 @@ export interface BuildBuyExactOutNativeParams {
 	user: PublicKey;
 	mint: PublicKey;
 	creator: PublicKey;
-	pythPriceFeed: PublicKey;
 	exactAmountOut: BN;
 	maxAmountIn: BN;
 	feeRecipient: PublicKey;
 	creatorReferralVault?: PublicKey | null;
 	traderReferralVault?: PublicKey | null;
 	userTokenAccount?: PublicKey;
+	pythPriceFeed?: PublicKey;
 	config: LiquidConfig;
 }
 
@@ -323,13 +294,13 @@ export function buildBuyExactOutNative(
 		user,
 		mint,
 		creator,
-		pythPriceFeed,
 		exactAmountOut,
 		maxAmountIn,
 		feeRecipient,
 		creatorReferralVault,
 		traderReferralVault,
 		userTokenAccount,
+		pythPriceFeed,
 		config,
 	} = params;
 
@@ -350,7 +321,7 @@ export function buildBuyExactOutNative(
 			user,
 			feeRecipient,
 			mint,
-			pythPriceFeed,
+			pythPriceFeed: pythPriceFeed ?? PYTH_SOL_USD_PRICE_FEED,
 			creatorUserProperties,
 			userTokenAccount: resolvedUserTokenAccount,
 			creatorReferralVault: creatorReferralVault ?? null,
@@ -383,7 +354,6 @@ export async function buildBuyExactOutNativeAutoResolve(
 	return buildBuyExactOutNative({
 		...params,
 		creator: curve.creator,
-		pythPriceFeed: params.pythPriceFeed,
 	});
 }
 
@@ -391,13 +361,13 @@ export interface BuildSellExactOutNativeParams {
 	user: PublicKey;
 	mint: PublicKey;
 	creator: PublicKey;
-	pythPriceFeed: PublicKey;
 	exactAmountOut: BN;
 	maxAmountIn: BN;
 	feeRecipient: PublicKey;
 	creatorReferralVault?: PublicKey | null;
 	traderReferralVault?: PublicKey | null;
 	userTokenAccount?: PublicKey;
+	pythPriceFeed?: PublicKey;
 	config: LiquidConfig;
 }
 
@@ -415,13 +385,13 @@ export function buildSellExactOutNative(
 		user,
 		mint,
 		creator,
-		pythPriceFeed,
 		exactAmountOut,
 		maxAmountIn,
 		feeRecipient,
 		creatorReferralVault,
 		traderReferralVault,
 		userTokenAccount,
+		pythPriceFeed,
 		config,
 	} = params;
 
@@ -442,7 +412,7 @@ export function buildSellExactOutNative(
 			user,
 			feeRecipient,
 			mint,
-			pythPriceFeed,
+			pythPriceFeed: pythPriceFeed ?? PYTH_SOL_USD_PRICE_FEED,
 			creatorUserProperties,
 			userTokenAccount: resolvedUserTokenAccount,
 			creatorReferralVault: creatorReferralVault ?? null,
@@ -475,7 +445,6 @@ export async function buildSellExactOutNativeAutoResolve(
 	return buildSellExactOutNative({
 		...params,
 		creator: curve.creator,
-		pythPriceFeed: params.pythPriceFeed,
 	});
 }
 
@@ -643,7 +612,7 @@ export function buildWithdrawReferralTokenRewards(
 export interface BuildExecuteBuybackNativeParams {
 	payer: PublicKey;
 	mint: PublicKey;
-	pythPriceFeed: PublicKey;
+	pythPriceFeed?: PublicKey;
 	config: LiquidConfig;
 }
 
@@ -665,7 +634,7 @@ export function buildExecuteBuybackNative(
 		.accountsPartial({
 			payer,
 			mint,
-			pythPriceFeed,
+			pythPriceFeed: pythPriceFeed ?? PYTH_SOL_USD_PRICE_FEED,
 		})
 		.instruction();
 }

package/src/oracle.ts

@@ -5,8 +5,6 @@
  * (mainnet, devnet, testnet, and localnet). Feed IDs are asset pair identifiers,
  * not account addresses. The actual price feed accounts differ per network, but all
  * contain data for this feed ID.
- *
- * Must match the constant in programs/liquid/src/instructions/shared/oracle.rs
  */
 export const SOL_USD_FEED_ID =
 	"0xef0d8b6fda2ceba41da15d4095d1da392a0d2f8ed0c6c7bc0f4cfac8c280b56d";
@@ -21,47 +19,6 @@ export const PYTH_EXPONENT = -8;
  */
 export const USD_DECIMALS = 6;
 
-/**
- * Calculates the initial virtual SOL reserves from the USD-denominated config value for a given virtual reserve value and SOL price.
- *
- * @param initialVirtualReserveUsd - Initial virtual reserve value in USD (6 decimals)
- * @param solPriceUsd - SOL price in USD (6 decimals)
- * @returns Initial virtual SOL reserves in lamports
- */
-export function calculateInitialVirtualSolReserves(
-	initialVirtualReserveUsd: bigint,
-	solPriceUsd: bigint,
-): bigint {
-	// virtual_sol (lamports) = initial_virtual_reserve_usd / sol_price_usd * 10^9
-	return (initialVirtualReserveUsd * BigInt(1_000_000_000)) / solPriceUsd;
-}
-
-/**
- * Calculates the market cap of a token in USD for native curves.
- *
- * Formula: market_cap_usd = (virtual_sol * sol_price / LAMPORTS_PER_SOL) * supply / virtual_token
- *
- * Uses a combined formula to avoid intermediate truncation that causes
- * coarse step granularity in a multi-step approach.
- *
- * @param virtualSolReserves - Virtual SOL reserves in lamports
- * @param virtualTokenReserves - Virtual token reserves (6 decimals)
- * @param tokenTotalSupply - Total supply of tokens (6 decimals)
- * @param solPriceUsd - SOL price in USD (6 decimals)
- * @returns Market cap in USD (6 decimals)
- */
-export function calculateNativeMarketCapUsd(
-	virtualSolReserves: bigint,
-	virtualTokenReserves: bigint,
-	tokenTotalSupply: bigint,
-	solPriceUsd: bigint,
-): bigint {
-	// Convert virtual SOL reserves to USD value, then compute FDV
-	const virtualSolUsd =
-		(virtualSolReserves * solPriceUsd) / BigInt(1_000_000_000);
-	return (virtualSolUsd * tokenTotalSupply) / virtualTokenReserves;
-}
-
 /**
  * Calculates the market cap of a token in USD for stable curves.
  *

package/src/types.ts

@@ -13,7 +13,7 @@ export type CurveStatus = (typeof CurveStatus)[keyof typeof CurveStatus];
 /** Anchor-serialized curve status representation */
 export type CurveStatusAnchor =
 	| { active: Record<string, never> }
-	| { complete: { solPriceSnapshot: BN } }
+	| { complete: Record<string, never> }
 	| { migrated: Record<string, never> };
 
 /**
@@ -75,8 +75,8 @@ export const feeModeEquals = (
 /** Global configuration for the bonding curve program */
 export interface GlobalConfiguration {
 	adminAuthority: PublicKey;
-	initialVirtualReserveUsd: BN;
-	migrationMarketCapUsd: BN;
+	initialVirtualUsdReserves: BN;
+	initialVirtualSolReserves: BN;
 	initialVirtualTokenReserves: BN;
 	initialRealTokenReserves: BN;
 	tokenTotalSupply: BN;
@@ -85,22 +85,23 @@ export interface GlobalConfiguration {
 	traderReferralRewardBasisPoints: number;
 	protocolFeeBasisPoints: number;
 	feeRecipients: PublicKey[];
-	quoteMints: PublicKey[];
 	solUsdPriceFeed: PublicKey;
+	quoteMints: PublicKey[];
 	pendingAdmin: PublicKey | null;
-	bump: number;
 	paused: boolean;
+	bump: number;
 }
 
-/** Native bonding curve account state */
+/** Unified bonding curve account state (native SOL and stable token curves) */
 export interface BondingCurveState {
 	creator: PublicKey;
 	tokenMint: PublicKey;
+	quoteMint: PublicKey | null;
 	realTokenReserves: BN;
 	virtualTokenReserves: BN;
-	realSolReserves: BN;
+	realQuoteReserves: BN;
+	initialVirtualQuoteReserves: BN;
 	tokenTotalSupply: BN;
-	initialVirtualReserveUsd: BN;
 	status: CurveStatusAnchor;
 	bump: number;
 }