This repository has been archived by the owner on Jan 5, 2024. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 146
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
* wip * adding content * add to homepage * tiny change * add image * requested changes * add supported chains to infa page * wip * modify wallet sdk smart wallet page * add a guide * edit supported chains * gasless code snippets * delete unwritted guides * rename blog callout
- Loading branch information
1 parent
7d9d6d7
commit 789bc6c
Showing
13 changed files
with
958 additions
and
113 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,143 @@ | ||
| --- | ||
| slug: /smart-wallet | ||
| title: Overview | ||
| hide_title: true | ||
| --- | ||
|
|
||
| import Tabs from "@theme/Tabs"; | ||
| import TabItem from "@theme/TabItem"; | ||
| import CodeBlock from "@theme/CodeBlock"; | ||
| import ViewRepoButton from "@components/ViewRepoButton"; | ||
| import QuickstartCard from "@components/QuickstartCard"; | ||
|
|
||
| # Smart Wallet | ||
|
|
||
| Everything you need to build [ERC-4337](https://eips.ethereum.org/EIPS/eip-4337) Smart Wallets for your users. | ||
|
|
||
| Once setup, your application will: | ||
|
|
||
| Ethereum has 2 types of accounts to transfer and receive tokens: EOAs (Externally Owned Accounts) and smart contract accounts. | ||
| A smart wallet is a wallet type requiring **no private keys or seed phrases**. | ||
| Smart contract wallets rely on code instead of private keys to secure and recover wallet information. | ||
|
|
||
| **A smart contract wallet is a Web3 wallet controlled by a smart contract following the [ERC-4337 specification](https://eips.ethereum.org/EIPS/eip-4337).** | ||
|
|
||
| ## Features | ||
|
|
||
| thirdweb’s smart wallets have the following features by default: | ||
|
|
||
| - The ability to have multiple owners on the same wallet. | ||
| - Execute transactions (single and batched). | ||
| - Send and receive native tokens to and from the smart wallet. | ||
| - Send and receive [ERC-721](/solidity/extensions/erc721) and [ERC-1155](/solidity/extensions/erc1155) NFTs from the smart wallet. | ||
| - Store contract metadata. | ||
| - Pay for its own gas via a [paymaster](/smart-wallet/how-it-works#paymaster). | ||
| - Assign roles and permissions such as signers and admins. | ||
|
|
||
| And more! | ||
|
|
||
| Smart Wallets can be deployed via the [explore page](https://thirdweb.com/explore) or customized to each application's needs using the [Solidity SDK](/solidity). | ||
|
|
||
| The `SmartWallet` API is **composable** - you can use with your own [ERC 4337](https://eips.ethereum.org/EIPS/eip-4337) compatible factory contract and you can also use your own bundler or paymaster services. | ||
|
|
||
| ## References | ||
|
|
||
| By using the thirdweb SDKs, you can easily create and manage smart wallets for your users: | ||
|
|
||
| <div className="row" style={{ marginBottom: 12, padding: 8, paddingTop: 0 }}> | ||
| <div className="col col--4" style={{ padding: 8 }}> | ||
| <QuickstartCard | ||
| name="Wallet SDK" | ||
| link="/wallet/smart-wallet" | ||
| image="/assets/product/wallet.png" | ||
| description="Using smart wallets with the Wallet SDK for low level control in JavaScript" | ||
| /> | ||
| </div> | ||
| <div className="col col--4" style={{ padding: 8 }}> | ||
| <QuickstartCard | ||
| name="React SDK" | ||
| link="/react/react.smartwallet" | ||
| image="/assets/languages/react.png" | ||
| description="Using smart wallets with Connect Wallet in a React app." | ||
| /> | ||
| </div> | ||
| <div className="col col--4" style={{ padding: 8 }}> | ||
| <QuickstartCard | ||
| name="React Native SDK" | ||
| link="/react-native/wallets#smart-wallet" | ||
| image="/assets/languages/react-native.png" | ||
| description="Using smart wallets with Connect Wallet for mobile apps" | ||
| /> | ||
| </div> | ||
| <div className="col col--4" style={{ padding: 8 }}> | ||
| <QuickstartCard | ||
| name="Unity SDK" | ||
| link="/unity/thirdwebmanager#smart-wallet-options" | ||
| image="/assets/languages/unity.webp" | ||
| description="Using smart wallets in a game built with Unity" | ||
| /> | ||
| </div> | ||
| </div> | ||
|
|
||
| ## Pricing & Billing | ||
|
|
||
| To use thirdweb's account abstraction infrastructure, you need to setup a billing account on the thirdweb dashboard Settings page. | ||
|
|
||
| **Free Tier** and **Pro Tier**: | ||
|
|
||
| - **Features:** | ||
| - **Bundler**: Transaction bundle calls (non-sponsored calls) are free to use. | ||
| - **Paymaster**: 10% premium on top of network fee based on your usage. | ||
|
|
||
| Find more information on the different billing tiers by visiting [thirdweb's pricing page](https://thirdweb.com/pricing). | ||
|
|
||
| ## Supported chains | ||
|
|
||
| <details> | ||
| <summary>View supported chains</summary> | ||
| <div> | ||
| <ul> | ||
| <li> | ||
| <b>Polygon</b> | ||
| </li> | ||
| <li> | ||
| <b>Optimism</b> | ||
| </li> | ||
| <li> | ||
| <b>Base</b> | ||
| </li> | ||
| <li> | ||
| <b>Arbitrum</b> | ||
| </li> | ||
| <li> | ||
| <b>Linea</b> | ||
| </li> | ||
| <li> | ||
| <b>Goerli</b> | ||
| </li> | ||
| <li> | ||
| <b>Sepolia</b> | ||
| </li> | ||
| <li> | ||
| <b>Mumbai</b> | ||
| </li> | ||
| <li> | ||
| <b>Base Goerli</b> | ||
| </li> | ||
| <li> | ||
| <b>Optimism Goerli</b> | ||
| </li> | ||
| <li> | ||
| <b>Arbitrum Goerli</b> | ||
| </li> | ||
| <li> | ||
| <b>Linea Testnet</b> | ||
| </li> | ||
| <li> | ||
| <b>Celo Alfajores Testnet</b> | ||
| </li> | ||
| </ul> | ||
| </div> | ||
| </details> | ||
|
|
||
| To support a chain not listed, [contact us](https://thirdweb.typeform.com/to/Q93CVgUc?typeform-source=thirdweb-www-git-mariano-ftd-1670.thirdweb-preview.com). |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,76 @@ | ||
| --- | ||
| slug: /smart-wallet/how-it-works | ||
| title: How it Works | ||
| --- | ||
|
|
||
| ## What is a Smart Wallet? | ||
|
|
||
| A Smart Wallet is a wallet that is controlled by a smart contract following the [ERC-4337 specification](https://eips.ethereum.org/EIPS/eip-4337). | ||
|
|
||
| Ethereum has 2 types of accounts to transfer and receive tokens: EOAs (Externally Owned Accounts) and Contract Accounts. A smart contract wallet is a wallet managed by a contract account | ||
| instead of an EOA. A smart wallet is a wallet type requiring **no private keys or seed phrases**. | ||
| Smart contract wallets rely on code instead of private keys to secure and recover wallet information. | ||
|
|
||
| **A smart contract wallet is a type of Web3 wallet powered by smart contracts.** | ||
|
|
||
| This smart wallet is unlocked by a 'key' - a personal account. This key can be anything from a [MetaMask](/wallet/metamask) wallet or even a [Local Wallet](/wallet/local-wallet) and is used as a way to 'sign in' to the wallet. | ||
|
|
||
| Benefits of Smart Wallets: | ||
|
|
||
| 1. Optimized transaction efficiency & batch transactions | ||
| - Combine multiple transactions into a single transaction to save on [gas fees](/glossary/gas) | ||
| 2. Improved Security Features | ||
| 3. Social & Multi-Sig Recovery | ||
| - Recover a wallet without seed phrases/passwords | ||
| - Nominate a trusted person to recover your wallet in the case of an emergency | ||
|
|
||
| ## How does it work? | ||
|
|
||
| When sending a transaction using a smart wallet, the `execute` method is called on the account contracts | ||
| which sends a `UserOperation` object that defines the purpose of the transaction and includes the relevant data for verification. | ||
|
|
||
| The requested `UserOperation` goes to an alt mempool — a waiting area specifically for pending smart account transactions — and waits for bundlers (nodes) to pick up transactions, | ||
| bundle them, and pay the gas, via a paymaster contract, for the transaction to register all `UserOperation` in a block. | ||
|
|
||
| To prioritize transactions, bundlers use a similar logic to how miners or validators prioritize transactions in the mempool based on the fee associated with each of them. | ||
| Bundlers earn the combined fee paid within all UserOperation they bundled. | ||
|
|
||
| These bundled `UserOperation` are then sent to the `EntryPoint` contract which verifies the `UserOperation` and executes the transaction. | ||
|
|
||
| To learn more about how smart wallets work, read our [smart contract deep dive](https://blog.thirdweb.com/smart-contract-deep-dive-building-smart-wallets-for-individuals-and-teams/). | ||
|
|
||
|  | ||
|
|
||
| ## Terminology | ||
|
|
||
| ### UserOperations | ||
|
|
||
| This is the data structure for the transaction that the user wants to perform. It contains the following fields: | ||
|
|
||
| - `sender`: The account making the operation. | ||
| - `nonce`: Anti-replay parameter; also used as the salt for first-time account creation. | ||
| - `initCode`: The initialization code needed to create the account (needed if and only if the account is not yet on-chain). | ||
| - `callData`: The data to pass to the `sender` during the operation. | ||
| - `callGasLimit`: The amount of gas to allocate for the operation. | ||
| - `verificationGasLimit`: The amount of gas to allocate for the verification step. | ||
| - `preVerificationGas`: The amount of gas to pay for to compensate the bundler for pre-verification execution and calldata. | ||
| - `maxFeePerGas`: Maximum fee per gas (similar to [EIP-1559](https://eips.ethereum.org/EIPS/eip-1559) `max_fee_per_gas`). | ||
| - `maxPriorityFeePerGas`: Maximum priority fee per gas (similar to [EIP-1559](https://eips.ethereum.org/EIPS/eip-1559)). | ||
| - `paymasterAndData`: Address of paymaster sponsoring the transaction, followed by extra data to send to the paymaster (empty for self-sponsored transaction). | ||
| - `signature`: Data passed into the account along with the nonce during the verification step. Should depend on the `chainid` and `EntryPoint` address to prevent replay attacks. | ||
|
|
||
| ### EntryPoint | ||
|
|
||
| The EntryPoint is a singleton contract (a contract that has a predictable address that is the same on every chain). | ||
| It has two methods that are used as entry points to execute bundles of UserOperations: `handleOps` and `handleAggregatedOps`. | ||
|
|
||
| ### Bundler (relayer) | ||
|
|
||
| A bundler is a smart contract that bundles multiple 'UserOperations' into a single bundle, a `handleOps` call, to the `EntryPoint` contract. | ||
|
|
||
| ### Paymaster | ||
|
|
||
| A paymaster is a smart contract that relays transactions. It provides a service that enables a third party to pay | ||
| the transaction fee on behalf of the user by funding the paymaster in advance. The Paymaster acts as a gas reserve which then | ||
| can be used during the call execution via the `EntryPoint` contract. The thirdweb [Smart Wallet](/smart-wallet) paymaster is initially paid for by thirdweb. By using an API key, | ||
| the usage is tracked and billed. |
Oops, something went wrong.
789bc6cThere was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Successfully deployed to the following URLs:
docs – ./
docs.thirdweb-preview.com
docs-chi-eight.vercel.app
portal.thirdweb.com
docs.thirdweb.com
docs-git-main.thirdweb-preview.com