Skip to main content

What You’ll Learn

These tutorials show you how to integrate Biconomy with different wallet types. Each wallet provider has two guides:
  • AbstractJS SDK — TypeScript library for frontend and Node.js apps
  • Supertransaction API — REST API for backend services and any language

Embedded Wallets (EIP-7702)

Embedded wallets live inside your application and support EIP-7702 for direct smart account upgrades.

External Wallets (Fusion Mode)

Browser extension wallets like MetaMask require Fusion Mode for MEE orchestration.

Understanding the Basics

Before diving in, here are the key concepts you’ll encounter:

What is an Embedded Wallet?

An embedded wallet is a wallet that lives inside your application rather than being a separate browser extension (like MetaMask). Users can create wallets through email, social login, or other auth methods—no seed phrases needed.

What is an External Wallet?

External wallets are browser extensions like MetaMask, Rabby, and Trust Wallet. They maintain their own security model and don’t allow apps to directly upgrade them to smart accounts.

What is EIP-7702?

EIP-7702 is a new Ethereum standard that upgrades a regular wallet (EOA) into a smart account without changing its address. This means:
  • Users keep their existing address
  • They gain smart account features (gas abstraction, batched transactions)
  • No separate smart contract deployment needed
EIP-7702 works with embedded wallets that allow authorization signing. External wallets like MetaMask use Fusion Mode instead.

What is Fusion Mode?

Fusion Mode enables MEE orchestration for wallets that don’t support EIP-7702. It works by:
  • Using a trigger transaction (permit or approve) to authorize operations
  • Routing execution through a temporary Companion Account
  • Returning all assets to the user’s original wallet
This means any wallet—including MetaMask, Rabby, and Trust—can access gasless, orchestrated transactions.

What is MEE?

MEE (Modular Execution Environment) is Biconomy’s infrastructure that handles:
  • Gas Abstraction — Pay gas fees with any ERC-20 token, or have someone sponsor them
  • Cross-Chain Execution — Execute transactions on multiple chains with one signature
  • Transaction Batching — Bundle multiple operations into a single transaction

Which Approach Should I Use?

FeatureAbstractJS SDKSupertransaction API
SetupTypeScript librarySimple REST calls
Best forFrontend apps, Node.jsBackend services, any language
FlexibilityRich composabilityStandard HTTP requests
Learning curveModerateLow
Both approaches achieve the same result—choose based on your tech stack.

Prerequisites

All tutorials assume you have:
  • Node.js 18+ installed
  • Basic JavaScript/TypeScript knowledge
  • An API key from your chosen wallet provider

Embedded Wallets

ProviderAbstractJS SDKSupertransaction API
PrivyGuideGuide
TurnkeyGuideGuide
ParaGuideGuide

External Wallets

ProviderAbstractJS SDKSupertransaction API
MetaMask / Rabby / TrustGuideGuide