Enum Threshold 

pub enum Threshold {
    Simple(u64),
    Weighted(Vec<Vec<Fraction>>),
}

KERI signing/backer threshold.

Simple thresholds are hex-encoded integers ("1", "2", "a"). Weighted thresholds are clause lists of fractions ([["1/2","1/2"]]). Clauses are ANDed; each is satisfied when the sum of verified weights >= 1.

Usage:

use auths_keri::Threshold;
let t: Threshold = serde_json::from_str("\"2\"").unwrap();
assert_eq!(t.simple_value(), Some(2));

Variants

Simple(u64)

M-of-N threshold (hex-encoded integer in JSON).

Weighted(Vec<Vec<Fraction>>)

Fractionally weighted threshold (list of clause lists in JSON). Clauses are ANDed; each is satisfied when sum of verified weights >= 1.

Implementations

impl Threshold

pub fn simple_value(&self) -> Option<u64>

Get the simple threshold value, if this is a simple threshold.

pub fn validate_satisfiable(&self, count: usize) -> Result<(), KeriTypeError>

Check that this threshold is structurally satisfiable against a key (or commitment / backer) list of length count.

This is a structural guard run at validation entry — it rejects events whose threshold can never be met regardless of which signatures arrive: a Simple(n) with n > count, a non-zero Simple over an empty list, or a Weighted clause whose length doesn’t match count.

Args:

• count - Length of the list the threshold governs (k, n, or b).

Usage:

use auths_keri::Threshold;
assert!(Threshold::Simple(2).validate_satisfiable(3).is_ok());
assert!(Threshold::Simple(5).validate_satisfiable(1).is_err());

pub fn is_satisfied(&self, verified_indices: &[u32], key_count: usize) -> bool

Check if the threshold is satisfied by the given set of verified key indices.

For Simple(n): at least n unique indices must be verified. For Weighted(clauses): ALL clauses must be independently satisfied. A clause is satisfied when the sum of weights at verified indices >= 1.

Args:

• verified_indices - Indices of keys whose signatures have been verified.
• key_count - Total number of keys in the key list (for bounds checking).

Usage:

use auths_keri::Threshold;
let t = Threshold::Simple(2);
assert!(t.is_satisfied(&[0, 1], 3));
assert!(!t.is_satisfied(&[0], 3));

Trait Implementations

impl Clone for Threshold

fn clone(&self) -> Threshold

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Threshold

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

Formats the value using the given formatter.

impl Default for Threshold

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Threshold

fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl Eq for Threshold

impl PartialEq for Threshold

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Threshold

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Threshold