Practical overview
When it fits
Use the framework when developing Solidity smart accounts that need delegation and ERC-4337 functionality, especially when delegated authority must be limited through caveats.
Who it is for
- Solidity developers building delegation-enabled smart accounts.
- Teams implementing custom DeleGator account logic or signature schemes.
- Developers creating caveat enforcers or crafting restricted delegations for onchain actions.
Documented uses
- Build a DeleGator smart account using its core and an implementation.
- Share authority to invoke onchain actions through delegations.
- Apply restrictions to delegated actions with caveats and Caveat Enforcer contracts.
- Develop custom account implementations or contracts that meet the DeleGator Core interface.
- Build and test the contracts with Foundry, or prepare an RPC-based deployment environment.
Requirements & limits
The framework is available as a public GitHub repository under the Apache-2.0 license. Its README documents Foundry and Solidity 0.8.23.
- A DeleGator proxy uses a selected implementation, so account behavior and signature verification depend on the implementation chosen or built.
- The README says delegations allow any onchain action by default and strongly recommends caveats to add restrictions.
- The EIP-7702 DeleGator Core variant omits UUPS proxy functionality.
- The README distinguishes tagged audited code releases from the working
mainbranch. - Deployment preparation involves environment variables and an RPC URL; scripts using a private key require it.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Prepare a local repository branch
Fork the framework, clone your fork and create a working branch for changes.
Before you start
- A Git installation
- A GitHub account to fork the repository
Steps
Fork the MetaMask/delegation-framework repository.
Clone your fork with the command below.
git clone https://github.com//delegation-framework.gitCreate a working branch with the command below.
git checkout -b feat/example-branch
Expected outcome
A local copy of your fork checked out on a separate working branch.
Guide limitations
- This setup sequence does not build, test or deploy the contracts.
- The README identifies
mainas the working development branch and says pull requests should be based against it.
Prepare the documented deployment environment
Configure environment variables and an RPC environment before selecting a documented deployment script.
Before you start
- Foundry
- An
.env.examplefile copied to.envand populated for the intended deployment scripts - An RPC URL; for local fork-based development, Anvil and a blockchain RPC URL
- A private key for scripts that require it
Steps
Copy
.env.exampleto.envand populate the variables required by the deployment scripts you plan to execute.Load the environment with
source .env.For local fork-based development, start Anvil with
anvil -f; otherwise obtain the RPC URL for deployment.Review the deployment documentation and select the relevant script for the contracts required.
Expected outcome
The documented environment is prepared for local fork-based development or for proceeding to a selected deployment script.
Guide limitations
- This guide stops before executing a deployment; it does not establish that deployment will succeed.
- The repository notes deployment may no longer be required on public chains where DeleGator is in use.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 13 October 2026
- Original website title
- MetaMask/delegation-framework · Official homepage title · retained in its source language

