Skip to content
Permalink
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
174 lines (159 sloc) 4.68 KB

Grimm Node Explorer API

The Node Explorer provides information about current chain state and blocks.

How to use

Find explorer-node binary in the explorer subdirectory (or download from releases) and run with the following arguments:

Node explorer options:
  -h [ --help ]                      list of all options
  --peer arg (=172.104.249.212:8101) peer address
  --port arg (=10000)                port to start the local node on
  --api_port arg (=8888)             port to start the local api server on
./explorer-node.exe --peer 67.205.185.92:8385 --api_port=8080 for example.

It may take some time (a few hours) on the first start to load all the info from chain.

API

status

GET http://x.x.x.x:port/status

Description: Gets current blockchain status.

Response:

{
  "chainwork": "0x38594101d0a0",
  "hash": "7353b5e4ad29a2ffa5f7952749d1eb04acedd82215b1f4f01d75107165f4622b",
  "height": 20531,
  "low_horizon": 19090,
  "timestamp": 1550158283
}

block

GET http://x.x.x.x:port/block?height={height} or GET http://x.x.x.x:port/block?hash={hash} or GET http://x.x.x.x:port/block?kernel={kernel}

Description: Gets block info for specified height, hash or kernel.

Response:

{
  "chainwork": "0x384fdc718a20",
  "difficulty": 157.9972152709961,
  "found": true,
  "hash": "c2a7315b63b1de6106a185c1c79219001ef5e3a07c217db227b079bbb9dd9b64",
  "height": 20516,
  "inputs": [],
  "kernels": [
    {
      "excess": "0x60413b5a09858312403190721938463ca22d7d87981a024873ddfa204a399eec",
      "fee": 0,
      "id": "d72684dba6255b2fe8631be9df764ee3c984cb0c9f386a8cf71f566acebd197d",
      "maxHeight": 18446744073709552000,
      "minHeight": 20516
    }
  ],
  "outputs": [
    {
      "coinbase": true,
      "commitment": "0x75329071d041e7828a57cbf2f63fb8db21543f35c1c2291d5c26c20d9b11465a",
      "incubation": 0,
      "maturity": 20756
    }
  ],
  "prev": "4b9e35b467b416e0d307dd94bd2fdce6e720b6b3a029dca822ccab3ac57c6d22",
  "subsidy": 8000000000,
  "timestamp": 1550157362
}

blocks

GET http://x.x.x.x:port/blocks?height={start}&n={count}

Description: Gets blocks info for specified range, where count should be <= 1500.

Response:

[
  {
    "chainwork": "0x380b69b2d420",
    "difficulty": 161.94402313232422,
    "found": true,
    "hash": "2107b173f174972c8ec7543ab731bf1905d24d101f45b42d5f0cd64853e4c38e",
    "height": 20402,
    "inputs": [],
    "kernels": [
      {
        "excess": "0x3829270cf74d473af83015501a83747b5b8c75c0d13303569a352bfe53b4ef4b",
        "fee": 0,
        "id": "3d0bed1e452c911f830351c671696f51e4a6a9086aeb7a059fc027a0db9c84a0",
        "maxHeight": 18446744073709552000,
        "minHeight": 20402
      }
    ],
    "outputs": [
      {
        "coinbase": true,
        "commitment": "0xb4261a4a7fabe181f6dd7e766410cf1aba8892fd2f41d3a7ff9378a4811521ff",
        "incubation": 0,
        "maturity": 20642
      }
    ],
    "prev": "09cf95acda1e9c3e8b1a45873fd9ef1d744d6645d16bd6b8c5e9ae8dfe2d0b1a",
    "subsidy": 8000000000,
    "timestamp": 1550150788
  },
  {
    "chainwork": "0x380ac7c128a0",
    "difficulty": 162.0944366455078,
    "found": true,
    "hash": "09cf95acda1e9c3e8b1a45873fd9ef1d744d6645d16bd6b8c5e9ae8dfe2d0b1a",
    "height": 20401,
    "inputs": [],
    "kernels": [
      {
        "excess": "0x554a6ef457d33abddcb98169fcd7fe68a7aa94bc2145a40f39d07ace7b43c0de",
        "fee": 0,
        "id": "c68cddd64a07974a1d5ea73eb4333a9b732a5b9ac705546217fa66d2ba5e8dd8",
        "maxHeight": 18446744073709552000,
        "minHeight": 20401
      }
    ],
    "outputs": [
      {
        "coinbase": true,
        "commitment": "0x6fd9e1124f91a744c7043f2873716094e1a6cc3a8ae9ca5278a1a421a7622301",
        "incubation": 0,
        "maturity": 20641
      }
    ],
    "prev": "9a8053f05ed7b6575770e002100025fa58452e307cf73d3594cbcd861fa5035a",
    "subsidy": 8000000000,
    "timestamp": 1550150719
  },
  {
    "chainwork": "0x380a25a8fba0",
    "difficulty": 161.4037857055664,
    "found": true,
    "hash": "9a8053f05ed7b6575770e002100025fa58452e307cf73d3594cbcd861fa5035a",
    "height": 20400,
    "inputs": [],
    "kernels": [
      {
        "excess": "0x7eef6fa3449e87dde801fec11cd6cec8b448a87f7bd1231cff668904ee6045d5",
        "fee": 0,
        "id": "bee59b34ea59a95e9fb415d34de3cc34416debcc1e14fd993f749b2aaee9b14d",
        "maxHeight": 18446744073709552000,
        "minHeight": 20400
      }
    ],
    "outputs": [
      {
        "coinbase": true,
        "commitment": "0x3b8a5d665b08119b8b8ee98c831089e0f7b3219ee92b3cf9d749777349ffd285",
        "incubation": 0,
        "maturity": 20640
      }
    ],
    "prev": "34ce853ef5d9b6878bb694b5eec0620217d2b5f68f36cfdfc9c3bd4f1ae67107",
    "subsidy": 8000000000,
    "timestamp": 1550150667
  }
]
You can’t perform that action at this time.