Skip to main content
Contributors are the attribution unit for b1e55ed. See also: /contributing/contributor-registration.

​
GET /contributors/

Lists contributors. 
curl -s \
  -H "Authorization: Bearer $TOKEN" \
  http://localhost:5050/api/v1/contributors/ | jq

​
POST /contributors/register

Registers a contributor.

​
Request

{
  "node_id": "b1e55ed-deadbeef",
  "name": "local-operator",
  "role": "operator",
  "metadata": {}
}

​
Example

curl -s \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"node_id":"b1e55ed-deadbeef","name":"alice","role":"operator","metadata":{}}' \
  http://localhost:5050/api/v1/contributors/register | jq
Errors:
  • 409 contributor.duplicate

​
GET /contributors/{id}

Returns a contributor. 
curl -s \
  -H "Authorization: Bearer $TOKEN" \
  http://localhost:5050/api/v1/contributors/contrib_abc123 | jq
Errors:
  • 404 contributor.not_found

​
DELETE /contributors/{id}

Removes a contributor. 
curl -s \
  -X DELETE \
  -H "Authorization: Bearer $TOKEN" \
  http://localhost:5050/api/v1/contributors/contrib_abc123 | jq
Errors:
  • 404 contributor.not_found

​
GET /contributors/{id}/score

Computes contributor score from attribution tables. 
curl -s \
  -H "Authorization: Bearer $TOKEN" \
  http://localhost:5050/api/v1/contributors/contrib_abc123/score | jq
Errors:
  • 404 contributor.not_found

​
GET /contributors/leaderboard

Returns top contributors.

​
Query parameters

ParamTypeDefault
limitint20

​
Example

curl -s \
  -H "Authorization: Bearer $TOKEN" \
  "http://localhost:5050/api/v1/contributors/leaderboard?limit=20" | jq

​
GET /contributors/attestations

Lists contributors that have an EAS UID stored in metadata. 
curl -s \
  -H "Authorization: Bearer $TOKEN" \
  http://localhost:5050/api/v1/contributors/attestations | jq

​
GET /contributors/{id}/attestation

Returns the stored off-chain EAS attestation for a contributor. 
curl -s \
  -H "Authorization: Bearer $TOKEN" \
  http://localhost:5050/api/v1/contributors/contrib_abc123/attestation | jq
Errors:
  • 404 contributor.attestation_not_found
  • 404 contributor.not_found