Skip to main content

Connect to a node

Prerequisites

Set up a GoQuorum network using one of the following tutorials:

Use geth attach

The Geth JavaScript console exposes the Web3 JavaScript API for development use, and can be started using the console or attach Geth subcommands. The console subcommand starts the Geth node and opens the console, while the attach subcommand attaches an already-running Geth instance to the console.

Run the attach subcommand and connect to the IPC socket, or, if enabled, to the RPC or WebSocket API endpoints:

geth attach /path/to/geth.ipc

Once connected you can execute commands as normal. For example, check existing validators using the following command:

istanbul.getValidators();

Exit the console using the following command:

exit;

Use the RPC interface

You can connect to a running node by making HTTP REST requests on the RPC endpoint, which is exposed on port 8545 by default.

To enable the RPC interface, start the GoQuorum node with the following parameters:

--http                           # Enable the HTTP-RPC server endpoint
--http.addr localhost # HTTP-RPC server listening interface (default: "localhost")
--http.port 8545 # HTTP-RPC server listening port (default: 8545)
--http.corsdomain "localhost" # Comma-separated list of domains from which to accept cross origin requests (browser enforced)
--http.vhosts "localhost" # Comma-separated list of virtual hostnames from which to accept requests (server enforced). Accepts '*' wildcard.
--http.api admin,db,... # APIs offered over the HTTP-RPC interface

GoQuorum supports the standard web3 JSON-RPC APIs and custom methods.

For example, run the following command to get the list of validators at a given block in an IBFT or QBFT network:

curl -X POST http://localhost:8545 --data '{"jsonrpc":"2.0","method":"istanbul_getValidators","params":[10],"id":1}' --header "Content-Type: application/json"

You can any tool to make requests, such as curl, Postman, or Web3.

note

Use the security plugin to secure the JSON-RPC server.

Use the WebSocket interface

You can connect to a running node using a WebSocket endpoint, which is exposed on port 8546 by default.

To enable the WebSocket interface, start the GoQuorum node with the following parameters:

--ws                           # Enable the WS-RPC server endpoint
--ws.addr localhost # WS-RPC server listening interface (default: "localhost")
--ws.port 8545 # WS-RPC server listening port (default: 8545)
--ws.origins "localhost" # Comma separated list of virtual hostnames from which to accept requests (server enforced). Accepts '*' wildcard
--ws.api admin,db,... # APIs offered over the WS interface
--ws.rpcprefix "/" # Path prefix on which WS-RPC is served. Use '/' to serve on all paths.

For example, to connect to an endpoint and get logs, run the following JavaScript:

const Web3 = require("web3");
var web3 = new Web3("wss://localhost:8546");
var subscription = web3.eth.subscribe(
"logs",
{
address: "0x123456..",
topics: ["0x12345..."],
},
function (error, result) {
if (!error) console.log(result);
},
);