Struct ExternalResourcePlan 

pub struct ExternalResourcePlan<A: AsRef<[u8]>> {
    pub manifest_store_present: bool,
    pub resources: Vec<ExternalResourceRequest>,
    pub truncated: bool,
    pub stop_reason: Option<ExternalResourceStopReason>,
    /* private fields */
}

A parse-only, bounded external-resource discovery session.

resources is the current ordered frontier. The caller resolves that frontier into an ExternalResources provider, then calls ExternalResourcePlan::continue_with. The method replaces it with the next frontier. The plan owns asset, so native bindings can retain their own zero-copy byte container without self-referential borrows.

Fields

manifest_store_present: bool

True once an embedded, supplied, or retrieved initial store was located, before parsing it. A malformed embedded store therefore cannot trigger a remote-manifest fallback. false authorizes a different root fallback only when Self::stop_reason is None and Self::resources is empty.

resources: Vec<ExternalResourceRequest>

Current first-seen resource frontier.

truncated: bool

True when discovery terminated before proving the frontier complete.

stop_reason: Option<ExternalResourceStopReason>

Typed terminal reason when truncated is true.

Implementations

impl<A: AsRef<[u8]>> ExternalResourcePlan<A>

pub fn asset(&self) -> &[u8]

Borrow the original asset for the one final verification pass.

pub fn did_documents(&self) -> &[ExternalDidDocumentRequest]

DID documents found by parse-only inspection of active ICA identities.

The list accumulates as retrieved initial stores are parsed. Callers must prefer a document already pinned in VerifyOptions and fetch only entries that remain unresolved.

pub fn continue_with( &mut self, resources: &dyn ExternalResources, ) -> Result<(), Error>

Consume the current frontier from caller-held outcomes and discover the next manifest-store or append-history frontier. No network I/O or verification occurs.