@privy-io/react-auth 1.25.1 → 1.26.0-beta.1

package/dist/index.d.ts

@@ -1,8 +1,7 @@
-import React, { ReactElement } from 'react';
+import react, { ReactElement } from 'react';
 import { ExternalProvider, InfuraProvider, Web3Provider } from '@ethersproject/providers';
-import EventEmitter from 'eventemitter3';
-import WCProvider from '@walletconnect/web3-provider';
 import { AbstractProvider } from 'web3-core';
+import EventEmitter from 'eventemitter3';
 import { AxiosResponse, AxiosRequestConfig } from 'axios';
 
 /**
@@ -103,10 +102,223 @@ interface eth_signTransactionResponse {
 type RpcRequestType = eth_signTransaction | eth_populateTransactionRequest | eth_sign | personal_sign;
 type RpcResponseType = eth_signTransactionResponse | eth_populateTransactionRequestResponse | eth_signResponse | personal_signResponse;
 
+type WalletCreateRequestDataType = {
+    accessToken: string;
+    recoveryPin: string;
+};
+type WalletConnectRequestDataType = {
+    accessToken: string;
+    address: string;
+};
+type WalletRecoverRequestDataType = {
+    accessToken: string;
+    address: string;
+    recoveryPin: string;
+};
+type WalletRpcRequestDataType = {
+    accessToken: string;
+    address: string;
+    request: RpcRequestType;
+};
+type WalletCreateResponseDataType = {
+    address: string;
+};
+type WalletConnectResponseDataType = {
+    address: string;
+};
+type WalletRecoverResponseDataType = {
+    address: string;
+};
+type WalletRpcResponseDataType = {
+    address: string;
+    response: RpcResponseType;
+};
+interface EmbeddedWalletProxy {
+    create: (data: WalletCreateRequestDataType) => Promise<WalletCreateResponseDataType>;
+    connect: (data: WalletConnectRequestDataType) => Promise<WalletConnectResponseDataType>;
+    recover: (data: WalletRecoverRequestDataType) => Promise<WalletRecoverResponseDataType>;
+    rpc: (data: WalletRpcRequestDataType) => Promise<WalletRpcResponseDataType>;
+}
+
+declare global {
+    interface Window {
+        ethereum?: unknown;
+    }
+}
+type EIP1193OnEventHandler = ((accounts: string[]) => void) | ((chainId: string | number) => void);
+interface EIP1193Provider {
+    request: (request: {
+        method: string;
+        params?: Array<any> | undefined;
+    }) => Promise<any>;
+    on: (eventName: string, listener: EIP1193OnEventHandler) => any;
+    removeListener: (eventName: string | symbol, listener: (...args: any[]) => void) => any;
+}
+/**
+ * The PrivyProxyProvider adds a middleware layer on top of the underlying wallet provider.
+ * @hidden
+ * */
+declare class PrivyProxyProvider implements EIP1193Provider {
+    walletProvider?: EIP1193Provider;
+    private _subscriptions;
+    constructor(walletProvider?: EIP1193Provider);
+    on(eventName: string, listener: (...args: any[]) => void): any;
+    request(request: {
+        method: string;
+        params?: any[] | undefined;
+    }): Promise<any>;
+    removeListener: (eventName: string | symbol, listener: (...args: any[]) => void) => any;
+    setWalletProvider: (provider: EIP1193Provider) => void;
+}
+interface RequestArguments {
+    readonly method: string;
+    readonly params?: readonly unknown[] | object;
+}
+declare class Embedded1193Provider extends EventEmitter implements EIP1193Provider {
+    walletProxy: EmbeddedWalletProxy;
+    address: string;
+    infuraProvider: InfuraProvider;
+    chainId: number;
+    constructor(walletProxy: EmbeddedWalletProxy, address: string, chainId?: number);
+    handleSendTransaction(args: RequestArguments): Promise<string>;
+    private handleSwitchEthereumChain;
+    private handlePersonalSign;
+    private handleEstimateGas;
+    request(args: RequestArguments): Promise<unknown>;
+    connect(): Promise<string | null>;
+}
+/**
+ * Shim to convert to ethers-compatible ExternalProvider class.
+ * @hidden
+ */
+declare class AsExternalProvider extends PrivyProxyProvider implements ExternalProvider {
+    constructor(provider: EIP1193Provider);
+    isMetaMask?: boolean;
+    isStatus?: boolean;
+    host?: string;
+    path?: string;
+    sendAsync?: (request: {
+        method: string;
+        params?: Array<any>;
+    }, callback: (error: any, response: any) => void) => void;
+    send?: (request: {
+        method: string;
+        params?: Array<any>;
+    }, callback: (error: any, response: any) => void) => void;
+}
+
+interface ConnectorEvents {
+    walletsUpdated(): void;
+    initialized(): void;
+}
+/**
+ * @hidden
+ *
+ * A WalletConnector is identified by a connectorType and walletClientType. A
+ * connectorType includes injected, wallet_connect, etc. A walletClientType
+ * includes metamask, trustwallet, etc.
+ *
+ * Each WalletConnector manages a list of wallets, identified by an address
+ * and chainId. Each wallet has a connected property indicating its current
+ * connection status, which is determined based on events emitted by the
+ * underlying provider.
+ *
+ * The WalletConnector also emits two events: walletsUpdated and initialized.
+ * The walletsUpdated event is triggered when the list of wallets changes,
+ * while the initialized event is triggered when the WalletConnector is
+ * ready and has successfully executed the syncAccounts() function for
+ * the first time.
+ */
+declare abstract class WalletConnector extends EventEmitter<ConnectorEvents> {
+    connected: boolean;
+    initialized: boolean;
+    wallets: BaseConnectedWallet[];
+    walletClientType: WalletClientType;
+    abstract connectorType: ConnectorType;
+    abstract proxyProvider: PrivyProxyProvider | Embedded1193Provider;
+    constructor(walletClientType: WalletClientType);
+    /**
+     * Builds a connected wallet object to be exposed to the developer. This object
+     * contains the address, chainId, and a few helper methods.
+     *
+     * Provider methods share the PrivyProxyProvider instance. This means that multiple
+     * wallets may share the same provider if one wallet was disconnected and another
+     * wallet was connected.
+     *
+     * A wallet is considered connected if it is present in the wallets array and is
+     * in a connected state.
+     */
+    buildConnectedWallet(address: string, chainId: string): BaseConnectedWallet;
+    /**
+     * Sync all accounts available via the provider if the wallet is connected.
+     */
+    syncAccounts(): Promise<void>;
+    /**
+     * Get the most recently connected wallet.
+     */
+    getConnectedWallet(): Promise<BaseConnectedWallet | null>;
+    /**
+     * As a proxy for "connected", we call eth_accounts and consider the client
+     * connected if at least one account is returned.
+     */
+    isConnected(): Promise<boolean>;
+    /**
+     * Perform personal_sign with the user's wallet.
+     *
+     * @param {string} message The message to sign.
+     * @returns {string} The resulting signature.
+     */
+    sign(message: string): Promise<string>;
+    protected onAccountsChanged: (_: string[]) => void;
+    protected onChainChanged: (chainId: string) => void;
+    protected onDisconnect: () => void;
+    protected onConnect: () => void;
+    subscribeListeners(): void;
+    unsubscribeListeners(): void;
+    abstract get walletBranding(): WalletBranding;
+    abstract connect(options: {
+        showPrompt?: boolean;
+        chainId?: number;
+    }): Promise<BaseConnectedWallet | null>;
+    abstract disconnect(): void;
+    abstract promptConnection(walletClientType: WalletClientType): void;
+}
+
 declare const SUPPORTED_OAUTH_PROVIDERS: readonly ["google", "discord", "twitter", "github", "apple"];
 type OAuthProviderType = typeof SUPPORTED_OAUTH_PROVIDERS[number];
-declare const SUPPORTED_WALLET_CONNECTION_TYPES: readonly ["metamask", "phantom", "coinbase_wallet", "wallet_connect", "embedded"];
-type WalletType = typeof SUPPORTED_WALLET_CONNECTION_TYPES[number];
+/** @hidden */
+type EmbeddedWalletClientType = 'privy';
+/** @hidden */
+type InjectedWalletClientType = 'metamask' | 'phantom';
+/** @hidden */
+type CoinbaseWalletClientType = 'coinbase_wallet';
+/** @hidden
+ *
+ * How this works:
+ *
+ * The raw data is pulled from https://registry.walletconnect.com/api/v2/wallets
+ * Some post-processing is done using the following script.
+ *
+ * const axios = require('axios');
+ * const walletTypes = [];
+ * axios.get("https://registry.walletconnect.com/api/v2/wallets").then((apiResult) => {
+ *   Object.values(apiResult.data.listings).forEach((walletEntry) => {
+ *     if (!walletEntry.mobile.native || !walletEntry.mobile.universal) return;
+ *     if (!walletEntry.chains.includes('eip155:1')) return;
+ *     if (!walletEntry.metadata.shortName) return;
+ *     // Manually removed for cleanliness
+ *     if (walletEntry.id === 'b2ce31fb31735fa886270806340de999f72342a7c29484badd8d4d013d77c8b8') return;
+ *     if (walletEntry.id) walletTypes.push(`'${walletEntry.id}'`);
+ *   });
+ *   console.log(walletTypes.join("\n  | "));
+ * });
+ */
+type WalletConnectWalletClientType = 'rainbow' | 'trust' | 'uniswap' | 'metamask' | 'argent' | 'spot' | 'zerion' | 'bitkeep' | 'unstoppable' | 'omni' | 'mathwallet' | 'bitpay' | '1inch' | 'eidoo' | 'coin98' | 'unstoppable' | 'alphawallet' | 'rwallet' | 'plasmapay' | 'o3wallet' | 'hashkey_me' | 'defiant' | 'essentials' | 'stasis' | 'julwallet' | 'tangem' | 'secux' | 'linen' | 'ambire' | 'obvious' | 'easypocket' | 'rice_wallet' | 'safemoon' | 'simplehold' | 'bitizen' | 'slavi_wallet' | 'nufinetes' | 'now_wallet' | 'blocto' | 'timeless' | 'arculus_wallet' | 'card' | 'mew_wallet' | 'pltwallet' | 'avacus' | 'bitski' | 'hippowallet' | 'edge' | 'assure' | 'enjin_wallet' | 'slingshot' | 'coinstats' | 'bitcoincom_wallet' | 'defiant' | 'binance';
+/** @hidden */
+type UnknownWalletClientType = 'unknown';
+type WalletClientType = InjectedWalletClientType | CoinbaseWalletClientType | WalletConnectWalletClientType | EmbeddedWalletClientType | UnknownWalletClientType;
+declare const SUPPORTED_CONNECTOR_TYPES: string[];
+type ConnectorType = typeof SUPPORTED_CONNECTOR_TYPES[number];
 /**
  * Wallet metadata currently for internal use only
  */
@@ -134,9 +346,6 @@ interface Wallet {
      * @experimental
      * DO NOT USE: This feature is under active development.
      *
-     * The chain ID of the active connected wallet, if used to verify in the current session.
-     * Only present for the active wallet.
-     *
      * e.g. testnet, mainnet, goerli */
     chainId?: string;
     /**
@@ -152,6 +361,44 @@ interface Wallet {
      */
     walletClient: 'privy' | 'unknown';
 }
+/**
+ * Object representation of a connected wallet.
+ */
+interface BaseConnectedWallet {
+    /** The wallet address. */
+    address: string;
+    /** The current chain ID with CAIP-2 formatting. */
+    chainId: string;
+    /** The first time this wallet was connected without break. */
+    connectedAt: number;
+    /** The wallet client where this key-pair is stored. */
+    walletClientType: WalletClientType;
+    /** The connector used to initiate the connection with the wallet client. */
+    connectorType: ConnectorType;
+    /** Returns true if the wallet is connected, false otherwise */
+    isConnected: () => Promise<boolean>;
+    /** Helper methods to build providers for interfacing with this wallet. */
+    getEthereumProvider: () => EIP1193Provider;
+    getEthersProvider: () => Web3Provider;
+    getWeb3jsProvider: () => AbstractProvider;
+    /** Disconnect method does not work on all connector types and will no-op if
+     * that is the case (metamask does not support programmatic disconnects) */
+    disconnect: () => void;
+}
+interface ConnectedWallet extends BaseConnectedWallet {
+    /** True if this wallet is linked to the authenticated user. False if it is not yet linked or
+     * the user has not yet authenticated. */
+    linked: boolean;
+    /** Link this wallet to the authenticated user. Throws a PrivyClientError if the user is not
+     * authenticated or if the wallet is not connected. */
+    link: () => Promise<void>;
+    /** Unlink this wallet to the authenticated user. Throws a PrivyClientError if the user is not
+     * authenticated. */
+    unlink: () => Promise<void>;
+    /** Login with this wallet. Throws a PrivyClientError if the user is already authenticated or
+     * the wallet is not connected. */
+    login: () => Promise<void>;
+}
 /** Object representation of a user's email. */
 interface Email {
     /** The email address. */
@@ -261,10 +508,9 @@ interface User {
     email?: Email;
     /** The user's phone number, if they have linked one. It cannot be linked to another user. */
     phone?: Phone;
-    /** The user's active wallet address, if they have linked at least one wallet. It cannot be linked to another user.
-     *  If a user links a new wallet, that one is automatically set as active.
-     *  Developers can call setActiveWallet() to change the active wallet.
-     *  The active wallet is the wallet that will be used for transactions and signing.
+    /** The user's most recently linked wallet, if they have linked at least one wallet.
+     *  It cannot be linked to another user.
+     *  This wallet is the wallet that will be used for transactions and signing if it is connected.
      **/
     wallet?: Wallet;
     /** The user's Google account, if they have linked one. It cannot be linked to another user. */
@@ -440,7 +686,7 @@ interface PrivyProviderProps {
      * @ignore
      * @class
      */
-    children: React.ReactNode;
+    children: react.ReactNode;
 }
 /**
  * Passes the Privy authentication context to your React components.
@@ -459,282 +705,89 @@ interface PrivyProviderProps {
  */
 declare const PrivyProvider: (props: PrivyProviderProps) => JSX.Element;
 
-type WalletCreateRequestDataType = {
-    accessToken: string;
-    recoveryPin: string;
-};
-type WalletConnectRequestDataType = {
-    accessToken: string;
-    address: string;
-};
-type WalletRecoverRequestDataType = {
-    accessToken: string;
-    address: string;
-    recoveryPin: string;
-};
-type WalletRpcRequestDataType = {
-    accessToken: string;
-    address: string;
-    request: RpcRequestType;
-};
-type WalletCreateResponseDataType = {
-    address: string;
-};
-type WalletConnectResponseDataType = {
-    address: string;
-};
-type WalletRecoverResponseDataType = {
-    address: string;
-};
-type WalletRpcResponseDataType = {
-    address: string;
-    response: RpcResponseType;
-};
-interface EmbeddedWalletProxy {
-    create: (data: WalletCreateRequestDataType) => Promise<WalletCreateResponseDataType>;
-    connect: (data: WalletConnectRequestDataType) => Promise<WalletConnectResponseDataType>;
-    recover: (data: WalletRecoverRequestDataType) => Promise<WalletRecoverResponseDataType>;
-    rpc: (data: WalletRpcRequestDataType) => Promise<WalletRpcResponseDataType>;
-}
-
-declare global {
-    interface Window {
-        ethereum?: any;
-    }
-}
-interface EIP1193Provider {
-    request: (request: {
-        method: string;
-        params?: Array<any> | undefined;
-    }) => Promise<any>;
-    on: (eventName: string, listener: (...args: unknown[]) => void) => any;
-    removeListener: (eventName: string | symbol, listener: (...args: any[]) => void) => any;
-}
-/**
- * The PrivyProxyProvider adds a middleware layer on top of the underlying wallet provider.
- * @hidden
- * */
-declare class PrivyProxyProvider implements EIP1193Provider {
-    walletProvider?: EIP1193Provider;
-    private _subscriptions;
-    constructor(walletProvider?: EIP1193Provider);
-    on(eventName: string, listener: (...args: any[]) => void): any;
-    request(request: {
-        method: string;
-        params?: any[] | undefined;
-    }): Promise<any>;
-    removeListener: (eventName: string | symbol, listener: (...args: any[]) => void) => any;
-    setWalletProvider: (provider: EIP1193Provider) => void;
-}
-interface RequestArguments {
-    readonly method: string;
-    readonly params?: readonly unknown[] | object;
-}
-declare class Embedded1193Provider extends EventEmitter implements EIP1193Provider {
-    walletProxy: EmbeddedWalletProxy;
-    address: string;
-    infuraProvider: InfuraProvider;
-    chainId: number;
-    constructor(walletProxy: EmbeddedWalletProxy, address: string, chainId?: number);
-    handleSendTransaction(args: RequestArguments): Promise<string>;
-    private handleSwitchEthereumChain;
-    private handlePersonalSign;
-    private handleEstimateGas;
-    request(args: RequestArguments): Promise<unknown>;
-    connect(): Promise<string | null>;
+interface ConnectorManagerEvents {
+    walletsUpdated(): void;
 }
-/**
- * Shim to convert to ethers-compatible ExternalProvider class.
- * @hidden
- */
-declare class AsExternalProvider extends PrivyProxyProvider implements ExternalProvider {
-    constructor(provider: EIP1193Provider);
-    isMetaMask?: boolean;
-    isStatus?: boolean;
-    host?: string;
-    path?: string;
-    sendAsync?: (request: {
-        method: string;
-        params?: Array<any>;
-    }, callback: (error: any, response: any) => void) => void;
-    send?: (request: {
-        method: string;
-        params?: Array<any>;
-    }, callback: (error: any, response: any) => void) => void;
-}
-
 /** @hidden */
-declare abstract class WalletConnector {
-    proxyProvider: PrivyProxyProvider | Embedded1193Provider;
-    walletType: WalletType;
-    connected: boolean;
-    address: string | null;
-    chain: string | null;
-    constructor(walletType: WalletType, proxyProvider: PrivyProxyProvider | Embedded1193Provider, address: string | null);
-    fetchAddress(): Promise<string | null>;
-    fetchChainId(): Promise<string>;
-    getConnectedWallet(): Promise<Wallet | null>;
-    abstract get walletBranding(): WalletBranding;
-    abstract connect(options: {
-        showPrompt: boolean;
-        chainId?: number;
-    }): Promise<Wallet | null>;
-    abstract disconnect(): void;
-    abstract isConnected(): Promise<boolean>;
-    abstract promptConnection(walletType: WalletType): void;
-    setActive(): Promise<boolean>;
+declare class ConnectorManager extends EventEmitter<ConnectorManagerEvents> {
+    walletConnectors: WalletConnector[];
+    initialized: boolean;
+    private storedConnections;
+    private activeWallet?;
+    constructor();
     /**
-     * Perform personal_sign with the user's wallet.
+     * The core wallets array that is exposed to developers. It builds
+     * the wallets away with the following logic:
      *
-     * @param {string} message The message to sign.
-     * @returns {string} The resulting signature.
-     */
-    sign(message: string): Promise<string>;
-}
-
-/**
- * Types aren't included in the final distribution, so we can have the duplicates here to assure
- * type-safety
- */
-type WalletId = '1ae92b26df02f0abca6304df07debccd18262fdf5fe82daa81593582dac9a369' | '4622a2b2d6af1c9844944291e5e7351a6aa24cd7b23099efac1b2fd875da31a0' | 'c57ca95b47569778a828d19178114f4db188b89b763c899ba0be274e97267d96' | '225affb176778569276e484e1b92637ad061b01e13a048b35a9d280c3b58970f' | '74f8092562bd79675e276d8b2062a83601a4106d30202f2d509195e30e19673d' | 'ecc4036f814562b41a5268adc86270fba1365471402006302e70169465b7ac18' | '8308656f4548bb81b3508afe355cfbb7f0cb6253d1cc7f998080601f838ecee3' | '38f5d18bd8522c244bdd70cb4a68e0e718865155811c043f052fb9f1c51de662' | 'afbd95522f4041c71dd4f1a065f971fd32372865b416f95a0b1db759ae33f2a7' | 'ccb714920401f7d008dbe11281ae70e3a4bfb621763b187b9e4a3ce1ab8faa3b' | '7674bb4e353bf52886768a3ddc2a4562ce2f4191c80831291218ebd90f5f5e26' | '2863183c3299d820fb9a4cb8aab4a34f50380c9992e8be871fd60a62e8d36481' | 'efba9ae0a9e0fdd9e3e055ddf3c8e75f294babb8aea3499456eff27f771fda61' | 'b021913ba555948a1c81eb3d89b372be46f8354e926679de648e4fa2938bed3e' | '7e90b95230bc462869bbb59f952273d89841e1c76bcc5319898e08c9f34bd4cd' | '138f51c8d00ac7b9ac9d8dc75344d096a7dfe370a568aa167eabc0a21830ed98' | '468b4ab3582757233017ec10735863489104515ab160c053074905a1eecb7e63' | '29f4a70ad5993f3f73ae8119f0e78ecbae51deec2a021a770225c644935c0f09' | '8240fb8a7b117aed27f04aa8870c714eeb910f7c1b16c9b868e793c1836335b8' | '15d7610042217f691385d20e640869dc7273e991b04e8f476417cdc5ec856955' | 'a395dbfc92b5519cbd1cc6937a4e79830187daaeb2c6fcdf9b9cce4255f2dcd5' | '0b415a746fb9ee99cce155c2ceca0c6f6061b1dbca2d722b3ba16381d0562150' | '881946407ff22a32ec0e42b2cd31ea5dab52242dc3648d777b511a0440d59efb' | '3b0e861b3a57e98325b82ab687fe0a712c81366d521ceec49eebc35591f1b5d1' | '38ee551a01e3c5af9d8a9715768861e4d642e2381a62245083f96672b5646c6b' | 'f2436c67184f158d1beda5df53298ee84abfc367581e4505134b5bcf5f46697d' | '15d1d97de89526a3c259a235304a7c510c40cda3331f0f8433da860ecc528bef' | '19ad8334f0f034f4176a95722b5746b539b47b37ce17a5abde4755956d05d44c' | '95501c1a07c8eb575cb28c753ab9044259546ebcefcd3645461086e49b671f5c' | '2ed796df33fdbde6a3ea6a47d3636b8341fe285038d844c7a78267b465b27028' | '4e6af4201658b52daad51a279bb363a08b3927e74c0f27abeca3b0110bddf0a9' | 'b13fcc7e3500a4580c9a5341ed64c49c17d7f864497881048eb160c089be5346' | '13c6a06b733edf51784f669f508826b2ab0dc80122a8b5d25d84b17d94bbdf70' | '0aafbedfb8eb56dae59ecc37c9a5388509cf9c082635e3f752581cc7128a17c0' | '761d3d98fd77bdb06e6c90092ee7071c6001e93401d05dcf2b007c1a6c9c222c' | 'ffa139f74d1c8ebbb748cf0166f92d886e8c81b521c2193aa940e00626f4e215' | '717911f4db0c5eda0e02e76ed179b7940ba1eefffdfb3c9e6540696226860da0' | '9d6c614d1995741d5313f1f3dbf1f66dcba694de782087d13b8721822502692f' | 'a6ffb821a3c32d36fc9d29e29c2ff79a0cd1db0bca453714777846ddf3fdff76' | '76745388a50e6fea982c4dee2a3ad61a8aa417668be870754689caa8a7506c93' | '6464873279d46030c0b6b005b33da6be5ed57a752be3ef1f857dc10eaf8028aa' | '2c81da3add65899baeac53758a07e652eea46dbb5195b8074772c62a77bbf568' | 'b823fb0d7228ef8e3c0bc9607df9ed79dae2ab3a2811d33f22ade4f573c18232' | 'dccbd717df77b395445cc6080e01fffada9d8b92dacfda312a26c70c2e9af673' | 'c6f3d04a4e1a51e7d2045f347a5ebdab30fc600950a740fca21f0c92e230ee05' | 'c482dfe368d4f004479977fd88e80dc9e81107f3245d706811581a6dfe69c534' | '14e7176536cb3706e221daaa3cfd7b88b7da8c7dfb64d1d241044164802c6bdd' | '0e4915107da5b3408b38e248f7a710f4529d54cd30e9d12ff0eb886d45c18e92' | 'a2c031fccd13a6c16d7745c303507f78ae4da53fed064542804e9657d73e8b5c' | 'f593f4eb9755ff047681a37ebc46706e0e915cf1c2fe0102f5ae47c9f6aa4082' | '5859076ade608fbc4e9d3fe2f95e8527de80f8451ecbb1dced54ca84deae0dd6' | 'bb88a220ed4dcd3d717ec19b6ac00a672edf92e97ef7c243d35e25ff56a07301' | 'cbe13eb482c76f1fa401ff4c84d9acd0b8bc9af311ca0620a0b192fb28359b4e' | 'b83a346877b71c02b8531f53485ce12bc00033eabcc1213ca3329cbc744813a5' | 'a92d512c649e87a5acba5885ac03f62662cff1f647c20a63833eb45a71a6f877' | '226d8a12a2e6e5c4185fa9c24313824bfb144c2a180325bddbd121844f497afa' | '11c5487e4d8dd8bf32d4c92222363df8296a27307b2531be1e25770365392ecb' | 'f5b4eeb6015d66be3f5940a895cbaa49ef3439e518cd771270e6b553b48f31d2' | '576c90ceaea34f29ff0104837cf2b2e23d201be43be1433feeb18d375430e1fd' | '94f785c0c8fb8c4f38cd9cd704416430bcaa2137f27e1468782d624bcd155a43' | 'bc949c5d968ae81310268bf9193f9c9fb7bb4e1283e1284af8f2bd4992535fd6' | '664b505fea4c2117b8a55c054ef209664e0a68ddaafd7534df739f97a293fa1d' | '0c5bba82e70a2b62405871af809020a077d110d765c0798eb660ad5d3131b328' | '792fbacfe787d67595dd4eb38ac308e14b3bbc810393db56f477a92e5ac8764b' | '7ef337ff00714f179d38b8142398efa2ab902a53430e99ebce02892053d7a310' | '7e94e75c90964a69ea375b92214f50c4223dfbfa4913a3733b615444b322f687' | '107bb20463699c4e614d3a2fb7b961e66f48774cb8f6d6c1aee789853280972c' | '1986e7c874bb906f057d5d64a4806c004e021689536e5228c74d64a6058e8bac' | '19418ecfd44963883e4d6abca1adeb2036f3b5ffb9bee0ec61f267a9641f878b' | '37a686ab6223cd42e2886ed6e5477fce100a4fb565dcd57ed4f81f7c12e93053' | '4f5de5333fed2ccf47c690579aba3b9128aea78175339ff51ef61704bde7502a' | '9034d54985807aaf3d7780f50f155f954daa468fb58d7b14b216fc79d68bbd14' | 'c39d8ee468e50474fdf3a0bd6b981be404d4671e2702a3d633aae95bcbaa032a' | 'e9ff15be73584489ca4a66f64d32c4537711797e30b6660dbcb71ea72a42b1f4' | '114efdbef4ce710081c1507f3dbc51f439c96a342cf33397799cd1c84b01a8c5' | '5b8e33346dfb2a532748c247876db8d596734da8977905a27b947ba1e2cf465b' | '2cca8c1b0bea04ba37dee4017991d348cdb7b826804ab2bd31073254f345b715' | 'e3787ea98d014ca77e2c3794db97c02ef8bcb39347705f5e79502a55434a1ecf' | '159b0423ce9075d5662f588f805931d989627affab3e63e4dd7ebc62b9c6738c' | 'fbea6f68df4e6ce163c144df86da89f24cb244f19b53903e26aea9ab7de6393c' | '1aedbcfc1f31aade56ca34c38b0a1607b41cccfa3de93c946ef3b4ba2dfab11c' | '14e5d957c6eb62d3ee8fc6239703ac2d537d7e3552154836ca0beef775f630bc' | '031f0187049b7f96c6f039d1c9c8138ff7a17fd75d38b34350c7182232cc29aa' | 'c40b9bcef32fa6ce4e0df98be1420628bbc4957646f742380fe618fcb4ab74f1' | 'b265ce38b94d602957a0946673c59a99a15d69adda4317544fec7298ea2d1387' | 'dc5415b6ea8114db518ae91195b027d690a11a1d2bfdd1a904e93c5cb746380e' | '41f20106359ff63cf732adf1f7dc1a157176c9b02fd266b50da6dcc1e9b86071';
-
-/**
- * Light wrapper around WCConnectionManager that uses the global connection manager
- * to manage the local storage layer and avoid conflicts.
- * There can be multiple WCWalletConnectors, but should only ever be a single
- * WCConnectionManager, which should be the class referenced - it will in turn find
- * the appropriate WCWalletConnector for use with an action.
- */
-declare class WCWalletConnector extends WalletConnector {
-    private connectionManager;
-    proxyProvider: PrivyProxyProvider;
-    constructor(connectionManager: WCConnectionManager, proxyProvider: PrivyProxyProvider, address: string | null);
-    setActive(): Promise<boolean>;
-    connect(options: {
-        showPrompt: boolean;
-    }): Promise<Wallet | null>;
-    isConnected(): Promise<boolean>;
-    /**
-     * Metadata about the wallet represented by this connector.
+     * 1. Flatten all wallets from all connectors
+     * 2. Sorted by connectedAT
+     * 3. Active wallet is moved to front of array (if it exists)
      */
-    get walletBranding(): {
-        name: string;
-        icon: string | EmbeddedSVG;
-    };
-    promptConnection(): Promise<void>;
+    get wallets(): BaseConnectedWallet[];
     /**
-     * Perform personal_sign with the user's first wallet associated with WalletConnect
+     * Detect and add all valid wallet connectors.
      */
-    sign(message: string): Promise<string>;
-    disconnect(): void;
+    initialize(): void;
     /**
-     * Access the underlying WCProvider directly with proper typings
+     * Restore previous Wallet Connect connections that have been stored in local storage.
      */
-    private get walletProvider();
+    restoreWalletConnectConnectors(): void;
     /**
-     * Set the underlying WCProvider with proper typings
+     * Helper function to find a wallet connector by connector type and wallet client type.
      */
-    setWalletProvider(walletProvider: WCProvider): void;
-}
-/**
- * An object representation of the Wallet Connect V1 protocol. This is used to initiate and manage connections
- * with any number of wallets.
- */
-declare class WCConnectionManager {
-    private _storageIdToProvider;
-    private reconnectDelayMs;
-    private reconnectBackoff;
-    constructor();
+    findWalletConnector(connectorType: ConnectorType, walletClientType: WalletClientType): WalletConnector | null;
     /**
-     * Builds a new WCWalletConnector instance
-     *
-     * If walletId is specified, attempts to launch into that specific flow.
-     *
-     * IMPORTANT! Nothing in this flow can be costly in order to properly launch our deep links. See:
-     * https://docs.walletconnect.com/1.0/mobile-linking#ios-app-link-constraints
+     * Add any connectedAt overrides for newly initialized wallets and pass-through change events.
      */
-    createConnector(proxyProvider: PrivyProxyProvider, address: string | null, 
+    private onInitialized;
     /**
-     * If provided, the connector will attempt to establish a connection directly using this
-     * wallet. If omitted, but an address is provided, the connector may still attempt to link
-     * up to a wallet, but may be unable to. If a wallet cannot be determined, the standard WC
-     * modal is shown.
+     * Save connection history and pass-through change events.
      */
-    walletId?: WalletId): WCWalletConnector;
+    private onWalletsUpdated;
+    addEmbeddedWalletConnector(walletProxy: EmbeddedWalletProxy, address: string): void;
     /**
-     * Disconnects all active Wallet Connect sessions.
+     * Normally, we do not remove connectors after creation. Privy embedded wallets are an exception
+     * because they are closely tied with an authenticated state.
      */
-    disconnect(): Promise<void>;
+    removeEmbeddedWalletConnector(): void;
     /**
-     * Fetch a storage id for an address/walletId pair. If we don't match exactly, we still
-     * attempt to discover if any legacy keys were matched using instant launch methods (currently)
-     * just metamask and reuse if that. Admittedly, this method feels very fragile and unknown.
+     * Creates a new wallet connector for the given connector type and wallet client type.
+     * If a connector already exists, it will be returned instead.
      */
-    private getStorageId;
+    createWalletConnector(connectorType: ConnectorType, walletClientType: WalletClientType): WalletConnector | null;
+    private addWalletConnector;
     /**
-     * Given an address, either fetch (reusing a stored connection) or create a new one if no stored
-     * connection is found
+     * Upon initialization, loads previous connections from local storage. If local storage
+     * is misformatted (e.g. due to previous privy:connectors usage), it returns an empty array that
+     * will be overwritten later.
+     *
+     * @returns StoredConnection[] list of stored connections from previous session
      */
-    getProviderForAddress(address: string | null, walletId: WalletId | undefined): WCProvider | undefined;
-    private createProviderWithStorageId;
+    private loadConnectionHistory;
     /**
-     * Create a WC provider and add an entry to the internal provider registry keyed on the internal
-     * WC storageId. If walletId is specified, attempts to launch the WC flow for that particular
-     * wallet
+     * Saves all current connections to local storage overridding any previous connections.
      */
-    createProvider(connector: WCWalletConnector, walletId?: WalletId): WCProvider;
+    private saveConnectionHistory;
     /**
-     * Replace the given provider, *assuming it's the one with null address*
+     * @deprecated **Deprecated**: This feature will be removed and should be replaced by
+     * interfacing with wallets directly (wallets[0].getEthereumProvider()).
      *
-     * Couldn't find any WC docs, but a reference implementation library had a similar error we were
-     * seeing - WC sessions wouldn't open a new modal/etc when doing `provider.enable()` if it had
-     * previously been rejected: https://github.com/Uniswap/web3-react/issues/217
-     */
-    replaceProvider(connector: WCWalletConnector, provider: WCProvider): WCProvider;
-    /**
-     * Enables the provider. Under the hood, this calls connect() and 'eth_RequestAccounts'.
+     * Build an Ethereum provider for the most recently connected wallet.
      */
-    enableProvider(provider: WCProvider): Promise<string[]>;
-}
-
-/** @hidden */
-declare class ConnectorManager {
-    walletConnectors: WalletConnector[];
-    activeWalletConnector?: WalletConnector;
-    initialized: boolean;
-    wcConnectionManager: WCConnectionManager;
-    constructor();
-    initialize(): void;
     getEthereumProvider: () => EIP1193Provider;
     /**
-     * Load state from the server user object (linked wallets).
-     * Currently, we can't load them because we don't know the wallet type.
-     * Once we've fixed this, we can load the wallets from the server and
-     * initialize their WalletConnector objects accordingly.
-     **/
-    initializeLinkedWallets(user: User): void;
-    /** Load the state from storage and hydrate the instance with WalletConnectors. */
-    load(): void;
-    /** Persist the instance state to storage to reload the connectors later. */
-    save(): void;
-    addEmbeddedWalletConnector(walletProxy: EmbeddedWalletProxy, address: string): void;
-    addWalletConnector(walletConnector: WalletConnector): void;
-    getConnectorByAddress(address: string): WalletConnector | undefined;
-    removeWallet(address: string): Promise<void>;
-    /**
-     * Performing personal_sign with the active wallet
-     * If the active wallet is not connected, we connect it in just-in-time" fashion.
+     * @deprecated **Deprecated**: This feature will be removed and should be replaced by
+     * interfacing with `wallets` directly.
+     *
+     * Performing personal_sign with the most recently connected wallet.
+     * If there is not a wallet connected, return null.
      */
     activeWalletSign(message: string): Promise<string | null>;
     /**
-     * Set a wallet as active, by passing the address.
-     * If the address is null or not found, do nothing and return false.
-     * If the connector was successfully found and set active, return true.
+     * @deprecated **Deprecated**: This feature will be removed and should be replaced by
+     * interfacing with `wallets` directly.
      */
-    setActiveWallet(address: string | null): Promise<boolean>;
-    createWalletConnector(walletType: WalletType, address: string | null, 
-    /** Only applicable for WalletConnect right now */
-    walletId?: WalletId): WalletConnector;
+    setActiveWallet(address: string): void;
 }
 
 /**
@@ -759,6 +812,10 @@ interface PrivyInterface {
      * The user object, or null if the user is not authenticated.
      */
     user: User | null;
+    /**
+     * Opens the Privy modal and prompts the user to connect a wallet.
+     */
+    connectWallet: () => void;
     /**
      * Opens the Privy login modal and prompts the user to login.
      */
@@ -818,22 +875,33 @@ interface PrivyInterface {
      */
     getAccessToken: () => Promise<string | null>;
     /**
+     * @deprecated **Deprecated**: This feature will be removed and should be replaced by
+     * interfacing with wallets directly (wallets[0].getEthereumProvider()).
+     *
      * Get an [EIP-1193](https://eips.ethereum.org/EIPS/eip-1193)-compatible provider from the user's wallet, if the user has connected one.
      *
      * You may then use the Ethereum Javascript API syntax to send JSON-RPC requests to the user's wallet.
      */
     getEthereumProvider: () => EIP1193Provider;
     /**
+     * @deprecated **Deprecated**: This feature will be removed and should be replaced by
+     * interfacing with wallets directly (wallets[0].getEthersProvider()).
      *
      * Get an [ethers.js](https://docs.ethers.io/v5/)-compatible provider from the user's wallet, if the user has connected one.
      *
      */
     getEthersProvider: () => Web3Provider;
     /**
+     * @deprecated **Deprecated**: This feature will be removed and should be replaced by
+     * interfacing with wallets directly (wallets[0].getWeb3jsProvider()).
+     *
      * Get a [web3.js](https://web3js.readthedocs.io/en/v1.8.0/)-compatible provider from the user's wallet, if the user has connected one.
      */
     getWeb3jsProvider: () => AbstractProvider;
     /**
+     * @deprecated **Deprecated**: This feature will be removed and should be replaced by the
+     * `useWallet` hook.
+     *
      * Get the ConnectorManager object
      * This shouldn't need to be used directly unless creating a plugin, like a WAGMI plugin
      */
@@ -872,14 +940,10 @@ interface PrivyInterface {
      */
     unlinkApple: (subject: string) => Promise<User>;
     /**
-     * Set one of the authenticated wallet addresses (part of user.linkedAccounts with type 'wallet'). as the active wallet.
-     * If you pass a wallet that's not one of the linkedAccounts, this will throw an error.
-     * This will prompt the user to reconnect their wallet if the connection is lost.
-     *
-     * The active wallet will be the one that getEthersProvider() will use as a signer (used for signing & transactions).
-     * It is also the wallet present at `user.wallet`, and that value is updated when this is called.
+     * @deprecated **Deprecated**: This feature will be removed and behaves the same as connectWallet(). Instead, please
+     * interact with the wallets array directly.
      *
-     * Note that when you link a new wallet, it becomes active.
+     * Note that when you connect a new wallet, it becomes first in the wallets array.
      */
     setActiveWallet: (address: string) => Promise<void>;
     /**
@@ -920,6 +984,18 @@ interface PrivyInterface {
  */
 declare const usePrivy: () => PrivyInterface;
 
+/**
+ * Allows you to manage the user's currently connected wallets.
+ * You can access the fields and methods documented here via the {@link useWallets} hook.
+ */
+interface UseWalletsInterface {
+    /**
+     * The user's connected wallets.
+     */
+    wallets: ConnectedWallet[];
+}
+declare function useWallets(): UseWalletsInterface;
+
 declare const VERSION: string;
 
 interface ResponseEmailAccount {
@@ -1130,7 +1206,6 @@ declare class PrivyClient {
     }): Promise<string | null>;
     getServerConfig(): Promise<PrivyServerConfig>;
     getUsdTokenPrice(chainId: string | number): Promise<number | undefined>;
-    setActiveWallet(address: string, user: User): Promise<User>;
     /**
      * Get a short-lived token to start a new Privy session from the existing authenticated session.
      *
@@ -1143,4 +1218,4 @@ declare class PrivyClient {
     forkSession(): Promise<string>;
 }
 
-export { Apple, AppleOAuthWithMetadata, AsExternalProvider, ConnectorManager, Discord, DiscordOAuthWithMetadata, Email, EmailWithMetadata, Github, GithubOAuthWithMetadata, Google, GoogleOAuthWithMetadata, Phone, PhoneWithMetadata, PrivyClient, PrivyClientConfig, PrivyInterface, PrivyProvider, PrivyProviderProps, PrivyProxyProvider, Quantity, SendTransactionModalUIOptions, SignMessageModalUIOptions, TransactionLog, TransactionReceipt, Twitter, TwitterOAuthWithMetadata, UnsignedTransactionRequest, User, VERSION, Wallet, WalletConnector, WalletWithMetadata, getAccessToken, usePrivy };
+export { Apple, AppleOAuthWithMetadata, AsExternalProvider, ConnectedWallet, ConnectorManager, Discord, DiscordOAuthWithMetadata, EIP1193Provider, Email, EmailWithMetadata, Github, GithubOAuthWithMetadata, Google, GoogleOAuthWithMetadata, Phone, PhoneWithMetadata, PrivyClient, PrivyClientConfig, PrivyInterface, PrivyProvider, PrivyProviderProps, PrivyProxyProvider, Quantity, SendTransactionModalUIOptions, SignMessageModalUIOptions, TransactionLog, TransactionReceipt, Twitter, TwitterOAuthWithMetadata, UnsignedTransactionRequest, UseWalletsInterface, User, VERSION, Wallet, WalletConnector, WalletWithMetadata, getAccessToken, usePrivy, useWallets };