Skip to main content

Migrate a dapp to Linea

Linea is EVM-equivalent, which means any dapp running on another chain compatible with the Ethereum Virtual Machine (EVM) can run on Linea with no changes. Accordingly, all you'll need to do is:

  • Duplicate your existing smart contracts and deploy them on Linea.
  • Configure your dapp to interact with Linea.

Deploy smart contracts

Your dapp's existing contracts must be deployed on Linea. Part one of our quickstart covers this, or you can pick one of multiple contract deployment tooling guides.

Chain information

You may need to update your dapp with Linea chain information, which our network information page covers.

RPC providers

Most major RPC providers support Linea RPC endpoints. Visit our RPC providers page for a non-exhaustive list of public and private endpoints.

note

Not all RPC providers support Linea-specific JSON-RPC API methods such as linea_estimateGas. The node providers page details which providers do support these methods.

Wallet connection

Multiple libraries, including Wagmi and Viem, support Linea wallet connectors.

Check out our wallet connection guide for additional information.

Moving your token

If your project has its own token, we recommend you:

Deploy a canonical token

Deploy and verify your token on Linea as you would on any other EVM-compatible chain.

Add to the token list

With your token deployed, you should make a pull request to add it to the token shortlist on Linea's canonical token list repository, after which it will be reviewed by our team.

Being on the shortlist means that your token will be displayed in the native bridge UI.

Submit metadata to Lineascan

Adding token metadata to Lineascan is not essential, but strongly recommended to support a positive user experience.

See the Lineascan guide.

Linea brand assets

The Linea site has a zip file of official Linea logos and icons available for download, available as both PNGs and SVGs for use in your dapp. If you need some assets or media that aren't covered here, please reach out on Discord.