Label Contract
Every status or error should be readable without relying only on color, private context, or insider shorthand.
Tooling can read the static failure matrix at data/failure-matrix.json. The file describes expected public states and next checks; it is not proof that recovery has happened live.
LabelMeaningExpected public next step
PendingThe action or observation is waiting for a public condition, confirmation, payment, proof, or owner decision.Show owner, last update, expected next check, and expiry if known.
RefusedThe owning surface rejected the action, interpretation, route, payload class, or state transition.Show refusal reason, owner, receipt/refusal id where public, and whether a different path exists.
StaleThe value was once observed but is too old to present as current.Show last update time and downgrade the claim.
UnavailableThe route, endpoint, product lane, or status surface is not answering under its public contract.Show fallback page, owner, and what cannot be verified now.
UnpaidAn accepted paid action is waiting for the required payment proof or accepted quote state.Show quote id, denom, expected amount, expiry, and payment boundary where public.
ExpiredThe quote, route, proof window, proposal, or action window is no longer valid.Show whether a new quote, new route, or new proposal is required.
DuplicateThe request repeats a known receipt, transaction, quote, route, or action id.Link to the original public record where safe.
InvalidThe input does not match the public contract: wrong denom, bad id, wrong route, unsupported payload class, or malformed request.Show the expected format without exposing private validation detail.
UnauthorizedThe requester is not allowed to perform the action or view the private material.Show the public permission boundary, not private access logic.
DegradedThe route answers below normal freshness, reliability, or completeness.Show weaker confidence, owner, and last successful public check.