Skip to content

Chain

Block chain RPC interface

Used to obtain block information

1. chain_getBlock

  • Usage:

  Used to obtain block information

  • Params:

   1. height usage: Current block height

  • Return:Block detail information

  • Example:

shell:

curl http://localhost:10085 -X POST --data '{"jsonrpc":"2.0","method":"chain_getBlock","params":[1000], "id": 3}' -H "Content-Type:application/json"

cli:

drep-cli 127.0.0.1:10085 chain_getBlock 1000 3
  • Response:
{
    "jsonrpc":"2.0",
    "id":3,
    "result":{
        "Header":{
            "ChainId":0,
            "Version":1,
            "PreviousHash":"0x1fbae528a8eed0f09201bfd2c7e52fef66f5f35619e9868cd6d02dabac60e4e6",
            "GasLimit":18000000,
            "GasUsed":0,
            "Height":1,
            "Timestamp":1592365562,
            "StateRoot":"UpMnHA5WmmTxU4T4jFQvpt6bFwigN+fg1Jx0fSD91MA=",
            "TxRoot":null,
            "MinerAddr":"0x8ae8964357772abf03e2d6b13a4a8de804433014",
            "ReceiptRoot":"0x0000000000000000000000000000000000000000000000000000000000000000",
            "Bloom":"0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000"
        },
        "Data":{
            "TxCount":0,
            "TxList":null
        },
        "Proof":{
            "Type":0,
            "Evidence":"MEUCIQDIZnsow/WbAmQ7jJ21EcVxzQkKA33LJfw8anhzkNjBzAIgMexycsYJlYEv0rbPvleoAx1iahzUx6FrMNZhh8uq6Lg="
        }
    }
}

2. chain_getMaxHeight

  • Usage:

  To get the current highest block

  • Params:

   null

  • Return:Current maximum block height value

  • Example:

shell:

curl http://localhost:10085 -X POST --data '{"jsonrpc":"2.0","method":"chain_getMaxHeight","params":[], "id": 3}' -H "Content-Type:application/json"

cli:

drep-cli 127.0.0.1:10085 chain_getMaxHeight 3
  • Response:
{"jsonrpc":"2.0","id":3,"result":1000}

3. chain_getBlockGasInfo

  • Usage:

  Obtain gas related information

  • Params:

   null

  • Return:Gas minimum value and maximum value required by the system; And the maximum gas value that the current block is set to

  • Example:

shell:

curl http://localhost:10085 -X POST --data '{"jsonrpc":"2.0","method":"chain_getBlockGasInfo","params":[], "id": 3}' -H "Content-Type:application/json"

cli:

drep-cli 127.0.0.1:10085 chain_getBlockGasInfo 3
  • Response:
{"jsonrpc":"2.0","id":3,"result":193005}

4. chain_getBalance

  • Usage:

  Query address balance

  • Params:

   1. Query address

  • Return:The account balance in the address

  • Example:

shell:

curl http://localhost:10085 -X POST --data '{"jsonrpc":"2.0","method":"chain_getBalance","params":["0x8a8e541ddd1272d53729164c70197221a3c27486"], "id": 3}' -H "Content-Type:application/json"

cli:

drep-cli 127.0.0.1:10085 chain_getBalance 0x8a8e541ddd1272d53729164c70197221a3c27486 3
  • Response:
{"jsonrpc":"2.0","id":3,"result":9987999999999984000000}

5. chain_getNonce

  • Usage:

  Query the nonce whose address is on the chain

  • Params:

   1. Query address

  • Return:nonce

  • Example:

shell:

curl http://localhost:10085 -X POST --data '{"jsonrpc":"2.0","method":"chain_getNonce","params":["0x8a8e541ddd1272d53729164c70197221a3c27486"], "id": 3}' -H "Content-Type:application/json"

cli:

drep-cli 127.0.0.1:10085 chain_getNonce 0x8a8e541ddd1272d53729164c70197221a3c27486 3
  • Response:
{"jsonrpc":"2.0","id":3,"result":0}

6. chain_getReputation

  • Usage:

  Query the reputation value of the address

  • Params:

   1. Query address

  • Return:The reputation value corresponding to the address

  • Example:

shell:

curl http://localhost:10085 -X POST --data '{"jsonrpc":"2.0","method":"chain_getReputation","params":["0x8a8e541ddd1272d53729164c70197221a3c27486"], "id": 3}' -H "Content-Type:application/json"

cli:

drep-cli 127.0.0.1:10085 chain_getReputation 0x8a8e541ddd1272d53729164c70197221a3c27486 3
  • Response:
{"jsonrpc":"2.0","id":3,"result":1}

7. chain_getTransactionByBlockHeightAndIndex

  • Usage:

  Gets a particular sequence of transactions in a block

  • Params:

   1. block height    2. Transaction sequence

  • Return:transaction

  • Example:

shell:

curl http://localhost:10085 -X POST --data '{"jsonrpc":"2.0","method":"chain_getTransactionByBlockHeightAndIndex","params":[10000,1], "id": 3}' -H "Content-Type:application/json"

cli:

drep-cli 127.0.0.1:10085 chain_getTransactionByBlockHeightAndIndex [100,1] 3
  • Response:
{
  "jsonrpc": "2.0",
  "id": 3,
  "result": {
    "Hash": "0xfa5c34114ff459b4c97e7cd268c507c0ccfcfc89d3ccdcf71e96402f9899d040",
    "From": "0x7923a30bbfbcb998a6534d56b313e68c8e0c594a",
    "Version": 1,
    "Nonce": 15632,
    "Type": 0,
    "To": "0x7923a30bbfbcb998a6534d56b313e68c8e0c594a",
    "ChainId": "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
    "Amount": "0x111",
    "GasPrice": "0x110",
    "GasLimit": "0x30000",
    "Timestamp": 1559322808,
    "Data": null,
    "Sig": "0x20f25b86c4bf73aa4fa0bcb01e2f5731de3a3917c8861d1ce0574a8d8331aedcf001e678000f6afc95d35a53ef623a2055fce687f85c2fd752dc455ab6db802b1f"
  }
}

8. chain_getAliasByAddress

  • Usage:

  Gets the alias corresponding to the address according to the address

  • Params:

   1. address

  • Return:Address the alias

  • Example:

shell:

curl http://localhost:10085 -X POST --data '{"jsonrpc":"2.0","method":"chain_getAliasByAddress","params":["0x8a8e541ddd1272d53729164c70197221a3c27486"], "id": 3}' -H "Content-Type:application/json"

cli:

drep-cli 127.0.0.1:10085 chain_getAliasByAddress 0x8a8e541ddd1272d53729164c70197221a3c27486 3
  • Response:
{"jsonrpc":"2.0","id":3,"result":"tom"}

9. chain_getAddressByAlias

  • Usage:

  Gets the address corresponding to the alias based on the alias

  • Params:

   1. Alias to be queried

  • Return:The address corresponding to the alias

  • Example:

shell:

curl http://localhost:10085 -X POST --data '{"jsonrpc":"2.0","method":"chain_getAddressByAlias","params":["tom"], "id": 3}' -H "Content-Type:application/json"

cli:

drep-cli 127.0.0.1:10085 chain_getAddressByAlias tom 3
  • Response:
{"jsonrpc":"2.0","id":3,"result":"0x8a8e541ddd1272d53729164c70197221a3c27486"}

10. chain_getReceipt

  • Usage:

  Get the receipt information based on txhash

  • Params:

   1. txhash

  • Return:receipt

  • Example:

shell:

curl http://localhost:10085 -X POST --data '{"jsonrpc":"2.0","method":"chain_getReceipt","params":["0x7d9dd32ca192e765ff2abd7c5f8931cc3f77f8f47d2d52170c7804c2ca2c5dd9"], "id": 3}' -H "Content-Type:application/json"

cli:

drep-cli 127.0.0.1:10085 chain_getReceipt 0x7d9dd32ca192e765ff2abd7c5f8931cc3f77f8f47d2d52170c7804c2ca2c5dd9 3
  • Response:
{"jsonrpc":"2.0","id":3,"result":""}

11. chain_getLogs

  • Usage:

  Get the transaction log information based on txhash

  • Params:

   1. txhash

  • Return:[]log

  • Example:

shell:

curl http://localhost:10085 -X POST --data '{"jsonrpc":"2.0","method":"chain_getLogs","params":["0x7d9dd32ca192e765ff2abd7c5f8931cc3f77f8f47d2d52170c7804c2ca2c5dd9"], "id": 3}' -H "Content-Type:application/json"

cli:

drep-cli 127.0.0.1:10085 chain_getLogs 0x7d9dd32ca192e765ff2abd7c5f8931cc3f77f8f47d2d52170c7804c2ca2c5dd9 3
  • Response:
{"jsonrpc":"2.0","id":3,"result":None}

12. chain_getCancelCreditDetailByTXHash

  • Usage:

  Get the back pledge or back vote information according to txhash

  • Params:

   1. txhash

  • Return:{}

  • Example:

shell:

curl http://localhost:10085 -X POST --data '{"jsonrpc":"2.0","method":"chain_getCancelCreditDetailByTXHash","params":["0x7d9dd32ca192e765ff2abd7c5f8931cc3f77f8f47d2d52170c7804c2ca2c5dd9"], "id": 3}' -H "Content-Type:application/json"

cli:

drep-cli 127.0.0.1:10085 chain_getCancelCreditDetailByTXHash 0x7d9dd32ca192e765ff2abd7c5f8931cc3f77f8f47d2d52170c7804c2ca2c5dd9 3
  • Response:
{"jsonrpc":"2.0","id":3,"result":None}

13. chain_getByteCode

  • Usage:

  Get bytecode by address

  • Params:

   1. address

  • Return:bytecode

  • Example:

shell:

curl http://localhost:10085 -X POST --data '{"jsonrpc":"2.0","method":"chain_getByteCode","params":["0x8a8e541ddd1272d53729164c70197221a3c27486"], "id": 3}' -H "Content-Type:application/json"

cli:

drep-cli 127.0.0.1:10085 chain_getByteCode 0x8a8e541ddd1272d53729164c70197221a3c27486 3
  • Response:
{"jsonrpc":"2.0","id":3,"result":"0x00"}

14. chain_getCreditDetails

  • Usage:

  Get all the details of the stake according to the address

  • Params:

   1. address

  • Return:bytecode

  • Example:

shell:

curl http://localhost:10085 -X POST --data '{"jsonrpc":"2.0","method":"chain_getCreditDetails","params":["0x8a8e541ddd1272d53729164c70197221a3c27486"], "id": 3}' -H "Content-Type:application/json"

cli:

drep-cli 127.0.0.1:10085 chain_getCreditDetails 0x8a8e541ddd1272d53729164c70197221a3c27486 3
  • Response:
{"jsonrpc":"2.0","id":3,"result":"[{\"Addr\":\"DREPd05d5f324ada3c418e14cd6b497f2f36d60ba607\",\"HeightValues\":[{\"CreditHeight\":1329,\"CreditValue\":\"0x11135\"}]}]"}

15. chain_getCancelCreditDetails

  • Usage:

  Get the details of all refund requests

  • Params:

   1. address

  • Return:bytecode

  • Example:

shell:

curl http://localhost:10085 -X POST --data '{"jsonrpc":"2.0","method":"chain_getCancelCreditDetails","params":["0x8a8e541ddd1272d53729164c70197221a3c27486"], "id": 3}' -H "Content-Type:application/json"

cli:

drep-cli 127.0.0.1:10085 chain_getCancelCreditDetails 0x8a8e541ddd1272d53729164c70197221a3c27486 3
  • Response:
{"jsonrpc":"2.0","id":3,"result":"{\"DREP300fc5a14e578be28c64627c0e7e321771c58cd4\":\"0x3641100\"}"}

16. chain_getCandidateAddrs

  • Usage:

  Gets the addresses of all candidate nodes and the corresponding trust values

  • Params:

   1. address

  • Return:[]

  • Example:

shell:

curl http://localhost:10085 -X POST --data '{"jsonrpc":"2.0","method":"chain_getCandidateAddrs","params":[""], "id": 3}' -H "Content-Type:application/json"

cli:

drep-cli 127.0.0.1:10085 chain_getCandidateAddrs 3
  • Response:
{"jsonrpc":"2.0","id":3,"result":"{\"0x300fc5a14e578be28c64627c0e7e321771c58cd4\":\"0x3641100\"}"}

17. chain_getChangeCycle

  • Usage:

  Gets the transition period of the out - of - block node

  • Params:

   null

  • Return:Transition period

  • Example:

shell:

curl http://localhost:10085 -X POST --data '{"jsonrpc":"2.0","method":"chain_getChangeCycle","params":"", "id": 3}' -H "Content-Type:application/json"

cli:

drep-cli 127.0.0.1:10085 chain_getChangeCycle 3
  • Response:
{"jsonrpc":"2.0","id":3,"result":"{100}"}