Skip to main content


The release notes for our react-auth SDK.


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


  • Login onComplete callback includes login method
  • Fix Zerion wallet
  • Fix OAuth linking init URL when cookies are enabled
  • Remove default border from login modal
  • Fix infinite loader on login screen bug
  • Update copy for email and sms login
  • Remove letter support in PIN screens
  • Country code selector for phone numbers


  • 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
  • Fix console.warnings related to WalletConnect
  • Fix issue around displayed gas estimates for OP Stack chains
  • Bump @coinbase/wallet-sdk dependency

UI Changes

  • Fix issue with showWalletLoginFirst login configuration being ignored
  • Fix icons and fonts on mobile login screen
  • Display email/social buttons on landing screen if only one email/social option
  • Underline "Follow this guide" link on the exportWallet screen


  • Design improvements on login modal
  • 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
  • Fix error message on signMessage screen

UI Changes


  • Add support for unenrolling MFA methods
  • Support Arbitrum Sepolia testnet out of the box
  • Upgrade from the legacy UIs to use @walletconnect/modal
  • Fix infinite polling on key export
  • Fix issue where ready was not properly set on return from OAuth redirects


  • Add cancel helper to the useMfa hook


  • Extend captcha timeout


  • Add TOTP support for MFA
  • Ensure developer-set gasLimit is always respected

UI Changes

  • Remove create external wallet prompt from home screen
  • Pull WalletConnect image from peer
  • Changed twitter logo to X logo


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


  • Add support for Base and BNB with fiat onramp


  • Fix email and phone input placeholder color
  • Remove email and phone connect input tip
  • Add MFA retry logic
  • Fix transaction receipt button margin
  • Add out-of-the-box support for Zora and Zora Goerli Testnet
  • Fix modal close firing multiple times
  • Add config to enable/disable whether USD prices are shown in the embedded wallet transaction modal


  • Add password masking controls to embedded wallet password flows


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


  • Add config for resolving tx after submission
  • Ensure wallet proxy is explicitly loaded in signature request modal


  • Enable SMS-based transaction MFA enrollment and verification
  • Fix bug around prompting external wallets to switch chain on connection
  • Ensure correct chain ID is used during SIWE


  • Enable configuration of RPC timeout duration for specific wallets


  • Allow SDK to send transactions even if USD prices cannot be fetched
  • 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
  • Deprecate WalletWithMetadata.chainId in favor of BaseConnectedWallet.chainId


  • Use new set password flow when setting a password during wallet creation
  • Improve error message when wallet attempts to take action on an unsupported chain


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


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


  • Extend support for social logins


  • Add LinkedIn OAuth to Social Logins
  • Fix chain-specific block explorer links for the embedded wallet transaction details screen


  • Fix signMessage to support multiple calls in sequence


  • Add button roles to login sections for screen reader visibility


  • Fix password strength value not updating on generate


  • Small design adjustments


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


  • Upgrade wallet recovery from short passcodes to support full passwords
  • Prevent closing embedded wallet password flow until password has been saved and confirmed
  • Bump @walletconnect/ethereum-provider version to 2.10.1


  • Support setting a password on an existing wallet using setWalletPassword


  • Add callbacks for createWallet
  • Allow Twitter login on mobile, despite unresolved Twitter OAuth bug
  • 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
  • Tweak documentation exports


  • Update handling of fundWalletConfig parameter in sendTransaction


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


  • Improve wallet address formatting on key export screen
  • Improve logo spacing on connectWallet modal
  • Update fiat on-ramp copy
  • 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


  • Add support for MoonPay Fiat On-Ramp plugin
  • Move towards using static JSON-RPC providers


  • 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


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


  • Fix broken link on "What is a wallet?"
  • Add optional support for turnstile CAPTCHA
  • Make all fields in ContractUIOptions config optional
  • Persist the embedded wallet's chain ID across browser sessions


  • Add support for Linea
  • Improve styling for Safari PWAs
  • Improve messaging for embedded wallet insufficient funds
  • Improve styling on when loading on mobile
  • Fix issue with gas estimation


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


  • 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


  • Further improvements to sendTransaction UI customization


  • Add Base support


  • Update OAuth allowlist rejection handling
  • Improved handshake between Privy SDK and iframe
  • Removed iframe message target specification
  • Improved interfaces for transaction UI Customizations
  • Tightened login modal design


  • Fix sizing of connect wallet modal when no logo is set
  • Update "Learn more about wallets" hyperlink


  • Fix issue with app logo vertical spacing
  • Add Sepolia support


  • Resolve issue connecting to the embedded wallet when using cookies
  • Launch the wallet recovery flow when requesting actions through the embedded EIP-1193 provider


  • Add loading state during embedded wallet creation
  • Narrow iframe messaging target
  • 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


  • Add a short delay before signing with MetaMask with WalletConnect to bypass issues with chain switching (awaiting upstream resolution)
  • Support signing UInt8Array messages
  • Fix inconsistent modal sizing bugs
  • Fix issue with wallet recovery flow for non-pinless wallets during headless message signing
  • Add headless sendTransaction
  • Remove AbortSignal.timeout (not supported in iOS < 16)
  • Add embedded wallet support for eth_signTypedData_v4


  • Reduce SDK log chattiness
  • Fix authenticated connect-only screen
  • Resolve issues with duplicate create embedded wallet calls
  • Fail fast when trying to link accounts for which there can only be one (sms, email, socials)
  • Fix issue with MetaMask wallet address not matching
  • Increase default request timeout
  • Increase default request retries
  • Fix an issue with wallet loginOrLink
  • Fix sendTransaction modal issue with non-Ethereum chains


  • Update WalletConnect dependencies to fix reliability issues


  • Fix bug where signature requests would hang indefinitely on React 17
  • Updates WalletConnect providers to support more JSON RPC methods
  • Remove dependency on crypto.randomUUID()


  • Fix useWallets hook to properly listen to user-triggered disconnects from MetaMask
  • 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


  • Fix an issue where not depending on @walletconnect/modal would require build failures in certain build environments
  • Load only WalletConnect v2-compatible wallets in the mobile modal. This also resolves paging overflow on mobile


  • Migrate WalletConnect from v1.0 to v2.0. Learn more
  • Add support for Celo (mainnet and Alfajores testnet), FVM (mainnet and Calibration testnet), and Base (Goerli testnet)
  • Fix local development issue where React strict-mode duplicates calls to create embedded wallets
  • Fix UI issues related to embedded wallet gas estimation
  • Store wallet client information (MetaMask, Coinbase Wallet, Rainbow, etc.) used when connecting Ethereum accounts


  • Add support for embedded wallet creation without requiring the user to set a PIN/passcode
  • Set client-side cookies alongside our localStorage tokens for local development/testing purposes
  • Update wallet_switchEthereumChain to match standardized params
  • Fix issue with linking/login from the wallets array
  • Fix issue where cookies weren't being properly set


  • Switch from axios to ofetch
  • Fix some issues with gas estimation
  • Fix issue where the wallets array wasn't getting properly updated


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


  • Connect-only support
  • New wallets array interface
  • Deprecate setActiveWallet, getEthereumProvider, getEthersProvider, getWeb3jsProvider in favor of wallets array methods
  • Fix WalletConnect chain switching


  • Decrease package size
  • Fix issue where signMessage contents did not respect newlines
  • Help circumvent issue with Phantom not supporting certain chains
  • Fix an issue with internal modal rendering


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


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


  • Fix ethereum object checking
  • 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)
  • Fix an issue with client-side config checking for apps with only wallet login


  • Fix an issue where attempting to sign in with smart contract wallets would show an incorrect error
  • Improve error handling related to Phantom extension window.ethereum hijacking
  • Improved client-side login config error handling and warnings


  • Add support for client-side configuration of modal ordering, ToS & Privacy Policy, supported login methods
  • Support setting logo using img and svg elements
  • Fix an issue where no logo caused an odd visual layout
  • Rename PIN to passcode for embedded wallets
  • Add support for submitting transactions using embedded wallets


  • Enable support for Phantom wallet
  • Add sign-in with Apple
  • Allow override of API URL


  • Update styling of app logo
  • Improve MetaMask UX around setting active wallet when all wallets are disconnected
  • Include ToS & Privacy Policy on modal in mobile


  • Remove layout shifts from embedded wallet iframe
  • Allow user to escape modal on clicking out or hitting ESC


  • Improve embedded wallet recovery UIs


  • Improve embedded wallet UIs


  • Enable embedded wallet private key export
  • Fix Metamask getting stuck in app store during deep linking


  • Add support for dark mode, client-side logo config, and advanced theming configuration
  • Improved mobile Coinbase Wallet experience. If already logged in to the mobile browser, this session will be transferred to the Coinbase Wallet in-app browser
  • Fix issues with blank tabs appearing on some browsers (ie Firefox)


  • Improved mobile wallet connection flow
    • Switch to using WalletConnect for MetaMask on mobile
    • Better WalletConnect connection management
    • Split wallet connection and sign on mobile to reduce issues getting stuck in App Store
  • Embedded wallet recovery
  • Fix issues when unlinking with multiple wallets
  • Improve active wallet management
  • Add hover states to all buttons and clean up app color usage


  • Add option for automatic embedded wallet create flow after login
  • Fix issue with signing using WalletConnect after page is refreshed


  • Disable background scrolling when the modal is open
  • Fix user.wallet not getting set for embedded wallets if there is external wallet data in localStorage
  • Improve PIN entry for embedded wallets on mobile
  • Fix excessive WalletConnect loading that was hitting Infura a ton


  • Release embedded wallets!
  • Fix issue with long emails overflowing the modal
  • Fix height on wallet connection status screen to avoid reflows


  • Improved multi-wallet linking
  • Disable passwordless code autofill on non-mobile
  • Improved home screen when there's only one authentication option