Update guides structure for MM smart accounts

AyushBherwani1998 · “AyushBherwani1998” · alexandratran · web-flow · commit e4819e1a4d3d · 2025-08-22T08:55:46.000+05:30
* add send gasless transaction guide

* minor edits, fix links, add redirects

* update eip7702 next steps

---------

Co-authored-by: “AyushBherwani1998” &lt;“ayush.bherwani1998@gmail.com”&gt;
Co-authored-by: Alexandra Tran &lt;alexandratran@protonmail.com&gt;
diff --git a/delegation-toolkit/concepts/caveat-enforcers.md b/delegation-toolkit/concepts/caveat-enforcers.md
@@ -119,7 +119,7 @@ This "all-or-nothing" approach ensures that delegations only execute exactly as
 
 ## Caveat builder
 
-While caveat enforcers operate at the smart contract level, most developers interact with them through the [`CaveatBuilder`](../how-to/create-delegation/restrict-delegation.md) interface in the MetaMask Delegation Toolkit.
+While caveat enforcers operate at the smart contract level, most developers interact with them through the [`CaveatBuilder`](../guides/create-delegation/restrict-delegation.md) interface in the MetaMask Delegation Toolkit.
 
 The `CaveatBuilder` provides a developer-friendly TypeScript API that:
 
@@ -160,11 +160,11 @@ for common restriction patterns, including:
 - Restricting token transfers and approvals.
 - Limiting execution frequency.
 
-For more complex scenarios, you can also [create custom caveat enforcers](../how-to/create-delegation/create-custom-caveat-enforcer.md) by implementing the `ICaveatEnforcer` interface.
+For more complex scenarios, you can also [create custom caveat enforcers](../guides/create-delegation/create-custom-caveat-enforcer.md) by implementing the `ICaveatEnforcer` interface.
 
 ## Attenuating authority with redelegations
 
-When [creating chains of delegations](../how-to/create-delegation/index.md#create-a-redelegation), it's important to understand how authority flows and can be restricted.
+When [creating chains of delegations](../guides/create-delegation/index.md#create-a-redelegation), it's important to understand how authority flows and can be restricted.
 
 Caveats applied to a chain of delegations are *accumulative*—they stack on top of each other:
 
diff --git a/delegation-toolkit/concepts/delegation.md b/delegation-toolkit/concepts/delegation.md
@@ -50,7 +50,7 @@ The delegation lifecycle is as follows:
    delegation through an [ERC-4337 user operation](smart-accounts.md#account-abstraction-erc-4337),
    which verifies that the delegated authority is valid in order to perform the execution.
 
-See [how to create a delegation](../how-to/create-delegation/index.md) to get started with the
+See [how to create a delegation](../guides/create-delegation/index.md) to get started with the
 delegation lifecycle.
 
 ## Delegation Framework
diff --git a/delegation-toolkit/concepts/environment.md b/delegation-toolkit/concepts/environment.md
@@ -71,7 +71,7 @@ See the changelog of the toolkit version you are using (in the left sidebar) for
 
 Alternatively, you can use the [`getDelegatorEnvironment`](../reference/api/delegation.md#getdelegatorenvironment) function to resolve the environment.
 This function is especially useful if your delegator is not a smart account when
-[creating a redelegation](../how-to/create-delegation/index.md#create-a-redelegation).
+[creating a redelegation](../guides/create-delegation/index.md#create-a-redelegation).
 
 ```typescript
 import { 
diff --git a/delegation-toolkit/concepts/smart-accounts.md b/delegation-toolkit/concepts/smart-accounts.md
@@ -39,7 +39,7 @@ ERC-4337 introduces the following concepts:
 
 The MetaMask Delegation Toolkit supports three types of MetaMask Smart Accounts, each offering unique features and use cases.
 
-See [Create a smart account](../how-to/create-smart-account.md) to learn how to use these different account types.
+See [Create a smart account](../guides/smart-accounts/create-smart-account.md) to learn how to use these different account types.
 
 ### Hybrid smart account
 
diff --git a/delegation-toolkit/experimental/erc-7710-redeem-delegations.md b/delegation-toolkit/experimental/erc-7710-redeem-delegations.md
@@ -84,7 +84,7 @@ Redeem a delegation with a [MetaMask smart account](#redeem-with-a-metamask-smar
 
 ### Redeem with a MetaMask smart account
 
-To redeem a delegation with a MetaMask smart account, [create a smart account](../how-to/create-smart-account.md)
+To redeem a delegation with a MetaMask smart account, [create a smart account](../guides/smart-accounts/create-smart-account.md)
 and a [Viem Bundler Client](https://viem.sh/account-abstraction/clients/bundler).
 
 After setting up your Bundler Client, you can extend its functionality with `erc7710BundlerActions` actions to support ERC-7710. Once extended, use [`sendUserOperationWithDelegation`](../reference/api/experimental-actions/bundler-client.md#senduseroperationwithdelegation) to redeem the permission.
diff --git a/delegation-toolkit/experimental/store-retrieve-delegations.md b/delegation-toolkit/experimental/store-retrieve-delegations.md
@@ -20,7 +20,7 @@ You can use methods provided by the `DelegationStorageClient` of the MetaMask De
 ## Prerequisites
 
 - [Install and set up the Delegation Toolkit.](../get-started/install.md)
-- [Configure the Delegation Toolkit.](../how-to/configure.md)
+- [Configure the Delegation Toolkit.](../guides/configure.md)
 - Ensure you have an API key and API key ID to interact with the `DelegationStorageClient`.
   If you need to gain access, email hellogators@consensys.net.
 
diff --git a/delegation-toolkit/get-started/erc7715-quickstart.md b/delegation-toolkit/get-started/erc7715-quickstart.md
@@ -130,7 +130,7 @@ const bundlerClient = createBundlerClient({
 
 ### 6. Redeem ERC-7715 permissions
 
-The session account can now [redeem the delegation](../how-to/redeem-delegation.md). The redeem transaction is sent to the `DelegationManager` contract, which validates the delegation and executes actions on the user's behalf.
+The session account can now [redeem the delegation](../guides/redeem-delegation.md). The redeem transaction is sent to the `DelegationManager` contract, which validates the delegation and executes actions on the user's behalf.
 
 To redeem the permissions, you can use the `sendUserOperationWithDelegation` bundler client action.
 
diff --git a/delegation-toolkit/get-started/install.md b/delegation-toolkit/get-started/install.md
@@ -17,7 +17,7 @@ This page provides instructions to install and set up the MetaMask Delegation To
 - Install [Yarn](https://yarnpkg.com/),
     [npm](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm), or another package manager.
 - If you plan to use any smart contracts (for example, to
-    [create a custom caveat enforcer](../how-to/create-delegation/create-custom-caveat-enforcer.md)),
+    [create a custom caveat enforcer](../guides/create-delegation/create-custom-caveat-enforcer.md)),
     install [Foundry](https://book.getfoundry.sh/getting-started/installation).
 
 ## Steps
@@ -33,7 +33,7 @@ npm install @metamask/delegation-toolkit
 ### 2. (Optional) Install the contracts
 
 If you plan to extend the Delegation Framework smart contracts (for example, to
-[create a custom caveat enforcer](../how-to/create-delegation/create-custom-caveat-enforcer.md)), install
+[create a custom caveat enforcer](../guides/create-delegation/create-custom-caveat-enforcer.md)), install
 the contract package using Foundry's command-line tool, Forge:
 
 ```bash
diff --git a/delegation-toolkit/get-started/smart-account-quickstart/eip7702.md b/delegation-toolkit/get-started/smart-account-quickstart/eip7702.md
@@ -158,4 +158,4 @@ const userOperationHash = await bundlerClient.sendUserOperation({
 
 - To grant specific permissions to other accounts from your smart account, [create a delegation](../../how-to/create-delegation/index.md).
 - To quickly bootstrap a MetaMask Smart Accounts project, [use the CLI](../use-the-cli.md).
-- You can also [use MetaMask SDK to upgrade an EOA to a smart account](/sdk/tutorials/upgrade-eoa-to-smart-account).
+- You can also [use MetaMask SDK to upgrade a MetaMask account to a smart account](/sdk/tutorials/upgrade-eoa-to-smart-account).
diff --git a/delegation-toolkit/get-started/smart-account-quickstart/index.md b/delegation-toolkit/get-started/smart-account-quickstart/index.md
@@ -43,7 +43,7 @@ const bundlerClient = createBundlerClient({
 
 ### 3. Create a MetaMask smart account
 
-[Create a MetaMask smart account](../../how-to/create-smart-account.md) to send the first user operation.
+[Create a MetaMask smart account](../../guides/smart-accounts/create-smart-account.md) to send the first user operation.
 
 This example configures a Hybrid smart account,
 which is a flexible smart account implementation that supports both an externally owned account (EOA) owner and any number of P256 (passkey) signers:
@@ -67,7 +67,7 @@ const smartAccount = await toMetaMaskSmartAccount({
 
 Send a user operation using Viem's [`sendUserOperation`](https://viem.sh/account-abstraction/actions/bundler/sendUserOperation) method.
 
-See [Send a user operation](../../how-to/send-user-operation.md) to learn how to estimate fee per gas, and wait for the transaction receipt.
+See [Send a user operation](../../guides/smart-accounts/send-user-operation.md) to learn how to estimate fee per gas, and wait for the transaction receipt.
 
 The smart account will remain counterfactual until the first user operation. If the smart account is not 
 deployed, it will be automatically deployed upon the sending first user operation.
@@ -94,8 +94,8 @@ const userOperationHash = await bundlerClient.sendUserOperation({
 
 ## Next steps
 
-- To grant specific permissions to other accounts from your smart account, [create a delegation](../../how-to/create-delegation/index.md).
+- To grant specific permissions to other accounts from your smart account, [create a delegation](../../guides/create-delegation/index.md).
 - This quickstart example uses a Hybrid smart account.
-  You can also [configure other smart account types](../../how-to/create-smart-account/configure-accounts-signers.md).
+  You can also [configure other smart account types](../../guides/smart-accounts/create-smart-account.md).
 - To upgrade an EOA to a smart account, see the [EIP-7702 quickstart](eip7702-quickstart.md).
 - To quickly bootstrap a MetaMask Smart Accounts project, [use the CLI](../use-the-cli.md).
diff --git a/delegation-toolkit/guides/_category_.json b/delegation-toolkit/guides/_category_.json
@@ -0,0 +1,4 @@
+{
+  "label": "Guides",
+  "position": 4
+}
diff --git a/delegation-toolkit/guides/configure.md b/delegation-toolkit/guides/configure.md
diff --git a/delegation-toolkit/guides/create-delegation/create-custom-caveat-enforcer.md b/delegation-toolkit/guides/create-delegation/create-custom-caveat-enforcer.md
diff --git a/delegation-toolkit/guides/create-delegation/index.md b/delegation-toolkit/guides/create-delegation/index.md
@@ -28,7 +28,7 @@ Learn how to [restrict a delegation](./restrict-delegation.md) using caveat enfo
 
 - [Install and set up the Delegation Toolkit.](../../get-started/install.md)
 - [Configure the Delegation Toolkit.](../configure.md)
-- [Create a MetaMask smart account.](../create-smart-account.md)
+- [Create a MetaMask smart account.](../smart-accounts/create-smart-account.md)
 
 ## Create a root delegation
 
diff --git a/delegation-toolkit/guides/create-delegation/restrict-delegation.md b/delegation-toolkit/guides/create-delegation/restrict-delegation.md
diff --git a/delegation-toolkit/guides/redeem-delegation.md b/delegation-toolkit/guides/redeem-delegation.md
@@ -20,7 +20,7 @@ The function supports batch redemption, allowing multiple delegations to be proc
 
 - [Install and set up the Delegation Toolkit.](../get-started/install.md)
 - [Configure the Delegation Toolkit.](configure.md)
-- [Create a delegator smart account.](create-smart-account.md)
+- [Create a delegator smart account.](smart-accounts/create-smart-account.md)
 - [Create a delegation.](create-delegation/index.md)
 
 ## Redeem a delegation
diff --git a/delegation-toolkit/guides/smart-accounts/_category_.json b/delegation-toolkit/guides/smart-accounts/_category_.json
@@ -0,0 +1,4 @@
+{
+  "label": "MetaMask Smart Accounts",
+  "position": 2
+}
diff --git a/delegation-toolkit/guides/smart-accounts/create-smart-account.md b/delegation-toolkit/guides/smart-accounts/create-smart-account.md
@@ -1,20 +1,20 @@
 ---
-description: Learn how to create a MetaMask smart account using Viem.
-sidebar_position: 2
+description: Learn how to create a MetaMask smart account using Delegation Toolkit.
+sidebar_position: 1
 ---
 
 import Tabs from "@theme/Tabs";
 import TabItem from "@theme/TabItem";
 
-# Create a MetaMask smart account
+# Create a smart account
 
-You can enable users to create a [MetaMask smart account](../concepts/smart-accounts.md) directly in your dapp.
-This page provides examples of using [`toMetaMaskSmartAccount`](../reference/api/smart-account.md#tometamasksmartaccount) with Viem Core SDK to create different types of smart accounts with different types of signatories.
+You can enable users to create a [MetaMask smart account](../../concepts/smart-accounts.md) directly in your dapp.
+This page provides examples of using [`toMetaMaskSmartAccount`](../../reference/api/smart-account.md#tometamasksmartaccount) with Viem Core SDK to create different types of smart accounts with different types of signatories.
 
 ## Prerequisites
 
-- [Install and set up the Delegation Toolkit.](../get-started/install.md)
-- [Configure the Delegation Toolkit.](configure.md)
+- [Install and set up the Delegation Toolkit.](../../get-started/install.md)
+- [Configure the Delegation Toolkit.](../configure.md)
 
 ## Create a Hybrid smart account
 
@@ -23,7 +23,7 @@ You can create a Hybrid smart account with the following types of signatories.
 
 ### Create a Hybrid smart account with an Account signatory
 
-Use [`toMetaMaskSmartAccount`](../reference/api/smart-account.md#tometamasksmartaccount) and Viem's [`privateKeyToAccount`](https://viem.sh/docs/accounts/local/privateKeyToAccount) to create a Hybrid smart account with a signatory from a private key:
+Use [`toMetaMaskSmartAccount`](../../reference/api/smart-account.md#tometamasksmartaccount) and Viem's [`privateKeyToAccount`](https://viem.sh/docs/accounts/local/privateKeyToAccount) to create a Hybrid smart account with a signatory from a private key:
 
 <Tabs>
 <TabItem value="example.ts">
@@ -76,7 +76,7 @@ export const account = privateKeyToAccount(privateKey);
 
 ### Create a Hybrid smart account with a Wallet Client signatory
 
-Use [`toMetaMaskSmartAccount`](../reference/api/smart-account.md#tometamasksmartaccount) and Viem's [`createWalletClient`](https://viem.sh/docs/clients/wallet) to create a Hybrid smart account with a Wallet Client signatory:
+Use [`toMetaMaskSmartAccount`](../../reference/api/smart-account.md#tometamasksmartaccount) and Viem's [`createWalletClient`](https://viem.sh/docs/clients/wallet) to create a Hybrid smart account with a Wallet Client signatory:
 
 <Tabs>
 <TabItem value="example.ts">
@@ -140,7 +140,7 @@ export const walletClient = createWalletClient({
 
 ### Create a Hybrid smart account with a WebAuthn (passkey) signatory
 
-Use [`toMetaMaskSmartAccount`](../reference/api/smart-account.md#tometamasksmartaccount) and Viem's [`toWebAuthnAccount`](https://viem.sh/account-abstraction/accounts/webauthn) to create a Hybrid smart account with a WebAuthn Account signatory:
+Use [`toMetaMaskSmartAccount`](../../reference/api/smart-account.md#tometamasksmartaccount) and Viem's [`toWebAuthnAccount`](https://viem.sh/account-abstraction/accounts/webauthn) to create a Hybrid smart account with a WebAuthn Account signatory:
 
 :::info Installation required
 To work with WebAuthn, install the [Ox SDK](https://oxlib.sh/).
@@ -211,8 +211,8 @@ export const webAuthnAccount = toWebAuthnAccount({ credential });
 
 ## Create a Multisig smart account
 
-A [Multisig smart account](../concepts/smart-accounts.md#multisig-smart-account) supports multiple EOA signers with a configurable threshold for execution.
-Use [`toMetaMaskSmartAccount`](../reference/api/smart-account.md#tometamasksmartaccount) to create a Multsig smart account with a combination of account signatories and Wallet Client signatories:
+A [Multisig smart account](../../concepts/smart-accounts.md#multisig-smart-account) supports multiple EOA signers with a configurable threshold for execution.
+Use [`toMetaMaskSmartAccount`](../../reference/api/smart-account.md#tometamasksmartaccount) to create a Multsig smart account with a combination of account signatories and Wallet Client signatories:
 
 <Tabs>
 <TabItem value="example.ts">
@@ -285,18 +285,18 @@ The number of signers in the signatories must be at least equal to the threshold
 
 ## Create a Stateless 7702 smart account
 
-A [Stateless 7702 smart account](../concepts/smart-accounts.md#stateless-7702-smart-account) represents an EOA that has been upgraded to support MetaMask Smart Accounts 
+A [Stateless 7702 smart account](../../concepts/smart-accounts.md#stateless-7702-smart-account) represents an EOA that has been upgraded to support MetaMask Smart Accounts 
 functionality as defined by [EIP-7702](https://eips.ethereum.org/EIPS/eip-7702).
 
 :::note
-This implementation does not handle the upgrade process; see the [EIP-7702 quickstart](../get-started/eip7702-quickstart.md) to learn how to upgrade.
+This implementation does not handle the upgrade process; see the [EIP-7702 quickstart](../../get-started/eip7702-quickstart.md) to learn how to upgrade.
 :::
 
 You can create a Stateless 7702 smart account with the following types of signatories.
 
 ### Create a Stateless 7702 smart account with an account signatory
 
-Use [`toMetaMaskSmartAccount`](../reference/api/smart-account.md#tometamasksmartaccount) and Viem's [`privateKeyToAccount`](https://viem.sh/docs/accounts/local/privateKeyToAccount) to create a Stateless 7702 smart account with a signatory from a private key:
+Use [`toMetaMaskSmartAccount`](../../reference/api/smart-account.md#tometamasksmartaccount) and Viem's [`privateKeyToAccount`](https://viem.sh/docs/accounts/local/privateKeyToAccount) to create a Stateless 7702 smart account with a signatory from a private key:
 
 <Tabs>
 <TabItem value="example.ts">
@@ -348,7 +348,7 @@ export const account = privateKeyToAccount(privateKey);
 
 ### Create a Stateless 7702 smart account with a Wallet Client signatory
 
-Use [`toMetaMaskSmartAccount`](../reference/api/smart-account.md#tometamasksmartaccount) and Viem's [`createWalletClient`](https://viem.sh/docs/clients/wallet) to create a Stateless 7702 smart account with a Wallet Client signatory:
+Use [`toMetaMaskSmartAccount`](../../reference/api/smart-account.md#tometamasksmartaccount) and Viem's [`createWalletClient`](https://viem.sh/docs/clients/wallet) to create a Stateless 7702 smart account with a Wallet Client signatory:
 
 <Tabs>
 <TabItem value="example.ts">
@@ -413,7 +413,7 @@ export const walletClient = createWalletClient({
 
 With a MetaMask smart account, you can perform the following functions:
 
-- In conjunction with [Viem Account Abstraction clients](configure.md), deploy the smart account
+- In conjunction with [Viem Account Abstraction clients](../configure.md), deploy the smart account
   and [send user operations](send-user-operation.md).
-- [Create delegations](create-delegation/index.md) that can be used to grant specific rights and permissions to other accounts.
+- [Create delegations](../create-delegation/index.md) that can be used to grant specific rights and permissions to other accounts.
   Smart accounts that create delegations are called *delegator accounts*.
diff --git a/delegation-toolkit/guides/smart-accounts/generate-multisig-signature.md b/delegation-toolkit/guides/smart-accounts/generate-multisig-signature.md
@@ -1,24 +1,24 @@
 ---
 description: Learn how to generate a Multisig signature.
-sidebar_position: 5
+sidebar_position: 4
 ---
 
 import Tabs from "@theme/Tabs";
 import TabItem from "@theme/TabItem";
 
 # Generate a multisig signature
 
-The MetaMask Delegation Toolkit supports [Multisig smart accounts](../concepts/smart-accounts.md#multisig-smart-account),
+The MetaMask Delegation Toolkit supports [Multisig smart accounts](../../concepts/smart-accounts.md#multisig-smart-account),
 allowing you to add multiple externally owned accounts (EOA) 
 signers with a configurable execution threshold. When the threshold 
 is greater than 1, you can collect signatures from the required signers 
-and use the [`aggregateSignature`](../reference/api/smart-account.md#aggregatesignature) function to combine them 
+and use the [`aggregateSignature`](../../reference/api/smart-account.md#aggregatesignature) function to combine them 
 into a single aggregated signature.
 
 ## Prerequisites
 
-- [Install and set up the Delegation Toolkit.](../get-started/install.md)
-- [Configure the Delegation Toolkit.](configure.md)
+- [Install and set up the Delegation Toolkit.](../../get-started/install.md)
+- [Configure the Delegation Toolkit.](../configure.md)
 - [Create a Multisig smart account.](create-smart-account.md#create-a-multisig-smart-account)
 
 ## Generate a multisig signature
diff --git a/delegation-toolkit/guides/smart-accounts/send-gasless-transaction.md b/delegation-toolkit/guides/smart-accounts/send-gasless-transaction.md
diff --git a/delegation-toolkit/guides/smart-accounts/send-user-operation.md b/delegation-toolkit/guides/smart-accounts/send-user-operation.md
diff --git a/delegation-toolkit/how-to/_category_.json b/delegation-toolkit/how-to/_category_.json
diff --git a/delegation-toolkit/reference/caveats.md b/delegation-toolkit/reference/caveats.md
diff --git a/vercel.json b/vercel.json
