Skip to main content

MetaMask Embedded Wallets

Integrate MetaMask Embedded Wallets (formerly Web3Auth) to enable instant, secure, and seamless wallet onboarding for your users on Linea — with no additional code required.

MetaMask Embedded Wallets lets users sign in with familiar logins (Google, Apple, Discord, etc.) and instantly creates a non-custodial wallet connected to Linea.
It’s fast, simple, and fully managed through the MetaMask Dashboard.

🌟 Why Use MetaMask Embedded Wallets on Linea?​

  • Instant onboarding: Use OAuth providers like Google or Apple for quick user authentication
  • Simple configuration: Set up Linea once through the dashboard
  • Non-custodial: Users retain full control of their private keys
  • Cross-platform support: Works on web, mobile, and game engines
  • Web2 - friendly UX: Familiar login and onboarding flows

Key Features​

  • External Wallet Aggregator: Integrates SSO logins with existing crypto wallets (e.g. MetaMask), compatible with EVM and Solana.
    🔗 Docs

  • Flexible Authentication: Supports Google, Facebook, X, passwordless email, and custom OAuth2.0, enabling frictionless Web2-to-Web3 onboarding.
    🔗 Docs

  • Group Connections: Link multiple SSOs using a shared unique ID (e.g. same email) so users can access the same wallet via different logins.
    🔗 Docs

  • Wallet Pregeneration: Create wallets pre-registration using unique identifiers (e.g. email) to pre-fund for airdrops or bonuses.
    🔗 Docs

  • Multi-Factor Authentication: Enforce additional security layers like OTPs or secondary SSOs for sensitive use cases.
    🔗 Docs

  • Cross-Platform SDKs: Available for React, Vue, JavaScript, Android, iOS, React Native, Flutter, Unity, and Unreal—users access the same wallet across devices.

  • Native Smart Accounts: Enable gas sponsorships, batch/automated transactions, spending caps, and automatic paymaster/bundler setup (Infura + Pimlico).
    🔗 Docs

  • UI Flexibility: Choose between prebuilt white-labelled UI or headless SDK for full customization and brand control.
    🔗 Docs

⚙️ 1. Dashboard Configuration (No Code Required)​

All setup happens inside the MetaMask Embedded Wallets Dashboard — no SDK changes or code edits are required.

🪄 Steps​

  1. Go to the MetaMask Embedded Wallets Dashboard.
  2. Select your project or create a new one.
  3. Navigate to the Chains tab.
  4. Search for Linea.
  5. Save your configuration.

✅ Once enabled, all MetaMask Embedded Wallets SDKs (React, Vue, JavaScript) will automatically connect to Linea — no code updates needed.

💻 3. Multi-Platform SDKs​

MetaMask Embedded Wallets supports every major developer environment — so your dApps, mobile apps, and games can all connect seamlessly to Linea.

PlatformSDK Documentation
Reactdocs.metamask.io/embedded-wallets/sdk/react
Vuedocs.metamask.io/embedded-wallets/sdk/vue
JavaScriptdocs.metamask.io/embedded-wallets/sdk/js
Node.jsdocs.metamask.io/embedded-wallets/sdk/node
Androiddocs.metamask.io/embedded-wallets/sdk/android
iOSdocs.metamask.io/embedded-wallets/sdk/ios
React Nativedocs.metamask.io/embedded-wallets/sdk/react-native
Flutterdocs.metamask.io/embedded-wallets/sdk/flutter
Unitydocs.metamask.io/embedded-wallets/sdk/unity
Unreal Enginedocs.metamask.io/embedded-wallets/sdk/unreal

🔗 4. Connecting to Linea​

After enabling Linea on the dashboard, MetaMask Embedded Wallets handles all connection logic automatically.

For JS based SDKs (React, Vue, JS & Node)​

The wallet connects to Linea using the chain configuration you set in the dashboard.
No developer setup required — the provider is pre-configured and ready to use.

For Mobile & Gaming SDKs (Android, iOS, Flutter, Unity, Unreal)​

These SDKs expose a user’s private key securely. Developers can use it with their preferred blockchain library (e.g., ethers.js, web3j, or engine-native signing tools) to interact with Linea RPCs.

Navigate to the dedicated documentation for Linea on MetaMask Embedded Wallets docs.

📚 Learn More​

Want to be featured here?
Have you built a tool for Linea? Contribute to the docs to add it here! See our guide to contributing.