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.
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.