OneBalance lets you create seamless chain-abstracted experiences with a single API. Instead of integrating with multiple blockchains individually, you can use OneBalance to access tokens across all chains with one simple integration.

This guide uses the Role-Based account configuration. See more on configurations here.

All examples in this guide are 100% free and open-source. Clone the repository to quickly get started, or try the live demo app.

5 Minutes to First Transaction

Follow our quickstart to make your first chain-abstracted transaction in under 5 minutes

Unified Token Access

Access tokens across chains as if they were one token

What You’ll Build

By the end of this quickstart, you’ll create a simple application that lets users interact with tokens across multiple chains using OneBalance’s chain abstraction capabilities.

1

Set up your environment

Get API keys and configure your project with Privy for social login

2

Create a smart contract account

Predict your account address and view aggregated balances across multiple chains in one place

3

Execute a chain-abstracted swap

Swap tokens across chains with no bridging required

4

Track your transaction

Monitor the status of your operations across multiple chains

Key APIs Used in This Guide

As you follow this guide, you’ll interact with several core OneBalance APIs:

You can learn more about these and other APIs in our API Reference.

Key Benefits

Chain Abstraction

No chains to manage - treat multichain interactions as single-chain operations

Gas Abstraction

No native gas tokens needed - pay fees with any token in your balance

No Bridging

Seamlessly interact across chains without manual bridging

Fast Path

Complete transactions up to 10x faster for supported routes

Modular Setup

Choose your preferred account model and wallet provider

Aggregated Balances

View all your assets in one place across chains

Ready to get started? Let’s begin with setting up your environment.