AbstractJS SDK

AbstractJS is Biconomy’s TypeScript SDK for building gas-abstracted, cross-chain applications. It provides a viem-inspired API for managing smart accounts and orchestrating transactions.

When to Use AbstractJS

Use AbstractJS when...

You need fine-grained control over transactions
Building with TypeScript/JavaScript
Want to compose custom DeFi flows
Need runtime parameter injection

Use Supertransaction API when...

Rapid prototyping
Non-TypeScript environments
Pre-built DeFi integrations
Simpler use cases

Core Concepts

Multichain Nexus Account

A smart account that exists across multiple chains with the same address. Supports gas abstraction, batching, and cross-chain orchestration.

const account = await toMultichainNexusAccount({
  signer: wallet,
  chainConfigurations: [
    { chain: optimism, transport: http(), version: getMEEVersion(MEEVersion.V2_1_0) },
    { chain: base, transport: http(), version: getMEEVersion(MEEVersion.V2_1_0) },
    { chain: arbitrum, transport: http(), version: getMEEVersion(MEEVersion.V2_1_0) }
  ]
});

MEE Client

Connects to the Modular Execution Environment—the network that executes your transactions gaslessly across chains.

const meeClient = await createMeeClient({ account });

Instructions

Building blocks for transactions. Can be simple calls or composable operations with runtime values.

const instruction = await account.buildComposable({
  type: "default",
  data: { chainId, to, abi, functionName, args }
});

What You Can Build

Feature	Description
Gasless Transactions	Users pay in any ERC-20 token or you sponsor entirely
Batch Operations	Multiple calls in one transaction
Cross-Chain Flows	Bridge + swap + deposit with one signature
Runtime Injection	Use actual balances at execution time
Smart Sessions	Delegate permissions to agents/bots

Quick Start

npm install @biconomy/abstractjs viem

import { createMeeClient, toMultichainNexusAccount, getMEEVersion, MEEVersion } from "@biconomy/abstractjs";
import { http } from "viem";
import { optimism, base } from "viem/chains";

// 1. Create account
const account = await toMultichainNexusAccount({
  signer: wallet,
  chainConfigurations: [
    { chain: optimism, transport: http(), version: getMEEVersion(MEEVersion.V2_1_0) },
    { chain: base, transport: http(), version: getMEEVersion(MEEVersion.V2_1_0) }
  ]
});

// 2. Create client
const meeClient = await createMeeClient({ account });

// 3. Build and execute
const quote = await meeClient.getQuote({
  instructions: [/* your calls */],
  feeToken: { address: USDC, chainId: base.id }
});

const { hash } = await meeClient.executeQuote({ quote });

Tutorials

Setup

Install and configure AbstractJS

Pay Gas in Tokens

Let users pay fees in ERC-20s

Sponsor Gas

Cover gas costs for users

Batch Calls

Composable single-chain batching

Cross-Chain

Multi-chain orchestration

Composable Batching

Dynamic values at execution time

Welcome

ERC-8211 Smart Batching

Supertransaction API

AbstractJS SDK

When to Use AbstractJS

Use AbstractJS when...

Use Supertransaction API when...

Core Concepts

Multichain Nexus Account

MEE Client

Instructions

What You Can Build

Quick Start

Tutorials

Setup

Pay Gas in Tokens

Sponsor Gas

Batch Calls

Cross-Chain

Composable Batching

​When to Use AbstractJS

Use AbstractJS when...

Use Supertransaction API when...

​Core Concepts

​Multichain Nexus Account

​MEE Client

​Instructions

​What You Can Build

​Quick Start

​Tutorials

Setup

Pay Gas in Tokens

Sponsor Gas

Batch Calls

Cross-Chain

Composable Batching

When to Use AbstractJS

Core Concepts

Multichain Nexus Account

MEE Client

Instructions

What You Can Build

Quick Start

Tutorials