Skip to main content

Integration options

MetaMask Connect offers three integration paths. All share the same underlying transport and session infrastructure, so you can start with the option that fits your dapp today and migrate later.

Single-ecosystem

If your dapp targets a single ecosystem, use @metamask/connect-evm or @metamask/connect-solana to add MetaMask Connect to an existing dapp with minimal code changes.

  • EVM: Provides an EIP-1193 compatible provider that works with ethers.js, viem, and web3.js.
  • Solana: Provides a Wallet Standard compatible wallet that works with the Solana wallet adapter ecosystem.

Multi-ecosystem

f your dapp supports both EVM and Solana, use @metamask/connect-evm and @metamask/connect-solana together to support both ecosystems while keeping familiar provider interfaces for each.

Use @metamask/connect-multichain to work directly with the Multichain API. This uses scopes and wallet_invokeMethod instead of per-chain RPC, and supports a single connection prompt across all ecosystems. This is the recommended long-term path.

Compare options

Single-ecosystemMulti-ecosystemMultichain
Packageconnect-evm or connect-solanaBoth connect-evm and connect-solanaconnect-multichain
EffortLow — drop-in providerLow — two providersMedium — scope-based API
EVM supportEIP-1193 providerEIP-1193 providerVia wallet_invokeMethod
Solana supportWallet StandardWallet StandardVia wallet_invokeMethod
Cross-chain UXSingle ecosystemSeparate connect per ecosystemSingle prompt for all ecosystems
SessionsAutomaticAutomatic per-clientFull control
Best forExisting single-chain dappsDapps supporting EVM and SolanaMultichain-native dapps

Wallet connector libraries

If your dapp already uses a wallet connector library, adopting MetaMask Connect is straightforward. In most cases, update a dependency or add a connector with no changes to your application code.

LibraryDocumentation
WagmiQuickstart
RainbowKitQuickstart
ConnectKitQuickstart
Web3AuthQuickstart
DynamicQuickstart