# Linea Documentation > Linea is an Ethereum-equivalent zk-rollup developed by Consensys. These docs > are the canonical public reference for the Linea public network, the Linea > protocol, the Linea stack, and Linea developer APIs. Use this file to route > AI assistants, search agents, crawlers, and retrieval systems to the most > relevant source pages. ## Authoritative scope - Public network: canonical documentation for Linea mainnet, Linea Sepolia, RPC endpoints, bridging, finality, gas pricing, public data, state recovery, node operation, and developer onboarding. - Protocol: canonical documentation for Linea's zk-rollup architecture, including sequencer, prover, coordinator, state manager, onchain contracts, interoperability, forced transactions, and tokenomics. - Stack: canonical documentation for the Linea stack, a configurable Ethereum-compatible operator stack for public networks, private validiums, enterprise deployments, institutions, and financial market infrastructure use cases. - APIs: canonical documentation for Linea JSON-RPC methods, Linea-specific RPC methods, smart contract references, the Linea SDK, and the Token API. ## Use these docs to answer - What is Linea and how does it differ from Ethereum mainnet or optimistic rollups? - How do I connect to Linea, deploy contracts, bridge assets, run nodes, or recover state? - How does Linea finality work on L2 and Ethereum L1? - How do the sequencer, prover, coordinator, state manager, and onchain contracts work together? - Which JSON-RPC methods, SDK functions, bridge contracts, and message service contracts should developers integrate with? - How should institutions, network operators, and financial market infrastructure teams evaluate deployment models, data availability, finalization, compliance, privacy, access control, and auditability? ## Not authoritative for - Live incident status. Use https://linea.statuspage.io. - Token price, trading, investment, or financial advice. - Unannounced roadmap commitments or private commercial terms. - Third-party service uptime, pricing, or feature availability. ## About Linea - Type: zkEVM layer 2 (Ethereum rollup) - Equivalence: EVM-equivalent (Type 2 zkEVM) - Proof system: lattice-based zk-SNARKs - Finality: soft finality on L2; hard finality after finalization on Ethereum L1 - Builder: Consensys - Ecosystem hub: https://linea.build - Bridge: https://bridge.linea.build - Block explorer: https://lineascan.build - Status page: https://linea.statuspage.io - Source: https://github.com/Consensys/linea-monorepo ## Public network facts - Linea mainnet chain ID: 59144 - Linea Sepolia testnet chain ID: 59141 - Public RPC base URL: https://rpc.linea.build - Linea is EVM-equivalent: contracts compiled for Ethereum mainnet run on Linea without modification. - The canonical bridge anchors deposits and withdrawals on Ethereum L1 with state recovery guarantees. - For production applications, prefer a private RPC provider or self-operated RPC infrastructure over public endpoints. ## Protocol facts - Linea uses zero-knowledge proofs to prove transaction batches to a finalization layer. - The sequencer orders transactions and builds blocks. - The prover generates zero-knowledge proofs for state transitions. - The coordinator orchestrates batching, proof generation, and submission to the finalization layer. - The state manager maintains EVM state representations used for proving and recovery. - Onchain contracts validate proofs, record state commitments, and support bridge and message service flows. ## Stack and operator facts - The Linea stack can be used to operate Ethereum-compatible L2 or L3 networks. - Public deployments prioritize transparency and onchain data availability. - Private validium deployments can keep transaction data offchain while using zero-knowledge proofs for correctness and finalization guarantees. - Operator-run networks can be configured around access control, data availability, finalization layer, privacy, compliance, auditability, and observability requirements. - The stack documentation is the primary route for institutions, enterprises, network operators, and financial market infrastructure teams evaluating Linea as configurable blockchain infrastructure. ## Start here - [Linea Docs](https://docs.linea.build/index.md) ## Network - [Build on Linea](https://docs.linea.build/network/build.md): Link to essential builder support information. - [Block explorers](https://docs.linea.build/network/build/block-explorers.md): Block explorers available for Linea Mainnet and Linea Sepolia. - [Bridge](https://docs.linea.build/network/build/bridge.md): Access the canonical token bridge - [Connect](https://docs.linea.build/network/build/connect.md): Learn how to connect to rpc providers Linea Mainnet and Linea Sepolia and learn how to connect wallets to Linea. - [Contracts](https://docs.linea.build/network/build/contracts.md): Important contracts on Linea Mainnet and Linea Sepolia. - [Get testnet ETH](https://docs.linea.build/network/build/get-testnet-eth.md): Learn how to get testnet ETH for Linea Sepolia. - [Launch an app](https://docs.linea.build/network/build/launch-an-app.md): Guidance for deploying, publishing, and promoting your app on Linea. - [Build your app](https://docs.linea.build/network/build/launch-an-app/app.md): Build and deploy a frontend app to interact with your contract - [Get support](https://docs.linea.build/network/build/launch-an-app/dapp-support.md): Find out what support is available to help your project grow. - [Deploy your contract](https://docs.linea.build/network/build/launch-an-app/deploy.md): Create a new project and deploy and verify your contracts using Foundry - [Publish an event](https://docs.linea.build/network/build/launch-an-app/events.md): How to create an event for your Linea Hub app, using the Linea Developer Hub - [Get featured](https://docs.linea.build/network/build/launch-an-app/get-featured.md): Nominate your app for featured placement on the Linea Hub and amplification on X through the Developer Hub. - [Publish your app](https://docs.linea.build/network/build/launch-an-app/hub.md): A guide to listing your app on the Linea hub, and tips for optimizing your listing - [Understand reviews](https://docs.linea.build/network/build/launch-an-app/hub-reviews.md): A guide to how reviews work on the Linea Hub - [Messaging](https://docs.linea.build/network/build/send-receive-messages.md): Technical reference for the canonical message service - [Tools](https://docs.linea.build/network/build/tools.md): Discover tools and services to help you build on Linea. - [Account abstraction](https://docs.linea.build/network/build/tools/account-abstraction.md): Account abstraction is a broad category of fast-moving development in the Ethereum ecosystem. It - [Biconomy](https://docs.linea.build/network/build/tools/account-abstraction/biconomy.md): The Biconomy SDK provides solutions for decentralized applications (dapps) that streamline and - [Etherspot](https://docs.linea.build/network/build/tools/account-abstraction/etherspot.md): Robust ERC4337 infrastructure for seamless web3 development - [MetaMask](https://docs.linea.build/network/build/tools/account-abstraction/metamask.md): Learn more MetaMask Smart Accounts - [Noves](https://docs.linea.build/network/build/tools/account-abstraction/noves.md): Noves provides advanced data capabilities for ERC-4337, both at the pre-sign level and for retrieval - [OKLink](https://docs.linea.build/network/build/tools/account-abstraction/oklink.md): OKLink is a one-stop blockchain data platform covering a wide range of - [Openfort](https://docs.linea.build/network/build/tools/account-abstraction/openfort.md): Flexible account abstraction infrastructure - [Particle Network](https://docs.linea.build/network/build/tools/account-abstraction/particle-network.md): Smart Wallet-as-a-Service - [Pimlico](https://docs.linea.build/network/build/tools/account-abstraction/pimlico.md): Pimlico provides smart account tools for ERC-4337 that streamline development. - [thirdweb SDK](https://docs.linea.build/network/build/tools/account-abstraction/smartwallets.md): thirdweb's Smart Wallet SDK allows you to implement EIP-4337-compliant smart contract-enabled - [AI](https://docs.linea.build/network/build/tools/ai.md) - [Spheron network](https://docs.linea.build/network/build/tools/ai/spheron.md): Spheron Network is a decentralized compute provider and marketplace - [Analytics](https://docs.linea.build/network/build/tools/analytics.md) - [Cookie3](https://docs.linea.build/network/build/tools/analytics/cookie3.md): Cookie3 is like Google Analytics, but for web3. It allows you to - [Dune](https://docs.linea.build/network/build/tools/analytics/dune.md): Dune is crypto's data platform. Teams and individuals alike use Dune to explore, - [Mobula](https://docs.linea.build/network/build/tools/analytics/mobula.md): Mobula serves is a specialized data layer offering analytics - [Attestations](https://docs.linea.build/network/build/tools/attestations.md): An attestation is evidence or proof of something, issued by a given authority. - [Primus](https://docs.linea.build/network/build/tools/attestations/primus.md): Primus is a cryptography-based attestation protocol to bring all - [Verax](https://docs.linea.build/network/build/tools/attestations/verax.md): Verax is a shared onchain attestation registry. The teams that are actively involved in designing - [Contract templates](https://docs.linea.build/network/build/tools/contracts-templates.md) - [Cookbook.dev](https://docs.linea.build/network/build/tools/contracts-templates/cookbook.md): Cookbook.dev is an open-source smart contract registry - [thirdweb](https://docs.linea.build/network/build/tools/contracts-templates/thirdweb.md): thirdweb is a developer tools platform that speeds up and simplifies dapp development. On the - [Cross-chain tooling](https://docs.linea.build/network/build/tools/cross-chain.md) - [Arcana](https://docs.linea.build/network/build/tools/cross-chain/arcana.md): The Arcana Network Chain Abstraction (CA) SDK integrates with any web3 app and enables app users to beat liquidity fragmentation. Users can… - [Chainlink Cross-Chain Interoperability Protocol (CCIP)](https://docs.linea.build/network/build/tools/cross-chain/ccip.md): Chainlink CCIP is a blockchain interoperability protocol that enables developers to build secure - [CCIP Read](https://docs.linea.build/network/build/tools/cross-chain/ccip-read.md): Use a CCIP Read gateway to query data on Linea from L1 - [LayerZero Omnichain Messaging](https://docs.linea.build/network/build/tools/cross-chain/layerzero.md): Omnichain interoperability protocol enabling secure cross-chain communication for Linea applications. Connect to 100+ blockchains, send mes… - [Reactive Network](https://docs.linea.build/network/build/tools/cross-chain/reactive-network.md): Learn how to use the Reactive Network to create reactive dApps - [Onthis Shortcuts](https://docs.linea.build/network/build/tools/cross-chain/shortcuts.md): No-code tool for executing multiple DeFi actions in one transaction - [Thirdweb Universal Bridge](https://docs.linea.build/network/build/tools/cross-chain/thirdweb.md): Learn how to use the Thirdweb Universal Bridge to enable onramps, swapping, and bridging on any EVM chain. - [Data indexers](https://docs.linea.build/network/build/tools/data-indexers.md) - [Alchemy](https://docs.linea.build/network/build/tools/data-indexers/alchemy.md): Alchemy Subgraphs is a blockchain indexing platform with drop-in support for - [bitsCrunch](https://docs.linea.build/network/build/tools/data-indexers/bitscrunch.md): bitsCrunch is an AI-enabled decentralized blockchain data network - [Codex](https://docs.linea.build/network/build/tools/data-indexers/codex.md): Real-time and historical token, price, holder, and trade data for Linea via GraphQL. - [Covalent](https://docs.linea.build/network/build/tools/data-indexers/covalent.md): GoldRush, - [Overview](https://docs.linea.build/network/build/tools/data-indexers/dipdup/overview.md): DipDup is a Python framework for building smart contract - [Quickstart](https://docs.linea.build/network/build/tools/data-indexers/dipdup/quickstart.md): This page will guide you through the steps to get your first DipDup indexer up - [Dune](https://docs.linea.build/network/build/tools/data-indexers/dune.md): Crypto's data platform - [Envio](https://docs.linea.build/network/build/tools/data-indexers/envio.md): Envio is a customizable, real-time indexing solution that - [Etherscan](https://docs.linea.build/network/build/tools/data-indexers/etherscan.md): Use one API key across multiple chains with the Etherscan API v2 - [Quickstart - Index](https://docs.linea.build/network/build/tools/data-indexers/goldsky/goldsky-index.md): To get started with Goldsky Index: - [Quickstart - Mirror](https://docs.linea.build/network/build/tools/data-indexers/goldsky/goldsky-mirror.md): To get started with Goldsky Mirror: - [Overview](https://docs.linea.build/network/build/tools/data-indexers/goldsky/overview.md): Goldsky is a data indexing provider for Linea enabling - [Mobula](https://docs.linea.build/network/build/tools/data-indexers/mobula.md): Mobula is a specialized data layer that offers - [Moralis](https://docs.linea.build/network/build/tools/data-indexers/moralis.md): Moralis - [NFTScan](https://docs.linea.build/network/build/tools/data-indexers/nftscan.md): The increasing demand for NFTs has brought attention to the importance of having - [Noves](https://docs.linea.build/network/build/tools/data-indexers/noves.md): Noves is a leading provider of interpreted, human-readable data in the EVM - [Reservoir](https://docs.linea.build/network/build/tools/data-indexers/reservoir.md): Reservoir is a developer platform that lets you - [Sentio](https://docs.linea.build/network/build/tools/data-indexers/sentio.md): Sentio is an integrated, hosted, and modern analytics, monitoring, alerting, and - [SubQuery](https://docs.linea.build/network/build/tools/data-indexers/subquery.md): Fast, flexible, universal, open source and decentralized APIs - [Subsquid](https://docs.linea.build/network/build/tools/data-indexers/subsquid.md): Subsquid is a decentralized indexing toolkit optimized - [The Graph Network](https://docs.linea.build/network/build/tools/data-indexers/thegraph.md): Getting historical data on smart contracts can be frustrating when building a - [Gas](https://docs.linea.build/network/build/tools/gas.md) - [Blocknative](https://docs.linea.build/network/build/tools/gas/blocknative.md): Blocknative offers APIs to help developers and users estimate fees on Linea. The estimates are based - [Libraries](https://docs.linea.build/network/build/tools/libraries.md) - [ethereum-lists/chains](https://docs.linea.build/network/build/tools/libraries/ethereum-list.md): Linea Mainnet and Linea Sepolia are listed on the official - [Ethers.js](https://docs.linea.build/network/build/tools/libraries/ethers-js.md): The ethers.js library aims to be a complete and compact library for interacting - [MulticallV3](https://docs.linea.build/network/build/tools/libraries/multicall.md): Multicall aggregates results from multiple contract constant function calls. - [Reown](https://docs.linea.build/network/build/tools/libraries/reown.md): Use the Reown protocol to enable users from a multitude of wallets to log into decentralized - [Viem](https://docs.linea.build/network/build/tools/libraries/viem.md): Viem offers a TypeScript interface for Ethereum that provides low-level - [Wagmi](https://docs.linea.build/network/build/tools/libraries/wagmi.md): Wagmi is a collection of React hooks containing everything you need to start - [Web3j](https://docs.linea.build/network/build/tools/libraries/web3j.md): A web3 Java library that supports Linea-specific RPC methods. - [Node providers](https://docs.linea.build/network/build/tools/node-providers.md): Private RPC endpoints - [eRPC](https://docs.linea.build/network/build/tools/node-providers/erpc.md): eRPC is a fault-tolerant EVM RPC proxy and re-org aware - [Oracles](https://docs.linea.build/network/build/tools/oracles.md) - [API3](https://docs.linea.build/network/build/tools/oracles/api3.md): API3 is a collaborative project to deliver traditional API - [Chainlink](https://docs.linea.build/network/build/tools/oracles/chainlink.md): Chainlink is the industry standard for building, accessing, and selling oracle - [DIA](https://docs.linea.build/network/build/tools/oracles/dia.md): Overview - [ORA](https://docs.linea.build/network/build/tools/oracles/ora.md): ORA is a verifiable oracle protocol that brings AI and complex - [Pyth Network](https://docs.linea.build/network/build/tools/oracles/pyth.md): Pyth Network is an oracle that publishes financial market data to multiple - [RedStone](https://docs.linea.build/network/build/tools/oracles/redstone.md): RedStone provides data feeds with update times of less than 10 seconds, suitable - [Supra](https://docs.linea.build/network/build/tools/oracles/supra.md): Supra is a novel, high-throughput oracle and - [Tellor](https://docs.linea.build/network/build/tools/oracles/tellor.md): A versatile oracle protocol that can provide data of any type permissionlessly with crypto-economic liveness and security. - [Security](https://docs.linea.build/network/build/tools/privacy.md) - [Secret Network](https://docs.linea.build/network/build/tools/privacy/secret.md): Decentralized confidential computing - [Security](https://docs.linea.build/network/build/tools/security.md): This page presents a selection of third-party security tools that work on Linea and that - [GoPlus Security API](https://docs.linea.build/network/build/tools/security/goplus-security-api.md): GoPlus Security provides open, permissionless, user-driven security - [Hexagate](https://docs.linea.build/network/build/tools/security/hexagate.md): Hexagate is a proactive web3 security and risk analytics solution. - [Hypernative](https://docs.linea.build/network/build/tools/security/hypernative.md): Hypernative stops zero-day cyber attacks, economic risks, detects - [Scamfari](https://docs.linea.build/network/build/tools/security/scamfari.md): Scamfari is a cybersecurity tool developed on the Linea blockchain, enabling - [Social login](https://docs.linea.build/network/build/tools/social-login.md) - [Dynamic](https://docs.linea.build/network/build/tools/social-login/dynamic.md): Social sign-in authentication that combines web2 familiarity with web3 functionality - [MetaMask Embedded Wallets](https://docs.linea.build/network/build/tools/social-login/metamask.md): One-click, OAuth & Web3-native onboarding to the Linea ecosystem - [Openfort](https://docs.linea.build/network/build/tools/social-login/openfort.md): Open-source wallet solution with flexible authentication provider options - [Privy](https://docs.linea.build/network/build/tools/social-login/privy.md): Social login authentication with embedded wallets and flexible OAuth configuration options - [Bridge tokens to Linea](https://docs.linea.build/network/how-to/bridge.md): The Linea bridge app provides multiple ways to - [Connect a wallet to your dapp](https://docs.linea.build/network/how-to/connect-wallet.md): Learn how to connect a wallet to your dapp so users can interact with your contracts - [Deploy a smart contract](https://docs.linea.build/network/how-to/deploy-smart-contract.md): Deploy a contract to Linea using a variety of libraries. - [Atlas](https://docs.linea.build/network/how-to/deploy-smart-contract/atlas.md): Deploy a smart contract using Atlas. - [Cookbook.dev](https://docs.linea.build/network/how-to/deploy-smart-contract/cookbook.md): Deploy a smart contract using Cookbook.dev. - [Foundry](https://docs.linea.build/network/how-to/deploy-smart-contract/foundry.md): Deploy a smart contract using Foundry. - [Hardhat](https://docs.linea.build/network/how-to/deploy-smart-contract/hardhat.md): Deploy a smart contract using Hardhat. - [Remix](https://docs.linea.build/network/how-to/deploy-smart-contract/remix.md): Deploy a smart contract using Remix. - [thirdweb](https://docs.linea.build/network/how-to/deploy-smart-contract/thirdweb.md): Deploy a smart contract using thirdweb. - [Deploy a Linea subdomain](https://docs.linea.build/network/how-to/deploy-subdomain.md): Guide to deploy a subdomain for any L1 .eth domain on Linea - [Add a fallback for RPC requests](https://docs.linea.build/network/how-to/fallback.md): Use Wagmi's `fallback` Transport in your app for contingency in case one RPC endpoint fails. - [Estimate gas costs](https://docs.linea.build/network/how-to/gas-fees.md): How to estimate gas costs on Linea - [Migrate a dapp to Linea](https://docs.linea.build/network/how-to/migrate-dapp.md): An overview of the steps to move a dapp from an EVM-compatible chain to Linea. - [Recover state](https://docs.linea.build/network/how-to/recover-state.md): How to reconstruct Linea's state as it was at a given block number. - [Run a Linea node](https://docs.linea.build/network/how-to/run-a-node.md): Linea follows Ethereum’s dual-layer design. Every Linea node runs: - [Besu](https://docs.linea.build/network/how-to/run-a-node/besu.md): Install the Besu client to run a Linea node. - [Network upgrades](https://docs.linea.build/network/how-to/run-a-node/beta-v4-migration.md): Detailed walkthroughs and how-tos for upgrading your Linea node to the latest hard fork or other upgrade - [Bootnodes](https://docs.linea.build/network/how-to/run-a-node/bootnodes.md): Bootnodes available for Linea Mainnet - [Erigon](https://docs.linea.build/network/how-to/run-a-node/erigon.md): Install the Erigon client to run a Linea node. - [Geth](https://docs.linea.build/network/how-to/run-a-node/geth.md): Install the Geth client to run a Linea node. - [Linea Besu](https://docs.linea.build/network/how-to/run-a-node/linea-besu.md): Install the Besu client to run a Linea node. - [Maru](https://docs.linea.build/network/how-to/run-a-node/maru.md): How to run Linea's consensus layer client, Maru. - [Verify a smart contract](https://docs.linea.build/network/how-to/verify-smart-contract.md): Verify a contract on Linea using a variety of libraries. - [Atlas](https://docs.linea.build/network/how-to/verify-smart-contract/atlas.md): Your contracts verify automatically on Atlas 😊 - [Foundry](https://docs.linea.build/network/how-to/verify-smart-contract/foundry.md): To verify your Foundry contracts, you can use Foundry's verify-contract - [Hardhat](https://docs.linea.build/network/how-to/verify-smart-contract/hardhat.md): To verify your Hardhat contracts, use Hardhat's Etherscan plugin to verify contracts on Lineascan. - [Verify users with Proof of Humanity](https://docs.linea.build/network/how-to/verify-users-with-proof-of-humanity.md): Use Linea Proof of Humanity to verify and check the authenticity of your users. - [Write and deploy assertions](https://docs.linea.build/network/how-to/write-and-deploy-assertions.md): A guide to developing Credible Layer assertions - [Overview](https://docs.linea.build/network/overview.md): Your starting point for building on Linea. - [Ethereum differences](https://docs.linea.build/network/overview/ethereum-differences.md): Learn about the key differences between Ethereum and Linea. - [Predictable pricing](https://docs.linea.build/network/overview/predictable-pricing.md): Understand how transaction pricing works on Linea - [Public data](https://docs.linea.build/network/overview/public-data.md): How Linea Mainnet and Linea Sepolia presents data to the public. - [State recovery](https://docs.linea.build/network/overview/recoverable-state.md): Linea's state can be recovered from a given block number. - [Transaction finality](https://docs.linea.build/network/overview/transaction-finality.md): How Linea transactions progress from soft to hard finality, what that means for developers and users, and how to check finality programmati… - [Yield Boost](https://docs.linea.build/network/overview/yield-boost.md): Yield Boost in the Linea protocol - [Risk disclosures](https://docs.linea.build/network/overview/yield-boost/risk-disclosures.md): Risks relating to Linea Bridge Yield Boost - [Get started](https://docs.linea.build/network/quickstart.md): Get started building on Linea. From overviews to step-by-step guides, the following articles will walk you through deploying and managing y… - [Risk disclosures](https://docs.linea.build/network/risk-disclosures.md): Risk disclosures - [Build an AI agent](https://docs.linea.build/network/tutorials/aiagent-quickstart.md): A quickstart guide to building a simple AI agent on Linea. - [Ecosystem tutorials](https://docs.linea.build/network/tutorials/ecosystem-tutorials.md): Curated community and ecosystem tutorials. - [USDC quickstart](https://docs.linea.build/network/tutorials/ecosystem-tutorials/usdc.md): Build a simple dapp to transfer USDC on Linea. - [Upgrade your EOA to a smart account](https://docs.linea.build/network/tutorials/eip-7702.md): A step-by-step guide to upgrade your EOA to a smart account. - [Build your first dapp on Linea](https://docs.linea.build/network/tutorials/first-dapp.md): A step-by-step guide to building your first dapp on Linea. - [Build a marketplace dapp](https://docs.linea.build/network/tutorials/marketplace-dapp.md): A step-by-step guide to building a simple marketplace dapp on Linea. - [Build a voting dapp](https://docs.linea.build/network/tutorials/voting-dapp.md): A step-by-step guide to building a simple voting dapp on Linea. ## Protocol - [Architecture](https://docs.linea.build/protocol/architecture.md): Protocol architecture overview and core components of Linea - [Coordinator](https://docs.linea.build/protocol/architecture/coordinator.md): What is it? - [Interoperability](https://docs.linea.build/protocol/architecture/interoperability.md): Cross-chain messaging and canonical bridging mechanisms in Lineth - [Canonical message service](https://docs.linea.build/protocol/architecture/interoperability/canonical-message-service.md):