Struct CandidateDisposal 

pub struct CandidateDisposal {
    pub existing_event: Option<EventId>,
    pub wallet: WalletId,
    pub date: TaxDate,
    pub sat: Sat,
    pub kind: DisposeKind,
    pub proceeds: Option<Usd>,
}

A candidate disposal to be evaluated (without persisting anything).

• existing_event = Some(id) — re-score an event already in the ledger with a candidate selection. The event’s own proceeds AND its resolved principal sat are used; both proceeds and sat on the candidate are ignored (M2: an injected selection is validated against the event’s resolved principal, so a wrong candidate.sat cannot mis-score).
• existing_event = None — a synthetic/hypothetical disposal (Mode-2 consultation). The engine appends a temporary Op::Dispose with the given proceeds (or FMV from the dataset when proceeds is None), folds, and discards the result.

Fields

existing_event: Option<EventId>

Some(id) → score an existing disposal; None → synthetic (Mode-2).

wallet: WalletId

date: TaxDate

sat: Sat

kind: DisposeKind

proceeds: Option<Usd>

Explicit proceeds (wins over FMV). Required for synthetic disposals on dates with no price entry — evaluate_disposal returns Err(ProceedsRequired) when both this and the dataset FMV are absent.

Trait Implementations

impl Clone for CandidateDisposal

fn clone(&self) -> CandidateDisposal

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CandidateDisposal

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

Formats the value using the given formatter.