Update delegation-toolkit docs for v0.12 release

* update docs for v0.12

* update quick start

* fix typos

* fix typo

* fix typo

* add 7702 content

* fix typos

* rename file

* Apply suggestions from code review

Co-authored-by: Alexandra Carrillo <[email protected]>

* update code snippets to use sepolia

* Apply suggestions from code review

Co-authored-by: jeffsmale90 <[email protected]>

* Minor nit

Co-authored-by: jeffsmale90 <[email protected]>

* update prerequisites

---------

Co-authored-by: Alexandra Carrillo <[email protected]>
Co-authored-by: jeffsmale90 <[email protected]>

Author: 3 people

delegation-toolkit/concepts/environment.md

@@ -42,7 +42,7 @@ import {
 } from "@metamask/delegation-toolkit";
 import { privateKeyToAccount } from "viem/accounts";
 import { createPublicClient, http } from "viem";
-import { lineaSepolia as chain } from "viem/chains";
+import { sepolia as chain } from "viem/chains";
 
 const publicClient = createPublicClient({
   chain,
@@ -79,8 +79,8 @@ import {
   DeleGatorEnvironment, 
 } from "@metamask/delegation-toolkit"; 
 
-// Resolves the DeleGatorEnvironment for Linea Sepolia
-const environment: DeleGatorEnvironment = getDelegatorEnvironment(59141);
+// Resolves the DeleGatorEnvironment for Sepolia
+const environment: DeleGatorEnvironment = getDelegatorEnvironment(11155111);
 ```
 
 ## Deploy custom delegator environment
@@ -97,7 +97,8 @@ Your wallet must have sufficient native token balance to deploy the contracts.
 
 ```typescript
 import { walletClient, publicClient } from "./config.ts";
-import { lineaSepolia as chain } from "viem/chains";
+import { sepolia as chain } from "viem/chains";
+import { deployDeleGatorEnvironment } from "@metamask/delegation-toolkit/utils";
 
 const environment = await deployDeleGatorEnvironment(
   walletClient, 
@@ -111,7 +112,7 @@ const environment = await deployDeleGatorEnvironment(
 
 ```typescript
 import { privateKeyToAccount } from "viem/accounts";
-import { lineaSepolia as chain } from "viem/chains";
+import { sepolia as chain } from "viem/chains";
 import { http, createWalletClient, createPublicClient } from "viem";
 
 // Your deployer wallet private key.
@@ -139,7 +140,8 @@ For example, if you've already deployed the `EntryPoint` contract on the target
 ```typescript
 // The config.ts is the same as in the previous example.
 import { walletClient, publicClient } from "./config.ts";
-import { lineaSepolia as chain } from "viem/chains";
+import { sepolia as chain } from "viem/chains";
+import { deployDeleGatorEnvironment } from "@metamask/delegation-toolkit/utils";
 
 const environment = await deployDeleGatorEnvironment(
   walletClient, 
@@ -163,12 +165,12 @@ To override the delegator environment, the toolkit provides an [`overrideDeploye
 ```typescript
 // The config.ts is the same as in the previous example.
 import { walletClient, publicClient } from "./config.ts";
-import { lineaSepolia as chain } from "viem/chains";
+import { sepolia as chain } from "viem/chains";
+import { DeleGatorEnvironment } from "@metamask/delegation-toolkit";
 import { 
-  DeleGatorEnvironment, 
   overrideDeployedEnvironment,
-  deployDeleGatorEnvironment
-} from "@metamask/delegation-toolkit";
+  deployDeleGatorEnvironment 
+} from "@metamask/delegation-toolkit/utils";
 
 const environment: DeleGatorEnvironment = await deployDeleGatorEnvironment(
   walletClient, 
@@ -188,14 +190,14 @@ If you've already deployed the contracts using a different method, you can creat
 ```typescript
 // remove-start
 - import { walletClient, publicClient } from "./config.ts";
-- import { lineaSepolia as chain } from "viem/chains";
+- import { sepolia as chain } from "viem/chains";
 // remove-end
+import { DeleGatorEnvironment } from "@metamask/delegation-toolkit";
 import { 
-  DeleGatorEnvironment, 
   overrideDeployedEnvironment,
   // remove-next-line
 - deployDeleGatorEnvironment
-} from "@metamask/delegation-toolkit";
+} from "@metamask/delegation-toolkit/utils";
 
 // remove-start
 - const environment: DeleGatorEnvironment = await deployDeleGatorEnvironment(

delegation-toolkit/concepts/smart-accounts.md

@@ -38,7 +38,8 @@ ERC-4337 introduces the following concepts:
 
 ## Smart account implementation types
 
-The MetaMask Delegation Toolkit supports two types of smart accounts, each offering unique features and use cases.
+The MetaMask Delegation Toolkit supports three types of smart accounts, each offering unique features and use cases.
+
 See [Configure accounts and signers](../how-to/create-smart-account/configure-accounts-signers.md) to learn how to use these different account types.
 
 ### Hybrid smart account
@@ -55,6 +56,13 @@ The signatory must have at least as many signers include as the threshold is con
 
 This type is referenced in the toolkit as `Implementation.Multisig`.
 
+### Stateless 7702 smart account
+
+The Stateless 7702 smart account implementation represents an externally owned account (EOA) upgraded to
+support smart account functionality as defined by [EIP-7702](https://eips.ethereum.org/EIPS/eip-7702). This implementation enables EOAs to perform smart account operations, including the creation and management of delegations.
+
+This type is referenced in the toolkit as `Implementation.Stateless7702`.
+
 ## Smart account flow
 
 The MetaMask smart account flow is as follows:

delegation-toolkit/get-started/cli-quickstart.md

@@ -1,6 +1,6 @@
 ---
 description: Get started with the MetaMask Delegation Toolkit using the `create-gator-app` CLI.
-sidebar_position: 3
+sidebar_position: 4
 sidebar_label: CLI quickstart
 ---
 

delegation-toolkit/get-started/eip7702-quickstart.md

@@ -0,0 +1,155 @@
+---
+description: Upgrade an externally owned account (EOA) to a smart account
+sidebar_position: 3
+sidebar_label: EIP-7702 quickstart
+---
+
+# EIP-7702 quickstart
+
+This page demonstrates how to upgrade your externally owned account (EOA) to support MetaMask smart account 
+functionality using an [EIP-7702](https://eips.ethereum.org/EIPS/eip-7702) transaction. This enables your EOA to leverage the benefits of account 
+abstraction, such as batch transactions, gas sponsorship, and [ERC-7710 delegation capabilities](./../concepts/delegation.md).
+
+## Prerequisites
+
+- [Install and set up the Delegation Toolkit.](install.md)
+- [Install Viem](https://viem.sh/)
+
+## Steps
+
+### 1. Set up a Public Client
+
+Set up a [Viem Public Client](https://viem.sh/docs/clients/public) using Viem's `createPublicClient` function. 
+This client will let the EOA query the account state and interact with blockchain network.
+
+```typescript
+import { createPublicClient, http } from "viem";
+import { sepolia as chain } from "viem/chains";
+ 
+const publicClient = createPublicClient({
+  chain,
+  transport: http(),
+});
+```
+
+### 2. Set up a Bundler Client
+
+Set up a [Viem Bundler Client](https://viem.sh/account-abstraction/clients/bundler) using Viem's `createBundlerClient` function.
+This lets you use the bundler service to estimate gas for user operations and submit transactions to the network.
+
+```typescript
+import { createBundlerClient } from "viem/account-abstraction";
+
+const bundlerClient = createBundlerClient({
+  client: publicClient,
+  transport: http("https://your-bundler-rpc.com"),
+});
+```
+
+### 3. Set up a Wallet Client
+
+Set up [Viem Wallet Client](https://viem.sh/docs/clients/wallet) using Viem's `createWalletClient` function. 
+This lets you sign and submit EIP-7702 authorization.
+
+```typescript
+import { createWalletClient, http } from "viem";
+import { sepolia as chain } from "viem/chains";
+import { privateKeyToAccount } from "viem/accounts";
+ 
+export const account = privateKeyToAccount("0x...");
+ 
+export const walletClient = createWalletClient({
+  account,
+  chain,
+  transport: http(),
+});
+```
+
+### 4. Authorize a 7702 delegation
+
+Create an authorization to map the contract code to an EOA, and sign it 
+using Viem's [`signAuthorization`](https://viem.sh/docs/eip7702/signAuthorization) action. The `signAuthorization` action 
+does not support JSON-RPC accounts.
+
+This example uses [`EIP7702StatelessDeleGator`](https://github.com/MetaMask/delegation-framework/blob/main/src/EIP7702/EIP7702StatelessDeleGator.sol) as the EIP-7702 delegator contract. 
+It follows a stateless design, as it does not store signer data in the contract's state. This approach
+provides a lightweight and secure way to upgrade an EOA to a smart account.
+
+```typescript
+import {
+  Implementation,
+  toMetaMaskSmartAccount,
+  getDeleGatorEnvironment,
+} from "@metamask/delegation-toolkit";
+import { privateKeyToAccount } from "viem/accounts";
+
+const environment = getDeleGatorEnvironment(sepolia.id);
+const contractAddress = environment.implementations.EIP7702StatelessDeleGatorImpl;
+
+const authorization = await walletClient.signAuthorization({
+  account, 
+  contractAddress,
+  executor: "self", 
+});
+```
+
+### 5. Submit the authorization
+
+Once you have signed an authorization, you can send an EIP-7702 transaction to set the EOA code.
+Since the authorization cannot be sent by itself, you can include it alongside a dummy transaction.
+
+```ts
+import { zeroAddress } from "viem";
+
+const hash = await walletClient.sendTransaction({ 
+  authorizationList: [authorization], 
+  data: "0x", 
+  to: zeroAddress, 
+});
+```
+
+### 6. Create a MetaMask smart account
+
+Create a smart account instance for the EOA and start 
+leveraging the benefits of account abstraction.
+
+```ts
+import { 
+  Implementation, 
+  toMetaMaskSmartAccount,
+} from "@metamask/delegation-toolkit";
+
+const addresses = await walletClient.getAddresses();
+const address = addresses[0];
+
+const smartAccount = await toMetaMaskSmartAccount({
+  client: publicClient,
+  implementation: Implementation.Stateless7702,
+  address, 
+  signatory: { walletClient },
+});
+```
+
+### 7. Send a user operation
+
+Send a user operation through the upgraded EOA, using Viem's [`sendUserOperation`](https://viem.sh/account-abstraction/actions/bundler/sendUserOperation) method.
+
+```ts
+import { parseEther } from "viem";
+
+// Appropriate fee per gas must be determined for the specific bundler being used.
+const maxFeePerGas = 1n;
+const maxPriorityFeePerGas = 1n;
+
+const userOperationHash = await bundlerClient.sendUserOperation({
+  account: smartAccount,
+  calls: [
+    {
+      to: "0x1234567890123456789012345678901234567890",
+      value: parseEther("1")
+    }
+  ],
+  maxFeePerGas,
+  maxPriorityFeePerGas
+});
+```

delegation-toolkit/get-started/quickstart.md

@@ -22,7 +22,7 @@ This client will let the delegator account query the signer's account state and
 
 ```typescript
 import { createPublicClient, http } from "viem";
-import { lineaSepolia as chain } from "viem/chains";
+import { sepolia as chain } from "viem/chains";
 
 const publicClient = createPublicClient({
   chain,
@@ -101,6 +101,13 @@ delegator account to the delegate account.
 This example passes an empty `caveats` array, which means the delegate can perform any action on the delegator's behalf.
 We recommend [restricting the delegation](../how-to/create-delegation/restrict-delegation.md) by adding caveat enforcers.
 
+:::warning Important
+
+Before creating a delegation, ensure that the delegator account has 
+been deployed. If the account is not deployed, redeeming the delegation will fail.
+
+:::
+
 ```typescript
 import { createDelegation } from "@metamask/delegation-toolkit";
 
@@ -137,18 +144,16 @@ executes actions on the delegator's behalf.
 To prepare the calldata for the redeem transaction, use the [`redeemDelegation`](../reference/api/delegation.md#redeemdelegation) utility function from the Delegation Toolkit.
 
 ```typescript
-import {
-  createExecution,
-  DelegationFramework,
-  SINGLE_DEFAULT_MODE,
-} from "@metamask/delegation-toolkit";
+import { createExecution } from "@metamask/delegation-toolkit";
+import { DelegationManager } from "@metamask/delegation-toolkit/contracts";
+import { SINGLE_DEFAULT_MODE } from "@metamask/delegation-toolkit/utils";
 import { zeroAddress } from "viem";
 
 const delegations = [ signedDelegation ];
 
-const executions = createExecution(zeroAddress);
+const executions = createExecution({ target: zeroAddress });
 
-const redeemDelegationCalldata = DelegationFramework.encode.redeemDelegations({
+const redeemDelegationCalldata = DelegationManager.encode.redeemDelegations({
   delegations: [ delegations ],
   modes: [ SINGLE_DEFAULT_MODE ],
   executions: [ executions ]

delegation-toolkit/get-started/supported-networks.md

@@ -11,21 +11,31 @@ If you don't see the network you're looking for, you can request support by emai
 
 ## Mainnet networks
 
-| Network Name        | v0.10.1 | v0.10.2 | v0.11.0 |
+| Network Name        | v0.10.2 | v0.11.0 | v0.12.0 |
 | ------------------- | ------- | ------- | ------- |
 | Ethereum            | ✅      | ✅      | ✅      |
 | Polygon             | ✅      | ✅      | ✅      |
 | Binance Smart Chain | ✅      | ✅      | ✅      |
 | Optimism            | ✅      | ✅      | ✅      |
-| Arbitrum            | ✅      | ✅      | ✅      |
+| Arbitrum One        | ✅      | ✅      | ✅      |
 | Base                | ✅      | ✅      | ✅      |
 | Gnosis Chain        | ✅      | ✅      | ✅      |
+| Unichain            | ❌      | ❌      | ✅      |
+| Arbitrum Nova       | ❌      | ❌      | ✅      |
+| Berachain           | ❌      | ❌      | ✅      |
 
 ## Testnet networks
 
-| Network Name     | v0.10.1 | v0.10.2 | v0.11.0 |
-| ---------------- | ------- | ------- | ------- |
-| Ethereum Sepolia | ✅      | ✅      | ✅      |
-| Base Sepolia     | ✅      | ✅      | ✅      |
-| MegaEth          | ✅      | ✅      | ✅      |
-| Gnosis Chiado    | ❌      | ❌      | ✅      |
+| Network Name                | v0.10.2 | v0.11.0 | v0.12.0 |
+| --------------------------- | ------- | ------- | ------- |
+| Ethereum Sepolia            | ✅      | ✅      | ✅      |
+| Base Sepolia                | ✅      | ✅      | ✅      |
+| MegaEth                     | ✅      | ✅      | ✅      |
+| Gnosis Chiado               | ❌      | ✅      | ✅      |
+| Arbitrum Sepolia            | ❌      | ❌      | ✅      |
+| Unichain Sepolia            | ❌      | ❌      | ✅      |
+| Berachain Bepolia           | ❌      | ❌      | ✅      |
+| Optimism Sepolia            | ❌      | ❌      | ✅      |
+| Binance Smart Chain         | ❌      | ❌      | ✅      |
+| Polygon Amoy                | ❌      | ❌      | ✅      |
+| Monad                       | ❌      | ❌      | ✅      |  

delegation-toolkit/how-to/configure.md

@@ -37,7 +37,7 @@ import {
   createBundlerClient,
 } from "viem/account-abstraction";
 import { http } from "viem";
-import { lineaSepolia as chain } from "viem/chains"; 
+import { sepolia as chain } from "viem/chains"; 
 
 // Replace these URLs with your actual bundler and paymaster endpoints.
 const bundlerUrl = "https://your-bundler-url.com";

delegation-toolkit/how-to/create-delegation/create-custom-caveat-enforcer.md

@@ -122,7 +122,7 @@ const delegation = createDelegation({
 
 ```typescript
 import { createPublicClient, http } from "viem";
-import { lineaSepolia as chain } from "viem/chains";
+import { sepolia as chain } from "viem/chains";
 import { 
   Implementation, 
   toMetaMaskSmartAccount,