Enum ProvenanceKind 

pub enum ProvenanceKind {
    Purchase,
    Gift,
    Inheritance,
    Mining,
    Earned,
    Airdrop,
    Fork,
}

The units’ real acquisition provenance (BG-D5). A CLOSED enumeration: only Purchase clears the promote gate — every other value has a documented FMV-at-receipt/carryover basis from the return (Notice 2014-21; Rev. Rul. 2019-24) and is refused, pointed at modeling the real acquisition instead. CLI-facing only (not part of the persisted schema — only provenance_attested: bool plus the fixed PROVENANCE_TEXT/PROVENANCE_VERSION are stored on the event, per T1’s Acknowledgment).

Variants

Purchase

Gift

Inheritance

Mining

Earned

Airdrop

Fork

Implementations

impl ProvenanceKind

pub const ALL: &[ProvenanceKind]

The CLOSED enumeration, in --provenance declaration order — the SINGLE list a driver offers the filer to choose from. Added for the TUI Promote flow’s BG-D5 provenance step (P-C gate tax I-2): the wizard must make the filer SELECT their acquisition provenance exactly as --provenance makes the CLI filer select it, and btctax-tui-edit does not depend on clap, so it cannot reach ValueEnum::value_variants(). Kept in lock-step with the enum by tests::provenance_all_covers_every_clap_value_variant.

★ A slice, not a fixed-length array (whole-branch arch Nit-N1, narrowed before the first publish): [ProvenanceKind; 7] bakes the variant COUNT into the public type, so adding a provenance kind would be a breaking change for every downstream matcher. As a slice that addition is purely additive.

pub fn label(self) -> &'static str

The filer-facing label for one variant. pub (widened from pub(crate) for the TUI Promote flow’s BG-D5 step): the chokepoint (crate::chokepoint::refuse_non_purchase) builds its refusal copy from this, so a driver offering the enumeration renders the SAME words the refusal names — no second copy of the enumeration’s wording.

Trait Implementations

impl Clone for ProvenanceKind

fn clone(&self) -> ProvenanceKind

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ProvenanceKind

impl Debug for ProvenanceKind

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

Formats the value using the given formatter.

impl Eq for ProvenanceKind

impl PartialEq for ProvenanceKind

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ProvenanceKind

impl ValueEnum for ProvenanceKind

fn value_variants<'a>() -> &'a [Self]

All possible argument values, in display order.

fn to_possible_value<'a>(&self) -> Option<PossibleValue>

The canonical argument value.

fn from_str(input: &str, ignore_case: bool) -> Result<Self, String>

Parse an argument into Self.