getEpoch

GET

/v1/explorer/epochs/{project_id}/{epoch}

curl --request GET \
  --url https://testnet-rpc.necter.network/v1/explorer/epochs/example/1

• Public RPC host (JSON only)

Parameters

Path Parameters

project_id

required

string

/^0x[0-9a-f]{64}$/

epoch

required

integer

Responses

200

Epoch with its attested v2 receipt and on-chain settlement

Media typeapplication/json

object

project_id

required

string

/^0x[0-9a-f]{64}$/

epoch

required

integer

epoch_secs

integer

starts_at

integer

ends_at

integer

status

required

string

Allowed values: open closed attested submitted settled released vetoed underfunded

rounds

integer

fallback_rounds

integer

miners

integer

token

object

address

required

Lowercase EVM address

string

/^0x[0-9a-f]{40}$/

symbol

required

string

name

string

decimals

required

integer

<= 36

totals

object

units

required

integer

gross

required

Token base units

string

/^(0|[1-9][0-9]{0,77})$/

miner

required

Token base units

string

/^(0|[1-9][0-9]{0,77})$/

developer

required

Token base units

string

/^(0|[1-9][0-9]{0,77})$/

treasury

required

Token base units

string

/^(0|[1-9][0-9]{0,77})$/

receipt_hash

string

/^0x[0-9a-f]{64}$/

merkle_root

string

/^0x[0-9a-f]{64}$/

settlement

object

status

open: the epoch has no attested receipt yet (nothing to settle)

string

Allowed values: open queued signed sent settled released vetoed reverted failed

tx_hash

string

/^0x[0-9a-f]{64}$/

block_number

integer

claimable_at

integer

error

string | null

receipt

object

v

required

integer

Allowed value: 2

chain_id

required

integer

vault_address

required

Lowercase EVM address

string

/^0x[0-9a-f]{40}$/

project_id

required

string

/^0x[0-9a-f]{64}$/

consensus_hash

required

string

/^0x[0-9a-f]{64}$/

round

required

integer

epoch_secs

required

integer

reward_token

required

Lowercase EVM address

string

/^0x[0-9a-f]{40}$/

reward_model

required

string

Allowed values: per-unit epoch-pool

compute_units

required

Array<object>

object

miner

required

Lowercase EVM address

string

/^0x[0-9a-f]{40}$/

units

required

integer

>= 1

amount

required

Token base units

string

/^(0|[1-9][0-9]{0,77})$/

totals

required

object

units

required

integer

gross

required

Token base units

string

/^(0|[1-9][0-9]{0,77})$/

miner

required

Token base units

string

/^(0|[1-9][0-9]{0,77})$/

developer

required

Token base units

string

/^(0|[1-9][0-9]{0,77})$/

treasury

required

Token base units

string

/^(0|[1-9][0-9]{0,77})$/

merkle_root

required

string

/^0x[0-9a-f]{64}$/

receipt_hash

required

string

/^0x[0-9a-f]{64}$/

attestations

required

Array<object>

object

node_id

required

string

/^ndsr-[0-9a-f]{16}$/

public_key

required

string

/^0x[0-9a-f]{64}$/

signature

required

string

/^0x[0-9a-f]{128}$/

Example

{
  "status": "open",
  "settlement": {
    "status": "open"
  },
  "receipt": {
    "v": 2,
    "reward_model": "per-unit"
  }
}

404

not_found

Media typeapplication/json

object

error

required

Stable machine code

string

message

required

string

details

object

key

additional properties

any

request_id

required

string

Example ^generated

{
  "error": "example",
  "message": "example",
  "details": {},
  "request_id": "example"
}