Developer documentation

Omnisea for developers.

Move ERC-20 tokens with Omniassets, create and trade tokens with Omnipad, or fund another chain with Omnigas. Start with current addresses, ABIs and transaction examples.

Send your first transfer View deployments

What Omnisea does

Each product has its own contracts and settlement flow. Omniassets locks, mints, burns and unlocks ERC-20 supply. Omnipad creates tokens through supported launchpads and routes local trades. Omnigas delivers native currency to a recipient on another chain.

Transfer

Lock an original ERC-20 or burn its Omniasset, then deliver it on another chain.

Quote

Calculate the exact native fee for the same arguments you will send onchain.

Track

Follow a transfer from its source transaction to destination delivery by message GUID.

Understand

Review the backing, messaging, failure handling, and trust boundaries.

Choose your path

Start with the client action you need, then use the contract references for exact arguments, events, errors, and LayerZero options.

Launch and trade tokens

Use current Omnipad contracts for Pons creation and local trading on Robinhood.

Bridge native gas

Fund a wallet between Base and Robinhood, with optional programmatic hooks.

Build a transfer flow

Connect React wallet state to discovery, approval, quote, and send actions.

Quote a transfer

Prepare live route arguments and show the current native fee before confirmation.

Track delivery

Read the source GUID and follow delivery or failure on the destination.

Handle client errors

Turn wallet, contract, fee, gas, and network failures into useful UI states.

Find deployments

Copy the current contract addresses and LayerZero endpoint IDs.

Learn how it works

See how originals, Omniassets, vault backing, and delivery fit together.

Programmatic start

This viem example sends an original ERC-20 from BNB Chain to Base. It checks whether Base needs the Omniasset deployed, builds the corresponding receive-gas option, approves the token, and sends with an exact quote.

TypeScript · viem

import { erc20Abi, zeroAddress } from "viem";

const omnisea = "0x7AEEBd64211eB405C081a2085BF712fb5ad2e133";
const token = "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c";
const sourceEid = 30102; // BNB Chain
const dstEid = 30184; // Base
const recipient = account.address;

const representation = await destinationClient.readContract({
  address: omnisea,
  abi: omniseaAbi,
  functionName: "representationFor",
  args: [sourceEid, token],
});
const isFirstTransfer = representation === zeroAddress;

const minimumGas = await sourceClient.readContract({
  address: omnisea,
  abi: omniseaAbi,
  functionName: isFirstTransfer ? "minCreationGas" : "minTransferGas",
});
const receiveGas = minimumGas + minimumGas / 5n;
const u128 = (value: bigint) => value.toString(16).padStart(32, "0");
const options = `0x000301002101${u128(receiveGas)}${u128(0n)}` as const;
const compose = { composer: zeroAddress, gasLimit: 0n, message: "0x" } as const;

const approval = await walletClient.writeContract({
  account,
  address: token,
  abi: erc20Abi,
  functionName: "approve",
  args: [omnisea, amount],
});
await sourceClient.waitForTransactionReceipt({ hash: approval });

const args = [dstEid, token, amount, recipient, isFirstTransfer, compose, options] as const;
const fee = await sourceClient.readContract({
  address: omnisea,
  abi: omniseaAbi,
  functionName: "quoteSendOriginal",
  args,
});

await walletClient.writeContract({
  account,
  address: omnisea,
  abi: omniseaAbi,
  functionName: "sendOriginal",
  args,
  value: fee,
});

Open the complete transfer guide

Documentation directory

Contract methods, client integrations, deployment addresses, and the concepts behind Omniassets.