Skip to content

Error codes

Code Meaning Sidecar action
FENCING_EPOCH_STALE Sidecar's lease expired Fail-closed; re-acquire (GA gate)
RESERVATION_STATE_CONFLICT Reservation not in expected state Adapter SHOULD re-query reservation context
RESERVATION_TTL_EXPIRED Reservation TTL passed before commit TTL sweeper releases automatically
PRICING_FREEZE_MISMATCH Bundle pricing differs from claim's pricing Operator: re-issue bundle
OVERRUN_RESERVATION Estimated > original reserved Adapter MUST split into separate calls
MULTI_RESERVATION_COMMIT_DEFERRED Multi-claim ReserveSet not in POC Use single-claim
IDEMPOTENCY_CONFLICT Idempotency key reused with different body Surface to caller as hard error
AUDIT_INVARIANT_VIOLATED SP found audit chain inconsistency Page 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.