Add stratum style mining protocol

[kseo]

No description provided.

[kseo]

@redongjun will work on this issue.

[kakao-jun-e]

@kseo I have written a protocol spec as below. could you review it?
(ref https://slushpool.com/help/manual/stratum-protocol)

mining.subscribe

Used for subscribing mining jobs.

Params: No parameters
Return Type: No parameters

Request Example

{
    "jsonrpc": "2.0", 
    "id": 1, 
    "method": "mining.subscribe", 
    "params": []
}

Response Example

{
    "jsonrpc": "2.0", 
    "id": 1, 
    "result": [],
    "error": null
}

mining.authorize

Used for authorizing miner.

Params:

1. name: string
2. password: string

Return Type: bool

Request Example

{
    "jsonrpc": "2.0", 
    "id":2, 
    "method": "mining.authorize", 
    "params": ["miner1", "password"]
}

Response Example

{
    "jsonrpc": "2.0",
    "id": 2, 
    "result": true,
    "error": null
}

mining.notify

Used for sending notifications with mining jobs

Params: WorkObject

Notification Example

{
    "jsonrpc": "2.0",
    "id": 3, 
    "method": "mining.notify", 
    "params": {
        "0x56642f04d519ae3262c7ba6facf1c5b11450ebaeb7955337cfbc45420d573077",
        "100"
    },
}

mining.submit

Used for submitting a proof-of-work solution.

Params:

1. powHash: string
2. seal: string[]

Return Type: bool

Request Example

{
    "jsonrpc": "2.0",
    "id": 4, 
    "method": "mining.submit", 
    "params": ["0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef", ["0x56642f04d519ae3262c7ba6facf1c5b11450ebaeb7955337cfbc45420d573077"]],
}

Response Example

{
    "jsonrpc": "2.0",
    "id": 4, 
    "result": true,
    "error": null
}

Exception Handling

Stratum defines simple exception handling. Example of rejected share looks like:

{
    "jsonrpc": "2.0",
    "id": 5, 
    "result": null, 
    "error": (21, "Job not found", null)
}

Where the error field is defined as (error_code, human_readable_message, traceback). Traceback may contain additional information for debugging errors.
Proposed error codes for mining service are:

• 20 - Other/Unknown
• 21 - Job not found (=stale)
• 22 - Duplicate share
• 23 - Low target share
• 24 - Unauthorized worker
• 25 - Not subscribed

[kseo]

@redongjun Thanks for the suggestion. Let's discuss the spec tomorrow at the developers meeting.

[kakao-jun-e]

After the developers meeting, I have read another stratum article and existing stratum codes in codechain. the proposal spec was a mistake due to a lack of understanding about mining pool and reward. so the specification has been slightly modified as above.

In summary:
subscribing give miner basic information for working. (currently no parameter, but need to discuss in the future)
authorizing register as a worker on a node.
notify and submit are the same as before.

I have prototyped as spec as above. #444