pub enum VerifyFailure {
    CellNotAssigned {
        gate: Gate,
        region: Region,
        gate_offset: usize,
        column: Column<Any>,
        offset: isize,
    },
    InstanceCellNotAssigned {
        gate: Gate,
        region: Region,
        gate_offset: usize,
        column: Column<Instance>,
        row: usize,
    },
    ConstraintNotSatisfied {
        constraint: Constraint,
        location: FailureLocation,
        cell_values: Vec<(VirtualCell, String)>,
    },
    ConstraintPoisoned {
        constraint: Constraint,
    },
    Lookup {
        lookup_index: usize,
        location: FailureLocation,
    },
    Permutation {
        column: Column,
        location: FailureLocation,
    },
}
Expand description

The reasons why a particular circuit is not satisfied.

Variants

CellNotAssigned

Fields

gate: Gate

The index of the active gate.

region: Region

The region in which this cell should be assigned.

gate_offset: usize

The offset (relative to the start of the region) at which the active gate queries this cell.

column: Column<Any>

The column in which this cell should be assigned.

offset: isize

The offset (relative to the start of the region) at which this cell should be assigned. This may be negative (for example, if a selector enables a gate at offset 0, but the gate uses Rotation::prev()).

A cell used in an active gate was not assigned to.

InstanceCellNotAssigned

Fields

gate: Gate

The index of the active gate.

region: Region

The region in which this gate was activated.

gate_offset: usize

The offset (relative to the start of the region) at which the active gate queries this cell.

column: Column<Instance>

The column in which this cell should be assigned.

row: usize

The absolute row at which this cell should be assigned.

An instance cell used in an active gate was not assigned to.

ConstraintNotSatisfied

Fields

constraint: Constraint

The polynomial constraint that is not satisfied.

location: FailureLocation

The location at which this constraint is not satisfied.

FailureLocation::OutsideRegion is usually caused by a constraint that does not contain a selector, and as a result is active on every row.

cell_values: Vec<(VirtualCell, String)>

The values of the virtual cells used by this constraint.

A constraint was not satisfied for a particular row.

ConstraintPoisoned

Fields

constraint: Constraint

The polynomial constraint that is not satisfied.

A constraint was active on an unusable row, and is likely missing a selector.

Lookup

Fields

lookup_index: usize

The index of the lookup that is not satisfied. These indices are assigned in the order in which ConstraintSystem::lookup is called during Circuit::configure.

location: FailureLocation

The location at which the lookup is not satisfied.

FailureLocation::InRegion is most common, and may be due to the intentional use of a lookup (if its inputs are conditional on a complex selector), or an unintentional lookup constraint that overlaps the region (indicating that the lookup’s inputs should be made conditional).

FailureLocation::OutsideRegion is uncommon, and could mean that:

  • The input expressions do not correctly constrain a default value that exists in the table when the lookup is not being used.
  • The input expressions use a column queried at a non-zero Rotation, and the lookup is active on a row adjacent to an unrelated region.

A lookup input did not exist in its corresponding table.

Permutation

Fields

column: Column

The column in which this permutation is not satisfied.

location: FailureLocation

The location at which the permutation is not satisfied.

A permutation did not preserve the original value of a cell.

Trait Implementations

Formats the value using the given formatter. Read more
Formats the value using the given formatter. Read more
This method tests for self and other values to be equal, and is used by ==. Read more
This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason. Read more

Auto Trait Implementations

Blanket Implementations

Gets the TypeId of self. Read more
Immutably borrows from an owned value. Read more
Mutably borrows from an owned value. Read more
Converts self into T using Into<T>. Read more
Causes self to use its Binary implementation when Debug-formatted. Read more
Causes self to use its Display implementation when Debug-formatted. Read more
Causes self to use its LowerExp implementation when Debug-formatted. Read more
Causes self to use its LowerHex implementation when Debug-formatted. Read more
Causes self to use its Octal implementation when Debug-formatted. Read more
Causes self to use its Pointer implementation when Debug-formatted. Read more
Causes self to use its UpperExp implementation when Debug-formatted. Read more
Causes self to use its UpperHex implementation when Debug-formatted. Read more
Formats each item in a sequence. Read more

Returns the argument unchanged.

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Instruments this type with the current Span, returning an Instrumented wrapper. Read more

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Pipes by value. This is generally the method you want to use. Read more
Borrows self and passes that borrow into the pipe function. Read more
Mutably borrows self and passes that borrow into the pipe function. Read more
Borrows self, then passes self.borrow() into the pipe function. Read more
Mutably borrows self, then passes self.borrow_mut() into the pipe function. Read more
Borrows self, then passes self.as_ref() into the pipe function.
Mutably borrows self, then passes self.as_mut() into the pipe function. Read more
Borrows self, then passes self.deref() into the pipe function.
Mutably borrows self, then passes self.deref_mut() into the pipe function. Read more
The alignment of pointer.
The type for initializers.
Initializes a with the given initializer. Read more
Dereferences the given pointer. Read more
Mutably dereferences the given pointer. Read more
Drops the object pointed to by the given pointer. Read more
Immutable access to a value. Read more
Mutable access to a value. Read more
Immutable access to the Borrow<B> of a value. Read more
Mutable access to the BorrowMut<B> of a value. Read more
Immutable access to the AsRef<R> view of a value. Read more
Mutable access to the AsMut<R> view of a value. Read more
Immutable access to the Deref::Target of a value. Read more
Mutable access to the Deref::Target of a value. Read more
Calls .tap() only in debug builds, and is erased in release builds.
Calls .tap_mut() only in debug builds, and is erased in release builds. Read more
Calls .tap_borrow() only in debug builds, and is erased in release builds. Read more
Calls .tap_borrow_mut() only in debug builds, and is erased in release builds. Read more
Calls .tap_ref() only in debug builds, and is erased in release builds. Read more
Calls .tap_ref_mut() only in debug builds, and is erased in release builds. Read more
Calls .tap_deref() only in debug builds, and is erased in release builds. Read more
Calls .tap_deref_mut() only in debug builds, and is erased in release builds. Read more
Converts the given value to a String. Read more
Attempts to convert self into T using TryInto<T>. Read more
The type returned in the event of a conversion error.
Performs the conversion.
The type returned in the event of a conversion error.
Performs the conversion.
Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more