@reown/appkit-common-react-native 0.0.0-develop-20250728153935 → 0.0.0-develop-20251030154825

package/src/types/api/wallet-api.ts

@@ -0,0 +1,71 @@
+import type { CaipNetworkId } from '../common';
+
+export interface WcWallet {
+  id: string;
+  name: string;
+  homepage?: string;
+  image_id?: string;
+  image_url?: string;
+  order?: number;
+  mobile_link?: string | null;
+  desktop_link?: string | null;
+  webapp_link?: string | null;
+  link_mode?: string | null;
+  app_store?: string | null;
+  play_store?: string | null;
+  chains?: readonly CaipNetworkId[];
+  badge_type?: 'certified' | 'none';
+}
+
+export interface DataWallet {
+  id: string;
+  ios_schema?: string;
+  android_app_id?: string;
+}
+
+export interface ApiGetWalletsRequest {
+  page: number;
+  entries: number;
+  search?: string;
+  include?: string[];
+  exclude?: string[];
+}
+
+export interface ApiGetWalletsResponse {
+  data: WcWallet[];
+  count: number;
+}
+
+export interface ApiGetDataWalletsResponse {
+  data: DataWallet[];
+  count: number;
+}
+
+export interface ApiGetAnalyticsConfigResponse {
+  isAnalyticsEnabled: boolean;
+}
+
+export type CustomWallet = Pick<
+  WcWallet,
+  | 'id'
+  | 'name'
+  | 'homepage'
+  | 'image_url'
+  | 'image_id'
+  | 'mobile_link'
+  | 'desktop_link'
+  | 'webapp_link'
+  | 'link_mode'
+  | 'app_store'
+  | 'play_store'
+> & {
+  android_app_id?: string;
+  ios_schema?: string;
+};
+
+export type UniversalProviderConfigOverride = {
+  methods?: Record<string, string[]>;
+  chains?: Record<string, string[]>;
+  events?: Record<string, string[]>;
+  rpcMap?: Record<string, string>;
+};

package/src/types/blockchain/adapter.ts

@@ -0,0 +1,52 @@
+import type { ChainNamespace, CaipAddress, AdapterType } from '../common';
+import type { WalletConnector } from '../wallet';
+import type { BalanceChangedEvent } from './balance';
+
+export interface BlockchainAdapterConfig {
+  supportedNamespace: ChainNamespace;
+  adapterType: AdapterType;
+}
+
+export interface BlockchainAdapterInitParams {
+  connector: WalletConnector;
+}
+
+export interface AdapterEvents {
+  accountsChanged: (event: AccountsChangedEvent) => void;
+  chainChanged: (event: ChainChangedEvent) => void;
+  disconnect: (event: DisconnectEvent) => void;
+  balanceChanged: (event: BalanceChangedEvent) => void;
+}
+
+export type AccountsChangedEvent = {
+  accounts: CaipAddress[];
+};
+
+export type ChainChangedEvent = {
+  chainId: string;
+};
+
+export type DisconnectEvent = undefined;
+
+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 interface ConnectionResponse {
+  accounts: string[];
+  chainId: string;
+  [key: string]: any;
+}

package/src/types/blockchain/balance.ts

@@ -0,0 +1,31 @@
+import type { CaipAddress } from '../common';
+import type { Tokens } from '../wallet';
+import type { AppKitNetwork } from './network';
+
+export interface Balance {
+  name?: string;
+  amount: string;
+  symbol: string;
+  quantity?: {
+    decimals: string;
+    numeric: string;
+  };
+  chainId?: string;
+  address?: CaipAddress | string; // contract address
+  value?: number; //total value of the amount in currency
+  price?: number; //price of the token in currency
+  iconUrl?: string;
+}
+
+export interface GetBalanceParams {
+  network: AppKitNetwork;
+  address?: CaipAddress;
+  tokens?: Tokens;
+}
+
+export type GetBalanceResponse = Balance;
+
+export type BalanceChangedEvent = {
+  address: CaipAddress;
+  balance: Balance;
+};

package/src/types/blockchain/index.ts

@@ -0,0 +1,5 @@
+// Blockchain types barrel export
+export * from './adapter';
+export * from './balance';
+export * from './network';
+export * from './transaction';

package/src/types/blockchain/network.ts

@@ -0,0 +1,39 @@
+import type { ChainNamespace, CaipNetworkId } from '../common';
+
+export type Network = {
+  // Core viem/chain properties
+  id: number | string;
+  name: 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;
+  };
+
+  // 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
+  imageUrl?: string;
+};
+
+export type AppKitNetwork = Network & {
+  chainNamespace: ChainNamespace; // mandatory for AppKitNetwork
+  caipNetworkId: CaipNetworkId; // mandatory for AppKitNetwork
+};
+
+export interface CaipNetwork {
+  id: CaipNetworkId;
+  name?: string;
+  imageId?: string;
+  imageUrl?: string;
+}
+
+export interface AppKitOpenOptions {
+  view: 'Account' | 'Connect' | 'WalletConnect' | 'Networks' | 'Swap' | 'OnRamp';
+}

package/src/{utils/TypeUtil.ts → types/blockchain/transaction.ts}

@@ -1,19 +1,3 @@
-export interface Balance {
-  name: string;
-  symbol: string;
-  chainId: string;
-  address?: string;
-  value?: number;
-  price: number;
-  quantity: BalanceQuantity;
-  iconUrl: string;
-}
-
-type BalanceQuantity = {
-  decimals: string;
-  numeric: string;
-};
-
 export type TransactionStatus = 'confirmed' | 'failed' | 'pending';
 export type TransactionDirection = 'in' | 'out' | 'self';
 export type TransactionImage = {
@@ -85,13 +69,3 @@ export interface TransactionDetail {
 export interface TransactionQuantity {
   numeric: string;
 }
-
-export type SocialProvider = 'apple' | 'x' | 'discord' | 'farcaster';
-
-export type ThemeMode = 'dark' | 'light';
-
-export interface ThemeVariables {
-  accent?: string;
-}
-
-export type ConnectorType = 'WALLET_CONNECT' | 'COINBASE' | 'AUTH' | 'EXTERNAL';

package/src/types/common.ts

@@ -0,0 +1,56 @@
+// Common types used across the AppKit ecosystem
+
+export type CaipAddress = `${string}:${string}:${string}`;
+
+export type CaipNetworkId = `${string}:${string}`;
+
+export type ChainNamespace = 'eip155' | 'solana' | 'bip122';
+
+export type AdapterType = 'solana' | 'wagmi' | 'ethers' | 'universal' | 'bip122';
+
+export type AccountType = 'eoa' | 'smartAccount';
+
+export type SocialProvider =
+  | 'google'
+  | 'facebook'
+  | 'github'
+  | 'apple'
+  | 'x'
+  | 'discord'
+  | 'email'
+  | 'farcaster';
+
+export type ThemeMode = 'dark' | 'light';
+
+export interface ThemeVariables {
+  accent?: string;
+}
+
+export interface BaseError {
+  message?: string;
+}
+
+export type ProjectId = string;
+
+export type Platform = 'mobile' | 'web' | 'qrcode' | 'email' | 'unsupported';
+
+export type SdkType = 'appkit';
+
+export type SdkVersion = `react-native-${string}-${string}`;
+
+export type RequestCache =
+  | 'default'
+  | 'force-cache'
+  | 'no-cache'
+  | 'no-store'
+  | 'only-if-cached'
+  | 'reload';
+
+export type CaipNamespaces = Record<
+  string,
+  {
+    chains: CaipNetworkId[];
+    methods: string[];
+    events: string[];
+  }
+>;

package/src/types/index.ts

@@ -0,0 +1,28 @@
+// Main types barrel export - re-exports all types from all domains
+
+// Common types
+export * from './common';
+
+// Blockchain types
+export * from './blockchain';
+
+// Wallet types
+export * from './wallet';
+
+// API types
+export * from './api';
+
+// Swap types
+export * from './swap';
+
+// OnRamp types
+export * from './onramp';
+
+// SIWX types
+export * from './siwx';
+
+// Storage types
+export * from './storage';
+
+// UI types
+export * from './ui';

package/src/types/onramp/countries.ts

@@ -0,0 +1,11 @@
+export type OnRampCountry = {
+  countryCode: string;
+  flagImageUrl: string;
+  name: string;
+};
+
+export type OnRampCountryDefaults = {
+  countryCode: string;
+  defaultCurrencyCode: string;
+  defaultPaymentMethods: string[];
+};

package/src/types/onramp/currencies.ts

@@ -0,0 +1,32 @@
+export type OnRampFiatCurrency = {
+  currencyCode: string;
+  name: string;
+  symbolImageUrl: string;
+};
+
+export type OnRampCryptoCurrency = {
+  currencyCode: string;
+  name: string;
+  chainCode: string;
+  chainName: string;
+  chainId: string;
+  contractAddress: string | null;
+  symbolImageUrl: string;
+};
+
+export type OnRampFiatLimit = {
+  currencyCode: string;
+  defaultAmount: number | null;
+  minimumAmount: number;
+  maximumAmount: number;
+};
+
+export type OnRampTransactionResult = {
+  purchaseCurrency: string | null;
+  purchaseAmount: string | null;
+  purchaseImageUrl: string | null;
+  paymentCurrency: string | null;
+  paymentAmount: string | null;
+  status: string | null;
+  network: string | null;
+};

package/src/types/onramp/errors.ts

@@ -0,0 +1,22 @@
+export const OnRampErrorType = {
+  AMOUNT_TOO_LOW: 'INVALID_AMOUNT_TOO_LOW',
+  AMOUNT_TOO_HIGH: 'INVALID_AMOUNT_TOO_HIGH',
+  INVALID_AMOUNT: 'INVALID_AMOUNT',
+  INCOMPATIBLE_REQUEST: 'INCOMPATIBLE_REQUEST',
+  BAD_REQUEST: 'BAD_REQUEST',
+  NO_VALID_QUOTES: 'NO_VALID_QUOTES',
+  FAILED_TO_LOAD: 'FAILED_TO_LOAD',
+  FAILED_TO_LOAD_COUNTRIES: 'FAILED_TO_LOAD_COUNTRIES',
+  FAILED_TO_LOAD_PROVIDERS: 'FAILED_TO_LOAD_PROVIDERS',
+  FAILED_TO_LOAD_METHODS: 'FAILED_TO_LOAD_METHODS',
+  FAILED_TO_LOAD_CURRENCIES: 'FAILED_TO_LOAD_CURRENCIES',
+  FAILED_TO_LOAD_LIMITS: 'FAILED_TO_LOAD_LIMITS',
+  UNKNOWN: 'UNKNOWN_ERROR'
+} as const;
+
+export type OnRampErrorTypeValues = (typeof OnRampErrorType)[keyof typeof OnRampErrorType];
+
+export interface OnRampError {
+  type: OnRampErrorTypeValues;
+  message: string;
+}

package/src/types/onramp/index.ts

@@ -0,0 +1,5 @@
+// OnRamp types barrel export
+export * from './countries';
+export * from './currencies';
+export * from './quotes';
+export * from './errors';

package/src/types/onramp/quotes.ts

@@ -0,0 +1,46 @@
+export type OnRampPaymentMethod = {
+  logos: {
+    dark: string;
+    light: string;
+  };
+  name: string;
+  paymentMethod: string;
+  paymentType: string;
+};
+
+export type OnRampQuote = {
+  countryCode: string;
+  customerScore: number;
+  destinationAmount: number;
+  destinationAmountWithoutFees: number;
+  destinationCurrencyCode: string;
+  exchangeRate: number;
+  fiatAmountWithoutFees: number;
+  lowKyc: boolean;
+  networkFee: number;
+  paymentMethodType: string;
+  serviceProvider: string;
+  sourceAmount: number;
+  sourceAmountWithoutFees: number;
+  sourceCurrencyCode: string;
+  totalFee: number;
+  transactionFee: number;
+  transactionType: string;
+};
+
+export type OnRampServiceProvider = {
+  categories: string[];
+  categoryStatuses: {
+    additionalProp: string;
+  };
+  logos: {
+    dark: string;
+    darkShort: string;
+    light: string;
+    lightShort: string;
+  };
+  name: string;
+  serviceProvider: string;
+  status: string;
+  websiteUrl: string;
+};

package/src/types/siwx/config.ts

@@ -0,0 +1,73 @@
+import type { CaipNetworkId } from '../common';
+import type { SIWXSession, SIWXMessage } from './message';
+
+/**
+ * This interface represents the SIWX configuration plugin, which is used to create and manage SIWX messages and sessions.
+ * You may use it to create a custom implementation following your needs, but watch close for the methods requirements.
+ */
+export interface SIWXConfig {
+  /**
+   * This method will be called to create a new message to be signed by the user.
+   *
+   * Constraints:
+   * - The message MUST be unique and contain all the necessary information to verify the user's identity.
+   * - SIWXMessage.toString() method MUST be implemented to return the message string.
+   *
+   * @param input SIWXMessage.Input
+   * @returns SIWXMessage
+   */
+  createMessage: (input: SIWXMessage.Input) => Promise<SIWXMessage>;
+  /**
+   * This method will be called to store a new single session.
+   *
+   * Constraints:
+   * - This method MUST verify if the session is valid and store it in the storage successfully.
+   *
+   * @param session SIWXSession
+   */
+  addSession: (session: SIWXSession) => Promise<void>;
+  /**
+   * This method will be called to revoke all the sessions stored for a specific chain and address.
+   *
+   * Constraints:
+   * - This method MUST delete all the sessions stored for the specific chain and address successfully.
+   *
+   * @param chainId CaipNetworkId
+   * @param address string
+   */
+  revokeSession: (chainId: CaipNetworkId, address: string) => Promise<void>;
+  /**
+   * This method will be called to replace all the sessions in the storage with the new ones.
+   *
+   * Constraints:
+   * - This method MUST verify all the sessions before storing them in the storage;
+   * - This method MUST replace all the sessions in the storage with the new ones succesfully otherwise it MUST throw an error.
+   *
+   * @param sessions SIWXSession[]
+   */
+  setSessions: (sessions: SIWXSession[]) => Promise<void>;
+  /**
+   * This method will be called to get all the sessions stored for a specific chain and address.
+   *
+   * Constraints:
+   * - This method MUST return only sessions that are verified and valid;
+   * - This method MUST NOT return expired sessions.
+   *
+   * @param chainId CaipNetworkId
+   * @param address string
+   * @returns
+   */
+  getSessions: (chainId: CaipNetworkId, address: string) => Promise<SIWXSession[]>;
+  /**
+   * This method determines whether the wallet stays connected when the user denies the signature request.
+   *
+   * @returns {boolean}
+   */
+  getRequired?: () => boolean;
+  /**
+   * This flag determines whether the session should be cleared when the user disconnects.
+   *
+   * @default true
+   */
+  signOutOnDisconnect?: boolean;
+}

package/src/types/siwx/index.ts

@@ -0,0 +1,4 @@
+export * from './config';
+export * from './message';
+export * from './verifier';
+export * from './storage';

package/src/types/siwx/message.ts

@@ -0,0 +1,92 @@
+import type { CaipNetworkId } from '../common';
+
+/**
+ * This interface represents a SIWX session, which is used to store the user's identity information.
+ */
+export interface SIWXSession {
+  data: SIWXMessage.Data;
+  message: string;
+  signature: string;
+  cacao?: Cacao;
+}
+/**
+ * This interface represents a SIWX message, which is used to create a message to be signed by the user.
+ * This must contain the necessary information to verify the user's identity and how to generate the string message.
+ */
+export interface SIWXMessage extends SIWXMessage.Data, SIWXMessage.Methods {}
+export declare namespace SIWXMessage {
+  /**
+   * This interface represents the SIWX message data, which is used to create a message to be signed by the user.
+   */
+  interface Data extends Input, Metadata, Identifier {}
+  /**
+   * This interface represents the SIWX message input.
+   * Here must contain what is different for each user of the application.
+   */
+  interface Input {
+    accountAddress: string;
+    chainId: CaipNetworkId;
+    notBefore?: Timestamp;
+  }
+  /**
+   * This interface represents the SIWX message metadata.
+   * Here must contain the main data related to the app.
+   */
+  interface Metadata {
+    domain: string;
+    uri: string;
+    version: string;
+    nonce: string;
+    statement?: string;
+    resources?: string[];
+  }
+  /**
+   * This interface represents the SIWX message identifier.
+   * Here must contain the request id and the timestamps.
+   */
+  interface Identifier {
+    requestId?: string;
+    issuedAt?: Timestamp;
+    expirationTime?: Timestamp;
+  }
+  /**
+   * This interface represents the SIWX message methods.
+   * Here must contain the method to generate the message string and any other method performed by the SIWX message.
+   */
+  interface Methods {
+    toString: () => string;
+  }
+  /**
+   * The timestamp is a UTC string representing the time in ISO 8601 format.
+   */
+  type Timestamp = string;
+}
+
+interface CacaoHeader {
+  t: 'caip122';
+}
+
+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;
+  };
+}

package/src/types/siwx/storage.ts

@@ -0,0 +1,44 @@
+import type { CaipNetworkId } from '../common';
+import type { SIWXSession } from './message';
+
+/**
+ * This is the interface for a SIWX storage.
+ */
+export interface SIWXStorage {
+  /**
+   * Adds a new session for the storage.
+   * This method should not verify the session, only store it.
+   *
+   * @param session SIWXSession
+   * @returns Promise<void>
+   */
+  add(session: SIWXSession): Promise<void>;
+
+  /**
+   * Deletes a session from the storage.
+   *
+   * @param chainId CaipNetworkId
+   * @param address string
+   * @returns Promise<void>
+   */
+  delete(chainId: CaipNetworkId, address: string): Promise<void>;
+
+  /**
+   * Gets a list of sessions for a given chainId and address.
+   * This method should not verify sessions, only return the sessions that are stored.
+   *
+   * @param chainId CaipNetworkId
+   * @param address string
+   * @returns Promise<SIWXSession[]>
+   */
+  get(chainId: CaipNetworkId, address: string): Promise<SIWXSession[]>;
+
+  /**
+   * Replaces the current sessions with the new list of sessions.
+   * This method should not verify sessions, only store them.
+   *
+   * @param sessions SIWXSession[]
+   * @returns Promise<void>
+   */
+  set(sessions: SIWXSession[]): Promise<void>;
+}

package/src/types/siwx/verifier.ts

@@ -0,0 +1,32 @@
+import type { ChainNamespace } from '../common';
+import type { SIWXSession } from './message';
+
+/**
+ * This is the base class for a SIWX verifier.
+ */
+export abstract class SIWXVerifier {
+  /**
+   * The chain namespace that this verifier should verify.
+   */
+  public abstract readonly chainNamespace: ChainNamespace;
+
+  /**
+   * This method should return true if the verifier should verify the session.
+   * By default it will check by the chain namespace, but you may override it for a specific requirement.
+   *
+   * @param session SIWXSession
+   * @returns boolean
+   */
+  public shouldVerify(session: SIWXSession): boolean {
+    return session.data.chainId.startsWith(this.chainNamespace);
+  }
+
+  /**
+   * This method should verify the session.
+   * You must implement this method with the verification logic.
+   *
+   * @param session SIWXSession
+   * @returns Promise<boolean> - If `true` means the session is valid.
+   */
+  abstract verify(session: SIWXSession): Promise<boolean>;
+}