Skip to content
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
92 changes: 46 additions & 46 deletions docs/docs/glossary.mdx

Large diffs are not rendered by default.

8 changes: 4 additions & 4 deletions docs/docs/overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ description: "Overview of StakeWise ecosystem: Protocol, Interface, DAO, and Lab

StakeWise has several distinct areas that serve different purposes — here's how to tell them apart.

- **[StakeWise Protocol](https://github.com/stakewise/v3-core)**: A modular collection of smart contracts powering decentralized liquid staking on Ethereum and Gnosis Chain. The protocol includes customizable Vaults (including blocklist, private, and ERC20 variants), an over-collateralized token system (osToken), validator lifecycle management, MEV capture and distribution, and governance controls.
- **[StakeWise Interface](https://app.stakewise.io/)**: A web interface that allows for easy interaction with the StakeWise protocol. The interface allows users to stake ETH, browse the Vault marketplace, create their own Vaults, and discover different DeFi strategies to maximize earnings.
- **[StakeWise DAO](https://vote.stakewise.io/#/)**: A governance system for governing the StakeWise Protocol, enabled by the SWISE token.
- **[StakeWise Labs](https://x.com/stakewise_io)**: The core development team behind StakeWise Protocol and its ecosystem tools.
- **[StakeWise Protocol](https://github.com/stakewise/v3-core)**: A modular collection of smart contracts powering decentralized liquid staking on Ethereum and Gnosis Chain. The protocol includes customizable Vaults (including blocklist, private, and ERC20 variants), an over-collateralized token system (osToken), validator lifecycle management, MEV capture and distribution, and governance controls.
- **[StakeWise Interface](https://app.stakewise.io/)**: A web interface that allows for easy interaction with the StakeWise protocol. The interface allows users to stake ETH, browse the Vault marketplace, create their own Vaults, and discover different DeFi strategies to maximize earnings.
- **[StakeWise DAO](https://vote.stakewise.io/#/)**: A governance system for governing the StakeWise Protocol, enabled by the SWISE token.
- **[StakeWise Labs](https://x.com/stakewise_io)**: The core development team behind StakeWise Protocol and its ecosystem tools.
2 changes: 1 addition & 1 deletion docs/docs/vaults/how-vaults-work.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -84,7 +84,7 @@ Users can mint osTokens for instant liquidity or withdraw. When users choose to
As ETH becomes available to the Vault, users can claim what is available.
If only part of the requested amount is available, they can claim that portion immediately and receive an updated ticket for the remainder.

Partial withdrawals for `0x02` compound validators are now supported and can now be triggered from the execution layer via [EIP-7002](https://eips.ethereum.org/EIPS/eip-7002)<sup><a href="#fn-4" id="fnref-4">4</a></sup>.
Partial withdrawals for `0x02` compound validators are now supported and can now be triggered from the execution layer via [EIP-7002](https://eips.ethereum.org/EIPS/eip-7002)<sup><a href="#fn-4" id="fnref-4">4</a></sup>.
The withdrawal fulfillment process is automated by the Operator Service, which manages validator exits and partial withdrawals among other responsibilities to ensure timely processing of the exit queue.

:::custom-info[Processing Time]
Expand Down
2 changes: 1 addition & 1 deletion operator/manage-vault/add-extra-rewards.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ Please note that Vault incentives are currently supported only on Ethereum.

Users can claim their incentives at any time through the [StakeWise App ↗](https://app.stakewise.io/):

![Claiming](./img/vault-incentives.gif)
![Claiming](./img/claim.gif)

## Periodic Distribution to the Vault

Expand Down
Binary file added operator/manage-vault/img/claim.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed operator/manage-vault/img/vault-incentives.gif
Binary file not shown.
Original file line number Diff line number Diff line change
Expand Up @@ -144,7 +144,7 @@ Response:

## DVT Relayer

When using a DVT setup, a specialized DVT relayer is required. Unlike a regular relayer, you do not need to set up a dedicated relayer instance. Instead, you can use the public DVT relayer available at: [https://mainnet-dvt-relayer.stakewise.io/](https://mainnet-dvt-relayer.stakewise.io/).
When using a DVT setup, a specialized DVT relayer is required. Unlike a regular relayer, you do not need to set up a dedicated relayer instance. Instead, you can use the public DVT relayer available at: [https://mainnet-dvt-relayer.stakewise.io/](https://mainnet-dvt-relayer.stakewise.io/).

The Operator environment configuration is similar to that of a regular relayer. However, you must specify the relayer type as follows:

Expand Down
4 changes: 2 additions & 2 deletions staker/boost.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ To use Boost, you need osETH in your wallet.

<div style={{ paddingLeft: '1.5rem' }}>

1. Open [app.stakewise.io](https://app.stakewise.io) and connect your wallet.
1. Open [app.stakewise.io](https://app.stakewise.io) and connect your wallet.
2. Select the **Boost** tab.
3. Check the **Boost APY** displayed to decide if it's a good time to enter.
4. Enter the amount of osETH you want to boost.
Expand Down Expand Up @@ -51,7 +51,7 @@ Periodically check on your position to ensure the Boost APY is positive. If you

<div style={{ paddingLeft: '1.5rem' }}>

1. Open [app.stakewise.io](https://app.stakewise.io) and connect your wallet.
1. Open [app.stakewise.io](https://app.stakewise.io) and connect your wallet.
2. Select the **Unboost** tab.
3. Enter the percentage of the position you want to exit.
4. Confirm the transaction. Your request enters the unboost queue, where processing time depends on the network exit queue. Only one unboost request can be active at a time.
Expand Down
8 changes: 4 additions & 4 deletions staker/risks.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,20 +7,20 @@ description: Risks of liquid staking with StakeWise — Vault performance, smart

Liquid staking carries inherent risks. This page covers them and how StakeWise addresses each.

## Vault Performance
## <img src="/icons/risks/vault-performance.png" alt="Vault Performance" style={{width: '32px', height: '32px', display: 'inline', verticalAlign: 'middle'}} /> Vault Performance

Your staking rewards depend on how well your Vault performs. Ethereum rewards validators for performing their duties correctly and [penalizes them ↗](https://ethereum.org/developers/docs/consensus-mechanisms/pos/rewards-and-penalties#penalties) for going offline, missing attestations, or acting maliciously. These penalties reduce the staked ETH in your Vault.

Each Vault is fully isolated — poor performance in one Vault has no effect on stakers in other Vaults. You can review every Vault's performance in the app before staking. If a Vault's performance starts declining, consider unstaking and moving to a better-performing Vault.

## Smart Contract
## <img src="/icons/risks/smart-contract.png" alt="Smart Contract" style={{width: '32px', height: '32px', display: 'inline', verticalAlign: 'middle'}} /> Smart Contract

All DeFi protocols carry smart contract risk. StakeWise runs on battle-tested, [regularly audited](/contracts/audits) contracts that secure over $1B in staked assets. The protocol has been live since 2021 with no security incidents.

## osETH Depeg
## <img src="/icons/risks/oseth-depeg.png" alt="osETH Depeg" style={{width: '32px', height: '32px', display: 'inline', verticalAlign: 'middle'}} /> osETH Depeg

osETH could temporarily trade below its fair value on secondary markets. The protocol's [redemption and liquidation mechanisms](/docs/ostoken/how-ostoken-works#peg-maintenance) create arbitrage incentives that keep the market price aligned with the underlying value.

## Boost
## <img src="/icons/risks/boost.png" alt="Boost" style={{width: '32px', height: '32px', display: 'inline', verticalAlign: 'middle'}} /> Boost

As with any leveraged strategy, [Boost](/docs/vaults/boost) carries liquidation and penalty risks. If Aave's borrow rate exceeds the staking rate for too long, your Boost APY turns negative and your position loses value every day it stays open, while your LTV drifts toward Aave's liquidation threshold. A [2% safety buffer](/docs/vaults/boost#safety-mechanisms) between max borrow LTV and the liquidation threshold gives your position room to absorb this drift, and StakeWise automatically unboosts as you approach the threshold. Stay updated via [StakeWise Discord ↗](https://discord.com/invite/2BSdr2g).
10 changes: 5 additions & 5 deletions staker/simple-staking.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -8,9 +8,9 @@ import Tooltip from '@site/src/components/Tooltip/Tooltip';

# Simple Staking

The simplest way to stake with StakeWise is through the [StakeWise App ↗](https://app.stakewise.io) — deposit any amount of ETH and stake it in a single click. Your assets are routed through a [MetaVault](/docs/vaults/meta-vaults) that distributes them across the best-performing Sub-vaults — currently just the [Genesis Vault](https://app.stakewise.io/vault/mainnet/0xac0f906e433d58fa868f936e8a43230473652885), with more to come.
The simplest way to stake with StakeWise is through the [StakeWise App ↗](https://app.stakewise.io) — deposit any amount of ETH and stake it in a single click. Your assets are routed through a [MetaVault](/docs/vaults/meta-vaults) that distributes them across the best-performing Sub-vaults — currently just the [Genesis Vault](https://app.stakewise.io/vault/mainnet/0xac0f906e433d58fa868f936e8a43230473652885), with more to come.

When staking, you'll automatically receive [osETH](/docs/ostoken/intro), which represents your staked assets plus accumulated rewards. osETH can be used [across DeFi to boost your yield](https://app.stakewise.io/ecosystem).
When staking, you'll automatically receive [osETH](/docs/ostoken/intro), which represents your staked assets plus accumulated rewards. osETH can be used [across DeFi to boost your yield](https://app.stakewise.io/ecosystem).

<Image img={require('./img/simple_staking.png')} alt="StakeWise simple staking explanation diagram" />

Expand All @@ -20,7 +20,7 @@ Stake your ETH and start earning rewards immediately.

<Image img={require('./img/staking_flow.png')} alt="Staking flow explanation diagram" />

1. Open [app.stakewise.io](https://app.stakewise.io) and connect your wallet.
1. Open [app.stakewise.io](https://app.stakewise.io) and connect your wallet.
2. Select the **Stake** tab and enter the amount of ETH you want to stake.
3. Review the details.
4. Click **Stake** and confirm the transaction in your wallet.
Expand All @@ -38,13 +38,13 @@ Once you have osETH in your wallet, you can optionally [Boost](/staker/boost) yo

Unstaking is just as simple — convert your osETH back to ETH directly in the StakeWise App whenever you want.

osETH can only be **minted** or **burned** — staking mints new osETH, and unstaking burns it to release the underlying ETH. osETH bought on a DEX isn't tied to any staking position, so it won't appear in the **Unstake** tab. To convert market-bought osETH back to ETH, swap it on the [Swap page](https://app.stakewise.io/swap) of the StakeWise App or sell it on a DEX.
osETH can only be **minted** or **burned** — staking mints new osETH, and unstaking burns it to release the underlying ETH. osETH bought on a DEX isn't tied to any staking position, so it won't appear in the **Unstake** tab. To convert market-bought osETH back to ETH, swap it on the [Swap page](https://app.stakewise.io/swap) of the StakeWise App or sell it on a DEX.

Before unstaking, make sure the amount of osETH you want to unstake is in your wallet. If you have an active Boost position, switch to the **Unboost** tab and exit it first.

<Image img={require('./img/unstaking_flow.png')} alt="Unstaking flow explanation diagram" />

1. Open [app.stakewise.io](https://app.stakewise.io) and connect your wallet.
1. Open [app.stakewise.io](https://app.stakewise.io) and connect your wallet.
2. Click the **flip** button <img src="/icons/stakewise/flip_button.png" alt="flip button icon" style={{height: '2.5em', verticalAlign: 'middle', display: 'inline-block'}} /> to switch from staking to unstaking mode.
3. Select the **Unstake** tab and enter the amount of osETH you want to convert back to ETH.
4. Review the details.
Expand Down
42 changes: 17 additions & 25 deletions staker/stakewise-v2/01-migrate-to-stakewise-v3-on-ethereum.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,14 +4,14 @@ sidebar_position: 1
description: "Step-by-step guide to migrate your stake from StakeWise V2 Pool to StakeWise V3 on Ethereum."
---

# Migrate to StakeWise V3 on Ethereum
import Image from '@theme/IdealImage';

<p style={{fontSize: '1.2em', color: 'rgba(var(--moon-rgb), .5)', marginTop: '-10px', marginBottom: '20px'}}>Migrating your stake in the legacy StakeWise Pool to StakeWise V3</p>
# Migrate to StakeWise V3 on Ethereum

This guide will walk you through the process of migrating your stake in the StakeWise Pool (known as StakeWise V2) to StakeWise V3. Follow the simple steps below to proceed.

:::custom-info[Migration Information]
Please consult our [blog post](https://blog.stakewise.io/guide/transitioning-to-stakewise-v3-the-migration-path) about the migration to StakeWise V3 to learn about the reasons and mechanics behind the migration.
Please consult our [blog post](https://blog.stakewise.io/guide/transitioning-to-stakewise-v3-the-migration-path) about the migration to StakeWise V3 to learn about the reasons and mechanics behind the migration.
:::

:::custom-info[Requirements]
Expand All @@ -20,46 +20,38 @@ You must have sETH2 and/or rETH2 tokens in your wallet to be able to migrate to

## Make sure you are on the right website

Scammers have attempted to lull users into connecting their wallets to malicious interfaces by replicating the StakeWise V3 interface and creating domain names similar to [stakewise.io](https://stakewise.io/).
Scammers have attempted to lull users into connecting their wallets to malicious interfaces by replicating the StakeWise V3 interface and creating domain names similar to [stakewise.io](https://stakewise.io/).

Before you proceed, make sure you are connecting your wallet to an interface located at [app.stakewise.io](https://app.stakewise.io/), which is the only official StakeWise V3 interface.
Before you proceed, make sure you are connecting your wallet to an interface located at [app.stakewise.io](https://app.stakewise.io/), which is the only official StakeWise V3 interface.

## Connect your wallet

Once you land on the StakeWise V3 interface, press the `Connect Wallet` button at the top-right-hand side of your screen and select the type of wallet you want to connect with.
Once you land on the StakeWise V3 interface, press the `Connect Wallet` button at the top right-hand side of your screen and select the type of wallet you want to connect with.

![Step 1](./img/migrate-v3-1.avif)
<Image img={require('./img/ethereum/connect_your_wallet.png')} alt="Connect your wallet" />

Remember that in order to migrate, you will need to connect with the wallet that holds the sETH2 and rETH2 tokens i.e. your stake in StakeWise V2.
Remember that in order to migrate, you will need to connect with the wallet that holds the sETH2 and rETH2 tokens, i.e. your stake in StakeWise V2.

## Navigate to the Migrate interface

Once your wallet is connected to the StakeWise V3 interface, you will find the Migrate section at the top of your screen.

![Step 2](./img/migrate-v3-2.avif)

Press on the `Migrate` button to open the Migrate interface. You should see a floating module with blank fields for the amount of sETH2 and rETH2 tokens you would like to migrate to StakeWise V3.

![Step 3](./img/migrate-v3-3.avif)

## Enter the amount you will migrate

For every StakeWise token that you own, you will be prompted to enter the amount you would like to migrate to StakeWise V3.
<Image img={require('./img/ethereum/navigate_to_the_migrate_interface.png')} alt="Navigate to the Migrate interface" />

sETH2 and rETH2 tokens represent ETH staked in StakeWise V2 at a 1:1 ratio. For every unit of a token you choose to migrate, a corresponding amount of your staked ETH will migrate to StakeWise V3.
Press the `Migrate` button to open the Migrate interface. You should see a floating module with blank fields for the amount of sETH2 and rETH2 tokens you would like to migrate to StakeWise V3.

![Step 4](./img/migrate-v3-4.avif)
<Image img={require('./img/ethereum/open_migrate_interface.png')} alt="Open the Migrate interface" />

You can use `Max` buttons to insert the total amount of tokens you hold in your wallet for migration.
## Enter the amount and confirm the transaction

## Confirm the transaction
For every StakeWise token that you own, you will be prompted to enter the amount you would like to migrate to StakeWise V3. sETH2 and rETH2 tokens represent ETH staked in StakeWise V2 at a 1:1 ratio. For every unit of a token you choose to migrate, a corresponding amount of your staked ETH will migrate to StakeWise V3. You can use `Max` buttons to insert the total amount of tokens you hold in your wallet.

Once you've selected the amounts of sETH2 and rETH2 tokens you would like to migrate to StakeWise V3, press on the Migrate button. Confirm the transaction in your wallet to initiate the migration.
Once you've entered the amounts, press the `Migrate` button and confirm the transaction in your wallet to initiate the migration.

![Step 5](./img/migrate-v3-5.avif)
<Image img={require('./img/ethereum/confirm_the_transaction.png')} alt="Confirm the transaction" />

Once the transaction is finalized, you should see the total amount of tokens you chose to migrate as ETH staked in the ["Genesis"](https://app.stakewise.io/vault/0xAC0F906E433d58FA868F936E8A43230473652885) Vault on StakeWise V3.
Once the transaction is finalized, you should see the total amount of tokens you chose to migrate as ETH staked in the [Genesis Vault ↗](https://app.stakewise.io/vault/0xAC0F906E433d58FA868F936E8A43230473652885) on StakeWise V3.

![Step 6](./img/migrate-v3-6.avif)
<Image img={require('./img/ethereum/migration_complete.png')} alt="Migration complete" />

This step marks the successful completion of the migration. Congratulations! 🎉
Loading