From cf56c7a3a18eab4cd096815cea5cbf80fedb0529 Mon Sep 17 00:00:00 2001 From: Vuk Tanaskovic Date: Fri, 31 May 2024 19:11:28 +0200 Subject: [PATCH 1/4] getting started and point updates --- docs/concepts/guide/01-first-steps.md | 30 ++++-- docs/concepts/guide/04-points.md | 143 +++++++++++--------------- 2 files changed, 78 insertions(+), 95 deletions(-) diff --git a/docs/concepts/guide/01-first-steps.md b/docs/concepts/guide/01-first-steps.md index 05de335..33f0625 100644 --- a/docs/concepts/guide/01-first-steps.md +++ b/docs/concepts/guide/01-first-steps.md @@ -4,26 +4,36 @@ title: First Steps sidebar_position: 1 --- -## Getting Started on Starknet +## Getting Started on Starknet[](https://docs.nimbora.io/docs/concepts/guide/first_steps#getting-started-on-starknet) -The first step consists of installing Starknet wallets and bridging funds to your account. The entire setup process is explained in detail [here](https://www.starknet.io/en/content/getting-started-using-starknet-setting-up-a-starknet-wallet). +1. The first step is installing a Starknet wallet( [Braavos](https://braavos.app/) or [ArgentX](https://argent.xyz/)). +2. Deposit funds (ETH on Starknet for starters) to your account. +3. To interact with Starknet dApps, you will need to deploy your account. +The process can be done with the following steps: -## Connect to Nimbora +1. Deposit ETH on Starknet to your wallet address. +2. Send ETH to your own or external address. +3. Your wallet will be ready to use as soon as the transaction is processed. -The process begins by visiting the Nimbora platform at https://app.nimbora.io/ +The entire setup process, including bridging of the funds is explained in detail [here](https://www.starknet.io/en/content/getting-started-using-starknet-setting-up-a-starknet-wallet). -Click “**Connect Wallet**” in the top right corner +## Getting started with Nimbora -![Untitled](https://i.imgur.com/SaXJ9qq.png) +Launch Nimbora at https://app.nimbora.io/. + +Nimbora is in alpha stage, so you will need a referral code to access the dApp. +![Untitled](https://i.ibb.co/J5mnmTv/Screenshot-549.png) -Select one of the two available wallet options ([Braavos](https://braavos.app/) or [ArgentX](https://argent.xyz/)) +You can [join our Discord](https://www.notion.so/Nimbora-MKT-Dashboard-e5cd8af2cd214955b1067075b3888c28?pvs=21) and ask for an invite in the #invites channel. -![Untitled](https://i.imgur.com/pwjsKxV.png) +Once you’ve secured the invite, click “Connect Wallet” in the top right corner. + +![Untitled](https://i.imgur.com/SaXJ9qq.png) -For the sake of this tutorial we will be using **Argent X** wallet extension. +Select one of the available wallet options ([Braavos](https://braavos.app/) or [ArgentX](https://argent.xyz/)) -![Untitled](https://i.imgur.com/517pTc6.png) +![Untitled](https://i.ibb.co/ftRGfGr/Screenshot-548.png) Follow the notification prompt and click on “**Connect**” diff --git a/docs/concepts/guide/04-points.md b/docs/concepts/guide/04-points.md index 6d93d60..8cd12f7 100644 --- a/docs/concepts/guide/04-points.md +++ b/docs/concepts/guide/04-points.md @@ -3,68 +3,83 @@ id: points title: Points sidebar_position: 4 --- +## 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) -## What are Crypto Points? +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. -**Crypto points**, within the context of Nimbora Protocol, are digital units 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 insights and rewards based on participation levels. +### Key Features of Nimbora Points:[](https://docs.nimbora.io/docs/concepts/guide/points#key-features-of-crypto-points) +1. **Incentivization**: Points encourage participation and engagement by rewarding users for their contributions to the Nimbora ecosystem. These contributions may include providing liquidity (borrow and yield strategies) or promoting adoption (referrals) +2. **Utility**: Beyond their monetary value, Nimbora points will offer utility within the Nimbora ecosystem. Users will be able to utilize these tokens to access premium features and get additional rewards. -### Key Features of Crypto Points: +### Types of Nimbora Points: +[](https://docs.nimbora.io/docs/concepts/guide/points#types-of-crypto-points) -1. **Incentivization**: Crypto points encourage participation and engagement by rewarding users for their contributions to the Nimbora ecosystem. These contributions may include providing liquidity or promoting adoption. +![Untitled](https://i.ibb.co/qDFcNpc/Untitled-28.png) -2. **Utility**: Beyond their monetary value, crypto points offer utility within the Nimbora ecosystem. Users can utilize these tokens to access premium features and get for additional rewards. +- **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. -### Types of Crypto Points: +## How are on-chain points calculated?[](https://docs.nimbora.io/docs/concepts/guide/points#how-are-on-chain-points-calculated) -- **Borrow Points**: Earn points while using borrow strategies. -- **Earn Points**: Earn points while using earn strategies. -- **Rank Points**: Earn points based on your performance. -- **Referral Points**: Earn points by inviting your friends. +### Earn[](https://docs.nimbora.io/docs/concepts/guide/points#earn) -## How are on-chain points calculated? +The earn points are calculated daily based user assets deposited in all earn troves. -### Borrow +**Example**: -The borrow points are calculated based on the daily user collateral `ETH` deposited in all Liquity troves. We use the ETH median daily price fetched from Pragma oracles to calculate the pts. +nsDAI strategy enables users to put their DAI to use. Users participating in the strategy will get nsDAI token - representing `DAI`-equivalent yield-bearing tokens. -| Day | User’s daily ETH collateral balance | ETH price USD | earn pts | -| --- | --- | --- | --- | -| 1 | 1 | 3000 | 3000 | -| 2 | 0.5 | 3200 | 1600 | -| 3 | 0 | 2800 | 0 | -| / | total pts earn | | 4600 | +![Untitled](https://i.ibb.co/12QVsLr/Untitled-29.png) -### Earn +The median daily price sourced from Pragma oracles (if not stablecoin) is utilized in this calculation process. -We employ a similar methodology to calculate the points for Yield DEX strategies. In the nsDai strategy, we determine the points by converting the balance of `DAI`-equivalent yield-bearing tokens. The median daily price sourced from Pragma oracles (if not stablecoin) is utilized in this calculation process. - -| Day | nsDAI balance | USD equivalent | pts earn | +| Day | nsDAI balance | USD equivalent | Points | | --- | --- | --- | --- | | 1 | 3000 | 3000 | 3000 | | 2 | 3000 | 3200 | 3200 | | 3 | 3000 | 3400 | 3400 | -| / | total pts earn | | 9600 | +| / | 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 -Before calculating the referral pts for each user, a boost is applied to the on-chain users pts (borrow + earn). By default, the boost is `10%`, but some users who used 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 users pts (borrow + earn). By default, the boost is `10%`, but strategic partners and users joining through them can receive a higher boost. -The referral pts are calculated based on the referral relation between users. +![Untitled](https://i.ibb.co/Gxj7TsW/Untitled-30.png) + +The referral points are calculated based on the referral relation between users. For example, we have this referral table: -| parent | child | +| Referral | Invited User | | --- | --- | | Alice | Bob | | Alice | Carlo | | Bob | Sarah | | Carlo | Alex | -and this is the daily pts per user +and this is the daily points per user -| User | pts | +| User | Points | | --- | --- | | Alice | 100 | | Bob | 200 | @@ -72,28 +87,20 @@ and this is the daily pts per user | Sarah | 100 | | Alex | 100 | -First, we boost the users’ pts +First, we boost the users’ points -| User | pts | -| --- | --- | -| Alice | 100 | -| Bob | 200 | -| Carlo | 300 | -| Sarah | 100 | -| Alex | 100 | +`referral points = (User points * boost) + (10% Bob + 10% Carlo + 5% Sarah + 5% Alex)` -`referral pts = (User points * boost) + (10% Bob + 10% Carlo + 5% Sarah + 5% Alex)` +Using the boosted points we calculate the referral points. -Using the boosted pts we calculate the referral pts. - -- `Alice` receives: - - `10%` from `Bob` and `Carlo`direct child - - `5%` from `Sarah` and `Alex` first child of a direct child. -- `Bob` receives: - - `10%` from `Sarah` direct child -- `Carlo` receives: - - `10%` from `Alex` direct child -- `Sarah` and `Alex` receive nothing because they don’t have a child. +- `Alice` receives: + - `10%` from `Bob` and `Carlo` direct invitee + - `5%` from `Sarah` and `Alex` first invitee of a direct invitee. +- `Bob` receives: + - `10%` from `Sarah` direct invitee +- `Carlo` receives: + - `10%` from `Alex` direct invitee +- `Sarah` and `Alex` receive nothing haven’t invited anyone. The following table was calculated using boosted balances. @@ -105,42 +112,8 @@ The following table was calculated using boosted balances. | Sarah | - | - | - | - | - | - | | Alex | - | - | - | - | - | - | -### Rank - -This is the user’s total pts - -| User | earn pts | borrow pts | referral pts | total pts | -| --- | --- | --- | --- | --- | -| Alice | 50 | 50 | 87 | 187 | -| Bob | 150 | 50 | 31 | 231 | -| Carlo | 100 | 200 | 41 | 341 | -| Sarah | 80 | 20 | 10 | 110 | -| Alex | 30 | 70 | 10 | 110 | +### Rank[](https://docs.nimbora.io/docs/concepts/guide/points#rank) -Sort the users by total pts ( the following are only examples for more details about prod setup check this [[link](https://www.notion.so/Point-system-Tech-bbaba9b312f4402d842547bb4579a8e4?pvs=21)]) +Rank points represent extra points earned based on your leaderboard position, with the top performers having higher earning rate. -1. The first receives 20% boost -2. The second receives 15% boost -3. The second receives 10% boost -4. The second receives 5% boost -5. The second receives 0% boost - -`Info: When users have the same pts the register timestamp is used to order them.` - -| Rank | user | total pts | rank pts | -| --- | --- | --- | --- | -| 1 | Carlo | 341 | 68 | -| 2 | Bob | 221 | 33 | -| 3 | Alice | 187 | 18 | -| 4 | Sarah | 110 | 5 | -| 5 | Alex | 110 | 0 | - -So, the total pts earn by each user during the last 24 hours: - -| Rank | total pts | rank pts | -| --- | --- | --- | -| 1 | 341 | 68 | -| 2 | 221 | 33 | -| 3 | 187 | 18 | -| 4 | 110 | 5 | -| 5 | 110 | 0 | +![Untitled](https://i.ibb.co/3TSwx37/Screenshot-550.png) From a2d2513ca41c84c0c9ab593d5be87b9934bea016 Mon Sep 17 00:00:00 2001 From: Vuk Tanaskovic Date: Tue, 4 Jun 2024 09:36:19 +0200 Subject: [PATCH 2/4] getting started and point updates --- docs/concepts/guide/04-points.md | 21 +++++++++++++++++++++ docs/concepts/introduction.md | 5 ++++- docs/concepts/links.md | 3 +-- 3 files changed, 26 insertions(+), 3 deletions(-) diff --git a/docs/concepts/guide/04-points.md b/docs/concepts/guide/04-points.md index 8cd12f7..1ef20bf 100644 --- a/docs/concepts/guide/04-points.md +++ b/docs/concepts/guide/04-points.md @@ -117,3 +117,24 @@ 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 % | +| --- | --- | +| 1-50 | 20% | +| 51-200 | 15% | +| 201-500 | 10% | +| 501-1000 | 5% | +| 1001+ | 0% | + +This table represents points breakdown with the Rank points taken into the account: + +| Leaderboard | Earn points | Borrow points | Referral points | % boost | Rank points | Total | +| --- | --- | --- | --- | --- | --- | --- | +| 1-50 | 100 | 50 | 50 | 20% | 40 | 240 | +| 51-200 | 80 | 20 | 0 | 15% | 15 | 115 | +| 201-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/introduction.md b/docs/concepts/introduction.md index b4245db..0d7a973 100644 --- a/docs/concepts/introduction.md +++ b/docs/concepts/introduction.md @@ -80,4 +80,7 @@ Building upon Starknet brings a paradigm shift to Ethereum transactions through - **Cost-Effective Transactions:** Drastically lowering the cost barrier for participation. - **Enhanced User Experience:** Providing intuitive and seamless interactions (Native Account Abstraction). - **Developer-Friendly Ecosystem:** Fostering an environment conducive to innovation and expansion. -- **Swift and Efficient Operations:** Streamlining processes across the blockchain for improved performance. \ No newline at end of file +- **Swift and Efficient Operations:** Streamlining processes across the blockchain for improved performance. +## Nimbora Security Audits: + +Nimbora has been audited by the Cairo Security Clan. Get the report [here](https://github.com/Cairo-Security-Clan/Audit-Portfolio/blob/main/Nimbora%20Audit%20Report.pdf). \ No newline at end of file diff --git a/docs/concepts/links.md b/docs/concepts/links.md index 5f86b56..cdfd911 100644 --- a/docs/concepts/links.md +++ b/docs/concepts/links.md @@ -16,8 +16,7 @@ sidebar_position: 4 - 💼 [LinkedIn](https://www.linkedin.com/company/nimbora/) - ✉️ [Newsletter](https://bit.ly/nimboranewsletter) - 📖 [Medium](https://medium.com/@Nimbora) - - +- 🛡 [Audit](https://github.com/Cairo-Security-Clan/Audit-Portfolio/blob/main/Nimbora%20Audit%20Report.pdf) ## **Need Help?** From e222fa10c4b5acaf8d991d94af49d3fc00551880 Mon Sep 17 00:00:00 2001 From: Vuk Tanaskovic Date: Tue, 4 Jun 2024 12:35:12 +0200 Subject: [PATCH 3/4] incentives breakdown --- docs/concepts/guide/02-earn.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/docs/concepts/guide/02-earn.md b/docs/concepts/guide/02-earn.md index 68b7d7d..5362bd1 100644 --- a/docs/concepts/guide/02-earn.md +++ b/docs/concepts/guide/02-earn.md @@ -13,8 +13,17 @@ There are several yield strategies with different underlying tokens and APR (Ann **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% avergae 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. +**Here's an APR breakdown of the nsDAI strategy** + +![alt](https://i.ibb.co/P4Vbc55/Screenshot-556.png) + +1. **Base**: Represents default strategy yield. +2. **Boost**: Represents incentives added by the Nimbora team to enable higher APR. +3. **Incentives**: Represents incentives provided by the Starknet Foundation. + **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. From 9516e30817ad97763233b56335031d6749b1421a Mon Sep 17 00:00:00 2001 From: 0xSacha <90143060+0xSacha@users.noreply.github.com> Date: Tue, 4 Jun 2024 12:44:16 +0200 Subject: [PATCH 4/4] fix(link): link to our audit repo --- docs/concepts/introduction.md | 2 +- docs/concepts/links.md | 3 +-- 2 files changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/concepts/introduction.md b/docs/concepts/introduction.md index 0d7a973..b4450cc 100644 --- a/docs/concepts/introduction.md +++ b/docs/concepts/introduction.md @@ -83,4 +83,4 @@ Building upon Starknet brings a paradigm shift to Ethereum transactions through - **Swift and Efficient Operations:** Streamlining processes across the blockchain for improved performance. ## Nimbora Security Audits: -Nimbora has been audited by the Cairo Security Clan. Get the report [here](https://github.com/Cairo-Security-Clan/Audit-Portfolio/blob/main/Nimbora%20Audit%20Report.pdf). \ No newline at end of file +Nimbora has been audited by the Cairo Security Clan. Get the report [here](https://github.com/0xSpaceShard/nimbora_audit_report_yield_dex/blob/main/Nimbora%20Audit%20Report.pdf). \ No newline at end of file diff --git a/docs/concepts/links.md b/docs/concepts/links.md index cdfd911..440cf2e 100644 --- a/docs/concepts/links.md +++ b/docs/concepts/links.md @@ -10,13 +10,12 @@ sidebar_position: 4 - 🌐 [Website](https://www.nimbora.io/) - 👨‍💻 [DApp](https://app.nimbora.io/) -- 🔐[Audit](https://github.com/0xSpaceShard/nimbora_audit_report_yield_dex/blob/main/Nimbora_Audit_Report_Yield_Dex.pdf) - 🐦 [Twitter](https://twitter.com/Nimbora_) - 👋 [Discord](http://discord.gg/nimbora) - 💼 [LinkedIn](https://www.linkedin.com/company/nimbora/) - ✉️ [Newsletter](https://bit.ly/nimboranewsletter) - 📖 [Medium](https://medium.com/@Nimbora) -- 🛡 [Audit](https://github.com/Cairo-Security-Clan/Audit-Portfolio/blob/main/Nimbora%20Audit%20Report.pdf) +- 🛡 [Audit](https://github.com/0xSpaceShard/nimbora_audit_report_yield_dex/blob/main/Nimbora%20Audit%20Report.pdf) ## **Need Help?**