Skip to main content
Whitechain runs EVM-compatible environments built on the OP Stack. Each settles on Ethereum and uses WBT as the native gas token.

​
At a glance

​
Mainnet

L2 Mainnet is not yet live. Chain ID, endpoints, and the launch date will be published before public availability.

​
Whitechain Sepolia

Whitechain Sepolia is the public test environment. Use it for dapp deployment, integration testing, and to claim test WBT from the faucet. To claim test WBT, see Testnet faucet. To check current uptime for these endpoints, see the status page.

​
Public RPC endpoints

This section lists every public JSON-RPC endpoint for Whitechain, operated by Whitechain and by third parties, with the rate limit that applies to each. No endpoint needs an API key or an IP allowlist. Reads and writes are open to any client, subject to the limits below. Third-party public endpoints are not live yet. Whitechain is evaluating partnerships with commercial RPC providers for Whitechain Sepolia and Mainnet. Until a partner endpoint is published in the table above, the two Whitechain endpoints are the only public RPC endpoints for the network. Do not treat any other endpoint claiming to serve chain ID 1874 as official.

​
Rate limits on Whitechain endpoints

The public HTTPS endpoint https://rpc.testnet.whitechain.io is rate limited per client IP address. Neither Whitechain endpoint needs an API key or an IP allowlist. Stay at or below 50 requests per second and you do not see a 429. Above that, the endpoint absorbs a short burst, then returns 429 for the excess while it keeps serving 50 requests per second. Recovery is immediate once your rate drops. Mainnet limits are published before Mainnet launch. Rate limits on third-party endpoints are set by each provider, not by Whitechain, and are published in the table above when those endpoints go live.

​
Working within the limits

The limits suit dapp front ends, wallet traffic, and integration testing. They are not sized for indexers, block-by-block backfills, or load tests. If your workload needs more headroom:
  • Batch calls into a single JSON-RPC request. The limiter counts one HTTP request per batch, so 20 calls cost the same as one.
  • Poll new blocks over WebSocket with eth_subscribe on newHeads instead of calling eth_blockNumber in a loop.
  • Reuse one WebSocket connection for several subscriptions instead of opening a connection per query.
  • Cache immutable results, such as receipts and finalized blocks, on your side.
  • Run your own node for unmetered access. See Run a node.
Handle 429 responses with exponential backoff, starting from the Retry-After value. A client that retries immediately after a 429 stays above the limit and keeps failing.

​
Gas token

WBT is the native gas token across all Whitechain environments. It uses 18 decimals and is configured as the OP Stack custom gas token. Every transaction fee on Whitechain is paid in WBT, regardless of network.