Skip to main content

Guide: Becoming a Rarimo validator

The following guide will instruct you on setting up the Rarimo node and stake the tokens to become the validator. We will also set up a broadcaster service, TSS service, and EVM identity saver service.

Node (rarimo-core)

To run the node, follow these steps:

  1. Download the following:
  1. Generate validator configs using rarimo-core binary

  2. Connect to This IP address is used for submitting TXs and p2p connections.

  3. Connect to the RPC node: [email protected]:26656

  4. Execute script to set environments:

export RARIMO_NODE=tcp://
  1. This script will init folder structure:
rarimo-core init $MONIKER_NAME --chain-id=rarimo_201411-1 --home=$RARIMO_HOME
  1. Paste genesis.json and app.toml (downloaded before) in $RARIMO_HOME/config/ folder.

  2. Create validator's private key:

rarimo-core keys add <key-name> --keyring-backend test --home=$RARIMO_HOME

Remember to save your mnemonic and address.

  1. Use your mnemonic to get ECDSA private key:
rarimo-core tx rarimocore parse-mnemonic 'mnemonic phrase'
  1. Add environment var with created address:
  1. Backup the following files and folders:
  1. Check validator seed:
rarimo-core tendermint show-node-id --home=$RARIMO_HOME
  1. Check that the key exists in the keystore:
rarimo-core keys show $LOCAL_VALIDATOR_ADDRESS --keyring-backend test --home=$RARIMO_HOME
  1. To run, use environment variables:
value: 'rarimo-core'


value: 'true'
  1. Use the following command to start your node:
mkdir -p $DAEMON_HOME/cosmovisor/genesis/bin && cp YOU_STORE_CORE_BIN(name rarimo-core) $DAEMON_HOME/cosmovisor/genesis/bin && cosmovisor run start --home=$RARIMO_HOME --rpc.laddr tcp://

That address will be used for your validator staking and your oracles.

Broadcaster service (broadcaster-svc)

To set up the broadcaster service, you will need your previously generated private key (you can get it via mnemonic).

Follow these steps:

  1. Download the broadcaster server binary

The following configuration config.yaml file should be provided to launch your broadcaster service (paste your private key in hex format):

disable_sentry: true
level: debug

## Port to listen incoming requests
addr: :80

## PostgreSQL database connect
url: 'postgres://broadcaster:broadcaster@broadcaster-db/broadcaster?sslmode=disable'

## Rarimo account private key in Hex format: 0x123fab...
sender_prv_hex: ''
## Rarimo chain id
chain_id: 'rarimo_201411-1'
## Base coin name
coin_name: 'urmo'

addr: 'validator:9090'
  1. You will also need some environment variables to run the service:
value: /config/config.yaml # The path to your config file
  1. Finally, perform migrations and start the service:
broadcaster-svc migrate up && broadcaster-svc run all

EVM identity saver

Currently, it should be one instance per account only for Polygon.

To set up EVM identity saver service, follow these steps:

  1. Download EVM Identity Saver service binary

  2. The following configuration config.yaml file should be provided to launch your oracle:

disable_sentry: true
level: debug

## Port to listen incoming requests (used to trigger revote for some operation - rare flow)
addr: :8000

## State contract for listening
contract_addr: '0x624ce98D2d27b20b8f8d521723Df8fC4db71D79D'
## Polygon websocket address
rpc: ''
## Start block to listen events. (0 - listen from current). Used to catchup old events. Be careful to use.
start_from_block: 0
## According to network name in Rarimo core. Example: Polygon
network_name: Polygon
## How many blocks should be created after event to fetch it.
block_window: 20

## address of broadcaster-svc
addr: ''
## sender account address (rarimo..)
sender_account: ''

## Rarimo chain connections

addr: tcp://validator:26657

addr: validator:9090

## Profiling

enabled: false
addr: :8080

## Issuer information

issuer_id: ['']
disable_filtration: true
  1. Add the path to your config file to the environment variables:
value: /config/config.yaml # the path to your config file

Oracle service requires the staking of some RMO tokens in the Rarimo chain.

  1. To start the service (in vote mode), use the following command:
evm-identity-saver-svc run state-update-voter


To become an active TSS party, you need to follow these steps:

  1. Download TSS service binary

  2. Generate TSS account (it is recommended to generate the new one and not use it in other services):

rarimo-core keys add <key-name> --keyring-backend test --home=$TSS_HOME

Also, you need to parse the mnemonic to get the corresponding private key:

rarimo-core tx rarimocore parse-mnemonic 'mnemonic phrase'
  1. Pre-setup secret parameters, execute and save response JSON:
tss-svc run paramgen
  1. Generate trial ECDSA private key, execute and store results:
tss-svc run prvgen
  1. Set up the Vault service and create a secret for your TSS (type KV version 2). The secret should contain the following credentials:
  * "data": "Leave empty"

* "pre": "Generated pre params JSON"

* "account": "Your Rarimo account hex key"

* "trial": "Generated Trial ECDSA private key hex"

JSON example:

"tls": true,
"data": "",
"pre": "pre-generated-secret-data",
"account": "rarimo-account-private-key-hex-leading-0x",
"trial": "trial-ecdsa-private-key-hex-leading-0x"
  1. Create a configuration file config.yaml with the following structure:
disable_sentry: true
level: debug

## PostreSQL connection

url: 'postgres://tss:tss@tss-2-db:5432/tss?sslmode=disable'

## Port to listen for incoming GRPC requests

addr: :9000

## Core connections

addr: tcp://validator:26657

addr: validator:9090

## Session configuration (should be the same for all services across the system)

start_block: 100
start_session_id: 0

## Swagger doc configuration

addr: :1313
enabled: false

## Chain configuration

chain_id: 'rarimo_201411-1'
coin_name: 'urmo'
  1. Set up host environment:
  - name: KV_VIPER_FILE
value: /config/config.yaml # is the path to your config file
- name: VAULT_PATH
value: http://vault-internal:8200 # your vault endpoint
value: "" # your vault token ("root"/"read/write")
- name: MOUNT_PATH
value: secret
value: tss # name of the secret path vault (type KV version 2)
  1. To launch the service, use the following command.
tss-svc migrate up && tss-svc run service

Note that your TSS service should be accessible only using a secure TLS connection.

After some period, your TSS will generate new keys together with other active parties and become an active party.

Finishing with validator

Execute the command to stake tokens and become a validator. You need to stake exactly 1000000urmo, which is equal to 1 RMO.

rarimo-core tx staking create-validator
--amount 1000000urmo \
--commission-max-change-rate "0.01" \
--commission-max-rate "0.2" \
--commission-rate "0.1" \
--min-self-delegation "1" \
--details "Meet new Rarimo validator" \
--pubkey $(rarimo-core tendermint show-validator --home=$RARIMO_HOME) \
--moniker $MONIKER_NAME \
--chain-id rarimo_201411-1 \
--fees 0urmo \
--home=$RARIMO_HOME \
--node=$RARIMO_NODE \
--keyring-backend=test \

Congratulations, you are a Rarimo Mainnet validator!