@zircuit/ovault-evm 0.0.1

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./oVaultSync";
+export * from "./types";
+export * from "./addresses";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export * from "./oVaultSync";
+export * from "./types";
+export * from "./addresses";

package/dist/oVaultSync/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./transfer";
+export * from "./tracking";
+//# sourceMappingURL=index.d.ts.map

package/dist/oVaultSync/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/oVaultSync/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}

package/dist/oVaultSync/index.js

@@ -0,0 +1,2 @@
+export * from "./transfer";
+export * from "./tracking";

package/dist/oVaultSync/tracking.d.ts

@@ -0,0 +1,46 @@
+import { Chain } from "viem";
+import { OVaultFailureReason, OVaultTransactionStep, OVaultWithdrawalInfo } from "../types";
+interface TrackingChainConfigs {
+    sourceChain: Chain;
+    hubChain: Chain;
+    dstChain: Chain;
+    rpcUrls?: {
+        sourceChain?: string;
+        hubChain?: string;
+        dstChain?: string;
+    };
+}
+/**
+ * Track the OVault transaction
+ * There are 4 possible scenarios:
+ * 1. BBB - source chain, hub chain, dst chain are the same
+ * 2. BBA - source chain, hub chain are the same, dst chain is different
+ * 3. ABB - hub chain, dst chain are the same, source chain is different
+ * 4. ABA - source chain, hub chain, dst chain are different. Source chain can optionally be the same as the dst chain.
+ *
+ * @param txHash - The hash of the transaction to track on the source chain.
+ */
+export declare function trackOVaultSyncTransaction(txHash: `0x${string}`, viemConfigs: TrackingChainConfigs, withdrawalInfo?: OVaultWithdrawalInfo): Promise<{
+    step: OVaultTransactionStep;
+    refunded: boolean | undefined;
+    failureReason: OVaultFailureReason | undefined;
+    destinationTxHash: `0x${string}` | undefined;
+} | {
+    step: OVaultTransactionStep;
+    failureReason: OVaultFailureReason;
+    refunded: boolean;
+    hubTxHash: `0x${string}`;
+    destinationTxHash?: undefined;
+} | {
+    step: OVaultTransactionStep;
+    failureReason: OVaultFailureReason;
+    refunded?: undefined;
+    destinationTxHash?: undefined;
+} | {
+    step: OVaultTransactionStep;
+    failureReason?: undefined;
+    refunded?: undefined;
+    destinationTxHash?: undefined;
+}>;
+export {};
+//# sourceMappingURL=tracking.d.ts.map

package/dist/oVaultSync/tracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracking.d.ts","sourceRoot":"","sources":["../../src/oVaultSync/tracking.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EAMN,MAAM,MAAM,CAAC;AACd,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EAErB,oBAAoB,EACrB,MAAM,UAAU,CAAC;AAKlB,UAAU,oBAAoB;IAC5B,WAAW,EAAE,KAAK,CAAC;IACnB,QAAQ,EAAE,KAAK,CAAC;IAChB,QAAQ,EAAE,KAAK,CAAC;IAChB,OAAO,CAAC,EAAE;QACR,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAijBD;;;;;;;;;GASG;AACH,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,KAAK,MAAM,EAAE,EACrB,WAAW,EAAE,oBAAoB,EACjC,cAAc,CAAC,EAAE,oBAAoB;;;;;;;;;;;;;;;;;;;;;GAYtC"}

package/dist/oVaultSync/tracking.js

@@ -0,0 +1,458 @@
+import { createPublicClient, decodeEventLog, http, } from "viem";
+import { OVaultFailureReason, OVaultTransactionStep, } from "../types";
+import { V2 as scanClient } from "@layerzerolabs/scan-client-v2";
+import { OVaultComposerSyncAbi } from "../contracts/OVaultComposerSync";
+import { OVaultComposerAbi } from "../contracts/OVaultComposer";
+async function getTxStatus(txHash, client) {
+    const receipt = await client.getTransactionReceipt({ hash: txHash });
+    if (receipt.status === "reverted") {
+        return {
+            success: false,
+            error: OVaultFailureReason.UNKNOWN,
+        };
+    }
+    else if (receipt.status === "success") {
+        return {
+            success: true,
+        };
+    }
+    return {
+        success: false,
+    };
+}
+async function isRefunded(txHash, client) {
+    const receipt = await client.waitForTransactionReceipt({
+        hash: txHash,
+    });
+    if (receipt.status !== "success") {
+        return false;
+    }
+    for (const log of receipt.logs) {
+        try {
+            const values = decodeEventLog({
+                abi: OVaultComposerSyncAbi,
+                data: log.data,
+                topics: log.topics,
+            });
+            if (values.eventName === "Refunded") {
+                return true;
+            }
+        }
+        catch (e) {
+            // Ignore errors in decoding logs, they might not be OFT events
+        }
+    }
+    return false;
+}
+// Helper function to find the withdrawal index by looking at WithdrawalProcessed events
+const findWithdrawalIndexInReceipt = async (message, withdrawalInfo, client) => {
+    try {
+        // Get the transaction hash from the source
+        const txHash = message?.source?.tx?.txHash;
+        if (!txHash) {
+            console.warn("No txHash found in message");
+            return null;
+        }
+        // Get the transaction receipt
+        const receipt = await client.getTransactionReceipt({ hash: txHash });
+        if (!receipt || receipt.logs.length === 0) {
+            console.warn("No receipt or logs found for transaction", txHash);
+            return null;
+        }
+        const withdrawalProcessedEvents = [];
+        for (const log of receipt.logs) {
+            try {
+                const decoded = decodeEventLog({
+                    abi: OVaultComposerAbi,
+                    data: log.data,
+                    topics: log.topics,
+                    eventName: "WithdrawalProcessed",
+                });
+                const args = decoded.args;
+                withdrawalProcessedEvents.push({
+                    index: args.index,
+                    initiator: args.initiator,
+                    timestamp: args.timestamp,
+                });
+            }
+            catch {
+                // Ignore, event is not WithdrawalProcessed
+            }
+        }
+        const matchIndex = withdrawalProcessedEvents.findIndex((event) => {
+            const indexMatch = event.index?.toString() === withdrawalInfo.index?.toString();
+            const initiatorMatch = event.initiator?.toLowerCase() ===
+                withdrawalInfo.initiator?.toLowerCase();
+            if (indexMatch && initiatorMatch) {
+                return true;
+            }
+            return false;
+        });
+        if (matchIndex < 0) {
+            console.warn("Could not find matching withdrawal in events", {
+                searchingForIndex: withdrawalInfo.index,
+                searchingForInitiator: withdrawalInfo.initiator,
+                foundInEvents: withdrawalProcessedEvents.map((e) => ({
+                    index: e.index.toString(),
+                    initiator: e.initiator,
+                    timestamp: e.timestamp.toString(),
+                })),
+            });
+        }
+        return matchIndex >= 0 ? matchIndex : null;
+    }
+    catch (error) {
+        console.error("Error finding withdrawal in receipt:", error);
+        return null;
+    }
+};
+async function getLzTxStatus(txHash) {
+    try {
+        const messages = await scanClient.getMessagesBySrcTxHash(txHash);
+        if (!Array.isArray(messages)) {
+            console.error("Invalid response from LayerZero scan API", {
+                txHash,
+                messages,
+            });
+            return [];
+        }
+        return messages;
+    }
+    catch (error) {
+        console.error("Error fetching LayerZero messages", {
+            txHash,
+            error: error instanceof Error ? error.message : error,
+        });
+        return [];
+    }
+}
+async function trackBBB(txHash, viemConfigs) {
+    const { sourceChain } = viemConfigs;
+    const sourceClient = createPublicClient({
+        chain: sourceChain,
+        transport: http(viemConfigs.rpcUrls?.sourceChain),
+    });
+    const sourceTx = await getTxStatus(txHash, sourceClient);
+    // In a BBB transaction, the source chain transaction is the only transaction.
+    // If the source chain transaction fails, the transaction is refunded.
+    return {
+        step: sourceTx.success
+            ? OVaultTransactionStep.COMPLETED
+            : OVaultTransactionStep.HUB_CHAIN_TRANSACTION,
+        refunded: sourceTx.error ? true : undefined,
+        failureReason: sourceTx.error,
+        destinationTxHash: sourceTx.success ? txHash : undefined,
+    };
+}
+async function trackABB(txHash, viemConfigs, withdrawalInfo) {
+    const { sourceChain, hubChain } = viemConfigs;
+    const sourceClient = createPublicClient({
+        chain: sourceChain,
+        transport: http(viemConfigs.rpcUrls?.sourceChain),
+    });
+    const hubClient = createPublicClient({
+        chain: hubChain,
+        transport: http(viemConfigs.rpcUrls?.hubChain),
+    });
+    const sourceTx = await getTxStatus(txHash, sourceClient);
+    if (sourceTx.error) {
+        return {
+            step: OVaultTransactionStep.SOURCE_CHAIN_TRANSACTION,
+            failureReason: OVaultFailureReason.UNKNOWN,
+        };
+    }
+    else if (!sourceTx.success) {
+        // Transaction is still in progress
+        return {
+            step: OVaultTransactionStep.SOURCE_CHAIN_TRANSACTION,
+        };
+    }
+    // Source Tx is successful, now we need to track the hub chain transaction.
+    const sourceToHubMessages = await getLzTxStatus(txHash);
+    if (sourceToHubMessages.length === 0) {
+        return {
+            step: OVaultTransactionStep.SOURCE_TO_HUB_LZ_TRANSACTION,
+        };
+    }
+    let sourceToHubMessage = sourceToHubMessages[0];
+    // For withdrawals, find which message index corresponds to this specific withdrawal
+    if (withdrawalInfo) {
+        const msgIndex = await findWithdrawalIndexInReceipt(sourceToHubMessage, withdrawalInfo, sourceClient);
+        if (msgIndex === null) {
+            console.warn("Could not find withdrawal in receipt events", withdrawalInfo);
+            return {
+                step: OVaultTransactionStep.HUB_CHAIN_TRANSACTION,
+            };
+        }
+        sourceToHubMessage = sourceToHubMessages[msgIndex];
+    }
+    if (sourceToHubMessage.status.name === "INFLIGHT" ||
+        sourceToHubMessage.status.name === "CONFIRMING") {
+        // Transaction is still in progress
+        return {
+            step: OVaultTransactionStep.SOURCE_TO_HUB_LZ_TRANSACTION,
+        };
+    }
+    if (sourceToHubMessage.status.name !== "DELIVERED") {
+        return {
+            step: OVaultTransactionStep.SOURCE_TO_HUB_LZ_TRANSACTION,
+            failureReason: OVaultFailureReason.UNKNOWN,
+        };
+    }
+    // Track hub chain transaction
+    const executorDst = sourceToHubMessage.destination;
+    const composeTxHash = executorDst?.lzCompose?.txs?.[0]
+        ?.txHash;
+    const failedCompose = executorDst?.lzCompose?.failedTx?.[0]
+        ?.txHash;
+    if (failedCompose) {
+        return {
+            step: OVaultTransactionStep.HUB_CHAIN_TRANSACTION,
+            failureReason: OVaultFailureReason.UNKNOWN,
+            refunded: false,
+            hubTxHash: failedCompose,
+        };
+    }
+    if (!composeTxHash) {
+        // Waiting for the compose tx to be created
+        return {
+            step: OVaultTransactionStep.HUB_CHAIN_TRANSACTION,
+        };
+    }
+    const hubTx = await getTxStatus(composeTxHash, hubClient);
+    const refunded = await isRefunded(composeTxHash, hubClient);
+    return {
+        step: hubTx.success
+            ? OVaultTransactionStep.COMPLETED
+            : OVaultTransactionStep.HUB_CHAIN_TRANSACTION,
+        refunded: hubTx.error || refunded ? true : undefined,
+        failureReason: hubTx.error || (refunded ? OVaultFailureReason.UNKNOWN : undefined),
+        destinationTxHash: hubTx.success ? composeTxHash : undefined,
+        hubTxHash: composeTxHash,
+    };
+}
+async function trackBBA(txHash, viemConfigs, withdrawalInfo) {
+    const { sourceChain, dstChain } = viemConfigs;
+    const sourceClient = createPublicClient({
+        chain: sourceChain,
+        transport: http(viemConfigs.rpcUrls?.sourceChain),
+    });
+    const dstClient = createPublicClient({
+        chain: dstChain,
+        transport: http(viemConfigs.rpcUrls?.dstChain),
+    });
+    const sourceTx = await getTxStatus(txHash, sourceClient);
+    if (sourceTx.error) {
+        return {
+            step: OVaultTransactionStep.SOURCE_CHAIN_TRANSACTION,
+            failureReason: OVaultFailureReason.UNKNOWN,
+        };
+    }
+    else if (!sourceTx.success) {
+        // Transaction is still in progress
+        return {
+            step: OVaultTransactionStep.SOURCE_CHAIN_TRANSACTION,
+        };
+    }
+    const hubToDstMessages = await getLzTxStatus(txHash);
+    if (hubToDstMessages.length === 0) {
+        return {
+            step: OVaultTransactionStep.HUB_TO_DST_LZ_TRANSACTION,
+        };
+    }
+    let hubToDstMessage = hubToDstMessages[0];
+    // For withdrawals, find which message index corresponds to this specific withdrawal
+    if (withdrawalInfo) {
+        const msgIndex = await findWithdrawalIndexInReceipt(hubToDstMessage, withdrawalInfo, sourceClient);
+        if (msgIndex === null) {
+            console.warn("Could not find withdrawal in receipt events", withdrawalInfo);
+            return {
+                step: OVaultTransactionStep.HUB_TO_DST_LZ_TRANSACTION,
+            };
+        }
+        hubToDstMessage = hubToDstMessages[msgIndex];
+    }
+    if (hubToDstMessage.status.name === "INFLIGHT" ||
+        hubToDstMessage.status.name === "CONFIRMING") {
+        return {
+            step: OVaultTransactionStep.HUB_TO_DST_LZ_TRANSACTION,
+        };
+    }
+    if (hubToDstMessage.status.name !== "DELIVERED") {
+        return {
+            step: OVaultTransactionStep.HUB_TO_DST_LZ_TRANSACTION,
+            failureReason: OVaultFailureReason.UNKNOWN,
+        };
+    }
+    // Track dst chain transaction
+    const dstTxHash = hubToDstMessage.destination?.tx?.txHash;
+    if (!dstTxHash) {
+        return {
+            step: OVaultTransactionStep.DST_CHAIN_TRANSACTION,
+        };
+    }
+    const dstTx = await getTxStatus(dstTxHash, dstClient);
+    return {
+        step: dstTx.success
+            ? OVaultTransactionStep.COMPLETED
+            : OVaultTransactionStep.DST_CHAIN_TRANSACTION,
+        refunded: false,
+        failureReason: dstTx.error,
+        destinationTxHash: dstTx.success ? dstTxHash : undefined,
+    };
+}
+async function trackABA(txHash, viemConfigs, withdrawalInfo) {
+    const { sourceChain, hubChain, dstChain } = viemConfigs;
+    const sourceClient = createPublicClient({
+        chain: sourceChain,
+        transport: http(viemConfigs.rpcUrls?.sourceChain),
+    });
+    const hubClient = createPublicClient({
+        chain: hubChain,
+        transport: http(viemConfigs.rpcUrls?.hubChain),
+    });
+    const dstClient = createPublicClient({
+        chain: dstChain,
+        transport: http(viemConfigs.rpcUrls?.dstChain),
+    });
+    const sourceTx = await getTxStatus(txHash, sourceClient);
+    if (sourceTx.error) {
+        return {
+            step: OVaultTransactionStep.SOURCE_CHAIN_TRANSACTION,
+            failureReason: OVaultFailureReason.UNKNOWN,
+        };
+    }
+    else if (!sourceTx.success) {
+        // Transaction is still in progress
+        return {
+            step: OVaultTransactionStep.SOURCE_CHAIN_TRANSACTION,
+        };
+    }
+    const sourceToHubMessages = await getLzTxStatus(txHash);
+    if (sourceToHubMessages.length === 0) {
+        return {
+            step: OVaultTransactionStep.SOURCE_TO_HUB_LZ_TRANSACTION,
+        };
+    }
+    let sourceToHubMessage = sourceToHubMessages[0];
+    // For withdrawals, find which message index corresponds to this specific withdrawal
+    if (withdrawalInfo) {
+        const msgIndex = await findWithdrawalIndexInReceipt(sourceToHubMessage, withdrawalInfo, sourceClient);
+        if (msgIndex === null) {
+            console.warn("Could not find withdrawal in receipt events", withdrawalInfo);
+            return {
+                step: OVaultTransactionStep.HUB_CHAIN_TRANSACTION,
+            };
+        }
+        sourceToHubMessage = sourceToHubMessages[msgIndex];
+    }
+    if (sourceToHubMessage.status.name === "INFLIGHT" ||
+        sourceToHubMessage.status.name === "CONFIRMING") {
+        return {
+            step: OVaultTransactionStep.SOURCE_TO_HUB_LZ_TRANSACTION,
+        };
+    }
+    if (sourceToHubMessage.status.name !== "DELIVERED") {
+        return {
+            step: OVaultTransactionStep.SOURCE_TO_HUB_LZ_TRANSACTION,
+            failureReason: OVaultFailureReason.UNKNOWN,
+        };
+    }
+    // Track hub chain transaction
+    const executorDst = sourceToHubMessage.destination;
+    const composeTxHash = executorDst?.lzCompose?.txs?.[0]
+        ?.txHash;
+    if (!composeTxHash) {
+        return {
+            step: OVaultTransactionStep.HUB_CHAIN_TRANSACTION,
+        };
+    }
+    const failedCompose = executorDst?.lzCompose?.failedTx?.[0]
+        ?.txHash;
+    if (executorDst?.lzCompose?.status !== "SUCCEEDED" && failedCompose) {
+        return {
+            step: OVaultTransactionStep.HUB_CHAIN_TRANSACTION,
+            failureReason: OVaultFailureReason.UNKNOWN,
+            refunded: false,
+            hubTxHash: failedCompose,
+        };
+    }
+    const hubTx = await getTxStatus(composeTxHash, hubClient);
+    const refunded = await isRefunded(composeTxHash, hubClient);
+    if (hubTx.success && refunded) {
+        // Something went wrong on the hub chain, but the funds were refunded.
+        return {
+            step: OVaultTransactionStep.HUB_CHAIN_TRANSACTION,
+            refunded: true,
+            failureReason: OVaultFailureReason.UNKNOWN,
+            hubTxHash: composeTxHash,
+        };
+    }
+    // Track hub to dst chain transaction
+    const hubToDstLzMessages = await getLzTxStatus(composeTxHash);
+    if (hubToDstLzMessages.length === 0) {
+        return {
+            step: OVaultTransactionStep.HUB_TO_DST_LZ_TRANSACTION,
+            hubTxHash: composeTxHash,
+        };
+    }
+    const hubToDstMessage = hubToDstLzMessages[0];
+    if (hubToDstMessage.status.name === "INFLIGHT" ||
+        hubToDstMessage.status.name === "CONFIRMING") {
+        return {
+            step: OVaultTransactionStep.HUB_TO_DST_LZ_TRANSACTION,
+            hubTxHash: composeTxHash,
+        };
+    }
+    if (hubToDstMessage.status.name !== "DELIVERED") {
+        return {
+            step: OVaultTransactionStep.HUB_TO_DST_LZ_TRANSACTION,
+            failureReason: OVaultFailureReason.UNKNOWN,
+            hubTxHash: composeTxHash,
+        };
+    }
+    // Track dst chain transaction
+    const dstTxHash = hubToDstMessage.destination?.tx?.txHash;
+    if (!dstTxHash) {
+        // Waiting for the dst tx to be created
+        return {
+            step: OVaultTransactionStep.DST_CHAIN_TRANSACTION,
+            hubTxHash: composeTxHash,
+        };
+    }
+    const dstTx = await getTxStatus(dstTxHash, dstClient);
+    return {
+        step: dstTx.success
+            ? OVaultTransactionStep.COMPLETED
+            : OVaultTransactionStep.DST_CHAIN_TRANSACTION,
+        refunded: false,
+        failureReason: dstTx.error,
+        destinationTxHash: dstTx.success ? dstTxHash : undefined,
+        hubTxHash: composeTxHash,
+    };
+}
+/**
+ * Track the OVault transaction
+ * There are 4 possible scenarios:
+ * 1. BBB - source chain, hub chain, dst chain are the same
+ * 2. BBA - source chain, hub chain are the same, dst chain is different
+ * 3. ABB - hub chain, dst chain are the same, source chain is different
+ * 4. ABA - source chain, hub chain, dst chain are different. Source chain can optionally be the same as the dst chain.
+ *
+ * @param txHash - The hash of the transaction to track on the source chain.
+ */
+export async function trackOVaultSyncTransaction(txHash, viemConfigs, withdrawalInfo) {
+    const { sourceChain, hubChain, dstChain } = viemConfigs;
+    if (sourceChain.id === hubChain.id && sourceChain.id === dstChain.id) {
+        return trackBBB(txHash, viemConfigs);
+    }
+    else if (sourceChain.id === hubChain.id && hubChain.id !== dstChain.id) {
+        return trackBBA(txHash, viemConfigs, withdrawalInfo);
+    }
+    else if (sourceChain.id !== hubChain.id && hubChain.id === dstChain.id) {
+        return trackABB(txHash, viemConfigs, withdrawalInfo);
+    }
+    else {
+        return trackABA(txHash, viemConfigs, withdrawalInfo);
+    }
+}

package/dist/oVaultSync/transfer.d.ts

@@ -0,0 +1,116 @@
+import { OVaultSyncInputs, SendParams, SendParamsInput, GenerateOVaultSyncInputsProps, OVaultCoreInputs } from "../types";
+export declare class OVaultSyncMessageBuilder {
+    private static getFormattedRefCode;
+    /**
+     * Parse a string amount to BigInt with specified decimals, always truncating (never rounding up)
+     * This is critical for LayerZero operations to avoid precision issues
+     */
+    private static parseUnitsTruncate;
+    /**
+     * LayerZero uses 6 shared decimals for cross-chain transfers.
+     * This function removes dust below the 6 decimal precision that LayerZero won't transfer.
+     * For tokens with >6 decimals, this prevents quoteSend failures due to precision loss.
+     */
+    private static removeLzDust;
+    static buildComposeArgument(input: SendParamsInput, messageFee: bigint): `0x${string}`;
+    /**
+     * Build the send params for the hub chain to the dst chain.
+     *
+     * @param input - The input parameters for the OVault.
+     * @returns The send params for the hub chain to the dst chain.
+     */
+    static buildHubToDstChainSendParams(input: SendParamsInput): {
+        dstEid: number;
+        to: `0x${string}`;
+        amountLD: bigint;
+        minAmountLD: bigint;
+        extraOptions: `0x${string}`;
+        composeMsg: `0x${string}`;
+        oftCmd: `0x${string}`;
+    };
+    /**
+     * Quote the amount of shares or assets that will be received from the OVault.
+     *
+     * @param input - The input parameters for the OVault.
+     * @returns The amount of shares or assets that will be received from the OVault.
+     */
+    static quoteOVaultOutput(input: GenerateOVaultSyncInputsProps): Promise<{
+        dstAmount: bigint;
+        minDstAmount: bigint;
+    }>;
+    /**
+     * Calculate the message fee for the hub chain. This is the fee that it costs to send a message from the hub chain to the dst chain.
+     *
+     * @param input - The input parameters for the OVault.
+     * @param useWalletAddress
+     * @returns The message fee for the hub chain.
+     */
+    static calculateHubChainFee(input: SendParamsInput, useWalletAddress?: boolean): Promise<{
+        nativeFee: bigint;
+        lzTokenFee: bigint;
+    }>;
+    static getMessageFee(sendParams: SendParams, input: SendParamsInput): Promise<{
+        nativeFee: bigint;
+        lzTokenFee: bigint;
+    }>;
+    static increaseByBuffer(amount: bigint, buffer?: number): bigint;
+    static buildSendParams(input: SendParamsInput): Promise<{
+        dstEid: number;
+        to: `0x${string}`;
+        amountLD: bigint;
+        minAmountLD: bigint;
+        extraOptions: `0x${string}`;
+        composeMsg: `0x${string}`;
+        oftCmd: `0x${string}`;
+    }>;
+    static buildApproval(input: SendParamsInput): Promise<{
+        tokenAddress: `0x${string}`;
+        amount: bigint;
+        spender: `0x${string}`;
+        usePermit: boolean;
+        nonce: bigint;
+        tokenName: string;
+        tokenVersion: string;
+        needsResetApproval?: undefined;
+    } | {
+        tokenAddress: `0x${string}`;
+        amount: bigint;
+        spender: `0x${string}`;
+        usePermit: boolean;
+        needsResetApproval: boolean | undefined;
+        nonce?: undefined;
+        tokenName?: undefined;
+        tokenVersion?: undefined;
+    } | undefined>;
+    /**
+     * Resolve a {@link OVaultCoreInputs} into the full
+     * {@link GenerateOVaultSyncInputsProps} using the built-in address registry.
+     */
+    static resolveCoreInputs(core: OVaultCoreInputs): GenerateOVaultSyncInputsProps;
+    /**
+     * Generate the inputs for the OVault.
+     *
+     * @param input - The input parameters for the OVault.
+     * @returns Inputs to call contracts to perform Deposit or Redeem on the OVault.
+     */
+    static generateOVaultInputs(input: OVaultCoreInputs): Promise<OVaultSyncInputs>;
+    /**
+     * Encode to avoid ABI-union incompatibility that arises when passing the
+     * discriminated-union `OVaultSyncInputs` directly to viem's `writeContract`.
+     *
+     * @param inputs     - The output from `generateOVaultInputs`.
+     * @param permitArgs - Optional permit arguments (`[deadline, v, r, s]`) to
+     *                     append when using the EIP-2612 permit flow.
+     */
+    static encodeTransactionRequest(inputs: OVaultSyncInputs, permitArgs?: readonly [
+        bigint,
+        number | bigint,
+        `0x${string}`,
+        `0x${string}`
+    ]): {
+        to: `0x${string}`;
+        data: `0x${string}`;
+        value: bigint;
+    };
+}
+//# sourceMappingURL=transfer.d.ts.map

package/dist/oVaultSync/transfer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transfer.d.ts","sourceRoot":"","sources":["../../src/oVaultSync/transfer.ts"],"names":[],"mappings":"AAeA,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,6BAA6B,EAE7B,gBAAgB,EACjB,MAAM,UAAU,CAAC;AAKlB,qBAAa,wBAAwB;IACnC,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAMlC;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAUjC;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;IAM3B,MAAM,CAAC,oBAAoB,CAAC,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM;IA2BtE;;;;;OAKG;IACH,MAAM,CAAC,4BAA4B,CAAC,KAAK,EAAE,eAAe;;;;;sBAoBrB,KAAK,MAAM,EAAE;oBAC1B,KAAK,MAAM,EAAE;;;IAOrC;;;;;OAKG;WACU,iBAAiB,CAC5B,KAAK,EAAE,6BAA6B,GACnC,OAAO,CAAC;QACT,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IAuDF;;;;;;OAMG;WACU,oBAAoB,CAC/B,KAAK,EAAE,eAAe,EACtB,gBAAgB,UAAO;;;;WA0EZ,aAAa,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,eAAe;;;;IAyCzE,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,MAAU;WAW7C,eAAe,CAAC,KAAK,EAAE,eAAe;;;;;sBAjNd,KAAK,MAAM,EAAE;oBAC1B,KAAK,MAAM,EAAE;;;WA8PxB,aAAa,CAAC,KAAK,EAAE,eAAe;;;;;eA6GZ,MAAM;mBACE,MAAM;;;;;;;;;;;;;IA0BnD;;;OAGG;IACH,MAAM,CAAC,iBAAiB,CACtB,IAAI,EAAE,gBAAgB,GACrB,6BAA6B;IAmFhC;;;;;OAKG;WACU,oBAAoB,CAC/B,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,gBAAgB,CAAC;IAyG5B;;;;;;;OAOG;IACH,MAAM,CAAC,wBAAwB,CAC7B,MAAM,EAAE,gBAAgB,EACxB,UAAU,CAAC,EAAE,SAAS;QACpB,MAAM;QACN,MAAM,GAAG,MAAM;QACf,KAAK,MAAM,EAAE;QACb,KAAK,MAAM,EAAE;KACd,GACA;QAAE,EAAE,EAAE,KAAK,MAAM,EAAE,CAAC;QAAC,IAAI,EAAE,KAAK,MAAM,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;CAoB7D"}