@reown/appkit-common-react-native 0.0.0-feat-onramp-20250718200617 → 0.0.0-feat-coinbase-20250722174423

package/src/utils/PresetsUtil.ts

@@ -1,4 +1,3 @@
-import type { ConnectorType } from './TypeUtil';
 import { ConstantsUtil } from './ConstantsUtil';
 
 export const PresetsUtil = {
@@ -7,11 +6,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 +21,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 +58,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: {
@@ -59,12 +91,6 @@ export const PresetsUtil = {
     [ConstantsUtil.WALLET_CONNECT_CONNECTOR_ID]: 'ef1a1fcf-7fe8-4d69-bd6d-fda1345b4400'
   } as Record<string, string>,
 
-  ConnectorTypesMap: {
-    [ConstantsUtil.WALLET_CONNECT_CONNECTOR_ID]: 'WALLET_CONNECT',
-    [ConstantsUtil.COINBASE_CONNECTOR_ID]: 'COINBASE',
-    [ConstantsUtil.AUTH_CONNECTOR_ID]: 'AUTH'
-  } as Record<string, ConnectorType>,
-
   RpcChainIds: [
     // Ethereum
     1,

package/src/utils/TypeUtil.ts

@@ -1,19 +1,68 @@
-export interface Balance {
+import { EventEmitter } from 'events';
+
+export type CaipAddress = `${string}:${string}:${string}`;
+
+export type CaipNetworkId = `${string}:${string}`;
+
+export type ChainNamespace = 'eip155' | 'solana' | 'polkadot' | 'bip122';
+
+export type AdapterType = 'solana' | 'wagmi' | 'ethers' | 'universal' | 'bip122';
+
+export type Network = {
+  // Core viem/chain properties
+  id: number | string;
   name: string;
-  symbol: string;
-  chainId: string;
-  address?: string;
-  value?: number;
-  price: number;
-  quantity: BalanceQuantity;
-  iconUrl: string;
-}
+  nativeCurrency: { name: string; symbol: string; decimals: number };
+  rpcUrls: {
+    default: { http: readonly string[] };
+    [key: string]: { http: readonly string[] } | undefined;
+  };
+  blockExplorers?: {
+    default: { name: string; url: string };
+    [key: string]: { name: string; url: string } | undefined;
+  };
 
-type BalanceQuantity = {
-  decimals: string;
-  numeric: string;
+  // AppKit specific / CAIP properties (Optional in type, but needed in practice)
+  chainNamespace?: ChainNamespace; // e.g., 'eip155'
+  caipNetworkId?: CaipNetworkId; // e.g., 'eip155:1'
+  testnet?: boolean;
+  deprecatedCaipNetworkId?: CaipNetworkId; // for Solana deprecated id
 };
 
+export type AppKitNetwork = Network & {
+  chainNamespace: ChainNamespace; // e.g., 'eip155'
+  caipNetworkId: CaipNetworkId; // e.g., 'eip155:1'
+  testnet?: boolean;
+  deprecatedCaipNetworkId?: CaipNetworkId; // for Solana deprecated id
+};
+
+export type AppKitConnectOptions = Pick<
+  ConnectOptions,
+  'namespaces' | 'defaultChain' | 'universalLink'
+>;
+
+export interface CaipNetwork {
+  id: CaipNetworkId;
+  name?: string;
+  imageId?: string;
+  imageUrl?: string;
+}
+
+export interface Balance {
+  name?: string;
+  amount: string;
+  symbol: string;
+  quantity?: {
+    decimals: string;
+    numeric: string;
+  };
+  chainId?: string;
+  address?: CaipAddress; // contract address
+  value?: number; //total value of the amount in currency
+  price?: number; //price of the token in currency
+  iconUrl?: string;
+}
+
 export type TransactionStatus = 'confirmed' | 'failed' | 'pending';
 export type TransactionDirection = 'in' | 'out' | 'self';
 export type TransactionImage = {
@@ -86,7 +135,15 @@ export interface TransactionQuantity {
   numeric: string;
 }
 
-export type SocialProvider = 'apple' | 'x' | 'discord' | 'farcaster';
+export type SocialProvider =
+  | 'google'
+  | 'facebook'
+  | 'github'
+  | 'apple'
+  | 'x'
+  | 'discord'
+  | 'email'
+  | 'farcaster';
 
 export type ThemeMode = 'dark' | 'light';
 
@@ -94,4 +151,312 @@ export interface ThemeVariables {
   accent?: string;
 }
 
-export type ConnectorType = 'WALLET_CONNECT' | 'COINBASE' | 'AUTH' | 'EXTERNAL';
+export interface Token {
+  address: string;
+  image?: string;
+}
+
+export type Tokens = Record<CaipNetworkId, Token>;
+
+export type Metadata = {
+  name: string;
+  description: string;
+  url: string;
+  icons: string[];
+  redirect?: {
+    native?: string;
+    universal?: string;
+    linkMode?: boolean;
+  };
+};
+
+export type BlockchainAdapterConfig = {
+  projectId: string;
+  supportedNamespace: ChainNamespace;
+  adapterType: AdapterType;
+};
+
+//********** Adapter Event Payloads **********//
+export type AccountsChangedEvent = {
+  accounts: string[];
+};
+
+export type ChainChangedEvent = {
+  chainId: string;
+};
+
+export type DisconnectEvent = {};
+
+export type BalanceChangedEvent = {
+  address: CaipAddress;
+  balance: Balance;
+};
+
+//********** Adapter Event Map **********//
+export interface AdapterEvents {
+  accountsChanged: (event: AccountsChangedEvent) => void;
+  chainChanged: (event: ChainChangedEvent) => void;
+  disconnect: (event: DisconnectEvent) => void;
+  balanceChanged: (event: BalanceChangedEvent) => void;
+}
+
+export interface GetBalanceParams {
+  network: AppKitNetwork;
+  address?: CaipAddress;
+  tokens?: Tokens;
+}
+
+export type GetBalanceResponse = Balance;
+
+//********** Connector Types **********//
+interface BaseNamespace {
+  chains?: CaipNetworkId[];
+  accounts: CaipAddress[];
+  methods: string[];
+  events: string[];
+}
+
+type Namespace = BaseNamespace;
+
+export type Namespaces = Record<string, Namespace>;
+
+export type ProposalNamespaces = Record<
+  string,
+  Omit<Namespace, 'accounts'> &
+    Required<Pick<Namespace, 'chains'>> & { rpcMap: Record<string, string> }
+>;
+
+export type ConnectOptions = {
+  namespaces?: ProposalNamespaces;
+  defaultChain?: CaipNetworkId;
+  universalLink?: string;
+  siweConfig?: AppKitSIWEClient;
+};
+
+export type ConnectorInitOptions = {
+  storage: Storage;
+  metadata: Metadata;
+};
+
+export abstract class WalletConnector extends EventEmitter {
+  public type: ConnectorType;
+  protected provider?: Provider;
+  protected namespaces?: Namespaces;
+  protected wallet?: WalletInfo;
+  protected storage?: Storage;
+  protected metadata?: Metadata;
+  protected properties?: ConnectionProperties;
+
+  constructor({ type }: { type: ConnectorType }) {
+    super();
+    this.type = type;
+  }
+
+  public async init(ops: ConnectorInitOptions) {
+    this.storage = ops.storage;
+    this.metadata = ops.metadata;
+  }
+
+  public setProvider(provider: Provider) {
+    this.provider = provider;
+  }
+
+  public async disconnect() {
+    await this.getProvider().disconnect();
+    this.namespaces = undefined;
+    this.wallet = undefined;
+    this.properties = undefined;
+  }
+
+  abstract connect(opts: ConnectOptions): Promise<Namespaces | undefined>;
+  abstract getProvider(): Provider;
+  abstract getNamespaces(): Namespaces;
+  abstract getChainId(namespace: ChainNamespace): CaipNetworkId | undefined;
+  abstract getWalletInfo(): WalletInfo | undefined;
+  abstract getProperties(): ConnectionProperties | undefined;
+  abstract switchNetwork(network: AppKitNetwork): Promise<void>;
+  abstract restoreSession(): Promise<boolean>;
+}
+
+//********** Provider Types **********//
+
+export interface Provider {
+  connect<T>(params?: any): Promise<T>;
+  disconnect(): Promise<void>;
+  request<T = unknown>(
+    args: RequestArguments,
+    chain?: string | undefined,
+    expiry?: number | undefined
+  ): Promise<T>;
+  on(event: string, listener: (args?: any) => void): any;
+  off(event: string, listener: (args?: any) => void): any;
+}
+
+export interface RequestArguments {
+  method: string;
+  params?: unknown[] | Record<string, unknown> | object | undefined;
+}
+
+export type ConnectorType = 'walletconnect' | 'coinbase' | 'auth' | 'phantom';
+
+//********** Others **********//
+
+export interface ConnectionResponse {
+  accounts: string[];
+  chainId: string;
+  [key: string]: any;
+}
+
+export interface WalletInfo {
+  name?: string;
+  icon?: string;
+  description?: string;
+  url?: string;
+  icons?: string[];
+  redirect?: {
+    native?: string;
+    universal?: string;
+    linkMode?: boolean;
+  };
+  [key: string]: unknown;
+}
+
+export interface ConnectionProperties {
+  email?: string;
+  username?: string;
+  smartAccounts?: CaipAddress[];
+  provider?: SocialProvider;
+  sessionTopic?: string;
+}
+
+export type AccountType = 'eoa' | 'smartAccount';
+
+export interface Storage {
+  /**
+   * Returns all keys in storage.
+   */
+  getKeys(): Promise<string[]>;
+
+  /**
+   * Returns all key-value entries in storage.
+   */
+  getEntries<T = any>(): Promise<[string, T][]>;
+
+  /**
+   * Get an item from storage for a given key.
+   * @param key The key to retrieve.
+   */
+  getItem<T = any>(key: string): Promise<T | undefined>;
+
+  /**
+   * Set an item in storage for a given key.
+   * @param key The key to set.
+   * @param value The value to set.
+   */
+  setItem<T = any>(key: string, value: T): Promise<void>;
+
+  /**
+   * Remove an item from storage for a given key.
+   * @param key The key to remove.
+   */
+  removeItem(key: string): Promise<void>;
+}
+
+//********** SIWE Types **********//
+export interface SIWESession {
+  address: string;
+  chainId: number;
+}
+
+interface CacaoHeader {
+  t: 'caip122';
+}
+
+export interface SIWECreateMessageArgs {
+  domain: string;
+  nonce: string;
+  uri: string;
+  address: CaipAddress;
+  version: '1';
+  type?: CacaoHeader['t'];
+  nbf?: string;
+  exp?: string;
+  statement?: string;
+  requestId?: string;
+  resources?: string[];
+  expiry?: number;
+  iat?: string;
+}
+export type SIWEMessageArgs = {
+  chains: CaipNetworkId[];
+  methods?: string[];
+} & Omit<SIWECreateMessageArgs, 'address' | 'nonce' | 'version'>;
+// Signed Cacao (CAIP-74)
+interface CacaoPayload {
+  domain: string;
+  aud: string;
+  nonce: string;
+  iss: string;
+  version?: string;
+  iat?: string;
+  nbf?: string;
+  exp?: string;
+  statement?: string;
+  requestId?: string;
+  resources?: string[];
+  type?: string;
+}
+
+interface Cacao {
+  h: CacaoHeader;
+  p: CacaoPayload;
+  s: {
+    t: 'eip191' | 'eip1271';
+    s: string;
+    m?: string;
+  };
+}
+
+export interface SIWEVerifyMessageArgs {
+  message: string;
+  signature: string;
+  cacao?: Cacao;
+}
+
+export interface SIWEClientMethods {
+  getNonce: (address?: string) => Promise<string>;
+  createMessage: (args: SIWECreateMessageArgs) => string;
+  verifyMessage: (args: SIWEVerifyMessageArgs) => Promise<boolean>;
+  getSession: () => Promise<SIWESession | null>;
+  signOut: () => Promise<boolean>;
+  getMessageParams?: () => Promise<SIWEMessageArgs>;
+  onSignIn?: (session?: SIWESession) => void;
+  onSignOut?: () => void;
+}
+
+export interface SIWEConfig extends SIWEClientMethods {
+  // Defaults to true
+  enabled?: boolean;
+  // In milliseconds, defaults to 5 minutes
+  nonceRefetchIntervalMs?: number;
+  // In milliseconds, defaults to 5 minutes
+  sessionRefetchIntervalMs?: number;
+  // Defaults to true
+  signOutOnDisconnect?: boolean;
+  // Defaults to true
+  signOutOnAccountChange?: boolean;
+  // Defaults to true
+  signOutOnNetworkChange?: boolean;
+}
+
+export interface AppKitSIWEClient extends SIWEClientMethods {
+  signIn: () => Promise<SIWESession | undefined>;
+  options: {
+    enabled: boolean;
+    nonceRefetchIntervalMs: number;
+    sessionRefetchIntervalMs: number;
+    signOutOnDisconnect: boolean;
+    signOutOnAccountChange: boolean;
+    signOutOnNetworkChange: boolean;
+  };
+}