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 Reconnecting Downstream Nodes (opens new window)
  • 3.4 Protocol Extensions (opens new window)
  • 3.5 Error Codes (opens new window)
  • 3.6 Common Protocol Messages (opens new window)
    • 3.6.1 SetupConnection (Client -> Server) (opens new window)
    • 3.6.2 SetupConnection.Success (Server -> Client) (opens new window)
    • 3.6.3 SetupConnection.Error (Server -> Client) (opens new window)
    • 3.6.4 ChannelEndpointChanged (Server -> Client) (opens new window)
• 4. Protocol Security (opens new window)
  • 4.1 Motivation for Authenticated Encryption with Associated Data (opens new window)
  • 4.2 Motivation for Using the Noise Protocol Framework (opens new window)
  • 4.3 Choice of cryptographic primitives (opens new window)
    • 4.3.1 Elliptic Curve (opens new window)
      • 4.3.1.1 EC point encoding remarks (opens new window)
    • 4.3.2 Hash function (opens new window)
    • 4.3.3 Cipher function for authenticated encryption (opens new window)
  • 4.4 Cryptographic operations (opens new window)
    • 4.4.1 CipherState object (opens new window)
    • 4.4.2 Handshake Operation (opens new window)
  • 4.5 Authenticated Key Agreement Handshake (opens new window)
    • 4.5.1 Handshake Act 1: Noise protocol proposal (opens new window)
    • 4.5.2 Handshake Act 2: Noise protocol choice (opens new window)
    • 4.5.3 Handshake Act 3: NX-handshake part 1 -> e (opens new window)
    • 4.5.4 Handshake Act 4: NX-handshake part 2 <- e, ee, s, es, SIGNATURE_NOISE_MESSAGE (opens new window)
    • 4.5.5 Server authentication (opens new window)
      • 4.5.5.1 Signature structure (opens new window)
    • 4.5.6 Transport message encryption and format (opens new window)
  • 4.6 URL Scheme and Pool Authority Key (opens new window)
  • 4.7 References (opens new window)
• 5. Mining Protocol (opens new window)
  • 5.1 Channels (opens new window)
    • 5.1.1 Standard Channels (opens new window)
    • 5.1.2 Extended Channels (opens new window)
    • 5.1.3 Group Channels (opens new window)
    • 5.1.4 Future Jobs (opens new window)
  • 5.2 Hashing Space Distribution (opens new window)
  • 5.3 Mining Protocol Messages (opens new window)
    • 5.3.1 SetupConnection Flags for Mining Protocol (opens new window)
    • 5.3.2 OpenStandardMiningChannel (Client -> Server) (opens new window)
    • 5.3.3 OpenStandardMiningChannel.Success (Server -> Client) (opens new window)
    • 5.3.4 OpenExtendedMiningChannel (Client -> Server) (opens new window)
    • 5.3.5 OpenExtendedMiningChannel.Success (Server -> Client) (opens new window)
    • 5.3.6 OpenMiningChannel.Error (Server -> Client) (opens new window)
    • 5.3.7 UpdateChannel (Client -> Server) (opens new window)
    • 5.3.8 UpdateChannel.Error (Server -> Client) (opens new window)
    • 5.3.9 CloseChannel (Client -> Server, Server -> Client) (opens new window)
    • 5.3.10 SetExtranoncePrefix (Server -> Client) (opens new window)
    • 5.3.11 SubmitSharesStandard (Client -> Server) (opens new window)
    • 5.3.12 SubmitSharesExtended (Client -> Server) (opens new window)
    • 5.3.13 SubmitShares.Success (Server -> Client) (opens new window)
    • 5.3.14 SubmitShares.Error (Server -> Client) (opens new window)
    • 5.3.15 NewMiningJob (Server -> Client) (opens new window)
    • 5.3.16 NewExtendedMiningJob (Server -> Client) (opens new window)
    • 5.3.17 SetNewPrevHash (Server -> Client, broadcast) (opens new window)
    • 5.3.18 SetCustomMiningJob (Client -> Server) (opens new window)
    • 5.3.19 SetCustomMiningJob.Success (Server -> Client) (opens new window)
    • 5.3.20 SetCustomMiningJob.Error (Server -> Client) (opens new window)
    • 5.3.21 SetTarget (Server -> Client) (opens new window)
    • 5.3.22 Reconnect (Server -> Client) (opens new window)
    • 5.3.23 SetGroupChannel (Server -> Client) (opens new window)
• 6. Job Negotiation Protocol (opens new window)
  • 6.1 Job Negotiation Protocol Messages (opens new window)
    • 6.1.1 SetupConnection Flags for Job Negotiation Protocol (opens new window)
    • 6.1.2 AllocateMiningJobToken (Client -> Server) (opens new window)
    • 6.1.3 AllocateMiningJobToken.Success (Server -> Client) (opens new window)
    • 6.1.4 CommitMiningJob (Client -> Server) (opens new window)
    • 6.1.5 CommitMiningJob.Success (Server -> Client) (opens new window)
    • 6.1.6 CommitMiningJob.Error (Server->Client) (opens new window)
    • 6.1.7 IdentifyTransactions (Server->Client) (opens new window)
    • 6.1.8 IdentifyTransactions.Success (Client->Server) (opens new window)
    • 6.1.9 ProvideMissingTransactions (Server->Client) (opens new window)
    • 6.1.10 ProvideMissingTransactions.Success (Client->Server) (opens new window)
• 7. Template Distribution Protocol (opens new window)
  • 7.1 CoinbaseOutputDataSize (Client -> Server) (opens new window)
  • 7.2 NewTemplate (Server -> Client) (opens new window)
  • 7.3 SetNewPrevHash (Server -> Client) (opens new window)
  • 7.4 RequestTransactionData (Client -> Server) (opens new window)
  • 7.5 RequestTransactionData.Success (Server->Client) (opens new window)
  • 7.6 RequestTransactionData.Error (Server->Client) (opens new window)
  • 7.7 SubmitSolution (Client -> Server) (opens new window)
• 8. Message Types (opens new window)
• 9. Extensions (opens new window)
• 10. Discussion (opens new window)
  • 10.1 Speculative Mining Jobs (opens new window)
  • 10.2 Rolling nTime (opens new window)
    • 10.2.1 Hardware nTime rolling (opens new window)
  • 10.3 Notes (opens new window)
  • 10.4 Usage Scenarios (opens new window)
    • 10.4.1 End Device (v2 ST) (opens new window)
    • 10.4.2 Transparent Proxy (v2 any -> v2 any) (opens new window)
    • 10.4.3 Difficulty Aggregating Proxy (v2 any -> v2 EX) (opens new window)
    • 10.4.4 Proxy (v1 -> v2) (opens new window)
    • 10.4.5 Proxy (v2 -> v1) (opens new window)
  • 10.5. FAQ (opens new window)
    • 10.5.1 Why is the protocol binary? (opens new window)
  • 10.6 Terminology (opens new window)
  • 10.7 Open Questions / Issues (opens new window)