> For the complete documentation index, see [llms.txt](https://docs.fyuz.fun/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fyuz.fun/how-fyuz-works/chainlink-integration.md).
# 🔗 Chainlink integration
Fyuz integrates [**Chainlink**](https://chain.link), the industry-standard decentralized oracle network, across the protocol — not as a badge, but as load-bearing infrastructure.
## 📈 Price Feeds — the graduation trigger
The bonding curve holds and prices everything in **BNB**, but graduation is defined in **USD** ($30,000 market cap). On every buy, the Fyuz contract reads the **Chainlink BNB/USD price feed** on-chain to value the token's market cap — when it reaches the target, graduation to PancakeSwap triggers automatically. The same feed keeps the USD numbers across the app honest.
**Staleness protection:** if the feed's latest data is older than the configured threshold (1 hour by default), it is rejected — Fyuz will not make graduation decisions on stale prices.
## 🎲 VRF — provably fair reward lotteries
The community's **0.3% fee stream** flows into the on-chain rewards Distributor. Each reward round pays out in two parts:
* **90% pro-rata** to leaderboard participants by their share of points in the round window.
* **10% to one winner picked by Chainlink VRF v2.5** (verifiable randomness) — and every participant holds exactly **one ticket regardless of size**, so small traders always have a real shot at the jackpot. 🎰
The random draw is verifiable on-chain: nobody — including the Fyuz team — can predict or rig the winner.
## ⏰ CRE — automatic reward distribution
Reward distribution is automated with the [**Chainlink Runtime Environment (CRE)**](https://docs.chain.link/cre) — Chainlink's orchestration layer, live on BNB Chain. A cron-triggered CRE workflow, executed by a Decentralized Oracle Network with Byzantine-fault-tolerant consensus, drives the round lifecycle end to end:
* ⏱️ opens reward rounds on schedule,
* 📊 delivers the leaderboard shares on-chain,
* 💸 settles the payout — 90% pro-rata, 10% to the VRF-drawn winner.
Rounds run like clockwork with no human pressing buttons, and a stuck round simply rolls its pot into the next one — funds are never stranded.
## 🤝 Why Chainlink
* **Decentralized** — prices and randomness come from independent node operators; no single party can feed Fyuz a false value.
* **Manipulation-resistant** — a flash-crash on one exchange can't fake a graduation; a miner can't grind the lottery.
* **Battle-tested** — Chainlink secures tens of billions of dollars across DeFi and is the de-facto oracle standard on BNB Smart Chain.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.fyuz.fun/how-fyuz-works/chainlink-integration.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
