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

Add Bee Node (Swarm) Guide #725

Merged
merged 47 commits into from
Sep 30, 2024
Merged
Changes from 1 commit
Commits
Show all changes
47 commits
Select commit Hold shift + click to select a range
9fc18de
Add files via upload
0xarmagan Jul 29, 2024
8af54f1
Update 07-24-core-devs-call.md
0xarmagan Jul 29, 2024
1bb846e
fix broken RPC url
vanshika-srivastava Jul 29, 2024
683d1c8
fix all the broken anchors and hyperlinks
vanshika-srivastava Jul 31, 2024
edc86c6
chore: fix some comments (#702)
zhoufanjin Jul 31, 2024
0244f05
shutterized -> to change to shutter enabled
vanshika-srivastava Aug 1, 2024
4a5ca3c
Merge branch 'main' into dev
vanshika-srivastava Aug 1, 2024
8db8770
fix core dev call layout
vanshika-srivastava Aug 2, 2024
4550427
Core Devs Call Notes July 31, 2024
0xarmagan Aug 6, 2024
86d3056
remove custom signer from interact page
vanshika-srivastava Aug 6, 2024
76868df
fix: 07-31-core-devs-call format
zengzengzenghuy Aug 6, 2024
6461c4f
Core Devs Call Notes Aug 7, 2024
0xarmagan Aug 9, 2024
03e5df4
"Liquid Staking" Page Update (#709)
iamjackgale Aug 12, 2024
aa150fb
Update _generate_validator_keys_wagyu.md (#710)
theChim9 Aug 12, 2024
ef62199
Update voluntary-exit.md (#711)
theChim9 Aug 12, 2024
d222223
Add files via upload
0xarmagan Aug 23, 2024
c0deaae
Update 08-21-core-devs-call.md
0xarmagan Aug 23, 2024
5a2569c
Update 08-07-core-devs-call.md
0xarmagan Aug 23, 2024
b35f1e8
Merge branch 'main' into dev
vanshika-srivastava Aug 26, 2024
aec2c12
Updates 08-21-core-devs-call.md for a small typo
vanshika-srivastava Aug 26, 2024
8f6fca4
Core Devs call notes Aug 28
0xarmagan Aug 31, 2024
9b89786
feat: Cookbook Onboard integration (#715)
ClockRide Sep 2, 2024
97b2046
Update 08-28-core-devs-call.md - fix format
vanshika-srivastava Sep 2, 2024
9090c86
Added dRPC to community Faucets (#698)
maradeeym Sep 2, 2024
46c76b9
chore(bridges): update deprecated url to https://github.com/tokenbridge/
zengzengzenghuy Sep 8, 2024
a79b5c3
add section for running node with eth swarm setup
vanshika-srivastava Sep 11, 2024
fed4767
feat(bridges): add Hashi integration overview
zengzengzenghuy Sep 16, 2024
01d820f
chore(bridges): add testnet contracts for Hashi integration
zengzengzenghuy Sep 17, 2024
9e9710c
fix: error
zengzengzenghuy Sep 17, 2024
be2b4fc
Merge branch 'main' into dev
vanshika-srivastava Sep 17, 2024
98c04a7
added custom signers guides
skundu42 Sep 19, 2024
ba01ed5
Add Confidential Computing category and Secret Network tooling (#719)
secretpatrick Sep 20, 2024
294c29b
Updated the faucet link
vanshika-srivastava Sep 21, 2024
d3dacce
fix naming for confidential computing
vanshika-srivastava Sep 21, 2024
c5c2d87
Update release workflow name
gMonty030 Sep 26, 2024
ce14288
Update Faucets.md with Correct faucet link
vanshika-srivastava Sep 26, 2024
e68809a
Update communication.md with new discord link
vanshika-srivastava Sep 26, 2024
6c8aabf
Update staking.md with new discord link
vanshika-srivastava Sep 26, 2024
0154b68
Update docusaurus.config.js
vanshika-srivastava Sep 26, 2024
bbd5a48
Update troubleshooting.md
vanshika-srivastava Sep 26, 2024
ad67463
Update monitoring.md
vanshika-srivastava Sep 26, 2024
03e54a0
Update bug-bounty.md
vanshika-srivastava Sep 26, 2024
231704e
Update depositWithdrawalReward.md
vanshika-srivastava Sep 26, 2024
5caa8fa
Update offlineAndSyncIssue.md
vanshika-srivastava Sep 26, 2024
48a0857
Update changingwc.md
vanshika-srivastava Sep 26, 2024
2d08dad
Update docusaurus.config.js
vanshika-srivastava Sep 26, 2024
13884a1
Add Bee node quickstart guides (#724)
NoahMaizels Sep 30, 2024
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
Prev Previous commit
Next Next commit
"Liquid Staking" Page Update (#709)
iamjackgale authored Aug 12, 2024
commit 03e5df48a02a72e8ab2cc0f94139062605f92493
82 changes: 50 additions & 32 deletions docs/tools/liquid-staking.md
Original file line number Diff line number Diff line change
@@ -4,66 +4,84 @@

# Liquid Staking

Liquid staking providers allow anyone to stake without running the infrastructure themselves. It also gives stakers an opportunity to use their tokenized staked resources (sGNO & rGNO) for yield farming, borrowing or compounding while still protecting the protocol.
Liquid staking allows anyone to stake on Gnosis Chain without running the infrastructure themselves. It also gives stakers an opportunity to use their tokenized staked resources (osGNO) for liquidity, yield farming or lending while still helping to secure Gnosis Chain.

:::note
Staked GNO (sGNO) and reward GNO (rGNO) can be converted to GNO following the Gnosis Execution Layer \<->\ Gnosis Beacon Chain merge. At that time the staking app will allow you to burn your sGNO and rGNO to redeem your original GNO deposit + your accrued GNO reward.
:::

## Stakewise Basics
StakeWise - a long-standing partner of the Gnosis ecosystem - is the primary provider of liquid-staking for GNO, through their osGNO token. Following the [launch of StakeWise V3](https://stakewise.medium.com/announcing-the-launch-of-stakewise-v3-on-gnosis-chain-0231285bd8e3) in July 2024, GNO holders can stake with any of a variety of providers through StakeWise to mint osGNO.

1) Go to [https://app.stakewise.io](https://app.stakewise.io) and connect your wallet (We use MetaMask in this example, you can also use WalletConnect, Ledger or other options).
This page explains how liquid staking with StakeWise works.

![](/img/node/stakewise-1.png)

2) If your MetaMask is not yet connected to Gnosis, switch by clicking on the network button, selecting Gnosis, and pressing **Switch**.
## osGNO

StakeWise V3 provides users with a marketplace of staking providers, each competing to offer the highest yields, the lowest fees and the most consistent performance. By distributing demand for staking among a selection of providers, StakeWise helps to decentralise the network's validator set and increase the quantity of assets securing the network. However, in unifying arrangements with each of these providers around a single liquid-staking token — osGNO — it also provides a consistent and reliable experience for users, regardless of their chosen provider.

*"osGNO"* stands for overcollateralized staked token. *"Overcollateralized"* refers to the limits on osGNO issuance, where only 90% of the stake (i.e. GNO tokens) provided can be made liquid through osGNO. However, 100% of the provided stake serves as backing for the liquid-staking token, leaving a substantial buffer in the event that stake is slashed for any reason.

![](/img/node/stakewise-2.png)

osGNO ([0xF490c80aAE5f2616d3e3BDa2483E30C4CB21d1A0](https://gnosisscan.io/token/0xf490c80aae5f2616d3e3bda2483e30c4cb21d1a0)) is a non-rebasing token, meaning that the balance of tokens held by the user is naturally static, but the value of each token rises continually as the underlying amount of GNO per token increases due to staking rewards. This enables seemless integration of osGNO into other DeFi applications like decentralised exchanges and lending protocols. This also means that osGNO is not issued 1:1 with GNO tokens, and you will receive less osGNO tokens than the underlying amount of GNO tokens backing them.

StakeWise processes two fees as part of its V3 implementation on Gnosis Chain:

* A flat fee of 5% of all staking rewards associated with your osGNO tokens is sent to StakeWise DAO. This fee is omitted for users who stake with StakeWise but do not mint osGNO; and

* A *"Vault Fee"* is set by the provider and charged on all rewards earned by the GNO you stake with them. For StakeWise's own Genesis Vault, this fee is set at 15% of all rewards earned.

## StakeWise Tutorial

To access StakeWise V3 on Gnosis Chain and mint osGNO, simply:

1) Head to [https://app.stakewise.io](https://app.stakewise.io), connect your wallet, and switch to Gnosis Chain.

![](/img/node/stakewise-3.png)

3) Confirm the Network switch in MetaMask.
2) On the Stake interface, you can select the amount of GNO you wish to stake, approve it for staking and then stake immediately into osGNO with the provider(s) allocated by the app.

![](/img/node/stakewise-4.png)

4) Enter the GNO deposit amount into the Stake interface. Enter any amount of GNO to get started. Note you can also change the recipient address if desired. You will receive the same amount of sGNO tokens relative to the GNO you stake.

Agree to the terms and press confirm.
3) Alternatively, head to the Vaults interface to select the provider you wish to stake with. Once you've selected a provider and moved to their page, select *"Stake"*, enter the amount of GNO, approve it and then stake it.

![](/img/node/stakewise-5.png)

5) Confirm the deposit transaction in your wallet. You should now see sGNO added in the interface.
4) Where you've staked with a specific vault, the relevant vault page will then show the amount staked with an option to *"Unstake"*. Below, it will also show the amount of osGNO minted for your stake, as well as options to *"Mint"* and *"Burn"* osGNO as appropriate.

![](/img/node/sGNO.png)
![](/img/node/stakewise-6.png)

## Tokens (sGNO & rGNO)
There you have it! You can now use your osGNO tokens freely, safe in the knowledge that your deposited GNO is earning staking rewards with StakeWise V3.

* sGNO address on Gnosis:
[0xa4ef9da5ba71cc0d2e5e877a910a37ec43420445 ](https://blockscout.com/xdai/mainnet/token/0xA4eF9Da5BA71Cc0D2e5E877a910A37eC43420445/token-transfers)
* rGNO address on Gnosis:
[0x6ac78efae880282396a335ca2f79863a1e6831d4 ](https://blockscout.com/xdai/mainnet/token/0x6aC78efae880282396a335CA2F79863A1e6831D4/token-transfers)
![](/img/node/stakewise-7.png)

You can [import to MetaMask](https://consensys.net/blog/metamask/how-to-add-your-custom-tokens-in-metamask/) as you would other tokens, or click on the 🦊 in Blockscout to add!
## V2 Migration

![](/img/node/blockscout-1.png)
:::note
StakeWise V2 has been deprecated, so will no longer be maintained. Please migrate to StakeWise V3 to continue earning staking rewards and supporting the network.
:::

At all times the total amount of tokens that have been issued to users is sGNO + rGNO = GNO deposits + GNO rewards \* (100% — 10%), where 10% is StakeWise commission.
Prior to the [V3 launch](https://stakewise.medium.com/announcing-the-launch-of-stakewise-v3-on-gnosis-chain-0231285bd8e3), StakeWise operated its V2 staking protocol for GNO on Gnosis Chain. Though support for V2 has been deprecated, liquidity for some V2 assets remain on the chain.

### sGNO
StakeWise V2 consisted of 2 core assets:

sGNO represents your initial stake of GNO deposited to the pool. Exchanging or transferring your sGNO balance will result in lower rGNO earned to your account, as you will have a smaller proportional amount staked that is earning rewards.
* sGNO ([0xa4ef9da5ba71cc0d2e5e877a910a37ec43420445 ](https://gnosisscan.io/address/0xa4ef9da5ba71cc0d2e5e877a910a37ec43420445)) represents the initial stake of GNO deposited into StakeWise. This figure is static, but is used as the basis to calculate rewards owing to the user; and

### rGNO
* rGNO ([0x6ac78efae880282396a335ca2f79863a1e6831d4 ](https://gnosisscan.io/address/0x6ac78efae880282396a335ca2f79863a1e6831d4)) represents the earned staking rewards and are updated on a periodic basis, based on the amount of sGNO held. The V2 contracts frequently check and update the rGNO balance of all sGNO holders, to reflect both rewards earned and deductions from any slashing.

rGNO represent earned staking rewards and are updated on a periodic basis. Contracts check and update your reward balance based on staked GNO increases in the staking pool (or decreases if slashed).
In V2, StakeWise charged a 10% commission for operating the network on all staking rewards before distributing them as rGNO. At all times, the total amount of tokens that had been issued to users in StakeWise V2 was equal to: *sGNO + rGNO = GNO deposits + (GNO rewards * (100% — 10%))*.

The interface shows the time until the next update to your rGNO.
![](/img/node/stakewise-8.png)

![Time until next rGNO update](/img/node/next-update.png)
If you hold or purchase any remaining sGNO or rGNO, StakeWise has provided a migration interface to move the underlying GNO tokens into V3. Follow this [tutorial](https://docs.stakewise.io/guides/stakewise-v2/migrate-to-stakewise-v3-on-gnosis-chain) to migrate, and check the Genesis Vault in V3 to find your migrated GNO.

:::note
**Coming Soon**: Use your rGNO in DeFi protocols on Gnosis to borrow and stake additional GNO!
## Learn More

Since rGNO tokens represent your rewards in a StakeWise Pool, exchanging or transferring your rGNO will mean that you transferred your rewards to someone else. It will not impact your future earnings.
:::
You can find out more about StakeWise V3, the Gnosis deployment and osGNO with the following resources:

* Read the StakeWise V3 [Documentation](https://docs.stakewise.io/);

* Read StakeWise's [launch blog post](https://stakewise.medium.com/stakewise-v3-on-gnosis-chain-what-to-expect-how-to-migrate-1149a5367c76) on what to expect with osGNO;

* Watch the Gnosis [Community Call](https://www.youtube.com/watch?v=fVVWtY_YBFo) with StakeWise from July 2024; and

* Reach out to the community through the [StakeWise Discord Server](https://discord.gg/StakeWise).

If you're interested in operating a vault in StakeWise V3, check out the recording of the [Vault Operator Workshop](https://www.youtube.com/watch?v=kX11K4ymn1Q).
Binary file removed static/img/node/sGNO.png
Binary file not shown.
Binary file modified static/img/node/stakewise-1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified static/img/node/stakewise-2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified static/img/node/stakewise-3.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified static/img/node/stakewise-4.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified static/img/node/stakewise-5.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/img/node/stakewise-6.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/img/node/stakewise-7.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/img/node/stakewise-8.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.