@aptos-labs/cross-chain-core 5.8.2 → 5.9.0

package/dist/providers/wormhole/signers/SolanaLocalSigner.d.ts

@@ -0,0 +1,65 @@
+import { Connection, Keypair, type Commitment } from "@solana/web3.js";
+import { Chain, Network, SignAndSendSigner, TxHash, UnsignedTransaction } from "@wormhole-foundation/sdk";
+import { PriorityFeeConfig } from "./solanaUtils";
+export interface SolanaLocalSignerConfig {
+    /** The Solana keypair to sign transactions with */
+    keypair: Keypair;
+    /** The Solana RPC connection */
+    connection: Connection;
+    /** Transaction confirmation commitment level (default: "finalized") */
+    commitment?: Commitment;
+    /** Retry interval in ms when transaction is not confirmed (default: 5000) */
+    retryIntervalMs?: number;
+    /** Priority fee configuration for faster transaction landing */
+    priorityFeeConfig?: PriorityFeeConfig;
+    /** Enable verbose logging (default: false) */
+    verbose?: boolean;
+}
+/**
+ * Server-side Solana signer for programmatic transaction signing.
+ * Use this when you want to sign Solana transactions without user wallet interaction,
+ * such as for server-side claim operations.
+ *
+ * @example
+ * ```typescript
+ * import { SolanaLocalSigner } from "@aptos-labs/cross-chain-core";
+ * import { Connection, Keypair } from "@solana/web3.js";
+ * import bs58 from "bs58";
+ *
+ * const keypair = Keypair.fromSecretKey(bs58.decode(process.env.SOLANA_CLAIM_SIGNER_KEY));
+ * const connection = new Connection("https://api.mainnet-beta.solana.com");
+ *
+ * const signer = new SolanaLocalSigner({
+ *   keypair,
+ *   connection,
+ *   // Optional: configure priority fees for faster landing
+ *   priorityFeeConfig: {
+ *     percentile: 0.9,
+ *     min: 100_000,
+ *     max: 1_000_000,
+ *   },
+ * });
+ * await cctpRoute.complete(signer, receipt);
+ * ```
+ */
+export declare class SolanaLocalSigner<N extends Network, C extends Chain> implements SignAndSendSigner<N, C> {
+    private keypair;
+    private connection;
+    private commitment;
+    private retryIntervalMs;
+    private priorityFeeConfig?;
+    private verbose;
+    private _claimedTransactionHashes;
+    constructor(config: SolanaLocalSignerConfig);
+    chain(): C;
+    address(): string;
+    /**
+     * Returns all transaction hashes from the most recent signAndSend call,
+     * joined by comma. If only one transaction was signed, returns a single hash string.
+     */
+    claimedTransactionHashes(): string;
+    signAndSend(txs: UnsignedTransaction<N, C>[]): Promise<TxHash[]>;
+    private signAndSendTransaction;
+}
+export type { PriorityFeeConfig };
+//# sourceMappingURL=SolanaLocalSigner.d.ts.map

package/dist/providers/wormhole/signers/SolanaLocalSigner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SolanaLocalSigner.d.ts","sourceRoot":"","sources":["../../../../src/providers/wormhole/signers/SolanaLocalSigner.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,OAAO,EAEP,KAAK,UAAU,EAChB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,KAAK,EACL,OAAO,EACP,iBAAiB,EACjB,MAAM,EACN,mBAAmB,EACpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAEL,iBAAiB,EAElB,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,uBAAuB;IACtC,mDAAmD;IACnD,OAAO,EAAE,OAAO,CAAC;IACjB,gCAAgC;IAChC,UAAU,EAAE,UAAU,CAAC;IACvB,uEAAuE;IACvE,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,6EAA6E;IAC7E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gEAAgE;IAChE,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,8CAA8C;IAC9C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,iBAAiB,CAAC,CAAC,SAAS,OAAO,EAAE,CAAC,SAAS,KAAK,CAC/D,YAAW,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC;IAElC,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,iBAAiB,CAAC,CAAoB;IAC9C,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,yBAAyB,CAAgB;gBAErC,MAAM,EAAE,uBAAuB;IAS3C,KAAK,IAAI,CAAC;IAIV,OAAO,IAAI,MAAM;IAIjB;;;OAGG;IACH,wBAAwB,IAAI,MAAM;IAI5B,WAAW,CAAC,GAAG,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;YAYxD,sBAAsB;CAkIrC;AAGD,YAAY,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/providers/wormhole/signers/SolanaSigner.d.ts

@@ -1,28 +1,20 @@
-import { ConfirmOptions, VersionedTransaction } from "@solana/web3.js";
-import { Transaction } from "@solana/web3.js";
-import { SolanaUnsignedTransaction } from "@wormhole-foundation/sdk-solana";
+/**
+ * Client-side Solana signer for wallet-based transaction signing.
+ * This function signs and sends the transaction while constantly checking for confirmation
+ * and resending the transaction if it hasn't been confirmed after the specified interval.
+ */
+import { ConfirmOptions, Transaction, VersionedTransaction } from "@solana/web3.js";
 import { Connection } from "@solana/web3.js";
 import { Network } from "@wormhole-foundation/sdk";
+import { SolanaUnsignedTransaction } from "@wormhole-foundation/sdk-solana";
 import { AdapterWallet } from "@aptos-labs/wallet-adapter-core";
 import { CrossChainCore } from "../../../CrossChainCore";
-export type SolanaRpcProvider = "triton" | "helius" | "ankr" | "unknown";
+import { PriorityFeeConfig } from "./solanaUtils";
+export type { SolanaRpcProvider, PriorityFeeConfig } from "./solanaUtils";
+export { sleep, isEmptyObject, determineRpcProvider, } from "./solanaUtils";
 export declare function signAndSendTransaction(request: SolanaUnsignedTransaction<Network>, wallet: AdapterWallet | undefined, options?: ConfirmOptions, crossChainCore?: CrossChainCore): Promise<string>;
-export declare function setPriorityFeeInstructions(connection: Connection, blockhash: string, lastValidBlockHeight: number, request: SolanaUnsignedTransaction<Network>, crossChainCore?: CrossChainCore): Promise<Transaction | VersionedTransaction>;
-export declare function sleep(timeout: number): Promise<unknown>;
 /**
- * Checks whether an object is empty.
- *
- * isEmptyObject(null)
- * // => true
- *
- * isEmptyObject(undefined)
- * // => true
- *
- * isEmptyObject({})
- * // => true
- *
- * isEmptyObject({ 'a': 1 })
- * // => false
+ * Prepares a transaction with priority fee instructions.
  */
-export declare const isEmptyObject: (value: object | null | undefined) => boolean;
+export declare function setPriorityFeeInstructions(connection: Connection, blockhash: string, lastValidBlockHeight: number, request: SolanaUnsignedTransaction<Network>, priorityFeeConfig?: PriorityFeeConfig): Promise<Transaction | VersionedTransaction>;
 //# sourceMappingURL=SolanaSigner.d.ts.map

package/dist/providers/wormhole/signers/SolanaSigner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SolanaSigner.d.ts","sourceRoot":"","sources":["../../../../src/providers/wormhole/signers/SolanaSigner.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,cAAc,EAId,oBAAoB,EACrB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,OAAO,EAGL,yBAAyB,EAC1B,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAGzD,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;AAGzE,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,yBAAyB,CAAC,OAAO,CAAC,EAC3C,MAAM,EAAE,aAAa,GAAG,SAAS,EACjC,OAAO,CAAC,EAAE,cAAc,EACxB,cAAc,CAAC,EAAE,cAAc,mBAgHhC;AAED,wBAAsB,0BAA0B,CAC9C,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,MAAM,EACjB,oBAAoB,EAAE,MAAM,EAC5B,OAAO,EAAE,yBAAyB,CAAC,OAAO,CAAC,EAC3C,cAAc,CAAC,EAAE,cAAc,GAC9B,OAAO,CAAC,WAAW,GAAG,oBAAoB,CAAC,CAsB7C;AAyLD,wBAAsB,KAAK,CAAC,OAAO,EAAE,MAAM,oBAE1C;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,GAAG,IAAI,GAAG,SAAS,YAa7D,CAAC"}
+{"version":3,"file":"SolanaSigner.d.ts","sourceRoot":"","sources":["../../../../src/providers/wormhole/signers/SolanaSigner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,cAAc,EACd,WAAW,EACX,oBAAoB,EACrB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACnD,OAAO,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD,OAAO,EAGL,iBAAiB,EAClB,MAAM,eAAe,CAAC;AAGvB,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAC1E,OAAO,EACL,KAAK,EACL,aAAa,EACb,oBAAoB,GACrB,MAAM,eAAe,CAAC;AAGvB,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,yBAAyB,CAAC,OAAO,CAAC,EAC3C,MAAM,EAAE,aAAa,GAAG,SAAS,EACjC,OAAO,CAAC,EAAE,cAAc,EACxB,cAAc,CAAC,EAAE,cAAc,mBAuDhC;AAED;;GAEG;AACH,wBAAsB,0BAA0B,CAC9C,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,MAAM,EACjB,oBAAoB,EAAE,MAAM,EAC5B,OAAO,EAAE,yBAAyB,CAAC,OAAO,CAAC,EAC3C,iBAAiB,CAAC,EAAE,iBAAiB,GACpC,OAAO,CAAC,WAAW,GAAG,oBAAoB,CAAC,CAe7C"}

package/dist/providers/wormhole/signers/solanaUtils.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Shared utilities for Solana transaction handling.
+ * Used by both SolanaLocalSigner (server-side) and SolanaSigner (client-side).
+ */
+import { Connection, Transaction, TransactionInstruction, VersionedTransaction, type Commitment } from "@solana/web3.js";
+/** Configuration for priority fees */
+export interface PriorityFeeConfig {
+    /** Percentile of recent fees to use (default: 0.9) */
+    percentile?: number;
+    /** Multiplier for the percentile fee (default: 1) */
+    percentileMultiple?: number;
+    /** Minimum fee in microlamports (default: 100_000) */
+    min?: number;
+    /** Maximum fee in microlamports (default: 100_000_000) */
+    max?: number;
+}
+/** Configuration for sending and confirming transactions */
+export interface SendAndConfirmConfig {
+    connection: Connection;
+    commitment: Commitment;
+    retryIntervalMs?: number;
+    /** Enable verbose logging (default: false) */
+    verbose?: boolean;
+}
+/** RPC provider type for priority fee calculation */
+export type SolanaRpcProvider = "triton" | "helius" | "ankr" | "unknown";
+/**
+ * Sends a serialized transaction and waits for confirmation with automatic retries.
+ *
+ * @param serializedTx - The serialized transaction bytes
+ * @param blockhash - The recent blockhash used in the transaction
+ * @param lastValidBlockHeight - The last valid block height for the transaction
+ * @param config - Configuration for sending and confirming
+ * @returns The transaction signature
+ */
+export declare function sendAndConfirmTransaction(serializedTx: Buffer | Uint8Array, blockhash: string, lastValidBlockHeight: number, config: SendAndConfirmConfig): Promise<string>;
+/**
+ * Formats a transaction error into a readable string.
+ */
+export declare function formatTransactionError(err: unknown): string;
+/**
+ * Adds priority fee instructions to a transaction.
+ * Simulates the transaction to determine compute units and calculates optimal fees.
+ *
+ * @param connection - Solana RPC connection
+ * @param transaction - The transaction to add priority fees to
+ * @param priorityFeeConfig - Configuration for priority fees
+ * @param verbose - Enable verbose logging
+ * @returns The transaction with priority fee instructions added
+ */
+export declare function addPriorityFeeInstructions(connection: Connection, transaction: Transaction, priorityFeeConfig?: PriorityFeeConfig, verbose?: boolean): Promise<Transaction>;
+/**
+ * Creates priority fee instructions based on simulation and fee estimation.
+ */
+export declare function createPriorityFeeInstructions(connection: Connection, transaction: Transaction | VersionedTransaction, priorityFeeConfig?: PriorityFeeConfig, verbose?: boolean): Promise<TransactionInstruction[]>;
+/**
+ * Determines the RPC provider from the endpoint URL.
+ */
+export declare function determineRpcProvider(endpoint: string): SolanaRpcProvider;
+/**
+ * Sleep for a specified duration.
+ */
+export declare function sleep(timeout: number): Promise<void>;
+/**
+ * Checks whether an object is empty.
+ */
+export declare const isEmptyObject: (value: object | null | undefined) => boolean;
+//# sourceMappingURL=solanaUtils.d.ts.map

package/dist/providers/wormhole/signers/solanaUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"solanaUtils.d.ts","sourceRoot":"","sources":["../../../../src/providers/wormhole/signers/solanaUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAEL,UAAU,EAKV,WAAW,EACX,sBAAsB,EACtB,oBAAoB,EACpB,KAAK,UAAU,EAChB,MAAM,iBAAiB,CAAC;AAUzB,sCAAsC;AACtC,MAAM,WAAW,iBAAiB;IAChC,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,sDAAsD;IACtD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,4DAA4D;AAC5D,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,UAAU,CAAC;IACvB,UAAU,EAAE,UAAU,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,qDAAqD;AACrD,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;AAMzE;;;;;;;;GAQG;AACH,wBAAsB,yBAAyB,CAC7C,YAAY,EAAE,MAAM,GAAG,UAAU,EACjC,SAAS,EAAE,MAAM,EACjB,oBAAoB,EAAE,MAAM,EAC5B,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,MAAM,CAAC,CAoDjB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAa3D;AAMD;;;;;;;;;GASG;AACH,wBAAsB,0BAA0B,CAC9C,UAAU,EAAE,UAAU,EACtB,WAAW,EAAE,WAAW,EACxB,iBAAiB,CAAC,EAAE,iBAAiB,EACrC,OAAO,GAAE,OAAe,GACvB,OAAO,CAAC,WAAW,CAAC,CAiBtB;AAED;;GAEG;AACH,wBAAsB,6BAA6B,CACjD,UAAU,EAAE,UAAU,EACtB,WAAW,EAAE,WAAW,GAAG,oBAAoB,EAC/C,iBAAiB,CAAC,EAAE,iBAAiB,EACrC,OAAO,GAAE,OAAe,GACvB,OAAO,CAAC,sBAAsB,EAAE,CAAC,CA8CnC;AAiJD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CAgBxE;AAED;;GAEG;AACH,wBAAsB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE1D;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,GAAG,IAAI,GAAG,SAAS,KAAG,OAYhE,CAAC"}

package/dist/providers/wormhole/types.d.ts

@@ -19,11 +19,14 @@ export interface WormholeTransferRequest {
     amount?: string;
     sponsorAccount?: Account;
 }
+export type WithdrawPhase = "initiating" | "tracking" | "claiming";
 export interface WormholeWithdrawRequest {
     sourceChain: Chain;
     wallet: AdapterWallet;
     destinationAddress: AccountAddressInput;
     sponsorAccount?: Account | GasStationApiKey;
+    /** Optional callback fired when the withdraw progresses to a new phase. */
+    onPhaseChange?: (phase: WithdrawPhase) => void;
 }
 export interface WormholeSubmitTransferRequest {
     sourceChain: Chain;
@@ -47,4 +50,44 @@ export interface WormholeStartTransferResponse {
     originChainTxnId: string;
     receipt: routes.Receipt<AttestationReceipt>;
 }
+export interface WormholeInitiateWithdrawRequest {
+    wallet: AdapterWallet;
+    destinationAddress: AccountAddressInput;
+    sponsorAccount?: Account | GasStationApiKey;
+}
+export interface WormholeInitiateWithdrawResponse {
+    originChainTxnId: string;
+    receipt: routes.Receipt<AttestationReceipt>;
+}
+export interface WormholeClaimWithdrawRequest {
+    sourceChain: Chain;
+    destinationAddress: string;
+    receipt: routes.Receipt<AttestationReceipt>;
+    wallet?: AdapterWallet;
+}
+export interface WormholeClaimWithdrawResponse {
+    destinationChainTxnId: string;
+}
+/**
+ * Error thrown when the withdraw flow fails *after* the Aptos burn
+ * transaction has already been submitted (i.e. during attestation tracking
+ * or destination-chain claiming).
+ *
+ * Consumers should check `instanceof WithdrawError` in their catch block
+ * to recover the `originChainTxnId` and display an explorer link so the
+ * user can verify their burn on-chain.
+ */
+export declare class WithdrawError extends Error {
+    /** Aptos burn transaction hash — always available when this error is thrown. */
+    readonly originChainTxnId: string;
+    /** The withdraw phase that failed ("tracking" or "claiming"). */
+    readonly phase: WithdrawPhase;
+    /**
+     * The underlying error that caused this failure.
+     * Mirrors ES2022 Error.cause — declared explicitly because the project's
+     * TypeScript lib target does not include ES2022 ErrorOptions.
+     */
+    readonly cause?: unknown;
+    constructor(message: string, originChainTxnId: string, phase: WithdrawPhase, cause?: unknown);
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/providers/wormhole/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/providers/wormhole/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAC/E,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAE5C,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,KAAK,CAC9C,SAAS,GAAG,SAAS,EACrB,MAAM,CAAC,OAAO,EACd,MAAM,CAAC,uBAAuB,CAAC,MAAM,CAAC,OAAO,CAAC,EAC9C,MAAM,CAAC,OAAO,CACf,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,oBAAoB,CACvD,SAAS,GAAG,SAAS,CACtB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,KAAK,CAC9C,MAAM,CAAC,OAAO,EACd,MAAM,CAAC,uBAAuB,CAAC,MAAM,CAAC,OAAO,CAAC,EAC9C,GAAG,CACJ,CAAC;AAEF,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,KAAK,CAAC;IACnB,IAAI,EAAE,UAAU,GAAG,UAAU,CAAC;CAC/B;AAED,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;AAE1F,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,KAAK,CAAC;IACnB,MAAM,EAAE,aAAa,CAAC;IACtB,kBAAkB,EAAE,mBAAmB,CAAC;IACxC,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,KAAK,CAAC;IACnB,MAAM,EAAE,aAAa,CAAC;IACtB,kBAAkB,EAAE,mBAAmB,CAAC;IACxC,cAAc,CAAC,EAAE,OAAO,GAAG,gBAAgB,CAAC;CAC7C;AAED,MAAM,WAAW,6BAA6B;IAC5C,WAAW,EAAE,KAAK,CAAC;IACnB,MAAM,EAAE,aAAa,CAAC;IACtB,kBAAkB,EAAE,mBAAmB,CAAC;CACzC;AAED,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC5C,UAAU,EAAE,YAAY,CAAC;IACzB,cAAc,CAAC,EAAE,YAAY,GAAG,gBAAgB,CAAC;CAClD;AAED,MAAM,WAAW,wBAAwB;IACvC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,wBAAwB;IACvC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,6BAA6B;IAC5C,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAC7C"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/providers/wormhole/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAC/E,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAE5C,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,KAAK,CAC9C,SAAS,GAAG,SAAS,EACrB,MAAM,CAAC,OAAO,EACd,MAAM,CAAC,uBAAuB,CAAC,MAAM,CAAC,OAAO,CAAC,EAC9C,MAAM,CAAC,OAAO,CACf,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,oBAAoB,CACvD,SAAS,GAAG,SAAS,CACtB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,KAAK,CAC9C,MAAM,CAAC,OAAO,EACd,MAAM,CAAC,uBAAuB,CAAC,MAAM,CAAC,OAAO,CAAC,EAC9C,GAAG,CACJ,CAAC;AAEF,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,KAAK,CAAC;IACnB,IAAI,EAAE,UAAU,GAAG,UAAU,CAAC;CAC/B;AAED,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;AAE1F,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,KAAK,CAAC;IACnB,MAAM,EAAE,aAAa,CAAC;IACtB,kBAAkB,EAAE,mBAAmB,CAAC;IACxC,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,MAAM,aAAa,GACrB,YAAY,GACZ,UAAU,GACV,UAAU,CAAC;AAEf,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,KAAK,CAAC;IACnB,MAAM,EAAE,aAAa,CAAC;IACtB,kBAAkB,EAAE,mBAAmB,CAAC;IACxC,cAAc,CAAC,EAAE,OAAO,GAAG,gBAAgB,CAAC;IAC5C,2EAA2E;IAC3E,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;CAChD;AAED,MAAM,WAAW,6BAA6B;IAC5C,WAAW,EAAE,KAAK,CAAC;IACnB,MAAM,EAAE,aAAa,CAAC;IACtB,kBAAkB,EAAE,mBAAmB,CAAC;CACzC;AAED,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC5C,UAAU,EAAE,YAAY,CAAC;IACzB,cAAc,CAAC,EAAE,YAAY,GAAG,gBAAgB,CAAC;CAClD;AAED,MAAM,WAAW,wBAAwB;IACvC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,wBAAwB;IACvC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,6BAA6B;IAC5C,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAC7C;AAID,MAAM,WAAW,+BAA+B;IAC9C,MAAM,EAAE,aAAa,CAAC;IACtB,kBAAkB,EAAE,mBAAmB,CAAC;IACxC,cAAc,CAAC,EAAE,OAAO,GAAG,gBAAgB,CAAC;CAC7C;AAED,MAAM,WAAW,gCAAgC;IAC/C,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,4BAA4B;IAC3C,WAAW,EAAE,KAAK,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAG5C,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED,MAAM,WAAW,6BAA6B;IAC5C,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;;;;GAQG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACtC,gFAAgF;IAChF,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,iEAAiE;IACjE,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;gBAGvB,OAAO,EAAE,MAAM,EACf,gBAAgB,EAAE,MAAM,EACxB,KAAK,EAAE,aAAa,EACpB,KAAK,CAAC,EAAE,OAAO;CAQlB"}

package/dist/providers/wormhole/utils.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Utility functions for Wormhole CCTP route creation.
+ * These helpers can be used both by WormholeProvider and server-side claim endpoints.
+ */
+import { routes, Wormhole } from "@wormhole-foundation/sdk";
+import { Chain } from "../../CrossChainCore";
+import { TokenConfig } from "../../config";
+export interface CCTPRouteResult {
+    route: routes.ManualRoute<"Mainnet" | "Testnet">;
+    request: routes.RouteTransferRequest<"Mainnet" | "Testnet">;
+}
+/**
+ * Creates a CCTP route for transferring USDC between two chains.
+ *
+ * This is a standalone helper that can be used both by WormholeProvider
+ * (client-side) and server-side claim endpoints to avoid code duplication.
+ *
+ * @param wh - Initialized Wormhole context
+ * @param sourceChain - Source chain (e.g., "Aptos")
+ * @param destChain - Destination chain (e.g., "Solana")
+ * @param tokens - Token configuration mapping (mainnetTokens or testnetTokens)
+ * @returns The CCTP route and request for completing transfers
+ * @throws Error if no valid CCTP route is found
+ */
+export declare function createCCTPRoute(wh: Wormhole<"Mainnet" | "Testnet">, sourceChain: Chain, destChain: Chain, tokens: Record<string, TokenConfig>): Promise<CCTPRouteResult>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/providers/wormhole/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/providers/wormhole/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAEL,MAAM,EACN,QAAQ,EAET,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;IACjD,OAAO,EAAE,MAAM,CAAC,oBAAoB,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;CAC7D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,eAAe,CACnC,EAAE,EAAE,QAAQ,CAAC,SAAS,GAAG,SAAS,CAAC,EACnC,WAAW,EAAE,KAAK,EAClB,SAAS,EAAE,KAAK,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GAClC,OAAO,CAAC,eAAe,CAAC,CAiC1B"}

package/dist/providers/wormhole/wormhole.d.ts

@@ -1,13 +1,14 @@
-import { TokenId, Wormhole } from "@wormhole-foundation/sdk";
+import { routes, Wormhole } from "@wormhole-foundation/sdk";
 import { Chain, CrossChainProvider, CrossChainCore } from "../../CrossChainCore";
 import { ChainConfig } from "../../config";
-import { WormholeQuoteRequest, WormholeQuoteResponse, WormholeTransferRequest, WormholeTransferResponse, WormholeSubmitTransferRequest, WormholeStartTransferResponse, WormholeClaimTransferRequest, WormholeWithdrawRequest, WormholeWithdrawResponse } from "./types";
+import { WormholeQuoteRequest, WormholeQuoteResponse, WormholeTransferRequest, WormholeTransferResponse, WormholeSubmitTransferRequest, WormholeStartTransferResponse, WormholeClaimTransferRequest, WormholeWithdrawRequest, WormholeWithdrawResponse, WormholeInitiateWithdrawRequest, WormholeInitiateWithdrawResponse, WormholeClaimWithdrawRequest, WormholeClaimWithdrawResponse } from "./types";
 export declare class WormholeProvider implements CrossChainProvider<WormholeQuoteRequest, WormholeQuoteResponse, WormholeTransferRequest, WormholeTransferResponse, WormholeWithdrawRequest, WormholeWithdrawResponse> {
     private crossChainCore;
     private _wormholeContext;
     private wormholeRoute;
     private wormholeRequest;
     private wormholeQuote;
+    private destinationChain?;
     constructor(core: CrossChainCore);
     get wormholeContext(): Wormhole<"Mainnet" | "Testnet"> | undefined;
     private setWormholeContext;
@@ -23,11 +24,40 @@ export declare class WormholeProvider implements CrossChainProvider<WormholeQuot
      * @returns
      */
     transfer(input: WormholeTransferRequest): Promise<WormholeTransferResponse>;
+    /**
+     * Phase 1: Initiates a withdraw by burning USDC on Aptos.
+     * The user signs the Aptos burn transaction via their wallet.
+     * Returns a receipt that can be tracked and later claimed.
+     */
+    initiateWithdraw(input: WormholeInitiateWithdrawRequest): Promise<WormholeInitiateWithdrawResponse>;
+    /**
+     * Phase 2: Tracks a withdraw receipt until attestation is ready.
+     * This polls Wormhole and returns once the receipt reaches the Attested state.
+     */
+    trackWithdraw(receipt: routes.Receipt): Promise<routes.Receipt>;
+    /**
+     * Phase 3: Claims the withdraw on the destination chain.
+     *
+     * If the destination is Solana and `solanaConfig.serverClaimUrl` is configured
+     * in the dapp config, the SDK automatically POSTs the attested receipt to that
+     * URL — no wallet popup required. The dapp's server endpoint handles signing
+     * and submitting the claim transaction.
+     *
+     * Otherwise falls back to the wallet-based Signer (triggers wallet popup).
+     */
+    claimWithdraw(input: WormholeClaimWithdrawRequest): Promise<WormholeClaimWithdrawResponse>;
+    /**
+     * Withdraws USDC from Aptos to a destination chain.
+     * Orchestrates all three phases internally:
+     *   1. Initiate — user signs the Aptos burn transaction
+     *   2. Track — wait for Wormhole attestation
+     *   3. Claim — if serverClaimUrl is configured for Solana, delegates to
+     *      the server; otherwise uses the wallet-based signer.
+     *
+     * The optional `onPhaseChange` callback lets the dapp update its UI
+     * as the flow progresses.
+     */
     withdraw(input: WormholeWithdrawRequest): Promise<WormholeWithdrawResponse>;
     getChainConfig(chain: Chain): ChainConfig;
-    getTokenInfo(sourceChain: Chain, destinationChain: Chain): {
-        sourceToken: TokenId;
-        destToken: TokenId;
-    };
 }
 //# sourceMappingURL=wormhole.d.ts.map

package/dist/providers/wormhole/wormhole.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wormhole.d.ts","sourceRoot":"","sources":["../../../src/providers/wormhole/wormhole.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,OAAO,EACP,QAAQ,EAIT,MAAM,0BAA0B,CAAC;AAOlC,OAAO,EACL,KAAK,EACL,kBAAkB,EAClB,cAAc,EACf,MAAM,sBAAsB,CAAC;AAI9B,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EAGxB,6BAA6B,EAC7B,6BAA6B,EAC7B,4BAA4B,EAC5B,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,SAAS,CAAC;AAKjB,qBAAa,gBAAiB,YAAW,kBAAkB,CACzD,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,CACzB;IACC,OAAO,CAAC,cAAc,CAAiB;IAEvC,OAAO,CAAC,gBAAgB,CAA8C;IAEtE,OAAO,CAAC,aAAa,CAAoC;IACzD,OAAO,CAAC,eAAe,CAA8B;IACrD,OAAO,CAAC,aAAa,CAAoC;gBAE7C,IAAI,EAAE,cAAc;IAIhC,IAAI,eAAe,IAAI,QAAQ,CAAC,SAAS,GAAG,SAAS,CAAC,GAAG,SAAS,CAEjE;YAEa,kBAAkB;YA0BlB,QAAQ;IAoDhB,QAAQ,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAuCrE,kBAAkB,CACtB,KAAK,EAAE,6BAA6B,GACnC,OAAO,CAAC,6BAA6B,CAAC;IA6DnC,iBAAiB,CACrB,KAAK,EAAE,4BAA4B,GAClC,OAAO,CAAC;QAAE,qBAAqB,EAAE,MAAM,CAAA;KAAE,CAAC;IAyD7C;;;;OAIG;IACG,QAAQ,CACZ,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,wBAAwB,CAAC;IAwB9B,QAAQ,CACZ,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,wBAAwB,CAAC;IA+GpC,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,WAAW;IAWzC,YAAY,CACV,WAAW,EAAE,KAAK,EAClB,gBAAgB,EAAE,KAAK,GACtB;QACD,WAAW,EAAE,OAAO,CAAC;QACrB,SAAS,EAAE,OAAO,CAAC;KACpB;CAaF"}
+{"version":3,"file":"wormhole.d.ts","sourceRoot":"","sources":["../../../src/providers/wormhole/wormhole.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,QAAQ,EAIT,MAAM,0BAA0B,CAAC;AAOlC,OAAO,EACL,KAAK,EACL,kBAAkB,EAClB,cAAc,EACf,MAAM,sBAAsB,CAAC;AAK9B,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EAGxB,6BAA6B,EAC7B,6BAA6B,EAC7B,4BAA4B,EAC5B,uBAAuB,EACvB,wBAAwB,EACxB,+BAA+B,EAC/B,gCAAgC,EAChC,4BAA4B,EAC5B,6BAA6B,EAE9B,MAAM,SAAS,CAAC;AAKjB,qBAAa,gBAAiB,YAAW,kBAAkB,CACzD,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,CACzB;IACC,OAAO,CAAC,cAAc,CAAiB;IAEvC,OAAO,CAAC,gBAAgB,CAA8C;IAEtE,OAAO,CAAC,aAAa,CAAoC;IACzD,OAAO,CAAC,eAAe,CAA8B;IACrD,OAAO,CAAC,aAAa,CAAoC;IACzD,OAAO,CAAC,gBAAgB,CAAC,CAAQ;gBAErB,IAAI,EAAE,cAAc;IAIhC,IAAI,eAAe,IAAI,QAAQ,CAAC,SAAS,GAAG,SAAS,CAAC,GAAG,SAAS,CAEjE;YAEa,kBAAkB;YA0BlB,QAAQ;IAyBhB,QAAQ,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAuCrE,kBAAkB,CACtB,KAAK,EAAE,6BAA6B,GACnC,OAAO,CAAC,6BAA6B,CAAC;IA6DnC,iBAAiB,CACrB,KAAK,EAAE,4BAA4B,GAClC,OAAO,CAAC;QAAE,qBAAqB,EAAE,MAAM,CAAA;KAAE,CAAC;IAyD7C;;;;OAIG;IACG,QAAQ,CACZ,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,wBAAwB,CAAC;IA0BpC;;;;OAIG;IACG,gBAAgB,CACpB,KAAK,EAAE,+BAA+B,GACrC,OAAO,CAAC,gCAAgC,CAAC;IA0C5C;;;OAGG;IACG,aAAa,CACjB,OAAO,EAAE,MAAM,CAAC,OAAO,GACtB,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;IA8B1B;;;;;;;;;OASG;IACG,aAAa,CACjB,KAAK,EAAE,4BAA4B,GAClC,OAAO,CAAC,6BAA6B,CAAC;IAgEzC;;;;;;;;;;OAUG;IACG,QAAQ,CACZ,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,wBAAwB,CAAC;IAwCpC,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,WAAW;CAU1C"}

package/dist/utils/receiptSerialization.d.ts

@@ -0,0 +1,38 @@
+import { routes, AttestationReceipt } from "@wormhole-foundation/sdk";
+/**
+ * Serializes a Wormhole receipt for JSON transport.
+ *
+ * JSON doesn't natively support BigInt, Uint8Array, or class instances.
+ * This function converts these types to a serializable format with type markers
+ * that can be reconstructed by `deserializeReceipt`.
+ *
+ * @example
+ * ```typescript
+ * import { serializeReceipt } from "@aptos-labs/cross-chain-core";
+ *
+ * // On the client side, before sending to server
+ * const serialized = serializeReceipt(receipt);
+ * await fetch("/api/claim", {
+ *   method: "POST",
+ *   body: JSON.stringify({ receipt: serialized }),
+ * });
+ * ```
+ */
+export declare function serializeReceipt(receipt: routes.Receipt<AttestationReceipt>): unknown;
+/**
+ * Deserializes a Wormhole receipt from JSON transport format.
+ *
+ * Reconstructs BigInt, Uint8Array, and UniversalAddress instances from
+ * the serialized format produced by `serializeReceipt`.
+ *
+ * @example
+ * ```typescript
+ * import { deserializeReceipt, SolanaLocalSigner } from "@aptos-labs/cross-chain-core";
+ *
+ * // On the server side, after receiving from client
+ * const receipt = deserializeReceipt(body.receipt);
+ * await cctpRoute.complete(signer, receipt);
+ * ```
+ */
+export declare function deserializeReceipt(obj: unknown): routes.Receipt<AttestationReceipt>;
+//# sourceMappingURL=receiptSerialization.d.ts.map

package/dist/utils/receiptSerialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"receiptSerialization.d.ts","sourceRoot":"","sources":["../../src/utils/receiptSerialization.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,kBAAkB,EAEnB,MAAM,0BAA0B,CAAC;AAoBlC;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,GAC1C,OAAO,CAuBT;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,OAAO,GACX,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAoDpC"}

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const CROSS_CHAIN_CORE_VERSION = "5.8.2";
+export declare const CROSS_CHAIN_CORE_VERSION = "5.9.0";
 //# sourceMappingURL=version.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aptos-labs/cross-chain-core",
-  "version": "5.8.2",
+  "version": "5.9.0",
   "description": "Aptos Cross Chain Core",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -59,7 +59,7 @@
     "@aptos-labs/derived-wallet-ethereum": "0.9.0",
     "@aptos-labs/derived-wallet-solana": "0.12.0",
     "@aptos-labs/derived-wallet-sui": "0.2.0",
-    "@aptos-labs/wallet-adapter-core": "8.3.0"
+    "@aptos-labs/wallet-adapter-core": "8.4.0"
   },
   "peerDependencies": {
     "@aptos-labs/ts-sdk": "^5.1.1"

package/src/CrossChainCore.ts

@@ -37,6 +37,26 @@ export interface CrossChainDappConfig {
       min?: number;
       max?: number;
     };
+    /**
+     * URL of a server-side API endpoint that claims withdraw transactions on Solana.
+     * When set, the SDK will POST the attested receipt to this URL instead of
+     * asking the user's wallet to sign the claim transaction.
+     *
+     * Expected request body: { serializedReceipt: string, destinationAddress: string, sourceChain: string }
+     * Expected response: { destinationChainTxnId: string }
+     * Check out the SERVERSIDE_SOLANA_SIGNER.md file for more details.
+     * 
+     * @example
+     * const crossChainCore = new CrossChainCore({
+     *   dappConfig: {
+     *     aptosNetwork: Network.TESTNET,
+     *     solanaConfig: {
+     *       serverClaimUrl: "/api/claim-withdraw",
+     *     },
+     *   },
+     * });
+     */
+    serverClaimUrl?: string;
   };
 }
 export type { AccountAddressInput } from "@aptos-labs/ts-sdk";

package/src/config/mainnet/chains.ts

@@ -16,8 +16,8 @@ export const mainnetChains: ChainsConfig = {
     key: "Solana",
     context: Context.SOLANA,
     displayName: "Solana",
-    explorerUrl: "https://explorer.solana.com/",
-    explorerName: "Solana Explorer",
+    explorerUrl: "https://solscan.io",
+    explorerName: "Solscan",
     chainId: 0,
     icon: "Solana",
     symbol: "SOL",

package/src/config/testnet/chains.ts

@@ -61,8 +61,8 @@ export const testnetChains: ChainsConfig = {
     key: "Solana",
     context: Context.SOLANA,
     displayName: "Solana",
-    explorerUrl: "https://explorer.solana.com/",
-    explorerName: "Solana Explorer",
+    explorerUrl: "https://solscan.io",
+    explorerName: "Solscan",
     chainId: 0,
     icon: "Solana",
     symbol: "SOL",

package/src/index.ts

@@ -2,4 +2,5 @@ export * from "./CrossChainCore";
 export * from "./config";
 export * from "./providers/wormhole/index";
 export * from "./providers/wormhole/types";
+export * from "./utils/receiptSerialization";
 export { Network } from "@aptos-labs/ts-sdk";

package/src/providers/wormhole/index.ts

@@ -1,4 +1,6 @@
 export * from "./wormhole";
 export * from "./types";
+export * from "./utils";
 export * from "./signers/AptosLocalSigner";
+export * from "./signers/SolanaLocalSigner";
 export * from "../../config";

package/src/providers/wormhole/signers/AptosLocalSigner.ts

@@ -29,7 +29,7 @@ export class AptosLocalSigner<
   _options: any;
   _wallet: Account;
   _sponsorAccount: Account | GasStationApiKey | undefined;
-  _claimedTransactionHashes: string;
+  _claimedTransactionHashes: string[] = [];
   _dappNetwork: AptosNetwork;
   constructor(
     chain: C,
@@ -42,7 +42,6 @@ export class AptosLocalSigner<
     this._options = options;
     this._wallet = wallet;
     this._sponsorAccount = feePayerAccount;
-    this._claimedTransactionHashes = "";
     this._dappNetwork = dappNetwork;
   }
 
@@ -54,11 +53,12 @@ export class AptosLocalSigner<
   }
 
   claimedTransactionHashes(): string {
-    return this._claimedTransactionHashes;
+    return this._claimedTransactionHashes.join(",");
   }
 
   async signAndSend(txs: UnsignedTransaction<N, C>[]): Promise<TxHash[]> {
     const txHashes: TxHash[] = [];
+    this._claimedTransactionHashes = [];
 
     for (const tx of txs) {
       const txId = await signAndSendTransaction(
@@ -68,7 +68,7 @@ export class AptosLocalSigner<
         this._dappNetwork,
       );
       txHashes.push(txId);
-      this._claimedTransactionHashes = txId;
+      this._claimedTransactionHashes.push(txId);
     }
     return txHashes;
   }

package/src/providers/wormhole/signers/AptosSigner.ts

@@ -27,7 +27,7 @@ export async function signAndSendTransaction(
   dappNetwork: AptosNetwork,
 ) {
   if (!wallet) {
-    throw new Error("wallet.sendTransaction is undefined").message;
+    throw new Error("wallet.sendTransaction is undefined");
   }
 
   const payload = request.transaction;

package/src/providers/wormhole/signers/EthereumSigner.ts

@@ -13,7 +13,7 @@ export async function signAndSendTransaction(
   options: any,
 ): Promise<string> {
   if (!wallet) {
-    throw new Error("wallet.sendTransaction is undefined").message;
+    throw new Error("wallet.sendTransaction is undefined");
   }
   // Ensure the signer is connected to the correct chain
   const chainId = await (
@@ -24,7 +24,7 @@ export async function signAndSendTransaction(
   const actualChainId = parseInt(chainId, 16);
 
   if (!actualChainId)
-    throw new Error("No signer found for chain" + chainName).message;
+    throw new Error("No signer found for chain" + chainName);
   const expectedChainId = request.transaction.chainId
     ? getBigInt(request.transaction.chainId)
     : undefined;
@@ -35,7 +35,7 @@ export async function signAndSendTransaction(
   ) {
     throw new Error(
       `Signer is not connected to the right chain. Expected ${expectedChainId}, got ${actualChainId}`,
-    ).message;
+    );
   }
 
   const provider = new ethers.BrowserProvider(

package/src/providers/wormhole/signers/Signer.ts

@@ -37,7 +37,7 @@ export class Signer<
   _wallet: AdapterWallet;
   _crossChainCore: CrossChainCore;
   _sponsorAccount: Account | GasStationApiKey | undefined;
-  _claimedTransactionHashes: string;
+  _claimedTransactionHashes: string[] = [];
 
   constructor(
     chain: ChainConfig,
@@ -53,7 +53,6 @@ export class Signer<
     this._wallet = wallet;
     this._crossChainCore = crossChainCore;
     this._sponsorAccount = sponsorAccount;
-    this._claimedTransactionHashes = "";
   }
 
   chain(): C {
@@ -64,11 +63,12 @@ export class Signer<
   }
 
   claimedTransactionHashes(): string {
-    return this._claimedTransactionHashes;
+    return this._claimedTransactionHashes.join(",");
   }
 
   async signAndSend(txs: UnsignedTransaction<N, C>[]): Promise<TxHash[]> {
     const txHashes: TxHash[] = [];
+    this._claimedTransactionHashes = [];
 
     for (const tx of txs) {
       const txId = await signAndSendTransaction(
@@ -80,7 +80,7 @@ export class Signer<
         this._sponsorAccount,
       );
       txHashes.push(txId);
-      this._claimedTransactionHashes = txId;
+      this._claimedTransactionHashes.push(txId);
     }
     return txHashes;
   }