@circle-fin/provider-cctp-v2 1.4.1 → 1.6.0

package/index.d.ts

@@ -499,6 +499,8 @@ declare enum Blockchain {
     Celo_Alfajores_Testnet = "Celo_Alfajores_Testnet",
     Codex = "Codex",
     Codex_Testnet = "Codex_Testnet",
+    Edge = "Edge",
+    Edge_Testnet = "Edge_Testnet",
     Ethereum = "Ethereum",
     Ethereum_Sepolia = "Ethereum_Sepolia",
     Hedera = "Hedera",
@@ -511,6 +513,8 @@ declare enum Blockchain {
     Linea_Sepolia = "Linea_Sepolia",
     Monad = "Monad",
     Monad_Testnet = "Monad_Testnet",
+    Morph = "Morph",
+    Morph_Testnet = "Morph_Testnet",
     NEAR = "NEAR",
     NEAR_Testnet = "NEAR_Testnet",
     Noble = "Noble",
@@ -661,6 +665,32 @@ interface EvmExecuteOverrides extends EvmEstimateOverrides {
      */
     nonce?: number;
 }
+/**
+ * Raw EVM call data tuple for a single contract interaction.
+ *
+ * Represents the minimal data needed to submit an EVM transaction:
+ * the target contract address, the ABI-encoded calldata, and an
+ * optional native token value. Used by EIP-5792 batched execution
+ * to compose multiple calls into a single `wallet_sendCalls` request.
+ *
+ * @interface EvmCallData
+ *
+ * @example
+ * ```typescript
+ * const callData: EvmCallData = {
+ *   to: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48',
+ *   data: '0x095ea7b3000000000000000000000000...',
+ * }
+ * ```
+ */
+interface EvmCallData {
+    /** The target contract address. */
+    to: `0x${string}`;
+    /** The ABI-encoded function calldata. */
+    data: `0x${string}`;
+    /** Optional native token value to send with the call. */
+    value?: bigint | undefined;
+}
 /**
  * Prepared contract execution for EVM chains.
  *
@@ -689,6 +719,28 @@ interface EvmPreparedChainRequest {
      * @throws If the execution fails
      */
     execute(overrides?: EvmExecuteOverrides): Promise<string>;
+    /**
+     * Return the raw call tuple without executing or estimating.
+     *
+     * Expose the `{ to, data, value }` triple that would be sent on-chain so
+     * callers can feed it into EIP-5792 `wallet_sendCalls` or other batching
+     * mechanisms. This method is optional -- adapters that do not support
+     * calldata extraction (e.g. Ethers v6) may omit it.
+     *
+     * @returns The raw EVM call data for this prepared request.
+     * @throws Never — synchronous accessor with no failure path.
+     * @since 2.0.0
+     *
+     * @example
+     * ```typescript
+     * const prepared = await adapter.prepare(params, ctx)
+     * if (prepared.getCallData) {
+     *   const { to, data, value } = prepared.getCallData()
+     *   console.log('Target:', to, 'Data:', data)
+     * }
+     * ```
+     */
+    getCallData?(): EvmCallData;
 }
 /**
  * Union type for all supported prepared contract executions.
@@ -4413,6 +4465,21 @@ interface BridgeStep {
      * - `undefined`: Not applicable (non-mint steps)
      */
     forwarded?: boolean;
+    /**
+     * Whether this step was executed as part of an EIP-5792 batched
+     * `wallet_sendCalls` request.
+     *
+     * - `true`: The step was included in a batched call bundle
+     * - `undefined`: The step was executed individually (sequential flow)
+     */
+    batched?: boolean | undefined;
+    /**
+     * The wallet-assigned batch identifier from `wallet_sendCalls`.
+     *
+     * Present only when {@link batched} is `true`. Can be used with
+     * `wallet_getCallsStatus` to query the status of the entire bundle.
+     */
+    batchId?: string | undefined;
     /** Optional human-readable error message */
     errorMessage?: string;
     /** Optional raw error object (can be Viem/Ethers/Chain error) */
@@ -4557,6 +4624,24 @@ interface BridgeConfig {
      * @defaultValue TransferSpeed.FAST
      */
     transferSpeed?: TransferSpeed | `${TransferSpeed}` | undefined;
+    /**
+     * Enable or disable EIP-5792 batched transaction execution.
+     *
+     * When `true` (or `undefined` / omitted), the bridge will attempt to batch
+     * the approve and burn calls into a single `wallet_sendCalls` request if
+     * the connected wallet supports it. Set to `false` to explicitly opt out
+     * and always use the sequential approve -> burn flow.
+     *
+     * @defaultValue `undefined` (batching attempted when the wallet supports it)
+     *
+     * @example
+     * ```typescript
+     * const config: BridgeConfig = {
+     *   batchTransactions: false, // force sequential flow
+     * }
+     * ```
+     */
+    batchTransactions?: boolean | undefined;
     /**
      * The maximum fee to pay for the burn operation.
      *