The complete documentation for the Stratum v2 Protocol Specification are located on Github (opens new window).

Authors

Pavel Moravec pavel@braiins.com
Jan Čapek jan@braiins.com
Matt Corallo bipstratum@bluematt.me

The Stratum V2 Protocol

• 0. Abstract (opens new window)
• 1. Motivation (opens new window)
• 2. Design Goals (opens new window)
• 3. Protocol Overview (opens new window)
  • 3.1 Data Types Mapping (opens new window)
  • 3.2 Framing (opens new window)
  • 3.3 Protocol Security (opens new window)
    • 3.3.1 Motivation for Authenticated Encryption with Associated Data (opens new window)
    • 3.3.2 Motivation for Using the Noise Protocol Framework (opens new window)
    • 3.3.3 Authenticated Key Agreement Handshake (opens new window)
    • 3.3.4 Signature Noise Message (opens new window)
    • 3.3.5 Certificate Format (opens new window)
    • 3.3.6 URL Scheme and Pool Authority Key (opens new window)
  • 3.4 Reconnecting Downstream Nodes (opens new window)
  • 3.5 Protocol Extensions (opens new window)
  • 3.6 Error Codes (opens new window)
  • 3.7 Common Protocol Messages (opens new window)
    • 3.7.1 SetupConnection (Client -> Server) (opens new window)
    • 3.7.2 SetupConnection.Success (Server -> Client) (opens new window)
    • 3.7.3 SetupConnection.Error (Server -> Client) (opens new window)
    • 3.7.4 ChannelEndpointChanged (Server -> Client) (opens new window)
• 4. Mining Protocol (opens new window)
  • 4.1 Channels (opens new window)
    • 4.1.1 Standard Channels (opens new window)
    • 4.1.2 Extended Channels (opens new window)
    • 4.1.3 Group Channels (opens new window)
    • 4.1.4 Future Jobs (opens new window)
  • 4.2 Hashing Space Distribution (opens new window)
  • 4.3 Mining Protocol Messages (opens new window)
    • 4.3.1 SetupConnection Flags for Mining Protocol (opens new window)
    • 4.3.2 OpenStandardMiningChannel (Client -> Server) (opens new window)
    • 4.3.3 OpenStandardMiningChannel.Success (Server -> Client) (opens new window)
    • 4.3.4 OpenExtendedMiningChannel (Client -> Server) (opens new window)
    • 4.3.5 OpenExtendedMiningChannel.Success (Server -> Client) (opens new window)
    • 4.3.6 OpenMiningChannel.Error (Server -> Client) (opens new window)
    • 4.3.7 UpdateChannel (Client -> Server) (opens new window)
    • 4.3.8 UpdateChannel.Error (Server -> Client) (opens new window)
    • 4.3.9 CloseChannel (Client -> Server, Server -> Client) (opens new window)
    • 4.3.10 SetExtranoncePrefix (Server -> Client) (opens new window)
    • 4.3.11 SubmitSharesStandard (Client -> Server) (opens new window)
    • 4.3.12 SubmitSharesExtended (Client -> Server) (opens new window)
    • 4.3.13 SubmitShares.Success (Server -> Client) (opens new window)
    • 4.3.14 SubmitShares.Error (Server -> Client) (opens new window)
    • 4.3.15 NewMiningJob (Server -> Client) (opens new window)
    • 4.3.16 NewExtendedMiningJob (Server -> Client) (opens new window)
    • 4.3.17 SetNewPrevHash (Server -> Client, broadcast) (opens new window)
    • 4.3.18 SetCustomMiningJob (Client -> Server) (opens new window)
    • 4.3.19 SetCustomMiningJob.Success (Server -> Client) (opens new window)
    • 4.3.20 SetCustomMiningJob.Error (Server -> Client) (opens new window)
    • 4.3.21 SetTarget (Server -> Client) (opens new window)
    • 4.3.22 Reconnect (Server -> Client) (opens new window)
    • 4.3.23 SetGroupChannel (Server -> Client) (opens new window)
• 5. Job Negotiation Protocol (opens new window)
  • 5.1 Job Negotiation Protocol Messages (opens new window)
    • 5.1.1 SetupConnection Flags for Job Negotiation Protocol (opens new window)
    • 5.1.2 AllocateMiningJobToken (Client -> Server) (opens new window)
    • 5.1.3 AllocateMiningJobToken.Success (Server -> Client) (opens new window)
    • 5.1.4 CommitMiningJob (Client -> Server) (opens new window)
    • 5.1.5 CommitMiningJob.Success (Server -> Client) (opens new window)
    • 5.1.6 CommitMiningJob.Error (Server->Client) (opens new window)
    • 5.1.7 IdentifyTransactions (Server->Client) (opens new window)
    • 5.1.8 IdentifyTransactions.Success (Client->Server) (opens new window)
    • 5.1.9 ProvideMissingTransactions (Server->Client) (opens new window)
    • 5.1.10 ProvideMissingTransactions.Success (Client->Server) (opens new window)
• 6. Template Distribution Protocol (opens new window)
  • 6.1 CoinbaseOutputDataSize (Client -> Server) (opens new window)
  • 6.2 NewTemplate (Server -> Client) (opens new window)
  • 6.3 SetNewPrevHash (Server -> Client) (opens new window)
  • 6.4 RequestTransactionData (Client -> Server) (opens new window)
  • 6.5 RequestTransactionData.Success (Server->Client) (opens new window)
  • 6.6 RequestTransactionData.Error (Server->Client) (opens new window)
  • 6.7 SubmitSolution (Client -> Server) (opens new window)
• 7. Message Types (opens new window)
• 8. Extensions (opens new window)
• 9. Discussion (opens new window)
  • 9.1 Speculative Mining Jobs (opens new window)
  • 9.2 Rolling nTime (opens new window)
    • 9.2.1 Hardware nTime rolling (opens new window)
  • 9.3 Notes (opens new window)
  • 9.4 Usage Scenarios (opens new window)
    • 9.4.1 End Device (v2 ST) (opens new window)
    • 9.4.2 Transparent Proxy (v2 any -> v2 any) (opens new window)
    • 9.4.3 Difficulty Aggregating Proxy (v2 any -> v2 EX) (opens new window)
    • 9.4.4 Proxy (v1 -> v2) (opens new window)
    • 9.4.5 Proxy (v2 -> v1) (opens new window)
  • 9.5. FAQ (opens new window)
    • 9.5.1 Why is the protocol binary? (opens new window)
  • 9.6 Terminology (opens new window)
  • 9.7 Open Questions / Issues (opens new window)