CLI command

skarbiec acquisition workloads

List every workload id whose proofs were spent, with the newest proof time it spent.

Invocation#

Shell
skarbiec acquisition workloads

Purpose#

List every workload id whose proofs were spent, with the newest proof time it spent.

Required inputs and options#

  • No argument and no flag. Read without the state lock: every write renames a whole document into place, so a reading never sees half of one. GET /v1/operator/acquisition/workloads answers the same list.

Output and state effects#

  • Prints ok and workloads, each with workload_id, newest (the epoch second of the newest proof it spent) and ahead_of_clock, true when that time lies ahead of this host's clock: such a workload's proofs stay refused until the clock passes it, since that floor is what refuses a replay of its earlier proofs, and the way out is a new workload id. It changes no state.

Refusals#

  • An argument or a flag exits 2 with `acquisition workloads takes no arguments and no flags, and was given <word> beyond it`. A state that cannot be read is refused by acquisition-workloads-unreadable, naming the file and why; the fix is to make it a regular owner-only file (chmod 600), never to remove it, since it is what refuses a spent proof presented again.