The Modular Execution Environment (MEE) supports multiple versions of its contract suite. Each version introduces new capabilities around smart accounts, validator configuration, and composability.
This guide helps SDK developers understand and select the appropriate version for their use case.
Versions Table
The table below outlines all supported MEE versions and their core capabilities. Use this to determine the best version for your project based on EVM support, composability, and ERC-7702 compatibility.
Version
Nexus Version
ERC-7702 Support
Composability
Notes
2.2.3
1.3.3
✅ Yes
✅️ Native
Use this for new accounts. Account initialization is single-use per transaction. Bundles the audited ERC-8211 Smart Batching. Reviewed by Pashov Audit Group (July 2026).
2.3.0
1.3.1
✅ Yes
✅️ Native
Release candidate, unaudited, not for production. Built on Nexus 1.3.1. Adds new safe-sa fusion mode that enables Safw accounts with multichain orchestration features
2.2.2
1.3.2
✅ Yes
✅️ Native
Bundles the audited ERC-8211 Smart Batching reference implementation (EF & Biconomy). Audited by Pashov (May 2026).
Bundles the audited ERC-8211 Smart Batching reference implementation (Ethereum Foundation & Biconomy) — the formal standardization of the composability primitives shipped in earlier versions
Expanded composability primitives and pipeline hardening
Audited by Pashov (May 2026)
Opt-in upgrade. Will become the default once the STX API supports it natively.
★
Reachest features prior to v2.2.2
Built on Nexus 1.3.1 with extended composability features
Key Features:
Adds native token runtime injection feature
Adds runtime injection via custom static call (inject ANY return value as an input param at the runtime)
Users signs EIP-712 Data Struct instead of blind Stx hash for the smart-account mode
Allows initializing new Nexus ERC-7702 account via relayer with an owner issued signature (gasless ERC-7702 delegation)
Recommended for projects seeking the latest features for the runtime injection and wanting to provide transparent EIP-712 sig requests for users.
★
Delegated EOA ownership
Built on Nexus 1.2.0 with cutting-edge capabilities
Key Features:
Fully supports ERC-7702, including delegated/upgraded EOAs as direct owners of Smart Contract Accounts (SCAs)
Features native composability — no need for manual module installation
Built on Nexus 1.2.0 with pre-installed MEE K1 validator
Recommended for all new projects seeking the simplest and most battle-tested developer experience.
2.0
Native Composability, No Delegated EOAs
ERC-7702 support with composability built-in
Key Features:
Supports ERC-7702, but does not allow delegated or upgraded EOAs to directly own smart accounts
Includes native composability, reducing setup complexity
Suitable for applications that do not require EOAs as direct smart account owners but want full ERC-7702 support.
1.1
EVM Paris Compatibility with Manual Composability
For chains limited to Paris upgrade opcodes
Key Features:
Does not support ERC-7702
Requires manual installation of composability modules, though the SDK automates this during deployment
Targeted for EVM chains limited to Paris upgrade opcodes (no PUSH0, MCOPY, or TSTORE). Good choice for compatibility-constrained environments.
1.0
Supports all EVM chains prior to the Cancun upgrade
Legacy compatibility for older EVM environments
Key Features:
No ERC-7702 support
Requires manual installation of composability modules, automatically handled by the SDK
Compatible with all EVM environments below the Cancun upgrade
Suitable for legacy or specialized chains where native composability isn’t available but can be enabled via modules.
Recommendation
Use 2.2.3 for new accounts. It is the only version built on Nexus 1.3.3, and version ordering does not indicate which suite to use: 2.3.0 sorts above it but is a release candidate on Nexus 1.3.1.Earlier versions remain available so that accounts already created on them stay derivable and upgradeable. They are not a starting point for new integrations.
import { MEEVersion } from "@your-sdk/core";const version = MEEVersion.V2_2_3;
How to Find Your Current Nexus Version
Not sure which Nexus version your smart account is using? Follow these simple steps to find out:
1
Locate your smart account address
Locate your existing Nexus smart account address on the specific blockchain you’re working with.
2
Open the block explorer
Open the block explorer for that chain (e.g., Etherscan, Polygonscan) and paste the smart account address into the search bar.
3
Navigate to the Contracts tab
Navigate to the Contracts tab on the explorer page.
4
Verify the proxy contract if needed
If the contract is a proxy and the proxy contract isn’t verified yet, you’ll need to verify it first. (If “Read as proxy” option isn’t available, this usually means verification is needed.)
5
Call the getImplementation function
Once verified, go to the Read as proxy section and call the getImplementation function. This will return the address of the actual implementation contract your smart account is using.
6
Compare with official addresses
Compare this implementation contract address against the addresses listed on our Contracts and Audits page. This will help you identify exactly which MEE version you are using.
If you need further assistance, feel free to join our Discord community and ask for help!
Keeping track of your Nexus version is key for smooth upgrades and compatibility checks.
Not Sure Which Version to Choose?
If you’re still confused about which MEE version fits your needs, or if you’re unsure about your current version for migration, don’t worry!Join our Discord community to ask questions and get real-time support from the team and other developers.We’re here to help you choose the best path forward!
Assistant
Responses are generated using AI and may contain mistakes.