laconicd/docs/quickstart/clients.md
Federico Kunze 5ba8ce4605
testnet docs (#393)
* testnet docs

* more updates on quickstart docs

* update quickstart

* more updates

* update quickstart

* final touches

* update lint
2020-07-17 14:07:05 -04:00

1.9 KiB

Clients

Learn how to connect a client to a running node. {synopsis}

Pre-requisite Readings

Client Integrations

Command Line Interface

Ethermint is integrated with a CLI client that can be used to send transactions and query the state from each module.

# available query commands
emintcli query -h

# available transaction commands
emintcli tx -h

Client Servers

The Ethermint client supports both REST endpoints from the SDK and Ethereum's JSON-RPC.

REST and Tendermint RPC

Ethermint exposes REST endpoints for all the integrated Cosmos-SDK modules. This makes it easier for wallets and block explorers to interact with the proof-of-stake logic.

To run the REST Server, you need to run the Ethermint daemon (emintd) and then execute (in another process):

emintcli rest-server --laddr "tcp://localhost:8545" --unlock-key $KEY --chain-id $CHAINID --trace

You should see the logs from the REST and the RPC server.

I[2020-07-17|16:54:35.037] Starting application REST service (chain-id: "8")... module=rest-server
I[2020-07-17|16:54:35.037] Starting RPC HTTP server on 127.0.0.1:8545   module=rest-server

Ethereum JSON-RPC server

Ethermint also supports most of the standard web3 JSON-RPC APIs to connect with existing web3 tooling.

::: tip Some of the JSON-RPC API namespaces are currently under development. :::

To connect to the JSON-PRC server, use the rest-server command as shown on the section above. Then, you can point any Ethereum development tooling to http://localhost:8545 or whatever port you choose with the listen address flag (--laddr).

Next {hide}

Process and subscribe to events via websockets {hide}