Connect to multiple ecosystems
Use @metamask/connect-multichain to connect to multiple blockchain networks and ecosystems in MetaMask at the same time.
With the multichain client, your dapp can request access to EVM networks, Solana, and future ecosystems in a single connection prompt, instead of using separate connection flows for each chain. This gives you more control than the ecosystem-specific clients, but requires adapting your dapp to work with the Multichain API rather than traditional per-chain RPC.
Jump to the Quickstart to set up MetaMask Connect Multichain in minutes.
How the Multichain API works
MetaMask Connect Multichain is built on the Multichain API (CAIP-25) specification, a chain-agnostic standard for wallet-dapp communication. For the full rationale and specification, see MetaMask Improvement Proposal-5 (MIP-5).
Instead of connecting to one chain at a time, the Multichain API lets you do the following:
- Request access to multiple ecosystems at once: For example, request Ethereum Mainnet, Polygon, and Solana Mainnet in a single session.
- Send requests to any chain in the session: For example, send a Solana transaction and an EVM transaction through the same connection.
- Manage the full session lifecycle: Connect, retrieve session data, invoke methods on any chain, and disconnect — using
connect,getSession,invokeMethod, anddisconnect. These SDK methods wrap the underlying Multichain API (wallet_createSession,wallet_getSession,wallet_invokeMethod,wallet_revokeSession).
For dapps that support both EVM and Solana, this means one session covers both — and users see a single approval prompt.
When to use the multichain client
The multichain client is a good fit when you're:
- Building a new dapp designed from the ground up for multiple ecosystems
- Looking for the best cross-chain UX — one connection prompt for all chains
- Needing full control over the session lifecycle
If you're adding MetaMask Connect Multichain to an existing dapp and want minimal code changes, the ecosystem-specific clients (@metamask/connect-evm or @metamask/connect-solana) are a simpler starting point — you can always migrate later.