0DNS API
Endpoints exposed by the node locator service, 0DNS.
Here listed all the endpoints exposed by the Node Locator service, which is used by the clients that need to communicate with the nodes of the chain (Miners/Sharders) to locate them retrieving their URLs and meta-information about the network. All endpoints should be prefixed by the url of the DNS service.
Get Network Nodes - GET /network
GET /networkRetrieve main nodes of the network. No parameters needed.
Response
{
"miners": [
"https://dev2.zus.network/miner01",
"https://dev3.zus.network/miner01",
"https://dev1.zus.network/miner01"
],
"sharders": [
"https://dev2.zus.network/sharder01",
"https://dev3.zus.network/sharder01",
"https://dev1.zus.network/sharder01"
]
}Get Latest Magic Block - GET /magic_block
GET /magic_blockMagic block is a special type of blocks that contains meta information about the network and its nodes. For more information about the magic block, refer to the Magic Block entity page. No parameters needed.
Response
{
"hash": "506391f07cabd7bfee330f979ba9baab498b721b748eb869ba2b5c054932c8bd",
"previous_hash": "",
"magic_block_number": 1,
"starting_round": 0,
"miners": {
"type": 0,
"nodes": {
"8f9a15b9551f8552a19cf4750ef14bff3bbac83bc1decd4d5a013a7f36f7ef71": {
"id": "8f9a15b9551f8552a19cf4750ef14bff3bbac83bc1decd4d5a013a7f36f7ef71",
"version": "",
"creation_date": 1669895308,
"public_key": "a93743137c318274bf375e32c00b91439c18c0c0432eac550b2c1a54d909fa0f6669408c3208e5f68fab5aa6c36c91e1978670f17118d3fb75b854d68c1c740f",
"n2n_host": "dev2.zus.network",
"host": "dev2.zus.network",
"port": 7071,
"path": "miner01",
"type": 0,
"description": "dev2@gmail.com",
"set_index": 0,
"status": 0,
"info": {
"build_tag": "",
"state_missing_nodes": 0,
"miners_median_network_time": 0,
"avg_block_txns": 0
}
},
"96b96df7631e00d339f9a25131927c43cba9f130b075f4af09e8934c21173341": {
"id": "96b96df7631e00d339f9a25131927c43cba9f130b075f4af09e8934c21173341",
"version": "",
"creation_date": 1669895308,
"public_key": "171fbdcbd536fc64f4bcf7f2730731a1c9468210a377e4efcc83f0e3a072560231ea028c56ae6e956f74463ab6438bd375ab4d8f877dadd42914c6488cb9621b",
"n2n_host": "dev3.zus.network",
"host": "dev3.zus.network",
"port": 7071,
"path": "miner01",
"type": 0,
"description": "dev3@gmail.com",
"set_index": 1,
"status": 0,
"info": {
"build_tag": "",
"state_missing_nodes": 0,
"miners_median_network_time": 0,
"avg_block_txns": 0
}
},
"c3227e496fdf3c9aa604f3470a2bbd1249f00142150bc067996cd0d6ffcd77ea": {
"id": "c3227e496fdf3c9aa604f3470a2bbd1249f00142150bc067996cd0d6ffcd77ea",
"version": "",
"creation_date": 1669895308,
"public_key": "0e33db4984e356e7cf5963d3b83fbf6273c5d309f68f95f5dc985c7d4368bc182d6be685dd3eefdbfc3652b1c914b4a862d07ac2c0197ae68fac62c2ed4a7093",
"n2n_host": "dev1.zus.network",
"host": "dev1.zus.network",
"port": 7071,
"path": "miner01",
"type": 0,
"description": "dev1@gmail.com",
"set_index": 2,
"status": 0,
"info": {
"build_tag": "",
"state_missing_nodes": 0,
"miners_median_network_time": 0,
"avg_block_txns": 0
}
}
}
},
"sharders": {
"type": 1,
"nodes": {
"371a09c9eec259d9d3ba794ecccdd392ecdeec4c35565ccc5977fba44e20217d": {
"id": "371a09c9eec259d9d3ba794ecccdd392ecdeec4c35565ccc5977fba44e20217d",
"version": "",
"creation_date": 1669895308,
"public_key": "c628ee0089586353bdda3476e9b70c9c91d6e0cd9e6ecb6b7d03628e6dd667245e97007fe143e47e6a67d1cd1f902e1a7ac2e9108ae9795050c5f2bafbd28ea1",
"n2n_host": "dev2.zus.network",
"host": "dev2.zus.network",
"port": 7171,
"path": "sharder01",
"type": 1,
"description": "dev2@gmail.com",
"set_index": 0,
"status": 0,
"info": {
"build_tag": "",
"state_missing_nodes": 0,
"miners_median_network_time": 0,
"avg_block_txns": 0
}
},
"afa396409ef1a78dff132f586c1f55e4725ccdc8554a727a525fcab44b3bcb16": {
"id": "afa396409ef1a78dff132f586c1f55e4725ccdc8554a727a525fcab44b3bcb16",
"version": "",
"creation_date": 1669895308,
"public_key": "163e5b04d2fbc4268af7e02a019bc0e7a623397464d695f8d3cabc997a145a11812fc5be9381964e9310a1c24762085ec224f0a1520d55ecd4e8920d56b486a3",
"n2n_host": "dev3.zus.network",
"host": "dev3.zus.network",
"port": 7171,
"path": "sharder01",
"type": 1,
"description": "dev3@gmail.com",
"set_index": 1,
"status": 0,
"info": {
"build_tag": "",
"state_missing_nodes": 0,
"miners_median_network_time": 0,
"avg_block_txns": 0
}
},
"e3cc90b550e7c5e906583897648dea5bc0cd61ae2127edb044892203384a1f33": {
"id": "e3cc90b550e7c5e906583897648dea5bc0cd61ae2127edb044892203384a1f33",
"version": "",
"creation_date": 1669895308,
"public_key": "ffb93216d151399d02357ec5b24f4a07a4667ae957fa163aaf603e7ec5a3df1bee32ef78bcb4551478ad3705016ba8c95fdba99daf02dcae3c2634654c016905",
"n2n_host": "dev1.zus.network",
"host": "dev1.zus.network",
"port": 7171,
"path": "sharder01",
"type": 1,
"description": "dev1@gmail.com",
"set_index": 2,
"status": 0,
"info": {
"build_tag": "",
"state_missing_nodes": 0,
"miners_median_network_time": 0,
"avg_block_txns": 0
}
}
}
},
"share_or_signs": {
"shares": {
"8f9a15b9551f8552a19cf4750ef14bff3bbac83bc1decd4d5a013a7f36f7ef71": {
"id": "8f9a15b9551f8552a19cf4750ef14bff3bbac83bc1decd4d5a013a7f36f7ef71",
"share_or_sign": {
"96b96df7631e00d339f9a25131927c43cba9f130b075f4af09e8934c21173341": {
"id": "",
"message": "d9cd2ce0df45e1677e9a80a6866a728dc81f4f900de8407b9c6a7cc6c8347050",
"share": "",
"sign": "1 1f95773ebaba44ca362d3c6c56e9aadcac60d1a3a39048dfba228a344f2ed739 33dea02718fe85e8288089f6efa2276247abd6291d753c81cadc654e4258469"
},
"c3227e496fdf3c9aa604f3470a2bbd1249f00142150bc067996cd0d6ffcd77ea": {
"id": "",
"message": "34074c8b8ae0605369fc1f9638f4ec9cee172cefb459ba4b191d2453aa6ca564",
"share": "",
"sign": "1 10bd1f7168a29b8215a3b7b194c1a0d9d8dbf0cf7a95e751024bd8e7710bd0b0 23327791cf1a76cd2913a50891ea473fc07663c24baf8701794ab3d6f94ef3f4"
}
}
},
"96b96df7631e00d339f9a25131927c43cba9f130b075f4af09e8934c21173341": {
"id": "96b96df7631e00d339f9a25131927c43cba9f130b075f4af09e8934c21173341",
"share_or_sign": {
"8f9a15b9551f8552a19cf4750ef14bff3bbac83bc1decd4d5a013a7f36f7ef71": {
"id": "",
"message": "6a3567e309f71b623739d2deb24386fcc9788f1163225aa3b756c05f398cac92",
"share": "",
"sign": "1 14aaa08b323db21f2f3f9d27631525a7fb2b97cad97f3337d5ff81d8c22c685f b7acb4663200f30edce6c41991c7d48e42305b9feb1de64c452266006bc662f"
},
"c3227e496fdf3c9aa604f3470a2bbd1249f00142150bc067996cd0d6ffcd77ea": {
"id": "",
"message": "df80067ccb70c759dbd313bb9e93d9da6240e5017d3f2e12d237fda7551d97b6",
"share": "",
"sign": "1 182512ec851506556a4228897fc78dcb0eda11aeefbfbf15e4f032b7376f348b 2917c106b04e007b55e375d26cb2c56b35efc550fd5965ac8ab1afbc12e3d35"
}
}
},
"c3227e496fdf3c9aa604f3470a2bbd1249f00142150bc067996cd0d6ffcd77ea": {
"id": "c3227e496fdf3c9aa604f3470a2bbd1249f00142150bc067996cd0d6ffcd77ea",
"share_or_sign": {
"8f9a15b9551f8552a19cf4750ef14bff3bbac83bc1decd4d5a013a7f36f7ef71": {
"id": "",
"message": "bc91f71dbba3cd44f6e664f07916063ef858402954354200e1129f641bbbd89c",
"share": "",
"sign": "1 702844529627c0ffb1a40cd29b02b90f173c703abf84fa73a95bd715ed5583c 105634cd2e050eea4d7dfc6ce38e2974ac89487e370f3de507e3f47b1db838cb"
},
"96b96df7631e00d339f9a25131927c43cba9f130b075f4af09e8934c21173341": {
"id": "",
"message": "a3787d198451b056d27839cb20227340dc66dea79188100929703a5f951ec0cc",
"share": "",
"sign": "1 4649b4b7fa099bc1f8d0fb7c864ed7df7272c60ee6f29fff5fb042fa4ad645 1bfb6786f910e4c52999d527029c04c3618e7625512ee38f2087a93e595adceb"
}
}
}
}
},
"mpks": {
"Mpks": {
"8f9a15b9551f8552a19cf4750ef14bff3bbac83bc1decd4d5a013a7f36f7ef71": {
"ID": "8f9a15b9551f8552a19cf4750ef14bff3bbac83bc1decd4d5a013a7f36f7ef71",
"Mpk": [
"1 149193bdf3444a563a4f4ac776bbfba49374776f0262b93b377f30e5649d3ad5 1a2e7868c6940f15bf56950688c26376985dcf850c35c8f754e438d28f91c705 14ae808cd1e9ac93f524a96f9f44e73028cb636931a19d4e971089eb0fb72286 fcc941c5a29381a2dedb1c186abc6f8b9bbbc1cb774ed2efa89667d2f9d51e",
"1 9ff8f430a5be8323003a714b7d3c1dc55792971413431b585234feaf7fc2379 1cdc7a25bc42c913b00a351392cb2d5762807dab078c1bbb05c4e0fa909dbe5c 145c357ede6c97a107712a862bb4bc153311fc1e41150838e40844b6a2cefe58 8a5253e9d84d2fb6d066936ed97e64b00c20a1fd7de0b672faed6cdc35dbb3e"
]
},
"96b96df7631e00d339f9a25131927c43cba9f130b075f4af09e8934c21173341": {
"ID": "96b96df7631e00d339f9a25131927c43cba9f130b075f4af09e8934c21173341",
"Mpk": [
"1 4845997dc7fe3ecc9e2992b264dcdbbadf008b6d5bf949b8b57d23c2efeac7f 37fc94a3f09139cedba07972634e42a54d59cea06c2d04ff0d4d6ad20e05195 1d54d1cce350642e7ae6a1caae81d9f0bee3e36397aa76beb12612f61db3288b 1adfe1b02a9e6bdc64fad117f7d21849bd6fc8fb1cd5d27981b9f9234002efd5",
"1 23cdd8c60a0c8a0fe1e3d44d91ea5848e085c7c6115fc7307e2d63ae2e5410e5 22e51b03f133b1e53ad825d4e22f2bcefefbf1b652eaa774e62ccdd5502b00e8 1d03bb6dec690747ec1e1659de1a2c93e8f267a596d20b965a30811bad28ea1 22f9ade2b6f3a47d60f8ea22e19bbd5c01d81c6436932303f02857c69bffc8c2"
]
},
"c3227e496fdf3c9aa604f3470a2bbd1249f00142150bc067996cd0d6ffcd77ea": {
"ID": "c3227e496fdf3c9aa604f3470a2bbd1249f00142150bc067996cd0d6ffcd77ea",
"Mpk": [
"1 16d44868531c5462f539c40c89942fe1f660124a3c120d495af9baae60464027 ef31d67e79edf882c6f85b2b4d688fe73064544c95a7a0015dca3b7b5a3f102 15f7fbb6f5aabe28274457fa5bf2017faefaf26db5b47bab463556f711760713 15e173baa89bf8bfbe013e3b8ef25f1ef67f51e071b1aa27224fb04cbfff3ef4",
"1 24a3950914dbd84eda94a329b4e6a1049ef085038e59497304747bde6e4e7aec 21534de560851803e3d5d3f33e5c42eac88fa57b89ad414f8a5e5472f814210a 1d57305133ce377a29367ebe24d48ffc8b103b772898f2c3b410a2e68c7a9d15 10054ffdbe0afd7c9a97699807b8ed2870b4a24801d224049025a39abf43615c"
]
}
}
},
"t": 2,
"k": 3,
"n": 3
}Last updated