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

strategies and merged pages #22

Open
wants to merge 1 commit into
base: develop
Choose a base branch
from
Open
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
72 changes: 0 additions & 72 deletions docs/concepts/benefits.md

This file was deleted.

2 changes: 1 addition & 1 deletion docs/concepts/guide/01-first-steps.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
id: first_steps
title: First Steps
sidebar_position: 1
sidebar_position: 2
---

## Getting Started on Starknet
Expand Down
30 changes: 11 additions & 19 deletions docs/concepts/guide/02-earn.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,15 @@
---
id: earn
title: Earn
sidebar_position: 2
sidebar_position: 3
sidebar_class_name: hidden
---

## Understanding the Earn Section

There are several yield strategies with different underlying tokens and APR (Annual Percentage Rate). Each card represent a certain strategy, it can be a lending pool, a strategy aggregator, an AMM liquidity pool...

![alt](/content/earn.png)
![alt](https://i.ibb.co/Wx44LdS/Screenshot-509.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% avergae you'll earn $10 after a year.

Expand All @@ -29,47 +29,39 @@ Choose the strategy that you want and click on the card for next steps
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/hdeposit.png)
![alt](https://i.ibb.co/VDh4Wm6/Screenshot-510.png)

Finally, when you've selected the token amount to deposit, click on "deposit" and follow the prompts on your wallet (Argent or Braavos) to complete the transaction.
When you've selected the token amount to deposit, click on "deposit" and follow the prompts on your wallet (Argent or Braavos) to complete the transaction.

![alt](/content/rdeposit.png)
![alt](https://i.ibb.co/3p9Yj1Y/Screenshot-512.png)

Once the transaction has been accepted on the network, a popup will appear at the bottom left of the screen to let you know.

![alt](/content/fdeposit.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 sections, your transaction should be here.
![alt](https://i.ibb.co/DLJdyRz/Screenshot-519.png)

![alt](/content/cdeposit.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.



## How to request a withdrawal

Withdrawal are not synchronous such as deposits they take an average of 1 day to be processed, a fast withdrawal option should arrive later on.


First, you need to decide on the amount you want to withdraw. This could be all or a portion of your assets.

![alt](/content/hwithdraw.png)
![alt](https://i.ibb.co/1rxHhLK/Screenshot-514.png)

Once you've made up your mind, locate and click on the 'withdraw' button and follow the prompts on your wallet (Argent or Braavos) to complete the transaction.

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

Once the transaction has been accepted on the network, a popup will appear at the bottom left of the screen to let you know.

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

You can consult all of your recent withdrawals in the wallet sections, your transaction should be here.
![alt](https://i.ibb.co/DDLSWNp/Screenshot-515.png)

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

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

ADD PICTURE PENDING REQUEST
![alt](https://i.ibb.co/CB4PtZw/Screenshot-517.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.

2 changes: 1 addition & 1 deletion docs/concepts/guide/_category_.json
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
{
"label": "Guide",
"position": 4,
"position": 3,
"collapsed": false
}
90 changes: 65 additions & 25 deletions docs/concepts/introduction.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,16 +4,6 @@ title: Introduction
sidebar_position: 1
---

[Nimbora](https://www.nimbora.io/) is a Starknet-based infrastructure enabling users to earn and borrow on Layer 1 protocols with significantly reduced costs. Powered by the innovative minds at the [SpaceShard team](https://www.spaceshard.io/), we leverage Starknet ZK Rollup to provide cost-effective DeFi strategies without compromising security or trust.

![About](/img/about.png)



When considering cross-chain strategies, many products rely on zap systems, bridge funds, and relayers to execute desired actions. Nimbora stands out by aggregating these intents into pools, batching them to accommodate multiple users, and executing transactions efficiently. This approach enables a single transaction to execute multiple L2 transactions, drastically reducing gas costs. Nimbora abstracts these complexities for users, allowing seamless and gasless utilization of L1 strategies from L2. With Nimbora, accessing and utilizing cross-chain strategies becomes effortless.
<!--


## **Starknet: The Backbone of Efficient DeFi**

Starknet revolutionizes Ethereum transactions with zk-STARKs technology, ensuring faster, more affordable, and secure exchanges, reshaping the DeFi landscape through:
Expand All @@ -33,22 +23,72 @@ Nimbora supports the [Argent X](https://www.argent.xyz/argent-x/) and [Braavos](

## Nimbora benefits

- **Maximizing Cost-Efficiency with Nimbora**

Nimbora drastically lowers transaction costs via Starknet's L2 solution, offering gas fees up to seven times less than those on the Ethereum mainnet. Our approach makes DeFi more accessible and economical for everyone.

- **Innovative Transaction Batching**

Our unique batching mechanism pools transactions, allowing DeFi interactions on the L1 network at a fraction of the usual cost. This process not only reduces expenses but also makes DeFi more inclusive.

- **N-Yield Tokens: A New Frontier**

N-Yield tokens, like N-sDAI and N-wstETH, represent the yield from DeFi strategies within Nimbora. These tokens, adaptable across various protocols, offer flexibility and open a realm of possibilities for managing your DeFi investments.

- **$STRK incentives with Nimbora**

For an in-depth exploration of STRK incentives, zero L1 gas fees, and more, check out our detailed post: [Nimbora x Liquity DeFi Spring](https://medium.com/@Nimbora/nimbora-x-liquity-defispring-high-apr-zero-l1-gas-borrowing-6b5b78dbab4e).
- ## A Gasless experience

You're eager to deposit funds into a L1 DeFi protocol to earn yields or borrow assets, but have you considered the potential cost in gas fees? Could it be $20, $100, or a staggering $300? The same applies for withdrawals or repayments.

![Gas](/img/gas.png)

| Action | Gas used | Gas Price (Eth) - 40 Gwei | Gas Price (USD) - 3k eth/usd |
|-------------------|----------------|-------------------------------|---------------------|
| Deposit / Redeem | 700K - 1M6 | 0.030589257 - 0.058813266 | $91.767771 - $176.439798 |
| Borrow / Repay | 580K - 900K | 0.025470271 - 0.039561244 | $76.410813 - $118.683732 |


Given the prevalent gas prices averaging around 40 Gwei, it's evident that gas fees pose a significant challenge for portfolios of low to medium value. For instance, a $100 gas cost could equate to 1% of a $10,000 portfolio, a substantial proportion that can impact overall returns. This issue is further compounded when adjustments or rebalancing of positions are required.

At Nimbora, our primary objective is to foster inclusivity within the realm of DeFi. We firmly believe that individuals should have the opportunity to earn yields, regardless of whether they're investing $50 or $5,000. Financial constraints should never be a barrier to entry.


### The Role of Starknet in Reducing Costs

Starknet plays a crucial role in Nimbora's ability to offer reduced gas fees. As an advanced Layer 2 solution, Starknet enhances the scalability of the blockchain by processing transactions off the main Ethereum chain. This process not only speeds up transactions but also significantly lowers the cost associated with them. By utilizing Starknet, Nimbora taps into these benefits, passing the savings directly to its users.

### Batching Mechanism: Pooling Transactions for Efficiency

Nimbora introduces an innovative batching mechanism that further enhances its cost-efficiency. This mechanism allows users to pool their transactions together, creating a collective action that can interact with DeFi protocols on the Layer 1 (L1) network at a fraction of the usual price. By doing so, Nimbora not only makes transactions more affordable but also fosters a more inclusive and accessible DeFi ecosystem.

![Gas](/content/pooling.png)


### The L2 Pooling Manager: Accumulating and Batching Requests

The transaction process begins when the Nimbora L2 Pooling Manager contract receives a request from a user. This contract acts as a collector, gathering individual requests into a new batch. The batching continues until the batch reaches its capacity. At this point, the L2 Pooling Manager packages all the requests into a single bundle and forwards it to the L1 Pooling Manager contract for further processing.

### L1 Verification and Asset Handling

Upon receiving the batch from the L2 side, the L1 Pooling Manager contract must wait for the batch to be verified on the Ethereum mainnet. This verification process is subject to network congestion but typically completes within a 12-hour window. Once verified, the L1 Pooling Manager interacts with the Starkgate Bridge to retrieve the necessary assets. These assets are then deposited according to the predetermined strategies.

### Reporting and Feedback Loop

The final step in the transaction process involves the L1 Pooling Manager generating a detailed report. This report confirms the successful deposit of assets and is sent back to the L2 Pooling Manager. This feedback loop ensures transparency and trust in the transaction process, allowing users to confidently engage with Nimbora's DeFi ecosystem.

By adopting these advanced mechanisms and leveraging Layer 2 solutions like Starknet, Nimbora is paving the way for a more affordable and accessible blockchain experience. Its innovative approach to transaction batching and cost reduction not only benefits individual users but also contributes to the broader goal of fostering a more inclusive DeFi ecosystem.



## Expanding DeFi Access from Layer 2

While Layer 2 (L2) solutions represent a significant innovation for scaling Ethereum DeFi, the majority of the ecosystem and liquidity remains rooted in Layer 1 (L1). It's important to acknowledge that L2 can take several years to mature into a resilient and robust DeFi ecosystem with deep liquidity. This challenge is further exacerbated when the L2 solution is not EVM-compatible, as protocols must allocate significant resources to deploy on these new platforms.

![Tvl](/img/tvl.png)


Moreover, even in cases where protocols successfully deploy on L2, they encounter a fundamental difference in market dynamics compared to L1. For instance, consider Aave pools on Ethereum and Polygon. Despite being the same protocol, each pool operates within distinct L1 and L2 markets, each with its unique characteristics and nuances.

Nimbora introduces a pioneering advancement by bridging the gap for emerging Layer 2 (L2) solutions, granting access to a plethora of Ethereum DeFi protocols (Current integrations). In essence, even nascent L2 platforms devoid of native DeFi infrastructure can now rival Ethereum's DeFi ecosystem with Nimbora's support.

We empower these burgeoning chains, rendering them viable during their transitional phase. Furthermore, our intervention catalyzes the emergence of distinct markets as these platforms mature, thus broadening the DeFi landscape and fostering innovation


## Leveraging Starknet for Enhanced DeFi

Building upon Starknet brings a paradigm shift to Ethereum transactions through zk-STARKs technology, resulting in:

- **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.

## **A Word of Caution: Stay Vigilant**

Expand Down
Loading