Skip to content

Latest commit

 

History

History
 
 

jsonrpc

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
benches
benches
 
 
src/bin
src/bin
 
 
types
types
 
 
.gitignore
.gitignore
 
 
Cargo.toml
Cargo.toml
 
 
ERROR_CODE.md
ERROR_CODE.md
 
 
README.md
README.md
 
 

README.md

#CITA说明

JSON-RPC

  • net_peerCount
  • cita_blockNumber
  • cita_sendTransaction
  • cita_getBlockByHash
  • cita_getBlockByNumber
  • cita_getTransaction
  • eth_getTransactionCount
  • eth_getCode
  • eth_getTransactionReceipt
  • eth_call

net_peerCount

当前的节点连接数.

Parameters

none

Returns

QUANTITY - integer of the number of connected peers.

Example
// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"net_peerCount","params":[],"id":74}'

// Result
{
    "id": 74, 
    "jsonrpc": "2.0", 
    "result": 2
}

cita_blockNumber

返回当前块高度.

Parameters

none

Returns

QUANTITY - integer of current block height of CITA.

Example
// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"cita_blockNumber","params":[],"id":83}'

// Result
{
    "id": 83, 
    "jsonrpc": "2.0", 
    "result": 1207
}

cita_sendTransaction

通过序列化交易调用区块链接口.

Parameters
  1. DATA, The signed transaction data.
params: ["0a28356230373365393233333934346235653732396534366436313866306438656466336439633334611aa5030adf020a28356230373365393233333934346235653732396534366436313866306438656466336439633334611aac020a013010a08d0622a2026060604052341561000c57fe5b5b60646000819055505b5b60fd806100256000396000f30060606040526000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff16806360fe47b11460445780636d4ce63c146061575bfe5b3415604b57fe5b605f60048080359060200190919050506084565b005b3415606857fe5b606e60c6565b6040518082815260200191505060405180910390f35b7fc6d8c0af6d21f291e7c359603aa97e0ed500f04db6e983b9fce75a91c6b8da6b816040518082815260200191505060405180910390a1806000819055505b50565b600060005490505b905600a165627a7a72305820bd5c5c100113c9c4ad095fc9559b61e9059b50f1f22953b4e313e3f9a7b1072a0029208080808010124184285b0543240ee71c84d5452c61fffa4e44bf0f51b7131c4cfe735cfa56e7cb140057227c80e6c9f4989cd15dfd66470c25d176987d325c67ee86a39218a28b01208080808010"]

// Transaction
syntax = "proto3";
enum Crypto {
    SECP = 0;
    SM2 = 1; 
}

//nonce 标识交易的唯一性
//gas 保留，现阶段传0

message Transaction {
    string from = 1;
    string to = 2;
    bytes content = 3; // Content
    uint64 valid_until_block = 4;
}

message Content {
    string nonce = 1;
    uint64 gas = 2;
    uint64 value = 3;
    bytes data = 4;
}

message SignedTransaction {
    bytes transaction = 1;
    bytes signature = 2;
    Crypto crypto = 3;
}

####合约代码的bytecode

以下代码片段为示例代码，具体获取contract bytecode的方法参考文档

solidity相关文档

pragma solidity ^0.4.0;

contract SimpleStorage {
    uint storedData;
    event Init(address, uint);
    event Set(address, uint);
    
    function SimpleStorage() {
        storedData = 100;
        Init(msg.sender, 100);
    }
    
    event Stored(uint);

    function set(uint x)  {
        Stored(x);
        storedData = x;
        Set(msg.sender, x);
    }

    function get() constant returns (uint) {
        return storedData;
    }
}

####签名

  1. 构造 Content -> content,设置合约代码的bytecode
  2. 用 content 构造 Transaction -> transaction
  3. 用 transaction 序列化 sha3 -> hash
  4. 对 hash 进行签名 -> signature
  5. 用 signature 和对应的签名算法 crypto 构造 SignedTransaction -> signed_transaction
  6. signed_transaction 序列化 -> signed_content
  7. signed_content 替换 transaction 的 content -> new_transaction
  8. new_transaction 序列化作为 cita_sendTransaction 的 params

伪代码描述:

let transaction = Transaction::new();
let content = Content::new();
// contract bincode
let data = "6060604052341561000f57600080fd5b5b60646000819055507f8fb1356be6b2a4e49ee94447eb9dcb8783f51c41dcddfe7919f945017d163bf3336064604051808373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020018281526020019250505060405180910390a15b5b610178806100956000396000f30060606040526000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff16806360fe47b1146100495780636d4ce63c1461006c575b600080fd5b341561005457600080fd5b61006a6004808035906020019091905050610095565b005b341561007757600080fd5b61007f610142565b6040518082815260200191505060405180910390f35b7fc6d8c0af6d21f291e7c359603aa97e0ed500f04db6e983b9fce75a91c6b8da6b816040518082815260200191505060405180910390a1806000819055507ffd28ec3ec2555238d8ad6f9faf3e4cd10e574ce7e7ef28b73caa53f9512f65b93382604051808373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020018281526020019250505060405180910390a15b50565b6000805490505b905600a165627a7a72305820eefc907a1c6b61875fc523a4e6473fea9e2cf1768466d16a7798227f758c8e390029".from_hex();
content.setdata(data);
let signed_transaction = SignedTransaction::new();

transaction.set_content(content.write_to_bytes());
let privkey = crypto::PrivKey::from(H256::from_str("a100df7a048e50ed308ea696dc600215098141cb391e9527329df289f9383f65").unwrap());
// sender: 5b073e9233944b5e729e46d618f0d8edf3d9c34a
let signature = sign(privkey, transaction.write_to_bytes().sha3()); 

signed_transaction.set_transaction(transaction.write_to_bytes());
signed_transaction.set_crypto(Crypto::SECP);
signed_transaction.set_signature(sign1.0.to_vec());

transaction.set_content(signed_transaction.set_transaction.write_to_bytes());

签名后的交易

0a28356230373365393233333934346235653732396534366436313866306438656466336439633334611a90050aca040a28356230373365393233333934346235653732396534366436313866306438656466336439633334611a97040a013010a08d06228d046060604052341561000f57600080fd5b5b60646000819055507f8fb1356be6b2a4e49ee94447eb9dcb8783f51c41dcddfe7919f945017d163bf3336064604051808373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020018281526020019250505060405180910390a15b5b610178806100956000396000f30060606040526000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff16806360fe47b1146100495780636d4ce63c1461006c575b600080fd5b341561005457600080fd5b61006a6004808035906020019091905050610095565b005b341561007757600080fd5b61007f610142565b6040518082815260200191505060405180910390f35b7fc6d8c0af6d21f291e7c359603aa97e0ed500f04db6e983b9fce75a91c6b8da6b816040518082815260200191505060405180910390a1806000819055507ffd28ec3ec2555238d8ad6f9faf3e4cd10e574ce7e7ef28b73caa53f9512f65b93382604051808373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020018281526020019250505060405180910390a15b50565b6000805490505b905600a165627a7a72305820eefc907a1c6b61875fc523a4e6473fea9e2cf1768466d16a7798227f758c8e39002920808080801012418e5492a523f2f44e5279f7deb96bc4ff416182cd5bd2713e62ba8151d4d5104104755011ae13d55384e1ea40318a94cc1a08a410cf3284970324b3114cbf01f900208080808010
Returns

DATA, 32 Bytes - 交易hash

Example
// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"cita_sendTransaction","params":["0a28356230373365393233333934346235653732396534366436313866306438656466336439633334611a90050aca040a28356230373365393233333934346235653732396534366436313866306438656466336439633334611a97040a013010a08d06228d046060604052341561000f57600080fd5b5b60646000819055507f8fb1356be6b2a4e49ee94447eb9dcb8783f51c41dcddfe7919f945017d163bf3336064604051808373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020018281526020019250505060405180910390a15b5b610178806100956000396000f30060606040526000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff16806360fe47b1146100495780636d4ce63c1461006c575b600080fd5b341561005457600080fd5b61006a6004808035906020019091905050610095565b005b341561007757600080fd5b61007f610142565b6040518082815260200191505060405180910390f35b7fc6d8c0af6d21f291e7c359603aa97e0ed500f04db6e983b9fce75a91c6b8da6b816040518082815260200191505060405180910390a1806000819055507ffd28ec3ec2555238d8ad6f9faf3e4cd10e574ce7e7ef28b73caa53f9512f65b93382604051808373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020018281526020019250505060405180910390a15b50565b6000805490505b905600a165627a7a72305820eefc907a1c6b61875fc523a4e6473fea9e2cf1768466d16a7798227f758c8e39002920808080801012418e5492a523f2f44e5279f7deb96bc4ff416182cd5bd2713e62ba8151d4d5104104755011ae13d55384e1ea40318a94cc1a08a410cf3284970324b3114cbf01f900208080808010"],"id":1}'

// Result
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "hash": "0xb38e5b6572b2613cab8088f93e6835576209f2b796104779b4a43fa5adc737af",
    "status": "4:OK"
  }
}

// 如果是近期发送的重复交易，则会提示重复交易

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "hash": "0xb38e5b6572b2613cab8088f93e6835576209f2b796104779b4a43fa5adc737af",
    "status": "4:DUP"
  }
}

cita_getBlockByHash

根据块hash查询块的信息

Parameters

DATA, 32 Bytes - Hash of a block. Boolean - 是否返回交易信息(True: 返回详细交易列表| False: 只返回交易hash).

params: [
   '84772dc0643c656b75a0d2e0b55b5a21bdfa85c4bb57f9af0825c12848c08aa8',
   true
]
Returns

Object - A block object, or null when no block was found:

Example
// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"cita_getBlockByHash","params":["2f3853b7d3bb3d6bc4bb2103b645aae2b8145125340018209184c7709e04dbc3", true],"id":1}'

// Result
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "version": 0,
    "hash": "0x5038c222d460c32fd06df36d58bb7cf5c368a55e207a46ecb18695451bfe4069",
    "header": {
      "timestamp": 1499756200950,
      "prevHash": "0xb28ec1911d375350664b9673a61d952e9a748f3e63606f1440f313c4911fde58",
      "proof": {
        "proposal": "0x0f25d396361c7d54bb16389f6a14bf95207915f91d180d382093e19adfc4133b",
        "height": 902,
        "round": 0,
        "commits": {
          "0x2b027dacd33a41ddb09e21805778f19951776ed5": "0x1532c58faedf9e103dd84aa6aacbd2121aa3a8102faa506e7e152fb10e45bafd31b1c3d372cf5d42f8b27a8bfea112ae194de76d99206f73837ad8c30267e6a501",
          "0x2d74a106464fbdf94e47bb28605a1aa244ab7788": "0x2ec53371cee732d59d23a58cf6cf53d818fb906fdeb5b0521a3a4cdbb75cf29658a1ff5fa95e4dc71563cbed10070c68e2eec0f812fa3be8e019b6df6e9ea66201",
          "0x3efd4959af72e1214ab83caa0f04a0cc3e54d383": "0xb051f0cc41bc3caed472d3c7a35e06d805e8f6d15ccb3efc257d71ee96932c5877a8e52fc29cb3bef73e0edbad62c617c4dd16763709b2604ab8b1db2d87736301",
          "0x5223818f7096520bfad68ce3d5ac959267dbc45f": "0x1cf6f8dc9654d461a317db199de0ed0d2d008762833b3358e269ceb3c412b60b3f1a2bd08f969e0dc1c9ebe1a0710002f853438a6ef3ea048de9b4e67387827400"
        }
      },
      "commit": {
        "stateRoot": "0xe29266e5574bc0c848b513d36403d4da71f99f328d3324e8d3134809c33d4fb4",
        "transactionsRoot": "0xf31e32611322f410f430ef8141c2237c19dd1034eddef8dedba692ec9851799b",
        "receiptsRoot": "0x9646cf2572734b4b13fe1616446ab2658e208cfdbaf25e47ebea9b6327e10c5b",
        "gasUsed": "0x0"
      },
      "height": "0x387"
    },
    "body": {
      "transactions": [
        {
          "hash": "0xf31e32611322f410f430ef8141c2237c19dd1034eddef8dedba692ec9851799b",
          "content": "0x0a28356230373365393233333934346235653732396534366436313866306438656466336439633334611a80040aba030a28356230373365393233333934346235653732396534366436313866306438656466336439633334611a87030a013010a08d0622fd026060604052341561000c57fe5b5b7f4f8cfde3439a1a302c21ca51eec26086efbfd940b8c0279889fc6bb6e73ecc6633604051808273ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200191505060405180910390a15b5b60fd806100806000396000f30060606040526000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff16806360fe47b11460445780636d4ce63c146061575bfe5b3415604b57fe5b605f60048080359060200190919050506084565b005b3415606857fe5b606e60c6565b6040518082815260200191505060405180910390f35b7fc6d8c0af6d21f291e7c359603aa97e0ed500f04db6e983b9fce75a91c6b8da6b816040518082815260200191505060405180910390a1806000819055505b50565b600060005490505b905600a165627a7a7230582079ba3769927f0f8cf4bec7ce02513b56823c8fc3f4047989951e042a9a04651900292080808080101241d51ca7a0171113478f47357a71c240bd0431f52639741a6721725de276a88d2e723b12f4bbeb1cdddea63f947ddb9db6e2667f08a03af1577c42d3c1a3dc5a7c01208080808010"
        }
      ]
    }
  }
}

cita_getBlockByNumber

根据块高度查询块信息.

Parameters
  1. QUANTITY - integer of a block height.
  2. Boolean - 是否返回交易信息(True: 返回详细交易列表| False: 只返回交易hash).
params: [
   4427,
   true
]
Returns

See cita_getBlockByHash

Example
// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"cita_getBlockByNumber","params":["0xF9", true],"id":1}'
或者
curl -X POST --data '{"jsonrpc":"2.0","method":"cita_getBlockByNumber","params":["249", true],"id":1}'
或者
curl -X POST --data '{"jsonrpc":"2.0","method":"cita_getBlockByNumber","params":[249, true],"id":1}'
Invalid Params
curl -X POST --data '{"jsonrpc":"2.0","method":"cita_getBlockByNumber","params":["0XF9", true],"id":1}'

高度参数可以用0x开头的十六进制或者十进制。0X开头是错误的参数格式。

同 cita_getBlockByHash

eth_getTransactionReceipt

根据交易hash获取交易回执。

Parameters
  1. DATA, 32 Bytes - hash of a transaction
params: [
   "b38e5b6572b2613cab8088f93e6835576209f2b796104779b4a43fa5adc737af"
]
Example
// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionReceipt","params":["b38e5b6572b2613cab8088f93e6835576209f2b796104779b4a43fa5adc737af"],"id":1}'

// Result
{
    "jsonrpc":"2.0",
    "id":1,
    "result":{
        "transactionHash":"0xb38e5b6572b2613cab8088f93e6835576209f2b796104779b4a43fa5adc737af",
        "transactionIndex":"0x0",
        "blockHash":"0xe068cf7299450b78fe97ed370fd9ebe09ecbd6786968e474fae862ccbd5c5020",
        "blockNumber":"0xa",
        "cumulativeGasUsed":"0x17a0f",
        "gasUsed":"0x17a0f",
        "contractAddress":"0xea4f6bc98b456ef085da5c424db710489848cab5",
        "logs":[
            {
                "address":"0xea4f6bc98b456ef085da5c424db710489848cab5",
                "topics":[
                    "0x8fb1356be6b2a4e49ee94447eb9dcb8783f51c41dcddfe7919f945017d163bf3"
                ],
                "data":"0x0000000000000000000000005b073e9233944b5e729e46d618f0d8edf3d9c34a0000000000000000000000000000000000000000000000000000000000000064",
                "blockHash":"0xe068cf7299450b78fe97ed370fd9ebe09ecbd6786968e474fae862ccbd5c5020",
                "blockNumber":"0xa",
                "transactionHash":"0xb38e5b6572b2613cab8088f93e6835576209f2b796104779b4a43fa5adc737af",
                "transactionIndex":"0x0",
                "logIndex":"0x0",
                "transactionLogIndex":"0x0"
            }
        ],
        "root":"0xe702d654a292a8d074fd5ba3769b3dead8095d2a8f2207b3a69bd49c91a178af",
        "logsBloom":"0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000100040000000010000200000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000040000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000"
    }
}

如果出现Timeout，errorcode 99,请查看可能的解决方法Cann't assign requested Address

eth_getLogs

根据Topic查询logs。

A note on specifying topic filters:

Topics are order-dependent. A transaction with a log with topics [A, B] will be matched by the following topic filters:

  • [] "anything"
  • [A] "A in first position (and anything after)"
  • [null, B] "anything in first position AND B in second position (and anything after)"
  • [A, B] "A in first position AND B in second position (and anything after)"
  • [[A, B], [A, B]] "(A OR B) in first position AND (A OR B) in second position (and anything after)"
Parameters
  1. Object - The filter options:
  • fromBlock: QUANTITY|TAG - (optional, default: "latest") Integer block number, or "latest" or "earliest".
  • toBlock: QUANTITY|TAG - (optional, default: "latest") Integer block number, or "latest" or "earliest".
  • address: DATA|Array, 20 Bytes - (optional) Contract address or a list of addresses from which logs should originate.
  • topics: Array of DATA, - (optional) Array of 32 Bytes DATA topics. Topics are order-dependent. Each topic can also be an array of DATA with "or" options.
Example
// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getLogs","params":[{"topics":["0x8fb1356be6b2a4e49ee94447eb9dcb8783f51c41dcddfe7919f945017d163bf3"],"fromBlock": 0}],"id":74}'

// Result
{
    "jsonrpc":"2.0",
    "id":74,
    "result":[
        {
            "address":"0xea4f6bc98b456ef085da5c424db710489848cab5",
            "topics":[
                "0x8fb1356be6b2a4e49ee94447eb9dcb8783f51c41dcddfe7919f945017d163bf3"
            ],
            "data":"0x0000000000000000000000005b073e9233944b5e729e46d618f0d8edf3d9c34a0000000000000000000000000000000000000000000000000000000000000064",
            "blockHash":"0x3e83b74560860344f4c48d7b8089a18173aecd96b6b2148653c61b5d3f559764",
            "blockNumber":"0x4",
            "transactionHash":"0xb38e5b6572b2613cab8088f93e6835576209f2b796104779b4a43fa5adc737af",
            "transactionIndex":"0x0",
            "logIndex":"0x0",
            "transactionLogIndex":"0x0"
        }
    ]
}

eth_call

合约接口调用.

Parameters
  1. Object - The transaction call object
  • from: DATA, 20 Bytes - (optional) The address the transaction is sent from.
  • to: DATA, 20 Bytes - The address the transaction is directed to.
  • data: DATA - (optional) Hash of the method signature and encoded parameters. For details see Ethereum Contract ABI
  1. QUANTITY - integer block height
params: [{"from":"0xca35b7d915458ef540ade6068dfe2f44e8fa733c","to":"0xea4f6bc98b456ef085da5c424db710489848cab5","data":"0x6d4ce63c"}, 4427]
Returns

DATA, 32 Bytes - the transaction hash.

(Parameters -> 1 -> Object -> data) example contract中get方法Hash和编码后的数据

0x6d4ce63c

发送和获取数据

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_call",
"params":[{"from":"0xca35b7d915458ef540ade6068dfe2f44e8fa733c","to":"0xea4f6bc98b456ef085da5c424db710489848cab5",
"data":"0x6d4ce63c"}, 6],"id":2}'

// Result
{
  "jsonrpc": "2.0",
  "id": 2,
  "result": "0x0000000000000000000000000000000000000000000000000000000000000064"
}

cita_getTransaction

根据交易hash查询交易。

Parameters
  1. DATA, 32 Bytes - hash of a transaction
params: [
   "c78ccb00a5b20c93d17c0fa3dd143f9da810bf5c9729770521948c31ad928ff4"
]
Returns

Object - A transaction object, or null when no transaction was found:

  • hash: DATA, 32 Bytes - hash of the transaction.
  • content: DATA, 交易内容.
  • blockHash: DATA, 32 Bytes - hash of the block where this transaction was in. null when its not in block.
  • blockNumber: QUANTITY - block number where this transaction was in. null when its not in block.
  • index: QUANTITY - integer of the transactions index position in the block. null when its not in block.
Example
// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"cita_getTransaction","params":["b38e5b6572b2613cab8088f93e6835576209f2b796104779b4a43fa5adc737af"],"id":1}'

// Result
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "hash": "0xb38e5b6572b2613cab8088f93e6835576209f2b796104779b4a43fa5adc737af",
    "content": "0x0a28356230373365393233333934346235653732396534366436313866306438656466336439633334611a90050aca040a28356230373365393233333934346235653732396534366436313866306438656466336439633334611a97040a013010a08d06228d046060604052341561000f57600080fd5b5b60646000819055507f8fb1356be6b2a4e49ee94447eb9dcb8783f51c41dcddfe7919f945017d163bf3336064604051808373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020018281526020019250505060405180910390a15b5b610178806100956000396000f30060606040526000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff16806360fe47b1146100495780636d4ce63c1461006c575b600080fd5b341561005457600080fd5b61006a6004808035906020019091905050610095565b005b341561007757600080fd5b61007f610142565b6040518082815260200191505060405180910390f35b7fc6d8c0af6d21f291e7c359603aa97e0ed500f04db6e983b9fce75a91c6b8da6b816040518082815260200191505060405180910390a1806000819055507ffd28ec3ec2555238d8ad6f9faf3e4cd10e574ce7e7ef28b73caa53f9512f65b93382604051808373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020018281526020019250505060405180910390a15b50565b6000805490505b905600a165627a7a72305820eefc907a1c6b61875fc523a4e6473fea9e2cf1768466d16a7798227f758c8e39002920808080801012418e5492a523f2f44e5279f7deb96bc4ff416182cd5bd2713e62ba8151d4d5104104755011ae13d55384e1ea40318a94cc1a08a410cf3284970324b3114cbf01f900208080808010",
    "blockNumber": "0x9",
    "blockHash": "0x571dafeea7628a6eaaae7edc8c634b0efa215b2ed3fc1022fdd53963812ffe19",
    "index": "0x0"
  }
}

eth_getTransactionCount

It is tranasction that you must have a EOA to deploy contract. eg:

keypair

let privkey = crypto::PrivKey::from(H256::from_str("a100df7a048e50ed308ea696dc600215098141cb391e9527329df289f9383f65").unwrap());
let keypair = crypto::KeyPair::from_privkey(privkey.into()).unwrap();
// nonce = 0
// sender: "5b073e9233944b5e729e46d618f0d8edf3d9c34a"
// EOA address = "5b073e9233944b5e729e46d618f0d8edf3d9c34a"

example contract

pragma solidity ^0.4.0;
contract SimpleStorage {
    uint storedData;
    
    function SimpleStorage() {
        storedData = 100;
    }
    
    event Stored(uint);

    function set(uint x)  {
        Stored(x);
        storedData = x;
    }

    function get() constant returns (uint) {
        return storedData;
    }
}

complie contract:

bincode = "0a28356230373365393233333934346235653732396534366436313866306438656466336439633334611a80040aba030a28356230373365393233333934346235653732396534366436313866306438656466336439633334611a87030a013010a08d0622fd026060604052341561000c57fe5b5b7f4f8cfde3439a1a302c21ca51eec26086efbfd940b8c0279889fc6bb6e73ecc6633604051808273ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200191505060405180910390a15b5b60fd806100806000396000f30060606040526000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff16806360fe47b11460445780636d4ce63c146061575bfe5b3415604b57fe5b605f60048080359060200190919050506084565b005b3415606857fe5b606e60c6565b6040518082815260200191505060405180910390f35b7fc6d8c0af6d21f291e7c359603aa97e0ed500f04db6e983b9fce75a91c6b8da6b816040518082815260200191505060405180910390a1806000819055505b50565b600060005490505b905600a165627a7a7230582079ba3769927f0f8cf4bec7ce02513b56823c8fc3f4047989951e042a9a04651900292080808080101241d51ca7a0171113478f47357a71c240bd0431f52639741a6721725de276a88d2e723b12f4bbeb1cdddea63f947ddb9db6e2667f08a03af1577c42d3c1a3dc5a7c01208080808010"

deploy contract:

curl -X POST --data '{"jsonrpc":"2.0","method":"cita_sendTransaction","params":["0a28356230373365393233333934346235653732396534366436313866306438656466336439633334611a80040aba030a28356230373365393233333934346235653732396534366436313866306438656466336439633334611a87030a013010a08d0622fd026060604052341561000c57fe5b5b7f4f8cfde3439a1a302c21ca51eec26086efbfd940b8c0279889fc6bb6e73ecc6633604051808273ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200191505060405180910390a15b5b60fd806100806000396000f30060606040526000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff16806360fe47b11460445780636d4ce63c146061575bfe5b3415604b57fe5b605f60048080359060200190919050506084565b005b3415606857fe5b606e60c6565b6040518082815260200191505060405180910390f35b7fc6d8c0af6d21f291e7c359603aa97e0ed500f04db6e983b9fce75a91c6b8da6b816040518082815260200191505060405180910390a1806000819055505b50565b600060005490505b905600a165627a7a7230582079ba3769927f0f8cf4bec7ce02513b56823c8fc3f4047989951e042a9a04651900292080808080101241d51ca7a0171113478f47357a71c240bd0431f52639741a6721725de276a88d2e723b12f4bbeb1cdddea63f947ddb9db6e2667f08a03af1577c42d3c1a3dc5a7c01208080808010"],"id":1}' 127.0.0.1:1337 | jq

get some infomation like eg:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "hash": "0xf31e32611322f410f430ef8141c2237c19dd1034eddef8dedba692ec9851799b",
    "status": "4:OK"
  }
}

ok! next:

curl -X POST --data '{"jsonrpc":"2.0","method":"cita_getTransaction","params":["f31e32611322f410f430ef8141c2237c19dd1034eddef8dedba692ec9851799b"],"id":1}' 127.0.0.1:1337 | jq

result:
    {
      "jsonrpc": "2.0",
      "id": 1,
      "result": {
        "transaction": {
          "hash": "0xf31e32611322f410f430ef8141c2237c19dd1034eddef8dedba692ec9851799b",
          "content": "0x0a28356230373365393233333934346235653732396534366436313866306438656466336439633334611a80040aba030a28356230373365393233333934346235653732396534366436313866306438656466336439633334611a87030a013010a08d0622fd026060604052341561000c57fe5b5b7f4f8cfde3439a1a302c21ca51eec26086efbfd940b8c0279889fc6bb6e73ecc6633604051808273ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200191505060405180910390a15b5b60fd806100806000396000f30060606040526000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff16806360fe47b11460445780636d4ce63c146061575bfe5b3415604b57fe5b605f60048080359060200190919050506084565b005b3415606857fe5b606e60c6565b6040518082815260200191505060405180910390f35b7fc6d8c0af6d21f291e7c359603aa97e0ed500f04db6e983b9fce75a91c6b8da6b816040518082815260200191505060405180910390a1806000819055505b50565b600060005490505b905600a165627a7a7230582079ba3769927f0f8cf4bec7ce02513b56823c8fc3f4047989951e042a9a04651900292080808080101241d51ca7a0171113478f47357a71c240bd0431f52639741a6721725de276a88d2e723b12f4bbeb1cdddea63f947ddb9db6e2667f08a03af1577c42d3c1a3dc5a7c01208080808010"
        },
        "block_height": 35,
        "block_hash": "0x8c4b8d43a973770e7362d3d4f72c541daa9e23cdf4690815e11b6e6cbc3e4f5b",
        "index": 0
      }
    }

get the transaction block height. eg:

"block_height": 35,

Now! you can test the eth_getTransactionCount interface. eg:

curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionCount","params":["5b073e9233944b5e729e46d618f0d8edf3d9c34a",35],"id":1}' 127.0.0.1:1337 | jq

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

good!

keep on! test eth_getCode. you have a contract address that is generated from eth_getTransactionReceipt result. eg:

curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionReceipt","params":["f31e32611322f410f430ef8141c2237c19dd1034eddef8dedba692ec9851799b"],"id":1}' 127.0.0.1:1337 | jq

reuslt:
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "logs": [
      {
        "transaction_hash": "0xf31e32611322f410f430ef8141c2237c19dd1034eddef8dedba692ec9851799b",
        "transaction_index": 0,
        "block_hash": "0x8c4b8d43a973770e7362d3d4f72c541daa9e23cdf4690815e11b6e6cbc3e4f5b",
        "block_height": 35,
        "address": "ea4f6bc98b456ef085da5c424db710489848cab5",
        "topics": [
          "0x4f8cfde3439a1a302c21ca51eec26086efbfd940b8c0279889fc6bb6e73ecc66"
        ],
        "data": "0x0000000000000000000000005b073e9233944b5e729e46d618f0d8edf3d9c34a"
      }
    ],
    "transaction_hash": "0xf31e32611322f410f430ef8141c2237c19dd1034eddef8dedba692ec9851799b",
    "transaction_index": 0,
    "block_hash": "0x8c4b8d43a973770e7362d3d4f72c541daa9e23cdf4690815e11b6e6cbc3e4f5b",
    "block_height": 35,
    "gas_used": 51869,
    "cumulative_gas_used": 51869,
    "contract_address": "0xea4f6bc98b456ef085da5c424db710489848cab5"
  }
}

right! get contract_address

keep

call eth_getCode:

curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getCode","params":["ea4f6bc98b456ef085da5c424db710489848cab5",35],"id":1}' 127.0.0.1:1337 | jq

result:
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x60606040526000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff16806360fe47b11460445780636d4ce63c146061575bfe5b3415604b57fe5b605f60048080359060200190919050506084565b005b3415606857fe5b606e60c6565b6040518082815260200191505060405180910390f35b7fc6d8c0af6d21f291e7c359603aa97e0ed500f04db6e983b9fce75a91c6b8da6b816040518082815260200191505060405180910390a1806000819055505b50565b600060005490505b905600a165627a7a7230582079ba3769927f0f8cf4bec7ce02513b56823c8fc3f4047989951e042a9a0465190029"
}

end!

RPC Errors 和 Null

1 Invalid Request

// 正确方式：POST 方法
curl -X GET -d '{"jsonrpc":"2.0","method":"cita_blockNumber","params":[]}' 127.0.0.1:1337   

{"jsonrpc":"2.0","error":{"code":-32600,"message":"Invalid Request"},"id":null}

2 Method not found

// 正确方式： method应该是cita_getBlockByNumber
curl -X POST -d '{"jsonrpc":"2.0","method":"cita_blockByHeight","params":[true],"id":3}' 127.0.0.1:1337

{"jsonrpc":"2.0", "error":{"code":-32601,"message":"Method not found"},"id":3 }

3 Invalid params

// 正确方式：params 应该是 ["0063187e6a84ae731cf9"]
curl -X POST -d '{"jsonrpc":"2.0","method":"cita_getTransaction","params":["0x0063187e6a84ae731cf9"],"id":2}' 127.0.0.1:1337

{"jsonrpc":"2.0", "error":{"code":-32602,"message":"Invalid params"},"id":2}

4 Method not found

// 正确方式： method应该是cita_getBlockByNumber
curl -X POST -d '{"jsonrpc":"2.0","method":"cita_getBlockBy","params":[99,true],"id":2}' 127.0.0.1:1337

{"jsonrpc":"2.0", "error":{"code":-32601,"message":"Method not found"},"id":2}

5 Null

// 原因：块高度未达到99999
curl -X POST -d '{"jsonrpc":"2.0","method":"cita_getBlockByNumber","params":[99999,true],"id":2}' 127.0.0.1:1337

{"jsonrpc":"2.0","id":2,"result":null}

7 test cita_code

curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getCode","params":["ea4f6bc98b456ef085da5c424db710489848cab9",35],"id":1}' 127.0.0.1:1337 | jq

//address or height error
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": null
}

8 test cita_get_TransactionCount

curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionCount","params":["5b073e9233944b5e729e46d618f0d8edf3d9c342",2],"id":1}' 127.0.0.1:1337 | jq

//address or height error
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x0"
}