docs.whitechain.io

# Whitechain

> Whitechain is an EVM-compatible OP Stack Layer 2 settling on Ethereum, with WBT as the native gas token.

- [Start building on Whitechain](https://docs.whitechain.io/learn/introduction/index.md): Whitechain is an EVM-compatible OP Stack Layer 2 that settles on Ethereum and uses WBT as the native gas token. Start here to connect, build, and deploy.
- [Start with AI](https://docs.whitechain.io/learn/get-started/start-with-ai.md): Route your AI coding assistant or autonomous agent to the right Whitechain integration: llms.txt, llms-full.txt, or the whitechain-dev Agent Skill.
- [Connect to Whitechain](https://docs.whitechain.io/learn/get-started/connect-wallet.md): Add Whitechain Mainnet or the Whitechain Sepolia testnet to an EVM wallet such as MetaMask.
- [Faucet](https://docs.whitechain.io/learn/get-started/get-testnet-wbt.md): Claim test WBT from the Whitechain Sepolia faucet (chain ID 1874) to pay gas while deploying contracts and testing dapps on the L2 network.
- [Deploy a contract](https://docs.whitechain.io/learn/get-started/deploy-a-contract.md): Choose a toolchain to deploy your first smart contract on Whitechain Sepolia: Remix, Hardhat, Foundry, or an AI agent with the whitechain-dev skill.
- [Introduction to Whitechain](https://docs.whitechain.io/learn/general/what-is-whitechain.md): Whitechain is an EVM-compatible Layer 2 blockchain built on the OP Stack, serving as The Onchain Economy Layer. It provides purpose-built infrastructure for businesses to launch, operate, and scale onchain within an ecosystem of 10M+ users.
- [Migration to L2](https://docs.whitechain.io/learn/general/migration.md): The L1 sunset stages, what read-only mode means, the hostname cut-over, and what WBT holders and integrations should know after the L2 Mainnet migration.
- [Getting $WBT](https://docs.whitechain.io/learn/general/get-wbt.md): How to acquire WBT for gas on Whitechain L2: buy on the WhiteBIT exchange, use fiat on-ramps, or bridge ERC-20 WBT from Ethereum mainnet. Information provided herein is for informational purposes only and does not constitute financial, investment, or legal advice, nor a solicitation to purchase digi…
- [Frequently asked questions](https://docs.whitechain.io/learn/general/faq.md): Common questions about Whitechain: what it is and who runs it, Mainnet status, WBT and gas fees, transaction finality, public RPC endpoints and rate limits, contract deployment, wallets, bridging, withdrawals, migration, and the Builders Program.
- [Whitechain Mainnet](https://docs.whitechain.io/learn/network/mainnet.md): Network reference for Whitechain Mainnet: chain ID, endpoints, fees, withdrawal timing, and what changed from the legacy L1.
- [Whitechain Sepolia (testnet)](https://docs.whitechain.io/learn/network/testnet.md): Network reference for the Whitechain Sepolia testnet: how to connect, public RPC limits, fees, and withdrawal timing. This reference is provided for testing and evaluation purposes only. Testnet parameters and endpoints are offered on an "AS IS" and "AS AVAILABLE" basis without uptime SLAs or warran…
- [Network reference](https://docs.whitechain.io/learn/network/reference.md): Chain IDs, public RPC endpoints and their rate limits, explorers, and other parameters for the Whitechain Mainnet and Whitechain Sepolia environments. All network reference data and infrastructure specifications are provided "AS IS" for technical guidance and are subject to modification without prio…
- [Transaction finality](https://docs.whitechain.io/learn/network/transaction-finality.md): How a Whitechain transaction moves from a one-second soft confirmation to Ethereum finality, and what keeps your funds safe at each stage.
- [Network fees](https://docs.whitechain.io/learn/network/network-fees.md): What a transaction costs on Whitechain: the L2 execution fee, the L1 data fee, who receives them, and how to estimate the total in WBT. All fee calculations, network parameters, and valuation estimates are provided "AS IS" for technical guidance and do not constitute a guaranteed price quote or fina…
- [Wallets](https://docs.whitechain.io/build/wallet/wallets.md): Connect MetaMask, Rabby, or Reown to Whitechain, and use Safe for multisig treasury and admin operations.
- [Next dapp template](https://docs.whitechain.io/build/dapps/dapp-with-nextjs.md): Clone the standalone Whitechain Next dapp starter, connect a wallet through Reown AppKit, and read and write the Storage contract on Whitechain Sepolia.
- [Vite dapp template](https://docs.whitechain.io/build/dapps/dapp-with-vite.md): Clone the standalone Whitechain Vite dapp starter, connect a wallet through Reown AppKit, and read and write the Storage contract on Whitechain Sepolia.
- [Connect a wallet with Reown AppKit](https://docs.whitechain.io/build/dapps/connect-wallet-with-reown.md): Add Reown AppKit to an existing app on Whitechain Sepolia: which chain to import, the Turbopack build alias, the RPC override, and which AppKit features Whitechain does not support.
- [Use viem with Whitechain](https://docs.whitechain.io/build/dapps/use-viem.md): Set up a viem client for Whitechain Sepolia and run common operations: read a balance, send WBT, and call a contract.
- [Deploy with Remix](https://docs.whitechain.io/build/deploy/deploy-with-remix.md): Learn how to deploy and verify smart contracts on Whitechain Sepolia using the Remix Online IDE.
- [Deploy with Hardhat](https://docs.whitechain.io/build/deploy/deploy-with-hardhat.md): Learn how to deploy and verify smart contracts on Whitechain Sepolia using the Hardhat development environment.
- [Deploy with Foundry](https://docs.whitechain.io/build/deploy/deploy-with-foundry.md): Deploy and verify a smart contract on Whitechain Sepolia using Foundry and forge from the command line.
- [Verify a proxy contract](https://docs.whitechain.io/build/deploy/verify-proxy-contracts.md): Verify EIP-1967 and UUPS proxy contracts on Whitechain Sepolia with Blockscout: verify the implementation, verify the proxy, and link the two so the proxy tab exposes the implementation's functions.
- [OP Stack canonical bridge](https://docs.whitechain.io/build/bridge/bridge-assets.md): Move assets between Ethereum and Whitechain with the OP Stack canonical bridge: deposits, withdrawals, contract addresses, and alternative bridges.
- [Portal bridge](https://docs.whitechain.io/build/bridge/portal-bridge.md): Move USDC, USDT, WBT, and ETH between Ethereum, Tron, and Whitechain in minutes with the Portal, Whitechain's centralized bridge.
- [Use the Portal bridge](https://docs.whitechain.io/build/bridge/use-the-portal.md): Step by step walkthrough of the Portal bridge app: connect a wallet, choose a route, set a recipient, confirm a transfer, and track it to completion.
- [Quick end-to-end test on testnet](https://docs.whitechain.io/build/bridge/bridge-e2e-testnet.md): Deploy a test token, then run a full canonical bridge deposit and withdrawal on Whitechain Sepolia to verify the flow end to end.
- [Overview](https://docs.whitechain.io/build/block-explorer/overview.md): Inspect Whitechain transactions, addresses, and verified contracts with Blockscout, and read chain data through its API.
- [Wallet indexing example](https://docs.whitechain.io/build/block-explorer/indexer-wallet.md): Read balances, token holdings, and transaction history for any address on Whitechain Sepolia with the Blockscout REST v2 API and ETH JSON-RPC, with copy-paste requests and real responses.
- [Token dashboard indexing example](https://docs.whitechain.io/build/block-explorer/indexer-token-dashboard.md): Show token metadata, holders, and a paginated transfer feed for any token on Whitechain Sepolia with the Blockscout GraphQL and REST v2 APIs, with copy-paste requests and real responses.
- [Gas and network tracker example](https://docs.whitechain.io/build/block-explorer/indexer-gas-tracker.md): Track live gas tiers, coin price, fees, and network stats on Whitechain Sepolia with the Blockscout Etherscan-compatible RPC API and REST v2 stats, with copy-paste requests and real responses.
- [Token list](https://docs.whitechain.io/build/block-explorer/token-list.md): The Uniswap-standard token list for Whitechain: where it is served, what it contains, how to load it in a dapp or wallet, and how to add a token to it.
- [For project partners](https://docs.whitechain.io/build/ecosystem/for-partners.md): Why deploy on Whitechain: deep WhiteBIT integration, exchange-listing pathway, ecosystem co-marketing, and OP Stack technical foundations.
- [Build with AI](https://docs.whitechain.io/build-with-ai/index.md): Resources for AI coding assistants and autonomous agents building on Whitechain: static docs files and installable Agent Skills, agnostic of which agent you run.
- [Feed Whitechain docs to AI tools](https://docs.whitechain.io/build-with-ai/llms-txt.md): Whitechain docs publish llms.txt, llms-full.txt, and a markdown version of every page, so AI assistants can read accurate context directly instead of scraping rendered HTML.
- [Agent Skills](https://docs.whitechain.io/build-with-ai/claude-skills.md): Install the whitechain-dev Agent Skill, a testnet developer playbook for connecting, deploying, verifying, and inspecting contracts on Whitechain Sepolia, agnostic of which AI agent you run.
- [Node operators](https://docs.whitechain.io/operate/run-a-node/overview.md): What a Whitechain RPC node is, how it follows the canonical L2 chain, the available node profiles, and what the node does and does not provide.
- [Run a node](https://docs.whitechain.io/operate/run-a-node/run-a-node.md): Prerequisites and step-by-step instructions to deploy a Whitechain RPC node with op-reth and op-node using Docker Compose.
- [Network artifacts](https://docs.whitechain.io/operate/run-a-node/network-artifacts.md): Download, verify, and regenerate the Whitechain genesis, rollup config, and L1 contract addresses that a node needs to start from the genesis block.
- [Node configuration](https://docs.whitechain.io/operate/run-a-node/configuration.md): Environment variables, network ports, data layout, and RPC limits for Whitechain RPC node profiles.
- [Node maintenance](https://docs.whitechain.io/operate/run-a-node/maintenance.md): Operate, back up, and update a Whitechain RPC node: make targets, datadir backup and restore, the upgrade and hardfork workflow, and security notes.
- [Troubleshooting](https://docs.whitechain.io/operate/run-a-node/troubleshooting.md): Common problems and fixes when running a Whitechain RPC node: missing configuration, artifact validation failures, slow sync, and transaction errors.
- [How the migration works](https://docs.whitechain.io/operate/migration/how-migration-works.md): The freeze and dump procedure that turns the legacy Whitechain L1 state into the L2 Mainnet genesis: the phases, the three allocations, and the tooling that performs each step.
- [Verify the migration](https://docs.whitechain.io/operate/migration/verify-the-migration.md): Check the migrated state yourself: reconcile every account, token and NFT between the legacy Whitechain L1 at the snapshot block and the L2, using the published reconciliation tooling.

## OpenAPI Specs

- [openapi](/api-reference/openapi.json)

## Optional

- [Status](https://status.whitechain.io)
- [Faucet](https://faucet.testnet.whitechain.io)
- [Bridge](https://bridge.testnet.whitechain.io)
- [Explorer](https://explorer.testnet.whitechain.io)
- [Blog](https://whitechain.io/blog)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.