osgiliath/gridcoin repository overview

⁠Introduction

Gridcoin (GRC) is a proof of stake based cryptocoin that rewards users for participating on the BOINC network (medicine, biology, climatology, mathematics or astrophysics). Gridcoin uses peer to peer technology to operate with no central authority. Managing transactions, issuing rewards and contributing to scientific research are carried out collectively by the network. The aim of the Gridcoin project is to shift the computational power from proof of work mining to scientific research calculations.

⁠Releases

5.5.0.0 - 2026-04-03 - "Natasha"

⁠Support

https://gitlab.com/wilkart/gridcoin-plateaux/-/issues⁠

⁠Usage

⁠Tags

All tags are built from master branch of Gridcoin Research⁠ on several official images of Linux. Gridcoin Research version tag and Gridcoin Research codename tag are built on Alpine Linux. Binaries are built from source code in the same container for transparency and easiness of inspection. Each container can be scanned for known vulnerablities before choosing the favourite one.

$ docker run aquasec/trivy image docker.io/osgiliath/gridcoin:TAG;

⁠Alpine Linux

⁠Alma Linux

⁠Oracle Linux

⁠openSUSE Linux

⁠Rocky Linux

⁠Ubuntu Linux

⁠Void Linux

⁠Environment

⁠Volumes

Docker volumes serve as the preferred mechanism for persisting data generated and utilized by containers. The data directory stores blockchain data files and wallet. By utilizing the option -v gridcoin-data:/data a persistent storage named gridcoin-data is created and mounted as /data within the active container.

⁠Runtime

Create and run a container from choosen image. Use your secret USER and secret PASSWORD.

$ docker run --detach \
  --name gridcoin \
  --hostname gridcoin \
  --network host \
  --pid host \
  -v gridcoin-data:/data \
  -e GRIDCOIN_RPC_USER="secretUSER" \
  -e GRIDCOIN_RPC_PASS="secretPASS" \
  -e GRIDCOIN_DATA_DIR="/data/gridcoin" \
  docker.io/osgiliath/gridcoin:natasha;

List running containers.

$ docker ps;

CONTAINER ID   IMAGE                COMMAND               CREATED          STATUS          PORTS     NAMES
7f899a873eb3   osgiliath/gridcoin   "start-gridcoin.sh"   40 seconds ago   Up 40 seconds             gridcoin

Get an object containing various state info.

$ docker exec -u gridcoin -it gridcoin /usr/bin/gridcoinresearchd -rpcuser=USER -rpcpassword=PASS getinfo;

{
  "version": "v5.5.0.0",
  "minor_version": 5,
  "protocolversion": 180329,
  "walletversion": 5040101,
  "balance": 0.00000000,
  "newmint": 0.00000000,
  "stake": 0.00000000,
  "blocks": 3944479,
  "in_sync": true,
  "timeoffset": 0,
  "uptime": 121068,
  "moneysupply": 514008749.96499919,
  "connections": 32,
  "proxy": "",
  "ip": "62.210.163.216",
  "difficulty": {
    "current": 9.760220418497282,
    "target": 9.643333197298228
  },
  "testnet": false,
  "keypoololdest": 1776124776,
  "keypoolsize": 101,
  "paytxfee": 0.00100000,
  "mininput": 0.00000000,
  "errors": ""
}

⁠License

Copyright 2023-2033 URUK-HAI for Gridcoin Plateaux

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.