Developer Quick Start Guide

·

Welcome to the Scroll developer ecosystem — a seamless, Ethereum-equivalent Layer 2 platform built for scalability without sacrificing security or compatibility. Whether you're building decentralized applications (dApps), smart contracts, or full-stack Web3 projects, Scroll offers full EVM bytecode equivalence, meaning your favorite Ethereum development tools work out of the box.

This guide walks you through everything you need to get started deploying on Scroll Sepolia Testnet, including testnet ETH acquisition, network configuration, and integration with popular development frameworks like Hardhat, Foundry, Remix, and more.

👉 Discover how to deploy your first contract on a scalable EVM-equivalent network today.

Get Testnet ETH

Before you can deploy on Scroll, you’ll need testnet ETH for gas fees. Here’s how to get started:

  1. Obtain Sepolia ETH using a faucet such as the official Sepolia faucet or through community-supported options.
  2. Bridge to Scroll Sepolia Testnet: Once you have Sepolia ETH, use the Scroll Cross-chain Bridge to transfer your testnet assets from Layer 1 (Sepolia) to Layer 2 (Scroll Sepolia).
💡 Tip: Always verify your wallet is connected to the correct network before initiating any transactions.

For step-by-step instructions, visit the Setup Guide in the user documentation.

Network Configuration

Scroll Sepolia Testnet is fully compatible with Ethereum tooling. Use the following details to configure your development environment:

Scroll Sepolia Testnet Parameters

These values are essential when setting up wallets, IDEs, or deployment scripts.

Configure Development Tools

Thanks to Scroll’s EVM equivalence, integrating with existing Ethereum development tools requires minimal changes. Below are setup instructions for the most widely used frameworks.

Hardhat

Update your hardhat.config.ts (or .js) file to include the Scroll Sepolia network:

const config: HardhatUserConfig = {
  networks: {
    scrollSepolia: {
      url: "https://sepolia-rpc.scroll.io/",
      accounts: process.env.PRIVATE_KEY ? [process.env.PRIVATE_KEY] : [],
    },
  },
};

Ensure your private key is stored securely using environment variables. Deploy using:

npx hardhat run scripts/deploy.ts --network scrollSepolia

Foundry

Deploy contracts via Foundry by specifying the RPC URL and enabling legacy mode if needed:

forge create ContractName --rpc-url https://sepolia-rpc.scroll.io/ --legacy --private-key $PRIVATE_KEY

Legacy mode ensures compatibility with pre-EIP-1559 networks.

Remix Web IDE

Using Remix with MetaMask is one of the fastest ways to deploy on Scroll:

  1. Connect MetaMask and add the Scroll Sepolia network manually using the configuration above.
  2. In Remix, go to Deploy & Run Transactions.
  3. Select Injected Provider - MetaMask from the environment dropdown.
  4. Confirm your wallet is set to Scroll Sepolia and click Deploy.

No extra plugins required — it just works.

Truffle

Ensure you have @truffle/hdwallet-provider installed:

npm install @truffle/[email protected]

Then update truffle-config.js:

const HDWalletProvider = require('@truffle/hdwallet-provider');

module.exports = {
  networks: {
    scrollSepolia: {
      provider: () => new HDWalletProvider(process.env.PRIVATE_KEY, 'https://sepolia-rpc.scroll.io/'),
      network_id: '*',
    },
  },
};

Brownie

Add Scroll Sepolia directly via command line:

brownie networks add Ethereum scrollSepolia host=https://sepolia-rpc.scroll.io/ chainid=534351

Set it as default in your brownie-config.yaml:

networks:
  default: scrollSepolia

Alternatively, import a custom YAML config:

live:
  - name: Ethereum
    networks:
      - chainid: 534351
        explorer: https://sepolia-blockscout.scroll.io/
        host: https://sepolia-rpc.scroll.io
        id: scrollSepolia
        name: Scroll Sepolia Testnet

Import with:

brownie networks import ./network-config.yaml

Deploy using:

brownie run scripts/deploy.py --network scrollSepolia

ethers.js

Initialize a provider pointing to Scroll Sepolia:

import { ethers } from 'ethers';

const provider = new ethers.JsonRpcProvider('https://sepolia-rpc.scroll.io/');

You can now interact with contracts, sign transactions, and listen to events — all using standard ethers.js patterns.

Scaffold-eth

Scaffold-eth users can deploy on Scroll with minor adjustments.

Configure Hardhat

In packages/hardhat/hardhat.config.js, set the default network:

const defaultNetwork = 'scrollSepolia';

module.exports = {
  networks: {
    scrollSepolia: {
      url: 'https://sepolia-rpc.scroll.io/',
      accounts: {
        mnemonic: mnemonic(),
      },
    },
  },
};

Generate a wallet and check balance:

yarn generate
yarn account

Then deploy:

yarn deploy --network scrollSepolia

Configure Frontend

Add Scroll Sepolia to packages/react-app/src/constants.js:

export const NETWORKS = {
  scrollSepolia: {
    name: 'scrollSepolia',
    color: '#e9d0b8',
    chainId: 534351,
    rpcUrl: 'https://sepolia-rpc.scroll.io/',
    blockExplorer: 'https://sepolia-blockscout.scroll.io',
  },
};

Set it as the default network in App.jsx:

const initialNetwork = NETWORKS.scrollSepolia;

Your dApp will now load on Scroll by default.

👉 Start building high-performance dApps on an EVM-equivalent Layer 2 today.

Frequently Asked Questions

Q: Is Scroll fully EVM equivalent?
A: Yes. Scroll uses zkEVM technology to achieve bytecode-level EVM equivalence, ensuring full compatibility with existing Ethereum tooling and smart contracts.

Q: Do I need special tools to develop on Scroll?
A: No. Standard Ethereum development tools like Hardhat, Foundry, Remix, and Truffle work without modification — just update the RPC endpoint and chain ID.

Q: How do I verify my smart contract on Scroll?
A: You can verify contracts using Sourcify or through Blockscout’s verification portal at https://sepolia-blockscout.scroll.io.

Q: Can I use MetaMask with Scroll?
A: Absolutely. Add the Scroll Sepolia network manually using the RPC URL and chain ID provided in this guide.

Q: Are there any gas differences between Ethereum and Scroll?
A: Gas costs on Scroll are significantly lower than Ethereum mainnet due to its Layer 2 architecture, while maintaining the same gas pricing model.

Q: What happens after testing on Sepolia?
A: Once ready, you can migrate your contracts to Scroll Mainnet using the same deployment process — just switch to the mainnet RPC and credentials.

What’s Next?

Now that your environment is set up, consider exploring advanced topics such as:

👉 Accelerate your Web3 development with a scalable, secure, and EVM-equivalent platform.

Scroll empowers developers to build without compromise. With seamless tooling integration, low-cost deployments, and Ethereum-grade security, it's never been easier to scale your dApp.