ansible-role-monero
===================

Deploys a Monero node (monerod) and a P2Pool node to Kubernetes, in the
`monero` namespace. Miners point xmrig at the P2Pool service on port 3333.

Role Variables
--------------

Required, from Vault:

- `monerod_user`, `monerod_password`: monerod's RPC login. Stored in the
  `monerod-rpc` Secret and passed to both containers through an environment
  variable, so it doesn't show in the Deployment specs.
- `monero_p2pool_wallet_address`: the address P2Pool pays out to.

Optional:

- `monero_p2pool_chain` (default `nano`): `main`, `mini` or `nano`. Match it
  to your total hashrate; see the note in `defaults/main.yml`. Switching
  chains starts from zero shares on the new chain, and shares on the old one
  stop earning once they leave its PPLNS window.
- `monero_p2pool_addpeers` (default `[]`): extra P2Pool peers as `host:port`.
  They must be on the same chain.
- `monero_p2pool_stats_host` (default `www.eom.dev`): website host that gets
  the public `/p2pool/stats.json` path. Use `""` to keep stats internal.
- `monero_p2pool_stats_ingress_class` (default `nginx`), `monero_p2pool_stats_image`
  (default `python:3.13-alpine`).

Public stats
------------

P2Pool runs with `--data-api /api --local-api`. Those files include miner IP
addresses, so they are never served. A `stats` sidecar
(`files/p2pool_stats.py`, standard library only) copies an allowlist of numeric
fields into one JSON document:

    {"sidechain": "nano",
     "node":    {"hashrate_15m", "hashrate_1h", "hashrate_24h", "miners",
                 "shares_found", "shares_failed", "current_effort",
                 "average_effort", "reward_share_percent",
                 "last_share_found_time", "updated_at", "stale"},
     "pool":    {"hashrate", "miners", "difficulty", "height", "blocks_found",
                 "last_block_found_time", "pplns_window", "updated_at", "stale"},
     "network": {"hashrate", "difficulty", "height", "reward_xmr",
                 "updated_at", "stale"}}

`node` is this P2Pool instance (everyone mining through it); `pool` is the
whole sidechain. Sections are `null` until P2Pool writes them, and the
endpoint answers 503 until `node` exists. Run the sidecar's tests with
`python3 -m unittest discover -s tests`.

Example Playbook
----------------

    - hosts: alpha-control-plane
      become: true
      vars_files:
        - ../secrets.yaml
      roles:
        - role: ericomeehan.monero

License
-------

MIT-0