README.md

MetaMask Embedded Wallets Node Examples

Node.js CLI examples using @web3auth/node-sdk for backend custom-auth flows.

These examples are intentionally minimal and focus on:

• JWT-based login with authConnectionId
• Wallet reconstruction through Web3Auth Sapphire networks
• Basic EVM or Solana signing/balance calls

Examples

• EVM Quick Start: custom JWT auth + EVM account/balance/sign message
• Solana Quick Start: custom JWT auth + Solana account/balance/sign message
• Firebase Quick Start: Firebase ID token -> Web3Auth connect -> EVM calls

Quick Start

cd <example-folder>
npm install
npm start

Example:

cd evm-quick-start
npm install
npm start

Before You Run

• Create a project in Web3Auth Dashboard
• Configure a custom auth connection and note its authConnectionId
• Keep your Client ID, authConnectionId, and web3AuthNetwork consistent

Critical Notes

• This repo uses MetaMask Embedded Wallets docs and APIs (legacy web3auth.io/docs links are outdated).
• Node SDK is backend-only and custom-auth-focused; it does not provide social-login UI.
• JWTs must be freshly issued; stale iat values can fail login.
• These examples include demo credentials and keys for learning only. Do not use as-is in production.

Official Docs

• Embedded Wallets Docs
• Node SDK Docs
• Node Quick Start
• Builder Hub Community

License

MIT - see LICENSE.