# README
consensusctl
consensusctl
is an RPC client for consensusd
.
Requirements
Go 1.19 or later.
Build from Source
-
Install Go according to the installation instructions here: http://golang.org/doc/install
-
Ensure Go was installed properly and is a supported version:
go version
- Run the following commands to obtain and install
consensusd
including all dependencies:
git clone https://github.com/consensus-network/consensusd
cd consensusd/cmd/consensusctl
go install .
consensusctl
should now be installed in$(go env GOPATH)/bin
. If you did not already add the bin directory to your system path during Go installation, you are encouraged to do so now.
Usage
The full consensusctl
configuration options can be seen with:
consensusctl --help
But the minimum configuration needed to run it is:
consensusctl <REQUEST_JSON>
For example:
consensusctl '{"getBlockDagInfoRequest":{}}'
For a list of all available requests check out the RPC documentation