@liquid-af/sdk 0.7.1 → 0.8.0

package/src/idl/liquid_swap.ts

@@ -70,23 +70,23 @@ export type LiquidSwap = {
       "args": []
     },
     {
-      "name": "buy",
+      "name": "buyExactIn",
       "docs": [
-        "Swap the tokens in the pool base output amount.",
+        "Buys base tokens by providing an exact amount of quote tokens (exact input).",
         "",
         "# Arguments",
-        "* `max_amount_in` -  input amount prevents excessive slippage",
-        "* `amount_out` -  amount of output token"
+        "* `amount_in` - Exact quote tokens to spend (before transfer fees).",
+        "* `minimum_amount_out` - Minimum base tokens to receive (after transfer fees; slippage protection)."
       ],
       "discriminator": [
-        102,
-        6,
-        61,
-        18,
-        1,
-        218,
-        235,
-        234
+        250,
+        234,
+        13,
+        123,
+        213,
+        156,
+        19,
+        236
       ],
       "accounts": [
         {
@@ -1046,33 +1046,33 @@ export type LiquidSwap = {
       ],
       "args": [
         {
-          "name": "maxAmountIn",
+          "name": "amountIn",
           "type": "u64"
         },
         {
-          "name": "amountOut",
+          "name": "minimumAmountOut",
           "type": "u64"
         }
       ]
     },
     {
-      "name": "buyExact",
+      "name": "buyExactOut",
       "docs": [
-        "Buys base tokens by providing an exact amount of quote tokens (exact input).",
+        "Buys base tokens by providing quote tokens to the pool (exact output).",
         "",
         "# Arguments",
-        "* `amount_in` - Exact quote tokens to spend.",
-        "* `minimum_amount_out` - Minimum base tokens to receive (slippage protection)."
+        "* `max_amount_in` - Maximum quote tokens willing to spend (including transfer fees; slippage protection).",
+        "* `amount_out` - Exact base tokens the user wants to receive (after transfer fees)."
       ],
       "discriminator": [
-        2,
-        162,
-        8,
-        52,
-        139,
-        46,
-        160,
-        13
+        24,
+        211,
+        116,
+        40,
+        105,
+        3,
+        153,
+        56
       ],
       "accounts": [
         {
@@ -2032,11 +2032,11 @@ export type LiquidSwap = {
       ],
       "args": [
         {
-          "name": "amountIn",
+          "name": "maxAmountIn",
           "type": "u64"
         },
         {
-          "name": "minimumAmountOut",
+          "name": "amountOut",
           "type": "u64"
         }
       ]
@@ -4184,23 +4184,23 @@ export type LiquidSwap = {
       "args": []
     },
     {
-      "name": "sell",
+      "name": "sellExactIn",
       "docs": [
-        "Swap the tokens in the pool base input amount.",
+        "Sells base tokens by providing them to the pool and receiving quote tokens (exact input).",
         "",
         "# Arguments",
-        "* `amount_in` -  input amount to transfer, output to DESTINATION is based on the exchange rate",
-        "* `minimum_amount_out` -  Minimum amount of output token, prevents excessive slippage"
+        "* `amount_in` - Exact amount of base tokens to sell (before transfer fees).",
+        "* `minimum_amount_out` - Minimum quote tokens expected (after transfer fees; slippage protection)."
       ],
       "discriminator": [
-        51,
-        230,
-        133,
-        164,
-        1,
-        127,
-        131,
-        173
+        149,
+        39,
+        222,
+        155,
+        211,
+        124,
+        152,
+        26
       ],
       "accounts": [
         {

package/src/instructions/index.ts

@@ -1,12 +1,12 @@
 export {
 	buildCreateNativeCurve,
 	buildBumpNative,
-	buildBuyNative,
-	buildBuyNativeAutoResolve,
-	buildSellNative,
-	buildSellNativeAutoResolve,
-	buildBuyExactNative,
-	buildBuyExactNativeAutoResolve,
+	buildBuyExactInNative,
+	buildBuyExactInNativeAutoResolve,
+	buildSellExactInNative,
+	buildSellExactInNativeAutoResolve,
+	buildBuyExactOutNative,
+	buildBuyExactOutNativeAutoResolve,
 	buildSellExactOutNative,
 	buildSellExactOutNativeAutoResolve,
 	buildMigrateNative,
@@ -17,12 +17,12 @@ export {
 	buildExecuteBuybackToken,
 	// Stable curve builders
 	buildCreateStableCurve,
-	buildBuyStable,
-	buildBuyStableAutoResolve,
-	buildSellStable,
-	buildSellStableAutoResolve,
-	buildBuyExactStable,
-	buildBuyExactStableAutoResolve,
+	buildBuyExactInStable,
+	buildBuyExactInStableAutoResolve,
+	buildSellExactInStable,
+	buildSellExactInStableAutoResolve,
+	buildBuyExactOutStable,
+	buildBuyExactOutStableAutoResolve,
 	buildSellExactOutStable,
 	buildSellExactOutStableAutoResolve,
 	buildMigrateStable,
@@ -32,9 +32,9 @@ export {
 export type {
 	BuildCreateNativeCurveParams,
 	BuildBumpNativeParams,
-	BuildBuyNativeParams,
-	BuildSellNativeParams,
-	BuildBuyExactNativeParams,
+	BuildBuyExactInNativeParams,
+	BuildSellExactInNativeParams,
+	BuildBuyExactOutNativeParams,
 	BuildSellExactOutNativeParams,
 	BuildMigrateNativeParams,
 	BuildInitializeNativeReferralVaultParams,
@@ -44,9 +44,9 @@ export type {
 	BuildExecuteBuybackTokenParams,
 	// Stable curve param types
 	BuildCreateStableCurveParams,
-	BuildBuyStableParams,
-	BuildSellStableParams,
-	BuildBuyExactStableParams,
+	BuildBuyExactInStableParams,
+	BuildSellExactInStableParams,
+	BuildBuyExactOutStableParams,
 	BuildSellExactOutStableParams,
 	BuildMigrateStableParams,
 	BuildInitializeFeeRecipientVaultsParams,
@@ -55,9 +55,9 @@ export type {
 
 export {
 	buildCreatePool,
-	buildSwapBuy,
-	buildSwapSell,
-	buildSwapBuyExact,
+	buildSwapBuyExactOut,
+	buildSwapSellExactIn,
+	buildSwapBuyExactIn,
 	buildSwapSellExactOut,
 	buildDeposit,
 	buildWithdraw,
@@ -65,9 +65,9 @@ export {
 } from "./liquid-swap.js";
 export type {
 	BuildCreatePoolParams,
-	BuildSwapBuyParams,
-	BuildSwapSellParams,
-	BuildSwapBuyExactParams,
+	BuildSwapBuyExactOutParams,
+	BuildSwapSellExactInParams,
+	BuildSwapBuyExactInParams,
 	BuildSwapSellExactOutParams,
 	BuildDepositParams,
 	BuildWithdrawParams,

package/src/instructions/liquid-swap.ts

@@ -70,7 +70,7 @@ export function buildCreatePool(
 		.instruction();
 }
 
-export interface BuildSwapBuyParams {
+export interface BuildSwapBuyExactOutParams {
 	payer: PublicKey;
 	creator: PublicKey;
 	baseMint: PublicKey;
@@ -85,13 +85,13 @@ export interface BuildSwapBuyParams {
 }
 
 /**
- * Builds a buy swap instruction (quote -> base).
+ * Builds a buyExactOut swap instruction (exact base output, quote input with slippage).
  *
- * @param params - {@link BuildSwapBuyParams}
+ * @param params - {@link BuildSwapBuyExactOutParams}
  * @returns Transaction instruction
  */
-export function buildSwapBuy(
-	params: BuildSwapBuyParams,
+export function buildSwapBuyExactOut(
+	params: BuildSwapBuyExactOutParams,
 ): Promise<TransactionInstruction> {
 	const {
 		payer,
@@ -122,7 +122,7 @@ export function buildSwapBuy(
 		quoteTokenProgram,
 	);
 	return program.methods
-		.buy(maxAmountIn, amountOut)
+		.buyExactOut(maxAmountIn, amountOut)
 		.accountsPartial({
 			payer,
 			creator,
@@ -142,7 +142,7 @@ export function buildSwapBuy(
 		.instruction();
 }
 
-export interface BuildSwapSellParams {
+export interface BuildSwapSellExactInParams {
 	payer: PublicKey;
 	creator: PublicKey;
 	baseMint: PublicKey;
@@ -157,13 +157,13 @@ export interface BuildSwapSellParams {
 }
 
 /**
- * Builds a sell swap instruction (base -> quote).
+ * Builds a sellExactIn swap instruction (exact base input, quote output with slippage).
  *
- * @param params - {@link BuildSwapSellParams}
+ * @param params - {@link BuildSwapSellExactInParams}
  * @returns Transaction instruction
  */
-export function buildSwapSell(
-	params: BuildSwapSellParams,
+export function buildSwapSellExactIn(
+	params: BuildSwapSellExactInParams,
 ): Promise<TransactionInstruction> {
 	const {
 		payer,
@@ -194,7 +194,7 @@ export function buildSwapSell(
 		quoteTokenProgram,
 	);
 	return program.methods
-		.sell(amountIn, minimumAmountOut)
+		.sellExactIn(amountIn, minimumAmountOut)
 		.accountsPartial({
 			payer,
 			creator,
@@ -214,7 +214,7 @@ export function buildSwapSell(
 		.instruction();
 }
 
-export interface BuildSwapBuyExactParams {
+export interface BuildSwapBuyExactInParams {
 	payer: PublicKey;
 	creator: PublicKey;
 	baseMint: PublicKey;
@@ -229,13 +229,13 @@ export interface BuildSwapBuyExactParams {
 }
 
 /**
- * Builds a buyExact swap instruction (exact quote input -> base output).
+ * Builds a buyExactIn swap instruction (exact quote input, base output with slippage).
  *
- * @param params - {@link BuildSwapBuyExactParams}
+ * @param params - {@link BuildSwapBuyExactInParams}
  * @returns Transaction instruction
  */
-export function buildSwapBuyExact(
-	params: BuildSwapBuyExactParams,
+export function buildSwapBuyExactIn(
+	params: BuildSwapBuyExactInParams,
 ): Promise<TransactionInstruction> {
 	const {
 		payer,
@@ -266,7 +266,7 @@ export function buildSwapBuyExact(
 		quoteTokenProgram,
 	);
 	return program.methods
-		.buyExact(amountIn, minimumAmountOut)
+		.buyExactIn(amountIn, minimumAmountOut)
 		.accountsPartial({
 			payer,
 			creator,

package/src/instructions/liquid.ts

@@ -108,7 +108,7 @@ export function buildBumpNative(
 		.instruction();
 }
 
-export interface BuildBuyNativeParams {
+export interface BuildBuyExactInNativeParams {
 	user: PublicKey;
 	mint: PublicKey;
 	creator: PublicKey;
@@ -125,11 +125,11 @@ export interface BuildBuyNativeParams {
  * Builds a buyNative instruction.
  * Requires the bonding curve creator and Pyth price feed to be known.
  *
- * @param params - {@link BuildBuyNativeParams}
+ * @param params - {@link BuildBuyExactInNativeParams}
  * @returns Transaction instruction
  */
-export function buildBuyNative(
-	params: BuildBuyNativeParams,
+export function buildBuyExactInNative(
+	params: BuildBuyExactInNativeParams,
 ): Promise<TransactionInstruction> {
 	const {
 		user,
@@ -153,7 +153,7 @@ export function buildBuyNative(
 	);
 
 	return program.methods
-		.buyNative(amountIn, minAmountOut)
+		.buyExactInNative(amountIn, minAmountOut)
 		.accountsPartial({
 			user,
 			feeRecipient,
@@ -172,29 +172,29 @@ export function buildBuyNative(
 
 /**
  * Builds a buyNative instruction, automatically fetching the bonding curve
- * creator from chain. Convenience wrapper around `buildBuyNative`.
+ * creator from chain. Convenience wrapper around `buildBuyExactInNative`.
  *
  * @param connection - Solana RPC connection
- * @param params - {@link BuildBuyNativeParams} without `creator`
+ * @param params - {@link BuildBuyExactInNativeParams} without `creator`
  * @returns Transaction instruction
  */
-export async function buildBuyNativeAutoResolve(
+export async function buildBuyExactInNativeAutoResolve(
 	connection: Connection,
-	params: Omit<BuildBuyNativeParams, "creator">,
+	params: Omit<BuildBuyExactInNativeParams, "creator">,
 ): Promise<TransactionInstruction> {
 	const curve = await fetchNativeBondingCurve(
 		connection,
 		params.mint,
 		params.config,
 	);
-	return buildBuyNative({
+	return buildBuyExactInNative({
 		...params,
 		creator: curve.creator,
 		pythPriceFeed: params.pythPriceFeed,
 	});
 }
 
-export interface BuildSellNativeParams {
+export interface BuildSellExactInNativeParams {
 	user: PublicKey;
 	mint: PublicKey;
 	creator: PublicKey;
@@ -211,11 +211,11 @@ export interface BuildSellNativeParams {
  * Builds a sellNative instruction.
  * Requires the bonding curve creator and Pyth price feed to be known.
  *
- * @param params - {@link BuildSellNativeParams}
+ * @param params - {@link BuildSellExactInNativeParams}
  * @returns Transaction instruction
  */
-export function buildSellNative(
-	params: BuildSellNativeParams,
+export function buildSellExactInNative(
+	params: BuildSellExactInNativeParams,
 ): Promise<TransactionInstruction> {
 	const {
 		user,
@@ -239,7 +239,7 @@ export function buildSellNative(
 	);
 
 	return program.methods
-		.sellNative(amountIn, minAmountOut)
+		.sellExactInNative(amountIn, minAmountOut)
 		.accountsPartial({
 			user,
 			feeRecipient,
@@ -258,29 +258,29 @@ export function buildSellNative(
 
 /**
  * Builds a sellNative instruction, automatically fetching the bonding curve
- * creator from chain. Convenience wrapper around `buildSellNative`.
+ * creator from chain. Convenience wrapper around `buildSellExactInNative`.
  *
  * @param connection - Solana RPC connection
- * @param params - {@link BuildSellNativeParams} without `creator`
+ * @param params - {@link BuildSellExactInNativeParams} without `creator`
  * @returns Transaction instruction
  */
-export async function buildSellNativeAutoResolve(
+export async function buildSellExactInNativeAutoResolve(
 	connection: Connection,
-	params: Omit<BuildSellNativeParams, "creator">,
+	params: Omit<BuildSellExactInNativeParams, "creator">,
 ): Promise<TransactionInstruction> {
 	const curve = await fetchNativeBondingCurve(
 		connection,
 		params.mint,
 		params.config,
 	);
-	return buildSellNative({
+	return buildSellExactInNative({
 		...params,
 		creator: curve.creator,
 		pythPriceFeed: params.pythPriceFeed,
 	});
 }
 
-export interface BuildBuyExactNativeParams {
+export interface BuildBuyExactOutNativeParams {
 	user: PublicKey;
 	mint: PublicKey;
 	creator: PublicKey;
@@ -297,11 +297,11 @@ export interface BuildBuyExactNativeParams {
  * Builds a buyExactNative instruction.
  * Buys an exact amount of tokens from the bonding curve, paying SOL.
  *
- * @param params - {@link BuildBuyExactNativeParams}
+ * @param params - {@link BuildBuyExactOutNativeParams}
  * @returns Transaction instruction
  */
-export function buildBuyExactNative(
-	params: BuildBuyExactNativeParams,
+export function buildBuyExactOutNative(
+	params: BuildBuyExactOutNativeParams,
 ): Promise<TransactionInstruction> {
 	const {
 		user,
@@ -324,7 +324,7 @@ export function buildBuyExactNative(
 	);
 
 	return program.methods
-		.buyExactNative(exactAmountOut, maxAmountIn)
+		.buyExactOutNative(exactAmountOut, maxAmountIn)
 		.accountsPartial({
 			user,
 			feeRecipient,
@@ -343,22 +343,22 @@ export function buildBuyExactNative(
 
 /**
  * Builds a buyExactNative instruction, automatically fetching the bonding curve
- * creator from chain. Convenience wrapper around `buildBuyExactNative`.
+ * creator from chain. Convenience wrapper around `buildBuyExactOutNative`.
  *
  * @param connection - Solana RPC connection
- * @param params - {@link BuildBuyExactNativeParams} without `creator`
+ * @param params - {@link BuildBuyExactOutNativeParams} without `creator`
  * @returns Transaction instruction
  */
-export async function buildBuyExactNativeAutoResolve(
+export async function buildBuyExactOutNativeAutoResolve(
 	connection: Connection,
-	params: Omit<BuildBuyExactNativeParams, "creator">,
+	params: Omit<BuildBuyExactOutNativeParams, "creator">,
 ): Promise<TransactionInstruction> {
 	const curve = await fetchNativeBondingCurve(
 		connection,
 		params.mint,
 		params.config,
 	);
-	return buildBuyExactNative({
+	return buildBuyExactOutNative({
 		...params,
 		creator: curve.creator,
 		pythPriceFeed: params.pythPriceFeed,
@@ -722,7 +722,7 @@ export function buildCreateStableCurve(
 		.instruction();
 }
 
-export interface BuildBuyStableParams {
+export interface BuildBuyExactInStableParams {
 	user: PublicKey;
 	mint: PublicKey;
 	quoteMint: PublicKey;
@@ -739,11 +739,11 @@ export interface BuildBuyStableParams {
  * Builds a buyStable instruction.
  * Buys tokens from a token-based bonding curve using quote tokens (e.g., USDC).
  *
- * @param params - {@link BuildBuyStableParams}
+ * @param params - {@link BuildBuyExactInStableParams}
  * @returns Transaction instruction
  */
-export function buildBuyStable(
-	params: BuildBuyStableParams,
+export function buildBuyExactInStable(
+	params: BuildBuyExactInStableParams,
 ): Promise<TransactionInstruction> {
 	const {
 		user,
@@ -784,7 +784,7 @@ export function buildBuyStable(
 	);
 
 	return program.methods
-		.buyStable(amountIn, minAmountOut)
+		.buyExactInStable(amountIn, minAmountOut)
 		.accountsPartial({
 			user,
 			mint,
@@ -804,25 +804,25 @@ export function buildBuyStable(
 
 /**
  * Builds a buyStable instruction, automatically fetching the bonding curve
- * creator from chain. Convenience wrapper around `buildBuyStable`.
+ * creator from chain. Convenience wrapper around `buildBuyExactInStable`.
  *
  * @param connection - Solana RPC connection
- * @param params - {@link BuildBuyStableParams} without `creator`
+ * @param params - {@link BuildBuyExactInStableParams} without `creator`
  * @returns Transaction instruction
  */
-export async function buildBuyStableAutoResolve(
+export async function buildBuyExactInStableAutoResolve(
 	connection: Connection,
-	params: Omit<BuildBuyStableParams, "creator">,
+	params: Omit<BuildBuyExactInStableParams, "creator">,
 ): Promise<TransactionInstruction> {
 	const curve = await fetchStableBondingCurve(
 		connection,
 		params.mint,
 		params.config,
 	);
-	return buildBuyStable({ ...params, creator: curve.creator });
+	return buildBuyExactInStable({ ...params, creator: curve.creator });
 }
 
-export interface BuildSellStableParams {
+export interface BuildSellExactInStableParams {
 	user: PublicKey;
 	mint: PublicKey;
 	quoteMint: PublicKey;
@@ -839,11 +839,11 @@ export interface BuildSellStableParams {
  * Builds a sellStable instruction.
  * Sells tokens to a token-based bonding curve for quote tokens (e.g., USDC).
  *
- * @param params - {@link BuildSellStableParams}
+ * @param params - {@link BuildSellExactInStableParams}
  * @returns Transaction instruction
  */
-export function buildSellStable(
-	params: BuildSellStableParams,
+export function buildSellExactInStable(
+	params: BuildSellExactInStableParams,
 ): Promise<TransactionInstruction> {
 	const {
 		user,
@@ -884,7 +884,7 @@ export function buildSellStable(
 	);
 
 	return program.methods
-		.sellStable(amountIn, minAmountOut)
+		.sellExactInStable(amountIn, minAmountOut)
 		.accountsPartial({
 			user,
 			mint,
@@ -904,25 +904,25 @@ export function buildSellStable(
 
 /**
  * Builds a sellStable instruction, automatically fetching the bonding curve
- * creator from chain. Convenience wrapper around `buildSellStable`.
+ * creator from chain. Convenience wrapper around `buildSellExactInStable`.
  *
  * @param connection - Solana RPC connection
- * @param params - {@link BuildSellStableParams} without `creator`
+ * @param params - {@link BuildSellExactInStableParams} without `creator`
  * @returns Transaction instruction
  */
-export async function buildSellStableAutoResolve(
+export async function buildSellExactInStableAutoResolve(
 	connection: Connection,
-	params: Omit<BuildSellStableParams, "creator">,
+	params: Omit<BuildSellExactInStableParams, "creator">,
 ): Promise<TransactionInstruction> {
 	const curve = await fetchStableBondingCurve(
 		connection,
 		params.mint,
 		params.config,
 	);
-	return buildSellStable({ ...params, creator: curve.creator });
+	return buildSellExactInStable({ ...params, creator: curve.creator });
 }
 
-export interface BuildBuyExactStableParams {
+export interface BuildBuyExactOutStableParams {
 	user: PublicKey;
 	mint: PublicKey;
 	quoteMint: PublicKey;
@@ -939,11 +939,11 @@ export interface BuildBuyExactStableParams {
  * Builds a buyExactStable instruction.
  * Buys an exact amount of tokens from a token-based bonding curve using quote tokens.
  *
- * @param params - {@link BuildBuyExactStableParams}
+ * @param params - {@link BuildBuyExactOutStableParams}
  * @returns Transaction instruction
  */
-export function buildBuyExactStable(
-	params: BuildBuyExactStableParams,
+export function buildBuyExactOutStable(
+	params: BuildBuyExactOutStableParams,
 ): Promise<TransactionInstruction> {
 	const {
 		user,
@@ -982,7 +982,7 @@ export function buildBuyExactStable(
 	);
 
 	return program.methods
-		.buyExactStable(exactAmountOut, maxAmountIn)
+		.buyExactOutStable(exactAmountOut, maxAmountIn)
 		.accountsPartial({
 			user,
 			mint,
@@ -1002,22 +1002,22 @@ export function buildBuyExactStable(
 
 /**
  * Builds a buyExactStable instruction, automatically fetching the bonding curve
- * creator from chain. Convenience wrapper around `buildBuyExactStable`.
+ * creator from chain. Convenience wrapper around `buildBuyExactOutStable`.
  *
  * @param connection - Solana RPC connection
- * @param params - {@link BuildBuyExactStableParams} without `creator`
+ * @param params - {@link BuildBuyExactOutStableParams} without `creator`
  * @returns Transaction instruction
  */
-export async function buildBuyExactStableAutoResolve(
+export async function buildBuyExactOutStableAutoResolve(
 	connection: Connection,
-	params: Omit<BuildBuyExactStableParams, "creator">,
+	params: Omit<BuildBuyExactOutStableParams, "creator">,
 ): Promise<TransactionInstruction> {
 	const curve = await fetchStableBondingCurve(
 		connection,
 		params.mint,
 		params.config,
 	);
-	return buildBuyExactStable({ ...params, creator: curve.creator });
+	return buildBuyExactOutStable({ ...params, creator: curve.creator });
 }
 
 export interface BuildSellExactOutStableParams {