Operation
CLI Operator
An operator can submit assertions for node keys that they either own or have been approved to submit assertions for.
Before You Begin: Make sure to navigate to the directory where the CLI binary is located using the terminal. For example:
cd /path/to/your/cli-binary-directory
Submitting Assertions
Command to Run Guardian Software
This command will validate and submit assertions for all node keys that are approved or owned by the <guardian-private-key>
address:
Windows
.\guardian-cli-win-x64.exe guardian run <guardian-private-key>
macOS/Linux
./guardian-cli guardian run <guardian-private-key>
Claiming Rewards
To claim rewards for a list of node keys, use the following command. The signer private key can be for any wallet with sufficient native token (tXR) to pay the gas fees:
Windows
.\guardian-cli-win-x64.exe guardian claim-rewards <signer-private-key> --owned-keys
macOS/Linux
./guardian-cli guardian claim-multiple-rewards <signer-private-key> --owned-keys
Troubleshooting
Help Command
If you need assistance with the CLI commands, you can always refer to the built-in help command:
Windows
.\guardian-cli-win-x64.exe help guardian
macOS/Linux
./guardian-cli-linux-x64 help guardian
This will display a list of available commands and their usage.
Execution Permissions (Linux)
Linux
If you encounter a "missing execution permission" error when trying to run the CLI binary, you may need to adjust the file permissions. Use the following commands:
chmod +x guardian-cli-linux-x64
chmod +x validation-engine
This will grant execution permissions to the binary files, allowing you to run them without issues.
macOS
The app is not verified by apple publishing so users will need to use a workaround to run the CLI:
Initial Warning: Click the binary from Finder after unzipping. A warning should appear; click "OK."

Allow Anyway: Go to
System Preferences > Security & Privacy
and click "Allow Anyway."

Run Again: Click the binary again from Finder, and click "Open" when the warning reappears.

Last updated