Skip to content
This repository was archived by the owner on Feb 17, 2025. It is now read-only.

Commit 191645a

Browse files
More info about recovering bond (#537)
* More info about recovering bond * Clarify options for recovering bonds Co-authored-by: NicNomadic <148877430+NicNomadic@users.noreply.github.com> * Formatting * Just show one option * Keep the node running --------- Co-authored-by: NicNomadic <148877430+NicNomadic@users.noreply.github.com>
1 parent 5f274f9 commit 191645a

File tree

1 file changed

+12
-3
lines changed

1 file changed

+12
-3
lines changed

docs/architecture/smart-rollups.md

Lines changed: 12 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Smart Rollups
33
authors: 'Nomadic Labs, TriliTech, Tim McMackin'
44
last_update:
5-
date: 17 January 2025
5+
date: 29 January 2025
66
---
77

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

8989
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.
90-
After that refutation period ends, the node operator can recover the bond, which unlocks their tez.
91-
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.
90+
Recovering the bond safely takes a few steps; in general, node operators follow these steps:
91+
92+
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.
93+
94+
1. Keep the node running until the last commitment is cemented.
95+
If operators shut down the node before the last commitment is cemented, they risk losing their bond if another node challenges their commitments.
96+
97+
1. Recover the bond by running the `octez-client recover bond` command, which unlocks their tez.
98+
Nodes running in `bailout` mode run this command automatically when the last commitment is cemented.
99+
100+
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.
92101

93102
### Reveal data channel
94103

0 commit comments

Comments
 (0)