Docs

Canonical state and freshness

Understand Torq read ownership, freshness evidence, and post-transaction completion.

Torq integrations consume shared state through:

Chain -> Indexer -> Projector -> Postgres -> API

Do not reconstruct shared protocol state from RPC. The API returns freshness evidence including status, lag, block, projection time, snapshot time, and a reason when state is stale or missing.

Workflow lifecycle

StatusMeaning
preparedTyped intents were built against a named canonical snapshot.
submittedYour signer submitted and registered the transaction.
minedThe transaction is in a block; product state is not yet complete.
indexedThe relevant chain events were consumed.
persisted_visibleCanonical Postgres reads show the expected state.
final_successEvery declared postcondition passed.
failedExecution, indexing, reorg handling, or canonical readback failed.

Every prepared workflow includes a snapshot hash, expiry, simulation requirement, blocked reasons, and expected postconditions. Re-prepare after expiry or stale-state rejection.

On this page