Module retry 

Explicit retry ownership, replay identity, and bounded decision policy.

Structs

CanonicalFingerprint

Caller-buffer canonical request fingerprint cleared on drop.

FingerprintDigest

Caller-buffer collision-resistant digest cleared on drop.

FingerprintRef

Borrowed exact or collision-resistant request fingerprint.

IdempotencyBinding

One-use local idempotency identity bound to one exact request fingerprint.

IdempotencyIntent

One-use fresh intent identifier supplied by a caller CSPRNG.

MaxAttempts

Nonzero total attempt bound, including the initial attempt.

MonotonicDuration

Caller-observed monotonic duration in implementation-defined ticks.

MonotonicInstant

Caller-observed monotonic instant in implementation-defined ticks.

RetryController

Non-cloneable owner of one request’s retry state and idempotency intent.

RetryPermit

Non-cloneable authorization for one exact prepared replay.

RetryPolicy

Complete caller-owned retry budgets.

RetrySubject

One prepared request inseparably bound to its canonical fingerprint.

Enums

DigestAlgorithm

Admitted collision-resistant digest algorithms.

FingerprintBuildError

Canonical fingerprint or digest construction failure.

FingerprintScope

Explicit account or tenant scope bound into a request fingerprint.

IdempotencyIntentError

Invalid caller-provided idempotency intent.

MaxAttemptsError

Invalid maximum attempt count.

RetryDecision

Retry admitted or stopped without sleeping or executing transport.

RetryEvent

Failure observation considered by the retry owner.

RetryExecutionError

Retry authorization or prepared transport execution failure.

RetryPermitError

Why a one-use retry permit did not authorize execution.

RetryPolicyError

Retry-controller construction or state-transition failure.

RetryStopReason

Fail-closed reason why no new attempt is admitted.

Constants

MAX_FINGERPRINT_DIGEST_BYTES

Maximum supported collision-resistant digest output.

MAX_FINGERPRINT_SCOPE_BYTES

Maximum account or tenant scope bytes admitted to a fingerprint.

MAX_IDEMPOTENCY_INTENT_BYTES

Maximum intent bytes retained by the borrowed retry contract.

MIN_IDEMPOTENCY_INTENT_BYTES

Minimum entropy bytes admitted for one fresh operation intent.

Traits

FingerprintHasher

Caller-provided collision-resistant fingerprint digest implementation.

Functions

build_canonical_fingerprint

Builds exact versioned canonical bytes into caller-owned storage.

build_fingerprint_digest

Builds and hashes canonical bytes, clearing caller scratch on every path.