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.

Sign up for GitHub

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

More info about recovering bond #537

Merged
merged 5 commits into from
Jan 31, 2025
Merged

More info about recovering bond #537

Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
2635140
More info about recovering bond
timothymcmackin Jan 29, 2025
81b121a
Clarify options for recovering bonds
timothymcmackin Jan 29, 2025
b85df78
Formatting
timothymcmackin Jan 29, 2025
5d4ba07
Just show one option
timothymcmackin Jan 30, 2025
f795a55
Keep the node running
timothymcmackin Jan 30, 2025
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
15 changes: 12 additions & 3 deletions docs/architecture/smart-rollups.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: Smart Rollups
authors: 'Nomadic Labs, TriliTech, Tim McMackin'
last_update:
date: 17 January 2025
date: 29 January 2025
---

Smart Rollups play a crucial part in providing high scalability on Tezos.
Expand Down Expand Up @@ -87,8 +87,17 @@ When a user runs a node that posts commitments, the protocol automatically locks
If the node posts a commitment that is refuted, they lose their bond, as described in [Refutation periods](#refutation-periods).

Because nodes have the length of the refutation to challenge another node's commitment, the bond stays locked until the end of the refutation period for the last commitment that the node posted.
After that refutation period ends, the node operator can recover the bond, which unlocks their tez.
To simplify the process, node operators can switch to bailout mode, which does not post commitments but continues to defend previously made commitments until the last refutation period ends.
Recovering the bond safely takes a few steps; in general, node operators follow these steps:

1. Switch the rollup node to a mode that defends previously made commitments but does not post new commitments, such as `accuser` mode or `bailout` mode.

1. Keep the node running until the last commitment is cemented.
If operators shut down the node before the last commitment is cemented, they risk losing their bond if another node challenges their commitments.

1. Recover the bond by running the `octez-client recover bond` command, which unlocks their tez.
Nodes running in `bailout` mode run this command automatically when the last commitment is cemented.

For an example of how to use bailout mode to recover your bond, see [Stopping the Smart Rollup node](https://docs.etherlink.com/network/smart-rollup-nodes/#stopping-the-smart-rollup-node) in the Etherlink documentation.

### Reveal data channel

Expand Down
Loading