zerc20-client-sdk 0.1.15 → 0.2.0

package/dist/operations/layerzeroScan/formatters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../../../src/operations/layerzeroScan/formatters.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEhG,wBAAgB,aAAa,CAAC,QAAQ,CAAC,EAAE,iBAAiB,GAAG,IAAI,GAAG,MAAM,CAEzE;AAED,wBAAgB,aAAa,CAAC,WAAW,CAAC,EAAE,oBAAoB,GAAG,IAAI,GAAG,MAAM,GAAG,SAAS,CAO3F;AAeD,wBAAgB,cAAc,CAAC,KAAK,CAAC,EAAE;IACrC,EAAE,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;CAC1E,GAAG,MAAM,GAAG,SAAS,CAYrB;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB;;;;;;cAY1D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,oBAAoB,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAW/F;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,UAAU,EAAE,GACnB,UAAU,GAAG,SAAS,CAYxB"}

package/dist/operations/layerzeroScan/formatters.js

@@ -0,0 +1,75 @@
+/**
+ * Formatting utilities for LayerZero Scan messages.
+ */
+export function endpointChain(endpoint) {
+    return endpoint?.chain ?? "-";
+}
+export function destinationTx(destination) {
+    return (destination?.tx?.txHash ||
+        destination?.lzCompose?.txs?.[0]?.txHash ||
+        destination?.nativeDrop?.tx?.txHash ||
+        undefined);
+}
+function formatTimestamp(unixSeconds) {
+    const date = new Date(unixSeconds * 1000);
+    return date.toLocaleString("en-US", {
+        year: "numeric",
+        month: "short",
+        day: "numeric",
+        hour: "2-digit",
+        minute: "2-digit",
+        second: "2-digit",
+        hour12: false,
+    });
+}
+export function summarizeBlock(stage) {
+    const blockNumber = stage?.tx?.blockNumber;
+    if (blockNumber === undefined || blockNumber === null) {
+        return undefined;
+    }
+    const asNumber = typeof blockNumber === "string" ? Number(blockNumber) : blockNumber;
+    const timestamp = stage?.tx?.blockTimestamp;
+    if (timestamp === undefined || timestamp === null) {
+        return asNumber ? asNumber.toString() : `${blockNumber}`;
+    }
+    const tsNumber = typeof timestamp === "string" ? Number(timestamp) : timestamp;
+    return `${asNumber ?? blockNumber} (${formatTimestamp(tsNumber)})`;
+}
+export function formatPathway(message) {
+    const pathway = message.pathway;
+    if (!pathway) {
+        return undefined;
+    }
+    return {
+        src: endpointChain(pathway.sender),
+        dst: endpointChain(pathway.receiver),
+        nonce: pathway.nonce,
+        srcEid: pathway.srcEid ? Number(pathway.srcEid) : undefined,
+        dstEid: pathway.dstEid ? Number(pathway.dstEid) : undefined,
+    };
+}
+/**
+ * Check if a LayerZero message belongs to the specified tokens by matching sender address.
+ */
+export function isMessageForTokens(message, tokens) {
+    const senderAddress = message.pathway?.sender?.address?.toLowerCase();
+    if (!senderAddress) {
+        return false;
+    }
+    return tokens.some((token) => token.tokenAddress.toLowerCase() === senderAddress ||
+        (token.adaptorAddress && token.adaptorAddress.toLowerCase() === senderAddress));
+}
+export function findTokenForMessage(message, tokens) {
+    const srcEid = message.pathway?.srcEid;
+    const srcChain = message.pathway?.sender?.chain?.toLowerCase();
+    return tokens.find((token) => {
+        if (srcEid && token.eid && Number(token.eid) === Number(srcEid)) {
+            return true;
+        }
+        if (srcChain && token.label.toLowerCase() === srcChain) {
+            return true;
+        }
+        return false;
+    });
+}
+//# sourceMappingURL=formatters.js.map

package/dist/operations/layerzeroScan/formatters.js.map

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

package/dist/operations/layerzeroScan/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * LayerZero Scan operations for tracking cross-chain message status.
+ */
+export type { LayerZeroScanConfig, CreateReadProvider, WalletMessagesParams, ScanMessagesResponse, LayerZeroScanMessage, LayerZeroEndpoint, LayerZeroStage, LayerZeroTxInfo, LayerZeroTxOptions, LayerZeroDestination, LayerZeroDestinationTx, LayerZeroCompose, LayerZeroComposeTx, BridgeRequestSummary, SendPayloadSummary, ComposeFollowupSummary, LayerZeroMessageSummary, WalletStatusResult, TokenMetadata, FetchWalletStatusParams, } from "./types.js";
+export { fetchWalletMessages, fetchTxMessages, getWalletMessagesUrl } from "./scan.js";
+export { tryDecodeBridgeRequest, decodeSendSummary, fetchOftSentAmount, decorateSendSummary, } from "./codec.js";
+export { endpointChain, destinationTx, summarizeBlock, formatPathway, isMessageForTokens, findTokenForMessage, } from "./formatters.js";
+export { fetchWalletStatus } from "./status.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/operations/layerzeroScan/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/operations/layerzeroScan/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,YAAY,EACV,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,sBAAsB,EACtB,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,EACtB,uBAAuB,EACvB,kBAAkB,EAClB,aAAa,EACb,uBAAuB,GACxB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAGvF,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,aAAa,EACb,aAAa,EACb,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/dist/operations/layerzeroScan/index.js

@@ -0,0 +1,12 @@
+/**
+ * LayerZero Scan operations for tracking cross-chain message status.
+ */
+// Scan API client
+export { fetchWalletMessages, fetchTxMessages, getWalletMessagesUrl } from "./scan.js";
+// Codec
+export { tryDecodeBridgeRequest, decodeSendSummary, fetchOftSentAmount, decorateSendSummary, } from "./codec.js";
+// Formatters
+export { endpointChain, destinationTx, summarizeBlock, formatPathway, isMessageForTokens, findTokenForMessage, } from "./formatters.js";
+// Status orchestration
+export { fetchWalletStatus } from "./status.js";
+//# sourceMappingURL=index.js.map

package/dist/operations/layerzeroScan/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/operations/layerzeroScan/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AA0BH,kBAAkB;AAClB,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAEvF,QAAQ;AACR,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAEpB,aAAa;AACb,OAAO,EACL,aAAa,EACb,aAAa,EACb,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AAEzB,uBAAuB;AACvB,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/dist/operations/layerzeroScan/scan.d.ts

@@ -0,0 +1,21 @@
+/**
+ * LayerZero Scan API client.
+ *
+ * All functions take a `LayerZeroScanConfig` parameter instead of reading
+ * from module-level state, making them framework-agnostic and testable.
+ */
+import type { LayerZeroScanConfig, LayerZeroScanMessage, ScanMessagesResponse, WalletMessagesParams } from "./types.js";
+/**
+ * Build the wallet messages URL for a given address (useful for deep-links).
+ */
+export declare function getWalletMessagesUrl(config: LayerZeroScanConfig, address: string): string;
+/**
+ * Fetch LayerZero messages for a wallet address.
+ */
+export declare function fetchWalletMessages(config: LayerZeroScanConfig, address: string, params?: WalletMessagesParams): Promise<ScanMessagesResponse<LayerZeroScanMessage>>;
+/**
+ * Fetch LayerZero messages for a specific transaction hash.
+ * Returns `null` when the transaction is not found (404).
+ */
+export declare function fetchTxMessages(config: LayerZeroScanConfig, txHash: string): Promise<ScanMessagesResponse<LayerZeroScanMessage> | null>;
+//# sourceMappingURL=scan.d.ts.map

package/dist/operations/layerzeroScan/scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.d.ts","sourceRoot":"","sources":["../../../src/operations/layerzeroScan/scan.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AA2BpB;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAGzF;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,mBAAmB,EAC3B,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,oBAAoB,GAC5B,OAAO,CAAC,oBAAoB,CAAC,oBAAoB,CAAC,CAAC,CAcrD;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,mBAAmB,EAC3B,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,oBAAoB,CAAC,oBAAoB,CAAC,GAAG,IAAI,CAAC,CAe5D"}

package/dist/operations/layerzeroScan/scan.js

@@ -0,0 +1,70 @@
+/**
+ * LayerZero Scan API client.
+ *
+ * All functions take a `LayerZeroScanConfig` parameter instead of reading
+ * from module-level state, making them framework-agnostic and testable.
+ */
+import { HttpClient } from "../../utils/http.js";
+function createClient(config) {
+    return new HttpClient(config.baseUrl, {
+        defaultHeaders: config.apiKey ? { "x-api-key": config.apiKey } : {},
+    });
+}
+function normalizeAddress(address) {
+    return address.startsWith("0x") ? address : `0x${address}`;
+}
+function parseScanResponse(raw) {
+    const payload = raw;
+    return {
+        data: payload.data ?? [],
+        nextToken: payload.nextToken ?? payload.next_token,
+    };
+}
+/**
+ * Build the wallet messages URL for a given address (useful for deep-links).
+ */
+export function getWalletMessagesUrl(config, address) {
+    const client = createClient(config);
+    return client.url(`messages/wallet/${normalizeAddress(address)}`);
+}
+/**
+ * Fetch LayerZero messages for a wallet address.
+ */
+export async function fetchWalletMessages(config, address, params) {
+    const client = createClient(config);
+    const normalized = normalizeAddress(address);
+    const searchParams = new URLSearchParams();
+    if (params?.limit)
+        searchParams.set("limit", params.limit.toString());
+    if (params?.start)
+        searchParams.set("start", params.start);
+    if (params?.end)
+        searchParams.set("end", params.end);
+    if (params?.nextToken)
+        searchParams.set("nextToken", params.nextToken);
+    const query = searchParams.toString();
+    const path = `messages/wallet/${normalized}${query ? `?${query}` : ""}`;
+    const raw = await client.getJson(path);
+    return parseScanResponse(raw);
+}
+/**
+ * Fetch LayerZero messages for a specific transaction hash.
+ * Returns `null` when the transaction is not found (404).
+ */
+export async function fetchTxMessages(config, txHash) {
+    if (!txHash) {
+        return null;
+    }
+    const client = createClient(config);
+    try {
+        const raw = await client.getJson(`messages/tx/${txHash}`);
+        return parseScanResponse(raw);
+    }
+    catch (error) {
+        if (error instanceof Error && /404/.test(error.message)) {
+            return null;
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=scan.js.map

package/dist/operations/layerzeroScan/scan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.js","sourceRoot":"","sources":["../../../src/operations/layerzeroScan/scan.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAejD,SAAS,YAAY,CAAC,MAA2B;IAC/C,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE;QACpC,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE;KACpE,CAAC,CAAC;AACL,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAe;IACvC,OAAO,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,EAAE,CAAC;AAC7D,CAAC;AAED,SAAS,iBAAiB,CAAI,GAAY;IACxC,MAAM,OAAO,GAAG,GAAiC,CAAC;IAClD,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,EAAE;QACxB,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,UAAU;KACnD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAA2B,EAAE,OAAe;IAC/E,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACpC,OAAO,MAAM,CAAC,GAAG,CAAC,mBAAmB,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AACpE,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAA2B,EAC3B,OAAe,EACf,MAA6B;IAE7B,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,UAAU,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAE7C,MAAM,YAAY,GAAG,IAAI,eAAe,EAAE,CAAC;IAC3C,IAAI,MAAM,EAAE,KAAK;QAAE,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;IACtE,IAAI,MAAM,EAAE,KAAK;QAAE,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAC3D,IAAI,MAAM,EAAE,GAAG;QAAE,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IACrD,IAAI,MAAM,EAAE,SAAS;QAAE,YAAY,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IAEvE,MAAM,KAAK,GAAG,YAAY,CAAC,QAAQ,EAAE,CAAC;IACtC,MAAM,IAAI,GAAG,mBAAmB,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACxE,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,OAAO,CAAU,IAAI,CAAC,CAAC;IAChD,OAAO,iBAAiB,CAAuB,GAAG,CAAC,CAAC;AACtD,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAA2B,EAC3B,MAAc;IAEd,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACpC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,OAAO,CAAU,eAAe,MAAM,EAAE,CAAC,CAAC;QACnE,OAAO,iBAAiB,CAAuB,GAAG,CAAC,CAAC;IACtD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;YACxD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/operations/layerzeroScan/status.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Orchestration layer for fetching and decoding LayerZero message status.
+ *
+ * This is the main entry point — `fetchWalletStatus` aggregates API data,
+ * decodes transaction payloads, and resolves compose followup messages.
+ */
+import type { FetchWalletStatusParams, WalletStatusResult } from "./types.js";
+/**
+ * Fetch and decode LayerZero message history for a wallet.
+ *
+ * This is the main orchestration function that:
+ * 1. Fetches messages from the LayerZero Scan API
+ * 2. Optionally filters by token addresses
+ * 3. Decodes send payloads and resolves compose followup messages
+ */
+export declare function fetchWalletStatus(params: FetchWalletStatusParams): Promise<WalletStatusResult>;
+//# sourceMappingURL=status.d.ts.map

package/dist/operations/layerzeroScan/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/operations/layerzeroScan/status.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoBH,OAAO,KAAK,EAGV,uBAAuB,EAMvB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAwKpB;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC,kBAAkB,CAAC,CA8C7B"}

package/dist/operations/layerzeroScan/status.js

@@ -0,0 +1,178 @@
+/**
+ * Orchestration layer for fetching and decoding LayerZero message status.
+ *
+ * This is the main entry point — `fetchWalletStatus` aggregates API data,
+ * decodes transaction payloads, and resolves compose followup messages.
+ */
+import { readDecimalConversionRate, readTokenDecimals } from "../../onchain/tokenReads.js";
+import { decodeSendSummary, decorateSendSummary, fetchOftSentAmount, isHexStrict, } from "./codec.js";
+import { destinationTx, endpointChain, findTokenForMessage, formatPathway, isMessageForTokens, summarizeBlock, } from "./formatters.js";
+import { fetchTxMessages, fetchWalletMessages, getWalletMessagesUrl } from "./scan.js";
+// ---------------------------------------------------------------------------
+// Token metadata cache (module-level, same lifetime as the SDK instance)
+// ---------------------------------------------------------------------------
+const tokenMetadataCache = new Map();
+async function fetchTokenMetadata(createReadProvider, token) {
+    if (!token?.tokenAddress)
+        return null;
+    const cacheKey = `${token.chainId}:${token.tokenAddress.toLowerCase()}`;
+    const cached = tokenMetadataCache.get(cacheKey);
+    if (cached) {
+        return cached;
+    }
+    const promise = (async () => {
+        try {
+            const provider = createReadProvider(token);
+            const [decimalsResult, conversionResult] = await Promise.allSettled([
+                readTokenDecimals(provider, token.tokenAddress),
+                readDecimalConversionRate(provider, token.tokenAddress),
+            ]);
+            const decimals = decimalsResult.status === "fulfilled" && decimalsResult.value !== undefined
+                ? decimalsResult.value
+                : undefined;
+            const decimalConversionRate = conversionResult.status === "fulfilled" ? conversionResult.value : undefined;
+            return { decimals, decimalConversionRate };
+        }
+        catch {
+            return {};
+        }
+    })();
+    tokenMetadataCache.set(cacheKey, promise);
+    return promise;
+}
+// ---------------------------------------------------------------------------
+// Internal decode helpers
+// ---------------------------------------------------------------------------
+async function decodeSendFromMessage(message, tokens, createReadProvider) {
+    const token = findTokenForMessage(message, tokens);
+    const txHash = message.source?.tx?.txHash;
+    if (txHash && token) {
+        try {
+            const provider = createReadProvider(token);
+            if (provider.getTransaction) {
+                const tx = await provider.getTransaction({ hash: txHash });
+                if (tx?.input && tx.input !== "0x") {
+                    const summary = decodeSendSummary(tx.input);
+                    return decorateSendSummary({ ...summary, source: "tx" }, token, (t) => fetchTokenMetadata(createReadProvider, t));
+                }
+            }
+        }
+        catch {
+            // getTransaction failed — fall through to payload decode below
+        }
+    }
+    const payload = message.source?.tx?.payload;
+    if (isHexStrict(payload)) {
+        try {
+            const summary = decodeSendSummary(payload);
+            return decorateSendSummary(summary, token, (t) => fetchTokenMetadata(createReadProvider, t));
+        }
+        catch (error) {
+            return {
+                source: "payload",
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    return null;
+}
+async function fetchComposeFollowups(message, tokens, createReadProvider, scanConfig) {
+    const compose = message.destination?.lzCompose;
+    if (!compose?.txs?.length) {
+        return [];
+    }
+    const results = await Promise.allSettled(compose.txs.map(async (tx) => {
+        if (!tx.txHash) {
+            return null;
+        }
+        const response = await fetchTxMessages(scanConfig, tx.txHash);
+        const followup = response?.data?.[0] ??
+            (message.destination?.tx?.txHash
+                ? (await fetchTxMessages(scanConfig, message.destination.tx.txHash))?.data?.[0]
+                : undefined);
+        if (!followup) {
+            // Return-leg not yet indexed — treat as not successful
+            const srcChain = endpointChain(message.pathway?.receiver);
+            const dstChain = endpointChain(message.pathway?.sender);
+            return {
+                srcChain,
+                dstChain,
+                sourceTx: tx.txHash,
+                destTx: "-",
+                success: false,
+            };
+        }
+        const srcChain = endpointChain(followup.pathway?.receiver);
+        const dstChain = endpointChain(followup.pathway?.sender);
+        const sourceTx = followup.source?.tx?.txHash ?? "-";
+        const destTx = destinationTx(followup.destination) ?? "-";
+        const delivered = followup.status?.name?.toLowerCase() === "delivered" ||
+            followup.destination?.status?.toLowerCase() === "delivered";
+        const tokenEntry = findTokenForMessage(followup, tokens);
+        const sendSummary = await decodeSendFromMessage(followup, tokens, createReadProvider);
+        const oftProvider = tokenEntry ? createReadProvider(tokenEntry) : undefined;
+        const oftAmountReceived = oftProvider
+            ? await fetchOftSentAmount(oftProvider, tx.txHash)
+            : undefined;
+        const metadata = tokenEntry ? await fetchTokenMetadata(createReadProvider, tokenEntry) : null;
+        return {
+            srcChain,
+            dstChain,
+            sourceTx,
+            destTx,
+            success: delivered,
+            amount: sendSummary?.amount,
+            amountSent: sendSummary?.amountSent ?? sendSummary?.amount,
+            amountReceived: oftAmountReceived ?? sendSummary?.amountReceived,
+            decimals: sendSummary?.decimals ?? metadata?.decimals,
+        };
+    }));
+    return results
+        .map((result) => (result.status === "fulfilled" ? result.value : null))
+        .filter((value) => value !== null);
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Fetch and decode LayerZero message history for a wallet.
+ *
+ * This is the main orchestration function that:
+ * 1. Fetches messages from the LayerZero Scan API
+ * 2. Optionally filters by token addresses
+ * 3. Decodes send payloads and resolves compose followup messages
+ */
+export async function fetchWalletStatus(params) {
+    const { address, tokens, scanConfig, createReadProvider, limit, nextToken, filterByToken } = params;
+    const response = await fetchWalletMessages(scanConfig, address, {
+        limit,
+        nextToken,
+    });
+    const filteredData = filterByToken
+        ? response.data.filter((message) => isMessageForTokens(message, tokens))
+        : response.data;
+    const items = await Promise.all(filteredData.map(async (message) => {
+        const send = await decodeSendFromMessage(message, tokens, createReadProvider);
+        const composeFollowups = await fetchComposeFollowups(message, tokens, createReadProvider, scanConfig);
+        const sourceTx = message.source?.tx?.txHash;
+        const sourceBlock = summarizeBlock(message.source);
+        const destTx = destinationTx(message.destination);
+        return {
+            guid: message.guid,
+            pathway: formatPathway(message),
+            sourceTx,
+            sourceBlock,
+            destinationTx: destTx,
+            send,
+            composeFollowups,
+            status: message.status?.name ?? message.destination?.status,
+            raw: message,
+        };
+    }));
+    return {
+        items,
+        nextToken: response.nextToken,
+        walletUrl: getWalletMessagesUrl(scanConfig, address),
+    };
+}
+//# sourceMappingURL=status.js.map

package/dist/operations/layerzeroScan/status.js.map

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

package/dist/operations/layerzeroScan/types.d.ts

@@ -0,0 +1,181 @@
+/**
+ * Type definitions for LayerZero Scan operations.
+ */
+import type { EvmReadProvider } from "../../types/evm.js";
+import type { TokenEntry } from "../../registry/types.js";
+/** Configuration for the LayerZero Scan API client. */
+export interface LayerZeroScanConfig {
+    /** Base URL for the LayerZero Scan API (e.g. "https://scan.layerzero-api.com/v1/"). */
+    baseUrl: string;
+    /** Optional API key for authenticated requests. */
+    apiKey?: string;
+}
+/** Factory function that creates a read provider for a given token entry. */
+export type CreateReadProvider = (token: TokenEntry) => EvmReadProvider;
+export interface WalletMessagesParams {
+    limit?: number;
+    start?: string;
+    end?: string;
+    nextToken?: string;
+}
+export interface ScanMessagesResponse<T> {
+    data: T[];
+    nextToken?: string;
+}
+export interface LayerZeroScanMessage {
+    status?: {
+        name?: string;
+        message?: string;
+    };
+    pathway?: {
+        srcEid?: number;
+        dstEid?: number;
+        sender?: LayerZeroEndpoint;
+        receiver?: LayerZeroEndpoint;
+        id?: string;
+        nonce?: number;
+    };
+    source?: LayerZeroStage;
+    destination?: LayerZeroDestination;
+    verification?: {
+        dvn?: {
+            status?: string;
+        };
+    };
+    sealer?: {
+        status?: string;
+        tx?: LayerZeroTxInfo;
+    };
+    guid?: string;
+}
+export interface LayerZeroEndpoint {
+    address?: string;
+    chain?: string;
+}
+export interface LayerZeroStage {
+    status?: string;
+    tx?: LayerZeroTxInfo;
+}
+export interface LayerZeroTxInfo {
+    txHash?: string;
+    blockHash?: string;
+    blockNumber?: number | string;
+    blockTimestamp?: number | string;
+    from?: string;
+    payload?: string;
+    readinessTimestamp?: number | string;
+    options?: LayerZeroTxOptions;
+}
+export interface LayerZeroTxOptions {
+    lzReceive?: {
+        gas?: number | string;
+        value?: number | string;
+    };
+    compose?: Array<{
+        index?: number | string;
+        gas?: number | string;
+        value?: number | string;
+    }>;
+    ordered?: boolean;
+}
+export interface LayerZeroDestination {
+    status?: string;
+    tx?: LayerZeroDestinationTx;
+    lzCompose?: LayerZeroCompose;
+    nativeDrop?: {
+        status?: string;
+        tx?: LayerZeroDestinationTx;
+    };
+    payload?: string;
+}
+export interface LayerZeroDestinationTx {
+    txHash?: string;
+    blockHash?: string;
+    blockNumber?: number | string;
+    blockTimestamp?: number | string;
+    from?: string;
+    to?: string;
+}
+export interface LayerZeroCompose {
+    txs: LayerZeroComposeTx[];
+    status?: string;
+    failedTx?: Array<{
+        txHash?: string;
+        txError?: string;
+    }>;
+}
+export interface LayerZeroComposeTx {
+    txHash?: string;
+    blockHash?: string;
+    blockNumber?: number | string;
+    blockTimestamp?: number | string;
+    from?: string;
+    to?: string;
+}
+export interface BridgeRequestSummary {
+    dstEid?: number;
+    to?: string;
+    refundAddress?: string;
+    minAmountOut?: bigint;
+}
+export interface SendPayloadSummary {
+    dstEid?: number;
+    to?: string;
+    amount?: bigint;
+    minAmount?: bigint;
+    compose?: BridgeRequestSummary | null;
+    source: "tx" | "payload";
+    error?: string;
+    amountSent?: bigint;
+    amountReceived?: bigint;
+    decimals?: number;
+    decimalConversionRate?: bigint;
+}
+export interface ComposeFollowupSummary {
+    srcChain: string;
+    dstChain: string;
+    sourceTx: string;
+    destTx: string;
+    success: boolean;
+    amount?: bigint;
+    amountSent?: bigint;
+    amountReceived?: bigint;
+    decimals?: number;
+}
+export interface LayerZeroMessageSummary {
+    guid?: string;
+    pathway?: {
+        src?: string;
+        dst?: string;
+        nonce?: number;
+        srcEid?: number;
+        dstEid?: number;
+    };
+    sourceTx?: string;
+    sourceBlock?: string;
+    destinationTx?: string;
+    send?: SendPayloadSummary | null;
+    composeFollowups?: ComposeFollowupSummary[];
+    status?: string;
+    raw: LayerZeroScanMessage;
+}
+export interface WalletStatusResult {
+    items: LayerZeroMessageSummary[];
+    nextToken?: string;
+    walletUrl: string;
+}
+export interface TokenMetadata {
+    decimals?: number;
+    decimalConversionRate?: bigint;
+}
+/** Parameters for the top-level `fetchWalletStatus` function. */
+export interface FetchWalletStatusParams {
+    address: string;
+    tokens: TokenEntry[];
+    scanConfig: LayerZeroScanConfig;
+    createReadProvider: CreateReadProvider;
+    limit?: number;
+    nextToken?: string;
+    filterByToken?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/operations/layerzeroScan/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/operations/layerzeroScan/types.ts"],"names":[],"mappings":"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"}

package/dist/operations/layerzeroScan/types.js

@@ -0,0 +1,5 @@
+/**
+ * Type definitions for LayerZero Scan operations.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/operations/layerzeroScan/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/operations/layerzeroScan/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/operations/layerzeroScan.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Re-export from layerzeroScan module.
+ */
+export * from "./layerzeroScan/index.js";
+//# sourceMappingURL=layerzeroScan.d.ts.map

package/dist/operations/layerzeroScan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layerzeroScan.d.ts","sourceRoot":"","sources":["../../src/operations/layerzeroScan.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,0BAA0B,CAAC"}

package/dist/operations/layerzeroScan.js

@@ -0,0 +1,5 @@
+/**
+ * Re-export from layerzeroScan module.
+ */
+export * from "./layerzeroScan/index.js";
+//# sourceMappingURL=layerzeroScan.js.map