Struct KindTieredHandler 

pub struct KindTieredHandler<'h> { /* private fields */ }

A stackable ExternalFnHandler that tiers externals by PolicyKind before delegating to a real handler.

• Query externals are always delegated live to inner (including a Pending result, passed straight through for async resolution).
• Effect externals are delegated live only when context == EvalContext::Eval and live_effects is armed; otherwise they resolve to ExternalResult::Fallback (the ink fallback body, or a named-external VM error if none is declared).
• A name absent from kinds is treated as Effect — conservative by default.

No coupling to crate::Speculation — this is a plain composable handler, usable anywhere an &dyn ExternalFnHandler is accepted.

Implementations

impl<'h> KindTieredHandler<'h>

pub fn new( inner: &'h dyn ExternalFnHandler, kinds: HashMap<String, PolicyKind>, context: EvalContext, live_effects: bool, ) -> Self

Build a handler gating calls to inner by kinds.

kinds maps ink-declared external names to their PolicyKind; a name absent from the map is treated as Effect. context picks the evaluation regime; live_effects arms Effect externals when context == EvalContext::Eval (ignored under Watch, where effects never fire live).

pub fn report(&self) -> ExternalsReport

Snapshot of which externals have run live versus fallen back so far. Diagnostic only.

Trait Implementations

impl ExternalFnHandler for KindTieredHandler<'_>

fn call(&self, name: &str, args: &[Value]) -> ExternalResult

Handle an external function call.