Saphan StudioDocs
Reference/Commands

saphan owner-block-settle

Settles a stream's owner-block debt by recording a well-formed owner block from a file, without starting a run, so the stream can be dispatched again.

Settles a stream's owner-block debt by recording a well-formed owner block from a file, without starting a run, so the stream can be dispatched again. The block is checked by the same validator that checks a run's return; a malformed block, or a file without one, is refused by name and nothing is written. It is an owner act: it prints a one-time six-character code on the terminal and waits for it to be typed back, and is refused without a terminal (scripts, CI), inside the console's browser terminal (where the console's passkey prompt is used instead) and after five wrong codes; the code is asked before the block is validated. saphan grammar owner-block prints the block's format, and saphan dry-run owner-block-settle runs the same validation, asks for no code and shows the record row that would be written.

saphan owner-block-settle <stream>
flagtypedefaultwhat it does
--actorstringWho is settling the debt; defaults to SAPHAN_ACTOR, then your configuration.
--filestringA file containing the fenced owner-block-v1 block, optionally with text around it. Required.

Global options apply to every command — see Every command.