The Mining Lab / Mining fundamentals

Stratum mining connections: a practical protocol field guide

Understand mining pool connection layers, Stratum compatibility, worker identities, failover, and submission monitoring.

BETTER POOL CONNECTIONS. — original Mining fundamentals feature graphic

A mining pool connection is more than a hostname in a configuration screen. It is a relationship among a device, a protocol implementation, an operator, and an accounting system. Understanding that relationship helps explain why a connected machine may not be submitting useful work, why a proxy changes the troubleshooting path, and why protocol support must be checked end to end.

This guide focuses on a practical evaluation and observation method. It does not recommend a particular pool or claim that changing protocols will produce a specific revenue improvement. The goal is to turn a vague “connection problem” into a set of questions that can be investigated with evidence.

Separate transport, protocol, and accounting

A network transport carries messages. A mining protocol defines how participants communicate work and submissions. A pool's accounting policy determines how eligible activity is handled for payment. These layers interact, but a success at one layer does not prove success at the others.

For example, a reachable endpoint only establishes limited network information. A successful protocol session may still have authorization or job-related issues later. Accepted work still needs to be interpreted according to the provider's documented accounting rules. Put each layer in its own section of your operating notes so a dashboard label such as “connected” does not become an unsupported claim about payout eligibility.

Understand what Stratum V2 defines

The Stratum V2 protocol overview describes a mining communication architecture with distinct protocol components and message structures. When evaluating an implementation, identify which components are actually supported. A broad “V2” label is not a substitute for documenting the device, proxy, upstream endpoint, and optional capabilities involved in your specific path.

Treat protocol selection as an interoperability project. Record software and firmware versions, the supported configuration, and any translation step. Keep optional features separate from baseline connectivity. The integrations overview on SiliconMining.com uses this same approach: named technologies are learning references, not a claim that the website operates certified connectors or partnerships.

Draw the actual connection path

A direct device-to-pool connection and a device-to-proxy-to-pool connection have different failure boundaries. Draw each hop, then record its owner and the evidence available from it. Include name resolution, network access controls, time synchronization where relevant, and the locations of configuration files or management interfaces.

Do not put secrets into the diagram. Use references to an approved secret store or configuration inventory instead. The diagram should help an authorized operator find information, not become a convenient package of credentials. Keep a version history when the path changes, especially when a proxy or alternate upstream is introduced.

Verify support before switching

Read the official documentation for the exact firmware, proxy, and pool endpoint you intend to use. Confirm supported protocol versions and any required configuration. Do not infer compatibility from a brand name, a forum screenshot, or support for a similarly named product. Preserve a copy or reference to the documentation used for the decision.

Define a small pilot before moving a fleet. Keep the previous working configuration available, identify who can restore it, and establish a clear stopping condition. A migration should be reversible under the responsible operator's procedures. Avoid changing several independent parts of the connection path simultaneously; doing so makes a failed test harder to interpret.

Keep worker identity unambiguous

Distinguish the physical device identity from the configured pool worker name and the identity used by a monitoring collector. If a machine is replaced but inherits a label, its hardware history should not silently merge with the old device's history. Conversely, moving a device between locations should not erase its identity.

Document how an upstream system groups workers and how your own inventory maps to those groups. Use stable internal identifiers in telemetry and retain friendly names for display. The sample API contract demonstrates a worker record that keeps identity, state, and measured fields explicit. It intentionally contains no real pool credentials or payout information.

Observe submissions over compatible windows

A connection investigation needs timestamps, session events, job-related information where supported, and submission outcomes. Compare these over the same observation interval. A one-minute local hashrate snapshot and a much longer pool estimate should not be expected to match point for point.

Keep rejection categories as supplied by the implementation rather than collapsing everything into one unexplained failure count. Record whether counters reset on reconnect or restart. When the meaning of a field is undocumented, mark it as unresolved instead of inventing a definition. Our monitoring guide explains how data dictionaries make these comparisons more reliable.

Investigate latency without jumping to causes

A delay can occur at several places in the path: local scheduling, a proxy queue, transport, upstream processing, or the measurement pipeline itself. A chart showing simultaneous events may suggest a hypothesis, but it does not identify the cause on its own. Preserve the clock and collection context before interpreting timing differences.

For a controlled test, change one documented condition at a time and record the expected observation. Avoid broad claims that a particular protocol or provider eliminates all stale work. The appropriate conclusion is narrower: what changed in your tested configuration, over which interval, under which conditions, and with what unresolved uncertainties.

Plan failover as an operational policy

An alternate endpoint is not a complete failover plan. Decide which failures trigger a switch, how long a condition must persist, how worker identities are preserved, and when returning to the primary endpoint is appropriate. Verify that the implementation's behavior matches your policy instead of assuming a familiar label implies familiar semantics.

Consider how the change affects monitoring and accounting reconciliation. A worker may continue operating while its activity is split across providers or endpoints. Record the transition as an event so later reviews can follow the work. Test recovery in a controlled setting before relying on it during an outage, using authorized configurations and the relevant provider requirements.

Protect the management plane

The configuration that chooses upstream endpoints and identities deserves stronger protection than a public read-only chart. Keep management interfaces restricted and separate monitoring credentials from control permissions where the equipment supports that distinction. A convenience feature should not make it easy for a dashboard reader to alter operational settings.

Maintain an audit record for authorized changes. Include who approved the change, its scope, and the outcome of the post-change check. Do not record secret values in the audit message. The secure mining APIs guide develops a similar separation between observing a worker and issuing privileged operations against it.

Reconcile protocol observations with provider records

After a pilot, compare your local observations with the provider's documented reports for the same interval. Account for different averaging windows and any reporting delay. Keep observed work, eligible work, account balances, and completed payments in separate categories. None should be substituted for another merely to make the totals look consistent.

List unresolved differences and the evidence needed to investigate them. A provider support request is more useful when it includes a bounded interval, relevant non-secret identifiers, and a concise description of the mismatch. Do not send raw configuration files without reviewing them for credentials and private infrastructure details.

Leave behind a connection runbook

Your final runbook should contain a sanitized connection diagram, version inventory, compatibility references, baseline observations, switchback procedure, and reconciliation method. Include a small set of known failure examples so another operator can recognize the difference between network reachability, session failure, rejected submissions, and stale monitoring data.

A protocol upgrade is valuable when its behavior is understood in the actual operating path. Begin with compatibility, preserve clear identities, and measure the layers separately. That approach makes both routine operation and future migrations easier to reason about without relying on a single green “connected” indicator.

Continue exploring: Mining fundamentals · Suggest a correction