diff --git a/.idea/vcs.xml b/.idea/vcs.xml
new file mode 100644
index 0000000..35eb1dd
--- /dev/null
+++ b/.idea/vcs.xml
@@ -0,0 +1,6 @@
+
+
+
+
+
+
\ No newline at end of file
diff --git a/.idea/workspace.xml b/.idea/workspace.xml
new file mode 100644
index 0000000..514614a
--- /dev/null
+++ b/.idea/workspace.xml
@@ -0,0 +1,104 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ {
+ "associatedIndex": 7
+}
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 1724767462945
+
+
+ 1724767462945
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/05-Mining-Protocol.md b/05-Mining-Protocol.md
index 16b9653..6635ee7 100644
--- a/05-Mining-Protocol.md
+++ b/05-Mining-Protocol.md
@@ -361,17 +361,23 @@ Because it is a common case that shares submission is successful, this response
| channel_id | U32 | Channel identification |
| last_sequence_number | U32 | Most recent sequence number with a correct result |
| new_submits_accepted_count | U32 | Count of new submits acknowledged within this batch |
-| new_shares_sum | U64 | Sum of shares acknowledged within this batch |
+| new_shares_sum | U64 | Sum of difficulty of shares acknowledged within this batch |
The server does not have to double check that the sequence numbers sent by a client are actually increasing.
It can simply use the last one received when sending a response.
It is the client’s responsibility to keep the sequence numbers correct/useful.
+The illustration below assumes a mining server that acknowledges every 10 successful submissions, and that a `SetTarget` message was sent to increase the difficulty from `Da` to `Db` in the middle of the batch submission.
+
+
+
+Please note that `new_submits_accepted_count` and `new_shares_sum` carry meaning within the batch being acknowledged, and their respective counters MUST be reset when a new batch starts being processed.
+
### 5.3.14 `SubmitShares.Error` (Server -> Client)
An error is immediately submitted for every incorrect submit attempt.
In case the server is not able to immediately validate the submission, the error is sent as soon as the result is known.
-This delayed validation can occur when a miner gets faster updates about a new prevhash than the server does (see `NewPrevHash` message for details).
+This delayed validation can occur when a miner gets faster updates about a new prevhash than the server does (see `SetNewPrevHash` message for details).
| Field Name | Data Type | Description |
| --------------- | --------- | ----------------------------------------------------------- |
@@ -386,6 +392,10 @@ Possible error codes:
- `difficulty-too-low`
- `invalid-job-id`
+The illustration below also assumes a mining server that acknowledges every 10 successful submissions.
+
+
+
### 5.3.15 `NewMiningJob` (Server -> Client)
The server provides an updated mining job to the client through a standard channel. This MUST be the first message after the channel has been successfully opened. This first message will have min_ntime unset (future job).
diff --git a/img/drawio/submit_shares_error.drawio.xml b/img/drawio/submit_shares_error.drawio.xml
new file mode 100644
index 0000000..0f3ba4c
--- /dev/null
+++ b/img/drawio/submit_shares_error.drawio.xml
@@ -0,0 +1,232 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/img/drawio/submit_shares_error.png b/img/drawio/submit_shares_error.png
new file mode 100644
index 0000000..7e2a50a
Binary files /dev/null and b/img/drawio/submit_shares_error.png differ
diff --git a/img/drawio/submit_shares_success.drawio.xml b/img/drawio/submit_shares_success.drawio.xml
new file mode 100644
index 0000000..43948cb
--- /dev/null
+++ b/img/drawio/submit_shares_success.drawio.xml
@@ -0,0 +1,229 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/img/submit_shares_error.png b/img/submit_shares_error.png
new file mode 100644
index 0000000..1190fef
Binary files /dev/null and b/img/submit_shares_error.png differ
diff --git a/img/submit_shares_success.png b/img/submit_shares_success.png
new file mode 100644
index 0000000..798f38f
Binary files /dev/null and b/img/submit_shares_success.png differ