Ruthenium

Description

Golang implementation of the Ruthenium protocol.

You will find a detailed description of the project in the wiki. To understand the motivations behind the creation of this blockchain, you can peruse the comprehensive details outlined in the Ruthenium whitepaper.

Quickstart

There are two ways to run a Ruthenium node. You can either use your own build from sources (Option A) or use a docker image provided in the repository packages (Option B).

Prerequisites

Option A (using sources):
- You need to have installed.
- If you are using Windows, you need to have tdm-gcc installed.
Option B (using docker image):
- You need to have installed.
Your firewall port 10600 must be open (please read "Program arguments" section of the validator node and access node documentation if you want to use another port than 10600).
To get an income or validate blocks ou need to be registered in the Proof of Humanity registry.

Installation

Option A (using sources):
- Download the sources archive:
```
https://github.com/my-cloud/ruthenium/releases/latest
```

Option B (using docker image):

Pull the image:

sudo docker pull ghcr.io/my-cloud/ruthenium:latest

Launch

Option A (using sources):
- Extract files from the sources archive
- At root level (ruthenium folder), run the validator node:
```
go run validatornode/main.go
```
- At root level (ruthenium folder), run the access node:
```
go run accessnode/main.go
```

Option B (using docker image):

Run the validator node:

sudo docker run -p 10600:10600 -ti ghcr.io/my-cloud/ruthenium:latest \app\validatornode

Run the access node:

sudo docker run -p 8080:8080 -ti ghcr.io/my-cloud/ruthenium:latest \app\accessnode

Using a web browser, go to:
- http://localhost:8080

APIs

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please do not hesitate to report a new bug or request a new feature. Of course, you are welcome to fork the repository and create a pull request. In any case, please let's take a look at the contributing file.

⭐ Don't forget to give the project a star! Thanks again!