@hongming-wang/usdc-bridge-widget 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,765 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as viem from 'viem';
+import { Chain } from 'viem';
+import * as _tanstack_react_query from '@tanstack/react-query';
+import React$1 from 'react';
+export { arbitrum, arbitrumSepolia, avalanche, avalancheFuji, base, baseSepolia, ink, linea, mainnet, optimism, optimismSepolia, polygon, polygonAmoy, sei, sepolia, sonic, worldchain, xdc } from 'viem/chains';
+
+/**
+ * Theme configuration for the Bridge Widget.
+ * All color values should be valid CSS color strings (hex, rgb, rgba, etc.).
+ *
+ * @example
+ * const customTheme: BridgeWidgetTheme = {
+ *   primaryColor: "#3b82f6",
+ *   backgroundColor: "rgba(0, 0, 0, 0.9)",
+ *   borderRadius: 16,
+ * };
+ */
+interface BridgeWidgetTheme {
+    /** Primary accent color used for buttons and highlights (hex) */
+    primaryColor?: string;
+    /** Secondary accent color used for gradients (hex) */
+    secondaryColor?: string;
+    /** Main background color of the widget (hex or rgba) */
+    backgroundColor?: string;
+    /** Background color for cards and nested elements (hex or rgba) */
+    cardBackgroundColor?: string;
+    /** Primary text color (hex) */
+    textColor?: string;
+    /** Secondary/muted text color for labels (hex or rgba) */
+    mutedTextColor?: string;
+    /** Border color for inputs and containers (hex or rgba) */
+    borderColor?: string;
+    /** Color for success states and messages (hex) */
+    successColor?: string;
+    /** Color for error states and messages (hex) */
+    errorColor?: string;
+    /** Color for hover states (hex or rgba) */
+    hoverColor?: string;
+    /** Border radius in pixels for rounded corners */
+    borderRadius?: number;
+    /** Font family for all text in the widget */
+    fontFamily?: string;
+}
+/**
+ * Configuration for a supported blockchain in the bridge.
+ * Contains chain metadata, USDC contract address, and CCTP TokenMessenger address.
+ *
+ * @example
+ * const ethereumConfig: BridgeChainConfig = {
+ *   chain: mainnet,
+ *   usdcAddress: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+ *   tokenMessengerAddress: "0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d",
+ *   iconUrl: "https://icons.llamao.fi/icons/chains/rsz_ethereum.jpg",
+ * };
+ */
+interface BridgeChainConfig {
+    /** Chain definition from viem containing id, name, and network details */
+    chain: Chain;
+    /** USDC token contract address on this chain (checksummed) */
+    usdcAddress: `0x${string}`;
+    /** Circle TokenMessenger contract address for CCTP transfers */
+    tokenMessengerAddress?: `0x${string}`;
+    /** URL for the chain's icon/logo image (optional, falls back to initial) */
+    iconUrl?: string;
+}
+/**
+ * Props for the BridgeWidget component.
+ *
+ * @example
+ * <BridgeWidget
+ *   defaultSourceChainId={1}
+ *   defaultDestinationChainId={8453}
+ *   onBridgeSuccess={({ txHash }) => console.log('Success:', txHash)}
+ *   onBridgeError={(error) => console.error('Error:', error)}
+ *   theme={{ primaryColor: "#3b82f6" }}
+ * />
+ */
+interface BridgeWidgetProps {
+    /**
+     * Array of supported chains with their USDC addresses.
+     * Defaults to all CCTP-supported chains from DEFAULT_CHAIN_CONFIGS.
+     */
+    chains?: BridgeChainConfig[];
+    /** Chain ID to pre-select as the source chain */
+    defaultSourceChainId?: number;
+    /** Chain ID to pre-select as the destination chain */
+    defaultDestinationChainId?: number;
+    /**
+     * Callback fired when a bridge transaction is initiated.
+     * Called before approval (if needed) or bridge execution begins.
+     */
+    onBridgeStart?: (params: {
+        /** Source chain ID */
+        sourceChainId: number;
+        /** Destination chain ID */
+        destChainId: number;
+        /** Amount being bridged (as string) */
+        amount: string;
+        /** Transaction hash (only present if tx already submitted) */
+        txHash?: `0x${string}`;
+    }) => void;
+    /**
+     * Callback fired when a bridge transaction completes successfully.
+     * The txHash can be used to link to a block explorer.
+     */
+    onBridgeSuccess?: (params: {
+        /** Source chain ID */
+        sourceChainId: number;
+        /** Destination chain ID */
+        destChainId: number;
+        /** Amount bridged (as string) */
+        amount: string;
+        /** Transaction hash of the successful bridge */
+        txHash: `0x${string}`;
+    }) => void;
+    /**
+     * Callback fired when a bridge transaction fails.
+     * The error object contains details about what went wrong.
+     */
+    onBridgeError?: (error: Error) => void;
+    /**
+     * Callback fired when the user clicks "Connect Wallet".
+     * If not provided, the widget will attempt to use wagmi's connectors.
+     */
+    onConnectWallet?: () => void;
+    /** Custom theme overrides to customize the widget appearance */
+    theme?: BridgeWidgetTheme;
+    /** Custom CSS class name to apply to the widget container */
+    className?: string;
+    /** Custom inline styles to apply to the widget container */
+    style?: React.CSSProperties;
+}
+/**
+ * Estimated costs and timing for a bridge transfer.
+ * Used by the deprecated useBridgeEstimate hook.
+ *
+ * @deprecated Use BridgeQuote from useBridge.ts instead
+ */
+interface BridgeEstimate {
+    /** Estimated gas fee (as formatted string) */
+    gasFee: string;
+    /** Protocol bridge fee (as formatted string) */
+    bridgeFee: string;
+    /** Total estimated fee including gas and protocol (as formatted string) */
+    totalFee: string;
+    /** Estimated time for the bridge to complete (e.g., "~15-20 minutes") */
+    estimatedTime: string;
+}
+/**
+ * Result state for a bridge operation.
+ * Tracks the current state and any associated transaction hash or error.
+ */
+interface BridgeResult {
+    /** Current state of the bridge operation */
+    state: "idle" | "pending" | "success" | "error";
+    /** Transaction hash if a transaction has been submitted */
+    txHash?: `0x${string}`;
+    /** Error message if the operation failed */
+    error?: string;
+}
+
+declare function BridgeWidget({ chains, defaultSourceChainId, defaultDestinationChainId, onBridgeStart, onBridgeSuccess, onBridgeError, onConnectWallet, theme: themeOverrides, className, style, }: BridgeWidgetProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Hook to get USDC balance for a specific chain
+ */
+declare function useUSDCBalance(chainConfig: BridgeChainConfig | undefined): {
+    balance: bigint;
+    balanceFormatted: string;
+    isLoading: boolean;
+    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<bigint, viem.ReadContractErrorType>>;
+};
+/**
+ * Hook to get USDC balances for all configured chains at once.
+ * Uses multicall for efficient batch fetching.
+ *
+ * @param chainConfigs - Array of chain configurations to fetch balances for
+ * @returns Object with balances mapped by chain ID, loading state, and refetch function
+ *
+ * @example
+ * const { balances, isLoading, refetch } = useAllUSDCBalances(chains);
+ * // balances[1] -> { balance: 1000000n, formatted: "1.00" }
+ */
+declare function useAllUSDCBalances(chainConfigs: BridgeChainConfig[]): {
+    balances: Record<number, {
+        balance: bigint;
+        formatted: string;
+    }>;
+    isLoading: boolean;
+    refetch: () => void;
+};
+/**
+ * Hook to check and handle USDC allowance
+ */
+declare function useUSDCAllowance(chainConfig: BridgeChainConfig | undefined, spenderAddress?: `0x${string}`): {
+    allowance: bigint;
+    allowanceFormatted: string;
+    isLoading: boolean;
+    isApproving: boolean;
+    approve: (amount: string) => Promise<`0x${string}`>;
+    needsApproval: (amount: string) => boolean;
+    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<bigint, viem.ReadContractErrorType>>;
+    approvalError: Error | null;
+};
+/**
+ * Hook to estimate bridge costs using Circle Bridge Kit SDK
+ *
+ * @deprecated This hook is deprecated and will be removed in a future version.
+ * Use `useBridgeQuote` from `useBridge.ts` instead for SDK-based estimates.
+ *
+ * Note: kit.estimate() requires an adapter with wallet connection.
+ * For pre-bridge quotes without wallet, we return CCTP standard estimates.
+ *
+ * @example
+ * // Before (deprecated):
+ * const { estimate } = useBridgeEstimate(sourceChainId, destChainId, amount);
+ *
+ * // After (recommended):
+ * import { useBridgeQuote } from './useBridge';
+ * const { quote } = useBridgeQuote(sourceChainId, destChainId, amount);
+ */
+declare function useBridgeEstimate(sourceChainId: number | undefined, destChainId: number | undefined, amount: string): {
+    estimate: BridgeEstimate | null;
+    isLoading: boolean;
+    error: Error | null;
+};
+/**
+ * Hook to format numbers for display
+ *
+ * @deprecated This hook is deprecated and will be removed in a future version.
+ * Use the `formatNumber` utility function directly from `utils.ts` instead.
+ * The hook adds unnecessary overhead with useCallback for a pure function.
+ *
+ * @example
+ * // Before (deprecated):
+ * const format = useFormatNumber();
+ * const formatted = format(1234.56, 2);
+ *
+ * // After (recommended):
+ * import { formatNumber } from './utils';
+ * const formatted = formatNumber(1234.56, 2);
+ */
+declare function useFormatNumber(): (value: string | number, decimals?: number) => string;
+
+declare function getChainName(chainId: number): string;
+interface BridgeParams {
+    sourceChainConfig: BridgeChainConfig;
+    destChainConfig: BridgeChainConfig;
+    amount: string;
+    recipientAddress?: `0x${string}`;
+}
+interface BridgeState {
+    status: "idle" | "loading" | "approving" | "burning" | "fetching-attestation" | "minting" | "success" | "error";
+    txHash?: `0x${string}`;
+    error?: Error;
+    events: BridgeEvent[];
+}
+interface BridgeEvent {
+    type: string;
+    timestamp: number;
+    data?: unknown;
+}
+interface UseBridgeResult {
+    bridge: (params: BridgeParams) => Promise<void>;
+    state: BridgeState;
+    reset: () => void;
+}
+/**
+ * Hook to execute USDC bridge transfers using Circle's Bridge Kit
+ */
+declare function useBridge(): UseBridgeResult;
+interface BridgeQuote {
+    estimatedGasFee: string;
+    bridgeFee: string;
+    totalFee: string;
+    estimatedTime: string;
+    expiresAt?: number;
+}
+/**
+ * Hook to get a quote for a bridge transfer.
+ *
+ * **Note:** This hook currently returns static CCTP standard estimates because
+ * Circle's `kit.estimate()` requires an adapter with an active wallet connection.
+ * For accurate gas estimates, the wallet will provide them during transaction signing.
+ *
+ * @param sourceChainId - Source chain ID
+ * @param destChainId - Destination chain ID
+ * @param amount - Amount to bridge (as string)
+ * @returns Quote with estimated fees and timing (static values)
+ *
+ * @example
+ * const { quote, isLoading, error } = useBridgeQuote(1, 8453, "100");
+ * // quote.estimatedTime -> "~15-20 minutes"
+ * // quote.bridgeFee -> "0-14 bps (FAST) / 0 (SLOW)"
+ */
+declare function useBridgeQuote(sourceChainId: number | undefined, destChainId: number | undefined, amount: string): {
+    quote: BridgeQuote | null;
+    isLoading: boolean;
+    error: Error | null;
+};
+
+declare const USDC_DECIMALS = 6;
+declare const USDC_BRAND_COLOR = "#2775ca";
+declare const MAX_USDC_AMOUNT = "100000000000";
+declare const MIN_USDC_AMOUNT = "0.000001";
+declare const DEFAULT_LOCALE = "en-US";
+declare const USDC_ADDRESSES: Record<number, `0x${string}`>;
+declare const TOKEN_MESSENGER_V1_ADDRESSES: Record<number, `0x${string}`>;
+declare const TOKEN_MESSENGER_V2_ADDRESS: `0x${string}`;
+declare const TOKEN_MESSENGER_ADDRESSES: Record<number, `0x${string}`>;
+declare const CHAIN_ICONS: Record<number, string>;
+
+/**
+ * Format a number for display with locale-aware formatting
+ *
+ * @param value - The number or string to format
+ * @param decimals - Number of decimal places (default: 2)
+ * @param locale - Optional locale string (e.g., 'en-US', 'de-DE'). Defaults to 'en-US' for consistent financial display.
+ * @returns Formatted number string
+ *
+ * @example
+ * formatNumber(1234.567) // "1,234.57"
+ * formatNumber(1234.567, 4) // "1,234.5670"
+ * formatNumber(1234.567, 2, 'de-DE') // "1.234,57"
+ */
+declare function formatNumber(value: string | number, decimals?: number, locale?: string): string;
+/**
+ * Validate and sanitize an amount input string.
+ * Ensures the value is a valid positive decimal with max 6 decimal places.
+ *
+ * @param value - The input string to validate
+ * @returns Object with isValid flag and sanitized value
+ */
+declare function validateAmountInput(value: string): {
+    isValid: boolean;
+    sanitized: string;
+    error?: string;
+};
+/**
+ * Safely parse a USDC amount string to bigint
+ * Returns null if parsing fails
+ */
+declare function parseUSDCAmount(amount: string): bigint | null;
+/**
+ * Check if a string is a valid positive number
+ */
+declare function isValidPositiveAmount(amount: string): boolean;
+/**
+ * Extract error message from unknown error type
+ */
+declare function getErrorMessage(error: unknown): string;
+/**
+ * Validation result for chain config
+ */
+interface ChainConfigValidationResult {
+    isValid: boolean;
+    errors: string[];
+}
+/**
+ * Validate a single chain configuration.
+ * Checks that required fields are present and addresses are valid.
+ *
+ * @param config - The chain configuration to validate
+ * @returns Validation result with errors if any
+ */
+declare function validateChainConfig(config: BridgeChainConfig): ChainConfigValidationResult;
+/**
+ * Validate an array of chain configurations.
+ * Returns the first error found or success if all configs are valid.
+ *
+ * @param configs - Array of chain configurations to validate
+ * @returns Validation result with all errors
+ */
+declare function validateChainConfigs(configs: BridgeChainConfig[]): ChainConfigValidationResult;
+
+declare const unichain: {
+    blockExplorers: {
+        readonly default: {
+            readonly name: "Uniscan";
+            readonly url: "https://uniscan.xyz";
+        };
+    };
+    blockTime?: number | undefined | undefined;
+    contracts?: {
+        [x: string]: viem.ChainContract | {
+            [sourceId: number]: viem.ChainContract | undefined;
+        } | undefined;
+        ensRegistry?: viem.ChainContract | undefined;
+        ensUniversalResolver?: viem.ChainContract | undefined;
+        multicall3?: viem.ChainContract | undefined;
+        erc6492Verifier?: viem.ChainContract | undefined;
+    } | undefined;
+    ensTlds?: readonly string[] | undefined;
+    id: 130;
+    name: "Unichain";
+    nativeCurrency: {
+        readonly name: "Ether";
+        readonly symbol: "ETH";
+        readonly decimals: 18;
+    };
+    experimental_preconfirmationTime?: number | undefined | undefined;
+    rpcUrls: {
+        readonly default: {
+            readonly http: readonly ["https://mainnet.unichain.org"];
+        };
+    };
+    sourceId?: number | undefined | undefined;
+    testnet?: boolean | undefined | undefined;
+    custom?: Record<string, unknown> | undefined;
+    extendSchema?: Record<string, unknown> | undefined;
+    fees?: viem.ChainFees<undefined> | undefined;
+    formatters?: undefined;
+    prepareTransactionRequest?: ((args: viem.PrepareTransactionRequestParameters, options: {
+        phase: "beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters";
+    }) => Promise<viem.PrepareTransactionRequestParameters>) | [fn: ((args: viem.PrepareTransactionRequestParameters, options: {
+        phase: "beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters";
+    }) => Promise<viem.PrepareTransactionRequestParameters>) | undefined, options: {
+        runAt: readonly ("beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters")[];
+    }] | undefined;
+    serializers?: viem.ChainSerializers<undefined, viem.TransactionSerializable> | undefined;
+    verifyHash?: ((client: viem.Client, parameters: viem.VerifyHashActionParameters) => Promise<viem.VerifyHashActionReturnType>) | undefined;
+};
+declare const hyperEvm: {
+    blockExplorers: {
+        readonly default: {
+            readonly name: "Hyperscan";
+            readonly url: "https://hyperscan.xyz";
+        };
+    };
+    blockTime?: number | undefined | undefined;
+    contracts?: {
+        [x: string]: viem.ChainContract | {
+            [sourceId: number]: viem.ChainContract | undefined;
+        } | undefined;
+        ensRegistry?: viem.ChainContract | undefined;
+        ensUniversalResolver?: viem.ChainContract | undefined;
+        multicall3?: viem.ChainContract | undefined;
+        erc6492Verifier?: viem.ChainContract | undefined;
+    } | undefined;
+    ensTlds?: readonly string[] | undefined;
+    id: 999;
+    name: "HyperEVM";
+    nativeCurrency: {
+        readonly name: "HYPE";
+        readonly symbol: "HYPE";
+        readonly decimals: 18;
+    };
+    experimental_preconfirmationTime?: number | undefined | undefined;
+    rpcUrls: {
+        readonly default: {
+            readonly http: readonly ["https://rpc.hyperliquid.xyz/evm"];
+        };
+    };
+    sourceId?: number | undefined | undefined;
+    testnet?: boolean | undefined | undefined;
+    custom?: Record<string, unknown> | undefined;
+    extendSchema?: Record<string, unknown> | undefined;
+    fees?: viem.ChainFees<undefined> | undefined;
+    formatters?: undefined;
+    prepareTransactionRequest?: ((args: viem.PrepareTransactionRequestParameters, options: {
+        phase: "beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters";
+    }) => Promise<viem.PrepareTransactionRequestParameters>) | [fn: ((args: viem.PrepareTransactionRequestParameters, options: {
+        phase: "beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters";
+    }) => Promise<viem.PrepareTransactionRequestParameters>) | undefined, options: {
+        runAt: readonly ("beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters")[];
+    }] | undefined;
+    serializers?: viem.ChainSerializers<undefined, viem.TransactionSerializable> | undefined;
+    verifyHash?: ((client: viem.Client, parameters: viem.VerifyHashActionParameters) => Promise<viem.VerifyHashActionReturnType>) | undefined;
+};
+declare const plume: {
+    blockExplorers: {
+        readonly default: {
+            readonly name: "Plume Explorer";
+            readonly url: "https://explorer.plume.org";
+        };
+    };
+    blockTime?: number | undefined | undefined;
+    contracts?: {
+        [x: string]: viem.ChainContract | {
+            [sourceId: number]: viem.ChainContract | undefined;
+        } | undefined;
+        ensRegistry?: viem.ChainContract | undefined;
+        ensUniversalResolver?: viem.ChainContract | undefined;
+        multicall3?: viem.ChainContract | undefined;
+        erc6492Verifier?: viem.ChainContract | undefined;
+    } | undefined;
+    ensTlds?: readonly string[] | undefined;
+    id: 98866;
+    name: "Plume";
+    nativeCurrency: {
+        readonly name: "Ether";
+        readonly symbol: "ETH";
+        readonly decimals: 18;
+    };
+    experimental_preconfirmationTime?: number | undefined | undefined;
+    rpcUrls: {
+        readonly default: {
+            readonly http: readonly ["https://rpc.plume.org"];
+        };
+    };
+    sourceId?: number | undefined | undefined;
+    testnet?: boolean | undefined | undefined;
+    custom?: Record<string, unknown> | undefined;
+    extendSchema?: Record<string, unknown> | undefined;
+    fees?: viem.ChainFees<undefined> | undefined;
+    formatters?: undefined;
+    prepareTransactionRequest?: ((args: viem.PrepareTransactionRequestParameters, options: {
+        phase: "beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters";
+    }) => Promise<viem.PrepareTransactionRequestParameters>) | [fn: ((args: viem.PrepareTransactionRequestParameters, options: {
+        phase: "beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters";
+    }) => Promise<viem.PrepareTransactionRequestParameters>) | undefined, options: {
+        runAt: readonly ("beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters")[];
+    }] | undefined;
+    serializers?: viem.ChainSerializers<undefined, viem.TransactionSerializable> | undefined;
+    verifyHash?: ((client: viem.Client, parameters: viem.VerifyHashActionParameters) => Promise<viem.VerifyHashActionReturnType>) | undefined;
+};
+declare const monad: {
+    blockExplorers: {
+        readonly default: {
+            readonly name: "Monad Explorer";
+            readonly url: "https://explorer.monad.xyz";
+        };
+    };
+    blockTime?: number | undefined | undefined;
+    contracts?: {
+        [x: string]: viem.ChainContract | {
+            [sourceId: number]: viem.ChainContract | undefined;
+        } | undefined;
+        ensRegistry?: viem.ChainContract | undefined;
+        ensUniversalResolver?: viem.ChainContract | undefined;
+        multicall3?: viem.ChainContract | undefined;
+        erc6492Verifier?: viem.ChainContract | undefined;
+    } | undefined;
+    ensTlds?: readonly string[] | undefined;
+    id: 10200;
+    name: "Monad";
+    nativeCurrency: {
+        readonly name: "MON";
+        readonly symbol: "MON";
+        readonly decimals: 18;
+    };
+    experimental_preconfirmationTime?: number | undefined | undefined;
+    rpcUrls: {
+        readonly default: {
+            readonly http: readonly ["https://rpc.monad.xyz"];
+        };
+    };
+    sourceId?: number | undefined | undefined;
+    testnet?: boolean | undefined | undefined;
+    custom?: Record<string, unknown> | undefined;
+    extendSchema?: Record<string, unknown> | undefined;
+    fees?: viem.ChainFees<undefined> | undefined;
+    formatters?: undefined;
+    prepareTransactionRequest?: ((args: viem.PrepareTransactionRequestParameters, options: {
+        phase: "beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters";
+    }) => Promise<viem.PrepareTransactionRequestParameters>) | [fn: ((args: viem.PrepareTransactionRequestParameters, options: {
+        phase: "beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters";
+    }) => Promise<viem.PrepareTransactionRequestParameters>) | undefined, options: {
+        runAt: readonly ("beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters")[];
+    }] | undefined;
+    serializers?: viem.ChainSerializers<undefined, viem.TransactionSerializable> | undefined;
+    verifyHash?: ((client: viem.Client, parameters: viem.VerifyHashActionParameters) => Promise<viem.VerifyHashActionReturnType>) | undefined;
+};
+declare const codex: {
+    blockExplorers: {
+        readonly default: {
+            readonly name: "Codex Explorer";
+            readonly url: "https://explorer.codex.storage";
+        };
+    };
+    blockTime?: number | undefined | undefined;
+    contracts?: {
+        [x: string]: viem.ChainContract | {
+            [sourceId: number]: viem.ChainContract | undefined;
+        } | undefined;
+        ensRegistry?: viem.ChainContract | undefined;
+        ensUniversalResolver?: viem.ChainContract | undefined;
+        multicall3?: viem.ChainContract | undefined;
+        erc6492Verifier?: viem.ChainContract | undefined;
+    } | undefined;
+    ensTlds?: readonly string[] | undefined;
+    id: 81224;
+    name: "Codex";
+    nativeCurrency: {
+        readonly name: "Ether";
+        readonly symbol: "ETH";
+        readonly decimals: 18;
+    };
+    experimental_preconfirmationTime?: number | undefined | undefined;
+    rpcUrls: {
+        readonly default: {
+            readonly http: readonly ["https://rpc.codex.storage"];
+        };
+    };
+    sourceId?: number | undefined | undefined;
+    testnet?: boolean | undefined | undefined;
+    custom?: Record<string, unknown> | undefined;
+    extendSchema?: Record<string, unknown> | undefined;
+    fees?: viem.ChainFees<undefined> | undefined;
+    formatters?: undefined;
+    prepareTransactionRequest?: ((args: viem.PrepareTransactionRequestParameters, options: {
+        phase: "beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters";
+    }) => Promise<viem.PrepareTransactionRequestParameters>) | [fn: ((args: viem.PrepareTransactionRequestParameters, options: {
+        phase: "beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters";
+    }) => Promise<viem.PrepareTransactionRequestParameters>) | undefined, options: {
+        runAt: readonly ("beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters")[];
+    }] | undefined;
+    serializers?: viem.ChainSerializers<undefined, viem.TransactionSerializable> | undefined;
+    verifyHash?: ((client: viem.Client, parameters: viem.VerifyHashActionParameters) => Promise<viem.VerifyHashActionReturnType>) | undefined;
+};
+declare function createChainConfig(chain: viem.Chain, options?: {
+    usdcAddress?: `0x${string}`;
+    tokenMessengerAddress?: `0x${string}`;
+    iconUrl?: string;
+}): BridgeChainConfig;
+declare const DEFAULT_CHAIN_CONFIGS: BridgeChainConfig[];
+
+/**
+ * Create a testnet chain configuration
+ */
+declare function createTestnetChainConfig(chain: viem.Chain, options?: {
+    usdcAddress?: `0x${string}`;
+    tokenMessengerAddress?: `0x${string}`;
+    iconUrl?: string;
+}): BridgeChainConfig;
+/**
+ * Testnet chain configurations for development and testing.
+ * These use Circle's testnet USDC and TokenMessenger contracts.
+ *
+ * @example
+ * import { TESTNET_CHAIN_CONFIGS } from './chains';
+ * <BridgeWidget chains={TESTNET_CHAIN_CONFIGS} />
+ */
+declare const TESTNET_CHAIN_CONFIGS: BridgeChainConfig[];
+
+/**
+ * Default theme color palette
+ */
+declare const THEME_COLORS: {
+    /** Primary accent - Indigo */
+    readonly primary: "#6366f1";
+    /** Secondary accent - Purple */
+    readonly secondary: "#a855f7";
+    /** Success state - Green */
+    readonly success: "#22c55e";
+    /** Error state - Red */
+    readonly error: "#ef4444";
+    /** Text color - White */
+    readonly text: "#ffffff";
+    /** Muted text - Semi-transparent white */
+    readonly mutedText: "rgba(255, 255, 255, 0.54)";
+    /** Border color - Semi-transparent white */
+    readonly border: "rgba(255, 255, 255, 0.06)";
+    /** Background - Dark with transparency */
+    readonly background: "rgba(15, 15, 25, 0.8)";
+    /** Card background - Darker with transparency */
+    readonly cardBackground: "rgba(15, 15, 25, 0.6)";
+    /** Dropdown background - Near opaque dark */
+    readonly dropdownBackground: "rgba(20, 20, 35, 0.98)";
+    /** Input background - Transparent black */
+    readonly inputBackground: "rgba(0, 0, 0, 0.3)";
+    /** Hover state - Semi-transparent white */
+    readonly hover: "rgba(255, 255, 255, 0.05)";
+};
+/**
+ * Default theme spacing and sizing
+ */
+declare const THEME_SIZING: {
+    /** Default border radius in pixels */
+    readonly borderRadius: 12;
+    /** Widget max width */
+    readonly maxWidth: "480px";
+    /** Standard padding */
+    readonly padding: "16px";
+    /** Gap between elements */
+    readonly gap: "12px";
+    /** Small gap */
+    readonly smallGap: "8px";
+    /** Dropdown max height */
+    readonly dropdownMaxHeight: "300px";
+};
+/**
+ * Default font settings
+ */
+declare const THEME_FONTS: {
+    /** Primary font family */
+    readonly family: "-apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, sans-serif";
+    /** Font sizes */
+    readonly sizes: {
+        readonly xs: "10px";
+        readonly sm: "12px";
+        readonly base: "14px";
+        readonly lg: "18px";
+    };
+    /** Font weights */
+    readonly weights: {
+        readonly normal: 400;
+        readonly medium: 500;
+        readonly semibold: 600;
+        readonly bold: 700;
+    };
+};
+/**
+ * Default complete theme configuration
+ */
+declare const defaultTheme: Required<BridgeWidgetTheme>;
+/**
+ * Merge user theme overrides with defaults
+ */
+declare function mergeTheme(theme?: BridgeWidgetTheme): Required<BridgeWidgetTheme>;
+/**
+ * Pre-built theme presets
+ */
+declare const themePresets: {
+    /** Default dark theme */
+    readonly dark: Required<BridgeWidgetTheme>;
+    /** Light theme variant */
+    readonly light: Required<BridgeWidgetTheme>;
+    /** Blue accent theme */
+    readonly blue: Required<BridgeWidgetTheme>;
+    /** Green accent theme */
+    readonly green: Required<BridgeWidgetTheme>;
+};
+
+interface IconProps {
+    /** Icon size in pixels */
+    size?: number;
+    /** Stroke/fill color */
+    color?: string;
+    /** Additional CSS class */
+    className?: string;
+    /** Additional inline styles */
+    style?: React$1.CSSProperties;
+}
+/**
+ * Chevron down icon for dropdowns
+ */
+declare function ChevronDownIcon({ size, color, className, style, }: IconProps): react_jsx_runtime.JSX.Element;
+/**
+ * Swap/exchange icon for chain swap button
+ */
+declare function SwapIcon({ size, color, className, style, }: IconProps): react_jsx_runtime.JSX.Element;
+/**
+ * Loading spinner icon
+ */
+declare function SpinnerIcon({ size, color, className, style, }: IconProps): react_jsx_runtime.JSX.Element;
+/**
+ * Check/success icon
+ */
+declare function CheckIcon({ size, color, className, style, }: IconProps): react_jsx_runtime.JSX.Element;
+/**
+ * Error/X icon
+ */
+declare function ErrorIcon({ size, color, className, style, }: IconProps): react_jsx_runtime.JSX.Element;
+/**
+ * External link icon
+ */
+declare function ExternalLinkIcon({ size, color, className, style, }: IconProps): react_jsx_runtime.JSX.Element;
+/**
+ * Wallet icon
+ */
+declare function WalletIcon({ size, color, className, style, }: IconProps): react_jsx_runtime.JSX.Element;
+
+export { type BridgeChainConfig, type BridgeEstimate, type BridgeEvent, type BridgeParams, type BridgeQuote, type BridgeResult, type BridgeState, BridgeWidget, type BridgeWidgetProps, type BridgeWidgetTheme, CHAIN_ICONS, type ChainConfigValidationResult, CheckIcon, ChevronDownIcon, DEFAULT_CHAIN_CONFIGS, DEFAULT_LOCALE, ErrorIcon, ExternalLinkIcon, MAX_USDC_AMOUNT, MIN_USDC_AMOUNT, SpinnerIcon, SwapIcon, TESTNET_CHAIN_CONFIGS, THEME_COLORS, THEME_FONTS, THEME_SIZING, TOKEN_MESSENGER_ADDRESSES, TOKEN_MESSENGER_V1_ADDRESSES, TOKEN_MESSENGER_V2_ADDRESS, USDC_ADDRESSES, USDC_BRAND_COLOR, USDC_DECIMALS, type UseBridgeResult, WalletIcon, codex, createChainConfig, createTestnetChainConfig, defaultTheme, formatNumber, getChainName, getErrorMessage, hyperEvm, isValidPositiveAmount, mergeTheme, monad, parseUSDCAmount, plume, themePresets, unichain, useAllUSDCBalances, useBridge, useBridgeEstimate, useBridgeQuote, useFormatNumber, useUSDCAllowance, useUSDCBalance, validateAmountInput, validateChainConfig, validateChainConfigs };