How to add Linea network to MetaMask? (Network Settings)

Adding Linea Network to MetaMask

1. Open MetaMask extension or mobile application and ensure you are logged into your wallet.

2. Click the network selector dropdown, usually located at the top of the interface, next to the account avatar or balance display.

3. Select “Add Network” or “Add a network manually” from the dropdown menu.

4. Enter the required Linea RPC configuration details: Network Name as Linea Mainnet, New RPC URL as https://rpc.linea.build, Chain ID as 59144, Currency Symbol as ETH, and Block Explorer URL as https://lineascan.build.

5. Confirm the addition by clicking “Save” or “Add Network”. The Linea network will appear in your network list immediately after successful configuration.

Verifying Linea Network Connection

1. After adding the network, switch to Linea Mainnet using the network selector.

2. Check if your ETH balance updates — native ETH on Linea is bridged ETH and may not reflect automatically unless previously deposited via the official bridge.

3. Visit https://lineascan.build and paste your wallet address to confirm transaction history and token holdings on Linea.

4. Attempt a small test transaction, such as sending 0.001 ETH to yourself or interacting with a Linea-native dApp like Velocore or SyncSwap.

5. Observe the transaction hash on LineaScan — successful inclusion confirms correct RPC endpoint and chain synchronization.

Common Configuration Errors

1. Using an outdated or unofficial RPC URL — only https://rpc.linea.build is officially supported for mainnet; third-party endpoints may cause timeouts or inconsistent block data.

2. Incorrect Chain ID — entering 59145 (testnet) instead of 59144 leads to failed interactions and misdirected assets.

3. Missing or malformed Block Explorer URL — this prevents MetaMask from generating clickable transaction links, reducing usability during debugging.

4. Currency Symbol set to “LINEA” — Linea uses ETH as its native currency symbol despite being a Layer 2; setting it otherwise causes display inconsistencies in balances and gas estimation.

Security Considerations

1. Never import private keys or seed phrases into unverified websites claiming to “add Linea automatically” — these are phishing vectors designed to steal funds.

2. Double-check the RPC URL spelling — subtle typos like rpc.linea.build vs. rpc.lina.build lead to malicious proxy nodes.

3. Avoid saving custom RPCs with custom port numbers or HTTP prefixes — Linea requires HTTPS and no ports beyond standard 443.

4. Disable “Auto-approve transactions” in MetaMask settings when testing on Linea to prevent accidental approvals of malicious contract calls.

Frequently Asked Questions

Q1. Can I use the same ETH balance on Ethereum and Linea without bridging?No. ETH on Linea is a separate representation secured by zero-knowledge proofs. You must use the official Linea Bridge to move assets between Ethereum and Linea.

Q2. Why does my MetaMask show “0 ETH” after switching to Linea even though I bridged funds?This occurs if the bridge transaction has not yet been finalized or if your wallet address was not properly registered during the bridging process. Wait for confirmation on LineaScan and refresh MetaMask.

Q3. Is it safe to add Linea using the “Detect Network” feature in MetaMask?No. MetaMask’s auto-detection does not currently recognize Linea. Manual entry using official parameters is the only trusted method.

Q4. What happens if I send tokens to a Linea address from Ethereum L1 without using the bridge?Those tokens will be irretrievably lost. Linea addresses are not compatible with Ethereum L1 transfers outside the designated bridge contracts.