Module recovery

Recovery planning for failed or stuck vault operations.

This module only derives recovery actions from explicit state and evidence. It does not execute those actions, and it does not invent payout outcomes when the available information is incomplete.

Structs

RecoveryContext

Context for determining whether recovery is eligible.

RecoveryOutcome

Result of planning a recovery operation.

RecoveryProgress

Progress timestamps for a specific in-flight operation.

RecoveryStats

Compute recovery statistics from the current state.

Enums

PayoutRecoveryEvidence

Evidence required to settle a payout during recovery.

RecoveryError

Recovery planning error.

RecoveryPolicy

Recovery eligibility policy.

Functions

compute_payout_failure_outcome

Compute a failure payout outcome from escrow shares and idle restore amount.

compute_payout_success_outcome

Compute a success payout outcome from escrow and collected amounts.

compute_recovery_stats

compute_settlement_shares

Compute the shares to burn and refund based on collected vs expected amounts.

determine_recovery_action

Determine the appropriate recovery action for the current state.

plan_allocation_recovery

Plan recovery for a failed allocation operation.

plan_payout_recovery

Plan recovery for a payout using explicit outcome evidence.

plan_refresh_recovery

Plan recovery for a failed refresh operation.

plan_withdrawal_recovery

Plan recovery for a failed withdrawal operation.