@circle-fin/provider-cctp-v2 1.8.2 → 1.8.3

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @circle-fin/provider-cctp-v2
 
+## 1.8.3
+
+### Patch Changes
+
+- `bridge` no longer rejects Gas Station-enabled smart-contract accounts (SCAs) with zero native balance on the source or destination chain. EOA wallets without native funds will still fail at simulation with the underlying RPC error.
+
 ## 1.8.2
 
 ### Patch Changes

package/index.cjs

@@ -6391,7 +6391,8 @@ const DEFAULT_RETRYABLE_ERROR_CODES = [
  *
  * @remarks
  * Check order for KitError instances:
- * 1. If `recoverability === 'RETRYABLE'`, return `true` immediately (priority check).
+ * 1. If `recoverability === 'RETRYABLE'` or `recoverability === 'RESUMABLE'`,
+ *    return `true` immediately (priority check).
  * 2. Otherwise, check if `error.code` is in `DEFAULT_RETRYABLE_ERROR_CODES` (fallback check).
  * 3. Non-KitError instances always return `false`.
  *
@@ -6402,6 +6403,12 @@ const DEFAULT_RETRYABLE_ERROR_CODES = [
  * subsequent attempts, such as network timeouts or temporary service
  * unavailability. These errors are safe to retry after a delay.
  *
+ * RESUMABLE errors indicate a multi-phase operation that completed some phases
+ * before failing (for example, a token approval landed but the execution
+ * transaction failed). They are also retryable — re-running the operation is
+ * safe — but callers that have a kit-level `retry()` should prefer it so that
+ * already-completed phases are skipped.
+ *
  * @param error - Unknown error to check
  * @returns True if error is retryable
  *
@@ -6447,16 +6454,29 @@ const DEFAULT_RETRYABLE_ERROR_CODES = [
  * })
  * isRetryableError(error3) // false
  *
+ * // KitError with RESUMABLE recoverability (partially-completed operation)
+ * const error4 = new KitError({
+ *   code: 8101,
+ *   name: 'EARN_EXECUTION_FAILED',
+ *   type: 'SERVICE',
+ *   recoverability: 'RESUMABLE',
+ *   message: 'Execution failed after approval',
+ * })
+ * isRetryableError(error4) // true
+ *
  * // Non-KitError
- * const error4 = new Error('Standard error')
- * isRetryableError(error4) // false
+ * const error5 = new Error('Standard error')
+ * isRetryableError(error5) // false
  * ```
  */
 function isRetryableError$1(error) {
     // Use proper type guard to check if it's a KitError
     if (isKitError(error)) {
-        // Priority check: explicit recoverability
-        if (error.recoverability === 'RETRYABLE') {
+        // Priority check: explicit recoverability. RESUMABLE errors are a subset of
+        // retryable errors — re-running the operation is safe, but a kit-level
+        // retry() can resume from the failed phase instead.
+        if (error.recoverability === 'RETRYABLE' ||
+            error.recoverability === 'RESUMABLE') {
             return true;
         }
         // Fallback check: error code against default retryable codes
@@ -12246,7 +12266,7 @@ async function buildBatchedStep(name, receipt, batchId, adapter, chain, statusCo
     return step;
 }
 
-var version = "1.8.2";
+var version = "1.8.3";
 var pkg = {
 	version: version};
 
@@ -12852,60 +12872,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) {
-        const { chain } = operationContext;
-        const chainName = extractChainInfo(chain).name;
-        const nativeSymbol = typeof chain === 'object' && chain !== null && 'nativeCurrency' in chain
-            ? chain.nativeCurrency.symbol
-            : undefined;
-        throw createInsufficientGasError(chainName, nativeSymbol, {
-            balance: '0',
-            walletAddress: operationContext.address,
-        });
-    }
-};
-
 /**
  * Permit signature standards for gasless token approvals.
  *
@@ -13466,7 +13432,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
@@ -13477,24 +13443,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,
-        });
-        // Only validate destination native balance if there's an adapter
-        // and forwarder is not being used (forwarder handles mint, no gas needed)
-        if ('adapter' in destination &&
-            destination.adapter &&
-            !destination.useForwarder) {
-            // 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

@@ -6384,7 +6384,8 @@ const DEFAULT_RETRYABLE_ERROR_CODES = [
  *
  * @remarks
  * Check order for KitError instances:
- * 1. If `recoverability === 'RETRYABLE'`, return `true` immediately (priority check).
+ * 1. If `recoverability === 'RETRYABLE'` or `recoverability === 'RESUMABLE'`,
+ *    return `true` immediately (priority check).
  * 2. Otherwise, check if `error.code` is in `DEFAULT_RETRYABLE_ERROR_CODES` (fallback check).
  * 3. Non-KitError instances always return `false`.
  *
@@ -6395,6 +6396,12 @@ const DEFAULT_RETRYABLE_ERROR_CODES = [
  * subsequent attempts, such as network timeouts or temporary service
  * unavailability. These errors are safe to retry after a delay.
  *
+ * RESUMABLE errors indicate a multi-phase operation that completed some phases
+ * before failing (for example, a token approval landed but the execution
+ * transaction failed). They are also retryable — re-running the operation is
+ * safe — but callers that have a kit-level `retry()` should prefer it so that
+ * already-completed phases are skipped.
+ *
  * @param error - Unknown error to check
  * @returns True if error is retryable
  *
@@ -6440,16 +6447,29 @@ const DEFAULT_RETRYABLE_ERROR_CODES = [
  * })
  * isRetryableError(error3) // false
  *
+ * // KitError with RESUMABLE recoverability (partially-completed operation)
+ * const error4 = new KitError({
+ *   code: 8101,
+ *   name: 'EARN_EXECUTION_FAILED',
+ *   type: 'SERVICE',
+ *   recoverability: 'RESUMABLE',
+ *   message: 'Execution failed after approval',
+ * })
+ * isRetryableError(error4) // true
+ *
  * // Non-KitError
- * const error4 = new Error('Standard error')
- * isRetryableError(error4) // false
+ * const error5 = new Error('Standard error')
+ * isRetryableError(error5) // false
  * ```
  */
 function isRetryableError$1(error) {
     // Use proper type guard to check if it's a KitError
     if (isKitError(error)) {
-        // Priority check: explicit recoverability
-        if (error.recoverability === 'RETRYABLE') {
+        // Priority check: explicit recoverability. RESUMABLE errors are a subset of
+        // retryable errors — re-running the operation is safe, but a kit-level
+        // retry() can resume from the failed phase instead.
+        if (error.recoverability === 'RETRYABLE' ||
+            error.recoverability === 'RESUMABLE') {
             return true;
         }
         // Fallback check: error code against default retryable codes
@@ -12239,7 +12259,7 @@ async function buildBatchedStep(name, receipt, batchId, adapter, chain, statusCo
     return step;
 }
 
-var version = "1.8.2";
+var version = "1.8.3";
 var pkg = {
 	version: version};
 
@@ -12845,60 +12865,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) {
-        const { chain } = operationContext;
-        const chainName = extractChainInfo(chain).name;
-        const nativeSymbol = typeof chain === 'object' && chain !== null && 'nativeCurrency' in chain
-            ? chain.nativeCurrency.symbol
-            : undefined;
-        throw createInsufficientGasError(chainName, nativeSymbol, {
-            balance: '0',
-            walletAddress: operationContext.address,
-        });
-    }
-};
-
 /**
  * Permit signature standards for gasless token approvals.
  *
@@ -13459,7 +13425,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
@@ -13470,24 +13436,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,
-        });
-        // Only validate destination native balance if there's an adapter
-        // and forwarder is not being used (forwarder handles mint, no gas needed)
-        if ('adapter' in destination &&
-            destination.adapter &&
-            !destination.useForwarder) {
-            // 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.8.2",
+  "version": "1.8.3",
   "description": "Circle's official Cross-Chain Transfer Protocol v2 provider for native USDC bridging",
   "keywords": [
     "circle",