# P2Pool Configuration File Example
# Copy this file to /var/lib/p2pool/params.conf and edit as needed
# Compatible with: p2pool v4.14+

# =============================================================================
# Monero Node Connection (REQUIRED)
# =============================================================================
# IP address or hostname of your Monero node
host = 127.0.0.1

# Monero RPC port
rpc-port = 18081

# Monero ZMQ port (required for optimal performance)
# v4.14+: ZMQ connections now support IPv6 addresses
zmq-port = 18083

# =============================================================================
# Wallet Configuration (REQUIRED)
# =============================================================================
# Your Monero wallet address - THIS IS REQUIRED
# Replace with your actual wallet address
wallet = YOUR_MONERO_WALLET_ADDRESS

# =============================================================================
# P2P Network Settings
# =============================================================================
# P2P bind address and port for P2Pool network communication
p2p = 0.0.0.0:37889

# Add known peer nodes (optional)
# addpeers = node1.p2pool.io:37889,node2.p2pool.io:37889

# HAProxy PROXY Protocol v2 for P2P connections (v4.14+)
# Enable ONLY if p2pool's P2P port is behind a proxy that sends PROXY Protocol
# v2 headers (e.g. HAProxy with "send-proxy-v2" directive).
# When enabled, the real client IP is extracted from the PROXY header and used
# for peer management, ban checks and logging — instead of the proxy's IP.
# P2P traffic is typically low-volume and usually does NOT need load balancing;
# leave commented out unless you have a specific reason to proxy P2P.
# Accepted values: none (default), v2
# p2p-proxy-protocol = none

# =============================================================================
# API Settings
# =============================================================================
# Directory for data API files
data-api = /var/lib/p2pool/data-api

# Enable local API (recommended for monitoring)
local-api = true

# =============================================================================
# Mining Mode
# =============================================================================
# Use mini sidechain for smaller miners (lower difficulty)
# Uncomment if your hashrate is less than 50 KH/s
# mini = true

# =============================================================================
# Stratum Server (for connecting miners)
# =============================================================================
# Enable stratum server for miners to connect
# Format: <bind_ip>:<port>
# stratum = 0.0.0.0:3333

# HAProxy PROXY Protocol v2 for Stratum connections (v4.14+)
# Enable ONLY if p2pool's Stratum port is behind a proxy that sends PROXY
# Protocol v2 headers (e.g. HAProxy with "send-proxy-v2" directive).
# When enabled, miners' real IP addresses are correctly extracted and shown
# in the `workers` command output, and per-IP ban/rate-limiting works properly.
# This is an open standard also supported by nginx, Traefik, AWS ELB, etc.;
# it is NOT tied to HAProxy specifically.
#
# ⚠️  TLV extensions (send-proxy-v2-ssl, send-proxy-v2-ssl-cn,
#     unique-id-format, crc32c) are silently ignored — only the address block
#     is read. Do NOT use exact addr_len checks in custom builds (spec §2.2
#     allows senders to append TLV vectors, increasing addr_len beyond the
#     base 12 / 36 bytes).
#
# Accepted values: none (default), v2
# stratum-proxy-protocol = none

# =============================================================================
# Merge Mining (Optional)
# =============================================================================
# Enable Tari merge mining
# Format: tari://<tari_node_ip>:<port> <tari_wallet_address>
# merge-mine = tari://127.0.0.1:18142 YOUR_TARI_WALLET_ADDRESS

# =============================================================================
# Logging
# =============================================================================
# Log file location
log-file = /var/log/p2pool/p2pool.log

# Log level (0 = none, 1 = fatal, 2 = error, 3 = warn, 4 = info, 5 = debug, 6 = trace)
loglevel = 3

# =============================================================================
# Performance Tuning (Advanced)
# =============================================================================
# in-peers = 10
# out-peers = 10

# =============================================================================
# Network Settings (Advanced)
# =============================================================================
# SOCKS5 proxy for outgoing connections
# socks5 = 127.0.0.1:9050

# SOCKS5 proxy type (v4.14+)
# Controls how p2pool treats the SOCKS5 proxy configured above.
# Accepted values:
#   auto  — auto-detect whether it is a plain proxy or Tor (default)
#   plain — treat as a standard SOCKS5 proxy (no Tor-specific behavior)
#   tor   — treat as a Tor SOCKS5 proxy (enables onion routing optimizations,
#            e.g. .onion peer resolution, correct onion connection counters)
# Only meaningful when `socks5` is set; ignored otherwise.
# socks5-proxy-type = auto