defi liquidity - faq and contracts

docs/ecosystem/auditors.md

@@ -1,5 +1,5 @@
 ---
-sidebar_position: 7
+sidebar_position: 12
 description: |
   Third-party auditors for Cadence contract auditing
 sidebar_custom_props:
@@ -28,11 +28,11 @@ The following companies provide independent contract auditing services of Cadenc
 
 [Halborn Inc.](https://www.halborn.com/) specializing in blockchain security and smart contract auditing including Cadence.
 
-## Oak Security 
+## Oak Security
 
 [Oak Security](https://www.oaksecurity.io/) a specialist in smart contract auditing security including Cadence.
 
-## Emerald City Academy 
+## Emerald City Academy
 
 [Emerald City Academy - Shield](https://docs.ecdao.org/auditing/shield) a Cadence-specialized, community-driven auditing service also offering development support and review for Cadence smart contracts.
 

docs/ecosystem/block-explorers.md

@@ -1,5 +1,5 @@
 ---
-sidebar_position: 2
+sidebar_position: 3
 description: |
   User-friendly online tools that provide visual representations of blockchain data, facilitating easy navigation through transactions, blocks, addresses, and smart contracts while ensuring real-time insights and transparency.
 sidebar_custom_props:

docs/ecosystem/bridges.md

@@ -1,5 +1,5 @@
 ---
-sidebar_position: 3
+sidebar_position: 6
 description: Mechanisms that connect different blockchain networks, allowing secure and decentralized transfer of assets and data across platforms.
 sidebar_custom_props:
   icon: ⛓️
@@ -11,20 +11,37 @@ Bridges are mechanisms that connect different blockchain networks, enabling secu
 
 <div id="cards" className="cards">
 
-## Celer cBridge
+## Stargate Bridge
 
-[Celer cBridge](https://cbridge.celer.network/) is a decentralized and non-custodial asset bridge that supports more than 150 tokens across over 40 blockchains and layer-2 rollups. It is built on top of the [Celer](https://celer.network/) Inter-chain Message Framework. cBridge has facilitated over $13 billion in cross-chain asset transfer volume across 40+ blockchains for more than 350,000 unique users. It is rapidly growing and expanding to support more blockchains and layer-2 solutions.
+[Stargate Bridge][1] is a cross-chain liquidity transfer protocol powered by LayerZero that enables seamless bridging of assets between Flow and major blockchain networks like Ethereum, BNB Chain, and Base. It uses LayerZero's omnichain messaging capabilities which allow Stargate to provide deep liquidity pools, low slippage, and cost-efficient transfers for stablecoins and cryptocurrencies such as USDC, USDT, USDF, and ETH.
 
-## Axelar
+## Flow Bridge
 
-[Axelar](https://www.axelar.network/) is a decentralized cross-chain network connecting over 55 blockchains, facilitating asset transfers and smart contract programmability. It features a proof-of-stake consensus for security and supports cross-chain applications through General Message Passing (GMP). Integrations with platforms like [Squid](https://www.squidrouter.com/) enable easy token swaps across networks like Ethereum and Polygon.
+[Flow Bridge][2] is a user-friendly, decentralized bridge designed to facilitate secure transfers of stablecoins like USDC, USDT, and USDF to and from Flow blockchain. Powered by Superbridge, it leverages native bridge contracts for official Superchain rollups, ensuring users receive the canonical asset on Flow with minimal trust assumptions. Flow Bridge supports transfers from 24+ chains, with ultra-low transaction fees and fast settlement times.
 
 ## LayerZero
 
-[LayerZero](https://docs.layerzero.network/) is a decentralized omnichain interoperability protocol that enables direct cross-chain messaging and asset transfers. It uses a unique Ultra Light Node (ULN) architecture combined with decentralized verifiers to ensure secure message delivery across chains. LayerZero supports multiple EVM-compatible chains and provides developers with tools to build cross-chain applications through its EndpointV2 contracts.
+[LayerZero][3] is a decentralized omnichain interoperability protocol that enables direct cross-chain messaging and asset transfers. It uses a unique Ultra Light Node (ULN) architecture combined with decentralized verifiers to ensure secure message delivery across chains. LayerZero supports multiple EVM-compatible chains and provides developers with tools to build cross-chain applications through its EndpointV2 contracts.
 
 ## Hyperlane
 
-[Hyperlane](https://www.usenexus.org/) is a modular interoperability framework that enables secure cross-chain communication. It allows developers to build applications that can seamlessly interact across different blockchain networks. Hyperlane's architecture emphasizes security and flexibility, providing customizable security models and permissionless interoperability between any blockchain networks.
+[Hyperlane][4] is a modular interoperability framework that enables secure cross-chain communication. It allows developers to build applications that can seamlessly interact across different blockchain networks. Hyperlane's architecture emphasizes security and flexibility, providing customizable security models and permissionless interoperability between any blockchain networks.
+
+## Celer cBridge
+
+[Celer cBridge][5] is a decentralized and non-custodial asset bridge that supports more than 150 tokens across over 40 blockchains and layer-2 rollups. It is built on top of the [Celer][6] Inter-chain Message Framework. cBridge has facilitated over $13 billion in cross-chain asset transfer volume across 40+ blockchains for more than 350,000 unique users. It is rapidly growing and expanding to support more blockchains and layer-2 solutions.
+
+## Axelar
+
+[Axelar][7] is a decentralized cross-chain network connecting over 55 blockchains, facilitating asset transfers and smart contract programmability. It features a proof-of-stake consensus for security and supports cross-chain applications through General Message Passing (GMP). Integrations with platforms like [Squid][8] enable easy token swaps across networks like Ethereum and Polygon.
 
 </div>
+
+[1]: https://stargate.finance/bridge
+[2]: https://bridge.flow.com/
+[3]: https://docs.layerzero.network/
+[4]: https://www.usenexus.org/
+[5]: https://cbridge.celer.network/
+[6]: https://celer.network/
+[7]: https://www.axelar.network/
+[8]: https://www.squidrouter.com/

docs/ecosystem/defi-liquidity/defi-contracts.md

@@ -0,0 +1,119 @@
+---
+id: defi-contracts
+title: DeFi Contracts on Flow
+description: A reference table of frequently used DeFi contracts on Flow, including their addresses for both Flow EVM and Flow Cadence.
+keywords:
+  - DeFi contracts
+  - Flow blockchain
+  - Flow EVM
+  - Flow Cadence
+  - stablecoins
+  - wrapped assets
+  - AMMs
+  - DEXs
+  - KittyPunch
+  - PunchSwap
+sidebar_position: 1
+sidebar_label: DeFi Contracts
+---
+
+import StablecoinsWrappedAssetsTable from '@site/src/components/defi-contracts/StablecoinsWrappedAssetsTable';
+
+Flow is a Layer 1 blockchain that supports EVM equivalency, offering two environments Flow EVM and Flow Cadence. Fungible and non-fungible tokens can seamlessly transfer between these environments via the native VM token bridge. As a result, many tokens have both a Flow EVM mainnet contract address and a Flow Cadence mainnet contract address, allowing developers to choose their preferred environment.
+
+Below is a list of commonly used DeFi contracts on Flow:
+
+## Stablecoins & Wrapped Assets
+
+#### Flow EVM Mainnet
+
+<StablecoinsWrappedAssetsTable environment="evm" />
+
+#### Flow Cadence Mainnet
+
+<StablecoinsWrappedAssetsTable environment="cadence" />
+
+## AMMs & DEXs
+
+#### Flow EVM Mainnet
+
+| Contract Name                                | Flow EVM Mainnet Address                     |
+| -------------------------------------------- | -------------------------------------------- |
+| [StableKittyFactoryNG.sol (KittyPunch)][1]   | `0x4412140D52C1F5834469a061927811Abb6026dB7` |
+| [TwoKittyFactory.sol (KittyPunch)][2]        | `0xf0E48dC92f66E246244dd9F33b02f57b0E69fBa9` |
+| [TriKittyFactory.sol (KittyPunch)][3]        | `0xebd098c60b1089f362AC9cfAd9134CBD29408226` |
+| [KittyRouterNgPoolsOnly.sol (KittyPunch)][4] | `0x87048a97526c4B66b71004927D24F61DEFcD6375` |
+| [PunchSwapV2Router02.sol (KittyPunch)][5]    | `0xf45AFe28fd5519d5f8C1d4787a4D5f724C0eFa4d` |
+| [PunchSwapV2Factory.sol (KittyPunch)][6]     | `0x29372c22459a4e373851798bFd6808e71EA34A71` |
+| [TrenchesTokensBuyer.sol (KittyPunch)][7]    | `0x6D0e081Acc28eA9ee6b7fD293eC03F97147b026d` |
+
+#### Flow Cadence Mainnet
+
+| Contract Name                       | Flow Cadence Mainnet Address |
+| ----------------------------------- | ---------------------------- |
+| [SwapFactory.cdc (IncrementFi)][22] | `0xb063c16cac85dbd1`         |
+| [SwapPair (IncrementFi)][23]        | `0xecbda466e7f191c7`         |
+| [SwapError (IncrementFi)][24]       | `0xb78ef7afa52ff906`         |
+| [SwapInterfaces (IncrementFi)][25]  | `0xb78ef7afa52ff906`         |
+| [SwapConfig (IncrementFi)][26]      | `0xb78ef7afa52ff906`         |
+| [SwapRouter (IncrementFi)][27]      | `0xa6850776a94e6551`         |
+
+## Bridges & Cross-Chain Messaging
+
+| Bridge / Protocol                            | Reference Docs           |
+| -------------------------------------------- | ------------------------ |
+| Stargate Bridge ([stargate.finance][8])      | [Mainnet Contracts][9]   |
+| Hyperlane Bridge ([trump.hyperlane.xyz][10]) | [Mainnet Contracts][11]  |
+| Flow Bridge ([bridge.flow.com][12])          | [Superbridge Docs][13]   |
+| Celer cBridge ([cbridge.celer.network][14])  | [Celer cBridge Docs][15] |
+| LayerZero                                    | [Mainnet Contracts][16]  |
+| Axelar                                       | [Axelar Docs][17]        |
+
+## Oracles
+
+#### Flow EVM Mainnet
+
+| Contract Name                 | Flow EVM Mainnet Address                     |
+| ----------------------------- | -------------------------------------------- |
+| [ERC1967Proxy.sol (Pyth)][18] | `0x2880aB155794e7179c9eE2e38200202908C17B43` |
+
+#### Flow Cadence Mainnet
+
+| Contract Name                             | Flow Cadence Mainnet Address |
+| ----------------------------------------- | ---------------------------- |
+| [PublicPriceOracle.cdc (IncrementFi)][19] | `0xec67451f8a58216a`         |
+
+## Other
+
+| Contract Name                                           | Flow EVM Mainnet Address                     |
+| ------------------------------------------------------- | -------------------------------------------- |
+| [SchemaRegistry.sol (Ethereum Attestation Service)][20] | `0xB0cF748a05AEA8D59e15834446CFC95bcFF510F0` |
+| [EAS.sol (Ethereum Attestation Service)][21]            | `0xc6376222F6E009A705a34dbF1dF72fEf8efB3964` |
+
+[1]: https://evm.flowscan.io/address/0x4412140D52C1F5834469a061927811Abb6026dB7?tab=contract
+[2]: https://evm.flowscan.io/address/0xf0E48dC92f66E246244dd9F33b02f57b0E69fBa9?tab=contract
+[3]: https://evm.flowscan.io/address/0xebd098c60b1089f362AC9cfAd9134CBD29408226?tab=contract
+[4]: https://evm.flowscan.io/address/0x87048a97526c4B66b71004927D24F61DEFcD6375?tab=contract
+[5]: https://evm.flowscan.io/address/0xf45AFe28fd5519d5f8C1d4787a4D5f724C0eFa4d?tab=contract
+[6]: https://evm.flowscan.io/address/0x29372c22459a4e373851798bFd6808e71EA34A71?tab=contract
+[7]: https://evm.flowscan.io/address/0x6D0e081Acc28eA9ee6b7fD293eC03F97147b026d?tab=contract
+[8]: https://stargate.finance/bridge?srcChain=ethereum&srcToken=0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48&dstChain=flow&dstToken=0xF1815bd50389c46847f0Bda824eC8da914045D14
+[9]: https://stargateprotocol.gitbook.io/stargate/v2-developer-docs/technical-reference/mainnet-contracts#flow
+[10]: https://trump.hyperlane.xyz/
+[11]: https://docs.hyperlane.xyz/docs/reference/addresses/mailbox-addresses
+[12]: https://bridge.flow.com/
+[13]: https://docs.superbridge.app/
+[14]: https://cbridge.celer.network/1/747/USDC-intermediary
+[15]: https://cbridge-docs.celer.network/tutorial/flow-cadence-bridging-guide
+[16]: https://docs.layerzero.network/v1/developers/evm/technical-reference/deployed-contracts?chains=flow
+[17]: https://docs.axelar.dev/validator/external-chains/flow/
+[18]: https://evm.flowscan.io/address/0x2880aB155794e7179c9eE2e38200202908C17B43?tab=contract
+[19]: https://contractbrowser.com/A.ec67451f8a58216a.PublicPriceOracle
+[20]: https://evm.flowscan.io/address/0xB0cF748a05AEA8D59e15834446CFC95bcFF510F0?tab=contract
+[21]: https://evm.flowscan.io/address/0xc6376222F6E009A705a34dbF1dF72fEf8efB3964?tab=contract
+[22]: https://contractbrowser.com/A.b063c16cac85dbd1.SwapFactory
+[23]: https://contractbrowser.com/A.ecbda466e7f191c7.SwapPair
+[24]: https://contractbrowser.com/A.b78ef7afa52ff906.SwapError
+[25]: https://contractbrowser.com/A.b78ef7afa52ff906.SwapInterfaces
+[26]: https://contractbrowser.com/A.b78ef7afa52ff906.SwapConfig
+[27]: https://contractbrowser.com/A.a6850776a94e6551.SwapRouter