Struct DecodeOpts 

#[non_exhaustive]
pub struct DecodeOpts {
    pub allow_unresolved_origin: bool,
}

Options controlling decode-time validation strictness (P0 pathless/ dead-card partial-decode).

The default (allow_unresolved_origin: false) is BYTE-IDENTICAL to pre-P0 decode behavior: Error::MissingExplicitOrigin is raised for any @N whose origin cannot be resolved (no canonical default AND no explicit path_decl/override). When true, that ONE reject is swallowed and the decode succeeds; the caller MUST query crate::encode::Descriptor::unresolved_origin_indices on the returned descriptor to learn which @N are unresolved (nothing extra is recorded on the Descriptor itself).

INVARIANT (funds-load-bearing): this flag relaxes ONLY the validate_explicit_origin_required outcome. No other decode check is affected — placeholder-usage, multipath consistency, tap-script-tree leaf validity, xpub-bytes validity, and (via crate::chunk::reassemble_with_opts) per-chunk BCH, chunk-header consistency, index-gap, and the derived-chunk-set-id / content-id check all stay enforced regardless of this flag. The Error::EmptyOriginOverride reject (P0.3) is likewise a DISTINCT, always-fatal error class — never swallowed by this opt-in, even when allow_unresolved_origin is true (fatal-in-partial).

#[non_exhaustive] (API-freeze, M-2): a future decode-relaxation option can be added as a new field without a SemVer-major bump. Downstream crates therefore cannot construct this with a struct literal — use DecodeOpts::default (strict) or DecodeOpts::partial (partial-allowing) instead.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

allow_unresolved_origin: bool

When true, Error::MissingExplicitOrigin is not raised at decode time. Default false (strict — today’s behavior).

Implementations

impl DecodeOpts

pub fn partial() -> Self

Partial-allowing decode options (allow_unresolved_origin: true), all other (future) options at their Default. The stable constructor for the render-path opt-in (md decode/md inspect, toolkit verify-bundle gate) — preferred over a struct literal since DecodeOpts is #[non_exhaustive].

Trait Implementations

impl Clone for DecodeOpts

fn clone(&self) -> DecodeOpts

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for DecodeOpts

impl Debug for DecodeOpts

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

Formats the value using the given formatter.

impl Default for DecodeOpts

fn default() -> DecodeOpts

Returns the “default value” for a type.

impl Eq for DecodeOpts

impl PartialEq for DecodeOpts

fn eq(&self, other: &DecodeOpts) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for DecodeOpts