Install and set up the Smart Accounts Kit

This page provides instructions to install and set up the Smart Accounts KitSmart Accounts Kit MetaMask toolkit for creating, managing, and interacting with smart accounts, delegations, and advanced permissions., enabling you to create and interact with MetaMask Smart AccountsMetaMask smart account A single MetaMask Smart Account used to execute transactions through smart-contract account logic. into your dapp.

Prerequisites

• Install Node.js v18 or later.
• Install Yarn, npm, or another package manager.
• If you plan to use any smart contracts (for example, to create a custom caveat enforcer), install Foundry.

Steps

1. Install the Smart Accounts Kit

Install the Smart Accounts Kit:

• npm
• Yarn
• pnpm
• Bun

npm install @metamask/smart-accounts-kit

yarn add @metamask/smart-accounts-kit

pnpm add @metamask/smart-accounts-kit

bun add @metamask/smart-accounts-kit

2. (Optional) Install the contracts

If you plan to extend the Delegation FrameworkDelegation Framework The ERC-7710-based delegation system that combines delegations, scopes, and caveat enforcers to constrain authority. smart contracts (for example, to create a custom caveat enforcer), install the contract package using Foundry's command-line tool, Forge:

forge install metamask/delegation-framework@v1.3.0

Add @metamask/delegation-framework/=lib/metamask/delegation-framework/ in your remappings.txt file.

3. Get started

You're now ready to start using the Smart Accounts Kit. See the MetaMask Smart Accounts quickstart to walk through a simple example.