Self Report (beta)
Self-serve API for node operators to report validator operations.
This endpoint is the gateway for node operators to "upload" their sets on the Rated Network Explorer. We now have a streamlined way in place for Node Operators to track their validator sets on the Rated Explorer, in a live way.
In order to prevent abuse and reduce the risk of legitimising bad actors, you must be approved by Rated in order to access this endpoint. Please head to our Rated Node Operator Onboarding form to request access.
post
/v0/selfReports/validators
Report Validators
This endpoint is the gateway for operators to onboard their validator sets to the Rated Network Explorer and OperatorsAPI. By establishing this connection you can be refreshing the state of your set on a continuous basis, as you onboard more pubkeys to the Beacon Chain.
Here's how to interpret the inputs required to operate it👇
Parameter | Context |
|---|---|
validators | Array of validator pubkeys associated with the node operator |
And here's how to you might go about implementing it👇
Curl
Python
curl -v -X 'POST' \
'https://api.rated.network/v0/selfReports/validators' \
-H 'accept: application/json' \
-H 'X-Rated-Network: mainnet' \
-H 'Authorization: Bearer <YOUR-TOKEN-HERE>'
-d '["0x01...", "0x02..."]'
import requests
from typing import Dict, List
YOUR_TOKEN: str = "ey..."
PUBKEYS: List[str] = ["0x001...", "0x002...", ]
HEADERS: Dict[str, str] = {
"Authorization": f"Bearer {YOUR_TOKEN}",
"X-Rated-Network": "mainnet",
}
try:
response = requests.post(
"https://api.rated.network/v0/selfReports/validators",
json={"validators": PUBKEYS}, # important! use json, not data here.
headers=HEADERS,
)
response.raise_for_status()
except requests.exceptions.HTTPError:
print(response.headers["x-request-id"])
print(response.json())
- Each request has a strict limit of 1,000 validator public keys. Please submit multiple requests if you need to report more than 1,000 validators.
- We cannot assign a key to your entity if it has already been reported by another operator. In case of false attribution, please contact us at [email protected], and we will address the issue.
- As this API is self-reported, it relies on the honest behaviour of all participants reporting their validators. Any instances of misconduct may lead to the exclusion of the entity from our platform.
- It typically takes about 24 hours for the reported keys to appear on rated.network/explorer. If your keys have not shown up after this period, please contact us at [email protected], and we will investigate the issue.
Last modified 29d ago