# Block Related Commands

Block related commands are all online, reference, and general commands.

# Get Height

# Usage

Usage: miyabi-cli getheight [options]

Options:
--help  Show help information

# Functionality

Return the current height of blockchain stored in the connected node.

# Example

$ ./miyabi-cli.exe getheight 
8

# Get Block

# Usage

Usage: miyabi-cli getblock [options]

Options:

--help             Show help information
-h|--height <num>  Block height 
-i|--id <hex>      Block id

# Functionality

Return the specific block information of the given height or block Id. -i or-h options need to be specified.

# Example

$ ./miyabi-cli.exe --pretty getblock -h 2 
{ 
  "value": { 
    "txCount": 1, 
    "sizeBytes": 920, 
    "height": 2, 
    "id": "adff51c544a6c76256a5679b00ab02a2ef1ec9f48d3ae5c30ba652a87132579d", 
    "header": { 
      "previousBlock": "cb4717e95d5a971628209e5abc6745085c2b9c7f06ca2718cb84b2c89795499f", 
      "transactionsMerkleRoot": "74f07b7c678f380e2341fcffedb01f14f2d097da0450cd5d40061605c0580c3e", 
      "eventsMerkleRoot": "5df6e0e2761359d30a8275058e299fcc0381534545f55cf43e41983f5d4c9456", 
      "stateHash": "a96e5095636bb074ab59f3495db4bfb16ea68146", 
      "eventFilter": "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000", 
	  "timestamp": "2019-11-12T06:27:10.073411Z" 
    }, 
    "evidence": { 
      "acceptStatement": { 
        "height": 2, 
        "round": 39, 
        "proposalDigest": "adff51c544a6c76256a5679b00ab02a2ef1ec9f48d3ae5c30ba652a87132579d" 
      }, 
      "evidence": [ 
        "3045022100cb851abedb839db98e64e5fbbbb7a785d843faa25502f0a50aa16fde1df42b900220161e7797061eb4e876f196b51ad38035d9e234ff753756dd66caeb0f19a309b8" 
      ] 
    } 
  }, 
  "atHeight": 4 
}

# Get Blocks

# Usage

Usage: miyabi-cli getblocks [options]

Options:
--help                  Show help information
-d|--depth <num>        Depth
-s|--startheight <num>  start height

# Functionality

Return blocks from startheight to min(startheight + depth, current height). Depth's default value is 10 and there is an upper bound defined in node config. Default value of start height is max(0, current height - depth).

# Example

$ ./miyabi-cli.exe --pretty getblocks  
{
  "value": [
    {
      "txCount": 1,
      "sizeBytes": 852,
      ...
      "height": 1234,
      "id": "69531d13c100b9fda288c62660a8e5d4c5974f47571f6ac1bef49c0d505ce7ba",
      "header": {
        "previousBlock": "739e7a84618fdb03accb5aa22d6cf6a4ff0bc2d77de1c677c4a5bbc3525a5d64",
        "transactionsMerkleRoot": "4772b0ba878425f0386a50672642499ebef41b40a6dc3040dea199577ecf0621",
        ...
   "evidence": {
        "acceptStatement": {
          "height": 1225,
          "round": 0,
          "proposalDigest": "1893d3e4f753e45dcfede90e8113d1ddd564796dc54f76a65def92b98518508c"
        },
        ...
  "atHeight": 1235
}

# Get Header

# Usage

Usage: miyabi-cli getheader [options]

Options:
--help             Show help information
-h|--height <num>  Block height
-i|--id <hex>      Block id

# Functionality

Return the block header of specific block height. -i or-h option need to be specified.

# Example

$ ./miyabi-cli.exe --pretty getheader -h 2  
{ 
  "value": { 
    "height": 2, 
    "id": "adff51c544a6c76256a5679b00ab02a2ef1ec9f48d3ae5c30ba652a87132579d", 
    "header": { 
      "previousBlock": "cb4717e95d5a971628209e5abc6745085c2b9c7f06ca2718cb84b2c89795499f", 
     ...
    "evidence": { 
      "acceptStatement": { 
        "height": 2, 
        "round": 39, 
        "proposalDigest": "adff51c544a6c76256a5679b00ab02a2ef1ec9f48d3ae5c30ba652a87132579d" 
      }, 
      "evidence": [  "3045022100cb851abedb839db98e64e5fbbbb7a785d843faa25502f0a50aa16fde1df42b900220161e7797061eb4e876f196b51ad38035d9e234ff753756dd66caeb0f19a309b8" 
      ]
    } 
  }, 
  "atHeight": 8 
}

# Get Headers

# Usage

Usage: miyabi-cli getheaders [options]

Options:
--help                  Show help information
-d|--depth <num>        Depth
-s|--startheight <num>  Start height

# Functionality

Return the specific block headers. Usage of -d and-s is the same as getblocks.

# Example

$ ./miyabi-cli.exe  --pretty getheaders -s 1 -d 2 
{
  "value": [
    {
      "height": 2,
      "id": "c999e807740129f0ab077357148fd9d8219d78ac9f00aca99e9ff2627d5a3f51",
      "header": {
        "previousBlock": "a5af0fd90d426437e29d46628b8cf3740b0ec92d1d06dba3f30bf98c61690c35",
        "transactionsMerkleRoot": "314112692a5f677cbf20e38c0715697d8ce5f87ea9cb7936b712dd953f2f69f0",
        "eventsMerkleRoot": "5df6e0e2761359d30a8275058e299fcc0381534545f55cf43e41983f5d4c9456",
        "stateHash": "d0018f34a0fdf78d18e67efbb0e19c259425f315",
        ...
    },
    {
      "height": 1,
      "id": "a5af0fd90d426437e29d46628b8cf3740b0ec92d1d06dba3f30bf98c61690c35",
      "header": {
        "previousBlock": "3fa99c2cbeb82352f455846fddcda8ed0fdf196aa259cd895fe0d77b4d21c54e",
        "transactionsMerkleRoot": "0b5f7086580ab12718bc2b107c449c27f627c2ad999d4e65205cd6a0ad981462",
        ...
    }
  ],
  "atHeight": 1239
}

# Get Block Events

# Usage

Usage: miyabi-cli getblockevents [options]

Options:
--help                Show help information
-i|--id <hex>         Block id
-h|--height <height>  Block height

# Functionality

Return the block events of a specific height or block id. -i or -h options need to be specified.

# Example

$ ./miyabi-cli.exe --pretty getblockevents -h 2  
{ 
  "value": { 
    "id": "cb67466866056d64230948078b806140fab4e6bb4ed9cdb561cf125ac72bb1c4", 
    "events": [ 
      { 
        "txIndex": 0, 
        "txId": "f76f01358d9f04f9982dced015d68f0762e3f87e60d9bf6c033e56f0aa596181", 
        "events": [ 
          { 
            "eventDataType": "ContractEventData", 
            "originatingEntry": "ContractInvoke", 
            "eventData": { 
              "eventName": "SampleEvent", 
              "originatingContract": "808215076d034831981017cbe4882d28b87ab6a76cdd78c678e0fca9b356a19497", 
              "eventValue": "{\"message\":\"Write is called\"}", 
              "filterData": [ 
                "53616d706c654576656e74", 
     "808215076d034831981017cbe4882d28b87ab6a76cdd78c678e0fca9b356a19497" 
              ], 
              "type": "ContractEventData" 
            } 
          } 
        ], 
        "filterData": "00000000000000000000010000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000400002000200000000000000000000000000000000000000000000000000001000000000000000000000000400000000000000000000000000000000000000000000000000000000010000000000000000000000" 
      } 
    ] 
  }, 
"atHeight": 3
}

# Get Blockchain Parameters

# Usage

Usage: miyabi-cli getblockchainparameters [options]

Options:
--help                  Show help information
-h|--depth <num>        Height

# Functionality

Returns the Blockchain Parameters for the blockchain at a given height h. The default value is the current height of the blockchain

# Example

$ ./miyabi-cli.exe  --pretty getblockchainparameters -h 34
{
  {
  "maxtpb": 8000,
  "emptyBlocks": false,
  "transactionLifetime": "01:00:00",
  "byzantineAssumption": true,
  "evidenceValidatorType": "",
  "maxClockDrift": "00:00:10",
  "networkName": "",
  "initScript": "[{\"type\": \"CreateAssetTable\", \"name\": \"TestInitAssetTable\", \"tracked\": \"false\", \"supportProofs\": \"false\", \"tableAcl\": {\"tableOwners\": [\"03b25c2a2e3793e14797dd100b668da2023e2bb03cf7b9a25d0b1f28487b856054\"]}, \"isReadRestricted\": \"false\", \"permissionModel\": \"CheckRowOnly\", \"tokenAdmins\": [\"03b25c2a2e3793e14797dd100b668da2023e2bb03cf7b9a25d0b1f28487b856054\"]}, {\"type\": \"ContractInitialize\", \"contractAdmins\": [\"0315ebc05445e3f9936732210aefb03781fe38558582666082571d4d6901c18cb9\", \"02284ecf010803f287dee92b8403ab6bdba590dcb0e5434b97fb3dcecfbab6ca34\", \"039dd634a89c706057df02b2491257d542970ac0776b58d9881dffd3af88004106\", \"02031868856c8bb0f1c8fdbc1acb728dc7dca5e7560ce68225c540bdd0dd077aef\", \"029666b7cb79a26111a7ec73471a2dcf848737e63d2a861d741b6cc5f9d04013e0\", \"023313b277629f6168febbaea102ca1f86be1b954570312b9b5725c4d7f997e766\", \"037e9e76c4ca5f777d4a9fed89e94b7febfa3e2959e105fc80ef708242b0cc76f6\", \"03ec41bba53d90ccaa12ee5d432d4d6179d465e97ecdaa716dbf67170cfe1d1620\", \"029d549131d0c2cee9de4b81e6d0f9f9b441adc7ec33434aa74503f554dd158423\", \"029bba801c2bf5574f79b767404a29c6ffaaf551e762ca9a630ddcc24d4dd1f361\"], \"contractDebug\": true}]",
  "extensions": [
    {
      "name": "Miyabi.BLS",
      "publicKey": ""
    },
    {
      "name": "Miyabi.Binary",
      "publicKey": ""
    },
    {
      "name": "Miyabi.Asset",
      "publicKey": ""
    },
    {
      "name": "Miyabi.Entity",
      "publicKey": ""
    },
    {
      "name": "Miyabi.Contract",
      "publicKey": ""
    },
    {
      "name": "Miyabi.NFT",
      "publicKey": ""
    },

  ],
  "blockLimit": {
    "MaxEntriesPerTransaction": 100,
    "MaxTransactionByteSize": 1000000
  }
}
}

← Certificate Commands →