以太坊—JSON RPC API

Geth 使用JSON数据格式， JSON-RPC协议做为客户端和网络进行交互的方法。 Geth 1.4 的 pub/sub 是实验性质的， 一样， Partity 1.6 也是。

JavaScript API

使用web3.js和etherenum节点交互时， 遵循一致的RPC协议.

 

JSON-RPC Endpoint

默认的JSON-RPC终端：

Client URL

C++ http://localhost:8545

GO http://localhost:8545

Py http://localhost:4000

Parity http://localhost:8545

 

Go

能够经过 --rpc 标志开启HTTP JSON-RPC

geth --rpc

能够经过下面的方式修改默认的端口(8545)和地址(localhost):

geth --rpc --rpcaddr <ip>  --rpcport <portnumber>

若是经过浏览器访问RPC， 须要注意跨域问题， 能够经过一下方式：

geth --rpc --rpccorsdomain "http://localhost:3000"

JSON-RPC也能够经过 geth console 开启， 以下：

admin.startRPC(addr, port)

 

C++

首先运行aleth启动节点：

build/aleth/aleth

而后开启JSON-RPC代理(默认 ~/.ethereum/geth.ipc 和 http://127.0.0.1:8545）

scripts/jsonrpcproxy.py

若是你使用非默认的IPC路径或者JSON-RPC, 能够指定：

scripts/jsonrpcproxy.py  <path to your node's geth.ipc>  <URL for this proxy server>

 

Python

在Python中， JSONRPC服务默认开启的端口和地址是127.0.0.1:4000

能够经过以下方式配置：

pyethapp -c jsonrpc.listen_port=4002 -c jsonrpc.listen_host=127.0.0.2 run

 

JSON-RPC 支持状况

cpp-ethereum ：JSON-RPC 1.0 JSON-RPC 2.0 Batch requests HTTP IPC

go-ethereum ：JSON-RPC 2.0 Batch requests HTTP IPC WS

py-ethereum ：JSON-RPC 2.0 Batch requests HTTP

patity ：JSON-RPC 2.0 Batch requests HTTP IPC WS

 

十六进制值编码 HEX value encoding

目前， 有2中主要的数据烈性用于JSON， unformatted byte arrays 和 quantities， 他们都是经过hex编码传递的。

 

默认block 参数

下面的方法有一个额外的默认的block参数：

• eth_getBalance
• eth_getCode
• eth_getTransactionCount
• eth_getStorageAt
• eth_call

当请求访问erhereum的状态时， 最后默认的block参数决定了block的高度，该选项能够是一下的取值， defaultBlock:

• HEX String 一个integer block 值
• String "earliest" 用于earliest/genesis block
• String "latest" 用于最近挖出的block
• String "pending" 用于pending 的 state/transactions

 

 

Curl 例子解释

curl 命令参数中 --data 默认指定数据类型为 application/x-www-form-urlencoded, 若是是其余的格式， 须要手动指定， 例如： -H "application/json" , 最后面必须跟 URL/IP 和 端口， 例如 ： curl e.x. 127.0.0.1:8545

 

JSON-RPC 方法

• web3_clientVersion
• web3_sha3

 

• net_version
• net_peeCount
• net_listening

 

• eth_protocolVersion
• eth_syncing
• eth_coinbase
• eth_mining
• eth_hashrate
• eth_gasPrice
• eth_accounts
• eth_blockNumber
• eth_getBalance
• eth_getStorageAt
• eth_getTransactionCount
• eth_getBlockTransactionCountByHash
• eth_getBlockTransactionCountByNumber
• eth_getUncleCountByBlockHash
• eth_getUncleCountByBlockNumber
• eth_getCode
• eth_sign
• eth_sendTransaction
• eth_sendRawTransaction
• eth_call
• eth_estimateGas
• eth_getBlockByHash
• eth_getBlockByNumber
• eth_getTransactionByHash
• eth_getTransactionByBlockHashAndIndex
• eth_getTransactionByBlockNumberAndIndex
• eth_getTransactionReceipt
• eth_getUncleByBlockHashAndIndex
• eth_getUnclueByBlockNumberAndIndex
• eth_getCompilers
• eth_compileSolidity
• eth_compileSerpent
• eth_newFilter
• eth_newBlockFilter
• eth_newPendingTransactionFilter
• eth_uninstallFilter
• eth_getFilterChanges
• eth_getFilterLogs
• eth_getLogs
• eth_getWork
• eth_submitWork
• eth_submitHashrate

 

• db_putString
• db_getString
• db_putHex
• db_getHex

 

• shh_post
• shh_version
• shh_newIdentity
• shh_hasIdentity
• shh_newGroup
• shh_addToGroup
• shh_newFilter
• shh_uninstallFilter
• shh_getFilterChanges
• shh_getMessages