Skip to content

Latest commit

 

History

History
1296 lines (1043 loc) · 40.1 KB

RPC服务.md

File metadata and controls

1296 lines (1043 loc) · 40.1 KB
Raw

RPC接口

下面接口只能在 websocket 下使用：

eth_accounts

查看当前客户端拥有的普通账户地址列表

参数

  • 无

返回

  • 地址数组

示例

curl -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":"0","method":"eth_accounts","params":[]}' http://127.0.0.1:8000

{
    "jsonrpc": "2.0",
    "id": "0",
    "result": ["0x08085a83232c4a3c2f9065f5bc1d93845fe8a4b5", "0x82c3a9d971fbb999ed1b541aa1ac65793a368bb5", "0x61ff8903116306edba4f38e8e91881555f306e55"]
}

eth_getBalance

查询普通账户或者合约账户的链克余额

参数

  1. string 要查询的地址
  2. string 16进制块高，或填 latest，earliest，pending

返回

  • string 余额，16进制字符串

示例

curl -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":"0","method":"eth_getBalance","params":["0x08085a83232c4a3c2f9065f5bc1d93845fe8a4b5","latest"]}' http://127.0.0.1:8000

{
    "jsonrpc": "2.0",
    "id": "0",
    "result": "0x1ed09bead87c0378d8e640000002a"
}

eth_getTokenBalance

查询普通账户或者合约账户的Token余额

参数

  1. string 要查询的地址
  2. string 16进制块高，或填 latest，earliest，pending
  3. string Token地址，全0地址 0x0000000000000000000000000000000000000000 表示链克

返回

  • string 余额，16进制字符串

示例

curl -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":"0","method":"eth_getTokenBalance","params":["0x08085a83232c4a3c2f9065f5bc1d93845fe8a4b5","latest","0x0000000000000000000000000000000000000000"]}' http://127.0.0.1:8000

{
    "jsonrpc": "2.0",
    "id": "0",
    "result": "0x1ed09bead87c036dbeba7d13aff2a"
}

eth_getAllBalances

查询某地址的所有Token的余额

参数

  1. string 要查询的地址
  2. string 16进制块高，或填 latest，earliest，pending

返回

  • map Token标示和对应的余额，全0地址 0x0000000000000000000000000000000000000000 表示链克

示例

curl -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":"0","method":"eth_getAllBalances","params":["0x08085a83232c4a3c2f9065f5bc1d93845fe8a4b5","latest"]}' http://127.0.0.1:8000

{
    "jsonrpc":"2.0",
    "id":"0",
    "result":{
        "0x0000000000000000000000000000000000000000":"0x1ed09bead87c0362a48eba275ff0a"
    }
}

eth_getUTXOGas

查询UTXO交易的Gas值

参数

  • 无

返回

  • string Gas，16进制字符串

示例

curl -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":"0","method":"eth_getUTXOGas","params":[]}' http://127.0.0.1:8000

{
    "jsonrpc": "2.0",
    "id": "0",
    "result": "0x7a120"
}

eth_getMaxOutputIndex

按token查询当前最大的Output索引

参数

  1. token string 要查询的Token的地址，查链克时填 0x0000000000000000000000000000000000000000

返回

  • string 16进制字符串，token对应的最大Output索引

示例

curl -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":"0","method":"eth_getMaxOutputIndex","params":["0x0000000000000000000000000000000000000000"]}' http://127.0.0.1:8000

{
    "jsonrpc": "2.0",
    "id": "0",
    "result": "0x20"
}

eth_getOutputs

查询UTXO交易的Output信息

参数

  1. object数组
    • token string 要查询的Token的地址，查链克时填 0x0000000000000000000000000000000000000000
    • index string 要查询的索引，16进制字符串

返回

  • object数组
    • height int 该Output所属的区块高度
    • out string 接收人
    • commit string 混淆后的金额
    • token string

示例

curl -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":"0","method":"eth_getOutputs","params":[[{"token":"0x0000000000000000000000000000000000000000","index":"0x1"}]]}' http://127.0.0.1:8000

{
    "jsonrpc": "2.0",
    "id": "0",
    "result": [{
        "out": "0000000000000000000000000000000000000000000000000000000000000000",
        "height": 10,
        "commit": "0000000000000000000000000000000000000000000000000000000000000000",
        "token": "0x0000000000000000000000000000000000000000"
    }]
}

eth_getBlockUTXOsByNumber

根据区块高度查询块中的UTXO交易

参数

返回

示例

eth_gasPrice

返回当前每个Gas的价格

参数

  • 无

返回

  • string Gas价格

示例

curl -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":"0","method":"eth_gasPrice","params":[]}' http://127.0.0.1:8000

{
    "jsonrpc":"2.0",
    "id":"0",
    "result":"0x174876e800"
}

eth_estimateGas

估算交易手续费

参数

  1. 交易数据，参考 eth_call

返回

  • string 16进制字符串，估算交易需要消耗的Gas值

示例

curl -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":"0","method":"eth_estimateGas","params":[{"from":"0x08085a83232c4a3c2f9065f5bc1d93845fe8a4b5","to":"0x82c3a9d971fbb999ed1b541aa1ac65793a368bb5","value":"0x100"}]}' http://127.0.0.1:8000

{
    "jsonrpc":"2.0",
    "id":"0",
    "result":"0x7a120"
}

eth_estimateSweepGas

估算执行清算某账户的交易所需的手续费

参数

  1. addr string 要清算的账户地址

返回

  • object
    • balance string 16进制字符串，账户当前余额
    • amount string 16进制字符串，清算转账金额
    • gas uint64 清算转账手续费
    • change string 16进制字符串，清算转账操作后账户的余额

示例

curl -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":0,"method":"eth_estimateSweepGas","params":["0xe954fcc4ab8c39aa7e7a9ed1b64da23e92998fa0"]}' http://127.0.0.1:8000

{
    "jsonrpc":"2.0",
    "id":"0",
    "result":{
        "change":"0x0",
        "gas":1626500000,
        "balance":"0x6ec3c5f179efcab2c00",
        "amount":"0x6e36b263660af622c00"
    }
}

eth_signTransaction

签交易，注意必须先解锁From账号

参数

  1. object 交易信息，参考 eth_sendTransaction

返回

  • object 签名后的交易信息
    • raw string 签名了的交易Raw
    • tx object 交易信息

示例

curl -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":"0","method":"eth_signTransaction","params":[{"from":"0x08085a83232c4a3c2f9065f5bc1d93845fe8a4b5","to":"0x82c3a9d971fbb999ed1b541aa1ac65793a368bb5","gas":"0x76c0","gasPrice":"0x9184e72a000","value":"0x100","nonce":"0x3"}]}' http://127.0.0.1:8000

{
    "jsonrpc":"2.0",
    "id":"0",
    "result":{
        "raw":"0xf8680385174876e8008276c09482c3a9d971fbb999ed1b541aa1ac65793a368bb58201008082e3e6a057ea0604e3fc5179faf8ee915cdee1a61a69fd3bb015cd180c0727d0440aa0b8a07fe9e7fd80555ee09e2ddc4bc08ca0ea5943dae0860e44c6b6fec5b8bcb078b5",
        "tx":{
            "nonce":"0x3",
            "gasPrice":"0x174876e800",
            "gas":"0x76c0",
            "to":"0x82c3a9d971fbb999ed1b541aa1ac65793a368bb5",
            "value":"0x100",
            "input":"0x",
            "v":"0xe3e6",
            "r":"0x57ea0604e3fc5179faf8ee915cdee1a61a69fd3bb015cd180c0727d0440aa0b8",
            "s":"0x7fe9e7fd80555ee09e2ddc4bc08ca0ea5943dae0860e44c6b6fec5b8bcb078b5",
            "hash":"0x4134240808073652fa4f89dcf9da7ad9b1ff90c963ef23ee0aaf7e93fec9afb4"
        }
    }
}

eth_signSpecTx

签特殊交易，需要先解锁参数 signers 中的所有账户

参数

  1. object
    • args object 要签的交易
    • type string 交易类型，可取的值为：
      • cct 创建合约交易
      • cut 升级合约交易
      • vt 更新验证人交易
    • signers string数组 要签名的账号

返回

示例

curl -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":"0","method":"eth_signSpecTx","params":[{"args":{"from":"0xc81a3c9790545fa65d339dd7564da6646c3f0571","nonce":"0x3","value":"0x4","data":"0x48656c6c6f20576f726c6421","gas":"0x7","gasPrice":"0x8"},"type":"cct","signers":["0x08085a83232c4a3c2f9065f5bc1d93845fe8a4b5","0x82c3a9d971fbb999ed1b541aa1ac65793a368bb5","0x61ff8903116306edba4f38e8e91881555f306e55"]}]}' http://127.0.0.1:8000

{
    "jsonrpc":"2.0",
    "id":"0",
    "result":{
        "raw":"0xf8fbe494c81a3c9790545fa65d339dd7564da6646c3f057103048c48656c6c6f20576f726c6421f8d4f84482e3e5a036c782955f411ce3390aac3b754c66e1594b0593176155b0f6574373bc696aa29f25716bea63a4f8f31a484adaeca89e120e3611bbfff0e5c8b240eccaad7757f84582e3e5a0c2c6de8bb9fc3b58b143dd9535f6f6ab12ef15ee03c0f90516aa4d6086218534a074749421d605dc329dfc7b4c313110747677e5eaca46a5ab923484f6ca5c946af84582e3e6a0715e46069733be6f29cfd95aed06047b1eb9c1593f8843485ebe94ced3a0df62a0182847b89c739584bb0d2fb31f9b63801ae29991072b1cc691de0a246cfecb45",
        "tx":{
            "mainInfo":{
                "from":"0xc81a3c9790545fa65d339dd7564da6646c3f0571",
                "nonce":3,
                "value":4,
                "input":"SGVsbG8gV29ybGQh"
            },
            "signs":[
                {
                    "v":58341,
                    "r":24777397643475873210619670478277848886667347288408284710158480646374001568418,
                    "s":66156148132348527778450567408332927308912930640871942576830914662515963735
                },
                {
                    "v":58341,
                    "r":88100064298687909792652529071582722738803713234772421986583855147938624931124,
                    "s":52674267065849999794815443602671076716544099285644251730694653051454306948202
                },
                {
                    "v":58342,
                    "r":51277918813925667596605326730065691777916124370185015088486809980125336100706,
                    "s":10926677249686603603140160947645920487294024992706948713848965217796749183813
                }
            ]
        }
    }
}

eth_sendTransaction

发送普通交易和合约交易到区块链，From账户需先解锁

参数

  1. object 交易结构体
    • from string 交易发送者的地址
    • to string 交易接收者的地址
    • gas string 手续费，可选
    • gasPrice string 手续费单价，可选
    • tokenAddress string 要交易的token，默认为链克交易，可选
    • value string 交易金额，可选
    • data string 要执行的合约函数的签名和编码后的参数，可选
    • nonce string 16进制字符串，发送者的nonce值，可选

返回

  • string 交易Hash

示例

curl -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":"0","method":"personal_unlockAccount","params":["0x08085a83232c4a3c2f9065f5bc1d93845fe8a4b5","1234",3600]}' http://127.0.0.1:8000

{
    "jsonrpc":"2.0",
    "id":"0",
    "result":true
}

curl -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":"0","method":"eth_sendTransaction","params":[{"from":"0x08085a83232c4a3c2f9065f5bc1d93845fe8a4b5","to":"0x82c3a9d971fbb999ed1b541aa1ac65793a368bb5","value":"0x100"}]}' http://127.0.0.1:8000

{
    "jsonrpc":"2.0",
    "id":"0",
    "result":"0xe5e416d32207ef3dea8d9086425f835592e7171c70cf518ecd4322610934dd74"
}

eth_sendRawTransaction

发送签名后的普通交易和合约交易到区块链

参数

  1. string 签名后的交易，0x开头的字符串

返回

  • string 交易Hash

示例

curl -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":"0","method":"eth_sendRawTransaction","params":["0xd46e8dd6..."]}' http://127.0.0.1:8000

{
    "jsonrpc": "2.0",
    "id": "0",
    "result": "0xfd7158eee4d6951b8624cc10d8ea18fb5ef6aec93807be68ed56582b9a4830c0"
}

eth_sendRawTokenTransaction

发送签名后的Token交易

参数

返回

示例

eth_sendRawUTXOTransaction

发送签名后的UTXO交易

参数

返回

示例

eth_sendRawTx

发送签名后的交易

参数

  1. string 签名后的交易，0x开头的字符串
  2. string 交易类型，可取的值：
    • tx 普通交易
    • txt Token交易
    • utx UTXO交易
    • cct 创建合约交易
    • cut 升级合约交易
    • vt 更新验证人交易
    • mst 多重签名交易

返回

  • string 交易Hash

示例

curl -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":"0","method":"eth_sendRawTx","params":["0xd46e8dd6...","tx"]}' http://127.0.0.1:8000

{
    "jsonrpc": "2.0",
    "id": "0",
    "result": "0xfd7158eee4d6951b8624cc10d8ea18fb5ef6aec93807be68ed56582b9a4830c0"
}

eth_call

通过执行合约来查询合约上的数据，只读操作

参数

  1. object
    • from string 发送请求的地址，可选
    • to string 要查询的合约地址
    • gas string 手续费，eth_call 不需要支付手续费，可选
    • gasPrice string 手续费单价，可选
    • tokenAddress string 要交易的token，默认为链克交易，可选
    • value string 交易金额，可选
    • data string 要执行的合约函数的签名和编码后的参数，可选
  2. string 16进制块高，或填 latest，earliest，pending

返回

  • 合约执行结果

示例

curl -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":"0","method":"eth_call","params":[{"to":"0x4c4743ed913adcdbd783248834f2bd136052b023","data":"0xd4fc9fc60000000000000000000000003002424b2dF8E8227d83A9b504D3C2578a557328"},"latest"]}' http://127.0.0.1:8000

{
    "jsonrpc": "2.0",
    "id": "0",
    "result": "0x0000000000000000000000000000000000000000000000001bc16d674ec80000"
}

eth_tokenCall

和 eth_call 相同

eth_getTransactionByHash

根据交易Hash查询交易

参数

  1. string 交易Hash

返回

  • object 交易信息，交易不存在时返回null
    • txType string 交易类型
    • txHash string 交易Hash
    • tx object 交易对象

示例

curl -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":"0","method":"eth_getTransactionByHash","params":["0xe5e416d32207ef3dea8d9086425f835592e7171c70cf518ecd4322610934dd74"]}' http://127.0.0.1:8000

{
    "jsonrpc":"2.0",
    "id":"0",
    "result":{
        "txType":"tx",
        "txHash":"0xe5e416d32207ef3dea8d9086425f835592e7171c70cf518ecd4322610934dd74",
        "signHash":"0x08d6cfb4ef69e5d02a7538865150d078a9e0dd229e4ee382558ae57d7aadbc54",
        "from":"0x08085a83232c4a3c2f9065f5bc1d93845fe8a4b5",
        "tx":{
            "type":"tx",
            "value":{
                "nonce":"0x0",
                "gasPrice":"0x174876e800",
                "gas":"0x7a120",
                "to":"0x82c3a9d971fbb999ed1b541aa1ac65793a368bb5",
                "value":"0x100",
                "input":"0x",
                "v":"0xe3e6",
                "r":"0x5587e56cd3261204002b0faf623d8fea47dc9ed6b6e8aad8aed78ac11d532a96",
                "s":"0x473b86e381cf0146d41996b12c5f3e7cf86a98666ee58d0880923776cdf469ca",
                "hash":"0xe5e416d32207ef3dea8d9086425f835592e7171c70cf518ecd4322610934dd74"
            }
        },
        "txEntry":{
            "blockHash":"0x02aed287a1e8b16c3d545bdd78d90ee0bf519cfc60bbfe84d36b9830a4fd71b5",
            "blockHeight":"3083",
            "txIndex":"0"
        }
    }
}

eth_getTransactionReceipt

根据交易Hash查询收据

参数

  1. string 交易Hash

返回

  • object 交易收据，交易不存在时返回null
    • blockHash string 所属块的Hash
    • blockNumber string 所属块的高度
    • transactionHash string 交易Hash
    • transactionIndex string 交易在块中的索引
    • from string 交易发送者
    • to string 交易接收者
    • tokenAddress string token，链克交易为 0x0000000000000000000000000000000000000000
    • gasUsed string 此交易消耗的Gas
    • cumulativeGasUsed string 在块中执行交易时消耗的总Gas
    • contractAddress string 部署合约的地址
    • logs 交易生成的log数组
    • logsBloom string
    • root string 交易后的stateroot
    • status string 1(成功) 或 0(失败)

示例

curl -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":"0","method":"eth_getTransactionReceipt","params":["0xe5e416d32207ef3dea8d9086425f835592e7171c70cf518ecd4322610934dd74"]}' http://127.0.0.1:8000

{
    "jsonrpc":"2.0",
    "id":"0",
    "result":{
        "blockHash":"0x02aed287a1e8b16c3d545bdd78d90ee0bf519cfc60bbfe84d36b9830a4fd71b5",
        "blockNumber":"0xc0b",
        "contractAddress":null,
        "cumulativeGasUsed":"0x7a120",
        "from":"0x08085a83232c4a3c2f9065f5bc1d93845fe8a4b5",
        "gasUsed":"0x7a120",
        "logs":[],
        "logsBloom":"0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
        "status":"0x1",
        "to":"0x82c3a9d971fbb999ed1b541aa1ac65793a368bb5",
        "tokenAddress":"0x0000000000000000000000000000000000000000",
        "transactionHash":"0xe5e416d32207ef3dea8d9086425f835592e7171c70cf518ecd4322610934dd74",
        "transactionIndex":"0x0"
    }
}

eth_blockNumber

查询区块高度

参数

  • 无

返回

  • string 区块高度，16进制字符串

示例

curl -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":"0","method":"eth_blockNumber","params":[]}' http://127.0.0.1:8000

{
    "jsonrpc": "2.0",
    "id": "0",
    "result": "0xc0b"
}

eth_genesisBlockNumber

查询创世块高度

参数

  • 无

返回

  • string 创世块高度，16进制字符串

示例

curl -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":"0","method":"eth_genesisBlockNumber","params":[]}' http://127.0.0.1:8000

{
    "jsonrpc": "2.0",
    "id": "0",
    "result": "0x9a34"
}

eth_getBlockByNumber

根据块高查询区块

参数

  1. string 16进制块高，或填 latest，earliest，pending
  2. boolean 设置为true时显示完整交易，false时仅显示交易Hash

返回

  • object 区块信息，区块不存在时返回null
    • number string 16进制字符串，块高
    • hash string 块的Hash
    • miner string
    • timestamp string 16进制字符串，出块时间
    • parentHash string 上一个块的Hash
    • transactionsRoot string 该块的交易根Hash
    • stateRoot string 该块的状态树的根Hash
    • receiptsRoot string 该块的交易收据的根Hash
    • gasLimit string 该块允许的最大Gas值
    • gasUsed string 该块中所有交易消耗的Gas总和
    • logsBloom string 块的日志的bloom过滤器
    • transactions 数组 交易数组，或交易Hash的数组

示例

curl -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":"0","method":"eth_getBlockByNumber","params":["0xc0b",false]}' http://127.0.0.1:8000

{
    "jsonrpc":"2.0",
    "id":"0",
    "result":{
        "number":"0xc0b",
        "hash":"0x02aed287a1e8b16c3d545bdd78d90ee0bf519cfc60bbfe84d36b9830a4fd71b5",
        "miner":"0x00000000000000000000466f756e646174696f6e",
        "timestamp":"0x5d5a8848",
        "parentHash":"0x668c0f0413d1bf6e428154cc725b31a47c358357a9aa53798ef9632ea49c944f",
        "transactionsRoot":"0xe5e416d32207ef3dea8d9086425f835592e7171c70cf518ecd4322610934dd74",
        "stateRoot":"0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470",
        "receiptsRoot":"0x0000000000000000000000000000000000000000000000000000000000000000",
        "gasLimit":"0x12a05f200",
        "gasUsed":"0x0",
        "logsBloom":"0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
        "transactions":[
            {
                "type":"hash",
                "value":"0xe5e416d32207ef3dea8d9086425f835592e7171c70cf518ecd4322610934dd74"
            }
        ]
    }
}

eth_getBlockByHash

根据块的Hash查询区块

参数

  1. string 块的Hash
  2. boolean 设置为true时显示完整交易，false时仅显示交易Hash

返回

示例

curl -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":"0","method":"eth_getBlockByHash","params":["0x23d8a6e7abcc66d0073487ec0b6334c3d0b31b470b70289963d8623e098aef3f",false]}' http://127.0.0.1:8000

执行结果和 eth_getBlockByNumber 的示例相同

eth_getTransactionCount

查询某账户发送过的交易数量

参数

  1. string 要查询的账户地址
  2. string 16进制块高，或填 latest，earliest，pending

返回

  • string 16进制字符串，该地址所发出的交易总量

示例

curl -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":"0","method":"eth_getTransactionCount","params":["0x08085a83232c4a3c2f9065f5bc1d93845fe8a4b5","latest"]}' http://127.0.0.1:8000

{
    "jsonrpc":"2.0",
    "id":"0",
    "result":"0x1"
}

eth_getBlockTransactionCountByNumber

根据块高查询指定块的交易数量

参数

  1. string 16进制块高，或填 latest，earliest，pending

返回

  • string 16进制字符串，该块所包含的交易数量

示例

curl -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":"0","method":"eth_getBlockTransactionCountByNumber","params":["0xc0b"]}' http://127.0.0.1:8000

{
    "jsonrpc":"2.0",
    "id":"0",
    "result":"0x1"
}

eth_getBlockTransactionCountByHash

根据块的Hash查询指定块的交易数量

参数

  1. string 块的Hash

返回

  • string 16进制字符串，该块所包含的交易数量

示例

curl -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":"0","method":"eth_getBlockTransactionCountByHash","params":["0x02aed287a1e8b16c3d545bdd78d90ee0bf519cfc60bbfe84d36b9830a4fd71b5"]}' http://127.0.0.1:8000

{
    "jsonrpc":"2.0",
    "id":"0",
    "result":"0x1"
}

eth_getTransactionByBlockNumberAndIndex

根据块高和在块中的索引来查询交易

参数

  1. string 16进制块高，或填 latest，earliest，pending
  2. string 16进制字符串，交易在块中的索引

返回

  • object 交易信息，交易不存在时返回 null

示例

curl -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":"0","method":"eth_getTransactionByBlockNumberAndIndex","params":["0xc0b","0x0"]}' http://127.0.0.1:8000

执行结果和 eth_getTransactionByHash 的示例相同

eth_getTransactionByBlockHashAndIndex

根据块的Hash和块中的交易索引查询交易

参数

  1. string 块的Hash
  2. string 16进制字符串，交易在块中的索引

返回

  • object 交易信息，交易不存在时返回 null

示例

curl -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":"0","method":"eth_getTransactionByBlockHashAndIndex","params":["0x02aed287a1e8b16c3d545bdd78d90ee0bf519cfc60bbfe84d36b9830a4fd71b5","0x0"]}' http://127.0.0.1:8000

执行结果和 eth_getTransactionByHash 的示例相同

eth_getRawTransactionByHash

根据交易Hash查询签名后的交易数据

参数

  1. string 交易Hash

返回

  • string 签名后的交易

示例

curl -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":"0","method":"eth_getRawTransactionByHash","params":["0xe5e416d32207ef3dea8d9086425f835592e7171c70cf518ecd4322610934dd74"]}' http://127.0.0.1:8000

{
    "jsonrpc":"2.0",
    "id":"0",
    "result":"0xf8698085174876e8008307a1209482c3a9d971fbb999ed1b541aa1ac65793a368bb58201008082e3e6a05587e56cd3261204002b0faf623d8fea47dc9ed6b6e8aad8aed78ac11d532a96a0473b86e381cf0146d41996b12c5f3e7cf86a98666ee58d0880923776cdf469ca"
}

eth_getRawTransactionByBlockNumberAndIndex

参数

  1. string 16进制块高，或填 latest，earliest，pending
  2. string 16进制字符串，交易在块中的索引

返回

  • string 签名后的交易
curl -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":"0","method":"eth_getRawTransactionByBlockNumberAndIndex","params":["0xc0b","0x0"]}' http://127.0.0.1:8000

执行结果和 eth_getRawTransactionByHash 的示例相同

eth_getRawTransactionByBlockHashAndIndex

参数

  1. string 块的Hash
  2. string 16进制字符串，交易在块中的索引

返回

  • string 签名后的交易
curl -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":"0","method":"eth_getRawTransactionByBlockHashAndIndex","params":["0x02aed287a1e8b16c3d545bdd78d90ee0bf519cfc60bbfe84d36b9830a4fd71b5","0x0"]}' http://127.0.0.1:8000

执行结果和 eth_getRawTransactionByHash 的示例相同

eth_getBlockBalanceRecordsByNumber

根据区块高度获取区块交易记录，需要先通过命令行参数 --save_balance_record 开启此功能

参数

  1. string 区块高度，16进制字符串，以0x开头

返回

  • object 交易记录
    • block_hash string 区块Hash
    • block_time string 区块创建时间
    • tx_records object 区块交易记录集
      • type string 交易类型
      • from string
      • to string
      • gas_limit string
      • gas_price string
      • hash string 交易Hash
      • nonce string 交易Nonce
      • payloads 合约调用参数
      • records object数组 一笔交易中的子交易记录集合
        • address string 子交易记录地址
        • amount string 16进制字符串，金额
        • hash string 子交易Hash
        • operation string 16进制字符串，操作(0为扣款，1为加钱)
        • token_id string Token标示，即Token合约地址
        • type string 子交易类型(transfer，contract，create_contract，sucicide，refund，fee)

示例

curl -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":"0","method":"eth_getBlockBalanceRecordsByNumber","params":["0xf8d"]}' http://127.0.0.1:8000

{
    "jsonrpc":"2.0",
    "id":"0",
    "result":{
        "block_time":"0x5d5b6341",
        "block_hash":"0x90c2144f18dd19a8e3a33ea4cc47b702788840a4d24a55f15ebfb08038bd669e",
        "tx_records":[
            {
                "hash":"0x2a15574d8ce4056b4ce9e799a8fd432db1b4aea8f1ef58a204820f3f09291683",
                "type":"tx",
                "records":[
                    {
                        "from":"0x08085a83232c4a3c2f9065f5bc1d93845fe8a4b5",
                        "to":"0x82c3a9d971fbb999ed1b541aa1ac65793a368bb5",
                        "from_address_type":"0x0",
                        "to_address_type":"0x0",
                        "type":"transfer",
                        "token_id":"0x0000000000000000000000000000000000000000",
                        "amount":"0x20",
                        "hash":"0xe886802adabfa324b1fb332c12829512f44b71e6d91a355a6bb13897cd1bb75d"
                    },
                    {
                        "from":"0x08085a83232c4a3c2f9065f5bc1d93845fe8a4b5",
                        "to":"0x00000000000000000000466f756e646174696f6e",
                        "from_address_type":"0x0",
                        "to_address_type":"0x0",
                        "type":"fee",
                        "token_id":"0x0000000000000000000000000000000000000000",
                        "amount":"0xb1a2bc2ec50000",
                        "hash":"0x256baa40f28a68e604a4cb155af9e32d41cbbe0da94903d4bfb6b25fdd78eeb6"
                    }
                ],
                "payloads":[],
                "nonce":"0x1",
                "gas_limit":"0x7a120",
                "gas_price":"0x174876e800",
                "from":"0x08085a83232c4a3c2f9065f5bc1d93845fe8a4b5",
                "to":"0x82c3a9d971fbb999ed1b541aa1ac65793a368bb5",
                "token_id":"0x0000000000000000000000000000000000000000"
            }
        ]
    }
}

eth_getAllCandidates

查询所有的候选人信息

参数

  1. string 16进制块高，或填 latest，earliest，pending

返回

  • object数组
    • candidate object 候选人信息
      • address string 地址
      • pub_key string 公钥
      • voting_power int 投票权重
      • coinbase string 奖励账户地址
    • score int 得分
    • punish_height int 发布高度

示例

curl -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":"0","method":"eth_getAllCandidates","params":["latest"]}' http://127.0.0.1:8000

{
    "jsonrpc":"2.0",
    "id":"0",
    "result":[
        {
            "candidate":{
                "address":"E0B1C58584FFC77B2F99FE7B5A5B24B405FFCE93",
                "pub_key":"0x724c2517228e6aa0790447529a9cccde7b7ab309c1b9829171dd8e2509683e817b6324428f8d162e",
                "voting_power":10,
                "coinbase":"0x000000000000000000000000000000000000000a"
            },
            "score":100,
            "punish_height":0
        },
        {
            "candidate":{
                "address":"40252318543C90CAB9081528D42F1913E5135557",
                "pub_key":"0x724c2517228e6aa099d5d3427039efe8cf5efabf8a87fcbe3c4b850f8ef294d6db358d8074c44078",
                "voting_power":10,
                "coinbase":"0x000000000000000000000000000000000000000b"
            },
            "score":100,
            "punish_height":0
        }
    ]
}

eth_getCode

根据合约地址查询合约字节码

参数

  1. string 合约部署地址
  2. string 16进制块高，或填 latest，earliest，pending

返回

  • string 合约字节码，查询的地址不是合约时返回 0x

示例

curl -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":"0","method":"eth_getCode","params":["0xade2fb587d816aa19170b54df2946c4d8512ca51","latest"]}' http://127.0.0.1:8000

{
    "jsonrpc":"2.0",
    "id":"0",
    "result":"0x6080604052600436106101d8576000357c0100000000000000000000000000000000000000000000000000000000900463f..."
}

eth_getStorageAt

查询某合约在某位置存储的值

参数

  1. string 合约地址
  2. string 存储位置
  3. string 16进制块高，或填 latest，earliest，pending

返回

  • string 值

示例

curl -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":"0","method":"eth_getStorageAt","params":["0xade2fb587d816aa19170b54df2946c4d8512ca51","0x0","latest"]}' http://127.0.0.1:8000

{
    "jsonrpc":"2.0",
    "id":"0",
    "result":"0x54fb1c7d0f011dd63b08f85ed7b518ab82028100"
}

eth_getStorageRoot

查询某地址的Storage root值，注意该接口只支持全量节点

参数

  1. string 地址
  2. string 16进制块高，或填 latest，earliest，pending

返回

  • string Storage root，查询失败时返回全0

示例

curl -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":"0","method":"eth_getStorageRoot","params":["0xade2fb587d816aa19170b54df2946c4d8512ca51","latest"]}' http://127.0.0.1:8000

{
    "jsonrpc":"2.0",
    "id":"0",
    "result":"0x0000000000000000000000000000000000000000000000000000000000000000"
}

eth_getChainVersion

查询链当前的版本

参数

  • 无

返回

  • string 版本号

示例

curl -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":"0","method":"eth_getChainVersion","params":[]}' http://127.0.0.1:8000

{
    "jsonrpc":"2.0",
    "id":"0",
    "result":"0.1.0"
}

eth_protocolVersion

查询当前协议版本

参数

  • 无

返回

  • string 版本号

示例

curl -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":"0","method":"eth_protocolVersion","params":[]}' http://127.0.0.1:8000

{
    "jsonrpc":"2.0",
    "id":"0",
    "result":"v1.0.0"
}

eth_stopTheWorld

停止共识出块，停止同步区块

参数

  • 无

返回

  • boolean 操作成功或失败

示例

curl -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":"0","method":"eth_stopTheWorld","params":[]}' http://127.0.0.1:8000

{
    "jsonrpc":"2.0",
    "id":"0",
    "result":true
}

eth_startTheWorld

启动共识出块，启动同步区块

参数

  • 无

返回

  • boolean 操作成功或失败

示例

curl -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":"0","method":"eth_startTheWorld","params":[]}' http://127.0.0.1:8000

{
    "jsonrpc":"2.0",
    "id":"0",
    "result":true
}

personal_newAccount

创建普通账户

参数

  1. string 密码，长度为6到64个字符

返回

  • string 创建好的账户地址地址

示例

curl -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":"0","method":"personal_newAccount","params":["1234"]}' http://127.0.0.1:8000

{
    "jsonrpc": "2.0",
    "id": "0",
    "result": "0x682d048ee929d3ed7567c7ab580e913a1acc8b37"
}

personal_listAccounts

作用及用法同 eth_accounts

personal_lockAccount

解锁后重新锁住普通账户

参数

  1. string 要锁的账户地址

返回

  • boolean 成功或失败

示例

curl -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":"0","method":"personal_lockAccount","params":["0x08085a83232c4a3c2f9065f5bc1d93845fe8a4b5"]}' http://127.0.0.1:8000

{
    "jsonrpc": "2.0",
    "id": "0",
    "result": true
}

personal_unlockAccount

解锁普通账户

参数

  1. string 要解锁的账户地址
  2. string 密码
  3. int 解锁状态持续的时间，单位秒

返回

  • boolean 成功或失败

示例

参考 eth_sendTransaction

personal_signTransaction

签普通交易

参数

  1. object 交易结构体，参考 eth_sendTransaction
  2. string From账户的密码

返回

示例

curl -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":"0","method":"personal_signTransaction","params":[{"from":"0x08085a83232c4a3c2f9065f5bc1d93845fe8a4b5","to":"0x82c3a9d971fbb999ed1b541aa1ac65793a368bb5","gas":"0x76c0","gasPrice":"0x9184e72a000","value":"0x100","nonce":"0x3"},"1234"]}' http://127.0.0.1:8000

执行结果和 eth_signTransaction 的示例相同

personal_sendTransaction

签普通交易并发送

参数

  1. object 交易结构体，参考 eth_sendTransaction
  2. string From账户的密码

返回

  • string 交易Hash

示例

curl -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":"0","method":"personal_sendTransaction","params":[{"from":"0x08085a83232c4a3c2f9065f5bc1d93845fe8a4b5","to":"0x82c3a9d971fbb999ed1b541aa1ac65793a368bb5","value":"0x100"},"1234"]}' http://127.0.0.1:8000

{
    "jsonrpc":"2.0",
    "id":"0",
    "result":"0x13e3bc03a73f3ba0d1e4fe57f054f432353de3e14f8cfedf9bd8260ff5270577"
}

personal_signAndSendTransaction

和 personal_sendTransaction 相同

lk_broadcastTxSync

Websocket接口，广播交易

参数

和 eth_sendRawTx 的参数相同

返回

  • boolean 成功或失败

lk_getBalance

Websocket接口，查询账户余额，同 eth_getBalance

lk_getBlock

Websocket接口，查询区块信息

参数

  1. string 16进制块高，或填 latest，earliest，pending

返回

lk_getLogs

Websocket接口，返回与给定过滤器对象匹配的所有log的数组

参数

  1. object 过滤选项
    • fromBlock string 16进制块高，可选，默认为最新块
    • toBlock string 16进制块高，可选，默认为最新块
    • addrs string数组 日志来源的合约地址
    • topics string数组 每个topic 32个字节

返回

  • object数组
    • address string 生成时间的合约地址
    • topics string数组 合约的topics
    • data string 合约输出内容
    • blockNumber int 块高
    • transactionHash string 交易Hash
    • transactionIndex int 交易在块中的索引
    • blockHash string 块的Hash
    • logIndex int log在收据中的索引
    • removed boolean 为false时表示有效
    • blockTime int 出块时间

lk_getTransaction

Websocket接口，同 eth_getTransactionByHash

lk_getTransactionCount

Websocket接口，同 eth_getTransactionCount