Skip to main content
The Portal contracts and routes are deployed on Testnet (Ethereum Sepolia, Tron Nile, and Whitechain Sepolia). The user-facing app is still in development. Mainnet routes and addresses are published at Mainnet launch.

Overview

The Portal is a centralized bridge operated by Whitechain. It moves a fixed set of tokens between Ethereum, Tron, and Whitechain in minutes, and it is the only route that connects Tron to Whitechain. A Whitechain-operated relayer holds the bridge liquidity and signs each transfer, so you trade self-custody for speed. This is the opposite tradeoff from the OP Stack canonical bridge, which is trust-minimized but takes minimum 7 days to withdraw to Ethereum on mainnet. Use the Portal when you need a fast transfer, a Tron route, or a token the canonical bridge does not support. Use the canonical bridge when you want a trustless path and can wait out the dispute period.

Portal compared to the canonical bridge

For the trustless path and its withdrawal steps, see OP Stack canonical bridge.

Supported routes and assets

The Portal connects Ethereum and Tron to Whitechain in both directions. There is no direct Ethereum to Tron route; to move between them, bridge through Whitechain in two steps. Tokens are a fixed list configured per route. A token deposited to Whitechain arrives as its bridged representation: USDC becomes USDC.e and USDT becomes USDT.e. WBT keeps its symbol and is the native gas token on Whitechain. Daily limits are per token and apply to the current testnet deployment. Values may change, and mainnet limits are set at launch.

How a transfer works

  1. Submit the transfer on the source network and sign one transaction. You can set a recipient address different from your own.
  2. Wait for the source network to confirm. Confirmation takes about 12 minutes on Ethereum and about 1 minute on Whitechain.
  3. The relayer checks that the destination network holds enough liquidity for the token. If liquidity is short, the transfer is rejected and you can retry later.
  4. The relayer releases the funds on the destination network. A Whitechain to Ethereum transfer is executed by the Portal, which pays the Ethereum gas for you.

Transaction statuses

The Portal tracks each transfer through three states.

Timing

A transfer completes within minutes once the source network confirms. This is the reason to choose the Portal over the canonical bridge for a fast exit to Ethereum.

Fees and limits

The Portal charges no bridging fee today. You pay the source-network gas for your own transaction. For a Whitechain to Ethereum transfer, the Portal pays the Ethereum gas and recovers it by charging you the equivalent in WBT. It reads the current Ethereum gas price, prices a typical token transfer, and converts that cost to WBT using WhiteBIT market rates. Each token has a daily limit, listed in Supported routes and assets. Transfers are also bounded by available liquidity on the destination network: a transfer larger than the pooled liquidity is rejected, and you can retry once liquidity is topped up.

Trust model

The Portal is centralized. A Whitechain-operated backend holds the bridge liquidity and signs every transfer with a dedicated key, and the on-chain Bridge contract only accepts transfers authorized by that key. This is what makes transfers fast, and it is the tradeoff against the canonical bridge: while funds are in transit, they are held by the Portal rather than by a trustless protocol. During maintenance the Portal can be paused. When it is paused, transfers stop until it resumes.

Contract addresses

Addresses below are for the current testnet deployment: Ethereum Sepolia, Tron Nile, and Whitechain Sepolia (chain ID 1874). Mainnet addresses are published at launch. Verify every address against this page before sending.

Bridge and Mapper contracts

The Bridge contract executes transfers. The Mapper defines which token pairs and directions are allowed. Both are proxy contracts.

Token addresses

When to use the Portal

Disclaimer

  • Test with a small amount before bridging large balances.
  • Verify every contract address against this page or the official Whitechain Explorer before submitting a transaction.
  • The Portal is centralized: funds in transit are held by the operator, not by a trustless protocol.