Deploy a Smart Contract on Scroll

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

Scroll is EVM-equivalent, so contracts deploy using the standard Solidity toolchain — Foundry, Hardhat, or Remix — with a GetBlock endpoint. This guide covers adding the network to a wallet and deploying a first contract to Scroll.

Prerequisites

• Node.js 18+ and a package manager, or Foundry

• An EVM wallet (such as MetaMask) with ETH on Scroll for gas — see Add Network to Your Wallet and Funding Your Deployer

• A GetBlock access token — the endpoint is https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/

• A funded deployer address with ETH on Scroll

Network Details

Property	Value
Network Name	Scroll Mainnet
RPC URL	https://shared.eu-central-1.getblock.io//
Chain ID	534352 (0x82750)
Currency Symbol	ETH
Block Explorer	scrollscan.com

Add Network to Your Wallet

Ethereum Mainnet is pre-configured in MetaMask by default. Scroll is not, so it must be added manually — use the button below or the manual steps that follow.

1

Open your wallet

Open MetaMask (or your EVM wallet of choice).

2

Add a custom network

Open the network selector and choose Add a custom network.

3

Enter network details

Enter the values from the Network Details table above.

4

Confirm the Chain ID

Confirm the Chain ID resolves to 534352.

5

Save and switch networks

Save and switch to the newly added Scroll network.

Funding Your Deployer

Scroll gas is paid in ETH that has been bridged from Ethereum.

• Mainnet — bridge ETH from Ethereum L1 using the official Scroll Bridge. Bridged ETH becomes spendable on Scroll for gas.

• Testnet (Scroll Sepolia, chain ID 534351) — obtain Ethereum Sepolia ETH from a public Sepolia faucet, then bridge it to Scroll Sepolia with the Scroll Bridge in testnet mode.

Deploy with Foundry

1

Install Foundry and initialize

curl -L https://foundry.paradigm.xyz | bash
foundryup
forge init hello-scroll && cd hello-scroll

2

Write the contract

src/Hello.sol

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

contract Hello {
    string public greeting = "Hello, Scroll";

    function setGreeting(string calldata greeting_) external {
        greeting = greeting_;
    }
}

3

Deploy

export SCROLL_RPC_URL=https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/
export PRIVATE_KEY=0xyour_deployer_private_key

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

4

Verify on the block explorer

Scroll uses a Scrollscan (Etherscan-compatible) explorer:

forge verify-contract <DEPLOYED_ADDRESS> src/Hello.sol:Hello \
  --chain-id 534352 \
  --verifier etherscan \
  --verifier-url https://api.scrollscan.com/api \
  --etherscan-api-key <SCROLLSCAN_API_KEY>

Deploy with Hardhat

1

Create the project

mkdir hello-scroll && cd hello-scroll
npm init --yes
npm install --save-dev hardhat
npx hardhat init

2

Configure the network

hardhat.config.js

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

const SCROLL_CHAIN_ID = 534352;

module.exports = {
  solidity: '0.8.24',
  networks: {
    scroll: {
      url: process.env.SCROLL_RPC_URL,
      chainId: SCROLL_CHAIN_ID,
      accounts: [process.env.PRIVATE_KEY]
    }
  },
  etherscan: {
    apiKey: { scroll: process.env.SCROLLSCAN_API_KEY },
    customChains: [
      {
        network: 'scroll',
        chainId: SCROLL_CHAIN_ID,
        urls: {
          apiURL: 'https://api.scrollscan.com/api',
          browserURL: 'https://scrollscan.com'
        }
      }
    ]
  }
};

3

Write the contract

contracts/Hello.sol

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

contract Hello {
    string public greeting = "Hello, Scroll";

    function setGreeting(string calldata greeting_) external {
        greeting = greeting_;
    }
}

4

Deploy

export SCROLL_RPC_URL=https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/
export PRIVATE_KEY=0xyour_deployer_private_key

npx hardhat ignition deploy ./ignition/modules/Hello.js --network scroll

5

Verify on the block explorer

export SCROLLSCAN_API_KEY=your_scrollscan_api_key
npx hardhat verify --network scroll <DEPLOYED_ADDRESS>