Skip to content

Network Node API

This section describes the Network Node API, specifically the /v1/epochs/{epoch_id}/participants endpoint. This endpoint is used to retrieve:

  • Merkle proofs
  • Host data
  • Validator signatures

Usage

Current Epoch Data 

curl -X GET http://<your_api_node_url:public_port>/v1/epochs/current/participants

Specific Epoch Data 

curl -X GET http://<your_api_node_url:public_port>/v1/epochs/<epoch_id>/participants

Example response breakdown

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
{
  "active_participants": {
    "participants": [
    {
        "index": "gonka17tvsmufmewvwfy3dfxz7l20jmlhhn6ekfcun7r",
        "validator_key": "ljvRT9VScsxQKKX4S91yJRNppbz691ceD4sBYBRrAys=",
        "weight": 10,
        "inference_url": "http://genesis-api:8080",
        "models": [
        "unsloth/llama-3-8b-Instruct"
        ],
        "seed": {
        "participant": "gonka17tvsmufmewvwfy3dfxz7l20jmlhhn6ekfcun7r",
        "block_height": 9,
        "signature": "6a2523cd5898539ef8ea765c7ab78f0de5dbcbb32a34b9706baa7294589f94d657422f573e7a4325d4ba8661466171c9621a51544478eb69f90a49b5271c1400"
        }
    }
    ],
    "epoch_group_id": 1,
    "poc_start_block_height": 9,
    "created_at_block_height": 15
  },
  "addresses": [
    "BBDEDC12E4830D2086263415BE3FB4BF43C505A5"
  ],
  "active_participants_bytes": "0acc020a2d636f736d6f7331377476736d75666d657776776679336466787a376c32306a6d6c68686e36656b6663756e3772122c6c6a765254395653637378514b4b5834533931794a524e7070627a363931636544347342594252724179733d180a2217687474703a2f2f67656e657369732d6170693a383038302a1b756e736c6f74682f6c6c616d612d332d38622d496e73747275637432b4010a2d636f736d6f7331377476736d75666d657776776679336466787a376c32306a6d6c68686e36656b6663756e377210091a8001366132353233636435383938353339656638656137363563376162373866306465356462636262333261333462393730366261613732393435383966393464363537343232663537336537613433323564346261383636313436363137316339363231613531353434343738656236396639306134396235323731633134303010011809280f",
  "proof_ops": {
    "ops": [
    {
        "type": "ics23:iavl",
        "key": "QWN0aXZlUGFydGljaXBhbnRzLzEvdmFsdWUv",
        "data": "CuMEChtBY3RpdmVQYXJ0aWNpcGFudHMvMS92YWx1ZS8S1QIKzAIKLWNvc21vczE3dHZzbXVmbWV3dndmeTNkZnh6N2wyMGptbGhobjZla2ZjdW43chIsbGp2UlQ5VlNjc3hRS0tYNFM5MXlKUk5wcGJ6NjkxY2VENHNCWUJSckF5cz0YCiIXaHR0cDovL2dlbmVzaXMtYXBpOjgwODAqG3Vuc2xvdGgvbGxhbWEtMy04Yi1JbnN0cnVjdDK0AQotY29zbW9zMTd0dnNtdWZtZXd2d2Z5M2RmeHo3bDIwam1saGhuNmVrZmN1bjdyEAkagAE2YTI1MjNjZDU4OTg1MzllZjhlYTc2NWM3YWI3OGYwZGU1ZGJjYmIzMmEzNGI5NzA2YmFhNzI5NDU4OWY5NGQ2NTc0MjJmNTczZTdhNDMyNWQ0YmE4NjYxNDY2MTcxYzk2MjFhNTE1NDQ0NzhlYjY5ZjkwYTQ5YjUyNzFjMTQwMBABGAkoDxoLCAEYASABKgMAAh4iKwgBEgQCBB4gGiEgwUNlynn4mzi4AC3u2itEeV3Y7Qe2vynK7Qqup2tmVgAiKwgBEgQECB4gGiEgiNVJ1Gl2VO0MezltgAUQs72vlGp3j3OWKH1OAD9MPHoiKwgBEgQGDB4gGiEgLyrwJqJ3jIIDD+gd8EO/3G8lNiCgkcpBn9IkqETCGbYiKwgBEgQIEh4gGiEgktjdW4rq4PGPx+En8SQnX7eIl6J5Qf4I9NEMMCokPa4iKwgBEgQKKB4gGiEg4Lo2jUStQ7FHrFhkm+Tk5df+rBHeeA6Ey5npZw+DEIk="
    },
    {
        "type": "ics23:simple",
        "key": "aW5mZXJlbmNl",
        "data": "CtoBCglpbmZlcmVuY2USIAeInJI1DSn8uBZz5z28V3JeXiQ7kPFDaCWqZeKu/1+ZGgkIARgBIAEqAQAiJwgBEgEBGiCkF0H31nsqBz1NVD3bG1444WqkoI982R1FXozDhDZvTyInCAESAQEaIJXhyLpHqjGG8RNH1IDYExUpZFPyxZvc7HLLmYEKxBeAIicIARIBARogVb5ZN4+aA5PlSPOrcbIeH/EuZ+nmQpJSod9LdNOb3WkiJQgBEiEBecxJ03qGQtj8qBYv4F3GTI9KLCix0WU+5PQNmJxXm7o="
    }
    ]
  },
  "validators": [
    {
    "address": "BBDEDC12E4830D2086263415BE3FB4BF43C505A5",
    "pub_key": "ljvRT9VScsxQKKX4S91yJRNppbz691ceD4sBYBRrAys=",
    "voting_power": 1000000,
    "proposer_priority": 0
    }
  ],
  "block": [
    {
    "header": {
        "version": { "block": 11 },
        "chain_id": "gonka-mainnet",
        "height": 15,
        "time": "2025-04-02T21:13:34.100375646Z",
        "last_block_id": {
        "hash": "306D1EBC3628F0571D5F772C85B554A8CD30C298648B4E325EC82945E7D20841",
        "parts": {
            "total": 1,
            "hash": "055C7DD9132B5133B7D422D423ED775BC4FF5E7E3C7447C4539B5573D67686DD"
        }
        },
        "last_commit_hash": "04584765750C36899099C65023702382D718F5CF5E44581F675EAEDF4F15DE9E",
        "data_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855",
        "validators_hash": "BC21E09900AE1CBD50444061E0B1853550A509A3B8CE3B2BF5DA0C9DCC0351B0",
        "next_validators_hash": "BC21E09900AE1CBD50444061E0B1853550A509A3B8CE3B2BF5DA0C9DCC0351B0",
        "consensus_hash": "048091BC7DDC283F77BFBF91D73C44DA58C3DF8A9CBC867405D8B7F3DAADA22F",
        "app_hash": "6DAF9E22F6A30D441F5C40BF37ABD8A3B11A7582F5023413639C3015C6E47713",
        "last_results_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855",
        "evidence_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855",
        "proposer_address": "BBDEDC12E4830D2086263415BE3FB4BF43C505A5"
    },
    "data": { "txs": null },
    "evidence": { "evidence": null },
    "last_commit": {
        "height": 14,
        "round": 0,
        "block_id": {
        "hash": "306D1EBC3628F0571D5F772C85B554A8CD30C298648B4E325EC82945E7D20841",
        "parts": {
            "total": 1,
            "hash": "055C7DD9132B5133B7D422D423ED775BC4FF5E7E3C7447C4539B5573D67686DD"
        }
        },
        "signatures": [
        {
            "block_id_flag": 2,
            "validator_address": "BBDEDC12E4830D2086263415BE3FB4BF43C505A5",
            "timestamp": "2025-04-02T21:13:34.100375646Z",
            "signature": "twGyWJvYr+jV1Hhfjio7p7lkDbg2+OrpUqI6Nmb3xHta0hKQyoky2S4U755x2YewLdG8t/1TlaqzurljQoXmDg=="
        }
        ]
    }
    }
  ]
}

active_participants

participants: List of active participants, including:

  • index: gonka address
  • validator_key: Public key (Base64)
  • weight: Voting weight
  • inference_url: Service endpoint
  • models: List of supported models
  • seed: Signature seed with metadata

addresses: List of participant addresses (in uppercase hex format)

active_participants_bytes: Raw byte array (hex-encoded) that encodes the Hosts' data — suitable for Merkle proof verification or state synchronization.

proof_ops: List of ICS23-compatible proof operations for verification

validators: Validator set at the time of the epoch:

  • address: Validator address
  • pub_key: Public key (Base64)
  • voting_power: Current voting power
  • proposer_priority: Consensus proposer priority

block: List of blocks surrounding the epoch event

  • Includes full block header metadata, proposer address, commit signatures, etc.
  • Useful for verifying the inclusion and commitment of Host data

Need help? Find answers on FAQ page, or join Discord server for assistance with general inquiries, technical issues, or security concerns.