@privy-io/react-auth 3.4.1 → 3.5.0

package/dist/dts/index.d.ts

@@ -1,20 +1,22 @@
 import * as react from 'react';
 import react__default, { MouseEvent } from 'react';
-import { M as MfaSubmitArgs, g as UserRecoveryMethod, c as SessionSignerInput, E as EthereumRpcRequestType, h as SolanaRpcRequestType, i as EthereumRpcResponseType, j as SolanaRpcResponseType, P as PrivyFarcasterSignerInitResponse, k as EIP1193Provider, l as EntropyIdVerifier$1, H as HDWalletWithMetadata, m as RequestArguments, n as WalletConnector, B as BaseConnectedEthereumWallet, o as PrivyProxyProvider, p as WalletClientType, q as ConnectedWalletMetadata, r as PrivyClientConfig, s as ConnectorType, u as SetBaseAccountSdkType, v as WalletListEntry, A as AppConfig, w as BaseConnectedWallet, f as SolanaWalletConnector, U as User, x as ConnectWalletModalOptions, y as LoginModalOptions, C as CreateWalletOptions, W as Wallet, z as SetWalletRecoveryOptions, b as SignMessageModalUIOptions, D as SignTypedDataParams, F as MfaMethod, G as UnsignedTransactionRequest, a as SendTransactionModalUIOptions, I as FundWalletConfig, J as ConnectedWallet, O as OAuthTokens, K as CrossAppProviderDetails, N as MoonpaySignRequest, Q as MoonpaySignResponse, T as SmartWalletConfig, V as SiwsMessageType, X as LoginMethod, Y as ExternalWalletMetadata, Z as TelegramAuthResult, _ as TelegramWebAppData, $ as OAuthUserInfo, a0 as LinkedAccountWithMetadata, a1 as PrivyErrorCode, a2 as BaseConnectedSolanaWallet, a3 as FundingMethod, S as SolanaChain, a4 as OAuthFlowState, a5 as LoginWithCode, a6 as OtpFlowState, a7 as PasskeyFlowState, a8 as SiweFlowState, a9 as BaseAccountSdkType, aa as UnsignedTransactionRequestWithChainId, ab as BaseConnectedWalletType, ac as TelegramAuthFlowState } from './types-BF33BYgd.js';
-export { au as Apple, aH as AppleOAuthWithMetadata, aP as ContractUIOptions, ay as CrossAppAccount, aK as CrossAppAccountWithMetadata, ar as Discord, aC as DiscordOAuthWithMetadata, aM as Email, am as EmailWithMetadata, aS as Farcaster, aI as FarcasterWithMetadata, as as Github, aD as GithubOAuthWithMetadata, ap as Google, aA as GoogleOAuthWithMetadata, aw as Line, aF as LineOAuthWithMetadata, az as LinkedAccountType, at as LinkedIn, aG as LinkedInOAuthWithMetadata, aU as LoginMethodOrderOption, ae as MessageTypes, ag as MoonpayCurrencyCode, ah as MoonpayPaymentMethod, aQ as NativeFundingConfig, al as NonEmptyArray, aT as Passkey, aL as PasskeyWithMetadata, aN as Phone, an as PhoneWithMetadata, aR as PriceDisplayOptions, ai as Quantity, aV as SiwsFlowState, af as SmartWallet, ax as Telegram, aJ as TelegramWithMetadata, av as Tiktok, aE as TiktokOAuthWithMetadata, aj as TransactionLog, ak as TransactionReceipt, aO as TransactionUIOptions, aq as Twitter, aB as TwitterOAuthWithMetadata, ad as TypedMessage, ao as WalletWithMetadata } from './types-BF33BYgd.js';
+import { k as MfaSubmitArgs, c as UserRecoveryMethod, g as SessionSignerInput, E as EthereumRpcRequestType, l as SolanaRpcRequestType, m as EthereumRpcResponseType, n as SolanaRpcResponseType, o as PrivyFarcasterSignerInitResponse, p as EIP1193Provider, q as EntropyIdVerifier$1, H as HDWalletWithMetadata, r as RequestArguments, s as WalletConnector, B as BaseConnectedEthereumWallet, u as PrivyProxyProvider, v as WalletClientType, w as ConnectedWalletMetadata, x as PrivyClientConfig, y as ConnectorType, z as SetBaseAccountSdkType, A as WalletListEntry, D as AppConfig, G as BaseConnectedWallet, j as SolanaWalletConnector, U as User, I as ConnectWalletModalOptions, J as LoginModalOptions, C as CreateWalletOptions, W as Wallet, K as SetWalletRecoveryOptions, f as SignMessageModalUIOptions, N as SignTypedDataParams, M as MfaMethod, Q as UnsignedTransactionRequest, e as SendTransactionModalUIOptions, T as FundWalletConfig, V as ConnectedWallet, O as OAuthTokens, X as CrossAppProviderDetails, Y as MoonpaySignRequest, Z as MoonpaySignResponse, _ as SmartWalletConfig, $ as SiwsMessageType, L as LoginMethod, a0 as ExternalWalletMetadata, a1 as TelegramAuthResult, a2 as TelegramWebAppData, a3 as OAuthUserInfo, a4 as OAuthFlowState, a5 as LoginWithCode, a6 as OtpFlowState, a7 as PasskeyFlowState, a8 as SiweFlowState, a as LinkedAccountWithMetadata, a9 as BaseAccountSdkType, aa as UnsignedTransactionRequestWithChainId, ab as BaseConnectedWalletType, b as BaseConnectedSolanaWallet, ac as TelegramAuthFlowState } from './types-C4KyGxEF.js';
+export { au as Apple, aH as AppleOAuthWithMetadata, aP as ContractUIOptions, ay as CrossAppAccount, aK as CrossAppAccountWithMetadata, ar as Discord, aC as DiscordOAuthWithMetadata, aM as Email, am as EmailWithMetadata, aS as Farcaster, aI as FarcasterWithMetadata, as as Github, aD as GithubOAuthWithMetadata, ap as Google, aA as GoogleOAuthWithMetadata, aw as Line, aF as LineOAuthWithMetadata, az as LinkedAccountType, at as LinkedIn, aG as LinkedInOAuthWithMetadata, aU as LoginMethodOrderOption, ae as MessageTypes, ag as MoonpayCurrencyCode, ah as MoonpayPaymentMethod, aQ as NativeFundingConfig, al as NonEmptyArray, aT as Passkey, aL as PasskeyWithMetadata, aN as Phone, an as PhoneWithMetadata, aR as PriceDisplayOptions, P as PrivyErrorCode, ai as Quantity, aV as SiwsFlowState, af as SmartWallet, ax as Telegram, aJ as TelegramWithMetadata, av as Tiktok, aE as TiktokOAuthWithMetadata, aj as TransactionLog, ak as TransactionReceipt, aO as TransactionUIOptions, aq as Twitter, aB as TwitterOAuthWithMetadata, ad as TypedMessage, ao as WalletWithMetadata } from './types-C4KyGxEF.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { TurnstileProps } from '@marsidev/react-turnstile';
 import EventEmitter from 'eventemitter3';
 import { Store, EIP6963ProviderDetail } from 'mipd';
 import Privy, { Chain, RpcConfig, GenerateAuthorizationSignatureInput, GenerateAuthorizationSignatureOutput } from '@privy-io/js-sdk-core';
 export { DEFAULT_SUPPORTED_CHAINS as SUPPORTED_CHAINS, addPrivyRpcToChain, addRpcUrlOverrideToChain } from '@privy-io/js-sdk-core';
-import { PasskeyAuthenticateInputType, SmartWalletType, CustomOAuthProvider, CustomMetadataType, OAuthProviderType, PrivyCoinbaseOnRampInitInput, PrivyCoinbaseOnRampInitResponse, PrivyCoinbaseOnRampStatusResponse, PrivyTransactionScanningInputType, PrivyTransactionScanningResponseType } from '@privy-io/public-api';
+import { FirstClassChainType, PasskeyAuthenticateInputType, SmartWalletType, CustomOAuthProvider, CustomMetadataType, OAuthProviderType, PrivyCoinbaseOnRampInitInput, PrivyCoinbaseOnRampInitResponse, PrivyCoinbaseOnRampStatusResponse, PrivyTransactionScanningInputType, PrivyTransactionScanningResponseType } from '@privy-io/public-api';
 export { OAuthProviderType } from '@privy-io/public-api';
 import * as viem from 'viem';
 import { Address, HttpTransport, Hex } from 'viem';
 import * as _simplewebauthn_browser from '@simplewebauthn/browser';
 import { PublicKeyCredentialRequestOptionsJSON } from '@simplewebauthn/browser';
 import { FetchOptions } from 'ofetch';
+import { P as PrivyEvents } from './events-context-DB3Pn5Hg.js';
+export { C as CallbackError } from './events-context-DB3Pn5Hg.js';
 import * as viem_accounts from 'viem/accounts';
 import '@coinbase/wallet-sdk';
 import '@solana/kit';
@@ -364,7 +366,7 @@ type RootWalletForDelegation = {
     /** Address of the root wallet for the entropy being delegated. */
     address: string;
     /** Chain type of the root wallet for the entropy being delegated. */
-    chainType: 'ethereum' | 'solana';
+    chainType: FirstClassChainType;
     /** Whether or not the root wallet for the entropy being delegated is imported. */
     imported: boolean;
 };
@@ -372,7 +374,7 @@ type DelegatedWallet = {
     /** Address for a wallet to delegate. */
     address: string;
     /** Chain type for a wallet to delegate. */
-    chainType: 'ethereum' | 'solana';
+    chainType: FirstClassChainType;
     /** HD index for the wallet to delegate. */
     walletIndex: number;
 };
@@ -2805,330 +2807,6 @@ declare class PrivyClient {
     scanTransaction(request: PrivyTransactionScanningInputType): Promise<PrivyTransactionScanningResponseType>;
 }
 
-/**
- * `CallbackError` optionally includes a second parameter with further error details.
- */
-type CallbackError<Details extends Record<string, any> | undefined = undefined> = Details extends Record<string, any> ? (error: PrivyErrorCode, details: Details) => void : (error: PrivyErrorCode) => void;
-interface PrivyEvents {
-    login: {
-        /**
-         * Callback that will execute once a `login` flow successfully completes.
-         * - If `config.embeddedWallets.createOnLogin` is set to 'off' or a wallet creation flow is not applicable,
-         *   this will run after the user successfully authenticates.
-         * - If `config.embeddedWallets.createOnLogin` is set to 'users-without-wallets' or 'all-users',
-         *   this will run after the user successfully authenticates _and_ creates their wallet (if applicable).
-         * - If a user is already authenticated, this will run immediately and the `wasAlreadyAuthenticated` flag will be set to `true`.
-         *
-         * @param params.user {@link User} the `user` oject corresponding to the authenticated user
-         * @param params.isNewUser {boolean} boolean flag indicating if this is the user's first time logging in to your app
-         * @param params.wasAlreadyAuthenticated {boolean} - boolean flag indicating whether the user entered the application already authenticated
-         * @param params.loginMethod {string} - the method used by the user to login
-         * @param params.loginAccount - the account corresponding to the loginMethod used
-         */
-        onComplete?: (params: {
-            user: User;
-            isNewUser: boolean;
-            wasAlreadyAuthenticated: boolean;
-            loginMethod: LoginMethod | null;
-            loginAccount: LinkedAccountWithMetadata | null;
-        }) => void;
-        /**
-         * Callback that will execute in the case of a non-successful login.
-         *
-         * @param error {@link PrivyErrorCode} - the corresponding error code
-         */
-        onError?: CallbackError;
-    };
-    logout: {
-        /**
-         * Callback that will execute when a user successfully logs out.
-         */
-        onSuccess?: () => void;
-    };
-    connectWallet: {
-        /**
-         * Callback that will execute once a successful `connectWallet` completes.
-         * This will not run in the case of a wallet-based authentication or link flow.
-         *
-         * @param params.wallet {@link BaseConnectedEthereumWallet | BaseConnectedSolanaWallet} the `wallet` object correspending to the connection
-         */
-        onSuccess?: (params: {
-            wallet: BaseConnectedEthereumWallet | BaseConnectedSolanaWallet;
-        }) => void;
-        /**
-         * Callback that will execute in the case of a non-successful wallet connection.
-         *
-         * @param params.error {@link PrivyErrorCode} - the corresponding error code
-         */
-        onError?: CallbackError;
-    };
-    connectOrCreateWallet: {
-        /**
-         * Callback that will execute once a successful `connectWallet` completes.
-         * This will not run in the case of a wallet-based authentication or link flow.
-         *
-         * @param params.wallet {@link BaseConnectedEthereumWallet | BaseConnectedSolanaWallet} the `wallet` object correspending to the connection
-         */
-        onSuccess?: (params: {
-            wallet: BaseConnectedEthereumWallet | BaseConnectedSolanaWallet;
-        }) => void;
-        /**
-         * Callback that will execute in the case of a non-successful wallet connection.
-         *
-         * @param params.error {@link PrivyErrorCode} - the corresponding error code
-         */
-        onError?: CallbackError;
-    };
-    createWallet: {
-        /**
-         * Callback that will execute once on a successful embedded wallet creation.
-         * This will run when `createWallet` is called manually, or when `config.embeddedWallets.createOnLogin` triggers
-         * an automatic wallet creation.
-         *
-         * @param params.wallet {@link BaseConnectedWallet}- the created `wallet` object
-         */
-        onSuccess?: (params: {
-            wallet: Wallet;
-        }) => void;
-        /**
-         * Callback that will execute in the case of a non-successful wallet creation.
-         *
-         * @param params.error {@link PrivyErrorCode} - the corresponding error code
-         */
-        onError?: CallbackError;
-    };
-    linkAccount: {
-        /**
-         * Callback that will execute once on a successful linking of a new account/login method.
-         * This will run when any of the 'link' methods are called manually.
-         * @param params.user {@link User}- the user the account was linked to
-         * @param params.linkMethod {@link LoginMethod}- the type of linked account
-         * @param params.linkedAccount - the newly linked account
-         */
-        onSuccess?: (params: {
-            user: User;
-            linkMethod: LoginMethod;
-            linkedAccount: LinkedAccountWithMetadata;
-        }) => void;
-        /**
-         * Callback that will execute in the case of a non-successful account linking.
-         *
-         * @param error {PrivyErrorCode} - the corresponding error code
-         * @param details.linkMethod {LoginMethod} - the type of (attempted) linked account
-         */
-        onError?: CallbackError<{
-            linkMethod: LoginMethod;
-        }>;
-    };
-    update: {
-        /**
-         * Callback that will execute once on a successful updating of an account.
-         * This will run when any of the 'updateAccount' methods are called manually.
-         * @param params.user {@link User}- the user the account was linked to
-         * @param params.updateMethod {@link LoginMethod}- the type of updated account
-         * @param params.updatedAccount - the newly updated account
-         */
-        onSuccess?: (params: {
-            user: User;
-            updateMethod: LoginMethod;
-            updatedAccount: LinkedAccountWithMetadata;
-        }) => void;
-        /**
-         * Callback that will execute in the case of a non-successful account linking.
-         *
-         * @param error {PrivyErrorCode} - the corresponding error code
-         * @param details.linkMethod {LoginMethod} - the type of (attempted) linked account
-         */
-        onError?: CallbackError<{
-            linkMethod: LoginMethod;
-        }>;
-    };
-    configureMfa: {
-        /**
-         * Callback that will execute when MFA is required to complete a given action.
-         * @param params.mfaMethods {@link MfaMethod[]} - List of MFA methods that the user can choose from
-         */
-        onMfaRequired: (params: {
-            mfaMethods: MfaMethod[];
-        }) => void;
-    };
-    setWalletPassword: {
-        /**
-         * Callback that will execute once a successful `setWalletPassword` completes.
-         * @param params.wallet {@link Wallet}- the `wallet` object that the password was set for
-         */
-        onSuccess?: (params: {
-            wallet: Wallet;
-        }) => void;
-        /**
-         * Callback that will execute in the case of a non-successful setWalletPassword.
-         *
-         * @param params.error {PrivyErrorCode} - the corresponding error code
-         */
-        onError?: CallbackError;
-    };
-    setWalletRecovery: {
-        /**
-         * Callback that will execute once a successful `setWalletRecovery` completes.
-         * @param params.method {@link UserRecoveryMethod} - the recovery method that was set
-         * @param params.wallet {@link Wallet}- the wallet object that the recovery was set for
-         */
-        onSuccess?: (params: {
-            method: UserRecoveryMethod;
-            wallet: Wallet;
-        }) => void;
-        /**
-         * Callback that will execute in the case of a non-successful setWalletRecovery.
-         *
-         * @param params.error {PrivyErrorCode} - the corresponding error code
-         */
-        onError?: CallbackError;
-    };
-    signMessage: {
-        /**
-         * Callback that will execute once a successful `signMessage` completes.
-         * This will not run in the case of a wallet-based authentication or link flow.
-         * @param params.signature - the signature (type string) of the embedded wallet used to sign message
-         */
-        onSuccess?: (params: {
-            signature: string;
-        }) => void;
-        /**
-         * Callback that will execute in the case of a non-successful signMessage.
-         *
-         * @param params.error {@link PrivyErrorCode} - the corresponding error code
-         */
-        onError?: CallbackError;
-    };
-    signTypedData: {
-        /**
-         * Callback that will execute once a successful `signTypedData` completes.
-         * @param params.signature - the signature (type string) of the embedded wallet used to sign
-         */
-        onSuccess?: (params: {
-            signature: string;
-        }) => void;
-        /**
-         * Callback that will execute in the case of a non-successful signTypedData.
-         *
-         * @param params.error {@link PrivyErrorCode} - the corresponding error code
-         */
-        onError?: CallbackError;
-    };
-    sendTransaction: {
-        /**
-         * Callback that will execute once a successful `sendTransaction` completes.
-         * This will not run for transactions with external wallets.
-         * @param an object with the transaction hash
-         */
-        onSuccess?: (params: {
-            hash: `0x${string}`;
-        }) => void;
-        /**
-         * Callback that will execute in the case of a non-successful sendTransaction.
-         *
-         * @param params.error {@link PrivyErrorCode} - the corresponding error code
-         */
-        onError?: CallbackError;
-    };
-    signTransaction: {
-        /**
-         * Callback that will execute once a successful `signTransaction` completes.
-         * This will not run for transactions with external wallets.
-         * @param an object with the transaction signature
-         */
-        onSuccess?: (params: {
-            signature: `0x${string}`;
-        }) => void;
-        /**
-         * Callback that will execute in the case of a non-successful signTransaction.
-         *
-         * @param params.error {@link PrivyErrorCode} - the corresponding error code
-         */
-        onError?: CallbackError;
-    };
-    accessToken: {
-        /**
-         * Callback that will execute when a user's access token is granted.
-         * @param params.accessToken - The user's access token
-         */
-        onAccessTokenGranted: (params: {
-            accessToken: string;
-        }) => void;
-        /**
-         * Callback that will execute when a user's access token is removed.
-         */
-        onAccessTokenRemoved: () => void;
-    };
-    oAuthAuthorization: {
-        /**
-         * Callback that will execute when a user successfully authorizes an OAuth flow.
-         *
-         * @param params.oAuthTokens {@link OAuthTokens} - the OAuth tokens returned from the OAuth provider:
-         * @param params.oAuthTokens.provider - {string}  The OAuth provider type.
-         * @param params.oAuthTokens.accessToken - {string} The OAuth access token.
-         * @param params.oAuthTokens.accessTokenExpiresInSeconds - {number} (optional) The number of seconds until the OAuth access token expires.
-         * @param params.oAuthTokens.refreshToken - {string} (optional) The OAuth refresh token.
-         * @param params.oAuthTokens.refreshTokenExpiresInSeconds - {number} (optional) The number of seconds until the OAuth refresh token expires.
-         * if the refresh token is present and this field is undefined, it is assumed
-         * that the refresh token does not have an expiration date.
-         * @param params.oAuthTokens.scopes -  {string[]} (optional) The list of OAuth scopes the access token is approved for.
-         *
-         * @param params.user {@link User} The authenticated user
-         */
-        onOAuthTokenGrant: (params: {
-            oAuthTokens: OAuthTokens;
-            user: User;
-        }) => void;
-    };
-    fundWallet: {
-        /**
-         * Callback that will execute when a funding flow is exited. This fires when a user closes a funding flow modal, for any reason.
-         *
-         * @param params.address {string} The address of the wallet being funded
-         * @param params.chain {Chain} The chain of the wallet being funded
-         * @param params.fundingMethod {@link FundingMethod} The funding method associated with the flow at time of exit. If the user had not yet selected
-         * a recovery method, this will be null.
-         * @param params.balance {bigint} The value for the funded wallet at the point of user exit.
-         */
-        onUserExited?: (params: {
-            address: string;
-            chain: Chain;
-            fundingMethod: FundingMethod | 'manual' | null;
-            balance: bigint | undefined;
-        }) => void;
-    };
-    fundSolanaWallet: {
-        /**
-         * Callback that will execute when a funding flow is exited. This fires when a user closes a funding flow modal, for any reason.
-         *
-         * @param params.address {string} The address of the wallet being funded
-         * @param params.fundingMethod {@link FundingMethod} The funding method associated with the flow at time of exit. If the user had not yet selected
-         * a recovery method, this will be null.
-         * @param params.balance {bigint} The value for the funded wallet at the point of user exit.
-         */
-        onUserExited?: (params: {
-            address: string;
-            fundingMethod: FundingMethod | 'manual' | null;
-            chain: SolanaChain;
-            balance: bigint | undefined;
-        }) => void;
-    };
-    customAuth: {
-        /**
-         * Callback that will execute when Privy successfully exchanges a custom auth JWT for a Privy JWT
-         * @param params.user - The Privy user
-         */
-        onAuthenticated: (params: {
-            user: User;
-        }) => void;
-        /**
-         * Callback that will execute when Privy detects a user is logged out from the third-party auth system, and correspondingly logs the user out.
-         */
-        onUnauthenticated: () => void;
-    };
-}
-
 /**
  * Use this hook to log the user in, and to attach callbacks
  * for successful `login`s, already-`authenticated` users, and
@@ -3505,12 +3183,17 @@ type UseLoginWithSiwe = {
      * @param opts options for verifying a signature for a SIWE message
      * @param opts.signature {string}  The EIP-191 signature corresponding to the message that the user had been given.
      * @param opts.message  {string} EIP-4361 message for signing. Returned from the generateSiweMessage call
+     * @param opts.disableSignup {boolean}  (optional) whether to disable signup for the user
+     * @param opts.walletClientType {string}  (optional) the wallet client of the external wallet (ie. 'metamask', 'coinbase_wallet'). Defaults to null if not specified.
+     * @param opts.connectorType {string}  (optional) the method used to connect the wallet to the application (ie. 'injected', 'wallet_connect_v2'). Defaults to null if not specified.
      * @returns The user response object.
      */
-    loginWithSiwe: ({ signature, message, disableSignup, }: {
+    loginWithSiwe: ({ signature, message, disableSignup, walletClientType, connectorType, }: {
         signature: string;
         message: string;
         disableSignup?: boolean;
+        walletClientType?: string;
+        connectorType?: string;
     }) => Promise<User>;
     /**
      * The current state of the SIWE link operation
@@ -3537,12 +3220,17 @@ type UseLoginWithSiws = {
      * @param opts options for verifying a signature for a SIWS message
      * @param opts.signature {string}  The signature corresponding to the message that the user had been given.
      * @param opts.message  {string} SIWS message for signing. Returned from the generateSiwsMessage call
+     * @param opts.disableSignup {boolean}  (optional) whether to disable signup for the user
+     * @param opts.walletClientType {string}  (optional) the wallet client of the external wallet (ie. 'phantom', 'solflare'). Defaults to null if not specified.
+     * @param opts.connectorType {string}  (optional) the method used to connect the wallet to the application (ie. 'injected', 'wallet_connect_v2'). Defaults to null if not specified.
      * @returns The user response object.
      */
-    loginWithSiws: ({ signature, message, disableSignup, }: {
+    loginWithSiws: ({ signature, message, disableSignup, walletClientType, connectorType, }: {
         signature: string;
         message: string;
         disableSignup?: boolean;
+        walletClientType?: string;
+        connectorType?: string;
     }) => Promise<User>;
 };
 declare const useLoginWithSiws: () => UseLoginWithSiws;
@@ -4611,4 +4299,4 @@ declare const useMigrateWallets: () => {
     }>;
 };
 
-export { BaseConnectedWalletType, type CallbackError, Captcha, ConnectWalletModalOptions, ConnectedWallet, ConnectorManager, type CustomAuthFlowState, EIP1193Provider, EthereumWalletConnector, FundWalletConfig, type JwtAuthFlowState, LinkedAccountWithMetadata, LoginModal, LoginModalOptions, LoginWithCode, MfaMethod, OAuthFlowState, OAuthTokens, OtpFlowState, PasskeyFlowState, PrivyClient, PrivyClientConfig, PrivyErrorCode, type PrivyEvents, type PrivyInterface, PrivyProvider, type PrivyProviderProps, type SendCodeToEmail, type SendCodeToSms, SendTransactionModalUIOptions, SignMessageModalUIOptions, SignTypedDataParams, SiweFlowState, TelegramAuthFlowState, UnsignedTransactionRequest, type UseAuthorizationSignatureInterface, type UseBaseAccountSdkInterface, type UseConnectBaseAccountInterface, type UseConnectCoinbaseSmartWalletInterface, type UseCustomAuth, type UseDelegatedActionsInterface, type UseFundWalletInterface, type UseGetAccessTokenForProvider, type UseImportWalletInterface, type UseLinkJwtAccount, type UseLinkWithPasskey, type UseLinkWithSiws, type UseLoginWithEmail, type UseLoginWithPasskey, type UseLoginWithSiws, type UseLoginWithSms, type UseLoginWithTelegram, type UseOAuthTokens, type UseRecoverEmbeddedWalletInterface, type UseSessionSignersInterface, type UseSignupWithPasskey, type UseSubscribeToJwtAuthWithFlagInput, type UseSyncJwtBasedAuthStateInput, type UseSyncJwtBasedAuthStateInterface, type UseWalletsInterface, User, VERSION, Wallet, WalletConnector, WalletListEntry, errorIndicatesMaxMfaRetries, errorIndicatesMfaTimeout, errorIndicatesMfaVerificationFailed, getCustomerAccessToken as getAccessToken, getEmbeddedConnectedWallet, toViemAccount, useActiveWallet, useAuthMfa, useAuthMfaEnrollment, useAuthorizationSignature, useBaseAccountSdk, useConnectBaseAccount, useConnectCoinbaseSmartWallet, useConnectOrCreateWallet, useConnectWallet, useCreateWallet, useCrossAppAccounts, useCustomAuth, useDelegatedActions, useFarcasterSigner, useFundWallet, useGetAccessTokenForProvider, useGuestAccounts, useHeadlessDelegatedActions, useIdentityToken, useImportWallet, useLinkAccount, useLinkJwtAccount, useLinkWithPasskey, useLinkWithSiwe, useLinkWithSiws, useLogin, useLoginWithEmail, useLoginWithFarcasterV2, useLoginWithOAuth, useLoginWithPasskey, useLoginWithSiwe, useLoginWithSiws, useLoginWithSms, useLoginWithTelegram, useLogout, useMfa, useMfaEnrollment, useMigrateWallets, useModalStatus, useOAuthTokens, usePrivy, useRecoverEmbeddedWallet, useRegisterMfaListener, useSendTransaction, useSessionSigners, useSetWalletRecovery, useSign7702Authorization, useSignMessage, useSignTransaction, useSignTypedData, useSignupWithPasskey, useSubscribeToJwtAuthWithFlag, useSyncJwtBasedAuthState, useToken, useUpdateAccount, useUpdateEmail, useUser, useWallets };
+export { BaseConnectedWalletType, Captcha, ConnectWalletModalOptions, ConnectedWallet, ConnectorManager, type CustomAuthFlowState, EIP1193Provider, EthereumWalletConnector, FundWalletConfig, type JwtAuthFlowState, LinkedAccountWithMetadata, LoginModal, LoginModalOptions, LoginWithCode, MfaMethod, OAuthFlowState, OAuthTokens, OtpFlowState, PasskeyFlowState, PrivyClient, PrivyClientConfig, PrivyEvents, type PrivyInterface, PrivyProvider, type PrivyProviderProps, type SendCodeToEmail, type SendCodeToSms, SendTransactionModalUIOptions, SignMessageModalUIOptions, SignTypedDataParams, SiweFlowState, TelegramAuthFlowState, UnsignedTransactionRequest, type UseAuthorizationSignatureInterface, type UseBaseAccountSdkInterface, type UseConnectBaseAccountInterface, type UseConnectCoinbaseSmartWalletInterface, type UseCustomAuth, type UseDelegatedActionsInterface, type UseFundWalletInterface, type UseGetAccessTokenForProvider, type UseImportWalletInterface, type UseLinkJwtAccount, type UseLinkWithPasskey, type UseLinkWithSiws, type UseLoginWithEmail, type UseLoginWithPasskey, type UseLoginWithSiws, type UseLoginWithSms, type UseLoginWithTelegram, type UseOAuthTokens, type UseRecoverEmbeddedWalletInterface, type UseSessionSignersInterface, type UseSignupWithPasskey, type UseSubscribeToJwtAuthWithFlagInput, type UseSyncJwtBasedAuthStateInput, type UseSyncJwtBasedAuthStateInterface, type UseWalletsInterface, User, VERSION, Wallet, WalletConnector, WalletListEntry, errorIndicatesMaxMfaRetries, errorIndicatesMfaTimeout, errorIndicatesMfaVerificationFailed, getCustomerAccessToken as getAccessToken, getEmbeddedConnectedWallet, toViemAccount, useActiveWallet, useAuthMfa, useAuthMfaEnrollment, useAuthorizationSignature, useBaseAccountSdk, useConnectBaseAccount, useConnectCoinbaseSmartWallet, useConnectOrCreateWallet, useConnectWallet, useCreateWallet, useCrossAppAccounts, useCustomAuth, useDelegatedActions, useFarcasterSigner, useFundWallet, useGetAccessTokenForProvider, useGuestAccounts, useHeadlessDelegatedActions, useIdentityToken, useImportWallet, useLinkAccount, useLinkJwtAccount, useLinkWithPasskey, useLinkWithSiwe, useLinkWithSiws, useLogin, useLoginWithEmail, useLoginWithFarcasterV2, useLoginWithOAuth, useLoginWithPasskey, useLoginWithSiwe, useLoginWithSiws, useLoginWithSms, useLoginWithTelegram, useLogout, useMfa, useMfaEnrollment, useMigrateWallets, useModalStatus, useOAuthTokens, usePrivy, useRecoverEmbeddedWallet, useRegisterMfaListener, useSendTransaction, useSessionSigners, useSetWalletRecovery, useSign7702Authorization, useSignMessage, useSignTransaction, useSignTypedData, useSignupWithPasskey, useSubscribeToJwtAuthWithFlag, useSyncJwtBasedAuthState, useToken, useUpdateAccount, useUpdateEmail, useUser, useWallets };

package/dist/dts/internal.d.mts

@@ -0,0 +1,44 @@
+import { U as User } from './types-C4KyGxEF.js';
+import '@coinbase/wallet-sdk';
+import '@simplewebauthn/browser';
+import '@solana/kit';
+import 'react';
+import 'viem';
+import '@privy-io/js-sdk-core';
+import '@privy-io/public-api';
+import '@base-org/account';
+import '@wallet-standard/base';
+import '@solana/wallet-standard-features';
+import '@wallet-standard/features';
+import 'eventemitter3';
+
+type UseLoginWithSsoToken = {
+    /**
+     * Authenticates a user by exchanging an SSO token for a session.
+     *
+     * This hook implements a secure code exchange flow where the token
+     * is exchanged server-side for a session response. This prevents exposing
+     * access tokens in URLs.
+     *
+     * @returns Promise resolving to the authenticated User
+     * @example
+     * ```typescript
+     * const {loginWithSsoToken} = useLoginWithSsoToken();
+     *
+     * // In your SSO callback page:
+     * await loginWithSsoToken();
+     * ```
+     *
+     * @experimental
+     */
+    loginWithSsoToken: () => Promise<User>;
+};
+/**
+ *
+ * Hook to authenticate a user using an SSO token.
+ *
+ * @experimental
+ */
+declare function useLoginWithSsoToken(): UseLoginWithSsoToken;
+
+export { type UseLoginWithSsoToken, useLoginWithSsoToken };

package/dist/dts/internal.d.ts

@@ -0,0 +1,44 @@
+import { U as User } from './types-C4KyGxEF.js';
+import '@coinbase/wallet-sdk';
+import '@simplewebauthn/browser';
+import '@solana/kit';
+import 'react';
+import 'viem';
+import '@privy-io/js-sdk-core';
+import '@privy-io/public-api';
+import '@base-org/account';
+import '@wallet-standard/base';
+import '@solana/wallet-standard-features';
+import '@wallet-standard/features';
+import 'eventemitter3';
+
+type UseLoginWithSsoToken = {
+    /**
+     * Authenticates a user by exchanging an SSO token for a session.
+     *
+     * This hook implements a secure code exchange flow where the token
+     * is exchanged server-side for a session response. This prevents exposing
+     * access tokens in URLs.
+     *
+     * @returns Promise resolving to the authenticated User
+     * @example
+     * ```typescript
+     * const {loginWithSsoToken} = useLoginWithSsoToken();
+     *
+     * // In your SSO callback page:
+     * await loginWithSsoToken();
+     * ```
+     *
+     * @experimental
+     */
+    loginWithSsoToken: () => Promise<User>;
+};
+/**
+ *
+ * Hook to authenticate a user using an SSO token.
+ *
+ * @experimental
+ */
+declare function useLoginWithSsoToken(): UseLoginWithSsoToken;
+
+export { type UseLoginWithSsoToken, useLoginWithSsoToken };

package/dist/dts/smart-wallets.d.mts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import react__default from 'react';
-import { a as SendTransactionModalUIOptions, b as SignMessageModalUIOptions } from './types-BF33BYgd.js';
+import { e as SendTransactionModalUIOptions, f as SignMessageModalUIOptions } from './types-C4KyGxEF.js';
 import { SmartAccountClient } from 'permissionless';
 import { EIP1193Provider, Chain, PublicClient, HttpTransport, WalletClient, PaymasterRpcSchema, SendTransactionParameters, Hash, SignableMessage, Hex, TypedData, SignTypedDataParameters } from 'viem';
 import { SmartAccount, SendUserOperationParameters } from 'viem/account-abstraction';

package/dist/dts/smart-wallets.d.ts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import react__default from 'react';
-import { a as SendTransactionModalUIOptions, b as SignMessageModalUIOptions } from './types-BF33BYgd.js';
+import { e as SendTransactionModalUIOptions, f as SignMessageModalUIOptions } from './types-C4KyGxEF.js';
 import { SmartAccountClient } from 'permissionless';
 import { EIP1193Provider, Chain, PublicClient, HttpTransport, WalletClient, PaymasterRpcSchema, SendTransactionParameters, Hash, SignableMessage, Hex, TypedData, SignTypedDataParameters } from 'viem';
 import { SmartAccount, SendUserOperationParameters } from 'viem/account-abstraction';

package/dist/dts/solana.d.mts

@@ -1,11 +1,12 @@
-import { c as SessionSignerInput, W as Wallet, b as SignMessageModalUIOptions, S as SolanaChain, d as SolanaStandardWallet, C as CreateWalletOptions, a as SendTransactionModalUIOptions, e as SolanaFundingConfig } from './types-BF33BYgd.js';
-export { f as SolanaAdapterConnector, t as toSolanaWalletConnectors } from './types-BF33BYgd.js';
+import { g as SessionSignerInput, W as Wallet, f as SignMessageModalUIOptions, S as SolanaChain, h as SolanaStandardWallet, C as CreateWalletOptions, e as SendTransactionModalUIOptions, i as SolanaFundingConfig } from './types-C4KyGxEF.js';
+export { j as SolanaAdapterConnector, t as toSolanaWalletConnectors } from './types-C4KyGxEF.js';
 import { SolanaSignAndSendTransactionFeature, SolanaSignTransactionFeature, SolanaSignMessageFeature } from '@solana/wallet-standard-features';
 import { WalletAccount, WalletIcon, WalletVersion } from '@wallet-standard/base';
 import { StandardConnectFeature, StandardDisconnectFeature, StandardEventsFeature } from '@wallet-standard/features';
 import EventEmitter from 'eventemitter3';
 import { SolanaSignAndSendTransactionOptions, SolanaSignTransactionOptions, ConnectedStandardSolanaWallet } from '@privy-io/js-sdk-core';
 export { ConnectedStandardSolanaWallet } from '@privy-io/js-sdk-core';
+import { P as PrivyEvents } from './events-context-DB3Pn5Hg.js';
 import '@coinbase/wallet-sdk';
 import '@simplewebauthn/browser';
 import '@solana/kit';
@@ -17,8 +18,7 @@ import '@base-org/account';
 interface UseImportWalletInterface {
     /**
      * Imports a private key to be used as an embedded wallet for the user
-     * This method will error if the user already has an imported wallet or if they
-     * exit in the middle of the flow.
+     * This method will error if the user exits in the middle of the flow.
      *
      * @param o Input object
      * @param o.privateKey The base58 private key of the solana wallet to import
@@ -288,11 +288,35 @@ type UseSignAndSendTransaction = {
 };
 declare function useSignAndSendTransaction(): UseSignAndSendTransaction;
 
-declare function useFundWallet(): {
+/**
+ * Method to fund a user's Solana wallet via Privy's funding feature by inputting a valid wallet address.
+ * You can access the fields and methods documented here via the {@link useFundWallet} hook.
+ */
+interface UseFundWalletInterface {
+    /**
+     * Prompt the user to go through the funding flow and for a specified Solana wallet.
+     *
+     * This will open the modal with a prompt for the user to select a funding method (if multiple are enabled).
+     *
+     * Once the user continues to the funding flow, Privy will display the funding status screen, and wait
+     * for the transaction to complete.
+     *
+     * Note: Even after a successful funding, funds can take a few minutes to arrive in the user's wallet.
+     *
+     * @param address The wallet address to fund
+     * @param options {@link SolanaFundingConfig} Funding configuration to specify chain and funding amount
+     */
     fundWallet: ({ address, options, }: {
         address: string;
         options?: SolanaFundingConfig;
     }) => Promise<void>;
-};
+}
+/**
+ * Hook to fund a Solana wallet via Privy's fiat on-ramp integration given the wallet address.
+ *
+ * @param callbacks.onUserExited {@link PrivyEvents} Callback that will execute when a funding flow is exited. This fires when a user closes a funding flow modal, for any reason.
+ * @returns fundWallet - function to on-ramp funds to any given Solana wallet
+ */
+declare function useFundWallet(callbacks?: PrivyEvents['fundSolanaWallet']): UseFundWalletInterface;
 
-export { PrivyStandardWallet, SolanaFundingConfig, SolanaStandardWallet, type UseImportWalletInterface, type UseSignAndSendTransaction, type UseSignMessage, type UseSignTransaction, type UseSolanaStandardWalletsInterface as UseStandardWallets, type UseWallets, useCreateWallet, useExportWallet, useFundWallet, useImportWallet, useSignAndSendTransaction, useSignMessage, useSignTransaction, useSolanaFundingPlugin, useSolanaLedgerPlugin, useSolanaStandardWallets as useStandardWallets, useWallets };
+export { PrivyStandardWallet, SolanaFundingConfig, SolanaStandardWallet, type UseFundWalletInterface, type UseImportWalletInterface, type UseSignAndSendTransaction, type UseSignMessage, type UseSignTransaction, type UseSolanaStandardWalletsInterface as UseStandardWallets, type UseWallets, useCreateWallet, useExportWallet, useFundWallet, useImportWallet, useSignAndSendTransaction, useSignMessage, useSignTransaction, useSolanaFundingPlugin, useSolanaLedgerPlugin, useSolanaStandardWallets as useStandardWallets, useWallets };