Skip to main content

OffchainStateCommitments

Commitments that keep track of the current state of an offchain Merkle tree constructed from actions. Intended to be stored on-chain.

Fields:

  • root: The root of the current Merkle tree
  • actionState: The hash pointing to the list of actions that have been applied to form the current Merkle tree

Extends​

  • OffchainStateCommitments

Constructors​

new OffchainStateCommitments()​

new OffchainStateCommitments(value: {
  "actionState": Field;
  "length": Field;
  "root": Field;
 }): OffchainStateCommitments

Parameters​

• value

• value.actionState: Field= Field

• value.length: Field= Field

• value.root: Field= Field

Returns​

OffchainStateCommitments

Inherited from​

OffchainState_.OffchainStateCommitments.constructor

Source​

lib/provable/types/struct.ts:148

Properties​

actionState​

actionState: Field = Field;

Inherited from​

OffchainState_.OffchainStateCommitments.actionState

Source​

lib/mina/actions/offchain-state-rollup.ts:49

length​

length: Field = Field;

Inherited from​

OffchainState_.OffchainStateCommitments.length

Source​

lib/mina/actions/offchain-state-rollup.ts:46

root​

root: Field = Field;

Inherited from​

OffchainState_.OffchainStateCommitments.root

Source​

lib/mina/actions/offchain-state-rollup.ts:45

_isStruct​

static _isStruct: true;

Inherited from​

OffchainState_.OffchainStateCommitments._isStruct

Source​

lib/provable/types/struct.ts:148

check()​

static check: (value: {
  "actionState": Field;
  "length": Field;
  "root": Field;
 }) => void;

Add assertions to the proof to check if value is a valid member of type T. This function does not return anything, instead it creates any number of assertions to prove that value is a valid member of the type T.

For instance, calling check function on the type Bool asserts that the value of the element is either 1 or 0.

Parameters​

• value

the element of type T to put assertions on.

• value.actionState: Field= Field

• value.length: Field= Field

• value.root: Field= Field

Returns​

void

Inherited from​

OffchainState_.OffchainStateCommitments.check

Source​

lib/provable/types/provable-intf.ts:76

empty()​

static empty: () => {
  "actionState": Field;
  "length": Field;
  "root": Field;
};

Returns​

{
  "actionState": Field;
  "length": Field;
  "root": Field;
}
actionState​
actionState: Field = Field;
length​
length: Field = Field;
root​
root: Field = Field;

Inherited from​

OffchainState_.OffchainStateCommitments.empty

Source​

lib/provable/types/struct.ts:158

fromFields()​

static fromFields: (fields: Field[]) => {
  "actionState": Field;
  "length": Field;
  "root": Field;
};

Parameters​

• fields: Field[]

Returns​

{
  "actionState": Field;
  "length": Field;
  "root": Field;
}
actionState​
actionState: Field = Field;
length​
length: Field = Field;
root​
root: Field = Field;

Inherited from​

OffchainState_.OffchainStateCommitments.fromFields

Source​

lib/provable/types/provable-intf.ts:115

fromJSON()​

static fromJSON: (x: {
  "actionState": Field;
  "length": Field;
  "root": Field;
 }) => {
  "actionState": Field;
  "length": Field;
  "root": Field;
};

Parameters​

• x

• x.actionState: string= Field

• x.length: string= Field

• x.root: string= Field

Returns​

{
  "actionState": Field;
  "length": Field;
  "root": Field;
}
actionState​
actionState: Field = Field;
length​
length: Field = Field;
root​
root: Field = Field;

Inherited from​

OffchainState_.OffchainStateCommitments.fromJSON

Source​

lib/provable/types/struct.ts:157

fromValue​

static fromValue: (x: {
  "actionState": Field;
  "length": Field;
  "root": Field;
 } | {
  "actionState": Field;
  "length": Field;
  "root": Field;
 }) => {
  "actionState": Field;
  "length": Field;
  "root": Field;
 } & (value: {
  "actionState": Field;
  "length": Field;
  "root": Field;
 }) => {
  "actionState": Field;
  "length": Field;
  "root": Field;
};

Convert provable type from a normal JS type.

Inherited from​

OffchainState_.OffchainStateCommitments.fromValue

Source​

lib/provable/types/provable-intf.ts:86

toAuxiliary()​

static toAuxiliary: (value?: {
  "actionState": Field;
  "length": Field;
  "root": Field;
 }) => any[];

A function that takes value (optional), an element of type T, as argument and returns an array of any type that make up the "auxiliary" (non-provable) data of value.

Parameters​

• value?

the element of type T to generate the auxiliary data array from, optional. If not provided, a default value for auxiliary data is returned.

• value.actionState?: Field= Field

• value.length?: Field= Field

• value.root?: Field= Field

Returns​

any[]

Inherited from​

OffchainState_.OffchainStateCommitments.toAuxiliary

Source​

lib/provable/types/provable-intf.ts:47

toCanonical()?​

static optional toCanonical: (x: {
  "actionState": Field;
  "length": Field;
  "root": Field;
 }) => {
  "actionState": Field;
  "length": Field;
  "root": Field;
};

Optional method which transforms a provable type into its canonical representation.

This is needed for types that have multiple representations of the same underlying value, and might even not have perfect completeness for some of those representations.

An example is the ForeignField class, which allows non-native field elements to exist in unreduced form. The unreduced form is not perfectly complete, for example, addition of two unreduced field elements can cause a prover error.

Specific protocols need to be able to protect themselves against incomplete operations at all costs. For example, when using actions and reducer, the reducer must be able to produce a proof regardless of the input action. toCanonical() converts any input into a safe form and enables us to handle cases like this generically.

Note: For most types, this method is the identity function. The identity function will also be used when the toCanonical() is not present on a type.

Parameters​

• x

• x.actionState: Field= Field

• x.length: Field= Field

• x.root: Field= Field

Returns​

{
  "actionState": Field;
  "length": Field;
  "root": Field;
}
actionState​
actionState: Field = Field;
length​
length: Field = Field;
root​
root: Field = Field;

Inherited from​

OffchainState_.OffchainStateCommitments.toCanonical

Source​

lib/provable/types/provable-intf.ts:104

toFields()​

static toFields: (value: {
  "actionState": Field;
  "length": Field;
  "root": Field;
 }) => Field[];

A function that takes value, an element of type T, as argument and returns an array of Field elements that make up the provable data of value.

Parameters​

• value

the element of type T to generate the Field array from.

• value.actionState: Field= Field

• value.length: Field= Field

• value.root: Field= Field

Returns​

Field[]

Inherited from​

OffchainState_.OffchainStateCommitments.toFields

Source​

lib/provable/types/provable-intf.ts:36

toInput()​

static toInput: (x: {
  "actionState": Field;
  "length": Field;
  "root": Field;
 }) => {
  "fields": Field[];
  "packed": [Field, number][];
};

Parameters​

• x

• x.actionState: Field= Field

• x.length: Field= Field

• x.root: Field= Field

Returns​

{
  "fields": Field[];
  "packed": [Field, number][];
}
fields?​
optional fields: Field[];
packed?​
optional packed: [Field, number][];

Inherited from​

OffchainState_.OffchainStateCommitments.toInput

Source​

lib/provable/types/struct.ts:152

toJSON()​

static toJSON: (x: {
  "actionState": Field;
  "length": Field;
  "root": Field;
 }) => {
  "actionState": Field;
  "length": Field;
  "root": Field;
};

Parameters​

• x

• x.actionState: Field= Field

• x.length: Field= Field

• x.root: Field= Field

Returns​

{
  "actionState": Field;
  "length": Field;
  "root": Field;
}
actionState​
actionState: string = Field;
length​
length: string = Field;
root​
root: string = Field;

Inherited from​

OffchainState_.OffchainStateCommitments.toJSON

Source​

lib/provable/types/struct.ts:156

toValue()​

static toValue: (x: {
  "actionState": Field;
  "length": Field;
  "root": Field;
 }) => {
  "actionState": Field;
  "length": Field;
  "root": Field;
};

Convert provable type to a normal JS type.

Parameters​

• x

• x.actionState: Field= Field

• x.length: Field= Field

• x.root: Field= Field

Returns​

{
  "actionState": Field;
  "length": Field;
  "root": Field;
}
actionState​
actionState: bigint = Field;
length​
length: bigint = Field;
root​
root: bigint = Field;

Inherited from​

OffchainState_.OffchainStateCommitments.toValue

Source​

lib/provable/types/provable-intf.ts:81

Methods​

emptyFromHeight()​

static emptyFromHeight(height: number): OffchainStateCommitments

Parameters​

• height: number

Returns​

OffchainStateCommitments

Inherited from​

OffchainState_.OffchainStateCommitments.emptyFromHeight

Source​

lib/mina/actions/offchain-state-rollup.ts:51

sizeInFields()​

static sizeInFields(): number

Return the size of the T type in terms of Field type, as Field is the primitive type.

Returns​

number

A number representing the size of the T type in terms of Field type.

Inherited from​

OffchainState_.OffchainStateCommitments.sizeInFields

Source​

lib/provable/types/provable-intf.ts:66