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.0 | 1.2.1 | ✅ Yes | ⚛️ Native | Experimental and unaudited. Adds new composability features |
2.1.0 | 1.2.0 | ✅ Yes | ✅ Native | Latest stable and recommended. Allows delegated/upgraded EOAs to directly own smart accounts in Nexus 1.2.0. |
2.0.0 | 1.2.0 | ✅ Yes | ✅ Native | Supports ERC-7702 flows but does not support delegated/upgraded EOAs as direct owners of smart accounts. |
1.1.0 | 1.0.2 | ❌ No | ⚠️ Manual | Composability must be installed manually (handled by the SDK). Best for EVM Paris–only chains with limited opcode support. |
1.0.0 | 1.0.2 | ❌ No | ⚠️ Manual | Same as 1.1.0 . Composability module installed via SDK. |
Version Breakdown
- v2.2.0 (Experimental)
- v2.1.0 (Recommended)
- v2.0.0
- v1.1.0
- v1.0.0
★
Experimental and unaudited
Built on Nexus 1.2.1 with extended composability 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)
- Allows initializing new Nexus ERC-7702 account via relayer with an owner issued signature (gasless ERC-7702 delegation)
Recommended for projects in early stages seeking the latest features for the runtime injection.
Recommendation
For most development needs, version2.1.0
is strongly recommended due to its full support for delegated EOAs and native composability. Earlier versions remain available for legacy or specialized chains but require additional setup steps handled by the SDK.
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.
Keeping track of your Nexus version is key for smooth upgrades and compatibility checks.