Skip to content

Error codes

CodeMeaningSidecar action
FENCING_EPOCH_STALESidecar’s lease expiredFail-closed; re-acquire (GA gate)
RESERVATION_STATE_CONFLICTReservation not in expected stateAdapter SHOULD re-query reservation context
RESERVATION_TTL_EXPIREDReservation TTL passed before commitTTL sweeper releases automatically
PRICING_FREEZE_MISMATCHBundle pricing differs from claim’s pricingOperator: re-issue bundle
OVERRUN_RESERVATIONEstimated > original reservedAdapter MUST split into separate calls
MULTI_RESERVATION_COMMIT_DEFERREDMulti-claim ReserveSet not in POCUse single-claim
IDEMPOTENCY_CONFLICTIdempotency key reused with different bodySurface to caller as hard error
AUDIT_INVARIANT_VIOLATEDSP found audit chain inconsistencyPage on-call; not retriable

See services/sidecar/src/domain/error.rs and proto/spendguard/common/v1/common.proto Error.Code enum for the authoritative list.