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

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

@@ -1,19 +1,21 @@
-import { Network as AptosNetwork, Account } from "@aptos-labs/ts-sdk";
+import { Account } from "@aptos-labs/ts-sdk";
 import { Chain, Network, SignAndSendSigner, TxHash, UnsignedTransaction } from "@wormhole-foundation/sdk";
 import { AptosChains } from "@wormhole-foundation/sdk-aptos";
-import { GasStationApiKey } from "../types";
+import { OnTransactionSigned } from "../types";
+import { CrossChainCore } from "../../../CrossChainCore";
 export declare class AptosLocalSigner<N extends Network, C extends Chain> implements SignAndSendSigner<N, C> {
     _chain: C;
     _options: any;
     _wallet: Account;
-    _sponsorAccount: Account | GasStationApiKey | undefined;
+    _sponsorAccount: Account | undefined;
+    _onTransactionSigned: OnTransactionSigned | undefined;
+    _crossChainCore: CrossChainCore;
     _claimedTransactionHashes: string[];
-    _dappNetwork: AptosNetwork;
-    constructor(chain: C, options: any, wallet: Account, feePayerAccount: Account | GasStationApiKey | undefined, dappNetwork: AptosNetwork);
+    constructor(chain: C, options: any, wallet: Account, feePayerAccount: Account | undefined, crossChainCore: CrossChainCore, onTransactionSigned?: OnTransactionSigned);
     chain(): C;
     address(): string;
     claimedTransactionHashes(): string;
     signAndSend(txs: UnsignedTransaction<N, C>[]): Promise<TxHash[]>;
 }
-export declare function signAndSendTransaction(request: UnsignedTransaction<Network, AptosChains>, wallet: Account, sponsorAccount: Account | GasStationApiKey | undefined, dappNetwork: AptosNetwork): Promise<string>;
+export declare function signAndSendTransaction(request: UnsignedTransaction<Network, AptosChains>, wallet: Account, sponsorAccount: Account | undefined, crossChainCore: CrossChainCore): Promise<string>;
 //# sourceMappingURL=AptosLocalSigner.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"AptosLocalSigner.d.ts","sourceRoot":"","sources":["../../../../src/providers/wormhole/signers/AptosLocalSigner.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,OAAO,IAAI,YAAY,EACvB,OAAO,EACR,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,KAAK,EACL,OAAO,EACP,iBAAiB,EACjB,MAAM,EACN,mBAAmB,EACpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAEL,WAAW,EACZ,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAG5C,qBAAa,gBAAgB,CAC3B,CAAC,SAAS,OAAO,EACjB,CAAC,SAAS,KAAK,CACf,YAAW,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC;IAClC,MAAM,EAAE,CAAC,CAAC;IACV,QAAQ,EAAE,GAAG,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,OAAO,GAAG,gBAAgB,GAAG,SAAS,CAAC;IACxD,yBAAyB,EAAE,MAAM,EAAE,CAAM;IACzC,YAAY,EAAE,YAAY,CAAC;gBAEzB,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,GAAG,EACZ,MAAM,EAAE,OAAO,EACf,eAAe,EAAE,OAAO,GAAG,gBAAgB,GAAG,SAAS,EACvD,WAAW,EAAE,YAAY;IAS3B,KAAK,IAAI,CAAC;IAGV,OAAO,IAAI,MAAM;IAIjB,wBAAwB,IAAI,MAAM;IAI5B,WAAW,CAAC,GAAG,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAgBvE;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,mBAAmB,CAAC,OAAO,EAAE,WAAW,CAAC,EAClD,MAAM,EAAE,OAAO,EACf,cAAc,EAAE,OAAO,GAAG,gBAAgB,GAAG,SAAS,EACtD,WAAW,EAAE,YAAY,mBA2D1B"}
+{"version":3,"file":"AptosLocalSigner.d.ts","sourceRoot":"","sources":["../../../../src/providers/wormhole/signers/AptosLocalSigner.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,OAAO,EACR,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,KAAK,EACL,OAAO,EACP,iBAAiB,EACjB,MAAM,EACN,mBAAmB,EACpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAEL,WAAW,EACZ,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,mBAAmB,EAEpB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD,qBAAa,gBAAgB,CAC3B,CAAC,SAAS,OAAO,EACjB,CAAC,SAAS,KAAK,CACf,YAAW,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC;IAClC,MAAM,EAAE,CAAC,CAAC;IACV,QAAQ,EAAE,GAAG,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,OAAO,GAAG,SAAS,CAAC;IACrC,oBAAoB,EAAE,mBAAmB,GAAG,SAAS,CAAC;IACtD,eAAe,EAAE,cAAc,CAAC;IAChC,yBAAyB,EAAE,MAAM,EAAE,CAAM;gBAEvC,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,GAAG,EACZ,MAAM,EAAE,OAAO,EACf,eAAe,EAAE,OAAO,GAAG,SAAS,EACpC,cAAc,EAAE,cAAc,EAC9B,mBAAmB,CAAC,EAAE,mBAAmB;IAU3C,KAAK,IAAI,CAAC;IAGV,OAAO,IAAI,MAAM;IAIjB,wBAAwB,IAAI,MAAM;IAI5B,WAAW,CAAC,GAAG,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAkBvE;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,mBAAmB,CAAC,OAAO,EAAE,WAAW,CAAC,EAClD,MAAM,EAAE,OAAO,EACf,cAAc,EAAE,OAAO,GAAG,SAAS,EACnC,cAAc,EAAE,cAAc,mBAiE/B"}

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

@@ -3,6 +3,7 @@ import { AdapterWallet } from "@aptos-labs/wallet-adapter-core";
 import { Network } from "@wormhole-foundation/sdk";
 import { AptosChains, AptosUnsignedTransaction } from "@wormhole-foundation/sdk-aptos";
 import { GasStationApiKey } from "..";
-export declare function signAndSendTransaction(request: AptosUnsignedTransaction<Network, AptosChains>, wallet: AdapterWallet, sponsorAccount: Account | GasStationApiKey | undefined, dappNetwork: AptosNetwork): Promise<string>;
+import { CrossChainCore } from "../../../CrossChainCore";
+export declare function signAndSendTransaction(request: AptosUnsignedTransaction<Network, AptosChains>, wallet: AdapterWallet, sponsorAccount: Account | GasStationApiKey | undefined, dappNetwork: AptosNetwork, crossChainCore?: CrossChainCore): Promise<string>;
 export declare function isAccount(obj: Account | GasStationApiKey): obj is Account;
 //# sourceMappingURL=AptosSigner.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"AptosSigner.d.ts","sourceRoot":"","sources":["../../../../src/providers/wormhole/signers/AptosSigner.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EAMP,OAAO,IAAI,YAAY,EAIxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACnD,OAAO,EACL,WAAW,EACX,wBAAwB,EACzB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,IAAI,CAAC;AAItC,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,wBAAwB,CAAC,OAAO,EAAE,WAAW,CAAC,EACvD,MAAM,EAAE,aAAa,EACrB,cAAc,EAAE,OAAO,GAAG,gBAAgB,GAAG,SAAS,EACtD,WAAW,EAAE,YAAY,mBA0G1B;AA0BD,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,GAAG,GAAG,IAAI,OAAO,CAEzE"}
+{"version":3,"file":"AptosSigner.d.ts","sourceRoot":"","sources":["../../../../src/providers/wormhole/signers/AptosSigner.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EAMP,OAAO,IAAI,YAAY,EAIxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACnD,OAAO,EACL,WAAW,EACX,wBAAwB,EACzB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAA2B,MAAM,IAAI,CAAC;AAG/D,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,wBAAwB,CAAC,OAAO,EAAE,WAAW,CAAC,EACvD,MAAM,EAAE,aAAa,EACrB,cAAc,EAAE,OAAO,GAAG,gBAAgB,GAAG,SAAS,EACtD,WAAW,EAAE,YAAY,EACzB,cAAc,CAAC,EAAE,cAAc,mBAiHhC;AA0BD,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,GAAG,GAAG,IAAI,OAAO,CAEzE"}

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

@@ -1,5 +1,5 @@
 import { EvmUnsignedTransaction, EvmChains } from "@wormhole-foundation/sdk-evm";
 import { Network } from "@wormhole-foundation/sdk";
 import { AdapterWallet } from "@aptos-labs/wallet-adapter-core";
-export declare function signAndSendTransaction(request: EvmUnsignedTransaction<Network, EvmChains>, wallet: AdapterWallet, chainName: string, options: any): Promise<string>;
+export declare function signAndSendTransaction(request: EvmUnsignedTransaction<Network, EvmChains>, wallet: AdapterWallet, chainName: string): Promise<string>;
 //# sourceMappingURL=EthereumSigner.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"EthereumSigner.d.ts","sourceRoot":"","sources":["../../../../src/providers/wormhole/signers/EthereumSigner.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,SAAS,EACV,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAEnD,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAEhE,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,sBAAsB,CAAC,OAAO,EAAE,SAAS,CAAC,EACnD,MAAM,EAAE,aAAa,EACrB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,GAAG,GACX,OAAO,CAAC,MAAM,CAAC,CAmCjB"}
+{"version":3,"file":"EthereumSigner.d.ts","sourceRoot":"","sources":["../../../../src/providers/wormhole/signers/EthereumSigner.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,SAAS,EACV,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAEnD,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAGhE,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,sBAAsB,CAAC,OAAO,EAAE,SAAS,CAAC,EACnD,MAAM,EAAE,aAAa,EACrB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,CAAC,CAsFjB"}

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

@@ -2,7 +2,7 @@ import { UnsignedTransaction, Network, Chain, TxHash, SignAndSendSigner } from "
 import { AdapterWallet } from "@aptos-labs/wallet-adapter-core";
 import { ChainConfig } from "../../../config";
 import { CrossChainCore } from "../../../CrossChainCore";
-import { GasStationApiKey } from "../types";
+import { GasStationApiKey, OnTransactionSigned } from "../types";
 import { Account } from "@aptos-labs/ts-sdk";
 export declare class Signer<N extends Network, C extends Chain> implements SignAndSendSigner<N, C> {
     _chain: ChainConfig;
@@ -11,8 +11,16 @@ export declare class Signer<N extends Network, C extends Chain> implements SignA
     _wallet: AdapterWallet;
     _crossChainCore: CrossChainCore;
     _sponsorAccount: Account | GasStationApiKey | undefined;
+    _onTransactionSigned: OnTransactionSigned | undefined;
     _claimedTransactionHashes: string[];
-    constructor(chain: ChainConfig, address: string, options: any, wallet: AdapterWallet, crossChainCore: CrossChainCore, sponsorAccount?: Account | GasStationApiKey | undefined);
+    /**
+     * When true, signed tx hashes are written to
+     * `_crossChainCore._lastSourceChainTxId` as a recovery side-channel.
+     * Set to false for destination-chain claim signers so they don't
+     * overwrite the source-chain burn hash.
+     */
+    _trackAsSourceChain: boolean;
+    constructor(chain: ChainConfig, address: string, options: any, wallet: AdapterWallet, crossChainCore: CrossChainCore, sponsorAccount?: Account | GasStationApiKey | undefined, onTransactionSigned?: OnTransactionSigned, trackAsSourceChain?: boolean);
     chain(): C;
     address(): string;
     claimedTransactionHashes(): string;

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

@@ -1 +1 @@
-{"version":3,"file":"Signer.d.ts","sourceRoot":"","sources":["../../../../src/providers/wormhole/signers/Signer.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,OAAO,EACP,KAAK,EACL,MAAM,EACN,iBAAiB,EAClB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAehE,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAGzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,qBAAa,MAAM,CACjB,CAAC,SAAS,OAAO,EACjB,CAAC,SAAS,KAAK,CACf,YAAW,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC;IAClC,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,GAAG,CAAC;IACd,OAAO,EAAE,aAAa,CAAC;IACvB,eAAe,EAAE,cAAc,CAAC;IAChC,eAAe,EAAE,OAAO,GAAG,gBAAgB,GAAG,SAAS,CAAC;IACxD,yBAAyB,EAAE,MAAM,EAAE,CAAM;gBAGvC,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,GAAG,EACZ,MAAM,EAAE,aAAa,EACrB,cAAc,EAAE,cAAc,EAC9B,cAAc,CAAC,EAAE,OAAO,GAAG,gBAAgB,GAAG,SAAS;IAUzD,KAAK,IAAI,CAAC;IAGV,OAAO,IAAI,MAAM;IAIjB,wBAAwB,IAAI,MAAM;IAI5B,WAAW,CAAC,GAAG,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAkBvE;AAED,eAAO,MAAM,sBAAsB,GACjC,OAAO,WAAW,EAClB,SAAS,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,EAC5C,QAAQ,aAAa,EACrB,SAAS,GAAG,YAAK,EACjB,gBAAgB,cAAc,EAC9B,iBAAiB,OAAO,GAAG,gBAAgB,GAAG,SAAS,KACtD,OAAO,CAAC,MAAM,CAwChB,CAAC"}
+{"version":3,"file":"Signer.d.ts","sourceRoot":"","sources":["../../../../src/providers/wormhole/signers/Signer.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,OAAO,EACP,KAAK,EACL,MAAM,EACN,iBAAiB,EAClB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAehE,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAGzD,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AACjE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,qBAAa,MAAM,CACjB,CAAC,SAAS,OAAO,EACjB,CAAC,SAAS,KAAK,CACf,YAAW,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC;IAClC,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,GAAG,CAAC;IACd,OAAO,EAAE,aAAa,CAAC;IACvB,eAAe,EAAE,cAAc,CAAC;IAChC,eAAe,EAAE,OAAO,GAAG,gBAAgB,GAAG,SAAS,CAAC;IACxD,oBAAoB,EAAE,mBAAmB,GAAG,SAAS,CAAC;IACtD,yBAAyB,EAAE,MAAM,EAAE,CAAM;IACzC;;;;;OAKG;IACH,mBAAmB,EAAE,OAAO,CAAC;gBAG3B,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,GAAG,EACZ,MAAM,EAAE,aAAa,EACrB,cAAc,EAAE,cAAc,EAC9B,cAAc,CAAC,EAAE,OAAO,GAAG,gBAAgB,GAAG,SAAS,EACvD,mBAAmB,CAAC,EAAE,mBAAmB,EACzC,kBAAkB,GAAE,OAAc;IAYpC,KAAK,IAAI,CAAC;IAGV,OAAO,IAAI,MAAM;IAIjB,wBAAwB,IAAI,MAAM;IAI5B,WAAW,CAAC,GAAG,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAuBvE;AAED,eAAO,MAAM,sBAAsB,GACjC,OAAO,WAAW,EAClB,SAAS,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,EAC5C,QAAQ,aAAa,EACrB,SAAS,GAAG,YAAK,EACjB,gBAAgB,cAAc,EAC9B,iBAAiB,OAAO,GAAG,gBAAgB,GAAG,SAAS,KACtD,OAAO,CAAC,MAAM,CAwChB,CAAC"}

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

@@ -1,6 +1,7 @@
 import { Connection, Keypair, type Commitment } from "@solana/web3.js";
 import { Chain, Network, SignAndSendSigner, TxHash, UnsignedTransaction } from "@wormhole-foundation/sdk";
 import { PriorityFeeConfig } from "./solanaUtils";
+import { OnTransactionSigned } from "../types";
 export interface SolanaLocalSignerConfig {
     /** The Solana keypair to sign transactions with */
     keypair: Keypair;
@@ -14,6 +15,8 @@ export interface SolanaLocalSignerConfig {
     priorityFeeConfig?: PriorityFeeConfig;
     /** Enable verbose logging (default: false) */
     verbose?: boolean;
+    /** Optional callback fired before and after each individual transaction is signed. */
+    onTransactionSigned?: OnTransactionSigned;
 }
 /**
  * Server-side Solana signer for programmatic transaction signing.
@@ -49,6 +52,7 @@ export declare class SolanaLocalSigner<N extends Network, C extends Chain> imple
     private retryIntervalMs;
     private priorityFeeConfig?;
     private verbose;
+    private _onTransactionSigned?;
     private _claimedTransactionHashes;
     constructor(config: SolanaLocalSignerConfig);
     chain(): C;

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

@@ -1 +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"}
+{"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;AACvB,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAE/C,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;IAClB,sFAAsF;IACtF,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;CAC3C;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,oBAAoB,CAAC,CAAsB;IACnD,OAAO,CAAC,yBAAyB,CAAgB;gBAErC,MAAM,EAAE,uBAAuB;IAU3C,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;YAcxD,sBAAsB;CAkIrC;AAGD,YAAY,EAAE,iBAAiB,EAAE,CAAC"}

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":"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"}
+{"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,mBA0DhC;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.map

@@ -1 +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"}
+{"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,CA4EjB;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

@@ -18,25 +18,52 @@ export interface WormholeTransferRequest {
     mainSigner: Account;
     amount?: string;
     sponsorAccount?: Account;
+    /** Optional callback fired before and after each individual transaction is signed. */
+    onTransactionSigned?: OnTransactionSigned;
 }
 export type WithdrawPhase = "initiating" | "tracking" | "claiming";
+/**
+ * Callback fired before and after each individual transaction is signed
+ * and submitted during a bridge flow.
+ *
+ * @param description - A human-readable description of the transaction
+ *   (e.g. "Approving USDC transfer"). Comes from the Wormhole SDK's
+ *   `UnsignedTransaction.description`.
+ * @param txId - `null` when called *before* signing; the on-chain
+ *   transaction hash when called *after* signing.
+ */
+export type OnTransactionSigned = (description: string, txId: string | null) => void;
 export interface WormholeWithdrawRequest {
+    /**
+     * The non-Aptos chain involved in the withdrawal. For a withdrawal from
+     * Aptos → Solana, this is `"Solana"`.
+     *
+     * Note: despite the name, this is the *destination* of the bridge transfer
+     * (where USDC will be claimed), not the chain that burns USDC (which is
+     * always Aptos for withdrawals).
+     */
     sourceChain: Chain;
     wallet: AdapterWallet;
     destinationAddress: AccountAddressInput;
     sponsorAccount?: Account | GasStationApiKey;
     /** Optional callback fired when the withdraw progresses to a new phase. */
     onPhaseChange?: (phase: WithdrawPhase) => void;
+    /** Optional callback fired before and after each individual transaction is signed. */
+    onTransactionSigned?: OnTransactionSigned;
 }
 export interface WormholeSubmitTransferRequest {
     sourceChain: Chain;
     wallet: AdapterWallet;
     destinationAddress: AccountAddressInput;
+    /** Optional callback fired before and after each individual transaction is signed. */
+    onTransactionSigned?: OnTransactionSigned;
 }
 export interface WormholeClaimTransferRequest {
     receipt: routes.Receipt<AttestationReceipt>;
     mainSigner: AptosAccount;
     sponsorAccount?: AptosAccount | GasStationApiKey;
+    /** Optional callback fired before and after each individual transaction is signed. */
+    onTransactionSigned?: OnTransactionSigned;
 }
 export interface WormholeTransferResponse {
     destinationChainTxnId: string;
@@ -54,20 +81,70 @@ export interface WormholeInitiateWithdrawRequest {
     wallet: AdapterWallet;
     destinationAddress: AccountAddressInput;
     sponsorAccount?: Account | GasStationApiKey;
+    /** Optional callback fired before and after each individual transaction is signed. */
+    onTransactionSigned?: OnTransactionSigned;
 }
 export interface WormholeInitiateWithdrawResponse {
     originChainTxnId: string;
     receipt: routes.Receipt<AttestationReceipt>;
 }
 export interface WormholeClaimWithdrawRequest {
-    sourceChain: Chain;
+    /**
+     * The chain on which the claim transaction will be executed (the destination
+     * chain of the withdrawal).
+     *
+     * For example, when withdrawing from Aptos → Solana, `claimChain` is
+     * `"Solana"` because that's where the USDC is minted/claimed.
+     */
+    claimChain: Chain;
     destinationAddress: string;
     receipt: routes.Receipt<AttestationReceipt>;
     wallet?: AdapterWallet;
+    /** Optional callback fired before and after each individual transaction is signed. */
+    onTransactionSigned?: OnTransactionSigned;
 }
 export interface WormholeClaimWithdrawResponse {
     destinationChainTxnId: string;
 }
+export interface RetryWithdrawClaimRequest extends WormholeClaimWithdrawRequest {
+    /** Maximum number of retry attempts (default: 5). */
+    maxRetries?: number;
+    /** Initial delay in ms before the first retry (default: 2000). */
+    initialDelayMs?: number;
+    /** Multiplier applied to the delay after each failed attempt (default: 2). */
+    backoffMultiplier?: number;
+}
+export interface RetryWithdrawClaimResponse extends WormholeClaimWithdrawResponse {
+    /** Number of retry attempts that were needed (0 means first attempt succeeded). */
+    retriesUsed: number;
+}
+/**
+ * Validates that a value returned by `getExpireTimestamp` is a non-negative
+ * integer suitable for use as an epoch-second expiration timestamp.
+ * Throws immediately for NaN, Infinity, negative values, or floats so that
+ * misconfigured callbacks fail fast instead of producing silent misbehaviour.
+ */
+export declare function validateExpireTimestamp(value: number): void;
+/**
+ * Error thrown when the transfer (deposit) flow fails *after* the source-chain
+ * burn transaction has already been submitted (i.e. during attestation tracking
+ * or Aptos claiming).
+ *
+ * Consumers should check `instanceof TransferError` 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 TransferError extends Error {
+    /** Source-chain burn transaction hash — available when the burn succeeded before the failure. */
+    readonly originChainTxnId: string;
+    /**
+     * 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, cause?: unknown);
+}
 /**
  * Error thrown when the withdraw flow fails *after* the Aptos burn
  * transaction has already been submitted (i.e. during attestation tracking

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":"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"}
+{"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;IACzB,sFAAsF;IACtF,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;CAC3C;AAED,MAAM,MAAM,aAAa,GACrB,YAAY,GACZ,UAAU,GACV,UAAU,CAAC;AAEf;;;;;;;;;GASG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;AAErF,MAAM,WAAW,uBAAuB;IACtC;;;;;;;OAOG;IACH,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;IAC/C,sFAAsF;IACtF,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;CAC3C;AAED,MAAM,WAAW,6BAA6B;IAC5C,WAAW,EAAE,KAAK,CAAC;IACnB,MAAM,EAAE,aAAa,CAAC;IACtB,kBAAkB,EAAE,mBAAmB,CAAC;IACxC,sFAAsF;IACtF,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;CAC3C;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;IACjD,sFAAsF;IACtF,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;CAC3C;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;IAC5C,sFAAsF;IACtF,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;CAC3C;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;;;;;;OAMG;IACH,UAAU,EAAE,KAAK,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAG5C,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,sFAAsF;IACtF,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;CAC3C;AAED,MAAM,WAAW,6BAA6B;IAC5C,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,yBAA0B,SAAQ,4BAA4B;IAC7E,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8EAA8E;IAC9E,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,0BAA2B,SAAQ,6BAA6B;IAC/E,mFAAmF;IACnF,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAO3D;AAED;;;;;;;;GAQG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACtC,iGAAiG;IACjG,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;gBAGvB,OAAO,EAAE,MAAM,EACf,gBAAgB,EAAE,MAAM,EACxB,KAAK,CAAC,EAAE,OAAO;CAOlB;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/wormhole.d.ts

@@ -1,7 +1,7 @@
 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, WormholeInitiateWithdrawRequest, WormholeInitiateWithdrawResponse, WormholeClaimWithdrawRequest, WormholeClaimWithdrawResponse } from "./types";
+import { WormholeQuoteRequest, WormholeQuoteResponse, WormholeTransferRequest, WormholeTransferResponse, WormholeSubmitTransferRequest, WormholeStartTransferResponse, WormholeClaimTransferRequest, WormholeWithdrawRequest, WormholeWithdrawResponse, WormholeInitiateWithdrawRequest, WormholeInitiateWithdrawResponse, WormholeClaimWithdrawRequest, WormholeClaimWithdrawResponse, RetryWithdrawClaimRequest, RetryWithdrawClaimResponse } from "./types";
 export declare class WormholeProvider implements CrossChainProvider<WormholeQuoteRequest, WormholeQuoteResponse, WormholeTransferRequest, WormholeTransferResponse, WormholeWithdrawRequest, WormholeWithdrawResponse> {
     private crossChainCore;
     private _wormholeContext;
@@ -58,6 +58,32 @@ export declare class WormholeProvider implements CrossChainProvider<WormholeQuot
      * as the flow progresses.
      */
     withdraw(input: WormholeWithdrawRequest): Promise<WormholeWithdrawResponse>;
+    /**
+     * Retries a failed `claimWithdraw` call with configurable exponential backoff.
+     *
+     * Use this when the claim phase of a withdrawal fails (e.g., RPC instability,
+     * network congestion) but the Aptos burn transaction has already been submitted.
+     * The attested receipt can be recovered from the `WithdrawError` thrown by
+     * `withdraw()` and passed directly to this method.
+     *
+     * @example
+     * ```ts
+     * try {
+     *   await provider.withdraw({ ... });
+     * } catch (error) {
+     *   if (error instanceof WithdrawError && error.phase === "claiming") {
+     *     const result = await provider.retryWithdrawClaim({
+     *       sourceChain,
+     *       destinationAddress,
+     *       receipt: attestedReceipt,
+     *       wallet,
+     *       maxRetries: 5,
+     *     });
+     *   }
+     * }
+     * ```
+     */
+    retryWithdrawClaim(input: RetryWithdrawClaimRequest): Promise<RetryWithdrawClaimResponse>;
     getChainConfig(chain: Chain): ChainConfig;
 }
 //# 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,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"}
+{"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,EAEf,MAAM,sBAAsB,CAAC;AAM9B,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,EAC7B,yBAAyB,EACzB,0BAA0B,EAG3B,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;YAyClB,QAAQ;IAyBhB,QAAQ,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAuCrE,kBAAkB,CACtB,KAAK,EAAE,6BAA6B,GACnC,OAAO,CAAC,6BAA6B,CAAC;IAgEnC,iBAAiB,CACrB,KAAK,EAAE,4BAA4B,GAClC,OAAO,CAAC;QAAE,qBAAqB,EAAE,MAAM,CAAA;KAAE,CAAC;IAkE7C;;;;OAIG;IACG,QAAQ,CACZ,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,wBAAwB,CAAC;IAmCpC;;;;OAIG;IACG,gBAAgB,CACpB,KAAK,EAAE,+BAA+B,GACrC,OAAO,CAAC,gCAAgC,CAAC;IA0C5C;;;OAGG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;IA8BrE;;;;;;;;;OASG;IACG,aAAa,CACjB,KAAK,EAAE,4BAA4B,GAClC,OAAO,CAAC,6BAA6B,CAAC;IAmEzC;;;;;;;;;;OAUG;IACG,QAAQ,CACZ,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,wBAAwB,CAAC;IAiDpC;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACG,kBAAkB,CACtB,KAAK,EAAE,yBAAyB,GAC/B,OAAO,CAAC,0BAA0B,CAAC;IAgCtC,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,WAAW;CAU1C"}

package/dist/version.d.ts

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aptos-labs/cross-chain-core",
-  "version": "5.9.0",
+  "version": "6.0.0",
   "description": "Aptos Cross Chain Core",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -57,9 +57,9 @@
     "eventemitter3": "^4.0.7",
     "tweetnacl": "^1.0.3",
     "@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.4.0"
+    "@aptos-labs/wallet-adapter-core": "8.4.0",
+    "@aptos-labs/derived-wallet-solana": "0.12.1"
   },
   "peerDependencies": {
     "@aptos-labs/ts-sdk": "^5.1.1"

package/src/CrossChainCore.ts

@@ -29,6 +29,17 @@ import {
 export interface CrossChainDappConfig {
   aptosNetwork: Network;
   disableTelemetry?: boolean;
+  /**
+   * Returns an epoch-second timestamp used as `expireTimestamp` when building
+   * Aptos transactions. Called at transaction-build time so that each
+   * transaction in a multi-step bridge flow gets a fresh expiration window.
+   *
+   * @example
+   * ```ts
+   * getExpireTimestamp: () => Math.floor(Date.now() / 1000) + 120 // 2 minutes
+   * ```
+   */
+  getExpireTimestamp?: () => number;
   solanaConfig?: {
     rpc?: string;
     priorityFeeConfig?: {
@@ -45,7 +56,7 @@ export interface CrossChainDappConfig {
      * 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: {
@@ -57,7 +68,53 @@ export interface CrossChainDappConfig {
      * });
      */
     serverClaimUrl?: string;
+    /**
+     * Solana transaction confirmation commitment level.
+     *
+     * - `"finalized"` (default) — waits for supermajority finalization (~30 s).
+     * - `"confirmed"` — waits for supermajority confirmation (~0.5 s).
+     *
+     * For bridge flows `"confirmed"` is usually sufficient because Wormhole
+     * guardians independently verify finality before issuing attestations.
+     *
+     * @default "finalized"
+     *
+     * @example
+     * const crossChainCore = new CrossChainCore({
+     *   dappConfig: {
+     *     aptosNetwork: Network.MAINNET,
+     *     solanaConfig: {
+     *       commitment: "confirmed", // ~0.5 s vs ~30 s
+     *     },
+     *   },
+     * });
+     */
+    commitment?: "confirmed" | "finalized";
   };
+  /**
+   * Custom RPC endpoints for EVM chains. When provided, these override the
+   * built-in `defaultRpc` values for balance lookups and Wormhole SDK
+   * initialization.
+   *
+   * @example
+   * ```ts
+   * evmConfig: {
+   *   Ethereum: { rpc: "https://rpc.ankr.com/eth/MY_KEY" },
+   *   Base: { rpc: "https://rpc.ankr.com/base/MY_KEY" },
+   * }
+   * ```
+   */
+  evmConfig?: Partial<Record<EvmChainName, { rpc: string }>>;
+  /**
+   * Custom RPC endpoint for the Sui chain. When provided, overrides the
+   * built-in `defaultRpc` for balance lookups and Wormhole SDK initialization.
+   *
+   * @example
+   * ```ts
+   * suiConfig: { rpc: "https://fullnode.mainnet.sui.io" }
+   * ```
+   */
+  suiConfig?: { rpc?: string };
 }
 export type { AccountAddressInput } from "@aptos-labs/ts-sdk";
 export { NetworkToChainId, NetworkToNodeAPI } from "@aptos-labs/ts-sdk";
@@ -78,6 +135,27 @@ export type Chain =
   | "Polygon"
   | "Sui";
 
+/**
+ * EVM chain names supported by the SDK — derived from {@link Chain} by
+ * excluding the non-EVM ecosystems. Adding a new EVM chain to `Chain`
+ * automatically makes it a valid key in `evmConfig`.
+ */
+export type EvmChainName = Exclude<Chain, "Solana" | "Aptos" | "Sui">;
+
+// Record ensures every EvmChainName key is present at compile time.
+const _evmChainRecord: Record<EvmChainName, true> = {
+  Ethereum: true,
+  Sepolia: true,
+  BaseSepolia: true,
+  ArbitrumSepolia: true,
+  Avalanche: true,
+  Base: true,
+  Arbitrum: true,
+  PolygonSepolia: true,
+  Polygon: true,
+};
+export const EVM_CHAIN_NAMES = Object.keys(_evmChainRecord) as EvmChainName[];
+
 // Map of Ethereum chain id to testnet chain config
 export const EthereumChainIdToTestnetChain: Record<string, ChainConfig> = {
   11155111: testnetChains.Sepolia!,
@@ -119,6 +197,14 @@ export class CrossChainCore {
   readonly CHAINS: ChainsConfig = testnetChains;
   readonly TOKENS: Record<string, TokenConfig> = testnetTokens;
 
+  /**
+   * Last known source-chain transaction ID, set by signers immediately after
+   * a transaction is submitted. Acts as a recovery side-channel so that
+   * callers can retrieve the tx hash even when the orchestration layer throws
+   * before returning it (e.g. claim failure after a successful burn).
+   */
+  _lastSourceChainTxId: string | undefined;
+
   constructor(args: { dappConfig: CrossChainDappConfig }) {
     this._dappConfig = args.dappConfig;
     if (args.dappConfig?.aptosNetwork === Network.MAINNET) {
@@ -181,14 +267,15 @@ export class CrossChainCore {
           walletAddress,
           this._dappConfig.aptosNetwork,
           sourceChain,
-          // TODO: maybe let the user config it
-          this.CHAINS[sourceChain].defaultRpc,
+          this._dappConfig?.evmConfig?.[sourceChain]?.rpc ??
+            this.CHAINS[sourceChain].defaultRpc,
         );
       case "Sui":
         return await getSuiWalletUSDCBalance(
           walletAddress,
           this._dappConfig.aptosNetwork,
-          this.CHAINS[sourceChain].defaultRpc,
+          this._dappConfig?.suiConfig?.rpc ??
+            this.CHAINS[sourceChain].defaultRpc,
         );
       default:
         throw new Error(`Unsupported chain: ${sourceChain}`);

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

@@ -3,7 +3,6 @@ import {
   AnyRawTransaction,
   Aptos,
   AptosConfig,
-  Network as AptosNetwork,
   Account,
 } from "@aptos-labs/ts-sdk";
 
@@ -18,8 +17,11 @@ import {
   AptosUnsignedTransaction,
   AptosChains,
 } from "@wormhole-foundation/sdk-aptos";
-import { GasStationApiKey } from "../types";
-import { isAccount } from "./AptosSigner";
+import {
+  OnTransactionSigned,
+  validateExpireTimestamp,
+} from "../types";
+import { CrossChainCore } from "../../../CrossChainCore";
 
 export class AptosLocalSigner<
   N extends Network,
@@ -28,21 +30,24 @@ export class AptosLocalSigner<
   _chain: C;
   _options: any;
   _wallet: Account;
-  _sponsorAccount: Account | GasStationApiKey | undefined;
+  _sponsorAccount: Account | undefined;
+  _onTransactionSigned: OnTransactionSigned | undefined;
+  _crossChainCore: CrossChainCore;
   _claimedTransactionHashes: string[] = [];
-  _dappNetwork: AptosNetwork;
   constructor(
     chain: C,
     options: any,
     wallet: Account,
-    feePayerAccount: Account | GasStationApiKey | undefined,
-    dappNetwork: AptosNetwork,
+    feePayerAccount: Account | undefined,
+    crossChainCore: CrossChainCore,
+    onTransactionSigned?: OnTransactionSigned,
   ) {
     this._chain = chain;
     this._options = options;
     this._wallet = wallet;
     this._sponsorAccount = feePayerAccount;
-    this._dappNetwork = dappNetwork;
+    this._crossChainCore = crossChainCore;
+    this._onTransactionSigned = onTransactionSigned;
   }
 
   chain(): C {
@@ -61,12 +66,14 @@ export class AptosLocalSigner<
     this._claimedTransactionHashes = [];
 
     for (const tx of txs) {
+      this._onTransactionSigned?.(tx.description, null);
       const txId = await signAndSendTransaction(
         tx as AptosUnsignedTransaction<Network, AptosChains>,
         this._wallet,
         this._sponsorAccount,
-        this._dappNetwork,
+        this._crossChainCore,
       );
+      this._onTransactionSigned?.(tx.description, txId);
       txHashes.push(txId);
       this._claimedTransactionHashes.push(txId);
     }
@@ -77,8 +84,8 @@ export class AptosLocalSigner<
 export async function signAndSendTransaction(
   request: UnsignedTransaction<Network, AptosChains>,
   wallet: Account,
-  sponsorAccount: Account | GasStationApiKey | undefined,
-  dappNetwork: AptosNetwork,
+  sponsorAccount: Account | undefined,
+  crossChainCore: CrossChainCore,
 ) {
   if (!wallet) {
     throw new Error("Wallet is undefined");
@@ -96,15 +103,23 @@ export async function signAndSendTransaction(
     }
   });
 
+  const dappNetwork = crossChainCore._dappConfig.aptosNetwork;
   const aptosConfig = new AptosConfig({
     network: dappNetwork,
   });
   const aptos = new Aptos(aptosConfig);
 
+  const expireTimestamp = crossChainCore._dappConfig.getExpireTimestamp?.();
+  if (typeof expireTimestamp !== "undefined") {
+    validateExpireTimestamp(expireTimestamp);
+  }
   const txnToSign = await aptos.transaction.build.simple({
     data: payload,
     sender: wallet.accountAddress.toString(),
     withFeePayer: sponsorAccount ? true : false,
+    ...(typeof expireTimestamp !== "undefined"
+      ? { options: { expireTimestamp } }
+      : {}),
   });
 
   const senderAuthenticator = await aptos.transaction.sign({
@@ -122,10 +137,8 @@ export async function signAndSendTransaction(
   };
 
   if (sponsorAccount) {
-    // Gas station is currently impossible to use, since the transactino we get from 
-    // Wormhole is a script transaction and gas station only supports entry function transactions
     const feePayerSignerAuthenticator = aptos.transaction.signAsFeePayer({
-      signer: sponsorAccount as Account,
+      signer: sponsorAccount,
       transaction: txnToSign,
     });
     txnToSubmit.feePayerAuthenticator = feePayerSignerAuthenticator;