@reown/appkit-core-react-native 0.0.0-feat-multichain-20250925184834 → 0.0.0-feat-multichain-20250930155416

package/lib/typescript/utils/StorageUtil.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StorageUtil.d.ts","sourceRoot":"","sources":["../../../src/utils/StorageUtil.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,QAAQ,EAEb,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,cAAc,EAEpB,MAAM,mCAAmC,CAAC;AAI3C,eAAO,MAAM,WAAW;6CACmB,cAAc;;;4BAkCzB,QAAQ;8BAuBN,QAAQ,EAAE;wBAQhB,QAAQ,QAAQ,EAAE,CAAC;;cAgBrC,aAAa;oBACP,MAAM,EAAE;;8BAiBU,QAAQ;QAAE,IAAI,EAAE,aAAa,CAAC;QAAC,UAAU,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC;oCAclD,aAAa;uCAaV,aAAa;;6CAyBP,kBAAkB;;kCAyB7B,aAAa,EAAE;;kDAsBC,qBAAqB,EAAE;;gDAsCzB,qBAAqB,EAAE;;oCAuCnC,eAAe,EAAE;;4CAsCT,kBAAkB,EAAE;;mCAsC7B,cAAc;;;CAoCpD,CAAC"}
+{"version":3,"file":"StorageUtil.d.ts","sourceRoot":"","sources":["../../../src/utils/StorageUtil.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,QAAQ,EAEb,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,cAAc,EAEpB,MAAM,mCAAmC,CAAC;AAK3C,eAAO,MAAM,WAAW;6CACmB,cAAc;;;4BAkCzB,QAAQ;8BAuBN,QAAQ,EAAE;wBAQhB,QAAQ,QAAQ,EAAE,CAAC;;cAgBrC,aAAa;oBACP,MAAM,EAAE;;8BAiBU,QAAQ;QAAE,IAAI,EAAE,aAAa,CAAC;QAAC,UAAU,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC;oCAclD,aAAa;uCAaV,aAAa;;6CAyBP,kBAAkB;;kCAyB7B,aAAa,EAAE;;kDAsBC,qBAAqB,EAAE;;gDAsCzB,qBAAqB,EAAE;;oCAsCnC,eAAe,EAAE;;4CAsCT,kBAAkB,EAAE;;mCAsC7B,cAAc;;;CAmCpD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reown/appkit-core-react-native",
-  "version": "0.0.0-feat-multichain-20250925184834",
+  "version": "0.0.0-feat-multichain-20250930155416",
   "main": "lib/commonjs/index.js",
   "types": "lib/typescript/index.d.ts",
   "module": "lib/module/index.js",
@@ -40,10 +40,10 @@
     "provenance": true
   },
   "dependencies": {
-    "@reown/appkit-common-react-native": "0.0.0-feat-multichain-20250925184834",
+    "@reown/appkit-common-react-native": "0.0.0-feat-multichain-20250930155416",
     "countries-and-timezones": "3.7.2",
     "derive-valtio": "0.2.0",
-    "valtio": "2.1.5"
+    "valtio": "2.1.8"
   },
   "peerDependencies": {
     "@walletconnect/react-native-compat": ">=2.16.1",

package/src/controllers/ApiController.ts

@@ -19,6 +19,7 @@ import { WcController } from './WcController';
 import { ApiUtil } from '../utils/ApiUtil';
 import { SnackController } from './SnackController';
 import { ConnectionsController } from './ConnectionsController';
+import { LogController } from './LogController';
 
 // -- Helpers ------------------------------------------- //
 const baseUrl = CoreHelperUtil.getApiUrl();
@@ -65,13 +66,18 @@ export const ApiController = {
     return subKey(state, key, callback);
   },
 
-  _getApiHeaders() {
+  _getApiParams() {
     const { projectId, sdkType, sdkVersion } = OptionsController.state;
 
     return {
-      'x-project-id': projectId,
-      'x-sdk-type': sdkType,
-      'x-sdk-version': sdkVersion,
+      projectId,
+      st: sdkType,
+      sv: sdkVersion
+    };
+  },
+
+  _getApiHeaders() {
+    return {
       'User-Agent': ApiUtil.getUserAgent(),
       'origin': ApiUtil.getOrigin()
     };
@@ -79,7 +85,11 @@ export const ApiController = {
 
   async _fetchWalletImage(imageId: string) {
     const headers = ApiController._getApiHeaders();
-    const url = await api.fetchImage(`/getWalletImage/${imageId}`, headers);
+    const url = await api.fetchImage(
+      `/getWalletImage/${imageId}`,
+      headers,
+      ApiController._getApiParams()
+    );
     if (url) {
       AssetController.setWalletImage(imageId, url);
     }
@@ -92,7 +102,11 @@ export const ApiController = {
     }
 
     const headers = ApiController._getApiHeaders();
-    const url = await api.fetchImage(`/public/getAssetImage/${imageId}`, headers);
+    const url = await api.fetchImage(
+      `/public/getAssetImage/${imageId}`,
+      headers,
+      ApiController._getApiParams()
+    );
     if (url) {
       AssetController.setNetworkImage(networkId, url);
     }
@@ -117,6 +131,7 @@ export const ApiController = {
       const path = Platform.select({ default: 'getIosData', android: 'getAndroidData' });
       const response = await api.get<ApiGetDataWalletsResponse>({
         path,
+        params: ApiController._getApiParams(),
         headers: ApiController._getApiHeaders()
       });
 
@@ -157,6 +172,7 @@ export const ApiController = {
           path: '/getWallets',
           headers: ApiController._getApiHeaders(),
           params: {
+            ...ApiController._getApiParams(),
             page: '1',
             platform: this.platform(),
             entries: installed?.length.toString(),
@@ -204,8 +220,7 @@ export const ApiController = {
     } catch (error) {
       state.installed = [];
       clearTimeout(timeoutId);
-      // eslint-disable-next-line no-console
-      console.log('Error fetching installed wallets', error);
+      LogController.sendError(error, 'ApiController.ts', 'fetchInstalledWallets');
     }
   },
 
@@ -219,6 +234,7 @@ export const ApiController = {
         path: '/getWallets',
         headers: ApiController._getApiHeaders(),
         params: {
+          ...ApiController._getApiParams(),
           page: '1',
           platform: this.platform(),
           entries: featuredWalletIds?.length
@@ -270,6 +286,7 @@ export const ApiController = {
       path: '/getWallets',
       headers: ApiController._getApiHeaders(),
       params: {
+        ...ApiController._getApiParams(),
         page: '1',
         platform: this.platform(),
         entries: recommendedEntries,
@@ -309,6 +326,7 @@ export const ApiController = {
       path: '/getWallets',
       headers: ApiController._getApiHeaders(),
       params: {
+        ...ApiController._getApiParams(),
         page: String(page),
         platform: this.platform(),
         entries: String(defaultEntries),
@@ -343,6 +361,7 @@ export const ApiController = {
       path: '/getWallets',
       headers: ApiController._getApiHeaders(),
       params: {
+        ...ApiController._getApiParams(),
         page: '1',
         platform: this.platform(),
         entries: String(defaultEntries),
@@ -426,6 +445,7 @@ export const ApiController = {
   async fetchAnalyticsConfig() {
     const response = await api.get<ApiGetAnalyticsConfigResponse>({
       path: '/getAnalyticsConfig',
+      params: ApiController._getApiParams(),
       headers: ApiController._getApiHeaders()
     });
     if (!response) return;

package/src/controllers/BlockchainApiController.ts

@@ -42,17 +42,24 @@ import { ConstantsUtil } from '../utils/ConstantsUtil';
 import { ApiUtil } from '../utils/ApiUtil';
 
 import { SnackController } from './SnackController';
+import { LogController } from './LogController';
 
 // -- Helpers ------------------------------------------- //
 const baseUrl = CoreHelperUtil.getBlockchainApiUrl();
 
-const getHeaders = () => {
-  const { sdkType, sdkVersion } = OptionsController.state;
+const getParams = () => {
+  const { projectId, sdkType, sdkVersion } = OptionsController.state;
 
+  return {
+    projectId,
+    st: sdkType,
+    sv: sdkVersion
+  };
+};
+
+const getHeaders = () => {
   return {
     'Content-Type': 'application/json',
-    'x-sdk-type': sdkType,
-    'x-sdk-version': sdkVersion,
     'User-Agent': ApiUtil.getUserAgent(),
     'origin': ApiUtil.getOrigin()
   };
@@ -89,6 +96,8 @@ export const BlockchainApiController = {
         await BlockchainApiController.getSupportedNetworks();
       }
     } catch (e) {
+      LogController.sendError(e, 'BlockchainApiController.ts', 'isNetworkSupported');
+
       return false;
     }
 
@@ -97,7 +106,8 @@ export const BlockchainApiController = {
 
   async getSupportedNetworks() {
     const supportedChains = await state.api.get<BlockchainApiControllerState['supportedChains']>({
-      path: 'v1/supported-chains'
+      path: 'v1/supported-chains',
+      params: getParams()
     });
 
     state.supportedChains = supportedChains!;
@@ -110,15 +120,13 @@ export const BlockchainApiController = {
 
     return state.api.get<BlockchainApiIdentityResponse>({
       path: `/v1/identity/${address}`,
-      params: {
-        projectId: OptionsController.state.projectId
-      },
-      headers: getHeaders()
+      headers: getHeaders(),
+      params: getParams()
     });
   },
 
   async fetchTransactions(params: BlockchainApiTransactionsRequest) {
-    const { account, projectId, cursor, signal, cache, chainId } = params;
+    const { account, cursor, signal, cache, chainId } = params;
     const isSupported = ConstantsUtil.ACTIVITY_SUPPORTED_CHAINS.includes(chainId);
 
     if (!isSupported) {
@@ -129,7 +137,7 @@ export const BlockchainApiController = {
       path: `/v1/account/${account}/history`,
       headers: getHeaders(),
       params: {
-        projectId,
+        ...getParams(),
         cursor,
         chainId
       },
@@ -150,19 +158,20 @@ export const BlockchainApiController = {
 
     const response = await state.api.post<BlockchainApiTokenPriceResponse>({
       path: '/v1/fungible/price',
+      headers: getHeaders(),
+      params: getParams(),
       body: {
         projectId,
         currency: 'usd',
         addresses
-      },
-      headers: getHeaders()
+      }
     });
 
     return response;
   },
 
   async fetchSwapAllowance(params: BlockchainApiSwapAllowanceRequest) {
-    const { projectId, tokenAddress, userAddress } = params;
+    const { tokenAddress, userAddress } = params;
     const [namespace, chain] = userAddress.split(':');
     const networkId: CaipNetworkId = `${namespace}:${chain}`;
     const isSupported = await BlockchainApiController.isNetworkSupported(networkId);
@@ -174,7 +183,7 @@ export const BlockchainApiController = {
     return state.api.get<BlockchainApiSwapAllowanceResponse>({
       path: `/v1/convert/allowance`,
       params: {
-        projectId,
+        ...getParams(),
         tokenAddress,
         userAddress
       },
@@ -183,7 +192,7 @@ export const BlockchainApiController = {
   },
 
   async fetchGasPrice(params: BlockchainApiGasPriceRequest) {
-    const { projectId, chainId } = params;
+    const { chainId } = params;
     const isSupported = await BlockchainApiController.isNetworkSupported(chainId);
 
     if (!isSupported) {
@@ -194,14 +203,14 @@ export const BlockchainApiController = {
       path: `/v1/convert/gas-price`,
       headers: getHeaders(),
       params: {
-        projectId,
+        ...getParams(),
         chainId
       }
     });
   },
 
   async fetchSwapQuote(params: BlockchainApiSwapQuoteRequest) {
-    const { projectId, amount, userAddress, from, to, gasPrice } = params;
+    const { amount, userAddress, from, to, gasPrice } = params;
     const [namespace, chain] = userAddress.split(':');
     const networkId: CaipNetworkId = `${namespace}:${chain}`;
     const isSupported = await BlockchainApiController.isNetworkSupported(networkId);
@@ -214,7 +223,7 @@ export const BlockchainApiController = {
       path: `/v1/convert/quotes`,
       headers: getHeaders(),
       params: {
-        projectId,
+        ...getParams(),
         amount,
         userAddress,
         from,
@@ -225,7 +234,7 @@ export const BlockchainApiController = {
   },
 
   async fetchSwapTokens(params: BlockchainApiSwapTokensRequest) {
-    const { projectId, chainId } = params;
+    const { chainId } = params;
     const isSupported = await BlockchainApiController.isNetworkSupported(chainId);
 
     if (!isSupported) {
@@ -236,7 +245,7 @@ export const BlockchainApiController = {
       path: `/v1/convert/tokens`,
       headers: getHeaders(),
       params: {
-        projectId,
+        ...getParams(),
         chainId
       }
     });
@@ -255,6 +264,7 @@ export const BlockchainApiController = {
     return state.api.post<BlockchainApiGenerateSwapCalldataResponse>({
       path: '/v1/convert/build-transaction',
       headers: getHeaders(),
+      params: getParams(),
       body: {
         amount,
         eip155: {
@@ -269,7 +279,7 @@ export const BlockchainApiController = {
   },
 
   async generateApproveCalldata(params: BlockchainApiGenerateApproveCalldataRequest) {
-    const { from, projectId, to, userAddress } = params;
+    const { from, to, userAddress } = params;
     const [namespace, chain] = userAddress.split(':');
     const networkId: CaipNetworkId = `${namespace}:${chain}`;
     const isSupported = await BlockchainApiController.isNetworkSupported(networkId);
@@ -282,7 +292,7 @@ export const BlockchainApiController = {
       path: `/v1/convert/build-approve`,
       headers: getHeaders(),
       params: {
-        projectId,
+        ...getParams(),
         userAddress,
         from,
         to
@@ -309,8 +319,8 @@ export const BlockchainApiController = {
       path: `/v1/account/${plainAddress}/balance`,
       headers: getHeaders(),
       params: {
+        ...getParams(),
         currency: 'usd',
-        projectId: OptionsController.state.projectId,
         chainId: `${namespace}:${chain}`,
         forceUpdate: forceUpdate?.join(',')
       }
@@ -322,7 +332,7 @@ export const BlockchainApiController = {
       path: `/v1/profile/account/${name}`,
       headers: getHeaders(),
       params: {
-        projectId: OptionsController.state.projectId,
+        ...getParams(),
         apiVersion: '2'
       }
     });
@@ -332,9 +342,7 @@ export const BlockchainApiController = {
     return await state.api.get<OnRampServiceProvider[]>({
       path: '/v1/onramp/providers',
       headers: getHeaders(),
-      params: {
-        projectId: OptionsController.state.projectId
-      }
+      params: getParams()
     });
   },
 
@@ -367,7 +375,7 @@ export const BlockchainApiController = {
       path: '/v1/onramp/providers/properties',
       headers: getHeaders(),
       params: {
-        projectId: OptionsController.state.projectId,
+        ...getParams(),
         type,
         excludeProviders: EXCLUDED_ONRAMP_PROVIDERS.join(','),
         ...params
@@ -379,6 +387,7 @@ export const BlockchainApiController = {
     return await state.api.post<OnRampQuote[]>({
       path: '/v1/onramp/multi/quotes',
       headers: getHeaders(),
+      params: getParams(),
       body: {
         projectId: OptionsController.state.projectId,
         ...body
@@ -391,6 +400,7 @@ export const BlockchainApiController = {
     return await state.api.post<BlockchainApiOnRampWidgetResponse>({
       path: '/v1/onramp/widget',
       headers: getHeaders(),
+      params: getParams(),
       body: {
         projectId: OptionsController.state.projectId,
         sessionData: {

package/src/controllers/ConnectionsController.ts

@@ -19,6 +19,7 @@ import {
 import { StorageUtil } from '../utils/StorageUtil';
 import { BlockchainApiController } from './BlockchainApiController';
 import { SnackController } from './SnackController';
+import { LogController } from './LogController';
 import { CoreHelperUtil } from '../utils/CoreHelperUtil';
 
 // -- Types --------------------------------------------- //
@@ -531,6 +532,10 @@ export const ConnectionsController = {
         });
       });
     } catch (error) {
+      LogController.sendError(error, 'ConnectionsController.ts', 'fetchBalance', {
+        address,
+        namespace
+      });
       SnackController.showError('Failed to get account balance');
     }
   },

package/src/controllers/EnsController.ts

@@ -2,6 +2,7 @@ import { subscribeKey as subKey } from 'valtio/utils';
 import { proxy, subscribe as sub } from 'valtio';
 import { BlockchainApiController } from './BlockchainApiController';
 import type { BlockchainApiEnsError } from '@reown/appkit-common-react-native';
+import { LogController } from './LogController';
 
 // -- Types --------------------------------------------- //
 
@@ -32,6 +33,7 @@ export const EnsController = {
     try {
       return await BlockchainApiController.lookupEnsName(name);
     } catch (e) {
+      LogController.sendError(e, 'EnsController.ts', 'resolveName');
       const error = e as BlockchainApiEnsError;
       throw new Error(error?.reasons?.[0]?.description || 'Error resolving name');
     }

package/src/controllers/EventsController.ts

@@ -50,6 +50,7 @@ export const EventsController = {
       await api.post({
         path: '/e',
         headers: ApiController._getApiHeaders(),
+        params: ApiController._getApiParams(),
         body: {
           eventId: CoreHelperUtil.getUUID(),
           bundleId: CoreHelperUtil.getBundleId(),

package/src/controllers/LogController.ts

@@ -0,0 +1,253 @@
+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,
+
+  /**
+   * Initialize the LogController
+   */
+  initialize() {
+    // Initialize the LogController
+  },
+
+  /**
+   * 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 {
+      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;
+  }
+};