Skip to content

getRound

GET
/v1/explorer/rounds/{round_id}
curl --request GET \
--url https://testnet-rpc.necter.network/v1/explorer/rounds/example
round_id
required
string
/^(exec|task):0x[0-9a-f]{64}$|^(reward|epoch):0x[0-9a-f]{64}:[0-9]+:[0-9]+$/

Round with votes and finality

Media typeapplication/json
object
round_id
required
string
kind
required
string
Allowed values: exec task reward epoch
state
required
string
Allowed values: pending committee_agreed finalized escalated failed fallback
project_id
string
/^0x[0-9a-f]{64}$/
module_address
string
/^0x[0-9a-f]{64}$/
function
string
epoch
integer
seq
integer
receipt_hash
string
/^0x[0-9a-f]{64}$/
gas_used
integer
committee_size
integer
votes
integer
agreeing
integer
audited
boolean
created_at
required
integer
finalized_at
integer
task
object
v
required
integer
Allowed value: 1
project_id
required
string
/^0x[0-9a-f]{64}$/
consensus_hash
required
string
/^0x[0-9a-f]{64}$/
epoch
required
integer
seq
required
integer
set_hash
required
string
/^0x[0-9a-f]{64}$/
module_address
required
string
/^0x[0-9a-f]{64}$/
function
required
string
input_hash
required
string
/^0x[0-9a-f]{64}$/
gas_limit
required
integer
issued_at
required
integer
committee
object
project_id
required
string
/^0x[0-9a-f]{64}$/
epoch
required
integer
seq
required
integer
set_hash
required
string
/^0x[0-9a-f]{64}$/
seed
required
string
/^0x[0-9a-f]{64}$/
k_eff
required
integer
b_eff
required
integer
quorum
required
integer
fallback

K_eff < min_size

boolean
committee_hash
string
/^0x[0-9a-f]{64}$/
skipped

Round detail only: draw members passed over when offers were made (not connected, unavailable, no free slot)

Array<object>
object
position
integer
node_id
string
/^ndsr-[0-9a-f]{16}$/
reason

Not_connected | unavailable | no_slots | busy:/

string
at
integer
draw
required
Array<object>
object
position
required
integer
role
required
string
Allowed values: primary backup
node_key
required
string
/^0x[0-9a-f]{64}$/
node_id
string
/^ndsr-[0-9a-f]{16}$/
weight
required

Decimal u128

string
votes_detail
Array<object>
object
round_id
required
string
kind
required
string
Allowed value: task
receipt_hash
required
string
/^0x[0-9a-f]{64}$/
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}$/
payout_address
required

Lowercase EVM address

string
/^0x[0-9a-f]{40}$/
round_signature
required
string
/^0x[0-9a-f]{128}$/
task
required
object
v
required
integer
Allowed value: 1
project_id
required
string
/^0x[0-9a-f]{64}$/
consensus_hash
required
string
/^0x[0-9a-f]{64}$/
epoch
required
integer
seq
required
integer
set_hash
required
string
/^0x[0-9a-f]{64}$/
module_address
required
string
/^0x[0-9a-f]{64}$/
function
required
string
input_hash
required
string
/^0x[0-9a-f]{64}$/
gas_limit
required
integer
issued_at
required
integer
receipt
required
object
v
required
integer
Allowed value: 1
module_address
required
string
/^0x[0-9a-f]{64}$/
function
required
string
input_hash
required
string
/^0x[0-9a-f]{64}$/
output_hash
required
string
/^0x[0-9a-f]{64}$/
events_hash
required
string
/^0x[0-9a-f]{64}$/
gas_used
required
integer
success
required
boolean
committee
required
object
position
required
integer
finality
object
v
required
integer
Allowed value: 1
round_id
required
string
project_id
required
string
/^0x[0-9a-f]{64}$/
epoch
required
integer
set_hash
required
string
/^0x[0-9a-f]{64}$/
receipt_hash
required
string
/^0x[0-9a-f]{64}$/
gas_used
required
integer
audited
required
boolean
voters
required
Array<object>
object
public_key
required
string
/^0x[0-9a-f]{64}$/
payout_address
required

Lowercase EVM address

string
/^0x[0-9a-f]{40}$/
finality_votes
Array<object>
object
key
additional properties
any
exec_votes

Exec: rounds — votes

Array<object>
object
key
additional properties
any

Example

{
"kind": "exec",
"state": "pending",
"task": {
"v": 1
},
"committee": {
"draw": [
{
"role": "primary"
}
]
},
"votes_detail": [
{
"kind": "task",
"task": {
"v": 1
},
"receipt": {
"v": 1
}
}
],
"finality": {
"v": 1
}
}

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"
}