Integration details: What are you building and where are you integrating Smart Accounts?
Prefer not to say, but my users will need wallets and the delegation framework looks like a path to corporate/SME adoption, the ability to manage a team of wallet holders.
Describe problem/question: What is the specific issue or question?
In your documentation you implicate the concept of an ‘environment’. In general, your documentation is excellent. However, environments is a bit fuzzy.
I assume that by environment, you mean a constellation of deployed contracts, authored by MetaMask in service of Delegation Framework functionality. Right?
If so, then do I need to deploy my own set of these contracts on my target chain? Or have you deployed a set of them on the main chains and these contracts serve everyone?
“When you create a MetaMask smart account, the toolkit automatically resolves the environment based on the version it requires and the chain configured. If no environment is found for the specified chain, it throws an error.”
Bonus question: if I have to deploy them, are there instructions on this? Do I have to keep them updated? Are they proxies?
Platform/chain: not specified (you said “prefer not to say”)
Short answer
“Environment” = the set of contract deployments + config the SDK needs on a particular chain (addresses, relevant ABIs/config for entrypoint/factory/delegation/paymaster/bundler pieces). The SDK resolves an environment for a chain+SDK version so it knows which contracts to call.
If you are using a chain that MetaMask has a published environment for (main nets and many popular testnets), you do NOT need to deploy your own contracts — the SDK will use the published environment. If the SDK cannot find an environment for the chain you’ve configured, then you will need to deploy the contract set yourself (or supply a custom environment object) and point the SDK at it.
Further details & practical notes
What the environment contains: a mapping of contract addresses + any per-chain configuration the SDK requires for features such as Delegation Framework, paymasters, entrypoints, etc. It’s what lets the SDK make calls without you hardcoding addresses.
Auto-resolution: as the docs say, the toolkit resolves an environment based on the SDK version and the chain. If no environment exists for that chain/version it will throw a “no environment found” error.
If you need to deploy: the Smart Accounts/Delegation repo typically includes deployment scripts and instructions in the GitHub repo or SDK packages. You will deploy the same contract set the SDK expects, then either register or pass that environment into the SDK.
Upgrades/proxies: many modern account frameworks use upgradeable patterns; some deployed components may be proxies. If you deploy your own set you will be responsible for running updates if you want to follow new SDK versions or security fixes. If you use MetaMask’s published environments, MetaMask manages those deployments.
What I recommend next
If you want me to check for you: tell me the target chain(s) (or at least whether it’s a public mainnet/testnet vs a private chain) and the SDK version you’re planning to use — I can confirm whether a published environment exists.
If you’ll deploy: I can point you to the deployment instructions and typical steps (grab the repo, run the deployment scripts, provide the generated addresses to the SDK). If you prefer, I can also outline the minimal environment object shape you’d pass into the Smart Account constructor.
If you run into an error (e.g., the SDK throws “no environment found”), the support team will need:
SDK version and platform/chain
Initialization/login code snippet you’re using
Browser console logs or screenshots showing the error
Check whether your target chain already has a published environment (tell me the chain name), or
Show the deployment flow and the environment object shape to pass into the SDK?
Happy to help the next step — say which chain + SDK version and I’ll follow up.
Note: This response was generated by an AI bot and may require further verification. The MetaMask Community Team has tracked this issue and will be responding as soon as possible.
Additionally, we would recommend you to join our biweekly Office Hours to get this resolved even faster. MetaMask Developer Office Hours