@circle-fin/app-kit 1.2.1 → 1.3.0

package/index.d.ts

@@ -616,8 +616,9 @@ declare enum Blockchain {
 /**
  * Enum representing chains that support same-chain swaps through the Swap Kit.
  *
- * Unlike the full {@link Blockchain} enum, SwapChain includes only mainnet
- * networks where adapter contracts are deployed (CCTPv2 support).
+ * Unlike the full {@link Blockchain} enum, SwapChain includes mainnet
+ * networks and explicitly whitelisted testnets (e.g., {@link Arc_Testnet})
+ * where adapter contracts are deployed (CCTPv2 support).
  *
  * Dynamic validation via {@link isSwapSupportedChain} ensures chains
  * automatically work when adapter contracts and supported tokens are deployed.
@@ -658,20 +659,21 @@ declare enum SwapChain {
     Sonic = "Sonic",
     XDC = "XDC",
     HyperEVM = "HyperEVM",
-    Monad = "Monad"
+    Monad = "Monad",
+    Arc_Testnet = "Arc_Testnet"
 }
 /**
  * Chain definition that supports swap operations.
  *
  * @remarks
- * Expanded from 4 to ~17 supported chains based on:
+ * Expanded from 4 to ~18 supported chains based on:
  * - CCTPv2 support (adapter contract deployed)
- * - Mainnet only
+ * - Mainnet chains plus whitelisted testnets (e.g., Arc Testnet)
  *
  * Use `isSwapSupportedChain()` for runtime validation.
  */
 type SwapChainDefinition = ChainDefinition & {
-    chain: Blockchain.Ethereum | Blockchain.Base | Blockchain.Polygon | Blockchain.Solana | Blockchain.Arbitrum | Blockchain.Optimism | Blockchain.Avalanche | Blockchain.Linea | Blockchain.Ink | Blockchain.World_Chain | Blockchain.Unichain | Blockchain.Plume | Blockchain.Sei | Blockchain.Sonic | Blockchain.XDC | Blockchain.HyperEVM | Blockchain.Monad;
+    chain: Blockchain.Ethereum | Blockchain.Base | Blockchain.Polygon | Blockchain.Solana | Blockchain.Arbitrum | Blockchain.Optimism | Blockchain.Avalanche | Blockchain.Linea | Blockchain.Ink | Blockchain.World_Chain | Blockchain.Unichain | Blockchain.Plume | Blockchain.Sei | Blockchain.Sonic | Blockchain.XDC | Blockchain.HyperEVM | Blockchain.Monad | Blockchain.Arc_Testnet;
 };
 /**
  * Chain identifier accepted by swap operations.
@@ -1002,6 +1004,7 @@ declare const ArcTestnet: {
     };
     readonly kitContracts: {
         readonly bridge: "0xC5567a5E3370d4DBfB0540025078e283e36A363d";
+        readonly adapter: "0xBBD70b01a1CAbc96d5b7b129Ae1AAabdf50dd40b";
     };
 };
 
@@ -1692,7 +1695,7 @@ declare const HyperEVM: {
     };
     readonly chainId: 999;
     readonly isTestnet: false;
-    readonly explorerUrl: "https://app.hyperliquid.xyz/explorer/tx/{hash}";
+    readonly explorerUrl: "https://hyperevmscan.io/tx/{hash}";
     readonly rpcEndpoints: readonly ["https://rpc.hyperliquid.xyz/evm"];
     readonly eurcAddress: null;
     readonly usdcAddress: "0xb88339CB7199b77E23DB6E890353E22632Ba630f";
@@ -6787,6 +6790,12 @@ declare const InputError: {
         readonly name: "INPUT_UNSUPPORTED_ACTION";
         readonly type: ErrorType;
     };
+    /** No route satisfies the slippage or minimum-output constraint */
+    readonly SLIPPAGE_CONSTRAINT_NOT_MET: {
+        readonly code: 1009;
+        readonly name: "INPUT_SLIPPAGE_CONSTRAINT_NOT_MET";
+        readonly type: ErrorType;
+    };
     /** General validation failure for complex validation rules */
     readonly VALIDATION_FAILED: {
         readonly code: 1098;
@@ -12176,8 +12185,9 @@ interface SwapResult {
  * - Resolved chain identifiers to full ChainDefinition objects
  * - Extracted and validated wallet addresses
  *
- * Note: Token aliases (e.g., 'USDC', 'NATIVE') are preserved in `tokenIn`
- * and `tokenOut` fields. Address resolution is handled by the provider layer.
+ * Note: Raw user input is validated first, then `tokenIn` and `tokenOut` may
+ * be canonicalized for downstream routing (for example, Arc Testnet
+ * `NATIVE` → `USDC`). Address resolution is handled by the provider layer.
  *
  * This type is consumed by swap providers and internal operations but is not
  * exposed to end users. It extends ServiceSwapParams which is the format expected
@@ -12194,8 +12204,8 @@ interface SwapResult {
  *     chain: Ethereum, // Full chain definition
  *     address: '0x742d35Cc6634C0532925a3b844Bc454e4438f44e'
  *   },
- *   tokenIn: 'USDC',  // Alias preserved
- *   tokenOut: 'USDT', // Alias preserved
+ *   tokenIn: 'USDC',  // Canonicalized for provider routing
+ *   tokenOut: 'USDT', // Canonicalized for provider routing
  *   amountIn: '100500000', // Converted to base units (100.5 USDC with 6 decimals)
  *   to: '0x742d35Cc6634C0532925a3b844Bc454e4438f44e',
  *   config: {
@@ -12815,6 +12825,44 @@ declare class AppKit {
      * ```
      */
     bridge(params: BridgeParams): Promise<BridgeResult>;
+    /**
+     * Retry a failed cross-chain USDC bridge transfer.
+     *
+     * Resume a bridge operation that failed due to a transient error.
+     * Use {@link isRetryableError} to check whether a failed step's error
+     * is eligible for retry before calling this method.
+     *
+     * @param result - The bridge result from the failed operation
+     * @param retryContext - The retry context with source and optional
+     *   destination adapters
+     * @returns Promise resolving to the bridge result with transaction
+     *   details
+     * @throws If the provider from the original result is not found
+     * @throws If the retry operation fails
+     *
+     * @example
+     * ```typescript
+     * import { AppKit, isRetryableError } from '@circle-fin/app-kit'
+     *
+     * const kit = new AppKit()
+     *
+     * const result = await kit.bridge({
+     *   from: sourceAdapter,
+     *   to: { adapter: destAdapter, chain: 'Polygon' },
+     *   amount: '100.50',
+     * })
+     *
+     * const failedStep = result.steps.find(s => s.error)
+     * if (result.state === 'error' && failedStep?.error && isRetryableError(failedStep.error)) {
+     *   const retried = await kit.retryBridge(result, {
+     *     from: sourceAdapter,
+     *     to: destAdapter,
+     *   })
+     *   console.log('Retry result:', retried.state)
+     * }
+     * ```
+     */
+    retryBridge(result: BridgeResult, retryContext: RetryContext): Promise<BridgeResult>;
     /**
      * Estimate the bridge operation.
      *
@@ -13201,4 +13249,4 @@ declare function isTokenAddress(token: string, chain: ChainDefinition): token is
 declare function validateToken(token: string, chain: ChainDefinition): TokenValidationResult;
 
 export { AppKit, BalanceError, Blockchain, BridgeChain, InputError, KitError, NetworkError, OnchainError, RateLimitError, RpcError, ServiceError, SwapChain, TOKEN_ALIASES, TransferSpeed, getErrorCode, getErrorMessage, getTokenDecimals, isBalanceError, isFatalError, isInputError, isKitError, isNetworkError, isOnchainError, isRateLimitError, isRetryableError, isRpcError, isServiceError, isTokenAddress, isTokenAlias, isUserCancellationError, setExternalPrefix, validateToken };
-export type { ActionHandler, AdapterContext, AllowanceStrategy, AppKitConfig, AppKitContext, BaseChainDefinition, BridgeConfig, CustomFeePolicy$1 as BridgeCustomFeePolicy, BridgeParams, BridgeResult, BridgeStep, CCTPConfig, CCTPMergedConfig, CCTPSplitConfig, ChainDefinition, Currency, DeveloperFeeHooks, EVMChainDefinition, ErrorDetails, EstimateResult$1 as EstimateResult, EstimatedGas, KitContractType, NonEVMChainDefinition, OperationType, Recoverability, SendParams, SwapConfig, CustomFeePolicy as SwapCustomFeePolicy, SwapEstimate, SwapFeeContext, SwapKitConfig, SwapKitContext, SwapParams, SwapResult, TokenInfo, VersionConfig };
+export type { ActionHandler, AdapterContext, AllowanceStrategy, AppKitConfig, AppKitContext, BaseChainDefinition, BridgeConfig, CustomFeePolicy$1 as BridgeCustomFeePolicy, BridgeParams, BridgeResult, BridgeStep, CCTPConfig, CCTPMergedConfig, CCTPSplitConfig, ChainDefinition, Currency, DeveloperFeeHooks, EVMChainDefinition, ErrorDetails, EstimateResult$1 as EstimateResult, EstimatedGas, KitContractType, NonEVMChainDefinition, OperationType, Recoverability, RetryContext, SendParams, SwapConfig, CustomFeePolicy as SwapCustomFeePolicy, SwapEstimate, SwapFeeContext, SwapKitConfig, SwapKitContext, SwapParams, SwapResult, TokenInfo, VersionConfig };