SDK changelogs
React
The release notes for the @privy-io/react-auth
SDK.
On an older version of the SDK? Check out our migration guides to help you upgrade:
- V2 Migration Guide
2.8.0
Improvements
- Improve
ready
flag fromuseWallets
for unauthenticated states - Remove WalletConnect fetch when WalletConnect is not used
- Update
js-sdk-core
to0.46.4
Bug Fixes
- Fix gas/nonce bug for Ethereum transactions
- Fix UI bug for Solana transactions involving ATA instructions
2.7.2
Improvements
- Internal improvements
- Update
js-sdk-core
to0.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
2.7.1
Improvements
- Update external transfer currency symbol to better reflect the asset
- Consolidate chain definitions across Privy JavaScript SDKs
- Update
js-sdk-core
to0.46.2
- Update
chains
to0.0.1
Experimental interfaces
Breaking changes
- Update
signAuthorization
fromuseSignAuthorization
with latest interface from viem
2.7.0
Improvements
- Improve gas estimation logic for ZeroDev bundlers
- Improve error message when operation fails due to missing
Buffer
implementation - Memoize
wallets
fromuseSolanaWallets
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
to0.9.23
to fix incompatibility with node 18
2.6.4
Bug Fixes
- Fix bug where solana wallets ready flag is never set to true
2.6.3
Improvements
- Add
Haha
wallet to walletlist - Add
useConnectOrCreateWallet
and support attaching callbacks - Update
@privy-io/js-sdk-core
to0.46.0
Bug Fixes
- Fix a recovery but when using Solana HD wallets at indices greater than 0
- Remove usage of
zustand/traditional
2.6.2
Other Changes
- Minor internal improvements
2.6.1
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
2.6.0
Improvements
- Support Solana wallet auto-creation set in dashboard
- Update
@privy-io/js-sdk-core
to0.44.4
Bug Fixes
- Fix funding amount breaking when input amount is not valid
2.5.0
Breaking Changes
- Remove session forking logic
Improvements
- Add
signAllTransactions
method for Solana wallets - Add
SignerAccount
to the user object - Update
@privy-io/js-sdk-core
to0.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
2.4.5
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
2.4.4
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
2.4.3
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
2.4.2
Other Changes
- Minor internal improvements
2.4.1
Bug Fixes
- Fix an issue with
getAccessToken
causing unnecessary re-renders
Other Changes
- Bump @coinbase/wallet-sdk to 4.3.0
2.4.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 touseLoginWithPasskey
- Update docstring for
user.wallet
Bug Fixes
- Fix Solana transaction screen to correctly take
uiOptions
fromsendTransaction
andsignTransaction
methods - Ensure
refreshUser
method does not recalculate on rerender - Fix issue where Phantom would respond to
eth_accounts
requests to non-Phantom wallets
2.3.0
Improvements
- Add ability to filter wallets by chain type for login/linking
- Add
getClientForChain
method to theuseSmartWallets
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
2.2.1
Other Changes
- Internal smart wallet improvements around chain ID
2.2.0
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
2.1.0
Improvements
- Update
js-sdk-core
to0.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
2.0.8
Improvements
- Update
js-sdk-core
to0.41.2
Other Changes
- Minor internal improvements
2.0.7
Bug Fixes
- Fix some overflow login options not rendering properly
2.0.6
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
2.0.5
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
2.0.4
Improvements
- Improve icons on account transfer flow
Bug Fixes
- Fix bug where
disableSignUp
is not respected after login is retried - Fix
ready
flag fromuseSolanaWallets
2.0.3
Improvements
- Add support for
disableSignup
on SIWS flows
Bug Fixes
- Fix issue with
walletIndex
on Solana wallets
2.0.2
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
2.0.1
Improvements
- Update MFA verification on unenrollment to prompt earlier
- Update
js-sdk-core
to0.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
2.0.0
Breaking Changes - read the V2 migration guide here!
Improvements
- Update callback interfaces to an object instead of positional arguments
- Update interfaces for
signMessage
,signTypedData
, andsendTransaction
- 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
andgetWeb3jsProvider
interfaces
1.99.1
Improvements
- Add support for custom
uiConfig
on smart wallet request methods - Improve Transaction UIs for Solana SPL token instructions
- Update
js-sdk-core
to0.37.1
Other Changes
- Allows account transfer flows to work when linking Telegram seamlessly
1.99.0
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
, andLinkedAccountType
types - Allow for Zustand
5.0.0
to support integrations withwagmi
1.98.4
Improvements
- Add solana key private importing
- Update
js-sdk-core
to0.36.1
Other Changes
- Adjust ordering of embedded wallets for custom landing screen
1.98.3
Bug Fixes
- Fix bug where
linkWallet
would only prompt a connection flow
1.98.2
Improvements
- Add
useLoginToFrame
hook to log into Farcaster frames v2 - Updated dependencies [2c3e469] - @privy-io/[email protected]
1.98.1
Bug Fixes
- Fix
Embedded wallet not found error
sending Solana transactions
1.98.0
Improvements
- Adds support for Solana HD wallets
- Update Solana funding to respect provider configured RPC URL
- Update
js-sdk-core
to0.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
1.97.0
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 thefundWallet
method to fund EVM wallets using cross-chain bridging from a Solana wallet, make sure to import and mount theuseSolanaPlugin
hook during any funding flows: - Show “Solana” chip in connected wallets button
1.96.2
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
1.96.1
Bug Fixes
- Fix issue where
sendTransaction
would not work with funding configurations
1.96.0
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
anduseActiveWallet
support for connectors - Improve stability for setting identity token to cookies
- Update
js-sdk-core
to0.35.3
Bug Fixes
- Fix link on “download Phantom” screen
1.95.4
Improvements
- Support arbitrary programs for Solana transactions
- Add
solanaClusters
field toPrivyProvider
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
1.95.3
Improvements
- Add icons for wallet balance in transfer flow
- Improve
UserPill
dividers - Expose
LinkedAccountWithMetadata
type - Expose
ready
value fromuseSolanaWallets
hook
Other Changes
- Show
Continue
button in Manual funding after funds are received - Pin
@solana/web3.js
to^1.95.8
1.95.2
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
to0.35.1
Bug Fixes
- Fix coinbase bundler/paymaster gas estimation issues
Other Changes
- Warn on wallets not ready for turbopack
1.95.1
Improvements
- Add fallback for funding with an alternate provider
Bug Fixes
- Fix bug bridging to EVM from a Solana wallet
1.95.0
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
1.94.3
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
1.94.2
Improvements
- Add support for delegated actions on EVM networks
1.94.1
Improvements
- Improve manual transfer screen of funding flow
- Update
@headlessui/react
to2.2.0
- Update
js-sdk-core
to0.34.0
Bug Fixes
- Fix OAuth callback not firing during login flow
- Fix Solana key export when MFA is enabled
1.94.0
Improvements
- Update session token storage
- Update typing for
AuthenticatedUser
- Support user owned recovery for Solana embedded wallets
- Update
js-sdk-core
to0.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
1.93.0
Improvements
- Add support for creating ethereum HD wallets at any index
- Improve session update logic
1.92.8
Improvements
- Update
js-sdk-core
to0.31.0
Bug Fixes
- Fix issue where logging out would attempt to link smart wallets
Other Changes
- Minor internal improvements
1.92.7
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
1.92.6
Improvements
- Add secondary color option to
UserPill
button
1.92.5
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
1.92.4
Improvements
- Update user object to include
delegatedWallets
field - Update
js-sdk-core
to0.30.1
Bug Fixes
- Fix transaction details not updating for batched smart wallet calls
1.92.3
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
1.92.2
Improvements
- Add
switchChain
to SmartWalletClient - Update type of wallet in connectWallet callbacks to be
BaseEthereumConnectedWallet
orBaseSolanaConnectedWallet
- Update
js-sdk-core
to0.29.3
Other Changes
- Downgrade console warning to debug for
eth_accounts
1.92.1
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
1.92.0
Improvements
- Add support for funding EVM wallets by bridging from an external Solana wallet
- Add loading state to
UserPill
- Upgrade
permissionless
peer dependency to0.2.10
to improve stability of counterfactual smart wallet address determination
1.91.0
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'
1.90.0
Improvements
- Add support for funding Solana wallets via transfer from external wallet, Coinbase Onramp, and MoonPay
- Update
ConnectedSolanaWallet
object to have wallet helpers likesignMessage
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
1.89.0
Improvements
- Add
bybit_wallet
to walletList options - Add callbacks for
updatePhone
andupdateEmail
through theuseUpdateAccount
hook - Update
js-sdk-core
to0.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
1.88.4
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
1.88.3
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
1.88.2
Improvements
- Update logos for rebrand
- Update
js-sdk-core
dependency to0.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
1.88.1
Improvements
- Update docstring of
appearance.walletList
to include correctcoinbase_wallet
instead ofcoinbase
- Add
detected_ethereum_wallets
anddetected_solana_wallets
as supportedWalletListEntry
values - Update
js-sdk-core
dependency to0.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
1.88.0
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
1.87.0
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 tov6.1.13
- Update build outputs and
package.json#exports
property to match modern patterns
1.86.0
Improvements
- Add optional
config
prop forSmartWalletsProvider
that allows forpaymasterContext
to be set - Update
js-sdk-core
dependency to0.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
1.85.0
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
1.84.0
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
1.83.1
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
1.83.0
Improvements
- Add support for passing a
disableSignup
flag tologin
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
1.82.0
Improvements
- Add
loginWithCrossAppAccount
touseCrossAppAccounts
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 nativesignMessage
,signTypedData
, andsendTransaction
methods - Add support for configuring the
walletList
to display in Privy’s connection prompt directly inconnectWallet
- Update
js-sdk-core
dependency to0.26.7
Bug Fixes
- Fix
loading
to correctly befalse
for error states on headless OAuth login
1.81.3
Improvements
- Add support for additional Ethereum embedded wallet creation at HD indices that are not 0
- Add
useCustomAuth
hook
1.81.2
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
1.81.1
Bug Fixes
- Fix chain definition for Base
1.81.0
Improvements
- Add ability to fund from external wallet with ERC20 tokens in addition to a chain’s native token
- Add
onComplete
andonError
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
1.80.0
Improvements
- Add ability to pre-fill either phone number or email on login UI
- Add
onComplete
andonError
callbacks for third-party auth login - Update
js-sdk-core
dependency to0.26.2
Other Changes
- Pin
@walletconnect/ethereum-provider
to2.15.1
or higher to avoid breaking change introduced in2.15.0
- Send Telegram
start_param
in authenticate request payload
1.79.1
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 foruseFundWallet
hook did not fire if there was an error - Fix visual bug on transaction screen when transaction amount overflows the modal
1.79.0
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
1.78.2
Breaking Changes
- Remove deprecated chains from default supported chains
- Remove Solana embedded wallet on logout
Improvements
- Add
'safe'
as an option forappearance.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
1.78.1
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
1.78.0
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)
1.77.0
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
fromuseFundWallet
hook - Fix copy on wallet creation recovery method selection screen
1.76.6
Improvements
- Improve QR code scannability
1.76.5
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
1.76.4
Bug Fixes
- Fix parameters for
updatePhone
flow
1.76.3
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
1.76.2
Improvements
- Update
js-sdk-core
dependency
1.76.1
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
1.76.0
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
1.75.1
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
1.75.0
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
1.74.1
Bug Fixes
- Fix occasional issue where embedded wallet transaction modal would infinitely load when used with ethers
1.74.0
Breaking Changes
- Deprecate
PrivyProvider
onSuccess
prop - Remove app logo from connect-only screen
Improvements
- Add
user
as argument toonOAuthTokenGrant
callback handler - Add
linkMethod
details toonError
callback foruseLinkAccount
- Improve transaction UI currency formatting
1.73.2
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
1.73.1
Breaking Changes
- Remove
WalletConnect
fallback whenexternalWallets.walletConnect.enabled
is set tofalse
Improvements
- Add
vanityName
toLinkedInOAuthWithMetadata
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
1.73.0
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
1.72.0
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
touseCrossAppAccounts
hook - Support returning OAuth provider tokens via
useOAuthTokens
hook - Add headless wallet linking via
useLinkWithSiwe
hook - Add new
suggestedAddress
parameter toconnectWallet
andlinkWallet
Other Changes
- Bump WalletConnect to
v2.13.3
to avoid metadata validation breaking change - Minor build improvements
1.71.0
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 tosignMessage
andsignTypedMessage
1.70.0
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.)
1.69.0
Improvements
- Add
useSetWalletRecovery
hook to set user-managed recovery methods for embedded wallets - Add
getEmbeddedConnectedWallet
helper to parseuseWallets
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
1.68.0
Breaking Changes
- Deprecate goerli and polygon mumbai chains
Improvements
- Upgrade
@walletconnect/ethereum-provider
to2.13.1
, fixesError: 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
1.67.0
Improvements
- Add support for Coinbase’s Smart Wallet
1.66.3
Bug Fixes
- Fix issue with signatures not working when wallet address is not checksummed
1.66.2
Improvements
- Add support for resetting password via
setPassword
- Add
mfaMethods
touseMfa
hook
Other Changes
- Fire
connectWallet
’sonSuccess
/onError
callbacks whenever a wallet is connected, including duringlogin
with SIWE - Retry JSON-RPC requests used to load connected wallets to handle flaky injected providers on page load
- Reduce noisy console warnings
1.66.1
Improvements
- Improved errors for embedded wallet gas estimation
Other Changes
- Minor improvements to refresh token storage
1.66.0
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
1.65.1
Improvements
- Improve error UI for SMS login
- Add console warning for gas estimation failure
- Add console warning for message signing failures
1.65.0
Improvements
- Add
rabby_wallet
as awalletList
option - Improve error UI for embedded wallet transactions
Bug Fixes
- Fix Twitter and Github logos on dark mode
1.64.1
Breaking Changes
- 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
fromuseWallets
to respect external wallet loading state
Other Changes
- Use Privy RPC endpoints for mainnet
1.64.0
Improvements
- Add
instagram
to supportedloginMethods
- Add new Farcaster write interfaces to
useExperimentalFarcasterSigner
1.63.0
Improvements
- Add passkeys as an option for transaction MFA
- Improve customization of transaction modal via
successHeader
andsuccessDescription
- Update
ready
fromuseWallets
hook to only correspond to embedded wallet loading state - Update transaction error UIs
1.62.0
Improvements
- Add Google Drive as an embedded wallet recovery option
1.61.0
Breaking Changes
- Deprecate Redstone Holesky and add Redstone Mainnet + Garnet Holesky
Improvements
- Add linked account to callback of
useLinkAccount
anduseLogin
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
andlatestVerifiedAt
, deprecateverifiedAt
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
1.60.7
Improvements
- Improve OAuth provider errors
Other Changes
- Read server config flags on
createWallet
- Bump mipd dependency from
0.0.5
to0.0.7
1.60.6
Improvements
- Update gas estimation to prioritize including the
from
address
Other Changes
- Avoid auto-closing login modal when access token is deleted from storage
1.60.5
Bug Fixes
- Fix SDK
authenticated
anduser
state when access token is cleared
1.60.4
Other Changes
- Minor internal improvements
1.60.3
Improvements
- Add Polygon Amoy Privy RPC endpoints
- Improve request retry logic
1.60.2
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
1.60.1
Improvements
- Expose
status
of login flow fromuseLoginWithSms
hook
Bug Fixes
- Fix issue with headless login where
link
was called whenlogin
should be
1.60.0
Breaking Changes
- 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
1.59.9
Improvements
- Add support for Berachain Artio
1.59.8
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
1.59.7
Improvements
- Update storage location for OAuth and PKCE
1.59.6
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 ifsupportedChains
are set without adefaultChain
- 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
1.59.5
Improvements
- Improve sign in with Farcaster redirect on iOS
Bug Fixes
- Fix “cannot dequeue event” console errors
1.59.4
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
1.59.3
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
1.59.2
Bug Fixes
- Fix phantom installation screen: reload after confirming installation
- Fix
ready
fromuseWallets
when phantom is inwalletList
1.59.1
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
1.59.0
Improvements
- Add new options to
appearance.walletList
:cryptocom
,uniswap
, andokx_wallet
- Expose
useFundWallet
to fund external wallets - Update gas estimation logic
- Update config to override
appearance.walletList
withloginMethodsAndOrder
if defined - Improve consistency of placeholder phone numbers
- Update coinbase wallet SDK
Bug Fixes
- Fix
ready
fromuseWallets
not getting set totrue
- 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
1.58.1
Improvements
- Expose
useFundWallet
to fund external wallets
Bug Fixes
- Fix
ready
fromuseWallets
not getting set totrue
Other Changes
- Reduce and improve console warnings on app startup
1.58.0
Improvements
- Add Spotify OAuth Integration
- Add
connectOrCreateWallet
- Add update email flow
- Improve session refresh logic
Other Changes
- Error state styling improvements
1.57.2
Bug Fixes
- Fix an issue causing OAuth logins to fail
1.57.1
Improvements
- Improve dialog accessibility
Other Changes
- Minor improvements to SDK initialization
- Minor copy updates
1.57.0
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
1.56.2
Breaking Changes
- 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
1.56.1
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 adefaultChain
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
1.56.0
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”
1.55.2
Breaking Changes
- 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
1.55.1
Improvements
- Improve captcha challenge timing
Other Changes
- Rename
farcaster_id
tofid
for consistency - Export Farcaster account on User object (
user.farcaster
)
1.55.0
Improvements
- Add sign-in with Farcaster. Please use version 1.55.1 to consume the most updated interfaces.
- Add
privyWalletOverride
toChain
type for overriding RPC urls - Update
useWallets
to throw when used outside ofPrivyProvider
Other Changes
- Style updates to various SVG elements
1.54.3
Improvements
- Add intermediary screen for CAPTCHA
- Improve wallet timeout error handling
1.54.2
Bug Fixes
- Fix issue with crypto utils compatibility
- Fix outline bug for status icons on dark mode
Other Changes
- Disable retries on 429s
1.54.1
Improvements
- Improve error handling for social login buttons
Other Changes
- Use browser friendly crypto utils
1.54.0
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
1.53.1
Improvements
- Improve accessibility and compatibility of the Privy modal
- Update
defaultChain
andsupportedChains
types to handleviem
’s updatedChain
type
Bug Fixes
- Fix issue where Phantom wallet button would not always show
1.53.0
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
1.52.6
Bug Fixes
- Ensure MFA only happens once for key export
- Fix visual bug with key export triggered with MFA
1.52.5
Improvements
- Add ready interface to useWallets
- Add
onAccessTokenGranted
andonAccessTokenRemoved
callbacks for access tokens
1.52.4
Other Changes
- Minor bugfixes
1.52.3
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
1.52.2
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
1.52.1
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 ofwallet_switchEthereumChain
RPC
1.52.0
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
1.51.1
Improvements
- Improve WalletConnect integration
- Expose modal visibility state via
useModalStatus
Bug Fixes
- Fix MetaMask in cases where it is not EIP-6963 injected
1.51.0
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
1.50.1
Bug Fixes
- Fix issue where transaction prompt can unexpectedly load twice
- Handle WalletConnect re-pairing attempts better
1.50.0
Breaking Changes
- 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
1.49.2
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.warn
ings 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
1.49.0
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
1.48.0
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
1.47.2
Improvements
- Add cancel helper to the
useMfa
hook
1.47.1
Other Changes
- Extend captcha timeout
1.47.0
Breaking Changes
- 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
1.46.1
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
1.46.0
Improvements
- Add support for Base and BNB with fiat onramp
1.45.3
Breaking Changes
- 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
1.45.2
Improvements
- Add password masking controls to embedded wallet password flows
1.45.1
Other Changes
- Show error message for automatic wallet creation
- Embedded wallet password confirmation type to “password”
1.45.0
Improvements
- Add config for resolving tx after submission
Bug Fixes
- Ensure wallet proxy is explicitly loaded in signature request modal
1.44.0
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
1.43.4
Improvements
- Enable configuration of RPC timeout duration for specific wallets
1.43.3
Breaking Changes
- Deprecate
WalletWithMetadata.chainId
in favor ofBaseConnectedWallet.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 tonumber
- 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
1.43.2
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
1.43.1
Improvements
- Update contents of “Download Password” file
- Improve UX of set password flow
1.43.0
Improvements
- Improve user flow for setting a password on the embedded wallet
- Add network configuration via
supportedChains
anddefaultChain
1.42.0
Other Changes
- Extend support for TikTok login
1.41.0
Improvements
- Add LinkedIn OAuth to Social Logins
Bug Fixes
- Fix chain-specific block explorer links for the embedded wallet transaction details screen
1.40.5
Bug Fixes
- Fix
signMessage
to support multiple calls in sequence
1.40.4
Improvements
- Add button roles to login sections for screen reader visibility
1.40.3
Bug Fixes
- Fix password strength value not updating on generate
1.40.2
Other Changes
- Small design adjustments
1.40.1
Other Changes
- Copy changes in wallet password and recovery flows
- Do not generate initial value for wallet password form
1.40.0
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
1.39.0
Improvements
- Support setting a password on an existing wallet using
setWalletPassword
1.38.0
Improvements
- Add callbacks for
createWallet
Bug Fixes
- Ensure
signMessage
andsendTransaction
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
1.37.1
Improvements
- Update handling of
fundWalletConfig
parameter insendTransaction
1.37.0
Improvements
- Add support for configuring the SDK with additional chains from
@wagmi/chains
1.36.1
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
1.36.0
Improvements
- Add support for MoonPay Fiat On-Ramp plugin
Other Changes
- Move towards using static JSON-RPC providers
1.35.1
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
1.35.0
Improvements
- Add support for using embedded wallets with a custom auth provider
- Add a shim for
eth_requestAccounts
RPC for the embedded wallet
1.34.1
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
1.34.0
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
1.33.1
Improvements
- Improve price display for transactions
- Improve handling of zero-value transactions
1.33.0
Improvements
- Add
wallet.switchChain
, which works across external and embedded wallets - Update Phantom logo
- Improve error handling when attempting to
login
when alreadyauthenticated
- Add support for Celo and Avalanche
1.32.1
Other Changes
- Further improvements to sendTransaction UI customization
1.32.0
Improvements
- Add Base support
1.31.0
Breaking Changes
- 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
1.30.4
Improvements
- Update “Learn more about wallets” hyperlink
Bug Fixes
- Fix sizing of connect wallet modal when no logo is set
1.30.3
Improvements
- Add Sepolia support
Bug Fixes
- Fix issue with app logo vertical spacing
1.30.2
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
1.30.1
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
1.30.0
Breaking Changes
- 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
1.29.0
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
1.28.4
Improvements
- Update WalletConnect dependencies to fix reliability issues
1.28.3
Breaking Changes
- 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
1.28.2
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
1.28.1
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
1.28.0
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
1.27.0
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
1.26.2
Bug Fixes
- Fix some issues with gas estimation
- Fix issue where the
wallets
array wasn’t getting properly updated
Other Changes
- Switch from
axios
toofetch
1.26.1
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
1.26.0
Breaking Changes
- Deprecate
setActiveWallet
,getEthereumProvider
,getEthersProvider
,getWeb3jsProvider
in favor ofwallets
array methods
Improvements
- New
wallets
array interface
Bug Fixes
- Fix WalletConnect chain switching
Other Changes
- Connect-only support
1.25.1
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
1.25.0
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
1.24.0
Other Changes
- EIP-1193 provider for embedded wallets
- Preliminary cookie support
1.23.2
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)
1.23.1
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
1.23.0
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
- Fix an issue where no logo caused an odd visual layout
Other Changes
- Rename PIN to passcode for embedded wallets
1.22.0
Improvements
- Enable support for Phantom wallet
- Add sign-in with Apple
Other Changes
- Allow override of API URL
1.21.0
Improvements
- 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
1.20.3
Breaking Changes
- Remove layout shifts from embedded wallet iframe
Other Changes
- Allow user to escape modal on clicking out or hitting ESC
1.20.2
Improvements
- Improve embedded wallet recovery UIs
1.20.1
Improvements
- Improve embedded wallet UIs
1.20.0
Improvements
- Enable embedded wallet private key export
Bug Fixes
- Fix Metamask getting stuck in app store during deep linking
1.19.0
Improvements
- 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
Bug Fixes
- Fix issues with blank tabs appearing on some browsers (ie Firefox)
1.18.0
Improvements
- 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
- Improve active wallet management
- Add hover states to all buttons and clean up app color usage
Bug Fixes
- Fix issues when unlinking with multiple wallets
Other Changes
- Embedded wallet recovery
1.17.0
Improvements
- Add option for automatic embedded wallet create flow after login
Bug Fixes
- Fix issue with signing using WalletConnect after page is refreshed
1.16.1
Improvements
- Improve PIN entry for embedded wallets on mobile
Bug Fixes
- Fix
user.wallet
not getting set for embedded wallets if there is external wallet data in localStorage - Fix excessive WalletConnect loading that was hitting Infura a ton
Other Changes
- Disable background scrolling when the modal is open
1.16.0
Bug Fixes
- Fix issue with long emails overflowing the modal
- Fix height on wallet connection status screen to avoid reflows
Other Changes
- Release embedded wallets!
1.15.0
Improvements
- Improved multi-wallet linking
- Improved home screen when there’s only one authentication option
Other Changes
- Disable passwordless code autofill on non-mobile
Was this page helpful?