@reown/appkit-core-react-native 2.0.0-alpha.6 → 2.0.1

package/src/controllers/EventsController.ts

@@ -3,17 +3,25 @@ import { ApiController } from './ApiController';
 import { OptionsController } from './OptionsController';
 import { CoreHelperUtil } from '../utils/CoreHelperUtil';
 import { FetchUtil } from '../utils/FetchUtil';
-import type { Event, EventName } from '@reown/appkit-common-react-native';
+import type {
+  Event,
+  EventName,
+  WalletImpressionItem,
+  WcWallet
+} from '@reown/appkit-common-react-native';
 
 // -- Helpers ------------------------------------------- //
 const baseUrl = CoreHelperUtil.getAnalyticsUrl();
 const api = new FetchUtil({ baseUrl });
 const excluded = ['MODAL_CREATED'];
+const IMPRESSION_TIMEOUT = 3000;
 
 // -- Types --------------------------------------------- //
 export interface EventsControllerState {
   timestamp: number;
   data: Event;
+  pendingWalletImpressions: WalletImpressionItem[];
+  pendingImpressionTimeout?: NodeJS.Timeout;
 }
 
 // -- State --------------------------------------------- //
@@ -22,7 +30,9 @@ const state = proxy<EventsControllerState>({
   data: {
     type: 'track',
     event: 'MODAL_CREATED' // just for init purposes
-  }
+  },
+  pendingWalletImpressions: [],
+  pendingImpressionTimeout: undefined
 });
 
 // -- Controller ---------------------------------------- //
@@ -41,6 +51,53 @@ export const EventsController = {
     });
   },
 
+  trackWalletImpression(props: {
+    wallet: WcWallet;
+    view: 'Connect' | 'AllWallets';
+    displayIndex: number;
+    query?: string;
+    installed?: boolean;
+  }) {
+    state.pendingWalletImpressions.push({
+      name: props.wallet.name ?? 'Unknown',
+      walletRank: props.wallet.order,
+      explorerId: props.wallet.id,
+      certified: props.wallet.badge_type === 'certified',
+      displayIndex: props.displayIndex,
+      view: props.view,
+      query: props.query,
+      installed: props.installed
+    });
+
+    if (state.pendingImpressionTimeout) {
+      clearTimeout(state.pendingImpressionTimeout);
+    }
+
+    state.pendingImpressionTimeout = setTimeout(() => {
+      EventsController.sendWalletImpressions();
+    }, IMPRESSION_TIMEOUT);
+  },
+
+  sendWalletImpressions() {
+    if (state.pendingImpressionTimeout) {
+      clearTimeout(state.pendingImpressionTimeout);
+      state.pendingImpressionTimeout = undefined;
+    }
+
+    const impressions = state.pendingWalletImpressions;
+
+    if (impressions.length === 0) {
+      return;
+    }
+
+    state.pendingWalletImpressions = [];
+    EventsController.sendEvent({
+      type: 'track',
+      event: 'WALLET_IMPRESSION',
+      items: impressions
+    });
+  },
+
   async _sendAnalyticsEvent(data: EventsControllerState['data'], timestamp: number) {
     if (excluded.includes(data.event)) {
       return;
@@ -50,6 +107,7 @@ export const EventsController = {
       await api.post({
         path: '/e',
         headers: ApiController._getApiHeaders(),
+        params: ApiController._getApiParams(),
         body: {
           eventId: CoreHelperUtil.getUUID(),
           bundleId: CoreHelperUtil.getBundleId(),
@@ -71,5 +129,18 @@ export const EventsController = {
     if (OptionsController.state.enableAnalytics) {
       EventsController._sendAnalyticsEvent(data, timestamp);
     }
+  },
+
+  resetState() {
+    if (state.pendingImpressionTimeout) {
+      clearTimeout(state.pendingImpressionTimeout);
+      state.pendingImpressionTimeout = undefined;
+    }
+    state.pendingWalletImpressions = [];
+    state.data = {
+      type: 'track',
+      event: 'MODAL_CREATED'
+    };
+    state.timestamp = Date.now();
   }
 };

package/src/controllers/LogController.ts

@@ -0,0 +1,250 @@
+import { proxy } from 'valtio';
+import { OptionsController } from './OptionsController';
+import { sanitizeString, sanitizeStackTrace, sanitizeValue, sanitizeData } from '../utils/LogUtils';
+import { CoreHelperUtil } from '../utils/CoreHelperUtil';
+
+// -- Types --------------------------------------------- //
+export type LogLevel = 'info' | 'warn' | 'error' | 'debug';
+
+export interface LogEntry {
+  id: string;
+  timestamp: number;
+  level: LogLevel;
+  message: string;
+  fileName?: string;
+  functionName?: string;
+  data?: Record<string, unknown>;
+}
+
+export interface LogControllerState {
+  logs: LogEntry[];
+}
+
+// -- Constants ----------------------------------------- //
+const MAX_LOGS_COUNT = 300; // Prevent memory issues
+
+// -- State --------------------------------------------- //
+const state = proxy<LogControllerState>({
+  logs: []
+});
+
+const generateLogId = (): string => {
+  return CoreHelperUtil.getUUID();
+};
+
+const logToConsole = (entry: LogEntry) => {
+  const { debug } = OptionsController.state;
+
+  if (!debug) {
+    return;
+  }
+
+  const location =
+    entry.fileName && entry.functionName
+      ? `[${entry.fileName}:${entry.functionName}]`
+      : entry.fileName
+      ? `[${entry.fileName}]`
+      : '';
+
+  const logMessage = `[AppKit] ${location} ${entry.message}`;
+
+  switch (entry.level) {
+    case 'error':
+      // eslint-disable-next-line no-console
+      console.error(logMessage);
+      break;
+    case 'warn':
+      console.warn(logMessage);
+      break;
+    case 'debug':
+      // eslint-disable-next-line no-console
+      console.debug(logMessage);
+      break;
+    case 'info':
+    default:
+      // eslint-disable-next-line no-console
+      console.log(logMessage);
+      break;
+  }
+};
+
+// -- Controller ---------------------------------------- //
+export const LogController = {
+  state,
+
+  /**
+   * Destroy the LogController (cleanup resources)
+   */
+  destroy() {
+    // Clear all logs
+    state.logs = [];
+  },
+
+  /**
+   * Send a general log entry
+   */
+  sendLog(
+    level: LogLevel,
+    message: string,
+    fileName?: string,
+    functionName?: string,
+    data?: Record<string, unknown>
+  ) {
+    if (!OptionsController.state.debug) {
+      return;
+    }
+    const entry: LogEntry = {
+      id: generateLogId(),
+      timestamp: Date.now(),
+      level,
+      message: sanitizeString(message),
+      fileName,
+      functionName,
+      data: sanitizeData(data)
+    };
+
+    state.logs.push(entry);
+
+    // Enforce maximum log count
+    if (state.logs.length > MAX_LOGS_COUNT) {
+      state.logs = state.logs.slice(-MAX_LOGS_COUNT);
+    }
+
+    logToConsole(entry);
+  },
+
+  /**
+   * Send an error log entry - convenience method for try/catch blocks
+   */
+  sendError(
+    error: Error | string | unknown,
+    fileName?: string,
+    functionName?: string,
+    additionalData?: Record<string, unknown>
+  ) {
+    let message: string;
+    let data: Record<string, unknown> = sanitizeData(additionalData) || {};
+
+    if (error instanceof Error) {
+      message = error.message || 'Error occurred';
+      // Sanitize stack trace to remove sensitive file paths
+      data['stack'] = error.stack ? sanitizeStackTrace(error.stack) : undefined;
+      data['name'] = error.name;
+
+      // Sanitize any additional properties on the error object
+      const errorProps: Record<string, unknown> = {};
+      Object.getOwnPropertyNames(error).forEach(prop => {
+        if (prop !== 'message' && prop !== 'stack' && prop !== 'name') {
+          errorProps[prop] = (error as any)[prop];
+        }
+      });
+
+      if (Object.keys(errorProps).length > 0) {
+        Object.assign(data, sanitizeValue(errorProps) as Record<string, unknown>);
+      }
+    } else if (typeof error === 'string') {
+      message = error;
+    } else if (error && typeof error === 'object' && 'message' in error) {
+      // Handle error-like objects (e.g., RPC errors, custom error objects)
+      message = String((error as any).message) || 'Error occurred';
+      // Include all properties of the error object
+      Object.assign(data, sanitizeValue(error) as Record<string, unknown>);
+    } else {
+      message = 'Unknown error occurred';
+      // Sanitize the original error object
+      data['originalError'] = sanitizeValue(error);
+    }
+
+    // Note: sanitization happens in sendLog method
+    this.sendLog('error', message, fileName, functionName, data);
+  },
+
+  /**
+   * Send an info log entry
+   */
+  sendInfo(
+    message: string,
+    fileName?: string,
+    functionName?: string,
+    data?: Record<string, unknown>
+  ) {
+    this.sendLog('info', message, fileName, functionName, data);
+  },
+
+  /**
+   * Send a warning log entry
+   */
+  sendWarn(
+    message: string,
+    fileName?: string,
+    functionName?: string,
+    data?: Record<string, unknown>
+  ) {
+    this.sendLog('warn', message, fileName, functionName, data);
+  },
+
+  /**
+   * Send a debug log entry
+   */
+  sendDebug(
+    message: string,
+    fileName?: string,
+    functionName?: string,
+    data?: Record<string, unknown>
+  ) {
+    this.sendLog('debug', message, fileName, functionName, data);
+  },
+
+  /**
+   * Get all logs
+   */
+  getLogs(): LogEntry[] {
+    return [...state.logs];
+  },
+
+  /**
+   * Get logs by level
+   */
+  getLogsByLevel(level: LogLevel): LogEntry[] {
+    return state.logs.filter(log => log.level === level);
+  },
+
+  /**
+   * Get recent logs (last N entries)
+   */
+  getRecentLogs(count: number = 100): LogEntry[] {
+    return state.logs.slice(-count);
+  },
+
+  /**
+   * Clear all logs
+   */
+  clearLogs() {
+    state.logs = [];
+  },
+
+  /**
+   * Export logs as JSON string for debugging
+   */
+  exportLogs(): string {
+    return JSON.stringify(state.logs, null, 2);
+  },
+
+  /**
+   * Get logs count by level
+   */
+  getLogsStats(): Record<LogLevel, number> {
+    const stats: Record<LogLevel, number> = {
+      info: 0,
+      warn: 0,
+      error: 0,
+      debug: 0
+    };
+
+    state.logs.forEach(log => {
+      stats[log.level]++;
+    });
+
+    return stats;
+  }
+};

package/src/controllers/OnRampController.ts

@@ -19,6 +19,7 @@ import { OptionsController } from './OptionsController';
 import { ConstantsUtil, OnRampErrorType } from '../utils/ConstantsUtil';
 import { StorageUtil } from '../utils/StorageUtil';
 import { SnackController } from './SnackController';
+import { LogController } from './LogController';
 import { EventsController } from './EventsController';
 import { BlockchainApiController, EXCLUDED_ONRAMP_PROVIDERS } from './BlockchainApiController';
 import { ConnectionsController } from './ConnectionsController';
@@ -142,6 +143,7 @@ export const OnRampController = {
 
       StorageUtil.setOnRampPreferredCountry(country);
     } catch (error) {
+      LogController.sendError(error, 'OnRampController.ts', 'setSelectedCountry');
       state.loading = false;
       state.error = {
         type: OnRampErrorType.FAILED_TO_LOAD_COUNTRIES,
@@ -240,6 +242,7 @@ export const OnRampController = {
           countries.find(c => c.countryCode === countryCode) || countries[0] || undefined;
       }
     } catch (error) {
+      LogController.sendError(error, 'OnRampController.ts', 'fetchCountries');
       state.error = {
         type: OnRampErrorType.FAILED_TO_LOAD_COUNTRIES,
         message: 'Failed to load countries'
@@ -261,6 +264,7 @@ export const OnRampController = {
 
       state.countriesDefaults = countriesDefaults;
     } catch (error) {
+      LogController.sendError(error, 'OnRampController.ts', 'fetchCountriesDefaults');
       state.error = {
         type: OnRampErrorType.FAILED_TO_LOAD_COUNTRIES,
         message: 'Failed to load countries defaults'
@@ -282,6 +286,7 @@ export const OnRampController = {
 
       state.serviceProviders = serviceProviders || [];
     } catch (error) {
+      LogController.sendError(error, 'OnRampController.ts', 'fetchServiceProviders');
       state.error = {
         type: OnRampErrorType.FAILED_TO_LOAD_PROVIDERS,
         message: 'Failed to load service providers'
@@ -313,6 +318,7 @@ export const OnRampController = {
 
       state.selectedPaymentMethod = state.paymentMethods[0];
     } catch (error) {
+      LogController.sendError(error, 'OnRampController.ts', 'fetchPaymentMethods');
       state.error = {
         type: OnRampErrorType.FAILED_TO_LOAD_METHODS,
         message: 'Failed to load payment methods'
@@ -342,6 +348,7 @@ export const OnRampController = {
 
       state.purchaseCurrency = selectedCurrency || undefined;
     } catch (error) {
+      LogController.sendError(error, 'OnRampController.ts', 'fetchCryptoCurrencies');
       state.error = {
         type: OnRampErrorType.FAILED_TO_LOAD_CURRENCIES,
         message: 'Failed to load crypto currencies'
@@ -385,6 +392,7 @@ export const OnRampController = {
         this.setPaymentCurrency(defaultCurrency);
       }
     } catch (error) {
+      LogController.sendError(error, 'OnRampController.ts', 'fetchFiatCurrencies');
       state.error = {
         type: OnRampErrorType.FAILED_TO_LOAD_CURRENCIES,
         message: 'Failed to load fiat currencies'
@@ -503,6 +511,7 @@ export const OnRampController = {
         sp => sp.serviceProvider === state.selectedQuote?.serviceProvider
       );
     } catch (error: any) {
+      LogController.sendError(error, 'OnRampController.ts', 'getQuotes');
       if (error.name === 'AbortError') {
         // Do nothing, another request was made
         return;
@@ -553,6 +562,7 @@ export const OnRampController = {
 
       state.paymentCurrenciesLimits = limits;
     } catch (error) {
+      LogController.sendError(error, 'OnRampController.ts', 'fetchFiatLimits');
       state.error = {
         type: OnRampErrorType.FAILED_TO_LOAD_LIMITS,
         message: 'Failed to load fiat limits'
@@ -617,6 +627,7 @@ export const OnRampController = {
 
       return widget;
     } catch (e: any) {
+      LogController.sendError(e, 'OnRampController.ts', 'generateWidget', { quote });
       EventsController.sendEvent({
         type: 'track',
         event: 'BUY_FAIL',
@@ -662,6 +673,7 @@ export const OnRampController = {
         this.fetchFiatCurrencies()
       ]);
     } catch (error) {
+      LogController.sendError(error, 'OnRampController.ts', 'loadOnRampData');
       if (!state.error) {
         state.error = {
           type: OnRampErrorType.FAILED_TO_LOAD,

package/src/controllers/SendController.ts

@@ -9,6 +9,7 @@ import { RouterController } from './RouterController';
 import { ConnectionsController } from './ConnectionsController';
 import { SwapController } from './SwapController';
 import { ConstantsUtil as CoreConstantsUtil } from '../utils/ConstantsUtil';
+import { LogController } from './LogController';
 
 // -- Types --------------------------------------------- //
 export interface TxParams {
@@ -86,7 +87,7 @@ export const SendController = {
       isSmartAccount: ConnectionsController.state.accountType === 'smartAccount',
       token: this.state.token?.address ?? this.state.token?.symbol ?? '',
       amount: this.state.sendTokenAmount || 0,
-      network: ConnectionsController.state.activeNetwork?.caipNetworkId ?? ''
+      network: ConnectionsController.state.activeNetwork?.caipNetworkId
     };
 
     try {
@@ -120,13 +121,17 @@ export const SendController = {
       RouterController.reset(isAuth ? 'Account' : 'AccountDefault');
       this.resetState();
     } catch (error: any) {
+      LogController.sendError(error, 'SendController.ts', 'sendToken');
       EventsController.sendEvent({
         type: 'track',
         event: 'SEND_ERROR',
         properties: eventProperties
       });
 
-      if (error?.message && error?.message.includes('user rejected')) {
+      if (
+        error?.message &&
+        (error?.message.includes('user rejected') || error?.message.includes('canceled'))
+      ) {
         SnackController.showError('Transaction cancelled');
       } else {
         SnackController.showError('Something went wrong');

package/src/controllers/SwapController.ts

@@ -14,6 +14,7 @@ import { BlockchainApiController } from './BlockchainApiController';
 import { OptionsController } from './OptionsController';
 import { SwapCalculationUtil } from '../utils/SwapCalculationUtil';
 import { SnackController } from './SnackController';
+import { LogController } from './LogController';
 import { RouterController } from './RouterController';
 import { CoreHelperUtil } from '../utils/CoreHelperUtil';
 import { TransactionsController } from './TransactionsController';
@@ -249,6 +250,7 @@ export const SwapController = {
         this.setSourceTokenAmount('1');
       }
     } catch (error) {
+      LogController.sendError(error, 'SwapController.ts', 'initializeState');
       SnackController.showError('Failed to initialize swap');
       RouterController.goBack();
     } finally {
@@ -491,6 +493,7 @@ export const SwapController = {
         this.setTransactionDetails();
       }
     } catch (error) {
+      LogController.sendError(error, 'SwapController.ts', 'getQuote');
       SnackController.showError('Failed to get swap quote');
     } finally {
       state.loadingQuote = false;
@@ -729,7 +732,7 @@ export const SwapController = {
         type: 'track',
         event: 'SWAP_SUCCESS',
         properties: {
-          network: ConnectionsController.state.activeNetwork?.caipNetworkId || '',
+          network: ConnectionsController.state.activeNetwork?.caipNetworkId,
           swapFromToken: this.state.sourceToken?.symbol || '',
           swapToToken: this.state.toToken?.symbol || '',
           swapFromAmount: this.state.sourceTokenAmount || '',
@@ -750,6 +753,11 @@ export const SwapController = {
       return transactionHash;
     } catch (err) {
       const error = err as TransactionError;
+      LogController.sendError(error, 'SwapController.ts', 'sendTransactionForSwap', {
+        sourceToken: this.state.sourceToken?.symbol,
+        toToken: this.state.toToken?.symbol,
+        amount: this.state.sourceTokenAmount
+      });
       state.transactionError = error?.shortMessage;
       state.loadingTransaction = false;
       SnackController.showError(error?.shortMessage ?? 'Transaction error');
@@ -758,7 +766,7 @@ export const SwapController = {
         event: 'SWAP_ERROR',
         properties: {
           message: error?.shortMessage ?? error?.message ?? 'Unknown',
-          network: ConnectionsController.state.activeNetwork?.caipNetworkId || '',
+          network: ConnectionsController.state.activeNetwork?.caipNetworkId,
           swapFromToken: this.state.sourceToken?.symbol || '',
           swapToToken: this.state.toToken?.symbol || '',
           swapFromAmount: this.state.sourceTokenAmount || '',

package/src/controllers/TransactionsController.ts

@@ -5,6 +5,7 @@ import { EventsController } from './EventsController';
 import { SnackController } from './SnackController';
 import { BlockchainApiController } from './BlockchainApiController';
 import { ConnectionsController } from './ConnectionsController';
+import { LogController } from './LogController';
 
 // -- Types --------------------------------------------- //
 type TransactionByMonthMap = Record<string, Transaction[]>;
@@ -74,6 +75,7 @@ export const TransactionsController = {
       state.empty = nonSpamTransactions.length === 0;
       state.next = response?.next ? response.next : undefined;
     } catch (error) {
+      LogController.sendError(error, 'TransactionsController.ts', 'fetchTransactions');
       EventsController.sendEvent({
         type: 'track',
         event: 'ERROR_FETCH_TRANSACTIONS',

package/src/features/reown-authentication/ReownAuthentication.ts

@@ -16,6 +16,8 @@ import { ConnectionsController } from '../../controllers/ConnectionsController';
 import { CoreHelperUtil } from '../../utils/CoreHelperUtil';
 import { OptionsController } from '../../controllers/OptionsController';
 import { FetchUtil } from '../../utils/FetchUtil';
+import { ApiUtil } from '../../utils/ApiUtil';
+import { LogController } from '../../controllers/LogController';
 
 /**
  * This is the configuration for using SIWX with Reown Authentication service.
@@ -108,7 +110,9 @@ export class ReownAuthentication implements SIWXConfig {
       this.emit('sessionChanged', session);
 
       return [session];
-    } catch {
+    } catch (error) {
+      LogController.sendError(error, 'ReownAuthentication.ts', 'getSessions');
+
       return [];
     }
   }
@@ -299,13 +303,14 @@ export class ReownAuthentication implements SIWXConfig {
   }
 
   private getSDKProperties(): { projectId: string; st: string; sv: string; domain: string } {
-    const headers = ApiController._getApiHeaders();
+    const { projectId, st, sv } = ApiController._getApiParams();
+    const domain = ApiUtil.getOrigin();
 
     return {
-      projectId: headers['x-project-id'],
-      st: headers['x-sdk-type'],
-      sv: headers['x-sdk-version'],
-      domain: headers['origin']
+      projectId,
+      st,
+      sv,
+      domain
     };
   }
 

package/src/index.ts

@@ -16,6 +16,13 @@ export {
 
 export { SnackController, type SnackControllerState } from './controllers/SnackController';
 
+export {
+  LogController,
+  type LogControllerState,
+  type LogEntry,
+  type LogLevel
+} from './controllers/LogController';
+
 export { ApiController, type ApiControllerState } from './controllers/ApiController';
 
 export { AssetController, type AssetControllerState } from './controllers/AssetController';
@@ -54,6 +61,7 @@ export { CoreHelperUtil } from './utils/CoreHelperUtil';
 export { StorageUtil } from './utils/StorageUtil';
 export { EventUtil } from './utils/EventUtil';
 export { WalletUtil } from './utils/WalletUtil';
+export { LogUtils } from './utils/LogUtils';
 
 // -- Features ----------------------------------------------------------------
 export { ReownAuthentication } from './features/reown-authentication/ReownAuthentication';

package/src/utils/ApiUtil.ts

@@ -3,7 +3,7 @@ import { CoreHelperUtil } from './CoreHelperUtil';
 
 export const ApiUtil = {
   getOrigin() {
-    return CoreHelperUtil.getBundleId();
+    return CoreHelperUtil.getBundleId() ?? 'react-native-unknown-origin';
   },
 
   getReactNativeVersion() {

package/src/utils/ConstantsUtil.ts

@@ -37,7 +37,6 @@ export const ConstantsUtil = {
   NATIVE_TOKEN_ADDRESS: {
     eip155: '0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee',
     solana: 'So11111111111111111111111111111111111111111',
-    polkadot: '0x',
     bip122: '0x'
   } as const satisfies Record<ChainNamespace, string>,
 

package/src/utils/CoreHelperUtil.ts

@@ -252,7 +252,7 @@ export const CoreHelperUtil = {
     });
   },
 
-  getBundleId() {
+  getBundleId(): string | undefined {
     if ((global as any)?.Application?.applicationId) {
       return (global as any)?.Application?.applicationId;
     }