pub enum VerifyFailure {
    CellNotAssigned {
        gate: Gate,
        region: Region,
        gate_offset: usize,
        column: Column<Any>,
        offset: isize,
    },
    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.

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 !=.

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.

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.