Overview

As a validator for the Quantum Portal network, your Quantum Portal node will vote on the status of external blockchains such as Ethereum, Cosmos, etc. Specifically:

1. Select which external chains your Quantum Portal node will support. Set up and configure your own nodes for the chains you selected.
2. Provide RPC endpoints for these nodes to your Quantum Portal validator node and register as a maintainer for these chains on the Quantum Portal network.

External chains you can support on Quantum Portal

• EVM-compatible chains
  • Arbitrum
  • Avalanche
  • Binance
  • Blast
  • Celo
  • Centrifuge
  • Ethereum
  • Fantom
  • Filecoin
  • Fraxtal
  • Immutable zkEVM
  • Kava
  • Mantle
  • Scroll
  • Moonbeam
  • Optimism
  • Polygon
  • Polygon zkEVM
• Cosmos chains
  • Nothing to do. All Cosmos chains are automatically supported by default.

Add external chain info to your validator’s configuration

Edit your vald config $QPD_HOME/config.toml: set the rpc_addr and start-with-bridge entries corresponding to the external chain you wish to connect.

Your config.toml file should already contain a snippet like the following:

##### EVM bridges options #####
# Each EVM chain needs the following
# 1. `[[QP_bridge_evm]]` # header
# 2. `name`                  # chain name (eg. "Ethereum")
# 3. 'rpc_addr'              # EVM RPC endpoint URL; chain maintainers set their own endpoint
# 4. `start-with-bridge`     # `true` to support this chain
#
# see https://docs.QP.dev/validator/external-chains

[[QP_bridge_evm]]
name = "Ethereum"
rpc_addr = ""
start-with-bridge = false

[[QP_bridge_evm]]
name = "Avalanche"
rpc_addr = ""
start-with-bridge = false

[[QP_bridge_evm]]
name = "Fantom"
rpc_addr = ""
start-with-bridge = false

[[QP_bridge_evm]]
name = "Moonbeam"
rpc_addr = ""
start-with-bridge = false

[[QP_bridge_evm]]
name = "Polygon"
rpc_addr = ""
start-with-bridge = false

Example: Ethereum

Edit the Ethereum entry::

[[QP_bridge_evm]]
name = "ethereum"
rpc_addr = "http://ip:port"
start-with-bridge = true

Be sure to set start-with-bridge to true.

Restart your companion processes

Stop your companion processes vald, tofnd.

kill -9 $(pgrep tofnd)
kill -9 $(pgrep -f "QPd vald-start")

Immediately resume your companion processes vald, tofnd as per Launch companion processes.

Check your connections to new chains in vald

Check your vald logs to see that your validator node has successfully connected to the new EVM chains you added. [How to view logs.]

You should see something like:

{`2021-11-25T01:25:54Z INF Successfully connected to EVM bridge for chain Ethereum module=vald
2021-11-25T01:25:54Z INF Successfully connected to EVM bridge for chain Avalanche module=vald
2021-11-25T01:25:54Z INF Successfully connected to EVM bridge for chain Fantom module=vald
2021-11-25T01:25:54Z INF Successfully connected to EVM bridge for chain Moonbeam module=vald
2021-11-25T01:25:54Z INF Successfully connected to EVM bridge for chain Polygon module=vald
2021-11-25T01:25:54Z INF Successfully connected to EVM bridge for chain Binance module=vald`}

Register as a maintainer of external chains

For each external chain C you selected earlier you must inform the Quantum Portal network of your intent to maintain C. This is accomplished via the register-chain-maintainer command. Since vald uses the broadcaster account, it is recommended to be shut down when submitting this command to avoid running into sequence mismatch errors due to concurrent signing.

Example:

QPd tx nexus register-chain-maintainer avalanche ethereum fantom moonbeam polygon --from broadcaster --chain-id $QPD_CHAIN_ID --home $QPD_HOME --gas auto --gas-adjustment 1.4

Deregister as chain maintainer from an external chain

If for some reason you need to deregister an external chain as a maintainer you must inform the Quantum Portal network of every chain you intent to leave. This is accomplished via the deregister-chain-maintainer command.

Example: Deregister the Avalanche chain:

QPd tx nexus deregister-chain-maintainer avalanche --from broadcaster --chain-id $QPD_CHAIN_ID --home $QPD_HOME --gas auto --gas-adjustment 1.4

Always configure RPC and chain registration together

Why? If your RPC endpoint for C is enabled but you are not registered as a maintainer for C then your validator will post vote transactions for C but those transactions will be ignored by the Quantum Portal network. Consequences:

• Your broadcaster account will lose funds because the Quantum Portal network does not refund transaction fees for vote messages unless you are a registered maintainer for chain C.
• You will see spurious error messages in your vald logs.
• Quantum Portal dashboards might display incorrect data on your votes for chain C.

Conversely, if you are registered as a maintainer for C but your RPC endpoint for C is disabled then your validator will fail to post vote transactions for C when the Quantum Portal network expects them. Consequences:

• Your validator will exhibit poor vote performance and cannot earn rewards for maintaining C.

Automatic deregistration

The Quantum Portal network will automatically deregister your validator as a maintainer for chain C if either of the following conditions is met in the previous 500 polls for C:

1. Your validator missed at least 20% of polls. A poll is “missed” if your validator never submits a vote transaction or if the vote transaction is posted more than 3 blocks after the poll concludes.
2. Your validator voted incorrectly in at least 5% of polls. A vote is “incorrect” if it conflicts with the majority for that poll.

How to recognize automatic deregistration

• The Quantum Portal network emits an event each time a chain maintainer is deregistered.
• QP-core logs will contain a message of the form deregistered validator {address} as maintainer for chain {chain}.
• Run the CLI query QPd q nexus chain-maintainers [chain] to see whether your validator is included.