Enum RotationError 

pub enum RotationError {
    WrongPhase {
        current: RotationPhase,
        expected: RotationPhase,
    },
    SameKey,
    InvalidTransitionWindow,
    TransitionStillOpen {
        until: DateTime<Utc>,
    },
    NoRotationInProgress,
    Encoding(String),
    Signer(SignerError),
}

Errors the state machine can produce.

Variants

WrongPhase

Tried to do something in the wrong phase (e.g. retire while still active). Hints at an operator misstep in the runbook.

Fields

current: RotationPhase

What phase the state machine is in.

expected: RotationPhase

What phase the operation expected.

SameKey

begin_handover was called with the same key id as the current signer. A no-op rotation would still publish an event that every host would refuse.

InvalidTransitionWindow

begin_handover was called with a non-positive transition window. Hosts must have a real overlap window or rotation is just an atomic swap from their perspective.

TransitionStillOpen

retire_old was called but the transition window hasn’t elapsed yet. Tells the operator to wait or override (override is a separate code path).

Fields

until: DateTime<Utc>

When the window closes.

NoRotationInProgress

retire_old was called but no rotation has been started yet.

Encoding(String)

JCS encoding failed. Should be impossible for the fixed-shape payload, but propagated rather than panicked.

Signer(SignerError)

The underlying signer failed.

Trait Implementations

impl Debug for RotationError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for RotationError

fn fmt(&self, __formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for RotationError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<SignerError> for RotationError

fn from(source: SignerError) -> Self

Converts to this type from the input type.