skarbiec acquisition-read

Invocation#

skarbiec acquisition-read <consumer> <item> <field> --token <one-use-token>

Purpose#

Consume one acquisition token and return only its bound field.

Required inputs and options#

• Requires the exact consumer, item, field, and --token returned by acquisition-request.

Output and state effects#

• Atomically removes the token hash before returning value, then appends acquisition-consumed; output carries the bound value, the request identifiers, and the item's declared provider when the item declares one. The provider key is absent rather than null when it does not, so absence cannot be read as a declaration.

Refusals#

• Returns unauthorized for an expired, replayed, mismatched, or unknown token and refuses hidden/unconfirmed lifecycle candidates without spending them.