UNPKG

namillum

Version:
127 lines (102 loc) 3.04 kB
--- id: api-blockchain-get-blockchain-info title: GetBlockchainInfo --- --- Returns the current network statistics for the specified network. **NOTE:** `CHAIN_ID` from `2` to `9` are reserved for Zilliqa Core use. ### Example Request import Tabs from "@theme/Tabs"; import TabItem from "@theme/TabItem"; <Tabs defaultValue="cURL" values={[ { label: 'cURL', value: 'cURL', }, { label: 'node.js', value: 'node.js', }, { label: 'java', value: 'java', }, { label: 'python', value: 'python', }, { label: 'go', value: 'go', }, ] }> <TabItem value="cURL"> ```shell curl -d '{ "id": "1", "jsonrpc": "2.0", "method": "GetBlockchainInfo", "params": [""] }' -H "Content-Type: application/json" -X POST "https://api.zilliqa.com/" ``` </TabItem> <TabItem value="node.js"> ```js const blockChainInfo = await zilliqa.blockchain.getBlockChainInfo(); console.log(blockChainInfo.result); ``` </TabItem> <TabItem value="java"> ```java public class App { public static void main(String[] args) throws IOException { HttpProvider client = new HttpProvider("https://api.zilliqa.com/"); Rep<BlockchainInfo> blockchainInfo = client.getBlockchainInfo(); System.out.println(new Gson().toJson(blockchainInfo)); } } ``` </TabItem> <TabItem value="python"> ```python from pyzil.zilliqa import chain chain.set_active_chain(chain.MainNet) print(chain.active_chain.api.GetBlockchainInfo()) ``` </TabItem> <TabItem value="go"> ```go func GetBlockchainInfo() { provider := NewProvider("https://api.zilliqa.com/") response := provider.GetBlockchainInfo() result, _ := json.Marshal(response) fmt.Println(string(result)) } ``` </TabItem> </Tabs> ### Example Response ```json { "id": "1", "jsonrpc": "2.0", "result": { "CurrentDSEpoch": "5898", "CurrentMiniEpoch": "589778", "DSBlockRate": 0.00014142137245459714, "NumDSBlocks": "5899", "NumPeers": 2400, "NumTransactions": "4350627", "NumTxBlocks": "589778", "NumTxnsDSEpoch": "748", "NumTxnsTxEpoch": "4", "ShardingStructure": { "NumPeers": [600, 600, 600] }, "TransactionRate": 0.09401852277720939, "TxBlockRate": 0.014137955733170903 } } ``` ### HTTP Request | Chain(s) | URL(s) | | --------------------- | -------------------------------------------- | | **Zilliqa mainnet** | https://api.zilliqa.com/ | | **Developer testnet** | https://dev-api.zilliqa.com/ | | **Local testnet** | http://localhost:4201/ | | **Isolated server** | https://zilliqa-isolated-server.zilliqa.com/ | ### Arguments | Parameter | Type | Required | Description | | --------- | ------ | -------- | --------------------- | | `id` | string | Required | `"1"` | | `jsonrpc` | string | Required | `"2.0"` | | `method` | string | Required | `"GetBlockchainInfo"` | | `params` | string | Required | Empty string `""` |