@across-protocol/sdk 4.3.155 → 4.4.0-alpha.10

package/dist/esm/src/svm/web3-v1/relayHashUtils.js

@@ -0,0 +1,206 @@
+import { BN } from "@coral-xyz/anchor";
+import { ethers } from "ethers";
+import { serialize } from "borsh";
+/**
+ * Calculates the relay hash from relay data and chain ID.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function calculateRelayHashUint8Array(relayData, chainId) {
+    const contentToHash = Buffer.concat([
+        relayData.depositor.toBuffer(),
+        relayData.recipient.toBuffer(),
+        relayData.exclusiveRelayer.toBuffer(),
+        relayData.inputToken.toBuffer(),
+        relayData.outputToken.toBuffer(),
+        Buffer.from(relayData.inputAmount),
+        relayData.outputAmount.toArrayLike(Buffer, "le", 8),
+        relayData.originChainId.toArrayLike(Buffer, "le", 8),
+        Buffer.from(relayData.depositId),
+        new BN(relayData.fillDeadline).toArrayLike(Buffer, "le", 4),
+        new BN(relayData.exclusivityDeadline).toArrayLike(Buffer, "le", 4),
+        hashNonEmptyMessage(relayData.message), // Replace with hash of message, so that relay hash can be recovered from event.
+        chainId.toArrayLike(Buffer, "le", 8),
+    ]);
+    const relayHash = ethers.utils.keccak256(contentToHash);
+    const relayHashBuffer = Buffer.from(relayHash.slice(2), "hex");
+    return new Uint8Array(relayHashBuffer);
+}
+/**
+ * Calculates the relay event hash from relay event data and chain ID.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function calculateRelayEventHashUint8Array(relayEventData, chainId) {
+    const contentToHash = Buffer.concat([
+        relayEventData.depositor.toBuffer(),
+        relayEventData.recipient.toBuffer(),
+        relayEventData.exclusiveRelayer.toBuffer(),
+        relayEventData.inputToken.toBuffer(),
+        relayEventData.outputToken.toBuffer(),
+        Buffer.from(relayEventData.inputAmount),
+        relayEventData.outputAmount.toArrayLike(Buffer, "le", 8),
+        relayEventData.originChainId.toArrayLike(Buffer, "le", 8),
+        Buffer.from(relayEventData.depositId),
+        new BN(relayEventData.fillDeadline).toArrayLike(Buffer, "le", 4),
+        new BN(relayEventData.exclusivityDeadline).toArrayLike(Buffer, "le", 4),
+        Buffer.from(relayEventData.messageHash), // Renamed to messageHash in the event data.
+        chainId.toArrayLike(Buffer, "le", 8),
+    ]);
+    const relayHash = ethers.utils.keccak256(contentToHash);
+    const relayHashBuffer = Buffer.from(relayHash.slice(2), "hex");
+    return new Uint8Array(relayHashBuffer);
+}
+/**
+ * Reads a 256-bit unsigned integer from a buffer.
+ */
+export const readUInt256BE = (buffer) => {
+    let result = BigInt(0);
+    for (let i = 0; i < buffer.length; i++) {
+        result = (result << BigInt(8)) + BigInt(buffer[i]);
+    }
+    return result;
+};
+/**
+ * Hashes a non-empty message using Keccak256.
+ */
+export function hashNonEmptyMessage(message) {
+    if (message.length > 0) {
+        const hash = ethers.utils.keccak256(message);
+        return Uint8Array.from(Buffer.from(hash.slice(2), "hex"));
+    }
+    // else return zeroed bytes32
+    return new Uint8Array(32);
+}
+/**
+ * Class for relay data.
+ */
+class RelayData {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    constructor(properties) {
+        Object.assign(this, properties);
+    }
+}
+/**
+ * Schema for relay data.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const relayDataSchema = new Map([
+    [
+        RelayData,
+        {
+            kind: "struct",
+            fields: [
+                ["amountToReturn", "u64"],
+                ["chainId", "u64"],
+                ["refundAmounts", ["u64"]],
+                ["leafId", "u32"],
+                ["mintPublicKey", [32]],
+                ["refundAddresses", [[32]]],
+            ],
+        },
+    ],
+]);
+/**
+ * Calculates the relayer refund leaf hash for Solana.
+ */
+export function calculateRelayerRefundLeafHashUint8Array(relayData) {
+    const refundAddresses = relayData.refundAddresses.map((address) => address.toBuffer());
+    const data = new RelayData({
+        amountToReturn: relayData.amountToReturn,
+        chainId: relayData.chainId,
+        refundAmounts: relayData.refundAmounts,
+        leafId: relayData.leafId,
+        mintPublicKey: relayData.mintPublicKey.toBuffer(),
+        refundAddresses: refundAddresses,
+    });
+    const serializedData = serialize(relayDataSchema, data);
+    // SVM leaves require the first 64 bytes to be 0 to ensure EVM leaves can never be played on SVM and vice versa.
+    const contentToHash = Buffer.concat([Buffer.alloc(64, 0), serializedData]);
+    return ethers.utils.keccak256(contentToHash);
+}
+/**
+ * Hash function for relayer refund leaves.
+ */
+export const relayerRefundHashFn = (input) => {
+    if (!input.isSolana) {
+        const abiCoder = new ethers.utils.AbiCoder();
+        const encodedData = abiCoder.encode([
+            "tuple( uint256 amountToReturn, uint256 chainId, uint256[] refundAmounts, uint256 leafId, address l2TokenAddress, address[] refundAddresses)",
+        ], [
+            {
+                leafId: input.leafId,
+                chainId: input.chainId,
+                amountToReturn: input.amountToReturn,
+                l2TokenAddress: input.l2TokenAddress, // Type assertion
+                refundAddresses: input.refundAddresses, // Type assertion
+                refundAmounts: input.refundAmounts, // Type assertion
+            },
+        ]);
+        return ethers.utils.keccak256(encodedData);
+    }
+    else {
+        return calculateRelayerRefundLeafHashUint8Array(input);
+    }
+};
+/**
+ * Class for slow fill data.
+ */
+class SlowFillData {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    constructor(properties) {
+        Object.assign(this, properties);
+    }
+}
+/**
+ * Schema for slow fill data.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const slowFillDataSchema = new Map([
+    [
+        SlowFillData,
+        {
+            kind: "struct",
+            fields: [
+                ["depositor", [32]],
+                ["recipient", [32]],
+                ["exclusiveRelayer", [32]],
+                ["inputToken", [32]],
+                ["outputToken", [32]],
+                ["inputAmount", [32]],
+                ["outputAmount", "u64"],
+                ["originChainId", "u64"],
+                ["depositId", [32]],
+                ["fillDeadline", "u32"],
+                ["exclusivityDeadline", "u32"],
+                ["message", ["u8"]],
+                ["chainId", "u64"],
+                ["updatedOutputAmount", "u64"],
+            ],
+        },
+    ],
+]);
+/**
+ * Hash function for slow fill leaves.
+ */
+export function slowFillHashFn(slowFillLeaf) {
+    const data = new SlowFillData({
+        depositor: Uint8Array.from(slowFillLeaf.relayData.depositor.toBuffer()),
+        recipient: Uint8Array.from(slowFillLeaf.relayData.recipient.toBuffer()),
+        exclusiveRelayer: Uint8Array.from(slowFillLeaf.relayData.exclusiveRelayer.toBuffer()),
+        inputToken: Uint8Array.from(slowFillLeaf.relayData.inputToken.toBuffer()),
+        outputToken: Uint8Array.from(slowFillLeaf.relayData.outputToken.toBuffer()),
+        inputAmount: slowFillLeaf.relayData.inputAmount,
+        outputAmount: slowFillLeaf.relayData.outputAmount,
+        originChainId: slowFillLeaf.relayData.originChainId,
+        depositId: Uint8Array.from(Buffer.from(slowFillLeaf.relayData.depositId)),
+        fillDeadline: slowFillLeaf.relayData.fillDeadline,
+        exclusivityDeadline: slowFillLeaf.relayData.exclusivityDeadline,
+        message: Uint8Array.from(slowFillLeaf.relayData.message),
+        chainId: slowFillLeaf.chainId,
+        updatedOutputAmount: slowFillLeaf.updatedOutputAmount,
+    });
+    const serializedData = serialize(slowFillDataSchema, data);
+    // SVM leaves require the first 64 bytes to be 0 to ensure EVM leaves cannot be played on SVM and vice versa
+    const contentToHash = Buffer.concat([Buffer.alloc(64, 0), serializedData]);
+    return ethers.utils.keccak256(contentToHash);
+}
+//# sourceMappingURL=relayHashUtils.js.map

package/dist/esm/src/svm/web3-v1/relayHashUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relayHashUtils.js","sourceRoot":"","sources":["../../../../../src/svm/web3-v1/relayHashUtils.ts"],"names":[],"mappings":"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"}

package/dist/esm/src/svm/web3-v1/solanaProgramUtils.d.ts

@@ -0,0 +1,50 @@
+import { Idl, Program, web3 } from "@coral-xyz/anchor";
+import { Connection, Finality, PublicKey, SignaturesForAddressOptions } from "@solana/web3.js";
+import { EventType } from "../types.svm";
+/**
+ * Finds a program address with a given label and optional extra seeds.
+ */
+export declare function findProgramAddress(label: string, program: PublicKey, extraSeeds?: string[]): {
+    publicKey: PublicKey;
+    bump: number;
+};
+/**
+ * Reads events from a transaction.
+ */
+export declare function readEvents<IDL extends Idl = Idl>(connection: Connection, txSignature: string, programs: Program<IDL>[], commitment?: Finality): Promise<{
+    program: web3.PublicKey;
+    data: any;
+    name: string | undefined;
+}[]>;
+/**
+ * Processes events from a transaction.
+ */
+export declare function processEventFromTx(txResult: web3.VersionedTransactionResponse, programs: Program<any>[]): {
+    program: web3.PublicKey;
+    data: any;
+    name: string | undefined;
+}[];
+/**
+ * Helper function to wait for an event to be emitted. Should only be used in tests where txSignature is known to emit.
+ */
+export declare function readEventsUntilFound<IDL extends Idl = Idl>(connection: Connection, txSignature: string, programs: Program<IDL>[]): Promise<{
+    program: web3.PublicKey;
+    data: any;
+    name: string | undefined;
+}[]>;
+/**
+ * Retrieves a specific event by name from a list of events.
+ */
+export declare function getEvent(events: any[], program: PublicKey, eventName: string): any;
+/**
+ * Reads all events for a specific program.
+ */
+export declare function readProgramEvents(connection: Connection, program: Program<any>, finality?: Finality, options?: SignaturesForAddressOptions): Promise<EventType[]>;
+/**
+ * Subscribes to CPI events for a program.
+ */
+export declare function subscribeToCpiEventsForProgram(connection: Connection, program: Program<any>, callback: (events: any[]) => void): number;
+/**
+ * Stringifies a CPI event.
+ */
+export declare function stringifyCpiEvent(obj: any, eventName: string): any;

package/dist/esm/src/svm/web3-v1/solanaProgramUtils.js

@@ -0,0 +1,230 @@
+import { BN, utils } from "@coral-xyz/anchor";
+import { PublicKey, } from "@solana/web3.js";
+import { deserialize } from "borsh";
+import { publicKeyToEvmAddress, u8Array32ToInt } from "./conversionUtils";
+/**
+ * Finds a program address with a given label and optional extra seeds.
+ */
+export function findProgramAddress(label, program, extraSeeds) {
+    const seeds = [Buffer.from(utils.bytes.utf8.encode(label))];
+    if (extraSeeds) {
+        for (const extraSeed of extraSeeds) {
+            if (typeof extraSeed === "string") {
+                seeds.push(Buffer.from(utils.bytes.utf8.encode(extraSeed)));
+            }
+            else if (Array.isArray(extraSeed)) {
+                seeds.push(Buffer.from(extraSeed));
+            }
+            else if (Buffer.isBuffer(extraSeed)) {
+                seeds.push(extraSeed);
+            }
+            else {
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                seeds.push(extraSeed.toBuffer());
+            }
+        }
+    }
+    const res = PublicKey.findProgramAddressSync(seeds, program);
+    return { publicKey: res[0], bump: res[1] };
+}
+/**
+ * Reads events from a transaction.
+ */
+export async function readEvents(connection, txSignature, programs, commitment = "confirmed") {
+    const txResult = await connection.getTransaction(txSignature, { commitment, maxSupportedTransactionVersion: 0 });
+    if (txResult === null)
+        return [];
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    return processEventFromTx(txResult, programs);
+}
+/**
+ * Processes events from a transaction.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function processEventFromTx(txResult, programs) {
+    const eventAuthorities = new Map();
+    for (const program of programs) {
+        eventAuthorities.set(program.programId.toString(), findProgramAddress("__event_authority", program.programId).publicKey);
+    }
+    const events = [];
+    // Resolve any potential addresses that were passed from address lookup tables.
+    const messageAccountKeys = txResult.transaction.message.getAccountKeys({
+        accountKeysFromLookups: txResult.meta?.loadedAddresses,
+    });
+    for (const ixBlock of txResult.meta?.innerInstructions ?? []) {
+        for (const ix of ixBlock.instructions) {
+            for (const program of programs) {
+                const ixProgramId = messageAccountKeys.get(ix.programIdIndex);
+                const singleIxAccount = ix.accounts.length === 1 ? messageAccountKeys.get(ix.accounts[0]) : undefined;
+                if (ixProgramId !== undefined &&
+                    singleIxAccount !== undefined &&
+                    program.programId.equals(ixProgramId) &&
+                    eventAuthorities.get(ixProgramId.toString())?.equals(singleIxAccount)) {
+                    const ixData = utils.bytes.bs58.decode(ix.data);
+                    const eventData = utils.bytes.base64.encode(Buffer.from(new Uint8Array(ixData).slice(8)));
+                    const event = program.coder.events.decode(eventData);
+                    events.push({
+                        program: program.programId,
+                        data: event?.data,
+                        name: event?.name,
+                    });
+                }
+            }
+        }
+    }
+    return events;
+}
+/**
+ * Helper function to wait for an event to be emitted. Should only be used in tests where txSignature is known to emit.
+ */
+export async function readEventsUntilFound(connection, txSignature, programs) {
+    const startTime = Date.now();
+    let txResult = null;
+    while (Date.now() - startTime < 5000) {
+        // 5 seconds timeout to wait to find the event.
+        txResult = await connection.getTransaction(txSignature, {
+            commitment: "confirmed",
+            maxSupportedTransactionVersion: 0,
+        });
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        if (txResult !== null)
+            return processEventFromTx(txResult, programs);
+        await new Promise((resolve) => setTimeout(resolve, 50)); // 50 ms delay between retries.
+    }
+    throw new Error("No event found within 5 seconds");
+}
+/**
+ * Retrieves a specific event by name from a list of events.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function getEvent(events, program, eventName) {
+    for (const event of events) {
+        if (event.name === eventName && program.toString() === event.program.toString()) {
+            return event.data;
+        }
+    }
+    throw new Error("Event " + eventName + " not found");
+}
+/**
+ * Reads all events for a specific program.
+ */
+export async function readProgramEvents(connection, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+program, finality = "confirmed", options = { limit: 1000 }) {
+    const allSignatures = [];
+    // Fetch all signatures in sequential batches
+    for (;;) {
+        const signatures = await connection.getSignaturesForAddress(program.programId, options, finality);
+        allSignatures.push(...signatures);
+        // Update options for the next batch. Set before to the last fetched signature.
+        if (signatures.length > 0) {
+            options = { ...options, before: signatures[signatures.length - 1].signature };
+        }
+        if (options.limit && signatures.length < options.limit)
+            break; // Exit early if the number of signatures < limit
+    }
+    // Fetch events for all signatures in parallel
+    const eventsWithSlots = await Promise.all(allSignatures.map(async (signature) => {
+        const events = await readEvents(connection, signature.signature, [program], finality);
+        return events.map((event) => ({
+            ...event,
+            confirmationStatus: signature.confirmationStatus || "Unknown",
+            blockTime: signature.blockTime || 0,
+            signature: signature.signature,
+            slot: signature.slot,
+            name: event.name || "Unknown",
+        }));
+    }));
+    return eventsWithSlots.flat(); // Flatten the array of events & return.
+}
+/**
+ * Subscribes to CPI events for a program.
+ */
+export function subscribeToCpiEventsForProgram(connection, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+program, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+callback) {
+    const subscriptionId = connection.onLogs(new PublicKey(findProgramAddress("__event_authority", program.programId).publicKey.toString()), async (logs) => {
+        callback(await readEvents(connection, logs.signature, [program], "confirmed"));
+    }, "confirmed");
+    return subscriptionId;
+}
+/**
+ * Class for DepositId.
+ */
+class DepositId {
+    value; // Fixed-length array as Uint8Array
+    constructor(properties) {
+        this.value = properties.value;
+    }
+}
+/**
+ * Borsh schema for deserializing DepositId.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const depositIdSchema = new Map([[DepositId, { kind: "struct", fields: [["value", [32]]] }]] // Fixed array [u8; 32]
+);
+/**
+ * Parses depositId: checks if only the first 4 bytes are non-zero and returns a u32 or deserializes the full array.
+ */
+function parseDepositId(value) {
+    const restAreZero = value.slice(4).every((byte) => byte === 0);
+    if (restAreZero) {
+        // Parse the first 4 bytes as a little-endian u32
+        const u32Value = new DataView(value.buffer).getUint32(0, true); // true for little-endian
+        return u32Value.toString();
+    }
+    // Deserialize the full depositId using the Borsh schema
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const depositId = deserialize(depositIdSchema, DepositId, Buffer.from(value));
+    return new BN(depositId.value).toString();
+}
+/**
+ * Stringifies a CPI event.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function stringifyCpiEvent(obj, eventName) {
+    if (obj?.constructor?.toString()?.includes("PublicKey")) {
+        if (obj.toString().startsWith("111111111111")) {
+            // First 12 bytes are 0 for EVM addresses.
+            return publicKeyToEvmAddress(obj);
+        }
+        return obj.toString();
+    }
+    else if (BN.isBN(obj)) {
+        return obj.toString();
+    }
+    else if (typeof obj === "bigint") {
+        return obj.toString();
+    }
+    else if (Array.isArray(obj) && obj.length == 32) {
+        return Buffer.from(obj).toString("hex"); // Hex representation for fixed-length arrays
+    }
+    else if (Array.isArray(obj)) {
+        return obj.map((obj) => stringifyCpiEvent(obj, eventName));
+    }
+    else if (obj !== null && typeof obj === "object") {
+        return Object.fromEntries(Object.entries(obj).map(([key, value]) => {
+            if (Array.isArray(value) && value.length === 32) {
+                if (key === "depositId" || key === "deposit_id") {
+                    // Parse depositId using the helper function
+                    const parsedValue = parseDepositId(new Uint8Array(value));
+                    return [key, parsedValue];
+                }
+                else if (eventName.toLowerCase() === "fundsdeposited" &&
+                    (key === "outputAmount" || key === "output_amount")) {
+                    return [key, u8Array32ToInt(new Uint8Array(value)).toString()];
+                }
+                else if ((eventName.toLowerCase() === "filledrelay" || eventName.toLowerCase() === "requestedslowfill") &&
+                    (key === "inputAmount" || key === "input_amount")) {
+                    return [key, u8Array32ToInt(new Uint8Array(value)).toString()];
+                }
+            }
+            return [key, stringifyCpiEvent(value, eventName)];
+        }));
+    }
+    return obj;
+}
+//# sourceMappingURL=solanaProgramUtils.js.map

package/dist/esm/src/svm/web3-v1/solanaProgramUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"solanaProgramUtils.js","sourceRoot":"","sources":["../../../../../src/svm/web3-v1/solanaProgramUtils.ts"],"names":[],"mappings":"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"}

package/dist/esm/src/svm/web3-v1/transactionUtils.d.ts

@@ -0,0 +1,12 @@
+import { AddressLookupTableAccount, Connection, Keypair, PublicKey, TransactionInstruction } from "@solana/web3.js";
+/**
+ * Sends a transaction using an Address Lookup Table for large numbers of accounts.
+ */
+export declare function sendTransactionWithLookupTable(connection: Connection, instructions: TransactionInstruction[], sender: Keypair, additionalSigners?: Keypair[]): Promise<{
+    txSignature: string;
+    lookupTableAddress: PublicKey;
+}>;
+/**
+ * Sends a transaction using existing Address Lookup Table.
+ */
+export declare function sendTransactionWithExistingLookupTable(connection: Connection, instructions: TransactionInstruction[], lookupTableAccount: AddressLookupTableAccount, sender: Keypair, additionalSigners?: Keypair[]): Promise<string>;

package/dist/esm/src/svm/web3-v1/transactionUtils.js

@@ -0,0 +1,82 @@
+import { web3 } from "@coral-xyz/anchor";
+import { AddressLookupTableProgram, TransactionMessage, VersionedTransaction, } from "@solana/web3.js";
+/**
+ * Sends a transaction using an Address Lookup Table for large numbers of accounts.
+ */
+export async function sendTransactionWithLookupTable(connection, instructions, sender, additionalSigners = []) {
+    // Maximum number of accounts that can be added to Address Lookup Table (ALT) in a single transaction.
+    const maxExtendedAccounts = 30;
+    // Consolidate addresses from all instructions into a single array for the ALT.
+    const lookupAddresses = Array.from(new Set(instructions.flatMap((instruction) => [
+        instruction.programId,
+        ...instruction.keys.map((accountMeta) => accountMeta.pubkey),
+    ])));
+    // Create instructions for creating and extending the ALT.
+    const [lookupTableInstruction, lookupTableAddress] = await AddressLookupTableProgram.createLookupTable({
+        authority: sender.publicKey,
+        payer: sender.publicKey,
+        recentSlot: await connection.getSlot(),
+    });
+    // Submit the ALT creation transaction
+    await web3.sendAndConfirmTransaction(
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    connection, new web3.Transaction().add(lookupTableInstruction), [sender], {
+        commitment: "confirmed",
+        skipPreflight: true,
+    });
+    // Extend the ALT with all accounts making sure not to exceed the maximum number of accounts per transaction.
+    for (let i = 0; i < lookupAddresses.length; i += maxExtendedAccounts) {
+        const extendInstruction = AddressLookupTableProgram.extendLookupTable({
+            lookupTable: lookupTableAddress,
+            authority: sender.publicKey,
+            payer: sender.publicKey,
+            addresses: lookupAddresses.slice(i, i + maxExtendedAccounts),
+        });
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        await web3.sendAndConfirmTransaction(connection, new web3.Transaction().add(extendInstruction), [sender], {
+            commitment: "confirmed",
+            skipPreflight: true,
+        });
+    }
+    // Wait for slot to advance. LUTs only active after slot advance.
+    const initialSlot = await connection.getSlot();
+    while ((await connection.getSlot()) === initialSlot) {
+        await new Promise((resolve) => setTimeout(resolve, 50));
+    }
+    // Fetch the AddressLookupTableAccount
+    const lookupTableAccount = (await connection.getAddressLookupTable(lookupTableAddress)).value;
+    if (lookupTableAccount === null)
+        throw new Error("AddressLookupTableAccount not fetched");
+    // Create the versioned transaction
+    const versionedTx = new VersionedTransaction(new TransactionMessage({
+        payerKey: sender.publicKey,
+        recentBlockhash: (await connection.getLatestBlockhash()).blockhash,
+        instructions,
+    }).compileToV0Message([lookupTableAccount]));
+    // Sign and submit the versioned transaction.
+    versionedTx.sign([sender, ...additionalSigners]);
+    const txSignature = await connection.sendTransaction(versionedTx);
+    // Confirm the versioned transaction
+    const block = await connection.getLatestBlockhash();
+    await connection.confirmTransaction({ signature: txSignature, blockhash: block.blockhash, lastValidBlockHeight: block.lastValidBlockHeight }, "confirmed");
+    return { txSignature, lookupTableAddress };
+}
+/**
+ * Sends a transaction using existing Address Lookup Table.
+ */
+export async function sendTransactionWithExistingLookupTable(connection, instructions, lookupTableAccount, sender, additionalSigners = []) {
+    // Create the versioned transaction
+    const versionedTx = new VersionedTransaction(new TransactionMessage({
+        payerKey: sender.publicKey,
+        recentBlockhash: (await connection.getLatestBlockhash()).blockhash,
+        instructions,
+    }).compileToV0Message([lookupTableAccount]));
+    // Sign and submit the versioned transaction.
+    versionedTx.sign([sender, ...additionalSigners]);
+    const txSignature = await connection.sendTransaction(versionedTx);
+    // Confirm the versioned transaction
+    const block = await connection.getLatestBlockhash();
+    await connection.confirmTransaction({ signature: txSignature, blockhash: block.blockhash, lastValidBlockHeight: block.lastValidBlockHeight }, "confirmed");
+    return txSignature;
+}
+//# sourceMappingURL=transactionUtils.js.map

package/dist/esm/src/svm/web3-v1/transactionUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactionUtils.js","sourceRoot":"","sources":["../../../../../src/svm/web3-v1/transactionUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,OAAO,EAEL,yBAAyB,EAKzB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AAEzB;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAClD,UAAsB,EACtB,YAAsC,EACtC,MAAe,EACf,oBAA+B,EAAE;IAEjC,sGAAsG;IACtG,MAAM,mBAAmB,GAAG,EAAE,CAAC;IAE/B,+EAA+E;IAC/E,MAAM,eAAe,GAAG,KAAK,CAAC,IAAI,CAChC,IAAI,GAAG,CACL,YAAY,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;QACpC,WAAW,CAAC,SAAS;QACrB,GAAG,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC;KAC7D,CAAC,CACH,CACF,CAAC;IAEF,0DAA0D;IAC1D,MAAM,CAAC,sBAAsB,EAAE,kBAAkB,CAAC,GAAG,MAAM,yBAAyB,CAAC,iBAAiB,CAAC;QACrG,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,KAAK,EAAE,MAAM,CAAC,SAAS;QACvB,UAAU,EAAE,MAAM,UAAU,CAAC,OAAO,EAAE;KACvC,CAAC,CAAC;IAEH,sCAAsC;IACtC,MAAM,IAAI,CAAC,yBAAyB;IAClC,8DAA8D;IAC9D,UAAiB,EACjB,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC,GAAG,CAAC,sBAAsB,CAAC,EAClD,CAAC,MAAM,CAAC,EACR;QACE,UAAU,EAAE,WAAW;QACvB,aAAa,EAAE,IAAI;KACpB,CACF,CAAC;IAEF,6GAA6G;IAC7G,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,eAAe,CAAC,MAAM,EAAE,CAAC,IAAI,mBAAmB,EAAE,CAAC;QACrE,MAAM,iBAAiB,GAAG,yBAAyB,CAAC,iBAAiB,CAAC;YACpE,WAAW,EAAE,kBAAkB;YAC/B,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,KAAK,EAAE,MAAM,CAAC,SAAS;YACvB,SAAS,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,mBAAmB,CAAC;SAC7D,CAAC,CAAC;QAEH,8DAA8D;QAC9D,MAAM,IAAI,CAAC,yBAAyB,CAAC,UAAiB,EAAE,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC,GAAG,CAAC,iBAAiB,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE;YAC/G,UAAU,EAAE,WAAW;YACvB,aAAa,EAAE,IAAI;SACpB,CAAC,CAAC;IACL,CAAC;IAED,iEAAiE;IACjE,MAAM,WAAW,GAAG,MAAM,UAAU,CAAC,OAAO,EAAE,CAAC;IAC/C,OAAO,CAAC,MAAM,UAAU,CAAC,OAAO,EAAE,CAAC,KAAK,WAAW,EAAE,CAAC;QACpD,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,sCAAsC;IACtC,MAAM,kBAAkB,GAAG,CAAC,MAAM,UAAU,CAAC,qBAAqB,CAAC,kBAAkB,CAAC,CAAC,CAAC,KAAK,CAAC;IAC9F,IAAI,kBAAkB,KAAK,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAE1F,mCAAmC;IACnC,MAAM,WAAW,GAAG,IAAI,oBAAoB,CAC1C,IAAI,kBAAkB,CAAC;QACrB,QAAQ,EAAE,MAAM,CAAC,SAAS;QAC1B,eAAe,EAAE,CAAC,MAAM,UAAU,CAAC,kBAAkB,EAAE,CAAC,CAAC,SAAS;QAClE,YAAY;KACb,CAAC,CAAC,kBAAkB,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAC5C,CAAC;IAEF,6CAA6C;IAC7C,WAAW,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,GAAG,iBAAiB,CAAC,CAAC,CAAC;IACjD,MAAM,WAAW,GAAG,MAAM,UAAU,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC;IAElE,oCAAoC;IACpC,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,kBAAkB,EAAE,CAAC;IACpD,MAAM,UAAU,CAAC,kBAAkB,CACjC,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,oBAAoB,EAAE,KAAK,CAAC,oBAAoB,EAAE,EACxG,WAAW,CACZ,CAAC;IAEF,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,sCAAsC,CAC1D,UAAsB,EACtB,YAAsC,EACtC,kBAA6C,EAC7C,MAAe,EACf,oBAA+B,EAAE;IAEjC,mCAAmC;IACnC,MAAM,WAAW,GAAG,IAAI,oBAAoB,CAC1C,IAAI,kBAAkB,CAAC;QACrB,QAAQ,EAAE,MAAM,CAAC,SAAS;QAC1B,eAAe,EAAE,CAAC,MAAM,UAAU,CAAC,kBAAkB,EAAE,CAAC,CAAC,SAAS;QAClE,YAAY;KACb,CAAC,CAAC,kBAAkB,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAC5C,CAAC;IAEF,6CAA6C;IAC7C,WAAW,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,GAAG,iBAAiB,CAAC,CAAC,CAAC;IACjD,MAAM,WAAW,GAAG,MAAM,UAAU,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC;IAElE,oCAAoC;IACpC,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,kBAAkB,EAAE,CAAC;IACpD,MAAM,UAAU,CAAC,kBAAkB,CACjC,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,oBAAoB,EAAE,KAAK,CAAC,oBAAoB,EAAE,EACxG,WAAW,CACZ,CAAC;IAEF,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/esm/src/svm/web3-v2/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./solanaProgramUtils";
+export * from "./transactionUtils";
+export * from "./types";

package/dist/esm/src/svm/web3-v2/index.js

@@ -0,0 +1,4 @@
+export * from "./solanaProgramUtils";
+export * from "./transactionUtils";
+export * from "./types";
+//# sourceMappingURL=index.js.map

package/dist/esm/src/svm/web3-v2/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/svm/web3-v2/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,SAAS,CAAC"}