commonware-utils 2026.10.0

Leverage common functionality across multiple primitives.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47

use commonware_codec::{Codec, EncodeFixed};
use core::{
    cmp::Ord,
    fmt::{Debug, Display},
    hash::Hash,
    ops::Deref,
};

pub mod fixed_bytes;
pub use fixed_bytes::FixedBytes;
pub mod u64;
pub use u64::U64;
pub mod prefixed_u64;
pub mod vec_u64;
pub use vec_u64::VecU64;
pub mod u32;
pub use u32::U32;
pub mod unit;
pub use unit::Unit;

/// Types that can be read from a variable-size byte sequence.
///
/// `Span` is typically used to parse things like requests from an untrusted
/// network connection (with variable-length fields). Once parsed, these types
/// are assumed to be well-formed (which prevents duplicate validation).
pub trait Span:
    Clone + Send + Sync + 'static + Ord + Debug + Hash + Display + Codec<Cfg = ()>
{
}

impl Span for u8 {}
impl Span for u16 {}
impl Span for u32 {}
impl Span for u64 {}
impl Span for u128 {}
impl Span for i8 {}
impl Span for i16 {}
impl Span for i32 {}
impl Span for i64 {}
impl Span for i128 {}

/// Types that can be fallibly read from a fixed-size byte sequence.
///
/// `Array` is typically used to parse things like `PublicKeys` and `Signatures`
/// from an untrusted network connection. Once parsed, these types are assumed
/// to be well-formed (which prevents duplicate validation).
pub trait Array: Span + EncodeFixed + AsRef<[u8]> + Deref<Target = [u8]> {}