You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/tutorials/integrations/gelato-sw.mdx
+62-23Lines changed: 62 additions & 23 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -22,59 +22,88 @@ import TabItem from '@theme/TabItem';
22
22
23
23
# Gelato Smart Wallet Integration Guide
24
24
25
-
You can use Gelato Smart Wallet to enable gasless transactions on Flow EVM. It supports features like: EIP-7702 or ERC-4337 depending on the wallet you use.
25
+
Gas fees are one of the biggest barriers to blockchain adoption. Users often need to hold native tokens just to pay for transaction fees, creating friction in onboarding and limiting the types of applications that can be built. Gelato Smart Wallet solves this problem by enabling **gasless transactions** on Flow EVM through sponsored transactions.
26
+
27
+
With Gelato Smart Wallet, you can:
28
+
-**Eliminate gas fees** for your users by sponsoring their transactions
29
+
-**Improve user experience** with seamless onboarding that doesn't require users to hold FLOW tokens
30
+
-**Support EIP-7702** for enhanced smart wallet functionality
31
+
-**Scale your dApp** by removing the cost barrier for user interactions
32
+
-**Leverage Flow's low gas costs** to provide affordable sponsored transactions
33
+
34
+
This tutorial will guide you through setting up Gelato Smart Wallet to enable gasless transactions on Flow EVM. You'll learn how to configure the necessary API keys, fund your sponsorship account, and implement gasless transaction functionality in your applications.
35
+
36
+
:::info
37
+
38
+
This tutorial focuses on **EIP-7702** implementation with Gelato Smart Wallet on Flow EVM. EIP-7702 provides a streamlined experience for users by maintaining the same address as their EOA while adding smart wallet capabilities, enabling enhanced features like gasless transactions and improved user experience.
39
+
40
+
:::
41
+
42
+
## Objectives
43
+
44
+
After completing this guide, you'll be able to:
45
+
46
+
- Configure a Gelato Smart Wallet account with proper API keys and funding setup
47
+
- Implement gasless transaction functionality using the Gelato Smart Wallet SDK
48
+
- Estimate and execute sponsored transactions on Flow EVM
49
+
- Integrate EIP-7702 features for enhanced user experience
50
+
- Troubleshoot common issues with Gelato Smart Wallet integration
26
51
27
52
## Prerequisites of using Gelato Smart Wallet
28
53
29
-
You need to setup all the followings in the Gelato App to create a Gelato Sponsor API Key.
54
+
You need to set up the following in the Gelato App to create a Gelato Sponsor API Key:
30
55
31
56
### Step 1. Create Your Gelato Account
32
57
33
58
Sign up on the [Gelato App] to establish an account. This account is the foundation for setting up relay tasks and managing gas sponsorships.
34
59
35
60
### Step 2. Create a Relay App
36
61
37
-
Within your Gelato account, create a new Relay App with the Flow EVM network.
62
+
Within your Gelato account, create a new _Relay App_ with the Flow EVM network.
38
63
For Testnet, you can first allow `Any contract` to call your relay app.
39
64
40
65

41
66
42
-
:::note
43
-
44
-
You can add more smart contract information and its associated chain information later in this App.
45
-
When set to a specific contract instead of `Any contract`, the API keys will only allow gasless transactions for calls to the designated methods within the ABI of the contract.
46
-
47
-
:::
48
-
49
-
### Step 3. Create/Obtain a Sponsor API Key
67
+
:::warning
50
68
51
-
After creating the relay app, navigate to its dashboard to locate your Sponsor API Key.
69
+
You'll need to add more information for your smart contracts at a later date.
52
70
53
-

71
+
When set to a specific contract instead of `Any contract`, the API keys will only allow sponsored transactions for calls to the designated methods within the ABI of that contract.
54
72
55
-
This key links your Gelato setup with 1Balance for gas sponsorship.
73
+
:::
56
74
57
-
### Step 4. Deposit Funds into 1Balance
75
+
### Step 3. Deposit Funds into 1Balance
58
76
59
-
To use Gelato sponsoring transactions, you need to deposit funds into 1Balance according to your target environment:
77
+
To use Gelato for sponsored transactions, you need to deposit funds into 1Balance according to your target environment:
60
78
61
79
- Mainnets: Deposit USDC.
62
80
- Testnets: Deposit Sepolia ETH.
63
81
64
-
Here we use Sepolia ETH as the gas fee for Testnet‘s gasless transactions.
82
+
Click the `1Balance` tab to deposit `.001` Sepolia ETH testnet funds.
65
83
66
84

67
85
68
-
Here are some third party Sepolia ETH faucets you can use:
86
+
If you need to fund your account, you can use one of the following third-party faucets:
69
87
70
88
-[Google Cloud Sepolia Faucet]
71
89
-[Alchemy Sepolia Faucet]
72
90
-[Chainlink Sepolia Faucet]
73
91
-[Metamask Sepolia Faucet]
74
92
93
+
### Step 4. Create/Obtain an API Key
94
+
95
+
After creating the Relay App, navigate to its dashboard to locate your Sponsor API Key.
96
+
97
+

98
+
99
+
This key links your Gelato setup with 1Balance for gas sponsorship.
100
+
101
+
Copy the API key to your clipboard.
102
+
75
103
## Send Gasless Transactions for your users
76
104
77
105
After you have created a Sponsor API Key and deposited funds into 1Balance, you can use gasless transactions features for your users.
106
+
78
107
With the Gelato Smart Wallet SDK, developers can easily set up sponsored transactions for their applications in just a few simple steps, enabling seamless onboarding and interaction without requiring users to hold native tokens.
79
108
80
109
:::note
@@ -88,22 +117,22 @@ You can find the examples in the [Gelato Smart Wallet SDK] repository.
So far, you’ve learned how to send sponsored EIP-7702 transactions using a Gelato Smart Wallet on Flow EVM.
274
+
In this tutorial, you successfully integrated Gelato Smart Wallet to enable gasless transactions on Flow EVM. You learned how to set up the necessary infrastructure, configure API keys, fund sponsorship accounts, and implement gasless transaction functionality in your applications. The implementation demonstrates how Flow's low gas costs combined with Gelato's sponsored transaction infrastructure can create seamless user experiences that eliminate the friction of gas fees.
275
+
276
+
Now that you have completed the tutorial, you should be able to:
277
+
278
+
- Configure a Gelato Smart Wallet account with proper API keys and funding setup
279
+
- Implement gasless transaction functionality using the Gelato Smart Wallet SDK
280
+
- Estimate and execute sponsored transactions on Flow EVM
281
+
- Integrate EIP-7702 features for enhanced user experience
282
+
- Troubleshoot common issues with Gelato Smart Wallet integration
283
+
284
+
The combination of Flow's efficient gas pricing and Gelato's sponsored transaction infrastructure opens up new possibilities for building user-friendly dApps. By eliminating the need for users to hold native tokens for gas fees, you can create onboarding experiences that rival traditional Web2 applications while maintaining the security and transparency of blockchain technology.
0 commit comments