For the complete documentation index, see llms.txt. This page is also available as Markdown.

cbETH

cbETH is Coinbase's wrapped staked-ETH token.

cbETH is Coinbase's wrapped staked-ETH token. No direct cbETH/USD Chainlink feed is used; this ICustomPriceFeed adapter combines the token's own exchange rate with an ETH/USD price read from the NAV's own primary feed.

The ETH/USD term is sourced from the NAV's own selector — see Base/USD from the NAV's own selector.

Source: cbETH_CustomPriceFeed.sol

Mainnet feed. The L2 deployments use a different oracle composition — see cbETH (L2).


Approach

exchangeRate() × ETH/USD.

Left-to-right flowchart of the cbETH (Mainnet) price feed: rate and Chainlink inputs combine into a USD price, with a staleness gate.
cbETH (Mainnet) price feed — how its oracle inputs compose into a USD price, with the staleness gate.

Price calculation

Input
Source
Description

exchangeRate

IcbETH.exchangeRate() on cbETH (18 dec)

ETH per 1 cbETH

ETH/USD

NAV base — getPriceDataNoDivergence(WETH) (8 dec)

the NAV's primary WETH/USD price

exchangeRate() is read directly from the cbETH contract and grows as staking rewards accrue. Output decimals are inherited from the ETH/USD feed (8).


Constructor

Parameter
Description

cbEth_

cbETH token address (also the supported underlying)

nav_

NAVCalculator (proxy) — supplies the base asset's USD price via getPriceDataNoDivergence

baseAsset_

The registered base asset whose USD price is read (WETH)


Staleness

getLatestPrice() returns stale if exchangeRate() returns 0, or if the NAV reports the base asset (WETH) stale — all its feeds stale. The base leg's updatedAt comes from the NAV's selected WETH feed. The exchangeRate() call has no independent heartbeat.


Chains

Deployed on Ethereum. For the Base deployment using a direct Chainlink cbETH/ETH feed, see cbETH (L2).

Last updated