Returns retained history rows for a KV key when history is available. Missing or unavailable history maps to an optional-read result.

Optional reads distinguish present data from missing data. When version or timestamp facts exist on the executor output, SDK mappings should preserve them.

Examples

A key that never existed has no history.

CLI

$ strata kv history absent

Wire

{"key":"YWJzZW50","type":"kv_history"}

Parameters

Name	Type	Required	Description
key	Bytes	yes	Key to read.

Plus the optional scope: branch and space (default to the session branch and the "default" space).

Returns

Maybe<Vec<HistoryItem>> — a miss returns nothing rather than raising.

Errors

• failed_precondition.engine.runtime_closed
• not_found.engine.branch
• invalid_argument.engine.product_space
• invalid_argument.engine.kv_key

Invocation

• CLI: strata kv history
• Wire type: kv_history