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

package/dist/CrossChainCore.d.ts

@@ -3,6 +3,17 @@ import { ChainsConfig, TokenConfig, ChainConfig } from "./config";
 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?: {
@@ -31,12 +42,69 @@ 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";
 export type AptosAccount = Account;
 export type Chain = "Solana" | "Ethereum" | "Sepolia" | "Aptos" | "BaseSepolia" | "ArbitrumSepolia" | "Avalanche" | "Base" | "Arbitrum" | "PolygonSepolia" | "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">;
+export declare const EVM_CHAIN_NAMES: EvmChainName[];
 export declare const EthereumChainIdToTestnetChain: Record<string, ChainConfig>;
 export declare const EthereumChainIdToMainnetChain: Record<string, ChainConfig>;
 export type CCTPProviders = "Wormhole";
@@ -49,6 +117,13 @@ export declare class CrossChainCore {
     readonly _dappConfig: CrossChainDappConfig;
     readonly CHAINS: ChainsConfig;
     readonly TOKENS: Record<string, TokenConfig>;
+    /**
+     * 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;
     });

package/dist/CrossChainCore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CrossChainCore.d.ts","sourceRoot":"","sources":["../src/CrossChainCore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAYtD,OAAO,EACL,YAAY,EAKZ,WAAW,EACX,WAAW,EACZ,MAAM,UAAU,CAAC;AAQlB,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,OAAO,CAAC;IACtB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,YAAY,CAAC,EAAE;QACb,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,iBAAiB,CAAC,EAAE;YAClB,UAAU,CAAC,EAAE,MAAM,CAAC;YACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;YAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;YACb,GAAG,CAAC,EAAE,MAAM,CAAC;SACd,CAAC;QACF;;;;;;;;;;;;;;;;;;WAkBG;QACH,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AACD,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACxE,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC;AAGnC,MAAM,MAAM,KAAK,GACb,QAAQ,GACR,UAAU,GACV,SAAS,GACT,OAAO,GACP,aAAa,GACb,iBAAiB,GACjB,WAAW,GACX,MAAM,GACN,UAAU,GACV,gBAAgB,GAChB,SAAS,GACT,KAAK,CAAC;AAGV,eAAO,MAAM,6BAA6B,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAMrE,CAAC;AAGF,eAAO,MAAM,6BAA6B,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAMrE,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC;AAEvC,MAAM,WAAW,kBAAkB,CACjC,aAAa,GAAG,GAAG,EACnB,cAAc,GAAG,GAAG,EACpB,gBAAgB,GAAG,GAAG,EACtB,iBAAiB,GAAG,GAAG,EACvB,gBAAgB,GAAG,GAAG,EACtB,iBAAiB,GAAG,GAAG;IAEvB,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACzD,QAAQ,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC/D,QAAQ,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAChE;AAED,qBAAa,cAAc;IACzB,QAAQ,CAAC,WAAW,EAAE,oBAAoB,CAExC;IAEF,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAiB;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAiB;gBAEjD,IAAI,EAAE;QAAE,UAAU,EAAE,oBAAoB,CAAA;KAAE;IAWtD,WAAW,CAAC,YAAY,EAAE,aAAa,GAAG,kBAAkB;IAgBtD,oBAAoB,CACxB,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,KAAK,GACjB,OAAO,CAAC,MAAM,CAAC;CA6CnB"}
+{"version":3,"file":"CrossChainCore.d.ts","sourceRoot":"","sources":["../src/CrossChainCore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAYtD,OAAO,EACL,YAAY,EAKZ,WAAW,EACX,WAAW,EACZ,MAAM,UAAU,CAAC;AAQlB,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,OAAO,CAAC;IACtB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;;;;;;;OASG;IACH,kBAAkB,CAAC,EAAE,MAAM,MAAM,CAAC;IAClC,YAAY,CAAC,EAAE;QACb,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,iBAAiB,CAAC,EAAE;YAClB,UAAU,CAAC,EAAE,MAAM,CAAC;YACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;YAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;YACb,GAAG,CAAC,EAAE,MAAM,CAAC;SACd,CAAC;QACF;;;;;;;;;;;;;;;;;;WAkBG;QACH,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB;;;;;;;;;;;;;;;;;;;;WAoBG;QACH,UAAU,CAAC,EAAE,WAAW,GAAG,WAAW,CAAC;KACxC,CAAC;IACF;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IAC3D;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9B;AACD,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACxE,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC;AAGnC,MAAM,MAAM,KAAK,GACb,QAAQ,GACR,UAAU,GACV,SAAS,GACT,OAAO,GACP,aAAa,GACb,iBAAiB,GACjB,WAAW,GACX,MAAM,GACN,UAAU,GACV,gBAAgB,GAChB,SAAS,GACT,KAAK,CAAC;AAEV;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,GAAG,KAAK,CAAC,CAAC;AActE,eAAO,MAAM,eAAe,EAAmC,YAAY,EAAE,CAAC;AAG9E,eAAO,MAAM,6BAA6B,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAMrE,CAAC;AAGF,eAAO,MAAM,6BAA6B,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAMrE,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC;AAEvC,MAAM,WAAW,kBAAkB,CACjC,aAAa,GAAG,GAAG,EACnB,cAAc,GAAG,GAAG,EACpB,gBAAgB,GAAG,GAAG,EACtB,iBAAiB,GAAG,GAAG,EACvB,gBAAgB,GAAG,GAAG,EACtB,iBAAiB,GAAG,GAAG;IAEvB,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACzD,QAAQ,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC/D,QAAQ,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAChE;AAED,qBAAa,cAAc;IACzB,QAAQ,CAAC,WAAW,EAAE,oBAAoB,CAExC;IAEF,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAiB;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAiB;IAE7D;;;;;OAKG;IACH,oBAAoB,EAAE,MAAM,GAAG,SAAS,CAAC;gBAE7B,IAAI,EAAE;QAAE,UAAU,EAAE,oBAAoB,CAAA;KAAE;IAWtD,WAAW,CAAC,YAAY,EAAE,aAAa,GAAG,kBAAkB;IAgBtD,oBAAoB,CACxB,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,KAAK,GACjB,OAAO,CAAC,MAAM,CAAC;CA8CnB"}