# Minero CLI — Windows y Ubuntu

Necesitas el minero Fenrune RX1 actual, tu **dirección pública FNRN** y el **host y puerto Stratum de una pool compatible**, de la misma red que tu wallet. El minero incluye sus motores RX1 y RX0: extrae el paquete completo.

Descargas: <https://fenrune.com/>. Versiones y estado de publicación: [README](README.md). La conexión de ejemplo `POOL_FENRUNE:PUERTO` debe sustituirse por una pool real anunciada; no hay una pool pública verificada en estas instrucciones.

## 1. Preparar la configuración

En Windows, extrae `fenrune-xmrig-0.3.0-windows-x64.zip`, abre PowerShell en la carpeta que contiene `xmrig.exe` y ejecuta:

```powershell
Copy-Item .\fenrune.example.json .\fenrune.json
notepad .\fenrune.json
```

En Ubuntu, extrae `fenrune-xmrig-0.3.0-ubuntu-x64.zip`, abre una terminal en la carpeta que contiene `xmrig` y ejecuta:

```bash
cp fenrune.example.json fenrune.json
nano fenrune.json
```

Modifica estos campos del archivo; conserva el resto de su contenido:

```json
"fenrune-url": "POOL_FENRUNE:PUERTO",
"fenrune-user": "TU_DIRECCION_FNRN.casa",
"fenrune-max-cpu-usage": 25,
"fenrune-mode": "fast"
```

Este fragmento forma parte del archivo JSON; no es un comando ni un archivo completo. También puedes usar el archivo completo `ejemplos/fenrune.json` incluido con estas guías.

- `fenrune-url`: host y puerto Stratum Bitcoin de la pool RX1. Acepta `host:puerto` o `stratum+tcp://host:puerto`.
- `fenrune-user`: tu dirección pública; `.casa` identifica el equipo si la pool admite el formato `direccion.worker`. Sigue el formato publicado por el operador.
- `fenrune-max-cpu-usage`: presupuesto orientativo de CPU. El ejemplo empieza con 25 %.
- `fenrune-mode`: `fast`, unos 2,3 GB para el dataset RX1; `light`, unos 256 MB y menor rendimiento. El proceso, la ruta adicional y el fee pueden necesitar más RAM.

Para minar solo Fenrune, conserva `"enabled": false` dentro del objeto `cpu` y `"pools": []`, tal como están en el ejemplo de una moneda. La ruta Fenrune tiene su propio ajuste de CPU.

No uses una URL HTTP de explorer/API, el puerto RPC del daemon ni `fee.fenrune.com:3333` como pool principal FNRN. Esta ruta necesita Stratum Bitcoin en TCP; no admite Stratum TLS.

## 2. Iniciar

Windows:

```powershell
.\xmrig.exe --config=fenrune.json
```

Ubuntu:

```bash
chmod +x xmrig start-fenrune.sh
./start-fenrune.sh
```

El script Ubuntu carga `fenrune.json` desde su propia carpeta. Conserva las bibliotecas incluidas junto al ejecutable. Espera la conexión, la preparación de memoria, el hashrate y la aceptación de trabajo por la pool. La dificultad de shares influye en cuánto tarda en aparecer la primera aceptación.

Puedes cerrar la sesión con `Ctrl+C`. No es necesario dejar abierta la wallet para minar en una pool; sí necesitas conservar su recuperación y consultar los pagos del operador.

## 3. Dos monedas en el mismo proceso — opcional

Usa `dual.example.json` como base de `fenrune.json`, en lugar del ejemplo de una sola moneda. En Windows:

```powershell
Copy-Item .\dual.example.json .\fenrune.json
notepad .\fenrune.json
```

En Ubuntu:

```bash
cp dual.example.json fenrune.json
nano fenrune.json
```

Completa los campos de Fenrune y los de la otra pool dentro de `pools`. Para Monero, el ejemplo usa `"algo": "rx/0"`; introduce una dirección XMR y una pool XMR reales. Para otra moneda, elige el algoritmo que realmente use su pool y que admita este minero.

Un reparto de ejemplo es 25 % para Fenrune (`fenrune-max-cpu-usage`) y 25 % para la segunda moneda (`cpu.max-threads-hint`), con `cpu.enabled` en `true`. La suma de presupuestos debe ser como máximo 100 %. Son orientativos, no un límite exacto de uso del sistema.

Arranca con el mismo comando del paso 2: las dos rutas trabajan en **un único proceso**. Hay un archivo completo en `ejemplos/dual.json`. No pongas `rx/0` en lugar del algoritmo Fenrune RX1.

## 4. Shares, pagos y aportación

Una share aceptada confirma trabajo aceptado por la pool. El saldo, mínimo de cobro, método de pago y comisión dependen del operador; consúltalos en su página usando tu dirección pública. Un candidato a bloque solo se confirma como bloque aceptado al comprobarlo en el nodo/explorer.

El minero programa 59 minutos normales y 1 minuto para el proxy de aportación por hora y ruta activa, aproximadamente el 1,67 % del tiempo. Usa RandomX estándar; la comisión de la pool se aplica aparte. Si el proxy está fuera de servicio, continúa el trabajo normal. [Estado y política de donaciones](README.md#aportaciones-y-donaciones).

## Si no funciona

| Mensaje o síntoma | Comprobar |
|---|---|
| No conecta | Host, puerto, red, pool encendida y endpoint Stratum TCP RX1. |
| Login/dirección rechazados | Dirección de la red correcta y formato de worker exigido por la pool. |
| Faltan DLL/SO | Volver a extraer el paquete completo, manteniendo sus motores junto al ejecutable. |
| Fallo al crear dataset | RAM libre suficiente; reducir la segunda ruta o probar `light`. |
| Shares rechazadas | Compatibilidad RX1 de pool/minero y motivo exacto del rechazo. |
| Shares aceptadas pero saldo cero en wallet | Consultar primero saldo, madurez y mínimo de pago de la pool. |
