The open-source RChain project is building a decentralized, economic, censorship-resistant, public compute infrastructure and blockchain. It will host and execute programs popularly referred to as “smart contracts”. It will be trustworthy, scalable, concurrent, with proof-of-stake consensus and content delivery.
RChain Developer features project-related tutorials and documentation, project planning information, events calendar, and information for how to engage with this project.
The RChain Cooperative maintains a public testnet running the latest version of RNode. Learn more at RChain public testnet information.
$ docker pull rnode/rnode
- Download a
.deb
package from the releases page $ sudo apt install ./rnode_<VERSION>.deb
, where<VERSION>
is something like0.8.3
- Download a
.rpm
package from the releases page $ sudo rpm -U ./rnode_<VERSION>.noarch.rpm
, where<VERSION>
is something like0.8.3
- Install Homebrew by following steps at the Homebrew homepage
$ brew install rchain/rchain/rnode
Docker will be used in the examples port portability reasons, but running the node as a standalone process is very similar.
To fetch the latest version of RNode from the remote Docker hub and run it
(exit with C-c
):
$ docker run -v $HOME/tmp:/var/lib/rnode -ti -p 40400:40400 rchain/rnode:latest
In order to use both the peer-to-peer network and REPL capabilities of the node, you need to run more than one Docker Rnode on the same host, the containers need to be connected to one user-defined network bridge:
$ docker network create rnode-net
$ docker run -v $HOME/tmp:/var/lib/rnode -dit --name rnode0 --network rnode-net rchain/rnode:latest -s
$ docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
15aa78b45da4 rchain/rnode:latest "/bin/main.sh -s" 3 seconds ago Up 2 seconds rnode0
In a new terminal:
$ docker logs -f rnode0
[...]
08:38:11.460 [main] INFO logger - Listening for traffic on rnode://[email protected]:40400.
[...]
A repl instance can be invoked this way:
$ docker run -v $HOME/tmp:/var/lib/rnode -it --name rnode-repl --network rnode-net rchain/rnode:latest --grpc-host rnode0 -r
rholang $ 5
Storage Contents:
for( x0 <= @{"stdout"} ) { Nil } | for( x0, x1 <= @{"stderrAck"} ) { Nil } | for( x0 <= @{"stderr"} ) { Nil } | for( x0, x1 <= @{"stdoutAck"} ) { Nil }
The above command should result in (rnode0
output):
[...]
08:38:11.463 [main] INFO logger - Starting stand-alone node.
Evaluating:
5
A peer node can be started with the following command (note that --bootstrap
takes the listening address of rnode0
):
$ docker run -v $HOME/tmp:/var/lib/rnode -it --name rnode-client --network rnode-net rchain/rnode:latest --bootstrap rnode://[email protected]:40400
[...]
08:58:36.267 [main] INFO logger - Listening for traffic on rnode://[email protected]:40400.
08:58:36.279 [main] INFO logger - Bootstrapping from #{PeerNode ee00a5357f2f4cb58b08a8a4c949da1b}.
08:58:36.294 [main] INFO logger - Initialize first phase handshake (encryption handshake) to #{PeerNode ee00a5357f2f4cb58b08a8a4c949da1b}
08:58:36.816 [repl-io-29] INFO logger - Initialize second phase handshake (protocol handshake) to #{PeerNode ee00a5357f2f4cb58b08a8a4c949da1b}
08:58:36.890 [repl-io-30] INFO logger - Connected #{PeerNode ee00a5357f2f4cb58b08a8a4c949da1b}.
08:58:41.939 [repl-io-30] INFO logger - Peers: 1.
The above command should result in (rnode0
output):
08:58:36.769 [repl-io-29] INFO logger - Responded to encryption handshake request from #{PeerNode 29d77e8cfd924db49e715d4cf4eeb28d}.
08:58:36.882 [repl-io-29] INFO logger - Responded to protocol handshake request from #{PeerNode 29d77e8cfd924db49e715d4cf4eeb28d}
08:58:37.211 [repl-io-35] INFO logger - Peers: 1.
To get a full list of options rnode accepts, use the --help
option: $ docker run -it rchain/rnode --help
.
Most of the command line options can be specified in a configuration file
rnode.conf
.
The default location of the configuration file is the data directory. An
alternative location can be specified with the command line option
--config-file <path>
.
The format of the configuration file is HOCON.
The reference.conf configuration file shows all options and default values.
Example configuration file:
rnode {
server {
host = localhost
upnp = false
port = 40400
port-http = 40403
port-kademlia = 40404
send-timeout = 2 seconds
standalone = false
bootstrap = "rnode://[email protected]?protocol=40400&discovery=40404"
data-dir = "/var/lib/rnode"
store-size = 1G
map-size = 1G
max-connections = 500
max-message-size = 256K
tls {
certificate = /etc/ssl/node.certificate.pem"
key = /etc/ssl/node.key.pem
}
metrics {
prometheus = false
influxdb = true
zipkin = false
sigar = false
}
}
grpc {
host = localhost
port-external = 40401
port-internal = 40402
}
casper {
# validator-public-key =
# validator-private-key-path =
sig-algorithm = ed25519
# bonds-file =
# known-validators-file =
validators = 5
}
}
Compile the project with:
$ sbt clean rholang/bnfc:clean rholang/bnfc:generate compile node/docker:publishLocal
Run the resulting binary with:
$ ./node/target/docker/stage/opt/docker/bin/rnode
For more detailed instructions, see the developer guide.
During this pre-release phase of the RChain software, there are some known issues.
File issues in our Public Jira Instance: File a bug
We use YourKit to profile rchain performance. YourKit supports open source projects with its full-featured Java Profiler. YourKit, LLC is the creator of YourKit Java Profiler and YourKit .NET Profiler, innovative and intelligent tools for profiling Java and .NET applications.
To get summary of licenses being used by the RChain's dependencies, simply run
sbt node/dumpLicenseReport
. The report will be available under
node/target/license-reports/rnode-licenses.html