# Xeomora CLI/operator — Windows

This package is for advanced users and operators of the controlled Xeomora public testnet.

The testnet is experimental and has no financial value. Test coins do not represent withdrawals, investment, exchange listing promises, or mainnet participation.

## Package contents

- `bin/xeomora-node.exe`: P2P node.
- `bin/xeomora-pool.exe`: pool for controlled operation.
- `bin/xeomora-miner.exe`: official CLI miner.
- `bin/xeomora-keygen.exe`: local testnet address generator.
- `certs/xeomora-stratum-ca.pem`: public CA for Stratum TLS.
- `manuals/README-PT.md`: Portuguese manual.
- `manuals/README-EN.md`: this manual.
- `SHA256SUMS.txt`: SHA-256 hashes for the internal files.

## Verify the download

Verify the ZIP SHA-256 on the official website.

After extracting:

```powershell
Get-Content .\SHA256SUMS.txt
Get-FileHash -Algorithm SHA256 .\bin\xeomora-node.exe
Get-FileHash -Algorithm SHA256 .\bin\xeomora-pool.exe
Get-FileHash -Algorithm SHA256 .\bin\xeomora-miner.exe
Get-FileHash -Algorithm SHA256 .\bin\xeomora-keygen.exe
Get-FileHash -Algorithm SHA256 .\certs\xeomora-stratum-ca.pem
```

Compare the results with `SHA256SUMS.txt`.

## Generate a testnet address

```powershell
$keygenOutput = .\bin\xeomora-keygen.exe testnet
$keygenOutput
$env:XEOMORA_WALLET = ($keygenOutput | Select-String '^ADDRESS_TXEO1P=').Line.Split('=')[1]
```

The private key printed by the command is secret. Do not send it to anyone and do not publish it in logs.

Use only a `txeo1p...` address on the testnet.

## Start a node

```powershell
$env:XEOMORA_DATA = Join-Path $env:LOCALAPPDATA "Xeomora\xeomora-v1"
New-Item -ItemType Directory -Force -Path $env:XEOMORA_DATA

.\bin\xeomora-node.exe `
  --chain-id xeomora-v1 `
  --data-dir $env:XEOMORA_DATA `
  --p2p-listen "/ip4/0.0.0.0/tcp/30333" `
  --bootstrap "/ip4/13.140.168.232/tcp/30333/p2p/12D3KooWMHa8zM6iwo9HdLSZkZtC4ExPPsq4Qb4kdWHLhJCpcR5L"
```

Do not expose raw RPC publicly.

## Mine through the official pool

```powershell
.\bin\xeomora-miner.exe `
  --mode pool `
  --chain-id xeomora-v1 `
  --tier 2 `
  --experimental-tier-dataset-size `
  --threads 1 `
  --pool xeomora.org:3333 `
  --pool-tls `
  --pool-tls-server-name xeomora.org `
  --pool-tls-ca-cert ".\certs\xeomora-stratum-ca.pem" `
  --wallet $env:XEOMORA_WALLET `
  --worker "rig01"
```

TLS is required for the public pool.

## Safety

- Do not use mainnet.
- Do not share a private key.
- Do not disable TLS.
- Do not expose raw RPC to the internet.
- Do not expose pool HTTP/admin publicly.
- Do not publish sensitive logs.

## Stop processes

Close the terminals or use `Ctrl+C`. To check:

```powershell
Get-Process xeomora-node,xeomora-pool,xeomora-miner -ErrorAction SilentlyContinue
```
