telos docs
Search…
Setting up a Telos Block Producer node
This section describes all the steps needed to setup a Telos Block Producer

Installation Methods

  • EOSIO currently supports the following operating systems:
    • Amazon Linux 2
    • CentOS 7
    • Ubuntu 16.04
    • Ubuntu 18.04
    • MacOS 10.14 (Mojave)
NOTE: If you are new to EOSIO, it is recommended that you install the EOSIO Prebuilt Binaries. If you are an advanced developer, a block producer, or no binaries are available for your platform, you may need to Build EOSIO from source depending on your OS.

Ubuntu package method

1
$ wget https://github.com/eosio/eos/releases/download/v2.0.11/eosio_2.0.11-1-ubuntu-18.04_amd64.deb
2
$ sudo apt install ./eosio_2.0.11-1-ubuntu-18.04_amd64.deb
Copied!

Compile source code method

  1. 1.
    Clone the EOSIO/EOS repository from Github like this:
    1
    $ git clone https://github.com/EOSIO/eos.git --recursive` [NOT NEEDED, if already cloned]
    Copied!
NOTE: The step-1 is not needed, if the repository is already cloned. Directly, start from step-2.
  1. 1.
    Go to the eos folder
    1
    $ cd eos
    Copied!
  2. 2.
    pull the repository with required released version
    1
    $ git pull https://github.com/EOSIO/eos.git v2.0.11`
    Copied!
  3. 3.
    update the submodules
    1
    $ git submodule update --init --recursive`
    Copied!
  4. 4.
    Go to required version
    1
    $ git checkout tags/v2.0.11`
    Copied!

Run Nodeos

nodeos generally runs in 2 modes:

A. Producing/Active mode

Producing Validator Nodes are configured for block production. They connect to the peer-to-peer (p2p) network and actively produce new blocks. Loose transactions are also validated and relayed. On mainnet, Producing Validator Nodes only produce blocks if their assigned block producer is part of an active schedule.
NOTE: System contracts required - These instructions assume you want to launch a producing validator node on a network with system contracts loaded. These instructions will not work on a default development node using native functionality, or one without system contracts loaded.

Goal

This section describes how to set up a producing node within the EOSIO network. A producing node, as its name implies, is a node that is configured to produce blocks in an EOSIO based blockchain. This functionality if provided through the producer_plugin as well as other Nodeos Plugins.
nodeos plugins
  • Plugins extend the core functionality implemented in nodeos. Some plugins are mandatory, such as chain_plugin, net_plugin, and producer_plugin, which reflect the modular design of nodeos. The other plugins are optional as they provide nice to have features, but non-essential for the nodes operation.
  • The list of specific plugins are as follows:
    • blockvault_client_plugin
    • chain_api_plugin
    • chain_plugin
    • db_size_api_plugin
    • history_api_plugin
    • history_plugin
    • http_client_plugin
    • http_plugin
    • login_plugin
    • net_api_plugin
    • net_plugin
    • producer_plugin
    • state_history_plugin
    • trace_api_plugin
    • txn_test_gen_plugin
Nodeos is modular: Plugins add incremental functionality to nodeos. Unlike runtime plugins, nodeos plugins are built at compile-time.

Pre-requisites

  • Install the EOSIO software before starting this section.
  • It is assumed that nodeos, cleos, and keosd are accessible through the path. If you built EOSIO using shell scripts, make sure to run the Install Script.
  • Know how to pass Nodeos options to enable or disable functionality.

Steps

Please follow the steps below to set up a producing node:
  1. 1.
    Local Wallet
  2. 2.
    Create your bp.json for your Telos validator
  3. 3.
    Register your account as a producing validator
  4. 4.
    Set Producer Name
  5. 5.
    Set the Producer's signature-provider
  6. 6.
    Define a peers list
  7. 7.
    Load the Required Plugins
1. Local Wallet
a. Create Telos Wallet locally. Record the password and keep secure.
1
cleos wallet create -n <wallet_name> --to-console
2
<!-- OR -->
3
cleos wallet create -n <wallet_name> --file <filename_with_extension>
Copied!
b. Unlock EOS Wallet. Paste your wallet password
1
cleos wallet unlock -n <wallet_name> --password <wallet_password>
Copied!
c. Account creation:
1
cleos -u <api_endpoint> system newaccount --stake-net <telos_net_amount> --stake-cpu <telos_cpu_amount> --buy-ram-kbytes <telos_ram_amount> <telos_existing_account_name> <telos_existing_account_name> <owner-publickey> <active-publickey>
Copied!
d. Load new account private key into your wallet
1
cleos wallet import -n <wallet_name> <privkey>
Copied!
2. Create your bp.json for your Telos validator
This will be used by voting portals and websites to identify validators. The bp.json contains location info for your Block Validator, nodes, and also contains other identifiable information such as your Block Producer public key.
For instance, http://yourwebsite.com/bp.json When you register your validator, the URL field should be filled with http://yourwebsite.com. Do not put the bp.json file in the URL.
For instance, for Aloha, the bp.json is located at https://www.alohaeos.com/bp.json, the URL to locate this will be https://www.alohaeos.com.
3. Register your account as a producing validator
In order for your account to be eligible as a producing validator, you will need to register the account as a producing validator:
1
<!-- cleos -u <api_endpoint> system regproducer <producer_account_name> <producer_signature_public_key> <producer_website> <producer-geo-location> -->
2
cleos -u http://api.main.alohaeos.com system regproducer alohaeosprod EOS87wJkSDXLDVVoJUaBYd4tjg8F8chMWY5nPo8Mb5F919TpbjJvz https://www.alohaeos.com Honolulu
Copied!
NOTE: separate key pair used only for signing blocks and can not perform any other operation.
If you currently have your active key listed in your config.ini for signing blocks — you need to stop it and replace it with a separate Signature key
Just follow this in order to replace the existing active (or insecure key) with separate signature key
  • Create new key pair using cleos create key --to-console
  • Replace signature provider record in your config.ini with the new key: signature-provider = EOS-SIGNATURE-PUBLIC-KEY=KEY:SIGNATURE-PRIVATE-KEY
  • Call regproducer command with the new signature key: cleos system regproducer [PRODUCER-NAME] [EOS-SIGNATURE-PUBLIC-KEY] {PRODUCER_URL] [COUNTRY_CODE]
4. Set Producer Name
Set the validator_name option in config.ini to your account, as follows:
1
# config.ini:
2
3
# ID of producer controlled by this node (e.g. inita; may specify multiple times) (eosio::producer_plugin)
4
producer-name = alohaeosprod
Copied!
5. Set the Producer's signature-provider
You will need to set the separate private key for your validator. The public key should have an authority for the validator account defined above.
signature-provider is defined with a 3-field tuple:
  • public-key - A valid EOSIO public key in form of a string.
  • provider-spec - It's a string formatted like :
  • provider-type - KEY or KEOSD
Using a Key:
1
# config.ini:
2
3
signature-provider = PUBLIC_SIGNING_KEY=KEY:PRIVATE_SIGNING_KEY
4
5
//Example
6
//signature-provider = EOS51PsUQXRKphEBPBP8iH8ZRGNvyqJ13hbR8yXGSPKEf5TQH27TF=KEY:5KgV1HsxEm3qKYdLaUgpdZvJcAV2AA7zVDJYBL7nVoE4mdcqQR1
Copied!
Using Keosd:
1
# config.ini:
2
3
signature-provider = KEOSD:<data>
4
5
//Example
6
//EOS51PsUQXRKphEBPBP8iH8ZRGNvyqJ13hbR8yXGSPKEf5TQH27TF=KEOSD:https://127.0.0.1:88888
Copied!
6. Define a peers list
1
# config.ini:
2
3
# Default p2p port is 9876
4
p2p-peer-address = 195.201.82.181:9876
5
p2p-peer-address = 47.52.71.18:9876
6
p2p-peer-address = 207.180.220.203:9876
7
p2p-peer-address = 149.28.254.141:9876
8
p2p-peer-address = p2p-telos.blckchnd.com:19876
9
p2p-peer-address = p2p.blindblocart.io:9877
10
p2p-peer-address = telos.caleos.io:9880
11
p2p-peer-address = p2p.telos.cryptosuvi.io:2222
Copied!
For more, visit here for Telos Mainnet & Telos Testnet
7. Load the Required Plugins
In your config.ini, confirm the following plugins are loading or append them if necessary.
1
# config.ini:
2
3
plugin = eosio::chain_plugin
4
plugin = eosio::producer_plugin
Copied!

B. Non-Producing or Standby mode

Non-Producing Validator Nodes connect to the peer-to-peer (p2p) network but do not actively produce new blocks; they are useful for acting as proxy nodes, relaying API calls, validating transactions, broadcasting information to other nodes, etc. Non-Producing Validator Nodes are also useful for monitoring the blockchain state.

Goal

This section describes how to set up a non-producing validator node within the Telos network. A non-producing validator node is a node that is not configured to produce blocks, instead it is connected and synchronized with other peers from an EOSIO based blockchain, exposing one or more services publicly or privately by enabling one or more Nodeos Plugins, except the producer_plugin.

Pre-requisites

  • Install the EOSIO software before starting this section.
  • It is assumed that nodeos, cleos, and keosd are accessible through the path. If you built EOSIO using shell scripts, make sure to run the Install Script.
  • Know how to pass Nodeos options to enable or disable functionality.

Steps

Please follow the steps below to set up a non-producing node:
  1. 1.
    Set Peers
  2. 2.
    Enable one or more available plugins
1. Set Peers
You need to set some peers in your config ini, for example:
1
# config.ini:
2
3
# Default p2p port is 9876
4
p2p-peer-address = 195.201.82.181:9876
5
p2p-peer-address = 47.52.71.18:9876
6
p2p-peer-address = 207.180.220.203:9876
7
p2p-peer-address = 149.28.254.141:9876
8
p2p-peer-address = p2p-telos.blckchnd.com:19876
9
p2p-peer-address = p2p.blindblocart.io:9877
10
p2p-peer-address = telos.caleos.io:9880
11
p2p-peer-address = p2p.telos.cryptosuvi.io:2222
Copied!
For more, visit here for Telos Mainnet & Telos Testnet
Or you can include the peer in as a boot flag when running nodeos, as follows:
1
nodeos ... --p2p-peer-address=106.10.42.238:9876
Copied!
2. Enable one or more available plugins
Each available plugin is listed and detailed in the Nodeos Plugins section. When nodeos starts, it will expose the functionality provided by the enabled plugins it was started with. For example, if you start nodeos with state_history_plugin enabled, you will have a non-producing node that offers full blockchain history. If you start nodeos with http_plugin enabled, you will have a non-producing node which exposes the Telos RPC API. Therefore, you can extend the basic functionality provided by a non-producing node by enabling any number of existing plugins on top of it. Another aspect to consider is that some plugins have dependencies to other plugins. Therefore, you need to satisfy all dependencies for a plugin in order to enable it.

Configuration Files

Mainnet

genesis.json

1
{
2
"initial_key": "EOS52vfcN43YHHU8Akh7VyfBdnDiMg15dPTELosWG9SR86ssBoU1T",
3
"initial_configuration": {
4
"max_transaction_delay": 3888000,
5
"min_transaction_cpu_usage": 100,
6
"net_usage_leeway": 500,
7
"context_free_discount_net_usage_den": 100,
8
"max_transaction_net_usage": 524288,
9
"context_free_discount_net_usage_num": 20,
10
"max_transaction_lifetime": 3600,
11
"deferred_trx_expiration_window": 600,
12
"max_authority_depth": 6,
13
"max_transaction_cpu_usage": 5000000,
14
"max_block_net_usage": 1048576,
15
"target_block_net_usage_pct": 1000,
16
"max_generated_transaction_count": 16,
17
"max_inline_action_size": 4096,
18
"target_block_cpu_usage_pct": 1000,
19
"base_per_transaction_net_usage": 12,
20
"max_block_cpu_usage": 50000000,
21
"max_inline_action_depth": 4
22
},
23
"initial_timestamp": "2018-12-12T10:29:00.000"
24
}
Copied!

config.ini

1
###### producer plugin options - enable if running producer node
2
plugin = eosio::producer_plugin
3
## sig provider keys should match the key on your producer-name
4
signature-provider = <pubkey>=KEY:<privkey>
5
producer-name = <your unique telos account name>
6
7
## additional producer plugin options can be left default
8
max-transaction-time = 10000
9
max-irreversible-block-age = -1
10
abi-serializer-max-time-ms = 2000
11
enable-stale-production = true
12
pause-on-startup = false
13
14
###### chain plugin options
15
plugin = eosio::chain_plugin
16
wasm-runtime = wabt
17
reversible-blocks-db-size-mb = 340
18
contracts-console = false
19
## set chain-state-db-size-mb to equal the size of your RAM
20
chain-state-db-size-mb = 98304
21
22
###### http plugin options
23
plugin = eosio::http_plugin
24
http-server-address = 0.0.0.0:1880
25
access-control-allow-origin = *
26
access-control-allow-credentials = false
27
https-client-validate-peers = 1
28
verbose-http-errors = true
29
http-validate-host = 0
30
## enable if using https
31
# https-server-address = 0.0.0.0:443
32
# https-certificate-chain-file
33
34
# nodeos general config
35
p2p-server-address = 0.0.0.0:9876
36
p2p-listen-endpoint = 0.0.0.0:9876
37
p2p-max-nodes-per-host = 1
38
max-clients = 250
39
connection-cleanup-period = 30
40
sync-fetch-span = 100
41
txn-reference-block-lag = 0
42
allowed-connection = any
43
agent-name = bensigcoolconfig
44
45
###### additional plugins
46
plugin = eosio::chain_api_plugin
47
plugin = eosio::history_plugin
48
49
###### p2p peer address
50
p2p-peer-address = 159.69.63.222:7776
51
p2p-peer-address = 109.237.25.217:3876
52
p2p-peer-address = testnet.telos.caleos.io:9879
53
p2p-peer-address = p2p.testnet.telos.eosdetroit.io:1337
54
p2p-peer-address = telosafrique.eosnairobi.io:9376
55
p2p-peer-address = telos.eosbcn.com:9876
56
p2p-peer-address = testnet.telos.eosindex.io:9876
Copied!

Testnet

genesis.json

1
{
2
"initial_key": "EOS7xyPWfh6743fhZ46zQQcXSctddoqG65d44YsyRnCJCs54mJLrH",
3
"initial_configuration": {
4
"max_block_net_usage": 1048576,
5
"target_block_net_usage_pct": 1000,
6
"max_transaction_net_usage": 524288,
7
"base_per_transaction_net_usage": 12,
8
"net_usage_leeway": 500,
9
"context_free_discount_net_usage_num": 20,
10
"context_free_discount_net_usage_den": 100,
11
"max_block_cpu_usage": 5000000,
12
"target_block_cpu_usage_pct": 1000,
13
"max_transaction_cpu_usage": 150000,
14
"min_transaction_cpu_usage": 100,
15
"max_transaction_lifetime": 3600,
16
"deferred_trx_expiration_window": 600,
17
"max_transaction_delay": 3888000,
18
"max_inline_action_size": 4096,
19
"max_inline_action_depth": 4,
20
"max_authority_depth": 6
21
},
22
"initial_timestamp": "2019–08–07T12:00:00.000"
23
}
Copied!

config.ini

1
###### producer plugin options - enable if running producer node
2
plugin = eosio::producer_plugin
3
## sig provider keys should match the key on your producer-name
4
signature-provider = <pubkey>=KEY:<privkey>
5
producer-name = <your unique telos account name>
6
7
## additional producer plugin options can be left default
8
max-transaction-time = 10000
9
max-irreversible-block-age = -1
10
abi-serializer-max-time-ms = 2000
11
enable-stale-production = true
12
pause-on-startup = false
13
14
###### chain plugin options
15
plugin = eosio::chain_plugin
16
wasm-runtime = wabt
17
reversible-blocks-db-size-mb = 340
18
contracts-console = false
19
## set chain-state-db-size-mb to equal the size of your RAM
20
chain-state-db-size-mb = 98304
21
22
###### http plugin options
23
plugin = eosio::http_plugin
24
http-server-address = 0.0.0.0:1880
25
access-control-allow-origin = *
26
access-control-allow-credentials = false
27
https-client-validate-peers = 1
28
verbose-http-errors = true
29
http-validate-host = 0
30
## enable if using https
31
# https-server-address = 0.0.0.0:443
32
# https-certificate-chain-file
33
34
# nodeos general config
35
p2p-server-address = 0.0.0.0:9876
36
p2p-listen-endpoint = 0.0.0.0:9876
37
p2p-max-nodes-per-host = 1
38
max-clients = 250
39
connection-cleanup-period = 30
40
sync-fetch-span = 100
41
txn-reference-block-lag = 0
42
allowed-connection = any
43
agent-name = bensigcoolconfig
44
45
###### additional plugins
46
plugin = eosio::chain_api_plugin
47
plugin = eosio::history_plugin
48
49
###### p2p peer address
50
p2p-peer-address=testnet2.telos.eosusa.news:59877
51
p2p-peer-address=node1.testnet2.telosglobal.io:9876
52
p2p-peer-address=node2.testnet2.telosglobal.io:9876
53
p2p-peer-address=basho.eos.barcelona:9899
54
p2p-peer-address=sslapi.teloscentral.com:9875
55
p2p-peer-address=145.239.133.188:5566
56
p2p-peer-address=testnet.telos.eclipse24.io:6789
57
p2p-peer-address=testnet2.telos.eosdetroit.io:1337
58
p2p-peer-address=basho-p2p.telosuk.io:19876
59
p2p-peer-address=telos-testnet.atticlab.net:7876
60
p2p-peer-address=testnet.eossweden.eu:8022
61
p2p-peer-address=testnet.telos.cryptosuvi.io:2223
62
p2p-peer-address=nickfury.tlos.goodblock.io:9876
63
p2p-peer-address=telosapi.eosmetal.io:59877
64
p2p-peer-address=207.148.6.75:9877
65
p2p-peer-address=p2p.testnet.telosgermany.io
66
p2p-peer-address=176.9.86.214:9877
67
p2p-peer-address=telos-testnet-b.eosphere.io:9876
68
p2p-peer-address=testnet.telos.africa:9875
69
p2p-peer-address=p2p.testnet.telosgreen.com:9876
70
p2p-peer-address=testnet2p2p.telosarabia.net:9876
71
p2p-peer-address=peer.tlostest.alohaeos.com:9876
72
p2p-peer-address=157.230.29.117:9876
Copied!

Frequently Asked Questions (FAQs)

Q. How does a Validator create a new account on Telos Blockchain?

A. There are 2 ways to create an account on Telos Blockchain:

Q. What is the difference between Telos Mainnet and Testnet?

A. The differences are as follows:

a. The mainnet of a blockchain launches when the protocol is fully developed and is the network where the project's functionalities, such as transactions with the native tokens, are carried out. Here is where transactions are being broadcasted, verified, and recorded on a distributed ledger technology. Whereas the testnet is a safe, separate network where developers carry out tests in the code without risking the main blockchain. The Telos Testnets are a sandbox for testing newly implemented features, finding bugs within the network and developing DApps. a. Testnet is for testing code updates, other functionalities, bug identification, new projects and program development, among many other uses. b. People associate a testnet with the initial developing of a blockchain where all the codes run, and we test everything before the final deployment of the protocol to the mainnet. c. the Telos testnets have one prominent advantage over the other testnets: it is a duplicate of the mainnet so it includes all its smart contracts and functionalities in the testnets. Because of this, developers and BPs obtain complete, accurate results when they run their tests, while reducing the work they have to do before running them. e. Testnet is designed to be as close to the code/features of the Telos Mainnet, with exception to any new innovations being tested in preparation for deployment on Mainnet.

Q. When a new upgrade or anything different will be tested before launch, what test strategies the Telos Validators follow?

A. Telos Validators follow a 4-tier test strategy, as it allows “to properly test/vet things at each respective level, and as it progresses through the tiers, additional testing/testers stress-test the system until its final deployment to the Telos Mainnet.” The stages are:

  • Internal Dev Testing: closed-loop testing of all code changes before presenting to any public tier.
  • Stagenet Testing: initial selected access, testing ran dedicated nodes.
  • Testnet Testing: this is where most public testing of features will occur before completing deployment to Mainnet. Code changes/activation at this level require 15/21 approval of the Testnet BPs.
  • Mainnet Deployment: once all testing has been completed, a deployment date agreed upon, a 15/21 BP approval is needed to activate all code changes/features on the Mainnet.