Skip to main content
All forward-looking roadmap schedules, Mainnet launch dates, and specifications are subject to change without prior notice.

General

Whitechain is an EVM-compatible Layer 2 built on the OP Stack, developed in alignment with the WhiteBIT ecosystem. It settles on Ethereum through blob data availability and uses WBT (WhiteBIT Coin) as the native gas token. At launch, a single sequencer node is run by a designated infrastructure operator under the standard OP Stack consensus configuration. Sequencer management operates independently of user dApps, and the protocol roadmap targets progressive transition to permissionless, decentralized sequencing. See Introduction to Whitechain.
Yes. Whitechain Mainnet runs on chain ID 1875 since 26 October 2026, and Whitechain Sepolia (chain ID 1874) is the public testnet. See the Network reference.
The OP Stack separates execution, data availability, and settlement into distinct layers. Every transaction’s data is published and settled on Ethereum, so Whitechain inherits Ethereum’s security and data-durability guarantees instead of carrying its own. This technical design relies on underlying Ethereum mechanics; Whitechain provides no independent warranties regarding Ethereum network integrity. The chain keeps full EVM compatibility, so any contract or toolchain that works on Ethereum works on Whitechain. The OP Stack also underlies Base, Optimism, and the wider Superchain, which gives Whitechain shared tooling and a path toward decentralized sequencing.
Nothing was required from you. At L2 Mainnet launch the full L1 state migrated into the L2 genesis automatically. Native WBT balances were preserved to the wei, and contracts kept their bytecode, storage, nonces, and addresses. ERC-20 and other token balances lived in contract storage, so they migrated with it. Transaction history and pending mempool transactions were not carried over; only final state was. After the snapshot block the L1 answers read methods only, and its history stays readable on https://legacy.explorer.whitechain.io. Users and application operators are solely responsible for archiving historical L1 data prior to decommissioning; Whitechain assumes no liability for unexported data loss. See Migration to L2.
No. The migration ran on 26 October 2026, and holders had nothing to claim, swap, or unlock. See Migration to L2.
Chain ID 1875 and https://rpc.whitechain.io are unchanged and now serve the L2. Update fee logic: the L2 uses EIP-1559 with a 5 gwei base fee floor plus an L1 data fee, and produces a block every second. eth_chainId returns 0x753 on both the L2 and the legacy L1, so do not use it to tell them apart. Read L1 history from https://legacy.explorer.whitechain.io.
Blocks arrive every second, and that inclusion is the sequencer’s word only. Your transaction becomes safe when its batch is confirmed on Ethereum, up to about 30 minutes, and finalized about 13 minutes after that. Only finalization is irreversible. See Transaction finality.
A designated infrastructure operator runs the single sequencer at launch strictly on an “AS IS” and “AS AVAILABLE” technical basis, without operational SLAs, uptime warranties, or liveness guarantees. Sequencer liveness does not compromise protocol security. In the event of sequencer downtime, latency, or transaction omission, the open-source OP Stack architecture allows users to bypass the sequencer and force transaction inclusion. That path runs directly through the L1 OptimismPortal smart contract on Ethereum. See What keeps your funds safe.
For WBT held on the exchange, use WhiteBIT support. For integration, node, or contract questions, use the Whitechain Discord. Migration dates are announced on X and in the Whitechain Telegram channel. Support never asks for your seed phrase, private key, or a wallet signature to complete a migration step. See Where to get help.

Fees and WBT

You pay gas in WBT, the native gas token, configured as the OP Stack custom gas token with 18 decimals. Every fee on Whitechain is paid in WBT, regardless of network, so you need a WBT balance to send any transaction. WBT is the native operational gas asset of Whitechain, powering transactions across The Onchain Economy Layer while providing broad ecosystem utility. See Network fees.
A fee has two parts: the L2 execution fee (gas used times the gas price) and the L1 data fee for publishing your transaction to Ethereum. At the 5 gwei base-fee floor, a plain WBT transfer of 21,000 gas costs about 0.000105 WBT to execute, well under one cent at $50 per WBT. Deploying a small contract costs about 0.0006 WBT, roughly three cents at that price. Cost calculations and token price references are purely illustrative and non-binding; actual transaction costs fluctuate based on dynamic L1 and L2 market conditions. The L1 data fee is added on top and tracks Ethereum’s gas price, so totals rise when Ethereum is busy. See Network fees.
Buy WBT on WhiteBIT, through the Convert tool or a fiat deposit, then withdraw it to your Whitechain address. WhiteBIT users withdraw WBT directly to Whitechain from the exchange UI, with no third-party bridge in between. Exchange purchases and withdrawals remain subject to WhiteBIT’s Terms of Use, legal restrictions, and KYC/AML verification. See Getting WBT.
Claim test WBT from the faucet at faucet.testnet.whitechain.io. Add Whitechain Sepolia to your wallet first, using chain ID 1874 and the RPC at https://rpc.testnet.whitechain.io/. Sign in with a GitHub account at least 30 days old. The standard drip is 0.5 WBT per 24-hour rolling window. Test WBT has no real value and cannot be bridged to mainnet. See Faucet.
The explorer may show only the L2 execution fee. The L1 data fee for publishing your transaction to Ethereum is charged on top of it, and the difference is that fee. Both parts are always charged. See Network fees.
Yes. The network does the work up to the point of failure, so you pay for the gas used, and both fee parts are charged. Nothing is refunded. Set a sufficient gas limit so a contract call does not run out partway through. See Network fees.
The L2 base fee follows EIP-1559 with elasticity 6 and denominator 100, so a full block raises it by 5%, an empty block lowers it by 1%, and it never drops below the 5 gwei base fee floor. The L1 data fee is the variable part: it tracks Ethereum’s base fee and blob base fee, so your total rises when Ethereum is busy. See Fee parameters.

For developers

Yes. Whitechain keeps full EVM compatibility, so any contract or toolchain that runs on Ethereum runs on Whitechain without modification. Deploy with Hardhat, Foundry, Remix, or any Ethereum library. Developers are solely responsible for conducting independent security audits and verifying regulatory compliance of their deployed code. See Deploy a contract.
Both networks are live.WebSocket endpoints are wss://rpc.whitechain.io/ws for Whitechain Mainnet and wss://rpc.testnet.whitechain.io/ws for Whitechain Sepolia. See the Network reference.
Whitechain Sepolia is a standard EVM network, so you add it by chain ID and RPC URL and need no Whitechain-specific plugin. Deploy with your usual toolchain, then verify the source on the explorer or Sourcify. The Deploy with Hardhat guide covers the full deploy-and-verify flow; Remix and Foundry guides are also available.
Use Whitechain Sepolia (chain ID 1874), the public test environment for dapp deployment, integration testing, and claiming test WBT from the faucet. See Connect to Whitechain.
Any standard EVM wallet. Whitechain documents MetaMask, Rabby, and Reown (formerly WalletConnect) for everyday signing, and Safe for multisig treasury and admin operations. No Whitechain-specific plugin exists, because you add the network by chain ID and RPC URL. Third-party wallets are external tools operated by independent entities; Whitechain disclaims all liability for their software security or operational failures. See Wallets.
No. Use the Ethereum libraries you already use. viem includes OP Stack support, so it returns the L1 data fee and keeps working across network upgrades without edits to your code. See Use viem with Whitechain.

Public RPC and infrastructure

Yes, per client IP address, with the same limits on Mainnet and Sepolia. You get 50 requests per second, plus a burst allowance of 500 requests above that. When you exceed it, the endpoint returns HTTP 429 Too Many Requests with a Retry-After header. The limiter counts each HTTP request, so batching several calls into one request helps. See Public RPC endpoints.
No. The public RPC and WebSocket endpoints need no API key and no IP allowlist. Reads and writes are open to any client, subject to the limits above.
The endpoint returns HTTP 429 Too Many Requests with a Retry-After header. Retry with exponential backoff, starting from the Retry-After value. A client that retries immediately stays above the limit and keeps failing. Batch related calls into one JSON-RPC request, because the limiter counts one HTTP request per batch. Subscribe to newHeads over WebSocket instead of polling eth_blockNumber, and cache receipts and finalized blocks on your side. See Working within the limits.
Not yet. Whitechain is evaluating partnerships with commercial RPC providers, and partner endpoints are published in the Public RPC endpoints table when they go live. Until then, https://rpc.testnet.whitechain.io and wss://rpc.testnet.whitechain.io/ws are the only public endpoints for Whitechain Sepolia, and https://rpc.whitechain.io and wss://rpc.whitechain.io/ws for Whitechain Mainnet. Treat any other endpoint claiming to serve chain ID 1874 or 1875 as unofficial.
Yes. Whitechain Mainnet exposes wss://rpc.whitechain.io/ws, and Whitechain Sepolia exposes wss://rpc.testnet.whitechain.io/ws. Both serve the standard Ethereum JSON-RPC API and support eth_subscribe for newHeads and logs. Sepolia also serves newPendingTransactions; Mainnet does not. Reuse one connection for multiple subscriptions rather than opening a connection per query. See WebSocket and subscriptions.
No, and there is no stream to read yet: Flashblocks are not enabled on Whitechain Mainnet or Whitechain Sepolia. When they are, the stream is separate from the public RPC, which does not carry it. See Flashblocks.
Run your own node. The stack is a pair of services, op-reth and op-node, and ships three profiles: full-snap-node (recommended default), full-node, and archive-node. Archive is the one required for historical tracing and eth_call at old blocks. Your node holds no Whitechain keys and forwards eth_sendRawTransaction to the public RPC. See Node operators.
Yes to both. Whitechain uses Blockscout, and its API is public, read-only, and needs no API key. It is rate limited per IP, so batch related lookups and cache results. For sustained querying across full chain history, run your own indexer or Blockscout instance. See Block explorer overview.
Check status.whitechain.io for the RPC, explorer, and faucet. A 429 response is a rate limit on your side, not an outage, and it clears once your request rate drops.

Bridging and withdrawals

Use the Portal bridge for WBT and stablecoins: on Mainnet it carries USDC and WBT. Use the OP Stack canonical bridge for ERC-20 tokens. ETH deposited as WETH through the canonical bridge works on testnet only; on Mainnet the bridged ETH token ships in a later release. Deposits from Ethereum to Whitechain arrive on L2 in about 2 minutes, following Ethereum block times. For an ERC-20 token, you approve the L1 standard bridge and call depositERC20; the L2 token must already be deployed. Native WBT cannot go through the canonical bridge, because Whitechain runs in custom gas token mode: use the faucet on testnet, and the Portal bridge. You can also move WBT through WhiteBIT deposits and withdrawals. See the OP Stack canonical bridge.
On testnet a full withdrawal takes about an hour, because the dispute-resolution delays are intentionally shortened. On Whitechain Mainnet it takes at least 7 days. Whichever network you are on, the dispute-resolution delay is enforced by the contracts and cannot be skipped, so plan treasury and time-sensitive flows accordingly. Deposits run the other way in about 2 minutes. Both figures move with L1 block times and congestion. For supported assets, the Portal bridge moves funds in minutes instead, as a centralized alternative to the canonical withdrawal period. See Transaction finality.
Whitechain runs in OP Stack custom gas token mode, where the native token is WBT instead of ETH. The canonical bridge does not carry the native gas token in that mode. Use the faucet on testnet, the Portal bridge, or WhiteBIT deposits and withdrawals. ERC-20 tokens do go through the canonical bridge. See OP Stack canonical bridge.
No. The dispute window is enforced by the protocol on Ethereum, so no fee or support request shortens it. A withdrawal is proven and finalized in two steps, and it cannot be cancelled once proven. Plan treasury flows around the minimum of 7 days on Mainnet. See Transaction finality.
Yes. WhiteBIT users withdraw WBT directly to Whitechain from the exchange UI, with no third-party bridge in the path. New users land on Whitechain with WBT in their wallet through the exchange flow they already use. Direct withdrawal functionality remains subject to WhiteBIT’s Terms of Use, jurisdictional availability, and identity verification requirements. See Getting WBT.

For projects

The Whitechain Foundation runs the Builders Program with financial, marketing, and technical support for projects building on Whitechain. Support is released against delivery milestones rather than as a lump sum. Projects that need more than the program covers are evaluated under the Investment Program, where terms are agreed per project. Participation in the Builders Program is discretionary, non-binding, and subject to separate legal contracts, KYC screening, and sanctions compliance. See the Whitechain Builders Program and For project partners.