Struct Signature 

pub struct Signature { /* private fields */ }

A ring signature produced by crate::sign_vote.

The on-the-wire encoding is:

  challenge        : 32 bytes  (canonical Scalar little-endian)
  responses[0]     : 32 bytes
  responses[1]     : 32 bytes
  ...
  responses[n-1]   : 32 bytes

where n is the size of the authorised ring. The ring members themselves are not stored inside the signature: the verifier is expected to already know the canonical authorised list, and to reconstruct the ring from it in the same deterministic order used at signing time. That way the signer cannot ship a hand-picked ring of their own.

Implementations

impl Signature

pub fn to_bytes(&self) -> Vec<u8>

Serialise to the byte layout described in the struct docs.

pub fn from_bytes(bytes: &[u8], ring_size: usize) -> Result<Self>

Deserialise from the byte layout described in the struct docs.

ring_size must be the size of the authorised list the verifier is about to check against. We require it explicitly because the signature on its own cannot tell n scalars from n+1.

pub fn to_hex(&self) -> String

Hex-encode using lowercase digits.

pub fn from_hex(s: &str, ring_size: usize) -> Result<Self>

Decode from a hex string. See Signature::from_bytes for the meaning of ring_size.

pub fn to_prefixed(&self) -> String

Encode in the human-friendly prefixed format: blsag_<hex>_<checksum>. The body length grows with the ring, but the format is otherwise identical to the fixed-size types.

pub fn from_prefixed(s: &str, ring_size: usize) -> Result<Self>

Decode a blsag_<hex>_<checksum> string produced by Signature::to_prefixed, verifying the tag and the checksum. See Signature::from_bytes for the meaning of ring_size.

Trait Implementations

impl Clone for Signature

fn clone(&self) -> Signature

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Signature

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

Formats the value using the given formatter.

impl Eq for Signature

impl PartialEq for Signature

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Signature