firedancer Command Line Interface
The Firedancer binary firedancer contains many subcommands which can be run from the command line. firedancer also supports subcommands from the fdctl binary.
WARNING
There is no stable release for the firedancer binary. Run the client and use these commands at your own risk.
add-authorized-voter
Adds an authorized voter to the running validator. The <keypair> argument is required and must be the path to an Agave style voter.json keypair file. If the path is specified as - the key will instead be read from stdin.
WARNING
add-authorized-voter is only supported with firedancer and not fdctl. In other words, the command is only supported while running the full client validator and not Frankendancer.
WARNING
add-authorized-voter must be called with the configuration file you started the validator with, like firedancer add-authorized-voter --config <config.toml>, if the config argument is not provided, the command may not add the authorized voter key on all tiles and your validator may produce invalid votes.
It is not generally safe to call add-authorized-voter, as another validator might be running with the same authorized voter and vote account. If they both vote concurrently, the validator may violate consensus and be subject to (future) slashing.
It is safe to call the command while the validator is running and voting as the client guarantees that votes will not be produced with the new authorized voter key until the key has been gracefully added to the running validator.
The command exits successfully (with an exit code of 0) if the authorized voter was added, otherwise it will fail and print diagnostic messages to stderr. Reasons for failure include the validator being unable to load or verify the provided authorized voter key, if the provided key is a duplicate that the validator is already using, or if there are too many authorized voters for the running validator (more than 16).
| Arguments | Description |
|---|---|
<keypair> | Path to a voter.json keypair file, or - to read the JSON formatted key from stdin |
--config <path> | Path to a configuration TOML file of the validator to add an authorized voter for. This must be the same configuration file the validator was started with |
$ sudo firedancer add-authorized-voter --config ~/config.toml ~/keys/validator-keypair.json
NOTICE Authorized voter key added `4UCZB7zfquCVN7GafWETFVLTceNH3nm2mndyHeDuSggC`