Struct snarkvm_wasm::traits::utilities::uint::UInt8

pub struct UInt8 {
    pub bits: Vec<Boolean, Global>,
    pub negated: bool,
    pub value: Option<u8>,
}

Fields

bits: Vec<Boolean, Global>

negated: bool

value: Option<u8>

Implementations

impl UInt8

pub fn constant_vec(values: &[u8]) -> Vec<UInt8, Global>

Construct a constant vector of UInt8 from a vector of u8

pub fn alloc_vec<F, CS, T>(
    cs: CS,
    values: &[T]
) -> Result<Vec<UInt8, Global>, SynthesisError> where
    CS: ConstraintSystem<F>,
    T: Into<Option<u8>> + Copy,
    F: Field, 

pub fn alloc_input_vec_le<F, CS>(
    cs: CS,
    values: &[u8]
) -> Result<Vec<UInt8, Global>, SynthesisError> where
    CS: ConstraintSystem<F>,
    F: PrimeField, 

Allocates a vector of u8’s by first converting (chunks of) them to F elements, (thus reducing the number of input allocations), and then converts this list of F gadgets back into bytes.

impl UInt8

pub fn constant(value: u8) -> UInt8

Trait Implementations

impl<F> Add<F, UInt8> for UInt8 where
    F: Field + PrimeField, 

type ErrorType = SynthesisError

pub fn add<CS>(
    &self,
    cs: CS,
    other: &UInt8
) -> Result<UInt8, <UInt8 as Add<F, UInt8>>::ErrorType> where
    CS: ConstraintSystem<F>, 

impl<F> AllocGadget<u8, F> for UInt8 where
    F: Field, 

pub fn alloc<Fn, T, CS>(cs: CS, value_gen: Fn) -> Result<UInt8, SynthesisError> where
    Fn: FnOnce() -> Result<T, SynthesisError>,
    CS: ConstraintSystem<F>,
    T: Borrow<u8>, 

pub fn alloc_input<Fn, T, CS>(
    cs: CS,
    value_gen: Fn
) -> Result<UInt8, SynthesisError> where
    Fn: FnOnce() -> Result<T, SynthesisError>,
    CS: ConstraintSystem<F>,
    T: Borrow<u8>, 

pub fn alloc_constant<Fn, T, CS>(
    _cs: CS,
    _f: Fn
) -> Result<Self, SynthesisError> where
    Fn: FnOnce() -> Result<T, SynthesisError>,
    CS: ConstraintSystem<F>,
    T: Borrow<V>, 

pub fn alloc_checked<Fn, T, CS>(cs: CS, f: Fn) -> Result<Self, SynthesisError> where
    Fn: FnOnce() -> Result<T, SynthesisError>,
    CS: ConstraintSystem<F>,
    T: Borrow<V>, 

pub fn alloc_input_checked<Fn, T, CS>(
    cs: CS,
    f: Fn
) -> Result<Self, SynthesisError> where
    Fn: FnOnce() -> Result<T, SynthesisError>,
    CS: ConstraintSystem<F>,
    T: Borrow<V>, 

impl Clone for UInt8

pub fn clone(&self) -> UInt8

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<F> ComparatorGadget<F> for UInt8 where
    F: Field + PrimeField, 

pub fn greater_than<CS>(
    &self,
    cs: CS,
    other: &Self
) -> Result<Boolean, SynthesisError> where
    CS: ConstraintSystem<F>, 

pub fn less_than_or_equal<CS>(
    &self,
    cs: CS,
    other: &Self
) -> Result<Boolean, SynthesisError> where
    CS: ConstraintSystem<F>, 

pub fn greater_than_or_equal<CS>(
    &self,
    cs: CS,
    other: &Self
) -> Result<Boolean, SynthesisError> where
    CS: ConstraintSystem<F>, 

impl<F> CondSelectGadget<F> for UInt8 where
    F: PrimeField, 

pub fn conditionally_select<CS>(
    cs: CS,
    cond: &Boolean,
    first: &UInt8,
    second: &UInt8
) -> Result<UInt8, SynthesisError> where
    CS: ConstraintSystem<F>, 

pub fn cost() -> usize

impl<F> ConditionalEqGadget<F> for UInt8 where
    F: Field, 

pub fn conditional_enforce_equal<CS>(
    &self,
    cs: CS,
    other: &UInt8,
    condition: &Boolean
) -> Result<(), SynthesisError> where
    CS: ConstraintSystem<F>, 

pub fn cost() -> usize

impl Debug for UInt8

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

Formats the value using the given formatter.

impl Eq for UInt8

impl<F> EqGadget<F> for UInt8 where
    F: Field, 

pub fn enforce_equal<CS>(
    &self,
    cs: CS,
    other: &Self
) -> Result<(), SynthesisError> where
    CS: ConstraintSystem<F>, 

pub fn cost() -> usize

impl<F> EvaluateEqGadget<F> for UInt8 where
    F: PrimeField, 

pub fn evaluate_equal<CS>(
    &self,
    cs: CS,
    other: &UInt8
) -> Result<Boolean, SynthesisError> where
    CS: ConstraintSystem<F>, 

impl<F> EvaluateLtGadget<F> for UInt8 where
    F: Field + PrimeField, 

pub fn less_than<CS>(
    &self,
    cs: CS,
    other: &UInt8
) -> Result<Boolean, SynthesisError> where
    CS: ConstraintSystem<F>, 

impl PartialEq<UInt8> for UInt8

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

This method tests for self and other values to be equal, and is used by ==.

#[must_use]pub fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl PartialOrd<UInt8> for UInt8

pub fn partial_cmp(&self, other: &UInt8) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

#[must_use]pub fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

#[must_use]pub fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

#[must_use]pub fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

#[must_use]pub fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl<F> ToBytesGadget<F> for UInt8 where
    F: Field, 

pub fn to_bytes<CS>(
    &self,
    _cs: CS
) -> Result<Vec<UInt8, Global>, SynthesisError> where
    CS: ConstraintSystem<F>, 

pub fn to_bytes_strict<CS>(
    &self,
    cs: CS
) -> Result<Vec<UInt8, Global>, SynthesisError> where
    CS: ConstraintSystem<F>, 

Additionally checks if the produced list of booleans is ‘valid’.

impl UInt for UInt8

pub fn negate(&self) -> UInt8

Returns the inverse UInt

pub fn is_constant(&self) -> bool

Returns true if all bits in this UInt are constant

pub fn to_bits_le(&self) -> Vec<Boolean, Global>

Turns this UInt into its little-endian byte order representation. LSB-first means that we can easily get the corresponding field element via double and add.

pub fn from_bits_le(bits: &[Boolean]) -> UInt8

Converts a little-endian byte order representation of bits into a UInt.

pub fn rotr(&self, by: usize) -> UInt8

Rotate self bits by size

pub fn xor<F, CS>(&self, cs: CS, other: &UInt8) -> Result<UInt8, SynthesisError> where
    CS: ConstraintSystem<F>,
    F: Field, 

XOR this UInt with another UInt

pub fn addmany<F, CS>(
    cs: CS,
    operands: &[UInt8]
) -> Result<UInt8, SynthesisError> where
    CS: ConstraintSystem<F>,
    F: PrimeField, 

Perform modular addition of several UInt objects.

pub fn sub<F, CS>(&self, cs: CS, other: &UInt8) -> Result<UInt8, SynthesisError> where
    CS: ConstraintSystem<F>,
    F: PrimeField, 

Perform modular subtraction of two UInt objects.

pub fn sub_unsafe<F, CS>(
    &self,
    cs: CS,
    other: &UInt8
) -> Result<UInt8, SynthesisError> where
    CS: ConstraintSystem<F>,
    F: PrimeField, 

Used for division. Evaluates a - b, and when a - b < 0, returns 0.

pub fn mul<F, CS>(&self, cs: CS, other: &UInt8) -> Result<UInt8, SynthesisError> where
    CS: ConstraintSystem<F>,
    F: PrimeField, 

Perform Bitwise multiplication of two UInt objects. Reference: https://en.wikipedia.org/wiki/Binary_multiplier

pub fn div<F, CS>(&self, cs: CS, other: &UInt8) -> Result<UInt8, SynthesisError> where
    CS: ConstraintSystem<F>,
    F: PrimeField, 

Perform long division of two UInt objects. Reference: https://en.wikipedia.org/wiki/Division_algorithm

pub fn pow<F, CS>(&self, cs: CS, other: &UInt8) -> Result<UInt8, SynthesisError> where
    CS: ConstraintSystem<F>,
    F: Field + PrimeField, 

Bitwise exponentiation of two UInt64 objects. Reference: /snarkVM/models/src/curves/field.rs

pub fn result_is_constant(first: &Self, second: &Self) -> bool

Returns true if both UInt objects have constant bits