Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/helium/blockchain-node
A Heilum Blockchain Node
https://github.com/helium/blockchain-node
blockchain erlang helium jsonrpc2 rocksdb
Last synced: 2 days ago
JSON representation
A Heilum Blockchain Node
- Host: GitHub
- URL: https://github.com/helium/blockchain-node
- Owner: helium
- License: apache-2.0
- Archived: true
- Created: 2020-05-22T04:07:41.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2023-11-05T15:37:27.000Z (about 1 year ago)
- Last Synced: 2024-08-01T21:46:42.059Z (3 months ago)
- Topics: blockchain, erlang, helium, jsonrpc2, rocksdb
- Language: Erlang
- Homepage:
- Size: 6.21 MB
- Stars: 60
- Watchers: 25
- Forks: 32
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Archived
This repository is no longer applicable after the migration to Solana
# blockchain-node
[](https://buildkite.com/helium/blockchain-node)
This is an Erlang application that is a Helium Blockchain node. It
follows the blockchain and exposes functionality using a JSONRPC 2.0 API.
## Documentation
See [API endpoint
documentation](https://helium.github.io/blockchain-node/blockchain_node-reference.html)
(in [markdown format](docs/blockchain_node-reference.md)).
## Developer Usage
- Clone this repository
- Run `make && make release` in the top level folder
- Run `make start` to start the application. Logs will be at
`_build/dev/rel/blockchain_node/log/*`.
Once started the application will start syncing the blockchain and
loading blocks. If this is done from scratch it can take a number of
days to download all blocks from the network and aobsorb them in the
local ledger.
### File Descriptors
The application uses a lot of file descriptors for network
communication and local storage. If you see errors related to too many
open files or `nofile`, stop the application and increase the file
descriptor limit.
#### macOS
You may see an error similar to the following:
`{error,"IO error: While open a file for appending: data/blockchain.db/020311.sst: Too many open files"}`
Check [this](https://superuser.com/a/443168) Superuser answer for a workaround.
#### Linux
Update your `/etc/security/limits.conf` to increase your file limits. An
example of what to add can be seen
[here](https://github.com/helium/blockchain-node/blob/master/.buildkite/config/blockchain_limits.conf).
### Installing Ubuntu Required Packages
If running on Ubuntu, you will need the following packages installed
before running `make release`:
```bash
wget https://packages.erlang-solutions.com/erlang-solutions_2.0_all.deb
sudo dpkg -i erlang-solutions_2.0_all.deb
sudo apt-get update
sudo apt install esl-erlang=1:24.3.3-1 cmake libsodium-dev libssl-dev build-essential
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
```
If you already have rust installed, please ensure it is at least at verion `1.51` or upgrade to the latest stable using `rustup update stable`
## Using Docker
### Building the Docker Image
`make docker-build`
### Running the Docker Container
`make docker-start`
### Updating Docker
Navigate to your copy of the `blockchain-node` repository.
`cd /path/to/blockchain-node`
Stop the Node.
`make docker-stop`
Update the repository.
`git pull`
Remove the existing Docker container.
`make docker-clean`
Rebuild the Docker image.
`make docker-build`
Run the updated Docker container.
`make docker-start`
Log the Node output.
`tail -f $HOME/node_data/log/console.log`