Skip to main content

Lamina1 Teleporter Token Bridge

The Lamina1 core team has built a bridge using the Avalanche Interchain Token Transfer contracts, leveraging Avalanche Warp Messaging (AWM) and the Avalanche Teleporter protocol, to allow users to send native or ERC20 tokens between Avalanche C Chain and Avalanche L1’s (previously known as subnets).

This bridge will debut alongside the L1 token listing on [TBD] at [Time/Date TBD] and will enable users to send L1 back and forth across LAMINA1 and Avalanche C Chain –– all within the LAMINA1 Hub environment.

For those unfamiliar, Avalanche Warp Messaging (AWM) is a protocol that enables sending data between L1s on the Avalanche network. The only requirement is that validators of a L1 register their BLS public keys on the Avalanche P chain. The P chain maintains the validator set of each L1, as well as which L1 blockchains exist. Validators on a given L1 can verify a message sent by validators of a different L1 by looking up the BLS public keys on the P chain, and then verifying the BLS signature that is sent together with the message as part of the AWM protocol. In order to allow AWM to be used within EVM execution, Avalanche developed a warp messaging precompile contract, which is active on the C chain as of the Durango upgrade. Furthermore, this precompile can also be activated on the subnet-evm codebase, which is used to launch EVM compatible L1s.

The Teleporter protocol is built on top of AWM and provides a developer-friendly interface for sending and receiving cross-chain messages from within the EVM. Amongst the features it provides, the highlights are replay protection and relay incentivization via fees collected in ERC20 tokens.

The Avalanche Interchain Token Transfer (ICTT) protocol is built on top of Teleporter and AWM and provides a standard interface to send ERC20 and native tokens between Avalanche L1s.

Using the Bridge to Move Tokens Across Networks​

To begin using the new Bridge, sign into your Lamina1 account, then go to your wallet by clicking on your L1 balance at the top of your Hub, or visiting it directly at https://lamina1.com/wallet. 

From there, select the ‘Send’ button, which will pull up a modal you can now use to send L1 or AVAX across the LAMINA1 and Avalanche networks. 

Note: You will likely need to use this feature when using a DEX (Decentralized Exchange) to access liquidity and trade assets. This initial version of the Lamina1 Token Teleporter bridge will essentially allow you to swap tokens across the LAMINA1 and Avalanche networks that wouldn't normally be able to communicate directly with each other. \ \ Keep in mind that because you’re submitting transactions across two chains there may be fees in the local currency of each chain. Depending on your use case you may need both L1 and AVAX on one or more chains to complete a bridge transaction. The table below shows exactly what you’ll need depending on the currency and direction you’re bridging:

To illustrate this, we describe two scenarios:\ \ Scenario 1: You’re new to the network and you want to buy L1 on an Avalanche DEX and transfer it to the Lamina1 network so you can stake it.

  1. Acquire some AVAX from your preferred Exchange (see link below) and send it to your Metamask wallet.
  2. Log in to the DEX with your Metamask wallet and find the L1 - AVAX trading pair
  3. Swap your AVAX for L1 but save at least a small amount (~0.01 AVAX) to pay for gas (see the table above).
  4. Log in to Lamina1.com/wallet with the same Metamask account and send the L1 tokens to yourself, setting the Origin dropdown to Avalanche and the Destination dropdown to Lamina1

Scenario 2: You have some L1 on the Lamina1 chain and want to swap it on the Avalanche DEX for AVAX

  1. If you haven’t yet already, export your private key into Metamask (see here for instructions)
  2. Acquire at least a small amount of AVAX (~.01 AVAX) from your preferred Exchange (see link below) and send it to the Metamask wallet generated from your Hub private key. This is used to pay the bridge fee in the table above.
  3. Log in to Lamina1.com/wallet with the same Metamask account and send the L1 tokens to yourself, setting the Origin dropdown to Lamina1 and the Destination dropdown to Avalanche. You will need to pay the bridge fee in AVAX before the Send button is enabled.
  4. Log in to the DEX with your Metamask wallet and find the L1 - AVAX trading pair
  5. Swap your L1 for AVAX

For information on how to acquire L1, visit: https://medium.com/@LAMINA1/get-assets-l1-avax-airdrop-rewards-tokens-60d19f848b20 

For information on how to acquire and swap AVAX, visit: https://www.avax.network/how-to-buy-sell-trade-cryptocurrency 

For a more in depth explanation, the following diagram shows the user flow for sending L1 back and forth between the Avalanche (C Chain) and LAMINA1 networks:

\ Sending L1 from Lamina1 to Avalanche (orange)

  1. User pays relayer fee in AVAX upfront
  2. User sends L1 to the Bridge contract on Lamina1 with a given destination address
  3. Bridge wraps L1 into Wrapped L1 (WL1) and holds it
  4. Bridge creates a Teleporter message to the Avalanche network
  5. Relayer (operated by Lamina1) sees the WARP message event
  6. Relayer submits transaction containing WARP message to Avalanche
  7. Teleporter Messenger delivers the message to the Bridge contract on Avalanche 
  8. Bridge mints L1 ERC20 and sends it to the destination address

Sending L1 from Avalanche to Lamina1 (blue)

  1. User sends L1 ERC20 to the Bridge contract on Avalanche with a given destination address
  2. Bridge burns L1 ERC20
  3. Bridge creates a Teleporter message to the Lamina1 network
  4. Relayer (operated by Lamina1) sees the WARP message event
  5. Relayer submits transaction containing WARP message to Lamina1
  6. Teleporter Messenger delivers the message to the Bridge contract on Lamina1 
  7. Bridge unwraps WL1 and sends L1 to the destination address

For now, the implementation of be Teleporter into Lamina1 will allow the transfer of L1 to other accounts across the Lamina1 and Avalanche networks. As the Lamina1 platform expands, additional tokens will be supported and the technology can be used to empower increasing cross-chain connectivity and utility between multiple blockchains.