Node Configuration

This guide is to show you how to configure your Pocket Validator node and go over other options you can use to customize your node.

Set Validator Address

You can change or set the address of your validator node that is displayed on the Tendermint network by using the set-validator command in the Pocket CLI:

$  pocket accounts set-validator <address>

If you already had an address connected to the Tendermint network, you may want to change the address and use another account. You first have to unstake that account, then use the set-validator command(shown above) and restake your node on the network.

Configuring your Chains

The chains is a JSON file that is used to connect your non-native blockchain node to your Pocket Validator node to relay requests throughout the network. You can configure your chains using the following methods:

Using the CLI:

To automatically configure your chains.json for the first time using the Pocket Core CLI, in your terminal, enter:

$  pocket util generate-chains

# returns
Enter the ID of the network identifier:

The first prompt, Enter the ID of the network identifier: asks for the identifier of the non-native blockchain you are supporting. You can find a list of network identifiers here.

Example: Eth Rinkeby network identifier is: 0022

After you hit enter, it then asks you to "Enter the URL of the network identifier:". This is the address of your blockchain node or load balancer you have running for your non-native blockchain.

Last it will ask "Would you like to enter another network identifier? (y/n)".
If you are only servicing one non-native blockchain then enter "n".
or you want to add more blockchains you are servicing to your chains then enter "y" and repeat the septs mentioned above.

Configure Your chains.json Manually:

You can create your own chains file by providing the following variables: ID and URL. If you are using Docker you may need to create your own chains.json file and map it to your docker containers directory. You will need to provide the following:

  • id: Identifier of the non-native blockchain you are supporting
  • url: The address of your blockchain node or load balancer you have running for your non-native blockchain.
[
  {
    "id": "0022",
    "url": "https://my-eth-node-url"
  }
]

A Pocket Validator Node can service multiple blockchians in one, saving you the time of configuring another validator node and staking it on the Pocket blockchain. To add more then one blockchain in your chains.json, you can list them out by doing the following:

[
  {
    "id": "0022", //eth rinkeby 
    "url": "https://my-eth-rinkeby-url"
  },
  {
    "id": "0021", //eth mainnet
    "url": "https://my-eth-mainnet-url"
  }
]

Configure your Genesis File

In order to connect to the Pocket Network, you will need to add the genesis.json file inside config folder that is located in your $HOME/.pocket/ directory. You can

  1. Download the correct genesis.json file from our Github .

  2. Download it directly into your config directory by entering:

$  curl -O https://raw.githubusercontent.com/pokt-network/pocket-network-genesis/master/testnet/genesis.json
  1. Or copy and paste the contents below in the genesis.json file in your $HOME/.pocket/config directory:
{
    "genesis_time": "2020-06-01T23:35:15.556598Z",
    "chain_id": "testnet",
    "consensus_params": {
        "block": {
            "max_bytes": "4000000",
            "max_gas": "-1",
            "time_iota_ms": "1"
        },
        "evidence": {
            "max_age": "120000000000"
        },
        "validator": {
            "pub_key_types": [
                "ed25519"
            ]
        }
    },
    "app_hash": "",
    "app_state": {
        "application": {
            "params": {
                "unstaking_time": "3600000000000",
                "max_applications": "9223372036854775807",
                "app_stake_minimum": "1000000",
                "base_relays_per_pokt": "2",
                "stability_adjustment": "0",
                "participation_rate_on": false,
                "maximum_chains": "15"
            },
            "applications": [],
            "exported": false
        },
        "auth": {
            "params": {
                "max_memo_characters": "1",
                "tx_sig_limit": "8",
                "fee_multipliers": {
                    "fee_multiplier": [{
                            "key": "claim",
                            "multiplier": "10"
                        },
                        {
                            "key": "proof",
                            "multiplier": "10"
                        }
                    ],
                    "default": "1"
                }
            },
            "accounts": [{
                "type": "posmint/Account",
                "value": {
                    "address": "cad3b0b8f5b54f0750385c6ca17a5c745d9dba17",
                    "coins": [{
                        "amount": "18446743929693333435",
                        "denom": "upokt"
                    }],
                    "public_key": {
                        "type": "crypto/ed25519_public_key",
                        "value": "e603378f4c0fe1ca57d545741a8150231218aa3d9e2f62c06a5005dfbca3bf3d"
                    }
                }
            }, {
                "type": "posmint/Account",
                "value": {
                    "address": "610cf8a6e8cefbaded845f1c1dc3b10a670be26b",
                    "coins": [{
                        "amount": "18446743929693333435",
                        "denom": "upokt"
                    }],
                    "public_key": {
                        "type": "crypto/ed25519_public_key",
                        "value": "1807948ea0041de2a9cd573d0edb073c1eaea60313c364c16c1bcd27629e305b"
                    }
                }
            }, {
                "type": "posmint/Account",
                "value": {
                    "address": "e6946760d9833f49da39aae9500537bef6f33a7a",
                    "coins": [{
                        "amount": "18446743929693333435",
                        "denom": "upokt"
                    }],
                    "public_key": {
                        "type": "crypto/ed25519_public_key",
                        "value": "4ac6202fca022b932be12a5bd51dc8375bfee843f4f90c412e83ad9af1069361"
                    }
                }
            }, {
                "type": "posmint/Account",
                "value": {
                    "address": "7674a47cc977326f1df6cb92c7b5a2ad36557ea2",
                    "coins": [{
                        "amount": "18446743929693333435",
                        "denom": "upokt"
                    }],
                    "public_key": {
                        "type": "crypto/ed25519_public_key",
                        "value": "257943d4255d60f9a042a2cd81ff64b711bedbf72db64d1f84b0e2455ce1dfd1"
                    }
                }
            }, {
                "type": "posmint/Account",
                "value": {
                    "address": "c7b7b7665d20a7172d0c0aa58237e425f333560a",
                    "coins": [{
                        "amount": "18446743929693333435",
                        "denom": "upokt"
                    }],
                    "public_key": {
                        "type": "crypto/ed25519_public_key",
                        "value": "d4448f629a19e4fb68a904a8d879fdd8b1b326d0fff39973f39af737a282be71"
                    }
                }
            }, {
                "type": "posmint/Account",
                "value": {
                    "address": "f6dc0b244c93232283cd1d8443363946d0a3d77a",
                    "coins": [{
                        "amount": "18446743929693333435",
                        "denom": "upokt"
                    }],
                    "public_key": {
                        "type": "crypto/ed25519_public_key",
                        "value": "1c03871c9f6d437a1856cc5141afa7beb1670e82ce692cb7d041d4bc90ab71ad"
                    }
                }
            }, {
                "type": "posmint/Account",
                "value": {
                    "address": "86209713befeca0807714bcdd5b79e81073faf8f",
                    "coins": [{
                        "amount": "18446743929693333435",
                        "denom": "upokt"
                    }],
                    "public_key": {
                        "type": "crypto/ed25519_public_key",
                        "value": "11ac3c35a531ec39f9c5f9164cdf13b19572181dc2048cba666ade0947df6a71"
                    }
                }
            }, {
                "type": "posmint/Account",
                "value": {
                    "address": "915a58ae437d2c2d6f35ac11b79f42972267700d",
                    "coins": [{
                        "amount": "18446743929693333435",
                        "denom": "upokt"
                    }],
                    "public_key": {
                        "type": "crypto/ed25519_public_key",
                        "value": "9290914ab72b4e1d377ac53350996b937ed466a01e3381a7de40282d11501f5b"
                    }
                }
            }],
            "supply": []
        },
        "gov": {
            "params": {
                "acl": [{
                        "acl_key": "application/ApplicationStakeMinimum",
                        "address": "b3d86cd8ab4aa0cb9861cb795d8d154e685a94cf"
                    },
                    {
                        "acl_key": "application/AppUnstakingTime",
                        "address": "b3d86cd8ab4aa0cb9861cb795d8d154e685a94cf"
                    },
                    {
                        "acl_key": "application/BaseRelaysPerPOKT",
                        "address": "b3d86cd8ab4aa0cb9861cb795d8d154e685a94cf"
                    },
                    {
                        "acl_key": "application/MaxApplications",
                        "address": "b3d86cd8ab4aa0cb9861cb795d8d154e685a94cf"
                    },
                    {
                        "acl_key": "application/MaximumChains",
                        "address": "b3d86cd8ab4aa0cb9861cb795d8d154e685a94cf"
                    },
                    {
                        "acl_key": "application/ParticipationRateOn",
                        "address": "b3d86cd8ab4aa0cb9861cb795d8d154e685a94cf"
                    },
                    {
                        "acl_key": "application/StabilityAdjustment",
                        "address": "b3d86cd8ab4aa0cb9861cb795d8d154e685a94cf"
                    },
                    {
                        "acl_key": "auth/MaxMemoCharacters",
                        "address": "b3d86cd8ab4aa0cb9861cb795d8d154e685a94cf"
                    },
                    {
                        "acl_key": "auth/TxSigLimit",
                        "address": "b3d86cd8ab4aa0cb9861cb795d8d154e685a94cf"
                    },
                    {
                        "acl_key": "gov/acl",
                        "address": "b3d86cd8ab4aa0cb9861cb795d8d154e685a94cf"
                    },
                    {
                        "acl_key": "gov/daoOwner",
                        "address": "b3d86cd8ab4aa0cb9861cb795d8d154e685a94cf"
                    },
                    {
                        "acl_key": "gov/upgrade",
                        "address": "b3d86cd8ab4aa0cb9861cb795d8d154e685a94cf"
                    },
                    {
                        "acl_key": "pocketcore/ClaimExpiration",
                        "address": "b3d86cd8ab4aa0cb9861cb795d8d154e685a94cf"
                    },
                    {
                        "acl_key": "auth/FeeMultipliers",
                        "address": "b3d86cd8ab4aa0cb9861cb795d8d154e685a94cf"
                    },
                    {
                        "acl_key": "pocketcore/ReplayAttackBurnMultiplier",
                        "address": "b3d86cd8ab4aa0cb9861cb795d8d154e685a94cf"
                    },
                    {
                        "acl_key": "pos/ProposerPercentage",
                        "address": "b3d86cd8ab4aa0cb9861cb795d8d154e685a94cf"
                    },
                    {
                        "acl_key": "pocketcore/ClaimSubmissionWindow",
                        "address": "b3d86cd8ab4aa0cb9861cb795d8d154e685a94cf"
                    },
                    {
                        "acl_key": "pocketcore/MinimumNumberOfProofs",
                        "address": "b3d86cd8ab4aa0cb9861cb795d8d154e685a94cf"
                    },
                    {
                        "acl_key": "pocketcore/SessionNodeCount",
                        "address": "b3d86cd8ab4aa0cb9861cb795d8d154e685a94cf"
                    },
                    {
                        "acl_key": "pocketcore/SupportedBlockchains",
                        "address": "b3d86cd8ab4aa0cb9861cb795d8d154e685a94cf"
                    },
                    {
                        "acl_key": "pos/BlocksPerSession",
                        "address": "b3d86cd8ab4aa0cb9861cb795d8d154e685a94cf"
                    },
                    {
                        "acl_key": "pos/DAOAllocation",
                        "address": "b3d86cd8ab4aa0cb9861cb795d8d154e685a94cf"
                    },
                    {
                        "acl_key": "pos/DowntimeJailDuration",
                        "address": "b3d86cd8ab4aa0cb9861cb795d8d154e685a94cf"
                    },
                    {
                        "acl_key": "pos/MaxEvidenceAge",
                        "address": "b3d86cd8ab4aa0cb9861cb795d8d154e685a94cf"
                    },
                    {
                        "acl_key": "pos/MaximumChains",
                        "address": "b3d86cd8ab4aa0cb9861cb795d8d154e685a94cf"
                    },
                    {
                        "acl_key": "pos/MaxJailedBlocks",
                        "address": "b3d86cd8ab4aa0cb9861cb795d8d154e685a94cf"
                    },
                    {
                        "acl_key": "pos/MaxValidators",
                        "address": "b3d86cd8ab4aa0cb9861cb795d8d154e685a94cf"
                    },
                    {
                        "acl_key": "pos/MinSignedPerWindow",
                        "address": "b3d86cd8ab4aa0cb9861cb795d8d154e685a94cf"
                    },
                    {
                        "acl_key": "pos/RelaysToTokensMultiplier",
                        "address": "b3d86cd8ab4aa0cb9861cb795d8d154e685a94cf"
                    },
                    {
                        "acl_key": "pos/SignedBlocksWindow",
                        "address": "b3d86cd8ab4aa0cb9861cb795d8d154e685a94cf"
                    },
                    {
                        "acl_key": "pos/SlashFractionDoubleSign",
                        "address": "b3d86cd8ab4aa0cb9861cb795d8d154e685a94cf"
                    },
                    {
                        "acl_key": "pos/SlashFractionDowntime",
                        "address": "b3d86cd8ab4aa0cb9861cb795d8d154e685a94cf"
                    },
                    {
                        "acl_key": "pos/StakeDenom",
                        "address": "b3d86cd8ab4aa0cb9861cb795d8d154e685a94cf"
                    },
                    {
                        "acl_key": "pos/StakeMinimum",
                        "address": "b3d86cd8ab4aa0cb9861cb795d8d154e685a94cf"
                    },
                    {
                        "acl_key": "pos/UnstakingTime",
                        "address": "b3d86cd8ab4aa0cb9861cb795d8d154e685a94cf"
                    }
                ],
                "dao_owner": "b3d86cd8ab4aa0cb9861cb795d8d154e685a94cf",
                "upgrade": {
                    "Height": "0",
                    "Version": "0"
                }
            },
            "DAO_Tokens": "0"
        },
        "pos": {
            "params": {
                "relays_to_tokens_multiplier": "10000",
                "unstaking_time": "3600000000000",
                "max_validators": "5000",
                "stake_denom": "upokt",
                "stake_minimum": "15000000000",
                "session_block_frequency": "4",
                "dao_allocation": "10",
                "proposer_allocation": "1",
                "maximum_chains": "15",
                "max_jailed_blocks": "6",
                "max_evidence_age": "120000000000",
                "signed_blocks_window": "100",
                "min_signed_per_window": "1",
                "downtime_jail_duration": "6000000000000",
                "slash_fraction_double_sign": "0.05",
                "slash_fraction_downtime": "0.01"
            },
            "prevState_total_power": "0",
            "prevState_validator_powers": null,
            "validators": [{
                    "address": "610cf8a6e8cefbaded845f1c1dc3b10a670be26b",
                    "public_key": "1807948ea0041de2a9cd573d0edb073c1eaea60313c364c16c1bcd27629e305b",
                    "jailed": false,
                    "status": 2,
                    "tokens": "1500000000000",
                    "service_url": "https://node1.testnet.pokt.network:443",
                    "chains": [
                        "0002",
                        "0023",
                        "0031",
                        "0032",
                        "0040",
                        "0044",
                        "0046",
                        "0057",
                        "005C",
                        "0021",
                        "0041",
                        "003F",
                        "0043",
                        "005E",
                        "0065",
                        "0003",
                        "0022",
                        "0042",
                        "0045",
                        "0066",
                        "0067",
                        "0014",
                        "0020"
                    ],
                    "unstaking_time": "0001-01-01T00:00:00Z"
                },
                {
                    "address": "e6946760d9833f49da39aae9500537bef6f33a7a",
                    "public_key": "4ac6202fca022b932be12a5bd51dc8375bfee843f4f90c412e83ad9af1069361",
                    "jailed": false,
                    "status": 2,
                    "tokens": "1500000000000",
                    "service_url": "https://node2.testnet.pokt.network:443",
                    "chains": [
                        "0002",
                        "0023",
                        "0031",
                        "0032",
                        "0040",
                        "0044",
                        "0046",
                        "0057",
                        "005C",
                        "0021",
                        "0041",
                        "003F",
                        "0043",
                        "005E",
                        "0065",
                        "0003",
                        "0022",
                        "0042",
                        "0045",
                        "0066",
                        "0067",
                        "0014",
                        "0020"
                    ],
                    "unstaking_time": "0001-01-01T00:00:00Z"
                },
                {
                    "address": "7674a47cc977326f1df6cb92c7b5a2ad36557ea2",
                    "public_key": "257943d4255d60f9a042a2cd81ff64b711bedbf72db64d1f84b0e2455ce1dfd1",
                    "jailed": false,
                    "status": 2,
                    "tokens": "1500000000000",
                    "service_url": "https://node3.testnet.pokt.network:443",
                    "chains": [
                        "0002",
                        "0023",
                        "0031",
                        "0032",
                        "0040",
                        "0044",
                        "0046",
                        "0057",
                        "005C",
                        "0021",
                        "0041",
                        "003F",
                        "0043",
                        "005E",
                        "0065",
                        "0003",
                        "0022",
                        "0042",
                        "0045",
                        "0066",
                        "0067",
                        "0014",
                        "0020"
                    ],
                    "unstaking_time": "0001-01-01T00:00:00Z"
                },
                {
                    "address": "c7b7b7665d20a7172d0c0aa58237e425f333560a",
                    "public_key": "d4448f629a19e4fb68a904a8d879fdd8b1b326d0fff39973f39af737a282be71",
                    "jailed": false,
                    "status": 2,
                    "tokens": "1500000000000",
                    "service_url": "https://node4.testnet.pokt.network:443",
                    "chains": [
                        "0002",
                        "0023",
                        "0031",
                        "0032",
                        "0040",
                        "0044",
                        "0046",
                        "0057",
                        "005C",
                        "0021",
                        "0041",
                        "003F",
                        "0043",
                        "005E",
                        "0065",
                        "0003",
                        "0022",
                        "0042",
                        "0045",
                        "0066",
                        "0067",
                        "0014",
                        "0020"
                    ],
                    "unstaking_time": "0001-01-01T00:00:00Z"
                },
                {
                    "address": "f6dc0b244c93232283cd1d8443363946d0a3d77a",
                    "public_key": "1c03871c9f6d437a1856cc5141afa7beb1670e82ce692cb7d041d4bc90ab71ad",
                    "jailed": false,
                    "status": 2,
                    "tokens": "1500000000000",
                    "service_url": "https://node5.testnet.pokt.network:443",
                    "chains": [
                        "0002",
                        "0023",
                        "0031",
                        "0032",
                        "0040",
                        "0044",
                        "0046",
                        "0057",
                        "005C",
                        "0021",
                        "0041",
                        "003F",
                        "0043",
                        "005E",
                        "0065",
                        "0003",
                        "0022",
                        "0042",
                        "0045",
                        "0066",
                        "0067",
                        "0014",
                        "0020"
                    ],
                    "unstaking_time": "0001-01-01T00:00:00Z"
                },
                {
                    "address": "86209713befeca0807714bcdd5b79e81073faf8f",
                    "public_key": "11ac3c35a531ec39f9c5f9164cdf13b19572181dc2048cba666ade0947df6a71",
                    "jailed": false,
                    "status": 2,
                    "tokens": "1500000000000",
                    "service_url": "https://node6.testnet.pokt.network:443",
                    "chains": [
                        "0002",
                        "0023",
                        "0031",
                        "0032",
                        "0040",
                        "0044",
                        "0046",
                        "0057",
                        "005C",
                        "0021",
                        "0041",
                        "003F",
                        "0043",
                        "005E",
                        "0065",
                        "0003",
                        "0022",
                        "0042",
                        "0045",
                        "0066",
                        "0067",
                        "0014",
                        "0020"
                    ],
                    "unstaking_time": "0001-01-01T00:00:00Z"
                },
                {
                    "address": "915a58ae437d2c2d6f35ac11b79f42972267700d",
                    "public_key": "9290914ab72b4e1d377ac53350996b937ed466a01e3381a7de40282d11501f5b",
                    "jailed": false,
                    "status": 2,
                    "tokens": "1500000000000",
                    "service_url": "https://node7.testnet.pokt.network:443",
                    "chains": [
                        "0002",
                        "0023",
                        "0031",
                        "0032",
                        "0040",
                        "0044",
                        "0046",
                        "0057",
                        "005C",
                        "0021",
                        "0041",
                        "003F",
                        "0043",
                        "005E",
                        "0065",
                        "0003",
                        "0022",
                        "0042",
                        "0045",
                        "0066",
                        "0067",
                        "0014",
                        "0020"
                    ],
                    "unstaking_time": "0001-01-01T00:00:00Z"
                }
            ],
            "exported": false,
            "signing_infos": {},
            "missed_blocks": {},
            "previous_proposer": ""
        },
        "pocketcore": {
            "params": {
                "session_node_count": "5",
                "proof_waiting_period": "3",
                "supported_blockchains": [
                    "0001",
                    "0002",
                    "0003",
                    "0004",
                    "0005",
                    "0006",
                    "0007",
                    "0008",
                    "0009",
                    "000A",
                    "000B",
                    "000C",
                    "000D",
                    "000E",
                    "000F",
                    "0010",
                    "0011",
                    "0012",
                    "0013",
                    "0014",
                    "0015",
                    "0016",
                    "0017",
                    "0018",
                    "0019",
                    "001A",
                    "001B",
                    "001C",
                    "001D",
                    "001E",
                    "001F",
                    "0020",
                    "0021",
                    "0022",
                    "0023",
                    "0024",
                    "0025",
                    "0026",
                    "0027",
                    "0028",
                    "0029",
                    "002A",
                    "002B",
                    "002C",
                    "002D",
                    "002E",
                    "002F",
                    "0030",
                    "0031",
                    "0032",
                    "0033",
                    "0034",
                    "0035",
                    "0036",
                    "0037",
                    "0038",
                    "0039",
                    "003A",
                    "003B",
                    "003C",
                    "003D",
                    "003E",
                    "003F",
                    "0040",
                    "0041",
                    "0042",
                    "0043",
                    "0044",
                    "0045",
                    "0046",
                    "0047",
                    "0048",
                    "0049",
                    "004A",
                    "004B",
                    "004C",
                    "004D",
                    "004E",
                    "004F",
                    "0050",
                    "0051",
                    "0052",
                    "0053",
                    "0054",
                    "0055",
                    "0056",
                    "0057",
                    "0058",
                    "0059",
                    "005A",
                    "005B",
                    "005C",
                    "005D",
                    "005E",
                    "005F",
                    "0060",
                    "0061",
                    "0062",
                    "0063",
                    "0064",
                    "0065",
                    "0066",
                    "0067",
                    "0068",
                    "0069",
                    "006A",
                    "006B"
                ],
                "claim_expiration": "120",
                "replay_attack_burn_multiplier": "3",
                "minimum_number_of_proofs": "10"
            },
            "receipts": null,
            "claims": null
        }
    }
}

Note: If you are using custom data directories, be sure to store this into your config directory

Updated 2 months ago


Node Configuration


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.