@meteora-ag/zap-sdk 1.1.2 → 1.2.0

package/README.md

@@ -16,6 +16,25 @@ pnpm install @meteora-ag/zap-sdk
 yarn add @meteora-ag/zap-sdk
 ```
 
+## Jupiter API Setup
+
+All Jupiter-related functions (`getJupiterQuote`, `getJupiterSwapInstruction`, and estimate functions) support custom API configuration.
+
+### Getting Your Jupiter API Key
+
+As of January 31st 2026, Jupiter requires an API key for all api request to https://api.jup.ag/. Obtain your API key at the [Jupiter Portal](https://portal.jup.ag/)
+
+For detailed setup instructions, see [Jupiter's Setup Guide](https://dev.jup.ag/portal/setup).
+
+### API Parameters
+
+All Jupiter functions accept optional `jupiterApiUrl` and `jupiterApiKey` parameters:
+
+- `jupiterApiUrl` (optional): The Jupiter API endpoint. Default: `"https://api.jup.ag"`
+- `jupiterApiKey` (optional): Your Jupiter API key. Default: `""` (empty string)
+
+**Note**: While the API key parameter is optional in the function signature, Jupiter requires an API key for all requests. Using the default empty string may result in API errors.
+
 ## Initialization
 
 ```typescript
@@ -23,7 +42,10 @@ import { Connection } from "@solana/web3.js";
 import { Zap } from "@meteora-ag/zap-sdk";
 
 const connection = new Connection("https://api.mainnet-beta.solana.com");
-const zap = new Zap(connection);
+const jupiterApiUrl = "https://api.jup.ag";
+const jupiterApiKey = "YOUR_API_KEY_HERE";
+
+const zap = new Zap(connection, jupiterApiUrl, jupiterApiKey);
 ```
 
 ## Usage

package/dist/index.d.mts

@@ -1575,6 +1575,10 @@ type Zap$1 = {
 };
 
 type ZapProgram = Program<Zap$1>;
+type ZapConfig = {
+    jupiterApiUrl?: string;
+    jupiterApiKey?: string;
+};
 type ZapOutParameters = IdlTypes<Zap$1>["zapOutParameters"];
 type ZapOutParams = {
     userTokenInAccount: PublicKey;
@@ -1799,6 +1803,7 @@ interface EstimateDlmmDirectSwapParams {
     maxDeltaId: number;
     strategy: StrategyType;
     singleSided?: DlmmSingleSided;
+    config?: ZapConfig;
 }
 interface DlmmDirectSwapEstimateContext {
     amountIn: BN;
@@ -1830,6 +1835,7 @@ interface EstimateDlmmRebalanceSwapParams {
     maxDeltaId: number;
     swapSlippageBps: number;
     strategy: StrategyType;
+    config?: ZapConfig;
 }
 interface DlmmDirectRebalanceEstimateContext {
     lbPair: PublicKey;
@@ -1854,6 +1860,7 @@ interface EstimateDlmmIndirectSwapParams {
     maxDeltaId: number;
     strategy: StrategyType;
     singleSided?: DlmmSingleSided;
+    config?: ZapConfig;
 }
 interface DlmmIndirectSwapEstimateResult {
     swapToX: JupiterQuoteResponse | null;
@@ -1998,8 +2005,14 @@ type ZapInDlmmResponse = {
 
 declare class Zap {
     private connection;
+    private jupiterApiUrl;
+    private jupiterApiKey;
     zapProgram: ZapProgram;
-    constructor(connection: Connection);
+    /**
+     * @param connection - The connection to the Solana cluster
+     * @param config - Optional configuration for Jupiter API URL (default: https://api.jup.ag) and API key (default: empty string)
+     */
+    constructor(connection: Connection, config?: ZapConfig);
     private initializeLedgerAccount;
     private closeLedgerAccount;
     private setLedgerBalance;
@@ -2232,9 +2245,9 @@ declare class Zap {
     zapOutThroughDlmm(params: ZapOutThroughDlmmParams): Promise<Transaction>;
 }
 
-declare function getJupiterQuote(inputMint: PublicKey, outputMint: PublicKey, amount: BN, maxAccounts: number, slippageBps: number, dynamicSlippage: boolean | undefined, onlyDirectRoutes: boolean, restrictIntermediateTokens: boolean, apiUrl?: string, apiKey?: string): Promise<JupiterQuoteResponse | null>;
-declare function getJupiterSwapInstruction(userPublicKey: PublicKey, quoteResponse: any, apiUrl?: string, apiKey?: string): Promise<JupiterSwapInstructionResponse>;
-declare function buildJupiterSwapTransaction(user: PublicKey, inputMint: PublicKey, outputMint: PublicKey, amount: BN, maxAccounts: number, slippageBps: number, jupiterQuoteResponse?: JupiterQuoteResponse): Promise<{
+declare function getJupiterQuote(inputMint: PublicKey, outputMint: PublicKey, amount: BN, maxAccounts: number, slippageBps: number, dynamicSlippage: boolean | undefined, onlyDirectRoutes: boolean, restrictIntermediateTokens: boolean, config?: ZapConfig): Promise<JupiterQuoteResponse | null>;
+declare function getJupiterSwapInstruction(userPublicKey: PublicKey, quoteResponse: any, config?: ZapConfig): Promise<JupiterSwapInstructionResponse>;
+declare function buildJupiterSwapTransaction(user: PublicKey, inputMint: PublicKey, outputMint: PublicKey, amount: BN, maxAccounts: number, slippageBps: number, jupiterQuoteResponse?: JupiterQuoteResponse, config?: ZapConfig): Promise<{
     transaction: Transaction;
     quoteResponse: JupiterQuoteResponse;
 }>;
@@ -2357,11 +2370,12 @@ declare function getExtraAccountMetasForTransferHook(connection: Connection, min
  * @param params.maxDeltaId - Maximum bin delta from active bin
  * @param params.strategy - Strategy type for the position
  * @param params.singleSided - Optional single-sided deposit mode (X or Y only) - default is non-single-sided
+ * @param params.config - Optional configuration for Jupiter API URL (default: https://api.jup.ag) and API key (default: empty string)
  * @returns IndirectSwapEstimate with swap details and post-swap token amounts
  * @throws if inputTokenMint matches any token in the DLMM pool
  * @throws if failed to get Jupiter swap quote
  */
-declare function estimateDlmmIndirectSwap({ amountIn, inputTokenMint, lbPair, connection, swapSlippageBps, minDeltaId, maxDeltaId, strategy, singleSided, }: EstimateDlmmIndirectSwapParams): Promise<DlmmIndirectSwapEstimate>;
+declare function estimateDlmmIndirectSwap({ amountIn, inputTokenMint, lbPair, connection, swapSlippageBps, minDeltaId, maxDeltaId, strategy, singleSided, config, }: EstimateDlmmIndirectSwapParams): Promise<DlmmIndirectSwapEstimate>;
 /**
  * Calculate optimal swap amount for zap-in deposits (single token input)
  *
@@ -2378,10 +2392,11 @@ declare function estimateDlmmIndirectSwap({ amountIn, inputTokenMint, lbPair, co
  * @param params.maxDeltaId - Maximum bin delta from active bin
  * @param params.strategy - Strategy type for the position
  * @param params.singleSided - Optional single-sided deposit mode (X or Y only) - default is non-single-sided
+ * @param params.config - Optional configuration for Jupiter API URL (default: https://api.jup.ag) and API key (default: empty string)
  * @returns DirectSwapEstimate with swap details and post-swap token amounts
  * @throws if failed to get both Jupiter and DLMM swap quotes
  */
-declare function estimateDlmmDirectSwap({ amountIn, inputTokenMint, lbPair, connection, swapSlippageBps, minDeltaId, maxDeltaId, strategy, singleSided, }: EstimateDlmmDirectSwapParams): Promise<DlmmDirectSwapEstimate>;
+declare function estimateDlmmDirectSwap({ amountIn, inputTokenMint, lbPair, connection, swapSlippageBps, minDeltaId, maxDeltaId, strategy, singleSided, config, }: EstimateDlmmDirectSwapParams): Promise<DlmmDirectSwapEstimate>;
 /**
  * Calculate optimal swap amount for rebalancing existing positions (both tokens)
  *
@@ -2396,10 +2411,11 @@ declare function estimateDlmmDirectSwap({ amountIn, inputTokenMint, lbPair, conn
  * @param params.minDeltaId - Minimum bin delta from active bin
  * @param params.maxDeltaId - Maximum bin delta from active bin
  * @param params.strategy - Strategy type for the position
+ * @param params.config - Optional configuration for Jupiter API URL (default: https://api.jup.ag) and API key (default: empty string)
  * @returns DirectSwapEstimate with swap details and post-swap token amounts
  * @throws if failed to get both Jupiter and DLMM swap quotes
  */
-declare function estimateDlmmRebalanceSwap({ lbPair, position, connection, swapSlippageBps, minDeltaId, maxDeltaId, strategy, }: EstimateDlmmRebalanceSwapParams): Promise<DlmmDirectRebalanceEstimate>;
+declare function estimateDlmmRebalanceSwap({ lbPair, position, connection, swapSlippageBps, minDeltaId, maxDeltaId, strategy, config, }: EstimateDlmmRebalanceSwapParams): Promise<DlmmDirectRebalanceEstimate>;
 
 declare const ZAP_PROGRAM_ID: PublicKey;
 declare const JUP_V6_PROGRAM_ID: PublicKey;
@@ -2423,6 +2439,7 @@ declare const AMOUNT_IN_DLMM_OFFSET = 8;
 declare const AMOUNT_IN_JUP_V6_REVERSE_OFFSET = 19;
 declare const AMOUNT_IN_DAMM_V2_OFFSET = 8;
 declare const DAMM_V2_SWAP_DISCRIMINATOR: number[];
+declare const DEFAULT_JUPITER_API_URL = "https://api.jup.ag";
 
 var address = "zapvX9M3uf5pvy4wRPAbQgdQsM1xmuiFnkfHKPvwMiz";
 var metadata = {
@@ -4304,4 +4321,4 @@ var idl = {
 	constants: constants
 };
 
-export { AMOUNT_IN_DAMM_V2_OFFSET, AMOUNT_IN_DLMM_OFFSET, AMOUNT_IN_JUP_V6_REVERSE_OFFSET, AccountsType, BIN_ARRAY_INDEX_BOUND, DAMM_V2_PROGRAM_ID, DAMM_V2_SWAP_DISCRIMINATOR, DLMM_PROGRAM_ID, DLMM_SWAP_DISCRIMINATOR, type DlmmDirectEstimateResult, type DlmmDirectRebalanceEstimate, type DlmmDirectRebalanceEstimateContext, type DlmmDirectSwapEstimate, type DlmmDirectSwapEstimateContext, DlmmDirectSwapQuoteRoute, type DlmmIndirectSwapEstimate, type DlmmIndirectSwapEstimateContext, type DlmmIndirectSwapEstimateResult, DlmmSingleSided, DlmmSwapType, type EstimateDlmmDirectSwapParams, type EstimateDlmmIndirectSwapParams, type EstimateDlmmRebalanceSwapParams, type GetZapInDammV2DirectPoolParams, type GetZapInDammV2IndirectPoolParams, type GetZapInDlmmDirectParams, type GetZapInDlmmIndirectParams, JUP_V6_PROGRAM_ID, type JupiterInstruction, type JupiterQuoteResponse, type JupiterRoutePlan, type JupiterSwapInstructionResponse, MEMO_PROGRAM_ID, type ProgramStrategyType, type RebalanceDlmmPositionParams, type RebalanceDlmmPositionResponse, SwapExternalType, type SwapQuoteResult, ZAP_PROGRAM_ID, Zap, idl as ZapIdl, type ZapInDammV2DirectPoolParam, type ZapInDammV2IndirectPoolParam, ZapInDammV2PoolSwapRoute, type ZapInDammV2Response, type ZapInDlmmDirectPoolParam, type ZapInDlmmIndirectPoolParam, type ZapInDlmmResponse, type ZapOutParameters, type ZapOutParams, type ZapOutThroughDammV2Params, type ZapOutThroughDlmmParams, type ZapOutThroughJupiterParams, type ZapProgram, type Zap$1 as ZapTypes, buildJupiterSwapTransaction, convertAccountTypeToNumber, convertLamportsToUiAmount, convertUiAmountToLamports, createDammV2SwapPayload, createDlmmSwapPayload, deriveDammV2EventAuthority, deriveDammV2PoolAuthority, deriveDlmmEventAuthority, deriveLedgerAccount, estimateDlmmDirectSwap, estimateDlmmIndirectSwap, estimateDlmmRebalanceSwap, filterOutCloseSplTokenAccountInstructions, getBinArrayBitmapExtension, getBitFromBinArrayIndexInBitmapExtension, getDammV2Pool, getDammV2RemainingAccounts, getDlmmRemainingAccounts, getExtraAccountMetasForTransferHook, getJupiterQuote, getJupiterSwapInstruction, getLbPairState, getNextBinArrayIndexWithLiquidity, getOrCreateATAInstruction, getTokenAccountBalance, getTokenProgramFromMint, toProgramStrategyType, unwrapSOLInstruction, wrapSOLInstruction };
+export { AMOUNT_IN_DAMM_V2_OFFSET, AMOUNT_IN_DLMM_OFFSET, AMOUNT_IN_JUP_V6_REVERSE_OFFSET, AccountsType, BIN_ARRAY_INDEX_BOUND, DAMM_V2_PROGRAM_ID, DAMM_V2_SWAP_DISCRIMINATOR, DEFAULT_JUPITER_API_URL, DLMM_PROGRAM_ID, DLMM_SWAP_DISCRIMINATOR, type DlmmDirectEstimateResult, type DlmmDirectRebalanceEstimate, type DlmmDirectRebalanceEstimateContext, type DlmmDirectSwapEstimate, type DlmmDirectSwapEstimateContext, DlmmDirectSwapQuoteRoute, type DlmmIndirectSwapEstimate, type DlmmIndirectSwapEstimateContext, type DlmmIndirectSwapEstimateResult, DlmmSingleSided, DlmmSwapType, type EstimateDlmmDirectSwapParams, type EstimateDlmmIndirectSwapParams, type EstimateDlmmRebalanceSwapParams, type GetZapInDammV2DirectPoolParams, type GetZapInDammV2IndirectPoolParams, type GetZapInDlmmDirectParams, type GetZapInDlmmIndirectParams, JUP_V6_PROGRAM_ID, type JupiterInstruction, type JupiterQuoteResponse, type JupiterRoutePlan, type JupiterSwapInstructionResponse, MEMO_PROGRAM_ID, type ProgramStrategyType, type RebalanceDlmmPositionParams, type RebalanceDlmmPositionResponse, SwapExternalType, type SwapQuoteResult, ZAP_PROGRAM_ID, Zap, type ZapConfig, idl as ZapIdl, type ZapInDammV2DirectPoolParam, type ZapInDammV2IndirectPoolParam, ZapInDammV2PoolSwapRoute, type ZapInDammV2Response, type ZapInDlmmDirectPoolParam, type ZapInDlmmIndirectPoolParam, type ZapInDlmmResponse, type ZapOutParameters, type ZapOutParams, type ZapOutThroughDammV2Params, type ZapOutThroughDlmmParams, type ZapOutThroughJupiterParams, type ZapProgram, type Zap$1 as ZapTypes, buildJupiterSwapTransaction, convertAccountTypeToNumber, convertLamportsToUiAmount, convertUiAmountToLamports, createDammV2SwapPayload, createDlmmSwapPayload, deriveDammV2EventAuthority, deriveDammV2PoolAuthority, deriveDlmmEventAuthority, deriveLedgerAccount, estimateDlmmDirectSwap, estimateDlmmIndirectSwap, estimateDlmmRebalanceSwap, filterOutCloseSplTokenAccountInstructions, getBinArrayBitmapExtension, getBitFromBinArrayIndexInBitmapExtension, getDammV2Pool, getDammV2RemainingAccounts, getDlmmRemainingAccounts, getExtraAccountMetasForTransferHook, getJupiterQuote, getJupiterSwapInstruction, getLbPairState, getNextBinArrayIndexWithLiquidity, getOrCreateATAInstruction, getTokenAccountBalance, getTokenProgramFromMint, toProgramStrategyType, unwrapSOLInstruction, wrapSOLInstruction };

package/dist/index.d.ts

@@ -1575,6 +1575,10 @@ type Zap$1 = {
 };
 
 type ZapProgram = Program<Zap$1>;
+type ZapConfig = {
+    jupiterApiUrl?: string;
+    jupiterApiKey?: string;
+};
 type ZapOutParameters = IdlTypes<Zap$1>["zapOutParameters"];
 type ZapOutParams = {
     userTokenInAccount: PublicKey;
@@ -1799,6 +1803,7 @@ interface EstimateDlmmDirectSwapParams {
     maxDeltaId: number;
     strategy: StrategyType;
     singleSided?: DlmmSingleSided;
+    config?: ZapConfig;
 }
 interface DlmmDirectSwapEstimateContext {
     amountIn: BN;
@@ -1830,6 +1835,7 @@ interface EstimateDlmmRebalanceSwapParams {
     maxDeltaId: number;
     swapSlippageBps: number;
     strategy: StrategyType;
+    config?: ZapConfig;
 }
 interface DlmmDirectRebalanceEstimateContext {
     lbPair: PublicKey;
@@ -1854,6 +1860,7 @@ interface EstimateDlmmIndirectSwapParams {
     maxDeltaId: number;
     strategy: StrategyType;
     singleSided?: DlmmSingleSided;
+    config?: ZapConfig;
 }
 interface DlmmIndirectSwapEstimateResult {
     swapToX: JupiterQuoteResponse | null;
@@ -1998,8 +2005,14 @@ type ZapInDlmmResponse = {
 
 declare class Zap {
     private connection;
+    private jupiterApiUrl;
+    private jupiterApiKey;
     zapProgram: ZapProgram;
-    constructor(connection: Connection);
+    /**
+     * @param connection - The connection to the Solana cluster
+     * @param config - Optional configuration for Jupiter API URL (default: https://api.jup.ag) and API key (default: empty string)
+     */
+    constructor(connection: Connection, config?: ZapConfig);
     private initializeLedgerAccount;
     private closeLedgerAccount;
     private setLedgerBalance;
@@ -2232,9 +2245,9 @@ declare class Zap {
     zapOutThroughDlmm(params: ZapOutThroughDlmmParams): Promise<Transaction>;
 }
 
-declare function getJupiterQuote(inputMint: PublicKey, outputMint: PublicKey, amount: BN, maxAccounts: number, slippageBps: number, dynamicSlippage: boolean | undefined, onlyDirectRoutes: boolean, restrictIntermediateTokens: boolean, apiUrl?: string, apiKey?: string): Promise<JupiterQuoteResponse | null>;
-declare function getJupiterSwapInstruction(userPublicKey: PublicKey, quoteResponse: any, apiUrl?: string, apiKey?: string): Promise<JupiterSwapInstructionResponse>;
-declare function buildJupiterSwapTransaction(user: PublicKey, inputMint: PublicKey, outputMint: PublicKey, amount: BN, maxAccounts: number, slippageBps: number, jupiterQuoteResponse?: JupiterQuoteResponse): Promise<{
+declare function getJupiterQuote(inputMint: PublicKey, outputMint: PublicKey, amount: BN, maxAccounts: number, slippageBps: number, dynamicSlippage: boolean | undefined, onlyDirectRoutes: boolean, restrictIntermediateTokens: boolean, config?: ZapConfig): Promise<JupiterQuoteResponse | null>;
+declare function getJupiterSwapInstruction(userPublicKey: PublicKey, quoteResponse: any, config?: ZapConfig): Promise<JupiterSwapInstructionResponse>;
+declare function buildJupiterSwapTransaction(user: PublicKey, inputMint: PublicKey, outputMint: PublicKey, amount: BN, maxAccounts: number, slippageBps: number, jupiterQuoteResponse?: JupiterQuoteResponse, config?: ZapConfig): Promise<{
     transaction: Transaction;
     quoteResponse: JupiterQuoteResponse;
 }>;
@@ -2357,11 +2370,12 @@ declare function getExtraAccountMetasForTransferHook(connection: Connection, min
  * @param params.maxDeltaId - Maximum bin delta from active bin
  * @param params.strategy - Strategy type for the position
  * @param params.singleSided - Optional single-sided deposit mode (X or Y only) - default is non-single-sided
+ * @param params.config - Optional configuration for Jupiter API URL (default: https://api.jup.ag) and API key (default: empty string)
  * @returns IndirectSwapEstimate with swap details and post-swap token amounts
  * @throws if inputTokenMint matches any token in the DLMM pool
  * @throws if failed to get Jupiter swap quote
  */
-declare function estimateDlmmIndirectSwap({ amountIn, inputTokenMint, lbPair, connection, swapSlippageBps, minDeltaId, maxDeltaId, strategy, singleSided, }: EstimateDlmmIndirectSwapParams): Promise<DlmmIndirectSwapEstimate>;
+declare function estimateDlmmIndirectSwap({ amountIn, inputTokenMint, lbPair, connection, swapSlippageBps, minDeltaId, maxDeltaId, strategy, singleSided, config, }: EstimateDlmmIndirectSwapParams): Promise<DlmmIndirectSwapEstimate>;
 /**
  * Calculate optimal swap amount for zap-in deposits (single token input)
  *
@@ -2378,10 +2392,11 @@ declare function estimateDlmmIndirectSwap({ amountIn, inputTokenMint, lbPair, co
  * @param params.maxDeltaId - Maximum bin delta from active bin
  * @param params.strategy - Strategy type for the position
  * @param params.singleSided - Optional single-sided deposit mode (X or Y only) - default is non-single-sided
+ * @param params.config - Optional configuration for Jupiter API URL (default: https://api.jup.ag) and API key (default: empty string)
  * @returns DirectSwapEstimate with swap details and post-swap token amounts
  * @throws if failed to get both Jupiter and DLMM swap quotes
  */
-declare function estimateDlmmDirectSwap({ amountIn, inputTokenMint, lbPair, connection, swapSlippageBps, minDeltaId, maxDeltaId, strategy, singleSided, }: EstimateDlmmDirectSwapParams): Promise<DlmmDirectSwapEstimate>;
+declare function estimateDlmmDirectSwap({ amountIn, inputTokenMint, lbPair, connection, swapSlippageBps, minDeltaId, maxDeltaId, strategy, singleSided, config, }: EstimateDlmmDirectSwapParams): Promise<DlmmDirectSwapEstimate>;
 /**
  * Calculate optimal swap amount for rebalancing existing positions (both tokens)
  *
@@ -2396,10 +2411,11 @@ declare function estimateDlmmDirectSwap({ amountIn, inputTokenMint, lbPair, conn
  * @param params.minDeltaId - Minimum bin delta from active bin
  * @param params.maxDeltaId - Maximum bin delta from active bin
  * @param params.strategy - Strategy type for the position
+ * @param params.config - Optional configuration for Jupiter API URL (default: https://api.jup.ag) and API key (default: empty string)
  * @returns DirectSwapEstimate with swap details and post-swap token amounts
  * @throws if failed to get both Jupiter and DLMM swap quotes
  */
-declare function estimateDlmmRebalanceSwap({ lbPair, position, connection, swapSlippageBps, minDeltaId, maxDeltaId, strategy, }: EstimateDlmmRebalanceSwapParams): Promise<DlmmDirectRebalanceEstimate>;
+declare function estimateDlmmRebalanceSwap({ lbPair, position, connection, swapSlippageBps, minDeltaId, maxDeltaId, strategy, config, }: EstimateDlmmRebalanceSwapParams): Promise<DlmmDirectRebalanceEstimate>;
 
 declare const ZAP_PROGRAM_ID: PublicKey;
 declare const JUP_V6_PROGRAM_ID: PublicKey;
@@ -2423,6 +2439,7 @@ declare const AMOUNT_IN_DLMM_OFFSET = 8;
 declare const AMOUNT_IN_JUP_V6_REVERSE_OFFSET = 19;
 declare const AMOUNT_IN_DAMM_V2_OFFSET = 8;
 declare const DAMM_V2_SWAP_DISCRIMINATOR: number[];
+declare const DEFAULT_JUPITER_API_URL = "https://api.jup.ag";
 
 var address = "zapvX9M3uf5pvy4wRPAbQgdQsM1xmuiFnkfHKPvwMiz";
 var metadata = {
@@ -4304,4 +4321,4 @@ var idl = {
 	constants: constants
 };
 
-export { AMOUNT_IN_DAMM_V2_OFFSET, AMOUNT_IN_DLMM_OFFSET, AMOUNT_IN_JUP_V6_REVERSE_OFFSET, AccountsType, BIN_ARRAY_INDEX_BOUND, DAMM_V2_PROGRAM_ID, DAMM_V2_SWAP_DISCRIMINATOR, DLMM_PROGRAM_ID, DLMM_SWAP_DISCRIMINATOR, type DlmmDirectEstimateResult, type DlmmDirectRebalanceEstimate, type DlmmDirectRebalanceEstimateContext, type DlmmDirectSwapEstimate, type DlmmDirectSwapEstimateContext, DlmmDirectSwapQuoteRoute, type DlmmIndirectSwapEstimate, type DlmmIndirectSwapEstimateContext, type DlmmIndirectSwapEstimateResult, DlmmSingleSided, DlmmSwapType, type EstimateDlmmDirectSwapParams, type EstimateDlmmIndirectSwapParams, type EstimateDlmmRebalanceSwapParams, type GetZapInDammV2DirectPoolParams, type GetZapInDammV2IndirectPoolParams, type GetZapInDlmmDirectParams, type GetZapInDlmmIndirectParams, JUP_V6_PROGRAM_ID, type JupiterInstruction, type JupiterQuoteResponse, type JupiterRoutePlan, type JupiterSwapInstructionResponse, MEMO_PROGRAM_ID, type ProgramStrategyType, type RebalanceDlmmPositionParams, type RebalanceDlmmPositionResponse, SwapExternalType, type SwapQuoteResult, ZAP_PROGRAM_ID, Zap, idl as ZapIdl, type ZapInDammV2DirectPoolParam, type ZapInDammV2IndirectPoolParam, ZapInDammV2PoolSwapRoute, type ZapInDammV2Response, type ZapInDlmmDirectPoolParam, type ZapInDlmmIndirectPoolParam, type ZapInDlmmResponse, type ZapOutParameters, type ZapOutParams, type ZapOutThroughDammV2Params, type ZapOutThroughDlmmParams, type ZapOutThroughJupiterParams, type ZapProgram, type Zap$1 as ZapTypes, buildJupiterSwapTransaction, convertAccountTypeToNumber, convertLamportsToUiAmount, convertUiAmountToLamports, createDammV2SwapPayload, createDlmmSwapPayload, deriveDammV2EventAuthority, deriveDammV2PoolAuthority, deriveDlmmEventAuthority, deriveLedgerAccount, estimateDlmmDirectSwap, estimateDlmmIndirectSwap, estimateDlmmRebalanceSwap, filterOutCloseSplTokenAccountInstructions, getBinArrayBitmapExtension, getBitFromBinArrayIndexInBitmapExtension, getDammV2Pool, getDammV2RemainingAccounts, getDlmmRemainingAccounts, getExtraAccountMetasForTransferHook, getJupiterQuote, getJupiterSwapInstruction, getLbPairState, getNextBinArrayIndexWithLiquidity, getOrCreateATAInstruction, getTokenAccountBalance, getTokenProgramFromMint, toProgramStrategyType, unwrapSOLInstruction, wrapSOLInstruction };
+export { AMOUNT_IN_DAMM_V2_OFFSET, AMOUNT_IN_DLMM_OFFSET, AMOUNT_IN_JUP_V6_REVERSE_OFFSET, AccountsType, BIN_ARRAY_INDEX_BOUND, DAMM_V2_PROGRAM_ID, DAMM_V2_SWAP_DISCRIMINATOR, DEFAULT_JUPITER_API_URL, DLMM_PROGRAM_ID, DLMM_SWAP_DISCRIMINATOR, type DlmmDirectEstimateResult, type DlmmDirectRebalanceEstimate, type DlmmDirectRebalanceEstimateContext, type DlmmDirectSwapEstimate, type DlmmDirectSwapEstimateContext, DlmmDirectSwapQuoteRoute, type DlmmIndirectSwapEstimate, type DlmmIndirectSwapEstimateContext, type DlmmIndirectSwapEstimateResult, DlmmSingleSided, DlmmSwapType, type EstimateDlmmDirectSwapParams, type EstimateDlmmIndirectSwapParams, type EstimateDlmmRebalanceSwapParams, type GetZapInDammV2DirectPoolParams, type GetZapInDammV2IndirectPoolParams, type GetZapInDlmmDirectParams, type GetZapInDlmmIndirectParams, JUP_V6_PROGRAM_ID, type JupiterInstruction, type JupiterQuoteResponse, type JupiterRoutePlan, type JupiterSwapInstructionResponse, MEMO_PROGRAM_ID, type ProgramStrategyType, type RebalanceDlmmPositionParams, type RebalanceDlmmPositionResponse, SwapExternalType, type SwapQuoteResult, ZAP_PROGRAM_ID, Zap, type ZapConfig, idl as ZapIdl, type ZapInDammV2DirectPoolParam, type ZapInDammV2IndirectPoolParam, ZapInDammV2PoolSwapRoute, type ZapInDammV2Response, type ZapInDlmmDirectPoolParam, type ZapInDlmmIndirectPoolParam, type ZapInDlmmResponse, type ZapOutParameters, type ZapOutParams, type ZapOutThroughDammV2Params, type ZapOutThroughDlmmParams, type ZapOutThroughJupiterParams, type ZapProgram, type Zap$1 as ZapTypes, buildJupiterSwapTransaction, convertAccountTypeToNumber, convertLamportsToUiAmount, convertUiAmountToLamports, createDammV2SwapPayload, createDlmmSwapPayload, deriveDammV2EventAuthority, deriveDammV2PoolAuthority, deriveDlmmEventAuthority, deriveLedgerAccount, estimateDlmmDirectSwap, estimateDlmmIndirectSwap, estimateDlmmRebalanceSwap, filterOutCloseSplTokenAccountInstructions, getBinArrayBitmapExtension, getBitFromBinArrayIndexInBitmapExtension, getDammV2Pool, getDammV2RemainingAccounts, getDlmmRemainingAccounts, getExtraAccountMetasForTransferHook, getJupiterQuote, getJupiterSwapInstruction, getLbPairState, getNextBinArrayIndexWithLiquidity, getOrCreateATAInstruction, getTokenAccountBalance, getTokenProgramFromMint, toProgramStrategyType, unwrapSOLInstruction, wrapSOLInstruction };

package/dist/index.js

@@ -74,6 +74,7 @@ __export(index_exports, {
   BIN_ARRAY_INDEX_BOUND: () => BIN_ARRAY_INDEX_BOUND,
   DAMM_V2_PROGRAM_ID: () => DAMM_V2_PROGRAM_ID,
   DAMM_V2_SWAP_DISCRIMINATOR: () => DAMM_V2_SWAP_DISCRIMINATOR,
+  DEFAULT_JUPITER_API_URL: () => DEFAULT_JUPITER_API_URL,
   DLMM_PROGRAM_ID: () => DLMM_PROGRAM_ID,
   DLMM_SWAP_DISCRIMINATOR: () => DLMM_SWAP_DISCRIMINATOR,
   DlmmDirectSwapQuoteRoute: () => DlmmDirectSwapQuoteRoute,
@@ -1723,9 +1724,63 @@ var DlmmSingleSided = /* @__PURE__ */ ((DlmmSingleSided2) => {
 })(DlmmSingleSided || {});
 
 // src/helpers/jupiter.ts
+var import_web32 = require("@solana/web3.js");
+
+// src/constants.ts
 var import_web3 = require("@solana/web3.js");
-function getJupiterQuote(inputMint, outputMint, amount, maxAccounts, slippageBps, dynamicSlippage = false, onlyDirectRoutes, restrictIntermediateTokens, apiUrl = "https://lite-api.jup.ag", apiKey) {
-  return __async(this, null, function* () {
+var import_bn = __toESM(require("bn.js"));
+var import_dlmm = require("@meteora-ag/dlmm");
+var ZAP_PROGRAM_ID = new import_web3.PublicKey(idl_default.address);
+var JUP_V6_PROGRAM_ID = new import_web3.PublicKey(
+  "JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4"
+);
+var DAMM_V2_PROGRAM_ID = new import_web3.PublicKey(
+  "cpamdpZCGKUy5JxQXB4dcpGPiikHawvSWAd6mEn1sGG"
+);
+var DLMM_PROGRAM_ID = new import_web3.PublicKey(
+  "LBUZKhRxPF3XUpBCjp4YzTKgLccjZhTSDM9YuVaPwxo"
+);
+var MEMO_PROGRAM_ID = new import_web3.PublicKey(
+  "MemoSq4gqABAXKb96qnH8TysNcWxMyWCqXgDLGmfcHr"
+);
+var BIN_ARRAY_INDEX_BOUND = [
+  import_dlmm.BIN_ARRAY_BITMAP_SIZE.mul(
+    import_dlmm.EXTENSION_BINARRAY_BITMAP_SIZE.add(new import_bn.default(1))
+  ).neg(),
+  import_dlmm.BIN_ARRAY_BITMAP_SIZE.mul(import_dlmm.EXTENSION_BINARRAY_BITMAP_SIZE.add(new import_bn.default(1))).sub(
+    new import_bn.default(1)
+  )
+];
+var AccountsType = {
+  TransferHookX: {
+    transferHookX: {}
+  },
+  TransferHookY: {
+    transferHookY: {}
+  },
+  TransferHookReward: {
+    transferHookReward: {}
+  }
+};
+var DLMM_SWAP_DISCRIMINATOR = [65, 75, 63, 76, 235, 91, 91, 136];
+var AMOUNT_IN_DLMM_OFFSET = 8;
+var AMOUNT_IN_JUP_V6_REVERSE_OFFSET = 19;
+var AMOUNT_IN_DAMM_V2_OFFSET = 8;
+var DAMM_V2_SWAP_DISCRIMINATOR = [
+  248,
+  198,
+  158,
+  145,
+  225,
+  117,
+  135,
+  200
+];
+var DEFAULT_JUPITER_API_URL = "https://api.jup.ag";
+
+// src/helpers/jupiter.ts
+function getJupiterQuote(_0, _1, _2, _3, _4) {
+  return __async(this, arguments, function* (inputMint, outputMint, amount, maxAccounts, slippageBps, dynamicSlippage = false, onlyDirectRoutes, restrictIntermediateTokens, config = {}) {
     const params = new URLSearchParams({
       inputMint: inputMint.toString(),
       outputMint: outputMint.toString(),
@@ -1736,14 +1791,14 @@ function getJupiterQuote(inputMint, outputMint, amount, maxAccounts, slippageBps
       restrictIntermediateTokens: restrictIntermediateTokens.toString(),
       dynamicSlippage: dynamicSlippage.toString()
     });
-    const url = `${apiUrl}/swap/v1/quote?${params.toString()}`;
+    const url = `${config.jupiterApiUrl || DEFAULT_JUPITER_API_URL}/swap/v1/quote?${params.toString()}`;
     let response = null;
     try {
       response = yield fetch(url, {
         method: "GET",
         headers: __spreadValues({
           Accept: "application/json"
-        }, apiKey ? { "x-api-key": apiKey } : {})
+        }, config.jupiterApiKey ? { "x-api-key": config.jupiterApiKey } : {})
       });
       if (!response.ok) {
         return null;
@@ -1755,9 +1810,9 @@ function getJupiterQuote(inputMint, outputMint, amount, maxAccounts, slippageBps
     return result;
   });
 }
-function getJupiterSwapInstruction(userPublicKey, quoteResponse, apiUrl = "https://lite-api.jup.ag", apiKey) {
-  return __async(this, null, function* () {
-    const url = `${apiUrl}/swap/v1/swap-instructions`;
+function getJupiterSwapInstruction(_0, _1) {
+  return __async(this, arguments, function* (userPublicKey, quoteResponse, config = {}) {
+    const url = `${config.jupiterApiUrl || DEFAULT_JUPITER_API_URL}/swap/v1/swap-instructions`;
     const requestBody = {
       userPublicKey: userPublicKey.toString(),
       quoteResponse
@@ -1769,7 +1824,7 @@ function getJupiterSwapInstruction(userPublicKey, quoteResponse, apiUrl = "https
         headers: __spreadValues({
           "Content-Type": "application/json",
           Accept: "application/json"
-        }, apiKey ? { "x-api-key": apiKey } : {}),
+        }, config.jupiterApiKey ? { "x-api-key": config.jupiterApiKey } : {}),
         body: JSON.stringify(requestBody)
       });
       if (!response.ok) {
@@ -1785,8 +1840,8 @@ function getJupiterSwapInstruction(userPublicKey, quoteResponse, apiUrl = "https
     return result;
   });
 }
-function buildJupiterSwapTransaction(user, inputMint, outputMint, amount, maxAccounts, slippageBps, jupiterQuoteResponse) {
-  return __async(this, null, function* () {
+function buildJupiterSwapTransaction(_0, _1, _2, _3, _4, _5, _6) {
+  return __async(this, arguments, function* (user, inputMint, outputMint, amount, maxAccounts, slippageBps, jupiterQuoteResponse, config = {}) {
     const quoteResponse = jupiterQuoteResponse != null ? jupiterQuoteResponse : yield getJupiterQuote(
       inputMint,
       outputMint,
@@ -1796,7 +1851,7 @@ function buildJupiterSwapTransaction(user, inputMint, outputMint, amount, maxAcc
       false,
       true,
       true,
-      "https://lite-api.jup.ag"
+      config
     );
     if (!quoteResponse) {
       throw new Error(
@@ -1805,78 +1860,26 @@ function buildJupiterSwapTransaction(user, inputMint, outputMint, amount, maxAcc
     }
     const swapInstructionResponse = yield getJupiterSwapInstruction(
       user,
-      quoteResponse
+      quoteResponse,
+      config
     );
-    const instruction = new import_web3.TransactionInstruction({
+    const instruction = new import_web32.TransactionInstruction({
       keys: swapInstructionResponse.swapInstruction.accounts.map((item) => {
         return {
-          pubkey: new import_web3.PublicKey(item.pubkey),
+          pubkey: new import_web32.PublicKey(item.pubkey),
           isSigner: item.isSigner,
           isWritable: item.isWritable
         };
       }),
-      programId: new import_web3.PublicKey(swapInstructionResponse.swapInstruction.programId),
+      programId: new import_web32.PublicKey(swapInstructionResponse.swapInstruction.programId),
       data: Buffer.from(swapInstructionResponse.swapInstruction.data, "base64")
     });
-    return { transaction: new import_web3.Transaction().add(instruction), quoteResponse };
+    return { transaction: new import_web32.Transaction().add(instruction), quoteResponse };
   });
 }
 
 // src/helpers/dammV2.ts
 var import_spl_token = require("@solana/spl-token");
-
-// src/constants.ts
-var import_web32 = require("@solana/web3.js");
-var import_bn = __toESM(require("bn.js"));
-var import_dlmm = require("@meteora-ag/dlmm");
-var ZAP_PROGRAM_ID = new import_web32.PublicKey(idl_default.address);
-var JUP_V6_PROGRAM_ID = new import_web32.PublicKey(
-  "JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4"
-);
-var DAMM_V2_PROGRAM_ID = new import_web32.PublicKey(
-  "cpamdpZCGKUy5JxQXB4dcpGPiikHawvSWAd6mEn1sGG"
-);
-var DLMM_PROGRAM_ID = new import_web32.PublicKey(
-  "LBUZKhRxPF3XUpBCjp4YzTKgLccjZhTSDM9YuVaPwxo"
-);
-var MEMO_PROGRAM_ID = new import_web32.PublicKey(
-  "MemoSq4gqABAXKb96qnH8TysNcWxMyWCqXgDLGmfcHr"
-);
-var BIN_ARRAY_INDEX_BOUND = [
-  import_dlmm.BIN_ARRAY_BITMAP_SIZE.mul(
-    import_dlmm.EXTENSION_BINARRAY_BITMAP_SIZE.add(new import_bn.default(1))
-  ).neg(),
-  import_dlmm.BIN_ARRAY_BITMAP_SIZE.mul(import_dlmm.EXTENSION_BINARRAY_BITMAP_SIZE.add(new import_bn.default(1))).sub(
-    new import_bn.default(1)
-  )
-];
-var AccountsType = {
-  TransferHookX: {
-    transferHookX: {}
-  },
-  TransferHookY: {
-    transferHookY: {}
-  },
-  TransferHookReward: {
-    transferHookReward: {}
-  }
-};
-var DLMM_SWAP_DISCRIMINATOR = [65, 75, 63, 76, 235, 91, 91, 136];
-var AMOUNT_IN_DLMM_OFFSET = 8;
-var AMOUNT_IN_JUP_V6_REVERSE_OFFSET = 19;
-var AMOUNT_IN_DAMM_V2_OFFSET = 8;
-var DAMM_V2_SWAP_DISCRIMINATOR = [
-  248,
-  198,
-  158,
-  145,
-  225,
-  117,
-  135,
-  200
-];
-
-// src/helpers/dammV2.ts
 var import_cp_amm_sdk = require("@meteora-ag/cp-amm-sdk");
 
 // src/helpers/pda.ts
@@ -2474,8 +2477,8 @@ function estimateSwapOutput(inAmount, effectiveRate) {
   const estimatedOutput = inAmountDecimal.mul(effectiveRate);
   return new import_bn3.default(estimatedOutput.floor().toString());
 }
-function getBestSwapQuoteJupiterDlmm(dlmm, inMint, outMint, inAmount, swapSlippageBps, swapForY, binArrays) {
-  return __async(this, null, function* () {
+function getBestSwapQuoteJupiterDlmm(_0, _1, _2, _3, _4, _5, _6) {
+  return __async(this, arguments, function* (dlmm, inMint, outMint, inAmount, swapSlippageBps, swapForY, binArrays, config = {}) {
     let dlmmQuoteResult = null;
     try {
       dlmmQuoteResult = dlmm.swapQuote(
@@ -2496,7 +2499,7 @@ function getBestSwapQuoteJupiterDlmm(dlmm, inMint, outMint, inAmount, swapSlippa
       false,
       true,
       true,
-      "https://lite-api.jup.ag"
+      config
     );
     const jupiterQuote = jupiterQuoteResult ? {
       inAmount: new import_bn3.default(jupiterQuoteResult.inAmount),
@@ -2619,7 +2622,8 @@ function estimateDlmmIndirectSwap(_0) {
     minDeltaId,
     maxDeltaId,
     strategy,
-    singleSided
+    singleSided,
+    config = {}
   }) {
     const dlmm = yield import_dlmm3.default.create(connection, lbPair);
     const activeBin = yield dlmm.getActiveBin();
@@ -2651,7 +2655,7 @@ function estimateDlmmIndirectSwap(_0) {
         false,
         true,
         true,
-        "https://lite-api.jup.ag"
+        config
       );
       if (!quote) {
         throw new Error(
@@ -2681,7 +2685,7 @@ function estimateDlmmIndirectSwap(_0) {
         false,
         true,
         true,
-        "https://lite-api.jup.ag"
+        config
       ),
       getJupiterQuote(
         inputTokenMint,
@@ -2692,7 +2696,7 @@ function estimateDlmmIndirectSwap(_0) {
         false,
         true,
         true,
-        "https://lite-api.jup.ag"
+        config
       )
     ]);
     const quoteToX = quoteToXResult.status === "fulfilled" ? quoteToXResult.value : null;
@@ -2795,7 +2799,7 @@ function estimateDlmmIndirectSwap(_0) {
         false,
         true,
         true,
-        "https://lite-api.jup.ag"
+        config
       ),
       getJupiterQuote(
         inputTokenMint,
@@ -2806,7 +2810,7 @@ function estimateDlmmIndirectSwap(_0) {
         false,
         true,
         true,
-        "https://lite-api.jup.ag"
+        config
       )
     ]);
     const finalQuoteToX = finalQuoteToXResult.status === "fulfilled" ? finalQuoteToXResult.value : null;
@@ -2848,7 +2852,8 @@ function estimateDlmmDirectSwapCore(_0) {
     minDeltaId,
     maxDeltaId,
     strategy,
-    singleSided
+    singleSided,
+    config = {}
   }) {
     if (singleSided !== void 0) {
       const singleSidedX = singleSided === 0 /* X */;
@@ -2865,7 +2870,8 @@ function estimateDlmmDirectSwapCore(_0) {
           tokenYAmount,
           swapSlippageBps,
           swapForY2,
-          binArrayForSwap2
+          binArrayForSwap2,
+          config
         );
         if (!quote) {
           throw new Error(
@@ -2893,7 +2899,8 @@ function estimateDlmmDirectSwapCore(_0) {
           tokenXAmount,
           swapSlippageBps,
           swapForY2,
-          binArrayForSwap2
+          binArrayForSwap2,
+          config
         );
         if (!quote) {
           throw new Error(
@@ -2987,7 +2994,8 @@ function estimateDlmmDirectSwapCore(_0) {
       initialSwapAmount,
       swapSlippageBps,
       swapForY,
-      binArrayForSwap
+      binArrayForSwap,
+      config
     );
     if (!initialQuote) {
       throw new Error(
@@ -3044,7 +3052,8 @@ function estimateDlmmDirectSwapCore(_0) {
       refinedAmount,
       swapSlippageBps,
       swapForY,
-      binArrayForSwap
+      binArrayForSwap,
+      config
     );
     if (!finalQuote) {
       return {
@@ -3078,7 +3087,8 @@ function estimateDlmmDirectSwap(_0) {
     minDeltaId,
     maxDeltaId,
     strategy,
-    singleSided
+    singleSided,
+    config = {}
   }) {
     const dlmm = yield import_dlmm3.default.create(connection, lbPair);
     (0, import_invariant.default)(
@@ -3096,7 +3106,8 @@ function estimateDlmmDirectSwap(_0) {
       minDeltaId,
       maxDeltaId,
       strategy,
-      singleSided
+      singleSided,
+      config
     });
     return {
       result,
@@ -3121,7 +3132,8 @@ function estimateDlmmRebalanceSwap(_0) {
     swapSlippageBps,
     minDeltaId,
     maxDeltaId,
-    strategy
+    strategy,
+    config = {}
   }) {
     const dlmm = yield import_dlmm3.default.create(connection, lbPair);
     const userPosition = yield dlmm.getPosition(position);
@@ -3133,8 +3145,9 @@ function estimateDlmmRebalanceSwap(_0) {
       minDeltaId,
       maxDeltaId,
       strategy,
-      singleSided: void 0
+      singleSided: void 0,
       // rebalance does not use single-sided deposits
+      config
     });
     return {
       result,
@@ -3199,9 +3212,15 @@ function getExtendMaxAmountTransfer(amount, percentage) {
 
 // src/zap.ts
 var Zap = class {
-  constructor(connection) {
+  /**
+   * @param connection - The connection to the Solana cluster
+   * @param config - Optional configuration for Jupiter API URL (default: https://api.jup.ag) and API key (default: empty string)
+   */
+  constructor(connection, config = {}) {
     this.connection = connection;
     this.zapProgram = new import_anchor.Program(idl_default, { connection });
+    this.jupiterApiUrl = config.jupiterApiUrl || DEFAULT_JUPITER_API_URL;
+    this.jupiterApiKey = config.jupiterApiKey || "";
   }
   /////// PRIVATE FUNDTIONS //////
   initializeLedgerAccount(owner, payer) {
@@ -3553,7 +3572,12 @@ var Zap = class {
           tokenAMint.equals(inputTokenMint) ? tokenBMint : tokenAMint,
           swapInAmount,
           maxAccounts,
-          slippageBps
+          slippageBps,
+          void 0,
+          {
+            jupiterApiUrl: this.jupiterApiUrl,
+            jupiterApiKey: this.jupiterApiKey
+          }
         );
         swapTransactions = [result.transaction];
         maxTransferAmount = getExtendMaxAmountTransfer(
@@ -3730,7 +3754,12 @@ var Zap = class {
           tokenAMint,
           amountIn,
           maxAccounts,
-          slippageBps
+          slippageBps,
+          void 0,
+          {
+            jupiterApiUrl: this.jupiterApiUrl,
+            jupiterApiKey: this.jupiterApiKey
+          }
         );
         return {
           user,
@@ -3771,7 +3800,12 @@ var Zap = class {
           tokenBMint,
           amountIn,
           maxAccounts,
-          slippageBps
+          slippageBps,
+          void 0,
+          {
+            jupiterApiUrl: this.jupiterApiUrl,
+            jupiterApiKey: this.jupiterApiKey
+          }
         );
         return {
           user,
@@ -3835,7 +3869,12 @@ var Zap = class {
           tokenAMint,
           swapAmountToA,
           maxAccounts,
-          slippageBps
+          slippageBps,
+          void 0,
+          {
+            jupiterApiUrl: this.jupiterApiUrl,
+            jupiterApiKey: this.jupiterApiKey
+          }
         );
         const { transaction: swapToBTransaction, quoteResponse: swapToBQuote } = yield buildJupiterSwapTransaction(
           user,
@@ -3843,7 +3882,12 @@ var Zap = class {
           tokenBMint,
           swapAmountToB,
           maxAccounts,
-          slippageBps
+          slippageBps,
+          void 0,
+          {
+            jupiterApiUrl: this.jupiterApiUrl,
+            jupiterApiKey: this.jupiterApiKey
+          }
         );
         return {
           user,
@@ -4127,7 +4171,11 @@ var Zap = class {
             directSwapEstimate.swapAmount,
             maxAccounts,
             swapSlippageBps,
-            swapQuote.originalQuote
+            swapQuote.originalQuote,
+            {
+              jupiterApiUrl: this.jupiterApiUrl,
+              jupiterApiKey: this.jupiterApiKey
+            }
           );
           swapTransactions.push(swapTx);
         } else {
@@ -4292,7 +4340,11 @@ var Zap = class {
           swapAmountToXInLamports,
           maxAccounts,
           swapSlippageBps,
-          indirectSwapEstimate.swapToX
+          indirectSwapEstimate.swapToX,
+          {
+            jupiterApiUrl: this.jupiterApiUrl,
+            jupiterApiKey: this.jupiterApiKey
+          }
         );
         swapTransactions.push(swapToXTransaction);
       }
@@ -4304,7 +4356,11 @@ var Zap = class {
           swapAmountToYInLamports,
           maxAccounts,
           swapSlippageBps,
-          indirectSwapEstimate.swapToY
+          indirectSwapEstimate.swapToY,
+          {
+            jupiterApiUrl: this.jupiterApiUrl,
+            jupiterApiKey: this.jupiterApiKey
+          }
         );
         swapTransactions.push(swapToYTransaction);
       }
@@ -4702,7 +4758,11 @@ var Zap = class {
             directSwapEstimate.swapAmount,
             maxAccounts,
             swapSlippageBps,
-            swapQuote.originalQuote
+            swapQuote.originalQuote,
+            {
+              jupiterApiUrl: this.jupiterApiUrl,
+              jupiterApiKey: this.jupiterApiKey
+            }
           );
           swapTransaction = swapTx;
         } else {
@@ -5162,6 +5222,7 @@ var Zap = class {
   BIN_ARRAY_INDEX_BOUND,
   DAMM_V2_PROGRAM_ID,
   DAMM_V2_SWAP_DISCRIMINATOR,
+  DEFAULT_JUPITER_API_URL,
   DLMM_PROGRAM_ID,
   DLMM_SWAP_DISCRIMINATOR,
   DlmmDirectSwapQuoteRoute,

package/dist/index.mjs

@@ -1648,12 +1648,69 @@ var DlmmSingleSided = /* @__PURE__ */ ((DlmmSingleSided2) => {
 
 // src/helpers/jupiter.ts
 import {
-  PublicKey,
+  PublicKey as PublicKey2,
   Transaction,
   TransactionInstruction
 } from "@solana/web3.js";
-function getJupiterQuote(inputMint, outputMint, amount, maxAccounts, slippageBps, dynamicSlippage = false, onlyDirectRoutes, restrictIntermediateTokens, apiUrl = "https://lite-api.jup.ag", apiKey) {
-  return __async(this, null, function* () {
+
+// src/constants.ts
+import { PublicKey } from "@solana/web3.js";
+import BN from "bn.js";
+import {
+  BIN_ARRAY_BITMAP_SIZE,
+  EXTENSION_BINARRAY_BITMAP_SIZE
+} from "@meteora-ag/dlmm";
+var ZAP_PROGRAM_ID = new PublicKey(idl_default.address);
+var JUP_V6_PROGRAM_ID = new PublicKey(
+  "JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4"
+);
+var DAMM_V2_PROGRAM_ID = new PublicKey(
+  "cpamdpZCGKUy5JxQXB4dcpGPiikHawvSWAd6mEn1sGG"
+);
+var DLMM_PROGRAM_ID = new PublicKey(
+  "LBUZKhRxPF3XUpBCjp4YzTKgLccjZhTSDM9YuVaPwxo"
+);
+var MEMO_PROGRAM_ID = new PublicKey(
+  "MemoSq4gqABAXKb96qnH8TysNcWxMyWCqXgDLGmfcHr"
+);
+var BIN_ARRAY_INDEX_BOUND = [
+  BIN_ARRAY_BITMAP_SIZE.mul(
+    EXTENSION_BINARRAY_BITMAP_SIZE.add(new BN(1))
+  ).neg(),
+  BIN_ARRAY_BITMAP_SIZE.mul(EXTENSION_BINARRAY_BITMAP_SIZE.add(new BN(1))).sub(
+    new BN(1)
+  )
+];
+var AccountsType = {
+  TransferHookX: {
+    transferHookX: {}
+  },
+  TransferHookY: {
+    transferHookY: {}
+  },
+  TransferHookReward: {
+    transferHookReward: {}
+  }
+};
+var DLMM_SWAP_DISCRIMINATOR = [65, 75, 63, 76, 235, 91, 91, 136];
+var AMOUNT_IN_DLMM_OFFSET = 8;
+var AMOUNT_IN_JUP_V6_REVERSE_OFFSET = 19;
+var AMOUNT_IN_DAMM_V2_OFFSET = 8;
+var DAMM_V2_SWAP_DISCRIMINATOR = [
+  248,
+  198,
+  158,
+  145,
+  225,
+  117,
+  135,
+  200
+];
+var DEFAULT_JUPITER_API_URL = "https://api.jup.ag";
+
+// src/helpers/jupiter.ts
+function getJupiterQuote(_0, _1, _2, _3, _4) {
+  return __async(this, arguments, function* (inputMint, outputMint, amount, maxAccounts, slippageBps, dynamicSlippage = false, onlyDirectRoutes, restrictIntermediateTokens, config = {}) {
     const params = new URLSearchParams({
       inputMint: inputMint.toString(),
       outputMint: outputMint.toString(),
@@ -1664,14 +1721,14 @@ function getJupiterQuote(inputMint, outputMint, amount, maxAccounts, slippageBps
       restrictIntermediateTokens: restrictIntermediateTokens.toString(),
       dynamicSlippage: dynamicSlippage.toString()
     });
-    const url = `${apiUrl}/swap/v1/quote?${params.toString()}`;
+    const url = `${config.jupiterApiUrl || DEFAULT_JUPITER_API_URL}/swap/v1/quote?${params.toString()}`;
     let response = null;
     try {
       response = yield fetch(url, {
         method: "GET",
         headers: __spreadValues({
           Accept: "application/json"
-        }, apiKey ? { "x-api-key": apiKey } : {})
+        }, config.jupiterApiKey ? { "x-api-key": config.jupiterApiKey } : {})
       });
       if (!response.ok) {
         return null;
@@ -1683,9 +1740,9 @@ function getJupiterQuote(inputMint, outputMint, amount, maxAccounts, slippageBps
     return result;
   });
 }
-function getJupiterSwapInstruction(userPublicKey, quoteResponse, apiUrl = "https://lite-api.jup.ag", apiKey) {
-  return __async(this, null, function* () {
-    const url = `${apiUrl}/swap/v1/swap-instructions`;
+function getJupiterSwapInstruction(_0, _1) {
+  return __async(this, arguments, function* (userPublicKey, quoteResponse, config = {}) {
+    const url = `${config.jupiterApiUrl || DEFAULT_JUPITER_API_URL}/swap/v1/swap-instructions`;
     const requestBody = {
       userPublicKey: userPublicKey.toString(),
       quoteResponse
@@ -1697,7 +1754,7 @@ function getJupiterSwapInstruction(userPublicKey, quoteResponse, apiUrl = "https
         headers: __spreadValues({
           "Content-Type": "application/json",
           Accept: "application/json"
-        }, apiKey ? { "x-api-key": apiKey } : {}),
+        }, config.jupiterApiKey ? { "x-api-key": config.jupiterApiKey } : {}),
         body: JSON.stringify(requestBody)
       });
       if (!response.ok) {
@@ -1713,8 +1770,8 @@ function getJupiterSwapInstruction(userPublicKey, quoteResponse, apiUrl = "https
     return result;
   });
 }
-function buildJupiterSwapTransaction(user, inputMint, outputMint, amount, maxAccounts, slippageBps, jupiterQuoteResponse) {
-  return __async(this, null, function* () {
+function buildJupiterSwapTransaction(_0, _1, _2, _3, _4, _5, _6) {
+  return __async(this, arguments, function* (user, inputMint, outputMint, amount, maxAccounts, slippageBps, jupiterQuoteResponse, config = {}) {
     const quoteResponse = jupiterQuoteResponse != null ? jupiterQuoteResponse : yield getJupiterQuote(
       inputMint,
       outputMint,
@@ -1724,7 +1781,7 @@ function buildJupiterSwapTransaction(user, inputMint, outputMint, amount, maxAcc
       false,
       true,
       true,
-      "https://lite-api.jup.ag"
+      config
     );
     if (!quoteResponse) {
       throw new Error(
@@ -1733,17 +1790,18 @@ function buildJupiterSwapTransaction(user, inputMint, outputMint, amount, maxAcc
     }
     const swapInstructionResponse = yield getJupiterSwapInstruction(
       user,
-      quoteResponse
+      quoteResponse,
+      config
     );
     const instruction = new TransactionInstruction({
       keys: swapInstructionResponse.swapInstruction.accounts.map((item) => {
         return {
-          pubkey: new PublicKey(item.pubkey),
+          pubkey: new PublicKey2(item.pubkey),
           isSigner: item.isSigner,
           isWritable: item.isWritable
         };
       }),
-      programId: new PublicKey(swapInstructionResponse.swapInstruction.programId),
+      programId: new PublicKey2(swapInstructionResponse.swapInstruction.programId),
       data: Buffer.from(swapInstructionResponse.swapInstruction.data, "base64")
     });
     return { transaction: new Transaction().add(instruction), quoteResponse };
@@ -1752,62 +1810,6 @@ function buildJupiterSwapTransaction(user, inputMint, outputMint, amount, maxAcc
 
 // src/helpers/dammV2.ts
 import { TOKEN_PROGRAM_ID } from "@solana/spl-token";
-
-// src/constants.ts
-import { PublicKey as PublicKey2 } from "@solana/web3.js";
-import BN from "bn.js";
-import {
-  BIN_ARRAY_BITMAP_SIZE,
-  EXTENSION_BINARRAY_BITMAP_SIZE
-} from "@meteora-ag/dlmm";
-var ZAP_PROGRAM_ID = new PublicKey2(idl_default.address);
-var JUP_V6_PROGRAM_ID = new PublicKey2(
-  "JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4"
-);
-var DAMM_V2_PROGRAM_ID = new PublicKey2(
-  "cpamdpZCGKUy5JxQXB4dcpGPiikHawvSWAd6mEn1sGG"
-);
-var DLMM_PROGRAM_ID = new PublicKey2(
-  "LBUZKhRxPF3XUpBCjp4YzTKgLccjZhTSDM9YuVaPwxo"
-);
-var MEMO_PROGRAM_ID = new PublicKey2(
-  "MemoSq4gqABAXKb96qnH8TysNcWxMyWCqXgDLGmfcHr"
-);
-var BIN_ARRAY_INDEX_BOUND = [
-  BIN_ARRAY_BITMAP_SIZE.mul(
-    EXTENSION_BINARRAY_BITMAP_SIZE.add(new BN(1))
-  ).neg(),
-  BIN_ARRAY_BITMAP_SIZE.mul(EXTENSION_BINARRAY_BITMAP_SIZE.add(new BN(1))).sub(
-    new BN(1)
-  )
-];
-var AccountsType = {
-  TransferHookX: {
-    transferHookX: {}
-  },
-  TransferHookY: {
-    transferHookY: {}
-  },
-  TransferHookReward: {
-    transferHookReward: {}
-  }
-};
-var DLMM_SWAP_DISCRIMINATOR = [65, 75, 63, 76, 235, 91, 91, 136];
-var AMOUNT_IN_DLMM_OFFSET = 8;
-var AMOUNT_IN_JUP_V6_REVERSE_OFFSET = 19;
-var AMOUNT_IN_DAMM_V2_OFFSET = 8;
-var DAMM_V2_SWAP_DISCRIMINATOR = [
-  248,
-  198,
-  158,
-  145,
-  225,
-  117,
-  135,
-  200
-];
-
-// src/helpers/dammV2.ts
 import { CpAmm, derivePoolAuthority } from "@meteora-ag/cp-amm-sdk";
 
 // src/helpers/pda.ts
@@ -2433,8 +2435,8 @@ function estimateSwapOutput(inAmount, effectiveRate) {
   const estimatedOutput = inAmountDecimal.mul(effectiveRate);
   return new BN3(estimatedOutput.floor().toString());
 }
-function getBestSwapQuoteJupiterDlmm(dlmm, inMint, outMint, inAmount, swapSlippageBps, swapForY, binArrays) {
-  return __async(this, null, function* () {
+function getBestSwapQuoteJupiterDlmm(_0, _1, _2, _3, _4, _5, _6) {
+  return __async(this, arguments, function* (dlmm, inMint, outMint, inAmount, swapSlippageBps, swapForY, binArrays, config = {}) {
     let dlmmQuoteResult = null;
     try {
       dlmmQuoteResult = dlmm.swapQuote(
@@ -2455,7 +2457,7 @@ function getBestSwapQuoteJupiterDlmm(dlmm, inMint, outMint, inAmount, swapSlippa
       false,
       true,
       true,
-      "https://lite-api.jup.ag"
+      config
     );
     const jupiterQuote = jupiterQuoteResult ? {
       inAmount: new BN3(jupiterQuoteResult.inAmount),
@@ -2578,7 +2580,8 @@ function estimateDlmmIndirectSwap(_0) {
     minDeltaId,
     maxDeltaId,
     strategy,
-    singleSided
+    singleSided,
+    config = {}
   }) {
     const dlmm = yield DLMM2.create(connection, lbPair);
     const activeBin = yield dlmm.getActiveBin();
@@ -2610,7 +2613,7 @@ function estimateDlmmIndirectSwap(_0) {
         false,
         true,
         true,
-        "https://lite-api.jup.ag"
+        config
       );
       if (!quote) {
         throw new Error(
@@ -2640,7 +2643,7 @@ function estimateDlmmIndirectSwap(_0) {
         false,
         true,
         true,
-        "https://lite-api.jup.ag"
+        config
       ),
       getJupiterQuote(
         inputTokenMint,
@@ -2651,7 +2654,7 @@ function estimateDlmmIndirectSwap(_0) {
         false,
         true,
         true,
-        "https://lite-api.jup.ag"
+        config
       )
     ]);
     const quoteToX = quoteToXResult.status === "fulfilled" ? quoteToXResult.value : null;
@@ -2754,7 +2757,7 @@ function estimateDlmmIndirectSwap(_0) {
         false,
         true,
         true,
-        "https://lite-api.jup.ag"
+        config
       ),
       getJupiterQuote(
         inputTokenMint,
@@ -2765,7 +2768,7 @@ function estimateDlmmIndirectSwap(_0) {
         false,
         true,
         true,
-        "https://lite-api.jup.ag"
+        config
       )
     ]);
     const finalQuoteToX = finalQuoteToXResult.status === "fulfilled" ? finalQuoteToXResult.value : null;
@@ -2807,7 +2810,8 @@ function estimateDlmmDirectSwapCore(_0) {
     minDeltaId,
     maxDeltaId,
     strategy,
-    singleSided
+    singleSided,
+    config = {}
   }) {
     if (singleSided !== void 0) {
       const singleSidedX = singleSided === 0 /* X */;
@@ -2824,7 +2828,8 @@ function estimateDlmmDirectSwapCore(_0) {
           tokenYAmount,
           swapSlippageBps,
           swapForY2,
-          binArrayForSwap2
+          binArrayForSwap2,
+          config
         );
         if (!quote) {
           throw new Error(
@@ -2852,7 +2857,8 @@ function estimateDlmmDirectSwapCore(_0) {
           tokenXAmount,
           swapSlippageBps,
           swapForY2,
-          binArrayForSwap2
+          binArrayForSwap2,
+          config
         );
         if (!quote) {
           throw new Error(
@@ -2946,7 +2952,8 @@ function estimateDlmmDirectSwapCore(_0) {
       initialSwapAmount,
       swapSlippageBps,
       swapForY,
-      binArrayForSwap
+      binArrayForSwap,
+      config
     );
     if (!initialQuote) {
       throw new Error(
@@ -3003,7 +3010,8 @@ function estimateDlmmDirectSwapCore(_0) {
       refinedAmount,
       swapSlippageBps,
       swapForY,
-      binArrayForSwap
+      binArrayForSwap,
+      config
     );
     if (!finalQuote) {
       return {
@@ -3037,7 +3045,8 @@ function estimateDlmmDirectSwap(_0) {
     minDeltaId,
     maxDeltaId,
     strategy,
-    singleSided
+    singleSided,
+    config = {}
   }) {
     const dlmm = yield DLMM2.create(connection, lbPair);
     invariant(
@@ -3055,7 +3064,8 @@ function estimateDlmmDirectSwap(_0) {
       minDeltaId,
       maxDeltaId,
       strategy,
-      singleSided
+      singleSided,
+      config
     });
     return {
       result,
@@ -3080,7 +3090,8 @@ function estimateDlmmRebalanceSwap(_0) {
     swapSlippageBps,
     minDeltaId,
     maxDeltaId,
-    strategy
+    strategy,
+    config = {}
   }) {
     const dlmm = yield DLMM2.create(connection, lbPair);
     const userPosition = yield dlmm.getPosition(position);
@@ -3092,8 +3103,9 @@ function estimateDlmmRebalanceSwap(_0) {
       minDeltaId,
       maxDeltaId,
       strategy,
-      singleSided: void 0
+      singleSided: void 0,
       // rebalance does not use single-sided deposits
+      config
     });
     return {
       result,
@@ -3179,9 +3191,15 @@ function getExtendMaxAmountTransfer(amount, percentage) {
 
 // src/zap.ts
 var Zap = class {
-  constructor(connection) {
+  /**
+   * @param connection - The connection to the Solana cluster
+   * @param config - Optional configuration for Jupiter API URL (default: https://api.jup.ag) and API key (default: empty string)
+   */
+  constructor(connection, config = {}) {
     this.connection = connection;
     this.zapProgram = new Program(idl_default, { connection });
+    this.jupiterApiUrl = config.jupiterApiUrl || DEFAULT_JUPITER_API_URL;
+    this.jupiterApiKey = config.jupiterApiKey || "";
   }
   /////// PRIVATE FUNDTIONS //////
   initializeLedgerAccount(owner, payer) {
@@ -3533,7 +3551,12 @@ var Zap = class {
           tokenAMint.equals(inputTokenMint) ? tokenBMint : tokenAMint,
           swapInAmount,
           maxAccounts,
-          slippageBps
+          slippageBps,
+          void 0,
+          {
+            jupiterApiUrl: this.jupiterApiUrl,
+            jupiterApiKey: this.jupiterApiKey
+          }
         );
         swapTransactions = [result.transaction];
         maxTransferAmount = getExtendMaxAmountTransfer(
@@ -3710,7 +3733,12 @@ var Zap = class {
           tokenAMint,
           amountIn,
           maxAccounts,
-          slippageBps
+          slippageBps,
+          void 0,
+          {
+            jupiterApiUrl: this.jupiterApiUrl,
+            jupiterApiKey: this.jupiterApiKey
+          }
         );
         return {
           user,
@@ -3751,7 +3779,12 @@ var Zap = class {
           tokenBMint,
           amountIn,
           maxAccounts,
-          slippageBps
+          slippageBps,
+          void 0,
+          {
+            jupiterApiUrl: this.jupiterApiUrl,
+            jupiterApiKey: this.jupiterApiKey
+          }
         );
         return {
           user,
@@ -3815,7 +3848,12 @@ var Zap = class {
           tokenAMint,
           swapAmountToA,
           maxAccounts,
-          slippageBps
+          slippageBps,
+          void 0,
+          {
+            jupiterApiUrl: this.jupiterApiUrl,
+            jupiterApiKey: this.jupiterApiKey
+          }
         );
         const { transaction: swapToBTransaction, quoteResponse: swapToBQuote } = yield buildJupiterSwapTransaction(
           user,
@@ -3823,7 +3861,12 @@ var Zap = class {
           tokenBMint,
           swapAmountToB,
           maxAccounts,
-          slippageBps
+          slippageBps,
+          void 0,
+          {
+            jupiterApiUrl: this.jupiterApiUrl,
+            jupiterApiKey: this.jupiterApiKey
+          }
         );
         return {
           user,
@@ -4107,7 +4150,11 @@ var Zap = class {
             directSwapEstimate.swapAmount,
             maxAccounts,
             swapSlippageBps,
-            swapQuote.originalQuote
+            swapQuote.originalQuote,
+            {
+              jupiterApiUrl: this.jupiterApiUrl,
+              jupiterApiKey: this.jupiterApiKey
+            }
           );
           swapTransactions.push(swapTx);
         } else {
@@ -4272,7 +4319,11 @@ var Zap = class {
           swapAmountToXInLamports,
           maxAccounts,
           swapSlippageBps,
-          indirectSwapEstimate.swapToX
+          indirectSwapEstimate.swapToX,
+          {
+            jupiterApiUrl: this.jupiterApiUrl,
+            jupiterApiKey: this.jupiterApiKey
+          }
         );
         swapTransactions.push(swapToXTransaction);
       }
@@ -4284,7 +4335,11 @@ var Zap = class {
           swapAmountToYInLamports,
           maxAccounts,
           swapSlippageBps,
-          indirectSwapEstimate.swapToY
+          indirectSwapEstimate.swapToY,
+          {
+            jupiterApiUrl: this.jupiterApiUrl,
+            jupiterApiKey: this.jupiterApiKey
+          }
         );
         swapTransactions.push(swapToYTransaction);
       }
@@ -4682,7 +4737,11 @@ var Zap = class {
             directSwapEstimate.swapAmount,
             maxAccounts,
             swapSlippageBps,
-            swapQuote.originalQuote
+            swapQuote.originalQuote,
+            {
+              jupiterApiUrl: this.jupiterApiUrl,
+              jupiterApiKey: this.jupiterApiKey
+            }
           );
           swapTransaction = swapTx;
         } else {
@@ -5141,6 +5200,7 @@ export {
   BIN_ARRAY_INDEX_BOUND,
   DAMM_V2_PROGRAM_ID,
   DAMM_V2_SWAP_DISCRIMINATOR,
+  DEFAULT_JUPITER_API_URL,
   DLMM_PROGRAM_ID,
   DLMM_SWAP_DISCRIMINATOR,
   DlmmDirectSwapQuoteRoute,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meteora-ag/zap-sdk",
-  "version": "1.1.2",
+  "version": "1.2.0",
   "description": "A Typescript SDK for interacting with the Zap program on Meteora.",
   "main": "dist/index.cjs",
   "module": "dist/index.js",