Add WalletConnect logger option

.changeset/walletconnect-logger-option.md

@@ -0,0 +1,13 @@
+---
+'@reown/appkit-react-native': patch
+'@reown/appkit-bitcoin-react-native': patch
+'@reown/appkit-coinbase-react-native': patch
+'@reown/appkit-common-react-native': patch
+'@reown/appkit-core-react-native': patch
+'@reown/appkit-ethers-react-native': patch
+'@reown/appkit-solana-react-native': patch
+'@reown/appkit-ui-react-native': patch
+'@reown/appkit-wagmi-react-native': patch
+---
+
+feat: add `logger` option to `createAppKit` for controlling `@walletconnect/universal-provider` log output. Accepts a log level (`'silent' | 'fatal' | 'error' | 'warn' | 'info' | 'debug' | 'trace'`). When omitted, WalletConnect's default logging is preserved.

packages/appkit/src/AppKit.ts

@@ -393,7 +393,8 @@ export class AppKit {
     if (CustomConnector) {
       await CustomConnector.init({
         storage: this.config.storage,
-        metadata: this.config.metadata
+        metadata: this.config.metadata,
+        logger: this.config.logger
       });
 
       return CustomConnector;
@@ -413,7 +414,8 @@ export class AppKit {
     });
     await this.walletConnectConnector.init({
       storage: this.config.storage,
-      metadata: this.config.metadata
+      metadata: this.config.metadata,
+      logger: this.config.logger
     });
 
     return this.walletConnectConnector;

packages/appkit/src/connectors/WalletConnectConnector.ts

@@ -33,7 +33,8 @@ export class WalletConnectConnector extends WalletConnector {
 
     const provider = await this.getUniversalProvider({
       projectId: this.config.projectId,
-      metadata: ops.metadata
+      metadata: ops.metadata,
+      logger: ops.logger
     });
 
     this.provider = provider as Provider;
@@ -83,16 +84,19 @@ export class WalletConnectConnector extends WalletConnector {
 
   private async getUniversalProvider({
     projectId,
-    metadata
+    metadata,
+    logger
   }: {
     projectId: string;
     metadata: Metadata;
+    logger?: ConnectorInitOptions['logger'];
   }): Promise<UniversalProvider> {
     if (!this.provider) {
       this.provider = (await UniversalProvider.init({
         projectId,
         metadata,
-        storage: this.storage
+        storage: this.storage,
+        ...(logger !== undefined && { logger })
       })) as Provider;
     }
 

packages/appkit/src/types.ts

@@ -3,6 +3,7 @@ import {
   type Features,
   type UniversalProviderConfigOverride,
   type WalletConnector,
+  type ConnectorInitOptions,
   type BlockchainAdapter,
   type Metadata,
   type Network,
@@ -136,6 +137,15 @@ export interface AppKitConfig {
    */
   debug?: OptionsControllerState['debug'];
 
+  /**
+   * Optional logger configuration forwarded to `@walletconnect/universal-provider`.
+   * Accepts a log level (`'silent' | 'fatal' | 'error' | 'warn' | 'info' | 'debug' | 'trace'`).
+   * When omitted, WalletConnect's default logging is used.
+   *
+   * @example logger: 'silent'
+   */
+  logger?: ConnectorInitOptions['logger'];
+
   /**
    * Optional theme mode for the AppKit UI.
    * Controls whether the interface uses light or dark theme.

packages/common/src/types/wallet/connector.ts

@@ -32,9 +32,19 @@ export type ConnectOptions = {
   universalLink?: string;
 };
 
+export type WalletConnectLoggerLevel =
+  | 'silent'
+  | 'fatal'
+  | 'error'
+  | 'warn'
+  | 'info'
+  | 'debug'
+  | 'trace';
+
 export type ConnectorInitOptions = {
   storage: Storage;
   metadata: Metadata;
+  logger?: WalletConnectLoggerLevel;
 };
 
 export abstract class WalletConnector extends EventEmitter {