> ## Documentation Index
> Fetch the complete documentation index at: https://l2docs.whitechain.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Network reference

> Chain IDs, public RPC endpoints and their rate limits, explorers, and other parameters for the Whitechain Mainnet and Whitechain Sepolia environments.

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

| Network            | Chain ID                             | Status      | Intended use                                  |
| ------------------ | ------------------------------------ | ----------- | --------------------------------------------- |
| Mainnet            | TBD, published before Mainnet launch | Coming soon | Production                                    |
| Whitechain Sepolia | `1874`                               | Live        | Public testing, integrations, dapp deployment |

## 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.

| Parameter         | Value                         |
| ----------------- | ----------------------------- |
| Chain ID          | `1874` (hex `0x752`)          |
| L1 settlement     | Ethereum Sepolia (`11155111`) |
| Block time        | 1s                            |
| Currency symbol   | WBT                           |
| Currency decimals | 18                            |

| Endpoint   | URL                                                                       |
| ---------- | ------------------------------------------------------------------------- |
| Public RPC | `https://rpc.testnet.whitechain.io`                                       |
| WebSocket  | `wss://rpc.testnet.whitechain.io/ws`                                      |
| Explorer   | [explorer.testnet.whitechain.io](https://explorer.testnet.whitechain.io/) |
| Faucet     | [faucet.testnet.whitechain.io](https://faucet.testnet.whitechain.io/)     |

To claim test WBT, see [Testnet faucet](/learn/get-started/get-testnet-wbt). To check current uptime for these endpoints, see the [status page](https://status.whitechain.io/).

## 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.

| Network            | Type                         | URL                                                                   | Operator                               | Auth                              | Status  |
| ------------------ | ---------------------------- | --------------------------------------------------------------------- | -------------------------------------- | --------------------------------- | ------- |
| Whitechain Sepolia | HTTPS JSON-RPC               | `https://rpc.testnet.whitechain.io`                                   | Whitechain                             | None                              | Live    |
| Whitechain Sepolia | WebSocket JSON-RPC           | `wss://rpc.testnet.whitechain.io/ws`                                  | Whitechain                             | None                              | Live    |
| Whitechain Sepolia | HTTPS and WebSocket JSON-RPC | Not yet available, published when the first partner endpoint launches | Third-party provider, under evaluation | To be confirmed with the provider | Planned |
| Mainnet            | HTTPS and WebSocket JSON-RPC | Not yet available, published before Mainnet launch                    | Whitechain                             | None                              | Planned |

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.

| Property                         | Value                                                    |
| -------------------------------- | -------------------------------------------------------- |
| Sustained rate                   | 50 requests per second per client IP                     |
| Burst allowance                  | Up to 500 requests above the sustained rate              |
| What the limit counts            | Each HTTP request, not each JSON-RPC call inside a batch |
| Status code when you are limited | `429 Too Many Requests`                                  |
| Retry hint                       | `Retry-After: 1` header on every `429` response          |
| WebSocket limits                 | Published once they are finalized                        |

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](/operate/run-a-node/overview).

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.

## Related

* [Public RPC endpoints and rate limits](#public-rpc-endpoints)
* [Whitechain Sepolia full parameters](/learn/network/testnet)
* [Faucet](/learn/get-started/get-testnet-wbt)
* [Network fees](/learn/network/network-fees)
* [Use viem with Whitechain](/build/dapps/use-viem)
* [OP Stack canonical bridge](/build/bridge/bridge-assets)
* [Migration to L2](/learn/general/migration)
* [Transaction finality](/learn/network/transaction-finality)
* [Service status](https://status.whitechain.io/)
