> For the complete documentation index, see [llms.txt](https://bitfi-2.gitbook.io/bitfi/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://bitfi-2.gitbook.io/bitfi/developer/using-contract/bfusd-oracle.md).

# bfUSD Oracle

## Overview

bfUSD uses price feeds to convert between USDT, USDC, and the dual staking pools. USDT deposits are always treated as 1:1, while USDC conversions consult a Chainlink oracle to keep pricing fair when the stablecoin drifts slightly.

## hbfUSD / pbfUSD Ratio Tracking

* **`currentRatio()`** – exposes the current bfUSD-to-share ratio with 1e8 precision.
* **`epochRatios(uint256 epoch)`** – returns `(startRatio, endRatio, startTime, endTime)` so that front-ends can reconstruct how a share price changed inside an epoch.
* **`convertToShares` / `convertToAssets`** – reuse the ratio logic, so once the oracle provides the bfUSD value, the vault can translate between assets and shares deterministically.

## Notes

* Always call `previewDeposit`, `previewMint`, `previewWithdraw`, or `previewRedeem` to show the expected amounts before sending a transaction.
* For USDC flows, read the Chainlink feed first, then apply the vault ratio to determine the share amount to mint or burn.