@meteora-ag/zap-sdk 1.2.0 → 1.3.1-rc.0

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import * as _solana_web3_js from '@solana/web3.js';
-import { PublicKey, TransactionInstruction, Transaction, AccountMeta, Connection } from '@solana/web3.js';
+import { PublicKey, TransactionInstruction, VersionedTransaction, Transaction, AccountMeta, Connection, AddressLookupTableAccount } from '@solana/web3.js';
 import { Program, IdlTypes } from '@coral-xyz/anchor';
 import BN from 'bn.js';
 import Decimal from 'decimal.js';
@@ -16,7 +16,7 @@ type Zap$1 = {
     address: "zapvX9M3uf5pvy4wRPAbQgdQsM1xmuiFnkfHKPvwMiz";
     metadata: {
         name: "zap";
-        version: "0.2.0";
+        version: "0.2.2";
         spec: "0.1.0";
         description: "Created with Anchor";
     };
@@ -546,12 +546,15 @@ type Zap$1 = {
                     {
                         name: "transferHookMultiReward";
                         fields: ["u8"];
+                    },
+                    {
+                        name: "transferHookReferral";
                     }
                 ];
             };
         },
         {
-            name: "baseFeeStruct";
+            name: "baseFeeInfo";
             serialization: "bytemuck";
             repr: {
                 kind: "c";
@@ -560,33 +563,31 @@ type Zap$1 = {
                 kind: "struct";
                 fields: [
                     {
-                        name: "cliffFeeNumerator";
-                        type: "u64";
-                    },
-                    {
-                        name: "baseFeeMode";
-                        type: "u8";
-                    },
-                    {
-                        name: "padding0";
+                        name: "data";
                         type: {
-                            array: ["u8", 5];
+                            array: ["u8", 32];
                         };
-                    },
-                    {
-                        name: "firstFactor";
-                        type: "u16";
-                    },
+                    }
+                ];
+            };
+        },
+        {
+            name: "baseFeeStruct";
+            serialization: "bytemuck";
+            repr: {
+                kind: "c";
+            };
+            type: {
+                kind: "struct";
+                fields: [
                     {
-                        name: "secondFactor";
+                        name: "baseFeeInfo";
                         type: {
-                            array: ["u8", 8];
+                            defined: {
+                                name: "baseFeeInfo";
+                            };
                         };
                     },
-                    {
-                        name: "thirdFactor";
-                        type: "u64";
-                    },
                     {
                         name: "padding1";
                         type: "u64";
@@ -887,9 +888,13 @@ type Zap$1 = {
                         type: "pubkey";
                     },
                     {
-                        name: "partner";
-                        docs: ["partner"];
-                        type: "pubkey";
+                        name: "padding0";
+                        docs: [
+                            "padding, previously partner pubkey, be careful when using this field"
+                        ];
+                        type: {
+                            array: ["u8", 32];
+                        };
                     },
                     {
                         name: "liquidity";
@@ -897,7 +902,7 @@ type Zap$1 = {
                         type: "u128";
                     },
                     {
-                        name: "padding";
+                        name: "padding1";
                         docs: [
                             "padding, previous reserve amount, be careful to use that field"
                         ];
@@ -914,14 +919,8 @@ type Zap$1 = {
                         type: "u64";
                     },
                     {
-                        name: "partnerAFee";
-                        docs: ["partner a fee"];
-                        type: "u64";
-                    },
-                    {
-                        name: "partnerBFee";
-                        docs: ["partner b fee"];
-                        type: "u64";
+                        name: "padding2";
+                        type: "u128";
                     },
                     {
                         name: "sqrtMinPrice";
@@ -966,7 +965,7 @@ type Zap$1 = {
                     {
                         name: "collectFeeMode";
                         docs: [
-                            "0 is collect fee in both token, 1 only collect fee in token a, 2 only collect fee in token b"
+                            "0 is collect fee in both token, 1 only collect fee only in token b"
                         ];
                         type: "u8";
                     },
@@ -976,14 +975,14 @@ type Zap$1 = {
                         type: "u8";
                     },
                     {
-                        name: "version";
+                        name: "feeVersion";
                         docs: [
-                            "pool version, 0: max_fee is still capped at 50%, 1: max_fee is capped at 99%"
+                            "pool fee version, 0: max_fee is still capped at 50%, 1: max_fee is capped at 99%"
                         ];
                         type: "u8";
                     },
                     {
-                        name: "padding0";
+                        name: "padding3";
                         docs: ["padding"];
                         type: "u8";
                     },
@@ -1020,10 +1019,34 @@ type Zap$1 = {
                         type: "pubkey";
                     },
                     {
-                        name: "padding1";
+                        name: "tokenAAmount";
+                        docs: ["token a amount"];
+                        type: "u64";
+                    },
+                    {
+                        name: "tokenBAmount";
+                        docs: ["token b amount"];
+                        type: "u64";
+                    },
+                    {
+                        name: "layoutVersion";
+                        docs: [
+                            "layout version: version 0: haven't track token_a_amount and token_b_amount, version 1: track token_a_amount and token_b_amount"
+                        ];
+                        type: "u8";
+                    },
+                    {
+                        name: "padding4";
                         docs: ["Padding for further use"];
                         type: {
-                            array: ["u64", 6];
+                            array: ["u8", 7];
+                        };
+                    },
+                    {
+                        name: "padding5";
+                        docs: ["Padding for further use"];
+                        type: {
+                            array: ["u64", 3];
                         };
                     },
                     {
@@ -1049,8 +1072,7 @@ type Zap$1 = {
                 "Information regarding fee charges",
                 "trading_fee = amount * trade_fee_numerator / denominator",
                 "protocol_fee = trading_fee * protocol_fee_percentage / 100",
-                "referral_fee = protocol_fee * referral_percentage / 100",
-                "partner_fee = (protocol_fee - referral_fee) * partner_fee_percentage / denominator"
+                "referral_fee = protocol_fee * referral_percentage / 100"
             ];
             serialization: "bytemuck";
             repr: {
@@ -1083,8 +1105,8 @@ type Zap$1 = {
                         type: "u8";
                     },
                     {
-                        name: "partnerFeePercent";
-                        docs: ["partner fee"];
+                        name: "padding0";
+                        docs: ["padding for future use"];
                         type: "u8";
                     },
                     {
@@ -1093,12 +1115,19 @@ type Zap$1 = {
                         type: "u8";
                     },
                     {
-                        name: "padding0";
+                        name: "padding1";
                         docs: ["padding"];
                         type: {
-                            array: ["u8", 5];
+                            array: ["u8", 3];
                         };
                     },
+                    {
+                        name: "compoundingFeeBps";
+                        docs: [
+                            "compounding fee bps, only non-zero in CollectFeeMode::Compounding"
+                        ];
+                        type: "u16";
+                    },
                     {
                         name: "dynamicFee";
                         docs: ["dynamic fee"];
@@ -1109,11 +1138,8 @@ type Zap$1 = {
                         };
                     },
                     {
-                        name: "padding1";
-                        docs: ["padding"];
-                        type: {
-                            array: ["u64", 2];
-                        };
+                        name: "initSqrtPrice";
+                        type: "u128";
                     }
                 ];
             };
@@ -1144,12 +1170,10 @@ type Zap$1 = {
                         type: "u64";
                     },
                     {
-                        name: "totalPartnerAFee";
-                        type: "u64";
-                    },
-                    {
-                        name: "totalPartnerBFee";
-                        type: "u64";
+                        name: "padding0";
+                        type: {
+                            array: ["u64", 2];
+                        };
                     },
                     {
                         name: "totalPosition";
@@ -1523,44 +1547,6 @@ type Zap$1 = {
         }
     ];
     constants: [
-        {
-            name: "dammV2";
-            type: "pubkey";
-            value: "cpamdpZCGKUy5JxQXB4dcpGPiikHawvSWAd6mEn1sGG";
-        },
-        {
-            name: "dammV2SwapDisc";
-            type: {
-                array: ["u8", 8];
-            };
-            value: "[248, 198, 158, 145, 225, 117, 135, 200]";
-        },
-        {
-            name: "dlmmSwap2Disc";
-            type: {
-                array: ["u8", 8];
-            };
-            value: "[65, 75, 63, 76, 235, 91, 91, 136]";
-        },
-        {
-            name: "jupV6";
-            type: "pubkey";
-            value: "JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4";
-        },
-        {
-            name: "jupV6RouteDisc";
-            type: {
-                array: ["u8", 8];
-            };
-            value: "[229, 23, 203, 151, 122, 227, 173, 42]";
-        },
-        {
-            name: "jupV6SharedAccountRouteDisc";
-            type: {
-                array: ["u8", 8];
-            };
-            value: "[193, 32, 155, 51, 65, 214, 156, 129]";
-        },
         {
             name: "maxBasisPoint";
             type: "u16";
@@ -1684,6 +1670,12 @@ interface JupiterSwapInstructionResponse {
     };
 }
 type ProgramStrategyType = IdlTypes<Zap$1>["strategyType"];
+/**
+ * A swap transaction produced during a zap. Jupiter swaps are compiled as v0
+ * VersionedTransactions (route accounts are compressed via Address Lookup Tables), while
+ * direct DLMM-pool swaps remain legacy Transactions. Consumers must handle both.
+ */
+type ZapSwapTransaction = Transaction | VersionedTransaction;
 type GetZapInDammV2DirectPoolParams = {
     user: PublicKey;
     inputTokenMint: PublicKey;
@@ -1738,7 +1730,7 @@ type ZapInDammV2DirectPoolParam = {
     maxSqrtPriceChangeBps: number;
     amount: BN;
     preInstructions: TransactionInstruction[];
-    swapTransactions: Transaction[];
+    swapTransactions: VersionedTransaction[];
     cleanUpInstructions: TransactionInstruction[];
     isTokenA?: boolean;
     swapInEstimate: {
@@ -1764,7 +1756,7 @@ type ZapInDammV2IndirectPoolParam = Omit<ZapInDammV2DirectPoolParam, "maxTransfe
 };
 type ZapInDammV2Response = {
     setupTransaction?: Transaction;
-    swapTransactions: Transaction[];
+    swapTransactions: VersionedTransaction[];
     ledgerTransaction: Transaction;
     zapInTransaction: Transaction;
     cleanUpTransaction: Transaction;
@@ -1901,7 +1893,7 @@ interface RebalanceDlmmPositionResponse {
     setupTransaction?: Transaction;
     initBinArrayTransaction?: Transaction;
     rebalancePositionTransaction?: Transaction;
-    swapTransaction?: Transaction;
+    swapTransaction?: ZapSwapTransaction;
     ledgerTransaction: Transaction;
     zapInTransaction: Transaction;
     cleanUpTransaction: Transaction;
@@ -1964,7 +1956,7 @@ type ZapInDlmmIndirectPoolParam = {
     maxTransferAmountX: BN;
     maxTransferAmountY: BN;
     preInstructions: TransactionInstruction[];
-    swapTransactions: Transaction[];
+    swapTransactions: VersionedTransaction[];
     cleanUpInstructions: TransactionInstruction[];
     binArrays: AccountMeta[];
     binArrayBitmapExtension: PublicKey | null;
@@ -1987,7 +1979,7 @@ type ZapInDlmmDirectPoolParam = {
     amount: BN;
     maxTransferAmount: BN;
     preInstructions: TransactionInstruction[];
-    swapTransactions: Transaction[];
+    swapTransactions: ZapSwapTransaction[];
     cleanUpInstructions: TransactionInstruction[];
     binArrays: AccountMeta[];
     binArrayBitmapExtension: PublicKey | null;
@@ -1997,7 +1989,7 @@ type ZapInDlmmDirectPoolParam = {
 };
 type ZapInDlmmResponse = {
     setupTransaction?: Transaction;
-    swapTransactions: Transaction[];
+    swapTransactions: ZapSwapTransaction[];
     ledgerTransaction: Transaction;
     zapInTransaction: Transaction;
     cleanUpTransaction: Transaction;
@@ -2212,7 +2204,7 @@ declare class Zap {
      * @param params.percentageToZapOut - Percentage of input token to zap out
      * @returns built transaction
      */
-    zapOutThroughJupiter(params: ZapOutThroughJupiterParams): Promise<Transaction>;
+    zapOutThroughJupiter(params: ZapOutThroughJupiterParams): Promise<VersionedTransaction>;
     /**
      * Performs a token swap using Damms V2 protocol as part of a zap out operation.
      * Swaps tokens from the input token ledger to the user's output token account.
@@ -2245,10 +2237,32 @@ declare class Zap {
     zapOutThroughDlmm(params: ZapOutThroughDlmmParams): Promise<Transaction>;
 }
 
+/**
+ * Fetch on-chain Address Lookup Table accounts for the given addresses.
+ * Missing/unresolvable tables are skipped. These tables are persistent and already
+ * active on-chain (e.g. Jupiter's route tables), so they can be used immediately.
+ */
+declare function getAddressLookupTableAccounts(connection: Connection, addresses: string[]): Promise<AddressLookupTableAccount[]>;
+/**
+ * Compile a set of instructions into a v0 VersionedTransaction using the provided
+ * Address Lookup Tables. Uses a placeholder blockhash — the caller overwrites
+ * `transaction.message.recentBlockhash` before signing.
+ */
+declare function buildVersionedTransaction(payerKey: PublicKey, instructions: TransactionInstruction[], lookupTableAccounts: AddressLookupTableAccount[]): VersionedTransaction;
+/**
+ * Build a Jupiter swap as a v0 VersionedTransaction, compressing the route accounts via
+ * Jupiter's on-chain Address Lookup Tables so the transaction fits within the 1232 byte limit
+ * (required once onlyDirectRoutes=false / higher maxAccounts produce multi-hop routes).
+ *
+ * A compute unit limit is set from Jupiter's estimate since multi-hop swaps exceed the 200k
+ * default. Compute unit price is intentionally left at the default (0) because these txs are
+ * sent inside Jito bundles where priority is paid via the bundle tip.
+ */
+declare function buildVersionedJupiterSwapTransaction(connection: Connection, user: PublicKey, swapInstructionResponse: JupiterSwapInstructionResponse): Promise<VersionedTransaction>;
 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;
+declare function buildJupiterSwapTransaction(connection: Connection, user: PublicKey, inputMint: PublicKey, outputMint: PublicKey, amount: BN, maxAccounts: number, slippageBps: number, jupiterQuoteResponse?: JupiterQuoteResponse, config?: ZapConfig): Promise<{
+    transaction: VersionedTransaction;
     quoteResponse: JupiterQuoteResponse;
 }>;
 
@@ -2258,6 +2272,14 @@ declare function getDammV2RemainingAccounts(poolAddress: PublicKey, user: Public
     isWritable: boolean;
     pubkey: PublicKey;
 }>>;
+/**
+ * Returns true if the pool is single-sided with only tokenA
+ */
+declare function isSingleSidedA(poolState: PoolState): boolean;
+/**
+ * Returns true if the pool is single-sided with only tokenB
+ */
+declare function isSingleSidedB(poolState: PoolState): boolean;
 /**
  * Creates payload data for DAMM V2 swap instruction
  * @param amountIn - The input amount for the swap
@@ -3111,6 +3133,9 @@ var types = [
 					fields: [
 						"u8"
 					]
+				},
+				{
+					name: "TransferHookReferral"
 				}
 			]
 		}
@@ -4321,4 +4346,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, 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 };
+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 ZapSwapTransaction, type Zap$1 as ZapTypes, buildJupiterSwapTransaction, buildVersionedJupiterSwapTransaction, buildVersionedTransaction, convertAccountTypeToNumber, convertLamportsToUiAmount, convertUiAmountToLamports, createDammV2SwapPayload, createDlmmSwapPayload, deriveDammV2EventAuthority, deriveDammV2PoolAuthority, deriveDlmmEventAuthority, deriveLedgerAccount, estimateDlmmDirectSwap, estimateDlmmIndirectSwap, estimateDlmmRebalanceSwap, filterOutCloseSplTokenAccountInstructions, getAddressLookupTableAccounts, getBinArrayBitmapExtension, getBitFromBinArrayIndexInBitmapExtension, getDammV2Pool, getDammV2RemainingAccounts, getDlmmRemainingAccounts, getExtraAccountMetasForTransferHook, getJupiterQuote, getJupiterSwapInstruction, getLbPairState, getNextBinArrayIndexWithLiquidity, getOrCreateATAInstruction, getTokenAccountBalance, getTokenProgramFromMint, isSingleSidedA, isSingleSidedB, toProgramStrategyType, unwrapSOLInstruction, wrapSOLInstruction };