Get a state proof that covers a given round

GET

/v2/stateproofs/{round}

Authorizations

• api_key

Parameters

Path Parameters

round

required

integer

The round for which a state proof is desired.

Responses

200

StateProofResponse wraps the StateProof type in a response.

Represents a state proof and its corresponding message

object

Message

required

Represents the message that the state proofs are attesting to.

object

BlockHeadersCommitment

required

The vector commitment root on all light block headers within a state proof interval.

string format: byte

/^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/

FirstAttestedRound

required

The first round the message attests to.

integer

LastAttestedRound

required

The last round the message attests to.

integer

LnProvenWeight

required

An integer value representing the natural log of the proven weight with 16 bits of precision. This value would be used to verify the next state proof.

integer

VotersCommitment

required

The vector commitment root of the top N accounts to sign the next StateProof.

string format: byte

/^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/

StateProof

required

The encoded StateProof for the message.

string format: byte

/^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/

401

Invalid API Token

An error response with optional data field.

object

data

object

message

required

string

404

Could not find a state proof that covers a given round

An error response with optional data field.

object

data

object

message

required

string

408

Timed out on request

An error response with optional data field.

object

data

object

message

required

string

500

Internal Error

An error response with optional data field.

object

data

object

message

required

string

503

Service Temporarily Unavailable

An error response with optional data field.

object

data

object

message

required

string

default

Unknown Error