On this page
How Omniassets work
Omniassets lets an existing ERC-20 move to another supported chain without a token-team bridge deployment. The original token remains on its original chain; deterministic representations carry its transferable supply elsewhere.
The three transfer cases
Original to another chain
- The user approves
Omniseaand callssendOriginal. OmniseaVaultreceives and records the original tokens.- The Router sends the asset identity and amount through LayerZero.
- The destination deploys the Omniasset if needed.
- The destination mints the Omniasset to the recipient.
Omniasset to another destination
- The user calls
sendOFT; no ERC-20 approval is required. - The source Omniasset is burned.
- The destination mints the same asset identity to the recipient.
Omniasset back to its origin
- The source Omniasset is burned.
- The original-chain Vault releases the corresponding original tokens.
Supply does not move as the same contract instance. It is burned or escrowed on one chain before it is minted or unlocked on another.
Contract modules
The public interface is split into small, non-upgradeable contracts:
| Module | Responsibility |
|---|---|
Omnisea | User entrypoint, accounting, quoting, sending, and asset discovery |
OmniseaRouter | LayerZero transport, peer validation, and failed-message storage |
OmniseaRegistry | Original identity, frozen metadata, and deterministic Omniasset deployment |
OmniseaVault | Original ERC-20 custody and locked-balance accounting |
OmniseaFeesManager | Protocol-fee accounting and distribution |
OFT | ERC-20 representation with bridge-only mint and burn |
An application normally interacts only with Omnisea and the selected ERC-20.
One interface on every EVM chain
The public core and shared modules use the same addresses across all supported EVM chains. The transfer API therefore stays the same when users change their source or destination.
The values that do change per route are:
- connected EVM chain ID;
- LayerZero source and destination EIDs;
- token role on the source;
- whether the destination Omniasset already exists;
- LayerZero execution fee and receive gas.
See Transfer for the contract flow and Asset identity for representation discovery.