@layerzerolabs/lz-solana-sdk-v2 3.0.105 → 3.0.106

package/dist/umi.d.mts

@@ -1,5 +1,5 @@
 import * as _metaplex_foundation_umi from '@metaplex-foundation/umi';
-import { PublicKey, Pda, Account, RpcAccount, Context, RpcGetAccountOptions, RpcGetAccountsOptions, Option, OptionOrNullable, ProgramError, Program, Signer, TransactionBuilder, ProgramRepositoryInterface, RpcInterface, ClusterFilter, WrappedInstruction, Commitment, AccountMeta, Instruction as Instruction$1, KeypairSigner } from '@metaplex-foundation/umi';
+import { PublicKey, Pda, Account, RpcAccount, Context, RpcGetAccountOptions, RpcGetAccountsOptions, Option, OptionOrNullable, ProgramError, Program, Signer, TransactionBuilder, ProgramRepositoryInterface, RpcInterface, ClusterFilter, WrappedInstruction, Commitment, AccountMeta, Instruction, AddressLookupTableInput, KeypairSigner } from '@metaplex-foundation/umi';
 import { PacketV1Codec, Packet as Packet$2 } from '@layerzerolabs/lz-v2-utilities';
 import { Serializer, GetDataEnumKindContent, GetDataEnumKind } from '@metaplex-foundation/umi/serializers';
 import { HashSigner } from '@layerzerolabs/lz-foundation';
@@ -4827,12 +4827,12 @@ declare class DVN {
     constructor(programId: PublicKey, rpc?: RpcInterface);
     getProgram(clusterFilter?: ClusterFilter): Program;
     initDVN(rpc: RpcInterface, payer: Signer, params: InitDvnInstructionArgs): Promise<WrappedInstruction>;
-    getDigest(vid: number, instruction: Instruction$1, expiration: bigint): ExecuteTransactionDigest;
+    getDigest(vid: number, instruction: Instruction, expiration: bigint): ExecuteTransactionDigest;
     getExecuteHash(hashBytes: Buffer): PublicKey;
     getHashBytes(digest: ExecuteTransactionDigest): Buffer;
     invoke(rpc: RpcInterface, payer: Signer, params: {
         vid: number;
-        instruction: Instruction$1;
+        instruction: Instruction;
         expiration: bigint;
     }, sign: SignFunc): Promise<WrappedInstruction>;
     setMultisigConfig(rpc: RpcInterface, payer: Signer, params: {
@@ -5879,15 +5879,19 @@ declare class Executor {
         endpointProgram?: PublicKey;
     }, commitment?: Commitment): Promise<{
         signers: Signer[];
-        instructions: Instruction$1[];
+        instructions: Instruction[];
+        addressLookupTables: AddressLookupTableInput[];
     }>;
     compose(rpc: RpcInterface, executor: Signer, param: {
         event: ComposeSentEvent;
         extraData: Uint8Array;
         value?: bigint;
-        computeUnits?: number;
         endpointProgram?: PublicKey;
-    }, commitment?: Commitment): Promise<WrappedInstruction>;
+    }, commitment?: Commitment): Promise<{
+        signers: Signer[];
+        instructions: Instruction[];
+        addressLookupTables: AddressLookupTableInput[];
+    }>;
     preExecute(executor: Signer, version: number, feeLimit: bigint): WrappedInstruction;
     postExecute(executor: Signer, version: number): WrappedInstruction;
 }
@@ -8384,7 +8388,7 @@ declare function instructionDiscriminator(method: string): Buffer;
  * @returns {Promise<Buffer>} A promise that resolves to the simulation result.
  * @throws {Error} If the simulation fails.
  */
-declare function simulateWeb3JsTransaction<From, To extends From = From>(_connection: string | web3.Connection | RpcInterface, _instructions: web3.TransactionInstruction[] | WrappedInstruction[] | Instruction$1[], _programId: web3.PublicKey | PublicKey, _payer: web3.PublicKey | PublicKey, serializer: Serializer<From, To>, commitment?: web3.Commitment, blockhash?: web3.Blockhash, _lookupTableAddress?: web3.PublicKey | PublicKey): Promise<To>;
+declare function simulateWeb3JsTransaction<From, To extends From = From>(_connection: string | web3.Connection | RpcInterface, _instructions: web3.TransactionInstruction[] | WrappedInstruction[] | Instruction[], _programId: web3.PublicKey | PublicKey, _payer: web3.PublicKey | PublicKey, serializer: Serializer<From, To>, commitment?: web3.Commitment, blockhash?: web3.Blockhash, _lookupTableAddress?: web3.PublicKey | PublicKey): Promise<To>;
 declare function toWeb3Connection(rpc: RpcInterface | web3.Connection): web3.Connection;
 
 /**
@@ -8547,6 +8551,9 @@ declare const MaxExecutorOptionTypeLength = 10;
 interface LzReceiveTypesV2Accounts {
     accounts: PublicKey[];
 }
+interface LzComposeTypesV2Accounts {
+    accounts: PublicKey[];
+}
 type AddressLocator = {
     __kind: 'Address';
     fields: [PublicKey];
@@ -8565,7 +8572,7 @@ interface AccountMetaRef {
     pubkey: AddressLocator;
     isWritable: boolean;
 }
-type Instruction = {
+type InstructionForLzReceive = {
     __kind: 'LzReceive';
     accounts: AccountMetaRef[];
 } | {
@@ -8574,16 +8581,33 @@ type Instruction = {
     accounts: AccountMetaRef[];
     data: Uint8Array;
 };
+type InstructionForLzCompose = {
+    __kind: 'LzCompose';
+    accounts: AccountMetaRef[];
+} | {
+    __kind: 'Standard';
+    programId: PublicKey;
+    accounts: AccountMetaRef[];
+    data: Uint8Array;
+};
 interface LzReceiveTypesV2Result {
     contextVersion: number;
     alts: PublicKey[];
-    instructions: Instruction[];
+    instructions: InstructionForLzReceive[];
+}
+interface LzComposeTypesV2Result {
+    contextVersion: number;
+    alts: PublicKey[];
+    instructions: InstructionForLzCompose[];
 }
 declare function getAddressLocatorSerializer(): Serializer<AddressLocator, AddressLocator>;
 declare function getLzReceiveTypesV2AccountsSerializer(): Serializer<LzReceiveTypesV2Accounts, LzReceiveTypesV2Accounts>;
+declare function getLzComposeTypesV2AccountsSerializer(): Serializer<LzComposeTypesV2Accounts, LzComposeTypesV2Accounts>;
 declare function getAccountMetaRefSerializer(): Serializer<AccountMetaRef, AccountMetaRef>;
-declare function getInstructionSerializer(): Serializer<Instruction, Instruction>;
+declare function getInstructionForLzReceiveSerializer(): Serializer<InstructionForLzReceive, InstructionForLzReceive>;
+declare function getInstructionForLzComposeSerializer(): Serializer<InstructionForLzCompose, InstructionForLzCompose>;
 declare function getLzReceiveTypesV2ResultSerializer(): Serializer<LzReceiveTypesV2Result, LzReceiveTypesV2Result>;
+declare function getLzComposeTypesV2ResultSerializer(): Serializer<LzComposeTypesV2Result, LzComposeTypesV2Result>;
 declare function addressLocator(kind: 'Payer'): GetDataEnumKind<AddressLocator, 'Payer'>;
 declare function addressLocator(kind: 'Signer', data: GetDataEnumKindContent<AddressLocator, 'Signer'>['fields']): GetDataEnumKind<AddressLocator, 'Signer'>;
 declare function addressLocator(kind: 'Address', data: GetDataEnumKindContent<AddressLocator, 'Address'>['fields']): GetDataEnumKind<AddressLocator, 'Address'>;
@@ -8592,6 +8616,22 @@ declare function isAddressLocator<K extends AddressLocator['__kind']>(kind: K, v
     __kind: K;
 };
 
+/**
+ * Retrieves the instructions and signers required for the LzCompose instruction (V2).
+ * This is used for lz_compose_types version 2.
+ */
+declare function buildLzComposeExecutionPlan(rpc: RpcInterface, executorProgram: PublicKey, payer: PublicKey, to: PublicKey, composerProgram: PublicKey, params: LzComposeParams, composeTypesAccounts?: LzComposeTypesV2Accounts, commitment?: Commitment): Promise<{
+    contextVersion: number;
+    signers: KeypairSigner[];
+    instructions: Instruction[];
+    addressLookupTables: AddressLookupTableInput[];
+}>;
+/**
+ * Fetches the metadata for lz_compose_types (versioned, V2).
+ * This reads the PDA account and deserializes the version, alts, and accounts.
+ */
+declare function getLzComposeTypesInfo(rpc: RpcInterface, payer: PublicKey, to: PublicKey, composerProgram: PublicKey, params: LzComposeParams, commitment?: Commitment): Promise<LzComposeTypesV2Accounts>;
+
 /**
  * Retrieves the instructions and signers required for the LzReceive instruction (V2).
  * This is used for lz_receive_types version 2.
@@ -8599,7 +8639,8 @@ declare function isAddressLocator<K extends AddressLocator['__kind']>(kind: K, v
 declare function buildLzReceiveExecutionPlan(rpc: RpcInterface, executorProgram: PublicKey, payer: PublicKey, receiver: PublicKey, receiverProgram: PublicKey, params: LzReceiveParams, receiveTypesAccounts?: LzReceiveTypesV2Accounts, commitment?: Commitment): Promise<{
     contextVersion: number;
     signers: KeypairSigner[];
-    instructions: Instruction$1[];
+    instructions: Instruction[];
+    addressLookupTables: AddressLookupTableInput[];
 }>;
 /**
  * Fetches the metadata for lz_receive_types (versioned, V2).
@@ -8615,40 +8656,31 @@ declare function getLzReceiveTypesInfo(rpc: RpcInterface, payer: PublicKey, rece
  * For V2: returns { signers, instructions } for multi-instruction atomic execution.
  */
 declare function lzReceive(rpc: RpcInterface, payer: PublicKey, packet: Pick<Packet$2, 'message' | 'sender' | 'srcEid' | 'guid' | 'receiver' | 'nonce'>, callerParams?: Uint8Array, executorProgram?: PublicKey, commitment?: Commitment): Promise<{
-    instruction: Instruction$1;
+    instruction: Instruction;
     contextVersion: number;
 } | ReturnType<typeof buildLzReceiveExecutionPlan>>;
 /**
- * Composes a LayerZero message.
- *
- * @param {Connection} connection - The Solana connection object.
- * @param {PublicKey} payer - The public key of the payer.
- * @param {ComposeSentEvent} event - The event containing the message details.
- * @param {Uint8Array} [extraData] - Optional extra data.
- * @param {Commitment | GetAccountInfoConfig} [commitmentOrConfig] - Optional commitment or configuration.
- *
- * @returns {Promise<TransactionInstruction>} The transaction instruction.
- */
-declare function lzCompose(rpc: RpcInterface, payer: PublicKey, event: ComposeSentEvent, extraData?: Uint8Array, commitment?: Commitment): Promise<Instruction$1>;
-/**
- * Retrieves the accounts required for the LzCompose instruction.
+ * Unified entry point for composing a LayerZero message on Solana.
+ * This function automatically detects the lz_compose_types version and dispatches to the correct logic.
  *
- * @param {Connection} connection - The Solana connection object.
- * @param {PublicKey} payer - The public key of the payer.
- * @param {PublicKey} to - The public key of the recipient.
- * @param {PublicKey} composerProgram - The public key of the composer program.
- * @param {LzComposeParams} params - The parameters for the LzCompose instruction.
- * @param {Commitment | GetAccountInfoConfig} [commitmentOrConfig] - Optional commitment or configuration.
- *
- * @returns {Promise<AccountMeta[]>} The list of account metadata.
+ * For V1: returns a single Instruction (legacy behavior).
+ * For V2: returns { signers, instructions } for multi-instruction atomic execution.
  */
-declare function getLzComposeAccountMeta(rpc: RpcInterface, payer: PublicKey, to: PublicKey, composerProgram: PublicKey, params: LzComposeParams, commitment?: Commitment): Promise<AccountMeta[]>;
+declare function lzCompose(rpc: RpcInterface, payer: PublicKey, event: ComposeSentEvent, extraData?: Uint8Array, executorProgram?: PublicKey, commitment?: Commitment): Promise<{
+    instruction: Instruction;
+    contextVersion: number;
+} | ReturnType<typeof buildLzComposeExecutionPlan>>;
 
 /**
  * Get the accounts required for lz_receive by querying lz_receive_types_v1.
  */
 declare function getLzReceiveAccountsFromTypesV1(rpc: RpcInterface, payer: PublicKey, receiver: PublicKey, receiverProgram: PublicKey, params: LzReceiveParams, commitment?: Commitment): Promise<AccountMeta[]>;
 
+/**
+ * Get the accounts required for lz_compose by querying lz_compose_types_v1.
+ */
+declare function getLzComposeAccountsFromTypesV1(rpc: RpcInterface, payer: PublicKey, to: PublicKey, composerProgram: PublicKey, params: LzComposeParams, commitment?: Commitment): Promise<AccountMeta[]>;
+
 /**
  * Supported programs.
  */
@@ -9031,4 +9063,4 @@ interface MessageLibInterface {
     getSetConfigIXAccountMetaForCPI(oapp: PublicKey, eid: number, endpointProgram?: PublicKey): AccountMeta[];
 }
 
-export { type AccountMetaRef, type AddressLocator, index as BlockedMessageLibProgram, dvn as DVNProgram, type Deployment, DvnPDA, index$f as DvnProgram, EDDSA, ENFORCED_OPTIONS_SEED, EndpointPDA, endpoint as EndpointProgram, EventPDA, ExecutorOptionType, ExecutorPDA, executor as ExecutorProgram, FAUCET_URL, type Instruction, type LzComposeParams, type LzReceiveAccount, type LzReceiveParams, type LzReceiveParamsArgs, type LzReceiveTypesV2Accounts, type LzReceiveTypesV2Result, MINT_SEED, MSG_TYPE_OFFSET, MaxExecutorOptionTypeLength, type MessageLibInterface, MessageLibPDA, MessageType, type NextNonceInstructionData, type NextNonceInstructionDataArgs, OmniAppPDA, PEER_SEED, PriceFeedPDA, pricefeed as PriceFeedProgram, SendHelper, SetConfigType, simpleMessageLib as SimpleMessageLibProgram, type SolanaPacketPath, type SupportedPrograms, UlnPDA, uln as UlnProgram, addressLocator, buildLzReceiveExecutionPlan, buildMessageV0, buildVersionedTransaction, closeLookupTable, createNonceAccountTX, deactivateLookupTable, extractComposeDeliveredEventByTxHash, extractComposeSentEventByTxHash, extractEventFromTransactionSignature, extractPacketSentEventByTxHash, extractReceivedPacketEventByTxHash, extractVerifiedPacketEventByTxHash, extractWorkerFeePaidEventByTxHash, generateAddressLookupTable, getAccountMetaRefSerializer, getAddressLocatorSerializer, getBlockedMessageLibProgramId, getDVNProgramId, getEndpointProgramId, getExecutorProgramId, getInstructionSerializer, getLzComposeAccountMeta, getLzComposeParamsSerializer, getLzReceiveAccountSerializer, getLzReceiveAccountsFromTypesV1, getLzReceiveParamsSerializer, getLzReceiveTypesInfo, getLzReceiveTypesV2AccountsSerializer, getLzReceiveTypesV2ResultSerializer, getNextNonceInstructionDataSerializer, getPricefeedProgramId, getProgramKeypair, getSimpleMessageLibProgramId, getULNProgramId, idlTypes, instructionDiscriminator, isAccountInitialized, isAddressLocator, lzCompose, lzReceive, messageLibs, nextNonce, simulateWeb3JsTransaction, toWeb3Connection, txWithAddressLookupTable, txWithNonce };
+export { type AccountMetaRef, type AddressLocator, index as BlockedMessageLibProgram, dvn as DVNProgram, type Deployment, DvnPDA, index$f as DvnProgram, EDDSA, ENFORCED_OPTIONS_SEED, EndpointPDA, endpoint as EndpointProgram, EventPDA, ExecutorOptionType, ExecutorPDA, executor as ExecutorProgram, FAUCET_URL, type InstructionForLzCompose, type InstructionForLzReceive, type LzComposeParams, type LzComposeTypesV2Accounts, type LzComposeTypesV2Result, type LzReceiveAccount, type LzReceiveParams, type LzReceiveParamsArgs, type LzReceiveTypesV2Accounts, type LzReceiveTypesV2Result, MINT_SEED, MSG_TYPE_OFFSET, MaxExecutorOptionTypeLength, type MessageLibInterface, MessageLibPDA, MessageType, type NextNonceInstructionData, type NextNonceInstructionDataArgs, OmniAppPDA, PEER_SEED, PriceFeedPDA, pricefeed as PriceFeedProgram, SendHelper, SetConfigType, simpleMessageLib as SimpleMessageLibProgram, type SolanaPacketPath, type SupportedPrograms, UlnPDA, uln as UlnProgram, addressLocator, buildLzComposeExecutionPlan, buildLzReceiveExecutionPlan, buildMessageV0, buildVersionedTransaction, closeLookupTable, createNonceAccountTX, deactivateLookupTable, extractComposeDeliveredEventByTxHash, extractComposeSentEventByTxHash, extractEventFromTransactionSignature, extractPacketSentEventByTxHash, extractReceivedPacketEventByTxHash, extractVerifiedPacketEventByTxHash, extractWorkerFeePaidEventByTxHash, generateAddressLookupTable, getAccountMetaRefSerializer, getAddressLocatorSerializer, getBlockedMessageLibProgramId, getDVNProgramId, getEndpointProgramId, getExecutorProgramId, getInstructionForLzComposeSerializer, getInstructionForLzReceiveSerializer, getLzComposeAccountsFromTypesV1, getLzComposeParamsSerializer, getLzComposeTypesInfo, getLzComposeTypesV2AccountsSerializer, getLzComposeTypesV2ResultSerializer, getLzReceiveAccountSerializer, getLzReceiveAccountsFromTypesV1, getLzReceiveParamsSerializer, getLzReceiveTypesInfo, getLzReceiveTypesV2AccountsSerializer, getLzReceiveTypesV2ResultSerializer, getNextNonceInstructionDataSerializer, getPricefeedProgramId, getProgramKeypair, getSimpleMessageLibProgramId, getULNProgramId, idlTypes, instructionDiscriminator, isAccountInitialized, isAddressLocator, lzCompose, lzReceive, messageLibs, nextNonce, simulateWeb3JsTransaction, toWeb3Connection, txWithAddressLookupTable, txWithNonce };

package/dist/umi.d.ts

@@ -1,5 +1,5 @@
 import * as _metaplex_foundation_umi from '@metaplex-foundation/umi';
-import { PublicKey, Pda, Account, RpcAccount, Context, RpcGetAccountOptions, RpcGetAccountsOptions, Option, OptionOrNullable, ProgramError, Program, Signer, TransactionBuilder, ProgramRepositoryInterface, RpcInterface, ClusterFilter, WrappedInstruction, Commitment, AccountMeta, Instruction as Instruction$1, KeypairSigner } from '@metaplex-foundation/umi';
+import { PublicKey, Pda, Account, RpcAccount, Context, RpcGetAccountOptions, RpcGetAccountsOptions, Option, OptionOrNullable, ProgramError, Program, Signer, TransactionBuilder, ProgramRepositoryInterface, RpcInterface, ClusterFilter, WrappedInstruction, Commitment, AccountMeta, Instruction, AddressLookupTableInput, KeypairSigner } from '@metaplex-foundation/umi';
 import { PacketV1Codec, Packet as Packet$2 } from '@layerzerolabs/lz-v2-utilities';
 import { Serializer, GetDataEnumKindContent, GetDataEnumKind } from '@metaplex-foundation/umi/serializers';
 import { HashSigner } from '@layerzerolabs/lz-foundation';
@@ -4827,12 +4827,12 @@ declare class DVN {
     constructor(programId: PublicKey, rpc?: RpcInterface);
     getProgram(clusterFilter?: ClusterFilter): Program;
     initDVN(rpc: RpcInterface, payer: Signer, params: InitDvnInstructionArgs): Promise<WrappedInstruction>;
-    getDigest(vid: number, instruction: Instruction$1, expiration: bigint): ExecuteTransactionDigest;
+    getDigest(vid: number, instruction: Instruction, expiration: bigint): ExecuteTransactionDigest;
     getExecuteHash(hashBytes: Buffer): PublicKey;
     getHashBytes(digest: ExecuteTransactionDigest): Buffer;
     invoke(rpc: RpcInterface, payer: Signer, params: {
         vid: number;
-        instruction: Instruction$1;
+        instruction: Instruction;
         expiration: bigint;
     }, sign: SignFunc): Promise<WrappedInstruction>;
     setMultisigConfig(rpc: RpcInterface, payer: Signer, params: {
@@ -5879,15 +5879,19 @@ declare class Executor {
         endpointProgram?: PublicKey;
     }, commitment?: Commitment): Promise<{
         signers: Signer[];
-        instructions: Instruction$1[];
+        instructions: Instruction[];
+        addressLookupTables: AddressLookupTableInput[];
     }>;
     compose(rpc: RpcInterface, executor: Signer, param: {
         event: ComposeSentEvent;
         extraData: Uint8Array;
         value?: bigint;
-        computeUnits?: number;
         endpointProgram?: PublicKey;
-    }, commitment?: Commitment): Promise<WrappedInstruction>;
+    }, commitment?: Commitment): Promise<{
+        signers: Signer[];
+        instructions: Instruction[];
+        addressLookupTables: AddressLookupTableInput[];
+    }>;
     preExecute(executor: Signer, version: number, feeLimit: bigint): WrappedInstruction;
     postExecute(executor: Signer, version: number): WrappedInstruction;
 }
@@ -8384,7 +8388,7 @@ declare function instructionDiscriminator(method: string): Buffer;
  * @returns {Promise<Buffer>} A promise that resolves to the simulation result.
  * @throws {Error} If the simulation fails.
  */
-declare function simulateWeb3JsTransaction<From, To extends From = From>(_connection: string | web3.Connection | RpcInterface, _instructions: web3.TransactionInstruction[] | WrappedInstruction[] | Instruction$1[], _programId: web3.PublicKey | PublicKey, _payer: web3.PublicKey | PublicKey, serializer: Serializer<From, To>, commitment?: web3.Commitment, blockhash?: web3.Blockhash, _lookupTableAddress?: web3.PublicKey | PublicKey): Promise<To>;
+declare function simulateWeb3JsTransaction<From, To extends From = From>(_connection: string | web3.Connection | RpcInterface, _instructions: web3.TransactionInstruction[] | WrappedInstruction[] | Instruction[], _programId: web3.PublicKey | PublicKey, _payer: web3.PublicKey | PublicKey, serializer: Serializer<From, To>, commitment?: web3.Commitment, blockhash?: web3.Blockhash, _lookupTableAddress?: web3.PublicKey | PublicKey): Promise<To>;
 declare function toWeb3Connection(rpc: RpcInterface | web3.Connection): web3.Connection;
 
 /**
@@ -8547,6 +8551,9 @@ declare const MaxExecutorOptionTypeLength = 10;
 interface LzReceiveTypesV2Accounts {
     accounts: PublicKey[];
 }
+interface LzComposeTypesV2Accounts {
+    accounts: PublicKey[];
+}
 type AddressLocator = {
     __kind: 'Address';
     fields: [PublicKey];
@@ -8565,7 +8572,7 @@ interface AccountMetaRef {
     pubkey: AddressLocator;
     isWritable: boolean;
 }
-type Instruction = {
+type InstructionForLzReceive = {
     __kind: 'LzReceive';
     accounts: AccountMetaRef[];
 } | {
@@ -8574,16 +8581,33 @@ type Instruction = {
     accounts: AccountMetaRef[];
     data: Uint8Array;
 };
+type InstructionForLzCompose = {
+    __kind: 'LzCompose';
+    accounts: AccountMetaRef[];
+} | {
+    __kind: 'Standard';
+    programId: PublicKey;
+    accounts: AccountMetaRef[];
+    data: Uint8Array;
+};
 interface LzReceiveTypesV2Result {
     contextVersion: number;
     alts: PublicKey[];
-    instructions: Instruction[];
+    instructions: InstructionForLzReceive[];
+}
+interface LzComposeTypesV2Result {
+    contextVersion: number;
+    alts: PublicKey[];
+    instructions: InstructionForLzCompose[];
 }
 declare function getAddressLocatorSerializer(): Serializer<AddressLocator, AddressLocator>;
 declare function getLzReceiveTypesV2AccountsSerializer(): Serializer<LzReceiveTypesV2Accounts, LzReceiveTypesV2Accounts>;
+declare function getLzComposeTypesV2AccountsSerializer(): Serializer<LzComposeTypesV2Accounts, LzComposeTypesV2Accounts>;
 declare function getAccountMetaRefSerializer(): Serializer<AccountMetaRef, AccountMetaRef>;
-declare function getInstructionSerializer(): Serializer<Instruction, Instruction>;
+declare function getInstructionForLzReceiveSerializer(): Serializer<InstructionForLzReceive, InstructionForLzReceive>;
+declare function getInstructionForLzComposeSerializer(): Serializer<InstructionForLzCompose, InstructionForLzCompose>;
 declare function getLzReceiveTypesV2ResultSerializer(): Serializer<LzReceiveTypesV2Result, LzReceiveTypesV2Result>;
+declare function getLzComposeTypesV2ResultSerializer(): Serializer<LzComposeTypesV2Result, LzComposeTypesV2Result>;
 declare function addressLocator(kind: 'Payer'): GetDataEnumKind<AddressLocator, 'Payer'>;
 declare function addressLocator(kind: 'Signer', data: GetDataEnumKindContent<AddressLocator, 'Signer'>['fields']): GetDataEnumKind<AddressLocator, 'Signer'>;
 declare function addressLocator(kind: 'Address', data: GetDataEnumKindContent<AddressLocator, 'Address'>['fields']): GetDataEnumKind<AddressLocator, 'Address'>;
@@ -8592,6 +8616,22 @@ declare function isAddressLocator<K extends AddressLocator['__kind']>(kind: K, v
     __kind: K;
 };
 
+/**
+ * Retrieves the instructions and signers required for the LzCompose instruction (V2).
+ * This is used for lz_compose_types version 2.
+ */
+declare function buildLzComposeExecutionPlan(rpc: RpcInterface, executorProgram: PublicKey, payer: PublicKey, to: PublicKey, composerProgram: PublicKey, params: LzComposeParams, composeTypesAccounts?: LzComposeTypesV2Accounts, commitment?: Commitment): Promise<{
+    contextVersion: number;
+    signers: KeypairSigner[];
+    instructions: Instruction[];
+    addressLookupTables: AddressLookupTableInput[];
+}>;
+/**
+ * Fetches the metadata for lz_compose_types (versioned, V2).
+ * This reads the PDA account and deserializes the version, alts, and accounts.
+ */
+declare function getLzComposeTypesInfo(rpc: RpcInterface, payer: PublicKey, to: PublicKey, composerProgram: PublicKey, params: LzComposeParams, commitment?: Commitment): Promise<LzComposeTypesV2Accounts>;
+
 /**
  * Retrieves the instructions and signers required for the LzReceive instruction (V2).
  * This is used for lz_receive_types version 2.
@@ -8599,7 +8639,8 @@ declare function isAddressLocator<K extends AddressLocator['__kind']>(kind: K, v
 declare function buildLzReceiveExecutionPlan(rpc: RpcInterface, executorProgram: PublicKey, payer: PublicKey, receiver: PublicKey, receiverProgram: PublicKey, params: LzReceiveParams, receiveTypesAccounts?: LzReceiveTypesV2Accounts, commitment?: Commitment): Promise<{
     contextVersion: number;
     signers: KeypairSigner[];
-    instructions: Instruction$1[];
+    instructions: Instruction[];
+    addressLookupTables: AddressLookupTableInput[];
 }>;
 /**
  * Fetches the metadata for lz_receive_types (versioned, V2).
@@ -8615,40 +8656,31 @@ declare function getLzReceiveTypesInfo(rpc: RpcInterface, payer: PublicKey, rece
  * For V2: returns { signers, instructions } for multi-instruction atomic execution.
  */
 declare function lzReceive(rpc: RpcInterface, payer: PublicKey, packet: Pick<Packet$2, 'message' | 'sender' | 'srcEid' | 'guid' | 'receiver' | 'nonce'>, callerParams?: Uint8Array, executorProgram?: PublicKey, commitment?: Commitment): Promise<{
-    instruction: Instruction$1;
+    instruction: Instruction;
     contextVersion: number;
 } | ReturnType<typeof buildLzReceiveExecutionPlan>>;
 /**
- * Composes a LayerZero message.
- *
- * @param {Connection} connection - The Solana connection object.
- * @param {PublicKey} payer - The public key of the payer.
- * @param {ComposeSentEvent} event - The event containing the message details.
- * @param {Uint8Array} [extraData] - Optional extra data.
- * @param {Commitment | GetAccountInfoConfig} [commitmentOrConfig] - Optional commitment or configuration.
- *
- * @returns {Promise<TransactionInstruction>} The transaction instruction.
- */
-declare function lzCompose(rpc: RpcInterface, payer: PublicKey, event: ComposeSentEvent, extraData?: Uint8Array, commitment?: Commitment): Promise<Instruction$1>;
-/**
- * Retrieves the accounts required for the LzCompose instruction.
+ * Unified entry point for composing a LayerZero message on Solana.
+ * This function automatically detects the lz_compose_types version and dispatches to the correct logic.
  *
- * @param {Connection} connection - The Solana connection object.
- * @param {PublicKey} payer - The public key of the payer.
- * @param {PublicKey} to - The public key of the recipient.
- * @param {PublicKey} composerProgram - The public key of the composer program.
- * @param {LzComposeParams} params - The parameters for the LzCompose instruction.
- * @param {Commitment | GetAccountInfoConfig} [commitmentOrConfig] - Optional commitment or configuration.
- *
- * @returns {Promise<AccountMeta[]>} The list of account metadata.
+ * For V1: returns a single Instruction (legacy behavior).
+ * For V2: returns { signers, instructions } for multi-instruction atomic execution.
  */
-declare function getLzComposeAccountMeta(rpc: RpcInterface, payer: PublicKey, to: PublicKey, composerProgram: PublicKey, params: LzComposeParams, commitment?: Commitment): Promise<AccountMeta[]>;
+declare function lzCompose(rpc: RpcInterface, payer: PublicKey, event: ComposeSentEvent, extraData?: Uint8Array, executorProgram?: PublicKey, commitment?: Commitment): Promise<{
+    instruction: Instruction;
+    contextVersion: number;
+} | ReturnType<typeof buildLzComposeExecutionPlan>>;
 
 /**
  * Get the accounts required for lz_receive by querying lz_receive_types_v1.
  */
 declare function getLzReceiveAccountsFromTypesV1(rpc: RpcInterface, payer: PublicKey, receiver: PublicKey, receiverProgram: PublicKey, params: LzReceiveParams, commitment?: Commitment): Promise<AccountMeta[]>;
 
+/**
+ * Get the accounts required for lz_compose by querying lz_compose_types_v1.
+ */
+declare function getLzComposeAccountsFromTypesV1(rpc: RpcInterface, payer: PublicKey, to: PublicKey, composerProgram: PublicKey, params: LzComposeParams, commitment?: Commitment): Promise<AccountMeta[]>;
+
 /**
  * Supported programs.
  */
@@ -9031,4 +9063,4 @@ interface MessageLibInterface {
     getSetConfigIXAccountMetaForCPI(oapp: PublicKey, eid: number, endpointProgram?: PublicKey): AccountMeta[];
 }
 
-export { type AccountMetaRef, type AddressLocator, index as BlockedMessageLibProgram, dvn as DVNProgram, type Deployment, DvnPDA, index$f as DvnProgram, EDDSA, ENFORCED_OPTIONS_SEED, EndpointPDA, endpoint as EndpointProgram, EventPDA, ExecutorOptionType, ExecutorPDA, executor as ExecutorProgram, FAUCET_URL, type Instruction, type LzComposeParams, type LzReceiveAccount, type LzReceiveParams, type LzReceiveParamsArgs, type LzReceiveTypesV2Accounts, type LzReceiveTypesV2Result, MINT_SEED, MSG_TYPE_OFFSET, MaxExecutorOptionTypeLength, type MessageLibInterface, MessageLibPDA, MessageType, type NextNonceInstructionData, type NextNonceInstructionDataArgs, OmniAppPDA, PEER_SEED, PriceFeedPDA, pricefeed as PriceFeedProgram, SendHelper, SetConfigType, simpleMessageLib as SimpleMessageLibProgram, type SolanaPacketPath, type SupportedPrograms, UlnPDA, uln as UlnProgram, addressLocator, buildLzReceiveExecutionPlan, buildMessageV0, buildVersionedTransaction, closeLookupTable, createNonceAccountTX, deactivateLookupTable, extractComposeDeliveredEventByTxHash, extractComposeSentEventByTxHash, extractEventFromTransactionSignature, extractPacketSentEventByTxHash, extractReceivedPacketEventByTxHash, extractVerifiedPacketEventByTxHash, extractWorkerFeePaidEventByTxHash, generateAddressLookupTable, getAccountMetaRefSerializer, getAddressLocatorSerializer, getBlockedMessageLibProgramId, getDVNProgramId, getEndpointProgramId, getExecutorProgramId, getInstructionSerializer, getLzComposeAccountMeta, getLzComposeParamsSerializer, getLzReceiveAccountSerializer, getLzReceiveAccountsFromTypesV1, getLzReceiveParamsSerializer, getLzReceiveTypesInfo, getLzReceiveTypesV2AccountsSerializer, getLzReceiveTypesV2ResultSerializer, getNextNonceInstructionDataSerializer, getPricefeedProgramId, getProgramKeypair, getSimpleMessageLibProgramId, getULNProgramId, idlTypes, instructionDiscriminator, isAccountInitialized, isAddressLocator, lzCompose, lzReceive, messageLibs, nextNonce, simulateWeb3JsTransaction, toWeb3Connection, txWithAddressLookupTable, txWithNonce };
+export { type AccountMetaRef, type AddressLocator, index as BlockedMessageLibProgram, dvn as DVNProgram, type Deployment, DvnPDA, index$f as DvnProgram, EDDSA, ENFORCED_OPTIONS_SEED, EndpointPDA, endpoint as EndpointProgram, EventPDA, ExecutorOptionType, ExecutorPDA, executor as ExecutorProgram, FAUCET_URL, type InstructionForLzCompose, type InstructionForLzReceive, type LzComposeParams, type LzComposeTypesV2Accounts, type LzComposeTypesV2Result, type LzReceiveAccount, type LzReceiveParams, type LzReceiveParamsArgs, type LzReceiveTypesV2Accounts, type LzReceiveTypesV2Result, MINT_SEED, MSG_TYPE_OFFSET, MaxExecutorOptionTypeLength, type MessageLibInterface, MessageLibPDA, MessageType, type NextNonceInstructionData, type NextNonceInstructionDataArgs, OmniAppPDA, PEER_SEED, PriceFeedPDA, pricefeed as PriceFeedProgram, SendHelper, SetConfigType, simpleMessageLib as SimpleMessageLibProgram, type SolanaPacketPath, type SupportedPrograms, UlnPDA, uln as UlnProgram, addressLocator, buildLzComposeExecutionPlan, buildLzReceiveExecutionPlan, buildMessageV0, buildVersionedTransaction, closeLookupTable, createNonceAccountTX, deactivateLookupTable, extractComposeDeliveredEventByTxHash, extractComposeSentEventByTxHash, extractEventFromTransactionSignature, extractPacketSentEventByTxHash, extractReceivedPacketEventByTxHash, extractVerifiedPacketEventByTxHash, extractWorkerFeePaidEventByTxHash, generateAddressLookupTable, getAccountMetaRefSerializer, getAddressLocatorSerializer, getBlockedMessageLibProgramId, getDVNProgramId, getEndpointProgramId, getExecutorProgramId, getInstructionForLzComposeSerializer, getInstructionForLzReceiveSerializer, getLzComposeAccountsFromTypesV1, getLzComposeParamsSerializer, getLzComposeTypesInfo, getLzComposeTypesV2AccountsSerializer, getLzComposeTypesV2ResultSerializer, getLzReceiveAccountSerializer, getLzReceiveAccountsFromTypesV1, getLzReceiveParamsSerializer, getLzReceiveTypesInfo, getLzReceiveTypesV2AccountsSerializer, getLzReceiveTypesV2ResultSerializer, getNextNonceInstructionDataSerializer, getPricefeedProgramId, getProgramKeypair, getSimpleMessageLibProgramId, getULNProgramId, idlTypes, instructionDiscriminator, isAccountInitialized, isAddressLocator, lzCompose, lzReceive, messageLibs, nextNonce, simulateWeb3JsTransaction, toWeb3Connection, txWithAddressLookupTable, txWithNonce };