Struct Evaluator

pub struct Evaluator<C, Wire> { /* private fields */ }

Streaming evaluator using a callback to receive ciphertexts as needed.

Evaluates a garbled circuit on the fly, using messages containing ciphertexts and wires. Parallelizable.

Implementations

impl<C: AbstractChannel, Wire: WireLabel> Evaluator<C, Wire>

pub fn new(channel: C) -> Self

Create a new Evaluator.

pub fn read_wire(&mut self, modulus: u16) -> Result<Wire, EvaluatorError>

Read a Wire from the reader.

Trait Implementations

impl<C: AbstractChannel, Wire: WireLabel> Fancy for Evaluator<C, Wire>

type Item = Wire

The underlying wire datatype created by an object implementing Fancy.

type Error = EvaluatorError

Errors which may be thrown by the users of Fancy.

fn constant(&mut self, _: u16, q: u16) -> Result<Wire, EvaluatorError>

Create a constant x with modulus q.

fn output(&mut self, x: &Wire) -> Result<Option<u16>, EvaluatorError>

Process this wire as output. Some Fancy implementers don’t actually return output, but they need to be involved in the process, so they can return None.

fn outputs( &mut self, xs: &[Self::Item], ) -> Result<Option<Vec<u16>>, Self::Error>

Output a slice of wires.

impl<C: AbstractChannel, Wire: WireLabel + ArithmeticWire> FancyArithmetic for Evaluator<C, Wire>

fn add(&mut self, x: &Wire, y: &Wire) -> Result<Wire, EvaluatorError>

Add x and y.

fn sub(&mut self, x: &Wire, y: &Wire) -> Result<Wire, EvaluatorError>

Subtract x and y.

fn cmul(&mut self, x: &Wire, c: u16) -> Result<Wire, EvaluatorError>

Multiply x times the constant c.

fn mul(&mut self, A: &Wire, B: &Wire) -> Result<Wire, EvaluatorError>

Multiply x and y.

fn proj( &mut self, x: &Wire, q: u16, _: Option<Vec<u16>>, ) -> Result<Wire, EvaluatorError>

Project x according to the truth table tt. Resulting wire has modulus q.

fn add_many(&mut self, args: &[Self::Item]) -> Result<Self::Item, Self::Error>

Sum up a slice of wires.

fn mod_change( &mut self, x: &Self::Item, to_modulus: u16, ) -> Result<Self::Item, Self::Error>

Change the modulus of x to to_modulus using a projection gate.

impl<C: AbstractChannel> FancyBinary for Evaluator<C, AllWire>

fn negate(&mut self, x: &Self::Item) -> Result<Self::Item, Self::Error>

Overriding negate to be a noop: entirely handled on garbler’s end

fn xor( &mut self, x: &Self::Item, y: &Self::Item, ) -> Result<Self::Item, Self::Error>

Binary Xor

fn and( &mut self, x: &Self::Item, y: &Self::Item, ) -> Result<Self::Item, Self::Error>

Binary And

fn or( &mut self, x: &Self::Item, y: &Self::Item, ) -> Result<Self::Item, Self::Error>

Uses Demorgan’s Rule implemented with an and gate and negation.

fn adder( &mut self, x: &Self::Item, y: &Self::Item, carry_in: Option<&Self::Item>, ) -> Result<(Self::Item, Self::Item), Self::Error>

Binary adder. Returns the result and the carry.

fn and_many(&mut self, args: &[Self::Item]) -> Result<Self::Item, Self::Error>

Returns 1 if all wires equal 1.

fn or_many(&mut self, args: &[Self::Item]) -> Result<Self::Item, Self::Error>

Returns 1 if any wire equals 1.

fn xor_many(&mut self, args: &[Self::Item]) -> Result<Self::Item, Self::Error>

XOR many wires together

fn mux_constant_bits( &mut self, x: &Self::Item, b1: bool, b2: bool, ) -> Result<Self::Item, Self::Error>

If x = 0 returns the constant b1 else return b2. Folds constants if possible.

fn mux( &mut self, b: &Self::Item, x: &Self::Item, y: &Self::Item, ) -> Result<Self::Item, Self::Error>

If b = 0 returns x else y.

impl<C: AbstractChannel> FancyBinary for Evaluator<C, WireMod2>

fn negate(&mut self, x: &Self::Item) -> Result<Self::Item, Self::Error>

Negate is a noop for the evaluator

fn xor( &mut self, x: &Self::Item, y: &Self::Item, ) -> Result<Self::Item, Self::Error>

Binary Xor

fn and( &mut self, A: &Self::Item, B: &Self::Item, ) -> Result<Self::Item, Self::Error>

Binary And

fn or( &mut self, x: &Self::Item, y: &Self::Item, ) -> Result<Self::Item, Self::Error>

Uses Demorgan’s Rule implemented with an and gate and negation.

fn adder( &mut self, x: &Self::Item, y: &Self::Item, carry_in: Option<&Self::Item>, ) -> Result<(Self::Item, Self::Item), Self::Error>

Binary adder. Returns the result and the carry.

fn and_many(&mut self, args: &[Self::Item]) -> Result<Self::Item, Self::Error>

Returns 1 if all wires equal 1.

fn or_many(&mut self, args: &[Self::Item]) -> Result<Self::Item, Self::Error>

Returns 1 if any wire equals 1.

fn xor_many(&mut self, args: &[Self::Item]) -> Result<Self::Item, Self::Error>

XOR many wires together

fn mux_constant_bits( &mut self, x: &Self::Item, b1: bool, b2: bool, ) -> Result<Self::Item, Self::Error>

If x = 0 returns the constant b1 else return b2. Folds constants if possible.

fn mux( &mut self, b: &Self::Item, x: &Self::Item, y: &Self::Item, ) -> Result<Self::Item, Self::Error>

If b = 0 returns x else y.

impl<C: AbstractChannel, Wire: WireLabel> FancyReveal for Evaluator<C, Wire>

fn reveal(&mut self, x: &Wire) -> Result<u16, EvaluatorError>

Reveal the contents of x to all parties.

fn reveal_many(&mut self, xs: &[Self::Item]) -> Result<Vec<u16>, Self::Error>

Reveal a slice of items to all parties.

fn reveal_bundle( &mut self, x: &Bundle<Self::Item>, ) -> Result<Vec<u16>, Self::Error>

Reveal a bundle to all parties.

fn reveal_many_bundles( &mut self, xs: &[Bundle<Self::Item>], ) -> Result<Vec<Vec<u16>>, Self::Error>

Reveal many bundles to all parties.

fn crt_reveal(&mut self, x: &CrtBundle<Self::Item>) -> Result<u128, Self::Error>

Reveal a CRT bundle to all parties.

fn crt_reveal_many( &mut self, xs: &[CrtBundle<Self::Item>], ) -> Result<Vec<u128>, Self::Error>

Reveal many CRT bundles to all parties.

fn bin_reveal( &mut self, x: &BinaryBundle<Self::Item>, ) -> Result<u128, Self::Error>

Reveal a binary bundle to all parties.

fn bin_reveal_many( &mut self, xs: &[BinaryBundle<Self::Item>], ) -> Result<Vec<u128>, Self::Error>

Reveal many binary bundles to all parties.