@circle-fin/app-kit 1.13.0 → 1.15.0

package/earn.mjs

@@ -28,7 +28,7 @@ if (typeof window !== 'undefined' && typeof window.Buffer === 'undefined') {
 
 
 import { z } from 'zod';
-import 'pino';
+import pino from 'pino';
 import '@ethersproject/bytes';
 import '@ethersproject/abi';
 import '@ethersproject/address';
@@ -859,8 +859,7 @@ class KitError extends Error {
         code: 8002,
         name: 'SERVICE_UNKNOWN_ERROR',
         type: 'SERVICE'
-    }
-};
+    }};
 
 /**
  * Creates error for network type mismatch between source and destination.
@@ -1047,7 +1046,7 @@ class KitError extends Error {
  * import { createValidationErrorFromZod } from '@core/errors'
  *
  * function validateBridgeParams(params: unknown): asserts params is BridgeParams {
- *   const result = bridgeParamsSchema.safeParse(params)
+ *   const result = usdcBridgeParamsSchema.safeParse(params)
  *   if (!result.success) {
  *     throw createValidationErrorFromZod(result.error, 'bridge parameters')
  *   }
@@ -2308,9 +2307,10 @@ function getOptionalString(value) {
     Blockchain["Algorand_Testnet"] = "Algorand_Testnet";
     Blockchain["Aptos"] = "Aptos";
     Blockchain["Aptos_Testnet"] = "Aptos_Testnet";
-    Blockchain["Arc_Testnet"] = "Arc_Testnet";
     Blockchain["Arbitrum"] = "Arbitrum";
     Blockchain["Arbitrum_Sepolia"] = "Arbitrum_Sepolia";
+    Blockchain["Arc"] = "Arc";
+    Blockchain["Arc_Testnet"] = "Arc_Testnet";
     Blockchain["Avalanche"] = "Avalanche";
     Blockchain["Avalanche_Fuji"] = "Avalanche_Fuji";
     Blockchain["Base"] = "Base";
@@ -2397,6 +2397,7 @@ var SwapChain;
     SwapChain["XDC"] = "XDC";
     SwapChain["HyperEVM"] = "HyperEVM";
     SwapChain["Monad"] = "Monad";
+    SwapChain["Arc"] = "Arc";
     // Testnet chains with swap support
     SwapChain["Arc_Testnet"] = "Arc_Testnet";
 })(SwapChain || (SwapChain = {}));
@@ -2404,6 +2405,7 @@ var BridgeChain;
 (function(BridgeChain) {
     // Mainnet chains with CCTPv2 support
     BridgeChain["Arbitrum"] = "Arbitrum";
+    BridgeChain["Arc"] = "Arc";
     BridgeChain["Avalanche"] = "Avalanche";
     BridgeChain["Base"] = "Base";
     BridgeChain["Codex"] = "Codex";
@@ -2459,6 +2461,7 @@ var BridgeChain;
 var UnifiedBalanceChain;
 (function(UnifiedBalanceChain) {
     // Mainnet chains with Gateway V1 support
+    UnifiedBalanceChain["Arc"] = "Arc";
     UnifiedBalanceChain["Arbitrum"] = "Arbitrum";
     UnifiedBalanceChain["Avalanche"] = "Avalanche";
     UnifiedBalanceChain["Base"] = "Base";
@@ -2488,6 +2491,7 @@ var UnifiedBalanceChain;
 })(UnifiedBalanceChain || (UnifiedBalanceChain = {}));
 var EarnChain;
 (function(EarnChain) {
+    EarnChain["Arc"] = "Arc";
     EarnChain["Arc_Testnet"] = "Arc_Testnet";
 })(EarnChain || (EarnChain = {}));
 /**
@@ -2504,8 +2508,11 @@ var EarnChain;
  * console.log(EARN_BRIDGE_SOURCE_BLOCKCHAINS.join(', '))
  * ```
  */ const EARN_BRIDGE_SOURCE_BLOCKCHAINS = [
+    "Arbitrum",
     "Arbitrum_Sepolia",
+    "Base",
     "Base_Sepolia",
+    "Ethereum",
     "Ethereum_Sepolia"
 ];
 /**
@@ -2519,6 +2526,7 @@ var EarnChain;
  * console.log(EARN_BRIDGE_DESTINATION_BLOCKCHAINS.join(', '))
  * ```
  */ const EARN_BRIDGE_DESTINATION_BLOCKCHAINS = [
+    "Arc",
     "Arc_Testnet"
 ];
 
@@ -2824,6 +2832,25 @@ var EarnChain;
  * EVM-compatible chains. Use this address when deploying or testing
  * cross-chain USDC transfers on test networks.
  */ const BRIDGE_CONTRACT_EVM_TESTNET = '0xC5567a5E3370d4DBfB0540025078e283e36A363d';
+/**
+ * The CrossChainTokenService (CCTPx) service address for EVM testnet networks.
+ *
+ * This service coordinates CCTPx cross-chain token operations on testnet
+ * environments and is shared by every EVM test network CCTPx supports. Read the
+ * chain definitions via `isCCTPXSupported` rather than trusting a list here,
+ * which goes stale as deployments land.
+ */ const CCTPX_SERVICE_ADDRESS_EVM_TESTNET = '0x63753E722bd2C2A5DF6EE19C5106662208B81077';
+/**
+ * CrossChainTokenService (CCTS) proxy address for CCTPx on EVM **mainnet**.
+ *
+ * @remarks
+ * A distinct deployment from {@link CCTPX_SERVICE_ADDRESS_EVM_TESTNET}, shared
+ * by every EVM mainnet chain that CCTPx supports. A chain becomes
+ * CCTPx-eligible only once its definition carries this as
+ * `cctpx.serviceAddress`, and a route additionally needs both of its endpoints
+ * eligible — so adding a chain here is the deliberate, reviewable step that
+ * opens mainnet CCTPx for it.
+ */ const CCTPX_SERVICE_ADDRESS_EVM_MAINNET = '0x431871229103b780868f8C6BB820cd16ECf942BC';
 /**
  * The bridge contract address for EVM mainnet networks.
  *
@@ -2892,8 +2919,115 @@ var EarnChain;
  * This program handles minting operations for Gateway transactions
  * on Solana devnet.
  */ const GATEWAY_MINTER_SOLANA_DEVNET = 'GATEmKK2ECL1brEngQZWCgMWPbvrEYqsV6u29dAaHavr';
-/** TokenMessengerWithFees address shared by enabled EVM mainnet sources. */ const TOKEN_MESSENGER_WITH_FEES_EVM_MAINNET = '0x71f54F818671cD0D7ea140Da213e5C8b5C92a408';
-/** TokenMessengerWithFees address shared by enabled EVM testnet sources. */ const TOKEN_MESSENGER_WITH_FEES_EVM_TESTNET = '0x8745D906D67C346E5eb1aEEED38Eb87F34DF0C0A';
+/**
+ * The `TokenMessengerWithFees` proxy contract address for EVM mainnet networks
+ * (all chains except Edge).
+ *
+ * Deployed at a CREATE3-derived address; identical across all mainnet EVM
+ * source chains. Present on any chain that supports the prepaid FORWARD path
+ * via `depositForBurnWithHookAndFees`.
+ */ const TOKEN_MESSENGER_WITH_FEES_EVM_MAINNET = '0x71f54F818671cD0D7ea140Da213e5C8b5C92a408';
+/**
+ * The `TokenMessengerWithFees` proxy contract address for EVM testnet networks.
+ *
+ * Identical across all testnet EVM source chains. Present on any testnet chain
+ * that supports the prepaid FORWARD path via `depositForBurnWithHookAndFees`.
+ */ const TOKEN_MESSENGER_WITH_FEES_EVM_TESTNET = '0x8745D906D67C346E5eb1aEEED38Eb87F34DF0C0A';
+/**
+ * The `DepositForHandler` proxy contract address for EVM mainnet networks.
+ *
+ * The handler the GenericExecutor calls on a fast-deposit destination chain to
+ * run a cross-chain deposit into the GatewayWallet. Deployed at the same
+ * address across all mainnet EVM destination chains.
+ */ const DEPOSIT_FOR_HANDLER_EVM_MAINNET = '0x16529813203f77E036576666336554a1210dce4D';
+/**
+ * The `DepositForHandler` proxy contract address for EVM testnet networks.
+ *
+ * Identical across all testnet EVM destination chains.
+ */ const DEPOSIT_FOR_HANDLER_EVM_TESTNET = '0xD05E7D2E7d30b92c5F17d7d0fC575fce231F1A48';
+/**
+ * The `GenericExecutor` proxy contract address for EVM mainnet networks.
+ *
+ * The GenericExecutor is the `mintRecipient` and `destinationCaller` on the
+ * destination chain for the CCTP v2 prepaid FORWARD path. It receives the CCTP
+ * mint and calls the `DepositForHandler` to complete the fast deposit.
+ * Deployed at the same address across all mainnet EVM destination chains.
+ */ const GENERIC_EXECUTOR_EVM_MAINNET = '0xFa7be2f04F3Ad4ca969260729c6d45B5625984A7';
+/**
+ * The `GenericExecutor` proxy contract address for EVM testnet networks.
+ *
+ * Identical across all testnet EVM destination chains.
+ */ const GENERIC_EXECUTOR_EVM_TESTNET = '0xEdC81040756AcCfF070c21D37b265b9D0b5Ba45e';
+
+/**
+ * Arc Mainnet chain definition
+ * @remarks
+ * This represents the official production network for the Arc blockchain,
+ * Circle's EVM-compatible Layer-1 designed for stablecoin finance
+ * and asset tokenization. Arc uses USDC as the native gas token and
+ * features the Malachite Byzantine Fault Tolerant (BFT) consensus
+ * engine for sub-second finality.
+ */ const Arc = defineChain({
+    type: 'evm',
+    chain: Blockchain.Arc,
+    name: 'Arc',
+    title: 'Arc Mainnet',
+    nativeCurrency: {
+        name: 'USDC',
+        symbol: 'USDC',
+        // Arc uses native USDC with 18 decimals for gas payments (EVM standard).
+        // Note: The ERC-20 USDC contract at usdcAddress uses 6 decimals.
+        // See: https://docs.arc.network/arc/references/contract-addresses
+        decimals: 18
+    },
+    chainId: 5042,
+    isTestnet: false,
+    explorerUrl: 'https://explorer.arc.io/tx/{hash}',
+    rpcEndpoints: [
+        'https://rpc.mainnet.arc.io/'
+    ],
+    eurcAddress: '0xbEf5f6d51CB62b58e6A8f77868681825C6fe21c1',
+    usdcAddress: '0x3600000000000000000000000000000000000000',
+    usdtAddress: null,
+    cctp: {
+        domain: 26,
+        contracts: {
+            v2: {
+                type: 'split',
+                tokenMessenger: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
+                messageTransmitter: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
+                confirmations: 1,
+                fastConfirmations: 1
+            }
+        },
+        forwarderSupported: {
+            source: false,
+            destination: true
+        }
+    },
+    cctpx: {
+        serviceAddress: CCTPX_SERVICE_ADDRESS_EVM_MAINNET
+    },
+    kitContracts: {
+        bridge: BRIDGE_CONTRACT_EVM_MAINNET,
+        adapter: ADAPTER_CONTRACT_EVM_MAINNET
+    },
+    gateway: {
+        domain: 26,
+        contracts: {
+            v1: {
+                wallet: GATEWAY_WALLET_EVM_MAINNET,
+                minter: GATEWAY_MINTER_EVM_MAINNET,
+                depositForHandler: DEPOSIT_FOR_HANDLER_EVM_MAINNET,
+                genericExecutor: GENERIC_EXECUTOR_EVM_MAINNET
+            }
+        },
+        forwarderSupported: {
+            source: true,
+            destination: true
+        }
+    }
+});
 
 /**
  * Arc Testnet chain definition
@@ -2942,6 +3076,9 @@ var EarnChain;
             destination: true
         }
     },
+    cctpx: {
+        serviceAddress: CCTPX_SERVICE_ADDRESS_EVM_TESTNET
+    },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_TESTNET,
         adapter: ADAPTER_CONTRACT_EVM_TESTNET
@@ -2952,9 +3089,8 @@ var EarnChain;
             v1: {
                 wallet: GATEWAY_WALLET_EVM_TESTNET,
                 minter: GATEWAY_MINTER_EVM_TESTNET,
-                // DepositForHandler the GenericExecutor calls to run a fast cross-chain
-                // deposit into the GatewayWallet above.
-                depositForHandler: '0xD05E7D2E7d30b92c5F17d7d0fC575fce231F1A48'
+                depositForHandler: DEPOSIT_FOR_HANDLER_EVM_TESTNET,
+                genericExecutor: GENERIC_EXECUTOR_EVM_TESTNET
             }
         },
         forwarderSupported: {
@@ -3010,6 +3146,9 @@ var EarnChain;
             destination: true
         }
     },
+    cctpx: {
+        serviceAddress: CCTPX_SERVICE_ADDRESS_EVM_MAINNET
+    },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_MAINNET,
         adapter: ADAPTER_CONTRACT_EVM_MAINNET
@@ -3075,6 +3214,9 @@ var EarnChain;
             destination: true
         }
     },
+    cctpx: {
+        serviceAddress: CCTPX_SERVICE_ADDRESS_EVM_TESTNET
+    },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_TESTNET,
         adapter: ADAPTER_CONTRACT_EVM_TESTNET
@@ -3140,6 +3282,9 @@ var EarnChain;
             destination: true
         }
     },
+    cctpx: {
+        serviceAddress: CCTPX_SERVICE_ADDRESS_EVM_MAINNET
+    },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_MAINNET,
         adapter: ADAPTER_CONTRACT_EVM_MAINNET
@@ -3149,7 +3294,9 @@ var EarnChain;
         contracts: {
             v1: {
                 wallet: GATEWAY_WALLET_EVM_MAINNET,
-                minter: GATEWAY_MINTER_EVM_MAINNET
+                minter: GATEWAY_MINTER_EVM_MAINNET,
+                depositForHandler: DEPOSIT_FOR_HANDLER_EVM_MAINNET,
+                genericExecutor: GENERIC_EXECUTOR_EVM_MAINNET
             }
         },
         forwarderSupported: {
@@ -3205,6 +3352,9 @@ var EarnChain;
     rpcEndpoints: [
         'https://api.avax-test.network/ext/bc/C/rpc'
     ],
+    cctpx: {
+        serviceAddress: CCTPX_SERVICE_ADDRESS_EVM_TESTNET
+    },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_TESTNET
     },
@@ -3213,7 +3363,9 @@ var EarnChain;
         contracts: {
             v1: {
                 wallet: GATEWAY_WALLET_EVM_TESTNET,
-                minter: GATEWAY_MINTER_EVM_TESTNET
+                minter: GATEWAY_MINTER_EVM_TESTNET,
+                depositForHandler: DEPOSIT_FOR_HANDLER_EVM_TESTNET,
+                genericExecutor: GENERIC_EXECUTOR_EVM_TESTNET
             }
         },
         forwarderSupported: {
@@ -3270,6 +3422,9 @@ var EarnChain;
             destination: true
         }
     },
+    cctpx: {
+        serviceAddress: CCTPX_SERVICE_ADDRESS_EVM_MAINNET
+    },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_MAINNET,
         adapter: ADAPTER_CONTRACT_EVM_MAINNET
@@ -3335,6 +3490,9 @@ var EarnChain;
             destination: true
         }
     },
+    cctpx: {
+        serviceAddress: CCTPX_SERVICE_ADDRESS_EVM_TESTNET
+    },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_TESTNET,
         adapter: ADAPTER_CONTRACT_EVM_TESTNET
@@ -3526,6 +3684,7 @@ var EarnChain;
             v2: {
                 type: 'split',
                 tokenMessenger: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
+                tokenMessengerWithFees: TOKEN_MESSENGER_WITH_FEES_EVM_MAINNET,
                 messageTransmitter: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
                 confirmations: 1,
                 fastConfirmations: 1
@@ -3571,6 +3730,7 @@ var EarnChain;
             v2: {
                 type: 'split',
                 tokenMessenger: '0x8FE6B999Dc680CcFDD5Bf7EB0974218be2542DAA',
+                tokenMessengerWithFees: TOKEN_MESSENGER_WITH_FEES_EVM_TESTNET,
                 messageTransmitter: '0xE737e5cEBEEBa77EFE34D4aa090756590b1CE275',
                 confirmations: 1,
                 fastConfirmations: 1
@@ -3616,6 +3776,7 @@ var EarnChain;
             v2: {
                 type: 'split',
                 tokenMessenger: '0x98706A006bc632Df31CAdFCBD43F38887ce2ca5c',
+                tokenMessengerWithFees: '0x3Ac96675F9a3E6922713e041645D82f3561d3686',
                 messageTransmitter: '0x5b61381Fc9e58E70EfC13a4A97516997019198ee',
                 confirmations: 65,
                 fastConfirmations: 1
@@ -3661,6 +3822,7 @@ var EarnChain;
             v2: {
                 type: 'split',
                 tokenMessenger: '0x8FE6B999Dc680CcFDD5Bf7EB0974218be2542DAA',
+                tokenMessengerWithFees: TOKEN_MESSENGER_WITH_FEES_EVM_TESTNET,
                 messageTransmitter: '0xE737e5cEBEEBa77EFE34D4aa090756590b1CE275',
                 confirmations: 65,
                 fastConfirmations: 1
@@ -3723,6 +3885,9 @@ var EarnChain;
             destination: true
         }
     },
+    cctpx: {
+        serviceAddress: CCTPX_SERVICE_ADDRESS_EVM_MAINNET
+    },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_MAINNET,
         adapter: ADAPTER_CONTRACT_EVM_MAINNET
@@ -3788,6 +3953,9 @@ var EarnChain;
             destination: true
         }
     },
+    cctpx: {
+        serviceAddress: CCTPX_SERVICE_ADDRESS_EVM_TESTNET
+    },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_TESTNET,
         adapter: ADAPTER_CONTRACT_EVM_TESTNET
@@ -4009,6 +4177,7 @@ var EarnChain;
             v2: {
                 type: 'split',
                 tokenMessenger: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
+                tokenMessengerWithFees: TOKEN_MESSENGER_WITH_FEES_EVM_MAINNET,
                 messageTransmitter: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
                 confirmations: 1,
                 fastConfirmations: 1
@@ -4056,6 +4225,7 @@ var EarnChain;
             v2: {
                 type: 'split',
                 tokenMessenger: '0x8FE6B999Dc680CcFDD5Bf7EB0974218be2542DAA',
+                tokenMessengerWithFees: TOKEN_MESSENGER_WITH_FEES_EVM_TESTNET,
                 messageTransmitter: '0xE737e5cEBEEBa77EFE34D4aa090756590b1CE275',
                 confirmations: 1,
                 fastConfirmations: 1
@@ -4337,6 +4507,7 @@ var EarnChain;
             v2: {
                 type: 'split',
                 tokenMessenger: '0x8FE6B999Dc680CcFDD5Bf7EB0974218be2542DAA',
+                tokenMessengerWithFees: TOKEN_MESSENGER_WITH_FEES_EVM_TESTNET,
                 messageTransmitter: '0xE737e5cEBEEBa77EFE34D4aa090756590b1CE275',
                 confirmations: 1,
                 fastConfirmations: 1
@@ -4382,6 +4553,7 @@ var EarnChain;
             v2: {
                 type: 'split',
                 tokenMessenger: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
+                tokenMessengerWithFees: TOKEN_MESSENGER_WITH_FEES_EVM_MAINNET,
                 messageTransmitter: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
                 confirmations: 64,
                 fastConfirmations: 1
@@ -4427,6 +4599,7 @@ var EarnChain;
             v2: {
                 type: 'split',
                 tokenMessenger: '0x8FE6B999Dc680CcFDD5Bf7EB0974218be2542DAA',
+                tokenMessengerWithFees: TOKEN_MESSENGER_WITH_FEES_EVM_TESTNET,
                 messageTransmitter: '0xE737e5cEBEEBa77EFE34D4aa090756590b1CE275',
                 confirmations: 64,
                 fastConfirmations: 1
@@ -4614,6 +4787,9 @@ var EarnChain;
             destination: true
         }
     },
+    cctpx: {
+        serviceAddress: CCTPX_SERVICE_ADDRESS_EVM_MAINNET
+    },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_MAINNET,
         adapter: ADAPTER_CONTRACT_EVM_MAINNET
@@ -4679,6 +4855,9 @@ var EarnChain;
             destination: true
         }
     },
+    cctpx: {
+        serviceAddress: CCTPX_SERVICE_ADDRESS_EVM_TESTNET
+    },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_TESTNET
     },
@@ -4728,6 +4907,7 @@ var EarnChain;
             v2: {
                 type: 'split',
                 tokenMessenger: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
+                tokenMessengerWithFees: TOKEN_MESSENGER_WITH_FEES_EVM_MAINNET,
                 messageTransmitter: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
                 confirmations: 1,
                 fastConfirmations: 1
@@ -4774,6 +4954,7 @@ var EarnChain;
             v2: {
                 type: 'split',
                 tokenMessenger: '0x8FE6B999Dc680CcFDD5Bf7EB0974218be2542DAA',
+                tokenMessengerWithFees: TOKEN_MESSENGER_WITH_FEES_EVM_TESTNET,
                 messageTransmitter: '0xE737e5cEBEEBa77EFE34D4aa090756590b1CE275',
                 confirmations: 1,
                 fastConfirmations: 1
@@ -5072,6 +5253,9 @@ var EarnChain;
             destination: true
         }
     },
+    cctpx: {
+        serviceAddress: CCTPX_SERVICE_ADDRESS_EVM_MAINNET
+    },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_MAINNET,
         adapter: ADAPTER_CONTRACT_EVM_MAINNET
@@ -5081,7 +5265,9 @@ var EarnChain;
         contracts: {
             v1: {
                 wallet: GATEWAY_WALLET_EVM_MAINNET,
-                minter: GATEWAY_MINTER_EVM_MAINNET
+                minter: GATEWAY_MINTER_EVM_MAINNET,
+                depositForHandler: DEPOSIT_FOR_HANDLER_EVM_MAINNET,
+                genericExecutor: GENERIC_EXECUTOR_EVM_MAINNET
             }
         },
         forwarderSupported: {
@@ -5138,6 +5324,9 @@ var EarnChain;
             destination: true
         }
     },
+    cctpx: {
+        serviceAddress: CCTPX_SERVICE_ADDRESS_EVM_TESTNET
+    },
     kitContracts: {
         bridge: BRIDGE_CONTRACT_EVM_TESTNET
     },
@@ -5146,7 +5335,9 @@ var EarnChain;
         contracts: {
             v1: {
                 wallet: GATEWAY_WALLET_EVM_TESTNET,
-                minter: GATEWAY_MINTER_EVM_TESTNET
+                minter: GATEWAY_MINTER_EVM_TESTNET,
+                depositForHandler: DEPOSIT_FOR_HANDLER_EVM_TESTNET,
+                genericExecutor: GENERIC_EXECUTOR_EVM_TESTNET
             }
         },
         forwarderSupported: {
@@ -6144,6 +6335,7 @@ var Chains = /*#__PURE__*/Object.freeze({
   AptosTestnet: AptosTestnet,
   Arbitrum: Arbitrum,
   ArbitrumSepolia: ArbitrumSepolia,
+  Arc: Arc,
   ArcTestnet: ArcTestnet,
   Avalanche: Avalanche,
   AvalancheFuji: AvalancheFuji,
@@ -6232,6 +6424,67 @@ var Chains = /*#__PURE__*/Object.freeze({
     return chain.cctp?.contracts.v2 !== undefined;
 }
 
+/**
+ * Chains the Fee Service accepts as a SOURCE for source-paid ("receive-exact")
+ * CCTP v2 fees. An explicit allowlist is required because the
+ * `TokenMessengerWithFees` wrapper address is now shared with the fast-deposit
+ * forwarder path, so wrapper presence no longer implies source-fee support.
+ * Keep in sync with backend coverage.
+ */ new Set([
+    // Mainnet
+    Blockchain.Ethereum,
+    Blockchain.Base,
+    Blockchain.Arbitrum,
+    Blockchain.Unichain,
+    Blockchain.Optimism,
+    Blockchain.Codex,
+    Blockchain.Ink,
+    Blockchain.Plume,
+    Blockchain.Linea,
+    Blockchain.World_Chain,
+    // Testnet counterparts
+    Blockchain.Ethereum_Sepolia,
+    Blockchain.Base_Sepolia,
+    Blockchain.Arbitrum_Sepolia,
+    Blockchain.Unichain_Sepolia,
+    Blockchain.Optimism_Sepolia,
+    Blockchain.Codex_Testnet,
+    Blockchain.Ink_Testnet,
+    Blockchain.Plume_Testnet,
+    Blockchain.Linea_Sepolia,
+    Blockchain.World_Chain_Sepolia
+]);
+
+/**
+ * Temporary allowlist of chains permitted to initiate Gateway fast deposits.
+ * Only chains keyed here are eligible; all others are rejected. Using the
+ * {@link Blockchain} enum keeps entries type-safe and catches typos at compile
+ * time. Remove this allowlist once roll-out is complete.
+ */ new Set([
+    // Mainnet
+    Blockchain.Ethereum,
+    Blockchain.Base,
+    Blockchain.Arbitrum,
+    Blockchain.Unichain,
+    Blockchain.Optimism,
+    Blockchain.Codex,
+    Blockchain.Ink,
+    Blockchain.Plume,
+    Blockchain.Linea,
+    Blockchain.World_Chain,
+    // Testnet counterparts
+    Blockchain.Ethereum_Sepolia,
+    Blockchain.Base_Sepolia,
+    Blockchain.Arbitrum_Sepolia,
+    Blockchain.Unichain_Sepolia,
+    Blockchain.Optimism_Sepolia,
+    Blockchain.Codex_Testnet,
+    Blockchain.Ink_Testnet,
+    Blockchain.Plume_Testnet,
+    Blockchain.Linea_Sepolia,
+    Blockchain.World_Chain_Sepolia
+]);
+
 /**
  * Zod schema for validating Gateway v1 contract addresses.
  *
@@ -6253,7 +6506,10 @@ var Chains = /*#__PURE__*/Object.freeze({
     }).min(1, 'Gateway minter address cannot be empty.'),
     depositForHandler: z.string({
         invalid_type_error: 'Gateway depositForHandler address must be a string.'
-    }).min(1, 'Gateway depositForHandler address cannot be empty.').optional()
+    }).min(1, 'Gateway depositForHandler address cannot be empty.').optional(),
+    genericExecutor: z.string({
+        invalid_type_error: 'Gateway genericExecutor address must be a string.'
+    }).min(1, 'Gateway genericExecutor address cannot be empty.').optional()
 }).strict() // Reject any additional properties not defined in the schema
 ;
 /**
@@ -6337,6 +6593,7 @@ var Chains = /*#__PURE__*/Object.freeze({
     usdcAddress: z.string().nullable(),
     usdtAddress: z.string().nullable(),
     cctp: z.any().nullable(),
+    cctpx: z.any().optional(),
     kitContracts: z.object({
         bridge: z.string().optional(),
         adapter: z.string().optional()
@@ -6542,14 +6799,15 @@ const EARN_BRIDGE_DESTINATION_CHAIN_VALUES = EARN_BRIDGE_DESTINATION_BLOCKCHAINS
  * Zod schema for validating the source chain of a cross-chain Earn deposit.
  *
  * Accept a supported source Blockchain value, a matching string literal, or a
- * ChainDefinition for a supported source chain. Source chains are Ethereum
- * Sepolia, Arbitrum Sepolia, and Base Sepolia.
+ * ChainDefinition for a supported source chain. Source chains are Ethereum,
+ * Arbitrum, and Base (mainnet and testnet).
  *
  * @example
  * ```typescript
  * import { earnBridgeSourceChainIdentifierSchema } from '@core/chains'
  *
  * // Valid
+ * earnBridgeSourceChainIdentifierSchema.parse('Ethereum')
  * earnBridgeSourceChainIdentifierSchema.parse('Ethereum_Sepolia')
  *
  * // Invalid (throws ZodError)
@@ -6568,14 +6826,15 @@ const EARN_BRIDGE_DESTINATION_CHAIN_VALUES = EARN_BRIDGE_DESTINATION_BLOCKCHAINS
  * deposit.
  *
  * Accept a supported destination Blockchain value, a matching string literal,
- * or a ChainDefinition for a supported destination chain. Currently only Arc
- * Testnet is supported.
+ * or a ChainDefinition for a supported destination chain. Arc (mainnet) and
+ * Arc Testnet are supported.
  *
  * @example
  * ```typescript
  * import { earnBridgeDestinationChainIdentifierSchema } from '@core/chains'
  *
  * // Valid
+ * earnBridgeDestinationChainIdentifierSchema.parse('Arc')
  * earnBridgeDestinationChainIdentifierSchema.parse('Arc_Testnet')
  *
  * // Invalid (throws ZodError)
@@ -7621,6 +7880,7 @@ const swapTokenEnumSchema = z.enum([
         // Mainnets (alphabetically sorted)
         // =========================================================================
         [Blockchain.Arbitrum]: '0xaf88d065e77c8cC2239327C5EDb3A432268e5831',
+        [Blockchain.Arc]: '0x3600000000000000000000000000000000000000',
         [Blockchain.Avalanche]: '0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E',
         [Blockchain.Base]: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
         [Blockchain.Celo]: '0xcebA9300f2b948710d2653dD7B07f33A8B32118C',
@@ -7735,6 +7995,7 @@ const swapTokenEnumSchema = z.enum([
         // =========================================================================
         // Mainnets
         // =========================================================================
+        [Blockchain.Arc]: '0xbEf5f6d51CB62b58e6A8f77868681825C6fe21c1',
         [Blockchain.Avalanche]: '0xc891EB4cbdEFf6e073e859e987815Ed1505c2ACD',
         [Blockchain.Base]: '0x60a3E35Cc302bFA44Cb288Bc5a4F316Fdb1adb42',
         [Blockchain.Cronos]: '0xA6dE01a2d62C6B5f3525d768f34d276652C554c8',
@@ -7978,6 +8239,7 @@ const swapTokenEnumSchema = z.enum([
         // =========================================================================
         // Mainnets
         // =========================================================================
+        [Blockchain.Arc]: '0x171A4217b86A807A64eB94757Db6849fb4bDbAA0',
         [Blockchain.Ethereum]: '0x72DFB2E44f59C5AD2bAFE84314E5b99a7cd5075E',
         // =========================================================================
         // Testnets
@@ -8070,13 +8332,28 @@ const swapTokenEnumSchema = z.enum([
 }
 
 /**
- * Check if a selector is a raw token selector (object form).
+ * Type guard: narrows a {@link TokenSelector} to a {@link RawTokenSelector}.
  *
  * @param selector - The token selector to check.
- * @returns True if the selector is a raw token selector.
+ * @returns `true` if `selector` is a raw token selector (object with `locator`).
+ *
+ * @example
+ * ```typescript
+ * if (isRawSelector(selector)) {
+ *   console.log(selector.locator)
+ * }
+ * ```
  */ function isRawSelector(selector) {
-    return typeof selector === 'object' && 'locator' in selector;
+    // `typeof null === 'object'` (a JS quirk) and `'locator' in null`
+    // throws, so the explicit `null` check is required at this exported
+    // guard for JS consumers passing nullish values. The lint rule sees
+    // the parameter typed as `TokenSelector` (no null) and flags the
+    // check as unnecessary — disabled because the check IS necessary at
+    // runtime even though TypeScript can prove it dead statically.
+    return typeof selector === 'object' && // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+    selector !== null && 'locator' in selector;
 }
+
 /**
  * Normalize a symbol to uppercase for case-insensitive lookup.
  *
@@ -8264,7 +8541,7 @@ const swapTokenEnumSchema = z.enum([
             if (typeof selector === 'string') {
                 return resolveSymbol(selector, chainId);
             }
-            throw createTokenResolutionError(`Invalid selector type: ${typeof selector}. Expected string or object with locator.`, selector, chainId);
+            throw createTokenResolutionError(`Invalid selector type: ${typeof selector}. Expected a token symbol or a raw selector (with locator).`, selector, chainId);
         },
         resolveByAddress (address, chainId) {
             if (!address || typeof address !== 'string') {
@@ -8467,7 +8744,7 @@ const swapTokenEnumSchema = z.enum([
  * allowlisted {@link ClientLogPayload} fields (and the allowlisted
  * sub-fields of `errorDetails` / `clientContext`) are copied across.
  * A regressing upstream mapper — or a plain-JS caller that bypasses the
- * type — therefore cannot exfiltrate stray properties (secrets, PII,
+ * type — therefore cannot exfiltrate stray properties (secrets,
  * raw error stacks) through the analytics channel. Optional fields are
  * only included when present so the serialised shape matches the
  * server's strict schema.
@@ -8490,6 +8767,9 @@ const swapTokenEnumSchema = z.enum([
     if (payload.destinationChain !== undefined) safe['destinationChain'] = payload.destinationChain;
     if (payload.tokenIn !== undefined) safe['tokenIn'] = payload.tokenIn;
     if (payload.tokenOut !== undefined) safe['tokenOut'] = payload.tokenOut;
+    if (payload.amountIn !== undefined) safe['amountIn'] = payload.amountIn;
+    if (payload.durationMs !== undefined) safe['durationMs'] = payload.durationMs;
+    if (payload.sourceAddress !== undefined) safe['sourceAddress'] = payload.sourceAddress;
     if (payload.txHash !== undefined) safe['txHash'] = payload.txHash;
     if (payload.correlationId !== undefined) safe['correlationId'] = payload.correlationId;
     if (payload.errorDetails !== undefined) {
@@ -8686,14 +8966,28 @@ const swapTokenEnumSchema = z.enum([
 }
 
 /**
- * Soft signal for the case where building or emitting a telemetry payload
- * threw — for example, a buggy `TelemetryContextResolver`, a regression in
+ * Emit a stable console warning when building or emitting a telemetry payload
+ * throws — for example, a buggy `TelemetryContextResolver`, a regression in
  * `extractErrorDetails`, or a synchronous failure inside `emitAnalyticsLog`
- * before it could swallow the error itself. Logged with a stable prefix so
- * consumers can grep for it. We deliberately do not re-throw: the caller's
- * original operation error must always win.
+ * before it could swallow the error itself. Uses a stable prefix so the
+ * drop is discoverable via grep. Never re-throws: the caller's original
+ * operation error must always win.
  *
  * @internal
+ *
+ * @param eventType - The telemetry event type that was being emitted.
+ * @param cause - The error or value that caused the drop.
+ *
+ * @example
+ * ```typescript
+ * import { warnTelemetryDrop } from '@core/utils'
+ *
+ * try {
+ *   void emitAnalyticsLog(payload)
+ * } catch (err) {
+ *   warnTelemetryDrop('my_event', err)
+ * }
+ * ```
  */ function warnTelemetryDrop(eventType, cause) {
     try {
         // Pass `cause` as the second console.warn argument rather than
@@ -8733,6 +9027,9 @@ const swapTokenEnumSchema = z.enum([
         ...context?.tokenOut != null && {
             tokenOut: context.tokenOut
         },
+        ...context?.amountIn != null && {
+            amountIn: context.amountIn
+        },
         ...context?.txHash != null && {
             txHash: context.txHash
         },
@@ -8832,7 +9129,7 @@ const swapTokenEnumSchema = z.enum([
 }
 
 var name$3 = "@circle-fin/bridge-kit";
-var version$3 = "1.14.0";
+var version$3 = "1.15.0";
 var pkg$3 = {
 	name: name$3,
 	version: version$3};
@@ -9452,7 +9749,72 @@ var TransferSpeed;
      */ recipientAddress: z.string().trim().min(1, 'Fee recipient must be a non-empty string').optional()
 }).strict();
 /**
- * Schema for validating bridge parameters.
+ * Factory for the bridge-params Zod schema, parameterized by the token
+ * validator. The base schema enforces all non-token fields (amount,
+ * source, destination, config); callers supply the Zod schema for the
+ * `token` field, allowing each provider to validate the token type it
+ * accepts.
+ *
+ * @param tokenSchema - Zod schema applied to the `token` field. Pass
+ *   `z.literal('USDC')` for USDC-only validation, or any
+ *   provider-specific schema (e.g. a `0x`-prefixed hex regex) for
+ *   providers that accept a different token type.
+ * @param config - Required. `maxDecimals` caps the decimal precision
+ *   permitted in `amount` and `config.maxFee`. Pass the widest value
+ *   any of the provider's tokens require — `6` for USDC-only, `18`
+ *   for an ERC-20 family that includes wETH, etc. The schema is a
+ *   coarse syntactic gate; narrower per-token precision is enforced
+ *   by the provider downstream.
+ * @returns A Zod object schema whose `token` field is validated by
+ *   `tokenSchema` and whose other fields (`amount`, `source`,
+ *   `destination`, `config`) are validated against the shared bridge
+ *   contract. Use `.safeParse` / `.parse` directly, or feed the schema
+ *   to {@link parseOrThrow} from `@core/utils` to surface validation
+ *   failures as `KitError` with the canonical
+ *   `INPUT_VALIDATION_FAILED` code.
+ *
+ * @example
+ * ```typescript
+ * import { createBridgeParamsSchema, z } from '@core/provider'
+ *
+ * const usdcSchema = createBridgeParamsSchema(z.literal('USDC'), { maxDecimals: 6 })
+ * const hexSchema = createBridgeParamsSchema(
+ *   z.string().regex(/^0x[0-9a-fA-F]{64}$/),
+ *   { maxDecimals: 18 },
+ * )
+ * ```
+ */ // The full inferred return type of `z.object({...})` here is
+// effectively impossible to spell out by hand without re-stating every
+// field's schema. TypeScript infers it from the body — callers receive
+// a precise Zod schema type via inference, and the explicit-return
+// rules are disabled for that reason.
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type, @typescript-eslint/explicit-module-boundary-types
+function createBridgeParamsSchema(tokenSchema, config) {
+    const { maxDecimals } = config;
+    return z.object({
+        amount: z.string().min(1, 'Required').pipe(createDecimalStringValidator({
+            allowZero: false,
+            regexMessage: AMOUNT_FORMAT_ERROR_MESSAGE,
+            attributeName: 'amount',
+            maxDecimals
+        })(z.string())),
+        source: walletContextSchema,
+        destination: bridgeDestinationSchema$1,
+        token: tokenSchema,
+        config: z.object({
+            transferSpeed: z.nativeEnum(TransferSpeed).optional(),
+            maxFee: z.string().pipe(createDecimalStringValidator({
+                allowZero: true,
+                regexMessage: MAX_FEE_FORMAT_ERROR_MESSAGE,
+                attributeName: 'maxFee',
+                maxDecimals
+            })(z.string())).optional(),
+            customFee: customFeeSchema.optional()
+        })
+    });
+}
+/**
+ * Schema for validating bridge parameters with USDC as the token.
  * This ensures all required fields are present and properly typed.
  * A bridge must include:
  * - A valid amount (non-empty numeric string \> 0)
@@ -9460,11 +9822,15 @@ var TransferSpeed;
  * - USDC as the token
  * - Optional config with transfer speed and max fee settings
  *
+ * Providers that accept a non-USDC token type should call
+ * {@link createBridgeParamsSchema} with their own token schema rather
+ * than reusing this constant.
+ *
  * @throws KitError if validation fails
  *
  * @example
  * ```typescript
- * import { bridgeParamsSchema } from '@core/provider'
+ * import { usdcBridgeParamsSchema } from '@core/provider'
  *
  * const validBridge = {
  *   amount: '100.50',
@@ -9489,193 +9855,61 @@ var TransferSpeed;
  *   }
  * }
  *
- * const result = bridgeParamsSchema.safeParse(validBridge)
+ * const result = usdcBridgeParamsSchema.safeParse(validBridge)
  * console.log(result.success) // true
  * ```
- */ z.object({
-    amount: z.string().min(1, 'Required').pipe(createDecimalStringValidator({
-        allowZero: false,
-        regexMessage: AMOUNT_FORMAT_ERROR_MESSAGE,
-        attributeName: 'amount',
-        maxDecimals: 6
-    })(z.string())),
-    source: walletContextSchema,
-    destination: bridgeDestinationSchema$1,
-    token: z.literal('USDC'),
-    config: z.object({
-        transferSpeed: z.nativeEnum(TransferSpeed).optional(),
-        maxFee: z.string().pipe(createDecimalStringValidator({
-            allowZero: true,
-            regexMessage: MAX_FEE_FORMAT_ERROR_MESSAGE,
-            attributeName: 'maxFee',
-            maxDecimals: 6
-        })(z.string())).optional(),
-        customFee: customFeeSchema.optional()
-    })
+ */ createBridgeParamsSchema(z.literal('USDC'), {
+    maxDecimals: 6
 });
 
-/**
- * Creates a Zod superRefine validator for recipient address format validation.
- * Validates that the address format matches the expected format for the chain type.
+// ----------------------------------------------------------------------------
+// IRIS API base URLs
+// ----------------------------------------------------------------------------
+// ----------------------------------------------------------------------------
+// Known token symbols (DX convenience)
+// ----------------------------------------------------------------------------
+//
+// These constants back symbol -> id resolution as a convenience: a caller may
+// pass a known symbol instead of a raw bytes32 id. They do NOT gate
+// routability.
+/**
+ * Display symbols the provider recognizes as a convenience for callers.
+ *
+ * A consumer may pass one of these symbols instead of a raw bytes32 token
+ * id; the provider resolves it to the symbol's canonical bytes32 id via
+ * {@link KNOWN_TOKEN_IDS_BY_NETWORK} (a symbol can map to more than one
+ * bridge, so the map pins the canonical one). This list does NOT gate
+ * routability: any token the IRIS registry lists with deployments on both
+ * endpoints routes when passed by its bytes32 id, whether listed here or
+ * not.
  *
- * @returns A superRefine function that validates recipientAddress against chain type
- */ function createRecipientAddressValidator() {
-    return (data, ctx)=>{
-        const chain = data.chain;
-        if (chain === null) {
-            return;
-        }
-        if (!isValidAddressForChain(data.recipientAddress, chain)) {
-            const chainInfo = extractChainInfo(chain);
-            ctx.addIssue({
-                code: z.ZodIssueCode.custom,
-                path: [
-                    'recipientAddress'
-                ],
-                message: `Invalid address format for ${String(chainInfo.name)}. Expected ${chainInfo.expectedAddressFormat}, but received: ${data.recipientAddress}`
-            });
-        }
-    };
+ * @example
+ * ```typescript
+ * for (const symbol of KNOWN_TOKEN_SYMBOLS) console.log(symbol)
+ * ```
+ */ const KNOWN_TOKEN_SYMBOLS = [
+    'cirBTC',
+    'wETH',
+    'EURC'
+];
+
+// ============================================================================
+// Crypto Utilities (Internal)
+// ============================================================================
+/** @internal */ function hasGetRandomValues() {
+    return typeof crypto !== 'undefined' && typeof crypto.getRandomValues === 'function';
+}
+/** @internal */ function hasRandomUUID() {
+    return typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function';
 }
 /**
- * Schema for validating AdapterContext for bridge operations.
- * Must always contain both adapter and chain explicitly.
- *
- * Optionally includes address for developer-controlled adapters.
- */ const adapterContextSchema$3 = z.object({
-    adapter: adapterSchema,
-    chain: bridgeChainIdentifierSchema,
-    address: z.string().optional()
-});
-/**
- * Schema for validating BridgeDestinationWithAddress objects.
- * Contains an explicit recipientAddress along with adapter and chain.
- * The address format is validated based on the chain type (EVM or Solana).
- */ const bridgeDestinationWithAddressSchema = adapterContextSchema$3.extend({
-    recipientAddress: z.string().min(1, 'Recipient address is required'),
-    useForwarder: z.boolean().optional()
-}).superRefine(createRecipientAddressValidator());
-/**
- * Schema for validating AdapterContext with optional useForwarder.
- * Extends adapterContextSchema with the useForwarder flag.
- */ const adapterContextWithForwarderSchema = adapterContextSchema$3.extend({
-    useForwarder: z.boolean().optional()
-});
-/**
- * Schema for validating ForwarderDestination objects.
- * Used when useForwarder is true and no adapter is provided.
- * Requires chain, recipientAddress, and useForwarder: true.
- *
- * When using this destination type:
- * - The mint step completes when the IRIS API confirms forwardState === 'CONFIRMED'
- * - No on-chain transaction confirmation is performed (no adapter available)
- * - The mint step's data field will be undefined (no transaction receipt)
- */ const forwarderDestinationSchema = z.object({
-    chain: bridgeChainIdentifierSchema,
-    recipientAddress: z.string().min(1, 'Recipient address is required'),
-    useForwarder: z.literal(true)
-}).strict().superRefine(createRecipientAddressValidator());
-/**
- * Schema for validating BridgeDestination union type.
- * Supports three destination configurations:
- * - BridgeDestinationWithAddress (adapter with explicit recipient)
- * - ForwarderDestination (no adapter, requires useForwarder: true and recipientAddress)
- * - AdapterContext with optional useForwarder (adapter for default recipient)
- *
- * When using ForwarderDestination (no adapter):
- * - The mint step completes when the IRIS API confirms forwardState === 'CONFIRMED'
- * - No on-chain transaction confirmation is performed
+ * Create an RFC 4122 compliant UUIDv4.
  *
- * The order matters: we check the more specific schemas first.
- * This ensures that objects with specific fields are matched correctly.
- */ const bridgeDestinationSchema = z.union([
-    bridgeDestinationWithAddressSchema,
-    forwarderDestinationSchema,
-    adapterContextWithForwarderSchema.strict()
-]);
-/**
- * Schema for validating bridge parameters with chain identifiers.
- * This extends the core provider's schema but adapts it for the bridge kit's
- * more flexible interface that accepts chain identifiers.
+ * @returns UUID string (8-4-4-4-12 hex digits with hyphens).
  *
- * The schema validates:
- * - From adapter context (must always include both adapter and chain)
- * - To bridge destination (AdapterContext or BridgeDestinationWithAddress)
- * - Amount is a non-empty numeric string \> 0
- * - Token is optional and defaults to 'USDC'
- * - Optional config parameters (transfer speed, max fee)
- *
- * @example
- * ```typescript
- * import { bridgeParamsWithChainIdentifierSchema } from '@circle-fin/bridge-kit'
- *
- * const params = {
- *   from: {
- *     adapter: sourceAdapter,
- *     chain: 'Ethereum'
- *   },
- *   to: {
- *     adapter: destAdapter,
- *     chain: 'Base'
- *   },
- *   amount: '100.50',
- *   token: 'USDC',
- *   config: {
- *     transferSpeed: 'FAST'
- *   }
- * }
- *
- * const result = bridgeParamsWithChainIdentifierSchema.safeParse(params)
- * if (result.success) {
- *   console.log('Parameters are valid')
- * } else {
- *   console.error('Validation failed:', result.error)
- * }
- * ```
- */ z.object({
-    from: adapterContextSchema$3.strict(),
-    to: bridgeDestinationSchema,
-    amount: z.string().min(1, 'Required').pipe(createDecimalStringValidator({
-        allowZero: false,
-        regexMessage: AMOUNT_FORMAT_ERROR_MESSAGE,
-        attributeName: 'amount',
-        maxDecimals: 6
-    })(z.string())),
-    token: z.literal('USDC').optional(),
-    config: z.object({
-        transferSpeed: z.nativeEnum(TransferSpeed).optional(),
-        feePayment: z.enum([
-            'source',
-            'destination'
-        ]).optional(),
-        maxFee: z.string().min(1, 'Required').pipe(createDecimalStringValidator({
-            allowZero: true,
-            regexMessage: MAX_FEE_FORMAT_ERROR_MESSAGE,
-            attributeName: 'maxFee',
-            maxDecimals: 6
-        })(z.string())).optional(),
-        customFee: customFeeSchema.optional()
-    }).optional(),
-    quote: z.string().regex(/^0x([a-fA-F0-9]{2})+$/, 'must be non-empty 0x hex').optional()
-});
-
-// ============================================================================
-// Crypto Utilities (Internal)
-// ============================================================================
-/** @internal */ function hasGetRandomValues() {
-    return typeof crypto !== 'undefined' && typeof crypto.getRandomValues === 'function';
-}
-/** @internal */ function hasRandomUUID() {
-    return typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function';
-}
-/**
- * Create an RFC 4122 compliant UUIDv4.
- *
- * @returns UUID string (8-4-4-4-12 hex digits with hyphens).
- *
- * @remarks
- * Use when external systems require RFC 4122 UUID format.
- * For traceId, use {@link createTraceId} instead.
+ * @remarks
+ * Use when external systems require RFC 4122 UUID format.
+ * For traceId, use {@link createTraceId} instead.
  *
  * @example
  * ```typescript
@@ -9764,6 +9998,241 @@ var TransferSpeed;
     message: 'Invalid metrics'
 });
 
+/**
+ * Omit undefined values from an object.
+ *
+ * @param obj - The object to process.
+ * @returns A new object with undefined values removed.
+ *
+ * @internal
+ * @remarks
+ * Used by both production and mock loggers to ensure consistent behavior.
+ * This prevents undefined values from being serialized in log output,
+ * which can cause issues with some log transports.
+ */ function omitUndefined(obj) {
+    const result = {};
+    for (const [key, value] of Object.entries(obj)){
+        if (value !== undefined) {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+
+/**
+ * Default redaction paths for web3/blockchain SDKs.
+ *
+ * @remarks
+ * These paths target common sensitive fields in blockchain applications.
+ * All user fields are nested under `context`, so paths start with `context.`.
+ * Wildcard `*` matches any key at that level.
+ */ const DEFAULT_REDACT_PATHS = [
+    // Generic Credentials
+    'context.password',
+    'context.passphrase',
+    'context.secret',
+    'context.token',
+    'context.*.password',
+    'context.*.passphrase',
+    'context.*.secret',
+    'context.*.token',
+    // API Keys & Auth Tokens
+    'context.apiKey',
+    'context.apiSecret',
+    'context.accessToken',
+    'context.refreshToken',
+    'context.jwt',
+    'context.bearerToken',
+    'context.sessionId',
+    'context.authorization',
+    'context.cookie',
+    'context.*.apiKey',
+    'context.*.apiSecret',
+    'context.*.accessToken',
+    'context.*.refreshToken',
+    'context.*.jwt',
+    'context.*.bearerToken',
+    'context.*.sessionId',
+    'context.*.authorization',
+    'context.*.cookie',
+    // Web3 / Crypto Keys
+    'context.privateKey',
+    'context.secretKey',
+    'context.signingKey',
+    'context.encryptionKey',
+    'context.*.privateKey',
+    'context.*.secretKey',
+    'context.*.signingKey',
+    'context.*.encryptionKey',
+    // Web3 / Crypto Mnemonics and Seeds
+    'context.mnemonic',
+    'context.seed',
+    'context.seedPhrase',
+    'context.*.mnemonic',
+    'context.*.seed',
+    'context.*.seedPhrase',
+    // OTP / Verification Codes
+    'context.otp',
+    'context.verificationCode',
+    'context.*.otp',
+    'context.*.verificationCode',
+    // Payment Information
+    'context.cardNumber',
+    'context.cvv',
+    'context.accountNumber',
+    'context.*.cardNumber',
+    'context.*.cvv',
+    'context.*.accountNumber'
+];
+/**
+ * Wrap user fields under `context` to prevent collision with pino internals.
+ *
+ * @param fields - User-provided log fields.
+ * @returns Object with fields nested under `context`, or undefined if empty.
+ *
+ * @remarks
+ * This function handles edge cases by returning undefined for null, undefined,
+ * or empty objects to avoid unnecessary wrapping in log output.
+ * Undefined values are cleaned before wrapping.
+ */ function wrapInContext(fields) {
+    if (!fields) return undefined;
+    // Clean undefined values for consistency and transport compatibility
+    const cleaned = omitUndefined(fields);
+    // Handle edge case: all values were undefined, resulting in empty object
+    const keys = Object.keys(cleaned);
+    if (keys.length === 0) return undefined;
+    return {
+        context: cleaned
+    };
+}
+/**
+ * Wrap a pino instance to conform to our Logger interface.
+ *
+ * @param pinoInstance - The pino logger instance to wrap.
+ * @returns A Logger instance conforming to our stable interface.
+ */ function wrapPino(pinoInstance) {
+    return {
+        debug (message, fields) {
+            const wrapped = wrapInContext(fields);
+            if (wrapped) {
+                pinoInstance.debug(wrapped, message);
+            } else {
+                pinoInstance.debug(message);
+            }
+        },
+        info (message, fields) {
+            const wrapped = wrapInContext(fields);
+            if (wrapped) {
+                pinoInstance.info(wrapped, message);
+            } else {
+                pinoInstance.info(message);
+            }
+        },
+        warn (message, fields) {
+            const wrapped = wrapInContext(fields);
+            if (wrapped) {
+                pinoInstance.warn(wrapped, message);
+            } else {
+                pinoInstance.warn(message);
+            }
+        },
+        error (message, fields) {
+            const wrapped = wrapInContext(fields);
+            if (wrapped) {
+                pinoInstance.error(wrapped, message);
+            } else {
+                pinoInstance.error(message);
+            }
+        },
+        child (tags) {
+            // Child bindings stay flat (not wrapped) - they're part of logger's base context
+            const cleaned = omitUndefined(tags);
+            return wrapPino(pinoInstance.child(cleaned));
+        }
+    };
+}
+/**
+ * Build pino redact configuration from our simplified options.
+ *
+ * @param redact - The redact configuration option.
+ * @returns Pino-compatible redact configuration or undefined.
+ */ function buildRedactConfig(redact) {
+    // Explicitly disabled
+    if (redact === false) {
+        return undefined;
+    }
+    // Custom paths provided
+    if (Array.isArray(redact)) {
+        return redact.length > 0 ? {
+            paths: redact,
+            censor: '[REDACTED]'
+        } : undefined;
+    }
+    // Default: use web3 sensible defaults
+    return {
+        paths: [
+            ...DEFAULT_REDACT_PATHS
+        ],
+        censor: '[REDACTED]'
+    };
+}
+/**
+ * Create a logger backed by pino.
+ *
+ * @param options - Logger options (optional).
+ * @param stream - Destination stream (optional).
+ * @returns A Logger instance.
+ * @throws Error if invalid pino options are provided.
+ *
+ * @remarks
+ * This is a thin wrapper around pino that exposes our stable Logger interface.
+ * Pino handles all transport concerns: JSON, pretty printing, file, remote, browser, etc.
+ *
+ * **Security**: By default, sensitive web3 fields (privateKey, mnemonic, apiKey, etc.)
+ * are automatically redacted from log output. Use `redact: false` to disable.
+ *
+ * @example
+ * ```typescript
+ * import { createLogger } from '@core/runtime'
+ *
+ * // Default: web3 sensitive fields are redacted
+ * const logger = createLogger({ level: 'info' })
+ * logger.info('Signing', { privateKey: '0x123...' })
+ * // Output: { context: { privateKey: '[REDACTED]' }, msg: 'Signing' }
+ *
+ * // Disable redaction (use with caution)
+ * const unsafeLogger = createLogger({ level: 'debug', redact: false })
+ *
+ * // Custom redaction paths
+ * const customLogger = createLogger({
+ *   level: 'info',
+ *   redact: ['context.mySecret', 'context.*.credentials']
+ * })
+ *
+ * // Pretty output for development
+ * const devLogger = createLogger({
+ *   level: 'debug',
+ *   transport: { target: 'pino-pretty' }
+ * })
+ *
+ * // Browser logger
+ * const browserLogger = createLogger({
+ *   browser: { asObject: true }
+ * })
+ * ```
+ */ function createLogger(options, stream) {
+    const { redact, ...pinoOptions } = options ?? {};
+    // Build redaction config
+    const redactConfig = buildRedactConfig(redact);
+    // Build final pino options, only include redact if defined
+    const finalOptions = redactConfig ? {
+        ...pinoOptions,
+        redact: redactConfig
+    } : pinoOptions;
+    const pinoInstance = pino(finalOptions);
+    return wrapPino(pinoInstance);
+}
+
 // ============================================================================
 // Validation Schema
 // ============================================================================
@@ -9843,6 +10312,186 @@ var TransferSpeed;
     clock: z.any().optional()
 }).passthrough();
 
+/**
+ * Creates a Zod superRefine validator for recipient address format validation.
+ * Validates that the address format matches the expected format for the chain type.
+ *
+ * @returns A superRefine function that validates recipientAddress against chain type
+ */ function createRecipientAddressValidator() {
+    return (data, ctx)=>{
+        const chain = data.chain;
+        if (chain === null) {
+            return;
+        }
+        if (!isValidAddressForChain(data.recipientAddress, chain)) {
+            const chainInfo = extractChainInfo(chain);
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                path: [
+                    'recipientAddress'
+                ],
+                message: `Invalid address format for ${String(chainInfo.name)}. Expected ${chainInfo.expectedAddressFormat}, but received: ${data.recipientAddress}`
+            });
+        }
+    };
+}
+/**
+ * Schema for `BridgeParams.token`.
+ *
+ * Accept `'USDC'`, a symbol from {@link KNOWN_TOKEN_SYMBOLS}, or a bytes32 id
+ * (`0x` plus exactly 64 hex characters). Reject unknown symbols, malformed ids,
+ * and `{ provider, id }` objects. A custom extra provider cannot introduce a
+ * new symbol through this field — only a bytes32 id.
+ *
+ * Omit the field to default to `'USDC'`.
+ */ const bridgeTokenSchema = z.union([
+    z.enum([
+        'USDC',
+        ...KNOWN_TOKEN_SYMBOLS
+    ]),
+    z.string().regex(/^0x[0-9a-fA-F]{64}$/, 'Token id must be a bytes32 (0x-prefixed, 64 hex chars)')
+]);
+/**
+ * Schema for validating AdapterContext for bridge operations.
+ * Must always contain both adapter and chain explicitly.
+ *
+ * Optionally includes address for developer-controlled adapters.
+ */ const adapterContextSchema$3 = z.object({
+    adapter: adapterSchema,
+    chain: bridgeChainIdentifierSchema,
+    address: z.string().optional()
+});
+/**
+ * Schema for validating BridgeDestinationWithAddress objects.
+ * Contains an explicit recipientAddress along with adapter and chain.
+ * The address format is validated based on the chain type (EVM or Solana).
+ */ const bridgeDestinationWithAddressSchema = adapterContextSchema$3.extend({
+    recipientAddress: z.string().min(1, 'Recipient address is required'),
+    useForwarder: z.boolean().optional()
+}).superRefine(createRecipientAddressValidator());
+/**
+ * Schema for validating AdapterContext with optional useForwarder.
+ * Extends adapterContextSchema with the useForwarder flag.
+ */ const adapterContextWithForwarderSchema = adapterContextSchema$3.extend({
+    useForwarder: z.boolean().optional()
+});
+/**
+ * Schema for validating ForwarderDestination objects.
+ * Used when useForwarder is true and no adapter is provided.
+ * Requires chain, recipientAddress, and useForwarder: true.
+ *
+ * When using this destination type:
+ * - The mint step completes when the IRIS API confirms forwardState === 'CONFIRMED'
+ * - No on-chain transaction confirmation is performed (no adapter available)
+ * - The mint step's data field will be undefined (no transaction receipt)
+ */ const forwarderDestinationSchema = z.object({
+    chain: bridgeChainIdentifierSchema,
+    recipientAddress: z.string().min(1, 'Recipient address is required'),
+    useForwarder: z.literal(true)
+}).strict().superRefine(createRecipientAddressValidator());
+/**
+ * Schema for validating BridgeDestination union type.
+ * Supports three destination configurations:
+ * - BridgeDestinationWithAddress (adapter with explicit recipient)
+ * - ForwarderDestination (no adapter, requires useForwarder: true and recipientAddress)
+ * - AdapterContext with optional useForwarder (adapter for default recipient)
+ *
+ * When using ForwarderDestination (no adapter):
+ * - The mint step completes when the IRIS API confirms forwardState === 'CONFIRMED'
+ * - No on-chain transaction confirmation is performed
+ *
+ * The order matters: we check the more specific schemas first.
+ * This ensures that objects with specific fields are matched correctly.
+ */ const bridgeDestinationSchema = z.union([
+    bridgeDestinationWithAddressSchema,
+    forwarderDestinationSchema,
+    adapterContextWithForwarderSchema.strict()
+]);
+/**
+ * Schema for validating bridge parameters with chain identifiers.
+ * This extends the core provider's schema but adapts it for the bridge kit's
+ * more flexible interface that accepts chain identifiers.
+ *
+ * The schema validates:
+ * - From adapter context (must always include both adapter and chain)
+ * - To bridge destination (AdapterContext or BridgeDestinationWithAddress)
+ * - Amount is a non-empty numeric string \> 0
+ * - Token is optional and defaults to 'USDC'
+ * - Optional config parameters (transfer speed, max fee)
+ *
+ * @example
+ * ```typescript
+ * import { bridgeParamsWithChainIdentifierSchema } from '@circle-fin/bridge-kit'
+ *
+ * const params = {
+ *   from: {
+ *     adapter: sourceAdapter,
+ *     chain: 'Ethereum'
+ *   },
+ *   to: {
+ *     adapter: destAdapter,
+ *     chain: 'Base'
+ *   },
+ *   amount: '100.50',
+ *   token: 'USDC',
+ *   config: {
+ *     transferSpeed: 'FAST'
+ *   }
+ * }
+ *
+ * const result = bridgeParamsWithChainIdentifierSchema.safeParse(params)
+ * if (result.success) {
+ *   console.log('Parameters are valid')
+ * } else {
+ *   console.error('Validation failed:', result.error)
+ * }
+ * ```
+ */ z.object({
+    from: adapterContextSchema$3.strict(),
+    to: bridgeDestinationSchema,
+    amount: z.string().min(1, 'Required').pipe(createDecimalStringValidator({
+        allowZero: false,
+        regexMessage: AMOUNT_FORMAT_ERROR_MESSAGE,
+        attributeName: 'amount',
+        // Widest precision any routable token needs (wETH = 18). This gate is
+        // token-agnostic and runs before the route provider is known, so it
+        // can only cap coarsely; the token's exact precision is enforced later
+        // at the scaling boundary (`BridgeKit.scaleResolvedAmount`). USDC (6)
+        // and every narrower token stay valid.
+        maxDecimals: 18
+    })(z.string())),
+    token: bridgeTokenSchema.optional(),
+    config: z.object({
+        transferSpeed: z.nativeEnum(TransferSpeed).optional(),
+        feePayment: z.enum([
+            'source',
+            'destination'
+        ]).optional(),
+        maxFee: z.string().min(1, 'Required').pipe(createDecimalStringValidator({
+            allowZero: true,
+            regexMessage: MAX_FEE_FORMAT_ERROR_MESSAGE,
+            attributeName: 'maxFee',
+            // See `amount` above: widest routable precision (18); the exact
+            // per-token precision is enforced at the scaling boundary.
+            maxDecimals: 18
+        })(z.string())).optional(),
+        customFee: customFeeSchema.optional()
+    }).optional(),
+    // Top-level (not nested under `config`) to mirror `BridgeParams.quote`.
+    //
+    // `z.unknown()` rather than a shape: the quote belongs to whichever provider
+    // issued it, and a route is matched to a provider only after these
+    // parameters are validated, so there is no one shape to check here.
+    //
+    // It also keeps the value intact. This object strips unknown keys, so a
+    // nested `z.object()` would clone the quote and drop every key not listed —
+    // losing a field the issuing provider added, between `estimate` and
+    // `bridge`. Shape is checked where the quote is consumed instead: CCTPx
+    // against its own envelope schema, and the receive-exact path in
+    // `sourceFees.ts` before it calls the Fee Service.
+    quote: z.unknown().optional()
+});
+
 /**
  * The ASCII "cctp-forward" magic, hex-encoded (no `0x`), that a forward-friendly
  * hookData must start with.
@@ -9871,6 +10520,9 @@ var TransferSpeed;
     [TransferSpeed.SLOW]: 2000
 });
 
+createLogger({
+    name: 'provider-cctp-v2'
+});
 /**
  * All chains that are supported by the CCTP v2 provider.
  *
@@ -9880,7 +10532,11 @@ var TransferSpeed;
  * @internal
  */ Object.values(Chains).filter((chain)=>isCCTPV2Supported(chain));
 
-/** Decimal string in token minor units, constrained to be strictly positive. */ const positiveAmountSchema = z.string().regex(/^\d+$/, 'must be a non-negative integer string')// Re-check the digit shape here: zod still runs this refinement when the
+/**
+ * Decimal string in token minor units, constrained to be strictly positive.
+ *
+ * @internal
+ */ const positiveAmountSchema = z.string().regex(/^\d+$/, 'must be a non-negative integer string')// Re-check the digit shape here: zod still runs this refinement when the
 // regex check above fails ("dirty"), so guard BigInt() against throwing on a
 // non-numeric value before comparing.
 .refine((value)=>/^\d+$/.test(value) && BigInt(value) > 0n, 'must be greater than zero');
@@ -9915,11 +10571,19 @@ const forwardRequestSchema = z.object({
 const preFinalityRequestSchema = z.object({
     type: z.literal('PRE_FINALITY')
 }).strict();
-/** A single quote request item (`FORWARD` or `PRE_FINALITY`). */ const feeQuoteRequestSchema = z.discriminatedUnion('type', [
+/**
+ * A single quote request item (`FORWARD` or `PRE_FINALITY`).
+ *
+ * @internal
+ */ const feeQuoteRequestSchema = z.discriminatedUnion('type', [
     forwardRequestSchema,
     preFinalityRequestSchema
 ]);
-/** A non-empty list of quote request items with unique types. */ const feeQuoteRequestsSchema = z.array(feeQuoteRequestSchema).min(1, 'at least one request item is required').refine((items)=>new Set(items.map((item)=>item.type)).size === items.length, 'request item types must be unique');
+/**
+ * A non-empty list of quote request items with unique types.
+ *
+ * @internal
+ */ const feeQuoteRequestsSchema = z.array(feeQuoteRequestSchema).min(1, 'at least one request item is required').refine((items)=>new Set(items.map((item)=>item.type)).size === items.length, 'request item types must be unique');
 /**
  * A structured `Partial<ApiPollingConfig>` polling override.
  *
@@ -9947,6 +10611,8 @@ const preFinalityRequestSchema = z.object({
  * it `undefined`, which is falsy and silently selects the production base URL.
  * (`buildFeeQuoteUrl` independently re-validates the domains for standalone
  * callers.)
+ *
+ * @internal
  */ z.object({
     sourceDomain: z.number().int().nonnegative(),
     destinationDomain: z.number().int().nonnegative(),
@@ -9982,7 +10648,11 @@ const metadataSchema = z.object({
         blockEstimatedAt: z.number().int().nonnegative().optional()
     }).passthrough()
 ]);
-/** Schema for a signed fee quote returned by the Quote API. */ z.object({
+/**
+ * Schema for a signed fee quote returned by the Quote API.
+ *
+ * @internal
+ */ z.object({
     // The runtime YAML spec maps signedQuote to a looser `hex` (which allows
     // an empty `0x`); we keep the stricter non-empty form. Do not relax
     // without a reason.
@@ -9996,7 +10666,11 @@ const metadataSchema = z.object({
     items: z.array(feeQuoteItemSchema),
     metadata: metadataSchema.optional()
 }).passthrough();
-/** Validate input to {@link validateQuote}. */ z.object({
+/**
+ * Validates input to {@link validateQuote}.
+ *
+ * @internal
+ */ z.object({
     sourceDomain: z.number().int().nonnegative(),
     abiSignature: z.string().min(1),
     args: z.array(z.union([
@@ -10031,11 +10705,13 @@ const validateQuoteItemSchema = z.object({
     computedArgsHash: bytes32Schema.optional()
 }).passthrough();
 /**
- * Schema for a response from the Quote API validation endpoint.
+ * Schema for a validate-quote result returned by the Iris `/validate/usdc/:sourceDomain` endpoint.
  *
  * The endpoint takes the source domain as a URL path parameter and does not
  * return it in the response body, so `sourceDomain` is intentionally not part
  * of this schema.
+ *
+ * @internal
  */ z.object({
     signedQuote: nonEmptyHexSchema,
     expiry: quoteExpiryStatusSchema,
@@ -10055,7 +10731,7 @@ const validateQuoteItemSchema = z.object({
 registerKit(`${pkg$3.name}/${pkg$3.version}`);
 
 var name$2 = "@circle-fin/swap-kit";
-var version$2 = "1.6.0";
+var version$2 = "1.7.0";
 var pkg$2 = {
 	name: name$2,
 	version: version$2};
@@ -12219,6 +12895,11 @@ createTokenRegistry();
         name: 'USDC',
         version: '2'
     },
+    Arc: {
+        chainId: Arc.chainId,
+        name: 'USDC',
+        version: '2'
+    },
     Arc_Testnet: {
         chainId: ArcTestnet.chainId,
         name: 'USDC',
@@ -13754,7 +14435,7 @@ new Set(Object.values(Blockchain));
 registerKit(`${pkg$2.name}/${pkg$2.version}`);
 
 var name$1 = "@circle-fin/earn-kit";
-var version$1 = "1.6.0";
+var version$1 = "1.7.0";
 var pkg$1 = {
 	name: name$1,
 	version: version$1};
@@ -13782,18 +14463,22 @@ const EARN_BRIDGE_ERC3009_TOKEN_SYMBOLS = [
  *
  * @internal
  */ const CHAIN_TO_API = {
+    [Blockchain.Arc]: 'ARC',
     [Blockchain.Arc_Testnet]: 'ARC-TESTNET'
 };
 /**
  * Map SDK source chain identifiers to bridge source-chain strings.
  *
- * Cross-chain Earn deposits currently support Ethereum Sepolia, Arbitrum
- * Sepolia, and Base Sepolia as source chains.
+ * Cross-chain Earn deposits support Ethereum, Arbitrum, and Base (mainnet
+ * and testnet) as source chains.
  *
  * @internal
  */ const EARN_BRIDGE_SOURCE_CHAIN_TO_API = {
+    [Blockchain.Arbitrum]: 'ARB',
     [Blockchain.Arbitrum_Sepolia]: 'ARB-SEPOLIA',
+    [Blockchain.Base]: 'BASE',
     [Blockchain.Base_Sepolia]: 'BASE-SEPOLIA',
+    [Blockchain.Ethereum]: 'ETH',
     [Blockchain.Ethereum_Sepolia]: 'ETH-SEPOLIA'
 };
 /**
@@ -13804,17 +14489,30 @@ const EARN_BRIDGE_ERC3009_TOKEN_SYMBOLS = [
  *
  * @internal
  */ const EARN_BRIDGE_DESTINATION_CHAIN_TO_API = {
+    [Blockchain.Arc]: CHAIN_TO_API[Blockchain.Arc],
     [Blockchain.Arc_Testnet]: CHAIN_TO_API[Blockchain.Arc_Testnet]
 };
 const EARN_BRIDGE_USDC_ERC3009_DOMAINS = {
+    [Blockchain.Arbitrum]: {
+        name: 'USD Coin',
+        version: '2'
+    },
     [Blockchain.Arbitrum_Sepolia]: {
         name: 'USD Coin',
         version: '2'
     },
+    [Blockchain.Base]: {
+        name: 'USD Coin',
+        version: '2'
+    },
     [Blockchain.Base_Sepolia]: {
         name: 'USDC',
         version: '2'
     },
+    [Blockchain.Ethereum]: {
+        name: 'USD Coin',
+        version: '2'
+    },
     [Blockchain.Ethereum_Sepolia]: {
         name: 'USDC',
         version: '2'
@@ -16658,7 +17356,7 @@ const bridgeDepositPrepareReviewSchema = z.object({
 }
 
 var name = "@circle-fin/provider-earn-service";
-var version = "1.5.0";
+var version = "1.6.0";
 var pkg = {
 	name: name,
 	version: version};