@reown/appkit-common-react-native 1.2.4 → 2.0.0

package/src/adapters/BlockchainAdapter.ts

@@ -0,0 +1,109 @@
+import { EventEmitter } from 'events';
+import type {
+  AdapterEvents,
+  AppKitNetwork,
+  CaipAddress,
+  ChainNamespace,
+  GetBalanceParams,
+  GetBalanceResponse,
+  Provider,
+  WalletConnector
+} from '../utils/TypeUtil';
+
+export abstract class BlockchainAdapter extends EventEmitter {
+  public projectId: string;
+  public connector?: WalletConnector;
+  public supportedNamespace: ChainNamespace;
+
+  // Typed emit method
+  override emit<K extends keyof AdapterEvents>(
+    event: K,
+    payload: Parameters<AdapterEvents[K]>[0]
+  ): boolean {
+    return super.emit(event, payload);
+  }
+
+  constructor({
+    projectId,
+    supportedNamespace
+  }: {
+    projectId: string;
+    supportedNamespace: ChainNamespace;
+  }) {
+    super();
+    this.projectId = projectId;
+    this.supportedNamespace = supportedNamespace;
+  }
+
+  setConnector(connector: WalletConnector) {
+    this.connector = connector;
+    this.subscribeToEvents();
+  }
+
+  removeConnector() {
+    this.connector = undefined;
+  }
+
+  getProvider(): Provider {
+    if (!this.connector) throw new Error('No active connector');
+
+    return this.connector.getProvider();
+  }
+
+  subscribeToEvents(): void {
+    const provider = this.connector?.getProvider();
+    if (!provider) return;
+
+    provider.on('chainChanged', this.onChainChanged.bind(this));
+    provider.on('accountsChanged', this.onAccountsChanged.bind(this));
+    provider.on('disconnect', this.onDisconnect.bind(this));
+  }
+
+  onChainChanged(chainId: string): void {
+    const _chains = this.getAccounts()?.map(account => account.split(':')[1]);
+    const shouldEmit = _chains?.some(chain => chain === chainId);
+
+    if (shouldEmit) {
+      this.emit('chainChanged', { chainId });
+    }
+  }
+
+  onAccountsChanged(accounts: string[]): void {
+    const _accounts = this.getAccounts();
+    const shouldEmit = _accounts?.some(account => {
+      const accountAddress = account.split(':')[2];
+
+      return accountAddress !== undefined && accounts.includes(accountAddress);
+    });
+
+    if (shouldEmit) {
+      this.emit('accountsChanged', { accounts });
+    }
+  }
+
+  onDisconnect(): void {
+    this.emit('disconnect', { namespace: this.getSupportedNamespace() });
+
+    const provider = this.connector?.getProvider();
+    if (provider) {
+      provider.off('chainChanged', this.onChainChanged.bind(this));
+      provider.off('accountsChanged', this.onAccountsChanged.bind(this));
+      provider.off('disconnect', this.onDisconnect.bind(this));
+    }
+
+    this.connector = undefined;
+  }
+
+  parseUnits(value: string, decimals: number): bigint {
+    const [whole, fraction = ''] = value.split('.');
+    const paddedFraction = (fraction + '0'.repeat(decimals)).slice(0, decimals);
+
+    return BigInt(whole + paddedFraction);
+  }
+
+  abstract disconnect(): Promise<void>;
+  abstract getSupportedNamespace(): ChainNamespace;
+  abstract getBalance(params: GetBalanceParams): Promise<GetBalanceResponse>;
+  abstract getAccounts(): CaipAddress[] | undefined;
+  abstract switchNetwork(network: AppKitNetwork): Promise<void>;
+}

package/src/adapters/EvmAdapter.ts

@@ -0,0 +1,79 @@
+import { BlockchainAdapter } from './BlockchainAdapter';
+import { NumberUtil } from '../utils/NumberUtil';
+
+export abstract class EVMAdapter extends BlockchainAdapter {
+  async estimateGas({ address, to, data, chainNamespace }: any): Promise<bigint> {
+    const provider = this.getProvider();
+
+    if (!provider) {
+      throw new Error('EVMAdapter:estimateGas - provider is undefined');
+    }
+
+    if (!address) {
+      throw new Error('EVMAdapter:estimateGas - from address is undefined');
+    }
+
+    if (chainNamespace && chainNamespace !== 'eip155') {
+      throw new Error('EVMAdapter:estimateGas - chainNamespace is not eip155');
+    }
+
+    try {
+      const txParams = {
+        from: address,
+        to,
+        data,
+        type: '0x0' // optional, legacy type
+      };
+
+      const estimatedGasHex = await provider.request({
+        method: 'eth_estimateGas',
+        params: [txParams]
+      });
+
+      return BigInt(estimatedGasHex as string);
+    } catch (error) {
+      throw new Error('EVMAdapter:estimateGas - eth_estimateGas RPC failed');
+    }
+  }
+
+  async sendTransaction(data: any) {
+    const { address } = data || {};
+
+    if (!this.getProvider()) {
+      throw new Error('EVMAdapter:sendTransaction - provider is undefined');
+    }
+
+    if (!address) {
+      throw new Error('EVMAdapter:sendTransaction - address is undefined');
+    }
+
+    const txParams = {
+      from: address,
+      to: data.to,
+      value: NumberUtil.convertNumericToHexString(data.value),
+      gas: NumberUtil.convertNumericToHexString(data.gas),
+      gasPrice: NumberUtil.convertNumericToHexString(data.gasPrice),
+      data: data.data, // hex-encoded bytecode
+      type: '0x0' // optional: legacy transaction type
+    };
+
+    const txHash = await this.getProvider().request({
+      method: 'eth_sendTransaction',
+      params: [txParams]
+    });
+
+    let receipt = null;
+    while (!receipt) {
+      receipt = (await this.getProvider().request({
+        method: 'eth_getTransactionReceipt',
+        params: [txHash]
+      })) as { blockHash?: `0x${string}` };
+
+      if (!receipt) {
+        await new Promise(r => setTimeout(r, 1000)); // wait 1s
+      }
+    }
+
+    return receipt?.blockHash || null;
+  }
+}

package/src/adapters/SolanaBaseAdapter.ts

@@ -0,0 +1,5 @@
+import { BlockchainAdapter } from './BlockchainAdapter';
+
+export abstract class SolanaBaseAdapter extends BlockchainAdapter {
+  // solana logic
+}

package/src/index.ts

@@ -8,4 +8,9 @@ export { PresetsUtil } from './utils/PresetsUtil';
 export { StringUtil } from './utils/StringUtil';
 export { ErrorUtil } from './utils/ErrorUtil';
 export { erc20ABI } from './contracts/erc20';
+export { solana, solanaDevnet, solanaTestnet } from './networks/solana';
+export { bitcoin, bitcoinTestnet } from './networks/bitcoin';
+export { BlockchainAdapter } from './adapters/BlockchainAdapter';
+export { EVMAdapter } from './adapters/EvmAdapter';
+export { SolanaBaseAdapter } from './adapters/SolanaBaseAdapter';
 export * from './utils/TypeUtil';

package/src/networks/bitcoin.ts

@@ -0,0 +1,32 @@
+import type { AppKitNetwork } from '../utils/TypeUtil';
+
+export const bitcoin: AppKitNetwork = {
+  id: '000000000019d6689c085ae165831e93',
+  caipNetworkId: 'bip122:000000000019d6689c085ae165831e93',
+  chainNamespace: 'bip122',
+  name: 'Bitcoin',
+  nativeCurrency: {
+    name: 'Bitcoin',
+    symbol: 'BTC',
+    decimals: 8
+  },
+  rpcUrls: {
+    default: { http: ['https://rpc.walletconnect.org/v1'] }
+  }
+};
+
+export const bitcoinTestnet: AppKitNetwork = {
+  id: '000000000933ea01ad0ee984209779ba',
+  caipNetworkId: 'bip122:000000000933ea01ad0ee984209779ba',
+  chainNamespace: 'bip122',
+  name: 'Bitcoin Testnet',
+  nativeCurrency: {
+    name: 'Bitcoin',
+    symbol: 'BTC',
+    decimals: 8
+  },
+  rpcUrls: {
+    default: { http: ['https://rpc.walletconnect.org/v1'] }
+  },
+  testnet: true
+};

package/src/networks/solana.ts

@@ -0,0 +1,44 @@
+import type { AppKitNetwork } from '../utils/TypeUtil';
+
+export const solana: AppKitNetwork = {
+  id: '5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp',
+  name: 'Solana',
+  nativeCurrency: { name: 'Solana', symbol: 'SOL', decimals: 9 },
+  rpcUrls: {
+    default: {
+      http: ['https://rpc.walletconnect.org/v1']
+    }
+  },
+  blockExplorers: { default: { name: 'Solscan', url: 'https://solscan.io' } },
+  chainNamespace: 'solana',
+  caipNetworkId: 'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp',
+  deprecatedCaipNetworkId: 'solana:4sGjMW1sUnHzSxGspuhpqLDx6wiyjNtZ',
+  testnet: false
+};
+
+export const solanaDevnet: AppKitNetwork = {
+  id: 'EtWTRABZaYq6iMfeYKouRu166VU2xqa1',
+  name: 'Solana Devnet',
+  nativeCurrency: { name: 'Solana', symbol: 'SOL', decimals: 9 },
+  rpcUrls: {
+    default: { http: ['https://rpc.walletconnect.org/v1'] }
+  },
+  blockExplorers: { default: { name: 'Solscan', url: 'https://solscan.io' } },
+  chainNamespace: 'solana',
+  caipNetworkId: 'solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1',
+  deprecatedCaipNetworkId: 'solana:8E9rvCKLFQia2Y35HXjjpWzj8weVo44K',
+  testnet: true
+};
+
+export const solanaTestnet: AppKitNetwork = {
+  id: '4uhcVJyU9pJkvQyS88uRDiswHXSCkY3z',
+  name: 'Solana Testnet',
+  nativeCurrency: { name: 'Solana', symbol: 'SOL', decimals: 9 },
+  rpcUrls: {
+    default: { http: ['https://rpc.walletconnect.org/v1'] }
+  },
+  blockExplorers: { default: { name: 'Solscan', url: 'https://solscan.io' } },
+  chainNamespace: 'solana',
+  caipNetworkId: 'solana:4uhcVJyU9pJkvQyS88uRDiswHXSCkY3z',
+  testnet: true
+};

package/src/utils/ConstantsUtil.ts

@@ -1,5 +1,5 @@
 export const ConstantsUtil = {
-  VERSION: '1.2.4',
+  VERSION: '2.0.0',
 
   EIP155: 'eip155',
   ADD_CHAIN_METHOD: 'wallet_addEthereumChain',
@@ -8,6 +8,7 @@ export const ConstantsUtil = {
   WC_NAME_SUFFIX_LEGACY: '.wcn.id',
 
   BLOCKCHAIN_API_RPC_URL: 'https://rpc.walletconnect.org',
+  BLOCKCHAIN_API_RPC_URL_STAGING: 'https://staging.rpc.walletconnect.org',
   PULSE_API_URL: 'https://pulse.walletconnect.org',
   API_URL: 'https://api.web3modal.org',
 

package/src/utils/DateUtil.ts

@@ -43,5 +43,9 @@ export const DateUtil = {
 
   getMonth(month: number) {
     return dayjs().month(month).format('MMMM');
+  },
+
+  isMoreThanOneWeekAgo(date: string | number) {
+    return dayjs(date).isBefore(dayjs().subtract(1, 'week'));
   }
 };

package/src/utils/NumberUtil.ts

@@ -1,6 +1,12 @@
 import * as BigNumber from 'bignumber.js';
 
 export const NumberUtil = {
+  /**
+   * Creates a BigNumber instance from a given value.
+   * If the value is a string, commas are removed before conversion.
+   * @param value - The input value (string, number, or BigNumber) to convert to a BigNumber.
+   * @returns A BigNumber instance.
+   */
   bigNumber(value: BigNumber.BigNumber.Value) {
     if (typeof value === 'string') {
       return new BigNumber.BigNumber(value.replace(/,/g, ''));
@@ -10,10 +16,11 @@ export const NumberUtil = {
   },
 
   /**
-   * Multiply two numbers represented as strings with BigNumber to handle decimals correctly
-   * @param a string
-   * @param b string
-   * @returns
+   * Multiplies two numbers using BigNumber for precision, especially with decimals.
+   * Handles undefined inputs by returning BigNumber(0).
+   * @param a - The first multiplicand (string, number, or BigNumber). Commas are removed if it's a string.
+   * @param b - The second multiplicand (string, number, or BigNumber). Commas are removed if it's a string.
+   * @returns The product as a BigNumber instance, or BigNumber(0) if either input is undefined.
    */
   multiply(a: BigNumber.BigNumber.Value | undefined, b: BigNumber.BigNumber.Value | undefined) {
     if (a === undefined || b === undefined) {
@@ -26,6 +33,13 @@ export const NumberUtil = {
     return aBigNumber.multipliedBy(bBigNumber);
   },
 
+  /**
+   * Rounds a number to a specified number of decimal places if its string representation meets a certain length threshold.
+   * @param number - The number to potentially round.
+   * @param threshold - The minimum string length of the number to trigger rounding.
+   * @param fixed - The number of decimal places to round to.
+   * @returns The rounded number (as a string if rounded, otherwise the original number) or the original number.
+   */
   roundNumber(number: number, threshold: number, fixed: number) {
     const roundedNumber =
       number.toString().length >= threshold ? Number(number).toFixed(fixed) : number;
@@ -34,10 +48,22 @@ export const NumberUtil = {
   },
 
   /**
-   * Format the given number or string to human readable numbers with the given number of decimals
-   * @param value - The value to format. It could be a number or string. If it's a string, it will be parsed to a float then formatted.
-   * @param decimals - number of decimals after dot
-   * @returns
+   * Calculates the next multiple of ten greater than or equal to the given amount.
+   * Defaults to 10 if no amount is provided or if the calculated multiple is less than 10.
+   * @param amount - The number for which to find the next multiple of ten. Optional.
+   * @returns The next multiple of ten, at least 10.
+   */
+  nextMultipleOfTen(amount?: number) {
+    if (!amount) return 10;
+
+    return Math.max(Math.ceil(amount / 10) * 10, 10);
+  },
+
+  /**
+   * Formats a number or string to a human-readable string with a specified number of decimal places, using US locale formatting.
+   * @param value - The value to format (string, number, or undefined). If undefined, returns '0.00'.
+   * @param decimals - The number of decimal places to display. Defaults to 2.
+   * @returns A locale-formatted string representation of the number.
    */
   formatNumberToLocalString(value: string | number | undefined, decimals = 2) {
     if (value === undefined) {
@@ -56,10 +82,11 @@ export const NumberUtil = {
       minimumFractionDigits: decimals
     });
   },
+
   /**
-   * Parse a formatted local string back to a number
-   * @param value - The formatted string to parse
-   * @returns
+   * Parses a locale-formatted numeric string (e.g., with commas) back into a number.
+   * @param value - The formatted string to parse. If undefined, returns 0.
+   * @returns The parsed number, or 0 if the input is undefined.
    */
   parseLocalStringToNumber(value: string | undefined) {
     if (value === undefined) {
@@ -68,5 +95,27 @@ export const NumberUtil = {
 
     // Remove any commas used as thousand separators and parse the float
     return parseFloat(value.replace(/,/gu, ''));
+  },
+
+  /**
+   * Converts a numeric value (BigInt, number, or string representation of a number) to a 0x-prefixed hexadecimal string.
+   * This is often required for Ethereum RPC parameters like value, gas, gasPrice.
+   * @param value - The value to convert. Can be BigInt, number, or a string (decimal or hex).
+   * @returns A 0x-prefixed hexadecimal string, or undefined if the input is undefined or null.
+   * @throws Error if the value cannot be converted to BigInt.
+   */
+  convertNumericToHexString: (value: any): string | undefined => {
+    if (value === undefined || value === null) {
+      return undefined;
+    }
+    try {
+      // This handles BigInt, number, or string representation of a number (decimal or hex)
+      const bigIntValue = BigInt(value);
+      // Ethereum RPC spec requires "0x0" for zero, and other values to be 0x-prefixed hex.
+
+      return '0x' + bigIntValue.toString(16);
+    } catch (error) {
+      throw new Error(`NumberUtil: Invalid parameter, cannot convert to hex: ${value}`);
+    }
   }
 };

package/src/utils/PresetsUtil.ts

@@ -7,11 +7,11 @@ export const PresetsUtil = {
       'fd20dc426fb37566d803205b19bbc1d4096b248ac04548e3cfb6b3a38bd033aa'
   } as Record<string, string>,
 
-  EIP155NetworkImageIds: {
+  NetworkImageIds: {
     // Ethereum
     1: 'ba0ba0cd-17c6-4806-ad93-f9d174f17900',
     // Arbitrum
-    42161: '600a9a04-c1b9-42ca-6785-9b4b6ff85200',
+    42161: '3bff954d-5cb0-47a0-9a23-d20192e74600',
     // Avalanche
     43114: '30c46e53-e989-45fb-4549-be3bd4eb3b00',
     // Binance Smart Chain
@@ -22,6 +22,20 @@ export const PresetsUtil = {
     10: 'ab9c186a-c52f-464b-2906-ca59d760a400',
     // Polygon
     137: '41d04d42-da3b-4453-8506-668cc0727900',
+    // Mantle
+    5000: 'e86fae9b-b770-4eea-e520-150e12c81100',
+    // Hedera Mainnet
+    295: '6a97d510-cac8-4e58-c7ce-e8681b044c00',
+    // Sepolia
+    11_155_111: 'e909ea0a-f92a-4512-c8fc-748044ea6800',
+    // Base Sepolia
+    84532: 'a18a7ecd-e307-4360-4746-283182228e00',
+    // Unichain Sepolia
+    1301: '4eeea7ef-0014-4649-5d1d-07271a80f600',
+    // Unichain Mainnet
+    130: '2257980a-3463-48c6-cbac-a42d2a956e00',
+    // Monad Testnet
+    10_143: '0a728e83-bacb-46db-7844-948f05434900',
     // Gnosis
     100: '02b53f6a-e3d4-479e-1cb4-21178987d100',
     // EVMos
@@ -45,7 +59,26 @@ export const PresetsUtil = {
     // Base
     8453: '7289c336-3981-4081-c5f4-efc26ac64a00',
     // Aurora
-    1313161554: '3ff73439-a619-4894-9262-4470c773a100'
+    1313161554: '3ff73439-a619-4894-9262-4470c773a100',
+    // Ronin Mainnet
+    2020: 'b8101fc0-9c19-4b6f-ec65-f6dfff106e00',
+    // Saigon Testnet (a.k.a. Ronin)
+    2021: 'b8101fc0-9c19-4b6f-ec65-f6dfff106e00',
+    // Berachain Mainnet
+    80094: 'e329c2c9-59b0-4a02-83e4-212ff3779900',
+    // Abstract Mainnet
+    2741: 'fc2427d1-5af9-4a9c-8da5-6f94627cd900',
+
+    // Solana networks
+    /// Mainnet
+    '5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp': 'a1b58899-f671-4276-6a5e-56ca5bd59700',
+    /// Testnet
+    '4uhcVJyU9pJkvQyS88uRDiswHXSCkY3z': 'a1b58899-f671-4276-6a5e-56ca5bd59700',
+
+    // Bitcoin
+    '000000000019d6689c085ae165831e93': '0b4838db-0161-4ffe-022d-532bf03dba00',
+    // Bitcoin Testnet
+    '000000000933ea01ad0ee984209779ba': '39354064-d79b-420b-065d-f980c4b78200'
   } as Record<string, string>,
 
   ConnectorNamesMap: {

package/src/utils/StringUtil.ts

@@ -4,6 +4,6 @@ export const StringUtil = {
       return '';
     }
 
-    return value.charAt(0).toUpperCase() + value.slice(1);
+    return value.charAt(0).toUpperCase() + value.slice(1).toLowerCase();
   }
 };