Native Bridge

Use Bridge

To be able to use the native bridge you need to get whitelisted.

Native bridging is available on Solana devnet. The bridge deposits funds only to SVM for now and uses SVM addresses.

Programs addresses:

# Portal program is the main contract that is used to interact with the Lumio network. 
# It is used to deposit and withdraw funds from the Lumio network.

# Oracle program is used to store the l2 block headers.

# Whitelist program is used to store the list of whitelisted users.

Currently, it's possible to bridge only using the Lumio CLI, so download it from our GitHub.

After downloading, unpack the archive. The lumio-cli executable will appear. In your terminal, run the following in the directory with the CLI:

chmod +x ./lumio-cli

Now you can move the CLI to your binary path. Configure your Solana CLI to Devnet:

solana config set --url

Create an account if needed:

solana-keygen new -o ./keypair.json

Request some Devnet SOL:

solana airdrop 1

Now we are ready to bridge. Run the following command:

lumio-cli deposit-sol 100000000 

Switch your CLI back to the Lumio Devnet:

solana config set --url

Query the account:

solana account <ADDRESS>

It should show the deposited balance on your account.


The bridge is scheduled to launch in early summer. The native bridge will operate similarly to other L2 native bridges:

  1. Send a transaction containing SOL, an SPL token, or an NFT to a Solana Program.

  2. Provide a recipient address.

  3. Specify the VM for the deposit.

  4. The smart contract emits an event.

  5. A sequencer picks up the event and proposes a new deposit transaction to the VM node.

  6. The balance appears on the provided address.


Withdrawals are expected to experience a delay of 3-7 days with Optimism and approximately 7-24 hours with risc0. Initially, before rollup challenging is enabled, there will be a fixed delay of 7 days from the initiation of a withdrawal.

Last updated