Enum HookError 

#[non_exhaustive]
pub enum HookError {
    BudgetExceeded,
    CapabilityDenied(CapToken),
    Trapped(&'static str),
    PolicyReValidationFailed,
}

Hook execution outcome.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

BudgetExceeded

Hook invocation exceeded the 10 ms / fuel budget. Surfaces only from sandbox-backed hosts; the no-op pass-through never returns this.

CapabilityDenied(CapToken)

Hook tried to import a host function not in its capability set. Rejected at module-load (sandbox-backed host) or as a call-site fallback.

Trapped(&'static str)

Hook invocation trapped — host catches and quarantines without propagating the unwind (analog of L0 A22).

PolicyReValidationFailed

Post-hook policy re-validation rejected the mutated extra bytes (confused-deputy defense — hook attempted to flip policy outcome).

Trait Implementations

impl Debug for HookError

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

Formats the value using the given formatter.

impl Display for HookError

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

Formats the value using the given formatter.

impl Error for HookError

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.