GetBlockByHeight

Query block information based on block height

Parameter

• id:
• jsonrpc: json version
• params: parameter
  • beginHeight: Starting block height
  • endHeight: End block height

tips:

When endHeight > top, endHeight = top, and the maximum difference between beginHeight and endHeight is 100

{
  "id":"1",
  "jsonrpc":"2.0",
  "params":{"beginHeight":"2484", "endHeight":"2584"}
}

Response

• id:
• jsonrpc: json version
• method: Call method name
• result: result message
  • code: result value
    • 0 success
    • -1 Block height error, beginHeight < endHeight
    • -2 The height of the request does not exceed 100
    • -3 Database abnormal, Get block hashes by block height error
    • -4 Database abnormal, Get block by block hash error
    • -5 Database abnormal, Get block top error
  • message: Call information
  • blocks: Block information (see block information description for details)

Return to Example:

{
  "id": "1",
  "jsonrpc": "2.0",
  "method": "GetBlockByHeight",
  "result": {
    "blocks": [
      {
        "block": {
          "blocksign": [
            {
              "pub": "MCowBQYDK2VwAyEAYc23TU7Tw6L9QcUXNM6FuS5kEzTTQEfX15dR9+n251Y=",
              "sign": "nYmcHtPifKAydKyaP8UOhfyPsxLfUg4cscFx4aW8BdGp0MzBnJGajgrYr35QY2QGMh8KSsldcjwqaDP1t4aZAA==",
              "signaddr": "0xadc2A709EC1413eCcEB4d115E50BD9ebBA35E3Ce"
            },
            {
              "pub": "MCowBQYDK2VwAyEAawp+8tDyeSREnNHrEaeBs6B9AeclJOlrAkeWMijTPww=",
              "sign": "S76VLYxJM6FhhiKsQqMlgaNIkeq/cutG+Zzdrd6+UWcuIDsDBHSzIzO8WO4D3UPswFQdejMW6KRkz2AbLdgFAg==",
              "signaddr": "0x79c80a68Cc851d9A2aBF16c32eBAaC866C4Fced9"
            },
            ......
          ],
          "bytes": 2398,
          "data": {
            "dependentCTx": ""
          },
          "hash": "0x85b85a2b88a9c993f44c21f45e43ff537eacfe08257d913ac9adcda223d14d4c",
          "height": 2484,
          "merkleroot": "0x446bd7acc5487883475b2c581f0c343bd9630adc35c88b584a52d5a2faec7ce8",
          "prevhash": "0xd0e8f63a7479df2cec92c701b4650eff8fbb31af6dba955f426b6966ea4541da",
          "time": 1717401536067676
        },
        "tx": [
          {
            "Consensus": 7,
            "Type": "Tx",
            "data": {
              "TxInfo": {
                "BonusAddr": "0xadc2A709EC1413eCcEB4d115E50BD9ebBA35E3Ce",
                "InvestAmount": 800000000000,
                "InvestType": "Normal"
              }
            },
            "identity": "0xadc2A709EC1413eCcEB4d115E50BD9ebBA35E3Ce",
            "info": "MQ==",
            "time": 1717401535678450,
            "txHash": "0x446bd7acc5487883475b2c581f0c343bd9630adc35c88b584a52d5a2faec7ce8",
            "txType": 4,
            "utxo": {
              "multisign": [
                {
                  "pub": "agc3qfYFfCGRHMJLSm/M37b32hITmFbt0VokGeECaEKazDrrUVDvwmRHY7QH/6lNMuuCVyfebhSjUr3AXW1ECg==",
                  "sign": "agc3qfYFfCGRHMJLSm/M37b32hITmFbt0VokGeECaEKazDrrUVDvwmRHY7QH/6lNMuuCVyfebhSjUr3AXW1ECg=="
                }
              ],
              "owner": [
                "0x638c172F63db3caf32c410D0188143E0Eff74bC8"
              ],
              "vin": {
                "prevout": {
                  "hash": [
                    "0xd738eaacbba575fff85f12d356bba157ff6dc1fcdf6c470ddf4d15cca26db7c5"
                  ]
                },
                "vinsign": [
                  {
                    "pub": "MCowBQYDK2VwAyEA878WPUVdMcjoPM+ZI1qC59e8nLgNXi/MAGIRFyU0kPM=",
                    "sign": "4H63JOxLz7T4ZxLaVAd3VMS3JUCAfv1blpaNVOM8vFyKrkk5NULHay5unpWlXQjIDEjOJCWo9jttJsoBXJbhBw=="
                  }
                ]
              },
              "vout": [
                {
                  "addr": "VirtualInvest",
                  "value": 800000000000
                },
                {
                  "addr": "0x638c172F63db3caf32c410D0188143E0Eff74bC8",
                  "value": 2199999967700
                },
                {
                  "addr": "VirtualBurnGas",
                  "value": 32300
                }
              ]
            },
            "verifySign": [
              {
                "pub": "MCowBQYDK2VwAyEAYc23TU7Tw6L9QcUXNM6FuS5kEzTTQEfX15dR9+n251Y=",
                "sign": "5+excKFT9ZgiLS12P2zrRzy565esiAtckqcFpsjWHY/6gWAJv6++5m9mn+P5eRhK8kU2iBGS4cIY7+lxadWiAA==",
                "signaddr": "0xadc2A709EC1413eCcEB4d115E50BD9ebBA35E3Ce"
              },
              {
                "pub": "MCowBQYDK2VwAyEAZVRP0epGewUhFeh7p6tvzX3Rhn4BSB/7Exjqr8hW5yk=",
                "sign": "",
                "signaddr": "0xd57730E2CE30d412cea04689C9cDE2f0846df169"
              },
              ......
            ]
          }
        ]
      }
    ],
    "code": 0,
    "message": "success"
  }
}

Example

curl http://localhost:41517/GetBlockByHeight -X POST -H "Content-Type: application/json" -d '
{
  "id":"1",
  "jsonrpc":"2.0",
  "params":{"beginHeight":"2484", "endHeight":"2584"}
}
'