Install Dependencies & Start a Local Node
Linux Distributions
Ubuntu
Currently supported versions:
-
Ubuntu 22.04 Jammy
-
Ubuntu 20.04 Focal
Install wire-cli
wire-cli is a TypeScript-based command-line tool for spinning up a local node. It automates tasks such as installing Wire Sysio core and CDT, deploying system contracts, and starting blockproducer and chain-api nodes.
To install the Wire CLI, run the following command:
npm i -g @wireio/wire-cli
Install Dependencies & Start a Local Node
To start a local node, run:
sudo wire-cli --g --enable-roa
It is important to note that we are intentially using wire-cli to launch a full-scale Wire blockchain environment. This is a multi-node setup(blockproducer and chain-api) with deployed system contracts, resource management, including contract policies, as well as protocol features, etc. and identical to testnet configuration setup.
Verify installation
Wire Sysio
nodeop --full-version
You should see a semantic version string followed by a commit hash with no errors. For example:
v3.1.6-8f6875608efc9aceab9218360822bba3bc664cfb
Wire Sysio executables are located at /usr/local/bin.
Wire CDT
which cdt-cpp
Expected Output -> /usr/bin/cdt-cpp
or
cdt-cpp --version
Expected Output -> cdt-cpp version 3.1.0
Wire CDT is located at /usr/opt with symlinks to each of its executable in /usr/bin. You can list the contents using ls -la usr/opt/cdt/<version>/bin.
Removing Wire Sysio and Wire CDT
Uninstall Wire Sysio and Wire CDT
sudo wire-cli uninstall --y
The uninstall command above will also remove the default wallet installed with Wire Sysio. To keep any imported keys, make sure to back them up before proceeding with deletion.
Validating nodeop
Check that nodeop is producing blocks. Run the following command:
tail -f /opt/wire-network/blockproducer/data/nodeop.log
You should see some output in the console similar to:
info [timestamp] nodeop producer_plugin.cpp:2293 produce_block ] Produced block b50adde5943bdde1... #44 at [timestamp] signed by sysio [trxs: 0, lib: 43, confirmed: 0]
info [timestamp] nodeop producer_plugin.cpp:2293 produce_block ] Produced block 39b2a4fef9db084f... #45 at [timestamp] signed by sysio [trxs: 0, lib: 44, confirmed: 0]
info [timestamp] nodeop producer_plugin.cpp:2293 produce_block ] Produced block cd23d3646d0166dc... #46 at [timestamp] signed by sysio [trxs: 0, lib: 45, confirmed: 0]
info [timestamp] nodeop producer_plugin.cpp:2293 produce_block ] Produced block 14bd99c3c3ffd441... #47 at [timestamp] signed by sysio [trxs: 0, lib: 46, confirmed: 0]
info [timestamp] nodeop producer_plugin.cpp:2293 produce_block ] Produced block 2e5fb9d0f2dce119... #48 at [timestamp] signed by sysio [trxs: 0, lib: 47, confirmed: 0]
Verify the [timestamp] is a recent one and that you aren't looking at a stale logs.
To exit logs: Ctrl + C
Check the Wallet
Open the shell and run the sudo clio wallet list command to list available wallets. We need to validate the installation and see that the command line client clio is working as intended.
Wallets:
[
"default"
]
Wallets can exist on multiple Linux users. Since we ran the script as sudo, the wallet we use is on sudo.
From this point forward, you'll be executing commands from your local system.
Check nodeop endpoints
This step ensures that the RPC API is functioning properly. You can choose one of the following methods:
3.1. Using clio
clio get info
3.2. HTTP GET request to /get_info
Use your browser to access the get_info endpoint from the chain_api_plugin. Simply click http://localhost:8888/v1/chain/get_info.
{
"server_version": "1dd2fd86",
"chain_id": "8a34ec7df1b8cd06ff4a8abbaa7cc50300823350cadc59ab296cb00d104d2b8f",
"head_block_num": 1769,
"last_irreversible_block_num": 1768,
"last_irreversible_block_id": "000006e810b62ae346aa0066d7e3d5fe152285692c4d15dc742e1733b61eb27b",
"head_block_id": "000006e931c346d88fc5cb63ce025bfd5f0843656761ac074b35c1c941684f64",
"head_block_time": "2024-09-25T15:43:18.000",
"head_block_producer": "sysio",
"virtual_block_cpu_limit": 1170419,
"virtual_block_net_limit": 6146775,
"block_cpu_limit": 200000,
"block_net_limit": 1048576,
"server_version_string": "v3.1.6",
"fork_db_head_block_num": 1769,
"fork_db_head_block_id": "000006e931c346d88fc5cb63ce025bfd5f0843656761ac074b35c1c941684f64",
"server_full_version_string": "v3.1.6-1dd2fd862c04c1b49df6b2314eb1a621d0301c9f",
"total_cpu_weight": 0,
"total_net_weight": 0,
"earliest_available_block_num": 1,
"last_irreversible_block_time": "<timestamp>"
}
Alternatively, check the endpoint directly from your terminal using the command:
curl http://localhost:8888/v1/chain/get_info | jq .
Third-party tools used in the steps above:
Troubleshooting
When wire-cli is trying to install the binaries and you are getting an error similar to:
Reading package lists... Done
Building dependency tree... Done
Reading state information... Done
Note, selecting 'wire-sysio' instead of './wire-sysio-3.1.6_amd64.deb'
Some packages could not be installed. This may mean that you have
requested an impossible situation or if you are using the unstable
distribution that some required packages have not yet been created
or been moved out of Incoming.
The following information may help to resolve the situation:
The following packages have unmet dependencies:
sysio : Depends: libssl1.1 but it is not installable
Depends: libicu60 but it is not installable
E: Unable to correct problems, you have held broken packages.
-
Try and resolve it by looking for exact dependencies at Index of /ubuntu/pool/main/o/openssl
-
Find the exact version of
libssl, in this caselibssl1.1 -
Download it:
wget http://archive.ubuntu.com/ubuntu/pool/main/o/openssl/libssl1.1_1.1.1-1ubuntu2.1\~18.04.amd64.deb
- Install the downloaded package:
sudo dpkg -i libssl1.1_1.1.1-1ubuntu2.1~18.04.amd64.deb
Repeat the same for any other packages that appear in the error message.
wget http://mirrors.edge.kernel.org/ubuntu/pool/main/i/icu/libicu60_60.2-3ubuntu3.1_amd64.deb
sudo dpkg -i libicu60_60.2-3ubuntu3.2_amd64.deb
After successfully installing all missing packages, attempt to install the binaries again.