@reown/appkit-common-react-native 2.0.0-alpha.0 → 2.0.0-alpha.2

package/src/utils/PresetsUtil.ts

@@ -1,12 +1,4 @@
-import type { ConnectorType } from './TypeUtil';
-import { ConstantsUtil } from './ConstantsUtil';
-
 export const PresetsUtil = {
-  ConnectorExplorerIds: {
-    [ConstantsUtil.COINBASE_CONNECTOR_ID]:
-      'fd20dc426fb37566d803205b19bbc1d4096b248ac04548e3cfb6b3a38bd033aa'
-  } as Record<string, string>,
-
   NetworkImageIds: {
     // Ethereum
     1: 'ba0ba0cd-17c6-4806-ad93-f9d174f17900',
@@ -81,23 +73,6 @@ export const PresetsUtil = {
     '000000000933ea01ad0ee984209779ba': '39354064-d79b-420b-065d-f980c4b78200'
   } as Record<string, string>,
 
-  ConnectorNamesMap: {
-    [ConstantsUtil.WALLET_CONNECT_CONNECTOR_ID]: 'WalletConnect',
-    [ConstantsUtil.COINBASE_CONNECTOR_ID]: 'Coinbase Wallet',
-    [ConstantsUtil.AUTH_CONNECTOR_ID]: 'AppKit Universal Wallet'
-  } as Record<string, string>,
-
-  ConnectorImageIds: {
-    [ConstantsUtil.COINBASE_CONNECTOR_ID]: '0c2840c3-5b04-4c44-9661-fbd4b49e1800',
-    [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/StringUtil.ts

@@ -5,5 +5,12 @@ export const StringUtil = {
     }
 
     return value.charAt(0).toUpperCase() + value.slice(1).toLowerCase();
+  },
+  hexToString(hexValue: string) {
+    // Remove 0x prefix if present
+    const cleanHex = hexValue.startsWith('0x') ? hexValue.slice(2) : hexValue;
+    // Convert hex to decimal number, then to string
+
+    return parseInt(cleanHex, 16).toString();
   }
 };

package/src/utils/TypeUtil.ts

@@ -1,4 +1,5 @@
 import { EventEmitter } from 'events';
+import type { BlockchainAdapter } from '../adapters/BlockchainAdapter';
 
 export type CaipAddress = `${string}:${string}:${string}`;
 
@@ -6,6 +7,8 @@ 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;
@@ -34,6 +37,15 @@ export type AppKitNetwork = Network & {
   deprecatedCaipNetworkId?: CaipNetworkId; // for Solana deprecated id
 };
 
+export interface AppKitOpenOptions {
+  view: 'Account' | 'Connect' | 'Networks' | 'Swap' | 'OnRamp';
+}
+
+export type AppKitConnectOptions = Pick<
+  ConnectOptions,
+  'namespaces' | 'defaultChain' | 'universalLink'
+>;
+
 export interface CaipNetwork {
   id: CaipNetworkId;
   name?: string;
@@ -42,21 +54,20 @@ export interface CaipNetwork {
 }
 
 export interface Balance {
-  name: string;
+  name?: string;
+  amount: string;
   symbol: string;
-  chainId: string;
-  address?: string;
-  value?: number;
-  price: number;
-  quantity: BalanceQuantity;
-  iconUrl: 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;
 }
 
-type BalanceQuantity = {
-  decimals: string;
-  numeric: string;
-};
-
 export type TransactionStatus = 'confirmed' | 'failed' | 'pending';
 export type TransactionDirection = 'in' | 'out' | 'self';
 export type TransactionImage = {
@@ -129,7 +140,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';
 
@@ -144,31 +163,54 @@ export interface Token {
 
 export type Tokens = Record<CaipNetworkId, Token>;
 
-export type ConnectorType = 'WALLET_CONNECT' | 'COINBASE' | 'AUTH' | 'EXTERNAL';
+export type Metadata = {
+  name: string;
+  description: string;
+  url: string;
+  icons: string[];
+  redirect?: {
+    native?: string;
+    universal?: string;
+    linkMode?: boolean;
+  };
+};
+
+export interface Identity {
+  name: string;
+  avatar?: string;
+}
+
+export interface Connection {
+  accounts: CaipAddress[];
+  balances: Map<CaipAddress, Balance[]>;
+  adapter: BlockchainAdapter;
+  caipNetwork: CaipNetworkId;
+  wallet?: WalletInfo;
+  properties?: ConnectionProperties;
+  type?: AccountType;
+  identities?: Map<CaipAddress, Identity>;
+}
+
+export type BlockchainAdapterConfig = {
+  projectId: string;
+  supportedNamespace: ChainNamespace;
+  adapterType: AdapterType;
+};
 
 //********** Adapter Event Payloads **********//
 export type AccountsChangedEvent = {
   accounts: string[];
-  namespace: ChainNamespace;
 };
 
 export type ChainChangedEvent = {
   chainId: string;
-  namespace: ChainNamespace;
 };
 
-export type DisconnectEvent = {
-  namespace: ChainNamespace;
-};
+export type DisconnectEvent = {};
 
 export type BalanceChangedEvent = {
-  namespace: ChainNamespace;
   address: CaipAddress;
-  balance: {
-    amount: string;
-    symbol: string;
-    contractAddress?: ContractAddress;
-  };
+  balance: Balance;
 };
 
 //********** Adapter Event Map **********//
@@ -179,117 +221,13 @@ export interface AdapterEvents {
   balanceChanged: (event: BalanceChangedEvent) => void;
 }
 
-//********** Adapter Types **********//
-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, namespace: this.getSupportedNamespace() });
-    }
-  }
-
-  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, namespace: this.getSupportedNamespace() });
-    }
-  }
-
-  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;
-  }
-
-  abstract disconnect(): Promise<void>;
-  abstract getSupportedNamespace(): ChainNamespace;
-  abstract getBalance(params: GetBalanceParams): Promise<GetBalanceResponse>;
-  abstract getAccounts(): CaipAddress[] | undefined;
-  abstract switchNetwork(network: AppKitNetwork): Promise<void>;
-}
-
-export abstract class EVMAdapter extends BlockchainAdapter {
-  // ens logic
-}
-
-export abstract class SolanaBaseAdapter extends BlockchainAdapter {}
-
 export interface GetBalanceParams {
+  network: AppKitNetwork;
   address?: CaipAddress;
-  network?: AppKitNetwork;
   tokens?: Tokens;
 }
 
-type ContractAddress = CaipAddress;
-
-export interface GetBalanceResponse {
-  amount: string;
-  symbol: string;
-  contractAddress?: ContractAddress;
-}
+export type GetBalanceResponse = Balance;
 
 //********** Connector Types **********//
 interface BaseNamespace {
@@ -305,33 +243,64 @@ export type Namespaces = Record<string, Namespace>;
 
 export type ProposalNamespaces = Record<
   string,
-  Omit<Namespace, 'accounts'> & Required<Pick<Namespace, 'chains'>>
+  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: New_ConnectorType;
-  protected provider: Provider;
+  public type: ConnectorType;
+  protected provider?: Provider;
   protected namespaces?: Namespaces;
   protected wallet?: WalletInfo;
+  protected storage?: Storage;
+  protected metadata?: Metadata;
+  protected properties?: ConnectionProperties;
 
-  constructor({ type, provider }: { type: New_ConnectorType; provider: Provider }) {
+  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;
   }
 
-  abstract connect(opts: {
-    namespaces?: ProposalNamespaces;
-    defaultChain?: CaipNetworkId;
-  }): Promise<Namespaces | undefined>;
-  abstract disconnect(): Promise<void>;
+  public async disconnect() {
+    await this.provider?.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>;
 }
 
+export type ConnectorType = 'walletconnect' | 'coinbase' | 'auth' | 'phantom';
+
 //********** Provider Types **********//
 
 export interface Provider {
@@ -351,9 +320,6 @@ export interface RequestArguments {
   params?: unknown[] | Record<string, unknown> | object | undefined;
 }
 
-//TODO: rename this and remove the old one ConnectorType
-export type New_ConnectorType = 'walletconnect' | 'coinbase' | 'auth';
-
 //********** Others **********//
 
 export interface ConnectionResponse {
@@ -375,3 +341,153 @@ export interface WalletInfo {
   };
   [key: string]: unknown;
 }
+
+export interface ConnectionProperties {
+  email?: string;
+  username?: string;
+  smartAccounts?: CaipAddress[];
+  provider?: SocialProvider;
+  sessionTopic?: string;
+}
+
+export interface LinkingRecord {
+  redirect: string;
+  href: string;
+}
+
+export interface WalletDeepLink {
+  href: string;
+  name: 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;
+  };
+}