Enum AddShareOutcome 

pub enum AddShareOutcome<S: PixSpec> {
    Duplicate,
    Surplus,
    Absorbed,
    Useful,
    Completed(PixScalar<S>),
}

What a share contributed to its polynomial.

The three non-contributing outcomes are kept apart from one another because they are not equivalent to a caller counting progress: a Duplicate says the peer re-sent an evaluation point, a Surplus says it is still emitting for a polynomial that is already done (expected — the Entry sends threshold + surplus shares per polynomial), and Absorbed says the polynomial has already failed and nothing can change that.

Variants

Duplicate

Same evaluation identifier as a share already collected for this polynomial.

Surplus

Arrived after the polynomial was already reconstructed.

Absorbed

Arrived after the polynomial failed to open its commitment, and was discarded.

Useful

New and distinct, but the threshold is not reached yet.

Completed(PixScalar<S>)

Reached the threshold; the constant term reconstructed and opened its commitment.