Skip to main content
Enable smart wallets in the Privy Dashboard before implementing this feature.

​
1. Enable smart wallets

First, enable the smart wallets toggle and select a smart wallet type. Privy currently supports Kernel, Biconomy, Light Account, Safe, Thirdweb and the Coinbase Smart Wallet as smart wallet types. Sample enable smart wallets
If you modify your smart wallet type after users have already created smart wallets, Privy will provision the original smart wallet type for existing users to ensure they can access the accounts they already use.

​
2. Configure the supported networks

Next, configure the networks for your smart wallets. You should do this for any network that your app plans to use smart wallets on. Sample enable smart wallets For each configured network, you can optionally provide a bundler URL and/or a paymaster URL.

​
Bundler

The bundler URL specifies the node you want to use bundle operations from multiple users into a single transaction. If a bundler URL is not set for a network, Privy defaults to Pimlico’s public bundler (https://public.pimlico.io/v2/{chainId}/rpc).
We strongly recommend setting your own bundler URL when taking smart wallets to production, to give you more control over bundler rate limits. Privy’s default bundler is heavily rate limited and is not suitable for production usage.

​
Paymaster

The paymaster URL specifies the paymaster used to sponsor gas fees for the smart wallets on the network. If a paymaster URL is set, Privy will use that paymaster to sponsor gas fees for your users’ transactions. If a paymaster URL is not set, your users’ smart wallets must have a balance of the network’s native currency to pay for gas fees for transactions. For additional security, we strongly recommend setting Allowed domains for your paymaster and/or bundler through your provider’s dashboard, to restrict usage of these URLs to only your website. If you are looking to set up a paymaster or bundler for your app, we suggest the following providers:
ProviderGet started
Pimlicohttps://dashboard.pimlico.io
ZeroDevhttps://dashboard.zerodev.app/
Alchemyhttps://dashboard.alchemy.com/
Biconomyhttps://dashboard.biconomy.io/
Thirdwebhttps://thirdweb.com
Coinbasehttps://www.coinbase.com/developer-platform/products/paymaster
If using Alchemy for your paymaster, please provide your Alchemy gas policy ID. Each gas policy ID is tied to a specific chain and Alchemy project.
If using Biconomy as a paymaster with @privy-io/react-auth, you can override our default paymaster context in the SmartAccountsProvider. View more in our setup notes.

​
Custom chains

If you do not see the chain you wish to configure on the drop down, you can configure a custom chain. Before configuring a custom chain on the Privy dashboard, please ensure the chain is supported by your smart wallet provider. Custom chain configuration requires an EIP155 chain ID, chain name, paymaster URL, bundler URL, and RPC URL; none of these values can be defaulted as they are in supported chains.