Participation

Return a list of participation keys

Return a list of participation keys

GEThttps://algo.nownodes.io/v2/participation

Authorization

api_key

Response

200400401404500default

A list of participation keys

Body

application/json

address*string

Address the key was generated for.

effective-first-validinteger

When registered, this is the first round it may be used.

effective-last-validinteger

When registered, this is the last round it may be used.

id*string

The key's ParticipationID.

key*object

AccountParticipation describes the parameters used by this account in consensus protocol.

last-block-proposalinteger

Round when this key was last used to propose a block.

last-state-proofinteger

Round when this key was last used to generate a state proof.

last-voteinteger

Round when this key was last used to vote.

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://algo.nownodes.io/v2/participation', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400401404500

[
  {
    "address": "text",
    "effective-first-valid": 0,
    "effective-last-valid": 0,
    "id": "text",
    "key": {
      "selection-participation-key": "Ynl0ZXM=",
      "state-proof-key": "Ynl0ZXM=",
      "vote-first-valid": 0,
      "vote-key-dilution": 0,
      "vote-last-valid": 0,
      "vote-participation-key": "Ynl0ZXM="
    },
    "last-block-proposal": 0,
    "last-state-proof": 0,
    "last-vote": 0
  }
]

Add a participation key to the node

POSThttps://algo.nownodes.io/v2/participation

Authorization

api_key

Body

application/msgpack

The participation key to add to the node

string (binary)

Response

200400401404500503default

Participation ID of the submission

Body

application/json

partId*string

encoding of the participation ID.

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://algo.nownodes.io/v2/participation', {
    method: 'POST',
    headers: {
      "Content-Type": "application/msgpack"
    },
    body: JSON.stringify("binary"),
});
const data = await response.json();

Response

200400401404500503

{
  "partId": "text"
}

Get participation key info given a participation ID

Given a participation ID, return information about that participation key

GEThttps://algo.nownodes.io/v2/participation/{participation-id}

Authorization

api_key

Path parameters

participation-id*string

Response

200400401404500default

A detailed description of a participation ID

Body

application/json

address*string

Address the key was generated for.

effective-first-validinteger

When registered, this is the first round it may be used.

effective-last-validinteger

When registered, this is the last round it may be used.

id*string

The key's ParticipationID.

key*object

AccountParticipation describes the parameters used by this account in consensus protocol.

last-block-proposalinteger

Round when this key was last used to propose a block.

last-state-proofinteger

Round when this key was last used to generate a state proof.

last-voteinteger

Round when this key was last used to vote.

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://algo.nownodes.io/v2/participation/{participation-id}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400401404500

{
  "address": "text",
  "effective-first-valid": 0,
  "effective-last-valid": 0,
  "id": "text",
  "key": {
    "selection-participation-key": "Ynl0ZXM=",
    "state-proof-key": "Ynl0ZXM=",
    "vote-first-valid": 0,
    "vote-key-dilution": 0,
    "vote-last-valid": 0,
    "vote-participation-key": "Ynl0ZXM="
  },
  "last-block-proposal": 0,
  "last-state-proof": 0,
  "last-vote": 0
}

Append state proof keys to a participation key

Given a participation ID, append state proof keys to a particular set of participation keys

POSThttps://algo.nownodes.io/v2/participation/{participation-id}

Authorization

api_key

Path parameters

participation-id*string

Body

application/msgpack

The state proof keys to add to an existing participation ID

string (binary)

Response

200400401404500default

A detailed description of a participation ID

Body

application/json

address*string

Address the key was generated for.

effective-first-validinteger

When registered, this is the first round it may be used.

effective-last-validinteger

When registered, this is the last round it may be used.

id*string

The key's ParticipationID.

key*object

AccountParticipation describes the parameters used by this account in consensus protocol.

last-block-proposalinteger

Round when this key was last used to propose a block.

last-state-proofinteger

Round when this key was last used to generate a state proof.

last-voteinteger

Round when this key was last used to vote.

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://algo.nownodes.io/v2/participation/{participation-id}', {
    method: 'POST',
    headers: {
      "Content-Type": "application/msgpack"
    },
    body: JSON.stringify("binary"),
});
const data = await response.json();

Response

200400401404500

{
  "address": "text",
  "effective-first-valid": 0,
  "effective-last-valid": 0,
  "id": "text",
  "key": {
    "selection-participation-key": "Ynl0ZXM=",
    "state-proof-key": "Ynl0ZXM=",
    "vote-first-valid": 0,
    "vote-key-dilution": 0,
    "vote-last-valid": 0,
    "vote-participation-key": "Ynl0ZXM="
  },
  "last-block-proposal": 0,
  "last-state-proof": 0,
  "last-vote": 0
}

Delete a given participation key by ID

Delete a given participation key by ID

DELETEhttps://algo.nownodes.io/v2/participation/{participation-id}

Authorization

api_key

Path parameters

participation-id*string

Response

200400401404500default

Participation key got deleted by ID

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://algo.nownodes.io/v2/participation/{participation-id}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Response

400401404500

{
  "data": {},
  "message": "text"
}