How to Deploy A Smart Contract on Linea

This guide covers adding the network to a browser wallet, then deploying a simple contract using Foundry and Hardhat — pick whichever you prefer on Linea.

Linea is an EVM-equivalent zkEVM that runs standard EVM bytecode, so contracts deploy with the usual Ethereum tooling such as Foundry, Hardhat, and Remix without modification. This guide covers adding Linea to a wallet and deploying a first contract with Foundry and Hardhat through a GetBlock endpoint.

Prerequisites

• A wallet holding ETH on Linea for gas (see Add Network to Your Wallet below)

• A GetBlock access token from the GetBlock dashboard, used as <ACCESS-TOKEN> in the endpoint https://go.getblock.io/<ACCESS-TOKEN>/

• Node.js version 20 or later, for Hardhat

• A funded deployer address, on Linea Sepolia for testing (see Testnet Faucets)

Network Details

Property	Linea Mainnet	Linea Sepolia Testnet
Chain ID	59144 (0xe708)	59141 (0xe705)
RPC URL	https://go.getblock.io/<ACCESS-TOKEN>/	https://go.getblock.io/<ACCESS-TOKEN>/
Currency Symbol	ETH	ETH
Block Explorer	lineascan.build	sepolia.lineascan.build

Linea is not pre-configured in MetaMask by default. Only Ethereum Mainnet and Sepolia ship pre-configured, so Linea must be added manually or through an add-network button before it appears in the wallet.

Every command below defaults to Mainnet — replace environment variable values with testnet ones for a dry run before touching real funds.

Never commit a real private key. Use environment variables and prefer a throwaway deployer key for testing. Private keys committed to a public repo are drained within seconds by automated bots.

Add Network to Your Wallet

1

Open your wallet

Open MetaMask, or the EVM wallet of choice.

2

Open the network menu

Click the network dropdown at the top of the wallet.

3

Add a network manually

Click Add network, then Add a network manually.

4

Enter the network details

Enter the network details from the Prerequisites section above.

5

Save and switch networks

Save and switch to the newly added network.

Deploy with Foundry

1

Install Foundry

curl -L https://foundry.paradigm.xyz | bash
foundryup

2

Create a project

mkdir linea-deploy && cd linea-deploy
forge init

3

Create a contract

Create src/HelloLinea.sol:

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.30;

contract HelloLinea {
    function hello() external pure returns (string memory) {
        return "Hello from Linea";
    }
}

4

Deploy

export PRIVATE_KEY=<your-deployer-private-key>
export LINEA_RPC_URL=https://go.getblock.io/<ACCESS-TOKEN>/

forge create src/HelloLinea.sol:HelloLinea \
  --rpc-url $LINEA_RPC_URL \
  --private-key $PRIVATE_KEY \
  --broadcast

5

Verify on Block Explorer

LineaScan uses the Etherscan V2 unified API. Use the chain ID and a single Etherscan API key:

export ETHERSCAN_API_KEY=<your-etherscan-api-key>

forge verify-contract <contract_address> \
  src/HelloLinea.sol:HelloLinea \
  --chain-id 59144 \
  --etherscan-api-key $ETHERSCAN_API_KEY

Deploy with Hardhat

1

Create a project

mkdir linea-deploy && cd linea-deploy
npm init -y
npm install --save-dev hardhat
npx hardhat init

Select a JavaScript project when prompted.

2

Configure networks

hardhat.config.js

require('@nomicfoundation/hardhat-toolbox');

const PRIVATE_KEY = process.env.PRIVATE_KEY;

module.exports = {
  solidity: '0.8.30',
  networks: {
    linea: {
      url: 'https://go.getblock.io/<ACCESS-TOKEN>/',
      chainId: 59144,
      accounts: [PRIVATE_KEY]
    },
    lineaSepolia: {
      url: 'https://go.getblock.io/<ACCESS-TOKEN>/',
      chainId: 59141,
      accounts: [PRIVATE_KEY]
    }
  },
  etherscan: {
    apiKey: process.env.ETHERSCAN_API_KEY
  }
};

3

Create a contract

Create contracts/HelloLinea.sol:

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.30;

contract HelloLinea {
    function hello() external pure returns (string memory) {
        return "Hello from Linea";
    }
}

4

Compile and Deploy

Create scripts/deploy.js:

scripts/deploy.js

const hre = require('hardhat');

async function main() {
  const contract = await hre.ethers.deployContract('HelloLinea');
  await contract.waitForDeployment();
  console.log('HelloLinea deployed to:', await contract.getAddress());
}

main().catch((error) => {
  console.error(error);
  process.exitCode = 1;
});

Then compile and deploy:

npx hardhat compile
npx hardhat run scripts/deploy.js --network linea

5

Verify on Block Explorer

npx hardhat verify --network linea <contract_address>

Testnet Faucets

Linea Sepolia

• Linea Faucet — dispenses Linea Sepolia ETH to a connected wallet (verify)

• Bridge Sepolia ETH from Ethereum Sepolia through the Linea Bridge as an alternative to faucets