ALASTRIA red B

Introduction

Alastria red B Network is a public-permissioned Blockchain network that uses the Hyperledger BESU technology, IBFT 2.0 consensus algorithm, and it's managed by Alastria partners, :vulcan_salute:.

There are 2 main steps to set up an Alatria Node:

1. Installation & configuration: There are two different ways to install the Alastria Besu node.

Docker: Follow the installation steps in this document and your node will be ready.
Binary: Please navigate to the Binaries doc

2. Getting permissioned: In order to use Alastria Network, your node must be previously accepted.

If you are a rookie in Blockchain or Ethereum please consider reading these references:

If you would like you to know more about Hyperledger Ecosystem, this link is a good start.

Administrative requirements

Alastria partners can add its own node. Otherwise contact support@alastria.io to start with administrative permissioning.

There are 2 main steps to set up an Alatria Node:

1. Installation: Follow the installation process and your node will be ready to be permissioned.

2. Getting permissioned: In order to use Alastria Network, your node must be previously accepted, after filling the form.

If a member wants to remove a node from the network, please send us a removal request using the same electronic form.

1) Installation

Before starting, consider the following guide to add a dedicated disk for the node database, independent of the system disk.

The following process explains the installation for a node:

Clone or download this repository:

git clone https://github.com/alastria/alastria-node-besu.git

Edit the .env file in the docker-compose directory and modify the NODE_NAME attribute:

cd alastria-node-besu/docker-compose

Set the NODENAME attribute according to the name you want for this node. The name SHOULD follow the convention: `REGB`

Where \<COMPANY> is your company/entity name, \<Y> is the number of processors of the machine, \<Z> is the amount of memory in Gb and \<NN> is a sequential counter for each machine that you may have (starting at 00). For example:

NODE_NAME="REG_ExampleOrg_B_2_8_00"

This is the name that will be given to the docker container.

Optionally, uncomment the RPC API and/or WebSocket ports of the container in the docker-compose.yaml if you need to use them.
To start the node run:

docker-compose up -d

We are done. Now, we will have the followings available:

Node's database at /data/alastria-node-besu/database
Node's logging files at /data/alastria-node-besu/logs
Node's keys files at /data/alastria-node-besu/keys

2) Permissioning new node

All nodes in Alastria Networks must be permissioned. To ask for permission you must enter your data in this electronic form, providing these information of your node:

1. ENODE: String ENODE from ENODE_ADDRESS (enode://ENODE@IP:30303)

2. Public IP: The external IP of your node.

3. System details: Hosting provider, number of cores (vCPUs), RAM Memory and Hard disk size.

In order to get permissioning, follow these steps to get the information that you will be asked for in the previous form:

You can find the ENODE_ADDRESS using curl -X POST --data '{"jsonrpc":"2.0","method":"admin_nodeInfo","params":[],"id":1}' http://127.0.0.1:8545.
Get the IP address of your node, as seen from the external world.

curl https://ifconfig.me/

Once your request is fulfilled after form submission, you will see that your node starts connecting to its peers and starts synchronizing the blockchain. The process of synchronization can take hours or even one or two days depending on the speed of your network and machine.

Adding automatic checking for updates in node lists

If your installation was done with docker-compose everything is set up in the container and there's nothing else to do :tada:

However, if your installation was done prior to June 2022, ensure you have the more up-to-date code running in your machine following these steps:

Stop the node with docker-compose down
Do a backup of the docker-compose.yml and the .env files to make sure you don't lose any configuration
Pull the more current code from the repository with git pull
Edit the docker-compose.yml and the .env files if you need a custom configuration in volumes and ports sections, and to set the type and the name of your node
Start the container forcing the image to be build again with docker-compose up --build -d

Secure your Besu node using API Key

We can add an additional security layer to our Besu node using API Key implementation in order to identify or authenticate an user for using the service.

Please, navigate to the section to set up the node. :point_right: API Key

Infraestructure details

System requirements

Operating System: Ubuntu 16.04/18.04/20.04 LTS 64 bits. CentOS, Redhat,... and other rpm systems are also allowed.
Hosting: Euro Zone; in order to complain with GDPR directives.
Hardware:

Hardware	Minimum	Desired
CPU's:	2	4
Memory:	4 Gb	8 Gb
Hard Disk (SSD):	64 Gb	256 Gb

Blockchain database is about 16Gb at mid-2021 and grows at rate of 2Gb/month. Take this into consideration when provisioning space for cache, logs etc. SSD Disk is mandatory

Firewall configuration

You need to open the following ports to deploy a node:

Incoming rules

Port	Type	From	Definition
30303	TCP	0.0.0.0	Ethereum client data transfer ports
30303	UDP	0.0.0.0	Ethereum client listener and discovery ports
9545	TCP	18.201.52.140	Scraping Prometheus metrics from Alastria

Notes:

Default Alastria configuration exposes BESU metrics in tcp/9545 port and exposes http://node_ip:9545/metrics route in order to be integrated in your local monitoring infraestructure. More information in https://besu.hyperledger.org/public-networks/how-to/monitor/metrics and https://grafana.com/grafana/dashboards/16455-besu-full/. Please, keep this access restricted to authorized hosts, as described in the documentation.

Optional ports:

Port	Type	From	Definition
8080	TCP	(orion parners)	:warning: DEPRECATED Orion port (in case you use private transactions)
8545	TCP	(web3 client)	json+rpc (in case you use remix/truffle/.../web3)
8546	TCP	(web3 client)	json+ws (in case you use remix/truffle/.../web3)

Notes:

:warning: Please, be very carefull opening web3 ports: this protocol does not have enabled (natively) neither authentication nor encryption!
:warning: Opening web3 ports, can be tuned in /data/alastria-node-besu/config/config.toml file: listening interface, web3 methods available,...
Ninja sysadmins don't use outbound firewall rules :joy:

Help! :fire_extinguisher:

Slack

Alastria has a group of channels available on Slack message platform, url: alastria.slack.com. You need to be invited, for it, please send a email to support@alastria.io asking to join the channel. Provide the following information:

Name and organization.
e-mail address to be added.
Channel list where to be joined.

Available channels by default

Once accepted in the Alastria Slack group you are automatically included in:

#general General purpose channel (public)
#notificaciones Notifications Github channel (public)

You can add yourself to the following channels:

#besu-group Channel for the red B team, :beer:

FAQ

How how can I see the logs of the container?

docker logs -f NODE_NAME

How to know if the node is already permissioned?

2021-04-29 14:58:44.465+00:00 | EthScheduler-Services-5 (importBlock) | INFO  | FullImportBlockStep | Import reached block 10145800 (0x82c9..ea34), Peers: 1

The last column should show, at least, one "Peer".

How to know if the node has finished syncing?

Use eth_syncing method to see the synchronization progress:

curl -X POST --data '{"jsonrpc":"2.0","method":"eth_syncing","params":[],"id":1}' http://127.0.0.1:8545

How can I manage the node?

curl -X POST --data '{"jsonrpc":"2.0","method":"admin_peers","params":[],"id":1}' http://127.0.0.1:8545
curl -X POST --data '{"jsonrpc":"2.0","method":"admin_nodeInfo","params":[],"id":1}' http://127.0.0.1:8545

Other ADMIN methods, in Besu API method

Also, IBFT and PERM methods (for validator nodes), in Private network API methods

Will the functionality (docker | ansible | whatever) be supported soon?

It's in your hands! Alastria is an open group and everyone is welcome to contribute. If you need any support we are here to help :hugs:

Connection from Remix/Truffle/Hardhat

You can refer to the smart-contract-deployment repository.

alastria / alastria-node-besu

readme