diff --git a/docs/concepts/guide/03-borrow.md b/docs/concepts/guide/03-borrow.md deleted file mode 100644 index 5eb9841..0000000 --- a/docs/concepts/guide/03-borrow.md +++ /dev/null @@ -1,82 +0,0 @@ ---- -id: borrow -title: Borrow -sidebar_position: 3 ---- -**Liquity strategy allows users to borrow LUSD**, a stablecoin pegged to the U.S. dollar, using ETH as collateral. This strategy is beneficial for users who want to leverage their assets without selling them. If ETH value goes up while the loan is active, repaying it becomes more profitable as users get back their ETH, now more valuable. On top of this, participating in this strategy now comes with a bonus: a ~29% APR in STRK tokens, provided by the Starknet Foundation as a part of the [DeFi Spring 2.0](https://medium.com/@Nimbora/introducing-defi-spring-2-0-bigger-bolder-better-364bb96b02d6) that are claimable every two weeks. - - -## Understanding the Borrow Section - -There are 2 cards (troves) with 2 different TCR (total collateral ratio). The CR is not fixed, as its value is pegged to the ETH price. That is why the screenshot below might not match the current numbers you will see once you open the troves. - -![Untitled](/content/borrow.png) - -**TCR is the percentage of assets you need to lock up as collateral when borrowing**. If you want to borrow $100 and the TCR is 676%, you must provide $676 worth of assets as collateral. - -Lets take as an example this image above - trove 604 TCR will require **less collateral** compared to Trove 910 CR, but Trove 910 TCR is **more secure** than Trove 604 . - -Consider this scenario: if all troves were open when the ETH price was at $1600, Trove 910 would have a higher tolerance for price fluctuations compared to Trove 604, allowing it to withstand a more significant drop in ETH price before facing liquidation. - -Once the collateral is deposited and locked, users can borrow against it according to the platform's loan-to-value ratio. If the value of the collateral falls below certain thresholds, the system may automatically liquidate the assets to repay the loan. - - -### **Which trove should you select?** - -This depends on how much LUSD you want to borrow and ongoing initiatives. - -The left trove offers a unique opportunity for users to borrow with minimal transaction costs, subsidized by the [Nimbora x Liquity](https://medium.com/@Nimbora/defi-spring-just-got-better-earn-strk-with-nimbora-x-liquity-d7e881f22c38) collaboration. - -## How to borrow - - -Enter the amount you want to supply or click on the buttons to set a desired percentage of your balance you want to deposit. You can also directly enter the amount of LUSD you want to borrow, both fields can be used. - - -![alt](/content/hborrow.png) - -Finally, when you've selected the amount, click on "borrow" and follow the prompts on your wallet (Argent or Braavos) to complete the transaction. - - -![alt](/content/rborrow.png) - - -Once the transaction has been accepted on the network, a popup will appear at the bottom right of the screen to let you know. - -![alt](/content/fborrow.png) - -You can consult all of your recent borrow in the wallet sections, your transaction should be here. - -![alt](/content/cborrow.png) - -And that's it, your borrow request has been sent, you can see it in pending orders section. - -![alt](/content/pborrow.png) - -Borrow should be processed within a day, LUSD will be directly sent to your wallet. - - -## Repay the Loan - -First, you need to decide on the amount you want to repay. This could be all of your debt or only a portion of it. - -![alt](/content/hrepay.png) - -Once you've made up your mind, locate and click on the 'repay' button and follow the prompts on your wallet (Argent or Braavos) to complete the transaction. - -![alt](/content/rrepay.png) - -Once the transaction has been accepted on the network, a popup will appear at the bottom right of the screen to let you know. - -![alt](/content/frepay.png) - -You can consult all of your recent repays in the wallet sections, your transaction should be here. - -![alt](/content/crepay.png) - -And that's it, your repay request has been sent, you can see it in pending orders section. - -![alt](/content/prepay.png) - -Repay should be processed within a day, ETH will be directly sent to your wallet. - diff --git a/docs/concepts/guide/04-points.md b/docs/concepts/guide/03-points.md similarity index 78% rename from docs/concepts/guide/04-points.md rename to docs/concepts/guide/03-points.md index e071ce5..0dd9c6c 100644 --- a/docs/concepts/guide/04-points.md +++ b/docs/concepts/guide/03-points.md @@ -1,12 +1,10 @@ --- id: points title: Points -sidebar_position: 4 +sidebar_position: 3 --- ## What are Nimbora Points?[](https://docs.nimbora.io/docs/concepts/guide/points#what-are-crypto-points) -![Untitled](https://i.ibb.co/LzNKDpn/Untitled-27.png) - Nimbora points are designed to incentivize and reward users for actively engaging with our platform. These points serve as a metric for off-chain measuring user activity and contribution within the Nimbora ecosystem, providing rewards based on participation levels. ### Key Features of Nimbora Points:[](https://docs.nimbora.io/docs/concepts/guide/points#key-features-of-crypto-points) @@ -17,10 +15,8 @@ Nimbora points are designed to incentivize and reward users for actively engagin ### Types of Nimbora Points: [](https://docs.nimbora.io/docs/concepts/guide/points#types-of-crypto-points) -![Untitled](https://i.ibb.co/qDFcNpc/Untitled-28.png) - **Earn Points**: Earn points for depositing assets to any of our earn strategies. -- **Borrow Points**: Earn points for borrowing LUSD against ETH in our borrow module. - **Referral Points**: Earn a fraction of the points your referrals and their invitees make. - **Rank Points**: Earn extra points based on your leaderboard position, with the top performers having higher earning rate. @@ -45,20 +41,6 @@ The median daily price sourced from Pragma oracles (if not stablecoin) is utiliz | 3 | 3000 | 3400 | 3400 | | / | Total points | | 9600 | -### Borrow[](https://docs.nimbora.io/docs/concepts/guide/points#borrow) - -The borrow points are calculated based on the daily user collateral `ETH` deposited in all Liquity troves. - -![Untitled](https://i.ibb.co/tby62s0/Untitled-32.png) - -We use the ETH median daily price fetched from Pragma oracles to calculate the pts. - -| Day | User’s daily ETH collateral balance | ETH price USD | Earn points | -| --- | --- | --- | --- | -| 1 | 1 | 3000 | 3000 | -| 2 | 0.5 | 3200 | 1600 | -| 3 | 0 | 2800 | 0 | -| / | total points earn | | 4600 | ### Referral @@ -116,7 +98,6 @@ The following table was calculated using boosted balances. Rank points represent extra points earned based on your leaderboard position, with the top performers having higher earning rate. -![Untitled](https://i.ibb.co/3TSwx37/Screenshot-550.png) This table represents points bonus based on the leaderboard position: | Leaderboard | Boost % | @@ -127,14 +108,15 @@ This table represents points bonus based on the leaderboard position: | 501-1000 | 5% | | 1001+ | 0% | -This table represents points breakdown with the Rank points taken into the account: +This table represents points breakdown with the Rank points taken into account: + +| Leaderboard | Earn points | Referral points | % boost | Rank points | Total | +| --- | --- | --- | --- | --- | --- | +| 1-50 | 100 | 50 | 20% | 30 | 180 | +| 51-150 | 80 | 0 | 15% | 12 | 92 | +| 151-500| 70 | 10 | 10% | 8 | 88 | +| 501-1000| 30 | 0 | 5% | 2 | 32 | +| 1001+ | 30 | 0 | 0% | 0 | 30 | -| Leaderboard | Earn points | Borrow points | Referral points | % boost | Rank points | Total | -| --- | --- | --- | --- | --- | --- | --- | -| 1-50 | 100 | 50 | 50 | 20% | 40 | 240 | -| 51-150 | 80 | 20 | 0 | 15% | 15 | 115 | -| 151-500 | 70 | 0 | 10 | 10% | 8 | 88 | -| 501-1000 | 30 | 10 | 0 | 5% | 2 | 42 | -| 1001+ | 30 | 5 | 0 | 0% | 0 | 35 | `Info: When users have the same points the register timestamp is used to order them.` \ No newline at end of file diff --git a/docs/concepts/guide/05-referral.md b/docs/concepts/guide/04-referral.md similarity index 92% rename from docs/concepts/guide/05-referral.md rename to docs/concepts/guide/04-referral.md index ca27e53..d2ea012 100644 --- a/docs/concepts/guide/05-referral.md +++ b/docs/concepts/guide/04-referral.md @@ -1,7 +1,7 @@ --- id: referrals title: Referrals -sidebar_position: 5 +sidebar_position: 4 --- ## The Nimbora Affiliation Program @@ -38,14 +38,11 @@ You can [join our Discord](https://discord.gg/nimbora) and ask for an invite in 1. Head to the app points section: [Nimbora Points](https://app.nimbora.io/points/) 2. Find the box labeled "Refer a Friend." - - ![Refer a Friend](/content/ref.png) - 3. Click the copy button to get your referral link, or directly click the X icon to share it with your community instantly. You can customize the tweet as you like. ### Benefits -Before calculating the referral points for each user, a boost is applied to the on-chain user's points (borrow + earn). By default, the boost is 10%, but some users who use partner links (boosted links) can receive a higher boost. +Before calculating the referral points for each user, a boost is applied to the on-chain user's points. By default, the boost is 10%, but some users who use partner links (boosted links) can receive a higher boost. For more details, check the [points section](/docs/concepts/guide/points). diff --git a/docs/concepts/products/borrow/01-strategy-lusd.md b/docs/concepts/products/borrow/01-strategy-lusd.md deleted file mode 100644 index 94f6c48..0000000 --- a/docs/concepts/products/borrow/01-strategy-lusd.md +++ /dev/null @@ -1,136 +0,0 @@ ---- -id: liquity -title: Liquity Strategy -sidebar_position: 1 ---- - -**Liquity strategy allows users to borrow LUSD**, a stablecoin pegged to the U.S. dollar, using ETH as collateral. This strategy is beneficial for users who want to leverage their assets without selling them. If ETH value goes up while the loan is active, repaying it becomes more profitable as users get back their ETH, now more valuable. On top of this, participating in this strategy now comes with a bonus: a ~11 APR in STRK tokens, provided by the Starknet Foundation as a part of the [DeFi Spring 2.0](https://medium.com/@Nimbora/introducing-defi-spring-2-0-bigger-bolder-better-364bb96b02d6) that are claimable every two weeks. - - -## Understanding the Borrow Section - -There's a card (trove) with a CR ratio. **TCR is the percentage of assets you need to lock up as collateral when borrowing**. If you want to borrow $100 and the TCR is 627%, you must provide $627 worth of assets as collateral. - -CR is not fixed, as its value is pegged to the ETH price. That is why the screenshot below might not match the current numbers you will see once you open the troves. - -![Untitled](/content/borrow.png) - - -Higher CR allows it to withstand a more significant drop in ETH price before facing liquidation. - -Once the collateral is deposited and locked, users can borrow against it according to the platform's loan-to-value ratio. If the value of the collateral falls below certain thresholds, the system may automatically liquidate the assets to repay the loan. - - -## How to borrow - - -Enter the amount you want to supply or click on the buttons to set a desired percentage of your balance you want to deposit. You can also directly enter the amount of LUSD you want to borrow, both fields can be used. - - -![alt](/content/hborrow.png) - -Finally, when you've selected the amount, click on "borrow" and follow the prompts on your wallet (Argent or Braavos) to complete the transaction. - - -![alt](/content/rborrow.png) - - -And that's it, your borrow request has been sent, you can see it in pending orders section. - -![alt](/content/pborrow.png) - -Borrow should be processed within a day, LUSD will be directly sent to your wallet. - - -## Repay the Loan - -First, you need to decide on the amount you want to repay. This could be all of your debt or only a portion of it. - -![alt](/content/hrepay.png) - -Once you've made up your mind, locate and click on the 'repay' button and follow the prompts on your wallet (Argent or Braavos) to complete the transaction. - -![alt](/content/rrepay.png) - -And that's it, your repay request has been sent, you can see it in pending orders section. - -![alt](/content/prepay.png) - -Repay should be processed within a day, ETH will be directly sent to your wallet. - -### What is Liquity? - - -Liquity is an interest-free borrowing protocol on Ethereum. Liquity offers decentralized, interest-free loans in LUSD against Ether collateral, requiring a minimum 110% collateral ratio. - - - Loan security is enhanced by a Stability Pool with LUSD and collective backing from borrowers as ultimate guarantors. - - - The protocol is non-custodial, immutable, and operates without governance. - - - It is highly secure, has several audits, and tops Defi Safety’s security list. - - - Additional resources about Liquity: - - [Website](https://www.liquity.org/) - - [Docs](https://docs.liquity.org/) - - [Analytics](https://dune.com/liquity/liquity) - - [Liquity on Twittter](https://twitter.com/LiquityProtocol) - -### What is LUSD - -- LUSD is a stablecoin pegged to the US Dollar. It serves as the payment medium for loans in the Liquity protocol, offering redemption against collateral at face value. - - - LUSD can be only minted against ETH, making it very resilient and independent of any centralized parties. Due to this it is a very popular treasury asset, but also across protocols and LP pools on mainnet and many L2’s. - - - Additional resources about [LUSD](https://docs.liquity.org/faq/general#what-are-lusd-and-lqty) - -### What is the LUSD contract on Starknet - -- LUSD contract on Starknet is: 0x070a76fd48ca0ef910631754d77dd822147fe98a569b826ec85e3c33fde586ac - - - All official Liquity contracts can be found [here](https://docs.liquity.org/documentation/resources#contract-addresses). - -### How frequently are borrows processed? - -- Borrow takes a day to be processed. - -### Do I really pay no interests on Liquity? - - - Yes, really! Liquity charges no interest, ever. - - - You pay only a one-off fee when opening the loan. This fee is almost always 0.50% but can go slightly higher at times. Read more about it [here](https://docs.liquity.org/faq/borrowing). - -### I don’t have enough LUSD to pay my debt, what can I do? - - - If you don’t have enough LUSD in your account you can use the [Starkgate](https://starkgate.starknet.io/) bridge to bridge the LUSD amount required to pay your debt and get back your collateral. - - - -### Understanding Risks Associated with Liquity - -1. **Smart Contract Risk**: - - Liquity, like any other DeFi protocol, is vulnerable to smart contract exploits. Despite efforts to audit and secure the smart contracts, there remains a risk of undiscovered vulnerabilities. Exploits can lead to loss of funds or manipulation of the protocol. - -2. **Liquidation Risk**: - - When users create a trove in Liquity, they must maintain a collateral ratio of at least 110%. Troves that fall below this threshold are subject to liquidation. - -**Process**: - 1. **Stability Pool Usage**: The system uses funds from the Stability Pool to cancel the debt of undercollateralized troves. - 2. **Redistribution Mechanism**: If the Stability Pool lacks sufficient funds, a redistribution mechanism is activated, spreading the debt and collateral of liquidated troves among all trove holders. - -**Penalty**: -Users facing liquidation may incur a penalty of up to 10%, which incentivizes them to maintain a safe collateral ratio. - - -3. **Redemption Risk**: - - Liquity allows direct redemption of LUSD stablecoins for the underlying collateral, Ether. This process carries certain risks for borrowers. - -**Process**: - 1. **Debt Cancellation**: Redeeming LUSD cancels debt from the riskiest trove in the system, i.e., the trove with the lowest collateral ratio. - 2. **Collateral Transfer**: The redeemer receives a corresponding amount of Ether from the trove used for debt cancellation. - -**Impact**: -Redemptions reduce the borrower's leverage and increase the overall collateral ratio of the system. While there's no additional penalty for borrowers, redemptions can lead to collateral loss and deleveraging of positions. - - -### Vigilant Surveillance: - -In the realm of Nimbora, your trove's collateralization ratio is closely monitored by the protocol itself. While you can't directly alter this ratio, rest assured that Nimbora diligently adjusts the risk levels to safeguard against potential liquidations or redemptions. \ No newline at end of file diff --git a/docs/concepts/products/borrow/_category_.json b/docs/concepts/products/borrow/_category_.json deleted file mode 100644 index d693925..0000000 --- a/docs/concepts/products/borrow/_category_.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "label": "Borrow", - "position": 2, - "collapsed": false -} \ No newline at end of file diff --git a/docs/concepts/products/products.md b/docs/concepts/products/products.md index 523a6b4..fc196ba 100644 --- a/docs/concepts/products/products.md +++ b/docs/concepts/products/products.md @@ -17,11 +17,3 @@ Explore carefully curated yield opportunities from Ethereum, now accessible on S - **Modular Integration:** Easily add new strategies with 60-200 lines of Solidity code. - **Standardized Tokens:** Nimbora yield tokens adhere to the 4626 standard for seamless integration. - **User-Friendly:** Integrate Ethereum yields into your Starknet apps effortlessly using our powerful SDK. - -## Borrow: Low-Cost, Better Rates - -Experience the benefits of low-gas transactions and rapid execution with Nimbora's borrowing solutions: - -- **Low-Gas Transactions:** The gas costs for L1 transactions are distributed among participants. -- **Fast Execution:** Borrowing and repayment orders are executed daily for optimal efficiency. -- **Competitive Borrow Rates:** Discover better borrowing rates on Ethereum to enhance investment strategies. diff --git a/src/pages/index.js b/src/pages/index.js index 2b97fa0..2fd7147 100644 --- a/src/pages/index.js +++ b/src/pages/index.js @@ -20,7 +20,7 @@ export const actions = [ title: 'What is Nimbora', icon: HelpCircle, to: '/docs/concepts/introduction', - text: 'Explore protocol concepts and follow our guides to earn and borrow with Nimbora.', + text: 'Explore protocol concepts and follow our guides to earn with Nimbora.', image: Spacebbit }, { @@ -58,11 +58,7 @@ export const dAppGuides = [ ] export const strategyGuides = [ - { - title: 'Borrow Strategy', - to: '/docs/concepts/guide/borrow', - text: 'Learn how to borrow LUSD', - }, + { title: 'Earn Strategy', to: '/docs/concepts/guide/earn',