blockscout/apps/ethereum_jsonrpc

EthereumJSONRPC

Ethereum JSONRPC client.

Configuration

Configuration for parity URLs can be provided with the following mix config:

config :ethereum_jsonrpc,
  url: "https://sokol.poa.network",
  trace_url: "https://sokol-trace.poa.network",
  http: [recv_timeout: 60_000, timeout: 60_000, hackney: [pool: :ethereum_jsonrpc]]

Note: the tracing node URL is provided separately from :url, via :trace_url. The trace URL and is used for fetch_internal_transactions, which is only a supported method on tracing nodes. The :http option is passed directly to the HTTP library (HTTPoison), which forwards the options down to :hackney.

Testing

By default, mox will be used to mock the EthereumJSONRPC.Transport and EthereumJSONRPC.HTTP behaviours. They mocked behaviours returns differ based on the EthereumJSONRPC.Variant.

EthereumJSONRPC.Variant	EthereumJSONRPC.Transport	EthereumJSONRPC.HTTP	url	Command	Usage(s)
EthereumJSONRPC.Parity	EthereumJSONRPC.Mox	EthereumJSONRPC.HTTP.Mox	N/A	mix test	Local, circleci/config.yml test_parity_mox job
EthereumJSONRPC.Parity	EthereumJSONRPC.HTTP	EthereumJSONRPC.HTTP.HTTPoison	https://trace-sokol.poa.network	ETHEREUM_JSONRPC_VARIANT=EthereumJSONRPC.Parity ETHEREUM_JSONRPC_TRANSPORT=EthereumJSONRPC.HTTP ETHEREUM_JSONRPC_HTTP=EthereumJSONRPC.HTTP.HTTPoison ETHEREUM_JSONRPC_HTTP_URL=https://sokol-trace.poa.network mix test --exclude no_parity	.circleci/config.yml test_parity_http job
EthereumJSONRPC.Geth	EthereumJSONRPC.Mox	EthereumJSONRPC.HTTP.Mox	N/A	ETHEREUM_JSONRPC_VARIANT=EthereumJSONRPC.Geth mix test --exclude no_geth	.circleci/config.yml test_geth_http job
EthereumJSONRPC.Geth	EthereumJSONRPC.HTTP	EthereumJSONRPC.HTTP.HTTPoison	https://mainnet.infura.io/8lTvJTKmHPCHazkneJsY	ETHEREUM_JSONRPC_VARIANT=EthereumJSONRPC.Geth ETHEREUM_JSONRPC_TRANSPORT=EthereumJSONRPC.HTTP ETHEREUM_JSONRPC_HTTP=EthereumJSONRPC.HTTP.HTTPoison ETHEREUM_JSONRPC_HTTP_URL=https://mainnet.infura.io/8lTvJTKmHPCHazkneJsY mix test --exclude no_geth	.circleci/config.yml test_geth_http job

Installation

The OTP application :ethereum_jsonrpc can be used in other umbrella OTP applications by adding ethereum_jsonrpc to your list of dependencies in mix.exs:

def deps do
  [
    {:ethereum_jsonrpc, in_umbrella: true}
  ]
end