Skip to content
Draft
Show file tree
Hide file tree
Changes from 7 commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -611,7 +611,7 @@ Now that you have completed this tutorial, you can:
[`IncrementFiSwapConnectors`]: https://github.com/onflow/FlowActions/blob/main/cadence/contracts/connectors/increment-fi/IncrementFiSwapConnectors.cdc
[`IncrementFiFlashloanConnectors`]: https://github.com/onflow/FlowActions/blob/main/cadence/contracts/connectors/increment-fi/IncrementFiFlashloanConnectors.cdc
[`FungibleTokenConnectors`]: https://github.com/onflow/FlowActions/blob/main/cadence/contracts/connectors/FungibleTokenConnectors.cdc
[oracle]: https://developers.flow.com/ecosystem/defi-liquidity/defi-contracts-mainnet#oracles
[oracle]: https://developers.flow.com/defi/defi-contracts-mainnet#oracles
[Band]: https://blog.bandprotocol.com/
[`BandOracleConnectors`]: https://github.com/onflow/FlowActions/blob/main/cadence/contracts/connectors/band-oracle/BandOracleConnectors.cdc
[Cadence type]: https://cadence-lang.org/docs/language/types-and-type-system/type-safety
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: How To Add Token To MetaMask
description: How to import a Flow token in MetaMask
sidebar_label: Add Token To MetaMask
sidebar_position: 4
sidebar_position: 6
keywords:
- add token to MetaMask
- MetaMask Flow EVM
Expand Down Expand Up @@ -88,7 +88,7 @@ You can find token contract addresses on:
If you're unsure, check the Flow EVM block explorer at [evm.flowscan.io][5]

[1]: https://evm.flowscan.io/tokens
[2]: /docs/ecosystem/defi-liquidity/defi-contracts-mainnet.md
[2]: /defi/defi-contracts-mainnet
[3]: https://dexscreener.com/flowevm
[4]: https://www.geckoterminal.com/flow-evm/pools
[5]: https://evm.flowscan.io
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ keywords:
- Flow blockchain
- Flow Cadence
- smart contracts
sidebar_position: 6
sidebar_position: 7
sidebar_label: Band Oracle
---

Expand All @@ -24,20 +24,22 @@ The Band Protocol Oracle contract enables Flow blockchain applications to access

## Contract Addresses

| Network | Address | [CLI](https://developers.flow.com/build/tools/flow-cli/dependency-manager) | Explorer |
|---------|---------|----------|----------|
| Network | Address | [CLI](https://developers.flow.com/build/tools/flow-cli/dependency-manager) | Explorer |
| ------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------- |
| Testnet | `0x9fb6606c300b5051` | <CopyButton text="flow dependencies install testnet://0x9fb6606c300b5051.BandOracle" title="Copy install command (testnet)" /> | [View Contract](https://testnet.flowscan.io/contract/A.9fb6606c300b5051.BandOracle) |
| Mainnet | `0x6801a6222ebf784a` | <CopyButton text="flow dependencies install mainnet://0x6801a6222ebf784a.BandOracle" title="Copy install command (mainnet)" /> | [View Contract](https://flowscan.io/contract/A.6801a6222ebf784a.BandOracle) |
| Mainnet | `0x6801a6222ebf784a` | <CopyButton text="flow dependencies install mainnet://0x6801a6222ebf784a.BandOracle" title="Copy install command (mainnet)" /> | [View Contract](https://flowscan.io/contract/A.6801a6222ebf784a.BandOracle) |

## Supported Symbols

### Cryptocurrency Pairs (against USD)

- **Major**: ETH, FLOW, USDC, USDT, WBTC, BNB, XRP, ADA, DOGE, POL (MATIC)
- **Layer 1**: SOL, DOT, AVAX, ATOM, XLM, TRX, SUI
- **DeFi**: AAVE, LINK, CRV, OP, UNI, SUSHI, CAKE, DYDX, 1INCH, BAT
- **Others**: LTC, SHIB, DAI, FTM

### Fiat Currency Pairs (against USD)

- **Asian**: KRW, INR, HKD, TWD, THB, JPY, MYR, PHP, CNY, SGD
- **European**: PLN, CZK, EUR, GBP, CHF, RUB, SEK, TRY
- **Americas**: BRL, CAD
Expand Down Expand Up @@ -92,17 +94,20 @@ All price data is stored with a USD conversion rate. When you query for price co
## Features

### Price Queries

- Query any supported symbol pair in real-time
- Get both integer (e18 precision) and fixed-point decimal rates
- Access timestamp information to verify data freshness
- Track BandChain request IDs for transparency

### Fee Structure

- Configurable fee system for oracle usage (currently set to zero)
- Fee collected in FLOW tokens
- Query current fee using `BandOracle.getFee()`

### Event Monitoring

The contract emits events to notify applications of updates:

```cadence
Expand Down Expand Up @@ -159,6 +164,7 @@ transaction(baseSymbol: String, quoteSymbol: String) {
```

### Example: ETH/USD Price

```cadence
// Get ETH price in USD
let priceData = BandOracle.getReferenceData(
Expand All @@ -170,6 +176,7 @@ let priceData = BandOracle.getReferenceData(
```

### Example: Cross-Currency Conversion

```cadence
// Get EUR price in JPY
let priceData = BandOracle.getReferenceData(
Expand Down Expand Up @@ -248,7 +255,6 @@ access(all) event BandOracleSymbolsUpdated(

When you detect an update for symbols your app uses, trigger a transaction to refresh your stored prices.


## Advanced Features

### Converting Between Number Formats
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ keywords:
- Stargate
- LayerZero
- Celer
sidebar_position: 3
sidebar_position: 5
sidebar_label: Cross-chain swaps on Flow EVM
---

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ keywords:
- DEXs
- KittyPunch
- PunchSwap
sidebar_position: 1
sidebar_position: 3
sidebar_label: DeFi Contracts Mainnet
---

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ keywords:
- DEXs
- oracles
- EAS
sidebar_position: 2
sidebar_position: 4
sidebar_label: DeFi Contracts Testnet
---

Expand Down
6 changes: 3 additions & 3 deletions docs/ecosystem/defi-liquidity/faq.md → docs/defi/faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,20 +13,20 @@ keywords:
- DEX
- yield farming
- liquidity
sidebar_position: 5
sidebar_position: 8
sidebar_label: Stablecoins & Bridges FAQ
---

import Details from '@theme/Details';

# DeFi & Liquidity FAQ
# Defi FAQ

Below are common questions regarding stablecoins, liquidity, and bridging on Flow. Click on each question to expand and view the answer.

## Bridging and Gas

<Details summary="Does Flow use ETH for gas?">
No, Flow uses $FLOW as the gas token. [WETH](./defi-contracts-mainnet#stablecoins--wrapped-assets) is supported on Flow EVM when [bridging](../bridges.md) from another chain. $WFLOW is used as an ERC20 in DeFi apps and not used for gas.
No, Flow uses $FLOW as the gas token. [WETH](./defi-contracts-mainnet#stablecoins--wrapped-assets) is supported on Flow EVM when [bridging](../ecosystem/bridges.md) from another chain. $WFLOW is used as an ERC20 in DeFi apps and not used for gas.
</Details>

<Details summary="How do I pay for gas when bridging into Flow?">
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Build with Forte ↙
sidebar_position: 0
sidebar_position: 2
---

# Quickstart
Expand Down
8 changes: 3 additions & 5 deletions docs/ecosystem/defi-liquidity/index.md → docs/defi/index.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: DeFi & Liquidity
title: Defi
description: Mechanisms that connect different blockchain networks, allowing secure and decentralized transfer of assets and data across platforms.
keywords:
- DeFi
Expand All @@ -13,12 +13,10 @@ keywords:
- lending platforms
- stablecoin protocols
- liquidity solutions
sidebar_position: 5
sidebar_custom_props:
icon: 💧
sidebar_position: 1
---

# DeFi & Liquidity on Flow
# Defi on Flow

**Fast, scalable, and capital-efficient DeFi.** Flow delivers a seamless DeFi experience without congestion, unlocking new possibilities for developers and users alike.

Expand Down
12 changes: 9 additions & 3 deletions docusaurus.config.js
Original file line number Diff line number Diff line change
Expand Up @@ -270,17 +270,23 @@ const config = {
},
items: [
{
to: 'build/flow',
to: 'defi',
position: 'left',
label: 'Build',
activeBasePath: '/build',
label: 'DeFi',
activeBasePath: '/defi',
},
{
to: 'blockchain-development-tutorials',
position: 'left',
label: 'Tutorials',
activeBasePath: '/blockchain-development-tutorials',
},
{
to: 'build/flow',
position: 'left',
label: 'Build',
activeBasePath: '/build',
},
{
to: 'protocol/flow-networks',
position: 'left',
Expand Down
Loading