Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merge develop #74

Merged
merged 2 commits into from
Oct 8, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
40 changes: 14 additions & 26 deletions docs/concepts/guide/02-earn.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
id: earn
title: Earn
title: Earn
sidebar_position: 2
sidebar_class_name: hidden
---
Expand All @@ -11,87 +11,75 @@ There are several yield strategies with different underlying tokens and APR (Ann

![alt](/content/strategy_nsdai/strategy_nsdai.png)

**APR is the percentage of assets you will earn on your deposit after a year**. If you want to deposit $100 of a certain token in a strategy, if APR is 10% average you'll earn $10 after a year.
**APR is the percentage of assets you will earn on your deposit after a year**. If you want to deposit $100 of a certain token in a strategy, if APR is 10% average you'll earn $10 after a year.


**APR is not fixed**. APR can change based on several factor such as market condition or the net asset value of the L1 strategy.
**APR is not fixed**. APR can change based on several factor such as market condition or the net asset value of the L1 strategy.

**Here's an APR breakdown of the nsDAI strategy**

![alt](/content/strategy_nsdai/apr_breakdown.png)

1. **Base**: Represents default strategy yield that auto-compounds daily. We take a 20% performance fee. The APRs displayed are what you actually receive, as our performance fee has already been accounted for.
1. **Base**: Represents default strategy yield that auto-compounds daily. We take a 20% performance fee. The APRs displayed are what you actually receive, as our performance fee has already been accounted for.
2. **Boost**: Represents incentives provided by the Nimbora team using the [Starknet Catalyst grant](https://medium.com/@Nimbora/nimbora-and-starknet-catalyst-program-14cc7f2f1ab5) that are claimable every week at the [rewards page](https://app.nimbora.io/rewards/).
3. **Incentives**: Represents incentives 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 week at the [rewards page](https://app.nimbora.io/rewards/).
4. **Extra: Ekubo LP** Providing Nimbora yield bearing tokens as liquidity on Ekubo is tracked and added to the total claimable STRK amount at the [rewards page](https://app.nimbora.io/rewards/).


**Underlying protocols**. Underlying protocols linked to the strategy are displayed, you can choose the one you are the most comfortable with.
**Underlying protocols**. Underlying protocols linked to the strategy are displayed, you can choose the one you are the most comfortable with.

**Underlying token**. The underlying token is the token used to deposit into the strategy, strategy yield bearing token is correlated to the underlying, just providing additional rewards.

**Total value locked**. The total value locked (TVL) is the total amount of assets held in the strategy converted in USD.


Choose the strategy that you want and click on the card for next steps

## How to deposit

Enter the amount you want to deposit or click on the buttons to set a desired percentage of your balance you want to deposit.
Enter the amount you want to deposit or click on the buttons to set a desired percentage of your balance you want to deposit.

![alt](/content/strategy_nsdai/strategy_nsdai_deposit.png)


When you've selected the token amount to deposit, click on "deposit" and follow the prompts on your wallet ([Braavos](https://braavos.app/) or [ArgentX](https://argent.xyz/)) to complete the transaction.

![alt](/content/strategy_nsdai/strategy_nsdai_deposit_wallet.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.
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/strategy_nsdai/strategy_nsdai_deposit_confirm.png)


You can consult all of your recent deposits in the wallet section, your transaction should be here.
You can consult all of your recent deposits in the wallet section, your transaction should be here.

![alt](/content/strategy_nsdai/strategy_nsdai_deposit_recent.png)

And that's it, you should be able to see your balance of Nimbora yield token into the portfolio section or directly into your wallet browser.


And that's it, you should be able to see your balance of Nimbora yield token into the portfolio section or directly into your wallet browser.

## How to request a withdrawal

You can choose between two withdrawal options - Instant and Normal.

![alt](../../../static/content/strategy_nsdai/strategy_nsdai_withdraw_instant.png)


Instant withdrawals factor in the price impact and set slippage.
Instant withdrawals factor in the price impact and set slippage.

![alt](../../../static/content/strategy_nsdai/strategy_nsdai_withdraw_normal.png)


Normal withdrawals are not synchronous such as deposits and take between 24 and 48 hours to be processed.
Normal withdrawals are not synchronous such as deposits and take between 24 and 72 hours to be processed.

Once you have selected the withdraw tab, you will need to decide on the amount you want to withdraw. This could be all or a portion of your assets.

Click on the 'withdraw' button and follow the prompts on your wallet ([Braavos](https://braavos.app/) or [ArgentX](https://argent.xyz/)) to complete the transaction.

![alt](/content/strategy_nsdai/strategy_nsdai_withdraw_wallet.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.
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/strategy_nsdai/strategy_nsdai_withdraw_confirm.png)

You can consult all of your recent deposits in the wallet section, your transaction should be here.
You can consult all of your recent deposits in the wallet section, your transaction should be here.

![alt](/content/strategy_nsdai/strategy_nsdai_withdraw_recent.png)

And that's it, you should see your pending request in the navbar.

![alt](/content/strategy_nsdai/strategy_nsdai_withdraw_pending.png)

Nimbora takes over the task of processing this request. This involves preparing your assets in order to be transferred back to your wallet, a process that is handled entirely behind the scenes to ensure a smooth and efficient operation. Once the request is ready to be claimed, Nimbora relayer will handle it and send it directly into your wallet.

Nimbora takes over the task of processing this request. This involves preparing your assets in order to be transferred back to your wallet, a process that is handled entirely behind the scenes to ensure a smooth and efficient operation. Once the request is ready to be claimed, Nimbora relayer will handle it and send it directly into your wallet.
64 changes: 27 additions & 37 deletions docs/concepts/products/earn/01-strategy-sdai.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,90 +8,79 @@ sidebar_class_name: hidden
**This strategy allows users to leverage their DAI holdings** by depositing them into an sDai vault, which is a specialized financial vehicle. This depositing action allows their DAI to be put to work, generating potential profits over time. The approach combines the security of DAI, a stablecoin, with the revenue-generating power of DeFi strategies. This mechanism is designed to provide users with a more effective way to maximize the potential return on their DAI investments.

### Source of yields

- Maker Protocol fees coming from DAI borrow and treasury earning.

This strategy is straightforward as the logic is very simple: it consists of depositing tokens into DSR to acquire sDai.

![alt](/content/sdai.png)



## Get Started

Visit Nimbora dApp via invite link and connect your Starknet wallet ([Braavos](https://braavos.app/) or [ArgentX](https://argent.xyz/)).



![alt](/content/strategy_nsdai/strategy_nsdai.png)



Enter the amount of ETH you want to deposit, or click on the small buttons below the box (25%, 50%, 75%, 100%) to set a desired percentage of the balance you want to deposit.


Enter the amount you want to deposit or click on the buttons to set a desired percentage of your balance you want to deposit.
Enter the amount you want to deposit or click on the buttons to set a desired percentage of your balance you want to deposit.

![alt](/content/strategy_nsdai/strategy_nsdai_deposit.png)


When you've selected the token amount to deposit, click on "deposit" and follow the prompts on your wallet ([Braavos](https://braavos.app/) or [ArgentX](https://argent.xyz/)) to complete the transaction.

![alt](/content/strategy_nsdai/strategy_nsdai_deposit_wallet.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.
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/strategy_nsdai/strategy_nsdai_deposit_confirm.png)

And that's it, you should be able to see your balance of Nimbora yield token into the portfolio section or directly into your wallet browser.
And that's it, you should be able to see your balance of Nimbora yield token into the portfolio section or directly into your wallet browser.

## Your Earning Starts Immediately!

Your yield comes from several sources -  **nsDAI base yield** + **$STRK** **incentives** + **Nimbora** **boost.**
Your yield comes from several sources -  **nsDAI base yield** + **$STRK** **incentives** + **Nimbora** **boost.**

**Here's an APR breakdown of the nsDAI strategy**

![alt](/content/strategy_nsdai/apr_breakdown.png)

1. **Base**: Represents default strategy yield that auto-compounds daily. We take a 20% performance fee. The APRs displayed are what you actually receive, as our performance fee has already been accounted for.
1. **Base**: Represents default strategy yield that auto-compounds daily. We take a 20% performance fee. The APRs displayed are what you actually receive, as our performance fee has already been accounted for.
2. **Boost**: Represents incentives provided by the Nimbora team using the [Starknet Catalyst grant](https://medium.com/@Nimbora/nimbora-and-starknet-catalyst-program-14cc7f2f1ab5) that are claimable every week at the [rewards page](https://app.nimbora.io/rewards/).
3. **Incentives**: Represents incentives 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 week at the [rewards page](https://app.nimbora.io/rewards/).
4. **Extra: Ekubo LP** Providing Nimbora yield bearing tokens as liquidity on Ekubo is tracked and added to the total claimable STRK amount at the [rewards page](https://app.nimbora.io/rewards/).


## How to request a withdrawal

You can choose between two withdrawal options - Instant and Normal.

![alt](../../../../static/content/strategy_nsdai/strategy_nsdai_withdraw_instant.png)

Instant withdrawals factor in the price impact and set slippage.
Instant withdrawals factor in the price impact and set slippage.

![alt](../../../../static/content/strategy_nsdai/strategy_nsdai_withdraw_normal.png)


Normal withdrawals are not synchronous such as deposits and take between 24 and 48 hours to be processed.
Normal withdrawals are not synchronous such as deposits and take between 24 and 72 hours to be processed.

Once you have selected the withdraw tab, you will need to decide on the amount you want to withdraw. This could be all or a portion of your assets.

Click on the 'withdraw' button and follow the prompts on your wallet ([Braavos](https://braavos.app/) or [ArgentX](https://argent.xyz/)) to complete the transaction.

![alt](/content/strategy_nsdai/strategy_nsdai_withdraw_wallet.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.
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/strategy_nsdai/strategy_nsdai_withdraw_confirm.png)

And that's it, you should see your pending request in the navbar.

![alt](/content/strategy_nsdai/strategy_nsdai_withdraw_pending.png)

You can consult all of your recent transactions in the wallet section. Your transaction should be here.
You can consult all of your recent transactions in the wallet section. Your transaction should be here.

![alt](/content/strategy_nsdai/strategy_nsdai_withdraw_recent.png)

Nimbora takes over the task of processing this request. This involves preparing your assets in order to be transferred back to your wallet, a process that is handled entirely behind the scenes to ensure a smooth and efficient operation. Once the request is ready to be claimed, Nimbora relayer will handle it and send it directly into your wallet.
Nimbora takes over the task of processing this request. This involves preparing your assets in order to be transferred back to your wallet, a process that is handled entirely behind the scenes to ensure a smooth and efficient operation. Once the request is ready to be claimed, Nimbora relayer will handle it and send it directly into your wallet.

### What is sDAI

Expand Down Expand Up @@ -139,44 +128,45 @@ Nimbora takes over the task of processing this request. This involves preparing

- The Multi Collateral Dai (MCD) update expands collateral options to include various Ethereum-based assets, contingent on approval by MKR holders.

- This enhancement introduces new features to the protocol, promoting broader asset acceptance and flexibility.
- This enhancement introduces new features to the protocol, promoting broader asset acceptance and flexibility.

- More about Maker:
- [Website](https://makerdao.com/en/)
- [Docs](https://docs.makerdao.com/)
- [MakerDAO on Twitter](https://twitter.com/MakerDAO)



### Understanding Risks Associated with SDAI

1. **Smart Contract Risk**:
- sDAI, like other DeFi protocols, is susceptible to exploits, including smart contract vulnerabilities and malicious attacks.

- sDAI, like other DeFi protocols, is susceptible to exploits, including smart contract vulnerabilities and malicious attacks.

2. **Regulatory Risks**:
- MakerDAO's shift towards RWA-based collateral introduces regulatory uncertainty due to its decentralized nature.
- Increased reliance on RWAs may lead to compliance challenges and potential regulatory gaps.

- MakerDAO's shift towards RWA-based collateral introduces regulatory uncertainty due to its decentralized nature.
- Increased reliance on RWAs may lead to compliance challenges and potential regulatory gaps.

3. **Collateral Risks**:
- RWAs' default risks may result in collateral shortfalls, jeopardizing the 1:1 USD peg of sDAI.
- Fluctuations in the DAI Savings Rate (DSR) could strain liquidity buffers if significant amounts of sDAI are minted or burned abruptly.
- RWAs' sensitivity to interest rate fluctuations may lead to losses if redemptions are required before maturity.

- RWAs' default risks may result in collateral shortfalls, jeopardizing the 1:1 USD peg of sDAI.
- Fluctuations in the DAI Savings Rate (DSR) could strain liquidity buffers if significant amounts of sDAI are minted or burned abruptly.
- RWAs' sensitivity to interest rate fluctuations may lead to losses if redemptions are required before maturity.

4. **Collateral Risks**:
- MakerDAO's engagement with multiple counterparties exposes it to credit risks such as liquidity, reputation, and settlement challenges.

- MakerDAO's engagement with multiple counterparties exposes it to credit risks such as liquidity, reputation, and settlement challenges.

5. **Centralization and Transparency Risks**:
- Pursuing additional returns through RWAs may increase centralization within MakerDAO.
- Onboarding RWAs reduces transparency compared to on-chain crypto assets, posing transparency risks.
- Pursuing additional returns through RWAs may increase centralization within MakerDAO.
- Onboarding RWAs reduces transparency compared to on-chain crypto assets, posing transparency risks.

### Stay Tuned for Upgrades

Keep an eye on our updates as we roll out new features and advanced strategies to enhance your earning potential.

**Join our [Discord](http://discord.gg/nimbora) for alpha and early notifications 🚀**

[![Nimbora Discord](../../../../static/content/stategy_sstrk/Discord.png)](https://discord.gg/nimbora)

[![Nimbora Discord](../../../../static/content/stategy_sstrk/Discord.png)](https://discord.gg/nimbora)

Stay tuned for updates as we continue to bring more 1-click yield strategies to life. Follow [Nimbora on X](https://x.com/Nimbora_) (Twitter) or [Medium](https://medium.com/@Nimbora).

Expand All @@ -198,4 +188,4 @@ Nimbora is a Starknet-based omnichain 1-click yield strategies platform that ena

🐧🗞️ [Docs](https://docs.nimbora.io/)

🐧🛡 [Audit](https://github.com/0xSpaceShard/nimbora_audit_report_yield_dex/blob/main/Nimbora%20Audit%20Report.pdf)
🐧🛡 [Audit](https://github.com/0xSpaceShard/nimbora_audit_report_yield_dex/blob/main/Nimbora%20Audit%20Report.pdf)
Loading
Loading