@hongming-wang/usdc-bridge-widget 0.2.1 → 0.2.2

package/dist/index.d.mts

@@ -59,7 +59,12 @@ interface BridgeChainConfig {
     chain: Chain;
     /** USDC token contract address on this chain (checksummed) */
     usdcAddress: `0x${string}`;
-    /** Circle TokenMessenger contract address for CCTP transfers */
+    /**
+     * Circle TokenMessenger contract address for CCTP transfers.
+     * While marked optional for type flexibility, this address is required
+     * for bridging to work. The widget will use TOKEN_MESSENGER_ADDRESSES
+     * from constants.ts as defaults if not provided via createChainConfig().
+     */
     tokenMessengerAddress?: `0x${string}`;
     /** URL for the chain's icon/logo image (optional, falls back to initial) */
     iconUrl?: string;

package/dist/index.d.ts

@@ -59,7 +59,12 @@ interface BridgeChainConfig {
     chain: Chain;
     /** USDC token contract address on this chain (checksummed) */
     usdcAddress: `0x${string}`;
-    /** Circle TokenMessenger contract address for CCTP transfers */
+    /**
+     * Circle TokenMessenger contract address for CCTP transfers.
+     * While marked optional for type flexibility, this address is required
+     * for bridging to work. The widget will use TOKEN_MESSENGER_ADDRESSES
+     * from constants.ts as defaults if not provided via createChainConfig().
+     */
     tokenMessengerAddress?: `0x${string}`;
     /** URL for the chain's icon/logo image (optional, falls back to initial) */
     iconUrl?: string;

package/dist/index.js

@@ -127,6 +127,7 @@ var USDC_ADDRESSES = {
   // Sonic
   480: "0x79A02482A880bCE3F13e09Da970dC34db4CD24d1",
   // World Chain
+  // Note: Monad is defined but not yet supported by Circle Bridge Kit SDK
   10200: "0x754704Bc059F8C67012fEd69BC8A327a5aafb603",
   // Monad
   1329: "0xe15fC38F6D8c56aF07bbCBe3BAf5708A2Bf42392",
@@ -617,6 +618,8 @@ function useBridgeQuote(sourceChainId, destChainId, amount) {
 }
 
 // src/hooks.ts
+var _useBridgeEstimateWarned = false;
+var _useFormatNumberWarned = false;
 function useUSDCBalance(chainConfig) {
   const { address } = (0, import_wagmi2.useAccount)();
   const {
@@ -685,6 +688,8 @@ function useAllUSDCBalances(chainConfigs) {
   return {
     balances,
     isLoading,
+    // Cast to () => void since we don't need the Promise return value.
+    // The caller just needs to trigger a refetch, not await it.
     refetch
   };
 }
@@ -767,9 +772,12 @@ function useUSDCAllowance(chainConfig, spenderAddress) {
 }
 function useBridgeEstimate(sourceChainId, destChainId, amount) {
   (0, import_react2.useEffect)(() => {
-    console.warn(
-      "[DEPRECATED] useBridgeEstimate is deprecated and will be removed in a future version. Use useBridgeQuote from './useBridge' instead."
-    );
+    if (!_useBridgeEstimateWarned) {
+      _useBridgeEstimateWarned = true;
+      console.warn(
+        "[DEPRECATED] useBridgeEstimate is deprecated and will be removed in a future version. Use useBridgeQuote from './useBridge' instead."
+      );
+    }
   }, []);
   const [estimate, setEstimate] = (0, import_react2.useState)(null);
   const [isLoading, setIsLoading] = (0, import_react2.useState)(false);
@@ -825,9 +833,12 @@ function useBridgeEstimate(sourceChainId, destChainId, amount) {
 }
 function useFormatNumber() {
   (0, import_react2.useEffect)(() => {
-    console.warn(
-      "[DEPRECATED] useFormatNumber is deprecated and will be removed in a future version. Use the formatNumber utility function from './utils' directly instead."
-    );
+    if (!_useFormatNumberWarned) {
+      _useFormatNumberWarned = true;
+      console.warn(
+        "[DEPRECATED] useFormatNumber is deprecated and will be removed in a future version. Use the formatNumber utility function from './utils' directly instead."
+      );
+    }
   }, []);
   return (0, import_react2.useCallback)(
     (value, decimals = 2) => {
@@ -1995,10 +2006,10 @@ function BridgeWidget({
     sourceChainConfig
   );
   (0, import_react3.useEffect)(() => {
-    if (address) {
+    if (isConnected && address) {
       refetchAllBalances();
     }
-  }, [address, refetchAllBalances]);
+  }, [isConnected, address, refetchAllBalances]);
   const { bridge: executeBridge, state: bridgeState, reset: resetBridge } = useBridge();
   const { isLoading: isConfirming, isSuccess } = (0, import_wagmi3.useWaitForTransactionReceipt)({
     hash: txHash

package/dist/index.mjs

@@ -47,6 +47,7 @@ var USDC_ADDRESSES = {
   // Sonic
   480: "0x79A02482A880bCE3F13e09Da970dC34db4CD24d1",
   // World Chain
+  // Note: Monad is defined but not yet supported by Circle Bridge Kit SDK
   10200: "0x754704Bc059F8C67012fEd69BC8A327a5aafb603",
   // Monad
   1329: "0xe15fC38F6D8c56aF07bbCBe3BAf5708A2Bf42392",
@@ -537,6 +538,8 @@ function useBridgeQuote(sourceChainId, destChainId, amount) {
 }
 
 // src/hooks.ts
+var _useBridgeEstimateWarned = false;
+var _useFormatNumberWarned = false;
 function useUSDCBalance(chainConfig) {
   const { address } = useAccount2();
   const {
@@ -605,6 +608,8 @@ function useAllUSDCBalances(chainConfigs) {
   return {
     balances,
     isLoading,
+    // Cast to () => void since we don't need the Promise return value.
+    // The caller just needs to trigger a refetch, not await it.
     refetch
   };
 }
@@ -687,9 +692,12 @@ function useUSDCAllowance(chainConfig, spenderAddress) {
 }
 function useBridgeEstimate(sourceChainId, destChainId, amount) {
   useEffect2(() => {
-    console.warn(
-      "[DEPRECATED] useBridgeEstimate is deprecated and will be removed in a future version. Use useBridgeQuote from './useBridge' instead."
-    );
+    if (!_useBridgeEstimateWarned) {
+      _useBridgeEstimateWarned = true;
+      console.warn(
+        "[DEPRECATED] useBridgeEstimate is deprecated and will be removed in a future version. Use useBridgeQuote from './useBridge' instead."
+      );
+    }
   }, []);
   const [estimate, setEstimate] = useState2(null);
   const [isLoading, setIsLoading] = useState2(false);
@@ -745,9 +753,12 @@ function useBridgeEstimate(sourceChainId, destChainId, amount) {
 }
 function useFormatNumber() {
   useEffect2(() => {
-    console.warn(
-      "[DEPRECATED] useFormatNumber is deprecated and will be removed in a future version. Use the formatNumber utility function from './utils' directly instead."
-    );
+    if (!_useFormatNumberWarned) {
+      _useFormatNumberWarned = true;
+      console.warn(
+        "[DEPRECATED] useFormatNumber is deprecated and will be removed in a future version. Use the formatNumber utility function from './utils' directly instead."
+      );
+    }
   }, []);
   return useCallback2(
     (value, decimals = 2) => {
@@ -1934,10 +1945,10 @@ function BridgeWidget({
     sourceChainConfig
   );
   useEffect3(() => {
-    if (address) {
+    if (isConnected && address) {
       refetchAllBalances();
     }
-  }, [address, refetchAllBalances]);
+  }, [isConnected, address, refetchAllBalances]);
   const { bridge: executeBridge, state: bridgeState, reset: resetBridge } = useBridge();
   const { isLoading: isConfirming, isSuccess } = useWaitForTransactionReceipt2({
     hash: txHash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hongming-wang/usdc-bridge-widget",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "A reusable USDC cross-chain bridge widget powered by Circle CCTP",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/BridgeWidget.tsx

@@ -804,12 +804,12 @@ export function BridgeWidget({
     sourceChainConfig
   );
 
-  // Refetch balances when wallet connects or address changes
+  // Refetch balances when wallet connects, disconnects, or address changes
   useEffect(() => {
-    if (address) {
+    if (isConnected && address) {
       refetchAllBalances();
     }
-  }, [address, refetchAllBalances]);
+  }, [isConnected, address, refetchAllBalances]);
 
   // Bridge hook
   const { bridge: executeBridge, state: bridgeState, reset: resetBridge } = useBridge();
@@ -1027,6 +1027,7 @@ export function BridgeWidget({
         onConnectWallet();
       } else {
         // Warn when onConnectWallet is not provided - helps developers debug
+        // Note: Bundlers typically strip console.warn in production builds
         console.warn(
           "[BridgeWidget] onConnectWallet prop is not provided. " +
           "Please provide onConnectWallet to handle wallet connection " +

package/src/__tests__/BridgeWidget.test.tsx

@@ -293,6 +293,37 @@ describe("BridgeWidget - Disconnected State", () => {
     expect(screen.queryByText(/1,000.00 USDC/)).toBeNull();
     expect(screen.queryByText(/500.00 USDC/)).toBeNull();
   });
+
+  it("refetches balances when isConnected changes to true", () => {
+    const refetchMock = vi.fn();
+    mockUseAllUSDCBalances.mockReturnValue({
+      balances: {},
+      isLoading: false,
+      refetch: refetchMock,
+    });
+
+    // Start disconnected
+    mockUseAccount.mockReturnValue({
+      address: undefined,
+      isConnected: false,
+    });
+
+    const { rerender } = render(<BridgeWidget />);
+
+    // Refetch should not be called when disconnected
+    expect(refetchMock).not.toHaveBeenCalled();
+
+    // Simulate wallet connection
+    mockUseAccount.mockReturnValue({
+      address: "0x1234567890123456789012345678901234567890",
+      isConnected: true,
+    });
+
+    rerender(<BridgeWidget />);
+
+    // Refetch should be called after connection
+    expect(refetchMock).toHaveBeenCalled();
+  });
 });
 
 describe("BridgeWidget - Chain Switch Required", () => {

package/src/constants.ts

@@ -29,6 +29,7 @@ export const USDC_ADDRESSES: Record<number, `0x${string}`> = {
   130: "0x078D782b760474a361dDA0AF3839290b0EF57AD6", // Unichain
   146: "0x29219dd400f2Bf60E5a23d13Be72B486D4038894", // Sonic
   480: "0x79A02482A880bCE3F13e09Da970dC34db4CD24d1", // World Chain
+  // Note: Monad is defined but not yet supported by Circle Bridge Kit SDK
   10200: "0x754704Bc059F8C67012fEd69BC8A327a5aafb603", // Monad
   1329: "0xe15fC38F6D8c56aF07bbCBe3BAf5708A2Bf42392", // Sei
   50: "0xfA2958CB79b0491CC627c1557F441eF849Ca8eb1", // XDC

package/src/hooks.ts

@@ -12,6 +12,10 @@ import { USDC_DECIMALS } from "./constants";
 import { formatNumber } from "./utils";
 import { getBridgeChain } from "./useBridge";
 
+// Module-level flags to emit deprecation warnings only once per session
+let _useBridgeEstimateWarned = false;
+let _useFormatNumberWarned = false;
+
 /**
  * Hook to get USDC balance for a specific chain
  */
@@ -119,6 +123,8 @@ export function useAllUSDCBalances(chainConfigs: BridgeChainConfig[]): {
   return {
     balances,
     isLoading,
+    // Cast to () => void since we don't need the Promise return value.
+    // The caller just needs to trigger a refetch, not await it.
     refetch: refetch as () => void,
   };
 }
@@ -249,12 +255,15 @@ export function useBridgeEstimate(
   destChainId: number | undefined,
   amount: string
 ) {
-  // Emit deprecation warning once
+  // Emit deprecation warning once per session
   useEffect(() => {
-    console.warn(
-      "[DEPRECATED] useBridgeEstimate is deprecated and will be removed in a future version. " +
-      "Use useBridgeQuote from './useBridge' instead."
-    );
+    if (!_useBridgeEstimateWarned) {
+      _useBridgeEstimateWarned = true;
+      console.warn(
+        "[DEPRECATED] useBridgeEstimate is deprecated and will be removed in a future version. " +
+        "Use useBridgeQuote from './useBridge' instead."
+      );
+    }
   }, []);
 
   const [estimate, setEstimate] = useState<BridgeEstimate | null>(null);
@@ -341,12 +350,15 @@ export function useBridgeEstimate(
  * const formatted = formatNumber(1234.56, 2);
  */
 export function useFormatNumber() {
-  // Emit deprecation warning once
+  // Emit deprecation warning once per session
   useEffect(() => {
-    console.warn(
-      "[DEPRECATED] useFormatNumber is deprecated and will be removed in a future version. " +
-      "Use the formatNumber utility function from './utils' directly instead."
-    );
+    if (!_useFormatNumberWarned) {
+      _useFormatNumberWarned = true;
+      console.warn(
+        "[DEPRECATED] useFormatNumber is deprecated and will be removed in a future version. " +
+        "Use the formatNumber utility function from './utils' directly instead."
+      );
+    }
   }, []);
 
   return useCallback(

package/src/types.ts

@@ -55,7 +55,12 @@ export interface BridgeChainConfig {
   chain: Chain;
   /** USDC token contract address on this chain (checksummed) */
   usdcAddress: `0x${string}`;
-  /** Circle TokenMessenger contract address for CCTP transfers */
+  /**
+   * Circle TokenMessenger contract address for CCTP transfers.
+   * While marked optional for type flexibility, this address is required
+   * for bridging to work. The widget will use TOKEN_MESSENGER_ADDRESSES
+   * from constants.ts as defaults if not provided via createChainConfig().
+   */
   tokenMessengerAddress?: `0x${string}`;
   /** URL for the chain's icon/logo image (optional, falls back to initial) */
   iconUrl?: string;

package/src/useBridge.ts

@@ -5,7 +5,9 @@ import { createViemAdapterFromProvider } from "@circle-fin/adapter-viem-v2";
 import type { BridgeChainConfig } from "./types";
 import type { EIP1193Provider } from "viem";
 
-// Maximum number of events to retain to prevent memory growth
+// Maximum number of events to retain to prevent memory growth.
+// 100 events is sufficient to track a full bridge lifecycle (approve, burn, attestation, mint)
+// while preventing unbounded memory growth in long-running sessions.
 const MAX_EVENTS = 100;
 
 // Chain ID to BridgeChain enum mapping
@@ -256,7 +258,8 @@ export function useBridge(): UseBridgeResult {
             kit.off("fetchAttestation", handleFetchAttestation);
             kit.off("mint", handleMint);
           } catch {
-            // Ignore errors during cleanup (kit may not support off)
+            // Bridge Kit's off() method may not exist in all versions or may throw
+            // if listeners were already removed. Safe to ignore during cleanup.
           }
         };