@reown/appkit-core-react-native 0.0.0-develop-20250728141602 → 0.0.0-develop-20251008155354

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

@@ -0,0 +1,80 @@
+import type { SIWXMessage, CaipNetworkId } from '@reown/appkit-common-react-native';
+import { ConnectionsController } from '../../controllers/ConnectionsController';
+import { OptionsController } from '../../controllers/OptionsController';
+import { CoreHelperUtil } from '../../utils/CoreHelperUtil';
+
+export class ReownAuthenticationMessenger {
+  public resources?: SIWXMessage['resources'];
+
+  protected getNonce: (params: SIWXMessage.Input) => Promise<SIWXMessage['nonce']>;
+
+  constructor(params: ReownAuthenticationMessenger.ConstructorParams) {
+    this.getNonce = params.getNonce;
+  }
+
+  async createMessage(input: SIWXMessage.Input): Promise<SIWXMessage> {
+    const metadata = OptionsController.state.metadata;
+    const domain = CoreHelperUtil.getBundleId();
+    const params = {
+      accountAddress: input.accountAddress,
+      chainId: input.chainId,
+      version: '1',
+      domain: domain ?? 'Unknown Domain',
+      uri: metadata?.redirect?.universal ?? metadata?.redirect?.native ?? 'Unknown URI',
+      resources: this.resources,
+      nonce: await this.getNonce(input),
+      issuedAt: this.stringifyDate(new Date()),
+      statement: undefined,
+      expirationTime: undefined,
+      notBefore: undefined
+    };
+
+    const methods = {
+      toString: () => this.stringify(params)
+    } satisfies SIWXMessage.Methods;
+
+    return Object.assign(params, methods);
+  }
+
+  private stringify(params: SIWXMessage.Data): string {
+    const networkName = this.getNetworkName(params.chainId);
+
+    return [
+      `${params.domain} wants you to sign in with your ${networkName} account:`,
+      params.accountAddress,
+      params.statement ? `\n${params.statement}\n` : '',
+      `URI: ${params.uri}`,
+      `Version: ${params.version}`,
+      `Chain ID: ${params.chainId}`,
+      `Nonce: ${params.nonce}`,
+      params.issuedAt && `Issued At: ${params.issuedAt}`,
+      params.expirationTime && `Expiration Time: ${params.expirationTime}`,
+      params.notBefore && `Not Before: ${params.notBefore}`,
+      params.requestId && `Request ID: ${params.requestId}`,
+      params.resources?.length &&
+        params.resources.reduce((acc, resource) => `${acc}\n- ${resource}`, 'Resources:')
+    ]
+      .filter(line => typeof line === 'string')
+      .join('\n')
+      .trim();
+  }
+
+  private getNetworkName(chainId: CaipNetworkId): string | undefined {
+    const requestedNetworks = ConnectionsController.state.networks;
+
+    return (
+      requestedNetworks.find(network => network.caipNetworkId === chainId)?.name ||
+      'Unknown Network'
+    );
+  }
+
+  private stringifyDate(date: Date): string {
+    return date.toISOString();
+  }
+}
+
+export namespace ReownAuthenticationMessenger {
+  export interface ConstructorParams {
+    getNonce: (params: SIWXMessage.Input) => Promise<SIWXMessage['nonce']>;
+  }
+}

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

@@ -0,0 +1,2 @@
+export * from './ReownAuthentication';
+export * from './ReownAuthenticationMessenger';

package/src/index.ts

@@ -7,26 +7,21 @@ export {
 
 export { RouterController, type RouterControllerState } from './controllers/RouterController';
 
-export { AccountController, type AccountControllerState } from './controllers/AccountController';
+export { WcController, type WcControllerState } from './controllers/WcController';
 
 export {
-  NetworkController,
-  type NetworkControllerClient,
-  type NetworkControllerState
-} from './controllers/NetworkController';
+  ConnectionsController,
+  type ConnectionsControllerState
+} from './controllers/ConnectionsController';
 
-export {
-  ConnectionController,
-  type ConnectionControllerClient,
-  type ConnectionControllerState
-} from './controllers/ConnectionController';
+export { SnackController, type SnackControllerState } from './controllers/SnackController';
 
 export {
-  ConnectorController,
-  type ConnectorControllerState
-} from './controllers/ConnectorController';
-
-export { SnackController, type SnackControllerState } from './controllers/SnackController';
+  LogController,
+  type LogControllerState,
+  type LogEntry,
+  type LogLevel
+} from './controllers/LogController';
 
 export { ApiController, type ApiControllerState } from './controllers/ApiController';
 
@@ -57,17 +52,19 @@ export {
 export { SendController, type SendControllerState } from './controllers/SendController';
 
 export { OnRampController, type OnRampControllerState } from './controllers/OnRampController';
-export { WebviewController, type WebviewControllerState } from './controllers/WebviewController';
 
 // -- Utils -------------------------------------------------------------------
 export { ApiUtil } from './utils/ApiUtil';
 export { AssetUtil } from './utils/AssetUtil';
-export { ConnectionUtil } from './utils/ConnectionUtil';
 export { ConstantsUtil } from './utils/ConstantsUtil';
 export { CoreHelperUtil } from './utils/CoreHelperUtil';
 export { StorageUtil } from './utils/StorageUtil';
 export { EventUtil } from './utils/EventUtil';
-export { RouterUtil } from './utils/RouterUtil';
-export { NetworkUtil } from './utils/NetworkUtil';
+export { WalletUtil } from './utils/WalletUtil';
+export { LogUtils } from './utils/LogUtils';
+
+// -- Features ----------------------------------------------------------------
+export { ReownAuthentication } from './features/reown-authentication/ReownAuthentication';
+export { ReownAuthenticationMessenger } from './features/reown-authentication/ReownAuthenticationMessenger';
 
-export type * from './utils/TypeUtil';
+// Types are now exported from @reown/appkit-common-react-native

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/AssetUtil.ts

@@ -1,40 +1,27 @@
-import { AssetController } from '../controllers/AssetController';
-import type { CaipNetwork, Connector, WcWallet } from './TypeUtil';
+import type { AppKitNetwork, WcWallet } from '@reown/appkit-common-react-native';
 
 export const AssetUtil = {
-  getWalletImage(wallet?: WcWallet) {
+  getWalletImage(wallet?: WcWallet, walletImages?: Record<string, string>) {
     if (wallet?.image_url) {
       return wallet?.image_url;
     }
 
     if (wallet?.image_id) {
-      return AssetController.state.walletImages[wallet.image_id];
+      return walletImages?.[wallet.image_id];
     }
 
     return undefined;
   },
 
-  getNetworkImage(network?: CaipNetwork) {
-    if (network?.imageUrl) {
-      return network?.imageUrl;
-    }
-
-    if (network?.imageId) {
-      return AssetController.state.networkImages[network.imageId];
-    }
-
-    return undefined;
-  },
-
-  getConnectorImage(connector?: Connector) {
-    if (connector?.imageUrl) {
-      return connector.imageUrl;
+  getNetworkImage(network?: AppKitNetwork, networkImages?: Record<string, string>) {
+    if (!network) {
+      return undefined;
     }
 
-    if (connector?.imageId) {
-      return AssetController.state.connectorImages[connector.imageId];
+    if (network?.imageUrl) {
+      return network.imageUrl;
     }
 
-    return undefined;
+    return networkImages?.[network?.id];
   }
 };

package/src/utils/ConstantsUtil.ts

@@ -1,11 +1,10 @@
-import type { Features } from './TypeUtil';
+import type { ChainNamespace, Features } from '@reown/appkit-common-react-native';
 
 const defaultFeatures: Features = {
   swaps: true,
   onramp: true,
-  email: true,
-  emailShowWallets: true,
-  socials: ['x', 'discord', 'apple']
+  socials: ['email', 'google', 'x', 'discord', 'apple', 'facebook', 'github', 'farcaster'],
+  showWallets: true
 };
 
 export const OnRampErrorType = {
@@ -35,7 +34,11 @@ export const ConstantsUtil = {
 
   LINKING_ERROR: 'LINKING_ERROR',
 
-  NATIVE_TOKEN_ADDRESS: '0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee',
+  NATIVE_TOKEN_ADDRESS: {
+    eip155: '0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee',
+    solana: 'So11111111111111111111111111111111111111111',
+    bip122: '0x'
+  } as const satisfies Record<ChainNamespace, string>,
 
   ONRAMP_ERROR_TYPES: OnRampErrorType,
 
@@ -129,6 +132,112 @@ export const ConstantsUtil = {
     'WNT'
   ],
 
+  //TODO: replace with supported chains from backend
+  ACTIVITY_SUPPORTED_CHAINS: [
+    // Arbitrum
+    'eip155:42161',
+    // BNB Chain
+    'eip155:56',
+    // Ethereum
+    'eip155:1',
+    // Blast
+    'eip155:81457',
+    // Ape Chain
+    'eip155:99999',
+    // Avalanche
+    'eip155:43114',
+    // Abstract
+    'eip155:900',
+    // opBNB
+    'eip155:204',
+    // Astar zkEVM
+    'eip155:3776',
+    // ZKsync Era
+    'eip155:324',
+    // Berachain
+    'eip155:80085',
+    // BOB
+    'eip155:60808',
+    // Cyber
+    'eip155:7560',
+    // Degen Chain
+    'eip155:666666666',
+    // Fraxtal
+    'eip155:252',
+    // Gravity Alpha
+    'eip155:10003',
+    // Ink
+    'eip155:999',
+    // Lens
+    'eip155:1348',
+    // Lisk
+    'eip155:113',
+    // Mode
+    'eip155:34443',
+    // Base
+    'eip155:8453',
+    // Mantle
+    'eip155:5000',
+    // Optimism
+    'eip155:10',
+    // Polygon
+    'eip155:137',
+    // Celo
+    'eip155:42220',
+    // Manta Pacific
+    'eip155:169',
+    // Gnosis Chain
+    'eip155:100',
+    // Fantom
+    'eip155:250',
+    // Ronin
+    'eip155:2020',
+    // Linea
+    'eip155:59144',
+    // Metis Andromeda
+    'eip155:1088',
+    // Aurora
+    'eip155:1313161554',
+    // XDC
+    'eip155:50',
+    // Cronos zkEVM
+    'eip155:1030',
+    // Polygon zkEVM
+    'eip155:1101',
+    // Polynomial
+    'eip155:80001',
+    // Rari
+    'eip155:1380012617',
+    // Redstone
+    'eip155:690',
+    // Scroll
+    'eip155:534352',
+    // Sei
+    'eip155:1329',
+    // Soneium
+    'eip155:1499',
+    // Sonic
+    'eip155:7007',
+    // Taiko
+    'eip155:167000',
+    // Viction
+    'eip155:88',
+    // Unichain
+    'eip155:12345',
+    // Wonder
+    'eip155:8787',
+    // X Layer
+    'eip155:196',
+    // World Chain
+    'eip155:2008',
+    // ZERϴ
+    'eip155:77777',
+    // ZkLink Nova
+    'eip155:810180',
+    // re.al
+    'eip155:666'
+  ],
+
   SWAP_SUPPORTED_NETWORKS: [
     // Ethereum'
     'eip155:1',
@@ -156,6 +265,10 @@ export const ConstantsUtil = {
     'eip155:1313161554'
   ],
 
+  SEND_SUPPORTED_NAMESPACES: ['eip155', 'solana'],
+
+  ONRAMP_SUPPORTED_NAMESPACES: ['eip155', 'solana', 'bip122'],
+
   CONVERT_SLIPPAGE_TOLERANCE: 1,
 
   DEFAULT_FEATURES: defaultFeatures,
@@ -183,6 +296,8 @@ export const ConstantsUtil = {
     'eip155:7700': 'CANTO', // Canto
     'eip155:59144': 'ETH_LINEA', // Linea
     'eip155:1101': 'ETH_POLYGONZKEVM', // Polygon zkEVM
-    'eip155:196': 'XIN' // Mixin
+    'eip155:196': 'XIN', // Mixin
+    'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp': 'SOL',
+    'bip122:000000000019d6689c085ae165831e93': 'BTC'
   }
 };

package/src/utils/CoreHelperUtil.ts

@@ -1,11 +1,24 @@
 /* eslint-disable no-bitwise */
 
 import { Linking, Platform } from 'react-native';
-import { ConstantsUtil as CommonConstants, type Balance } from '@reown/appkit-common-react-native';
+import {
+  BlockchainAdapter,
+  ConstantsUtil as CommonConstants,
+  type AdapterType,
+  type Balance,
+  type CaipAddress,
+  type CaipNetwork,
+  type ChainNamespace,
+  type SocialProvider,
+  type LinkingRecord,
+  type DataWallet,
+  type SdkVersion
+} from '@reown/appkit-common-react-native';
+
 import * as ct from 'countries-and-timezones';
 
 import { ConstantsUtil } from './ConstantsUtil';
-import type { CaipAddress, CaipNetwork, DataWallet, LinkingRecord } from './TypeUtil';
+import { OptionsController } from '../controllers/OptionsController';
 
 // -- Helpers -----------------------------------------------------------------
 async function isAppInstalledIos(deepLink?: string): Promise<boolean> {
@@ -40,6 +53,20 @@ export const CoreHelperUtil = {
     return Date.now() - lastRetry >= ConstantsUtil.ONE_SEC_MS;
   },
 
+  isCaipAddress(address?: unknown): address is CaipAddress {
+    if (typeof address !== 'string') {
+      return false;
+    }
+
+    const sections = address.split(':');
+    const namespace = sections[0];
+
+    return (
+      sections.filter(Boolean).length === 3 &&
+      (namespace as string) in CommonConstants.CHAIN_NAME_MAP
+    );
+  },
+
   getPairingExpiry() {
     return Date.now() + ConstantsUtil.FOUR_MINUTES_MS;
   },
@@ -48,8 +75,12 @@ export const CoreHelperUtil = {
     return caipAddress?.split(':')[1];
   },
 
-  getPlainAddress(caipAddress: CaipAddress | undefined) {
-    return caipAddress?.split(':')[2];
+  getPlainAddress(address: CaipAddress | string | undefined) {
+    if (this.isCaipAddress(address)) {
+      return address?.split(':')[2];
+    }
+
+    return address;
   },
 
   async wait(milliseconds: number) {
@@ -97,7 +128,7 @@ export const CoreHelperUtil = {
     };
   },
 
-  formatUniversalUrl(appUrl: string, wcUri: string): LinkingRecord {
+  formatUniversalUrl(appUrl: string, wcUri: string, provider?: SocialProvider): LinkingRecord {
     if (CoreHelperUtil.isLinkModeURL(wcUri)) {
       return {
         redirect: wcUri,
@@ -115,7 +146,9 @@ export const CoreHelperUtil = {
     const encodedWcUrl = encodeURIComponent(wcUri);
 
     return {
-      redirect: `${safeAppUrl}wc?uri=${encodedWcUrl}`,
+      redirect: provider
+        ? `${safeAppUrl}wc?uri=${encodedWcUrl}&provider=${provider}`
+        : `${safeAppUrl}wc?uri=${encodedWcUrl}`,
       href: safeAppUrl
     };
   },
@@ -144,8 +177,8 @@ export const CoreHelperUtil = {
     return formattedBalance ? `${formattedBalance} ${symbol}` : `0.000 ${symbol || ''}`;
   },
 
-  isAddress(address: string, chain = 'eip155'): boolean {
-    switch (chain) {
+  isAddress(address: string, namespace: ChainNamespace = 'eip155'): boolean {
+    switch (namespace) {
       case 'eip155':
         if (!/^(?:0x)?[0-9a-f]{40}$/iu.test(address)) {
           return false;
@@ -219,7 +252,7 @@ export const CoreHelperUtil = {
     });
   },
 
-  getBundleId() {
+  getBundleId(): string | undefined {
     if ((global as any)?.Application?.applicationId) {
       return (global as any)?.Application?.applicationId;
     }
@@ -277,7 +310,7 @@ export const CoreHelperUtil = {
 
     let sum = 0;
     for (const item of array) {
-      sum += item.value ?? 0;
+      sum += item?.value ?? 0;
     }
 
     const roundedNumber = sum.toFixed(2);
@@ -317,5 +350,28 @@ export const CoreHelperUtil = {
         func(...args);
       }, wait);
     };
+  },
+
+  generateSdkVersion(adapters: BlockchainAdapter[], version: string): SdkVersion {
+    const hasNoAdapters = adapters.length === 0;
+    const universalType: AdapterType = 'universal';
+
+    const adapterNames = hasNoAdapters
+      ? universalType
+      : adapters
+          .sort((a, b) => a.adapterType.localeCompare(b.adapterType))
+          .map(adapter => adapter.adapterType)
+          .join(',');
+
+    return `react-native-${adapterNames}-${version}`;
+  },
+
+  getRequestedCaipNetworkIds() {
+    const chains = OptionsController.state.requestedNetworks;
+    if (!chains) return [];
+
+    const requestedIds = chains.map(caipNetwork => caipNetwork.caipNetworkId);
+
+    return requestedIds;
   }
 };

package/src/utils/EventUtil.ts

@@ -1,4 +1,4 @@
-import type { Platform, WcWallet } from './TypeUtil';
+import type { Platform, WcWallet } from '@reown/appkit-common-react-native';
 
 export const EventUtil = {
   getWalletPlatform(wallet: WcWallet, installed?: boolean): Platform | undefined {

package/src/utils/FetchUtil.ts

@@ -1,4 +1,5 @@
-import type { RequestCache } from './TypeUtil';
+import type { RequestCache } from '@reown/appkit-common-react-native';
+import { LogController } from '../controllers/LogController';
 
 // -- Types ----------------------------------------------------------------------
 interface Options {
@@ -8,7 +9,7 @@ interface Options {
 
 interface RequestArguments {
   path: string;
-  headers?: HeadersInit_;
+  headers?: HeadersInit;
   params?: Record<string, string | undefined>;
   cache?: RequestCache;
   signal?: AbortSignal;
@@ -71,9 +72,13 @@ export class FetchUtil {
     return this.processResponse<T>(response);
   }
 
-  public async fetchImage(path: string, headers?: Record<string, string>) {
+  public async fetchImage(
+    path: string,
+    headers?: Record<string, string>,
+    params?: Record<string, string>
+  ) {
     try {
-      const url = this.createUrl({ path }).toString();
+      const url = this.createUrl({ path, params }).toString();
       const response = await fetch(url, { headers });
       const blob = await response.blob();
       const reader = new FileReader();
@@ -87,7 +92,7 @@ export class FetchUtil {
     }
   }
 
-  private createUrl({ path, params }: RequestArguments) {
+  public createUrl({ path, params }: RequestArguments) {
     let fullUrl: string;
 
     const isAbsoluteUrl = path.startsWith('http://') || path.startsWith('https://');
@@ -130,14 +135,18 @@ export class FetchUtil {
       if (response.headers.get('content-type')?.includes('application/json')) {
         try {
           const errorData = await response.json();
+          LogController.sendError(JSON.stringify(errorData), 'FetchUtil.ts', 'processResponse');
 
           return Promise.reject(errorData);
         } catch (jsonError) {
+          LogController.sendError(jsonError, 'FetchUtil.ts', 'processResponse');
+
           return Promise.reject(`Code: ${response.status} - ${response.statusText}`);
         }
       }
 
       const errorText = await response.text();
+      LogController.sendError(errorText, 'FetchUtil.ts', 'processResponse');
 
       return Promise.reject(`Code: ${response.status} - ${response.statusText} - ${errorText}`);
     }