@circle-fin/app-kit 1.12.0 → 1.13.0

package/unifiedBalance.mjs

@@ -658,6 +658,11 @@ class KitError extends Error {
         name: 'INPUT_UNSUPPORTED_TOKEN',
         type: 'INPUT'
     },
+    /** Action not supported by this adapter / ecosystem */ UNSUPPORTED_ACTION: {
+        code: 1008,
+        name: 'INPUT_UNSUPPORTED_ACTION',
+        type: 'INPUT'
+    },
     /** No route satisfies the slippage or minimum-output constraint */ SLIPPAGE_CONSTRAINT_NOT_MET: {
         code: 1009,
         name: 'INPUT_SLIPPAGE_CONSTRAINT_NOT_MET',
@@ -2292,6 +2297,8 @@ class KitError extends Error {
     Blockchain["Optimism_Sepolia"] = "Optimism_Sepolia";
     Blockchain["Pharos"] = "Pharos";
     Blockchain["Pharos_Testnet"] = "Pharos_Testnet";
+    Blockchain["Plasma"] = "Plasma";
+    Blockchain["Plasma_Testnet"] = "Plasma_Testnet";
     Blockchain["Polkadot_Asset_Hub"] = "Polkadot_Asset_Hub";
     Blockchain["Polkadot_Westmint"] = "Polkadot_Westmint";
     Blockchain["Plume"] = "Plume";
@@ -2361,6 +2368,7 @@ var BridgeChain;
     BridgeChain["Morph"] = "Morph";
     BridgeChain["Optimism"] = "Optimism";
     BridgeChain["Pharos"] = "Pharos";
+    BridgeChain["Plasma"] = "Plasma";
     BridgeChain["Plume"] = "Plume";
     BridgeChain["Polygon"] = "Polygon";
     BridgeChain["Sei"] = "Sei";
@@ -2387,6 +2395,7 @@ var BridgeChain;
     BridgeChain["Morph_Testnet"] = "Morph_Testnet";
     BridgeChain["Optimism_Sepolia"] = "Optimism_Sepolia";
     BridgeChain["Pharos_Testnet"] = "Pharos_Testnet";
+    BridgeChain["Plasma_Testnet"] = "Plasma_Testnet";
     BridgeChain["Plume_Testnet"] = "Plume_Testnet";
     BridgeChain["Polygon_Amoy_Testnet"] = "Polygon_Amoy_Testnet";
     BridgeChain["Sei_Testnet"] = "Sei_Testnet";
@@ -2833,6 +2842,8 @@ 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';
 /**
  * Circle's fee recipient address for EVM chains.
  *
@@ -2880,6 +2891,7 @@ var EarnChain;
             v2: {
                 type: 'split',
                 tokenMessenger: '0x8FE6B999Dc680CcFDD5Bf7EB0974218be2542DAA',
+                tokenMessengerWithFees: TOKEN_MESSENGER_WITH_FEES_EVM_TESTNET,
                 messageTransmitter: '0xE737e5cEBEEBa77EFE34D4aa090756590b1CE275',
                 confirmations: 1,
                 fastConfirmations: 1
@@ -2947,6 +2959,7 @@ var EarnChain;
             v2: {
                 type: 'split',
                 tokenMessenger: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
+                tokenMessengerWithFees: TOKEN_MESSENGER_WITH_FEES_EVM_MAINNET,
                 messageTransmitter: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
                 confirmations: 65,
                 fastConfirmations: 1
@@ -3011,6 +3024,7 @@ var EarnChain;
             v2: {
                 type: 'split',
                 tokenMessenger: '0x8FE6B999Dc680CcFDD5Bf7EB0974218be2542DAA',
+                tokenMessengerWithFees: TOKEN_MESSENGER_WITH_FEES_EVM_TESTNET,
                 messageTransmitter: '0xE737e5cEBEEBa77EFE34D4aa090756590b1CE275',
                 confirmations: 65,
                 fastConfirmations: 1
@@ -3075,6 +3089,7 @@ var EarnChain;
             v2: {
                 type: 'split',
                 tokenMessenger: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
+                tokenMessengerWithFees: TOKEN_MESSENGER_WITH_FEES_EVM_MAINNET,
                 messageTransmitter: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
                 confirmations: 1,
                 fastConfirmations: 1
@@ -3136,6 +3151,7 @@ var EarnChain;
             v2: {
                 type: 'split',
                 tokenMessenger: '0x8fe6b999dc680ccfdd5bf7eb0974218be2542daa',
+                tokenMessengerWithFees: TOKEN_MESSENGER_WITH_FEES_EVM_TESTNET,
                 messageTransmitter: '0xe737e5cebeeba77efe34d4aa090756590b1ce275',
                 confirmations: 1,
                 fastConfirmations: 1
@@ -3203,6 +3219,7 @@ var EarnChain;
             v2: {
                 type: 'split',
                 tokenMessenger: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
+                tokenMessengerWithFees: TOKEN_MESSENGER_WITH_FEES_EVM_MAINNET,
                 messageTransmitter: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
                 confirmations: 65,
                 fastConfirmations: 1
@@ -3267,6 +3284,7 @@ var EarnChain;
             v2: {
                 type: 'split',
                 tokenMessenger: '0x8fe6b999dc680ccfdd5bf7eb0974218be2542daa',
+                tokenMessengerWithFees: TOKEN_MESSENGER_WITH_FEES_EVM_TESTNET,
                 messageTransmitter: '0xe737e5cebeeba77efe34d4aa090756590b1ce275',
                 confirmations: 65,
                 fastConfirmations: 1
@@ -3377,6 +3395,7 @@ var EarnChain;
             v2: {
                 type: 'split',
                 tokenMessenger: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
+                tokenMessengerWithFees: TOKEN_MESSENGER_WITH_FEES_EVM_MAINNET,
                 messageTransmitter: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
                 confirmations: 65,
                 fastConfirmations: 1
@@ -3421,6 +3440,7 @@ var EarnChain;
             v2: {
                 type: 'split',
                 tokenMessenger: '0x8fe6b999dc680ccfdd5bf7eb0974218be2542daa',
+                tokenMessengerWithFees: TOKEN_MESSENGER_WITH_FEES_EVM_TESTNET,
                 messageTransmitter: '0xe737e5cebeeba77efe34d4aa090756590b1ce275',
                 confirmations: 65,
                 fastConfirmations: 1
@@ -3652,6 +3672,7 @@ var EarnChain;
             v2: {
                 type: 'split',
                 tokenMessenger: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
+                tokenMessengerWithFees: TOKEN_MESSENGER_WITH_FEES_EVM_MAINNET,
                 messageTransmitter: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
                 confirmations: 65,
                 fastConfirmations: 2
@@ -3716,6 +3737,7 @@ var EarnChain;
             v2: {
                 type: 'split',
                 tokenMessenger: '0x8fe6b999dc680ccfdd5bf7eb0974218be2542daa',
+                tokenMessengerWithFees: TOKEN_MESSENGER_WITH_FEES_EVM_TESTNET,
                 messageTransmitter: '0xe737e5cebeeba77efe34d4aa090756590b1ce275',
                 confirmations: 65,
                 fastConfirmations: 2
@@ -3826,6 +3848,7 @@ var EarnChain;
             v2: {
                 type: 'split',
                 tokenMessenger: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
+                tokenMessengerWithFees: TOKEN_MESSENGER_WITH_FEES_EVM_MAINNET,
                 messageTransmitter: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
                 confirmations: 1,
                 fastConfirmations: 1
@@ -3885,6 +3908,7 @@ var EarnChain;
             v2: {
                 type: 'split',
                 tokenMessenger: '0x8FE6B999Dc680CcFDD5Bf7EB0974218be2542DAA',
+                tokenMessengerWithFees: TOKEN_MESSENGER_WITH_FEES_EVM_TESTNET,
                 messageTransmitter: '0xE737e5cEBEEBa77EFE34D4aa090756590b1CE275',
                 confirmations: 1,
                 fastConfirmations: 1
@@ -4039,6 +4063,7 @@ var EarnChain;
             v2: {
                 type: 'split',
                 tokenMessenger: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
+                tokenMessengerWithFees: TOKEN_MESSENGER_WITH_FEES_EVM_MAINNET,
                 messageTransmitter: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
                 confirmations: 65,
                 fastConfirmations: 1
@@ -4086,6 +4111,7 @@ var EarnChain;
             v2: {
                 type: 'split',
                 tokenMessenger: '0x8FE6B999Dc680CcFDD5Bf7EB0974218be2542DAA',
+                tokenMessengerWithFees: TOKEN_MESSENGER_WITH_FEES_EVM_TESTNET,
                 messageTransmitter: '0xE737e5cEBEEBa77EFE34D4aa090756590b1CE275',
                 confirmations: 65,
                 fastConfirmations: 1
@@ -4130,6 +4156,7 @@ var EarnChain;
             v2: {
                 type: 'split',
                 tokenMessenger: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
+                tokenMessengerWithFees: TOKEN_MESSENGER_WITH_FEES_EVM_MAINNET,
                 messageTransmitter: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
                 confirmations: 1,
                 fastConfirmations: 1
@@ -4175,6 +4202,7 @@ var EarnChain;
             v2: {
                 type: 'split',
                 tokenMessenger: '0x8fe6b999dc680ccfdd5bf7eb0974218be2542daa',
+                tokenMessengerWithFees: TOKEN_MESSENGER_WITH_FEES_EVM_TESTNET,
                 messageTransmitter: '0xe737e5cebeeba77efe34d4aa090756590b1ce275',
                 confirmations: 1,
                 fastConfirmations: 1
@@ -4221,6 +4249,7 @@ var EarnChain;
             v2: {
                 type: 'split',
                 tokenMessenger: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
+                tokenMessengerWithFees: TOKEN_MESSENGER_WITH_FEES_EVM_MAINNET,
                 messageTransmitter: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
                 confirmations: 1,
                 fastConfirmations: 1
@@ -4534,6 +4563,7 @@ var EarnChain;
             v2: {
                 type: 'split',
                 tokenMessenger: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
+                tokenMessengerWithFees: TOKEN_MESSENGER_WITH_FEES_EVM_MAINNET,
                 messageTransmitter: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
                 confirmations: 65,
                 fastConfirmations: 1
@@ -4598,6 +4628,7 @@ var EarnChain;
             v2: {
                 type: 'split',
                 tokenMessenger: '0x8fe6b999dc680ccfdd5bf7eb0974218be2542daa',
+                tokenMessengerWithFees: TOKEN_MESSENGER_WITH_FEES_EVM_TESTNET,
                 messageTransmitter: '0xe737e5cebeeba77efe34d4aa090756590b1ce275',
                 confirmations: 65,
                 fastConfirmations: 1
@@ -4718,6 +4749,98 @@ var EarnChain;
     }
 });
 
+/**
+ * Plasma Mainnet chain definition
+ * @remarks
+ * This represents the official production network for the Plasma blockchain.
+ * Plasma is an EVM-equivalent Layer 1 blockchain purpose-built for global
+ * stablecoin payments, with deterministic BFT finality (PlasmaBFT/Fast-HotStuff).
+ */ const Plasma = defineChain({
+    type: 'evm',
+    chain: Blockchain.Plasma,
+    name: 'Plasma',
+    title: 'Plasma Mainnet',
+    nativeCurrency: {
+        name: 'Plasma',
+        symbol: 'XPL',
+        decimals: 18
+    },
+    chainId: 9745,
+    isTestnet: false,
+    explorerUrl: 'https://plasmascan.to/tx/{hash}',
+    rpcEndpoints: [
+        'https://rpc.plasma.to'
+    ],
+    eurcAddress: '0x3EE196E78d4d4248b849B8E1C7F44C5457FAFD2C',
+    usdcAddress: '0x2d661C89D812261039AF9764eceaAee884f5F67F',
+    usdtAddress: null,
+    cctp: {
+        domain: 33,
+        contracts: {
+            v2: {
+                type: 'split',
+                tokenMessenger: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
+                messageTransmitter: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
+                confirmations: 3,
+                fastConfirmations: 1
+            }
+        },
+        forwarderSupported: {
+            source: false,
+            destination: false
+        }
+    },
+    kitContracts: {
+        bridge: BRIDGE_CONTRACT_EVM_MAINNET
+    }
+});
+
+/**
+ * Plasma Testnet chain definition
+ * @remarks
+ * This represents the official test network for the Plasma blockchain.
+ * Plasma is an EVM-equivalent Layer 1 blockchain purpose-built for global
+ * stablecoin payments, with deterministic BFT finality (PlasmaBFT/Fast-HotStuff).
+ */ const PlasmaTestnet = defineChain({
+    type: 'evm',
+    chain: Blockchain.Plasma_Testnet,
+    name: 'Plasma Testnet',
+    title: 'Plasma Testnet',
+    nativeCurrency: {
+        name: 'Plasma',
+        symbol: 'XPL',
+        decimals: 18
+    },
+    chainId: 9746,
+    isTestnet: true,
+    explorerUrl: 'https://testnet.plasmascan.to/tx/{hash}',
+    rpcEndpoints: [
+        'https://testnet-rpc.plasma.to'
+    ],
+    eurcAddress: '0x98AfA0F93Dd993B736399f9074eDcEBD1985A330',
+    usdcAddress: '0xE67Fb267022cBA8064Dd388CC2FED724F3120D9D',
+    usdtAddress: null,
+    cctp: {
+        domain: 33,
+        contracts: {
+            v2: {
+                type: 'split',
+                tokenMessenger: '0x8FE6B999Dc680CcFDD5Bf7EB0974218be2542DAA',
+                messageTransmitter: '0xE737e5cEBEEBa77EFE34D4aa090756590b1CE275',
+                confirmations: 3,
+                fastConfirmations: 1
+            }
+        },
+        forwarderSupported: {
+            source: false,
+            destination: false
+        }
+    },
+    kitContracts: {
+        bridge: BRIDGE_CONTRACT_EVM_TESTNET
+    }
+});
+
 /**
  * Plume Mainnet chain definition
  * @remarks
@@ -4749,6 +4872,7 @@ var EarnChain;
             v2: {
                 type: 'split',
                 tokenMessenger: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
+                tokenMessengerWithFees: TOKEN_MESSENGER_WITH_FEES_EVM_MAINNET,
                 messageTransmitter: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
                 confirmations: 65,
                 fastConfirmations: 1
@@ -4795,6 +4919,7 @@ var EarnChain;
             v2: {
                 type: 'split',
                 tokenMessenger: '0x8FE6B999Dc680CcFDD5Bf7EB0974218be2542DAA',
+                tokenMessengerWithFees: TOKEN_MESSENGER_WITH_FEES_EVM_TESTNET,
                 messageTransmitter: '0xE737e5cEBEEBa77EFE34D4aa090756590b1CE275',
                 confirmations: 65,
                 fastConfirmations: 1
@@ -4896,6 +5021,7 @@ var EarnChain;
             v2: {
                 type: 'split',
                 tokenMessenger: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
+                tokenMessengerWithFees: TOKEN_MESSENGER_WITH_FEES_EVM_MAINNET,
                 messageTransmitter: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
                 confirmations: 33,
                 fastConfirmations: 13
@@ -4961,6 +5087,7 @@ var EarnChain;
             v2: {
                 type: 'split',
                 tokenMessenger: '0x8FE6B999Dc680CcFDD5Bf7EB0974218be2542DAA',
+                tokenMessengerWithFees: TOKEN_MESSENGER_WITH_FEES_EVM_TESTNET,
                 messageTransmitter: '0xE737e5cEBEEBa77EFE34D4aa090756590b1CE275',
                 confirmations: 33,
                 fastConfirmations: 13
@@ -5020,6 +5147,7 @@ var EarnChain;
             v2: {
                 type: 'split',
                 tokenMessenger: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
+                tokenMessengerWithFees: TOKEN_MESSENGER_WITH_FEES_EVM_MAINNET,
                 messageTransmitter: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
                 confirmations: 1,
                 fastConfirmations: 1
@@ -5079,6 +5207,7 @@ var EarnChain;
             v2: {
                 type: 'split',
                 tokenMessenger: '0x8FE6B999Dc680CcFDD5Bf7EB0974218be2542DAA',
+                tokenMessengerWithFees: TOKEN_MESSENGER_WITH_FEES_EVM_TESTNET,
                 messageTransmitter: '0xE737e5cEBEEBa77EFE34D4aa090756590b1CE275',
                 confirmations: 1,
                 fastConfirmations: 1
@@ -5136,6 +5265,7 @@ var EarnChain;
             v2: {
                 type: 'split',
                 tokenMessenger: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
+                tokenMessengerWithFees: TOKEN_MESSENGER_WITH_FEES_EVM_MAINNET,
                 messageTransmitter: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
                 confirmations: 1,
                 fastConfirmations: 1
@@ -5194,6 +5324,7 @@ var EarnChain;
             v2: {
                 type: 'split',
                 tokenMessenger: '0x8FE6B999Dc680CcFDD5Bf7EB0974218be2542DAA',
+                tokenMessengerWithFees: TOKEN_MESSENGER_WITH_FEES_EVM_TESTNET,
                 messageTransmitter: '0xE737e5cEBEEBa77EFE34D4aa090756590b1CE275',
                 confirmations: 1,
                 fastConfirmations: 1
@@ -5509,6 +5640,7 @@ var EarnChain;
             v2: {
                 type: 'split',
                 tokenMessenger: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
+                tokenMessengerWithFees: TOKEN_MESSENGER_WITH_FEES_EVM_MAINNET,
                 messageTransmitter: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
                 confirmations: 65,
                 fastConfirmations: 1
@@ -5573,6 +5705,7 @@ var EarnChain;
             v2: {
                 type: 'split',
                 tokenMessenger: '0x8FE6B999Dc680CcFDD5Bf7EB0974218be2542DAA',
+                tokenMessengerWithFees: TOKEN_MESSENGER_WITH_FEES_EVM_TESTNET,
                 messageTransmitter: '0xE737e5cEBEEBa77EFE34D4aa090756590b1CE275',
                 confirmations: 65,
                 fastConfirmations: 1
@@ -5630,6 +5763,7 @@ var EarnChain;
             v2: {
                 type: 'split',
                 tokenMessenger: '0x28b5a0e9C621a5BadaA536219b3a228C8168cF5d',
+                tokenMessengerWithFees: TOKEN_MESSENGER_WITH_FEES_EVM_MAINNET,
                 messageTransmitter: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
                 confirmations: 65,
                 fastConfirmations: 1
@@ -5689,6 +5823,7 @@ var EarnChain;
             v2: {
                 type: 'split',
                 tokenMessenger: '0x8fe6b999dc680ccfdd5bf7eb0974218be2542daa',
+                tokenMessengerWithFees: TOKEN_MESSENGER_WITH_FEES_EVM_TESTNET,
                 messageTransmitter: '0xe737e5cebeeba77efe34d4aa090756590b1ce275',
                 confirmations: 65,
                 fastConfirmations: 1
@@ -5749,6 +5884,7 @@ var EarnChain;
             v2: {
                 type: 'split',
                 tokenMessenger: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
+                tokenMessengerWithFees: TOKEN_MESSENGER_WITH_FEES_EVM_MAINNET,
                 messageTransmitter: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
                 confirmations: 3,
                 fastConfirmations: 3
@@ -5794,6 +5930,7 @@ var EarnChain;
             v2: {
                 type: 'split',
                 tokenMessenger: '0x8FE6B999Dc680CcFDD5Bf7EB0974218be2542DAA',
+                tokenMessengerWithFees: TOKEN_MESSENGER_WITH_FEES_EVM_TESTNET,
                 messageTransmitter: '0xE737e5cEBEEBa77EFE34D4aa090756590b1CE275',
                 confirmations: 3,
                 fastConfirmations: 1
@@ -6004,6 +6141,8 @@ var Chains = /*#__PURE__*/Object.freeze({
   OptimismSepolia: OptimismSepolia,
   Pharos: Pharos,
   PharosTestnet: PharosTestnet,
+  Plasma: Plasma,
+  PlasmaTestnet: PlasmaTestnet,
   Plume: Plume,
   PlumeTestnet: PlumeTestnet,
   PolkadotAssetHub: PolkadotAssetHub,
@@ -7969,6 +8108,7 @@ function parseOrThrow(value, schema, context) {
         [Blockchain.Noble]: 'uusdc',
         [Blockchain.Optimism]: '0x0b2c639c533813f4aa9d7837caf62653d097ff85',
         [Blockchain.Pharos]: '0xC879C018dB60520F4355C26eD1a6D572cdAC1815',
+        [Blockchain.Plasma]: '0x2d661C89D812261039AF9764eceaAee884f5F67F',
         [Blockchain.Plume]: '0x222365EF19F7947e5484218551B56bb3965Aa7aF',
         [Blockchain.Polkadot_Asset_Hub]: '1337',
         [Blockchain.Polygon]: '0x3c499c542cef5e3811e1192ce70d8cc03d5c3359',
@@ -7989,6 +8129,7 @@ function parseOrThrow(value, schema, context) {
         [Blockchain.Arbitrum_Sepolia]: '0x75faf114eafb1BDbe2F0316DF893fd58CE46AA4d',
         [Blockchain.Avalanche_Fuji]: '0x5425890298aed601595a70AB815c96711a31Bc65',
         [Blockchain.Base_Sepolia]: '0x036CbD53842c5426634e7929541eC2318f3dCF7e',
+        [Blockchain.Celo_Alfajores_Testnet]: '0x2F25deB3848C207fc8E0c34035B3Ba7fC157602B',
         [Blockchain.Codex_Testnet]: '0x6d7f141b6819C2c9CC2f818e6ad549E7Ca090F8f',
         [Blockchain.Cronos_Testnet]: '0xEb33dc5fac03833e132593659e1dE7256aB59794',
         [Blockchain.Edge_Testnet]: '0x2d9F7CAD728051AA35Ecdc472a14cf8cDF5CFD6B',
@@ -8004,6 +8145,7 @@ function parseOrThrow(value, schema, context) {
         [Blockchain.Noble_Testnet]: 'uusdc',
         [Blockchain.Optimism_Sepolia]: '0x5fd84259d66Cd46123540766Be93DFE6D43130D7',
         [Blockchain.Pharos_Testnet]: '0xcfC8330f4BCAB529c625D12781b1C19466A9Fc8B',
+        [Blockchain.Plasma_Testnet]: '0xE67Fb267022cBA8064Dd388CC2FED724F3120D9D',
         [Blockchain.Plume_Testnet]: '0xcB5f30e335672893c7eb944B374c196392C19D18',
         [Blockchain.Polkadot_Westmint]: '31337',
         [Blockchain.Polygon_Amoy_Testnet]: '0x41e94eb019c0762f9bfcf9fb1e58725bfb0e7582',
@@ -8066,6 +8208,7 @@ function parseOrThrow(value, schema, context) {
         [Blockchain.Base]: '0x60a3E35Cc302bFA44Cb288Bc5a4F316Fdb1adb42',
         [Blockchain.Cronos]: '0xA6dE01a2d62C6B5f3525d768f34d276652C554c8',
         [Blockchain.Ethereum]: '0x1aBaEA1f7C830bD89Acc67eC4af516284b1bC33c',
+        [Blockchain.Plasma]: '0x3EE196E78d4d4248b849B8E1C7F44C5457FAFD2C',
         [Blockchain.Solana]: 'HzwqbKZw8HxMN6bF2yFZNrht3c2iXXzpKcFu7uBEDKtr',
         [Blockchain.World_Chain]: '0x1C60ba0A0eD1019e8Eb035E6daF4155A5cE2380B',
         // =========================================================================
@@ -8074,7 +8217,8 @@ function parseOrThrow(value, schema, context) {
         [Blockchain.Arc_Testnet]: '0x89B50855Aa3bE2F677cD6303Cec089B5F319D72a',
         [Blockchain.Base_Sepolia]: '0x808456652fdb597867f38412077A9182bf77359F',
         [Blockchain.Cronos_Testnet]: '0x31f7538adb53cF16350e6B0c89d03D91b7D12c46',
-        [Blockchain.Ethereum_Sepolia]: '0x08210F9170F89Ab7658F0B5E3fF39b0E03C594D4'
+        [Blockchain.Ethereum_Sepolia]: '0x08210F9170F89Ab7658F0B5E3fF39b0E03C594D4',
+        [Blockchain.Plasma_Testnet]: '0x98AfA0F93Dd993B736399f9074eDcEBD1985A330'
     }
 };
 
@@ -8881,7 +9025,7 @@ function parseOrThrow(value, schema, context) {
 }
 
 var name = "@circle-fin/unified-balance-kit";
-var version = "1.4.0";
+var version = "1.5.0";
 var pkg = {
 	name: name,
 	version: version};
@@ -9164,6 +9308,110 @@ var pkg = {
  * ```
  */ const USDC_DECIMALS$1 = 6;
 
+/**
+ * Canonical list of actions that do not prepare or submit transactions.
+ *
+ * @internal
+ */ const READ_ACTION_KEYS = [
+    'token.allowance',
+    'token.balanceOf',
+    'token.name',
+    'native.balanceOf',
+    'usdc.allowance',
+    'usdc.balanceOf',
+    'usdc.name',
+    'gateway.v1.isDelegate',
+    'gateway.v1.withdrawingBalance',
+    'gateway.v1.withdrawalBlock',
+    'gateway.v1.signBurnIntents'
+];
+const READ_ACTION_KEY_SET = new Set(READ_ACTION_KEYS);
+/**
+ * Check whether a runtime value identifies a read action.
+ *
+ * @param action - The value to classify.
+ * @returns Whether the value is a registered read-action key.
+ *
+ * @example
+ * ```typescript
+ * import { isReadActionKey } from '@core/adapter'
+ *
+ * if (isReadActionKey(value)) {
+ *   await adapter.readAction(value, params, context)
+ * }
+ * ```
+ *
+ * @internal
+ */ function isReadActionKey(action) {
+    return typeof action === 'string' && READ_ACTION_KEY_SET.has(action);
+}
+
+/**
+ * Create the standard error for a missing or non-read action.
+ *
+ * @param action - The unsupported action value.
+ * @returns A fatal unsupported-action error.
+ *
+ * @internal
+ */ function createUnsupportedReadActionError(action) {
+    return new KitError({
+        ...InputError.UNSUPPORTED_ACTION,
+        recoverability: 'FATAL',
+        message: `Read action "${String(action)}" is not registered in this adapter.`
+    });
+}
+/**
+ * Execute a read through the adapter's dedicated read seam when available.
+ *
+ * @remarks
+ * Fall back to the legacy `prepareAction().execute()` contract so providers
+ * remain runtime-compatible with adapter versions released before `readAction`.
+ * Consumers must upgrade their adapter package for reads to bypass custom
+ * `prepareAction` wrappers.
+ *
+ * @typeParam TAdapterCapabilities - The adapter capabilities type.
+ * @typeParam TActionKey - The read action key.
+ * @param adapter - The adapter that owns the read action.
+ * @param action - The read action to execute.
+ * @param params - The parameters for the read action.
+ * @param ctx - The operation context.
+ * @returns The raw read-action result.
+ * @throws {KitError} When `action` is not a supported read-action key.
+ *
+ * @example
+ * ```typescript
+ * import { executeAdapterReadAction } from '@core/adapter'
+ * import { Ethereum } from '@core/chains'
+ *
+ * const allowance = await executeAdapterReadAction(
+ *   adapter,
+ *   'token.allowance',
+ *   { tokenAddress, delegate },
+ *   { chain: Ethereum },
+ * )
+ * ```
+ *
+ * @internal
+ */ async function executeAdapterReadAction(adapter, action, params, ctx) {
+    if (!isReadActionKey(action)) {
+        throw createUnsupportedReadActionError(action);
+    }
+    const runtimeAdapter = adapter;
+    if (typeof runtimeAdapter.readAction === 'function') {
+        return runtimeAdapter.readAction(action, params, ctx);
+    }
+    let request;
+    try {
+        request = await adapter.prepareAction(action, params, ctx);
+    } catch (error) {
+        if (error instanceof Error && error.message === `Action ${action} is not supported`) {
+            throw createUnsupportedReadActionError(action);
+        }
+        throw error;
+    }
+    return request.execute();
+}
+
 /**
  * Schema for validating hexadecimal strings with '0x' prefix.
  *
@@ -9373,16 +9621,15 @@ var pkg = {
  * ```
  */ const validateBalanceForTransaction = async (params)=>{
     const { amount, adapter, token, tokenAddress, operationContext } = params;
-    const balancePrepared = await adapter.prepareAction('usdc.balanceOf', {
+    const balance = await executeAdapterReadAction(adapter, 'usdc.balanceOf', {
         walletAddress: operationContext.address
     }, operationContext);
-    const balance = await balancePrepared.execute();
-    if (BigInt(balance) < BigInt(amount)) {
+    if (BigInt(String(balance)) < BigInt(amount)) {
         // Extract chain name from operationContext
         const chainName = extractChainInfo(operationContext.chain).name;
         // Create KitError with rich context in trace
         throw createInsufficientTokenBalanceError(chainName, token, {
-            balance: balance.toString(),
+            balance: String(balance),
             amount,
             tokenAddress,
             walletAddress: operationContext.address
@@ -12354,6 +12601,23 @@ async function signUnits(group, signingUnits) {
     }
     return signedSets;
 }
+/**
+ * Fail loudly if a signing group carries an intent it does not own.
+ *
+ * Every intent in a group is signed by `group.address`, so that signer must own
+ * each intent's `spec.sourceSigner`. If distinct spend sources ever collapse
+ * into one group again (DEVX-3638), this throws before signing instead of
+ * silently producing a wrong-signer signature. specs are bytes32 and
+ * `group.address` is a native address, so normalize both before comparing.
+ */ function assertGroupSignerOwnsIntents(group) {
+    if (group.address == null || group.address === '') return;
+    const groupSigner = convertAddress(group.address, 'bytes32').toLowerCase();
+    for (const intent of group.intents){
+        if (intent.spec.sourceSigner.toLowerCase() !== groupSigner) {
+            throw createValidationFailedError$1('group.address', group.address, `Signing group for ${group.address} carries an intent whose ` + `sourceSigner is ${intent.spec.sourceSigner}; a group must be signed ` + 'by the wallet that owns every intent it carries. This indicates ' + 'distinct spend sources collapsed into a single signing group.');
+        }
+    }
+}
 /**
  * Sign an EVM adapter group.
  *
@@ -12396,22 +12660,42 @@ async function signUnits(group, signingUnits) {
     // Validate the collection before doing bytecode reads or asking a wallet
     // to sign. evmSigningData owns the canonical BurnIntent validation.
     validateGroupIntents(group.intents);
+    // Guard against a wrong-signer collapse: the group's signer must own every
+    // intent it carries.
+    assertGroupSignerOwnsIntents(group);
     const chainsByDomain = collectChainsByDomain(group);
     const signerTypeByDomain = await classifySignerTypes(group, chainsByDomain);
     const signingUnits = createSigningUnits(group, signerTypeByDomain);
     return await signUnits(group, signingUnits);
 }
 
+// One adapter instance can serve several signer addresses (e.g. a single
+// dev-controlled adapter used for multiple wallets), so the group map must be
+// keyed on `(adapter, sourceSigner)` rather than the adapter reference alone.
+// Keying on the adapter alone collapsed two same-chain sources into one group,
+// signing the second wallet's intent with the first wallet (DEVX-3638 /
+// DEVX-3194). A Map needs a primitive key, so give each adapter instance a
+// stable token and combine it with the (case-normalized) signer address.
+const adapterTokens = new WeakMap();
+let nextAdapterToken = 0;
+function groupKey(alloc) {
+    let token = adapterTokens.get(alloc.adapter);
+    if (token === undefined) {
+        token = nextAdapterToken++;
+        adapterTokens.set(alloc.adapter, token);
+    }
+    return `${String(token)}:${alloc.sourceSigner.toLowerCase()}`;
+}
 /**
  * Add an EVM intent into the batched EVM group map.
  *
- * On EVM, all intents for the same adapter are batched into a single
- * group. The signing step uses `chainsByDomain` to preserve EOA batching
+ * On EVM, all intents for the same adapter **and signer** are batched into a
+ * single group. The signing step uses `chainsByDomain` to preserve EOA batching
  * while signing ERC-1271 intents separately on their source chains.
  *
  * @param intent - The burn intent to group.
  * @param alloc - The allocation that resolved to this intent.
- * @param evmGroups - Mutable map of adapter → EVM group.
+ * @param evmGroups - Mutable map of `(adapter, sourceSigner)` key → EVM group.
  *
  * @example
  * ```typescript
@@ -12421,12 +12705,13 @@ async function signUnits(group, signingUnits) {
  * groupEvmIntents(intent, alloc, groups)
  * ```
  */ function groupEvmIntents(intent, alloc, evmGroups) {
-    const existing = evmGroups.get(alloc.adapter);
+    const key = groupKey(alloc);
+    const existing = evmGroups.get(key);
     if (existing) {
         existing.intents.push(intent);
         existing.chainsByDomain.set(alloc.chain.gateway.domain, alloc.chain);
     } else {
-        evmGroups.set(alloc.adapter, {
+        evmGroups.set(key, {
             adapter: alloc.adapter,
             chain: alloc.chain,
             intents: [
@@ -13455,6 +13740,8 @@ const gatewayInfoSchema = z.object({
  * Fetch Gateway info from the `/v1/info` endpoint.
  *
  * @param isTestnet - Whether to query the testnet or mainnet API.
+ * @param config - Optional polling config overrides, including custom
+ *   `headers` forwarded with the request.
  * @returns Parsed Gateway info including per-domain processed heights.
  * @throws KitError on HTTP failure or invalid response.
  *
@@ -13463,11 +13750,11 @@ const gatewayInfoSchema = z.object({
  * const info = await fetchGatewayInfo(true)
  * console.log(info.domains.map(d => `${d.chain}: ${d.processedHeight}`))
  * ```
- */ async function fetchGatewayInfo(isTestnet) {
+ */ async function fetchGatewayInfo(isTestnet, config) {
     const apiBaseUrl = getGatewayApiBaseUrl(isTestnet);
     const url = `${apiBaseUrl}/v1/info`;
     try {
-        return await pollApiGet(url, assertGatewayInfoResponse);
+        return await pollApiGet(url, assertGatewayInfoResponse, config);
     } catch (error) {
         if (error instanceof KitError) {
             throw error;
@@ -13493,6 +13780,8 @@ const gatewayInfoSchema = z.object({
  *
  * @param isTestnet - Whether to query the testnet or mainnet API.
  * @param domain - The Gateway domain number (e.g. 0 = Ethereum, 6 = Base).
+ * @param config - Optional polling config overrides, including custom
+ *   `headers` forwarded with the `/v1/info` request.
  * @returns The processed height as a bigint.
  * @throws KitError when the domain is not found in the response.
  *
@@ -13501,10 +13790,10 @@ const gatewayInfoSchema = z.object({
  * const height = await getProcessedHeight(true, 6) // Base Sepolia
  * console.log(`Gateway processed up to block ${height}`)
  * ```
- */ async function getProcessedHeight(isTestnet, domain) {
+ */ async function getProcessedHeight(isTestnet, domain, config) {
     // No caching in v1 — /v1/info is cheap and delegate status checks
     // are infrequent. Revisit if rate-limit or latency issues appear.
-    const info = await fetchGatewayInfo(isTestnet);
+    const info = await fetchGatewayInfo(isTestnet, config);
     const entry = info.domains.find((d)=>d.domain === domain);
     if (!entry) {
         throw new KitError({
@@ -13970,12 +14259,22 @@ function throwNetworkMismatch(expected, actual) {
  * @param allocations - Normalized allocations used to map domain → adapter/chain.
  * @returns Array of groups, each with adapter, chain, and intents to sign.
  */ function groupIntentsByAdapter(intents, allocations) {
+    // Keyed by `(adapter, sourceSigner)` (see groupEvmIntents), not by adapter
+    // alone: two spend sources on the same chain — including two addresses behind
+    // one shared adapter — must stay in separate signing groups.
     const evmGroups = new Map();
     const solanaGroups = [];
     for (const intent of intents){
-        const alloc = allocations.find((a)=>a.chain.gateway.domain === intent.spec.sourceDomain);
+        // Match each intent back to its source allocation by BOTH Gateway domain
+        // and signer. Two spend sources on the same chain share a domain, so
+        // matching on domain alone always returned the FIRST allocation — folding
+        // the second wallet's intent into the first wallet's signing group so it
+        // was signed by the wrong wallet (DEVX-3638). specs carry sourceSigner as
+        // bytes32 and allocations carry native addresses, so normalize both.
+        const intentSigner = intent.spec.sourceSigner.toLowerCase();
+        const alloc = allocations.find((a)=>a.chain.gateway.domain === intent.spec.sourceDomain && convertAddress(a.sourceSigner, 'bytes32').toLowerCase() === intentSigner);
         if (!alloc) {
-            throw createValidationFailedError$1('intent.spec.sourceDomain', intent.spec.sourceDomain, `No allocation found for sourceDomain ${String(intent.spec.sourceDomain)}; ` + 'estimate response contains an intent that does not match any allocation');
+            throw createValidationFailedError$1('intent.spec.sourceDomain', intent.spec.sourceDomain, `No allocation found for sourceDomain ${String(intent.spec.sourceDomain)} and sourceSigner ${String(intent.spec.sourceSigner)}; ` + 'estimate response contains an intent that does not match any allocation');
         }
         if (alloc.chain.type === 'solana') {
             solanaGroups.push(groupSolanaIntents(intent, alloc));
@@ -17392,12 +17691,12 @@ const FORWARDER_POLL_TIMEOUT_MS = 300_000;
  *   exceeds the 5-minute timeout without reaching a terminal status.
  * @throws KitError Propagated from {@link pollApiGet} if the HTTP
  *   request itself fails or returns a non-OK response.
- */ async function pollForwarderCompletion(apiBaseUrl, transferId) {
+ */ async function pollForwarderCompletion(apiBaseUrl, transferId, requestConfig) {
     const startTime = Date.now();
     while(Date.now() - startTime < FORWARDER_POLL_TIMEOUT_MS){
         let status;
         try {
-            status = await pollApiGet(`${apiBaseUrl}/v1/transfer/${transferId}`, assertGatewayTransferDetails);
+            status = await pollApiGet(`${apiBaseUrl}/v1/transfer/${transferId}`, assertGatewayTransferDetails, requestConfig);
         } catch (error) {
             throwGatewayApiError(error);
         }
@@ -17515,7 +17814,7 @@ const FORWARDER_POLL_TIMEOUT_MS = 300_000;
  * @param params - Spend parameters (source(s) and token).
  * @param destChain - Resolved destination chain (used for network type).
  * @returns Confirmed balances tagged with their originating source index.
- */ async function fetchChainBalances(params, destChain) {
+ */ async function fetchChainBalances(params, destChain, requestConfig) {
     const rawSources = Array.isArray(params.from) ? params.from : [
         params.from
     ];
@@ -17544,7 +17843,7 @@ const FORWARDER_POLL_TIMEOUT_MS = 300_000;
             token: params.token,
             sources: querySource,
             networkType
-        });
+        }, requestConfig);
     }));
     const chainBalances = [];
     for(let i = 0; i < balanceResults.length; i++){
@@ -17617,9 +17916,9 @@ const FORWARDER_POLL_TIMEOUT_MS = 300_000;
  * @param recipientAddress - Resolved recipient address.
  * @param useForwarder - Whether the Forwarding Service path is active.
  * @returns Allocations, intents, and (auto-allocation only) confirmed balances.
- */ async function resolveAllocationsAndIntents(params, destChain, recipientAddress, useForwarder) {
+ */ async function resolveAllocationsAndIntents(params, destChain, recipientAddress, useForwarder, requestConfig) {
     if (params.amountIn) {
-        const chainBalances = await fetchChainBalances(params, destChain);
+        const chainBalances = await fetchChainBalances(params, destChain, requestConfig);
         const { allocations, intents } = await buildAutoAllocatedFromBalances(params, destChain, recipientAddress, useForwarder, params.amountIn, chainBalances);
         return {
             allocations,
@@ -17642,11 +17941,11 @@ const FORWARDER_POLL_TIMEOUT_MS = 300_000;
  * @param useForwarder - Whether the Forwarding Service path is active.
  * @param allocations - Normalised allocations (forwarded to error handler).
  * @returns Estimate entries and optional forwarding fee.
- */ async function fetchEstimate(apiBaseUrl, estimateBody, useForwarder, allocations) {
+ */ async function fetchEstimate(apiBaseUrl, estimateBody, useForwarder, allocations, requestConfig) {
     if (useForwarder) {
         let fwdResponse;
         try {
-            fwdResponse = await pollApiPost(`${apiBaseUrl}/v1/estimate?enableForwarder=true`, estimateBody, assertGatewayForwarderEstimateResponse);
+            fwdResponse = await pollApiPost(`${apiBaseUrl}/v1/estimate?enableForwarder=true`, estimateBody, assertGatewayForwarderEstimateResponse, requestConfig);
         } catch (error) {
             throwGatewayApiError(error, allocations);
         }
@@ -17657,7 +17956,7 @@ const FORWARDER_POLL_TIMEOUT_MS = 300_000;
     }
     let entries;
     try {
-        entries = await pollApiPost(`${apiBaseUrl}/v1/estimate`, estimateBody, assertGatewayEstimateResponse);
+        entries = await pollApiPost(`${apiBaseUrl}/v1/estimate`, estimateBody, assertGatewayEstimateResponse, requestConfig);
     } catch (error) {
         throwGatewayApiError(error, allocations);
     }
@@ -17728,14 +18027,14 @@ const FORWARDER_POLL_TIMEOUT_MS = 300_000;
  * @param destChain - Resolved destination chain with Gateway v1 config.
  * @param useForwarder - Whether the Forwarding Service path is active.
  * @returns Estimated intents (with real maxFee) and optional forwarding fee.
- */ async function validateAndEstimate(allocations, intents, destChain, useForwarder) {
+ */ async function validateAndEstimate(allocations, intents, destChain, useForwarder, requestConfig) {
     assertNetworkCompatibility(allocations, destChain);
     if (useForwarder) {
         assertForwarderRouteSupport(destChain, allocations);
     }
     const apiBaseUrl = getGatewayApiBaseUrl(destChain.isTestnet);
     const estimateBody = buildEstimateRequestBody(intents);
-    const { entries, forwardingFee } = await fetchEstimate(apiBaseUrl, estimateBody, useForwarder, allocations);
+    const { entries, forwardingFee } = await fetchEstimate(apiBaseUrl, estimateBody, useForwarder, allocations, requestConfig);
     const estimatedIntents = parseEstimateResponse(entries, intents);
     return {
         estimatedIntents,
@@ -17794,7 +18093,7 @@ const FORWARDER_POLL_TIMEOUT_MS = 300_000;
             }
             throw err;
         }
-        const { estimatedIntents, forwardingFee } = await validateAndEstimate(corrected.allocations, corrected.intents, opts.destChain, opts.useForwarder);
+        const { estimatedIntents, forwardingFee } = await validateAndEstimate(corrected.allocations, corrected.intents, opts.destChain, opts.useForwarder, opts.requestConfig);
         const stillOverdrawn = findOverdrawnChains(estimatedIntents, corrected.allocations, opts.chainBalances);
         if (stillOverdrawn.length === 0) {
             return {
@@ -17828,12 +18127,12 @@ const FORWARDER_POLL_TIMEOUT_MS = 300_000;
  * @param recipientAddress - Resolved recipient address.
  * @param useForwarder - Whether the Forwarding Service path is active.
  * @returns Allocations, estimated intents, and optional forwarding fee.
- */ async function resolveValidatedIntents(params, destChain, recipientAddress, useForwarder) {
+ */ async function resolveValidatedIntents(params, destChain, recipientAddress, useForwarder, requestConfig) {
     if (useForwarder) {
         assertForwarderRouteSupport(destChain);
     }
-    const { allocations, intents, chainBalances } = await resolveAllocationsAndIntents(params, destChain, recipientAddress, useForwarder);
-    const { estimatedIntents, forwardingFee } = await validateAndEstimate(allocations, intents, destChain, useForwarder);
+    const { allocations, intents, chainBalances } = await resolveAllocationsAndIntents(params, destChain, recipientAddress, useForwarder, requestConfig);
+    const { estimatedIntents, forwardingFee } = await validateAndEstimate(allocations, intents, destChain, useForwarder, requestConfig);
     if (params.amountIn && chainBalances) {
         const overdrawn = findOverdrawnChains(estimatedIntents, allocations, chainBalances);
         if (overdrawn.length > 0) {
@@ -17846,7 +18145,10 @@ const FORWARDER_POLL_TIMEOUT_MS = 300_000;
                 chainBalances,
                 estimatedIntents,
                 allocations,
-                overdrawn
+                overdrawn,
+                ...requestConfig ? {
+                    requestConfig
+                } : {}
             });
         }
     }
@@ -17890,10 +18192,10 @@ const FORWARDER_POLL_TIMEOUT_MS = 300_000;
         attestationSignature: transferResponse.signature
     };
 }
-async function runSpendNormalPath(params, destChain, useForwarder, dispatcher, steps) {
+async function runSpendNormalPath(params, destChain, useForwarder, dispatcher, steps, requestConfig) {
     const chainName = destChain.name;
     const recipientAddress = await resolveRecipientAddress(params.to);
-    const { allocations, estimatedIntents, forwardingFee: estimateFwdFee } = await resolveValidatedIntents(params, destChain, recipientAddress, useForwarder);
+    const { allocations, estimatedIntents, forwardingFee: estimateFwdFee } = await resolveValidatedIntents(params, destChain, recipientAddress, useForwarder, requestConfig);
     pushStep(steps, dispatcher, 'gateway.spend.step.buildBurnIntents', chainName, {
         name: 'buildBurnIntents',
         state: 'success',
@@ -17930,7 +18232,7 @@ async function runSpendNormalPath(params, destChain, useForwarder, dispatcher, s
     const forwarderParam = useForwarder ? '?enableForwarder=true' : '';
     let transferResponse;
     try {
-        transferResponse = await pollApiPost(`${transferApiBaseUrl}/v1/transfer${forwarderParam}`, transferBody, assertGatewayTransferResponse);
+        transferResponse = await pollApiPost(`${transferApiBaseUrl}/v1/transfer${forwarderParam}`, transferBody, assertGatewayTransferResponse, requestConfig);
     } catch (error) {
         throwGatewayApiError(error, allocations);
     }
@@ -18010,10 +18312,11 @@ function updateFeesWithActual(fees, completionStatus) {
             amount: actual
         } : f);
 }
-async function resolveDestinationTxHash(params, destChain, forwarder, transferId, attestation, attestationSignature, fees) {
+async function resolveDestinationTxHash(opts) {
+    const { params, destChain, forwarder, transferId, attestation, attestationSignature, fees, requestConfig } = opts;
     if (forwarder && transferId) {
         const apiBaseUrl = getGatewayApiBaseUrl(destChain.isTestnet);
-        const completionStatus = await pollForwarderCompletion(apiBaseUrl, transferId);
+        const completionStatus = await pollForwarderCompletion(apiBaseUrl, transferId, requestConfig);
         if (!completionStatus.transactionHash) {
             throw new KitError({
                 ...OnchainError.TRANSACTION_REVERTED,
@@ -18096,9 +18399,20 @@ function buildSpendResult(recipientAddress, destChain, txHash, allocationResults
 /**
  * Execute the mint step, recording success/error as a spend step.
  */ async function executeMintStep(opts) {
-    const { params, destChain, forwarder, transferId, attestation, attestationSignature, fees, steps, dispatcher } = opts;
+    const { params, destChain, forwarder, transferId, attestation, attestationSignature, fees, steps, dispatcher, requestConfig } = opts;
     try {
-        const mintResult = await resolveDestinationTxHash(params, destChain, forwarder, transferId, attestation, attestationSignature, fees);
+        const mintResult = await resolveDestinationTxHash({
+            params,
+            destChain,
+            forwarder,
+            transferId,
+            attestation,
+            attestationSignature,
+            fees,
+            ...requestConfig ? {
+                requestConfig
+            } : {}
+        });
         pushStep(steps, dispatcher, 'gateway.spend.step.mint', destChain.name, {
             name: 'mint',
             state: 'success',
@@ -18153,7 +18467,8 @@ function buildSpendResult(recipientAddress, destChain, txHash, allocationResults
     assertSpendAddresses(params, destChain);
     const forwarder = isForwarderEnabled(params.to);
     const steps = [];
-    const context = params.config?.retry ? await resolveRetryContext(params) : await resolveNormalContext(params, destChain, forwarder, dispatcher, steps);
+    const requestConfig = options?.requestConfig;
+    const context = params.config?.retry ? await resolveRetryContext(params) : await resolveNormalContext(params, destChain, forwarder, dispatcher, steps, requestConfig);
     const fees = appendForwarderFee(context.fees, context.forwardingFee);
     const mintResult = await executeMintStep({
         params,
@@ -18164,7 +18479,10 @@ function buildSpendResult(recipientAddress, destChain, txHash, allocationResults
         attestationSignature: context.attestationSignature,
         fees,
         steps,
-        dispatcher
+        dispatcher,
+        ...requestConfig ? {
+            requestConfig
+        } : {}
     });
     // A throwing `onBroadcast` must never strand the caller after a
     // successful mint — the chain has moved. `safeInvokeCallback` swallows
@@ -18181,14 +18499,14 @@ function buildSpendResult(recipientAddress, destChain, txHash, allocationResults
 /**
  * Resolve the spend context via the normal (non-retry) path.
  * Validates `from`, then delegates to `runSpendNormalPath`.
- */ async function resolveNormalContext(params, destChain, forwarder, dispatcher, steps) {
+ */ async function resolveNormalContext(params, destChain, forwarder, dispatcher, steps, requestConfig) {
     if (!params.from) {
         throw createValidationFailedError$1('from', params.from, 'Source (from) is required when config.retry is not provided.');
     }
     return runSpendNormalPath({
         ...params,
         from: params.from
-    }, destChain, forwarder, dispatcher, steps);
+    }, destChain, forwarder, dispatcher, steps, requestConfig);
 }
 /**
  * Estimate fees for a Gateway spend without executing it.
@@ -18211,13 +18529,13 @@ function buildSpendResult(recipientAddress, destChain, txHash, allocationResults
  * })
  * fees.forEach((f) => console.log(f.type, f.amount, f.allocations))
  * ```
- */ async function estimateSpend$1(params) {
+ */ async function estimateSpend$1(params, requestConfig) {
     const destChain = resolveChainIdentifier(params.to.chain);
     assertGatewayV1(destChain);
     assertSpendAddresses(params, destChain);
     const forwarder = isForwarderEnabled(params.to);
     const recipientAddress = await resolveRecipientAddress(params.to);
-    const { allocations, estimatedIntents, forwardingFee } = await resolveValidatedIntents(params, destChain, recipientAddress, forwarder);
+    const { allocations, estimatedIntents, forwardingFee } = await resolveValidatedIntents(params, destChain, recipientAddress, forwarder, requestConfig);
     const fees = computeEstimateFees(estimatedIntents, allocations, params.config?.customFee);
     if (forwardingFee) {
         fees.push({
@@ -18341,6 +18659,9 @@ function assertNotSelfDelegation(chain, signerAddress, delegateAddress, action)
  *    the delegate is `'ready'` (finalized); otherwise it is `'pending'`.
  *
  * @param params - The adapter context (`from`), delegate address, and token.
+ * @param requestConfig - Optional polling config overrides, including custom
+ *   `headers` forwarded with the `/v1/info` request used on the EVM finality
+ *   check.
  * @returns Promise resolving to `'none'`, `'pending'`, or `'ready'`.
  * @throws KitError if the chain is unsupported or `/v1/info` fails.
  *
@@ -18360,7 +18681,7 @@ function assertNotSelfDelegation(chain, signerAddress, delegateAddress, action)
  * const status = await getDelegateStatus(params)
  * if (status === 'ready') { // safe to spend }
  * ```
- */ async function getDelegateStatus$1(params) {
+ */ async function getDelegateStatus$1(params, requestConfig) {
     const { from, delegateAddress } = params;
     const { adapter } = from;
     const chain = resolveChainIdentifier(from.chain);
@@ -18376,8 +18697,7 @@ function assertNotSelfDelegation(chain, signerAddress, delegateAddress, action)
         chain
     };
     // Step 1: Quick check at latest block (no HTTP call)
-    const latestRequest = await adapter.prepareAction('gateway.v1.isDelegate', baseActionParams, operationContext);
-    const latestResult = await latestRequest.execute();
+    const latestResult = await executeAdapterReadAction(adapter, 'gateway.v1.isDelegate', baseActionParams, operationContext);
     if (String(latestResult).toLowerCase() !== 'true') {
         return 'none';
     }
@@ -18386,13 +18706,12 @@ function assertNotSelfDelegation(chain, signerAddress, delegateAddress, action)
         // Solana uses confirmed vs finalized commitment as a proxy for
         // Gateway finality. This is conservative — can only over-report
         // 'pending', never falsely report 'ready'.
-        const finalizedRequest = await adapter.prepareAction('gateway.v1.isDelegate', {
-            ...baseActionParams,
-            commitment: 'finalized'
-        }, operationContext);
         let finalizedResult;
         try {
-            finalizedResult = await finalizedRequest.execute();
+            finalizedResult = await executeAdapterReadAction(adapter, 'gateway.v1.isDelegate', {
+                ...baseActionParams,
+                commitment: 'finalized'
+            }, operationContext);
         } catch (error) {
             if (isBlockRangeError(error)) {
                 return 'pending';
@@ -18402,11 +18721,7 @@ function assertNotSelfDelegation(chain, signerAddress, delegateAddress, action)
         return String(finalizedResult).toLowerCase() === 'true' ? 'ready' : 'pending';
     }
     // EVM: use processedHeight from /v1/info
-    const processedHeight = await getProcessedHeight(chain.isTestnet, chain.gateway.domain);
-    const finalizedRequest = await adapter.prepareAction('gateway.v1.isDelegate', {
-        ...baseActionParams,
-        blockNumber: processedHeight
-    }, operationContext);
+    const processedHeight = await getProcessedHeight(chain.isTestnet, chain.gateway.domain, requestConfig);
     // If the RPC node lags Gateway's indexer view, the historical read at
     // processedHeight may throw a block-range error. This is safe to treat
     // as 'pending' because processedHeight comes from Gateway's /v1/info
@@ -18415,7 +18730,10 @@ function assertNotSelfDelegation(chain, signerAddress, delegateAddress, action)
     // Re-throw structural errors to avoid masking real bugs.
     let finalizedResult;
     try {
-        finalizedResult = await finalizedRequest.execute();
+        finalizedResult = await executeAdapterReadAction(adapter, 'gateway.v1.isDelegate', {
+            ...baseActionParams,
+            blockNumber: processedHeight
+        }, operationContext);
     } catch (error) {
         if (isBlockRangeError(error)) {
             return 'pending';
@@ -18476,8 +18794,8 @@ function parseAmountSafe(amount) {
         chain
     };
     const [withdrawingRaw, withdrawalBlockRaw] = await Promise.all([
-        adapter.prepareAction('gateway.v1.withdrawingBalance', readParams, operationContext).then(async (req)=>req.execute()),
-        adapter.prepareAction('gateway.v1.withdrawalBlock', readParams, operationContext).then(async (req)=>req.execute())
+        executeAdapterReadAction(adapter, 'gateway.v1.withdrawingBalance', readParams, operationContext),
+        executeAdapterReadAction(adapter, 'gateway.v1.withdrawalBlock', readParams, operationContext)
     ]);
     const withdrawingValue = safeBigInt(String(withdrawingRaw), 'withdrawingBalance');
     const withdrawalBlockValue = safeBigInt(String(withdrawalBlockRaw), 'withdrawalBlock');
@@ -18517,12 +18835,11 @@ function parseAmountSafe(amount) {
     const tokenAddress = getTokenAddress(chain, params.token);
     // Read the pending balance before withdrawing — the contract resets it to 0
     // after withdraw() executes, so this is the only way to capture the amount.
-    const withdrawingBalanceReq = await adapter.prepareAction('gateway.v1.withdrawingBalance', {
+    const withdrawingRaw = await executeAdapterReadAction(adapter, 'gateway.v1.withdrawingBalance', {
         token: tokenAddress,
         depositor: signerAddress,
         chain
     }, operationContext);
-    const withdrawingRaw = await withdrawingBalanceReq.execute();
     const withdrawingValue = safeBigInt(String(withdrawingRaw), 'withdrawingBalance');
     if (withdrawingValue === 0n) {
         throw new KitError({
@@ -18622,6 +18939,35 @@ function dispatchEvent(dispatcher, opName, stage, chain, data) {
     dispatchEvent(dispatcher, opName, 'failed', chain, extractErrorInfo(error));
 }
 
+// ---------------------------------------------------------------------------
+// Config validation
+// ---------------------------------------------------------------------------
+function isPlainObject(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        return false;
+    }
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+function assertHeadersConfig(headers) {
+    if (headers === undefined) {
+        return;
+    }
+    if (!isPlainObject(headers)) {
+        throw createValidationFailedError$1('config.headers', headers, 'config.headers must be a plain object with string header values when provided');
+    }
+    for (const [name, value] of Object.entries(headers)){
+        if (typeof value !== 'string') {
+            throw createValidationFailedError$1(`config.headers.${name}`, value, 'header values must be strings');
+        }
+    }
+}
+function assertGatewayV1Config(config) {
+    if (!isPlainObject(config)) {
+        throw createValidationFailedError$1('config', config, 'config must be a plain object when provided');
+    }
+    assertHeadersConfig(config['headers']);
+}
 // ---------------------------------------------------------------------------
 // Factory
 // ---------------------------------------------------------------------------
@@ -18631,7 +18977,12 @@ function dispatchEvent(dispatcher, opName, stage, chain, data) {
  * Returns a plain object that implements {@link IGatewayProvider} by
  * delegating to the standalone functions in `operations/`.
  *
+ * @param config - Optional provider configuration. Supply `headers` to
+ *   forward custom HTTP headers with every Gateway API request. See
+ *   {@link GatewayV1Config}.
  * @returns An {@link IGatewayProvider} instance.
+ * @throws Throws when `config` or `config.headers` is not a plain object, or a
+ *   header value is not a string.
  *
  * @example
  * ```typescript
@@ -18640,7 +18991,23 @@ function dispatchEvent(dispatcher, opName, stage, chain, data) {
  * const provider = createGatewayV1Provider()
  * const chains = provider.getSupportedChains()
  * ```
- */ function createGatewayV1Provider() {
+ *
+ * @example
+ * ```typescript
+ * // Forward a custom header on every Gateway API request.
+ * const provider = createGatewayV1Provider({
+ *   headers: { 'X-Access-Key': process.env.GATEWAY_ACCESS_KEY! },
+ * })
+ * ```
+ */ function createGatewayV1Provider(config = {}) {
+    assertGatewayV1Config(config);
+    // Captured once and threaded to every Gateway API call the operations make,
+    // so a configured header reaches balances, estimate, transfer, forwarder
+    // status, and /v1/info alike. Left undefined when no headers are configured
+    // so the operations keep their existing defaults untouched.
+    const requestConfig = config.headers ? {
+        headers: config.headers
+    } : undefined;
     /**
    * Execute an operation with started/succeeded/failed event dispatch.
    */ async function withEvents(opName, chain, startedData, params, fn) {
@@ -18671,21 +19038,25 @@ function dispatchEvent(dispatcher, opName, stage, chain, data) {
             }, params, depositFor$1),
         spend: async (params, options)=>{
             const destChainName = extractChainInfo(params.to.chain).name;
+            const mergedOptions = requestConfig ? {
+                ...options,
+                requestConfig
+            } : options;
             return withEvents('spend', destChainName, {
                 destinationChain: destChainName,
                 token: params.token ?? 'USDC'
-            }, params, async (p)=>spend$1(p, provider.actionDispatcher, options));
+            }, params, async (p)=>spend$1(p, provider.actionDispatcher, mergedOptions));
         },
         estimateSpend: async (params)=>{
             const destChainName = extractChainInfo(params.to.chain).name;
             return withEvents('estimateSpend', destChainName, {
                 destinationChain: destChainName,
                 token: params.token ?? 'USDC'
-            }, params, estimateSpend$1);
+            }, params, async (p)=>estimateSpend$1(p, requestConfig));
         },
         getBalances: async (params)=>withEvents('getBalances', 'aggregate', {
                 token: params.token ?? 'USDC'
-            }, params, getBalances$1),
+            }, params, async (p)=>getBalances$1(p, requestConfig)),
         addDelegate: async (params)=>withEvents('addDelegate', extractChainInfo(params.from.chain).name, {
                 delegateAddress: params.delegateAddress
             }, params, addDelegate$1),
@@ -18703,7 +19074,9 @@ function dispatchEvent(dispatcher, opName, stage, chain, data) {
         // in withEvents. getSupportedChains is synchronous. getDelegateStatus is a
         // lightweight read that consumers treat as a utility check, unlike
         // getBalances which involves API polling and benefits from lifecycle events.
-        getDelegateStatus: getDelegateStatus$1,
+        // getDelegateStatus is wrapped to forward the provider's request config to
+        // its /v1/info call; getSupportedChains makes no API call.
+        getDelegateStatus: async (params)=>getDelegateStatus$1(params, requestConfig),
         getSupportedChains: getSupportedChains$1
     };
     return provider;
@@ -18713,6 +19086,7 @@ function dispatchEvent(dispatcher, opName, stage, chain, data) {
  * The default providers that will be used in addition to the providers
  * provided to the createUnifiedBalanceKitContext factory function.
  *
+ * @param config - Optional configuration forwarded to the default provider.
  * @returns A readonly tuple with one element: the default Gateway v1 provider
  *   instance created via {@link createGatewayV1Provider}.
  * @internal
@@ -18724,8 +19098,10 @@ function dispatchEvent(dispatcher, opName, stage, chain, data) {
  * const { providers } = createUnifiedBalanceKitContext()
  * // providers[0] is the default Gateway v1 instance from getDefaultProviders()
  * ```
- */ const getDefaultProviders = ()=>[
-        createGatewayV1Provider()
+ */ const getDefaultProviders = (config = {})=>[
+        createGatewayV1Provider(config.headers ? {
+            headers: config.headers
+        } : {})
     ];
 function createUnifiedBalanceKitContext(config = {}) {
     // Runtime guard: `excludeDefaultProviders: true` with no `providers` is
@@ -18739,7 +19115,10 @@ function createUnifiedBalanceKitContext(config = {}) {
     // Initialize default providers — either the canonical singleton tuple or
     // an empty list when the caller has opted out. Typed loosely here; each
     // public overload narrows the return type for callers.
-    const defaultProviders = config.excludeDefaultProviders === true ? [] : getDefaultProviders();
+    const defaultProvidersConfig = config.headers ? {
+        headers: config.headers
+    } : {};
+    const defaultProviders = config.excludeDefaultProviders === true ? [] : getDefaultProviders(defaultProvidersConfig);
     const providers = [
         ...defaultProviders,
         ...config.providers ?? []
@@ -19430,29 +19809,65 @@ function sumAllocationsFromSources(sources) {
     }
 });
 
+function normalizeAddressIdentity(value) {
+    if (typeof value !== 'string') return undefined;
+    try {
+        return convertAddress(value, 'bytes32').toLowerCase();
+    } catch  {
+        // Address validation below owns the structured error for invalid input.
+        return value;
+    }
+}
 /**
- * Reject `from` arrays containing the same adapter reference more than once.
- * Must run on the raw input (before Zod parsing) because `z.object()` creates
- * new wrapper objects and identity (`===`) is lost.
+ * Reject `from` arrays that describe the same spend source more than once.
+ *
+ * One adapter instance may legitimately be reused across distinct Gateway
+ * source accounts. When `sourceAccount` is omitted, the signer address
+ * identifies the source. Must run on the raw input (before Zod parsing)
+ * because `z.object()` creates new wrapper objects and adapter identity
+ * (`===`) is lost.
  *
  * @internal
- */ function assertNoDuplicateAdapters(params) {
+ */ function assertNoDuplicateSpendSources(params) {
     if (params == null || typeof params !== 'object') return;
     const from = params['from'];
     if (!Array.isArray(from) || from.length < 2) return;
-    const seen = new Set();
+    const seen = new Map();
     for (const source of from){
         if (source == null || typeof source !== 'object') continue;
-        const adapter = source['adapter'];
+        const record = source;
+        const adapter = record['adapter'];
         if (adapter == null) continue;
-        if (seen.has(adapter)) {
+        const sourceAccount = normalizeAddressIdentity(record['sourceAccount']) ?? normalizeAddressIdentity(record['address']);
+        let sourceAccounts = seen.get(adapter);
+        if (sourceAccounts == null) {
+            sourceAccounts = new Set();
+            seen.set(adapter, sourceAccounts);
+        }
+        if (sourceAccounts.has(sourceAccount)) {
             throw new KitError({
                 ...InputError.VALIDATION_FAILED,
                 recoverability: 'FATAL',
-                message: 'Duplicate adapter instance detected in from array. ' + 'Each source must use a distinct adapter object.'
+                message: 'Duplicate spend source detected in from array. The same adapter ' + 'and Gateway source account are reused more than once.'
             });
         }
-        seen.add(adapter);
+        sourceAccounts.add(sourceAccount);
+    }
+}
+function assertSourceAddressContexts(from) {
+    const sources = Array.isArray(from) ? from : [
+        from
+    ];
+    for (const raw of sources){
+        if (raw == null || typeof raw !== 'object') continue;
+        const source = raw;
+        const addressContext = source.adapter?.capabilities?.addressContext;
+        if (addressContext === 'developer-controlled' && (typeof source.address !== 'string' || source.address === '')) {
+            throw createValidationFailedError$1('address', source.address, 'Address is required for developer-controlled adapters.');
+        }
+        if (addressContext === 'user-controlled' && source.address !== undefined) {
+            throw createValidationFailedError$1('address', source.address, 'Address should not be provided for user-controlled adapters. ' + 'The address is automatically resolved from the connected wallet.');
+        }
     }
 }
 /**
@@ -19466,14 +19881,17 @@ function sumAllocationsFromSources(sources) {
  * @throws \{KitError\} When validation fails; error code is
  *   {@link InputError.VALIDATION_FAILED}.
  */ function assertSpendParams(params) {
-    assertNoDuplicateAdapters(params);
+    assertNoDuplicateSpendSources(params);
+    if (params != null && typeof params === 'object' && 'from' in params) {
+        assertSourceAddressContexts(params['from']);
+    }
     const result = spendParamsSchema.safeParse(params);
     if (!result.success) {
         throw convertZodErrorToStructured(result.error, params);
     }
     const data = result.data;
     // Validate recipientAddress against the destination chain
-    if (data.to.recipientAddress) {
+    if (data.to.recipientAddress !== undefined && data.to.recipientAddress !== '') {
         const toChain = data.to.chain;
         if (!isValidAddressForChain(data.to.recipientAddress, toChain)) {
             const chainInfo = extractChainInfo(toChain);
@@ -19481,7 +19899,7 @@ function sumAllocationsFromSources(sources) {
         }
     }
     // Validate sourceAccount against each source's allocation chain
-    if (data.from) {
+    if (data.from !== undefined) {
         assertSourceAccountAddresses(data.from);
     }
 }
@@ -19496,11 +19914,15 @@ function assertSourceAccountAddresses(from) {
         from
     ];
     for (const raw of sources){
-        if (!raw || typeof raw !== 'object' || !('sourceAccount' in raw)) continue;
+        if (raw === null || typeof raw !== 'object' || !('sourceAccount' in raw)) {
+            continue;
+        }
         const source = raw;
-        if (!source.sourceAccount) continue;
+        if (source.sourceAccount === undefined || source.sourceAccount === '') {
+            continue;
+        }
         const sourceChain = getSourceChainFromAllocations(source.allocations);
-        if (!sourceChain) continue;
+        if (sourceChain === undefined) continue;
         if (!isValidAddressForChain(source.sourceAccount, sourceChain)) {
             const chainInfo = extractChainInfo(sourceChain);
             throw createInvalidAddressError(source.sourceAccount, String(chainInfo.name), chainInfo.expectedAddressFormat);