Skip to content
Open
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Next Next commit
add eoa guide
  • Loading branch information
AyushBherwani1998 committed Dec 12, 2025
commit 32a888b70c355fc0542d7a31057bc359177d9e58
1 change: 1 addition & 0 deletions gator-sidebar.js
Original file line number Diff line number Diff line change
Expand Up @@ -66,6 +66,7 @@ const sidebar = {
items: [
'guides/smart-accounts/signers/dynamic',
'guides/smart-accounts/signers/embedded-wallets',
'guides/smart-accounts/signers/eoa-wallets',
'guides/smart-accounts/signers/privy',
],
},
Expand Down
114 changes: 114 additions & 0 deletions smart-accounts-kit/guides/smart-accounts/signers/eoa-wallets.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,114 @@
---
description: Learn how to use Externally Owned Account (EOA) with MetaMask Smart Accounts.
sidebar_label: EOA (e.g. MetaMask)
keywords: [metamask, smart account, signer, metamask smart account]
---

# Use Externally Owned Account (EOA) with MetaMask Smart Accounts

Externally Owned Account (EOA) are one of the most widely used wallet (e.g. MetaMask, Phantom, and more) whcih consists of public
keypair where the private key is only known to the user. MetaMask Smart Accounts is a signer agnostic implementation that allows you
to use EOA as a signer for MetaMask Smart Accounts.

:::info
This guide is targeted towards React and React-based frameworks. For Vue, see [Wagmi docs](https://wagmi.sh/vue/getting-started).
:::

## Prerequisites

- Install [Node.js](https://nodejs.org/en/blog/release/v18.18.0) v18 or later
- Install [Yarn](https://yarnpkg.com/),
[npm](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm), or another package manager

## Steps

### 1. Install dependencies

Install the [Smart Accounts Kit](https://www.npmjs.com/package/@metamask/smart-accounts-kit) and other dependencies in your project:

```bash npm2yarn
npm install @metamask/smart-accounts-kit wagmi @tanstack/react-query viem
```

### 2. Create the App provider

Once you've created the `AppProvider`, wrap it at the root of your application so
that the rest of your application has access to the Wagmi's and TanStack's context.
This will allow every component inside the provider to use the Wagmi hooks.

For the advance configuration, see [Wagmi's createConfig API reference](https://wagmi.sh/react/api/createConfig).

<Tabs>
<TabItem value = "provider.ts">

```ts
import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
import { ReactNode } from "react";
import { WagmiProvider } from 'wagmi'
import { config } from "./config.ts";

const queryClient = new QueryClient();

export function AppProvider({ children }: { children: ReactNode }) {
return (
<WagmiProvider config={config}>
<QueryClientProvider client={queryClient}>
{children}
</QueryClientProvider>
</WagmiProvider>
);
}
```

</TabItem>

<TabItem value = "config.ts">

```ts
import { createConfig, http } from "wagmi";
import { sepolia } from "viem/chains";

export const config = createConfig({
chains: [sepolia],
transports: {
[sepolia.id]: http(),
},
});
```

</TabItem>
</Tabs>

### 3. Create a smart account

Once the user has connected their wallet, use the [Wallet Client](https://viem.sh/docs/clients/wallet) from Wagmi as the signer to create a
MetaMask smart account.

```ts
import { Implementation, toMetaMaskSmartAccount } from "@metamask/smart-accounts-kit";
import { useAccount, usePublicClient, useWalletClient } from "wagmi";

const { address } = useAccount();
const publicClient = usePublicClient();
const { data: walletClient } = useWalletClient();

// Additional check to make sure the EOA wallet is connected
// and values are available.
if (!address || !walletClient || !publicClient ) {
// Handle the error case
}

const smartAccount = await toMetaMaskSmartAccount({
client: publicClient,
implementation: Implementation.Hybrid,
deployParams: [address, [], [], []],
deploySalt: "0x",
signer: { walletClient },
});
```

## Next steps

- See how to use [MetaMask Embedded Wallets as a signer](./eoa-wallets.md) to make user onboarding journey easier.
- See how to [send a user operations](../send-user-operation.md).
- To sponsor gas for end users, see how to [send a gasless transaction](../send-gasless-transaction.md).
5 changes: 5 additions & 0 deletions smart-accounts-kit/guides/smart-accounts/signers/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,6 +35,11 @@ Checkout the following guides to learn how to configure different signers:
title: "Dynamic",
description: "Learn how to use Dynamic with MetaMask Smart Accounts.",
},
{
href: "/smart-accounts-kit/development/guides/smart-accounts/signers/eoa-wallets",
title: "EOA (e.g. MetaMask)",
description: "Learn how to use EOAs like MetaMAsk with MetaMask Smart Accounts.",
},
{
href: "/smart-accounts-kit/development/guides/smart-accounts/signers/privy",
title: "Privy",
Expand Down
Loading