@proto-kit/protocolDocs


Documentation / @proto-kit/protocol / Bundle

Class: Bundle

A bundle represents an ordered list of transactions and their evaluated effects. Specifically, this includes beforeTransaction, runtime and afterTransaction evaluation, but not block hooks.

Extends

  • object

Constructors

new Bundle()

new Bundle(value): Bundle

Parameters

value

value.networkStateHash: Field = Field

value.pendingSTBatchesHash: FieldTransition = FieldTransition

value.transactionsHash: Field = Field

value.witnessedRootsHash: FieldTransition = FieldTransition

Returns

Bundle

Inherited from

`Struct({ // Those are per-block trackers networkStateHash: Field, transactionsHash: Field,

// Those are non-linear trackers that we assert later in the blockprover pendingSTBatchesHash: FieldTransition, witnessedRootsHash: FieldTransition, }).constructor`

Defined in

node_modules/o1js/dist/node/lib/provable/types/struct.d.ts:103

Properties

networkStateHash

networkStateHash: Field = Field

Inherited from

`Struct({ // Those are per-block trackers networkStateHash: Field, transactionsHash: Field,

// Those are non-linear trackers that we assert later in the blockprover pendingSTBatchesHash: FieldTransition, witnessedRootsHash: FieldTransition, }).networkStateHash`

Defined in

packages/protocol/src/prover/accumulators/BlockHashList.ts:25


pendingSTBatchesHash

pendingSTBatchesHash: FieldTransition = FieldTransition

Inherited from

`Struct({ // Those are per-block trackers networkStateHash: Field, transactionsHash: Field,

// Those are non-linear trackers that we assert later in the blockprover pendingSTBatchesHash: FieldTransition, witnessedRootsHash: FieldTransition, }).pendingSTBatchesHash`

Defined in

packages/protocol/src/prover/accumulators/BlockHashList.ts:29


transactionsHash

transactionsHash: Field = Field

Inherited from

`Struct({ // Those are per-block trackers networkStateHash: Field, transactionsHash: Field,

// Those are non-linear trackers that we assert later in the blockprover pendingSTBatchesHash: FieldTransition, witnessedRootsHash: FieldTransition, }).transactionsHash`

Defined in

packages/protocol/src/prover/accumulators/BlockHashList.ts:26


witnessedRootsHash

witnessedRootsHash: FieldTransition = FieldTransition

Inherited from

`Struct({ // Those are per-block trackers networkStateHash: Field, transactionsHash: Field,

// Those are non-linear trackers that we assert later in the blockprover pendingSTBatchesHash: FieldTransition, witnessedRootsHash: FieldTransition, }).witnessedRootsHash`

Defined in

packages/protocol/src/prover/accumulators/BlockHashList.ts:30


_isStruct

static _isStruct: true

Inherited from

`Struct({ // Those are per-block trackers networkStateHash: Field, transactionsHash: Field,

// Those are non-linear trackers that we assert later in the blockprover pendingSTBatchesHash: FieldTransition, witnessedRootsHash: FieldTransition, })._isStruct`

Defined in

node_modules/o1js/dist/node/lib/provable/types/struct.d.ts:104


check()

static check: (value) => 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.networkStateHash: Field = Field

value.pendingSTBatchesHash: FieldTransition = FieldTransition

value.transactionsHash: Field = Field

value.witnessedRootsHash: FieldTransition = FieldTransition

Returns

void

Inherited from

`Struct({ // Those are per-block trackers networkStateHash: Field, transactionsHash: Field,

// Those are non-linear trackers that we assert later in the blockprover pendingSTBatchesHash: FieldTransition, witnessedRootsHash: FieldTransition, }).check`

Defined in

node_modules/o1js/dist/node/lib/provable/types/provable-intf.d.ts:60


empty()

static empty: () => object

Returns

object

networkStateHash

networkStateHash: Field = Field

pendingSTBatchesHash

pendingSTBatchesHash: FieldTransition = FieldTransition

transactionsHash

transactionsHash: Field = Field

witnessedRootsHash

witnessedRootsHash: FieldTransition = FieldTransition

Inherited from

`Struct({ // Those are per-block trackers networkStateHash: Field, transactionsHash: Field,

// Those are non-linear trackers that we assert later in the blockprover pendingSTBatchesHash: FieldTransition, witnessedRootsHash: FieldTransition, }).empty`

Defined in

node_modules/o1js/dist/node/lib/provable/types/struct.d.ts:113


fromFields()

static fromFields: (fields) => object

Parameters

fields: Field[]

Returns

object

networkStateHash

networkStateHash: Field = Field

pendingSTBatchesHash

pendingSTBatchesHash: FieldTransition = FieldTransition

transactionsHash

transactionsHash: Field = Field

witnessedRootsHash

witnessedRootsHash: FieldTransition = FieldTransition

Inherited from

`Struct({ // Those are per-block trackers networkStateHash: Field, transactionsHash: Field,

// Those are non-linear trackers that we assert later in the blockprover pendingSTBatchesHash: FieldTransition, witnessedRootsHash: FieldTransition, }).fromFields`

Defined in

node_modules/o1js/dist/node/lib/provable/types/provable-intf.d.ts:95


fromJSON()

static fromJSON: (x) => object

Parameters

x

x.networkStateHash: string = Field

x.pendingSTBatchesHash = FieldTransition

x.pendingSTBatchesHash.from: string = Field

x.pendingSTBatchesHash.to: string = Field

x.transactionsHash: string = Field

x.witnessedRootsHash = FieldTransition

x.witnessedRootsHash.from: string = Field

x.witnessedRootsHash.to: string = Field

Returns

object

networkStateHash

networkStateHash: Field = Field

pendingSTBatchesHash

pendingSTBatchesHash: FieldTransition = FieldTransition

transactionsHash

transactionsHash: Field = Field

witnessedRootsHash

witnessedRootsHash: FieldTransition = FieldTransition

Inherited from

`Struct({ // Those are per-block trackers networkStateHash: Field, transactionsHash: Field,

// Those are non-linear trackers that we assert later in the blockprover pendingSTBatchesHash: FieldTransition, witnessedRootsHash: FieldTransition, }).fromJSON`

Defined in

node_modules/o1js/dist/node/lib/provable/types/struct.d.ts:112


fromValue

static fromValue: (x) => object & (value) => object

Convert provable type from a normal JS type.

Inherited from

`Struct({ // Those are per-block trackers networkStateHash: Field, transactionsHash: Field,

// Those are non-linear trackers that we assert later in the blockprover pendingSTBatchesHash: FieldTransition, witnessedRootsHash: FieldTransition, }).fromValue`

Defined in

node_modules/o1js/dist/node/lib/provable/types/provable-intf.d.ts:68


toAuxiliary()

static toAuxiliary: (value?) => 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.networkStateHash?: Field = Field

value.pendingSTBatchesHash?: FieldTransition = FieldTransition

value.transactionsHash?: Field = Field

value.witnessedRootsHash?: FieldTransition = FieldTransition

Returns

any[]

An array of any type describing how this T element is made up of “auxiliary” (non-provable) data.

Inherited from

`Struct({ // Those are per-block trackers networkStateHash: Field, transactionsHash: Field,

// Those are non-linear trackers that we assert later in the blockprover pendingSTBatchesHash: FieldTransition, witnessedRootsHash: FieldTransition, }).toAuxiliary`

Defined in

node_modules/o1js/dist/node/lib/provable/types/provable-intf.d.ts:34


toCanonical()?

static optional toCanonical: (x) => object

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.networkStateHash: Field = Field

x.pendingSTBatchesHash: FieldTransition = FieldTransition

x.transactionsHash: Field = Field

x.witnessedRootsHash: FieldTransition = FieldTransition

Returns

object

networkStateHash

networkStateHash: Field = Field

pendingSTBatchesHash

pendingSTBatchesHash: FieldTransition = FieldTransition

transactionsHash

transactionsHash: Field = Field

witnessedRootsHash

witnessedRootsHash: FieldTransition = FieldTransition

Inherited from

`Struct({ // Those are per-block trackers networkStateHash: Field, transactionsHash: Field,

// Those are non-linear trackers that we assert later in the blockprover pendingSTBatchesHash: FieldTransition, witnessedRootsHash: FieldTransition, }).toCanonical`

Defined in

node_modules/o1js/dist/node/lib/provable/types/provable-intf.d.ts:85


toFields()

static toFields: (value) => 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.networkStateHash: Field = Field

value.pendingSTBatchesHash: FieldTransition = FieldTransition

value.transactionsHash: Field = Field

value.witnessedRootsHash: FieldTransition = FieldTransition

Returns

Field[]

A Field array describing how this T element is made up of Field elements.

Inherited from

`Struct({ // Those are per-block trackers networkStateHash: Field, transactionsHash: Field,

// Those are non-linear trackers that we assert later in the blockprover pendingSTBatchesHash: FieldTransition, witnessedRootsHash: FieldTransition, }).toFields`

Defined in

node_modules/o1js/dist/node/lib/provable/types/provable-intf.d.ts:24


toInput()

static toInput: (x) => object

Parameters

x

x.networkStateHash: Field = Field

x.pendingSTBatchesHash: FieldTransition = FieldTransition

x.transactionsHash: Field = Field

x.witnessedRootsHash: FieldTransition = FieldTransition

Returns

object

fields?

optional fields: Field[]

packed?

optional packed: [Field, number][]

Inherited from

`Struct({ // Those are per-block trackers networkStateHash: Field, transactionsHash: Field,

// Those are non-linear trackers that we assert later in the blockprover pendingSTBatchesHash: FieldTransition, witnessedRootsHash: FieldTransition, }).toInput`

Defined in

node_modules/o1js/dist/node/lib/provable/types/struct.d.ts:107


toJSON()

static toJSON: (x) => object

Parameters

x

x.networkStateHash: Field = Field

x.pendingSTBatchesHash: FieldTransition = FieldTransition

x.transactionsHash: Field = Field

x.witnessedRootsHash: FieldTransition = FieldTransition

Returns

object

networkStateHash

networkStateHash: string = Field

pendingSTBatchesHash

pendingSTBatchesHash: object = FieldTransition

pendingSTBatchesHash.from

pendingSTBatchesHash.from: string = Field

pendingSTBatchesHash.to

pendingSTBatchesHash.to: string = Field

transactionsHash

transactionsHash: string = Field

witnessedRootsHash

witnessedRootsHash: object = FieldTransition

witnessedRootsHash.from

witnessedRootsHash.from: string = Field

witnessedRootsHash.to

witnessedRootsHash.to: string = Field

Inherited from

`Struct({ // Those are per-block trackers networkStateHash: Field, transactionsHash: Field,

// Those are non-linear trackers that we assert later in the blockprover pendingSTBatchesHash: FieldTransition, witnessedRootsHash: FieldTransition, }).toJSON`

Defined in

node_modules/o1js/dist/node/lib/provable/types/struct.d.ts:111


toValue()

static toValue: (x) => object

Convert provable type to a normal JS type.

Parameters

x

x.networkStateHash: Field = Field

x.pendingSTBatchesHash: FieldTransition = FieldTransition

x.transactionsHash: Field = Field

x.witnessedRootsHash: FieldTransition = FieldTransition

Returns

object

networkStateHash

networkStateHash: bigint = Field

pendingSTBatchesHash

pendingSTBatchesHash: object = FieldTransition

pendingSTBatchesHash.from

pendingSTBatchesHash.from: bigint = Field

pendingSTBatchesHash.to

pendingSTBatchesHash.to: bigint = Field

transactionsHash

transactionsHash: bigint = Field

witnessedRootsHash

witnessedRootsHash: object = FieldTransition

witnessedRootsHash.from

witnessedRootsHash.from: bigint = Field

witnessedRootsHash.to

witnessedRootsHash.to: bigint = Field

Inherited from

`Struct({ // Those are per-block trackers networkStateHash: Field, transactionsHash: Field,

// Those are non-linear trackers that we assert later in the blockprover pendingSTBatchesHash: FieldTransition, witnessedRootsHash: FieldTransition, }).toValue`

Defined in

node_modules/o1js/dist/node/lib/provable/types/provable-intf.d.ts:64

Methods

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

`Struct({ // Those are per-block trackers networkStateHash: Field, transactionsHash: Field,

// Those are non-linear trackers that we assert later in the blockprover pendingSTBatchesHash: FieldTransition, witnessedRootsHash: FieldTransition, }).sizeInFields`

Defined in

node_modules/o1js/dist/node/lib/provable/types/provable-intf.d.ts:51