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
  • Participant 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-testnet-2",
        "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 participants' 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 participant data

Need help? Join Discord server for assistance with general inquiries, technical issues, or security concerns.