Maintenance is requested, approved, and tracked.
Users should not need direct infrastructure access. The portal collects the request, the API validates it against the allowlist, and the worker executes only supported actions through the canonical NABD maintenance CLI.
Safe order of work
- Confirm chain facts: chain ID, profile, supply, treasury, and genesis hash.
- Check network health before any change.
- Run diagnosis to understand the issue and recommended action.
- Create a snapshot before any repair work that touches node state.
- Change one node at a time and re-check health.
- Confirm result is recorded so admins can review what happened.
Operations catalogue
Check Health
maintenance.healthviewer · operator · adminread onlyDiagnose Network
maintenance.doctoroperator · adminread onlyView Logs
maintenance.logsoperator · adminread onlyRestart Node
maintenance.restart-nodeoperator · adminguarded mutationCreate Snapshot
maintenance.snapshot-nodeoperator · adminguarded mutationState Sync Node
maintenance.state-sync-nodeadminadmin repairRestore Node
maintenance.restore-nodeadminadmin repairGenerate Wallet
wallet.generateoperator · adminguarded mutationWorker behavior
The worker polls jobs where status = queued, claims the row, and dispatches by action. Successful jobs land as completed with a redacted argv in the result. Failures are failed; dangerous operations that the NABD CLI refuses are stored as blocked so they are not retried automatically.
Keep repair screens focused on the decision: what network, what node, what action, who approved it. Hide command details from normal portal users.