Build with Paymasters (Sponsored Transactions)
One of the biggest UX enhancements unlocked by Smart Wallet is the ability for app developers to sponsor their users’ transactions. If your app supports Smart Wallet, you can start sponsoring your users’ transactions by using standardized Paymaster service communication enabled by new wallet RPC methods.
This guide is specific to using Smart Wallet, you can find our more about using Paymasters with Base in the Base Go Gasless page.
The code below is also in our Wagmi Smart Wallet template.
Skip ahead and clone the template
If you are looking for a complete example, you can skip the steps below and clone the Wagmi Smart Wallet template. Simply open a terminal and run:
Follow the instructions in the README to install the dependencies and run the app.
Add Support in your Next.js app (using Wagmi/Viem)
Set up your Paymaster service
As a prerequisite, you’ll need to obtain a Paymaster service URL from a Paymaster service provider.
We’ll use Coinbase Developer Platform as a Paymaster service provider, currently offering up to $15k in gas credits as part of the Base Gasless Campaign.
ERC-7677-Compliant Paymaster Providers
If you choose to use a different Paymaster service provider, ensure they are ERC-7677-compliant.
Once you have signed up for Coinbase Developer Platform, you get your Paymaster service URL by navigating to Onchain Tools > Paymaster as shown below:
Should you create a proxy for your Paymaster service?
As you can see in the Paymaster transaction component, we use a proxy to protect the Paymaster service URL to prevent it from being exposed/leaked on a frontend client
For local development, you can use the same URL for the Paymaster service and the proxy.
We also created a minimalist proxy API
which you can use as the PaymasterServiceUrl
in the TransactWithPaymaster
component.
Once you have your Paymaster service URL, you can proceed to setting up your contracts allowlist. This is a list of contracts and function calls that you want to be sponsored by the Paymaster.
Congrats! You’ve set up your Paymaster service and contracts allowlist. It’s time to create Wagmi and Viem clients.
You can also choose to create custom advanced policies !
For example, in the template, we create a willSponsor
function in utils.ts
to add some extra validation if you need
more control over the policy enforcement.
willSponsor
is most likely not needed if you are using Coinbase Developer Platform as it has built-in policy enforcement features,
but know that this is still possible if you need it.
Create Wagmi and Viem clients
This section shows you how to create Wagmi and Viem clients to interact with Smart Wallet using the Paymaster service you set up in the previous steps.
Send EIP-5792 requests with a Paymaster service capability
Once you have your Paymaster service set up, you can now pass its URL along to Wagmi’s useWriteContracts
hook.
Pass in the proxy URL
If you set up a proxy in your app’s backend as recommended in step (2) above, you’ll want to pass in the proxy URL you created.
About The Hooks Used Above
The useWriteContracts
and useCapabilities
hooks used below rely on new wallet RPC and are not yet supported in most wallets.
It is recommended to have a fallback function if your app supports wallets other than Smart Wallet.
How to find this code in the repository?
The code above is a simplified version of the code in the template.
In the template, we create a TransactWithPaymaster
component that uses the useWriteContracts
hook to send a transaction with a Paymaster.
The TransactWithPaymaster
component is used in the page.tsx
file.
That’s it! Smart Wallet will handle the rest. If your Paymaster service is able to sponsor the transaction, in the UI Smart Wallet will indicate to your user that the transaction is sponsored.