# Table of Contents - [Overview | Bonzo Finance Documentation](#overview-bonzo-finance-documentation) - [Bonzo Mainnet | Bonzo Finance Documentation](#bonzo-mainnet-bonzo-finance-documentation) - [Connect Wallet | Bonzo Finance Documentation](#connect-wallet-bonzo-finance-documentation) - [Supply Assets | Bonzo Finance Documentation](#supply-assets-bonzo-finance-documentation) - [Roadmap | Bonzo Finance Documentation](#roadmap-bonzo-finance-documentation) - [Repay Loan | Bonzo Finance Documentation](#repay-loan-bonzo-finance-documentation) - [Withdraw Assets | Bonzo Finance Documentation](#withdraw-assets-bonzo-finance-documentation) - [Enable / Disable Collateral | Bonzo Finance Documentation](#enable-disable-collateral-bonzo-finance-documentation) - [Borrow Assets | Bonzo Finance Documentation](#borrow-assets-bonzo-finance-documentation) - [Troubleshooting | Bonzo Finance Documentation](#troubleshooting-bonzo-finance-documentation) - [Bonzo Testnet | Bonzo Finance Documentation](#bonzo-testnet-bonzo-finance-documentation) - [Hedera ($HBAR) | Bonzo Finance Documentation](#hedera-hbar-bonzo-finance-documentation) - [Liquidations | Bonzo Finance Documentation](#liquidations-bonzo-finance-documentation) - [Dashboard Metrics Explained | Bonzo Finance Documentation](#dashboard-metrics-explained-bonzo-finance-documentation) - [Bridging Assets | Bonzo Finance Documentation](#bridging-assets-bonzo-finance-documentation) - [Obtaining $HBAR | Bonzo Finance Documentation](#obtaining-hbar-bonzo-finance-documentation) - [Hedera Wallet Setup | Bonzo Finance Documentation](#hedera-wallet-setup-bonzo-finance-documentation) - [Protocol Fees & Revenue | Bonzo Finance Documentation](#protocol-fees-revenue-bonzo-finance-documentation) - [Bonzo Points | Bonzo Finance Documentation](#bonzo-points-bonzo-finance-documentation) - [Pre-Season Points Airdrop | Bonzo Finance Documentation](#pre-season-points-airdrop-bonzo-finance-documentation) - [Careers | Bonzo Finance Documentation](#careers-bonzo-finance-documentation) - [Single-Sided Staking | Bonzo Finance Documentation](#single-sided-staking-bonzo-finance-documentation) - [Native APYs & Liquidity Incentives | Bonzo Finance Documentation](#native-apys-liquidity-incentives-bonzo-finance-documentation) - [Community | Bonzo Finance Documentation](#community-bonzo-finance-documentation) - [Season Four Points | Bonzo Finance Documentation](#season-four-points-bonzo-finance-documentation) - [Cybernetic NFT | Bonzo Finance Documentation](#cybernetic-nft-bonzo-finance-documentation) - [Team | Bonzo Finance Documentation](#team-bonzo-finance-documentation) - [Commemorative NFT | Bonzo Finance Documentation](#commemorative-nft-bonzo-finance-documentation) - [GitHub | Bonzo Finance Documentation](#github-bonzo-finance-documentation) - [Flash Loans | Bonzo Finance Documentation](#flash-loans-bonzo-finance-documentation) - [Season Two Points | Bonzo Finance Documentation](#season-two-points-bonzo-finance-documentation) - [Ownership & License Terms | Bonzo Finance Documentation](#ownership-license-terms-bonzo-finance-documentation) - [Season Three Points | Bonzo Finance Documentation](#season-three-points-bonzo-finance-documentation) - [SaucerSwap DEX | Bonzo Finance Documentation](#saucerswap-dex-bonzo-finance-documentation) - [Oracles | Bonzo Finance Documentation](#oracles-bonzo-finance-documentation) - [Bug Bounty | Bonzo Finance Documentation](#bug-bounty-bonzo-finance-documentation) - [Liquidation Bots (Beta) | Bonzo Finance Documentation](#liquidation-bots-beta-bonzo-finance-documentation) - [1st Edition Bonzo NFTs | Bonzo Finance Documentation](#1st-edition-bonzo-nfts-bonzo-finance-documentation) - [Supra | Bonzo Finance Documentation](#supra-bonzo-finance-documentation) - [Glossary | Bonzo Finance Documentation](#glossary-bonzo-finance-documentation) - [Liquidator Contract | Bonzo Finance Documentation](#liquidator-contract-bonzo-finance-documentation) - [Season One Points | Bonzo Finance Documentation](#season-one-points-bonzo-finance-documentation) - [Performing a Liquidation | Bonzo Finance Documentation](#performing-a-liquidation-bonzo-finance-documentation) - [Bonzo NFT Collectables | Bonzo Finance Documentation](#bonzo-nft-collectables-bonzo-finance-documentation) - [Brand Assets | Bonzo Finance Documentation](#brand-assets-bonzo-finance-documentation) - [Chainlink | Bonzo Finance Documentation](#chainlink-bonzo-finance-documentation) - [Audits | Bonzo Finance Documentation](#audits-bonzo-finance-documentation) - [Community | Bonzo Finance Documentation](#community-bonzo-finance-documentation) - [Contact | Bonzo Finance Documentation](#contact-bonzo-finance-documentation) - [Environment Setup | Bonzo Finance Documentation](#environment-setup-bonzo-finance-documentation) - [Configuring Hardhat | Bonzo Finance Documentation](#configuring-hardhat-bonzo-finance-documentation) - [Support | Bonzo Finance Documentation](#support-bonzo-finance-documentation) - [MiCAR Whitepaper | Bonzo Finance Documentation](#micar-whitepaper-bonzo-finance-documentation) - [Accounts & Contracts | Bonzo Finance Documentation](#accounts-contracts-bonzo-finance-documentation) - [Bonzo v1 Data API | Bonzo Finance Documentation](#bonzo-v1-data-api-bonzo-finance-documentation) - [Privacy Policy | Bonzo Finance Documentation](#privacy-policy-bonzo-finance-documentation) - [Terms of Service | Bonzo Finance Documentation](#terms-of-service-bonzo-finance-documentation) - [Protocol Contracts | Bonzo Finance Documentation](#protocol-contracts-bonzo-finance-documentation) - [Introduction | Risk Framework](#introduction-risk-framework) - [Email Protection | Cloudflare](#email-protection-cloudflare) - [Actual Rates & Parameters | Risk Framework](#actual-rates-parameters-risk-framework) - [Risk Parameters per Asset | Risk Framework](#risk-parameters-per-asset-risk-framework) - [Ledger Works | Risk Framework](#ledger-works-risk-framework) - [Oracle Price Feeds | Risk Framework](#oracle-price-feeds-risk-framework) - [Risk Parameters | Risk Framework](#risk-parameters-risk-framework) - [Introduction | Risk Framework](#introduction-risk-framework) - [Supply Rate Methodology | Risk Framework](#supply-rate-methodology-risk-framework) - [Adding an Asset | Risk Framework](#adding-an-asset-risk-framework) - [Historical Utilization | Risk Framework](#historical-utilization-risk-framework) - [Borrow Rate Methodology | Risk Framework](#borrow-rate-methodology-risk-framework) - [August 2025 | Risk Framework](#august-2025-risk-framework) - [October 2025 | Risk Framework](#october-2025-risk-framework) - [Smart Contracts & HTS Tokens | Risk Framework](#smart-contracts-hts-tokens-risk-framework) - [Introduction | Risk Framework](#introduction-risk-framework) - [Smart Contract Audit | Risk Framework](#smart-contract-audit-risk-framework) - [Supply / Borrow Cap Updates - Ecosystem Assets | Risk Framework](#supply-borrow-cap-updates-ecosystem-assets-risk-framework) - [Risk Parameter LTV Updates - Ecosystem Assets | Risk Framework](#risk-parameter-ltv-updates-ecosystem-assets-risk-framework) - [Interest Rate & Borrow Cap Update - USDC | Risk Framework](#interest-rate-borrow-cap-update-usdc-risk-framework) - [Onboard wETH (LayerZero OFT) to Bonzo Lend | Risk Framework](#onboard-weth-layerzero-oft-to-bonzo-lend-risk-framework) --- # Overview | Bonzo Finance Documentation Welcome to the official documentation for Bonzo Finance — the premier lending and borrowing protocol of the Hedera network. The organizational structure of Bonzo is comprised of these four components: * **Bonzo Finance Labs:** A Dubai-based development shop corporation is contributing to development of the Bonzo Finance protocol, along with the user interface. * **The Bonzo Finance Protocol:** A liquidity pool-based decentralized lending protocol built on Hedera. Bonzo is powered by open source smart contracts from Aave v2 that have been adapted to Hedera's native smart contract and token services. Bonzo utilizes over-collateralized loans, flash loans, and dynamic interest rate models to facilitate permissionless lending and borrowing of crypto assets. * **The Bonzo Interface:** An easy-to-use, web-hosted user interface that allows user interaction with the Bonzo protocol. The interface is one of many ways to interact with Bonzo. * **The Bonzo DAO (Coming Soon):** A decentralized autonomous organization (DAO) that guides protocol development and governance through collective decision-making by its community members, enabled by the $BONZO token. [](https://docs.bonzo.finance/hub#bonzo-finance-protocol) Bonzo Finance Protocol ------------------------------------------------------------------------------------- The [Bonzo Finance](https://www.bonzo.finance/) protocol is an open source, non-custodial protocol designed to facilitate the lending and borrowing of cryptocurrencies, with a focus on HBAR, Hedera Token Service (HTS) tokens, and wrapped major assets. Bonzo prioritizes censorship resistance, security, and self-custody, enabling users to transact without reliance on trusted intermediaries that may selectively restrict access. Bonzo Finance is based on [Aave v2](https://docs.aave.com/developers/v/2.0) and adapted to the Hedera EVM (Ethereum Virtual Machine) and native Hedera Token Service (HTS). By adapting Aave v2 to Hedera, the Bonzo Finance protocol inherits the Hedera network's high throughput, fast transaction finality, and a low, fixed, U.S. dollar-denominated fee structure. Additionally, Hedera's architecture ensures fair transaction ordering, mitigating the risk of MEV attacks commonly seen on alternative EVM-based protocols. Bonzo Finance utilizes [Supra](https://docs.bonzo.finance/hub/developer/oracles/supra) oracles that enable accurate and reliable price feeds for the lending and borrowing of assets, ensuring transparent and efficient operations within the protocol. [NextRoadmap](https://docs.bonzo.finance/hub/roadmap) Last updated 1 year ago --- # Bonzo Mainnet | Bonzo Finance Documentation [Connect Wallet](https://docs.bonzo.finance/hub/get-started/bonzo-mainnet/connect-wallet) [Supply Assets](https://docs.bonzo.finance/hub/get-started/bonzo-mainnet/supply-assets) [Withdraw Assets](https://docs.bonzo.finance/hub/get-started/bonzo-mainnet/withdraw-assets) [Enable / Disable Collateral](https://docs.bonzo.finance/hub/get-started/bonzo-mainnet/enable-disable-collateral) [Borrow Assets](https://docs.bonzo.finance/hub/get-started/bonzo-mainnet/borrow-assets) [Repay Loan](https://docs.bonzo.finance/hub/get-started/bonzo-mainnet/repay-loan) [Dashboard Metrics Explained](https://docs.bonzo.finance/hub/get-started/bonzo-mainnet/dashboard-metrics-explained) [PreviousRoadmap](https://docs.bonzo.finance/hub/roadmap) [NextConnect Wallet](https://docs.bonzo.finance/hub/get-started/bonzo-mainnet/connect-wallet) Last updated 1 year ago --- # Connect Wallet | Bonzo Finance Documentation Upon mainnet launch, Bonzo Finance will support the HashPack ecosystem wallet — support for additional Hedera ecosystem wallets and MetaMask will be made available soon. [](https://docs.bonzo.finance/hub/get-started/bonzo-mainnet/connect-wallet#hashpack) HashPack Wallet --------------------------------------------------------------------------------------------------------- [HashPack](https://www.hashpack.app/) is the leading wallet on the Hedera network. For detailed, step-by-step instructions on setting up your HashPack wallet, visit [How to Create Your First Account with HashPack](https://www.hashpack.app/post/how-to-create-your-first-account-with-hashpack) . * For desktop users, install the HashPack extension from the [Chrome Web Store](https://chrome.google.com/webstore/detail/hashpack/gjagmgiddbbciopjhllkdnddhcglnemk) . * For iOS users, download HashPack from the [Apple App Store](https://apps.apple.com/us/app/hashpack/id6444389849) . * For Android users, you can find HashPack on the [Google Play Store](https://play.google.com/store/apps/details?id=app.hashpack.wallet.twa) . [](https://docs.bonzo.finance/hub/get-started/bonzo-mainnet/connect-wallet#hashpack-1) Connecting HashPack to Bonzo Finance -------------------------------------------------------------------------------------------------------------------------------- ### [](https://docs.bonzo.finance/hub/get-started/bonzo-mainnet/connect-wallet#desktop-application-and-hashpack-chrome-extension) **Desktop Application & HashPack Chrome Extension** 1. From the [Bonzo Finance dashboard](https://docs.bonzo.finance/hub/get-started/bonzo-mainnet) , click on "Connect Wallet" and choose HashPack. 2. The HashPack Chrome extension will open and request selection of a specific account. 3. Select the account you'd like to connect to Bonzo Finance and click "Approve" ### [](https://docs.bonzo.finance/hub/get-started/bonzo-mainnet/connect-wallet#desktop-application-and-mobile-hashpack) **Desktop Application & Mobile HashPack** 1. From the [Bonzo Finance dashboard](https://docs.bonzo.finance/hub/get-started/bonzo-mainnet) on your desktop device, click on "Connect Wallet" and choose HashPack. 2. A "WalletConnect" modal will appear on screen. 3. Click the "copy" icon to the right of "Connect your wallet" to copy the wallet pairing string. 4. Open HashPack on your mobile device, select an account to use, and then click the "Globe" icon on the top right of the interface. 5. Tap the "Connect dApp" button from that drop-down menu. 6. Enter the pairing string you've copied on your desktop device into the empty field. 7. A list of accounts will appear — select the account you'd like to use with Bonzo Finance and tap "Approve" to connect your account. 8. The Desktop application will automatically connect to that account. ### [](https://docs.bonzo.finance/hub/get-started/bonzo-mainnet/connect-wallet#mobile-hashpack) **Mobile HashPack** 1. If visiting Bonzo Finance from a mobile device, open the HashPack application. 2. After selecting an account, tap on "DAPPS" in the HashPack wallet navigation. 3. Scroll down to "Lending & Borrowing" and tap on "Bonzo Finance". ![](https://docs.bonzo.finance/hub/~gitbook/image?url=https%3A%2F%2F3581807805-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRfK3lCSOewdMJ6MlbF1B%252Fuploads%252FFVjQfhgLbsPRKSQG9Yte%252Fimage.png%3Falt%3Dmedia%26token%3Dbd8261c7-c934-4f62-a256-498d87b2568a&width=768&dpr=4&quality=100&sign=638fd91c&sv=2) [PreviousBonzo Mainnet](https://docs.bonzo.finance/hub/get-started/bonzo-mainnet) [NextSupply Assets](https://docs.bonzo.finance/hub/get-started/bonzo-mainnet/supply-assets) Last updated 1 year ago --- # Supply Assets | Bonzo Finance Documentation After connecting your HashPack to the Bonzo Finance protocol, you can supply any supported asset to start earning yield and [Bonzo Points](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-points/season-one-points) . [](https://docs.bonzo.finance/hub/get-started/bonzo-mainnet/supply-assets#desktop) **Desktop** --------------------------------------------------------------------------------------------------- 1. From the [Bonzo Finance dashboard](https://docs.bonzo.finance/hub/get-started/bonzo-mainnet) scroll down to view the list of supported assets. 2. Find the asset you'd like to supply and click on the ![](https://docs.bonzo.finance/hub/~gitbook/image?url=https%3A%2F%2F3581807805-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRfK3lCSOewdMJ6MlbF1B%252Fuploads%252FPVD5PUqcp4GnuBNc9SXP%252Fimage.png%3Falt%3Dmedia%26token%3Dfd15d0be-460d-487e-9ab4-0af636974236&width=43&dpr=4&quality=100&sign=da699e13&sv=2) icon found on the right side of the table. 3. Click **Supply** and an on-screen modal will appear. 4. From within the modal, type in the amount you'd like to supply or click on the ![](https://docs.bonzo.finance/hub/~gitbook/image?url=https%3A%2F%2F3581807805-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRfK3lCSOewdMJ6MlbF1B%252Fuploads%252F6ALd54E8p7xdjRvkASQi%252Fimage.png%3Falt%3Dmedia%26token%3D68c6ce85-6ce5-4f46-8ef1-6e4be31ab7fe&width=65&dpr=4&quality=100&sign=a074446d&sv=2) button to autofill the full amount held of the selected asset in the connected account. 5. Review the "Transaction overview" section of the modal to understand the impact of supplying the specified amount of this asset. 6. Click the **Supply \[Asset\]** button to review and sign the required transaction(s) that appear within your connected wallet. 7. Once completed, the asset supplied and additional details will appear in the "Supplied" box of the Bonzo Finance dashboard. [](https://docs.bonzo.finance/hub/get-started/bonzo-mainnet/supply-assets#mobile) **Mobile** ------------------------------------------------------------------------------------------------- 1. Access the [Bonzo Finance dashboard](https://docs.bonzo.finance/hub/get-started/bonzo-mainnet) from within the HashPack dApp browser. 2. Scroll down to view the list of supported assets. 3. Find the asset you'd like to supply and tap on it to view additional details. 4. Tap on the **Supply** button and an on-screen modal will appear. 5. From within the modal, type in the amount you'd like to supply or click on the ![](https://docs.bonzo.finance/hub/~gitbook/image?url=https%3A%2F%2F3581807805-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRfK3lCSOewdMJ6MlbF1B%252Fuploads%252F6ALd54E8p7xdjRvkASQi%252Fimage.png%3Falt%3Dmedia%26token%3D68c6ce85-6ce5-4f46-8ef1-6e4be31ab7fe&width=65&dpr=4&quality=100&sign=a074446d&sv=2) button to autofill the full amount held of the selected asset in the connected account. 6. Review the "Transaction overview" section of the modal to understand the impact of supplying the specified amount of this asset. 7. Click the **Supply \[Asset\]** button to review and sign the required transaction(s). 8. Once completed, the asset supplied and additional details will appear in the "Supplied" box of the Bonzo Finance dashboard. [PreviousConnect Wallet](https://docs.bonzo.finance/hub/get-started/bonzo-mainnet/connect-wallet) [NextWithdraw Assets](https://docs.bonzo.finance/hub/get-started/bonzo-mainnet/withdraw-assets) Last updated 1 year ago --- # Roadmap | Bonzo Finance Documentation The roadmap provides an overview of Bonzo Finance's past, present, and future developments for the Bonzo protocol and user interface. Please note that this roadmap is subject to change based on external circumstances and input from the DAO community. The items listed are not necessarily in chronological order. [](https://docs.bonzo.finance/hub/roadmap#in-development) 🟩 In Development -------------------------------------------------------------------------------- **Projects actively being developed:** * Bonzo Vaults * Bonzo Bridge [](https://docs.bonzo.finance/hub/roadmap#planned-for-development) 🟨 Planned for Development -------------------------------------------------------------------------------------------------- **Projects planned for development:** * Additional Asset Listings * DAO Governance Implementation [](https://docs.bonzo.finance/hub/roadmap#prioritized-for-development) 🟧 Prioritized for Development ---------------------------------------------------------------------------------------------------------- **Projects prioritized for development:** * Cross-Chain Bridging Integration for Axelar, LayerZero (UI/UX + Development) * MetaMask Support * Real-Time Protocol Monitoring [](https://docs.bonzo.finance/hub/roadmap#completed) 🏁 Completed ---------------------------------------------------------------------- **Projects that have completed development:** * Code Freeze & Smart Contract Audits * Safety Module & staking functionality + UI/UX * Safety Module development + UI/UX * Initial Bonzo Finance Homepage & Blog * Supra oracles integration * Points reward system based on HCS-20 * Testnet deployment/adaptation of Aave v2 Smart Contracts * HashConnect integration for HashPack * Public Discord faucet for SaucerSwap testnet HTS tokens * Public testnet availability & UI/UX dapp frontend * Official homepage & branding * Bonzo NFT illustrations * Liquidation bot testing & developer templates * DeFi Llama Adapters * Data API * WalletConnect integration (HashPack, Kaliba, etc.) * HBAR liquidity incentive smart contracts & UI updates * Flash loan documentation & developer templates * CoinGecko Integration * Bonzo Finance protocol analytics page (UI/UX + Data API integration) * Individual asset analytics page(s) (UI/UX + Data API integration) * Chainlink Oracles implementation * Single-sided staking for $xBONZO * $BONZO Faucet in Discord for Bonzo Finance NFT holders * New Loan Health Monitor added to the Bonzo Dashboard * UI/UX Revamp [PreviousOverview](https://docs.bonzo.finance/hub) [NextBonzo Mainnet](https://docs.bonzo.finance/hub/get-started/bonzo-mainnet) Last updated 1 month ago --- # Repay Loan | Bonzo Finance Documentation Bonzo Finance allows users to repay their outstanding loans at any time. Repaying loans is crucial for maintaining a healthy position, reducing the risk of liquidation, and freeing up collateral for withdrawal. Here's how to repay a loan on Bonzo Finance: [](https://docs.bonzo.finance/hub/get-started/bonzo-mainnet/repay-loan#desktop) **Desktop** ------------------------------------------------------------------------------------------------ 1. From the [Bonzo Finance dashboard](https://docs.bonzo.finance/hub/get-started/bonzo-mainnet) check the "Borrowed" section to view all borrow positions. 2. Find the loan you'd like to repay and click on the ![](https://docs.bonzo.finance/hub/~gitbook/image?url=https%3A%2F%2F3581807805-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRfK3lCSOewdMJ6MlbF1B%252Fuploads%252FPVD5PUqcp4GnuBNc9SXP%252Fimage.png%3Falt%3Dmedia%26token%3Dfd15d0be-460d-487e-9ab4-0af636974236&width=43&dpr=4&quality=100&sign=da699e13&sv=2) icon found on the right side of the table. 3. Click **Repay** and an on-screen modal will appear. 4. From within the modal, type in the amount you'd like to repay or click on the ![](https://docs.bonzo.finance/hub/~gitbook/image?url=https%3A%2F%2F3581807805-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRfK3lCSOewdMJ6MlbF1B%252Fuploads%252F6ALd54E8p7xdjRvkASQi%252Fimage.png%3Falt%3Dmedia%26token%3D68c6ce85-6ce5-4f46-8ef1-6e4be31ab7fe&width=65&dpr=4&quality=100&sign=a074446d&sv=2) button to autofill the full amount of the position. Make sure you have enough of the asset in the connected account to repay the full amount if using "max". 5. Review the "Transaction overview" section of the modal to understand how repaying the loan will affect your position. 6. Click the **Repay \[Asset\]** button to review and sign the required transaction(s) that appear within your connected wallet. 7. Once completed, the asset will be withdrawn from the connected account to repay the loan and your loan balance will be updated in the Bonzo Finance dashboard. Refresh your wallet to reflect these changes. [](https://docs.bonzo.finance/hub/get-started/bonzo-mainnet/repay-loan#mobile) **Mobile** ---------------------------------------------------------------------------------------------- 1. Access the [Bonzo Finance dashboard](https://docs.bonzo.finance/hub/get-started/bonzo-mainnet) from within the HashPack dApp browser. 2. Scroll down to view the "Borrowed" section to view all borrow positions. 3. Find the loan you'd like to repay and tap on it to view additional details. 4. Tap on the **Repay** button and an on-screen modal will appear. 5. From within the modal, type in the amount you'd like to repay or click on the ![](https://docs.bonzo.finance/hub/~gitbook/image?url=https%3A%2F%2F3581807805-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRfK3lCSOewdMJ6MlbF1B%252Fuploads%252F6ALd54E8p7xdjRvkASQi%252Fimage.png%3Falt%3Dmedia%26token%3D68c6ce85-6ce5-4f46-8ef1-6e4be31ab7fe&width=65&dpr=4&quality=100&sign=a074446d&sv=2) button to autofill the full amount of the position. Make sure you have enough of the asset in the connected account to repay the full amount if using "max". 6. Review the "Transaction overview" section of the modal to understand how repaying the loan will affect your position. 7. Click the **Repay \[Asset\]** button to review and sign the required transaction(s). 8. Once completed, the asset will be withdrawn from the connected account to repay the loan and your loan balance will be updated in the Bonzo Finance dashboard. Refresh your wallet to reflect these changes. [PreviousBorrow Assets](https://docs.bonzo.finance/hub/get-started/bonzo-mainnet/borrow-assets) [NextDashboard Metrics Explained](https://docs.bonzo.finance/hub/get-started/bonzo-mainnet/dashboard-metrics-explained) Last updated 1 year ago --- # Withdraw Assets | Bonzo Finance Documentation Bonzo Finance offers users the flexibility to withdraw supplied assets at any time, provided those assets are not currently serving as collateral for outstanding loans. This feature ensures that users maintain control over their liquidity. Only assets not actively securing a loan can be withdrawn freely — if a user has borrowed against their supplied assets, they may need to repay their loan or adjust your position before initiating a withdrawal. Here's how to withdraw assets from Bonzo Finance: [](https://docs.bonzo.finance/hub/get-started/bonzo-mainnet/withdraw-assets#desktop) **Desktop** ----------------------------------------------------------------------------------------------------- 1. From the [Bonzo Finance dashboard](https://docs.bonzo.finance/hub/get-started/bonzo-mainnet) check the "Supplied" box to view all assets currently supplied. 2. Find the asset you'd like to withdraw and click on the ![](https://docs.bonzo.finance/hub/~gitbook/image?url=https%3A%2F%2F3581807805-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRfK3lCSOewdMJ6MlbF1B%252Fuploads%252FPVD5PUqcp4GnuBNc9SXP%252Fimage.png%3Falt%3Dmedia%26token%3Dfd15d0be-460d-487e-9ab4-0af636974236&width=43&dpr=4&quality=100&sign=da699e13&sv=2) icon found on the right side of the table. 3. Click **Withdraw** and an on-screen modal will appear. 4. From within the modal, type in the amount you'd like to withdraw or click on the ![](https://docs.bonzo.finance/hub/~gitbook/image?url=https%3A%2F%2F3581807805-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRfK3lCSOewdMJ6MlbF1B%252Fuploads%252F6ALd54E8p7xdjRvkASQi%252Fimage.png%3Falt%3Dmedia%26token%3D68c6ce85-6ce5-4f46-8ef1-6e4be31ab7fe&width=65&dpr=4&quality=100&sign=a074446d&sv=2) button to autofill the full amount supplied. 5. Review the "Transaction overview" section of the modal to understand the impact of withrawing the specified amount of this asset. 6. Click the **Withdraw \[Asset\]** button to review and sign the required transaction(s) that appear within your connected wallet. 7. Once completed, the asset will be withdrawn from the protocol and appear in your wallet. Refresh your wallet to reflect these changes. [](https://docs.bonzo.finance/hub/get-started/bonzo-mainnet/withdraw-assets#mobile) **Mobile** --------------------------------------------------------------------------------------------------- 1. Access the [Bonzo Finance dashboard](https://docs.bonzo.finance/hub/get-started/bonzo-mainnet) from within the HashPack dApp browser. 2. Scroll down to view the "Supplied" section, which contains a list of assets currently supplied. 3. Find the asset you'd like to withdraw and tap on it to view additional details. 4. Tap on the **Withdraw** button and an on-screen modal will appear. 5. Type in the amount you'd like to withdraw or click on the ![](https://docs.bonzo.finance/hub/~gitbook/image?url=https%3A%2F%2F3581807805-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRfK3lCSOewdMJ6MlbF1B%252Fuploads%252F6ALd54E8p7xdjRvkASQi%252Fimage.png%3Falt%3Dmedia%26token%3D68c6ce85-6ce5-4f46-8ef1-6e4be31ab7fe&width=65&dpr=4&quality=100&sign=a074446d&sv=2) button to autofill the full amount supplied. 6. Review the "Transaction overview" section of the modal to understand the impact of withdrawing the specified amount of this asset. 7. Click the **Withdraw \[Asset\]** button to review and sign the required transaction(s). 8. Once completed, the asset will be withdrawn from the protocol and appear in your wallet. Refresh your wallet to reflect these changes. [PreviousSupply Assets](https://docs.bonzo.finance/hub/get-started/bonzo-mainnet/supply-assets) [NextEnable / Disable Collateral](https://docs.bonzo.finance/hub/get-started/bonzo-mainnet/enable-disable-collateral) Last updated 1 year ago --- # Enable / Disable Collateral | Bonzo Finance Documentation Enabling and disabling supplied assets as collateral allows for more nuanced control over one's lending and borrowing strategy within the protocol. Assets supplied to Bonzo Finance are enabled as collateral by default. This means that after an asset is supplied to the protocol, users can then borrow against a percentage of the total value supplied. This percentage is called the "loan-to-value ratio (LTV)" and varies for each asset based on its individual risk profile. It's important to note that assets supplied as collateral are only susceptible to liquidation if the user is borrowing other assets against its value. If you're not borrowing, your supplied assets cannot be liquidated, even if they are enabled as collateral. In addition, reward APYs continue to accrue when supplying an asset, even if it's disabled as collateral. Bonzo Finance allows users to "enable" or "disable" whether an asset supplied is used as collateral or not. There are a few reasons why a user might want to utilize this feature on a per-asset basis: 1. **Risk management**: By disabling an asset as collateral, you prevent it from being used to borrow against, which can help manage your overall risk exposure. 2. **Avoiding liquidation risk**: If you don't want a particular asset to be at risk of liquidation, you can disable it as collateral. 3. **Strategic borrowing**: You may want to use only specific assets as collateral based on your borrowing strategy or market conditions. 4. **Simplifying position management**: By limiting which assets are used as collateral, you can make it easier to track and manage your positions. 5. **Yield optimization**: Some users may prefer to keep certain high-yielding assets separate from their collateral pool to maximize returns without increasing borrowing capacity. ### [](https://docs.bonzo.finance/hub/get-started/bonzo-mainnet/enable-disable-collateral#enabling-and-disabling-assets-as-collateral) Enabling & Disabling Assets as Collateral: 1. View the "Supplied" box in the Bonzo Finance interface. 2. Find the asset you'd like to enable or disable as collateral and click on its ![](https://docs.bonzo.finance/hub/~gitbook/image?url=https%3A%2F%2F3581807805-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRfK3lCSOewdMJ6MlbF1B%252Fuploads%252FjsNfuJOV6nSFWftnoJcl%252Fimage.png%3Falt%3Dmedia%26token%3Dda9a1289-e2fc-44b1-9232-9f6ea9d42b7f&width=41&dpr=4&quality=100&sign=f9b157d4&sv=2) button in the table. 3. Click "Disable as Collateral" or "Enable as Collateral" from the drop-down menu. 4. An on-screen modal will appear confirming details of this transaction — once reviewed, click the "Disable as Collateral" or "Enable as Collateral" button. 5. Review the transaction in your connected wallet and approve. [PreviousWithdraw Assets](https://docs.bonzo.finance/hub/get-started/bonzo-mainnet/withdraw-assets) [NextBorrow Assets](https://docs.bonzo.finance/hub/get-started/bonzo-mainnet/borrow-assets) Last updated 10 months ago --- # Borrow Assets | Bonzo Finance Documentation After supplying assets as collateral to Bonzo Finance, users can borrow any supported asset against a percentage of the supplied collateral value, known as the "loan-to-value (LTV)" ratio. [](https://docs.bonzo.finance/hub/get-started/bonzo-mainnet/borrow-assets#desktop) **Desktop** --------------------------------------------------------------------------------------------------- 1. From the [Bonzo Finance dashboard](https://docs.bonzo.finance/hub/get-started/bonzo-mainnet) scroll down to view the list of supported assets. 2. Find the asset you'd like to borrow and click on the ![](https://docs.bonzo.finance/hub/~gitbook/image?url=https%3A%2F%2F3581807805-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRfK3lCSOewdMJ6MlbF1B%252Fuploads%252FPVD5PUqcp4GnuBNc9SXP%252Fimage.png%3Falt%3Dmedia%26token%3Dfd15d0be-460d-487e-9ab4-0af636974236&width=43&dpr=4&quality=100&sign=da699e13&sv=2) icon found on the right side of the table. 3. Click **Borrow** and an on-screen modal will appear. 4. From within the modal, type in the amount of the selected asset you'd like to borrow. 5. Review the "Transaction overview" section of the modal to understand the impact of borrowing the specified amount of this asset. 6. Click the **Borrow \[Asset\]** button to review and sign the required transaction(s) that appear within your connected wallet. 7. Once completed, the asset borrowed and additional details will appear in the "Borrowed" box of the Bonzo Finance dashboard. Borrowing assets against collateral has a direct impact on "health factor" — if a user's health factor drops below 1, the collateral supplied becomes susceptible to liquidation. It's important to regularly monitor borrow and supply positions. [](https://docs.bonzo.finance/hub/get-started/bonzo-mainnet/borrow-assets#mobile) **Mobile** ------------------------------------------------------------------------------------------------- 1. Access the [Bonzo Finance dashboard](https://docs.bonzo.finance/hub/get-started/bonzo-mainnet) from within the HashPack dApp browser. 2. Scroll down to view the list of supported assets. 3. Find the asset you'd like to borrow and tap on it to view additional details. 4. Tap on the **Borrow** button and an on-screen modal will appear. 5. From within the modal, type in the amount of the selected asset you'd like to borrow. 6. Review the "Transaction overview" section of the modal to understand the impact of supplying the specified amount of this asset. 7. Click the **Borrow \[Asset\]** button to review and sign the required transaction(s). 8. Once completed, the asset borrowed and additional details will appear in the "Borrowed" box of the Bonzo Finance dashboard. [PreviousEnable / Disable Collateral](https://docs.bonzo.finance/hub/get-started/bonzo-mainnet/enable-disable-collateral) [NextRepay Loan](https://docs.bonzo.finance/hub/get-started/bonzo-mainnet/repay-loan) Last updated 10 months ago --- # Troubleshooting | Bonzo Finance Documentation Please check the **Bonzo Finance status page** to determine if any errors experienced are due to known maintenance or issues: [http://status.bonzo.finance/](http://status.bonzo.finance/) The Bonzo Finance Labs team is regularly optimizing its front-end, squashing bugs, and implementing feedback to ensure a great end user experience. It's still possible for errors to occur — if you've encountered an error using the Bonzo Finance front-end application, such as failing transactions, please follow the instructions found below to remediate. **If you still experience issues, please join the official** [**Bonzo Finance Discord**](https://www.bonzo.finance/discord) **server and open a support ticket.** ### [](https://docs.bonzo.finance/hub/get-started/troubleshooting#desktop-browser--chrome-extension-hashpack-kabila) **Desktop Browser + Chrome Extension (HashPack, Kabila)** 1. Close any other windows / tabs that have SaucerSwap, Bonzo Finance, etc. active 2. Disconnect wallet 3. Disconnect all Bonzo Finance wallet connection(s) \[globe icon on top right of wallet interface\] 4. Clear the browser's cache for https://app.bonzo.finance (or clear the entire cache) 5. Quit the browser application 6. Re-open the browser application 7. Re-connect wallet 8. Attempt transaction again **⏰ Additional Check**: Some users have experienced transaction failures due to the clock on their machine / device not being in-sync with the actual time — please ensure that your system's time reflects the accurate time. ### [](https://docs.bonzo.finance/hub/get-started/troubleshooting#desktop-browser--mobile-pairing-string-hashpack-kabila) **Desktop Browser + Mobile Pairing String (HashPack, Kabila)** 1. Close any other windows / tabs that have SaucerSwap, Bonzo Finance, etc. active 2. Disconnect wallet 3. Disconnect all Bonzo Finance wallet connection(s) \[globe icon on top right of wallet interface\] 4. Clear the browser's cache for https://app.bonzo.finance (or clear the entire cache) 5. Quit the browser application 6. Re-open the browser application 7. Re-connect wallet 8. Attempt transaction again **⏰ Additional Check**: Some users have experienced transaction failures due to the clock on their device not being in-sync with the actual time — please ensure that your device's time reflects the accurate time. ### [](https://docs.bonzo.finance/hub/get-started/troubleshooting#mobile-wallet-hashpack-kabila--in-wallet-browser) **Mobile Wallet (HashPack, Kabila) + In-Wallet Browser** 1. Close any other windows / tabs that have SaucerSwap, Bonzo Finance, etc. active 2. Disconnect wallet 3. Disconnect all Bonzo Finance wallet connection(s) \[globe icon on top right of wallet interface\] 4. Force quit the mobile wallet 5. Re-open the mobile wallet 6. Visit https://app.bonzo.finance (or tap Bonzo Finance in dapp marketplace) 7. Re-connect wallet 8. Attempt transaction again **⏰ Additional Check**: Some users have experienced transaction failures due to the clock on their device not being in-sync with the actual time — please ensure that your device's time reflects the accurate time. [PreviousDashboard Metrics Explained](https://docs.bonzo.finance/hub/get-started/bonzo-mainnet/dashboard-metrics-explained) [NextBonzo Testnet](https://docs.bonzo.finance/hub/get-started/bonzo-testnet) Last updated 2 months ago --- # Bonzo Testnet | Bonzo Finance Documentation The testnet instance of Bonzo Finance is available on desktop web browsers and mobile devices. ### [](https://docs.bonzo.finance/hub/get-started/bonzo-testnet#hedera-testnet-account-creation-and-wallet-setup) 🎒 Hedera Testnet Account Creation & Wallet Setup **Desktop** 1. Download and install the [HashPack](https://www.hashpack.app/) wallet for the Chrome web browser 2. Create a Hedera testnet account using HashPack * _Be sure to check the "Testnet Account" box when creating your account_ * _Your new testnet account will automatically have 100 testnet $HBAR — to receive more testnet $HBAR, please visit_ [_https://portal.hedera.com/faucet_](https://portal.hedera.com/faucet) **Mobile** 1. Install the [HashPack](https://www.hashpack.app/) wallet on your mobile device 2. Create a Hedera testnet account using HashPack * _Be sure to check the "Testnet Account" box when creating your account_ * _Your new testnet account will automatically have 100 testnet $HBAR — to receive more testnet $HBAR, please visit_ [_https://portal.hedera.com/faucet_](https://portal.hedera.com/faucet) 3. Navigate to the "DAPPS" tab in the wallet and enter [https://testnet.bonzo.finance/](https://testnet.bonzo.finance/) into the `Load custom dapp URL` field at the top of the section and press the `Load` button. 4. You'll be directed to connect your HashPack testnet wallet to the Bonzo Finance testnet dashboard. _**Note: Once the Bonzo Finance application is live on mainnet, it will receive a dapp listing in HashPack.**_ ### [](https://docs.bonzo.finance/hub/get-started/bonzo-testnet#get-testnet-hts-assets-usdhbarx-usdsauce-usdxsauce-usdusdc-usdkarate) 🪙 Get Testnet HTS Assets ($HBARX, $SAUCE, $XSAUCE, $USDC, $KARATE) 1. Join the official [Bonzo Finance Discord](https://www.bonzo.finance/discord) and navigate to the #testnet-faucet channel to receive testnet HTS assets to your testnet account in HashPack * _View the pinned message in the_ _**#testnet-faucet**_ _channel and follow those instructions to receive testnet HTS assets to your testnet account in HashPack_ * _Alternatively, utilize the_ [_testnet instance of SaucerSwap_](https://testnet.saucerswap.finance/) _to swap testnet HBAR for supported ($HBARX, $SAUCE, $XSAUCE, $USDC, $KARATE) testnet HTS assets_ ### [](https://docs.bonzo.finance/hub/get-started/bonzo-testnet#using-the-bonzo-finance-testnet-dashboard) 🧪 Using the Bonzo Finance Testnet Dashboard 1. Visit the testnet instance of Bonzo Finance at [https://testnet.bonzo.finance/](https://testnet.bonzo.finance/) 2. Connect the testnet account in your HashPack Wallet by clicking on the "Connect Wallet" button and selecting your testnet account in the HashPack Wallet prompt. 3. You'll first need to supply testnet HTS assets to the protocol: * From the full list of supported assets at the bottom of the page, supply any amount of any supported asset available in your testnet account (wallet) by clicking the "Supply" button in the \[• • •\] drop-down menu. * Please review and confirm these transaction(s) in your HashPack wallet to proceed. 4. After supplying assets to the protocol, you can now borrow assets up to your specified "borrow power" (displayed at the top of the dashboard): * From the full list of supported assets at the bottom of the page, borrow any supported asset by clicking the "Borrow" button in the \[• • •\] drop-down menu. * Please review and confirm this transaction in your HashPack wallet to proceed. [PreviousTroubleshooting](https://docs.bonzo.finance/hub/get-started/troubleshooting) [NextProtocol Fees & Revenue](https://docs.bonzo.finance/hub/get-started/protocol-fees-and-revenue) Last updated 1 year ago --- # Hedera ($HBAR) | Bonzo Finance Documentation [Hedera Wallet Setup](https://docs.bonzo.finance/hub/get-started/hedera-usdhbar/hedera-wallet-setup) [Obtaining $HBAR](https://docs.bonzo.finance/hub/get-started/hedera-usdhbar/obtaining-usdhbar) [Bridging Assets](https://docs.bonzo.finance/hub/get-started/hedera-usdhbar/bridging-assets) [PreviousLiquidations](https://docs.bonzo.finance/hub/get-started/liquidations) [NextHedera Wallet Setup](https://docs.bonzo.finance/hub/get-started/hedera-usdhbar/hedera-wallet-setup) --- # Liquidations | Bonzo Finance Documentation Liquidations are a crucial mechanism in the Bonzo Finance protocol that helps maintain the health and stability of the lending and borrowing ecosystem. When a borrower's health factor drops below 1, indicating that their collateral value no longer sufficiently covers their loan value, their position becomes eligible for liquidation. This can happen when the value of the collateral decreases or the value of the borrowed debt increases relative to each other. During a liquidation, up to 50% of the borrower's debt is repaid, and the corresponding collateral value plus a liquidation fee is taken from the available collateral. [](https://docs.bonzo.finance/hub/get-started/liquidations#understanding-the-liquidation-penalty) Understanding the Liquidation Penalty -------------------------------------------------------------------------------------------------------------------------------------------- The liquidation penalty, also known as the **liquidation bonus** for liquidators, is a variable percentage that depends on the asset(s) being used as collateral. You can find the **liquidation bonus** for each asset on the [analytics page](https://app.bonzo.finance/analytics) of the Bonzo Finance application. This fee serves as an incentive for liquidators to participate in the liquidation process and help maintain the stability of the platform. [](https://docs.bonzo.finance/hub/get-started/liquidations#liquidation-examples) Liquidation Examples ---------------------------------------------------------------------------------------------------------- To better understand how liquidations work in Bonzo Finance, let's consider a couple of examples: ### [](https://docs.bonzo.finance/hub/get-started/liquidations#example-1) **Example 1** 1. Alice deposits 1000 HBAR as collateral and borrows 500 HBAR worth of value in USDC. 2. If Alice's health factor falls below 1, her loan becomes eligible for liquidation. 3. A liquidator can repay up to 50% of her borrowed amount, which is 250 HBAR worth of USDC. 4. In return, the liquidator can claim the corresponding amount of HBAR collateral plus the liquidation bonus (e.g., 5%). In this case, the liquidator would claim 262.5 HBAR for repaying 250 HBAR worth of USDC. ### [](https://docs.bonzo.finance/hub/get-started/liquidations#example-2) **Example 2** 1. Bob deposits 500 HBAR and 1000 SAUCE tokens as collateral and borrows 800 HBAR worth of value in USDC. 2. If Bob's health factor drops below 1, his loan becomes eligible for liquidation. 3. A liquidator can repay up to 50% of the borrowed amount, which is 400 HBAR worth of USDC. The liquidator can choose which collateral to claim based on the liquidation bonus. 4. If the liquidation bonus for SAUCE tokens (e.g., 10%) is higher than HBAR (e.g., 5%), the liquidator might opt to liquidate (claim) SAUCE tokens. In this case, the liquidator would claim 440 HBAR worth of SAUCE tokens for repaying 400 HBAR worth of USDC. [](https://docs.bonzo.finance/hub/get-started/liquidations#avoiding-liquidation) Avoiding Liquidation ---------------------------------------------------------------------------------------------------------- To avoid liquidation, borrowers can take proactive steps to maintain a healthy collateral-to-debt ratio. This can be achieved by depositing additional collateral assets or repaying a portion of the outstanding loan. By default, loan repayments have a more significant impact on improving the health factor compared to depositing more collateral. Borrowers should closely monitor their health factor and aim to keep it well above 1 to provide a safety buffer against market fluctuations. Tools like HAL can help users track their health factor and receive notifications when it falls below a certain threshold. Additionally, services like Defi Saver offer auto-liquidation features to help borrowers manage their positions more effectively. It's important to be mindful of stablecoin price fluctuations due to market conditions, as they can impact the health factor. For example, if the market price of USDC deviates from its intended $1.00 peg, it can affect the collateral-to-debt ratio. [](https://docs.bonzo.finance/hub/get-started/liquidations#participating-in-the-liquidation-ecosystem) Participating in the Liquidation Ecosystem ------------------------------------------------------------------------------------------------------------------------------------------------------ Liquidations in Bonzo Finance are open to anyone, providing an opportunity for users to earn liquidation bonuses by repaying borrowers' debts and claiming their collateral. However, the liquidation process is highly competitive, with many liquidators developing custom solutions and bots to be the first to liquidate eligible loans. If you're interested in participating in the liquidation ecosystem, you can find more information in the [Liquidation Bots](https://docs.bonzo.finance/hub/developer/liquidation-bots-beta) section of the Bonzo Finance documentation hub. This section provides technical details and guidance on how to integrate liquidation functionality into your own applications or bots. [PreviousProtocol Fees & Revenue](https://docs.bonzo.finance/hub/get-started/protocol-fees-and-revenue) [NextHedera ($HBAR)](https://docs.bonzo.finance/hub/get-started/hedera-usdhbar) Last updated 10 months ago --- # Dashboard Metrics Explained | Bonzo Finance Documentation The Bonzo Finance dashboard provides users with essential information about their lending and borrowing positions. Here's an overview of these metrics: ![](https://docs.bonzo.finance/hub/~gitbook/image?url=https%3A%2F%2F3581807805-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRfK3lCSOewdMJ6MlbF1B%252Fuploads%252FOf7lbgA4VPufPxUYoho1%252FScreenshot%25202025-06-18%2520at%25208.32.37%25E2%2580%25AFPM.png%3Falt%3Dmedia%26token%3Dafd49596-bd11-4a46-baf6-1213f44183d5&width=768&dpr=4&quality=100&sign=c8b933f6&sv=2) Bonzo Finance | Loan Health Monitor Terminology Description **Loan Health Monitor Bar** This bar represents the overall health of all current positions combined. It displays a user's current loan-to-value (LTV) ratio at the top. Using a bar graph representation, the loan health monitor visualizes the overall health of user positions with four distinct regions: 🟢 **Safe Zone LTV**: Well collateralized (low risk). 🟡 **Warning Zone LTV**: Approaching borrowing limit (medium risk). 🟠 **Danger Zone LTV**: Exceeded borrowing limit (high risk). 🔴 **Liquidation Zone LTV\***: Eligible for liquidation. \*If the loan health bar is in the 🔴 **Liquidation Zone LTV** it's likely that collateral is in the process of being liquidated already. **Borrow Power** This figure represents the maximum amount a user can borrow based on their supplied collateral. It fluctuates with market conditions, including the value of both supplied collateral and borrowed funds. **Net APY** This percentage shows a user's net earnings or costs from using the platform. It combines the interest earned from lending assets with the interest paid for borrowing assets. A positive number means a user is earning more interest than they are paying. **Health Factor** A crucial metric for borrowers, the Health Factor indicates how close your position is to being liquidated. The higher this number, the safer your position. If it approaches 1, you're at risk of liquidation. **Loan-to-Value (LTV)** This percentage indicates how much value a user has borrowed, relative to the value supplied as collateral. For example, if a user has supplied $1,000 worth of assets as collateral and borrowed $500 worth of assets, their current LTV would be 50%. **Liquidation LTV** This is the maximum LTV a user's position(s) can reach before being susceptible for liquidation. If a user's current LTV reaches this threshold, their collateral may be liquidated to repay their loan. ### [](https://docs.bonzo.finance/hub/get-started/bonzo-mainnet/dashboard-metrics-explained#understanding-and-utilization-of-metrics) **Understanding and Utilization of Metrics** * Users should regularly monitor their **Health Factor**. If it's decreasing, users should consider repaying some of their loan(s) or supplying more assets as collateral. * Use **Borrow Power** wisely — just because a user can borrow more, doesn't always mean they should. * Users should aim to keep **loan-to-value (LTV)** comfortably below the **Liquidation LTV** to maintain a safe position to prevent liquidations. * **Net APY** is an aggregate APY that combines all supply & borrow position APYs to determine an aggregate APY. A positive Net APY means that a user is earning more than they're paying in interest. * _Net APY does not factor in supplemental liquidity incentives (APYs with a ✨ next to them) or the usage of borrowed funds across other DeFi platforms outside of Bonzo Finance._ [PreviousRepay Loan](https://docs.bonzo.finance/hub/get-started/bonzo-mainnet/repay-loan) [NextTroubleshooting](https://docs.bonzo.finance/hub/get-started/troubleshooting) Last updated 4 months ago --- # Bridging Assets | Bonzo Finance Documentation Bonzo Finance will initally support $HBAR, $HBARX, $USDC, and Hedera ecosystem assets — as the project evolves, Bonzo Finance anticipates supporting wrapped major assets bridged from other networks to Hedera. [PreviousObtaining $HBAR](https://docs.bonzo.finance/hub/get-started/hedera-usdhbar/obtaining-usdhbar) [NextSingle-Sided Staking](https://docs.bonzo.finance/hub/rewards-and-incentives/single-sided-staking) Last updated 1 year ago --- # Obtaining $HBAR | Bonzo Finance Documentation To interact with the Bonzo Finance protocol and perform transactions, you will need HBAR, the native token of the Hedera network. HBAR is used to pay transaction fees on Hedera network, similar to how ETH is used on the Ethereum network. Here are a few ways you can obtain HBAR: ### [](https://docs.bonzo.finance/hub/get-started/hedera-usdhbar/obtaining-usdhbar#centralized-exchanges) Centralized Exchanges Many popular cryptocurrency exchanges, such as Binance, Coinbase, BitStamp and MEXC, support HBAR trading. You can find a comprehensive list of exchanges that offer HBAR on [CoinMarketCap](https://coinmarketcap.com/currencies/hedera/) . Simply create an account on one of these exchanges, complete the necessary verification steps, and purchase HBAR using your preferred payment method. ### [](https://docs.bonzo.finance/hub/get-started/hedera-usdhbar/obtaining-usdhbar#fiat-on-ramps-and-gateways) FIAT On-Ramps & Gateways If you prefer to buy HBAR directly using your local currency, you can use FIAT on-ramp gateways like [MoonPay](https://www.moonpay.com/buy/hbar) and [Banxa](https://banxa.com/) . These services allow you to purchase HBAR using a credit or debit card, bank transfers, Apple Pay, or Google Pay. You can access these gateways either through their websites or directly within the [HashPack](https://www.hashpack.app/) wallet, a popular Hedera-compatible wallet. [PreviousHedera Wallet Setup](https://docs.bonzo.finance/hub/get-started/hedera-usdhbar/hedera-wallet-setup) [NextBridging Assets](https://docs.bonzo.finance/hub/get-started/hedera-usdhbar/bridging-assets) Last updated 1 year ago --- # Hedera Wallet Setup | Bonzo Finance Documentation ### [](https://docs.bonzo.finance/hub/get-started/hedera-usdhbar/hedera-wallet-setup#hashpack) HashPack [HashPack](https://www.hashpack.app/) is the leading wallet on the Hedera network. For detailed, step-by-step instructions on setting up your HashPack wallet, visit [How to Create Your First Account with HashPack](https://www.hashpack.app/post/how-to-create-your-first-account-with-hashpack) . * For desktop users, install the HashPack extension from the [Chrome Web Store](https://chrome.google.com/webstore/detail/hashpack/gjagmgiddbbciopjhllkdnddhcglnemk) . * For iOS users, download HashPack from the [Apple App Store](https://apps.apple.com/us/app/hashpack/id6444389849) . * For Android users, you can find HashPack on the [Google Play Store](https://play.google.com/store/apps/details?id=app.hashpack.wallet.twa) . ### [](https://docs.bonzo.finance/hub/get-started/hedera-usdhbar/hedera-wallet-setup#metamask) MetaMask Currently in development. The Bonzo Finance testnet application today only works with the HashPack wallet. [MetaMask](https://metamask.io/) is the most widely-used wallet, allowing users to store ERC-20 tokens on EVM-based blockchains, as well as Hedera Token Service (HTS) tokens on the Hedera network. For detailed, step-by-step instructions on setting up your MetaMask wallet, visit [Getting started with MetaMask](https://support.metamask.io/hc/en-us/articles/360015489531-Getting-started-with-MetaMask) . * For desktop users, install the MetaMask extension directly from [metamask.io](https://metamask.io/) . * For iOS users, download MetaMask from the [Apple App Store](https://apps.apple.com/us/app/metamask-blockchain-wallet/id1438144202?_branch_match_id=1235424007731302813&_branch_referrer=H4sIAAAAAAAAA8soKSkottLXz00tScxNLM7WSywo0MvJzMvWL8529DB2SnSztAQA5G46IyQAAAA%3D) . * For Android users, you can find MetaMask on the [Google Play Store](https://play.google.com/store/apps/details?id=io.metamask&hl=en_US&ref=producthunt&_branch_match_id=1235424007731302813&_branch_referrer=H4sIAAAAAAAAA8soKSkottLXz00tScxNLM7WSywo0MvJzMvWT6ooz3a1yHeztAQA%2FOIqTSQAAAA%3D) . ### [](https://docs.bonzo.finance/hub/get-started/hedera-usdhbar/hedera-wallet-setup#metamask-network-configuration-json-rpc) MetaMask Network Configuration (JSON-RPC) When first connecting your MetaMask account to Hedera, you will need to add a JSON-RPC relay to enable communication between MetaMask and Hedera. 1. Use [ChainList](https://chainlist.org/chain/295) to add the "Hashio" RPC, operated and maintained as a community service by [Hashgraph](https://www.hashgraph.com/) . **OR** 2. Manually add a network by including the following JSON-RPC information: * **Network Name:** Hedera Mainnet * **RPC URL:** [https://mainnet.hashio.io/api](https://mainnet.hashio.io/api) * **Chain ID:** 295 * **Currency Symbol:** HBAR * **Block Explorer URL:** [https://hashscan.io/mainnet/](https://hashscan.io/mainnet/) [PreviousHedera ($HBAR)](https://docs.bonzo.finance/hub/get-started/hedera-usdhbar) [NextObtaining $HBAR](https://docs.bonzo.finance/hub/get-started/hedera-usdhbar/obtaining-usdhbar) Last updated 1 year ago --- # Protocol Fees & Revenue | Bonzo Finance Documentation As a decentralized lending and borrowing protocol, Bonzo Finance is committed to creating a robust and economically sustainable ecosystem that benefits all stakeholders. The protocol’s fee structure is designed to ensure the long-term viability of the protocol while providing attractive opportunities for target user personas. [](https://docs.bonzo.finance/hub/get-started/protocol-fees-and-revenue#protocol-fees) Protocol Fees --------------------------------------------------------------------------------------------------------- At the core of Bonzo Finance's fee model are four distinct fee types that work together to ensure platform sustainability, incentivize optimal behavior, and protect all participants. These carefully calibrated fees maintain the protocol's financial health, compensate liquidity providers fairly, and create the right market dynamics for long-term growth while distributing value across the ecosystem. ### [](https://docs.bonzo.finance/hub/get-started/protocol-fees-and-revenue#borrowing-rate) **Borrowing Rate** The Borrowing Rate is a dynamic (variable) and annualized interest rate (APY) that borrowers pay when taking loans from the protocol. Unlike fees that primarily benefit the protocol, borrowing rates primarily flow to suppliers (lenders) who provide the liquidity being borrowed, with only a portion (the [Reserve Factor](https://docs.bonzo.finance/hub/get-started/protocol-fees-and-revenue#reserve-factor) ) going to the protocol itself. The most up-to-date interest rate models per asset are found in the [Risk Framework](https://docs.bonzo.finance/bonzo-risk-framework/liquidity-risk/actual-rates-and-parameters) documentation. * **Purpose**: To compensate suppliers for providing liquidity and to regulate market demand for borrowing based on supply and utilization * **Mechanism**: Dynamic rates that increase as utilization increases, incentivizing repayments during high utilization and encouraging borrowing during low utilization * **Calculation**: Uses a two-slope model based on utilization: * When utilization < optimal: Rate = Base + (Utilization/Optimal) × Slope1 * When utilization ≥ optimal: Rate = Base + Slope1 + ((Utilization-Optimal)/(1-Optimal)) × Slope2 * **Beneficiaries**: Primarily suppliers (lenders) of the asset, with a portion (Reserve Factor) going to the protocol treasury ### [](https://docs.bonzo.finance/hub/get-started/protocol-fees-and-revenue#reserve-factor) **Reserve Factor** The Reserve Factor Fee is a percentage of interest paid by borrowers that is allocated to the protocol's reserves and set on a per-asset basis. These reserves act as a safety buffer for the platform, creating a financial cushion that protects lenders from potential losses during market volatility or unexpected events. The most up-to-date Reserve Factor fee(s) per asset are found in the [Risk Framework](https://docs.bonzo.finance/bonzo-risk-framework/asset-risk/risk-parameters-per-asset) documentation. * **Purpose**: To build a protocol safety reserve that serves as the first line of defense against shortfall events * **Mechanism**: A fixed percentage of all interest payments made by borrowers is automatically directed to the protocol treasury * **Beneficiary**: The protocol treasury, which can be used by the Bonzo Finance DAO for various purposes, including but not limited to providing rewards to Safety Module participants ### [](https://docs.bonzo.finance/hub/get-started/protocol-fees-and-revenue#liquidation-bonus) **Liquidation Bonus** The Liquidation Bonus (sometimes referred to as Liquidation Fee from the borrower's perspective) is applied when a borrower's collateral is liquidated due to their position falling below the required collateralization ratio. This fee is a percentage of the liquidated collateral and is paid to the liquidator as an incentive for maintaining the health of the platform. The most up-to-date Liquidation Bonus fee(s) per asset are found in the [Risk Framework](https://docs.bonzo.finance/bonzo-risk-framework/asset-risk/risk-parameters-per-asset) documentation. * **Purpose**: To incentivize third-party liquidators to repay at-risk loans and maintain the solvency of the protocol. * **Mechanism**: When a position becomes undercollateralized, liquidators can repay a portion of the debt and receive the equivalent value plus a bonus in collateral assets. ### [](https://docs.bonzo.finance/hub/get-started/protocol-fees-and-revenue#flash-loans) **Flash Loans** Flash Loans are uncollateralized loans that must be borrowed and repaid within a single blockchain transaction. The Flash Loan Fee is a fixed percentage charged on the borrowed amount for using this service. * **Purpose**: To generate revenue from users leveraging Flash Loans for arbitrage, liquidations, and other financial operations. * **Mechanism**: A fixed percentage (0.09%) of the total borrowed amount is charged when a Flash Loan is executed. * **Current Value**: 0.09% of the Flash Loan volume. * **Beneficiary**: The majority of the fee (excluding the asset's Reserve Factor) is distributed to liquidity providers of the respective asset. [PreviousBonzo Testnet](https://docs.bonzo.finance/hub/get-started/bonzo-testnet) [NextLiquidations](https://docs.bonzo.finance/hub/get-started/liquidations) Last updated 8 months ago --- # Bonzo Points | Bonzo Finance Documentation Points incentive programs for protocols and networks are ubiquitous across web3 — from LayerZero, to WalletConnect (ReOwn), and Kamino on Solana, points programs have been employed across the industry to incentivize protocol growth, liquidity, and adoption, rewarding users for these activities. The Bonzo Points program rewards active community members who supply liquidity to and borrow liquidity from the Bonzo Finance protocol. Point earnings are based on the dollar value of supported HTS assets supplied and borrowed, and distributed on a 24 hour basis. Point earnings are used to inform claimable $BONZO at the end of every points season, each lasting 3-4 months. Earn 2 points per $1 USD in value supplied & 8 points per $1 USD in value borrowed every 24 hours. Bonzo Points earned per account are used to inform claimable $BONZO at the end of each season; **there is no conversion rate between points to $BONZO tokens** and token distribution amounts are determined at the end of each season. The start and end date(s) for each season are found in the table below: Season Start End 1 Oct 28 2024 February 28 2025 2 March 1 2025 June 2 2025 3 June 3 2025 September 3 2025 4 September 4 2025 December 8 2025 In addition to the regular seasons of points, Bonzo Finance hosted a [token weighted pre-season airdrop of points](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-points/pre-season-points-airdrop) for holders of HTS assets supported by Bonzo Finance. The pre-season has concluded. ![](https://docs.bonzo.finance/hub/~gitbook/image?url=https%3A%2F%2F3581807805-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRfK3lCSOewdMJ6MlbF1B%252Fuploads%252F6lFT7UxEqvmwd7SdjFVa%252Fhow_jt_works.png%3Falt%3Dmedia%26token%3Dbc6ea9bd-33a2-4ea0-a21d-8ba07ec23c2a&width=768&dpr=4&quality=100&sign=486b644&sv=2) ### [](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-points#the-hcs-20-points-standard) The HCS-20 Points Standard The Bonzo Points program utilizes the Hedera Consensus Service HCS-20 standard — this offers the unique ability for points to be tied directly to Hedera accounts on-chain — it also allows for airdropping of points to users without them even having to connect their wallets to the protocol. Additionally, because all points are on-chain, they are verifiable and auditable. #### [](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-points#tierbot-or-hcs-20-points-verification-for-bonzo-points-bzpt) TierBot | HCS-20 Points Verification for Bonzo Points (BZPT) To verify on-chain Bonzo Points earned across all seasons, please visit [TierBot's HCS-20 Points Explorer](https://tier.bot/advanced-analytics/hedera/hcs20?tab=my-tokens) and connect your wallet. #### [](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-points#hashscan-or-hedera-consensus-service-hcs-20-topic-ids-for-bonzo-points) HashScan | Hedera Consensus Service (HCS-20) Topic IDs for Bonzo Points Pre-Season: [https://hashscan.io/mainnet/topic/0.0.7159077](https://hashscan.io/mainnet/topic/0.0.7159077) [PreviousNative APYs & Liquidity Incentives](https://docs.bonzo.finance/hub/rewards-and-incentives/native-apys-and-liquidity-incentives) [NextPre-Season Points Airdrop](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-points/pre-season-points-airdrop) Last updated 2 months ago --- # Pre-Season Points Airdrop | Bonzo Finance Documentation The [token-weighted airdrop of points](https://app.bonzo.finance/points) in the pre-season kicked off on **Friday, September 13th, 2024, at 4:00 PM ET**, starting with a snapshot of holders and amounts of assets in the program. The first distribution of Bonzo Points was made on **Monday, September 16th, 2024,** for the $HBARX asset and continued every other business day with a new points airdrop for every HTS asset supported by the program. ### [](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-points/pre-season-points-airdrop#key-points) **Key Points** * Non-linear token-weighted distribution of points * Unique regression curve for each asset (made available in the documentation) * Leaderboard and earnings were updated every 24 hours in the [Bonzo Finance](https://app.bonzo.finance/points) app * Accumulated points determined $BONZO token claims at the Token Generation Event (TGE) ![](https://docs.bonzo.finance/hub/~gitbook/image?url=https%3A%2F%2F3581807805-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRfK3lCSOewdMJ6MlbF1B%252Fuploads%252FNdvcly7QuD6b7Vr4bA1a%252Fimage.png%3Falt%3Dmedia%26token%3D25bcdd9c-5446-4c43-ab84-a3176a5cabcc&width=768&dpr=4&quality=100&sign=cc602e6f&sv=2) ### [](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-points/pre-season-points-airdrop#snapshot) **Snapshot** * **Date**: September 13th, 2024 at 4:00 PM ET ### [](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-points/pre-season-points-airdrop#airdrop-distribution-for-token-weighted-pre-season-points) **Airdrop Distribution for Token-Weighted Pre-Season Points** Points will be distributed across multiple days, based on a schedule tied to assets supported by the protocol: * Mon, Sept 16: $HBARX ([Distribution Details](https://docs.google.com/spreadsheets/d/1rVUDzVOQFta8qfO-JxmhI959Hbo3AXam6etWpzXHblE/edit?usp=sharing) ) * Wed, Sept 18: $PACK ([Distribution Details](https://docs.google.com/spreadsheets/d/1hZAsOF57eGFInPXJb-Toga4nXVnArQ9_pv0dZ6OmQGw/edit?usp=sharing) ) * Fri, Sept 20: $SAUCE ([Distribution Details](https://docs.google.com/spreadsheets/d/1TzQCSNzCGfKaMecD_UyEvu7nU3j1L-9SlkDx3i1ERxo/edit?gid=1745000703#gid=1745000703) ) * Fri, Sept 20: $XSAUCE ([Distribution Details](https://docs.google.com/spreadsheets/d/1cegHkUzdi04U6z4uaH-quiJl4brA8ZUbJtaLxdDO3yY/edit?gid=984072007#gid=984072007) ) * Mon, Sept 23: $DOVU ([Distribution Details](https://docs.google.com/spreadsheets/d/1-C3bukxV0YeHBTKAv-8CbNyftpvTzOBc2NCCzNdC7EI/edit?gid=375635124#gid=375635124) ) * Wed, Sept 25: $KARATE ([Distribution Details](https://docs.google.com/spreadsheets/d/1pKX1P2OKlwOenPL_QvaDfT3CwJDoGVQPKgmfLfI3RB0/edit?usp=sharing) ) * Fri, Sept 27: $HST ([Distribution Details](https://docs.google.com/spreadsheets/d/1Lgu5brxhDVqzm__JAYIB-cANFJ_9V6fnhatKt9gp3og/edit?usp=sharing) ) * Mon, Sept 30: $STEAM ([Distribution Details](https://docs.google.com/spreadsheets/d/15ls027YE8NdSu4nhePiw8IzsLKtXLSpET2esZkmtjrA/edit?gid=31857120#gid=31857120) ) * Wed, Oct 2: $USDC ([Distribution Details](https://docs.google.com/spreadsheets/d/1LgyOeudlU3LqMG4sp_jmAq-GTWLfOUTaKUwNVnTU4gI/edit?usp=sharing) ) ### [](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-points/pre-season-points-airdrop#bonzo-nft-points-multipliers) **Bonzo NFT Points Multipliers** Every Bonzo NFT came with a multiplier that automatically multiplies the points you earn during pre-season airdrops, giving holders an extra edge in the race to the top of the leaderboard. The multiplier applied to point earnings was based on the single highest tier NFT held in the same account that received points. * 🏜️ **Desert Bonzo**: 1.1x multiplier * 🌊 **Ocean Bonzo**: 1.2x multiplier * 🚀 **Space Bonzo**: 1.3x multiplier * 🌌 **Singularity Bonzo**: 1.5x multiplier NFTs needed to be held during snapshot periods to lock in these rewards and accelerate the path to more points and $BONZO earnings. ![](https://docs.bonzo.finance/hub/~gitbook/image?url=https%3A%2F%2F3581807805-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRfK3lCSOewdMJ6MlbF1B%252Fuploads%252FoZNbvVxQuBKofQ3pUPRp%252FSentx_collectibles.jpg%3Falt%3Dmedia%26token%3D95584a3c-1814-420b-8e1c-2b810d90b5bf&width=768&dpr=4&quality=100&sign=4f313fd9&sv=2) ### [](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-points/pre-season-points-airdrop#how-pre-season-points-worked) How Pre-Season Points Worked #### [](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-points/pre-season-points-airdrop#step-1-points-snapshot) Step 1: Points Snapshot * Date: September 13th, 2024, 4:00 PM ET * Applied to all supported assets #### [](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-points/pre-season-points-airdrop#step-2-points-airdrop) Step 2: Points Airdrop * First airdrop: September 16th, 2024 ($HBARX) * Frequency: Every other business day (schedule above) * Covered all HTS assets supported by the program * Points were updated on [Bonzo Finance points leaderboard](https://app.bonzo.finance/points) after each airdrop #### [](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-points/pre-season-points-airdrop#step-3-check-the-leaderboard) Step 3: Check the Leaderboard * Location: [app.bonzo.finance/points](http://app.bonzo.finance/points) * Users connected their HashPack wallet to view earned points & account ranking against others in the ecosystem [PreviousBonzo Points](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-points) [NextSeason One Points](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-points/season-one-points) Last updated 4 months ago --- # Careers | Bonzo Finance Documentation Bonzo Finance Labs is building the future of decentralized lending and borrowing on the Hedera network. The team is passionate about driving innovation in the DeFi ecosystem on Hedera and delivering a protocol that offers a trustworthy, secure, and easy-to-use experience for every user. The team fosters a culture of curiosity, creativity, transparency, and collaboration — we highly value those who are educators at heart and recognize the importance of the community. As a member of the Bonzo Finance team, you'll have the opportunity to work alongside talented professionals from diverse backgrounds who share a common goal: to revolutionize finance on Hedera and make DeFi accessible to everyone. If you're excited about the potential of Bonzo Finance and want to contribute to a project that's at the forefront of the Hedera DeFi ecosystem, please send your resume and a brief introduction to [\[email protected\]](https://docs.bonzo.finance/cdn-cgi/l/email-protection#8fece0e1fbeeecfbcfede0e1f5e0a1e9e6e1eee1ecea) . We look forward to hearing from you! [PreviousTeam](https://docs.bonzo.finance/hub/contributors/team) [NextCommunity](https://docs.bonzo.finance/hub/contributors/community) Last updated 1 year ago --- # Single-Sided Staking | Bonzo Finance Documentation [Single-sided staking](https://app.bonzo.finance/stake) allows $BONZO token holders to earn yield without providing liquidity or incurring impermanent loss. By staking $BONZO tokens, users receive $xBONZO tokens as a receipt that represents their share of the staking pool. Over time, as rewards are continuously compounded into the pool, the conversion rate between $BONZO and $xBONZO improves, resulting in higher returns when unstaking. The $xBONZO Token ID is [**0.0.8490541**](https://hashscan.io/mainnet/token/0.0.8490541) [](https://docs.bonzo.finance/hub/rewards-and-incentives/single-sided-staking#how-staking-works) How Staking Works ----------------------------------------------------------------------------------------------------------------------- The staking mechanism is designed around a continuously improving conversion rate between $BONZO and $xBONZO. This dynamic rate reflects both user contributions and ongoing reward emissions: ### [](https://docs.bonzo.finance/hub/rewards-and-incentives/single-sided-staking#staking-process) **Staking Process** 1. **Stake $BONZO Tokens:** When staking $BONZO tokens, receive $xBONZO receipt tokens at the current exchange rate. For example, if the rate is 1 $BONZO = 0.9 $xBONZO, staking 1,000 $BONZO will mint 900 $xBONZO. 2. **Hold $xBONZO Tokens:** The $xBONZO tokens appreciate in value over time as the staking pool grows via continuous reward emissions. 3. **Unstake When Ready: C**onvert $xBONZO tokens back to $BONZO at any time at the improved conversion rate, without a mandatory lock-up period or unstaking fees (aside from Hedera network fees). [](https://docs.bonzo.finance/hub/rewards-and-incentives/single-sided-staking#key-features) Key Features ------------------------------------------------------------------------------------------------------------- ### [](https://docs.bonzo.finance/hub/rewards-and-incentives/single-sided-staking#token-locking) Token Locking When staking $BONZO, tokens are securely locked in the staking smart contract. In return, users receive $xBONZO tokens at the current conversion rate. These $xBONZO tokens represent the user's stake in the protocol and their claim on the underlying $BONZO tokens. Copy Example: - Current Conversion Rate: 1 $BONZO = 0.9 $xBONZO - User stakes 1,000 $BONZO - User receives 900 $xBONZO tokens - 1,000 $BONZO remains locked in the contract ### [](https://docs.bonzo.finance/hub/rewards-and-incentives/single-sided-staking#automatic-yield-generation) Automatic Yield Generation Unlike traditional staking models that distribute rewards at fixed intervals, our system continuously increases the conversion rate between $BONZO and $xBONZO. This means: * No manual claiming of rewards * No tracking of reward distribution epochs * Value accrues seamlessly in the background The yield is reflected in the continuously improving conversion rate between $BONZO and $xBONZO. The longer user hold their $xBONZO tokens, the more $BONZO they'll receive when they eventually unstake. ### [](https://docs.bonzo.finance/hub/rewards-and-incentives/single-sided-staking#variable-apr) Variable APR The Annual Percentage Rate (APR) for staking is not fixed and varies based on: * The total number of $BONZO tokens currently staked in the protocol * Current $BONZO allocations to the staking rewards contract Users can check the current effective APR on the [staking dashboard](https://app.bonzo.finance/stake) . This rate determines how quickly the conversion rate between $BONZO and $xBONZO improves over time. Monthly Schedule $BONZO Token Rewards March 17, 2025 - April 17, 2025 100,000 April 17, 2025 - May 17, 2025 Coming Soon ### [](https://docs.bonzo.finance/hub/rewards-and-incentives/single-sided-staking#unstaking-flexibility) Unstaking Flexibility One of the primary advantages of staking is flexibility — users can unstake $xBONZO staking receipt tokens at any time with: * No minimum lock-up period * No unstaking fees (except standard Hedera network transaction fees) * No vesting schedules When unstaking, $xBONZO tokens are burned, and the user receives $BONZO tokens at the current conversion rate, which should be higher than when initially staked. Copy CopyExample: - Initial stake: 1,000 $BONZO → 900 $xBONZO (at 0.9 conversion rate) - After 6 months: Conversion rate improves to 0.85 - Unstaking 900 $xBONZO would return 1,058.82 $BONZO (900 ÷ 0.85) - Net gain: 58.82 $BONZO (5.88% return) ### [](https://docs.bonzo.finance/hub/rewards-and-incentives/single-sided-staking#growth-effect) Growth Effect The improving conversion rate creates an effect similar to compound interest. The longer $xBONZO tokens are held, the more $BONZO will be received when unstaked. This incentivizes long-term participation in the protocol's ecosystem. ### [](https://docs.bonzo.finance/hub/rewards-and-incentives/single-sided-staking#governance-rights-coming-soon) Governance Rights (Coming Soon) In 2025, $xBONZO tokens will grant holders governance rights proportional to their stake. This will allow $xBONZO holders to: * Vote on protocol changes * Participate in protocol upgrade decisions * Influence DAO treasury fund allocations * Shape the future development of the Bonzo Finance ecosystem [PreviousBridging Assets](https://docs.bonzo.finance/hub/get-started/hedera-usdhbar/bridging-assets) [NextNative APYs & Liquidity Incentives](https://docs.bonzo.finance/hub/rewards-and-incentives/native-apys-and-liquidity-incentives) Last updated 7 months ago --- # Native APYs & Liquidity Incentives | Bonzo Finance Documentation When lending (supplying) an asset on Bonzo Finance, the asset is supplied into single-asset liquidity pool. For example, the HBAR market consists of an HBAR liquidity pool, which everyone supplies into. Inversely, users borrowing an asset from Bonzo Finance borrow it from same single-asset liquidity pools lenders supplied into. When supplying assets to Bonzo Finance, there are two types of rewards, a "Native APY" and a "Liquidity Incentives APY" (indicated by a ✨ icon in the dashboard, next to the native APY). ![](https://docs.bonzo.finance/hub/~gitbook/image?url=https%3A%2F%2F3581807805-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRfK3lCSOewdMJ6MlbF1B%252Fuploads%252FL7c685sYlpruOZFs98YS%252Fimage.png%3Falt%3Dmedia%26token%3D0703f77c-8c74-4ef0-80aa-a9d0500e7ba3&width=768&dpr=4&quality=100&sign=d2b50ada&sv=2) ### [](https://docs.bonzo.finance/hub/rewards-and-incentives/native-apys-and-liquidity-incentives#id-1.-native-apy-rewards) 1\. Native APY Rewards Every asset supported by Bonzo Finance offers a native APY for supplying. Native APYs are: * **Auto-compounding**: Supplied assets automatically earn compounding interest without any additional actions required. * **Variable**: The APY fluctuates primarily based on the utilization ratio of each pool (how much of the pool is being actively borrowed relative to its total supply) and the [interest rate models](https://docs.bonzo.finance/bonzo-risk-framework/liquidity-risk/actual-rates-and-parameters) for each asset pool. * **Real-time Accrual:** Interest accumulates continuously and is reflected in your balance. ### [](https://docs.bonzo.finance/hub/rewards-and-incentives/native-apys-and-liquidity-incentives#id-2.-liquidity-incentive-apy-rewards) 2\. Liquidity Incentive APY Rewards (✨) Some assets supported by Bonzo Finance offer liquidity incentives, in the form of an additive APY, for both supplying and borrowing — these rewards must be claimed by the user manually. Liquidity incentive APYs are: * **Bonus Rewards**: Indicated by a reward icon (✨) next to the base APY. * **Claimed Manually**: Unlike the native APY, these rewards must be manually claimed by clicking the "Claim" button at the top of your "Supplied" and "Borrowed" boxes in the dashboard. * **Consist of Multiple Asset Types**: Depending on the asset supplied or borrowed, you may receive rewards in different asset types, including HBAR, USDC, DOVU, KARATE, or others. [PreviousSingle-Sided Staking](https://docs.bonzo.finance/hub/rewards-and-incentives/single-sided-staking) [NextBonzo Points](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-points) Last updated 8 months ago --- # Community | Bonzo Finance Documentation The Bonzo Finance community can be found across the following social media channels and regular development updates provided via the monthly newsletter. Channel URL 🎙️ 𝕏 [https://x.com/bonzo\_finance](https://x.com/bonzo_finance) 👾 Discord [https://bonzo.finance/discord](https://bonzo.finance/discord) 💼 LinkedIn [https://linkedin.com/company/bonzo-finance-labs](https://linkedin.com/company/bonzo-finance-labs) 💻 GitHub [https://github.com/bonzo-labs](https://github.com/bonzo-labs) 💌 Newsletter [https://bonzo.finance](https://bonzo.finance/) [PreviousCareers](https://docs.bonzo.finance/hub/contributors/careers) [NextBonzo v1 Data API](https://docs.bonzo.finance/hub/developer/bonzo-v1-data-api) Last updated 8 months ago --- # Season Four Points | Bonzo Finance Documentation ### [](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-points/season-four-points#bonzo-points-season-dates-and-earnings) **Bonzo Points Season Dates & Earnings** Season Four of the [Bonzo Points program](https://app.bonzo.finance/points) officially kicked off on September 4 2025. Point earnings convert to claimable $BONZO at the end of every points season. The start and end dates for each season are found in the table below: Season Start End 1 Oct 28 2024 February 28 2025 2 March 1 2025 June 2 2025 3 June 3 2025 September 3 2025 4 September 4 2025 December 8 2025 Points earnings are based on the dollar value of assets supplied to and borrowed from the protocol, distributed on a 24-hour basis. Supported assets of the protocol can be found on [Bonzo Finance.](https://app.bonzo.finance/) Details of points earning calculations for Season Four are found in the table below: **Supply Points** 2 points / $1 USD of token value **Borrow Points** 8 points / $1 USD of token value ### [](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-points/season-four-points#id-1st-edition-bonzo-nft-points-multiplier) **1st Edition Bonzo NFT Points Multiplier** Every [1st Edition Bonzo NFT](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-nft-collectables/1st-edition-bonzo-nfts) gives a "Bonzo Points" multiplier that automatically multiplies the points earned each day during Season Four, giving holders an extra edge in the race to the top of the leaderboard. **The multiplier applied to point earnings is based on the single highest tier 1st Edition Bonzo NFT held in the same account receiving points.** * 🏜️ **Desert Bonzo**: 1.1x multiplier * 🌊 **Ocean Bonzo**: 1.2x multiplier * 🚀 **Space Bonzo**: 1.3x multiplier * 🌌 **Singularity Bonzo**: 1.5x multiplier To purchase an NFT on secondary markets, please visit [SentX](https://sentx.io/nft-marketplace/creators/bonzo-finance) . ![](https://docs.bonzo.finance/hub/~gitbook/image?url=https%3A%2F%2F3581807805-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRfK3lCSOewdMJ6MlbF1B%252Fuploads%252FoZNbvVxQuBKofQ3pUPRp%252FSentx_collectibles.jpg%3Falt%3Dmedia%26token%3D95584a3c-1814-420b-8e1c-2b810d90b5bf&width=768&dpr=4&quality=100&sign=4f313fd9&sv=2) ### [](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-points/season-four-points#cybernetic-nft-points-multiplier-s) **Cybernetic NFT Points Multiplier(s)** The Bonzo Cybernetic NFT Collectible features a 1.05x points multiplier, stackable on itself, and 1st Edition Bonzo NFT Collectibles held in the account receiving points. This multiplier is active until the Cybernetic NFT is [burned for $BONZO](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-nft-collectables/cybernetic-nft#distribution-of-usdbonzo-tokens) , with a total stacking cap of 2.0x. **The multiplier applied to point earnings is based on the number of Bonzo Cybernetic NFTs stacked on both themselves and 1st Edition Bonzo NFTs for a maximum multiplier of 2.0x. Please see the table below for an example.** NFT Type Points Multiplier Running Total Multiplier 1st Edition Singularity 1.5x 1.5x Cybernetic NFT #1 1.05x 1.55x Cybernetic NFT #2 1.05x 1.60x Cybernetic NFT #3 1.05x 1.65x Cybernetic NFT #4 1.05x 1.7x Cybernetic NFT #5 1.05x 1.75x Cybernetic NFT #6 1.05x 1.8x Cybernetic NFT #7 1.05x 1.85x Cybernetic NFT #8 1.05x 1.9x Cybernetic NFT #9 1.05x 1.95x Cybernetic NFT #10 1.05x 2.0x ![](https://docs.bonzo.finance/hub/~gitbook/image?url=https%3A%2F%2F3581807805-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRfK3lCSOewdMJ6MlbF1B%252Fuploads%252Fss0jYfPVf6rjz72kMJTn%252FCyberneticBonzo%2520%281%29.png%3Falt%3Dmedia%26token%3D15a50d70-c328-4521-9323-a9db0d6f2891&width=768&dpr=4&quality=100&sign=c2a62f58&sv=2) Cybernetic Bonzo [0.0.7743905](https://hashscan.io/mainnet/token/0.0.7743905) [PreviousSeason Three Points](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-points/season-three-points) [NextBonzo NFT Collectables](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-nft-collectables) Last updated 2 months ago --- # Cybernetic NFT | Bonzo Finance Documentation [](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-nft-collectables/cybernetic-nft#bonzo-cybernetic-nft) Bonzo Cybernetic NFT ---------------------------------------------------------------------------------------------------------------------------------------------- The Bonzo Cybernetic NFT collectible is available for trading on secondary NFT marketplaces across the Hedera ecosystem, such as [SentX](https://sentx.io/nft-marketplace/cybernetic-bonzo) and [Kabila](https://market.kabila.app/en/collections/7743905/items) . The Cybernetic NFT collectible must be [burned on the HeadStarter platform](https://app.headstarter.org/portfolio/redeem-tokens?tab=other-tokens) in order to claim $BONZO governance tokens. Upon burning, the account will be airdropped a [Bonzo Commemorative NFT](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-nft-collectables/commemorative-nft) collectible. ![](https://docs.bonzo.finance/hub/~gitbook/image?url=https%3A%2F%2F3581807805-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRfK3lCSOewdMJ6MlbF1B%252Fuploads%252Fss0jYfPVf6rjz72kMJTn%252FCyberneticBonzo%2520%281%29.png%3Falt%3Dmedia%26token%3D15a50d70-c328-4521-9323-a9db0d6f2891&width=768&dpr=4&quality=100&sign=c2a62f58&sv=2) Cybernetic Bonzo [0.0.7743905](https://hashscan.io/mainnet/token/0.0.7743905) ### [](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-nft-collectables/cybernetic-nft#cybernetic-nft-collectable-utility) **🖼️ Cybernetic NFT Collectable Utility** Category Details Token ID [0.0.7743905](https://hashscan.io/mainnet/token/0.0.7743905) **Circulating Supply** 500 **Original Mint Cost (December 4-5)** **$200** 685 ℏ **Current Utility** The Bonzo Cybernetic NFT offers unique benefits and utility before being burned at any time (starting at TGE on February 21, 2025) in order to claim $BONZO tokens: * **Cybernetic Role in Discord**: Owning Bonzo Cybernetic NFT Collectible grants holders a unique Discord role, and a memento NFT will be provided to maintain this role after the burn. * **Stackable Points Multiplier**: The Bonzo Cybernetic NFT Collectible features a 1.05x points multiplier, stackable with itself and existing Bonzo Finance NFT Collectibles until burned for $BONZO, with a total stacking cap of 2.0x. * **$BONZO Token Distribution:** The Bonzo Cybernetic NFT Collectible offers holders the ability to burn the NFT for a total of 11,400 claimable $BONZO tokens. ### [](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-nft-collectables/cybernetic-nft#distribution-of-usdbonzo-tokens) **🪙 Distribution of $BONZO tokens** The Cybernetic NFT offers holders the ability to claim **11,400 $BONZO tokens**, ensuring widespread adoption and decentralization of $BONZO for DAO governance purposes. In order to claim $BONZO tokens from this NFT, it must be [burned on the HeadStarter platform](https://app.headstarter.org/portfolio/redeem-tokens?tab=other-tokens) . A commemorative NFT will be provided to accounts that burn this NFT, in order to retain their Discord community role. **The Commemorative NFT received after burning does not include Bonzo Points multiplier utility.** Distribution Date(s) Amount **Distribution #1** February 21, 2025 75% of "claimable" $BONZO **Distribution #2** 4 months after the date on which the Cybernetic NFT was burned 25% of "claimable" $BONZO ### [](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-nft-collectables/cybernetic-nft#royalty-fee) **👑 Royalty Fee** There are royalty fees configured for the Cybernetic NFT as outlined in the table below. Description % Fee Bonzo Finance 4.5% InAMaze Artist 0.5% [Previous1st Edition Bonzo NFTs](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-nft-collectables/1st-edition-bonzo-nfts) [NextCommemorative NFT](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-nft-collectables/commemorative-nft) Last updated 4 months ago --- # Team | Bonzo Finance Documentation Bonzo Finance Labs fosters a culture of curiosity, creativity, transparency, and collaboration — we highly value those who are patient educators at heart and recognize the importance of community. We pride ourselves on being "optimistic pragmatists" and believe in overcoming challenges with a positive attitude while staying grounded in reality. If you're passionate about decentralized finance and are interested in joining us, please visit the [careers page](https://docs.bonzo.finance/hub/contributors/careers) of the official documentation. The Bonzo Finance Labs team is fully doxxed with information found below. Name Role Profile(s) **Brady** Co-Founder & CEO [𝕏](https://www.x.com/bmgentile) [LinkedIn](https://www.linkedin.com/in/bradygentile) **Gaurang** Co-Founder & CTO [𝕏](https://x.com/gaurangtorvekar) **Nikhil** Engineer [𝕏](https://twitter.com/NikhilBAsrani) **Renly** Marketing & Community [𝕏](https://twitter.com/r3n__ly) [LinkedIn](https://www.linkedin.com/in/renly-smith-883223278/) **Khemraj** Engineer [𝕏](https://x.com/khemraj_a) [PreviousAudits](https://docs.bonzo.finance/hub/security-and-risk/audits) [NextCareers](https://docs.bonzo.finance/hub/contributors/careers) Last updated 3 months ago --- # Commemorative NFT | Bonzo Finance Documentation [](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-nft-collectables/commemorative-nft#bonzo-commemorative-nft) Bonzo Commemorative NFT ------------------------------------------------------------------------------------------------------------------------------------------------------- The Bonzo Commemorative NFT collectible is airdropped to users who burn their Cybernetic Bonzo NFT on the HeadStarter platform. ![](https://docs.bonzo.finance/hub/~gitbook/image?url=https%3A%2F%2F3581807805-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRfK3lCSOewdMJ6MlbF1B%252Fuploads%252F9rL6Xu9z98To6eeYvOYU%252Fimage.png%3Falt%3Dmedia%26token%3D6f979718-8520-42ef-8448-beea160c6bb0&width=768&dpr=4&quality=100&sign=fcb68d11&sv=2) ### [](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-nft-collectables/commemorative-nft#commemorative-nft-collectable-utility) **🖼️ Commemorative NFT Collectable Utility** Category Details Token ID [0.0.8370668](https://hashscan.io/mainnet/token/0.0.8370668) **Circulating Supply** Up to 500 **Original Mint Cost** **Airdropped after burning Cybernetic Bonzo NFT** **Current Utility** Commemorative Bonzo is a token of appreciation provided to community members who burned their Cybernetic Bonzo NFT and offers community-centric utility. * **Cybernetic Role in Discord**: Owning Bonzo Cybernetic NFT Collectible grants holders a unique Discord role, and a memento NFT will be provided to maintain this role after the burn. [PreviousCybernetic NFT](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-nft-collectables/cybernetic-nft) [NextOwnership & License Terms](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-nft-collectables/ownership-and-license-terms) Last updated 4 months ago --- # GitHub | Bonzo Finance Documentation Bonzo Finance Labs is a development shop which contributes to development of the Bonzo Finance protocol, along with its user interface. The Bonzo Finance Labs GitHub can be found here: [https://github.com/bonzo-labs](https://github.com/bonzo-labs) **Please note:** The Bonzo Finance codebase is currently set as private during initial development, but will be made completely open source prior to its mainnet deployment. [PreviousChainlink](https://docs.bonzo.finance/hub/developer/oracles/chainlink) [NextBug Bounty](https://docs.bonzo.finance/hub/developer/bug-bounty) Last updated 1 year ago --- # Flash Loans | Bonzo Finance Documentation Flash Loans are a type of uncollateralized loan that allows developers to borrow substantial amounts of assets for a brief period, execute a defined set of strategies, and repay the loan, all within a single "atomic" transaction. This functionality opens up a world of possibilities for DeFi users, enabling them to take advantage of arbitrage and liquidation bot opportunities, optimize their positions, and access liquidity in ways not previously possible. Learn more in this educational blog posting: "[Flash Loans: How They Work and Potential Use Cases](https://bonzo.finance/blog/flash-loans-how-they-work-and-potential-use-cases) " Once borrowing becomes available on Bonzo Finance, developers will be able to build smart contracts that enable flash loan functionality. Tutorials and code examples for flash loans are coming soon. [PreviousPerforming a Liquidation](https://docs.bonzo.finance/hub/developer/liquidation-bots-beta/performing-a-liquidation) [NextOracles](https://docs.bonzo.finance/hub/developer/oracles) Last updated 1 year ago --- # Season Two Points | Bonzo Finance Documentation ### [](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-points/season-two-points#bonzo-points-season-dates-and-earnings) **Bonzo Points Season Dates & Earnings** Season Two of the [Bonzo Points program](https://app.bonzo.finance/points) officially kicked off on March 1st 2025. Point earnings convert to claimable $BONZO at the end of every points season. The start and end dates for each season are found in the table below: Season Start End 1 Oct 28 2024 February 28 2025 2 March 1 2025 June 2 2025 3 June 3 2025 September 3 2025 Points earnings are based on the dollar value of assets supplied to and borrowed from the protocol, distributed on a 24 hour basis — supported assets of the protocol can be found on [Bonzo Finance.](https://app.bonzo.finance/) Details of points earning calculations for Season Two are found in the table below: **Supply Points** 2 points / $1 USD of token value **Borrow Points** 8 points / $1 USD of token value ### [](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-points/season-two-points#id-1st-edition-bonzo-nft-points-multiplier) **1st Edition Bonzo NFT Points Multiplier** Every [1st Edition Bonzo NFT](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-nft-collectables/1st-edition-bonzo-nfts) gave a "Bonzo Points" multiplier that automatically multiplied the points earned each day during Season Two, giving holders an extra edge in the race to the top of the leaderboard. **The multiplier applied to point earnings is based on the single highest tier 1st Edition Bonzo NFT held in the same account receiving points.** * 🏜️ **Desert Bonzo**: 1.1x multiplier * 🌊 **Ocean Bonzo**: 1.2x multiplier * 🚀 **Space Bonzo**: 1.3x multiplier * 🌌 **Singularity Bonzo**: 1.5x multiplier To purchase an NFT on secondary markets, please visit [SentX](https://sentx.io/nft-marketplace/creators/bonzo-finance) . ![](https://docs.bonzo.finance/hub/~gitbook/image?url=https%3A%2F%2F3581807805-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRfK3lCSOewdMJ6MlbF1B%252Fuploads%252FoZNbvVxQuBKofQ3pUPRp%252FSentx_collectibles.jpg%3Falt%3Dmedia%26token%3D95584a3c-1814-420b-8e1c-2b810d90b5bf&width=768&dpr=4&quality=100&sign=4f313fd9&sv=2) ### [](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-points/season-two-points#cybernetic-nft-points-multiplier-s) **Cybernetic NFT Points Multiplier(s)** The Bonzo Cybernetic NFT Collectible features a 1.05x points multiplier, stackable on itself and 1st Edition Bonzo NFT Collectibles held in the account receiving points. This multiplier is active until the Cybernetic NFT is [burned for $BONZO](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-nft-collectables/cybernetic-nft#distribution-of-usdbonzo-tokens) , with a total stacking cap of 2.0x. **The multiplier applied to point earnings is based on the number of Bonzo Cybernetic NFTs stacked on both themselves and 1st Edition Bonzo NFTs for a maximum multiplier of 2.0x. Please see the table below for an example.** NFT Type Points Multiplier Running Total Multiplier 1st Edition Singularity 1.5x 1.5x Cybernetic NFT #1 1.05x 1.55x Cybernetic NFT #2 1.05x 1.60x Cybernetic NFT #3 1.05x 1.65x Cybernetic NFT #4 1.05x 1.7x Cybernetic NFT #5 1.05x 1.75x Cybernetic NFT #6 1.05x 1.8x Cybernetic NFT #7 1.05x 1.85x Cybernetic NFT #8 1.05x 1.9x Cybernetic NFT #9 1.05x 1.95x Cybernetic NFT #10 1.05x 2.0x ![](https://docs.bonzo.finance/hub/~gitbook/image?url=https%3A%2F%2F3581807805-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRfK3lCSOewdMJ6MlbF1B%252Fuploads%252Fss0jYfPVf6rjz72kMJTn%252FCyberneticBonzo%2520%281%29.png%3Falt%3Dmedia%26token%3D15a50d70-c328-4521-9323-a9db0d6f2891&width=768&dpr=4&quality=100&sign=c2a62f58&sv=2) Cybernetic Bonzo [0.0.7743905](https://hashscan.io/mainnet/token/0.0.7743905) [PreviousSeason One Points](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-points/season-one-points) [NextSeason Three Points](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-points/season-three-points) Last updated 2 months ago --- # Ownership & License Terms | Bonzo Finance Documentation ### [](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-nft-collectables/ownership-and-license-terms#nft-ownership-and-license-terms) **NFT Ownership and License Terms** Bonzo Finance Foundation has created and issued various NFTs to the public (“_**Bonzo NFTs**_”). Unless otherwise stated, the following terms and conditions (these “_**Terms**_”) apply to each Bonzo NFT. BY PURCHASING OR OTHERWISE TAKING POSSESSION OF ANY BONZO NFT, YOU HEREBY AGREE TO THESE TERMS. IF YOU DO NOT AGREE TO THESE TERMS, DO NOT PURCHASE OR OTHERWISE TAKE POSSESSION OF ANY BONZO NFT. BONZO FINANCE FOUNDATION RESERVES THE RIGHT TO MODIFY THESE TERMS AT ANY TIME WITHOUT PRIOR NOTICE TO YOU. 1. **Definitions**. * “_**Art**_” means any art, design, and drawings that may be associated with an NFT that you Own. * "_**NFT**_" means any blockchain-tracked, non-fungible token, such as those conforming to the Hedera Token Service standard, including Bonzo NFTs. * “_**Own**_” means, with respect to an NFT, an NFT that you have purchased or otherwise rightfully acquired from a legitimate source, where proof of such purchase is recorded on the relevant blockchain. * “_**Purchased NFT**_” means an NFT that you Own. 2. **Ownership**. You acknowledge and agree that Bonzo Finance Foundation (or, as applicable, its licensors) owns all legal right, title and interest in and to the Art, and all intellectual property rights therein. The rights that you have in and to the Art are limited to those described in this License. Bonzo Finance Foundation reserves all rights in and to the Art not expressly granted to you in this License. 3. **Utility**. Owners may be offered utility, benefits, or entitlements (collectively, “Utility”) from time to time, but these Terms do not confer any Utility except as granted by the License. Bonzo Finance Foundation makes no assurances of any Utility. Any Utility may be subject to other terms and conditions. Bonzo Finance Foundation shall not be responsible in any manner for any Utility offered by any third party. 4. **License**. Subject to your continued compliance with the terms of this License, Bonzo Finance Foundation grants you a worldwide, non-exclusive, non-transferable, royalty-free license to use, copy, and display the Art for your Purchased NFTs, solely for the following purposes: (i) for your own personal, non-commercial use; (ii) as part of a marketplace that permits the purchase and sale of your NFTs, provided that the marketplace cryptographically verifies each NFT owner’s rights to display the Art for their Purchased NFTs to ensure that only the actual owner can display the Art; or (iii) as part of a third party website or application that permits the inclusion, involvement, or participation of your NFTs, provided that the website/application cryptographically verifies each NFT owner’s rights to display the Art for their Purchased NFTs to ensure that only the actual owner can display the Art, and provided that the Art is no longer visible once the owner of the Purchased NFT leaves the website/application. 5. **Restrictions**. You agree that you may not, nor permit any third party to do or attempt to do any of the foregoing without Bonzo Finance Foundation’s express prior written consent in each case: (i) modify the Art for your Purchased NFT in any way, including, without limitation, the shapes, designs, drawings, attributes, or color schemes (your use of Extensions will not constitute a prohibited modification hereunder); (ii) use the Art for your Purchased NFTs to advertise, market, or sell any third party product or service; (iii) use the Art for your Purchased NFTs in connection with images, videos, or other forms of media that depict hatred, intolerance, violence, cruelty, or anything else that could reasonably be found to constitute hate speech or otherwise infringe upon the rights of others; (iv) use the Art for your Purchased NFTs in movies, videos, or any other forms of media, except to the limited extent that such use is expressly permitted in Section 3(b) above or solely for your own personal, non-commercial use; (v) sell, distribute for commercial gain (including, without limitation, giving away in the hopes of eventual commercial gain), or otherwise commercialize merchandise that includes, contains, or consists of the Art for your Purchased NFTs; (vi) attempt to trademark, copyright, or otherwise acquire additional intellectual property rights in or to the Art for your Purchased NFTs; or (vii) otherwise utilize the Art for your Purchased NFTs for your or any third party’s commercial benefit. 6. **Royalties**. In addition to any Hedera network transaction fees, each time an NFT is transferred via a network transaction to another network account, Bonzo Finance Foundation shall collect a commission of 5% of the total value of that transaction (each, a “Commission”). You acknowledge and agree that the Commission will be transferred directly to Bonzo Finance Foundation through the Hedera network as part of the network transaction. 7. **Terms of License**. The license granted in Section 3 above applies only to the extent that you continue to Own the applicable Purchased NFT. If at any time you sell, trade, donate, give away, transfer, or otherwise dispose of your Purchased NFT for any reason, the license granted in Section 3 will immediately expire with respect to those NFTs without the requirement of notice, and you will have no further rights in or to the Art for those NFTs. 8. **Disclaimer of Risks**. You accept and acknowledge each of the following: * The value of an NFT is subjective and volatile. Bonzo Finance Foundation does not guarantee the future value of any Bonzo NFTs. You accept and acknowledge that the Bonzo NFTs do not represent investment contracts or any other investment vehicle, and the purchaser of any Bonzo NFT may lose money. * The Bonzo NFTs are recorded on the Hedera network, and Bonzo Finance Foundation is not responsible for any issues associated with the risk of hardware, software and internet connections, the risk of malicious software introduction, and the risk that third parties may obtain unauthorized access to information stored within your wallet, and any other technical risks associated with the underlying Hedera network, including network forks, upgrades, or outages that have unintended consequences for the Bonzo NFTs. You accept and acknowledge that Bonzo Finance Foundation will not be responsible for any communication failures, disruptions, errors, distortions or delays you may experience when using the Hedera network, however caused. * The regulatory regime governing blockchain technologies, cryptocurrencies, and tokens is uncertain, and new regulations or policies may materially adversely affect the Bonzo NFTs and their potential utility or value. You accept and acknowledge that Bonzo Finance Foundation is not responsible for your compliance with your local laws and regulations applicable to NFTs. 9. **Indemnification**. You agree to indemnify and hold harmless Bonzo Finance Foundation from and against any and all claims, damages, liabilities, costs, and expenses (including reasonable attorneys' fees) arising out of or in connection with any breach of your rights and obligations under these Terms. 10. **Limitation of Liability**. In no event shall either party be liable to the other party for any indirect, incidental, consequential, special, punitive, or exemplary damages (including, without limitation, damages for loss of profits, revenue, business, data, or use), even if such party has been advised of the possibility of such damages. Except for liability arising from a breach of Section 5 (Indemnification) or a party's gross negligence or willful misconduct, each party's total cumulative liability to the other party for any and all claims and damages arising out of or relating to this Agreement shall not exceed the greater of the total amount of the purchase price paid by you to Bonzo Finance Foundation or $100 USD in the event you did not acquire the Purchased NFT from Bonzo Finance Foundation. 11. **Dispute Resolution**. These Terms shall be governed by and construed in accordance with the laws of the State of New York, without regard to its conflict of laws principles. Any dispute, controversy, or claim arising out of or relating to this Agreement, or the breach, termination, or validity thereof, shall be resolved by final and binding arbitration administered by JAMS in accordance with its Comprehensive Arbitration Rules and Procedures (the "JAMS Rules") then in effect. The arbitration shall be conducted in New York City, New York. The arbitration shall be conducted by a single arbitrator selected in accordance with the JAMS Rules. The arbitrator shall be experienced in commercial transactions involving intellectual property. The arbitrator shall award the prevailing party, if any, its costs and reasonable attorneys' fees. If no party is deemed to be the prevailing party, each party shall bear its own costs and attorneys' fees. [PreviousCommemorative NFT](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-nft-collectables/commemorative-nft) [NextAudits](https://docs.bonzo.finance/hub/security-and-risk/audits) Last updated 1 year ago --- # Season Three Points | Bonzo Finance Documentation ### [](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-points/season-three-points#bonzo-points-season-dates-and-earnings) **Bonzo Points Season Dates & Earnings** Season three of the [Bonzo Points program](https://app.bonzo.finance/points) officially kicked off on June 3rd 2025. Point earnings convert to claimable $BONZO at the end of a every points season. The start and end dates for each season are found in the table below: Season Start End 1 Oct 28 2024 February 28 2025 2 March 1 2025 June 2 2025 3 June 3 2025 September 3 2025 Points earnings are based on the dollar value of assets supplied to and borrowed from the protocol, distributed on a 24 hour basis — supported assets of the protocol can be found on [Bonzo Finance.](https://app.bonzo.finance/) Details of points earning calculations for season one are found in the table below: **Supply Points** 2 points / $1 USD of token value **Borrow Points** 8 points / $1 USD of token value ### [](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-points/season-three-points#id-1st-edition-bonzo-nft-points-multiplier) **1st Edition Bonzo NFT Points Multiplier** Every [1st Edition Bonzo NFT](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-nft-collectables/1st-edition-bonzo-nfts) gave a "Bonzo Points" multiplier that automatically multiplied the points earned each day during Season Three, giving holders an extra edge in the race to the top of the leaderboard. **The multiplier applied to point earnings is based on the single highest tier 1st Edition Bonzo NFT held in the same account receiving points.** * 🏜️ **Desert Bonzo**: 1.1x multiplier * 🌊 **Ocean Bonzo**: 1.2x multiplier * 🚀 **Space Bonzo**: 1.3x multiplier * 🌌 **Singularity Bonzo**: 1.5x multiplier To purchase an NFT on secondary markets, please visit [SentX](https://sentx.io/nft-marketplace/creators/bonzo-finance) . ![](https://docs.bonzo.finance/hub/~gitbook/image?url=https%3A%2F%2F3581807805-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRfK3lCSOewdMJ6MlbF1B%252Fuploads%252FoZNbvVxQuBKofQ3pUPRp%252FSentx_collectibles.jpg%3Falt%3Dmedia%26token%3D95584a3c-1814-420b-8e1c-2b810d90b5bf&width=768&dpr=4&quality=100&sign=4f313fd9&sv=2) ### [](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-points/season-three-points#cybernetic-nft-points-multiplier-s) **Cybernetic NFT Points Multiplier(s)** The Bonzo Cybernetic NFT Collectible features a 1.05x points multiplier, stackable on itself and 1st Edition Bonzo NFT Collectibles held in the account receiving points. This multiplier is active until the Cybernetic NFT is [burned for $BONZO](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-nft-collectables/cybernetic-nft#distribution-of-usdbonzo-tokens) , with a total stacking cap of 2.0x. **The multiplier applied to point earnings is based on the number of Bonzo Cybernetic NFTs stacked on both themselves and 1st Edition Bonzo NFTs for a maximum multiplier of 2.0x. Please see the table below for an example.** NFT Type Points Multiplier Running Total Multiplier 1st Edition Singularity 1.5x 1.5x Cybernetic NFT #1 1.05x 1.55x Cybernetic NFT #2 1.05x 1.60x Cybernetic NFT #3 1.05x 1.65x Cybernetic NFT #4 1.05x 1.7x Cybernetic NFT #5 1.05x 1.75x Cybernetic NFT #6 1.05x 1.8x Cybernetic NFT #7 1.05x 1.85x Cybernetic NFT #8 1.05x 1.9x Cybernetic NFT #9 1.05x 1.95x Cybernetic NFT #10 1.05x 2.0x ![](https://docs.bonzo.finance/hub/~gitbook/image?url=https%3A%2F%2F3581807805-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRfK3lCSOewdMJ6MlbF1B%252Fuploads%252Fss0jYfPVf6rjz72kMJTn%252FCyberneticBonzo%2520%281%29.png%3Falt%3Dmedia%26token%3D15a50d70-c328-4521-9323-a9db0d6f2891&width=768&dpr=4&quality=100&sign=c2a62f58&sv=2) Cybernetic Bonzo [0.0.7743905](https://hashscan.io/mainnet/token/0.0.7743905) [PreviousSeason Two Points](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-points/season-two-points) [NextSeason Four Points](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-points/season-four-points) Last updated 2 months ago --- # SaucerSwap DEX | Bonzo Finance Documentation [](https://docs.bonzo.finance/hub/developer/liquidation-bots-beta/saucerswap-dex#how-the-liquidation-bot-utilizes-saucerswap-on-hedera) How the Liquidation Bot Utilizes SaucerSwap on Hedera -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- The liquidation process involves not only repaying the borrower's debt but also converting assets to ensure that the liquidator ends up with a net profit. On the Hedera network, SaucerSwap plays a crucial role in facilitating these token swaps efficiently. ### [](https://docs.bonzo.finance/hub/developer/liquidation-bots-beta/saucerswap-dex#what-is-saucerswap) What is SaucerSwap? [SaucerSwap](https://www.saucerswap.finance/) is a decentralized exchange (DEX) built on the Hedera network. It allows users to swap between different Hedera Token Service (HTS) assets seamlessly and provides liquidity pools for various token pairs. ### [](https://docs.bonzo.finance/hub/developer/liquidation-bots-beta/saucerswap-dex#role-of-saucerswap-in-liquidation) Role of SaucerSwap in Liquidation When performing a liquidation on the Bonzo Protocol: 1. **Flash Loan**: The liquidator contract takes out a flash loan of the debt asset from the Bonzo lending pool. 2. **Debt Repayment**: The borrowed amount is used to repay the borrower's debt, thereby initiating the liquidation process. 3. **Collateral Acquisition**: In return for repaying the debt, the liquidator receives a portion of the borrower's collateral, including a liquidation bonus. 4. **Token Swap via SaucerSwap**: The collateral asset received may not be the desired asset for the liquidator. Using SaucerSwap, the liquidator swaps the collateral asset back to the original debt asset or another preferred asset. 5. **Repaying the Flash Loan**: The liquidator uses the swapped assets to repay the flash loan plus any fees, keeping any remaining assets as profit. ### [](https://docs.bonzo.finance/hub/developer/liquidation-bots-beta/saucerswap-dex#integration-with-the-liquidator-contract) Integration with the Liquidator Contract The `**LiquidatorContract.sol**` is designed to interact seamlessly with SaucerSwap: * **Associating Tokens**: On Hedera, tokens need to be associated with an account or contract before they can be transferred. The liquidator contract includes functions to associate necessary tokens to facilitate swaps. * **Swapping Assets**: The `**executeOperation()**` function in the contract uses SaucerSwap's router to swap the collateral assets received during liquidation back into the debt asset or another specified token. * **Optimizing Profits**: By leveraging SaucerSwap's liquidity pools, the liquidator can optimize the swap rates, ensuring maximum profitability from the liquidation process. ### [](https://docs.bonzo.finance/hub/developer/liquidation-bots-beta/saucerswap-dex#benefits-of-using-saucerswap) Benefits of Using SaucerSwap * **Liquidity**: Access to deep liquidity pools for various token pairs on the Hedera network. * **Efficiency**: Fast and cost-effective swaps due to Hedera's high throughput and low fees. * **Smart Contract Integration**: Easy integration with smart contracts, enabling automated and trustless execution of swaps during the liquidation process. [PreviousLiquidation Bots (Beta)](https://docs.bonzo.finance/hub/developer/liquidation-bots-beta) [NextEnvironment Setup](https://docs.bonzo.finance/hub/developer/liquidation-bots-beta/environment-setup) Last updated 11 months ago --- # Oracles | Bonzo Finance Documentation Oracles are on-chain entities that bridge the gap between blockchain-based smart contracts and real-world data, such as cryptocurrency prices. They play a crucial role in ensuring that price feed data used by DeFi protocols is up-to-date, accurate, and tamper-proof. In the context of lending and borrowing, oracles provide the necessary price feeds that enable these platforms to determine collateral requirements, calculate interest rates, and execute liquidations when needed. Bonzo Finance utilizes both [Chainlink](https://docs.bonzo.finance/hub/developer/oracles/chainlink) and [Supra](https://docs.bonzo.finance/hub/developer/oracles/supra) oracles for verifiable, tamper proof asset price feed data. Check out the educational article "[The Role of Oracles in Decentralized Lending & Borrowing](https://bonzo.finance/blog/the-role-of-oracles-in-decentralized-lending-and-borrowing) " to learn more about the world of oracles and their significance in DeFi lending and borrowing ecosystems. [PreviousFlash Loans](https://docs.bonzo.finance/hub/developer/flash-loans) [NextSupra](https://docs.bonzo.finance/hub/developer/oracles/supra) Last updated 8 months ago --- # Bug Bounty | Bonzo Finance Documentation Protocol security is a top priority for Bonzo Finance Labs. To encourage responsible disclosure of vulnerabilities, a Bug Bounty Program exists with financial rewards based on the severity of the identified issues. ### [](https://docs.bonzo.finance/hub/developer/bug-bounty#scope) Within Scope * Bonzo Finance [testnet contracts](https://docs.bonzo.finance/hub/developer/protocol-contracts) and [GitHub repositories](https://github.com/bonzo-labs) * Bonzo Finance [testnet interface](https://testnet.bonzo.finance/) ### [](https://docs.bonzo.finance/hub/developer/bug-bounty#scope-1) Out of Scope * Bonzo Finance mainnet contracts and production environment (testing restricted to testnet, which mirrors mainnet) * Third-party contracts not directly associated with Bonzo Finance * Known issues from previous audit and bug bounty reports * Third-party applications using Bonzo Finance contracts * Any findings that rely on Denial of Service (DoS) or Distributed Denial of Service (DDoS) ### [](https://docs.bonzo.finance/hub/developer/bug-bounty#scope-2) Rewards The program includes the following four-level severity scale, based on the OWASP risk rating methodology: **• Critical:** Issues that could impact numerous users and have serious reputational, legal, or financial implications. An example would be being able to lock contracts permanently or take funds from all users. **• High:** Issues that impact individual users where exploitation would pose reputational, legal, or moderate financial risk to the user. **• Medium:** The risk is relatively small and does not pose a threat to user funds. **• Informational:** The issue does not pose an immediate risk but is relevant to security best practices. Bonzo Finance Labs will determine rewards based on the bug's severity and its potential for exploitation. Rewards may be disbursed in U.S. dollars, cryptocurrency, or a mix of both. ### [](https://docs.bonzo.finance/hub/developer/bug-bounty#disclosure) Disclosure Report vulnerabilities to [\[email protected\]](https://docs.bonzo.finance/cdn-cgi/l/email-protection#cfaca0a1bbaeacbb8fada0a1b5a0e1a9a6a1aea1acaa) . An acknowledgment will be sent within two to three business days. Do not disclose the bug publicly until it is resolved and permitted by Bonzo Finance Labs. A detailed report of a vulnerability increases the likelihood of a reward and may increase the reward amount. Please provide as much information about the vulnerability as possible, including: * Conditions required for reproducing the bug * Step-by-step guide or proof of concept for reproduction * Potential consequences if exploited * Suggested remediation (optional) Anyone who reports a unique, previously-unreported vulnerability that results in a change to the code or a configuration change and who keeps such vulnerability confidential until it has been resolved by our engineers will be financially rewarded. ### [](https://docs.bonzo.finance/hub/developer/bug-bounty#eligibility) Eligibility To be eligible for a reward under this program, you must meet the following conditions: 1. **Uniqueness:** Discover a previously unreported, non-public vulnerability that is not already known to our team and is within the scope of the program. 2. **First Disclosure:** Be the first to disclose the unique vulnerability to [\[email protected\]](https://docs.bonzo.finance/cdn-cgi/l/email-protection#e88b87869c898b9ca88a87869287c68e818689868b8d) and adhere to the program's disclosure requirements. 3. **Detailed Reporting:** Provide comprehensive information that enables our engineers to reproduce and remedy the vulnerability. 4. **Non-Exploitation:** Do not exploit the vulnerability in any form, including publicizing it or seeking other forms of profit, except under this program. 5. **Non-Publicization:** Do not disclose the vulnerability to the public or any third party without our explicit approval. 6. **Ethical Conduct:** Make a good faith effort to prevent privacy violations, data destruction, service interruption, or any degradation of in-scope assets. 7. **Lawful Behavior:** Do not engage in any unlawful conduct during the disclosure process, such as making threats or demands. 8. **Age Requirement:** Must be at least 18 years of age. If younger, you may participate with the consent of a parent or guardian. 9. **Legal Compliance:** Cannot be subject to U.S. sanctions or reside in a U.S.-embargoed country. 10. **Non-Affiliation:** Cannot be a current or former employee, vendor, or contractor who contributed to the development of the affected code. 11. **Complete Compliance:** Must comply with all other eligibility requirements specified in this program. By meeting these criteria, you become eligible for a reward under the Bonzo Finance Bug Bounty Program. ### [](https://docs.bonzo.finance/hub/developer/bug-bounty#other-terms) Other Terms By submitting a report, you grant Bonzo Finance Labs the rights necessary to validate and resolve the vulnerability. All reward decisions are at our sole discretion. The program's terms may be changed at any time. For questions about the bug bounty program, please contact [\[email protected\]](https://docs.bonzo.finance/cdn-cgi/l/email-protection#e88b87869c898b9ca88a87869287c68e818689868b8d) . [PreviousGitHub](https://docs.bonzo.finance/hub/developer/github) [NextBrand Assets](https://docs.bonzo.finance/hub/resources/brand-assets) Last updated 8 months ago --- # Liquidation Bots (Beta) | Bonzo Finance Documentation **Disclaimer:** This tutorial is for educational purposes only. Liquidations involve financial risk. All participants should ensure compliance with applicable laws and regulations in their jurisdiction before performing any liquidation activities. In the Bonzo Protocol, liquidation occurs when a borrower's collateral value falls below a certain threshold due to changes in asset prices or accrued interest. Liquidators can repay a portion of the borrower's debt and receive a liquidation bonus on the collateral they obtain. This process helps maintain the protocol's solvency and incentivizes liquidators. This tutorial will demonstrate how to perform a liquidation on the Bonzo Protocol deployed on the Hedera blockchain using a custom smart contract and a Hardhat script. #### [](https://docs.bonzo.finance/hub/developer/liquidation-bots-beta#core-concepts) **Core Concepts:** * **Collateral Asset**: The asset supplied by the borrower. * **Debt Asset**: The asset borrowed by the borrower. * **Health Factor**: A value representing the safety of the borrower's position. A health factor below 1 indicates that the position is undercollateralized and can be liquidated. #### [](https://docs.bonzo.finance/hub/developer/liquidation-bots-beta#example-code-and-script-repositories) **Example Code & Script Repositories:** * **Smart Contract**: [LiquidationContract.sol](https://github.com/Bonzo-Labs/bonzo-finance-contracts/blob/main/contracts/examples/LiquidationContract.sol) * **Sample Scripts**: [liquidationFlashLoan scripts](https://github.com/Bonzo-Labs/bonzo-finance-contracts/tree/main/scripts/liquidationFlashLoan) [PreviousProtocol Contracts](https://docs.bonzo.finance/hub/developer/protocol-contracts) [NextSaucerSwap DEX](https://docs.bonzo.finance/hub/developer/liquidation-bots-beta/saucerswap-dex) Last updated 11 months ago --- # 1st Edition Bonzo NFTs | Bonzo Finance Documentation [](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-nft-collectables/1st-edition-bonzo-nfts#bonzo-nft-collectibles) Bonzo NFT Collectibles ---------------------------------------------------------------------------------------------------------------------------------------------------------- Bonzo NFT Collectibles can be purchased on secondary NFT marketplaces across the Hedera ecosystem, such as [SentX](https://sentx.io/nft-marketplace/creators/bonzo-finance) and [Kabila](https://market.kabila.app/en/collections) . ![](https://docs.bonzo.finance/hub/~gitbook/image?url=https%3A%2F%2F3581807805-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRfK3lCSOewdMJ6MlbF1B%252Fuploads%252F0G9hLlHMI8vy0q7EebSD%252F1desert.jpg%3Falt%3Dmedia%26token%3D7d4c91fb-e2dd-4293-a836-d3c41de24fe8&width=768&dpr=4&quality=100&sign=5cf2eb6d&sv=2) Desert Bonzo [0.0.6178137](https://hashscan.io/mainnet/token/0.0.6178137) ![](https://docs.bonzo.finance/hub/~gitbook/image?url=https%3A%2F%2F3581807805-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRfK3lCSOewdMJ6MlbF1B%252Fuploads%252FJdRCEXrKujAL0ESPwvNN%252F2ocean.jpg%3Falt%3Dmedia%26token%3Dab281d26-e4df-487d-8420-83bb5f3fe539&width=768&dpr=4&quality=100&sign=2363ccae&sv=2) Ocean Bonzo [0.0.6178141](https://hashscan.io/mainnet/token/0.0.6178141) ![](https://docs.bonzo.finance/hub/~gitbook/image?url=https%3A%2F%2F3581807805-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRfK3lCSOewdMJ6MlbF1B%252Fuploads%252FBhCaO9fHzeaVAOpJ6YuU%252F3space.jpg%3Falt%3Dmedia%26token%3D2a2eda4c-81cf-4080-a3a4-0a27ace94269&width=768&dpr=4&quality=100&sign=cd2c8b3d&sv=2) Space Bonzo [0.0.6178143](https://hashscan.io/mainnet/token/0.0.6178143) ![](https://docs.bonzo.finance/hub/~gitbook/image?url=https%3A%2F%2F3581807805-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRfK3lCSOewdMJ6MlbF1B%252Fuploads%252FqcuVyc62ZqnFP7W7TOab%252F4singularity.jpg%3Falt%3Dmedia%26token%3D44326723-7136-4e69-99bb-aeb86209076a&width=768&dpr=4&quality=100&sign=b4625814&sv=2) Singularity Bonzo [0.0.6173820](https://hashscan.io/mainnet/token/0.0.6173820?p=1&k=1) [](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-nft-collectables/1st-edition-bonzo-nfts#distribution-of-usdbonzo-tokens) **🪙 Distribution of $BONZO tokens** --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- * Accounts holding Bonzo NFT Collectibles are eligible to claim distributions of $BONZO. The distribution schedule of $BONZO tokens to NFT holders is found in the table below. Distribution Date(s) Amount **Distribution #1** Upon TGE (token generation event) \[February 21, 2025\] 75% of "claimable" $BONZO per NFT **Distribution #2** End of Season 2 points \[June 3, 2025\] 25% of "claimable" $BONZO per NFT [](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-nft-collectables/1st-edition-bonzo-nfts#bonus-usdbonzo-tokens-distribution-complete) **⭐️ Bonus $BONZO Tokens -** Distribution Complete ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- As part of the NFT sale campaign, bonus $BONZO tokens were awarded to accounts that held 20 or more of a single Bonzo NFT type: * 4,125 $BONZO (for holding 20+ of Desert) * 12,375 $BONZO (for holding 20+ of Ocean) * 24,875 $BONZO (for holding 20+ of Space) _Note: NFT types could not be combined to meet the 20+ threshold._ **To qualify, eligible accounts had to:** * Hold the required quantity during the first snapshot at the end of the NFT sale * Still hold the NFTs during a randomly timed second snapshot that occurred prior to the Token Generation Event (TGE) Both snapshots have been taken, and bonus distributions were sent in full to qualifying accounts at the time of the TGE. [](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-nft-collectables/1st-edition-bonzo-nfts#bonzo-nft-collectables-utility) **🖼️ Bonzo NFT Collectables Utility** ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- The three NFT tiers are as follows: Desert Ocean Space Token ID [0.0.6178137](https://hashscan.io/mainnet/token/0.0.6178137) [0.0.6178141](https://hashscan.io/mainnet/token/0.0.6178141) [0.0.6178143](https://hashscan.io/mainnet/token/0.0.6178143) **Circulating Supply** 1,323 798 400 **Original Mint Cost (June 24)** **$100** 1,210 ℏ **$300** 3,630 ℏ **$600** 7,320 ℏ **Current Utility** • Dedicated “Desert” role in Discord • Early access to Bonzo PFP avatars • $BONZO faucet rewards in Discord • 1.1x [Bonzo Points](https://app.bonzo.finance/points) multiplier for utilization of protocol • Ability to claim up to ~3,300~ 6,270 $BONZO tokens • Dedicated “Ocean” role in Discord • Early access to Bonzo PFP avatars • $BONZO faucet rewards in Discord • 1.2x [Bonzo Points](https://app.bonzo.finance/points) multiplier for utilization of protocol • Ability to claim up to ~9,900~ 18,810 $BONZO tokens • Dedicated “Space” role in Discord • Early access to Bonzo PFP avatars • $BONZO faucet rewards in Discord • 1.3x [Bonzo Points](https://app.bonzo.finance/points) multiplier for utilization of protocol • Ability to claim up to ~19,900~ 37,810 $BONZO tokens A fourth “Singularity” NFT collectible was sent to all accounts holding each of the three NFTs listed above after the sale had commenced and an account “snapshot” was taken. Utility for the "Singularity" NFT is as follows: Singularity Token ID [0.0.6173820](https://hashscan.io/mainnet/token/0.0.6173820?p=1&k=1) **Circulating Supply** 389 **Original Mint Cost (June 24)** For every complete set of Desert, Ocean, and Space Bonzo NFTs purchased, a Singularity Bonzo NFT was airdropped to the purchasing account ID. **Current Utility** • Dedicated “Singularity” role in Discord • Early access to Bonzo PFP avatars • $BONZO faucet rewards in Discord • 1.5x [Bonzo Points](https://app.bonzo.finance/points) multiplier for utilization of protocol • Ability to claim up to ~1,175~ 2,519 $BONZO tokens [](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-nft-collectables/1st-edition-bonzo-nfts#royalty-fee) **👑 Royalty Fee** ------------------------------------------------------------------------------------------------------------------------------------------- There are royalty fees for Bonzo NFTs as outlined in the table below. Description % Fee Bonzo Finance 4.5% InAMaze Artist 0.5% [PreviousBonzo NFT Collectables](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-nft-collectables) [NextCybernetic NFT](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-nft-collectables/cybernetic-nft) Last updated 4 months ago --- # Supra | Bonzo Finance Documentation [Supra](https://docs.supra.com/oracles/data-feeds/data-feeds-index#tab-crypto) push oracles are currently being utilized in the Bonzo Finance protocol on Hedera for accurate and reliable price feeds. To view live data feeds, please visit the [Supra data feed dashboard](https://supra.com/data) . Provider Feeds EVM Contract Details Supra HBARX / wHBAR SAUCE / wHBAR XSAUCE / wHBAR DOVU / wHBAR PACK / wHBAR KARATE / wHBAR STEAM / wHBAR HST / wHBAR [0xD02cc7a670047b6b012556A88e275c685d25e0c9](https://hashscan.io/mainnet/contract/0.0.4322850) Heartbeat: 1 hr Deviation Threshold: 0.5% Read more about Bonzo Finance's Supra implementation in this blog posting: [https://bonzo.finance/blog/integrating-supra-oracles-into-bonzo-finance-on-hedera-hashgraph](https://bonzo.finance/blog/integrating-supra-oracles-into-bonzo-finance-on-hedera-hashgraph) [PreviousOracles](https://docs.bonzo.finance/hub/developer/oracles) [NextChainlink](https://docs.bonzo.finance/hub/developer/oracles/chainlink) Last updated 3 months ago --- # Glossary | Bonzo Finance Documentation This glossary contains definitions for common terms used throughout the Bonzo Finance documentation. Familiarizing yourself with these terms will help you better understand the protocol and its various components. If further assistance is needed or you have any development-related questions, please don't hesitate to reach out on [Discord](https://www.bonzo.finance/discord) . Term Description Annual Percentage Yield (APY) APY represents the estimated annual return on your investment, taking into account the effect of compound interest. It differs from Annual Percentage Rate (APR), which does not consider compounding. aTokens Tokens that represent a user's share of the supplied assets in a lending pool. They are minted when a user supplies an asset and burned when the user withdraws their funds. bTokens accrue interest over time based on the lending pool's performance. Bonzo Token (BONZO) The native governance token of the Bonzo Finance protocol. BONZO token holders can participate in the decision-making process by voting on protocol upgrades and parameter changes. Borrow APY The real-time interest APY for borrowing. This rate is variable and determined by the ratio of total supplied and borrowed by all users. Borrow Cap The maximum total amount of an asset that can be borrowed from the Bonzo Finance protocol across all users. Borrow caps help protect the protocol by preventing excessive borrowing of any single asset and maintaining healthy liquidity levels. Collateral An asset that a borrower pledges as security for a loan. In Bonzo Finance, users can supply various cryptocurrencies as collateral to borrow other assets. Collateralization Ratio The ratio between the value of the collateral and the value of the borrowed asset. It determines the maximum amount a user can borrow based on their collateral. Flash Loan Uncollateralized loans that allow users to borrow funds without providing upfront collateral, as long as the borrowed amount plus fees are returned within the same transaction. Flash loans enable various use cases such as arbitrage, collateral swapping, and debt refinancing. Health Factor A metric that represents the safety of a borrower's position. It is calculated by dividing the total value of the collateral (multiplied by the liquidation threshold) by the total borrowed amount. A health factor below 1 indicates that the position is undercollateralized and subject to liquidation. Interest Rate Model The algorithm that determines the interest rates for borrowing and lending based on the supply and demand dynamics of each asset. Bonzo Finance employs a variable interest rate model that adjusts rates in real-time to maintain a balanced market. Liquidation The process of selling a borrower's collateral to repay their outstanding debt when their position becomes undercollateralized (i.e., when the health factor drops below 1). Liquidation Bonus An incentive given to liquidators in the form of a bonus on top of the liquidated collateral. It encourages liquidators to participate in the liquidation process and maintain the stability of the protocol. Liquidation Threshold The percentage of the collateral's value at which a borrower's position becomes eligible for liquidation. It is specified for each collateral type and helps maintain a safe cushion for the protocol. Loan-to-Value (LTV) Ratio The maximum percentage of an asset's value that a user can borrow. It is determined by the asset's risk profile and helps maintain a healthy level of collateralization. Reserve Factor A percentage of interest payments (protocol fees) that is set aside as protocol reserves, which are used to sustain DAO operations and protocol development. The Reserve Factor also acts as an additional layer of security for the protocol, being employed in cases of shortfall events. Reserves The smart contracts that hold the supplied assets and manage the lending and borrowing activities within the Bonzo Finance protocol. Each supported asset has its own reserve. Slope 1 The gradual interest rate increase applied when utilization of an asset pool is below the "optimal utilization" point. Slope 1 determines the borrow APY and Supply APY for an asset pool. Slope 2 The steep interest rate increase applied when utilization of an asset exceeds the "optimal utilization" point. Slope 2 is designed to discourage 100% utilization of an asset pool and determines the borrow APY and Supply APY for an asset pool. Supply APY The real-time earnings APY for supplying. This rate is variable and determined by the ratio of total supplied and borrowed by all users. Supply Cap The maximum total amount of an asset that can be supplied to the Bonzo Finance protocol across all users. Supply caps help manage risk by limiting the protocol's exposure to any single asset. [PreviousBrand Assets](https://docs.bonzo.finance/hub/resources/brand-assets) [NextContact](https://docs.bonzo.finance/hub/resources/contact) Last updated 8 months ago --- # Liquidator Contract | Bonzo Finance Documentation The `**LiquidatorContract.sol**` smart contract facilitates liquidations by interacting with the Bonzo lending pool and performing token swaps via SaucerSwap. ### [](https://docs.bonzo.finance/hub/developer/liquidation-bots-beta/liquidator-contract#id-1.-review-the-contract) 1\. Review the Contract You can find the contract code [here](https://github.com/Bonzo-Labs/bonzo-finance-contracts/blob/main/contracts/examples/LiquidationContract.sol) . **Key Functions:** * `**liquidate()**`: Initiates the flash loan and triggers the liquidation. * `**executeOperation()**`: Called after receiving the flash-loaned amount; performs the liquidation and token swap. * `**_associateToken()**`: Associates Hedera tokens with the contract (required on Hedera). ### [](https://docs.bonzo.finance/hub/developer/liquidation-bots-beta/liquidator-contract#id-2.-compile-the-contract) 2\. Compile the Contract Compile the contract using Hardhat: Copy npm run compile ### [](https://docs.bonzo.finance/hub/developer/liquidation-bots-beta/liquidator-contract#id-3.-deploy-the-contract) 3\. Deploy the Contract Deploy the contract to the Hedera testnet: Copy npx hardhat run scripts/deploy.ts --network hedera_testnet * Ensure your `**hardhat.config.ts**` is set up for the Hedera testnet. * In `**deploy.ts**`, replace `**LendingPoolAddressesProvider_address**` and `**SaucerswapRouter_address**` with the actual contract addresses. [PreviousEnvironment Setup](https://docs.bonzo.finance/hub/developer/liquidation-bots-beta/environment-setup) [NextConfiguring Hardhat](https://docs.bonzo.finance/hub/developer/liquidation-bots-beta/configuring-hardhat) Last updated 11 months ago --- # Season One Points | Bonzo Finance Documentation ### [](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-points/season-one-points#bonzo-points-season-dates-and-earnings) **Bonzo Points Season Dates & Earnings** Season One of the [Bonzo Points program](https://app.bonzo.finance/points) officially started on October 28, 2024, with the launch of Bonzo Finance on mainnet. Point earnings convert to claimable $BONZO at the end of every points season. The start and end dates for each season are found in the table below: Season Start End 1 Oct 28 2024 February 28 2025 2 March 1 2025 June 2 2025 3 June 3 2025 September 3 2025 Point earnings are based on the dollar value of assets supplied to and borrowed from the protocol, distributed on a 24-hour basis. Supported assets of the protocol can be found on [Bonzo Finance.](https://app.bonzo.finance/dashboard) Details of points earning calculations for Season One are found in the table below: **Mainnet Launch** _(Supply only)_ **After Borrowing Enabled** **Supply Points** 4 points / $1 USD of token value 2 points / $1 USD of token value **Borrow Points** (_Borrowing disabled)_ 8 points / $1 USD of token value ### [](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-points/season-one-points#id-1st-edition-bonzo-nft-points-multiplier) **1st Edition Bonzo NFT Points Multiplier** Every [1st Edition Bonzo NFT](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-nft-collectables/1st-edition-bonzo-nfts) gave a "Bonzo Points" multiplier that automatically multiplied the points earned each day during Season One, giving holders an extra edge in the race to the top of the leaderboard. **The multiplier applied to point earnings is based on the single highest tier 1st Edition Bonzo NFT held in the same account receiving points.** * 🏜️ **Desert Bonzo**: 1.1x multiplier * 🌊 **Ocean Bonzo**: 1.2x multiplier * 🚀 **Space Bonzo**: 1.3x multiplier * 🌌 **Singularity Bonzo**: 1.5x multiplier To purchase an NFT on secondary markets, please visit [SentX](https://sentx.io/nft-marketplace/creators/bonzo-finance) . ![](https://docs.bonzo.finance/hub/~gitbook/image?url=https%3A%2F%2F3581807805-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRfK3lCSOewdMJ6MlbF1B%252Fuploads%252FoZNbvVxQuBKofQ3pUPRp%252FSentx_collectibles.jpg%3Falt%3Dmedia%26token%3D95584a3c-1814-420b-8e1c-2b810d90b5bf&width=768&dpr=4&quality=100&sign=4f313fd9&sv=2) ### [](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-points/season-one-points#cybernetic-nft-points-multiplier-s) **Cybernetic NFT Points Multiplier(s)** The Bonzo Cybernetic NFT Collectible features a 1.05x points multiplier, stackable on itself, and 1st Edition Bonzo NFT Collectibles held in the account receiving points. This multiplier is active until the Cybernetic NFT is [burned for $BONZO](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-nft-collectables/cybernetic-nft#distribution-of-usdbonzo-tokens) , with a total stacking cap of 2.0x. **The multiplier applied to point earnings is based on the number of Bonzo Cybernetic NFTs stacked on both themselves and 1st Edition Bonzo NFTs for a maximum multiplier of 2.0x. Please see the table below for an example.** NFT Type Points Multiplier Running Total Multiplier 1st Edition Singularity 1.5x 1.5x Cybernetic NFT #1 1.05x 1.55x Cybernetic NFT #2 1.05x 1.60x Cybernetic NFT #3 1.05x 1.65x Cybernetic NFT #4 1.05x 1.7x Cybernetic NFT #5 1.05x 1.75x Cybernetic NFT #6 1.05x 1.8x Cybernetic NFT #7 1.05x 1.85x Cybernetic NFT #8 1.05x 1.9x Cybernetic NFT #9 1.05x 1.95x Cybernetic NFT #10 1.05x 2.0x ![](https://docs.bonzo.finance/hub/~gitbook/image?url=https%3A%2F%2F3581807805-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRfK3lCSOewdMJ6MlbF1B%252Fuploads%252Fss0jYfPVf6rjz72kMJTn%252FCyberneticBonzo%2520%281%29.png%3Falt%3Dmedia%26token%3D15a50d70-c328-4521-9323-a9db0d6f2891&width=768&dpr=4&quality=100&sign=c2a62f58&sv=2) Cybernetic Bonzo [0.0.7743905](https://hashscan.io/mainnet/token/0.0.7743905) [PreviousPre-Season Points Airdrop](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-points/pre-season-points-airdrop) [NextSeason Two Points](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-points/season-two-points) Last updated 4 months ago --- # Performing a Liquidation | Bonzo Finance Documentation Now, we'll execute the script to perform the liquidation. ### [](https://docs.bonzo.finance/hub/developer/liquidation-bots-beta/performing-a-liquidation#id-1.-identify-liquidatable-accounts) 1\. Identify Liquidatable Accounts The script contains a list of accounts that are eligible for liquidation. You can get these accounts through this API on the testnet: * [Liquidatable Accounts API](https://bonzo-data-api-testnet-a3d6b2946b71.herokuapp.com/liquidatable) The "Liquidatable Accounts API" for the Hedera mainnet will be made available soon. ### [](https://docs.bonzo.finance/hub/developer/liquidation-bots-beta/performing-a-liquidation#id-2.-configure-the-liquidation-parameters) 2\. Configure the Liquidation Parameters In the script, the `liquidate` function is set up to liquidate a specific user. Update the parameters accordingly. Copy async function liquidate() { const user = liquidatables[2]; // Index of the user in the list const collateralReserve = "0xCollateralAssetAddress"; // Collateral asset address const debtReserve = "0xDebtAssetAddress"; // Debt asset address const borrowed = ethers.utils.parseUnits("100", 18); // Amount to cover // ... rest of the code } * `**user**`: The address of the user to liquidate. * `**collateralReserve**`: The address of the collateral asset. * `**debtReserve**`: The address of the debt asset. * `**borrowed**`: The amount of debt to cover (in wei). Replace the placeholders with the actual values based on the user's positions. ### [](https://docs.bonzo.finance/hub/developer/liquidation-bots-beta/performing-a-liquidation#id-3.-execute-the-script) 3\. Execute the Script Run the script using Hardhat: Copy npx hardhat run scripts/liquidationFlashLoan/liquidate.ts --network hedera_testnet ### [](https://docs.bonzo.finance/hub/developer/liquidation-bots-beta/performing-a-liquidation#id-4.-monitor-the-output) 4\. Monitor the Output The script will output the progress of the liquidation: Copy User: 0x78c3edaf3ae5dc69e688d7f41f85c4745ccd552c Caller address: 0xYourWalletAddress Collateral Reserve: 0xCollateralAssetAddress Debt Reserve: 0xDebtAssetAddress Borrowed: 100 Flash loan successful If the liquidation is successful, you'll see a confirmation message. If there are errors, the script will output the error details. [PreviousConfiguring Hardhat](https://docs.bonzo.finance/hub/developer/liquidation-bots-beta/configuring-hardhat) [NextFlash Loans](https://docs.bonzo.finance/hub/developer/flash-loans) Last updated 11 months ago --- # Bonzo NFT Collectables | Bonzo Finance Documentation [](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-nft-collectables#id-1st-edition-bonzo-nft-collectibles) 1st Edition Bonzo NFT Collectibles -------------------------------------------------------------------------------------------------------------------------------------------------------------- Bonzo NFT Collectibles can be purchased on secondary NFT marketplaces across the Hedera ecosystem, such as [SentX](https://sentx.io/nft-marketplace/creators/bonzo-finance) and [Kabila](https://market.kabila.app/en/collections) . For more information about Bonzo NFT Collectibles, please see the [1st Edition Bonzo NFTs](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-nft-collectables#id-1st-edition-bonzo-nft-collectibles) section of the documentation. ![](https://docs.bonzo.finance/hub/~gitbook/image?url=https%3A%2F%2F3581807805-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRfK3lCSOewdMJ6MlbF1B%252Fuploads%252F0G9hLlHMI8vy0q7EebSD%252F1desert.jpg%3Falt%3Dmedia%26token%3D7d4c91fb-e2dd-4293-a836-d3c41de24fe8&width=768&dpr=4&quality=100&sign=5cf2eb6d&sv=2) Desert Bonzo [0.0.6178137](https://hashscan.io/mainnet/token/0.0.6178137) ![](https://docs.bonzo.finance/hub/~gitbook/image?url=https%3A%2F%2F3581807805-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRfK3lCSOewdMJ6MlbF1B%252Fuploads%252FJdRCEXrKujAL0ESPwvNN%252F2ocean.jpg%3Falt%3Dmedia%26token%3Dab281d26-e4df-487d-8420-83bb5f3fe539&width=768&dpr=4&quality=100&sign=2363ccae&sv=2) Ocean Bonzo [0.0.6178141](https://hashscan.io/mainnet/token/0.0.6178141) ![](https://docs.bonzo.finance/hub/~gitbook/image?url=https%3A%2F%2F3581807805-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRfK3lCSOewdMJ6MlbF1B%252Fuploads%252FBhCaO9fHzeaVAOpJ6YuU%252F3space.jpg%3Falt%3Dmedia%26token%3D2a2eda4c-81cf-4080-a3a4-0a27ace94269&width=768&dpr=4&quality=100&sign=cd2c8b3d&sv=2) Space Bonzo [0.0.6178143](https://hashscan.io/mainnet/token/0.0.6178143) ![](https://docs.bonzo.finance/hub/~gitbook/image?url=https%3A%2F%2F3581807805-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRfK3lCSOewdMJ6MlbF1B%252Fuploads%252FqcuVyc62ZqnFP7W7TOab%252F4singularity.jpg%3Falt%3Dmedia%26token%3D44326723-7136-4e69-99bb-aeb86209076a&width=768&dpr=4&quality=100&sign=b4625814&sv=2) Singularity Bonzo [0.0.6173820](https://hashscan.io/mainnet/token/0.0.6173820?p=1&k=1) [](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-nft-collectables#cybernetic-nft-collectible) Cybernetic NFT Collectible ------------------------------------------------------------------------------------------------------------------------------------------- The Bonzo Cybernetic NFT collectible is available for trading on secondary NFT marketplaces across the Hedera ecosystem, such as [SentX](https://sentx.io/nft-marketplace/creators/bonzo-finance) and [Kabila](https://market.kabila.app/en/collections) . For more information about Bonzo NFT Collectibles, please see the [Cybernetic NFT](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-nft-collectables#cybernetic-nft-collectible) section of the documentation. ![](https://docs.bonzo.finance/hub/~gitbook/image?url=https%3A%2F%2F3581807805-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRfK3lCSOewdMJ6MlbF1B%252Fuploads%252Fss0jYfPVf6rjz72kMJTn%252FCyberneticBonzo%2520%281%29.png%3Falt%3Dmedia%26token%3D15a50d70-c328-4521-9323-a9db0d6f2891&width=768&dpr=4&quality=100&sign=c2a62f58&sv=2) Cybernetic Bonzo [0.0.7743905](https://hashscan.io/mainnet/token/0.0.7743905) [PreviousSeason Four Points](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-points/season-four-points) [Next1st Edition Bonzo NFTs](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-nft-collectables/1st-edition-bonzo-nfts) Last updated 4 months ago --- # Brand Assets | Bonzo Finance Documentation ### [](https://docs.bonzo.finance/hub/resources/brand-assets#logo-png) Logo (PNG) ![](https://docs.bonzo.finance/hub/~gitbook/image?url=https%3A%2F%2F3581807805-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRfK3lCSOewdMJ6MlbF1B%252Fuploads%252FDaMX92Ru7JXoppxvUr9F%252FBlack.png%3Falt%3Dmedia%26token%3D0cbdbe4a-8efb-493a-8f8c-b2abd5a56d91&width=768&dpr=4&quality=100&sign=cbd17ee0&sv=2) ![](https://docs.bonzo.finance/hub/~gitbook/image?url=https%3A%2F%2F3581807805-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRfK3lCSOewdMJ6MlbF1B%252Fuploads%252FCp2Z0Vjow6r3oLTHnN2I%252FWhite.png%3Falt%3Dmedia%26token%3D80cae1a9-4cb5-41b6-b3cb-e1b21042a33c&width=768&dpr=4&quality=100&sign=fef84250&sv=2) ### [](https://docs.bonzo.finance/hub/resources/brand-assets#logo-svg) Logo (SVG) ![](https://docs.bonzo.finance/hub/~gitbook/image?url=https%3A%2F%2F3581807805-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRfK3lCSOewdMJ6MlbF1B%252Fuploads%252FrgBaJ4VPzTAAUrrXEB9B%252FBlack.svg%3Falt%3Dmedia%26token%3D331724d4-e88b-4568-82ce-ccb5d2374893&width=768&dpr=4&quality=100&sign=ad04e7d5&sv=2) ![](https://docs.bonzo.finance/hub/~gitbook/image?url=https%3A%2F%2F3581807805-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRfK3lCSOewdMJ6MlbF1B%252Fuploads%252FBHPlBPA0zFzxEiTYHfHa%252FWhite.svg%3Falt%3Dmedia%26token%3D163a146f-d622-4393-a0f1-b894e80aba87&width=768&dpr=4&quality=100&sign=1553272a&sv=2) ### [](https://docs.bonzo.finance/hub/resources/brand-assets#color-palette) Color Palette ![](https://docs.bonzo.finance/hub/~gitbook/image?url=https%3A%2F%2F3581807805-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRfK3lCSOewdMJ6MlbF1B%252Fuploads%252F5N0e98Wh6sdJbpbXrBu6%252FBonzo%2520Finance%2520Template.001.jpeg%3Falt%3Dmedia%26token%3D3dbd5ec7-1aa9-49bc-ba9e-bc4139ae44ba&width=768&dpr=4&quality=100&sign=b85f176&sv=2) ### [](https://docs.bonzo.finance/hub/resources/brand-assets#typeface) Typeface Name Link SuisseIntl-Medium [https://www.swisstypefaces.com/fonts/suisse/#buy](https://www.swisstypefaces.com/fonts/suisse/#buy) SuisseIntl-Regular [https://www.swisstypefaces.com/fonts/suisse/#buy](https://www.swisstypefaces.com/fonts/suisse/#buy) TiemposText-Medium [https://www.onlinewebfonts.com/download/2f284401b2057179c369b475dd90387d](https://www.onlinewebfonts.com/download/2f284401b2057179c369b475dd90387d) [PreviousBug Bounty](https://docs.bonzo.finance/hub/developer/bug-bounty) [NextGlossary](https://docs.bonzo.finance/hub/resources/glossary) Last updated 1 year ago --- # Chainlink | Bonzo Finance Documentation [Chainlink](http://chain.link/) push oracles are currently being utilized in the Bonzo Finance protocol on Hedera for accurate and reliable price feeds for HBAR and USDC. To view live data feeds, please visit the Chainlink documentation. Provider Asset Feed EVM Contract Details Chainlink HBAR / USD [0xAF685FB45C12b92b5054ccb9313e135525F9b5d5](https://hashscan.io/mainnet/contract/0xAF685FB45C12b92b5054ccb9313e135525F9b5d5?pf=1&ps=1&pr=1&pa=1) Heartbeat: 24 hr Deviation Threshold: 0.5% Chainlink USDC / USD [0x2b358642c7C37b6e400911e4FE41770424a7349F](https://hashscan.io/mainnet/contract/0x2b358642c7C37b6e400911e4FE41770424a7349F) Heartbeat: 24 hr Deviation Threshold: 0.3% Read more about Bonzo Finance's Chainlink implementation in this blog posting: [http://bonzo.finance/blog/bonzo-finance-has-integrated-the-chainlink-standard-for-verifiable-data-on-hedera](http://bonzo.finance/blog/bonzo-finance-has-integrated-the-chainlink-standard-for-verifiable-data-on-hedera) [PreviousSupra](https://docs.bonzo.finance/hub/developer/oracles/supra) [NextGitHub](https://docs.bonzo.finance/hub/developer/github) Last updated 8 months ago --- # Audits | Bonzo Finance Documentation The Bonzo Finance v1 smart contracts have undergone audits by Halborn across the following categories in the table below, with links to each audit: Finance Contracts Liquidity Incentives Staking Module LayerZero OFT Halborn [Link](https://www.halborn.com/audits/bonzo/finance-contracts) [Link](https://www.halborn.com/audits/bonzo/finance-contracts) [Report](https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRfK3lCSOewdMJ6MlbF1B%2Fuploads%2FVzy3zOrWNp6itHRUZP12%2FBonzo_Finance_Staking_Module_Smart_Contract_Security_Assessment.pdf?alt=media&token=3de512a0-04f0-4d24-afb2-3f90f8b00ae2) [Report](https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRl3dkXEKv1yqGhH70g65%2Fuploads%2FJXDsFP3pOPr7VUS9BCMx%2FLayerZero%20OFT%20Connector%20Audit.pdf?alt=media&token=018ef982-4900-4102-aad4-15f26b92a096) [PreviousOwnership & License Terms](https://docs.bonzo.finance/hub/rewards-and-incentives/bonzo-nft-collectables/ownership-and-license-terms) [NextTeam](https://docs.bonzo.finance/hub/contributors/team) Last updated 2 months ago --- # Community | Bonzo Finance Documentation The Bonzo Finance community can be found across the following social media channels and regular development updates provided via the monthly newsletter. Channel URL 🎙️ 𝕏 [https://x.com/bonzo\_finance](https://x.com/bonzo_finance) 👾 Discord [https://bonzo.finance/discord](https://bonzo.finance/discord) 💼 LinkedIn [https://linkedin.com/company/bonzo-finance-labs](https://linkedin.com/company/bonzo-finance-labs) 💌 Newsletter [https://bonzo.finance](https://bonzo.finance/) [PreviousSupport](https://docs.bonzo.finance/hub/resources/contact/support) [NextAccounts & Contracts](https://docs.bonzo.finance/hub/accounts-and-contracts) Last updated 1 year ago --- # Contact | Bonzo Finance Documentation [Support](https://docs.bonzo.finance/hub/resources/contact/support) [Community](https://docs.bonzo.finance/hub/resources/contact/community) [PreviousGlossary](https://docs.bonzo.finance/hub/resources/glossary) [NextSupport](https://docs.bonzo.finance/hub/resources/contact/support) --- # Environment Setup | Bonzo Finance Documentation [](https://docs.bonzo.finance/hub/developer/liquidation-bots-beta/environment-setup#prerequisites) Prerequisites --------------------------------------------------------------------------------------------------------------------- Before we begin, make sure you have the following: * **Basic understanding** of Solidity, Hardhat, and JavaScript/TypeScript. * **Node.js and npm** installed on your machine. * [**HashPack**](https://hashpack.app/) or another wallet configured for the Hedera network. * **Hedera testnet** account credentials. ### [](https://docs.bonzo.finance/hub/developer/liquidation-bots-beta/environment-setup#id-1.-clone-the-repository) 1\. Clone the Repository First, clone the repository containing the smart contract and script: Copy git clone https://github.com/Bonzo-Labs/bonzo-finance-contracts.git cd bonzo-finance-contracts ### [](https://docs.bonzo.finance/hub/developer/liquidation-bots-beta/environment-setup#id-2.-install-dependencies) 2\. Install Dependencies Install the required npm packages (you may need to use the `**--legacy-peer-deps**` flag due to older versions of dependencies): Copy npm install --legacy-peer-deps ### [](https://docs.bonzo.finance/hub/developer/liquidation-bots-beta/environment-setup#id-3.-configure-environment-variables) 3\. Configure Environment Variables Create a `**.env**` file in the root directory and add your Hedera account details and other configurations: Copy PRIVATE_KEY=your-private-key ACCOUNT_ID=your-account-id PROVIDER_URL=https://testnet.hashio.io/api LENDING_POOL_ADDRESS=0x... DATA_PROVIDER_ADDRESS=0x... PRICE_ORACLE_ADDRESS=0x... LIQUIDATOR_CONTRACT_ADDRESS=0x... * Replace `**your-private-key**` and `**your-account-id**` with your actual Hedera testnet account credentials. * Replace `**0x...**` with the actual contract addresses. You can find the mainnet contract addresses [here](https://docs.bonzo.finance/hub/developer/contract-deployments) . ### [](https://docs.bonzo.finance/hub/developer/liquidation-bots-beta/environment-setup#id-4.-install-hedera-sdk-if-not-already-installed) 4\. Install Hedera SDK (if not already installed) Copy npm install @hashgraph/sdk [PreviousSaucerSwap DEX](https://docs.bonzo.finance/hub/developer/liquidation-bots-beta/saucerswap-dex) [NextLiquidator Contract](https://docs.bonzo.finance/hub/developer/liquidation-bots-beta/liquidator-contract) Last updated 11 months ago --- # Configuring Hardhat | Bonzo Finance Documentation The Hardhat script `**liquidate.ts**` automates the liquidation process by interacting with the deployed Liquidator contract. ### [](https://docs.bonzo.finance/hub/developer/liquidation-bots-beta/configuring-hardhat#id-1.-review-the-script) 1\. Review the Script You can find the script code [here](https://github.com/Bonzo-Labs/bonzo-finance-contracts/blob/main/scripts/liquidationFlashLoan/liquidate.ts) . #### [](https://docs.bonzo.finance/hub/developer/liquidation-bots-beta/configuring-hardhat#key-components) **Key Components:** * **Chain Data Configuration**: Contains network-specific data such as operator keys, contract addresses, and token paths. * **Contract Setup Functions**: Functions to initialize contract instances using ABIs and addresses. * **Liquidation Functions**: Functions that perform the liquidation using different methods (direct contract interaction, script-based). ### [](https://docs.bonzo.finance/hub/developer/liquidation-bots-beta/configuring-hardhat#id-2.-update-chain-data) 2\. Update Chain Data Ensure that the `**chainData**` object in the script contains the correct addresses and keys for your environment: Copy const chainData = { operatorId: process.env.ACCOUNT_ID, operatorKey: process.env.PRIVATE_KEY, providerUrl: process.env.PROVIDER_URL, liquidatorContractAddress: process.env.LIQUIDATOR_CONTRACT_ADDRESS, lendingPoolAddress: process.env.LENDING_POOL_ADDRESS, dataProviderAddress: process.env.DATA_PROVIDER_ADDRESS, priceOracleAddress: process.env.PRICE_ORACLE_ADDRESS, // Add any other required addresses and keys }; ### [](https://docs.bonzo.finance/hub/developer/liquidation-bots-beta/configuring-hardhat#id-3.-set-up-environment-variables) 3\. Set Up Environment Variables Ensure your `**.env**` file contains all necessary variables, as shown in the [Prerequisites](https://docs.bonzo.finance/hub/developer/liquidation-bots-beta/environment-setup) section. [PreviousLiquidator Contract](https://docs.bonzo.finance/hub/developer/liquidation-bots-beta/liquidator-contract) [NextPerforming a Liquidation](https://docs.bonzo.finance/hub/developer/liquidation-bots-beta/performing-a-liquidation) Last updated 11 months ago --- # Support | Bonzo Finance Documentation If you have any questions or encounter issues with the Bonzo Finance contracts and/or user interface, please join the official Bonzo Finance Discord at [https://bonzo.finance/discord](https://bonzo.finance/discord) and create a ticket in the **🎫╏create-ticket** channel. The Bonzo Finance team will **never** email or DM you first. Members of our team will **never** ask for your seed phrase, private key, or funds. **Always confirm any interaction you have is with official Bonzo Finance accounts on Discord, 𝕏, or email.** [PreviousContact](https://docs.bonzo.finance/hub/resources/contact) [NextCommunity](https://docs.bonzo.finance/hub/resources/contact/community) Last updated 1 year ago --- # MiCAR Whitepaper | Bonzo Finance Documentation Bonzo Reserve Ltd. has published and notified the MiCAR crypto-asset white paper for $BONZO to its home Member State (MFSA). This crypto-asset marketing communication has not been reviewed or approved by any competent authority in any Member State of the European Union. The person seeking admission to trading is solely responsible for the content of this crypto-asset marketing communication. 583KB [20250926\_Bonzo\_Whitepaper\_ATTR\_V1\_PDF.pdf](https://3581807805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRfK3lCSOewdMJ6MlbF1B%2Fuploads%2FaSvZENqQu8pI21ik62jF%2F20250926_Bonzo_Whitepaper_ATTR_V1_PDF.pdf?alt=media&token=0939944e-77ac-4c33-b1f9-3d552fd4771b) PDF Download[Open](https://3581807805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRfK3lCSOewdMJ6MlbF1B%2Fuploads%2FaSvZENqQu8pI21ik62jF%2F20250926_Bonzo_Whitepaper_ATTR_V1_PDF.pdf?alt=media&token=0939944e-77ac-4c33-b1f9-3d552fd4771b) Bonzo Finance | MiCAR Whitepaper **Contact** [\[email protected\]](https://docs.bonzo.finance/cdn-cgi/l/email-protection) **Scope** Admission to trading only; no public offer. **Key Risks** The crypto-asset may lose value in part or in full, may not always be transferable, and may not be liquid. [PreviousPrivacy Policy](https://docs.bonzo.finance/hub/legal/privacy-policy) Last updated 11 days ago --- # Accounts & Contracts | Bonzo Finance Documentation [](https://docs.bonzo.finance/hub/accounts-and-contracts#usdbonzo-contracts) $BONZO Contracts -------------------------------------------------------------------------------------------------- Allocation Purpose Type Account / Contract ID Owner DAO Treasury Treasury Vesting Contract [0.0.8312259](https://hashscan.io/mainnet/contract/0.0.8312259) Bonzo Foundation Community 1st Edition NFT Claims Distribution Contract [0.0.8317267](https://hashscan.io/mainnet/contract/0.0.8317267) Bonzo Foundation Community Cybernetic NFT Claims Distribution Contract [0.0.5725214](https://hashscan.io/mainnet/contract/0.0.5725214) HeadStarter Community Pre-Season Points Claims Distribution Contract [0.0.8317289](https://hashscan.io/mainnet/contract/0.0.8317289) Bonzo Foundation Community Marketing Programs Vesting Contract [0.0.8305740](https://hashscan.io/mainnet/contract/0.0.8305740) Bonzo Foundation Community Liquidity & Staking Rewards Vesting Contract(s) [0.0.8306863](https://hashscan.io/mainnet/contract/0.0.8306863) [0.0.8306542](https://hashscan.io/mainnet/contract/0.0.8306542) [0.0.8306744](https://hashscan.io/mainnet/contract/0.0.8306744) Bonzo Foundation Investor Various Vesting Contract [0.0.8329267](https://hashscan.io/mainnet/contract/0.0.8329267) Bonzo Reserve Ltd. Core Development Core Development Vesting Contract [0.0.8305606](https://hashscan.io/mainnet/contract/0.0.8305606) Bonzo Foundation [](https://docs.bonzo.finance/hub/accounts-and-contracts#usdbonzo-accounts) $BONZO Accounts ------------------------------------------------------------------------------------------------ Allocation Purpose Type Account / Contract ID Owner Token Issuance Treasury Treasury Token Issuance Account [0.0.8279084](https://hashscan.io/mainnet/account/0.0.8279084) Bonzo Reserve Ltd. Foundation Treasury Treasury Holding Account [0.0.8302193](https://hashscan.io/mainnet/account/0.0.8302193) Bonzo Foundation DAO Treasury Treasury Operational Account [0.0.8326196](https://hashscan.io/mainnet/account/0.0.8326196) Bonzo Foundation Community 1st Edition NFT & Points Season(s) Distribution Account [0.0.8274461](https://hashscan.io/mainnet/account/0.0.8274461) Bonzo Foundation Community Cybernetic NFT Distribution Account [0.0.5725188](https://hashscan.io/mainnet/account/0.0.8274461) HeadStarter Community Marketing Programs Operational Account [0.0.7285744](https://hashscan.io/mainnet/account/0.0.7285744) Bonzo Foundation Community Liquidity & Staking Rewards Operational Account(s) [0.0.8326242](https://hashscan.io/mainnet/account/0.0.8326242?ph=1&ps=1&pt=1&pn=1&pc=1&pr=1&pa=1&pf=1) [0.0.8326207](https://hashscan.io/mainnet/account/0.0.8326207) [0.0.8326258](https://hashscan.io/mainnet/account/0.0.8326258) Bonzo Foundation [PreviousCommunity](https://docs.bonzo.finance/hub/resources/contact/community) [NextTerms of Service](https://docs.bonzo.finance/hub/legal/terms-of-service) Last updated 8 months ago --- # Bonzo v1 Data API | Bonzo Finance Documentation Welcome to the Bonzo Data API Service documentation. This guide provides comprehensive information about the API endpoints, data structures, and usage examples to help you integrate with the Bonzo Liquidity Pools. Whether you're building custom liquidation services or integrating market statistics into your application, this documentation will assist you every step of the way. [](https://docs.bonzo.finance/hub/developer/bonzo-v1-data-api#introduction) Introduction --------------------------------------------------------------------------------------------- ### [](https://docs.bonzo.finance/hub/developer/bonzo-v1-data-api#overview) Overview The **Bonzo Data API Service** provides current lending pool market statistics and individual account supply and borrow information for the [Bonzo.Finance](https://bonzo.finance/) protocol. The service is publicly accessible and can be queried by third parties wishing to interact with the Bonzo Liquidity Pools, such as custom liquidation services or analytical tools. ### [](https://docs.bonzo.finance/hub/developer/bonzo-v1-data-api#key-features) Key Features * **Real-Time Market Data**: Access up-to-date information on supply and borrow pools for supported Hedera tokens. * **Account Insights**: Retrieve detailed account information, including balances and solvency computations. * **Public Endpoints**: Open API for developers to build custom solutions and integrations. * **OpenAPI Specification**: Comprehensive API definitions for easy integration. [](https://docs.bonzo.finance/hub/developer/bonzo-v1-data-api#base-url) Base URL ------------------------------------------------------------------------------------- With the introduction of EVM ERC-20 assets on "Bonzo Lend" (e.g. $wETH LayerZero) — please utilize this temporary URL for live data, in place of the URL found below: [https://mainnet-data-staging.bonzo.finance/](https://mainnet-data-staging.bonzo.finance/) — notices will be provided via [𝕏](https://x.com/bonzo_finance) and [Discord](https://bonzo.finance/discord) for when the URL below will become active again, after this period of temporary monitoring. Thank you. All API requests are made to the following base URL: Copy https://data.bonzo.finance/ [](https://docs.bonzo.finance/hub/developer/bonzo-v1-data-api#common-response-structure) Common Response Structure ----------------------------------------------------------------------------------------------------------------------- ### [](https://docs.bonzo.finance/hub/developer/bonzo-v1-data-api#balance-information-object) Balance Information Object All token balances are returned in a standardized format: Copy { "tiny_token": "0x1234...", // Hex string of smallest denomination "token_display": "100.50", // Human-readable token amount "hbar_tinybar": "0x5678...", // Hex string of HBAR equivalent in tinybars "hbar_display": "50.25", // Human-readable HBAR equivalent "usd_wad": "0x90ab...", // Hex string of USD value in WAD "usd_display": "75.30" // Human-readable USD value } [](https://docs.bonzo.finance/hub/developer/bonzo-v1-data-api#endpoints) Endpoints --------------------------------------------------------------------------------------- ### [](https://docs.bonzo.finance/hub/developer/bonzo-v1-data-api#id-1.-account-dashboard) 1\. Account Dashboard Get detailed information about an account's lending and borrowing positions. Copy GET /dashboard/{accountId} #### [](https://docs.bonzo.finance/hub/developer/bonzo-v1-data-api#parameters) Parameters Name Type Description `accountId` string Hedera account ID in format `shard.realm.num` #### [](https://docs.bonzo.finance/hub/developer/bonzo-v1-data-api#response) Response Copy { "chain_id": string, //The EIP155 identifier of the hedera network used to create Ethereum transactions. "network_name": string, //The name identifier of the hedera network compatible with forNetwork and other native SDK toolkits. "hts_address": string, //The native hedera address for the account in question "evm_address": string, //The 20-byte EVM address for the account as seen by the network’s mirror node, this is the form of account address that must be used when interacting with Bonzo contracts. "reserves": [ //A list of reserve currencies and their statistics related to the account in question:\ "average_supply_apy": number, //The average return from supply of all holdings in the pool.\ "average_borrow_apy": number, //The average interest rate from all borrowed tokens from the pool.\ "average_net_apy": number //The average net APY on supplied assets minus the interest rate from borrowed tokens.\ {\ "id": number, //The ID of the reserve currency (typically the index of the currency in the pool’s internal list of reserve currencies.)\ "name": string, //Name of the reserve currency.\ "symbol": string, // The symbol for the reserve currency.\ "coingecko_id": string, //The CoinGecko ID associated with reserve token. Useful to 3rd party external wishing to lookup reserve prices without having to call the Supra Oracle.\ "hts_address": string, //The Native Hedera HTS address of the currency.\ "evm_address": string, //The EVM 20byte address for the currency.\ "atoken_address": string, //The EVM ERC20 address for the corresponding aToken for the reserve currency.\ "stable_debt_address": string, //The EVM ERC20 address for the corresponding stable debt for the reserve currency.\ "variable_debt_address": string, //The EVM ERC20 address for the corresponding variable debt for the reserve currency.\ "protocol_treasury_address": string, //The address of the treasury that receives the protocol's interest reserve payments.\ "decimals": number, //The native number of decimals of the currency.\ "ltv": number, //Loan-to-Value (LTV) of the reserve currency.\ "liquidation_threshold": number, //The liquidation Threshold for the reserve currency.\ "liquidation_bonus": number, //The liquidation bonus of the reserve currency.\ "active": boolean, //The active state of the reserve currency.\ "frozen": boolean, //The frozen state of the reserve currency.\ "variable_borrowing_enabled": boolean, //The variable borrowing state of the reserve currency.\ "stable_borrowing_enabled": boolean, //The stable rate borrowing state of the reserve currency.\ "reserve_factor": number, //The reserve factor.\ "token_balance": BalanceInfo, //The current balance information for the account’s holdings of the reserve token.\ "atoken_balance": BalanceInfo, //The amount of token this account supplied to the liquidity pool contract.\ "stable_debt_balance": BalanceInfo, //The amount of stable rate debt this account has accumulated.\ "variable_debt_balance": BalanceInfo, //The amount of variable rate debt this account has accumulated.\ "available_liquidity": BalanceInfo, //The total system wide liquidity available for this token.\ "total_stable_debt": BalanceInfo, //The total system wide stable debt for this token.\ "total_variable_debt": BalanceInfo, //The total system wide variable debt for this token.\ "total_supply": BalanceInfo, //The sum total of all supplied value of this token across all accounts.\ "borrow_cap": BalanceInfo, //The total system wide borrow limit for this token.\ "supply_cap": BalanceInfo, //The total system wide supply limit for this token.\ "utilization_rate": number, //The total system utilization of supplied token as a percentage.\ "supply_apy": number, //The current supply APY yield in percent.\ "variable_borrow_apy": number, //The current variable borrow APY cost in percent.\ "stable_borrow_apy": number, //The current stable borrow APY cost in percent.\ "use_as_collateral_enabled": boolean, //If true, the supplied balance of this token can be used by account as Collateral for borrowing purposes.\ "price_weibars": string, //The current market price in weibars (hex encoded binary integer)\ "price_usd_wad": string, //The equivalent USD price value in WAD (hex encoded binary integer)\ "price_usd_display": string //The equivalent USD price value for display purposes (string lossy representation).\ }\ ], "user_credit": { //Additional credit information attributed to the account in question. "hbar_balance": BalanceInfo, //The current account’s native crypto balance. "total_supply": BalanceInfo, //The total amount of value this account has supplied across reserve currencies, normalized to value in hbar. "total_collateral": BalanceInfo, //The sum total amount of supply that is enabled as collateral, normalized in hbar. "total_debt": BalanceInfo, //The sum total amount of account debt, normalized in hbar. "credit_limit": BalanceInfo, //The remaining value that this account may borrow, normalized in hbar. "liquidation_ltv": number, //Loan to Value threshold at which the borrower can be liquidated. "current_ltv": number, //The average loan to value position of this account. "max_ltv": number, //Loan-to-Value (LTV) allowed. "health_factor": number, //Acocunt’s health factor. }, "timestamp": string //The consensus timestamp this information was generated. } #### [](https://docs.bonzo.finance/hub/developer/bonzo-v1-data-api#example-request) Example Request Copy curl https://data.bonzo.finance/dashboard/0.0.1234 ### [](https://docs.bonzo.finance/hub/developer/bonzo-v1-data-api#id-2.-list-of-debtors) 2\. List of Debtors Get a list of all accounts with outstanding debt. Copy GET /debtors #### [](https://docs.bonzo.finance/hub/developer/bonzo-v1-data-api#response-1) Response Copy { "chain_id": string, //The EIP155 identifier of the hedera network used to create Ethereum transactions. "network_name": string, //The name identifier of the hedera network compatible with forNetwork and other native SDK toolkits. "debtors": string[], // Array of EVM addresses "timestamp": string //The consensus timestamp this information was generated. } #### [](https://docs.bonzo.finance/hub/developer/bonzo-v1-data-api#example-request-1) Example Request Copy curl https://data.bonzo.finance/debtors ### [](https://docs.bonzo.finance/hub/developer/bonzo-v1-data-api#id-3.-market-information) 3\. Market Information Get current global state of all Bonzo liquidity pools. Copy GET /market #### [](https://docs.bonzo.finance/hub/developer/bonzo-v1-data-api#response-2) Response Copy { "chain_id": string, //The EIP155 identifier of the hedera network used to create Ethereum transactions. "network_name": string, //The name identifier of the hedera network compatible with forNetwork and other native SDK toolkits. "reserves": [ //A list of reserve currencies and their global statistics:\ {\ "id": number, //The ID of the reserve currency (typically the index of the currency in the pool’s internal list of reserve currencies.)\ "name": string, //Name of the reserve currency.\ "symbol": string, //The symbol for the reserve currency.\ "coingecko_id": string, //The CoinGecko ID associated with reserve token. Useful to 3rd party external wishing to lookup reserve prices without having to call the Supra Oracle.\ "hts_address": string, //The Native Hedera HTS address of the currency.\ "evm_address": string, //The EVM 20byte address for the currency/\ // ... same as reserves object in dashboard endpoint\ }\ ], "timestamp": string //The consensus timestamp this information was generated. } ### [](https://docs.bonzo.finance/hub/developer/bonzo-v1-data-api#id-4.-pool-statistics) 4\. Pool Statistics Get 24-hour usage statistics for the protocol. Copy GET /stats #### [](https://docs.bonzo.finance/hub/developer/bonzo-v1-data-api#response-3) Response Copy { "chain_id": string, //The EIP155 identifier of the hedera network used to create Ethereum transactions. "network_name": string, //The name identifier of the hedera network compatible with forNetwork and other native SDK toolkit "total_supply_value": BalanceInfo, //The total amount of reserves supplied to the entire system, normalized in hBar value. "total_borrowed_value": BalanceInfo, //The total amount of reserves borrowed from the entire system, normalized in hBar value. "total_liquidity_value": BalanceInfo, //The total amount of supplied reserves minus borrowed, normalized in hBar value. "total_deposits_count": number, //Total number of deposits that occurred in the past 24-hour period. "total_withdraws_count": number, //Total number of withdrawals that occurred in the past 24-hour period. "total_borrows_count": number, //Total number of borrowings that occurred in the past 24-hour period. "total_repays_count": number, //Total number of repayments that occurred in the past 24-hour period. "total_enable_collateral_count": number, //Total number of times an account approved a deposit can be used as collateral in the past 24-hour period. "total_disable_collateral_count": number, //Total number of times an account removed a deposit as collateral in the past 24-hour period. "total_flash_loan_count": number, //Total count of flash loans executed in the past 24-hour period. "total_flash_loan_fees": BalanceInfo, //Total value of flash loan fees paid to the protocol in the past 24-hour period. "total_liquidations_count": number, //Total count of loan liquidations in the past 24-hour period. "total_liquidation_payoffs": BalanceInfo, //Total value of loans paid off via liquidations in the past 24-hour period. "total_liquidation_rewards": BalanceInfo, //Total value of collateral rewarded to liquidators in the past 24-hour period. "total_liquidation_bonuses": BalanceInfo, //Total value of the portion of collateral rewarded to liquidators that is considered the bonus value (value in excess of payoff value) in the past 24-hour period. "total_protocol_fees": BalanceInfo, //Total value of fees collected by the protocol in the past 24-hour period. "total_intrest_earned": BalanceInfo, //Total value of interest earned by liquidity suppliers in the past 24-hour period. "total_gas_consumed": number, //Total value of gas consumed by the Hedera EVM all protocol activity in the past 24-hour period. "total_gas_charged": number, //Total value of gas charged by the Hedera Network to execute the protocol activities in the past 24-hour period, this value may exceed the total gas consumed due to the nature of how hedera manages EVM gas authorizations. "total_network_fees": number, //Total native hedera fees beyond gas fees charged to execute protocol activities in the past 24-hour period. "total_successful_transactions": number, //Count of all successful transactions submitted to the protocol in the past 24-hour period. "total_failed_transactions": number, //Count of transactions submitted to the protocol that failed to execute in the past 24-hour period. "active_users": string[], //A array list of accounts (EVM 20byte addresses) that have interacted with the protocol in the past 24-hour period. "reserves": [...], // Same as market endpoint "timestamp_start": string, //The consensus timestamp at the beginning of this 24-hour period. "timestamp_end": string //The consensus timestamp at the end of this 24-hour period. } ### [](https://docs.bonzo.finance/hub/developer/bonzo-v1-data-api#id-5.-protocol-information) 5\. Protocol Information Get server and protocol configuration information. Copy GET /info #### [](https://docs.bonzo.finance/hub/developer/bonzo-v1-data-api#response-4) Response Copy { "chain_id": string, //The EIP155 identifier of the hedera network used to create Ethereum transactions. "network_name": string, //The name identifier of the hedera network compatible with forNetwork and other native SDK toolkits. "mirror_node": string, //The upstream mirror node this system relies upon to retrieve information from the hedera network. "lending_pool_address": string, //Address of the lending pool contract, the providing the lending and borrowing interfaces. "price_oracle_address": string, //Address of the price oracle contract, the contract the protocol relies upon for current market prices. "protocol_data_provider_address": string, //Address of the protocol data provider contract, this is the root contract upon which all other information regarding the protocol, pools, reserves and oracles can be obtained. "lending_pool_configurator_address": string, //The configuration module for the protocol. Monitoring events from this contract can alert applications of changes in the protocol configuration. "whbar_hts_address": string, //The Native Hedera HTS address of the token wrapping native hbar crypto. "whbar_evm_address": string, //The EVM 20byte address for the address of the token wrapping native hbar crypto. "reserves": [...] // Basic reserve configuration info } ### [](https://docs.bonzo.finance/hub/developer/bonzo-v1-data-api#id-6.-bonzo-token-information) 6\. BONZO Token Information Get circulation information for the BONZO token. Copy GET /bonzo ### [](https://docs.bonzo.finance/hub/developer/bonzo-v1-data-api#response-5) Response Copy { "chain_id": string, //The EIP155 identifier of the hedera network used to create Ethereum transactions. "network_name": string, //The name identifier of the hedera network compatible with forNetwork and other native SDK toolkits. "token_id": string, //The native hedera address for the BONZO token. "symbol": string, //The string symbol representing the token. "name": string, //The name of the token. "memo": string, //The memo record associated with the token. "total_supply": string, //The total minted supply of the token, in smallest denomination. "circulating_supply": string, //The circulating supply of the token, in smallest denomination. "decimals": number, //The number of decimals associated with the token. "treasuries": [ //A list of Hedera accounts that make up the various identified treasuries of $BONZO; the balances held by these accounts do not count towards circulating supply.\ {\ "address": string, //The native Hedera address of the treasury account.\ "name": string, //The name of the treasury.\ "balance": string //The balance of token held by the treasury, in smallest denomination.\ }\ ], "timestamp": string //The consensus timestamp this information was generated. } ### [](https://docs.bonzo.finance/hub/developer/bonzo-v1-data-api#id-7.-bonzo-circulation-supply) 7\. BONZO Circulation Supply Get current circulating supply of BONZO token in decimal notation. Copy GET /bonzo/circulation #### [](https://docs.bonzo.finance/hub/developer/bonzo-v1-data-api#response-6) Response Plain text number representing circulating supply. [](https://docs.bonzo.finance/hub/developer/bonzo-v1-data-api#error-handling) Error Handling ------------------------------------------------------------------------------------------------- The API uses standard HTTP status codes: * 200: Success * 404: Resource not found * 503: Service unavailable (upstream mirror node error) Error responses include a text explanation of the issue. [](https://docs.bonzo.finance/hub/developer/bonzo-v1-data-api#rate-limiting) Rate Limiting ----------------------------------------------------------------------------------------------- * Current rate limits: None * Please implement reasonable request throttling in your applications [](https://docs.bonzo.finance/hub/developer/bonzo-v1-data-api#best-practices) Best Practices ------------------------------------------------------------------------------------------------- 1. Cache responses when appropriate to minimize API calls 2. Use the dashboard endpoint instead of market when you have an account ID 3. Implement exponential backoff for retries 4. Monitor the health factor of positions if building liquidation bots [](https://docs.bonzo.finance/hub/developer/bonzo-v1-data-api#example-implementation) Example Implementation ----------------------------------------------------------------------------------------------------------------- Here's a simple JavaScript example to fetch market data: Copy async function getBonzoMarketData() { try { const response = await fetch('https://data.bonzo.finance/market'); if (!response.ok) { throw new Error(`HTTP error! status: ${response.status}`); } const data = await response.json(); // Process reserves data data.reserves.forEach(reserve => { console.log(`${reserve.symbol}: ${reserve.utilization_rate}% utilization`); console.log(`Supply APY: ${reserve.supply_apy}%`); console.log(`Borrow APY: ${reserve.variable_borrow_apy}%`); }); } catch (error) { console.error('Error fetching market data:', error); } } [](https://docs.bonzo.finance/hub/developer/bonzo-v1-data-api#support) Support ----------------------------------------------------------------------------------- * Discord: [Join Bonzo Finance Discord](https://www.bonzo.finance/Discord/) [PreviousCommunity](https://docs.bonzo.finance/hub/contributors/community) [NextProtocol Contracts](https://docs.bonzo.finance/hub/developer/protocol-contracts) Last updated 9 days ago --- # Privacy Policy | Bonzo Finance Documentation ⏰ **Last updated: April 23rd, 2024** This Privacy Policy describes how Bonzo Finance Labs FZC (referred to herein as "Bonzo Finance Labs", "we", "our", or "us"), collects, uses, shares, and stores personal information of users of its website: [https://bonzo.finance](https://bonzo.finance/) (the "Site"). This Privacy Policy applies to the Site and other domain names offering or linking to the Site offered by Bonzo Finance Labs, use of the Site and any and all services offered by Bonzo Finance Labs are collectively called the "Service." All capitalized terms have their definition in Bonzo Finance Labs’ [Terms of Service](https://bonzo.finance/terms-of-service) , unless otherwise noted here. IF YOU DO NOT AGREE WITH ANY PART OF THIS PRIVACY POLICY DO NOT USE THE SERVICE. BY CLICKING "I ACCEPT", BELOW, AND/OR BY ACCESSING THE SERVICE, YOU AGREE THAT YOU HAVE READ, UNDERSTAND, AND SHALL BE BOUND BY THIS PRIVACY POLICY IN ITS ENTIRETY. If you are accessing and using the Service on behalf of a company (such as your employer) or other legal entity, you represent and warrant that you have the authority to bind that entity to this Agreement. In that case, "you" and "your" will refer to YOU AND that entity. You must be at least eighteen (18) years old and can enter into a binding contract with Bonzo Finance Labs and are not otherwise prohibited from using the Service under any applicable law. UNDER THE REQUIREMENTS OF THE CHILDREN'S ONLINE PRIVACY PROTECTION ACT (COPPA), IF WE RECEIVE INFORMATION DIRECTLY FROM A CHILD UNDER AGE THIRTEEN (13) WE WILL USE THAT INFORMATION ONLY TO RESPOND DIRECTLY TO THAT CHILD (OR THEIR PARENT OR LEGAL GUARDIAN) TO INFORM THE CHILD THAT THEY CANNOT USE THE SERVICE. WE WILL THEN DELETE ALL INFORMATION PROVIDED BY THE CHILD. This Privacy Policy does not apply to information collected through Third party Websites or services that you may access through the Service or information that you submit to us through email, text message, other electronic messages or offline. ### [](https://docs.bonzo.finance/hub/legal/privacy-policy#id-1.-modifications) 1\. Modifications We reserve the right, in our sole discretion, to modify this Privacy Policy from time to time. If we make any modifications, we will notify you by updating the date at the top of the Privacy Policy. All modifications will be effective when they are posted, and your continued use of the Service will serve as confirmation of your acceptance of those modifications. If you do not agree with any modifications to this Privacy Policy, you must immediately stop accessing and using the Service. ### [](https://docs.bonzo.finance/hub/legal/privacy-policy#id-2.-contact-information) 2\. Contact Information Should you have questions about this Privacy Policy, you may contact us at: [\[email protected\]](https://docs.bonzo.finance/cdn-cgi/l/email-protection#1d7e7273697c7e695d7f72736772337b74737c737e78) . ### [](https://docs.bonzo.finance/hub/legal/privacy-policy#id-3.-what-we-collect) 3\. What We Collect **A. Personal information that we may collect from you (known altogether, as "Personal Information"):** * Email address, your name, phone number, mailing address, and any other personal information you provide to us when you communicate with us. Such personal information is used only for communication with you; * IP address, MAC address, cookie identifiers, domain server; * Transaction information and network information regarding transactions on the Hedera network; * Usage information, such as information about how you use the Service and interact with us and any data related to usage, performance, site security, traffic patterns, location information, browser and device information; * Surveys. If you decide to participate in a survey, you may be asked to provide certain information which may include personal information; * Social Media Content. We may offer forums, blogs, or social media pages. Any content you provide on these avenues will be considered public and is NOT subject to ANY privacy protections; and * Registration for Sweepstakes, Contests, and Promotions: Contact information you provide may be used to reach you about the sweepstakes, contest, and/or promotion and for other promotional, marketing, and business uses where permitted by law. In your jurisdiction we may be required to publicly share the information of winners. **B. Collected Automatically or by Others:** We may collect certain information automatically or from others when you use the Service. We use this information to carry out the Service and we analyze (and may engage third parties to analyze) this information to improve and enhance the Service. This information may include: * Internet protocol (IP) address, user settings, MAC address, cookie identifiers; * Details about your browser, operating system or device; * Location information; * Internet service provider, pages that you visit before, during and after using the Service, information about the links you click; * Data regarding your use of the Service, including, but not limited to, the types of content you interact with and the frequency and duration of your activities, the pages or features of our Site to which a user browsed and the time spent on those pages or features, the frequency with which the Site is used by a user, search terms, the links on our Site that a user clicked on or used, and other statistics; * Information about you from a third-party login service, social networking site, and information about you that you have made publicly available via your privacy settings. Information collected through these services may include your name, user name, location, gender, birth date, email, profile picture, and any contacts stored in that service; * Registration for Sweepstakes, Contests, and Promotions: Contact information you provide may be used to reach you about the sweepstakes, contest, and/or promotion and for other promotional, marketing, and business uses where permitted by law. In your jurisdiction we may be required to publicly share the information of winners. **C. Cookies, Pixel Tags, Analytics Information, and Interest-Based Advertising Technologies** We, as well as third parties that provide content, advertising, or other functionality on the Service, may use cookies, pixel tags, local storage, and other technologies (the "Technologies") to automatically collect information through the Service. Technologies are small data files placed on your computer, tablet, mobile phone, or other device that allow us and third parties to record certain pieces of information whenever you visit or interact with our Service. Cookies are small text files placed in visitors' computer browsers to store their preferences. Most browsers allow you to block and delete cookies. However, if you do that, the Service may not work properly. A pixel tag is a piece of code embedded in the Service that collects information about users' engagement on the Site. **D. Third-Party Tools** Third Party tools may be used to monitor and analyze the use of the Service: * Google Analytics. You can find more information about Google Analytics' use of your personal data here: [https://www.google.com/analytics/terms/us.html](https://www.google.com/analytics/terms/us.html) * Amazon Web Services. You can find more information about Amazon Web Services use of your personal data here: [https://aws.amazon.com/privacy](https://aws.amazon.com/privacy) * Vercel. You can find more information about Vercel's use of your personal data here: [https://vercel.com/legal/privacy-policy](https://vercel.com/legal/privacy-policy) * GitHub. You can find more information about GitHub's use of your personal data here: [https://docs.github.com/en/site-policy/privacy-policies/github-privacy-statement](https://docs.github.com/en/site-policy/privacy-policies/github-privacy-statement) * Validation Cloud. You can find more information about Validation Cloud’s use of your personal data here: [https://www.validationcloud.io/privacy](https://www.validationcloud.io/privacy) * Swirlds Labs (HashScan & HashIO). You can find more information about HashScan’s use of your personal data here: [https://swirldslabs.com/privacy-policy/](https://swirldslabs.com/privacy-policy/) * Hedera. You can find more information about Hedera’s use of your personal data here: [https://hedera.com/privacy](https://hedera.com/privacy) * GitBook. You can find more information about GitBook's use of your personal data here: [https://policies.gitbook.com/privacy#how-gitbook-secures-your-information](https://policies.gitbook.com/privacy#how-gitbook-secures-your-information) * HashPack. You can find more information about HashPack's use of your personal data here: [https://www.hashpack.app/privacy](https://www.hashpack.app/privacy) * Blade. You can find more information about Blade's use of your personal data here: [https://www.bladewallet.io/privacy-policy/](https://www.bladewallet.io/privacy-policy/) * MetaMask. You can find more information about MetaMask's use of your personal data here: [https://consensys.net/privacy-policy/](https://consensys.net/privacy-policy/) * Supra Oracles. You can find more information about Supra Oracles' use of your personal data here: [https://www.supraoracles.com/privacy-policy/](https://www.supraoracles.com/privacy-policy/) * Pyth Network. You can find more information about Pyth Network's use of your personal data here: [https://pyth.network/privacy-policy](https://pyth.network/privacy-policy) ### [](https://docs.bonzo.finance/hub/legal/privacy-policy#id-4.-how-we-use-your-personal-information) 4\. How We Use Your Personal Information We may use your Personal Information in several ways, including to: 1. Provide you with the Service and provide access to certain areas, functionalities, and features of the Service as well as provide you with services that you may request and to process and complete transactions. 2. Communicate with you about policy changes, promotions, events, and other news about products and services offered by us. We may also use your Personal Information to respond to any comments and questions you may have concerning the Service, provide customer service, technical notices, updates, security alerts, and furnish you with information concerning transactions. 3. Improve our Service. We may use your Personal Information to operate, maintain, and improve our Services. 4. Provide you with additional content such as customized materials about offers, products, analytics, marketing, and Service that may be of interest to you. 5. De-identified / Aggregated Information. We may use Personal Information and other data about you to generate de-identified / aggregated information. These may include, but not be limited to demographic information, location information, device information, or other analysis we may create. 6. Automatic Collection Technologies. We may use Technologies to automatically collect information through the Service. This includes: * Technologies that allow you to access the Service; * Technologies that are required to identify irregular site behavior and improve security; * Technologies that track your use of the Service to improve user experience and functionality of the Service; and * Technologies that allow for the delivery of relevant marketing content to you depending on your use of the Service. G. Fraud prevention and Safety. * Verifying your identity and preventing fraud; * Preventing against illegal activity; * Debugging to identify and repair errors that impair existing intended functionality; * Enforcing our terms and policies; and * Following our legal obligations and the law such as complying with law enforcement, national security requests, and legal process (such as a court order or subpoena). ### [](https://docs.bonzo.finance/hub/legal/privacy-policy#id-5.-sharing-of-personal-information) 5\. Sharing of Personal Information We may disclose Personal Information to third parties in the following cases: * Merger, Sale, or other Asset Transfer. A merger, acquisition, financing due diligence, reorganization, bankruptcy, receivership, purchase or sale of assets, or transition of Service to another provider, may cause your information to be sold or transferred as part of such a transaction, as permitted by law and/or contract. * Location. You acknowledge that all information processed by us may be transferred, processed, and stored anywhere in the world, including but not limited to, the United States or other countries, which may have data protection laws that are different from the laws where you live. We endeavor to safeguard your information consistent with the requirements of applicable laws. If we transfer personal information to countries outside the European Economic Area, we will put in place appropriate safeguards to ensure that this transfer complies with the applicable laws and regulations. * Complying with Legal Obligations. We may share your Personal Information to comply with legal obligations and law enforcement as well as for national security requests, and legal process (such as a court order or subpoena). * Referrals. Our Service may also allow you to refer friends through our referral services. These referral services may allow you to share and forward content, information, and Personal Information, with a friend. * Third-party Websites. The Service may link to other websites or other services. We do not control, endorse, nor are we responsible for the privacy practices or content of such Third-party Websites. Your use of Third-party Websites is at your own risk. ### [](https://docs.bonzo.finance/hub/legal/privacy-policy#id-6.-your-rights) 6\. Your Rights Where you have consented to the processing of your Personal Information and you may withdraw that consent at any time and prevent further processing by contacting us as described above in the "Contact Information" section. Even if you opt out, we may still collect and use non-personal information regarding your activities on our Service and for other legal purposes as described above. Furthermore, you have the right to: 1) Confirm whether we are processing your Personal Information; 2) Obtain access to or receive a copy of your Personal Information that you have provided to us in a commonly used format; 3) Request correction of your Personal Information where it is inaccurate or incomplete; and/or 4) Request deletion of your Personal Information, subject to certain exceptions prescribed by law. 1. **Technologies.** Technologies (including cookies) may be disabled or removed by tools available as part of most browsers. Generally, you must separately opt out, disable, or remove technologies on EACH browser and device. 2. **Google Analytics.** You may exercise choices regarding the use of cookies from Google Analytics by going to: [https://tools.google.com/dlpage/gaoptout](https://tools.google.com/dlpage/gaoptout) and downloading the Google Analytics Opt-out Browser Add-on. ### [](https://docs.bonzo.finance/hub/legal/privacy-policy#id-7.-data-retention) 7\. Data Retention Your Personal Information is retained as long as necessary and relevant to fulfill obligations in this Privacy Policy or under the Terms of Service. To determine the appropriate retention period for Personal Information, we consider the amount, nature, and sensitivity of the Personal Information, the potential risk of harm from unauthorized use or disclosure of your Personal Information, the purposes for which we process your Personal Information, and applicable legal requirements. We retain Personal Information to: * Comply with applicable law; * Prevent fraud; * Resolve disputes; * Troubleshoot problems; * Assist law enforcement; * Enforce our Terms of Service; * Provide our Service; * Establish legal defenses; and * Any other actions permitted by law. ### [](https://docs.bonzo.finance/hub/legal/privacy-policy#id-8.-how-information-is-secured) 8\. How Information is Secured We take steps to employ industry standard security measures designed to protect the security of all information (including Personal Information) submitted through the Service. NO SYSTEM IS COMPLETELY SECURE. SECURITY OF INFORMATION TRANSMITTED THROUGH THE INTERNET CAN NEVER BE GUARANTEED AND WE DO NOT REPRESENT, ENSURE, OR WARRANT SUCH. WE ARE NOT RESPONSIBLE FOR THE INTERRUPTION OR INTERCEPTION OF ANY COMMUNICATIONS THROUGH THE INTERNET, CHANGES TO DATA, OR LOSS OF DATA. WE DO NOT ACCEPT LIABILITY FOR UNINTENTIONAL DISCLOSURE. ### [](https://docs.bonzo.finance/hub/legal/privacy-policy#id-9.-european-union-subjects) 9\. European Union Subjects This section provides additional details about the Personal Information we collect about European Union subjects and the rights afforded to them under the European Union General Data Protection Regulation (GDPR). Personal Information as used in this Privacy Policy is equivalent to "personal data" as defined in the GDPR. We are required to inform you of the legal bases of our processing of your Personal Information which can be found in the "How We Use Your Personal Information" section, above. Should you have other questions regarding the legal basis for that use, please contact us per the "Contact Information" section, above. Per the GDPR, you have rights regarding your Personal Information. In regards to your Personal Information, you may request to: 1. Opt-out of marketing communications which you have previously consented to receive (but we may continue to send Service related and other non-marketing communications to you); 2. 2\. Give you access to your Personal Information; 3. 3\. Update, delete, restrict, and/or correct inaccuracies in your Personal Information; 4. 4\. Transfer a machine-readable copy of your Personal Information to you or your authorized agent; and 5. 5\. Object to our reliance on our legitimate business interests as the basis for processing your Personal Information that impacts your rights. To exercise any of these rights you may contact us per the "Contact Information" section, above. Applicable law may require us to decline your request. Should we decline your request and subject to legal restrictions, we will tell you the basis for declining your request. ### [](https://docs.bonzo.finance/hub/legal/privacy-policy#id-10.-california-residents) 10\. California Residents This section provides additional details about the Personal Information we collect about California consumers and the rights afforded to them under the California Consumer Privacy Act ("CCPA"). According to California Civil Code Section 1789.3, California users of the Service may reach the Complaint Assistance Unit of the Division of Consumer Services of the California Department of Consumer Affairs by mail at 1625 North Market Blvd., Sacramento, CA 95834, or by telephone at (800) 952-5210. See the "What We Collect" section above for details about the Personal Information we collect from you. Personal Information is collected for the business and commercial purposes described in the "How We Use Your Personal Information" section above. Personal Information may be shared with third parties described in the "Sharing of Personal Information" section above. We do not sell (as such term is defined in the CCPA) Personal Information. Please refer to the "Cookies, Pixel Tags, Analytics Information, and Interest-Based Advertising technologies" sub-section, above, for information regarding the types of third-party cookies and Technologies, if any, that we use. The CCPA provides California consumers the right to request to know more details about the categories or specific pieces of Personal Information we collect (including how we use and disclose this Personal Information), to delete their Personal Information, and allows you to not be discriminated against for exercising these rights. California consumers may make a request pursuant to their rights under the CCPA by contacting us per the "Contact Information" section, above. You will need to verify your identity and the reason for your inquiry before any further action is taken. As such, valid government identification may be required. You may, and in order to, designate an authorized agent to make a request on your behalf, must provide a valid power of attorney, the requester's valid government issued identification, and the authorized agent's valid government issued identification. [PreviousTerms of Service](https://docs.bonzo.finance/hub/legal/terms-of-service) [NextMiCAR Whitepaper](https://docs.bonzo.finance/hub/legal/micar-whitepaper) Last updated 1 year ago --- # Terms of Service | Bonzo Finance Documentation ⏰ **Last Updated: April 23rd, 2024** These Terms of Service (the "Agreement") explain the terms and conditions by which you may access and use the Services provided by Bonzo Finance Labs FZC (referred to herein as "Bonzo Finance Labs", "we", "our", or "us"). The Services include, but are not necessarily limited to, (a) [https://bonzo.finance](https://bonzo.finance/) , a website-hosted user interface, including a front-end graphical user interface ("GUI") (the "Interface"), and (‎b) other domain names linking to the Interface or offered by us. You must read this Agreement and our Privacy Policy ("Privacy Policy") (located at:[https://bonzo.finance/privacy-policy](https://bonzo.finance/privacy-policy) ), which is incorporated by reference, carefully, as they govern your use of the Services. By accessing or using any of the Services, you signify that you have read, understand, and agree to be bound by this Agreement in its entirety. If you do not agree, you are not authorized to access or use any of our Services and should not use our Services. To access or use any of our Services, you must be able to form a legally binding contract with us. Accordingly, you represent that you are at least the age of majority in your jurisdiction (e.g., 18 years old in the United States) and have the full right, power, and authority to enter into and comply with the terms and conditions of this Agreement on behalf of yourself and any company or legal entity for which you may access or use the Services. If you are entering into this Agreement on behalf of an entity, you represent that you have the legal authority to bind such entity. You further represent that you are not (a) the subject of economic or trade sanctions administered or enforced by any governmental authority or otherwise designated on any list of prohibited or restricted parties (including but not limited to the list maintained by the Office of Foreign Assets Control of the U.S. Department of the Treasury) or (b) a citizen, resident, or organized in a jurisdiction or territory that is the subject of comprehensive country-wide, territory-wide, or regional economic sanctions by the United States. Finally, you represent that your access and use of any of our Services will fully comply with all applicable laws and regulations, and that you will not access or use any of our Services to conduct, promote, or otherwise facilitate any illegal activity. Upon our request, you agree to provide us with certain Personal Information (as defined in the Privacy Policy) for the purposes of identity verification and the detection of money laundering, terrorist financing, fraud, or any other financial crimes and permit us to keep a record of such Personal Information. See the Privacy Policy on how we treat your data. We reserve the right to alter your access and use of the Service as a result of information collected about you on an ongoing basis. The Service is offered to you in Bonzo Finance Labs' sole discretion and we may choose to not offer the Service or discontinue your access to the Service at any time and in our sole discretion without notice to you. NOTICE: This Agreement contains important information, including a binding arbitration provision and a class action waiver, both of which impact your rights as to how disputes are resolved. Our Services are only available to you — and you should only access any of our Services — if you agree completely with these terms. ### [](https://docs.bonzo.finance/hub/legal/terms-of-service#id-1.-our-services) 1\. Our Services **1.1 The Interface and Protocol** The Interface provides a web or mobile-based means of access to a decentralized lending and borrowing protocol built on the Hedera network that allows users to lend, borrow, and earn yields on their crypto assets via the Bonzo Finance Protocol (the "Protocol" or "Bonzo Finance"). You understand and acknowledge that the Protocol is not a Service and the protocol is governed in accordance with the documentation located at [https://docs.bonzo.finance/governance](https://docs.bonzo.finance/governance) ("Governance"). Bonzo Finance Labs does not control or operate any version of the Protocol on any blockchain network and the Protocol is governed in accordance with Governance. By using the Interface, you understand that you are not lending or borrowing assets directly from us and that we do not operate any lending pools on the Protocol or control the execution of lending and borrowing transactions on the Protocol. As a general matter, Bonzo Finance Labs is not a liquidity provider into Protocol lending pools and liquidity providers are independent third parties. To access the Protocol, you must use a non-custodial wallet software, which allows you to interact with public blockchains. Your relationship with that non-custodial wallet provider is governed by the applicable terms of service. We do not have custody or control over the contents of your wallet and have no ability to retrieve or transfer its contents. By connecting your wallet to the Interface, you agree to be bound by this Agreement and all of the terms incorporated herein by reference. **1.2 Other Services** We may from time to time in the future offer additional products, and such additional products shall be considered a Service as used herein, regardless of whether such product is specifically defined in this Agreement. **1.3 Third Party Services and Content** When you use any of our Services, you may also be using the products, services or content of one or more third parties. Your use of such third-party products, services or content may be subject to separate policies, terms of use and fees of these third parties, and you agree to abide by and be responsible for such policies, terms of use and fees, as applicable. ### [](https://docs.bonzo.finance/hub/legal/terms-of-service#id-2.-modification) 2\. Modification **2.1 Modifications of this Agreement** We reserve the right, in our sole discretion, to modify this Agreement from time to time. If we make any material modifications, we will notify you by updating the date at the top of the Agreement and by publishing a current version of the Agreement at [https://docs.bonzo.finance/legal/terms-of-service](https://docs.bonzo.finance/legal/terms-of-service) . All modifications will be effective when they are posted, and your continued accessing or use of any of the Services will serve as confirmation of your acceptance of those modifications. If you do not agree with any modifications to this Agreement, you must immediately stop accessing and using all of our Services. **2.2 Modifications of our Services** We reserve the following rights, which do not constitute obligations of ours: (a) with or without notice to you, to modify, substitute, eliminate or add to any of the Services; (b) to review, modify, filter, disable, delete and remove any and all content and information from any of the Services. ### [](https://docs.bonzo.finance/hub/legal/terms-of-service#id-3.-intellectual-property-rights) 3\. Intellectual Property Rights **3.1 Generally** We own all intellectual property and other rights in the Services and their respective contents, including, but not limited to, software, text, images, trademarks, service marks, copyrights, patents, designs, and their "look and feel." Subject to the terms of this Agreement, we grant you a limited, revocable, non-exclusive, non-sublicensable, non-transferable license to access and use our Services solely in accordance with this Agreement. You agree that you will not use, modify, distribute, tamper with, reverse engineer, disassemble or decompile any of our Services for any purpose other than as expressly permitted pursuant to this Agreement. Except as set forth in this Agreement, we grant you no rights to any of our Services, including any intellectual property rights. The Services may allow you to store and share content including, but not limited to, posts to communicate with others, files, documents, graphics, images, music, software, audio and video (known altogether as the "Post(s)"). Bonzo Finance Labs does not claim any ownership rights to the Posts and nothing in this Agreement restricts any rights that you may have to your Posts. By using any of our Services, you grant us a worldwide, non-exclusive, sublicensable, royalty-free license to use, copy, modify, and display any content, including but not limited to text, materials, images, files, communications, comments, feedback, suggestions, ideas, concepts, questions, data, or otherwise, that you post on or through any of our Services for our current and future business purposes, including to provide, promote, and improve the services. This includes any digital file, art, or other material linked to or associated with any NFTs that are displayed. You grant to us a non-exclusive, transferable, worldwide, perpetual, irrevocable, fully-paid, royalty-free license, with the right to sublicense, under any and all intellectual property rights that you own or control to use, copy, modify, create derivative works based upon any suggestions or feedback for any purpose related to the Services. You represent and warrant that you have, or have obtained, all rights, licenses, consents, permissions, power and/or authority necessary to grant the rights granted herein for any material that you list, post, promote, or display on or through any of our Services (including, but not limited to, NFTs). You represent and warrant that such content does not contain material subject to copyright, trademark, publicity rights, or other intellectual property rights, unless you have necessary permission or are otherwise legally entitled to post the material and to grant us the license described above, and that the content does not violate any laws. We are not responsible in any way for removal or deletion of (or the failure thereof) the Posts, but we reserve the right and are not obligated to remove or disable access to any Posts at any time and without any notice to you. **3.2 Third-Party Resources and Promotions** Our Services may contain references or links to third-party resources, including, but not limited to, information, materials, products, or services, that we do not own or control. In addition, third parties may offer promotions related to your access and use of our Services. We do not approve, monitor, endorse, warrant or assume any responsibility for any such resources or promotions. If you access any such resources or participate in any such promotions, you do so at your own risk, and you understand that this Agreement does not apply to your dealings or relationships with any third parties. You expressly relieve us of any and all liability arising from your use of any such resources or participation in any such promotions. **3.3 Additional Rights** We reserve the right to cooperate with any law enforcement, court or government investigation or order or third party requesting or directing that we disclose information or content or information that you provide. ### [](https://docs.bonzo.finance/hub/legal/terms-of-service#id-4.-your-responsibilities) 4\. Your Responsibilities **4.1 Prohibited Activity** You agree not to engage in, or attempt to engage in, any of the following categories of prohibited activity in relation to your access and use of the Services: * Intellectual Property Infringement. Activity that infringes on or violates any copyright, trademark, service mark, patent, right of publicity, right of privacy, or other proprietary or intellectual property rights under the law. * Cyberattack. Activity that seeks to interfere with or compromise the integrity, security, or proper functioning of any computer, server, network, personal device, or other information technology system, including, but not limited to, the deployment of viruses and denial of service attacks. * Fraud and Misrepresentation. Activity that seeks to defraud us or any other person or entity, including, but not limited to, providing any false, inaccurate, or misleading information in order to unlawfully obtain the property of another. * Market Manipulation. Activity that violates any applicable law, rule, or regulation concerning the integrity of lending and borrowing markets. * Securities and Derivatives Violations. Activity that violates any applicable law, rule, or regulation concerning the lending, borrowing, or trading of securities or derivatives, including, but not limited to, the unregistered offering of securities and the offering of leveraged and margined commodity products to retail customers in the United States. * Sale of Stolen Property. Buying, selling, or transferring of stolen items, fraudulently obtained items, items taken without authorization, and/or any other illegally obtained items. * Data Mining or Scraping. Activity that involves data mining, robots, scraping, or similar data gathering or extraction methods of content or information from any of our Services. * Objectionable Content. Activity that involves soliciting information from anyone under the age of 18 or that is otherwise harmful, threatening, abusive, harassing, tortious, excessively violent, defamatory, vulgar, obscene, pornographic, libelous, invasive of another's privacy, hateful, discriminatory, or otherwise objectionable. * Any Other Unlawful Conduct. Activity that violates any applicable law, rule, or regulation of the United States or another relevant jurisdiction, including, but not limited to, the restrictions and regulatory requirements imposed by U.S. law. **4.2 Lending & Borrowing** You agree and understand that: (a) all lending and borrowing transactions you submit through any of our Services are considered unsolicited, which means that they are solely initiated by you; (b) you have not received any investment advice from us in connection with any lending or borrowing transactions; (c) we do not conduct a suitability review of any lending or borrowing transactions you submit; and (d) when a transaction occurs using your credentials, we will assume that you authorized such transaction. **4.2 Non-Custodial and No Fiduciary Duties** Each of the Services is a purely non-custodial application, meaning we do not ever have custody, possession, or control of your digital assets at any time. It further means you are solely responsible for the custody of the cryptographic private keys to the digital asset wallets you hold and you should never share your wallet credentials or seed phrase with anyone. We accept no responsibility for, or liability to you, in connection with your use of a wallet and make no representations or warranties regarding how any of our Services will operate with any specific wallet. Likewise, you are solely responsible for any associated wallet and we are not liable for any acts or omissions by you in connection with or as a result of your wallet being compromised. This Agreement is not intended to, and does not, create or impose any fiduciary duties on us. To the fullest extent permitted by law, you acknowledge and agree that we owe no fiduciary duties or liabilities to you or any other party, and that to the extent any such duties or liabilities may exist at law or in equity, those duties and liabilities are hereby irrevocably disclaimed, waived, and eliminated. You further agree that the only duties and obligations that we owe you are those set out expressly in this Agreement. **4.4 Compliance and Tax Obligations** One or more of our Services may not be available or appropriate for use in your jurisdiction. By accessing or using any of our Services, you agree that you are solely and entirely responsible for compliance with all laws and regulations that may apply to you. Specifically, your use of our Services or the Protocol may result in various tax consequences, such as income or capital gains tax, value-added tax, goods and services tax, or sales tax in certain jurisdictions. It is your responsibility to determine whether taxes apply to any transactions you initiate or receive and, if so, to report and/or remit the correct tax to the appropriate tax authority. **4.5 Gas Fees** Blockchain transactions require the payment of transaction fees to the appropriate network ("Gas Fees"). You will be solely responsible to pay the Gas Fees for any transaction that you initiate via any of our Services. **4.6 Protocol Fees** The Bonzo Finance Protocol charges various fees associated with the use of its lending and borrowing services. By using our Services, you agree to the payment and reasonableness of these fees, which include: * Reserve Factor Fee: A portion of the interest paid by borrowers is allocated to the protocol's reserves, which serve as a safety buffer for the platform. The Reserve Factor Fee is a percentage of this allocated interest. * Liquidation Fee: When a borrower's collateral is liquidated due to their position falling below the required collateralization ratio, a Liquidation Fee is applied. This fee is a percentage of the liquidated collateral and is paid to the liquidator as an incentive for maintaining the health of the platform. * Stability Fee: The Stability Fee is a variable rate fee charged on borrowers to maintain the stability of the protocol. This fee is adjusted based on market conditions and is used to incentivize or disincentivize borrowing, helping to keep the platform in balance. * Flash Loan Fee: For users who take advantage of Flash Loans, which are uncollateralized loans that must be borrowed and repaid within a single transaction, a Flash Loan Fee is charged. This fee is a percentage of the borrowed amount and is paid to the protocol. By using the Bonzo Finance Protocol, you acknowledge and agree to pay these fees as applicable to your lending and borrowing activities. The specific fee rates are determined by the protocol's governance process and are subject to change. It is your responsibility to stay informed about the current fee structure and to factor these costs into your decision-making when using the platform. **4.7 Release of Claims** You expressly agree that you assume all risks in connection with your access and use of any of our Services or the Protocol. You further expressly waive and release us from any and all liability, claims, causes of action, or damages arising from or in any way relating to your use of any of our Services. If you are a California resident, you waive the benefits and protections of California Civil Code § 1542, which provides: "\[a\] general release does not extend to claims that the creditor or releasing party does not know or suspect to exist in his or her favor at the time of executing the release and that, if known by him or her, would have materially affected his or her settlement with the debtor or released party." ### [](https://docs.bonzo.finance/hub/legal/terms-of-service#id-5.-disclaimers) 5\. DISCLAIMERS **5.1 ASSUMPTION OF RISK** GENERALLY BY ACCESSING AND USING ANY OF OUR SERVICES OR THE PROTOCOL, YOU REPRESENT THAT YOU ARE FINANCIALLY AND TECHNICALLY SOPHISTICATED ENOUGH TO UNDERSTAND THE INHERENT RISKS ASSOCIATED WITH USING CRYPTOGRAPHIC AND BLOCKCHAIN-BASED SYSTEMS, AND THAT YOU HAVE A WORKING KNOWLEDGE OF THE USAGE AND INTRICACIES OF DIGITAL ASSETS SUCH AS HEDERA TOKEN (HBAR), SO-CALLED STABLECOINS, AND OTHER DIGITAL TOKENS SUCH AS THOSE FOLLOWING THE HEDERA TOKEN SERVICE ("HTS") STANDARD. IN PARTICULAR, YOU UNDERSTAND THAT THE MARKETS FOR THESE DIGITAL ASSETS ARE NASCENT AND HIGHLY VOLATILE DUE TO RISK FACTORS INCLUDING, BUT NOT LIMITED TO, ADOPTION, SPECULATION, TECHNOLOGY, SECURITY, AND REGULATION. YOU UNDERSTAND THAT ANYONE CAN CREATE A TOKEN, INCLUDING FAKE VERSIONS OF EXISTING TOKENS AND TOKENS THAT FALSELY CLAIM TO REPRESENT PROJECTS, AND ACKNOWLEDGE AND ACCEPT THE RISK THAT YOU MAY MISTAKENLY BORROW THOSE OR OTHER TOKENS. SO-CALLED STABLECOINS MAY NOT BE AS STABLE AS THEY PURPORT TO BE, MAY NOT BE FULLY OR ADEQUATELY COLLATERALIZED, AND MAY BE SUBJECT TO PANICS AND RUNS. FURTHER, YOU UNDERSTAND THAT SMART CONTRACT TRANSACTIONS AUTOMATICALLY EXECUTE AND SETTLE, AND THAT BLOCKCHAIN-BASED TRANSACTIONS ARE IRREVERSIBLE WHEN CONFIRMED. YOU ACKNOWLEDGE AND ACCEPT THAT THE COST AND SPEED OF TRANSACTING WITH CRYPTOGRAPHIC AND BLOCKCHAIN-BASED SYSTEMS SUCH AS HEDERA ARE VARIABLE AND MAY INCREASE DRAMATICALLY AT ANY TIME. IF YOU ACT AS A LIQUIDITY PROVIDER TO THE PROTOCOL THROUGH THE INTERFACE, YOU UNDERSTAND THAT YOUR DIGITAL ASSETS MAY LOSE SOME OR ALL OF THEIR VALUE WHILE THEY ARE SUPPLIED TO THE PROTOCOL THROUGH THE INTERFACE DUE TO THE FLUCTUATION OF PRICES OF TOKENS IN A LENDING POOL. FINALLY, YOU UNDERSTAND THAT WE DO NOT CREATE, OWN, OR OPERATE CROSS-CHAIN BRIDGES AND WE DO NOT MAKE ANY REPRESENTATION OR WARRANTY ABOUT THE SAFETY OR SOUNDNESS OF ANY CROSS-CHAIN BRIDGE. IN SUMMARY, YOU ACKNOWLEDGE THAT WE ARE NOT RESPONSIBLE FOR ANY OF THESE VARIABLES OR RISKS, DO NOT OWN OR CONTROL THE PROTOCOL, AND CANNOT BE HELD LIABLE FOR ANY RESULTING LOSSES THAT YOU EXPERIENCE WHILE ACCESSING OR USING ANY OF OUR SERVICES OR THE PROTOCOL. ACCORDINGLY, YOU UNDERSTAND AND AGREE TO ASSUME FULL RESPONSIBILITY FOR ALL OF THE RISKS OF ACCESSING AND USING THE INTERFACE TO INTERACT WITH THE PROTOCOL. **5.2 NO WARRANTIES** EACH OF OUR SERVICES ARE PROVIDED ON AN "AS IS" AND "AS AVAILABLE" BASIS. TO THE FULLEST EXTENT PERMITTED BY LAW, WE DISCLAIM ANY REPRESENTATIONS AND WARRANTIES OF ANY KIND, WHETHER EXPRESS, IMPLIED, OR STATUTORY, INCLUDING, BUT NOT LIMITED TO, THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. YOU ACKNOWLEDGE AND AGREE THAT YOUR USE OF EACH OF OUR SERVICES IS AT YOUR OWN RISK. WE DO NOT REPRESENT OR WARRANT THAT ACCESS TO ANY OF OUR SERVICES WILL BE CONTINUOUS, UNINTERRUPTED, TIMELY, OR SECURE; THAT THE INFORMATION CONTAINED IN ANY OF OUR SERVICES WILL BE ACCURATE, RELIABLE, COMPLETE, OR CURRENT; OR THAT ANY OF OUR SERVICES WILL BE FREE FROM ERRORS, DEFECTS, VIRUSES, OR OTHER HARMFUL ELEMENTS. NO ADVICE, INFORMATION, OR STATEMENT THAT WE MAKE SHOULD BE TREATED AS CREATING ANY WARRANTY CONCERNING ANY OF OUR SERVICES. WE DO NOT ENDORSE, GUARANTEE, OR ASSUME RESPONSIBILITY FOR ANY ADVERTISEMENTS, OFFERS, OR STATEMENTS MADE BY THIRD PARTIES CONCERNING ANY OF OUR SERVICES. USER UNDERSTANDS & ACKNOWLEDGES THAT THERE MAY BE BUGS WITH RESPECT TO DISPLAYING THE WRONG TOKEN INFORMATION OR NFT INFORMATION/META-DATA AND IS ADVISED TO CONSULT THE PROTOCOL AND PUBLIC BLOCKCHAIN OF THE RELEVANT NETWORK. WE DO NOT POLICE OR REGULARLY MONITOR THE DATA OR META-DATA THAT IS BEING PROVIDED IN CONNECTION WITH THE PROTOCOL, INTERFACE, OR SERVICES. SIMILARLY, THE PROTOCOL IS PROVIDED "AS IS", AT YOUR OWN RISK, AND WITHOUT WARRANTIES OF ANY KIND. ALTHOUGH WE CONTRIBUTED TO THE INITIAL CODE FOR THE PROTOCOL, WE DO NOT PROVIDE, OWN, OR CONTROL THE PROTOCOL, WHICH IS RUN AUTONOMOUSLY WITHOUT ANY HEADCOUNT BY SMART CONTRACTS DEPLOYED ON VARIOUS BLOCKCHAINS. NO DEVELOPER OR ENTITY INVOLVED IN CREATING THE PROTOCOL WILL BE LIABLE FOR ANY CLAIMS OR DAMAGES WHATSOEVER ASSOCIATED WITH YOUR USE, INABILITY TO USE, OR YOUR INTERACTION WITH OTHER USERS OF, THE PROTOCOL, INCLUDING ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, PUNITIVE OR CONSEQUENTIAL DAMAGES, OR LOSS OF PROFITS, CRYPTOCURRENCIES, TOKENS, OR ANYTHING ELSE OF VALUE. WE DO NOT ENDORSE, GUARANTEE, OR ASSUME RESPONSIBILITY FOR ANY ADVERTISEMENTS, OFFERS, OR STATEMENTS MADE BY THIRD PARTIES CONCERNING ANY OF OUR SERVICES. ANY PAYMENTS OR FINANCIAL TRANSACTIONS THAT YOU ENGAGE IN WILL BE PROCESSED VIA AUTOMATED SMART CONTRACTS. ONCE EXECUTED, WE HAVE NO CONTROL OVER THESE PAYMENTS OR TRANSACTIONS, NOR DO WE HAVE THE ABILITY TO REVERSE ANY PAYMENTS OR TRANSACTIONS. **5.3 NO INVESTMENT ADVICE** ALL INFORMATION PROVIDED BY ANY OF OUR SERVICES IS FOR INFORMATIONAL PURPOSES ONLY AND SHOULD NOT BE CONSTRUED AS INVESTMENT ADVICE OR A RECOMMENDATION THAT A PARTICULAR TOKEN IS A SAFE OR SOUND INVESTMENT. YOU SHOULD NOT TAKE, OR REFRAIN FROM TAKING, ANY ACTION BASED ON ANY INFORMATION CONTAINED IN ANY OF OUR SERVICES. BY PROVIDING TOKEN INFORMATION FOR YOUR CONVENIENCE, WE DO NOT MAKE ANY INVESTMENT RECOMMENDATIONS TO YOU OR OPINE ON THE MERITS OF ANY TRANSACTION OR OPPORTUNITY. YOU ALONE ARE RESPONSIBLE FOR DETERMINING WHETHER ANY INVESTMENT, INVESTMENT STRATEGY OR RELATED TRANSACTION IS APPROPRIATE FOR YOU BASED ON YOUR PERSONAL INVESTMENT OBJECTIVES, FINANCIAL CIRCUMSTANCES, AND RISK TOLERANCE. ### [](https://docs.bonzo.finance/hub/legal/terms-of-service#id-6.-indemnification) 6\. Indemnification You agree to hold harmless, release, defend, and indemnify us and our officers, directors, employees, contractors, agents, affiliates, and subsidiaries from and against all claims, damages, obligations, losses, liabilities, costs, and expenses arising from: (a) your access to and use of any of the Services or the Protocol; (b) your violation of any term or condition of this Agreement, the rights of any third party, or any other applicable law, rule, or regulation; (c) any other party's access to and use of any of the Services or the Protocol with your assistance or using any device or account that you own or control; and (d) any dispute between you and (i) any other user of any of the Services or the Protocol or (ii) any of your own customers or users. ### [](https://docs.bonzo.finance/hub/legal/terms-of-service#id-7.-limitation-of-liability) 7\. Limitation of Liability UNDER NO CIRCUMSTANCES SHALL WE OR ANY OF OUR OFFICERS, DIRECTORS, EMPLOYEES, CONTRACTORS, AGENTS, AFFILIATES, OR SUBSIDIARIES BE LIABLE TO YOU FOR ANY INDIRECT, PUNITIVE, INCIDENTAL, SPECIAL, CONSEQUENTIAL, OR EXEMPLARY DAMAGES, INCLUDING, BUT NOT LIMITED TO, DAMAGES FOR LOSS OF PROFITS, GOODWILL, USE, DATA, OR OTHER INTANGIBLE PROPERTY, ARISING OUT OF OR RELATING TO ANY ACCESS TO OR USE OF, OR INABILITY TO ACCESS OR USE, ANY OF THE SERVICES OR THE PROTOCOL, NOR WILL WE BE RESPONSIBLE FOR ANY DAMAGE, LOSS, OR INJURY RESULTING FROM HACKING, TAMPERING, OR OTHER UNAUTHORIZED ACCESS OR USE OF THE SERVICES OR THE PROTOCOL OR THE INFORMATION CONTAINED WITHIN THEM, WHETHER SUCH DAMAGES ARE BASED IN CONTRACT, TORT, NEGLIGENCE, STRICT LIABILITY, OR OTHERWISE, ARISING OUT OF OR IN CONNECTION WITH AUTHORIZED OR UNAUTHORIZED USE OF THE SERVICES OR THE PROTOCOL, EVEN IF AN AUTHORIZED REPRESENTATIVE OF BONZO FINANCE HAS BEEN ADVISED OF OR KNEW OR SHOULD HAVE KNOWN OF THE POSSIBILITY OF SUCH DAMAGES. WE ASSUME NO LIABILITY OR RESPONSIBILITY FOR ANY: (A) ERRORS, MISTAKES, OR INACCURACIES OF CONTENT; (B) PERSONAL INJURY OR PROPERTY DAMAGE, OF ANY NATURE WHATSOEVER, RESULTING FROM ANY ACCESS TO OR USE OF THE SERVICES OR THE PROTOCOL; (C) UNAUTHORIZED ACCESS TO OR USE OF ANY SECURE SERVER OR DATABASE IN OUR CONTROL, OR THE USE OF ANY INFORMATION OR DATA STORED THEREIN; (D) INTERRUPTION OR CESSATION OF FUNCTION RELATED TO THE SERVICES OR THE PROTOCOL; (E) BUGS, VIRUSES, TROJAN HORSES, OR THE LIKE THAT MAY BE TRANSMITTED TO OR THROUGH THE SERVICES OR THE PROTOCOL; (F) ERRORS OR OMISSIONS IN, OR LOSS OR DAMAGE INCURRED AS A RESULT OF THE USE OF, ANY CONTENT MADE AVAILABLE THROUGH THE SERVICES OR THE PROTOCOL; AND (G) THE DEFAMATORY, OFFENSIVE, OR ILLEGAL CONDUCT OF ANY THIRD PARTY. WE HAVE NO LIABILITY TO YOU OR TO ANY THIRD PARTY FOR ANY CLAIMS OR DAMAGES THAT MAY ARISE AS A RESULT OF ANY PAYMENTS OR TRANSACTIONS THAT YOU ENGAGE IN VIA THE SERVICES OR THE PROTOCOL, OR ANY OTHER PAYMENT OR TRANSACTIONS THAT YOU CONDUCT VIA THE SERVICES OR THE PROTOCOL. EXCEPT AS EXPRESSLY PROVIDED FOR HEREIN, WE DO NOT PROVIDE REFUNDS FOR ANY PURCHASES THAT YOU MIGHT MAKE ON OR THROUGH THE SERVICES OR THE PROTOCOL. WE MAKE NO WARRANTIES OR REPRESENTATIONS, EXPRESS OR IMPLIED, ABOUT LINKED THIRD-PARTY SERVICES, THE THIRD PARTIES THEY ARE OWNED AND OPERATED BY, THE INFORMATION CONTAINED ON THEM, ASSETS AVAILABLE THROUGH THEM, OR THE SUITABILITY, PRIVACY, OR SECURITY OF THEIR PRODUCTS OR SERVICES. YOU ACKNOWLEDGE SOLE RESPONSIBILITY FOR AND ASSUME ALL RISK ARISING FROM YOUR USE OF THIRD-PARTY SERVICES, THIRD-PARTY WEBSITES, APPLICATIONS, OR RESOURCES. WE SHALL NOT BE LIABLE UNDER ANY CIRCUMSTANCES FOR DAMAGES ARISING OUT OF OR IN ANY WAY RELATED TO SOFTWARE, PRODUCTS, SERVICES, AND/OR INFORMATION OFFERED OR PROVIDED BY THIRD-PARTIES AND ACCESSED THROUGH THE SERVICES OR THE PROTOCOL. SOME JURISDICTIONS DO NOT ALLOW THE LIMITATION OF LIABILITY FOR PERSONAL INJURY, OR OF INCIDENTAL OR CONSEQUENTIAL DAMAGES, SO THIS LIMITATION MAY NOT APPLY TO YOU. IN NO EVENT SHALL OUR TOTAL LIABILITY TO YOU FOR ALL DAMAGES (OTHER THAN AS MAY BE REQUIRED BY APPLICABLE LAW IN CASES INVOLVING PERSONAL INJURY) EXCEED THE AMOUNT OF ONE HUNDRED U.S. DOLLARS ($100.00 USD) OR ITS EQUIVALENT IN THE LOCAL CURRENCY OF THE APPLICABLE JURISDICTION. THE FOREGOING DISCLAIMER WILL NOT APPLY TO THE EXTENT PROHIBITED BY LAW. ### [](https://docs.bonzo.finance/hub/legal/terms-of-service#id-8.-governing-law-dispute-resolution-and-class-action-waivers) 8\. Governing Law, Dispute Resolution and Class Action Waivers **8.1 Governing Law** You agree that the laws of Dubai, without regard to principles of conflict of laws, govern this Agreement and any Dispute between you and us. You further agree that each of our Services shall be deemed to be based solely in Dubai, and that although a Service may be available in other jurisdictions, its availability does not give rise to general or specific personal jurisdiction in any forum outside of Dubai. The parties acknowledge that this Agreement evidences international commerce. Any arbitration conducted pursuant to this Agreement shall be governed by the relevant arbitration laws and regulations of Dubai. You agree that the courts of the Dubai International Financial Centre (DIFC) are the exclusive forums for any appeals of an arbitration award or for court proceedings in the event that this Agreement's binding arbitration clause is found to be unenforceable. **8.2 Dispute Resolution** We will use our best efforts to resolve any potential disputes through informal, good faith negotiations. If a potential dispute arises, you must contact us by sending an email to [\[email protected\]](https://docs.bonzo.finance/cdn-cgi/l/email-protection#127e7775737e52707d7c687d3c747b7c737c7177) so that we can attempt to resolve it without resorting to formal dispute resolution. If we aren't able to reach an informal resolution within sixty days of your email, then you and we both agree to resolve the potential dispute according to the process set forth below. At our sole discretion, we may elect to submit any Dispute to non-binding mediation. If an election to mediate is made, then such mediation shall be held in Dubai, unless the parties agree otherwise, and it shall be conducted by a mediator selected by us. We reserve the right to appear by video conference to the fullest extent permitted by law. Any claim or controversy arising out of or relating to any of our Services, this Agreement, or any other acts or omissions for which you may contend that we are liable, including, but not limited to, any claim or controversy as to arbitrability ("Dispute"), shall be finally and exclusively settled by arbitration conducted by the Dubai International Arbitration Centre (DIAC) pursuant to its Arbitration Rules (the "DIAC Rules") then in effect, except as modified by this Agreement. A party who wishes to start arbitration must submit a written demand for arbitration to the DIAC and give notice to the other party as specified in the DIAC Rules and per Section 9.5 of this Agreement. The arbitration shall be selected pursuant to the DIAC Rules. The arbitration will be held in Dubai, unless you and we both agree to hold it elsewhere. Unless we agree otherwise, the arbitrator may not consolidate your claims with those of any other party. Any judgment on the award rendered by the arbitrator may be entered in any court of competent jurisdiction. If for any reason a claim by law or equity must proceed in court rather than in arbitration, you agree to waive any right to a jury trial and any claim may be brought only in the courts of the Dubai International Financial Centre (DIFC). The parties will each pay their own attorney's fees and arbitration costs, unless the arbitrator makes an affirmative finding that a party's claim is frivolous, in which case the party asserting the frivolous claim will be required to pay the other party's attorney fees and arbitration costs. **8.3 Class Action and Jury Trial Waiver** You must bring any and all Disputes against us in your individual capacity and not as a plaintiff in or member of any purported class action, collective action, private attorney general action, or other representative proceeding. This provision applies to class arbitration. You and we both agree to waive the right to demand a trial by jury. ### [](https://docs.bonzo.finance/hub/legal/terms-of-service#id-9.-miscellaneous) 9\. Miscellaneous **9.1 Entire Agreement** These terms constitute the entire agreement between you and us with respect to the subject matter hereof. This Agreement supersedes any and all prior or contemporaneous written and oral agreements, communications and other understandings (if any) relating to the subject matter of the terms. **9.2 Assignment** You may not assign or transfer this Agreement, by operation of law or otherwise, without our prior written consent. Any attempt by you to assign or transfer this Agreement without our prior written consent shall be null and void. We may freely assign or transfer this Agreement. Subject to the foregoing, this Agreement will bind and inure to the benefit of the parties, their successors and permitted assigns. **9.3 Not Registered with the SEC or Any Other Agency** We are not registered with the U.S. Securities and Exchange Commission. You understand and acknowledge that we do not broker lending or borrowing orders on your behalf. We also do not facilitate the execution or settlement of your transactions, which occur entirely on public distributed blockchains like Hedera. As a result, we do not (and cannot) guarantee market best pricing or best execution through our Services. Any references in a Service to "best rate" does not constitute a representation or warranty about rates available through such Service, on the Protocol, or elsewhere. **9.4 Relationship of the Parties** Nothing in this Agreement shall be deemed or is intended to be deemed, nor shall it cause you and us to be treated as partners, joint ventures, or either you or us to be treated as the agent of the other. **9.5 Notice** You agree and consent to receive electronically all communications, agreements, documents, notices and disclosures (collectively "Communication(s)") that we may provide to you in connection with your use of the Service. You agree that we may provide such Communications via the primary email address you supply to us in your profile, instant chat, and/or through other electronic communications including but not limited to text messages or mobile push notifications. It is your responsibility to provide us with a true, accurate, and complete contact information. If we send you a Communication, but you do not receive it because your contact information is incorrect, blocked by a service provider, out of date, or you are otherwise unable to receive electronic Communications, we will have been deemed to have provided the Communication to you. Any notice or communications required to be given to us under this Agreement will be given and received via (i) email at [\[email protected\]](https://docs.bonzo.finance/cdn-cgi/l/email-protection#ddb1b8babcb19dbfb2b3a7b2f3bbb4b3bcb3beb8) , read and delivery receipt requested and confirmed; or (ii) sent by an overnight service with tracking capabilities to the address below, upon receipt; or (iii) sent by certified mail, upon signed receipt. Attn: BONZO FINANCE LABS - FZCO Building A1, Dubai Digital Park, Dubai Silicon Oasis, Dubai, United Arab Emirates **9.6 Severability** With the exception of Section 8.3 (Class Action and Jury Trial Waiver), if any provision of this Agreement shall be determined to be invalid or unenforceable under any rule, law, or regulation of any local, state, or federal government agency, such provision will be changed and interpreted to accomplish the objectives of the provision to the greatest extent possible under any applicable law and the validity or enforceability of any other provision of this Agreement shall not be affected. [PreviousAccounts & Contracts](https://docs.bonzo.finance/hub/accounts-and-contracts) [NextPrivacy Policy](https://docs.bonzo.finance/hub/legal/privacy-policy) Last updated 1 year ago --- # Protocol Contracts | Bonzo Finance Documentation [](https://docs.bonzo.finance/hub/developer/protocol-contracts#core-protocol-contracts) Core Protocol Contracts -------------------------------------------------------------------------------------------------------------------- ### [](https://docs.bonzo.finance/hub/developer/protocol-contracts#lending-pool-infrastructure) Lending Pool Infrastructure Contract Name Testnet Address Mainnet Address LendingPoolAddressesProviderRegistry [0xA5B57E3d0205436Eb3bb7d0F49bf1C9E399110F8](https://hashscan.io/testnet/contract/0.0.4999344) [0xE20273F10D1b85BaF56F6063cd5271C885427EC5](https://hashscan.io/mainnet/contract/0.0.7308449) LendingPoolAddressesProvider [0x873575d4AeeBe015AcF3BB17AAa9DD248cc76D68](https://hashscan.io/testnet/contract/0.0.4999346) [0x76b846DAB3646527bfb75952E1f33AfAA72B56D1](https://hashscan.io/mainnet/contract/0.0.7308451) LendingPool [0xf67DBe9bD1B331cA379c44b5562EAa1CE831EbC2](https://hashscan.io/testnet/contract/0.0.4999355) [0x236897c518996163E7b313aD21D1C9fCC7BA1afc](https://hashscan.io/mainnet/contract/0.0.7308459) LendingPoolConfigurator [0x6Fa59558495a4D8B1701ab7924fc5a249d63cfF0](https://hashscan.io/testnet/contract/0.0.4999359) [0xf41332220e51Ca8dB22De683fB0157e644e7A963](https://hashscan.io/mainnet/contract/0.0.7308462) LendingPoolCollateralManager [0x35426e22F51165008fD594265b789C258f68D457](https://hashscan.io/testnet/contract/0.0.4999415) [0x7687E1AaAD6cE335fb7d64ede7Dd7273De883698](https://hashscan.io/mainnet/contract/0.0.7308529) ### [](https://docs.bonzo.finance/hub/developer/protocol-contracts#oracle-contracts) Oracle Contracts Contract Name Testnet Address Mainnet Address AaveOracle [0x9B940a1e60D652bCaf09C1d2224d1A4a544FDFb0](https://hashscan.io/testnet/contract/0.0.4999377) [0xc0Bb4030b55093981700559a0B751DCf7Db03cBB](https://hashscan.io/mainnet/contract/0.0.7308480) PriceOracle [0xF6e755380518589dE02f0F6BaA1D291C016992Cb](https://hashscan.io/testnet/contract/0.0.4999375) [0x9F1981afD19e2881A4Acb39aa144c7fBc4a6D8b3](https://hashscan.io/mainnet/contract/0.0.7308479) LendingRateOracle [0xeC4a61EEb3d4015CCed52E51697347bf893931E7](https://hashscan.io/testnet/contract/0.0.4999378) [0x2a9272C588c8b6C04757577d08285211C18232DD](https://hashscan.io/mainnet/contract/0.0.7308481) ### [](https://docs.bonzo.finance/hub/developer/protocol-contracts#data-provider-and-helper-contracts) Data Provider & Helper Contracts Contract Name Testnet Address Mainnet Address AaveProtocolDataProvider [0x121A2AFFA5f595175E60E01EAeF0deC43Cc3b024](https://hashscan.io/testnet/contract/0.0.4999382) [0x78feDC4D7010E409A0c0c7aF964cc517D3dCde18](https://hashscan.io/mainnet/contract/0.0.7308483) WalletBalanceProvider [0xBB265cFA2Ccaa97260fAfd7303fCE751F3081d51](https://hashscan.io/testnet/contract/0.0.4999416) [0xD64ffB431cF66fDEDB6f98Af07c63F49295b69e5](https://hashscan.io/mainnet/contract/0.0.7308530) WETHGateway [0x16197Ef10F26De77C9873d075f8774BdEc20A75d](https://hashscan.io/testnet/contract/0.0.4999384) [0x9a601543e9264255BebB20Cef0E7924e97127105](https://hashscan.io/mainnet/contract/0.0.7308485) [](https://docs.bonzo.finance/hub/developer/protocol-contracts#implementation-contracts) Implementation Contracts ---------------------------------------------------------------------------------------------------------------------- These are the underlying implementation contracts (proxy contracts) used by the protocol. Contract Name Testnet Address Mainnet Address LendingPoolImpl [0xC9beA74f6A2897c0C014Fe26e141c6518a2D2b8E](https://hashscan.io/testnet/contract/0.0.4999354) [0x5290b075d737606fccccA2f745D7337E0fCe633B](https://hashscan.io/mainnet/contract/0.0.7308458) LendingPoolConfiguratorImpl [0xfa36F969AA5eFef29ADb2cf895c5B286a8eD72b1](https://hashscan.io/testnet/contract/0.0.4999357) [0x650f70Ec874DAB7464FEAc9Ba55D07f3896721a6](https://hashscan.io/mainnet/contract/0.0.7308461) LendingPoolCollateralManagerImpl [0x35426e22F51165008fD594265b789C258f68D457](https://hashscan.io/testnet/account/0.0.4999415) [0x7687E1AaAD6cE335fb7d64ede7Dd7273De883698](https://hashscan.io/mainnet/contract/0.0.7308529) [](https://docs.bonzo.finance/hub/developer/protocol-contracts#supported-mainnet-assets) Supported Mainnet Assets ---------------------------------------------------------------------------------------------------------------------- ### [](https://docs.bonzo.finance/hub/developer/protocol-contracts#whbar) WHBAR * Token: [`0x0000000000000000000000000000000000163b5a`](https://hashscan.io/mainnet/token/0.0.1456986) * aToken: [`0x6e96a607F2F5657b39bf58293d1A006f9415aF32`](https://hashscan.io/mainnet/contract/0.0.7308509) * Variable Debt: [`0xCD5A1FF3AD6EDd7e85ae6De3854f3915dD8c9103`](https://hashscan.io/mainnet/contract/0.0.7308511) ### [](https://docs.bonzo.finance/hub/developer/protocol-contracts#hbarx) HBARX * Token: [`0x00000000000000000000000000000000000cba44`](https://hashscan.io/mainnet/token/0.0.834116) * aToken: [`0x40EBC87627Fe4689567C47c8C9C84EDC4Cf29132`](https://hashscan.io/mainnet/contract/0.0.7308502) * Variable Debt: [`0xF4167Af5C303ec2aD1B96316fE013CA96Eb141B5`](https://hashscan.io/mainnet/contract/0.0.7308504) ### [](https://docs.bonzo.finance/hub/developer/protocol-contracts#usdc) USDC * Token: [`0x000000000000000000000000000000000006f89a`](https://hashscan.io/mainnet/token/0.0.456858) * aToken: [`0xB7687538c7f4CAD022d5e97CC778d0b46457c5DB`](https://hashscan.io/mainnet/contract/0.0.7308496) * Variable Debt: [`0x8a90C2f80Fc266e204cb37387c69EA2ed42A3cc1`](https://hashscan.io/mainnet/contract/0.0.7308498) ### [](https://docs.bonzo.finance/hub/developer/protocol-contracts#sauce) SAUCE * Token: [`0x00000000000000000000000000000000000b2ad5`](https://hashscan.io/mainnet/token/0.0.731861) * aToken: [`0x2bcC0a304c0bc816D501c7C647D958b9A5bc716d`](https://hashscan.io/mainnet/contract/0.0.7308505) * Variable Debt: [`0x736c5dbB8ADC643f04c1e13a9C25f28d3D4f0503`](https://hashscan.io/mainnet/contract/0.0.7308507) ### [](https://docs.bonzo.finance/hub/developer/protocol-contracts#xsauce) XSAUCE * Token: [`0x00000000000000000000000000000000001647e8`](https://hashscan.io/mainnet/token/0.0.1460200) * aToken: [`0xEc9CEF1167b4673726B1e5f5A978150e63cDf23b`](https://hashscan.io/mainnet/contract/0.0.7308493) * Variable Debt: [`0x08c816eC7aC0580c802151E4efFbDa687f7Cac2a`](https://hashscan.io/mainnet/contract/0.0.7308495) ### [](https://docs.bonzo.finance/hub/developer/protocol-contracts#karate) KARATE * Token: [`0x000000000000000000000000000000000022d6de`](https://hashscan.io/mainnet/token/0.0.2283230) * aToken: [`0x98262552C8246Ffb55E3539Ceb51838912402959`](https://hashscan.io/mainnet/contract/0.0.7308499) * Variable Debt: [`0xB6209F33982CE99139Ab325b13B260d32287A807`](https://hashscan.io/mainnet/contract/0.0.7308501) ### [](https://docs.bonzo.finance/hub/developer/protocol-contracts#dovu) DOVU * Token: [`0x000000000000000000000000000000000038b3db`](https://hashscan.io/mainnet/token/0.0.3716059) * aToken: [`0x89D2789481cB4CB5B6949Ff55EBA5629c5bC5B1E`](https://hashscan.io/mainnet/contract/0.0.7308512) * Variable Debt: [`0x9d81E1676A7e116ec725208DdeAB11929eA3F7A6`](https://hashscan.io/mainnet/contract/0.0.7308514) ### [](https://docs.bonzo.finance/hub/developer/protocol-contracts#hst) HST * Token: [`0x00000000000000000000000000000000000ec585`](https://hashscan.io/mainnet/token/0.0.968069) * aToken: [`0x2e63e864AAD2ce87b45d2C93bc126850DC5122c9`](https://hashscan.io/mainnet/contract/0.0.7308515) * Variable Debt: [`0xdc6e9E967648cd28E8BaF2EB1124ef7C9C5Bd027`](https://hashscan.io/mainnet/contract/0.0.7308517) ### [](https://docs.bonzo.finance/hub/developer/protocol-contracts#pack) PACK * Token: [`0x0000000000000000000000000000000000492a28`](https://hashscan.io/mainnet/token/0.0.4794920) * aToken: [`0x5F98C43ce4b4765638d69B4a2407a2186A347CB9`](https://hashscan.io/mainnet/contract/0.0.7308518) * Variable Debt: [`0x63c7EF5398E8Fe23D95E762802F011590A7816a1`](https://hashscan.io/mainnet/contract/0.0.7308520) ### [](https://docs.bonzo.finance/hub/developer/protocol-contracts#steam) STEAM * Token: [`0x000000000000000000000000000000000030fb8b`](https://hashscan.io/mainnet/token/0.0.3210123) * aToken: [`0x46BEf910150a3880ce6eAC60A059E70494A4805e`](https://hashscan.io/mainnet/contract/0.0.7308521) * Variable Debt: [`0xdFD1D43cbd700AEC5bcc151d028274412d31db70`](https://hashscan.io/mainnet/contract/0.0.7308523) ### [](https://docs.bonzo.finance/hub/developer/protocol-contracts#grelf) GRELF * Token: [`0x000000000000000000000000000000000011afa2`](https://hashscan.io/mainnet/token/0.0.1159074) * aToken: [`0xb8c34c9a46AEdf1decb846F942861EeE7dE78075`](https://hashscan.io/mainnet/contract/0.0.8677321) * Variable Debt: [`0x0E509Fc72f4b5d97494c0d45fcd1cF04d531Be44`](https://hashscan.io/mainnet/contract/0.0.8677323) ### [](https://docs.bonzo.finance/hub/developer/protocol-contracts#kbl) KBL * Token: [`0x00000000000000000000000000000000005b665a`](https://hashscan.io/mainnet/token/0.0.5989978) * aToken: [`0xC45A34b9D9e29fBfCAACC9193FD0CE950e63Ba81`](https://hashscan.io/mainnet/contract/0.0.9132058) * Variable Debt: [`0x6a74429E0D761085C4D5520A14ab59874dfe1C06`](https://hashscan.io/mainnet/contract/0.0.9132060) ### [](https://docs.bonzo.finance/hub/developer/protocol-contracts#bonzo) BONZO * Token: [`0x00000000000000000000000000000000007e545e`](https://hashscan.io/mainnet/token/0.0.8279134) * aToken: [`0xC5aa104d5e7D9baE3A69Ddd5A722b8F6B69729c9`](https://hashscan.io/mainnet/contract/0.0.9155090) * Variable Debt: [`0x1790C9169480c5C67D8011cd0311DDE1b2DC76e0`](https://hashscan.io/mainnet/contract/0.0.9155092?pr=1&pa=1&ps=1&pf=1) [](https://docs.bonzo.finance/hub/developer/protocol-contracts#interest-rate-strategy-contracts) Interest Rate Strategy Contracts -------------------------------------------------------------------------------------------------------------------------------------- ### [](https://docs.bonzo.finance/hub/developer/protocol-contracts#base-strategies) Base Strategies Strategy Name Testnet Address Mainnet Address Volatile One [0x82a278be934D9Ba2e4e46cad5d818647E2Ef0990](https://hashscan.io/testnet/contract/0.0.4999387) [0x0eaD7dDfC2Bb172D4a899aad8E7b4d882067a001](https://hashscan.io/mainnet/contract/0.0.7308488) Volatile Two [0x58812c9430fc9C1e246E34a92a11ecea057DB049](https://hashscan.io/testnet/contract/0.0.4674857) [0xDa47ecEC5ba98eF6a8C3c4F7EaDa3FBda6f7EED9](https://hashscan.io/mainnet/contract/0.0.7308491) Volatile Three [0x5c5a27079728FCB66522760032e19cf5d94Fd823](https://hashscan.io/testnet/contract/0.0.3666324) \- ### [](https://docs.bonzo.finance/hub/developer/protocol-contracts#asset-specific-strategies) Asset-Specific Strategies Asset Mainnet Address HBAR (wHBAR) [0x82C50aAfe0dc3f92e637EE05076d68180DB06d58](https://hashscan.io/mainnet/contract/0.0.7775843) HBARX [0xA68FC75Acc8a731a1e5cc4CB717b162566d947A8](https://hashscan.io/mainnet/contract/0.0.7775845) USDC [0x10753aD937e2f16daB73230fE5e5d8ace807C666](https://hashscan.io/mainnet/contract/0.0.7809070) SAUCE [0xf38e204b948Db78Ca5D51cCEd7ccEe182Fe4bcA8](https://hashscan.io/mainnet/contract/0.0.7809074) XSAUCE [0x998A60b83617F05c1Dcd4b3f5D37a2265d6a674D](https://hashscan.io/mainnet/contract/0.0.7775852) KARATE [0x9bB33f2D511CA3089Fc5696BEe3ABee7174a556a](https://hashscan.io/mainnet/contract/0.0.7809076) DOVU [0xC8C0c05683474a7B4c8DdaD69D0D546A841Be5D4](https://hashscan.io/mainnet/contract/0.0.7775862) HST [0x6886E0eD3Cb5dcE6f8e50dCb692a142AE8a14775](https://hashscan.io/mainnet/contract/0.0.7775868) PACK [0x4DF846F81135d9e63834AD4C7865F1C1983F767a](https://hashscan.io/mainnet/contract/0.0.7775864) STEAM [0xA3E524FE431011dc6d050c32E92Acc38D2f50cB4](https://hashscan.io/mainnet/contract/0.0.7775872) ### [](https://docs.bonzo.finance/hub/developer/protocol-contracts#hcs-20-points) HCS-20 Points Topic ID Season Ticker ID [0.0.7159077](https://hashscan.io/mainnet/topic/0.0.7159077) Pre-Season Points BZPT [0.0.7159077](https://hashscan.io/mainnet/topic/0.0.7159077) Season 1 Points BZ\_S1 [PreviousBonzo v1 Data API](https://docs.bonzo.finance/hub/developer/bonzo-v1-data-api) [NextLiquidation Bots (Beta)](https://docs.bonzo.finance/hub/developer/liquidation-bots-beta) Last updated 4 months ago --- # Introduction | Risk Framework Asset risk is a critical component of the overall risk management framework in decentralized finance (DeFi) protocols. Bonzo Finance, a lending and borrowing protocol built on the Hedera network, assesses the risks associated with supported assets is essential to maintaining the stability and security of the protocol. Bonzo Finance has developed a comprehensive methodology informed by Aave's methodology for evaluating risk related to assets supported by the protocol. This assessment takes into account various factors, including market risk, liquidity risk, and smart contract risk, among others. By carefully analyzing these risk factors, Bonzo Finance aims to ensure that the assets supported by the protocol meet stringent safety and stability criteria. This approach helps to protect users' funds, maintain the integrity of the protocol, and promote a secure lending and borrowing environment. The following sections explain the specific risk assessment methodologies employed by Bonzo Finance for each category of asset risk. This documentation also covers an overview of the current assets supported by the protocol and their respective risk profiles and parameter configurations. [NextAdding an Asset](https://docs.bonzo.finance/bonzo-risk-framework/asset-risk/adding-an-asset) Last updated 1 year ago --- # Email Protection | Cloudflare Please enable cookies. Email Protection ================ You are unable to access this email address docs.bonzo.finance -------------------------------------------------------------- The website from which you got to this page is protected by Cloudflare. Email addresses on that page have been hidden in order to keep them from being accessed by malicious bots. **You must enable Javascript in your browser in order to decode the e-mail address**. If you have a website and are interested in protecting it in a similar way, you can [sign up for Cloudflare](https://www.cloudflare.com/sign-up?utm_source=email_protection) . * [How does Cloudflare protect email addresses on website from spammers?](https://developers.cloudflare.com/waf/tools/scrape-shield/email-address-obfuscation/) * [Can I sign up for Cloudflare?](https://developers.cloudflare.com/fundamentals/setup/account/create-account/) Cloudflare Ray ID: **99c8cc054c9fc9b1** • Your IP: Click to reveal 54.237.218.47 • Performance & security by [Cloudflare](https://www.cloudflare.com/5xx-error-landing) --- # Actual Rates & Parameters | Risk Framework [](https://docs.bonzo.finance/bonzo-risk-framework/liquidity-risk/actual-rates-and-parameters#variable-interest-rate-model-parameters) Actual Interest Rate Parameters --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- **Asset** **Collateral** **Liquidation Bonus** UoptimalU\_{optimal}Uoptimal​ **Slope 1** **Slope 2** HBAR Yes 1.98% 55.00% 6% 150% HBARX Yes 1.18% 53.00% 6% 150% USDC Yes 7.40% 52.00% 12% 200% wETH Yes 7% 80% 3.3% 85% SAUCE Yes 3.95% 54.00% 9% 150% XSAUCE Yes 3.95% 54.00% 7% 150% KARATE Yes 3.46% 55.00% 9% 300% DOVU Yes 6.66% 47.00% 9% 250% PACK Yes 6.91% 52.00% 9% 250% HST Yes 6.17% 54.00% 9% 250% STEAM Yes 8.14% 54.00% 9% 250% GRELF Yes 6.66% 54.00% 9% 250% KBL Yes 6.66% 54% 9% 250% [](https://docs.bonzo.finance/bonzo-risk-framework/liquidity-risk/actual-rates-and-parameters#interest-rate-parameter-changes) Interest Rate Parameter Changes ------------------------------------------------------------------------------------------------------------------------------------------------------------------- When market conditions change, risks change; Bonzo Finance is continuously monitoring the assets integrated into the protocol, which sometimes requires quickly adapting the interest rate models. The table below tacks interest rate parameter changes over time. Date Asset Parameter Changed From To 10/29/2025 $wETH Optimal Utilization Slope 1 Slope 2 Liquidation Bonus New Asset 80% 3.3% 85% 7% 12/27/2024 $KARATE Optimal Utilization Slope 2 70% 100% 55% 300% 1/8/2025 $USDC Optimal Utilization Slope 1 70% 5% 52% 12% **3/25/2025** $GRELF Optimal Utilization Slope 1 Slope 2 New Asset 54.00% 9.00% 250.00% 4/24/2025 $KBL Optimal Utilization Slope 1 Slope 2 New Asset 54.00% 9.00% 250.00% ### [](https://docs.bonzo.finance/bonzo-risk-framework/liquidity-risk/actual-rates-and-parameters#hbar-interest-rate-model) HBAR Interest Rate Model ![](https://docs.bonzo.finance/bonzo-risk-framework/~gitbook/image?url=https%3A%2F%2F2639038200-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRl3dkXEKv1yqGhH70g65%252Fuploads%252FFj99v0MGZfa4i9QuuSfz%252Fimage.png%3Falt%3Dmedia%26token%3D71a4911c-c18f-4aa6-862f-66ffa5e08e19&width=768&dpr=4&quality=100&sign=69ad2a75&sv=2) ### [](https://docs.bonzo.finance/bonzo-risk-framework/liquidity-risk/actual-rates-and-parameters#hbarx-interest-rate-model) HBARX Interest Rate Model ![](https://docs.bonzo.finance/bonzo-risk-framework/~gitbook/image?url=https%3A%2F%2F2639038200-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRl3dkXEKv1yqGhH70g65%252Fuploads%252FmDy3jVCI3FvfzKVKIN9d%252Fimage.png%3Falt%3Dmedia%26token%3Db4bea794-8e49-45d6-a5d3-979a9e1170f5&width=768&dpr=4&quality=100&sign=c7bf7c87&sv=2) ### [](https://docs.bonzo.finance/bonzo-risk-framework/liquidity-risk/actual-rates-and-parameters#usdc-interest-rate-model) USDC Interest Rate Model ![](https://docs.bonzo.finance/bonzo-risk-framework/~gitbook/image?url=https%3A%2F%2F2639038200-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRl3dkXEKv1yqGhH70g65%252Fuploads%252FtAGVyDZh3IdWy7zBqxyH%252Fimage.png%3Falt%3Dmedia%26token%3D27e9f321-d88b-4697-be97-29dfa246cc45&width=768&dpr=4&quality=100&sign=b0b7fa54&sv=2) ### [](https://docs.bonzo.finance/bonzo-risk-framework/liquidity-risk/actual-rates-and-parameters#weth-interest-rate-model) wETH Interest Rate Model ![](https://docs.bonzo.finance/bonzo-risk-framework/~gitbook/image?url=https%3A%2F%2F2639038200-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRl3dkXEKv1yqGhH70g65%252Fuploads%252FhFXK1KqqtdBwFCqEU4bq%252FScreenshot%25202025-10-29%2520at%25205.37.34%25E2%2580%25AFPM.png%3Falt%3Dmedia%26token%3D60586972-be1e-4d96-8404-8e5e29ef10ff&width=768&dpr=4&quality=100&sign=1f1c9d7f&sv=2) ### [](https://docs.bonzo.finance/bonzo-risk-framework/liquidity-risk/actual-rates-and-parameters#sauce-interest-rate-model) SAUCE Interest Rate Model ![](https://docs.bonzo.finance/bonzo-risk-framework/~gitbook/image?url=https%3A%2F%2F2639038200-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRl3dkXEKv1yqGhH70g65%252Fuploads%252FrdhLz3aPTHOUPZljFW58%252Fimage.png%3Falt%3Dmedia%26token%3Dc8e1852b-2d8d-4710-83f1-c41fcdc1be46&width=768&dpr=4&quality=100&sign=cd0fd675&sv=2) ### [](https://docs.bonzo.finance/bonzo-risk-framework/liquidity-risk/actual-rates-and-parameters#xsauce-interest-rate-model) XSAUCE Interest Rate Model ![](https://docs.bonzo.finance/bonzo-risk-framework/~gitbook/image?url=https%3A%2F%2F2639038200-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRl3dkXEKv1yqGhH70g65%252Fuploads%252F2UDXw0dSkU3Dm6xapoR2%252Fimage.png%3Falt%3Dmedia%26token%3Dfdceeeb2-fe64-43de-be96-77231fde9d95&width=768&dpr=4&quality=100&sign=6cf918b7&sv=2) ### [](https://docs.bonzo.finance/bonzo-risk-framework/liquidity-risk/actual-rates-and-parameters#karate-interest-rate-model) KARATE Interest Rate Model ![](https://docs.bonzo.finance/bonzo-risk-framework/~gitbook/image?url=https%3A%2F%2F2639038200-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRl3dkXEKv1yqGhH70g65%252Fuploads%252FrG9A4ZiX8BKcBKQg6CMR%252FScreenshot%25202024-12-29%2520at%25201.40.00%25E2%2580%25AFPM.png%3Falt%3Dmedia%26token%3D3f1315e1-2492-49b9-b9af-3cef24828b93&width=768&dpr=4&quality=100&sign=118504e1&sv=2) ### [](https://docs.bonzo.finance/bonzo-risk-framework/liquidity-risk/actual-rates-and-parameters#dovu-interest-rate-model) DOVU Interest Rate Model ![](https://docs.bonzo.finance/bonzo-risk-framework/~gitbook/image?url=https%3A%2F%2F2639038200-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRl3dkXEKv1yqGhH70g65%252Fuploads%252F1hx1A3Y0LB6ZeMp0OX5w%252Fimage.png%3Falt%3Dmedia%26token%3Dd15f23b8-470e-476a-9bd3-cbfa259b26f4&width=768&dpr=4&quality=100&sign=f4f8a51a&sv=2) ### [](https://docs.bonzo.finance/bonzo-risk-framework/liquidity-risk/actual-rates-and-parameters#pack-interest-rate-model) PACK Interest Rate Model ![](https://docs.bonzo.finance/bonzo-risk-framework/~gitbook/image?url=https%3A%2F%2F2639038200-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRl3dkXEKv1yqGhH70g65%252Fuploads%252F4put3nkUXFXcK9iHPVcu%252Fimage.png%3Falt%3Dmedia%26token%3D47bf7d82-8198-46e5-9d3c-912278cf772a&width=768&dpr=4&quality=100&sign=7d450297&sv=2) ### [](https://docs.bonzo.finance/bonzo-risk-framework/liquidity-risk/actual-rates-and-parameters#hst-interest-rate-model) HST Interest Rate Model ![](https://docs.bonzo.finance/bonzo-risk-framework/~gitbook/image?url=https%3A%2F%2F2639038200-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRl3dkXEKv1yqGhH70g65%252Fuploads%252F6hC0MTFChAzLewYWggAN%252Fimage.png%3Falt%3Dmedia%26token%3D9855cab3-313c-4fd6-bae7-035ced18b238&width=768&dpr=4&quality=100&sign=f66cb8a9&sv=2) ### [](https://docs.bonzo.finance/bonzo-risk-framework/liquidity-risk/actual-rates-and-parameters#steam-interest-rate-model) STEAM Interest Rate Model ![](https://docs.bonzo.finance/bonzo-risk-framework/~gitbook/image?url=https%3A%2F%2F2639038200-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRl3dkXEKv1yqGhH70g65%252Fuploads%252FcZ45nKBep6YZ1xnJ22Ok%252Fimage.png%3Falt%3Dmedia%26token%3D037ade17-3e62-40ba-b572-583fe3e0b305&width=768&dpr=4&quality=100&sign=4e952e53&sv=2) ### [](https://docs.bonzo.finance/bonzo-risk-framework/liquidity-risk/actual-rates-and-parameters#grelf-interest-rate-model) GRELF Interest Rate Model ![](https://docs.bonzo.finance/bonzo-risk-framework/~gitbook/image?url=https%3A%2F%2F2639038200-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRl3dkXEKv1yqGhH70g65%252Fuploads%252FgqqBhAl8ccvCJdu1zDQf%252FScreenshot%25202025-04-04%2520at%25207.30.41%25E2%2580%25AFPM.png%3Falt%3Dmedia%26token%3D146e7d8a-356f-4b93-97de-3d23e15581b0&width=768&dpr=4&quality=100&sign=cb90abc0&sv=2) ### [](https://docs.bonzo.finance/bonzo-risk-framework/liquidity-risk/actual-rates-and-parameters#kbl-interest-rate-model) KBL Interest Rate Model ![](https://docs.bonzo.finance/bonzo-risk-framework/~gitbook/image?url=https%3A%2F%2F2639038200-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRl3dkXEKv1yqGhH70g65%252Fuploads%252F0uqDGJ3L9AHuE6UIfnkb%252Fimage.png%3Falt%3Dmedia%26token%3Dc764a0ee-a5a5-49c9-852b-6af1f74af57c&width=768&dpr=4&quality=100&sign=ebbd7906&sv=2) [PreviousSupply Rate Methodology](https://docs.bonzo.finance/bonzo-risk-framework/liquidity-risk/supply-rate-methodology) [NextSmart Contracts & HTS Tokens](https://docs.bonzo.finance/bonzo-risk-framework/liquidity-risk/smart-contracts-and-hts-tokens) Last updated 10 days ago --- # Risk Parameters per Asset | Risk Framework ℹ 7/28/25 | Note: Supply Caps on Asset Markets (Expand to Read)[](https://docs.bonzo.finance/bonzo-risk-framework/asset-risk/risk-parameters-per-asset#id-7-28-25-or-note-supply-caps-on-asset-markets-expand-to-read) Bonzo Finance has crossed $70 million Total Value Locked (TVL) — an all-time high of TVL in $hbar denominated value, as well — powered by institutional inflows and a growing Hedera retail user base. **As the protocol continues to mature and evolve, larger amounts of liquidity, relative to the size of Hedera's ecosystem, calls for additional risk controls.** In coordination with risk partners, the **Bonzo Finance protocol has implemented supply caps across asset markets** for more adequate protection of lenders, the protocol, and supported tokens. Supply and borrow caps in Bonzo Finance are configured as fixed token amounts (versus total value). At a high-level, supply caps are set on a per-asset basis and determined based on asset and liquidity attributes, including, but not limited to, their relative available liquidity across Hedera DeFi (DEXs, etc.). With the introduction of supply caps, certain asset markets may have a cap configured lower than the amount currently supplied; this is often common in lending protocols across web3, as changing market dynamics shift risks, especially during volatile seasons. **If an asset's supply cap is configured below the amount currently supplied, funds can remain supplied and used as collateral (or “supply only”), until withdrawn, without issue.** If an asset's supply has reached or is above its cap, users will not be able to supply this asset to a pool (or re-supply after withdrawing, if already in the pool) until the pool's total supply drops below the cap. Safety for users, the protocol, and broader ecosystem is priority #1 to ensure long-term success — while certain limitations can feel restricting, they serve as critical safeguards which support the current state of Hedera's ecosystem as it continues on its trajectory towards more liquidity, users, and protocols. Each asset in the Bonzo Finance protocol has configurable risk parameters, which influences how they are supplied and borrowed. The calibration of the parameters will be conservative as the protocol launches, to ensure safety, and become more aggressive as the Bonzo Finance ecosystem matures with educated users, greater liquidity, and a thriving liquidation ecosystem. The table below offers a summary of the latest risk parameters per asset: Asset LTV Liquidation Threshold Liquidation Bonus Reserve Factor Supply Cap Borrow Cap $HBAR 62.72% 67.98% 1.98% 11.68% \- 57,034,268 $HBARX 62.98% 68.28% 1.18% 10.14% \- 9,641,854 $USDC 80.45% 83.50% 7.40% 13.50% \- 5,500,000 $wETH 70% 75% 7% 20% 225 112 $SAUCE 40.00% 68.04% 3.95% 14.60% 18,138,944 4,534,736 $XSAUCE 40.00% 67.59% 3.95% 10.94% 14,936,519 3,734,129 $BONZO 40.00% 59.00% 6.66% 17.25% 14,116,318 3,529,079 $KARATE 20.00% 65.00% 3.46% 19.60% 385,208,012 77,041,602 $DOVU 20.00% 59.00% 6.66% 17.25% 19,379,844 3,875,968 $PACK 10.00% 57.00% 6.91% 12.97% 480,307 0 $HST 10.00% 52.00% 6.17% 15.22% 1,077,934 0 $STEAM 10.00% 57.00% 8.14% 13.88% 1,226,843 0 $GRELF 20.00% 59.00% 6.66% 17.25% 107,642 21,528 $KBL 10.00% 57.00% 6.66% 17.25% 1,161,440 0 The table above results from the asset risk assessment relating to security, governance and the markets. Tokens with high risk exposure to single counter-parties cannot be used as collateral. [](https://docs.bonzo.finance/bonzo-risk-framework/asset-risk/risk-parameters-per-asset#risk-parameter-changes) Risk Parameter Changes ------------------------------------------------------------------------------------------------------------------------------------------- When market conditions change, risks change; Bonzo Finance is continuously monitoring the assets integrated into the protocol, which sometimes requires quickly adapting the risk parameters. The table below tacks parameter changes over time. Date Asset Parameter Changed From To **10/28/2025** wETH Loan-to-Value (LTV) Liquidation Threshold Liquidation Bonus Reserve Factor Supply Cap Borrow Cap New Asset 70% 75% 7% 20% 220 112 **8/13/2025** SAUCE XSAUCE BONZO KARATE GRELF DOVU PACK STEAM HST KBL Supply Caps [Supply / Borrow Cap Updates - Ecosystem Assets](https://docs.bonzo.finance/bonzo-risk-framework/change-memos/august-2025/supply-borrow-cap-updates-ecosystem-assets) 10,000,000 35,000,000 30,000,000 2,000,000,000 949,834 102,000,000 10,120,275 19,781,362 26,725,453 45,450,838 18,138,944 14,936,519 14,116,318 385,208,012 107,642 19,379,844 480,307 1,226,843 1,077,934 1,161,440 **8/13/2025** SAUCE XSAUCE BONZO KARATE GRELF DOVU PACK STEAM HST KBL Borrow Caps [Supply / Borrow Cap Updates - Ecosystem Assets](https://docs.bonzo.finance/bonzo-risk-framework/change-memos/august-2025/supply-borrow-cap-updates-ecosystem-assets) 3,000,000 10,750,000 8,400,000 803,014,392 450,000 230,000,000 16,053,200 11,372,200 5,537,875 16,000,000 4,534,736 3,734,129 3,529,079 77,041,602 21,528 3,875,968 0 0 0 0 **8/13/2025** SAUCE XSAUCE BONZO KARATE GRELF DOVU PACK STEAM HST KBL LTV [Risk Parameter LTV Updates - Ecosystem Assets](https://docs.bonzo.finance/bonzo-risk-framework/change-memos/august-2025/risk-parameter-ltv-updates-ecosystem-assets) 30.00% 30.00% 30.00% 25.00% 20.00% 20.00% 25.00% 20.00% 20.00% 25.00% 40.00% 40.00% 40.00% 20.00% " " 10.00% 10.00% 10.00% 10.00% **8/8/2025** $SAUCE $XSAUCE $BONZO $STEAM $PACK $DOVU $HST $GRELF $KBL LTV 62.41% 61.83% 50.00% 50.00% 50.00% 50.00% 45.00% 50.00% 50.00% 30% 30% 30% 20% 25% 20% 20% 20% 25% **8/8/2025** $SAUCE $XSAUCE $HST $GRELF $KBL Borrow Cap 4,376,629 18,755,218 12,537,875 678,611 17,335,529 3,000,000 10,750,000 5,537,875.00 450,000 16,000,000 **8/8/2025** $SAUCE $XSAUCE $KARATE $STEAM $PACK $GRELF $KBL Supply Cap 14,832,201 43,384,117 3,229,337,939 22,781,362 14,120,275 2,849,834 49,450,838 10,000,000 35,000,000 2,000,000,000 19,781,362 10,120,275 949,834 45,450,838 **8/6/2025** $KARATE LTV Liquidation Threshold 50.00% 57.00% 25% 65% **8/6/2025** $PACK Borrow Cap 16,053,200 3,500,000 **8/6/2025** $BONZO $DOVU Supply Cap 41,480,000 435,394,769 30,000,000 230,000,000 **7/30/2025** $USDC Borrow Cap 3,449,222 5,500,000 **7/28/2025** $SAUCE $XSAUCE $KARATE $DOVU $PACK $HST $STEAM $GRELF $KBL $BONZO Supply Cap New Parameter 14,832,201 43,384,117 3,229,337,939 435,394,769 14,120,275 26,725,453 22,781,362 2,849,834 49,450,838 41,480,000 **7/11/2025** $USDC $KARATE $BONZO $GRELF $KBL Borrow Cap 3,449,222 750,000,000 5,000,000 500,000 13,000,000 4,000,000 803,014,392 8,400,000 678,611 17,335,529 **5/13/2025** $BONZO $GRELF $KBL Borrow Cap 3,500,000 160,000 5,000,000 5,000,000 500,000 13,000,000 **5/13/2025** $KARATE $DOVU $STEAM $BONZO $GRELF $KBL Liquidation Threshold 52.00% 52.00% 52.00% 52.00% 43.00% 43.00% 57.00% 59.00% 57.00% 59.00% 59.00% 57.00% **5/13/2025** $KARATE $DOVU $STEAM $BONZO $GRELF $KBL Loan-to-Value (LTV) 45.00% 45.00% 45.00% 30.00% 30.00% 30.00% 50.00% 50.00% 50.00% 50.00% 50.00% 50.00% **5/1/2025** $BONZO Loan-to-Value (LTV) Liquidation Threshold Liquidation Bonus Reserve Factor Borrow Cap New Asset 30.00% 43.00% 6.66% 17.25% 3,500,000 **4/25/2025** $KBL Borrow Cap 29,200,000 5,000,000 **4/24/2025** $KBL Loan-to-Value (LTV) Liquidation Threshold Liquidation Bonus Reserve Factor Borrow Cap New Asset 30.00% 43.00% 6.66% 17.25% 29,200,000 **4/1/2025** $PACK Borrow Cap 2,514,592 16,053,200 **4/1/2025** $USDC Borrow Cap 2,941,539 3,449,222 **3/26/2025** $GRELF Borrow Cap 656,716 160,000 **3/25/2025** $GRELF Loan-to-Value (LTV) Liquidation Threshold Liquidation Bonus Reserve Factor Borrow Cap New Asset 30.00% 43.00% 6.66% 17.25% 656,716 **3/18/2025** $KARATE $DOVU $PACK $HST $STEAM Liquidation Threshold 41.00% 43.50% 43.00% 48.00% 43.00% 52.00% 52.00% 57.00% 52.00% 52.00% **3/18/2025** $KARATE $DOVU $PACK $HST $STEAM Loan-to-Value (LTV) 30.00% 30.00% 30.00% 30.00% 30.00% 45.00% 45.00% 50.00% 45.00% 45.00% **3/18/2025** $HBARX $USDC $XSAUCE Reserve Factor 14.58% 10.40% 12.86% 10.14% 13.50% 10.94% **3/18/2025** $USDC $KARATE $DOVU $PACK $STEAM Borrow Cap 1,875,300 218,118,366 83,682,008 1,941,454 11,208,478 2,941,539 750,000,000 102,000,000 2,514,592 11,372,200 **2/14/2025** $USDC $KARATE $DOVU $HST $STEAM Borrow Cap 1,783,375 950,959,650 296,716,240 21,932,392 19,715,165 1,875,300 218,118,366 83,682,008 12,537,875 11,208,478 2/2/2025 $HBAR $HBARX $USDC $SAUCE $XSAUCE $KARATE $DOVU $PACK $HST $STEAM Borrow Cap 65,424,962 25,712,671 2,314,729 4,085,167 20,768,560 457,526,473 259,530,259 1,814,378 20,294,813 20,879,107 57,034,268 9,641,854 1,783,375 4,376,629 18,755,218 950,959,650 296,716,240 1,941,454 21,932,392 19,715,165 **01/31/2025** $USDC $HBAR Borrow Cap 1,017,153 12,696,906 2,314,729 65,424,962 **1/28/2025** $HBAR $USDC Borrow Cap 27,989,525 2,138,912 65,424,962 2,314,729 **1/25/2025** $HBAR $USDC Borrow Cap 13,493,843 1,257,182 27,989,525 2,138,912 **1/13/2025** $KARATE $DOVU $PACK $HST $STEAM Liquidation Threshold 0.02% 0.02% 0.02% 0.02% 0.02% 41.00% 43.50% 43.00% 48.00% 43.00% **1/13/2025** $KARATE $DOVU $PACK $HST $STEAM Loan-to-Value (LTV) 0.01% 0.01% 0.01% 0.01% 0.01% 30.00% 30.00% 30.00% 30.00% 30.00% **1/8/2025** $HBAR $HBARX $USDC $SAUCE $XSAUCE $KARATE $DOVU $PACK $HST $STEAM Borrow Cap 12,874,870 23,930,116 696,641 5,020,146 21,258,578 456,725,925 251,807,558 1,928,615 20,254,780 19,076,860 13,493,843 25,712,671 1,257,182 4,085,167 20,768,560 457,526,473 259,530,259 1,814,378 20,294,813 20,879,107 **12/27/2024** $HBAR $HBARX $USDC $SAUCE $XSAUCE $KARATE $DOVU $PACK $HST $STEAM Borrow Cap 13,147,016 23,934,448 1,335,740 5,440,193 20,566,527 170,317,292 101,344,300 812,343 8,454,396 7,801,459 12,874,870 23,930,116 696,641 5,020,146 21,258,578 456,725,925 251,807,558 1,928,615 20,254,780 19,076,860 **12/23/2024** $USDC Borrow Cap 745,902 1,335,740 **12/20/2024** $HBAR $HBARX $USDC $SAUCE $XSAUCE $KARATE $DOVU $PACK $HST $STEAM Borrow Cap 12,696,906 23,338,766 713,273 4,751,002 20,411,784 98,497,690 101,194,454 811,403 8,458,395 7,389,362 13,147,016 23,934,448 745,902 5,440,193 20,566,527 170,317,292 101,344,300 812,343 8,454,396 7,801,459 **12/18/2024** $HBAR $HBARX $USDC $SAUCE $XSAUCE $KARATE $DOVU $PACK $HST $STEAM Borrow Cap 9,268,465 14,975,362 691,146 2,455,823 13,917,964 117,808,061 89,258,923 873,709 12,065,370 5,585,154 12,696,906 23,338,766 713,273 4,751,002 20,411,784 98,497,690 101,194,454 811,403 8,458,395 7,389,362 **12/16/2024** $USDC Borrow Cap 1,017,153 691,146 **12/14/2024** $USDC Borrow Cap 1,005,373 1,017,153 [PreviousRisk Parameters](https://docs.bonzo.finance/bonzo-risk-framework/asset-risk/risk-parameters) [NextOracle Price Feeds](https://docs.bonzo.finance/bonzo-risk-framework/asset-risk/oracle-price-feeds) Last updated 10 days ago --- # Ledger Works | Risk Framework The composability of DeFi enables Bonzo Finance to interoperate with the entire Hedera ecosystem. However, it also exposes the protocol to potential financial contagion. Assets supported by the protocol affect the platform at its core — particularly assets that can be supplied as collateral — which safeguard the protocol's solvency. To ensure that an asset holds a reasonable amount of risk, Bonzo Finance has contracted [Ledger Works](https://www.lworks.io/) for real-time risk assessment and monitoring, using machine learning / AI and actuarial models. Ledger Works modeling takes into account data from SaucerSwap liquidity pools, Bonzo Finance utilization, counter parties (Supra oracles), and macro-economic forces, to derive appropriate risk parameter configurations for assets supported by Bonzo Finance. [PreviousAdding an Asset](https://docs.bonzo.finance/bonzo-risk-framework/asset-risk/adding-an-asset) [NextRisk Parameters](https://docs.bonzo.finance/bonzo-risk-framework/asset-risk/risk-parameters) Last updated 11 months ago --- # Oracle Price Feeds | Risk Framework [Supra](https://docs.supra.com/docs/data-feeds/decentralized/networks) push oracles are currently being utilized in the Bonzo Finance protocol on Hedera for accurate and reliable price feeds. To view live data feeds, please visit the [Supra data feed dashboard](https://supra.com/data) . Provider EVM Contract Supra "Push" Oracles on Hedera [0xD02cc7a670047b6b012556A88e275c685d25e0c9](https://hashscan.io/mainnet/contract/0.0.4322850) ### [](https://docs.bonzo.finance/bonzo-risk-framework/asset-risk/oracle-price-feeds#supra-oracle-feed-index) **Supra Oracle Feed Index** Supra offers a "[data feed index](https://docs.supra.com/oracles/data-feeds/data-feeds-index) " per each price feed; found below is the index number for each feed, utilized by the Bonzo Finance protocol. For a live view of price feeds from Supra, please see the [Supra data dashboard](https://supra.com/data) . Data Feed Index Number HBARX / wHBAR 427 wHBAR / USDC 505 SAUCE / wHBAR 425 xSAUCE / wHBAR 426 DOVU / wHBAR 429 HST / wHBAR 428 KARATE / wHBAR 472 PACK / wHBAR 478 STEAM / wHBAR 479 Read more about Bonzo Finance's Supra implementation in this blog posting: [https://bonzo.finance/blog/integrating-supra-oracles-into-bonzo-finance-on-hedera-hashgraph](https://bonzo.finance/blog/integrating-supra-oracles-into-bonzo-finance-on-hedera-hashgraph) [PreviousRisk Parameters per Asset](https://docs.bonzo.finance/bonzo-risk-framework/asset-risk/risk-parameters-per-asset) [NextIntroduction](https://docs.bonzo.finance/bonzo-risk-framework/liquidity-risk/introduction) Last updated 11 days ago --- # Risk Parameters | Risk Framework Bonzo Finance utilizes several key risk parameters configured per asset to manage the protocol's risk exposure and ensure its stability. These parameters are carefully calibrated by Ledger Works, and are based on various risk factors to provide optimal security for lenders while maintaining flexibility for borrowers. ### [](https://docs.bonzo.finance/bonzo-risk-framework/asset-risk/risk-parameters#loan-to-value) **Loan-to-Value (LTV)** The Loan-to-Value (LTV) ratio defines the maximum amount of currency that can be borrowed with a specific collateral. It’s expressed in percentage: at LTV=75%, for every 1 HBAR worth of collateral, borrowers will be able to borrow 0.75 HBAR worth of the corresponding currency. * **Risk Consideration**: A lower LTV indicates a more conservative lending approach, reducing the risk of under-collateralization during market volatility. * **Calculation:** For each connected account the maximum LTV is calculated as the weighted average of the LTVs of the collateral assets supplied and their value: MaxLTV\=∑Collaterali in HBAR×LTViTotal Collateral in HBAR\\text{MaxLTV} = \\frac{\\sum \\text{Collateral}\_i \\text{ in HBAR} \\times \\text{LTV}\_i}{\\text{Total Collateral in HBAR}} MaxLTV\=Total Collateral in HBAR∑Collaterali​ in HBAR×LTVi​​ ### [](https://docs.bonzo.finance/bonzo-risk-framework/asset-risk/risk-parameters#loan-to-value-1) **Liquidation Threshold** The Liquidation Threshold is the point at which a loan becomes undercollateralized and eligible for liquidation. It's always set higher than the LTV to provide a buffer against market fluctuations. For more volatile assets, this buffer is typically set higher for additional protection. * **Risk Consideration**: The gap between LTV and Liquidation Threshold acts as a safety cushion, allowing borrowers time to react to market changes before risking liquidation. * **Calculation:** For each account the Liquidation Threshold is calculated as the weighted average of the Liquidation Thresholds of the collateral assets supplied and their value: Liquidation Threshold\=∑Collaterali in HBAR×Liquidation ThresholdiTotal Collateral in HBAR\\text{Liquidation Threshold} = \\frac{\\sum \\text{Collateral}\_i \\text{ in HBAR} \\times \\text{Liquidation Threshold}\_i}{\\text{Total Collateral in HBAR}} Liquidation Threshold\=Total Collateral in HBAR∑Collaterali​ in HBAR×Liquidation Thresholdi​​ ### [](https://docs.bonzo.finance/bonzo-risk-framework/asset-risk/risk-parameters#loan-to-value-2) **Liquidation Bonus** The Liquidation Bonus is an incentive offered to liquidators for repaying undercollateralized loans — it is viewed as a "penalty" from the perspective of the collateral supplier, as it's considered a loss on the collateral supplied. This bonus is expressed as a percentage of the collateral's value that liquidators "purchase" at a discount, as part of the liquidation process. * **Risk Consideration**: A higher bonus incentivizes quicker liquidations, helping to maintain the protocol's solvency during market downturns. If the bonus is high per individual asset, it disincentivizes supplying the asset as collateral, as it could result in loss for the borrower. * **Calculation**: Market Price of Asset \* (1 - Liquidation Bonus) = Discounted Price ### [](https://docs.bonzo.finance/bonzo-risk-framework/asset-risk/risk-parameters#loan-to-value-3) **Health Factor** For each wallet, these risks parameters enable the calculation of the health factor: Hf\=∑Collaterali in HBAR×Liquidation ThresholdiTotal Borrows in HBARH\_f = \\frac{\\sum \\text{Collateral}\_i \\text{ in HBAR} \\times \\text{Liquidation Threshold}\_i}{\\text{Total Borrows in HBAR}} Hf​\=Total Borrows in HBAR∑Collaterali​ in HBAR×Liquidation Thresholdi​​ When the following formula below is true, the position may be liquidated to maintain solvency as described in the diagram below. Hf<1H\_f < 1Hf​<1 ![](https://docs.bonzo.finance/bonzo-risk-framework/~gitbook/image?url=https%3A%2F%2F2639038200-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FRl3dkXEKv1yqGhH70g65%252Fuploads%252FzhjWWZgHW7aqGB7PUzh6%252FScreenshot%25202024-08-07%2520at%25204.44.16%25E2%2580%25AFPM.png%3Falt%3Dmedia%26token%3Dc2c00c54-98a1-4c9e-a0bd-bff7aff46b11&width=768&dpr=4&quality=100&sign=b5ca8995&sv=2) Risk Parameters Safeguard Solvency ### [](https://docs.bonzo.finance/bonzo-risk-framework/asset-risk/risk-parameters#reserve-factor) Reserve Factor The Reserve Factor is the percentage of interest payments (protocol fees) set aside as protocol reserves. This reserve is used to sustain DAO operations and pay for protocol development; it also acts as an additional layer of security for the protocol, being employed in the case of a shortfall event, prior to any activation of the Safety Module. * **Risk Consideration**: A higher Reserve Factor builds a larger safety net for the protocol but may reduce yields for lenders. * **Calculation**: Reserve Factor = (Interest Allocated to Reserves) / (Total Interest Collected) x 100% [PreviousLedger Works](https://docs.bonzo.finance/bonzo-risk-framework/asset-risk/ledger-works) [NextRisk Parameters per Asset](https://docs.bonzo.finance/bonzo-risk-framework/asset-risk/risk-parameters-per-asset) Last updated 11 months ago --- # Introduction | Risk Framework Bonzo Finance is an open source, non-custodial lending protocol built on the Hedera network, leveraging open source Aave v2 to enable lending and borrowing of digital assets found across the Hedera ecosystem to and from liquidity pools. Asset suppliers receive interest-bearing aTokens in exchange for their deposits. Liquidity is a critical metric for Bonzo Finance, as it represents the protocol's capacity to handle core operations: facilitating borrowing and allowing the redemption of aTokens for underlying supported assets. Insufficient liquidity can severely impair the protocol's functionality. The protocol's liquidity can be gauged at any given moment through its utilization ratio — the proportion of each asset's supply pool that is currently being borrowed. This "liquidity risk" section explains Bonzo Finance's liquidity risk by: 1. Analyzing the historical availability of assets in Bonzo Finance 2. Identifying periods of liquidity scarcity It's important to note that illiquid assets often suffer from valuation discounts due to the challenge of finding counterparties, especially in newer DeFi ecosystems, such as Hedera's. By studying historical utilization rates, Bonzo Finance can help assess the protocol's liquidity risk level. This understanding allows for the implementation of effective risk management strategies, including: 1. Tailoring the borrow interest rate model to the Hedera DeFi ecosystem's unique characteristics 2. Establishing alternative sources of aToken liquidity that align with Hedera's ecosystem These measures aim to ensure Bonzo Finance maintains robust liquidity, supporting its operations and growth within Hedera's DeFi ecosystem. [PreviousOracle Price Feeds](https://docs.bonzo.finance/bonzo-risk-framework/asset-risk/oracle-price-feeds) [NextHistorical Utilization](https://docs.bonzo.finance/bonzo-risk-framework/liquidity-risk/historical-utilization) Last updated 1 year ago --- # Supply Rate Methodology | Risk Framework Borrow interest rates paid are distributed as yield for aToken holders who have supplied assets in the protocol, excluding a share of yields sent to the ecosystem reserve defined by the reserve factor on a per asset basis. The **deposit (supply) interest rate** is paid on assets supplied, which is shared amongst all liquidity providers. The deposit APY DtD\_tDt​ is: Dt\=Ut(VBtVt)(1−Rt)D\_t = U\_t(VB\_tV\_t)(1 - R\_t) Dt​\=Ut​(VBt​Vt​)(1−Rt​) * UtU\_tUt​ = the utilization ratio * VBtVB\_tVBt​ = the share of variable borrows * VtV\_tVt​ = the variable rate * RtR\_tRt​ = the reserve factor [PreviousBorrow Rate Methodology](https://docs.bonzo.finance/bonzo-risk-framework/liquidity-risk/borrow-rate-methodology) [NextActual Rates & Parameters](https://docs.bonzo.finance/bonzo-risk-framework/liquidity-risk/actual-rates-and-parameters) Last updated 1 year ago --- # Adding an Asset | Risk Framework Bonzo Finance enables users to deposit and borrow digital assets through the pooling of funds. Depositors receive protocol-issued aTokens, which accumulate deposits and the interest generated. Each loan is secured by collateral acting as a risk mitigation tool against default. As the means of exchange, assets are central in Bonzo Finance's non-custodial lending operations. More details on how the protocol works can be found in Bonzo Finance's [documentation](https://docs.bonzo.finance/) . Given the specificities of Bonzo Finance's model, the selection of assets has been performed with the following constraints: 1. **Each additional asset will slightly increase the gas cost of the borrow and redeem actions permanently on the Hedera network.** The asset must be included in the smart contract, adding complexity and thus costs. 2. **Each asset added to the Bonzo Finance protocol as collateral increases the protocol risk of insolvency.** From a financial perspective, the assets of Bonzo Finance are collateral, while the liabilities are the loaned amounts. The underlying assets for collateral and loaned amounts often differ, with loans mostly taken in stablecoins and backed by volatile tokens. This means the protocol is heavily exposed to the failure of assets supported as collateral and their market fluctuations. 3. **A centralized asset accepted as collateral exposes the protocol to its centralization risk.** The single point of failure risks of underlying assets extend to the Bonzo Finance protocol. 4. **Assets only enabled for depositing and borrowing (not usable as collateral) present lower risk for the protocol.** Collateral are the assets of the protocol. To remain solvent, the value of these assets must remain greater than the value of the assets borrowed . Assets which can only be used for borrowing should always be excessively backed by other collateralized assets. 5. **Having volume from a wide range of supported assets in lending pools reduces risk via diversification benefits.** When adding an asset to the Bonzo Finance protocol, significant controls are required to ensure the asset will add more value than risk. Only assets associated with long-term worthy projects, which have significant community support, are considered. The asset risk methodology framework explores whether an asset represents a reasonable amount of risk for the protocol, while calibrating the asset's risk parameters to mitigate those risks. In the context of the Hedera ecosystem, Bonzo Finance must also consider the unique characteristics of the network and its tokens issued via the Hedera Token Service (HTS). These assets, native to the Hedera network, have different risk profiles compared to EVM ERC-20 smart contract based tokens typical of other networks. The asset risk methodology framework carefully evaluates risk associated with each HTS token prior to its integration into the protocol. The high throughput and low latency of the Hedera network may impact the way currency risks are assessed and managed, relative to operations on alternative networks. Bonzo Finance took these factors into account when designing asset risk quantification criterion and configuring asset risk parameters. [PreviousIntroduction](https://docs.bonzo.finance/bonzo-risk-framework) [NextLedger Works](https://docs.bonzo.finance/bonzo-risk-framework/asset-risk/ledger-works) Last updated 1 year ago --- # Historical Utilization | Risk Framework [](https://docs.bonzo.finance/bonzo-risk-framework/liquidity-risk/historical-utilization#introduction-to-utilization-rate) Introduction to Utilization Rate ---------------------------------------------------------------------------------------------------------------------------------------------------------------- Each currency reserve in Bonzo Finance is characterized by its utilization rate UUU: U\=TotalBorrowsTotalLiquidityU = \\frac{\\text{TotalBorrows}}{\\text{TotalLiquidity}}U\=TotalLiquidityTotalBorrows​ The utilization rate monitors what proportion of the reserve's total capital is borrowed at any given time. [](https://docs.bonzo.finance/bonzo-risk-framework/liquidity-risk/historical-utilization#balancing-risks-and-benefits-of-utilization) Balancing Risks & Benefits of Utilization ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ As UUU approaches 100%, the available capital becomes increasingly scarce until no more liquidity is available upon U\=100%U = 100\\%U\=100%. This situation can be problematic if depositors wish to withdraw their supplied funds, but no liquidity is available. However, high utilization also results in higher returns for depositors. Therefore, it's essential to maximize utilization while safeguarding liquidity. [](https://docs.bonzo.finance/bonzo-risk-framework/liquidity-risk/historical-utilization#interest-rate-model-and-optimal-utilization) Interest Rate Model & Optimal Utilization ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ The interest rate model in Bonzo Finance is calibrated around an optimal utilization rate UoptimalUoptimalUoptimal for each reserve, reflecting the unique market conditions of the Hedera network. Bonzo Finance tracks the historical utilization rate to monitor the risk of liquidity shortages. This analysis is based on the maximum daily utilization, serving as a conservative proxy for liquidity risk. Given that Bonzo Finance is a new protocol on Hedera, the initial analysis will be limited but will grow more comprehensive over time. As Bonzo Finance gathers more data specific to the protocol the Hedera DeFi ecosystem at large, it will provide statistics on the maximum daily utilization for various assets in Bonzo Finance markets. This data will support better understanding: 1. How often full utilization is reached for supported assets 2. Which assets tend to have higher utilization rates 3. How utilization patterns on Hedera differ from other networks This information will be crucial for fine-tuning our interest rate models, setting appropriate risk parameters, and ensuring the overall health of the Bonzo Finance protocol within the Hedera ecosystem. After borrowing has been enabled for at least one quarter, the historical utilization analysis will be made available in the table below. Statistic % of Time \= 100% \- \>95% \- \>90% \- \>80% \- \>50% \- < 25% \- < 10% \- < 5% \- [PreviousIntroduction](https://docs.bonzo.finance/bonzo-risk-framework/liquidity-risk/introduction) [NextBorrow Rate Methodology](https://docs.bonzo.finance/bonzo-risk-framework/liquidity-risk/borrow-rate-methodology) Last updated 1 year ago --- # Borrow Rate Methodology | Risk Framework Bonzo Finance's interest rate strategy is calibrated to manage liquidity risk and optimize utilization on the Hedera network. The borrow interest rates are derived from the Utilization Rate UUU. UUU is an indicator of capital availability in the pool. The interest rate model manages liquidity risk through user incentives: * **When capital is available**: Low interest rates to encourage borrowing. * **When capital is scarce**: High interest rates to encourage loan repayments and additional deposits. [](https://docs.bonzo.finance/bonzo-risk-framework/liquidity-risk/borrow-rate-methodology#interest-rate-model) **Interest Rate Model** ------------------------------------------------------------------------------------------------------------------------------------------- Liquidity risk increases as UUU approaches 100%. To address this, the interest rate curve is split around an optimal utilization rate UoptimalU\_{optimal}Uoptimal​. Before UoptimalU\_{optimal}Uoptimal​, the slope is gentle; after, it rises sharply. The interest rate RtR\_tRt​ follows the model: If U _**Addendum**__: Analysis performed prior to the addition of liquidity to the HBAR/WETH SaucerSwap v2 pool; at current liquidity depth / width, recommended supply cap is 220-230 WETH._ ### [](https://docs.bonzo.finance/bonzo-risk-framework/change-memos/october-2025/onboard-weth-layerzero-oft-to-bonzo-lend#specification-initial-listing-phase-1) Specification (Initial Listing — Phase 1) **Asset:** `wETH (LayerZero OFT on Hedera)` Parameter Recommended Rationale **Enable Borrow** **Yes** Standard for blue-chip collateral; limits via caps. **Enable Collateral** **Yes** ETH-class collateral w/ conservative LTV/LT. **Supply Cap** **225 wETH** Within Re7 “realistic” 35–40 wETH band; sized to ensure profitable liquidations under local DEX depth. **Borrow Cap** **112 wETH** 50% of Supply Cap to limit borrow-driven sell pressure in shallow markets. **LTV** **70%** Below Aave’s typical ~80% to reflect Hedera liquidity/bridge risk. **Liquidation Threshold (LT)** **75%** 5% gap vs LTV gives reaction time and supports higher LB; wider than some mainnet settings. **Liquidation Bonus (LB)** **7%** Above mainnet norms (~5%) to ensure liquidation profitability in shallower liquidity. **Reserve Factor (RF)** **20%** Above Aave’s common 15% to accrue extra safety reserves in low-liquidity conditions. **Close Factor (CF)** **50%** Industry-standard to prevent full wipes and smooth execution. **Interest Rate Model (Variable)** **Base** 0% **U**_**opt**_ 80% **Slope1** 3.3% **Slope2** 85% Uses well-understood WETH curves observed across Aave v3 markets (0% base; 80% kink; low Slope1 to target U_opt_; high Slope2 to protect tail liquidity). > **Note on cap sizing:** _Analysis report was performed prior to the addition of liquidity to the HBAR/WETH SaucerSwap v2 pool; at current liquidity depth / width, recommended supply cap from Re7 is 220-230 WETH;_ _**225 wETH**_ _is selected to balance utility with liquidation success given a 7% LB._ [](https://docs.bonzo.finance/bonzo-risk-framework/change-memos/october-2025/onboard-weth-layerzero-oft-to-bonzo-lend#impact-and-rationale) Impact & Rationale ------------------------------------------------------------------------------------------------------------------------------------------------------------------- ### [](https://docs.bonzo.finance/bonzo-risk-framework/change-memos/october-2025/onboard-weth-layerzero-oft-to-bonzo-lend#why-these-levels-now) **Why these levels now** * **Liquidation feasibility first:** With LT 75%, LB 7%, CF 50%, worst-case unwinds remain profitable for liquidators under modeled price impact bands, reducing bad-debt risk if markets gap. * **Conservative vs. Aave:** Aave’s WETH often sits around LTV ≈ 80/LT ≈ 82.5 with LB ≈ 5%; Bonzo starts at 70/75/10 to account for Hedera liquidity and OFT bridge risks, then ratchets up as liquidity deepens. * **IR curve choice:** 0% base, U_opt_ 80%, and modest Slope1 (3.3%) encourage healthy utilization without inducing rate spikes; Slope2 85% sharply disincentivizes >80% utilization, preserving on-chain liquidity for liquidations. ### [](https://docs.bonzo.finance/bonzo-risk-framework/change-memos/october-2025/onboard-weth-layerzero-oft-to-bonzo-lend#bridge-oft-risk-notes) **Bridge/OFT risk notes** * Listing an OFT-bridged wETH introduces messaging/DVN trust assumptions; therefore, caps and RF are higher than mainnet peers, and monitoring (below) is mandated. [](https://docs.bonzo.finance/bonzo-risk-framework/change-memos/october-2025/onboard-weth-layerzero-oft-to-bonzo-lend#monitoring-triggers-and-next-steps) Monitoring, Triggers & Next Steps ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ ### [](https://docs.bonzo.finance/bonzo-risk-framework/change-memos/october-2025/onboard-weth-layerzero-oft-to-bonzo-lend#operational-monitoring-weekly-and-on-10-price-moves) Operational monitoring (weekly and on 10% price moves) * **Dex Depth Check:** Track SaucerSwap WETH/HBAR active liquidity and effective swap impact bands; revisit caps if active liquidity falls materially. * **Utilization & Rates:** If wETH utilization persistently >85% or <30% for 3+ days, consider Slope1/U_opt_ nudges (industry precedent). * **Bridge/DVN Health:** Track LayerZero incident advisories and DVN composition changes; pause increases or reduce caps on adverse signals. * **DEX liquidity deterioration:** 14-day average active WETH liquidity down >40% versus today’s baseline. * **Volatility shock:** 24h WETH/HBAR move >20% or repeated >10% shocks over 72h (per Re7 tail analysis). * **Bridge risk elevation:** Verified DVN/endpoint incident or materially increased trust assumptions. ### [](https://docs.bonzo.finance/bonzo-risk-framework/change-memos/october-2025/onboard-weth-layerzero-oft-to-bonzo-lend#phase-up-plan-subject-to-passing-all-guardrails-for-2-consecutive-weeks) **Phase-up plan (subject to passing all guardrails for ≥2 consecutive weeks)** * **Step 1:** Supply Cap 50 wETH, Borrow Cap 30 wETH (unchanged LTV/LT/LB/RF/CF). * **Step 2:** If local depth materially increases (or Bonzo LP boosts are deployed), consider LTV 75%, LT 80%, LB 6% (approaching mainnet norms), with independent memo and stress test. [](https://docs.bonzo.finance/bonzo-risk-framework/change-memos/october-2025/onboard-weth-layerzero-oft-to-bonzo-lend#implementation) Implementation --------------------------------------------------------------------------------------------------------------------------------------------------------- * Configure wETH (LayerZero OFT) with the Phase 1 parameters above. * Announce listing + parameters in Bonzo docs / interface. * Begin monitoring loop (weekly + on 10% price moves). * Prepare follow-up memo for any cap increases or LTV/LT/LB adjustments post-stabilization period (≥2 weeks). [](https://docs.bonzo.finance/bonzo-risk-framework/change-memos/october-2025/onboard-weth-layerzero-oft-to-bonzo-lend#appendix-parameter-sources-and-industry-references) Appendix — Parameter Sources & Industry References --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- * **Re7 Labs:** **WETH Risk Parameters for Bonzo Lend** (Oct 2024) — liquidity analysis, cap bands, and recommended settings. 753KB [WETH Risk Parameters for Bonzo - Oct 24.pdf](https://2639038200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRl3dkXEKv1yqGhH70g65%2Fuploads%2FOxIUnwEkuLuHbHv0cdfj%2FWETH%20Risk%20Parameters%20for%20Bonzo%20-%20Oct%2024.pdf?alt=media&token=8cd7eb27-d18b-49ed-a2c4-e48bbf0da156) PDF Download[Open](https://2639038200-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRl3dkXEKv1yqGhH70g65%2Fuploads%2FOxIUnwEkuLuHbHv0cdfj%2FWETH%20Risk%20Parameters%20for%20Bonzo%20-%20Oct%2024.pdf?alt=media&token=8cd7eb27-d18b-49ed-a2c4-e48bbf0da156) * **Aave references (comparables / norms):** parameters & governance threads on LTV/LT/LB/RF/IR curves ([1](https://governance.aave.com/t/arfc-aave-v3-deployment-on-base/13708) , [2](https://aave.com/docs/resources/parameters) , [3](https://aave.com/docs/developers/smart-contracts/interest-rate-strategy) , [4](https://governance.aave.com/t/gauntlet-interest-rate-recommendations-for-weth-and-wmatic-on-v2-and-v3/14588) ) * Close factor conventions & liquidation literature. * LayerZero OFT / DVN risk background. [PreviousOctober 2025](https://docs.bonzo.finance/bonzo-risk-framework/change-memos/october-2025) [NextIntroduction](https://docs.bonzo.finance/bonzo-risk-framework/audits-and-analysis/introduction) Last updated 10 days ago ---