> For the complete documentation index, see [llms.txt](https://xr-one.gitbook.io/xr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://xr-one.gitbook.io/xr/guides/hero-nodes/operators-manual/operation.md).

# 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:

```bash
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

```bash
.\guardian-cli-win-x64.exe guardian run <guardian-private-key>
```

#### macOS/Linux

```bash
./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

```bash
.\guardian-cli-win-x64.exe guardian claim-rewards <signer-private-key> --owned-keys
```

#### macOS/Linux

```bash
./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

```bash
.\guardian-cli-win-x64.exe help guardian
```

#### macOS/Linux

```bash
./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:

```bash
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:&#x20;

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

<figure><img src="https://454180389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMazZlzD0ZHqCFq8FXflR%2Fuploads%2FEbe9yknwUwYLhS21xI8T%2FMacOSWarning.jpeg?alt=media&amp;token=9a5a438b-4c47-4705-9098-db68d05204ff" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://454180389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMazZlzD0ZHqCFq8FXflR%2Fuploads%2FI2gmvOxf1Fld5zLbJI7R%2FMacOSAppSettings.jpeg?alt=media&amp;token=2cb67ce2-0c0b-4e20-8114-6bfff61725ee" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://454180389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMazZlzD0ZHqCFq8FXflR%2Fuploads%2FsvBcZiWUIo4rdAv3zXlz%2FMacOsAllowBinary.jpeg?alt=media&amp;token=e59cd755-35b4-478f-bda9-8a5659c8fb7e" alt=""><figcaption></figcaption></figure>