Struct CanonicalEncoder 

pub struct CanonicalEncoder { /* private fields */ }

An in-progress canonical encoding, opened under one domain tag.

Every value is length-prefixed (u64 big-endian) so no concatenation can alias two encodings; lists are additionally count-prefixed.

Implementations

impl CanonicalEncoder

pub fn new(domain_tag: &[u8]) -> Self

Open an encoding under a domain tag such as b"perspt-prompt-v1". The tag itself is the first length-prefixed field.

pub fn field(&mut self, bytes: &[u8]) -> &mut Self

Append one length-prefixed byte field.

pub fn text(&mut self, value: &str) -> &mut Self

Append one length-prefixed UTF-8 field.

pub fn u64(&mut self, value: u64) -> &mut Self

Append a fixed-width unsigned integer (no length prefix needed).

pub fn bool(&mut self, value: bool) -> &mut Self

Append one boolean byte.

pub fn list<I>(&mut self, entries: I) -> &mut Self

where I: ExactSizeIterator, I::Item: AsRef<str>,

Append a count-prefixed list of text entries.

pub fn finish(self) -> Vec<u8>

The finished canonical bytes.

pub fn digest(self) -> String

SHA-256 over the finished canonical bytes, hex encoded with a sha256: prefix so a digest names its own algorithm.

Trait Implementations

impl Debug for CanonicalEncoder

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

Formats the value using the given formatter.