Skip to main content Startseite Ersteller johnalbertini14-glitch openclaw-skills smart-accounts-kit
smart-accounts-kit Web3 development using MetaMask Smart Accounts Kit. Use when the user wants to build dApps with ERC-4337 smart accounts, send user operations, batch transactions, configure signers (EOA, passkey, multisig), implement gas abstraction with paymasters, create delegations, or request advanced permissions (ERC-7715). Supports Viem integration, multiple signer types (Dynamic, Web3Auth, Wagmi), gasless transactions, and the Delegation Framework.
Zur Installation springen Skills Marktplatz Entdecken und erkunden Sie KI-Skills, die von der Community erstellt wurden.
Mit Codex oder Claude installieren Kopieren Sie diesen Prompt, fügen Sie ihn in Codex, Claude oder einen anderen Assistant ein und lassen Sie die Skill-Seite prüfen und installieren.
Prompt-Details anzeigen Ein direkter Befehl überspringt den Prüf-Prompt. Prüfen Sie die Quelle, bevor Sie ihn ausführen.
npx skills add https://github.com/johnalbertini14-glitch/openclaw-skills --skill smart-accounts-kitDer Befehl bleibt in einer Zeile. Scrollen Sie horizontal, um ihn vor dem Kopieren vollständig zu prüfen.
Sie bevorzugen eine lokale Kopie? Laden Sie die Dateien herunter, die SkillsMP derzeit vorliegen.
ZIP herunterladen Herunterladen... Mehr aus diesem Repository
Verwandte Berufe SOC
Basierend auf der SOC-Berufsklassifikation
name smart-accounts-kit description Web3 development using MetaMask Smart Accounts Kit. Use when the user wants to build dApps with ERC-4337 smart accounts, send user operations, batch transactions, configure signers (EOA, passkey, multisig), implement gas abstraction with paymasters, create delegations, or request advanced permissions (ERC-7715). Supports Viem integration, multiple signer types (Dynamic, Web3Auth, Wagmi), gasless transactions, and the Delegation Framework. metadata {"openclaw":{"emoji":"🦊","homepage":"https://docs.metamask.io/smart-accounts-kit"}}
Quick Reference
This skill file provides quick access to the MetaMask Smart Accounts Kit v0.3.0. For detailed information, refer to the specific reference files.
📚 Detailed References:
Package Installation
npm install @metamask/smart-accounts-kit@0.3.0
For custom caveat enforcers:
forge install metamask/delegation-framework@v1.3.0
Core Concepts Summary
1. Smart Accounts (ERC-4337)
Three implementation types:
Hybrid (Implementation.Hybrid) - EOA + passkey signersMultisig (Implementation.MultiSig) - Multiple signers with threshold
Stateless7702 (Implementation.Stateless7702) - EIP-7702 upgraded EOA
2. Delegation Framework (ERC-7710) Grant permissions from delegator to delegate:
Scopes - Initial authority (spending limits, function calls)Caveats - Restrictions enforced by smart contractsTypes - Root, open root, redelegation, open redelegationLifecycle - Create → Sign → Store → Redeem
3. Advanced Permissions (ERC-7715) Request permissions via MetaMask extension:
Human-readable UI confirmations
ERC-20 and native token permissions
Requires MetaMask Flask 13.5.0+
User must have smart account
Quick Code Examples
Create Smart Account import { Implementation , toMetaMaskSmartAccount } from '@metamask/smart-accounts-kit'
import { privateKeyToAccount } from 'viem/accounts'
const account = privateKeyToAccount ('0x...' )
const smartAccount = await toMetaMaskSmartAccount ({
client : publicClient,
implementation : Implementation .Hybrid ,
deployParams : [account.address , [], [], []],
deploySalt : '0x' ,
signer : { account },
})
Create Delegation import { createDelegation } from '@metamask/smart-accounts-kit'
import { parseUnits } from 'viem'
const delegation = createDelegation ({
to : delegateAddress,
from : delegatorSmartAccount.address ,
environment : delegatorSmartAccount.environment ,
scope : {
type : 'erc20TransferAmount' ,
tokenAddress : '0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238' ,
maxAmount : parseUnits ('10' , 6 ),
},
caveats : [
{ type : 'timestamp' , afterThreshold : now, beforeThreshold : expiry },
{ type : 'limitedCalls' , limit : 5 },
],
})
Sign Delegation const signature = await smartAccount.signDelegation ({ delegation })
const signedDelegation = { ...delegation, signature }
Redeem Delegation import { createExecution, ExecutionMode } from '@metamask/smart-accounts-kit'
import { DelegationManager } from '@metamask/smart-accounts-kit/contracts'
import { encodeFunctionData, erc20Abi } from 'viem'
const callData = encodeFunctionData ({
abi : erc20Abi,
args : [recipient, parseUnits ('1' , 6 )],
functionName : 'transfer' ,
})
const execution = createExecution ({ target : tokenAddress, callData })
const redeemCalldata = DelegationManager .encode .redeemDelegations ({
delegations : [[signedDelegation]],
modes : [ExecutionMode .SingleDefault ],
executions : [[execution]],
})
const userOpHash = await bundlerClient.sendUserOperation ({
account : delegateSmartAccount,
calls : [{ to : delegateSmartAccount.address , data : redeemCalldata }],
})
const txHash = await delegateWalletClient.sendTransaction ({
to : environment.DelegationManager ,
data : redeemCalldata,
})
Request Advanced Permissions import { erc7715ProviderActions } from '@metamask/smart-accounts-kit/actions'
const walletClient = createWalletClient ({
transport : custom (window .ethereum ),
}).extend (erc7715ProviderActions ())
const grantedPermissions = await walletClient.requestExecutionPermissions ([
{
chainId : chain.id ,
expiry : now + 604800 ,
signer : {
type : 'account' ,
data : { address : sessionAccount.address },
},
permission : {
type : 'erc20-token-periodic' ,
data : {
tokenAddress,
periodAmount : parseUnits ('10' , 6 ),
periodDuration : 86400 ,
justification : 'Transfer 10 USDC daily' ,
},
},
isAdjustmentAllowed : true ,
},
])
Redeem Advanced Permissions
import { erc7710BundlerActions } from '@metamask/smart-accounts-kit/actions'
const bundlerClient = createBundlerClient ({
client : publicClient,
transport : http (bundlerUrl),
}).extend (erc7710BundlerActions ())
const permissionsContext = grantedPermissions[0 ].context
const delegationManager = grantedPermissions[0 ].signerMeta .delegationManager
const userOpHash = await bundlerClient.sendUserOperationWithDelegation ({
publicClient,
account : sessionAccount,
calls : [
{
to : tokenAddress,
data : calldata,
permissionsContext,
delegationManager,
},
],
})
import { erc7710WalletActions } from '@metamask/smart-accounts-kit/actions'
const walletClient = createWalletClient ({
account : sessionAccount,
chain,
transport : http (),
}).extend (erc7710WalletActions ())
const txHash = await walletClient.sendTransactionWithDelegation ({
to : tokenAddress,
data : calldata,
permissionsContext,
delegationManager,
})
Key API Methods
Smart Accounts
toMetaMaskSmartAccount() - Create smart accountaggregateSignature() - Combine multisig signaturessignDelegation() - Sign delegationsignUserOperation() - Sign user operationsignMessage() / signTypedData() - Standard signing
Delegations
createDelegation() - Create delegation with delegatecreateOpenDelegation() - Create open delegationcreateCaveatBuilder() - Build caveats arraycreateExecution() - Create execution structredeemDelegations() - Encode redemption calldatasignDelegation() - Sign with private keygetSmartAccountsEnvironment() - Resolve environmentdeploySmartAccountsEnvironment() - Deploy contractsoverrideDeployedEnvironment() - Override environment
Advanced Permissions
erc7715ProviderActions() - Wallet client extension for requestingrequestExecutionPermissions() - Request permissionserc7710BundlerActions() - Bundler client extensionsendUserOperationWithDelegation() - Redeem with smart accounterc7710WalletActions() - Wallet client extensionsendTransactionWithDelegation() - Redeem with EOA
Supported ERC-7715 Permission Types
ERC-20 Token Permissions Permission Type Description erc20-token-periodicPer-period limit that resets at each period erc20-token-streamingLinear streaming with amountPerSecond rate
Native Token Permissions Permission Type Description native-token-periodicPer-period ETH limit that resets native-token-streamingLinear ETH streaming with amountPerSecond rate
Common Delegation Scopes
Spending Limits Scope Description erc20TransferAmountFixed ERC-20 limit erc20PeriodTransferPer-period ERC-20 limit erc20StreamingLinear streaming ERC-20 nativeTokenTransferAmountFixed native token limit nativeTokenPeriodTransferPer-period native token limit nativeTokenStreamingLinear streaming native erc721TransferERC-721 (NFT) transfer
Function Calls Scope Description functionCallSpecific methods/addresses allowed ownershipTransferOwnership transfers only
Common Caveat Enforcers
Target & Method
allowedTargets - Limit callable addressesallowedMethods - Limit callable methodsallowedCalldata - Validate specific calldataexactCalldata / exactCalldataBatch - Exact calldata matchexactExecution / exactExecutionBatch - Exact execution match
Value & Token
valueLte - Limit native token valueerc20TransferAmount - Limit ERC-20 amounterc20BalanceChange - Validate ERC-20 balance changeerc721Transfer / erc721BalanceChange - ERC-721 restrictionserc1155BalanceChange - ERC-1155 validation
Time & Frequency
timestamp - Valid time range (seconds)blockNumber - Valid block rangelimitedCalls - Limit redemption counterc20PeriodTransfer / erc20Streaming - Time-based ERC-20nativeTokenPeriodTransfer / nativeTokenStreaming - Time-based native
Security & State
redeemer - Limit redemption to specific addressesid - One-time delegation with IDnonce - Bulk revocation via noncedeployed - Auto-deploy contractownershipTransfer - Ownership transfer onlynativeTokenPayment - Require paymentnativeBalanceChange - Validate native balancemultiTokenPeriod - Multi-token period limits
Execution Modes Mode Chains Processing On Failure SingleDefaultOne Sequential Revert SingleTryOne Sequential Continue BatchDefaultMultiple Interleaved Revert BatchTryMultiple Interleaved Continue
Contract Addresses (v1.3.0)
Core Contract Address EntryPoint 0x0000000071727De22E5E9d8BAf0edAc6f37da032SimpleFactory 0x69Aa2f9fe1572F1B640E1bbc512f5c3a734fc77cDelegationManager 0xdb9B1e94B5b69Df7e401DDbedE43491141047dB3MultiSigDeleGatorImpl 0x56a9EdB16a0105eb5a4C54f4C062e2868844f3A7HybridDeleGatorImpl 0x48dBe696A4D990079e039489bA2053B36E8FFEC4
Critical Rules
Always Required
Always use caveats - Never create unrestricted delegationsDeploy delegator first - Account must be deployed before redeemingCheck smart account status - ERC-7715 requires user has smart account
Behavior
Caveats are cumulative - In delegation chains, restrictions stackFunction call default - v0.3.0 defaults to NO native token (use valueLte)Batch mode caveat - No compatible caveat enforcers available
Requirements
ERC-7715 requirements - MetaMask Flask 13.5.0+, smart accountMultisig threshold - Need at least threshold signers7702 upgrade - Stateless7702 requires EIP-7702 upgrade first
Common Patterns
Pattern 1: ERC-20 with Time Limit const delegation = createDelegation ({
to : delegate,
from : delegator,
environment,
scope : {
type : 'erc20TransferAmount' ,
tokenAddress,
maxAmount : parseUnits ('100' , 6 ),
},
caveats : [
{ type : 'timestamp' , afterThreshold : now, beforeThreshold : expiry },
{ type : 'limitedCalls' , limit : 10 },
{ type : 'redeemer' , redeemers : [delegate] },
],
})
Pattern 2: Function Call with Value const delegation = createDelegation ({
to : delegate,
from : delegator,
environment,
scope : {
type : 'functionCall' ,
targets : [contractAddress],
selectors : ['transfer(address,uint256)' ],
valueLte : { maxValue : parseEther ('0.1' ) },
},
caveats : [{ type : 'allowedMethods' , selectors : ['transfer(address,uint256)' ] }],
})
Pattern 3: Periodic Native Token const delegation = createDelegation ({
to : delegate,
from : delegator,
environment,
scope : {
type : 'nativeTokenPeriodTransfer' ,
periodAmount : parseEther ('0.01' ),
periodDuration : 86400 ,
startDate : now,
},
})
Pattern 4: Redelegation Chain
const aliceToBob = createDelegation ({
to : bob,
from : alice,
environment,
scope : { type : 'erc20TransferAmount' , tokenAddress, maxAmount : parseUnits ('100' , 6 ) },
})
const bobToCarol = createDelegation ({
to : carol,
from : bob,
environment,
scope : { type : 'erc20TransferAmount' , tokenAddress, maxAmount : parseUnits ('50' , 6 ) },
parentDelegation : aliceToBob,
caveats : [{ type : 'timestamp' , afterThreshold : now, beforeThreshold : expiry }],
})
Troubleshooting Quick Fixes Issue Solution Account not deployed Use bundlerClient.sendUserOperation() to deploy Invalid signature Verify chain ID, delegation manager, signer permissions Caveat enforcer reverted Check caveat parameters match execution, verify order Redemption failed Check delegator balance, calldata validity, target contracts ERC-7715 not working Upgrade to Flask 13.5.0+, ensure user has smart account Permission denied Handle gracefully, provide manual fallback Threshold not met Add more signers for multisig 7702 not working Confirm EOA upgraded via EIP-7702 first
Resources
NPM: @metamask/smart-accounts-kitContracts: metamask/delegation-framework@v1.3.0ERC Standards: ERC-4337, ERC-7710, ERC-7715, ERC-7579MetaMask Flask: https://metamask.io/flask
Version Info
Toolkit: 0.3.0Delegation Framework: 1.3.0Breaking Change: Function call scope defaults to no native token transfer
For detailed documentation, see the reference files in the /references directory.
