For the complete documentation index, see llms.txt. This page is also available as Markdown.

Bridging assets user guide

Who this is for: anyone who wants to move assets between Ethereum (or another chain) and Lumia, without the developer-level detail. For the technical version, with contract-level detail, addresses, and the exact bridge interface, see Bridge assets to/from Lumia L2.

Bridging moves value between two separate chains. Assets on one chain are locked or burned, and a matching representation is released or minted on the other. You need a wallet set up for both the source chain and Lumia before you start. See Getting a wallet if you do not have one yet.

Before you bridge anything

The general shape of a bridge transaction

What follows is the general pattern for bridging a token between two EVM chains. Read it as an outline of what to expect, not as steps to follow against any particular bridge.

The diagram below shows that general pattern. It does not show which bridge Lumia users should use, how long any step takes, or what a bridge charges: none of that is confirmed.

1

Connect your wallet

Connect your wallet to the bridge interface.

2

Select chains and asset

Select the source chain, the destination chain, and the asset.

3

Approve the bridge contract

Approve the bridge contract to move the asset. For ERC-20 tokens this is a separate transaction from the transfer itself.

4

Confirm and wait on the source chain

Confirm the bridge transaction and wait for it to be picked up on the source chain.

5

Wait for the destination chain

Wait for the asset to appear on the destination chain. Some bridges deliver it automatically. Others require a second, separate claim transaction on the destination side.

If something goes wrong

Do not guess at a fix. Do not send a second transaction to try again before you understand why the first one is stuck. Contact support with your transaction hash and both wallet addresses:

Last updated

Was this helpful?