Struct sp_core::bandersnatch::vrf::VrfSignData

pub struct VrfSignData {
    pub vrf_inputs: VrfIosVec<VrfInput>,
    pub transcript: Transcript,
}

A Fiat-Shamir transcript and a sequence of VrfInputs ready to be signed.

The transcript will be used as messages for the Fiat-Shamir transform part of the scheme. This data keeps the signature secure but doesn’t contribute to the actual VRF output. If unsure just give it a unique label depending on the actual usage of the signing data.

The vrf_inputs is a sequence of VrfInputs to be signed and which are used to construct the VrfOutputs in the signature.

Fields

vrf_inputs: VrfIosVec<VrfInput>

VRF inputs to be signed.

transcript: Transcript

Associated Fiat-Shamir transcript.

Implementations

impl VrfSignData

pub fn new( label: &'static [u8], transcript_data: impl IntoIterator<Item = impl AsRef<[u8]>>, vrf_inputs: impl IntoIterator<Item = VrfInput> ) -> Result<Self, ()>

Construct a new data to be signed.

The transcript_data is used to construct the Fiat-Shamir Transcript. Fails if the vrf_inputs yields more elements than MAX_VRF_IOS

Refer to the VrfSignData for more details about the usage of transcript_data and vrf_inputs

pub fn new_unchecked( label: &'static [u8], transcript_data: impl IntoIterator<Item = impl AsRef<[u8]>>, vrf_inputs: impl IntoIterator<Item = VrfInput> ) -> Self

Construct a new data to be signed.

The transcript_data is used to construct the Fiat-Shamir Transcript. At most the first MAX_VRF_IOS elements of vrf_inputs are used.

Refer to the VrfSignData for more details about the usage of transcript_data and vrf_inputs

pub fn push_transcript_data(&mut self, data: &[u8])

Append a raw message to the transcript.

pub fn push_vrf_input(&mut self, vrf_input: VrfInput) -> Result<(), VrfInput>

Append a VrfInput to the vrf inputs to be signed.

On failure, gives back the VrfInput parameter.

pub fn challenge<const N: usize>(&self) -> [u8; N]

Create challenge from the transcript contained within the signing data.

Trait Implementations

impl Clone for VrfSignData

fn clone(&self) -> VrfSignData

Returns a copy of the value.

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

Performs copy-assignment from source.