celocli validatorgroup
View and manage Validator Groups
celocli validatorgroup:commissioncelocli validatorgroup:deregistercelocli validatorgroup:listcelocli validatorgroup:member ARG1celocli validatorgroup:registercelocli validatorgroup:reset-slashing-multiplier ARG1celocli validatorgroup:show ARG1
celocli validatorgroup:commission
Manage the commission for a registered Validator Group. This represents the share of the epoch rewards given to elected Validators that goes to the group they are a member of. Updates must be made in a two step process where the group owner first calls uses the queue-update option, then after the required update delay, the apply option. The commission update delay, in blocks, can be viewed with the network:parameters command. A groups next commission update block can be checked with validatorgroup:show
USAGE
$ celocli validatorgroup:commission --from <value> [--gasCurrency <value>] [--globalHelp]
[--apply | --queue-update <value>]
FLAGS
--apply Applies a previously queued
update. Should be called
after the update delay.
--from=0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d (required) Address for the
Validator Group or Validator
Group validator signer
--gasCurrency=0x1234567890123456789012345678901234567890 Use a specific gas currency
for transaction fees
(defaults to CELO if no gas
currency is supplied). It
must be a whitelisted token.
--globalHelp View all available global
flags
--queue-update=<value> Queues an update to the
commission, which can be
applied after the update
delay.
DESCRIPTION
Manage the commission for a registered Validator Group. This represents the share of
the epoch rewards given to elected Validators that goes to the group they are a member
of. Updates must be made in a two step process where the group owner first calls uses
the queue-update option, then after the required update delay, the apply option. The
commission update delay, in blocks, can be viewed with the network:parameters command.
A groups next commission update block can be checked with validatorgroup:show
EXAMPLES
commission --from 0x47e172F6CfB6c7D01C1574fa3E2Be7CC73269D95 --queue-update 0.1
commission --from 0x47e172F6CfB6c7D01C1574fa3E2Be7CC73269D95 --apply
See code: src/commands/validatorgroup/commission.ts
celocli validatorgroup:deregister
Deregister a Validator Group. Approximately 180 days after the validator group is empty, it will be possible to deregister it start unlocking the CELO. If you wish to deregister your validator group, you must first remove all members, then wait the required 180 days before running this command.
USAGE
$ celocli validatorgroup:deregister --from <value> [--gasCurrency <value>]
[--globalHelp]
FLAGS
--from=0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d (required) Signer or
ValidatorGroup's address
--gasCurrency=0x1234567890123456789012345678901234567890 Use a specific gas currency
for transaction fees
(defaults to CELO if no gas
currency is supplied). It
must be a whitelisted token.
--globalHelp View all available global
flags
DESCRIPTION
Deregister a Validator Group. Approximately 180 days after the validator group is
empty, it will be possible to deregister it start unlocking the CELO. If you wish to
deregister your validator group, you must first remove all members, then wait the
required 180 days before running this command.
EXAMPLES
deregister --from 0x47e172f6cfb6c7d01c1574fa3e2be7cc73269d95
See code: src/commands/validatorgroup/deregister.ts
celocli validatorgroup:list
List registered Validator Groups, their names (if provided), commission, and members.
USAGE
$ celocli validatorgroup:list [--gasCurrency <value>] [--globalHelp] [--columns <value>
| -x] [--filter <value>] [--no-header | [--csv | --no-truncate]] [--output
csv|json|yaml | | ] [--sort <value>]
FLAGS
-x, --extended
show extra columns
--columns=<value>
only show provided columns (comma-separated)
--csv
output is csv format [alias: --output=csv]
--filter=<value>
filter property by partial string matching, ex: name=foo
--gasCurrency=0x1234567890123456789012345678901234567890
Use a specific gas currency for transaction fees (defaults to CELO if no gas
currency is supplied). It must be a whitelisted token.
--globalHelp
View all available global flags
--no-header
hide table header from output
--no-truncate
do not truncate output to fit screen
--output=<option>
output in a more machine friendly format
<options: csv|json|yaml>
--sort=<value>
property to sort by (prepend '-' for descending)
DESCRIPTION
List registered Validator Groups, their names (if provided), commission, and members.
EXAMPLES
list
See code: src/commands/validatorgroup/list.ts
celocli validatorgroup:member ARG1
Add or remove members from a Validator Group
USAGE
$ celocli validatorgroup:member ARG1 --from <value> [--gasCurrency <value>]
[--globalHelp] [--yes] [--accept | --remove | --reorder <value>]
ARGUMENTS
ARG1 Validator's address
FLAGS
--accept Accept a validator whose
affiliation is already set
to the group
--from=0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d (required) ValidatorGroup's
address
--gasCurrency=0x1234567890123456789012345678901234567890 Use a specific gas currency
for transaction fees
(defaults to CELO if no gas
currency is supplied). It
must be a whitelisted token.
--globalHelp View all available global
flags
--remove Remove a validator from the
members list
--reorder=<value> Reorder a validator within
the members list. Indices
are 0 based
--yes Answer yes to prompt
DESCRIPTION
Add or remove members from a Validator Group
EXAMPLES
member --from 0x47e172f6cfb6c7d01c1574fa3e2be7cc73269d95 --accept 0x97f7333c51897469e8d98e7af8653aab468050a3
member --from 0x47e172f6cfb6c7d01c1574fa3e2be7cc73269d95 --remove 0x97f7333c51897469e8d98e7af8653aab468050a3
member --from 0x47e172f6cfb6c7d01c1574fa3e2be7cc73269d95 --reorder 3 0x47e172f6cfb6c7d01c1574fa3e2be7cc73269d95
See code: src/commands/validatorgroup/member.ts
celocli validatorgroup:register
Register a new Validator Group
USAGE
$ celocli validatorgroup:register --from <value> --commission <value> [--gasCurrency
<value>] [--globalHelp] [--yes]
FLAGS
--commission=<value> (required) The share of the
epoch rewards given to
elected Validators that goes
to the group.
--from=0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d (required) Address for the
Validator Group
--gasCurrency=0x1234567890123456789012345678901234567890 Use a specific gas currency
for transaction fees
(defaults to CELO if no gas
currency is supplied). It
must be a whitelisted token.
--globalHelp View all available global
flags
--yes Answer yes to prompt
DESCRIPTION
Register a new Validator Group
EXAMPLES
register --from 0x47e172F6CfB6c7D01C1574fa3E2Be7CC73269D95 --commission 0.1
See code: src/commands/validatorgroup/register.ts
celocli validatorgroup:reset-slashing-multiplier ARG1
Reset validator group slashing multiplier.
USAGE
$ celocli validatorgroup:reset-slashing-multiplier ARG1 [--gasCurrency <value>]
[--globalHelp]
ARGUMENTS
ARG1 ValidatorGroup's address
FLAGS
--gasCurrency=0x1234567890123456789012345678901234567890 Use a specific gas currency
for transaction fees
(defaults to CELO if no gas
currency is supplied). It
must be a whitelisted token.
--globalHelp View all available global
flags
DESCRIPTION
Reset validator group slashing multiplier.
EXAMPLES
reset-slashing-multiplier 0x97f7333c51897469E8D98E7af8653aAb468050a3
See code: src/commands/validatorgroup/reset-slashing-multiplier.ts
celocli validatorgroup:show ARG1
Show information about an existing Validator Group
USAGE
$ celocli validatorgroup:show ARG1 [--gasCurrency <value>] [--globalHelp]
ARGUMENTS
ARG1 ValidatorGroup's address
FLAGS
--gasCurrency=0x1234567890123456789012345678901234567890 Use a specific gas currency
for transaction fees
(defaults to CELO if no gas
currency is supplied). It
must be a whitelisted token.
--globalHelp View all available global
flags
DESCRIPTION
Show information about an existing Validator Group
EXAMPLES
show 0x97f7333c51897469E8D98E7af8653aAb468050a3
See code: src/commands/validatorgroup/show.ts