@circle-fin/provider-cctp-v2 1.3.0 → 1.3.1

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @circle-fin/provider-cctp-v2
 
+## 1.3.1
+
+### Patch Changes
+
+- Fix for native token balance validation fails for Gas Station–enabled wallets when either the source or destination chain has zero native token balance
+
 ## 1.3.0
 
 ### Minor Changes

package/index.cjs

@@ -3742,12 +3742,6 @@ const BalanceError = {
         code: 9001,
         name: 'BALANCE_INSUFFICIENT_TOKEN',
         type: 'BALANCE',
-    },
-    /** Insufficient native token (ETH/SOL/etc) for gas fees */
-    INSUFFICIENT_GAS: {
-        code: 9002,
-        name: 'BALANCE_INSUFFICIENT_GAS',
-        type: 'BALANCE',
     }};
 /**
  * Standardized error definitions for ONCHAIN type errors.
@@ -4034,49 +4028,6 @@ function createInsufficientTokenBalanceError(chain, token, trace) {
         },
     });
 }
-/**
- * Creates error for insufficient gas funds.
- *
- * This error is thrown when a wallet does not have enough native tokens
- * (ETH, SOL, etc.) to pay for transaction gas fees. The error is FATAL
- * as it requires user intervention to add gas funds.
- *
- * @param chain - The blockchain network where the gas check failed
- * @param trace - Optional trace context to include in error (can include rawError and additional debugging data)
- * @returns KitError with insufficient gas details
- *
- * @example
- * ```typescript
- * import { createInsufficientGasError } from '@core/errors'
- *
- * throw createInsufficientGasError('Ethereum')
- * // Message: "Insufficient gas funds on Ethereum"
- * ```
- *
- * @example
- * ```typescript
- * // With trace context for debugging
- * throw createInsufficientGasError('Ethereum', {
- *   rawError: error,
- *   gasRequired: '21000',
- *   gasAvailable: '10000',
- *   walletAddress: '0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb',
- * })
- * ```
- */
-function createInsufficientGasError(chain, trace) {
-    return new KitError({
-        ...BalanceError.INSUFFICIENT_GAS,
-        recoverability: 'FATAL',
-        message: `Insufficient gas funds on ${chain}`,
-        cause: {
-            trace: {
-                ...trace,
-                chain,
-            },
-        },
-    });
-}
 
 /**
  * Creates error for transaction simulation failures.
@@ -6721,58 +6672,6 @@ const validateBalanceForTransaction = async (params) => {
     }
 };
 
-/**
- * Validate that the adapter has sufficient native token balance for transaction fees.
- *
- * This function checks if the adapter's current native token balance (ETH, SOL, etc.)
- * is greater than zero. It throws a KitError with code 9002 (BALANCE_INSUFFICIENT_GAS)
- * if the balance is zero, indicating the wallet cannot pay for transaction fees.
- *
- * @param params - The validation parameters containing adapter and operation context.
- * @returns A promise that resolves to void if validation passes.
- * @throws {KitError} When the adapter's native balance is zero (code: 9002).
- *
- * @example
- * ```typescript
- * import { validateNativeBalanceForTransaction } from '@core/adapter'
- * import { createViemAdapterFromPrivateKey } from '@circle-fin/adapter-viem-v2'
- * import { isKitError, ERROR_TYPES } from '@core/errors'
- *
- * const adapter = createViemAdapterFromPrivateKey({
- *   privateKey: '0x...',
- *   chain: 'Ethereum',
- * })
- *
- * try {
- *   await validateNativeBalanceForTransaction({
- *     adapter,
- *     operationContext: { chain: 'Ethereum' },
- *   })
- *   console.log('Native balance validation passed')
- * } catch (error) {
- *   if (isKitError(error) && error.type === ERROR_TYPES.BALANCE) {
- *     console.error('Insufficient gas funds:', error.message)
- *   }
- * }
- * ```
- */
-const validateNativeBalanceForTransaction = async (params) => {
-    const { adapter, operationContext } = params;
-    const balancePrepared = await adapter.prepareAction('native.balanceOf', {
-        walletAddress: operationContext.address,
-    }, operationContext);
-    const balance = await balancePrepared.execute();
-    if (BigInt(balance) === 0n) {
-        // Extract chain name from operationContext
-        const chainName = extractChainInfo(operationContext.chain).name;
-        // Create KitError with rich context in trace
-        throw createInsufficientGasError(chainName, {
-            balance: '0',
-            walletAddress: operationContext.address,
-        });
-    }
-};
-
 /**
  * CCTP bridge step names that can occur in the bridging flow.
  *
@@ -7823,7 +7722,7 @@ class CCTPV2BridgingProvider extends BridgingProvider {
     async bridge(params) {
         // CCTP-specific bridge params validation (includes base validation)
         assertCCTPv2BridgeParams(params);
-        const { source, destination, amount, token } = params;
+        const { source, amount, token } = params;
         // Extract operation context from source wallet context for balance validation
         const sourceOperationContext = this.extractOperationContext(source);
         // Validate USDC balance for transaction on source chain
@@ -7834,18 +7733,6 @@ class CCTPV2BridgingProvider extends BridgingProvider {
             tokenAddress: source.chain.usdcAddress,
             operationContext: sourceOperationContext,
         });
-        // Validate native balance > 0 for gas fees on source chain
-        await validateNativeBalanceForTransaction({
-            adapter: source.adapter,
-            operationContext: sourceOperationContext,
-        });
-        // Extract operation context from destination wallet context
-        const destinationOperationContext = this.extractOperationContext(destination);
-        // Validate native balance > 0 for gas fees on destination chain
-        await validateNativeBalanceForTransaction({
-            adapter: destination.adapter,
-            operationContext: destinationOperationContext,
-        });
         return bridge(params, this);
     }
     /**

package/index.mjs

@@ -3736,12 +3736,6 @@ const BalanceError = {
         code: 9001,
         name: 'BALANCE_INSUFFICIENT_TOKEN',
         type: 'BALANCE',
-    },
-    /** Insufficient native token (ETH/SOL/etc) for gas fees */
-    INSUFFICIENT_GAS: {
-        code: 9002,
-        name: 'BALANCE_INSUFFICIENT_GAS',
-        type: 'BALANCE',
     }};
 /**
  * Standardized error definitions for ONCHAIN type errors.
@@ -4028,49 +4022,6 @@ function createInsufficientTokenBalanceError(chain, token, trace) {
         },
     });
 }
-/**
- * Creates error for insufficient gas funds.
- *
- * This error is thrown when a wallet does not have enough native tokens
- * (ETH, SOL, etc.) to pay for transaction gas fees. The error is FATAL
- * as it requires user intervention to add gas funds.
- *
- * @param chain - The blockchain network where the gas check failed
- * @param trace - Optional trace context to include in error (can include rawError and additional debugging data)
- * @returns KitError with insufficient gas details
- *
- * @example
- * ```typescript
- * import { createInsufficientGasError } from '@core/errors'
- *
- * throw createInsufficientGasError('Ethereum')
- * // Message: "Insufficient gas funds on Ethereum"
- * ```
- *
- * @example
- * ```typescript
- * // With trace context for debugging
- * throw createInsufficientGasError('Ethereum', {
- *   rawError: error,
- *   gasRequired: '21000',
- *   gasAvailable: '10000',
- *   walletAddress: '0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb',
- * })
- * ```
- */
-function createInsufficientGasError(chain, trace) {
-    return new KitError({
-        ...BalanceError.INSUFFICIENT_GAS,
-        recoverability: 'FATAL',
-        message: `Insufficient gas funds on ${chain}`,
-        cause: {
-            trace: {
-                ...trace,
-                chain,
-            },
-        },
-    });
-}
 
 /**
  * Creates error for transaction simulation failures.
@@ -6715,58 +6666,6 @@ const validateBalanceForTransaction = async (params) => {
     }
 };
 
-/**
- * Validate that the adapter has sufficient native token balance for transaction fees.
- *
- * This function checks if the adapter's current native token balance (ETH, SOL, etc.)
- * is greater than zero. It throws a KitError with code 9002 (BALANCE_INSUFFICIENT_GAS)
- * if the balance is zero, indicating the wallet cannot pay for transaction fees.
- *
- * @param params - The validation parameters containing adapter and operation context.
- * @returns A promise that resolves to void if validation passes.
- * @throws {KitError} When the adapter's native balance is zero (code: 9002).
- *
- * @example
- * ```typescript
- * import { validateNativeBalanceForTransaction } from '@core/adapter'
- * import { createViemAdapterFromPrivateKey } from '@circle-fin/adapter-viem-v2'
- * import { isKitError, ERROR_TYPES } from '@core/errors'
- *
- * const adapter = createViemAdapterFromPrivateKey({
- *   privateKey: '0x...',
- *   chain: 'Ethereum',
- * })
- *
- * try {
- *   await validateNativeBalanceForTransaction({
- *     adapter,
- *     operationContext: { chain: 'Ethereum' },
- *   })
- *   console.log('Native balance validation passed')
- * } catch (error) {
- *   if (isKitError(error) && error.type === ERROR_TYPES.BALANCE) {
- *     console.error('Insufficient gas funds:', error.message)
- *   }
- * }
- * ```
- */
-const validateNativeBalanceForTransaction = async (params) => {
-    const { adapter, operationContext } = params;
-    const balancePrepared = await adapter.prepareAction('native.balanceOf', {
-        walletAddress: operationContext.address,
-    }, operationContext);
-    const balance = await balancePrepared.execute();
-    if (BigInt(balance) === 0n) {
-        // Extract chain name from operationContext
-        const chainName = extractChainInfo(operationContext.chain).name;
-        // Create KitError with rich context in trace
-        throw createInsufficientGasError(chainName, {
-            balance: '0',
-            walletAddress: operationContext.address,
-        });
-    }
-};
-
 /**
  * CCTP bridge step names that can occur in the bridging flow.
  *
@@ -7817,7 +7716,7 @@ class CCTPV2BridgingProvider extends BridgingProvider {
     async bridge(params) {
         // CCTP-specific bridge params validation (includes base validation)
         assertCCTPv2BridgeParams(params);
-        const { source, destination, amount, token } = params;
+        const { source, amount, token } = params;
         // Extract operation context from source wallet context for balance validation
         const sourceOperationContext = this.extractOperationContext(source);
         // Validate USDC balance for transaction on source chain
@@ -7828,18 +7727,6 @@ class CCTPV2BridgingProvider extends BridgingProvider {
             tokenAddress: source.chain.usdcAddress,
             operationContext: sourceOperationContext,
         });
-        // Validate native balance > 0 for gas fees on source chain
-        await validateNativeBalanceForTransaction({
-            adapter: source.adapter,
-            operationContext: sourceOperationContext,
-        });
-        // Extract operation context from destination wallet context
-        const destinationOperationContext = this.extractOperationContext(destination);
-        // Validate native balance > 0 for gas fees on destination chain
-        await validateNativeBalanceForTransaction({
-            adapter: destination.adapter,
-            operationContext: destinationOperationContext,
-        });
         return bridge(params, this);
     }
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@circle-fin/provider-cctp-v2",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "description": "Circle's official Cross-Chain Transfer Protocol v2 provider for native USDC bridging",
   "keywords": [
     "circle",