@wormhole-foundation/sdk-connect 0.5.0-beta.0

package/dist/esm/types.d.ts.map

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

package/dist/esm/types.js

@@ -0,0 +1,27 @@
+// Transfer state machine states
+export var TransferState;
+(function (TransferState) {
+    TransferState[TransferState["Failed"] = -1] = "Failed";
+    TransferState[TransferState["Created"] = 0] = "Created";
+    TransferState[TransferState["SourceInitiated"] = 1] = "SourceInitiated";
+    TransferState[TransferState["SourceFinalized"] = 2] = "SourceFinalized";
+    TransferState[TransferState["Attested"] = 3] = "Attested";
+    TransferState[TransferState["DestinationInitiated"] = 4] = "DestinationInitiated";
+    TransferState[TransferState["DestinationFinalized"] = 5] = "DestinationFinalized";
+})(TransferState || (TransferState = {}));
+export function isSourceInitiated(receipt) {
+    return receipt.state === TransferState.SourceInitiated;
+}
+export function isSourceFinalized(receipt) {
+    return receipt.state === TransferState.SourceFinalized;
+}
+export function isAttested(receipt) {
+    return receipt.state === TransferState.Attested;
+}
+export function isCompleted(receipt) {
+    return receipt.state > TransferState.Attested;
+}
+export function isFailed(receipt) {
+    return receipt.state < 0;
+}
+//# sourceMappingURL=types.js.map

package/dist/esm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AASA,gCAAgC;AAChC,MAAM,CAAN,IAAY,aAQX;AARD,WAAY,aAAa;IACvB,sDAAW,CAAA;IACX,uDAAW,CAAA;IACX,uEAAe,CAAA;IACf,uEAAe,CAAA;IACf,yDAAQ,CAAA;IACR,iFAAoB,CAAA;IACpB,iFAAoB,CAAA;AACtB,CAAC,EARW,aAAa,KAAb,aAAa,QAQxB;AA8DD,MAAM,UAAU,iBAAiB,CAC/B,OAA4B;IAE5B,OAAO,OAAO,CAAC,KAAK,KAAK,aAAa,CAAC,eAAe,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,OAA4B;IAE5B,OAAO,OAAO,CAAC,KAAK,KAAK,aAAa,CAAC,eAAe,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,OAA4B;IAE5B,OAAO,OAAO,CAAC,KAAK,KAAK,aAAa,CAAC,QAAQ,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,OAA4B;IAE5B,OAAO,OAAO,CAAC,KAAK,GAAG,aAAa,CAAC,QAAQ,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,QAAQ,CAAK,OAA4B;IACvD,OAAO,OAAO,CAAC,KAAK,GAAG,CAAC,CAAC;AAC3B,CAAC"}

package/dist/esm/whscan-api.d.ts

@@ -0,0 +1,172 @@
+import { Chain } from "@wormhole-foundation/sdk-base";
+import { PayloadDiscriminator, PayloadLiteral, TxHash, WormholeMessageId, deserialize } from "@wormhole-foundation/sdk-definitions";
+export declare const WHSCAN_RETRY_INTERVAL = 2000;
+/**
+ * The status of a transaction
+ *
+ * contains information about the transaction and the global transaction if it was relayed
+ */
+export interface TransactionStatus {
+    id: string;
+    timestamp: string;
+    txHash: string;
+    emitterChain: number;
+    emitterAddress: string;
+    emitterNativeAddress: string;
+    payload: {
+        amount: string;
+        callerAppId: string;
+        fee: string;
+        fromAddress: string;
+        parsedPayload: any;
+        payload: string;
+        payloadType: number;
+        toAddress: string;
+        toChain: number;
+        tokenAddress: string;
+        tokenChain: number;
+    };
+    standardizedProperties: {
+        amount: string;
+        appIds: string[];
+        fee: string;
+        feeAddress: string;
+        feeChain: number;
+        fromAddress: string;
+        fromChain: number;
+        toAddress: string;
+        toChain: number;
+        tokenAddress: string;
+        tokenChain: number;
+    };
+    globalTx?: {
+        id: string;
+        originTx: {
+            txHash: string;
+            from: string;
+            status: string;
+        };
+        destinationTx?: {
+            chainId: number;
+            status: string;
+            method: string;
+            txHash: string;
+            from: string;
+            to: string;
+            blockNumber: string;
+            timestamp: string;
+            updatedAt: string;
+        };
+    };
+}
+export interface RelayData {
+    from: {
+        chain: string;
+        chainId: number;
+        txHash: string;
+        senderAddress: string;
+        symbol: string;
+        amountSent: number;
+        amountToSwap: number;
+        estimatedNativeAssetAmount: number;
+    };
+    vaa: string;
+    status: string;
+    fee: {
+        amount: number;
+        symbol: string;
+    };
+    error: any;
+    to: {
+        chain: string;
+        chainId: number;
+        recipientAddress: string;
+        txHash: string;
+        gasUsed: number;
+        nativeAssetSymbol: string;
+        nativeAssetReceived: number;
+    };
+    metrics: {
+        receivedAt: string;
+        completedAt: string;
+        failedAt: any;
+        attempts: number;
+        maxAttempts: number;
+        waitingForTxInMs: number;
+        waitingForWalletInMs: number;
+    };
+}
+export interface ApiVaa {
+    sequence: number;
+    id: string;
+    version: number;
+    emitterChain: number;
+    emitterAddr: string;
+    emitterNativeAddr: string;
+    guardianSetIndex: number;
+    vaa: string;
+    timestamp: string;
+    updatedAt: string;
+    indexedAt: string;
+    txHash: string;
+}
+/**
+ * Gets the bytes of a VAA for a given WormholeMessageId or `null` if the VAA is not available yet.
+ * @param apiUrl the url of the wormholescan API
+ * @param whm the WormholeMessageId
+ * @returns a Uint8Array containing the VAA or `null` if it's not available yet
+ * @throws Errors if the service throws an unrecoverable error (e.g. 500)
+ */
+export declare function getVaaBytes(apiUrl: string, whm: WormholeMessageId): Promise<Uint8Array | null>;
+export declare function getVaaBytesWithRetry(apiUrl: string, whm: WormholeMessageId, timeout: number): Promise<Uint8Array | null>;
+export declare function getVaa<T extends PayloadLiteral | PayloadDiscriminator>(apiUrl: string, whm: WormholeMessageId, decodeAs: T): Promise<ReturnType<typeof deserialize<T>> | null>;
+export declare function getVaaWithRetry<T extends PayloadLiteral | PayloadDiscriminator>(apiUrl: string, whm: WormholeMessageId, decodeAs: T, timeout: number): Promise<ReturnType<typeof deserialize<T>> | null>;
+/**
+ * Gets the status for a transaction given WormholeMessageId or `null` if the VAA is not available yet.
+ * @param rpcUrl the url of the wormholescan API
+ * @param whm the WormholeMessageId
+ * @returns a TransactionStatus or `null` if it's not available yet
+ * @throws Errors if the service throws an unrecoverable error (e.g. 500)
+ */
+export declare function getTransactionStatus(rpcUrl: string, whm: WormholeMessageId): Promise<TransactionStatus | null>;
+export declare function getTransactionStatusWithRetry(rpcUrl: string, whm: WormholeMessageId, timeout: number): Promise<TransactionStatus | null>;
+export declare function getRelayStatus(rpcUrl: string, txid: TxHash): Promise<RelayData | null>;
+export declare function getRelayStatusWithRetry(rpcUrl: string, txid: TxHash, timeout: number): Promise<RelayData | null>;
+export declare function getVaaByTxHash(rpcUrl: string, txid: string): Promise<ApiVaa | null>;
+export declare function getVaaByTxHashWithRetry<T extends PayloadLiteral | PayloadDiscriminator>(rpcUrl: string, txid: TxHash, decodeAs: T, timeout: number): Promise<ReturnType<typeof deserialize<T>> | null>;
+export declare function getTxsByAddress(rpcUrl: string, address: string, pageSize?: number, page?: number): Promise<TransactionStatus[] | null>;
+export type GuardianHeartbeat = {
+    p2pNodeAddr: string;
+    rawHeartbeat: {
+        bootTimestamp: string;
+        counter: string;
+        features: string[];
+        guardianAddr: string;
+        networks: {
+            contractAddress: string;
+            errorCount: string;
+            height: string;
+            id: number;
+        }[];
+        nodeName: string;
+        timestamp: string;
+        version: string;
+    };
+    verifiedGuardianAddr: string;
+};
+export declare function getGuardianHeartbeats(rpcUrl: string): Promise<GuardianHeartbeat[] | null>;
+export type GovernedTokens = {
+    [chain in Chain]?: Record<string, number>;
+};
+export declare function getGovernedTokens(rpcUrl: string): Promise<GovernedTokens | null>;
+export type GovernorChainLimit = {
+    available: number;
+    limit: number;
+    maxSize?: number;
+};
+export type GovernorLimits = {
+    [chain in Chain]?: GovernorChainLimit;
+};
+export declare function getGovernorLimits(rpcUrl: string): Promise<GovernorLimits | null>;
+export declare function getIsVaaEnqueued(rpcUrl: string, whm: WormholeMessageId): Promise<boolean | null>;
+//# sourceMappingURL=whscan-api.d.ts.map

package/dist/esm/whscan-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"whscan-api.d.ts","sourceRoot":"","sources":["../../src/whscan-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAwC,MAAM,+BAA+B,CAAC;AAC5F,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,MAAM,EACN,iBAAiB,EACjB,WAAW,EACZ,MAAM,sCAAsC,CAAC;AAI9C,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAE1C;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,MAAM,CAAC;QACpB,GAAG,EAAE,MAAM,CAAC;QACZ,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,GAAG,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,sBAAsB,EAAE;QACtB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,GAAG,EAAE,MAAM,CAAC;QACZ,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,QAAQ,CAAC,EAAE;QACT,EAAE,EAAE,MAAM,CAAC;QACX,QAAQ,EAAE;YACR,MAAM,EAAE,MAAM,CAAC;YACf,IAAI,EAAE,MAAM,CAAC;YACb,MAAM,EAAE,MAAM,CAAC;SAChB,CAAC;QACF,aAAa,CAAC,EAAE;YACd,OAAO,EAAE,MAAM,CAAC;YAChB,MAAM,EAAE,MAAM,CAAC;YACf,MAAM,EAAE,MAAM,CAAC;YACf,MAAM,EAAE,MAAM,CAAC;YACf,IAAI,EAAE,MAAM,CAAC;YACb,EAAE,EAAE,MAAM,CAAC;YACX,WAAW,EAAE,MAAM,CAAC;YACpB,SAAS,EAAE,MAAM,CAAC;YAClB,SAAS,EAAE,MAAM,CAAC;SACnB,CAAC;KACH,CAAC;CACH;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,aAAa,EAAE,MAAM,CAAC;QACtB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,0BAA0B,EAAE,MAAM,CAAC;KACpC,CAAC;IACF,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE;QACH,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,KAAK,EAAE,GAAG,CAAC;IACX,EAAE,EAAE;QACF,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,gBAAgB,EAAE,MAAM,CAAC;QACzB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,mBAAmB,EAAE,MAAM,CAAC;KAC7B,CAAC;IACF,OAAO,EAAE;QACP,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,GAAG,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,gBAAgB,EAAE,MAAM,CAAC;QACzB,oBAAoB,EAAE,MAAM,CAAC;KAC9B,CAAC;CACH;AAED,MAAM,WAAW,MAAM;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,iBAAiB,GACrB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAoB5B;AAED,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,iBAAiB,EACtB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAG5B;AAED,wBAAsB,MAAM,CAAC,CAAC,SAAS,cAAc,GAAG,oBAAoB,EAC1E,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,iBAAiB,EACtB,QAAQ,EAAE,CAAC,GACV,OAAO,CAAC,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAInD;AAED,wBAAsB,eAAe,CAAC,CAAC,SAAS,cAAc,GAAG,oBAAoB,EACnF,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,iBAAiB,EACtB,QAAQ,EAAE,CAAC,EACX,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAQnD;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,iBAAiB,GACrB,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAmBnC;AAED,wBAAsB,6BAA6B,CACjD,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,iBAAiB,EACtB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAQnC;AAED,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAgB5F;AAED,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAG3B;AAED,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAgBzF;AAED,wBAAsB,uBAAuB,CAAC,CAAC,SAAS,cAAc,GAAG,oBAAoB,EAC3F,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,CAAC,EACX,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAYnD;AAED,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,MAAW,EACrB,IAAI,GAAE,MAAU,GACf,OAAO,CAAC,iBAAiB,EAAE,GAAG,IAAI,CAAC,CAgBrC;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE;QACZ,aAAa,EAAE,MAAM,CAAC;QACtB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE;YACR,eAAe,EAAE,MAAM,CAAC;YACxB,UAAU,EAAE,MAAM,CAAC;YACnB,MAAM,EAAE,MAAM,CAAC;YACf,EAAE,EAAE,MAAM,CAAC;SACZ,EAAE,CAAC;QACJ,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,oBAAoB,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,GAAG,IAAI,CAAC,CAO/F;AASD,MAAM,MAAM,cAAc,GAAG;KAE1B,KAAK,IAAI,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;CAC1C,CAAC;AAEF,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CActF;AASD,MAAM,MAAM,kBAAkB,GAAG;IAE/B,SAAS,EAAE,MAAM,CAAC;IAElB,KAAK,EAAE,MAAM,CAAC;IAEd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AACF,MAAM,MAAM,cAAc,GAAG;KAC1B,KAAK,IAAI,KAAK,CAAC,CAAC,EAAE,kBAAkB;CACtC,CAAC;AAEF,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAsBtF;AAGD,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,iBAAiB,GACrB,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAUzB"}

package/dist/esm/whscan-api.js

@@ -0,0 +1,222 @@
+import { amount, encoding, toChain, toChainId } from "@wormhole-foundation/sdk-base";
+import { deserialize, } from "@wormhole-foundation/sdk-definitions";
+import axios from "axios";
+import { retry } from "./tasks";
+export const WHSCAN_RETRY_INTERVAL = 2000;
+/**
+ * Gets the bytes of a VAA for a given WormholeMessageId or `null` if the VAA is not available yet.
+ * @param apiUrl the url of the wormholescan API
+ * @param whm the WormholeMessageId
+ * @returns a Uint8Array containing the VAA or `null` if it's not available yet
+ * @throws Errors if the service throws an unrecoverable error (e.g. 500)
+ */
+export async function getVaaBytes(apiUrl, whm) {
+    const { chain, emitter, sequence } = whm;
+    const chainId = toChainId(chain);
+    const emitterAddress = encoding.stripPrefix("0x", emitter.toString());
+    const url = `${apiUrl}/v1/signed_vaa/${chainId}/${emitterAddress}/${sequence}`;
+    try {
+        const { data: { vaaBytes }, } = await axios.get(url);
+        return encoding.b64.decode(vaaBytes);
+    }
+    catch (error) {
+        if (!error)
+            return null;
+        if (typeof error === "object") {
+            // A 404 error means the VAA is not yet available
+            // since its not available yet, we return null signaling it can be tried again
+            if (axios.isAxiosError(error) && error.response?.status === 404)
+                return null;
+            if ("status" in error && error.status === 404)
+                return null;
+        }
+        throw error;
+    }
+}
+export async function getVaaBytesWithRetry(apiUrl, whm, timeout) {
+    const task = () => getVaaBytes(apiUrl, whm);
+    return await retry(task, WHSCAN_RETRY_INTERVAL, timeout, "Wormholescan:GetVaaBytes");
+}
+export async function getVaa(apiUrl, whm, decodeAs) {
+    const vaaBytes = await getVaaBytes(apiUrl, whm);
+    if (!vaaBytes)
+        return null;
+    return deserialize(decodeAs, vaaBytes);
+}
+export async function getVaaWithRetry(apiUrl, whm, decodeAs, timeout) {
+    const task = () => getVaa(apiUrl, whm, decodeAs);
+    return await retry(task, WHSCAN_RETRY_INTERVAL, timeout, "Wormholescan:GetVaaBytes");
+}
+/**
+ * Gets the status for a transaction given WormholeMessageId or `null` if the VAA is not available yet.
+ * @param rpcUrl the url of the wormholescan API
+ * @param whm the WormholeMessageId
+ * @returns a TransactionStatus or `null` if it's not available yet
+ * @throws Errors if the service throws an unrecoverable error (e.g. 500)
+ */
+export async function getTransactionStatus(rpcUrl, whm) {
+    const { chain, emitter, sequence } = whm;
+    const chainId = toChainId(chain);
+    const emitterAddress = emitter.toUniversalAddress().toString();
+    const url = `${rpcUrl}/api/v1/transactions/${chainId}/${emitterAddress}/${sequence}`;
+    try {
+        const response = await axios.get(url);
+        return response.data;
+    }
+    catch (error) {
+        if (!error)
+            return null;
+        if (typeof error === "object") {
+            // A 404 error means the VAA is not yet available
+            // since its not available yet, we return null signaling it can be tried again
+            if (axios.isAxiosError(error) && error.response?.status === 404)
+                return null;
+            if ("status" in error && error.status === 404)
+                return null;
+        }
+        throw error;
+    }
+}
+export async function getTransactionStatusWithRetry(rpcUrl, whm, timeout) {
+    const task = () => getTransactionStatus(rpcUrl, whm);
+    return await retry(task, WHSCAN_RETRY_INTERVAL, timeout, "Wormholescan:GetTransactionStatus");
+}
+export async function getRelayStatus(rpcUrl, txid) {
+    const url = `${rpcUrl}/v1/relays?txHash=${txid}`;
+    try {
+        const response = await axios.get(url);
+        if (response.data.data.to.txHash)
+            return response.data.data;
+    }
+    catch (error) {
+        if (!error)
+            return null;
+        if (typeof error === "object") {
+            // A 404 error means the VAA is not yet available
+            // since its not available yet, we return null signaling it can be tried again
+            if (axios.isAxiosError(error) && error.response?.status === 404)
+                return null;
+            if ("status" in error && error.status === 404)
+                return null;
+        }
+        throw error;
+    }
+    return null;
+}
+export async function getRelayStatusWithRetry(rpcUrl, txid, timeout) {
+    const task = () => getRelayStatus(rpcUrl, txid);
+    return retry(task, WHSCAN_RETRY_INTERVAL, timeout, "Wormholescan:GetRelayStatus");
+}
+export async function getVaaByTxHash(rpcUrl, txid) {
+    const url = `${rpcUrl}/api/v1/vaas?txHash=${txid}`;
+    try {
+        const response = await axios.get(url);
+        if (response.data.data.length > 0)
+            return response.data.data[0];
+    }
+    catch (error) {
+        if (!error)
+            return null;
+        if (typeof error === "object") {
+            // A 404 error means the VAA is not yet available
+            // since its not available yet, we return null signaling it can be tried again
+            if (axios.isAxiosError(error) && error.response?.status === 404)
+                return null;
+            if ("status" in error && error.status === 404)
+                return null;
+        }
+        throw error;
+    }
+    return null;
+}
+export async function getVaaByTxHashWithRetry(rpcUrl, txid, decodeAs, timeout) {
+    const task = () => getVaaByTxHash(rpcUrl, txid);
+    const vaa = await retry(task, WHSCAN_RETRY_INTERVAL, timeout, "Wormholescan:GetVaaByTxHash");
+    if (!vaa)
+        return null;
+    return deserialize(decodeAs, encoding.b64.decode(vaa.vaa));
+}
+export async function getTxsByAddress(rpcUrl, address, pageSize = 50, page = 0) {
+    const url = `${rpcUrl}/api/v1/transactions?address=${address}&pageSize=${pageSize}&page=${page}`;
+    try {
+        const response = await axios.get(url);
+        if (response.data.transactions.length > 0)
+            return response.data.transactions;
+    }
+    catch (error) {
+        if (!error)
+            return null;
+        if (typeof error === "object") {
+            // A 404 error means the VAA is not yet available
+            // since its not available yet, we return null signaling it can be tried again
+            if (axios.isAxiosError(error) && error.response?.status === 404)
+                return null;
+            if ("status" in error && error.status === 404)
+                return null;
+        }
+        throw error;
+    }
+    return null;
+}
+export async function getGuardianHeartbeats(rpcUrl) {
+    const url = `${rpcUrl}/v1/heartbeats`;
+    try {
+        const response = await axios.get(url);
+        if (response.data && response.data.entries.length > 0)
+            return response.data.entries;
+    }
+    catch { }
+    return null;
+}
+export async function getGovernedTokens(rpcUrl) {
+    const url = `${rpcUrl}/v1/governor/token_list`;
+    try {
+        const response = await axios.get(url);
+        if (response.data && response.data.entries.length > 0) {
+            return response.data.entries.reduce((acc, entry) => {
+                const chain = toChain(entry.originChainId);
+                acc[chain] = acc[chain] || {};
+                acc[chain][entry.originAddress] = entry.price;
+                return acc;
+            }, {});
+        }
+    }
+    catch { }
+    return null;
+}
+export async function getGovernorLimits(rpcUrl) {
+    const url = `${rpcUrl}/v1/governor/available_notional_by_chain`;
+    try {
+        const response = await axios.get(url);
+        if (response.data && response.data.entries.length > 0) {
+            return response.data.entries.reduce((acc, entry) => {
+                // if 0 consider it no limit
+                const maxSize = entry.bigTransactionSize === "0"
+                    ? undefined
+                    : amount.whole(amount.parse(entry.bigTransactionSize, 2));
+                acc[toChain(entry.chainId)] = {
+                    available: amount.whole(amount.parse(entry.remainingAvailableNotional, 2)),
+                    limit: amount.whole(amount.parse(entry.notionalLimit, 2)),
+                    maxSize,
+                };
+                return acc;
+            }, {});
+        }
+    }
+    catch { }
+    return null;
+}
+// TODO: returning bool or null is asking for trouble
+export async function getIsVaaEnqueued(rpcUrl, whm) {
+    const { chain, emitter, sequence } = whm;
+    const chainId = toChainId(chain);
+    const emitterAddress = emitter.toUniversalAddress().toString();
+    const url = `${rpcUrl}/v1/governor/is_vaa_enqueued/${chainId}/${emitterAddress}/${sequence}`;
+    try {
+        const response = await axios.get(url);
+        return response.data.isEnqueued;
+    }
+    catch { }
+    return null;
+}
+//# sourceMappingURL=whscan-api.js.map

package/dist/esm/whscan-api.js.map

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

package/dist/esm/wormhole.d.ts

@@ -0,0 +1,198 @@
+import { Chain, Network, Platform } from "@wormhole-foundation/sdk-base";
+import { ChainAddress, ChainContext, Contracts, NativeAddress, PayloadDiscriminator, PayloadLiteral, PlatformContext, PlatformUtils, TokenAddress, TokenId, TxHash, WormholeMessageId, deserialize } from "@wormhole-foundation/sdk-definitions";
+import { ConfigOverrides, WormholeConfig } from "./config";
+import { CircleTransfer } from "./protocols/cctpTransfer";
+import { TokenTransfer } from "./protocols/tokenTransfer";
+import { RouteConstructor } from "./routes";
+import { RouteResolver } from "./routes/resolver";
+import { TransactionStatus } from "./whscan-api";
+type PlatformMap<N extends Network, P extends Platform = Platform> = Map<P, PlatformContext<N, P>>;
+type ChainMap<N extends Network, C extends Chain = Chain> = Map<C, ChainContext<N, C>>;
+export declare class Wormhole<N extends Network> {
+    protected readonly _network: N;
+    protected _platforms: PlatformMap<N>;
+    protected _chains: ChainMap<N>;
+    readonly config: WormholeConfig;
+    constructor(network: N, platforms: PlatformUtils<any>[], config?: ConfigOverrides);
+    get network(): N;
+    /**
+     * Creates a CircleTransfer object to move Native USDC from one chain to another
+     * @param amount the amount to transfer
+     * @param from the address to transfer from
+     * @param to the address to transfer to
+     * @param automatic whether to use automatic delivery
+     * @param payload the payload to send with the transfer
+     * @param nativeGas the amount of native gas to send with the transfer
+     * @returns the CircleTransfer object
+     * @throws Errors if the chain or protocol is not supported
+     */
+    circleTransfer(amount: bigint, from: ChainAddress, to: ChainAddress, automatic: boolean, payload?: Uint8Array, nativeGas?: bigint): Promise<CircleTransfer<N>>;
+    /**
+     * Creates a TokenTransfer object to move a token from one chain to another
+     * @param token the token to transfer
+     * @param amount the amount to transfer
+     * @param from the address to transfer from
+     * @param to the address to transfer to
+     * @param automatic whether to use automatic delivery
+     * @param payload the payload to send with the transfer
+     * @param nativeGas the amount of native gas to send with the transfer
+     * @returns the TokenTransfer object
+     * @throws Errors if the chain or protocol is not supported
+     */
+    tokenTransfer(token: TokenId, amount: bigint, from: ChainAddress, to: ChainAddress, automatic: boolean, payload?: Uint8Array, nativeGas?: bigint): Promise<TokenTransfer<N>>;
+    /**
+     * Gets a RouteResolver configured with the routes passed
+     * @param routes the list RouteConstructors to use
+     * @returns the RouteResolver
+     */
+    resolver(routes: RouteConstructor[]): RouteResolver<N>;
+    /**
+     * Gets the contract addresses for a given chain
+     * @param chain the chain name
+     * @returns the contract addresses
+     */
+    getContracts(chain: Chain): Contracts | undefined;
+    /**
+     * Returns the platform object, i.e. the class with platform-specific logic and methods
+     * @param chain the platform name
+     * @returns the platform context class
+     * @throws Errors if platform is not found
+     */
+    getPlatform<P extends Platform>(platformName: P): PlatformContext<N, P>;
+    /**
+     * Returns the chain "context", i.e. the class with chain-specific logic and methods
+     * @param chain the chain name
+     * @returns the chain context class
+     * @throws Errors if context is not found
+     */
+    getChain<C extends Chain>(chain: C): ChainContext<N, C>;
+    /**
+     * Gets the TokenId for a token representation on any chain
+     *  These are the Wormhole wrapped token addresses, not necessarily
+     *  the cannonical version of that token
+     *
+     * @param chain The chain name to get the wrapped token address
+     * @param tokenId The Token ID (chain/address) of the original token
+     * @returns The TokenId on the given chain, null if it does not exist
+     * @throws Errors if the chain is not supported or the token does not exist
+     */
+    getWrappedAsset<C extends Chain>(chain: C, token: TokenId<Chain>): Promise<TokenId<C>>;
+    /**
+     *  Taking the original TokenId for some wrapped token chain
+     *  These are the Wormhole wrapped token addresses, not necessarily
+     *  the cannonical version of that token
+     *
+     * @param tokenId The Token ID of the token we're looking up the original asset for
+     * @returns The Original TokenId corresponding to the token id passed,
+     * @throws Errors if the chain is not supported or the token does not exist
+     */
+    getOriginalAsset<C extends Chain>(token: TokenId<C>): Promise<TokenId<Chain>>;
+    /**
+     * Gets the number of decimals for a token on a given chain
+     *
+     * @param chain The chain name or id of the token/representation
+     * @param token The token address
+     * @returns The number of decimals
+     */
+    getDecimals<C extends Chain>(chain: C, token: TokenAddress<C>): Promise<number>;
+    /**
+     * Fetches the balance of a given token for a wallet
+     *
+     * @param walletAddress The wallet address
+     * @param tokenId The token ID (its home chain and address on the home chain)
+     * @param chain The chain name or id
+     * @returns The token balance of the wormhole asset as a BigNumber
+     */
+    getBalance<C extends Chain>(chain: C, token: TokenAddress<C>, walletAddress: string): Promise<bigint | null>;
+    /**
+     * Gets the associated token account for chains that require it (only Solana currently).
+     *
+     * @param token the TokenId of the token to get the token account for
+     * @param recipient the address of the primary account that may require a separate token account
+     * @returns
+     */
+    getTokenAccount<C extends Chain>(recipient: ChainAddress<C>, token: TokenId<C>): Promise<ChainAddress<C>>;
+    /**
+     * Gets the Raw VAA Bytes from the API or Guardian RPC, finality must be met before the VAA will be available.
+     *
+     * @param wormholeMessageId The WormholeMessageId corresponding to the VAA to be fetched
+     * @param timeout The total amount of time to wait for the VAA to be available
+     * @returns The VAA bytes if available
+     * @throws Errors if the VAA is not available after the retries
+     */
+    getVaaBytes(wormholeMessageId: WormholeMessageId, timeout?: number): Promise<Uint8Array | null>;
+    /**
+     * Gets a VAA from the API or Guardian RPC, finality must be met before the VAA will be available.
+     *
+     * @param id The WormholeMessageId or Transaction hash corresponding to the VAA to be fetched
+     * @param decodeAs The VAA type to decode the bytes as
+     * @param timeout The total amount of time to wait for the VAA to be available
+     * @returns The VAA if available
+     * @throws Errors if the VAA is not available after the retries
+     */
+    getVaa<T extends PayloadLiteral | PayloadDiscriminator>(id: WormholeMessageId | TxHash, decodeAs: T, timeout?: number): Promise<ReturnType<typeof deserialize<T>> | null>;
+    /**
+     * Gets the CircleAttestation corresponding to the message hash logged in the transfer transaction.
+     * @param msgHash  The keccak256 hash of the message emitted by the circle contract
+     * @param timeout The total amount of time to wait for the VAA to be available
+     * @returns The CircleAttestation as a string, if available
+     * @throws Errors if the CircleAttestation is not available after the retries
+     */
+    getCircleAttestation(msgHash: string, timeout?: number): Promise<string | null>;
+    /**
+     * Get the status of a transaction, identified by the chain, emitter address, and sequence number
+     *
+     * @param id the message id for the Wormhole Message to get transaction status for or originating Transaction hash
+     * @returns the TransactionStatus
+     */
+    getTransactionStatus(id: WormholeMessageId | TxHash, timeout?: number): Promise<TransactionStatus | null>;
+    /**
+     * Get recent transactions for an address
+     *
+     * @param address the string formatted address to get transactions for
+     * @returns the TransactionStatus
+     */
+    getTransactionsForAddress(address: string, pageSize?: number, page?: number): Promise<TransactionStatus[] | null>;
+    /**
+     * Parse an address from its canonincal string format to a NativeAddress
+     *
+     * @param chain The chain the address is for
+     * @param address The address in canonical string format
+     * @returns The address in the NativeAddress format
+     */
+    static parseAddress<C extends Chain>(chain: C, address: string): NativeAddress<C>;
+    /**
+     * Return a string in the canonical chain format representing the address
+     * of a token or account
+     *
+     * @param chainAddress The ChainAddress or TokenId to get a string address
+     * @returns The string address in canonical format for the chain
+     */
+    static canonicalAddress(chainAddress: ChainAddress | TokenId): string;
+    /**
+     * Parse an address from its canonincal string format to a NativeAddress
+     *
+     * @param chain The chain the address is for
+     * @param address The native address in canonical string format
+     * @returns The ChainAddress
+     */
+    static chainAddress<C extends Chain>(chain: C, address: string): ChainAddress<C>;
+    /**
+     * Parse an address from its canonincal string format to a NativeAddress
+     *
+     * @param chain The chain the address is for
+     * @param address The native address in canonical string format or the string "native"
+     * @returns The ChainAddress
+     */
+    static tokenId<C extends Chain>(chain: C, address: string): TokenId<C>;
+    /**
+     * Parses all relevant information from a transaction given the sending tx hash and sending chain
+     *
+     * @param chain The sending chain name or context
+     * @param tx The sending transaction hash
+     * @returns The parsed WormholeMessageId
+     */
+    static parseMessageFromTx<N extends Network, C extends Chain>(chain: ChainContext<N, C>, txid: TxHash, timeout?: number): Promise<WormholeMessageId[]>;
+}
+export {};
+//# sourceMappingURL=wormhole.d.ts.map