Skip to content

clarify new_shares_sum field of SubmitShares.Success#126

Merged
plebhash merged 2 commits into
stratum-mining:mainfrom
plebhash:2025-04-04-clarify-submit-shares-success
Feb 20, 2026
Merged

clarify new_shares_sum field of SubmitShares.Success#126
plebhash merged 2 commits into
stratum-mining:mainfrom
plebhash:2025-04-04-clarify-submit-shares-success

Conversation

@plebhash
Copy link
Copy Markdown
Member

@plebhash plebhash commented Apr 4, 2025

@plebhash plebhash marked this pull request as draft April 4, 2025 16:38
@plebhash plebhash changed the title clarify new_shares_sum field of SubmitShares.Success [WIP] clarify new_shares_sum field of SubmitShares.Success Apr 4, 2025
@plebhash plebhash force-pushed the 2025-04-04-clarify-submit-shares-success branch 2 times, most recently from 87d8db6 to 8a56281 Compare April 9, 2025 21:40
@pavlenex
Copy link
Copy Markdown
Contributor

Thanks for adding these graphics, it makes things way easier to understand!

@plebhash plebhash force-pushed the 2025-04-04-clarify-submit-shares-success branch 2 times, most recently from 9f44b3b to 592112a Compare April 10, 2025 21:29
plebhash referenced this pull request in vinteumorg/pleblottery Jun 16, 2025
@plebhash

This comment was marked as resolved.

@plebhash

This comment was marked as resolved.

it's not clear what the `new_shares_sum` field of `SubmitShares.Success` really means

after reaching out to @jakubtrnka , he described the following:

> `new_submits_accepted_count` is number of submits.
> `new_shares_sum` is "integral" over difficulty of work to be confirmed by this success msg

this commit clarifies both `SubmitShares.Success` and `SubmitShares.Error` with detailed descriptions and new visual diagrams.
@plebhash plebhash force-pushed the 2025-04-04-clarify-submit-shares-success branch from ce15cb7 to 5e37f3e Compare February 19, 2026 13:07
@plebhash plebhash changed the title [WIP] clarify new_shares_sum field of SubmitShares.Success clarify new_shares_sum field of SubmitShares.Success Feb 19, 2026
@plebhash
Copy link
Copy Markdown
Member Author

marking this as ready for review, as we're getting confusion around this concept stratum-mining/stratum#2090 (comment)

@plebhash plebhash marked this pull request as ready for review February 19, 2026 13:09
@Fi3
Copy link
Copy Markdown
Contributor

Fi3 commented Feb 20, 2026

ack

1 similar comment
@jakubtrnka
Copy link
Copy Markdown
Collaborator

ack

@plebhash plebhash merged commit 161f21c into stratum-mining:main Feb 20, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

SubmitShares.Success has unclear description of new_shares_sum field

4 participants