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:

1. Initial Warning: Click the binary from Finder after unzipping. A warning should appear; click "OK."

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

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