React changelog

​

Improvements

• Update @privy-io/js-sdk-core to 0.52.3

​

Improvements

• Update @reown/appkit to 1.7.11
• Update @privy-io/js-sdk-core to 0.52.2

​

Improvements

• Update useConnectWallet to show all supported wallets from WalletConnect
• Support authentication with Line
• Automatically close CAPTCHA after success
• Update @privy-io/js-sdk-core to 0.52.1

​

Improvements

• Add new useUpdateEmail hook to headlessly update users email addresses.
• Add description field to connectWalletModalOptions, deprecate suggestedAddress
• Update @abstract-foundation/agw-client to 1.8.5
• Update @privy-io/js-sdk-core to 0.52.0

​

Improvements

• Update @privy-io/js-sdk-core to 0.51.1

The chainType property under linked accounts of type: “wallet” now includes additional values in the union. This type union should always be considered open to expansion, as new chains are supported. Learn more about chain support.

​

Improvements

• Adds a new /extended-chains entrypoint for working on chains supported at the Tier 2 level.
  • Adds the useCreateWallet hook for creating a new wallet on extended chains.
  • Adds the useSignRawHash hook for signing a raw hash along the blockchain’s cryptographic curve.
• Adds the useAuthorizationSignature hook for generating an authorization signature on Privy API request payloads.
• Update kernel metafactory usage to be optional.
• Deprecate useSignAuthorization in favor of useSign7702Authorization.
• Expanded the linked account types to include additional chains in linked wallets.
• Update @privy-io/js-sdk-core to 0.51.0

​

Improvements

• Fix bug when displaying message to sign
• Add Bridge USDC funding
• Update dependencies for viem and others
• Support eoa actions in eth wallet hooks
• Update @privy-io/js-sdk-core to 0.50.11

​

Improvements

• Update @privy-io/js-sdk-core to 0.50.10

​

Improvements

• Improve error messages
• Update @privy-io/js-sdk-core to 0.50.9

​

Improvements

• Allow WalletConnect appkit to be passed into the PrivyProvider
• Update @privy-io/js-sdk-core to 0.50.8

​

Bug Fixes

• Fix uncaught MFA canceled error

​

Improvements

• Update @privy-io/js-sdk-core to 0.50.7

​

Improvements

• Update @privy-io/js-sdk-core to 0.50.6

​

Improvements

• Adjusts the wording in the ‘Export wallet’ UI
• Update @privy-io/js-sdk-core to 0.50.5

​

Improvements

• Add endPartnerName to Coinbase OnRamp URL
• Update @privy-io/js-sdk-core to 0.50.4

​

Improvements

• Adjusts the wording in the ‘Export wallet’ UI
• Allow for chainId of 0 to be used to sign 7702 authorization signatures
• Expose a new useLinkJwtAccount hook.
• Update @privy-io/js-sdk-core to 0.50.3

​

Improvements

• Improve error message around wallet creation
• Add WalletConnect to Solana auto-connect
• Expose linkPasskey on useLinkAccount hook
• Add wallet signature and RPC timeout update
• Allow Coinbase wallet config to pass parameters through into Coinbase SDK
• Update js-sdk-core to 0.50.2

​

Bug Fixes

• Fetch wallets information from WalletConnect even if it was disabled

​

Other Changes

• Support export for unified wallets

​

Improvements

• Add new library for ethereum utils
• Fix bug blocking use of imported wallets
• Fix WalletConnect auto-prompt
• Fix social oauth method selection
• Bugfix: correctly clear disableSignup flag during OAuth flow
• Update js-sdk-core to 0.50.1

​

Improvements

• Add useSolanaStandardWallets hook for wallet standard Solana wallets
• Fix bug for all detected wallets in the useSolanaWallets wallets array
• Enable Ledger Solana authentication via useSolanaLedgerPlugin hook
• Add policies to addSessionSigners
• Undeprecate useDelegatedActions and useHeadlessDelegatedActions
• Update js-sdk-core to 0.50.0

​

Improvements

• Add the useSessionSigners hook and deprecate useDelegatedActions and useHeadlessDelegatedActions
• Update js-sdk-core to 0.48.3

​

Improvements

• Update js-sdk-core to 0.48.2

​

Improvements

• Decode Raydium and Jupiter swap instructions
• Update paymaster sponsored check for smart wallets
• Reduce console warnings caused by styled-components
• Set USDC token when reading manual funding QR code
• Add support for headless SIWE
• Update js-sdk-core to 0.48.1

​

Improvements

• Improve Solana instruction decoding and UIs
• Solana USDC onramp
• Update js-sdk-core to 0.48.0

​

Improvements

• Update js-sdk-core to 0.47.3

​

Improvements

• Update Wallet Connect dependencies
• Allow for custom block explorer URLs for solana clusters
• Add Binance to wallet list
• Update js-sdk-core to 0.47.2

​

Bug Fixes

• Fix transaction preparation errors for batch transactions that succeed

​

Improvements

• Update js-sdk-core to 0.47.1

​

Bug Fixes

• Fix bug where signature requests from a wrapped ethers provider threw an error
• Update background color of warning on receive funds screen
• Improve Solana transaction UI

​

Bug Fixes

• Fix bug where signatures were not being returned from headless signTransaction or sendTransaction calls

​

Bug Fixes

• Fix @solana/web3.js expected in main bundle
• Fix key export for apps with color-scheme: dark set in their CSS
• Fix email entry flashing all login methods when options are passed to useLogin

​

Improvements

• Improve ready flag from useWallets for unauthenticated states
• Remove WalletConnect fetch when WalletConnect is not used
• Update js-sdk-core to 0.46.4

​

Bug Fixes

• Fix gas/nonce bug for Ethereum transactions
• Fix UI bug for Solana transactions involving ATA instructions

​

Improvements

• Internal improvements
• Update js-sdk-core to 0.46.3

​

Bug Fixes

• Support creating Solana wallets without Ethereum when user owned recovery is required
• Fix UI issue where ERC20 amount was not set

​

Improvements

• Update external transfer currency symbol to better reflect the asset
• Consolidate chain definitions across Privy JavaScript SDKs
• Update js-sdk-core to 0.46.2
• Update chains to 0.0.1

​

Experimental interfaces

• Update signAuthorization from useSignAuthorization with latest interface from viem

​

Improvements

• Improve gas estimation logic for ZeroDev bundlers
• Improve error message when operation fails due to missing Buffer implementation
• Memoize wallets from useSolanaWallets

​

Bug Fixes

• Fix bug where Solana key export would return the users’ Ethereum wallet private key
• Fix issue where Solana wallet was not set on user after auto-create
• Pin @solana/wallet-adapter-base to 0.9.23 to fix incompatibility with node 18

​

Bug Fixes

• Fix bug where solana wallets ready flag is never set to true

​

Improvements

• Add Haha wallet to walletlist
• Add useConnectOrCreateWallet and support attaching callbacks
• Update @privy-io/js-sdk-core to 0.46.0

​

Bug Fixes

• Fix a recovery but when using Solana HD wallets at indices greater than 0
• Remove usage of zustand/traditional

​

Other Changes

• Minor internal improvements

​

Improvements

• Update wallet connect copy

​

Bug Fixes

• Fix bug with Coinbase Wallet QR authentication
• Fix bug blocking modal close when solana plugin cannot be loaded

​

Improvements

• Support Solana wallet auto-creation set in dashboard
• Update @privy-io/js-sdk-core to 0.44.4

​

Bug Fixes

• Fix funding amount breaking when input amount is not valid

• Remove session forking logic

​

Improvements

• Add signAllTransactions method for Solana wallets
• Add SignerAccount to the user object
• Update @privy-io/js-sdk-core to 0.44.3

​

Bug Fixes

• Fix showWalletUIs for smart wallets
• Fix overriding the priceDisplay config for funding

​

Other Changes

• Allow UI customization for funding with manual transfers
• Minor internal improvements

​

Improvements

• Add Ronin wallet to the walletList config
• Update bridging flow to be more resilient to slippage

​

Bug Fixes

• Fix issue where Solana signTransaction would error if the user did not have sufficient funds
• Fix issue where uiOptions weren’t safely parsed in the sign message screen

​

Other Changes

• Fetch wallet metadata from the WalletConnect registry

​

Improvements

• Update @walletconnect/ethereum-provider version to ^2.18.0
• Update @walletconnect/modal version to ^2.7.0
• Add id to embedded wallet account on user object for delegated actions

​

Bug Fixes

• Fix wallets not auto-connecting in mobile
• Resolve issue for signing with HD Solana wallets

​

Other Changes

• Show Ronin wallet in WalletConnect dialog
• Throw error if invalid address passed to exportWallet

​

Improvements

• Support passkey as a valid option in loginMethods

​

Bug Fixes

• Fix issue for SMS when using useLoginMethodsAndOrder
• Fix issue where headless delegation wouldn’t work unless primary wallet was recovered

​

Other Changes

• Minor internal improvements

​

Bug Fixes

• Fix an issue with getAccessToken causing unnecessary re-renders

​

Other Changes

• Bump @coinbase/wallet-sdk to 4.3.0

​

Improvements

• Update bridging flow to poll Relay API to determine if bridging failed and funds were refunded
• Add support for headless Telegram login
• Add useSignMessage hook for Solana
• Add credentialsId option to useLoginWithPasskey
• Update docstring for user.wallet

​

Bug Fixes

• Fix Solana transaction screen to correctly take uiOptions from sendTransaction and signTransaction methods
• Ensure refreshUser method does not recalculate on rerender
• Fix issue where Phantom would respond to eth_accounts requests to non-Phantom wallets

​

Improvements

• Add ability to filter wallets by chain type for login/linking
• Add getClientForChain method to the useSmartWallets hook
• Add useSignTransaction for Solana embedded walelts
• Add headless passkey signup
• Add isCancellable UI to send transaction screen

​

Bug Fixes

• Fix EVM WalletConnect issue
• Fix bug for HD wallet creation

​

Other Changes

• Internal smart wallet improvements around chain ID

​

Improvements

• Add support for automatic embedded Solana wallet creation on login
• Add support for ThirdWeb smart accounts
• Add support for signing raw data with smart wallets

​

Bug Fixes

• Fix issue where an error was thrown if a Solana transaction instruction could not be parsed
• Fix issue where an “Insufficient funds” error was thrown if a Solana transaction didn’t contain a latestBlockhash
• Fix issue where EVM transaction preparation would error if transaction.type was passed as a hexadecimal string instead of number

​

Other Changes

• Reinitialize wallet connectors where config.appearance.walletList prop changes

​

Improvements

• Update js-sdk-core to 0.41.4

​

Bug Fixes

• Fix createWallet call in headless oncomplete callbacks
• Fix issue where Rabby was not switching or adding an app’s default chain during connect/login flows
• Fix issue where a Solana wallet could not be delegated if the user had both Ethereum and Solana embedded wallets and created the Ethereum wallet first

​

Other Changes

• Mobile connectors for Solflare, Backpack and OKX
• Allow to only connect a wallet deeplinking into a wallet’s app in-app browser
• Auto connect Solana wallets when shouldAutoConnect: true without prompting user for permission
• Hide QR codes from some automated screen capture tools

​

Improvements

• Update js-sdk-core to 0.41.2

​

Other Changes

• Minor internal improvements

​

Bug Fixes

• Fix some overflow login options not rendering properly

​

Improvements

• Improve QR code in receive funds flow

​

Bug Fixes

• Fix signature requests bug for CBSW

​

Other Changes

• Allow keeping a passkey linked when unenrolling from MFA

​

Improvements

• Add useUser hook
• Support setting passkey (login and signup) as the only enabled login method
• Improve solana connectors detection

​

Bug Fixes

• Fix bug where message/typed data signatures for cross app flows did not respect the smart wallets chain

​

Other Changes

• Allow keeping a passkey enrolled in MFA when unlinking
• Allow Moonpay funding for Avalanche and Celo chains

​

Improvements

• Improve icons on account transfer flow

​

Bug Fixes

• Fix bug where disableSignUp is not respected after login is retried
• Fix ready flag from useSolanaWallets

​

Improvements

• Add support for disableSignup on SIWS flows

​

Bug Fixes

• Fix issue with walletIndex on Solana wallets

​

Improvements

• Improve transaction UIs for SPL transfers on Solana
• Update passkey unenrollment in MFA to automatically unlink the passkey as well
• Update useIdentityToken hook to work with HTTPOnly cookies

​

Bug Fixes

• Fix issue with creating an embedded wallet when signing up with passkey
• Fix error handling with OAuth and passkey whitelabel login
• Fix embedded wallet gas estimation to include from address in estimation query
• Fix bug with creating an Ethereum wallet after Solana in the same React tick

​

Other Changes

• Hide password input on password recovery screens

​

Improvements

• Update MFA verification on unenrollment to prompt earlier
• Update js-sdk-core to 0.38.0

​

Bug Fixes

• Resolves issues with useSolanaWallets where ready was never true, and embedded wallets were not being returned
• Fix wallet creation when called in quick succession

​

Improvements

• Update callback interfaces to an object instead of positional arguments
• Update interfaces for signMessage, signTypedData, and sendTransaction
• Add UIs for signTransaction

​

Bug Fixes

• Fix Telegram link when captcha is enabled

​

Other Changes

• Move solana specific hooks to the @privy-io/react-auth/solana import path
• Remove getEthersProvider and getWeb3jsProvider interfaces

​

Improvements

• Add support for custom uiConfig on smart wallet request methods
• Improve Transaction UIs for Solana SPL token instructions
• Update js-sdk-core to 0.37.1

​

Other Changes

• Allows account transfer flows to work when linking Telegram seamlessly

​

Improvements

• Add support for signing up with passkey
• Add support for seamless Telegram linking
• Add useIdentityToken hook for fetching the identity token client-side

​

Bug Fixes

• Fix funding config to accept viem Chain objects
• Ensure embedded Solana wallets are recovered as needed when signTransaction is invoked

​

Other Changes

• Show separate “To” and “Token address” fields for ERC20 transfers
• Export PrivyErrorCode, LinkedAccountWithMetadata, and LinkedAccountType types
• Allow for Zustand 5.0.0 to support integrations with wagmi

​

Improvements

• Add solana key private importing
• Update js-sdk-core to 0.36.1

​

Other Changes

• Adjust ordering of embedded wallets for custom landing screen

​

Bug Fixes

• Fix bug where linkWallet would only prompt a connection flow

​

Improvements

• Add useLoginToFrame hook to log into Farcaster frames v2
• Updated dependencies [2c3e469] - @privy-io/[email protected]

​

Bug Fixes

• Fix Embedded wallet not found error sending Solana transactions

​

Improvements

• Adds support for Solana HD wallets
• Update Solana funding to respect provider configured RPC URL
• Update js-sdk-core to 0.35.6

​

Bug Fixes

• Fix issue where newer apps could not use the config.embeddedWallets.waitForTransactionConfirmation property to disable awaiting transaction confirmation
• Fix funding amount input font-size

​

Improvements

• Update additional embedded wallet creation to prompt MFA if required
• Update copy in UI for delegating an embedded wallet
• Add ability to edit amount to bridge/transfer in wallet funding flows

​

Bug Fixes

• Fix issue where certain package managers required @solana/web3.js to be installed as a peer dependency even if not using Solana functionality.
• Fix issue where pregenerated Telegram accounts would error during login

​

Other Changes

• Introduce useSolanaPlugin hook. If your app uses the fundWallet method to fund EVM wallets using cross-chain bridging from a Solana wallet, make sure to import and mount the useSolanaPlugin hook during any funding flows:
• Show “Solana” chip in connected wallets button

​

Improvements

• Add empty wallet states for no detected connected wallets

​

Bug Fixes

• Fix issue where USDC balance was misformatted in manual transfer funding flow
• Fix issue where Solana transaction screen would sometimes show token address under “Pay with” field

​

Bug Fixes

• Fix issue where sendTransaction would not work with funding configurations

​

Improvements

• Add support for USDC SOL->EVM cross-chain bridging
• Add one-click funding configuration option (app.fundingConfig.defaultFundingMethod) to send users directly into funding flow.
• Add support for configuring preferred provider for card funding.
• Add WalletsDialog and useActiveWallet support for connectors
• Improve stability for setting identity token to cookies
• Update js-sdk-core to 0.35.3

​

Bug Fixes

• Fix link on “download Phantom” screen

​

Improvements

• Support arbitrary programs for Solana transactions
• Add solanaClusters field to PrivyProvider config for setting custom RPC URLs for Solana

​

Bug Fixes

• Fix issue where sendTransaction would error if the app didn’t have funding methods enabled

​

Improvements

• Add icons for wallet balance in transfer flow
• Improve UserPill dividers
• Expose LinkedAccountWithMetadata type
• Expose ready value from useSolanaWallets hook

​

Other Changes

• Show Continue button in Manual funding after funds are received
• Pin @solana/web3.js to ^1.95.8

​

Improvements

• Add support for using root domain for passkeys
• Add functionality to user pill to export solana wallets, export HD eth wallet, and fund a specific wallet
• Add Phantom wallet button for browsers with no wallets on Solana
• Add support for bigints in transactions via cross app connect
• Update js-sdk-core to 0.35.1

​

Bug Fixes

• Fix coinbase bundler/paymaster gas estimation issues

​

Other Changes

• Warn on wallets not ready for turbopack

​

Improvements

• Add fallback for funding with an alternate provider

​

Bug Fixes

• Fix bug bridging to EVM from a Solana wallet

​

Improvements

• Update funding flows - support Apple Pay
• Update session management logic
• Add support for new Crypto.com extension
• Add support for headless passkey linking

​

Bug Fixes

• Fix typesVersions for node10 resolution

​

Improvements

• Add ethereum support to useDelegatedActions hook
• Update language on delegated actions modal
• Add cross app buttons to login modal

​

Bug Fixes

• Fix telegram seamless login
• Fix error when sendTransaction is called with an imported wallet

​

Other Changes

• Show a warning when solana is enabled in the dashboard but not configured properly on the client
• Log out users who have not yet accepted legal terms when require affirmative consent is set

​

Improvements

• Add support for delegated actions on EVM networks

​

Improvements

• Improve manual transfer screen of funding flow
• Update @headlessui/react to 2.2.0
• Update js-sdk-core to 0.34.0

​

Bug Fixes

• Fix OAuth callback not firing during login flow
• Fix Solana key export when MFA is enabled

​

Improvements

• Update session token storage
• Update typing for AuthenticatedUser
• Support user owned recovery for Solana embedded wallets
• Update js-sdk-core to 0.33.0

​

Other Changes

• Release useDelegatedActions hook
• Allow existing users with + emails to log in even if app has disable creation of new users with + emails
• Bump multiplier for smart wallet gas estimation
• Move permissionless to be an optional peer dependency

​

Improvements

• Add support for creating ethereum HD wallets at any index
• Improve session update logic

​

Improvements

• Update js-sdk-core to 0.31.0

​

Bug Fixes

• Fix issue where logging out would attempt to link smart wallets

​

Other Changes

• Minor internal improvements

​

Improvements

• Improve error banner UI on dark mode
• Add disableSignup option to headless login hooks
• Add paymaster context config for Alchemy and Biconomy paymasters
• Update delegated actions modal styles

​

Bug Fixes

• Fix bug where recently used wallet was missing in the login wallet list

​

Improvements

• Add secondary color option to UserPill button

​

Bug Fixes

• Fix issue with parsing user response from Privy API

​

Other Changes

• Show “Maximum” as the amount for ERC20 approvals if the amount being improved is the maximum value of uint256
• Use direct imports for heroicons

​

Improvements

• Update user object to include delegatedWallets field
• Update js-sdk-core to 0.30.1

​

Bug Fixes

• Fix transaction details not updating for batched smart wallet calls

​

Improvements

• Add support for the Coinbase Smart Wallet as a smart wallet implementation
• Update all Solana package imports to be dynamic
• Add CSS selectors to login buttons

​

Other Changes

• Show verified wallet details during Farcaster account merging flow

​

Improvements

• Add switchChain to SmartWalletClient
• Update type of wallet in connectWallet callbacks to be BaseEthereumConnectedWallet or BaseSolanaConnectedWallet
• Update js-sdk-core to 0.29.3

​

Other Changes

• Downgrade console warning to debug for eth_accounts

​

Improvements

• Improve colors for UserPill button text

​

Bug Fixes

• Fix build output of types
• Fix issue where certain builds would break if @solana/web3.js optional peer dependency was not installed
• Fix custom auth error when logged in as a stale user and switching to a new user

​

Other Changes

• Fetch setting for whether plus emails are disabled when fetching app configuration

​

Improvements

• Add support for funding EVM wallets by bridging from an external Solana wallet
• Add loading state to UserPill
• Upgrade permissionless peer dependency to 0.2.10 to improve stability of counterfactual smart wallet address determination

​

Improvements

• Add support for wallet MFA with Solana embedded wallets
• Add support for funding Solana wallets by bridging from an external EVM wallet
• Add support for exporting HD wallets beyond the wallet at index 0

​

Bug Fixes

• Fix issue with wallet funding where an error UI would be shown if user exited Coinbase Onramp too early
• Fix issue with wallet funding where incorrect token symbol was shown in manual transfer screen for Polygon
• Fix issue with attempting to connect to Phantom’s injected EVM provider if the walletChainType for the app is set to 'solana-only'

​

Improvements

• Add support for funding Solana wallets via transfer from external wallet, Coinbase Onramp, and MoonPay
• Update ConnectedSolanaWallet object to have wallet helpers like signMessage always be defined, and throw an error if unsupported by the underlying wallet
• Improve smart wallet gas estimation by using Pimlico public client for Pimlico bundlers
• Add new error code for disallowed + emails
• Update icons and copy for MFA and passkey flows

​

Bug Fixes

• Fix issue with Coinbase Onramp where an error would be shown if user exited Onramp flow too quickly

​

Improvements

• Add bybit_wallet to walletList options
• Add callbacks for updatePhone and updateEmail through the useUpdateAccount hook
• Update js-sdk-core to 0.28.8

​

Other Changes

• Allow for configuration of showing/hiding of transaction UIs per transation/signature via uiOptions.showWalletUIs
• Allow server side wallet UIs to be overridden by client side config via config.embeddedWallets.showWalletUIs

​

Improvements

• Add support for customizing the icon on the UserPill

​

Bug Fixes

• Fix issue where smart wallet linking would cause the onComplete callback not to fire
• Ensure correct asset symbol is shown in fund via manual transfer screen
• Fix CAPTCHA in Telegram seamless auth

​

Improvements

• Add minimal version of UserPill with only primary account info and logout button

​

Bug Fixes

• Ensure Solana wallets are recovered during sign transaction flow

​

Other Changes

• Allow an Ethereum embedded wallet to be created for a user with a Solana embedded wallet
• Optimize “Protected by Privy” asset size

​

Improvements

• Update logos for rebrand
• Update js-sdk-core dependency to 0.28.5

​

Bug Fixes

• Fix: Sign Solana transaction using the embedded wallet address instead of from address
• Fix Solana Phantom wallet option to appear as “Phantom” in the wallet list

​

Improvements

• Update docstring of appearance.walletList to include correct coinbase_wallet instead of coinbase
• Add detected_ethereum_wallets and detected_solana_wallets as supported WalletListEntry values
• Update js-sdk-core dependency to 0.28.4

​

Bug Fixes

• Fix bug calling signTypedData with imported wallets

​

Other Changes

• When apps explicitly pass defaultChain/supportedChains and the chains are already supported by Privy, only override the RPC URL to use the internal Privy RPC instead of replacing entire chain representation

​

Improvements

• Add onComplete/onError callbacks to headless auth hooks
• Improved custom auth authentication handling
• Support integers and booleans in customMetadata

​

Bug Fixes

• Fix error waiting for response after sending transaction

​

Improvements

• Update login method transfer UIs
• Add useLoginWithPasskey hook
• Add state to whitelabel auth flows
• Add universal profile to wallet_list options
• Improve Solana embedded wallet creation
• Update User pill recently used account logic
• Improve smart wallet transaction logic and UIs
• Improve funding network selector UI
• Update styled-components dependency to v6.1.13
• Update build outputs and package.json#exports property to match modern patterns

​

Improvements

• Add optional config prop for SmartWalletsProvider that allows for paymasterContext to be set
• Update js-sdk-core dependency to 0.28.1

​

Bug Fixes

• Fix display of decimal token values on transaction screens

​

Other Changes

• Allow for login method transfers
• Show solana transactions breakdown
• Solana annotations for docs

​

Improvements

• Add support for connecting external Solana wallets via toSolanaWalletConnectors
• Add support for login/linking external Solana wallets
• Add new external wallets config options to set Solana connectors
• Add transaction UIs for Solana embedded wallet transactions
• Add useSendSolanaTransaction hook

​

Improvements

• Add smart wallets SDK (@privy-io/react-auth/smart-wallets) with support for native account abstraction features
• Improve Celo chain icon

​

Bug Fixes

• Fix captcha on headless sms and email login hooks

​

Other Changes

• Hide the “Add funds” button on the UserPill if funding is not enabled

​

Bug Fixes

• Fix background color of warning on export screen in light modes
• Handle connected vs logged in state better in UserPill component
• Fix bridging flow gas estimation issues

​

Improvements

• Add support for passing a disableSignup flag to login to distinguish between login and sign-up
• Add support for fetching USDC funding configuration from the Dashboard
• Update Polygon’s MATIC gas token to POL

​

Bug Fixes

• Fix issue where headless OAuth callbacks did not fire correctly
• Fix issue where client-side funding configuration was ignored if chain was not set

​

Other Changes

• Make suggested address copyable-on-click on connect and link wallet strings

​

Improvements

• Add loginWithCrossAppAccount to useCrossAppAccounts hook
• Add support for using multiple HD embedded wallets per user in the useWallets array (including EIP1193 provider support and ethers/viem/wagmi support) and Privy’s native signMessage, signTypedData, and sendTransaction methods
• Add support for configuring the walletList to display in Privy’s connection prompt directly in connectWallet
• Update js-sdk-core dependency to 0.26.7

​

Bug Fixes

• Fix loading to correctly be false for error states on headless OAuth login

​

Improvements

• Add support for additional Ethereum embedded wallet creation at HD indices that are not 0
• Add useCustomAuth hook

​

Improvements

• Support funding wallets with USDC from MoonPay and Coinbase Onramp

​

Bug Fixes

• Fix bug where CJS builds threw SyntaxError: Unexpected identifier...
• Ensure Twitter login always shows up on mobile if enabled
• Ensure a destination currency is always set when funding via external transfer for ERC20s
• Ensure Coinbase Onramp amount is properly formatted with a leading digit

​

Other Changes

• Silence expected errors when fetching Relay quotes on chains where an address has no balance

​

Bug Fixes

• Fix chain definition for Base

​

Improvements

• Add ability to fund from external wallet with ERC20 tokens in addition to a chain’s native token
• Add onComplete and onError callbacks for headless OAuth login

​

Bug Fixes

• Fix issue where copy on key export screen was not legible in dark mode

​

Other Changes

• Export UserPill component to display user account and wallet information

​

Improvements

• Add ability to pre-fill either phone number or email on login UI
• Add onComplete and onError callbacks for third-party auth login
• Update js-sdk-core dependency to 0.26.2

​

Other Changes

• Pin @walletconnect/ethereum-provider to 2.15.1 or higher to avoid breaking change introduced in 2.15.0
• Send Telegram start_param in authenticate request payload

​

Bug Fixes

• Fix issue where native asset token price could not be fetched for chains not configured in supportedChains during bridging flow
• Fix issue where onUserExited callback for useFundWallet hook did not fire if there was an error
• Fix visual bug on transaction screen when transaction amount overflows the modal

​

Improvements

• Support Telegram authentication with mini-app direct link
• Add support for exporting imported and Solana wallets

​

Other Changes

• Allow users to bridge from another network when funding with an external wallet

• Remove deprecated chains from default supported chains
• Remove Solana embedded wallet on logout

​

Improvements

• Add 'safe' as an option for appearance.walletList configuration option

​

Bug Fixes

• Fix Spotify and Instagram not showing up in upfront login methods
• Fix Uniswap extension login method not showing up

​

Other Changes

• Strip URL hash after successful Telegram seamless login
• fix issue with setting client cookies on Safari on localhost
• allow enter to submit embedded wallet password

​

Bug Fixes

• Fix issue with misaligned loading spinner during Farcaster login flow
• Fix client-side checks for whether OAuth authentications should be treated as login vs. linking

​

Other Changes

• Allow Telegram linking without surfacing it as an upfront login method

​

Improvements

• Update loginWithTelegram to always login instead of link, regardless of initial auth state
• Add Solana mainnet chain ID to Solana embedded wallet in user.linkedAccounts

​

Bug Fixes

• Fix issue with linkWithSiwe for linking smart accounts to user object
• Fix allow list error screen to show custom error messages configured by developers
• Fix issue where Ethereum and Solana embedded wallets could not be created in the same React tick
• Fix occasional error with invalid to address when funding via external wallets (e.g. MetaMask)

​

Other Changes

• Gracefully handle maximum wallets linked error when linking wallets via SIWE
• Allow connectOrCreate to be called even if users already have connected wallets
• Block embedded wallet transaction submission until transaction has been fully prepared
• Fail fast in insecure contexts (e.g. http) with a clear error message
• Ignore gasPrice during transaction preparation on EIP-1559 chains where that parameter is not supported (OP Stack, Polygon)

​

Improvements

• Add support for guest accounts
• Add missing error for when setWalletRecovery flow is exited from the selection screen
• Update js-sdk-core dependency to 0.26.0

​

Bug Fixes

• Fix bug where external funding flow fails when using fundWallet from useFundWallet hook
• Fix copy on wallet creation recovery method selection screen

​

Improvements

• Improve QR code scannability

​

Improvements

• Add seed phrase export for embedded ethereum wallets
• Update js-sdk-core dependency to 0.25.0

​

Other Changes

• Clean up imports for icons
• Minor internal improvements

​

Bug Fixes

• Fix parameters for updatePhone flow

​

Improvements

• Add updatePhone flow for updating user phone numbers
• Add lukso to default supported chains

​

Bug Fixes

• Fix Uniswap wallet logo on mobile

​

Other Changes

• Minor internal improvements

​

Improvements

• Update js-sdk-core dependency

​

Improvements

• Add signature UI for Solana embedded wallets
• Update border radius on funding method icons

​

Bug Fixes

• Fix issue with dark mode in funding UIs

​

Improvements

• Add Coinbase Onramp as a funding option
• Support user editing of default funding value
• Improve funding UIs
• Add callback for fundWallet flow

​

Other Changes

• Return identity token to end user’s browser

​

Improvements

• Add “Telegram” text to Telegram login button
• Update the default connection setting for Coinbase Wallet to be 'all' (smart wallet and extension/mobile wallet) instead of 'eoaOnly' (extension/mobile wallet only)

​

Other Changes

• Extend timeout for embedded wallet iframe to 20s to handle resource-constrained environments like TMAs

​

Improvements

• Add external wallet funding flow and new server-side funding configuration options
• Add login modal indicator for recently used login method
• Update transaction request UI
• Support overriding login methods at the point of login

​

Bug Fixes

• Fix broken back button in NextJS Pages app
• Fix bug where non-injected wallets did not show up on connect wallet screen

​

Bug Fixes

• Fix occasional issue where embedded wallet transaction modal would infinitely load when used with ethers

• Deprecate PrivyProvider onSuccess prop
• Remove app logo from connect-only screen

​

Improvements

• Add user as argument to onOAuthTokenGrant callback handler
• Add linkMethod details to onError callback for useLinkAccount
• Improve transaction UI currency formatting

​

Improvements

• Update farcaster signer to not be experimental with useFarcasterSigner

​

Bug Fixes

• Fix bug where wallet login fails if there is an existing stale non-siwe auth flow

​

Other Changes

• UI tweaks on signature request screen

• Remove WalletConnect fallback when externalWallets.walletConnect.enabled is set to false

​

Improvements

• Add vanityName to LinkedInOAuthWithMetadata interface
• Improve errors for transacting against a read-only provider app

​

Bug Fixes

• Fix Twitter OAuth from within a cross-app auth flow
• Fix login modal not reopening after logout

​

Improvements

• Add experimental externalWalletConfig.walletConnect.enabled

​

Other Changes

• Cross-app wallets
• Exodus mobile wallet fix
• Crypto.com walet extension fix
• Embedded wallet transaction fix due to address case mismatch
• UI tweaks

​

Improvements

• Improve account already linked error for email and SMS linking
• Improve insufficient funds error on transaction flows - Add chain name
• Improve Coinbase Wallet connection experience for PWAs using eoaOnly mode - No longer open in Coinbase Wallet in-app browser
• Add unlinkCrossAppAccount to useCrossAppAccounts hook
• Support returning OAuth provider tokens via useOAuthTokens hook
• Add headless wallet linking via useLinkWithSiwe hook
• Add new suggestedAddress parameter to connectWallet and linkWallet

​

Other Changes

• Bump WalletConnect to v2.13.3 to avoid metadata validation breaking change
• Minor build improvements

​

Improvements

• Add cross-app account linking and wallet requests via useCrossAppAccounts hook
• Improve OTP code resend experience
• Improve loading and success state for signature screen
• Improve error state for social login
• Improve login error callbacks
• Upgrade Coinbase Wallet SDK to 4.0.3

​

Other Changes

• add iconUrl option to signMessage and signTypedMessage

​

Improvements

• Add support for Telegram seamless authentication

​

Other Changes

• Pre-emptively block Google login in more in-app browsers where it is expected to fail (LinkedIn, Coinbase Wallet, MetaMask, etc.)

​

Improvements

• Add useSetWalletRecovery hook to set user-managed recovery methods for embedded wallets
• Add getEmbeddedConnectedWallet helper to parse useWallets array for the embedded wallet

​

Bug Fixes

• Fix issue with Twitter login on Android due to x.com deeplinks not working
• Fix issue with recalculating nonce when retrying a failed transaction
• Fix typo in passkey enrollment screen

• Deprecate goerli and polygon mumbai chains

​

Improvements

• Upgrade @walletconnect/ethereum-provider to 2.13.1, fixes Error: description is required value in metadata error introduced by WalletConnect
• Add config.appearance.loginMessage interface for setting a custom subtitle below logo
• Add blast to OP-Stack gas estimation
• Improve error handling around wallet connector initialization

​

Improvements

• Add support for Coinbase’s Smart Wallet

​

Bug Fixes

• Fix issue with signatures not working when wallet address is not checksummed

​

Improvements

• Add support for resetting password via setPassword
• Add mfaMethods to useMfa hook

​

Other Changes

• Fire connectWallet’s onSuccess/onError callbacks whenever a wallet is connected, including during login with SIWE
• Retry JSON-RPC requests used to load connected wallets to handle flaky injected providers on page load
• Reduce noisy console warnings

​

Improvements

• Improved errors for embedded wallet gas estimation

​

Other Changes

• Minor improvements to refresh token storage

​

Improvements

• Add embedded wallet recovery via iCloud

​

Other Changes

• Telegram link/unlink
• Make Farcaster QR code more scannable
• Throw more accurate error when gas estimation fails

​

Improvements

• Improve error UI for SMS login
• Add console warning for gas estimation failure
• Add console warning for message signing failures

​

Improvements

• Add rabby_wallet as a walletList option
• Improve error UI for embedded wallet transactions

​

Bug Fixes

• Fix Twitter and Github logos on dark mode

• Remove dynamic import of CB wallet SDK, fixes issues around connection persisting across refresh and tabs

​

Improvements

• Add scroll to login overflow screen when there are greater than 5 options
• Update ready from useWallets to respect external wallet loading state

​

Other Changes

• Use Privy RPC endpoints for mainnet

​

Improvements

• Add instagram to supported loginMethods
• Add new Farcaster write interfaces to useExperimentalFarcasterSigner

​

Improvements

• Add passkeys as an option for transaction MFA
• Improve customization of transaction modal via successHeader and successDescription
• Update ready from useWallets hook to only correspond to embedded wallet loading state
• Update transaction error UIs

​

Improvements

• Add Google Drive as an embedded wallet recovery option

• Deprecate Redstone Holesky and add Redstone Mainnet + Garnet Holesky

​

Improvements

• Add linked account to callback of useLinkAccount and useLogin hooks
• Update copy on set password screen to emphasize that loss of password and device will mean loss of the wallet
• Improve MFA enrollment loading state for TOTP
• Add firstVerifiedAt and latestVerifiedAt, deprecate verifiedAt field on account objects
• Add config.appearance.landingHeader prop to allow customization of login modal header text

​

Other Changes

• Use Privy RPC endpoints for Berachain Artio

​

Improvements

• Improve OAuth provider errors

​

Other Changes

• Read server config flags on createWallet
• Bump mipd dependency from 0.0.5 to 0.0.7

​

Improvements

• Update gas estimation to prioritize including the from address

​

Other Changes

• Avoid auto-closing login modal when access token is deleted from storage

​

Bug Fixes

• Fix SDK authenticated and user state when access token is cleared

​

Other Changes

• Minor internal improvements

​

Improvements

• Add Polygon Amoy Privy RPC endpoints
• Improve request retry logic

​

Bug Fixes

• Fix edge case when signing in with multiple Coinbase wallets
• Fix bug preventing Passkey retries due to browser user intent requirements

​

Other Changes

• Visual adjustments for Passkey login and link

​

Improvements

• Expose status of login flow from useLoginWithSms hook

​

Bug Fixes

• Fix issue with headless login where link was called when login should be

• Remove extra redirect prompt during sign in with external wallets

​

Improvements

• Add login with passkey (configurable via Dashboard)
• Add support for BSC and Sapphire transactions when using wagmi
• Improve user limit reached sign-in error

​

Bug Fixes

• Fix focus outline on phone number and email inputs

​

Other Changes

• Disable wallet link in CBW
• Don’t show login modal when awaiting ready and already authenticated

​

Improvements

• Add support for Berachain Artio

​

Improvements

• Add IDs to modal content and backdrop
• Update gas estimation to support ERC20 contracts that require a .from parameter

​

Other Changes

• Pin Coinbase Wallet SDK to 3.9.3

​

Improvements

• Update storage location for OAuth and PKCE

​

Bug Fixes

• Ensure transaction type gets defaulted even if gas fees are manually set by developer - Note this interface is experimental and may change in a future update

​

Other Changes

• Disable switchChain prompt on wallet login if supportedChains are set without a defaultChain
• Extend Polygon gas estimation logic to Amoy testnet
• Change copy on transaction status screen
• Show app name instead of “Privy” in Coinbase Wallet during connect flow
• [experimental] Support writes to farcaster via useExperimentalFarcasterSigner hook

​

Improvements

• Improve sign in with Farcaster redirect on iOS

​

Bug Fixes

• Fix “cannot dequeue event” console errors

​

Improvements

• Improve consistency of ‘Take me to Warpcast’ button
• Update OAuth query param removal to use replace instead of push
• Add support for Polygon Amoy testnet out of the box

​

Bug Fixes

• Fix bug where users are prompted to SIWE repeatedly after selecting a wallet login
• Fix bugs related to repeated clicks on OAuth login buttons

​

Other Changes

• Dependencies: update jose from 4.14.6 to 4.15.5

​

Improvements

• Update signTypedData handler to only default EIP712Domain type if not specified by caller
• Improve handling around embedded wallet creation errors
• Update RPC endpoints for some testnets

​

Bug Fixes

• Fix cookie-based session restoration on new subdomain

​

Bug Fixes

• Fix phantom installation screen: reload after confirming installation
• Fix ready from useWallets when phantom is in walletList

​

Improvements

• Improve text padding on password inputs
• Improve gas limit estimation with retries
• Add useLinkAccount callback method

​

Bug Fixes

• Fix bug where MFA methods are stale

​

Improvements

• Add new options to appearance.walletList: cryptocom, uniswap, and okx_wallet
• Expose useFundWallet to fund external wallets
• Update gas estimation logic
• Update config to override appearance.walletList with loginMethodsAndOrder if defined
• Improve consistency of placeholder phone numbers
• Update coinbase wallet SDK

​

Bug Fixes

• Fix ready from useWallets not getting set to true
• Fix wallets array not updating after disconnecting Coinbase Wallet

​

Other Changes

• Mark library as side effect free
• Reduce and improve console warnings on app startup

​

Improvements

• Expose useFundWallet to fund external wallets

​

Bug Fixes

• Fix ready from useWallets not getting set to true

​

Other Changes

• Reduce and improve console warnings on app startup

​

Improvements

• Add Spotify OAuth Integration
• Add connectOrCreateWallet
• Add update email flow
• Improve session refresh logic

​

Other Changes

• Error state styling improvements

​

Bug Fixes

• Fix an issue causing OAuth logins to fail

​

Improvements

• Improve dialog accessibility

​

Other Changes

• Minor improvements to SDK initialization
• Minor copy updates

​

Improvements

• Add signTypedData and associated UIs
• Add name to TikTok account interface
• Add documentation about Twitter Profile Picture image size
• Add useSetWalletPassword callback function
• Improve error handling on createWallet

​

Bug Fixes

• Handle Twitter account suspended errors

• Deprecate noPromptOnSignature. You should now set this configuration in the Dashboard.

​

Bug Fixes

• Ensure Twitter login is disabled by mobile on default due to issues with Twitter OAuth on mobile. You can override this setting in the Dashboard.

​

Other Changes

• Tree-shake friendly icon imports

​

Improvements

• Update check for whether a wallet is linked or not to handle exported embedded wallets
• Update WalletConnect to not specify required chains namespaces unless a defaultChain is explicitly set
• Update ConnectedWallet object with more WalletWithMetadata

​

Bug Fixes

• Fix bug with password-based recovery in exportWallet method
• Fix spacing on OAuth status screen

​

Improvements

• Add Twitter profilePictureUrl to user object. Existing users must login with Twitter again to have their profile picture fetched.
• Update docstring for config.loginMethods

​

Bug Fixes

• Fix “Try again?” CTA on Farcaster error screen to take user back to QR code

​

Other Changes

• With Google OAuth, pre-emptively direct users out of in-app browsers as Google OAuth is blocked in in-app browsers. Read more.
• Check that wallet has sufficient funds to cover gas in addition to value for transactions
• Dramatically improve initial modal load by optimizing wallet connector initializations
• Rename developer “console” to “dashboard”

• Remove copy link on farcaster loading screen

​

Improvements

• Enable automatic wallet creation for Farcaster login
• Update captcha view styles
• Improve Sign in with Farcaster link opening

​

Other Changes

• Disable captcha challenge if the user is already authenticated
• Disable clicking outside to close Privy modal on unrecoverable screens
• Rename profile_picture to profile_picture_url

​

Improvements

• Improve captcha challenge timing

​

Other Changes

• Rename farcaster_id to fid for consistency
• Export Farcaster account on User object (user.farcaster)

​

Improvements

• Add sign-in with Farcaster. Please use version 1.55.1 to consume the most updated interfaces.
• Add privyWalletOverride to Chain type for overriding RPC urls
• Update useWallets to throw when used outside of PrivyProvider

​

Other Changes

• Style updates to various SVG elements

​

Improvements

• Add intermediary screen for CAPTCHA
• Improve wallet timeout error handling

​

Bug Fixes

• Fix issue with crypto utils compatibility
• Fix outline bug for status icons on dark mode

​

Other Changes

• Disable retries on 429s

​

Improvements

• Improve error handling for social login buttons

​

Other Changes

• Use browser friendly crypto utils

​

Bug Fixes

• Fix issue with dialog z-index
• Fix OAuth connecting screen delay after redirect
• Fix issue with Coinbase Wallet not showing as a “detected wallet” when omitted from the walletList

​

Other Changes

• OAuth authentication protocol upgrade

​

Improvements

• Improve accessibility and compatibility of the Privy modal
• Update defaultChain and supportedChains types to handle viem’s updated Chain type

​

Bug Fixes

• Fix issue where Phantom wallet button would not always show

​

Improvements

• Add captcha support for SIWE and OAuth logins
• Add default support for Base Sepolia, Optimism Sepolia, and Zora Sepolia and handle them as OP Stack chains
• Improved handling when dialog is not supported (more coming in subsequent release)

​

Bug Fixes

• Fix wallet images on mobile

​

Other Changes

• Set privy-session client cookie when not using server cookies

​

Bug Fixes

• Ensure MFA only happens once for key export
• Fix visual bug with key export triggered with MFA

​

Improvements

• Add ready interface to useWallets
• Add onAccessTokenGranted and onAccessTokenRemoved callbacks for access tokens

​

Other Changes

• Minor bugfixes

​

Improvements

• Add helper function errorIndicatesMfaCanceled to determine if a wallet error was due to MFA cancellation

​

Bug Fixes

• Fixes issue where Safari autofill would sometimes appear over invisible inputs

​

Improvements

• Add a console.warn message when opening MFA modal in headless mode

​

Bug Fixes

• Ensure BSC transactions are marked as type: 0 since BSC is not EIP-1159-compatible
• Fix handling of unsupported region errors for SMS login and MFA
• Fix visual issue with scrollbars on export wallet button

​

Improvements

• Improve default estimation of maxPriorityFeePerGas for OP Stack chains

​

Bug Fixes

• Ensure connections stored in memory are synchronized with local storage

​

Other Changes

• Error immediately if an unauthenticated user calls a link- method, instead of after the linking user flow
• When connecting to MetaMask mobile via WalletConnect, remove request to switch chain to the app’s defaultChain due to MetaMask’s flaky handling of wallet_switchEthereumChain RPC

​

Improvements

• Add support for MFA on Embedded Wallet transactions
• Add walletList configuration to PrivyProvider
• Improve image loading on send transaction screen
• Update embedded wallet export screen UI

​

Bug Fixes

• Fix typo on Moonpay on-ramp screen
• Fix disabled state for insufficient funds on send transaction screen

​

Improvements

• Improve WalletConnect integration
• Expose modal visibility state via useModalStatus

​

Bug Fixes

• Fix MetaMask in cases where it is not EIP-6963 injected

​

Improvements

• Add support for wallets injected via EIP-6963
• Add support for wallets injected via legacy window.etherum as “Browser Extension”
• Add rainbow as a default supported wallet
• Improve Arbitrum gas estimation.
• Update SMS country code selector for better consistency
• Update icons for continue with email/sms on landing screen

​

Bug Fixes

• Fix broken scroll within WalletConnect modal

​

Other Changes

• Better focus state for email and phone number inputs
• Social login buttons no longer disabled after going back on browser
• Modal interactions no longer blocked when opening on top of Radix UI modal

​

Bug Fixes

• Fix issue where transaction prompt can unexpectedly load twice
• Handle WalletConnect re-pairing attempts better

• Remove default border from login modal
• Remove letter support in PIN screens

​

Improvements

• Update copy for email and sms login

​

Bug Fixes

• Fix Zerion wallet
• Fix OAuth linking init URL when cookies are enabled
• Fix infinite loader on login screen bug

​

Other Changes

• Login onComplete callback includes login method
• Country code selector for phone numbers

​

Improvements

• Add explicit support for Rainbow browser extension wallet
• Add out-of-the-box support for Holesky (L1) and Holesky Redstone (L2)
• Add warnings for unsupported/not recommended login configurations in loginMethods
• Improve deeplinking with MetaMask app on mobile web

​

Bug Fixes

• Fix console.warnings related to WalletConnect
• Fix issue around displayed gas estimates for OP Stack chains
• Fix issue with showWalletLoginFirst login configuration being ignored
• Fix icons and fonts on mobile login screen

​

Other Changes

• Bump @coinbase/wallet-sdk dependency
• Display email/social buttons on landing screen if only one email/social option
• Underline “Follow this guide” link on the exportWallet screen

​

Improvements

• Enable additional configurations for loginMethods: - Email and SMS at the same time - Social only - Greater than 5 social login options
• Update OP stack gas estimates and fix gas used calculation
• New Modal UI, try it out on our live demo

​

Bug Fixes

• Fix error message on signMessage screen

​

Other Changes

• Design improvements on login modal

​

Improvements

• Add support for unenrolling MFA methods
• Support Arbitrum Sepolia testnet out of the box
• Upgrade from the legacy UIs to use @walletconnect/modal

​

Bug Fixes

• Fix infinite polling on key export
• Fix issue where ready was not properly set on return from OAuth redirects

​

Improvements

• Add cancel helper to the useMfa hook

​

Other Changes

• Extend captcha timeout

• Remove create external wallet prompt from home screen

​

Improvements

• Add TOTP support for MFA

​

Bug Fixes

• Ensure developer-set gasLimit is always respected

​

Other Changes

• Pull WalletConnect image from peer
• Changed twitter logo to X logo

​

Bug Fixes

• Ensure correct RPC URLs are used
• Fix bug with logout retries
• Fix bug around unrecognized parameters in transactions populated by third-party SDKs

​

Improvements

• Add support for Base and BNB with fiat onramp

• Remove email and phone connect input tip

​

Improvements

• Add MFA retry logic
• Add out-of-the-box support for Zora and Zora Goerli Testnet
• Add config to enable/disable whether USD prices are shown in the embedded wallet transaction modal

​

Bug Fixes

• Fix email and phone input placeholder color
• Fix transaction receipt button margin
• Fix modal close firing multiple times

​

Improvements

• Add password masking controls to embedded wallet password flows

​

Other Changes

• Show error message for automatic wallet creation
• Embedded wallet password confirmation type to “password”

​

Improvements

• Add config for resolving tx after submission

​

Bug Fixes

• Ensure wallet proxy is explicitly loaded in signature request modal

​

Improvements

• Enable SMS-based transaction MFA enrollment and verification

​

Bug Fixes

• Fix bug around prompting external wallets to switch chain on connection
• Ensure correct chain ID is used during SIWE

​

Improvements

• Enable configuration of RPC timeout duration for specific wallets

• Deprecate WalletWithMetadata.chainId in favor of BaseConnectedWallet.chainId

​

Bug Fixes

• Handle Rainbow Wallet browser extension’s hijacking of the MetaMask injected provider
• Handle numeric eth_chainId responses from WalletConnect wallets
• Fix precision of Polygon and Polygon Mumbai gas fees to avoid underflow errors
• Fix bug around casting chainId from ethers to number
• Fix embedded wallet creation after OAuth by waiting for iframe to load

​

Other Changes

• Allow SDK to send transactions even if USD prices cannot be fetched

​

Improvements

• Improve error message when wallet attempts to take action on an unsupported chain

​

Other Changes

• Use new set password flow when setting a password during wallet creation

​

Improvements

• Update contents of “Download Password” file
• Improve UX of set password flow

​

Improvements

• Improve user flow for setting a password on the embedded wallet
• Add network configuration via supportedChains and defaultChain

​

Other Changes

• Extend support for TikTok login

​

Improvements

• Add LinkedIn OAuth to Social Logins

​

Bug Fixes

• Fix chain-specific block explorer links for the embedded wallet transaction details screen

​

Bug Fixes

• Fix signMessage to support multiple calls in sequence

​

Improvements

• Add button roles to login sections for screen reader visibility

​

Bug Fixes

• Fix password strength value not updating on generate

​

Other Changes

• Small design adjustments

​

Other Changes

• Copy changes in wallet password and recovery flows
• Do not generate initial value for wallet password form

​

Improvements

• Upgrade wallet recovery from short passcodes to support full passwords

​

Other Changes

• Prevent closing embedded wallet password flow until password has been saved and confirmed
• Bump @walletconnect/ethereum-provider version to 2.10.1

​

Improvements

• Support setting a password on an existing wallet using setWalletPassword

​

Improvements

• Add callbacks for createWallet

​

Bug Fixes

• Ensure signMessage and sendTransaction throw appropriate errors when user declines request
• Ensure Coinbase Wallet receives wallet_addEthereumChain RPC when necessary
• Fix status of ready upon returning from OAuth redirect
• Fix recovery for cookie-only sessions

​

Other Changes

• Allow Twitter login on mobile, despite unresolved Twitter OAuth bug
• Tweak documentation exports

​

Improvements

• Update handling of fundWalletConfig parameter in sendTransaction

​

Improvements

• Add support for configuring the SDK with additional chains from @wagmi/chains

​

Improvements

• Improve wallet address formatting on key export screen
• Improve logo spacing on connectWallet modal
• Update fiat on-ramp copy

​

Other Changes

• When using Coinbase Wallet on mobile, pass user back and forth between browser and wallet apps instead of using the wallet’s in-app browser

​

Improvements

• Add support for MoonPay Fiat On-Ramp plugin

​

Other Changes

• Move towards using static JSON-RPC providers

​

Bug Fixes

• Fix behavior of onClose callback for transaction screen if user clicks outside the modal
• Fix issue with switchChain caching the wallet’s original chain on page load
• Handle Zerion Wallet’s hijacking of the MetaMask injected provider

​

Improvements

• Add support for using embedded wallets with a custom auth provider
• Add a shim for eth_requestAccounts RPC for the embedded wallet

​

Improvements

• Add optional support for turnstile CAPTCHA

​

Bug Fixes

• Fix broken link on “What is a wallet?”

​

Other Changes

• Make all fields in ContractUIOptions config optional
• Persist the embedded wallet’s chain ID across browser sessions

​

Improvements

• Add support for Linea
• Improve styling for Safari PWAs
• Improve messaging for embedded wallet insufficient funds
• Improve styling on when loading on mobile

​

Bug Fixes

• Fix issue with gas estimation

​

Improvements

• Improve price display for transactions
• Improve handling of zero-value transactions

​

Improvements

• Add wallet.switchChain, which works across external and embedded wallets
• Update Phantom logo
• Improve error handling when attempting to login when already authenticated
• Add support for Celo and Avalanche

​

Other Changes

• Further improvements to sendTransaction UI customization

​

Improvements

• Add Base support

• Removed iframe message target specification

​

Improvements

• Update OAuth allow list rejection handling
• Improved handshake between Privy SDK and iframe
• Improved interfaces for transaction UI Customizations

​

Other Changes

• Tightened login modal design

​

Improvements

• Update “Learn more about wallets” hyperlink

​

Bug Fixes

• Fix sizing of connect wallet modal when no logo is set

​

Improvements

• Add Sepolia support

​

Bug Fixes

• Fix issue with app logo vertical spacing

​

Bug Fixes

• Resolve issue connecting to the embedded wallet when using cookies

​

Other Changes

• Launch the wallet recovery flow when requesting actions through the embedded EIP-1193 provider

​

Improvements

• Add loading state during embedded wallet creation

​

Bug Fixes

• Fix race condition when fetching the nonce for SIWE
• Fix issue where an embedded wallet would be created on login but the UI would hang
• Fix an issue where walletProvider was sometimes undefined when checking if connected

​

Other Changes

• Narrow iframe messaging target

• Remove AbortSignal.timeout (not supported in iOS < 16)

​

Improvements

• Add a short delay before signing with MetaMask with WalletConnect to bypass issues with chain switching (awaiting upstream resolution)
• Support signing UInt8Array messages
• Add headless sendTransaction
• Add embedded wallet support for eth_signTypedData_v4

​

Bug Fixes

• Fix inconsistent modal sizing bugs
• Fix issue with wallet recovery flow for non-pinless wallets during headless message signing

​

Bug Fixes

• Fix authenticated connect-only screen
• Resolve issues with duplicate create embedded wallet calls
• Fix issue with MetaMask wallet address not matching
• Fix an issue with wallet loginOrLink
• Fix sendTransaction modal issue with non-Ethereum chains

​

Other Changes

• Reduce SDK log chattiness
• Fail fast when trying to link accounts for which there can only be one (sms, email, socials)
• Increase default request timeout
• Increase default request retries

​

Improvements

• Update WalletConnect dependencies to fix reliability issues

• Remove dependency on crypto.randomUUID()

​

Improvements

• Updates WalletConnect providers to support more JSON RPC methods

​

Bug Fixes

• Fix bug where signature requests would hang indefinitely on React 17

​

Improvements

• Updates WalletConnect to support Privy’s supported networks
• Updates WalletConnect to clear sessions faster on logout calls
• Updates the z-index of Privy modals to be arbitrarily high so that it is not hidden by any app UIs

​

Bug Fixes

• Fix useWallets hook to properly listen to user-triggered disconnects from MetaMask

​

Bug Fixes

• Fix an issue where not depending on @walletconnect/modal would require build failures in certain build environments

​

Other Changes

• Load only WalletConnect v2-compatible wallets in the mobile modal. This also resolves paging overflow on mobile

​

Improvements

• Add support for Celo (mainnet and Alfajores testnet), FVM (mainnet and Calibration testnet), and Base (Goerli testnet)

​

Bug Fixes

• Fix local development issue where React strict-mode duplicates calls to create embedded wallets
• Fix UI issues related to embedded wallet gas estimation

​

Other Changes

• Migrate WalletConnect from v1.0 to v2.0.
• Store wallet client information (MetaMask, Coinbase Wallet, Rainbow, etc.) used when connecting Ethereum accounts

​

Improvements

• Add support for embedded wallet creation without requiring the user to set a PIN/passcode
• Update wallet_switchEthereumChain to match standardized params

​

Bug Fixes

• Fix issue with linking/login from the wallets array
• Fix issue where cookies weren’t being properly set

​

Other Changes

• Set client-side cookies alongside our localStorage tokens for local development/testing purposes

​

Bug Fixes

• Fix some issues with gas estimation
• Fix issue where the wallets array wasn’t getting properly updated

​

Other Changes

• Switch from axios to ofetch

​

Bug Fixes

• Fixes related to connect-only support
• Resolved an issue causing performance problems for pages with the PrivyProvider loaded

​

Other Changes

• wallets interface improvements

• Deprecate setActiveWallet, getEthereumProvider, getEthersProvider, getWeb3jsProvider in favor of wallets array methods

​

Improvements

• New wallets array interface

​

Bug Fixes

• Fix WalletConnect chain switching

​

Other Changes

• Connect-only support

​

Bug Fixes

• Fix issue where signMessage contents did not respect newlines
• Fix an issue with internal modal rendering

​

Other Changes

• Decrease package size
• Help circumvent issue with Phantom not supporting certain chains

​

Improvements

• Improved recovery when sending a transaction to the EIP1193 provider
• Improved visuals on low dollar amounts in embedded wallet transactions

​

Other Changes

• Internal rendering mechanism improvements

​

Other Changes

• EIP-1193 provider for embedded wallets
• Preliminary cookie support

​

Bug Fixes

• Fix ethereum object checking
• Fix an issue with client-side config checking for apps with only wallet login

​

Other Changes

• Properly clear query params during session transfer to in-app browsers (resolves an issue where a refresh of the page would show the signing modal again)

​

Improvements

• Improve error handling related to Phantom extension window.ethereum hijacking
• Improved client-side login config error handling and warnings

​

Bug Fixes

• Fix an issue where attempting to sign in with smart contract wallets would show an incorrect error

​

Improvements

• Add support for client-side configuration of modal ordering, ToS & Privacy Policy, supported login methods
• Support setting logo using img and svg elements
• Add support for submitting transactions using embedded wallets

​

Bug Fixes