# Ethereum stratum mining protocol v1.0.0

By [watano](https://paragraph.com/@watano) · 2021-12-08

---

revision of this document: R2

*   I. Introduction 简介
    
*   II. Concept 概念
    
*   III. Specifications (RFC) 规范(RFC)
    
*   IV. Real world scenario 真实场景
    
*   V. Planned improvements 增强计划
    
*   VI. Contact 联系方式
    

I. 简介
=====

以太坊没有正式的stratum协议。它只支持GetWork，这是一个非常耗资源的问题，因为矿工需要不断的投票来获得可能的新工作。因此，GetWork会影响到矿工和矿池的性能。由于需要更专业的以太坊挖矿，出现了几个专为以太坊的“stratum”版本。这些“stratums”利用了服务器端(矿池端)的GetWork来获取工作，如果创建此类协议时采取仔细考虑因素和预防措施，这将是很好的。但这并没有完成。这些协议有以下问题:

1.  每个矿工/工人都没有唯一的数据。Extranonce被忽略(但仍然被发送)。每一个矿工都获取seedhash(每30k块都是相同的)和headerhash(每个块都改变)。然后矿工使用这两个值和自己的Nonce来生成哈希。矿工可能在做重复的工作(如果他们选择了相同的Nonce)。
    
2.  难度冗余。难度在mining.notify消息中作为已命名目标的第三个参数被发送。这是不需要的，因为矿工们可以通过自己的困难来计算目标哈希。
    
3.  整体数据冗余。有几个字段不需要通过网络发送。首先, 如果未使用extranonce，则不必发送。其次,每隔30k个块更换一次seedhash，就没有必要每次挖矿都发送。第三,正如在第2条中指出的 - 当使用set\_difficulty时, 在mining.notify中的目标是多余的。第四,mining.submit实际上只需要发送一次。矿池需要验证Nonce的有效性，并将计算哈希和混合哈希(mixhash)。如果删除所有提及的冗余，可以很容易地减少50%以上的带宽使用。
    
4.  与原有slush的stratum规范相比，有一些不一致的地方。其中一个是ids。Ids应该增加，以便矿池能够跟踪接收到的数据。另一件事是HEX标记'0x'从每个字符串字段开始。这也是多余的，如果不使用的话，我们将节省一些带宽。
    
5.  没有规范，只有有实现的解决方案项目。这通常会导致几个类似的协议版本;到底发生了什么。
    

我们的目标是建立一个可靠的、无冗余的、刀枪不入的以太坊stratum挖矿协议, 它没有前面指出的这些问题。

II. 概念
======

以太坊的GetWork给我们3个值:

    { ... "result":[
    "0x645cf20198c2f3861e947d4f67e3ab63b7b2e24dcc9095bd9123e7b33371f6cc",
    "0xabad8f99f3918bf903c6a909d9bbc0fdfa5a2f4b9cb1196175ec825c6610126c",
    "0x0000000394427b08175efa9a9eb59b9123e2969bf19bf272b20787ed022fbe6c"
    ]}
    

第一个值是headerhash,第二个是seedhash, 第三个是目标。 Seedhash用于识别DAG文件, headerhash和64为Nonce由我们的矿机给我们的哈希选择出, 如果低于提供的目标，则提供块/共享。

由于Nonce的宽度为64位(8字节)，并且考虑到非常糟糕的可能情况，以太坊在5分钟内没有发现一个块，8个字节的Nonce能够提升矿机的速度到:

        (2^64 / 300) / 1G ~ 61,489,147 GH/s
    

这是一个非常大的数字，所以我们可以很容易地考虑为我们的stratum协议拿走一些字节。

    ---------------------------------------
    | Bytes | Max supported hashing speed |
    |   8   |        ~61,489,147.000 GH/s |
    |   7   |           ~240,192.000 GH/s |
    |   6   |               ~938.000 GH/s |
    |   5   |                 ~3.665 GH/s |
    |   4   |                 ~0.014 GH/s |
    ---------------------------------------
    

只有4个字节的Nonce不是一个选项，因为我们已经有了能够达到14 MH/s以上的矿工。5个字节的Nonce宽度允许最大速度为3.665 GH/s，在相当长的时间内是足够的，即使ASICs到达。

矿工需要在矿池中得到seedhash、headerhash、难度和部分nonce(被称为extranonce)。矿工选择了它自己的第二部分(称为minernonce)。Extranonce与minernonce连接，它提供64位的Ethereum nonce。

III. 规范(RFC)
============

* * *

在矿工到矿池建立TCP连接之后，就会发生握手。矿工首先发送数据:

    {
      "id": 1,
      "method": "mining.subscribe",
      "params": [
        "MinerName/1.0.0", "EthereumStratum/1.0.0"
      ]
    }
    

第一个参数是矿工名称和版本(正如标准stratum协议)。第二个参数必须是“Ethereum Stratum/Version”，版本是根据该文档的版本使用的EthereumStratum矿工的版本。如果矿池不支持此版本，它可以终止连接或返回错误。 注意，矿工可以迭代ids，可以从任何数字开始。从矿工到矿池的每条消息都需要有唯一的id给矿工以正确读取响应，因为矿池可能不以FIFO方式处理矿工的消息。

服务器回复:

    {
      "id": 1,
      "result": [
        [
          "mining.notify",
          "ae6812eb4cd7735a302a8a9dd95cf71f",
          "EthereumStratum/1.0.0"
        ],
        "080c"
      ],
      "error": null
    }
    

响应几乎与标准stratum协议具有以下差异;结果数组的第一个参数的第三个参数为“EthereumStratum/Version”;如果矿池没有报告此参数或版本与矿工支持的不同，矿工可以预期兼容性问题，并终止连接。结果数组的第二个参数是由矿池设置的extranonce(在十六进制中)。没有第三个参数，因为没有extranonce2(正如标准stratum)。Extranonce可能最大3字节。

矿工应在初次握手时授权;这与标准stratum协议相同，在这里将不会详细解释。

在第一份任务(工作)提供之前，矿池必须通过发送设置难度:

    {
      "id": null,
      "method": "mining.set_difficulty",
      "params": [
        0.5
      ]
    }
    

参数数组的第一项是双重数据类型的难度。难度和目标之间的转换与比特币一样;难度1转化为HEX的目标:

如果矿池在第一份工作之前没有设置难度，那么矿工就可以假定难度是1。

当难度发生变化时，矿工们开始为每一份到达的NEXT任务使用新的难度。

如果矿工已经订阅extranonce通知(详细解释在这里:[https://www.nicehash.com/?p=software#devs](https://www.nicehash.com/?p=software#devs)),然后矿池可能会改变矿工的extranonce通过发送:

    {
      "id": null,
      "method": "mining.set_extranonce",
      "params": [
        "af4c"
      ]
    }
    

新的extranonce对于所有在矿池中发送的NEXT任务都有效。

矿池通过发送以下数据通知矿工工作(工作):

    {
      "id": null,
      "method": "mining.notify",
      "params": [
        "bf0488aa",
        "abad8f99f3918bf903c6a909d9bbc0fdfa5a2f4b9cb1196175ec825c6610126c",
        "645cf20198c2f3861e947d4f67e3ab63b7b2e24dcc9095bd9123e7b33371f6cc",
        true
      ]
    }
    

参数数组的第一个参数是任务ID(必须是任意大小的十六进制数)。第二个参数是seedhash。每一个任务都发送一个seedhash来支持尽可能多的矿池，这可能会很快地在货币之间交换。第三个参数是headerhash。最后一个参数是boolean cleanjobs。如果设为true，那么矿工需要清理任务队列，并立即开始从事新提供的任务，因为所有旧的任务分享都将导致陈旧的分享错误。

矿工使用seedhash识别DAG，然后试着带着headerhash,extranonce和自己的minernonce寻找低于目标的分享(这是由提供的难度而产生的)。

当发现低于目标的分享时，矿工将其提交给矿池:

    {
      "id": 244,
      "method": "mining.submit",
      "params": [
        "username",
        "bf0488aa",
        "6a909d9bbc0f"
      ]
    }
    

参数数组的第二个参数是任务ID，第三个参数是minernonce。注意在上面的例子中，minernonce是6个字节，因为提供的extranonce是2个字节。如果矿池提供3字节的extranonce，那么minernonce必须是5字节。

对于每一个提交的工作，矿池需要返回标准stratum响应:

    {
      "id": 244,
      "result": true,
      "error": null
    }
    

或者如果分享不被接受(标准stratum响应):

    {
      "id": 244,
      "result": false,
      "error": [
        -1,
        "Job not found",
        NULL
      ]
    }
    

IV. 真实场景
========

* * *

矿工连接矿池并发送:

    {
      "id": 1,
      "method": "mining.subscribe",
      "params": [
        "EthereumMiner/1.0.0", "EthereumStratum/1.0.0"
      ]
    }
    

矿池响应:

    {
      "id": 1,
      "result": [
        [
          "mining.notify",
          "ae6812eb4cd7735a302a8a9dd95cf71f",
          "EthereumStratum/1.0.0"
        ],
        "a2eea0"
      ],
      "error": null
    }
    

矿工然后认证:

    {
      "id": 2,
      "method": "mining.authorize",
      "params": [
        "test",
        "password"
      ]
    }
    

矿池确认:

    {
      "id": 2,
      "result": true,
      "error": null
    }\n
    

矿池发送难度:

    {
      "id": null,
      "method": "mining.set_difficulty",
      "params": [
        1.0
      ]
    }\n
    

然后任务:

    {
      "id": null,
      "method": "mining.notify",
      "params": [
        "bf0488aa",
        "abad8f99f3918bf903c6a909d9bbc0fdfa5a2f4b9cb1196175ec825c6610126c",
        "fc12eb20c58158071c956316cdcd12a22dd8bf126ac4aee559f0ffe4df11f279",
        true
      ]
    }\n
    

过了一段时间，矿工找到了分享并提交:

    {
      "id": 3,
      "method": "mining.submit",
      "params": [
        "test",
        "bf0488aa",
        "cfae7df760"
      ]
    }\n
    

矿池响应:

    {
      "id": 3,
      "result": true,
      "error": null
    }\n
    

分享是有效考虑数据:

    seedhash=abad8f99f3918bf903c6a909d9bbc0fdfa5a2f4b9cb1196175ec825c6610126c
    headerhash=fc12eb20c58158071c956316cdcd12a22dd8bf126ac4aee559f0ffe4df11f279
    nonce=a2eea0cfae7df760
    

结果是难度的1.863, 大于1.0.

V. 增强计划
=======

以太坊有RPC方法eth\_getBlockByNumber，它可以返回一些尚未被挖掘的下块数据。数据中有下一个块号(块高度)。这个数字可以代替seedhash;然后，每个矿工都将计算自己的seedhash，因此带宽的使用将会减少更多。 有一些改造eth\_getBlockTemplate方法的计划。当这种情况发生时，这种stratum协议可能与标准stratum非常相似。

VI. 联系方式
========

*   [www.nicehash.com](http://www.nicehash.com)
    
*   [info@nicehash.com](mailto:info@nicehash.com)

---

*Originally published on [watano](https://paragraph.com/@watano/ethereum-stratum-mining-protocol-v1-0-0)*