@@ -118,6 +118,40 @@ dotns --password test-password register domain --account default --name coolname
118118
119119# With reverse record
120120dotns --password test-password register domain --account default --name coolname42 --reverse
121+
122+ # Auto-retry on failure, resuming from the cached commitment (here, up to 3 times)
123+ dotns --password test-password register domain --account default --name coolname42 --retry 3
124+ ```
125+
126+ ### Resume and manage commitments
127+
128+ Registration is a two-step commit-reveal: the commit lands on-chain, then after the
129+ minimum commitment age the reveal completes the mint. If the reveal is interrupted
130+ (crash, network drop, closed terminal), the commitment is cached locally so it can be
131+ resumed rather than restarted. The reveal secret is encrypted at rest with your
132+ credential (keystore password, mnemonic, or key URI); the rest of the record is
133+ plaintext so it can be listed and cleared without unlocking.
134+
135+ Records live under ` ~/.dotns/registrations/ ` (override with ` DOTNS_REGISTRATION_DIR ` ).
136+
137+ ``` bash
138+ # Resume the most recent interrupted registration
139+ dotns --password test-password register retry --account default
140+
141+ # Resume a specific cached commitment by name
142+ dotns --password test-password register retry coolname42 --account default
143+
144+ # List cached commitments and their on-chain status
145+ dotns register list
146+
147+ # Review cached commitments: purges completed ones, then prompts for any pending
148+ dotns --password test-password register clear --account default
149+
150+ # Non-interactively discard pending commitments
151+ dotns register clear --discard
152+
153+ # Non-interactively complete pending commitments
154+ dotns --password test-password register clear --register --account default
121155```
122156
123157### Register Subnames
0 commit comments