Bridging NFTs across layers

Thank you to @vbuterin for his initial post kick-starting this topic: Cross-rollup NFT wrapper and migration ideas


A problem faced within the Ethereum blockchain as well as Layer 2s is the segmentation of assets, especially NFTs. When an NFT is created on a Layer 2, the NFT is stuck on that layer. This leads to the problem of NFT silos, where NFT assets on Layer 2 cannot be withdrawn to Layer 1. Having a way to create and transfer NFTs across multiple layers is important in order to introduce NFT applications to Layer 2s.


Create a way to easily transfer NFTs across layers and reduce the gas requirements by minting the NFTs on Layer 2. This lets the user decide when they would like to withdraw their NFTs to Layer 1.

Overview Diagram

Initializing the NFT Contracts

  1. The Owner will provision the L1_NFT_Collection with the deployed L2_NFT_Collection, specifying:
  • Address of the L2_NFT_Collection
  • Chain ID of the L2_NFT_Collection
  • Location of the NFT, mapping of the Chain ID by the NFT ID
  • Range of Allocated NFTs, e.g. #1-100, 60-61, etc.

Range is a unit of 1000 NFTs… rangeid 0 means NFT #0 to NFT #999.

Data Structure

mapping(chainid => address) addresses;
mapping(rangeid => chainid) range_loc;

Claiming the NFT on Layer 2

  1. The User will claim the NFT, specifying the NFT ID. The L2_NFT_Collection contract on Layer 2 will verify the ID assignment (i.e. this Layer 2 owns the NFT) and mints the NFT on this rollup accordingly. Users can freely transfer NFTs within the rollup as normal.

Withdrawing an NFT

  1. The User sends a transaction to the L2_NFT_Collection smart contract, initiating the withdrawal to a target recipient on Layer 1.

  2. The NFT gets deposited into the L2_Deposit contract, which locks the NFT for later retrieval if necessary.

  3. The Locked NFT triggers a cross-message to the L1_NFT_Collection which allows the designated recipient to mint/withdraw the NFT on Layer 1.

  • A new record in L1_NFT_Collection will be added to update the chain ownership of this particular NFT, data structure: mapping(id=>chainid) nft_loc; nft_loc always overrides range_loc. To determine the actual chain ownership of a NFT, the logic should check nft_loc first then range_loc if nft_loc[id] returns 0.

  • If the NFT was already previously minted on Layer 1 before, i.e. it is not the first time this NFT has been withdrawn to Layer 1, the user would get that NFT with the updated metadata, with its nft_loc updated.

  1. The recipient will claim the NFT, specifying the NFT ID.

(Re)depositing the NFT on Layer 2

  1. The User sends a transaction to the L1_NFT_Collection smart contract, initiating the transition to a target recipient on a target Layer 2 rollup.

  2. The NFT gets deposited into the L1_Deposit contract, which locks the NFT for later retrieval if necessary.

  3. The Locked NFT triggers a cross-message to the L2_NFT_Collection, which allows the user to mint/claim an existing NFT on Layer 2 by the NFT ID.

  • If the NFT was already created and was deposited to the target rollup, the user would recieve the NFT with the updated metadata.

  • L1_NFT_Collection will have nft_loc updated to reflect the updated chain ownership of the NFT.

Sequence Diagrams


Layer 1 => Layer 2

Layer 2 => Layer 1

Pros & Cons


  • Allows any user to claim an NFT on another Layer 2.
  • The User can withdraw the NFT on Layer 2 and have the equivalent NFT created on Layer 1 with no chance of duplication.
  • The User has the option to transfer their created NFT at any time from Layer 1 to Layer 2 and vice versa.
  • Allows one NFT project to extend to multiple rollups.
  • Easy and low cost initial setup.


  • The Owner has to create an equivalent NFT contract on the supported layers.
  • NFTs can only move from Layer 2 to the coordinator chain (Layer 1 in this case) and back, they cannot move from Layer 2 to Layer 2 directly.
  • Higher cost when moving NFTs among rollups because involvement of two Layer 1 transactions (withdraw and deposit)
  • Technical complexity to connect both Layers


Using a rollup to track the chain ownership to reduce the transaction cost

A rollup can be used to manage the chain ownership. In this way, the transaction cost can be greatly reduced. Layer 1 in this case can be treated the same as other rollups to some extent.


I assume you have already seen VB’s Cross-rollup NFT wrapper and migration ideas

1 Like

The core ideas seem quite similar to what I wrote in Cross-rollup NFT wrapper and migration ideas !

Allowing NFTs to be issued in any domain (L1 or an L2 rollup) by pre-allocating some indices to each domain is an excellent idea and definitely needed to prevent confusion from multi-allocation.

The main challenge with using cross-messages directly is that many of these rollups are optimistic rollups which have a 1 week withdrawal delay. This is okay for some exceptional situations (eg. a particular rollup is shutting down completely due to some governance operation, and everyone is getting their assets out), but it’s really inconvenient for normal use. Hence why my proposals make wrapper NFTs accessible instantly, and not just after a week-long wait.

Another issue is that I think it’s not just L1 <-> L2 transfers that we should be thinking about, but also L2 <-> L2 transfers (eg. Optimism <-> Arbitrum). These L2 <-> L2 transfers should not require directly touching L1.


Hi @vbuterin thank you for your response. I re-read your post regarding Cross-rollup NFT wrapper and migration ideas. This implementation is similar to Extension 2, but instead of having a single contract manage all NFTs, where all potentially withdrawn NFTs are pre-created. This implementation instead uses a single NFT-collection contract, where the individual who created the contract owns the NFTs and can set the amount to be allocated on each individual layer. This has the added benefit of allowing each NFT to be tracked and located from the Layer 1 contract, with the assumption that the NFT stays on that layer and is not deposited to another contract outside of the architecture. This allows other users/contracts to see where the NFT is officially located using the Layer 1 contract.

I agree that there is a significant trade-off in the wait time for the transition between layers. Any type of messaging across chain would have to be put in that waiting period. I personally think that the event of transitioning an NFT from a Layer 2 is rare, but necessary to have. The initial idea is to have the ability for NFT projects to support multiple allocations on multiple layers, while still retaining the ability to make a withdrawal to Layer 1/2. Thank you for your thoughts and discussion points related to this design.