Skip to main content

Delegation Toolkit documentation

Embed MetaMask smart accounts with new capabilities into your dapp.

What's new in v0.9.0?

Breaking changes

The ⚠️ symbol denotes potentially breaking API changes. As per the semantic versioning specification, from v1.0.0 onwards, breaking changes will be released only in major version bumps.

Breaking Changes​

⚠️ Package references​

  • Moved the package from @metamask-private to @metamask organization.
  • Renames the delegator-core-viem entrypoint to delegation-toolkit.
- import { toMetaMaskSmartAccount } from "@metamask-private/delegator-core-viem";
+ import { toMetaMaskSmartAccount } from "@metamask/delegation-toolkit";

⚠️ SimpleFactory address​

Updates the SimpleFactory contract address. Please note, this will result in a change to the smart account address for MetaMaskSmartAccount.

// Delegation enviroment for 1.3.0
export const deployment_1_3_0 = {
//...
- SimpleFactory: '0x6ff518884f21168c30c58CB21184D6AdBC18Ad90',
+ SimpleFactory: '0x69Aa2f9fe1572F1B640E1bbc512f5c3a734fc77c',
//...
}

Enhancements​

⚠️ Package installation​

Package installation no longer requires an authentication token, as it has transitioned out of private alpha. 🎉

Contract addresses​

The following are the contract addresses for the Delegation Framework version 1.3.0, as used by this version of the toolkit.

Delegation Framework​

ContractAddress
EntryPoint0x0000000071727De22E5E9d8BAf0edAc6f37da032
SimpleFactory0x69Aa2f9fe1572F1B640E1bbc512f5c3a734fc77c
DelegationManager0xdb9B1e94B5b69Df7e401DDbedE43491141047dB3
MultiSigDeleGatorImpl0x56a9EdB16a0105eb5a4C54f4C062e2868844f3A7
HybridDeleGatorImpl0x48dBe696A4D990079e039489bA2053B36E8FFEC4

Caveat enforcers​

EnforcerAddress
AllowedCalldataEnforcer0xc2b0d624c1c4319760C96503BA27C347F3260f55
AllowedMethodsEnforcer0x2c21fD0Cb9DC8445CB3fb0DC5E7Bb0Aca01842B5
AllowedTargetsEnforcer0x7F20f61b1f09b08D970938F6fa563634d65c4EeB
ArgsEqualityCheckEnforcer0x44B8C6ae3C304213c3e298495e12497Ed3E56E41
BlockNumberEnforcer0x5d9818dF0AE3f66e9c3D0c5029DAF99d1823ca6c
DeployedEnforcer0x24ff2AA430D53a8CD6788018E902E098083dcCd2
ERC20BalanceGteEnforcer0x433A6A4d9875D87510584fd6cc586eB1c5F8A1d2
ERC20TransferAmountEnforcer0xf100b0819427117EcF76Ed94B358B1A5b5C6D2Fc
ERC20PeriodTransferEnforcer0x474e3Ae7E169e940607cC624Da8A15Eb120139aB
ERC20StreamingEnforcer0x56c97aE02f233B29fa03502Ecc0457266d9be00e
ERC721BalanceGteEnforcer0xA5d03eb350FA89f854685f6313CeCA27A4212542
ERC721TransferEnforcer0x3790e6B7233f779b09DA74C72b6e94813925b9aF
ERC1155BalanceGteEnforcer0x831b76f53601f38BfaCa2e6b442D6A5408Ae375c
ExactCalldataBatchEnforcer0x982FD5C86BBF425d7d1451f974192d4525113DfD
ExactCalldataEnforcer0x99F2e9bF15ce5eC84685604836F71aB835DBBdED
ExactExecutionBatchEnforcer0x1e141e455d08721Dd5BCDA1BaA6Ea5633Afd5017
ExactExecutionEnforcer0x146713078D39eCC1F5338309c28405ccf85Abfbb
IdEnforcer0xC8B5D93463c893401094cc70e66A206fb5987997
LimitedCallsEnforcer0x04658B29F6b82ed55274221a06Fc97D318E25416
NonceEnforcer0xDE4f2FAC4B3D87A1d9953Ca5FC09FCa7F366254f
TimestampEnforcer0x1046bb45C8d673d4ea75321280DB34899413c069
ValueLteEnforcer0x92Bf12322527cAA612fd31a0e810472BBB106A8F
NativeBalanceGteEnforcer0x54e17146b9CCE2642881E0879e06e9D63F7d7606
NativeTokenPaymentEnforcer0x4803a326ddED6dDBc60e659e5ed12d85c7582811
NativeTokenTransferAmountEnforcer0xF71af580b9c3078fbc2BBF16FbB8EEd82b330320
NativeTokenStreamingEnforcer0xD10b97905a320b13a0608f7E9cC506b56747df19
NativeTokenPeriodTransferEnforcer0x9BC0FAf4Aca5AE429F4c06aEEaC517520CB16BD9
OwnershipTransferEnforcer0x7EEf9734E7092032B5C56310Eb9BbD1f4A524681
RedeemerEnforcer0xE144b0b2618071B4E56f746313528a669c7E65c5
SpecificActionERC20TransferBatchEnforcer0x00e0251aaA263dfE3B3541B758A82D1CBA1c3B6D

Supported mainnet networks​

  • Ethereum
  • Polygon
  • Binance Smart Chain
  • Optimism
  • Arbitrum
  • Linea
  • Base
  • Gnosis Chain

Supported testnet networks​

  • Ethereum Sepolia
  • Linea Sepolia
  • Base Sepolia
  • MegaEth
On this page