Docs/staker section by ulieth · Pull Request #89 · stakewise/stakewise-docs

ulieth · 2026-04-10T14:30:40Z

No description provided.

# Conflicts: # docs/docs/guides/intro.mdx # docs/docs/guides/staking/intro.mdx # docusaurus.config.ts # operator/alternative-key-management/dvt/obol-setup.mdx # operator/alternative-key-management/dvt/ssv-setup.mdx # operator/manage-vault/vault-administration.mdx # operator/operator-service-v3/alternative-key-management/dvt/obol-setup.mdx # operator/operator-service-v3/alternative-key-management/dvt/ssv-setup.mdx # sidebars.ts # src/theme/Root.tsx # staker/solo-staking.mdx

vercel · 2026-04-10T14:30:48Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
docs	Ready	Preview	Apr 21, 2026 2:34pm

…osition and description quotes from concepts docs

tsudmi · 2026-04-13T11:38:18Z

+
+## Why Stake with StakeWise?
+
+Stake any amount of ETH, earn [rewards](/staker/rewards) automatically, mint [osETH](/docs/ostoken/intro) to stay liquid while your ETH keeps earning, and [withdraw whenever you want](/docs/vaults/how-vaults-work#withdrawals).


Please mention osETH integrations as well.

tsudmi · 2026-04-13T11:40:15Z

+
+## Why Stake with StakeWise?
+
+Stake any amount of ETH, earn [rewards](/staker/rewards) automatically, mint [osETH](/docs/ostoken/intro) to stay liquid while your ETH keeps earning, and [withdraw whenever you want](/docs/vaults/how-vaults-work#withdrawals).


This part must be better described, maybe by steps. and what you get from each step

tsudmi · 2026-04-13T11:40:40Z

+Every Vault comes with [Boost](/docs/vaults/boost) built in — activate it with a single click to use your osETH as collateral on Aave, borrowing and restaking more ETH for historically 4–6% APY.
+
+You stay in full control — your funds never leave the smart contracts, while professional operators handle all the validator infrastructure for you.
+Your only [costs](/docs/fees/intro) are Ethereum gas for transactions and a small fee on rewards — set by the Vault operator<sup><a href="#fn-1" id="fnref-1">1</a></sup>.


Suggested change

Your only [costs](/docs/fees/intro) are Ethereum gas for transactions and a small fee on rewards — set by the Vault operator<sup><a href="#fn-1" id="fnref-1">1</a></sup>.

Your only [costs](/docs/fees/intro) are Ethereum gas for transactions and a fee on rewards — set by the Vault operator<sup><a href="#fn-1" id="fnref-1">1</a></sup>.

tsudmi · 2026-04-13T11:42:31Z

+Everything runs on battle-tested, [regularly audited](/contracts/audits) smart contracts that secure over $1B in staked assets.
+As Ethereum evolves, so does StakeWise — delivering the latest features that make staking more powerful with every upgrade.<sup><a href="#fn-4" id="fnref-4">4</a></sup>
+
+<Image img={require('./img/key_strengths.png')} alt="StakeWise's key strengths" />


Don't think we need this image here.

tsudmi · 2026-04-13T11:42:36Z

+Your only [costs](/docs/fees/intro) are Ethereum gas for transactions and a small fee on rewards — set by the Vault operator<sup><a href="#fn-1" id="fnref-1">1</a></sup>.
+If you mint osETH, the StakeWise DAO takes an additional 5% of its accrued rewards.
+
+Risk is contained by design: each Vault is isolated<sup><a href="#fn-2" id="fnref-2">2</a></sup>, and osETH is overcollateralized<sup><a href="#fn-3" id="fnref-3">3</a></sup>.


tsudmi · 2026-04-13T12:14:07Z

+
+Vault staking gives you control over exactly how your assets are staked. Unlike [one-click staking](./stake-with-one-click.mdx), you can choose a specific Vault based on its node operators, MEV strategy, and fees. Each Vault is fully isolated: your rewards come solely from your chosen Vault's performance, and you're protected from slashing penalties incurred by validators in other Vaults. Each Vault page shows a detailed rewards chart you can review before you stake. You can stake and withdraw as easily as with one-click staking.
+
+<Image img={require('./img/stake_with_a_vault.png')} alt="Staking with a Vault explanation diagram" />


Here and in other similar images, lets not add image next to the title:

tsudmi · 2026-04-13T12:26:47Z

+If you mint osETH, your position gets a [health score](/docs/ostoken/how-ostoken-works#position-health) based on how much osETH you've minted relative to your staked ETH (the <Tooltip content="The ratio of minted osETH value to your staked ETH. The higher the LTV, the closer your position is to redemption or liquidation.">Loan-to-Value ratio</Tooltip>). There are four health levels — healthy, moderate, risky, and unhealthy. If your position becomes unhealthy, it may be subject to [redemption or liquidation](/docs/ostoken/how-ostoken-works#peg-maintenance). You can improve it anytime by burning osETH or adding more stake.
+:::


It’s worth noting that position health also depends on the APY of osETH relative to the vault APY. The larger the gap (vault APY < osETH APY), the worse the position health.

tsudmi · 2026-04-13T12:31:15Z

 ---
 title: How to Use Boost
-sidebar_position: 1
 description: Step-by-step guide to boosting and unboosting your staking position with StakeWise Boost.


We only describe how to boost/unboost with vaults, but nothing about the stake page (simple staking)

tsudmi · 2026-04-13T12:35:35Z

@@ -1,21 +1,22 @@
 ---
 title: How to Use Boost


As we don't use screenshots on other pages, lets also remove it from here

tsudmi · 2026-04-13T12:36:58Z

 Periodically check on your Vault position to ensure the Boost APY is positive. If you see a negative Boost APY for longer than 7 days in a row, consider unboosting your position. Stay informed for real-time updates via the [StakeWise Discord ↗](https://discord.com/invite/2BSdr2g).
 :::

-## Unboosting Process


It's worth mentioning that you can add an email to receive an alert as soon as the unboosted position is ready to be claimed.

evgeny-stakewise · 2026-04-20T13:06:44Z

+<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.
+2. Click the **swap arrows** icon (top-left) to switch from staking to unstaking mode.


confused about swap arrows icon term.
Maybe add small inline image right after 'icon' word to make things clear.
I see the icon is called 'flip button' in sources.
I like 'flip' word, maybe it's better term than 'swap arrows'.

evgeny-stakewise · 2026-04-20T14:08:55Z

+- If you unstake more than you staked (e.g. you also bought osETH on the market), the staked portion enters the exit queue while the rest is swapped instantly via an exchange.
+- If you never staked and only bought osETH on the market, the swap happens instantly via an exchange.


for me 'unstake' tab shows 0 available for unstaking although i have some osGno bought on dex

…staker-section

evgeny-stakewise · 2026-04-24T10:10:44Z

+3. Select the **Unstake** tab and enter the amount of osETH you want to convert back to ETH.
+4. Review the details.
+5. Click **Unstake** and confirm the transaction in your wallet.
+6. Once confirmed, your ETH (original stake plus accumulated rewards) will be returned to your wallet.


Need to wait until exit request is processed (takes some hours or days), then claim action will be available. Only when claiming, user gets his stake back.

evgeny-stakewise · 2026-04-24T10:12:27Z

+
+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 in the **Swap** section of the StakeWise App or sell it on a DEX.
+
+<Image img={require('./img/unstaking_flow.png')} alt="Unstaking flow explanation diagram" />


'claim' part is missing. I see 'claim' step is present on vault staking page image. The same pattern works here, in simple staking.

ulieth added 6 commits April 3, 2026 10:54

create staker section with dedicated sidebar and navigation

6b03841

add staker introduction and rewards pages

f15f999

rewrite introduction and rewards sections

f6061b2

updated introduction with prose-styled text and an image

c896907

create staker documentation section

cb7ebab

vercel Bot deployed to Preview April 10, 2026 14:31 View deployment

ulieth added 4 commits April 13, 2026 12:08

add visuals, imrpove safety section, remove wallet choice mention

817f332

merge staking-into-a-vault into vaults intro, remove unused sidebar_p…

b0fa767

…osition and description quotes from concepts docs

add how-it-works section to staker introduction from vault concepts

57f42d8

remove redundant oseth liquidity mention

e0e9477

tsudmi reviewed Apr 13, 2026

View reviewed changes

update staker section

126a1d3

vercel Bot deployed to Preview April 14, 2026 14:13 View deployment

evgeny-stakewise reviewed Apr 20, 2026

View reviewed changes

ulieth added 2 commits April 21, 2026 11:43

Merge branch 'main' of github.com:stakewise/stakewise-docs into docs/…

a9b2a3a

…staker-section

updated grammar, unstaking flow explanation

bc455cc

vercel Bot deployed to Preview April 21, 2026 14:34 View deployment

evgeny-stakewise reviewed Apr 24, 2026

View reviewed changes


		## Why Stake with StakeWise?

		Stake any amount of ETH, earn [rewards](/staker/rewards) automatically, mint [osETH](/docs/ostoken/intro) to stay liquid while your ETH keeps earning, and [withdraw whenever you want](/docs/vaults/how-vaults-work#withdrawals).

	Your only [costs](/docs/fees/intro) are Ethereum gas for transactions and a small fee on rewards — set by the Vault operator<sup><a href="#fn-1" id="fnref-1">1</a></sup>.
	Your only [costs](/docs/fees/intro) are Ethereum gas for transactions and a fee on rewards — set by the Vault operator<sup><a href="#fn-1" id="fnref-1">1</a></sup>.


		Vault staking gives you control over exactly how your assets are staked. Unlike [one-click staking](./stake-with-one-click.mdx), you can choose a specific Vault based on its node operators, MEV strategy, and fees. Each Vault is fully isolated: your rewards come solely from your chosen Vault's performance, and you're protected from slashing penalties incurred by validators in other Vaults. Each Vault page shows a detailed rewards chart you can review before you stake. You can stake and withdraw as easily as with one-click staking.

		<Image img={require('./img/stake_with_a_vault.png')} alt="Staking with a Vault explanation diagram" />

		If you mint osETH, your position gets a [health score](/docs/ostoken/how-ostoken-works#position-health) based on how much osETH you've minted relative to your staked ETH (the <Tooltip content="The ratio of minted osETH value to your staked ETH. The higher the LTV, the closer your position is to redemption or liquidation.">Loan-to-Value ratio</Tooltip>). There are four health levels — healthy, moderate, risky, and unhealthy. If your position becomes unhealthy, it may be subject to [redemption or liquidation](/docs/ostoken/how-ostoken-works#peg-maintenance). You can improve it anytime by burning osETH or adding more stake.
		:::

		- If you unstake more than you staked (e.g. you also bought osETH on the market), the staked portion enters the exit queue while the rest is swapped instantly via an exchange.
		- If you never staked and only bought osETH on the market, the swap happens instantly via an exchange.


		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 in the Swap section of the StakeWise App or sell it on a DEX.

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

Conversation

ulieth commented Apr 10, 2026

Uh oh!

vercel Bot commented Apr 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

evgeny-stakewise Apr 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

vercel Bot commented Apr 10, 2026 •

edited

Loading

evgeny-stakewise Apr 20, 2026 •

edited

Loading