Validators

How to create, manage or delete a validator on the NodeHub.io platform via API.

Get all validators

GET https://api.nodehub.io/v1/nodes

This endpoint returns list of your nodes including validators with their related information.

Headers

Name	Type	Description
Authorization*	string	Authentication token you've generated in your account

200

[
  {
    "collateral": 32,
    "creation_date": "2019/07/17 09:24:50",
    "currency": "ethereum",
    "id": "FemaleLikelyWolverine",
    "last_reward": null,
    "network_status": "UNKNOWN",
    "nodehub_status": "start required",
    "package": "cloud",
    "validator_pubkey": "GVLGb7odP1o85sCHkPKMfPj25UHnDLnMaM",
    "withdrawal_address": "GVLGb7odP1o85sCHkPKMfPj25UHnDLnMaM",
    "fee_recipient": "GVLGb7odP1o85sCHkPKMfPj25UHnDLnMaM",
    "sync_status": "done",
    "ticker": "ETH"
  }
]

Get a specific validator

GET https://api.nodehub.io/v1/nodes/:id

This endpoint returns information about the validator that you've specified.

Path Parameters

Name	Type	Description
id*	string	ID of the validator

Headers

Name	Type	Description
Authorization*	string	Authentication token you've generated in your account

200

[
  {
    "collateral": 32,
    "creation_date": "2019/07/17 09:24:50",
    "currency": "ethereum",
    "id": "FemaleLikelyWolverine",
    "last_reward": null,
    "network_status": "UNKNOWN",
    "nodehub_status": "start required",
    "package": "cloud",
    "validator_pubkey": "GVLGb7odP1o85sCHkPKMfPj25UHnDLnMaM",
    "withdrawal_address": "GVLGb7odP1o85sCHkPKMfPj25UHnDLnMaM",
    "fee_recipient": "GVLGb7odP1o85sCHkPKMfPj25UHnDLnMaM",
    "sync_status": "done",
    "ticker": "ETH"
  }
]

Create a validator

POST https://api.nodehub.io/v1/validators

This endpoint allows you to create a validator.

Headers

Name	Type	Description
Authorization*	string	Authentication token you've generated in your account
Content-Type	multipart/form-data	Content-Type must be multipart/form-data.

Request Body

Name	Type	Description
currency*	string	NodeHub ID of the project
keystores*	list of .json files	List of validator keystore json files. Up to 20 files at a time can be uploaded at the same payload.
password*	string	Password for the keystore json files. All files in the same payload must have the same password.
fee_recipient*	string	Fee recipient for the validator
package*	string	Dedicated or Cloud plan.

200

{
  "keystore1.json": {"success": False, "message": "Already exists"},
  "keystore2.json": {"success": False, "message": "Invalid password"},
  "keystore3.json": {"success": True, "message": "Successfully deployed", "node_id": "GeneratedNodeID"},
}

Change fee recipient

POST https://api.nodehub.io/v1/validators/:id/fee

This endpoint allows you to change your validator's fee recipient.

Headers

Name	Type	Description
Authorization*	string	Authentication token you've generated in your account

Path Parameters

Name	Type	Description
id*	string	ID of the node

Request Body

Name	Type	Description
fee_recipient*	string	Sign message
change_for	string	Optional. Acceptable values: only_this to change for this validator only, same_fee to apply the change to all validators with the same fee recipient and same_payee to apply the change to all validators with the same validator address. Default: only_this.

200

{
  "success": True,
  "message": "Fee recipient updated successfully"
}

Delete a validator

DELETE https://api.nodehub.io/v1/nodes/:id

This endpoint deletes your specified validator.

Headers

Name	Type	Description
Authorization*	string	Authentication token you've generated in your account

Path Parameters

Name	Type	Description
id*	string	ID of the validaator

200

{
    "success": true
}