@liquid-af/sdk 0.5.8 → 0.6.0

package/src/instructions/index.ts

@@ -5,6 +5,10 @@ export {
 	buildBuyNativeAutoResolve,
 	buildSellNative,
 	buildSellNativeAutoResolve,
+	buildBuyExactNative,
+	buildBuyExactNativeAutoResolve,
+	buildSellExactOutNative,
+	buildSellExactOutNativeAutoResolve,
 	buildMigrateNative,
 	buildInitializeNativeReferralVault,
 	buildWithdrawReferralRewards,
@@ -17,6 +21,10 @@ export {
 	buildBuyStableAutoResolve,
 	buildSellStable,
 	buildSellStableAutoResolve,
+	buildBuyExactStable,
+	buildBuyExactStableAutoResolve,
+	buildSellExactOutStable,
+	buildSellExactOutStableAutoResolve,
 	buildMigrateStable,
 	buildInitializeFeeRecipientVaults,
 	buildInitializeReferralTokenVault,
@@ -26,6 +34,8 @@ export type {
 	BuildBumpNativeParams,
 	BuildBuyNativeParams,
 	BuildSellNativeParams,
+	BuildBuyExactNativeParams,
+	BuildSellExactOutNativeParams,
 	BuildMigrateNativeParams,
 	BuildInitializeNativeReferralVaultParams,
 	BuildWithdrawReferralRewardsParams,
@@ -36,6 +46,8 @@ export type {
 	BuildCreateStableCurveParams,
 	BuildBuyStableParams,
 	BuildSellStableParams,
+	BuildBuyExactStableParams,
+	BuildSellExactOutStableParams,
 	BuildMigrateStableParams,
 	BuildInitializeFeeRecipientVaultsParams,
 	BuildInitializeReferralTokenVaultParams,
@@ -45,6 +57,8 @@ export {
 	buildCreatePool,
 	buildSwapBuy,
 	buildSwapSell,
+	buildSwapBuyExact,
+	buildSwapSellExactOut,
 	buildDeposit,
 	buildWithdraw,
 	buildSwapExecuteBuyback,
@@ -53,6 +67,8 @@ export type {
 	BuildCreatePoolParams,
 	BuildSwapBuyParams,
 	BuildSwapSellParams,
+	BuildSwapBuyExactParams,
+	BuildSwapSellExactOutParams,
 	BuildDepositParams,
 	BuildWithdrawParams,
 	BuildSwapExecuteBuybackParams,

package/src/instructions/liquid-swap.ts

@@ -214,6 +214,150 @@ export function buildSwapSell(
 		.instruction();
 }
 
+export interface BuildSwapBuyExactParams {
+	payer: PublicKey;
+	creator: PublicKey;
+	baseMint: PublicKey;
+	quoteMint: PublicKey;
+	baseTokenProgram: PublicKey;
+	quoteTokenProgram: PublicKey;
+	amountIn: BN;
+	minimumAmountOut: BN;
+	feeRecipient: PublicKey;
+	oraclePriceFeed?: PublicKey;
+	config: LiquidConfig;
+}
+
+/**
+ * Builds a buyExact swap instruction (exact quote input -> base output).
+ *
+ * @param params - {@link BuildSwapBuyExactParams}
+ * @returns Transaction instruction
+ */
+export function buildSwapBuyExact(
+	params: BuildSwapBuyExactParams,
+): Promise<TransactionInstruction> {
+	const {
+		payer,
+		creator,
+		baseMint,
+		quoteMint,
+		baseTokenProgram,
+		quoteTokenProgram,
+		amountIn,
+		minimumAmountOut,
+		feeRecipient,
+		oraclePriceFeed,
+		config,
+	} = params;
+
+	const program = getCachedSwapProgram(config);
+
+	const baseTokenAccount = getAssociatedTokenAddressSync(
+		baseMint,
+		payer,
+		false,
+		baseTokenProgram,
+	);
+	const quoteTokenAccount = getAssociatedTokenAddressSync(
+		quoteMint,
+		payer,
+		false,
+		quoteTokenProgram,
+	);
+	return program.methods
+		.buyExact(amountIn, minimumAmountOut)
+		.accountsPartial({
+			payer,
+			creator,
+			baseTokenAccount,
+			quoteTokenAccount,
+			baseTokenProgram,
+			quoteTokenProgram,
+			baseMint,
+			quoteMint,
+			feeRecipient,
+			liquidState: {
+				user: payer,
+				tokenMint: baseMint,
+			},
+			...(oraclePriceFeed ? { oraclePriceFeed } : {}),
+		})
+		.instruction();
+}
+
+export interface BuildSwapSellExactOutParams {
+	payer: PublicKey;
+	creator: PublicKey;
+	baseMint: PublicKey;
+	quoteMint: PublicKey;
+	baseTokenProgram: PublicKey;
+	quoteTokenProgram: PublicKey;
+	maxAmountIn: BN;
+	exactAmountOut: BN;
+	feeRecipient: PublicKey;
+	oraclePriceFeed?: PublicKey;
+	config: LiquidConfig;
+}
+
+/**
+ * Builds a sellExactOut swap instruction (base input -> exact quote output).
+ *
+ * @param params - {@link BuildSwapSellExactOutParams}
+ * @returns Transaction instruction
+ */
+export function buildSwapSellExactOut(
+	params: BuildSwapSellExactOutParams,
+): Promise<TransactionInstruction> {
+	const {
+		payer,
+		creator,
+		baseMint,
+		quoteMint,
+		baseTokenProgram,
+		quoteTokenProgram,
+		maxAmountIn,
+		exactAmountOut,
+		feeRecipient,
+		oraclePriceFeed,
+		config,
+	} = params;
+
+	const program = getCachedSwapProgram(config);
+
+	const baseTokenAccount = getAssociatedTokenAddressSync(
+		baseMint,
+		payer,
+		false,
+		baseTokenProgram,
+	);
+	const quoteTokenAccount = getAssociatedTokenAddressSync(
+		quoteMint,
+		payer,
+		false,
+		quoteTokenProgram,
+	);
+	return program.methods
+		.sellExactOut(maxAmountIn, exactAmountOut)
+		.accountsPartial({
+			payer,
+			creator,
+			baseTokenAccount,
+			quoteTokenAccount,
+			baseTokenProgram,
+			quoteTokenProgram,
+			baseMint,
+			quoteMint,
+			feeRecipient,
+			liquidState: {
+				user: payer,
+				tokenMint: baseMint,
+			},
+			...(oraclePriceFeed ? { oraclePriceFeed } : {}),
+		})
+		.instruction();
+}
+
 export interface BuildDepositParams {
 	owner: PublicKey;
 	poolAddress: PublicKey;

package/src/instructions/liquid.ts

@@ -280,6 +280,176 @@ export async function buildSellNativeAutoResolve(
 	});
 }
 
+export interface BuildBuyExactNativeParams {
+	user: PublicKey;
+	mint: PublicKey;
+	creator: PublicKey;
+	pythPriceFeed: PublicKey;
+	exactAmountOut: BN;
+	maxAmountIn: BN;
+	feeRecipient: PublicKey;
+	creatorReferralVault?: PublicKey | null;
+	traderReferralVault?: PublicKey | null;
+	config: LiquidConfig;
+}
+
+/**
+ * Builds a buyExactNative instruction.
+ * Buys an exact amount of tokens from the bonding curve, paying SOL.
+ *
+ * @param params - {@link BuildBuyExactNativeParams}
+ * @returns Transaction instruction
+ */
+export function buildBuyExactNative(
+	params: BuildBuyExactNativeParams,
+): Promise<TransactionInstruction> {
+	const {
+		user,
+		mint,
+		creator,
+		pythPriceFeed,
+		exactAmountOut,
+		maxAmountIn,
+		feeRecipient,
+		creatorReferralVault,
+		traderReferralVault,
+		config,
+	} = params;
+
+	const program = getCachedLiquidProgram(config);
+
+	const [creatorUserProperties] = getUserPropertiesPDA(
+		creator,
+		config.liquidStateProgramId,
+	);
+
+	return program.methods
+		.buyExactNative(exactAmountOut, maxAmountIn)
+		.accountsPartial({
+			user,
+			feeRecipient,
+			mint,
+			pythPriceFeed,
+			creatorUserProperties,
+			creatorReferralVault: creatorReferralVault ?? null,
+			traderReferralVault: traderReferralVault ?? null,
+			liquidState: {
+				user,
+				tokenMint: mint,
+			},
+		})
+		.instruction();
+}
+
+/**
+ * Builds a buyExactNative instruction, automatically fetching the bonding curve
+ * creator from chain. Convenience wrapper around `buildBuyExactNative`.
+ *
+ * @param connection - Solana RPC connection
+ * @param params - {@link BuildBuyExactNativeParams} without `creator`
+ * @returns Transaction instruction
+ */
+export async function buildBuyExactNativeAutoResolve(
+	connection: Connection,
+	params: Omit<BuildBuyExactNativeParams, "creator">,
+): Promise<TransactionInstruction> {
+	const curve = await fetchNativeBondingCurve(
+		connection,
+		params.mint,
+		params.config,
+	);
+	return buildBuyExactNative({
+		...params,
+		creator: curve.creator,
+		pythPriceFeed: params.pythPriceFeed,
+	});
+}
+
+export interface BuildSellExactOutNativeParams {
+	user: PublicKey;
+	mint: PublicKey;
+	creator: PublicKey;
+	pythPriceFeed: PublicKey;
+	exactAmountOut: BN;
+	maxAmountIn: BN;
+	feeRecipient: PublicKey;
+	creatorReferralVault?: PublicKey | null;
+	traderReferralVault?: PublicKey | null;
+	config: LiquidConfig;
+}
+
+/**
+ * Builds a sellExactOutNative instruction.
+ * Sells tokens to receive an exact amount of SOL from the bonding curve.
+ *
+ * @param params - {@link BuildSellExactOutNativeParams}
+ * @returns Transaction instruction
+ */
+export function buildSellExactOutNative(
+	params: BuildSellExactOutNativeParams,
+): Promise<TransactionInstruction> {
+	const {
+		user,
+		mint,
+		creator,
+		pythPriceFeed,
+		exactAmountOut,
+		maxAmountIn,
+		feeRecipient,
+		creatorReferralVault,
+		traderReferralVault,
+		config,
+	} = params;
+
+	const program = getCachedLiquidProgram(config);
+
+	const [creatorUserProperties] = getUserPropertiesPDA(
+		creator,
+		config.liquidStateProgramId,
+	);
+
+	return program.methods
+		.sellExactOutNative(exactAmountOut, maxAmountIn)
+		.accountsPartial({
+			user,
+			feeRecipient,
+			mint,
+			pythPriceFeed,
+			creatorUserProperties,
+			creatorReferralVault: creatorReferralVault ?? null,
+			traderReferralVault: traderReferralVault ?? null,
+			liquidState: {
+				user,
+				tokenMint: mint,
+			},
+		})
+		.instruction();
+}
+
+/**
+ * Builds a sellExactOutNative instruction, automatically fetching the bonding curve
+ * creator from chain. Convenience wrapper around `buildSellExactOutNative`.
+ *
+ * @param connection - Solana RPC connection
+ * @param params - {@link BuildSellExactOutNativeParams} without `creator`
+ * @returns Transaction instruction
+ */
+export async function buildSellExactOutNativeAutoResolve(
+	connection: Connection,
+	params: Omit<BuildSellExactOutNativeParams, "creator">,
+): Promise<TransactionInstruction> {
+	const curve = await fetchNativeBondingCurve(
+		connection,
+		params.mint,
+		params.config,
+	);
+	return buildSellExactOutNative({
+		...params,
+		creator: curve.creator,
+		pythPriceFeed: params.pythPriceFeed,
+	});
+}
+
 export interface BuildMigrateNativeParams {
 	migrator: PublicKey;
 	mint: PublicKey;
@@ -752,6 +922,202 @@ export async function buildSellStableAutoResolve(
 	return buildSellStable({ ...params, creator: curve.creator });
 }
 
+export interface BuildBuyExactStableParams {
+	user: PublicKey;
+	mint: PublicKey;
+	quoteMint: PublicKey;
+	creator: PublicKey;
+	exactAmountOut: BN;
+	maxAmountIn: BN;
+	feeRecipient: PublicKey;
+	creatorReferralVault?: PublicKey | null;
+	traderReferralVault?: PublicKey | null;
+	config: LiquidConfig;
+}
+
+/**
+ * Builds a buyExactStable instruction.
+ * Buys an exact amount of tokens from a token-based bonding curve using quote tokens.
+ *
+ * @param params - {@link BuildBuyExactStableParams}
+ * @returns Transaction instruction
+ */
+export function buildBuyExactStable(
+	params: BuildBuyExactStableParams,
+): Promise<TransactionInstruction> {
+	const {
+		user,
+		mint,
+		quoteMint,
+		creator,
+		exactAmountOut,
+		maxAmountIn,
+		feeRecipient,
+		creatorReferralVault,
+		traderReferralVault,
+		config,
+	} = params;
+
+	const program = getCachedLiquidProgram(config);
+
+	const feeRecipientQuoteAccount = getAssociatedTokenAddressSync(
+		quoteMint,
+		feeRecipient,
+		true,
+		TOKEN_PROGRAM_ID,
+	);
+
+	const [creatorUserProperties] = getUserPropertiesPDA(
+		creator,
+		config.liquidStateProgramId,
+	);
+
+	const [bondingCurve] = getStableBondingCurvePDA(
+		mint,
+		config.liquidProgramId,
+	);
+	const [buybackVault] = getBuybackVaultPDA(
+		bondingCurve,
+		config.liquidProgramId,
+	);
+
+	return program.methods
+		.buyExactStable(exactAmountOut, maxAmountIn)
+		.accountsPartial({
+			user,
+			mint,
+			quoteMint,
+			feeRecipient: feeRecipientQuoteAccount,
+			creatorUserProperties,
+			creatorReferralVault: creatorReferralVault ?? null,
+			traderReferralVault: traderReferralVault ?? null,
+			buybackVault,
+			liquidState: {
+				user,
+				tokenMint: mint,
+			},
+		})
+		.instruction();
+}
+
+/**
+ * Builds a buyExactStable instruction, automatically fetching the bonding curve
+ * creator from chain. Convenience wrapper around `buildBuyExactStable`.
+ *
+ * @param connection - Solana RPC connection
+ * @param params - {@link BuildBuyExactStableParams} without `creator`
+ * @returns Transaction instruction
+ */
+export async function buildBuyExactStableAutoResolve(
+	connection: Connection,
+	params: Omit<BuildBuyExactStableParams, "creator">,
+): Promise<TransactionInstruction> {
+	const curve = await fetchStableBondingCurve(
+		connection,
+		params.mint,
+		params.config,
+	);
+	return buildBuyExactStable({ ...params, creator: curve.creator });
+}
+
+export interface BuildSellExactOutStableParams {
+	user: PublicKey;
+	mint: PublicKey;
+	quoteMint: PublicKey;
+	creator: PublicKey;
+	exactAmountOut: BN;
+	maxAmountIn: BN;
+	feeRecipient: PublicKey;
+	creatorReferralVault?: PublicKey | null;
+	traderReferralVault?: PublicKey | null;
+	config: LiquidConfig;
+}
+
+/**
+ * Builds a sellExactOutStable instruction.
+ * Sells tokens to receive an exact amount of quote tokens from a token-based bonding curve.
+ *
+ * @param params - {@link BuildSellExactOutStableParams}
+ * @returns Transaction instruction
+ */
+export function buildSellExactOutStable(
+	params: BuildSellExactOutStableParams,
+): Promise<TransactionInstruction> {
+	const {
+		user,
+		mint,
+		quoteMint,
+		creator,
+		exactAmountOut,
+		maxAmountIn,
+		feeRecipient,
+		creatorReferralVault,
+		traderReferralVault,
+		config,
+	} = params;
+
+	const program = getCachedLiquidProgram(config);
+
+	const feeRecipientQuoteAccount = getAssociatedTokenAddressSync(
+		quoteMint,
+		feeRecipient,
+		true,
+		TOKEN_PROGRAM_ID,
+	);
+
+	const [creatorUserProperties] = getUserPropertiesPDA(
+		creator,
+		config.liquidStateProgramId,
+	);
+
+	const [bondingCurve] = getStableBondingCurvePDA(
+		mint,
+		config.liquidProgramId,
+	);
+	const [buybackVault] = getBuybackVaultPDA(
+		bondingCurve,
+		config.liquidProgramId,
+	);
+
+	return program.methods
+		.sellExactOutStable(exactAmountOut, maxAmountIn)
+		.accountsPartial({
+			user,
+			mint,
+			quoteMint,
+			feeRecipient: feeRecipientQuoteAccount,
+			creatorUserProperties,
+			creatorReferralVault: creatorReferralVault ?? null,
+			traderReferralVault: traderReferralVault ?? null,
+			buybackVault,
+			liquidState: {
+				user,
+				tokenMint: mint,
+			},
+		})
+		.instruction();
+}
+
+/**
+ * Builds a sellExactOutStable instruction, automatically fetching the bonding curve
+ * creator from chain. Convenience wrapper around `buildSellExactOutStable`.
+ *
+ * @param connection - Solana RPC connection
+ * @param params - {@link BuildSellExactOutStableParams} without `creator`
+ * @returns Transaction instruction
+ */
+export async function buildSellExactOutStableAutoResolve(
+	connection: Connection,
+	params: Omit<BuildSellExactOutStableParams, "creator">,
+): Promise<TransactionInstruction> {
+	const curve = await fetchStableBondingCurve(
+		connection,
+		params.mint,
+		params.config,
+	);
+	return buildSellExactOutStable({ ...params, creator: curve.creator });
+}
+
 export interface BuildMigrateStableParams {
 	migrator: PublicKey;
 	mint: PublicKey;