HashRelay

Core Features

Built for professional mining operations — secure, scalable, and zero-downtime

F1

Full Traffic Encrypted Tunnel

Pain Point

Mining traffic transmitted in plaintext over complex networks is easily identified, throttled, and blocked by ISPs. Traffic sniffing and hashrate hijacking are real threats.

Solution

HashRelay inserts an encryption layer between miners and pools. The client encapsulates Stratum traffic in TLS 1.3 or QUIC tunnels before forwarding to the relay server. ISPs only see encrypted HTTPS/QUIC data.

Technical Highlights

  • 1TLS 1.3 certificate mode (recommended for production)
  • 2TCP + AES-256-GCM for no-certificate environments
  • 3TCP + ChaCha20-Poly1305 for low-end CPUs without AES acceleration
  • 4QUIC for cross-border weak networks (lowest latency)
F2

Multi-Pool Multi-Coin Parallel Forwarding

Pain Point

Traditional mining farms running multiple coins must maintain separate proxies per coin — complex management, chaotic port assignments, and difficult troubleshooting.

Solution

Static port mappings allow one HashRelay instance to forward multiple coins to different pools simultaneously. Port 3333 → BTC pool, port 4444 → ETH pool. Miners don't change anything.

Technical Highlights

  • 1Protocol-agnostic transparent forwarding for any Stratum-based coin
  • 2Each mapping independently configured with pool address and aggregation settings
  • 3Config changes pushed to clients in real time, no restart needed
  • 4Per-pool Stratum parsing can be enabled or disabled independently
F3

Request Aggregation

Pain Point

Large farms with thousands of miners each opening separate tunnel connections consume massive bandwidth and server resources — and risk triggering pool connection bans.

Solution

The built-in Aggregation Engine parses Stratum protocol client-side and merges thousands of miner requests into just a few upstream connections. 1,000 miners → 2 connections.

Technical Highlights

  • 1Supports Stratum V1, V1-Ethash, and Stratum V2
  • 2miners_per_conn controls ratio; default 500 miners/connection, auto-scaling
  • 3extranonce2 space partitioning ensures each miner has a unique search space
  • 4JSON-RPC ID remapping prevents concurrent request ID collisions
F4

Real-time Hashrate Monitoring & Alerts

Pain Point

Farm operators lack immediate awareness: a miner offline for hours before discovery, reject rate anomalies requiring manual pool login to check, no automatic hashrate drop alerts.

Solution

Protocol mirror analysis extracts Stratum data asynchronously alongside the forwarding pipeline — no impact on forwarding latency. Real-time hashrate calculation and anomaly detection.

Technical Highlights

  • 1Disconnect alert: second-level response
  • 2High reject rate: triggers at ≥30% rejection (min 10 shares)
  • 3Hashrate drop: sliding window estimation
  • 4Supports Email, Telegram, and Webhook notifications
F5

Dynamic Config Hot Push

Pain Point

Traditional proxies require a service restart for every pool config change, causing brief miner disconnections — catastrophic at scale.

Solution

Admin changes mappings via dashboard or API; the server records the change in a database transaction and immediately pushes to the relevant client nodes via persistent connection. Miners feel nothing.

Technical Highlights

  • 1Push event types: CREATED, UPDATED, ENABLED, DISABLED, DELETED
  • 2Client hot-updates local listeners, no restart required
  • 3Atomic database + push ensures consistency
  • 4Changes take effect in under one second
F6

TCP + QUIC Dual Protocol

Pain Point

High packet loss on cross-border links causes TCP throughput to collapse. But some networks block UDP, making QUIC unavailable. No single protocol suits all environments.

Solution

HashRelay simultaneously listens on TCP and QUIC. Choose your protocol in the config file based on actual network conditions. Both are production-ready and switchable on the fly.

Technical Highlights

  • 1QUIC: best for cross-border/weak networks — low latency, packet-loss tolerant
  • 2TCP + TLS cert: best compatibility for stable datacenter networks
  • 3TCP + ChaCha20: best for no-cert internal networks with low-end CPUs
  • 4Both protocols active simultaneously; clients choose per deployment
F7

Smart Auto-Reconnect

Pain Point

Network fluctuations break connections and force miners to pause — losing hashrate revenue.

Solution

The client has built-in unlimited reconnect with a default 5-second interval. The local Stratum listener stays alive during reconnect. Miners experience zero interruption.

Technical Highlights

  • 1Heartbeat: 60s Ping/Pong intervals
  • 23 consecutive missed heartbeats (~180s) triggers reconnect
  • 3Miners continue submitting shares to the local port during tunnel recovery
  • 4Minimizes hashrate loss during network instability
F8

Management API

Pain Point

Manual operation at scale is error-prone and slow. Teams need programmatic control over pool configs, mappings, and statistics.

Solution

A full RESTful JSON API at /api/v1/ enables scripting, CI/CD pipeline integration, and third-party system automation to manage all HashRelay resources.

Technical Highlights

  • 1Pool management: CRUD operations
  • 2Port mapping management with live status
  • 3Client node management and token generation
  • 4Statistics and alert event endpoints