Skip to content

fix: validate proof of work on block acceptance#115

Open
Jiyacodex wants to merge 4 commits into
StabilityNexus:mainfrom
Jiyacodex:test-pow-validation
Open

fix: validate proof of work on block acceptance#115
Jiyacodex wants to merge 4 commits into
StabilityNexus:mainfrom
Jiyacodex:test-pow-validation

Conversation

@Jiyacodex

@Jiyacodex Jiyacodex commented Jul 4, 2026

Copy link
Copy Markdown

Addressed Issues:

Received blocks were checked for linkage and hash consistency, but their hashes were not verified against the required Proof-of-Work difficulty.

This PR adds PoW validation to validate_block_link_and_hash(). Since both add_block() and resolve_conflicts() use this shared validator, invalid-PoW blocks are now rejected during both normal block acceptance and chain reorganization.

Screenshots/Recordings:

Not applicable.

Additional Notes:

Added regression tests covering both affected paths:

  • add_block() rejects a block whose hash does not satisfy its claimed difficulty.
  • resolve_conflicts() rejects a candidate chain containing a block with invalid PoW.

The regression tests fail without the PoW validation check and pass with the fix.

Testing:

  • python -m pytest tests/test_pow_validation.py -v: 2 passed
  • python -m pytest: 75 passed, 1 pre-existing failure in TestSmartContract.test_out_of_gas
    • Expected: Out of gas!
    • Actual: Execution timed out
    • The same failure was reproduced on untouched origin/main

AI Usage Disclosure:

  • This PR does not contain AI-generated code at all.
  • This PR contains AI-generated code. I have read the AI Usage Policy and this PR complies with this policy. I have tested the code locally and I am responsible for it.

I have used the following AI models and tools: ChatGPT and Claude for reviewing the changes and refining the tests.

Checklist

  • My PR addresses a single issue, fixes a single bug or makes a single improvement.
  • My code follows the project's code style and conventions
  • If applicable, I have made corresponding changes or additions to the documentation
  • If applicable, I have made corresponding changes or additions to tests
  • My changes generate no new warnings or errors
  • I have joined the Discord server and I will share a link to this PR with the project maintainers there
  • I have read the Contribution Guidelines
  • Once I submit my PR, CodeRabbit AI will automatically review it and I will address CodeRabbit's comments.
  • I have filled this PR template completely and carefully, and I understand that my PR may be closed without review otherwise.

Summary by CodeRabbit

  • Bug Fixes
    • Improved block validation to reject blocks that fail the required proof-of-work difficulty.
    • Ensured invalid proof-of-work blocks are not added to the chain and are not adopted during conflict resolution.
  • Tests
    • Added unit tests covering block rejection and conflict-resolution behavior for invalid proof-of-work candidates.

@coderabbitai

coderabbitai Bot commented Jul 4, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

Warning

Review limit reached

@Jiyacodex, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 15 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro

Run ID: 65814d6b-0303-49a0-a6e0-8ad04a95492e

📥 Commits

Reviewing files that changed from the base of the PR and between 9423173 and add5a77.

📒 Files selected for processing (1)
  • minichain/chain.py

Walkthrough

Adds a dedicated Proof-of-Work validation error, rejects blocks whose hashes miss the required leading-zero difficulty, and adds tests covering invalid-PoW rejection in add_block and resolve_conflicts.

Changes

PoW Validation

Layer / File(s) Summary
PoW validation and rejection handling
minichain/chain.py
Adds InvalidProofOfWorkError, enforces the difficulty prefix in validate_block_link_and_hash, and handles that failure explicitly in Blockchain._apply_block.
Invalid PoW rejection tests
tests/test_pow_validation.py
Adds an invalid-PoW block helper and tests that add_block and resolve_conflicts reject it without changing chain length.

Estimated code review effort: 2 (Simple) | ~10 minutes

Suggested labels: Python Lang

Poem

I hopped through hashes, bright and neat,
But zeros guard the chain’s retreat.
A PoW block must wear the crown,
Or gentle paws will turn it down.
🐰

🚥 Pre-merge checks | ✅ 4
✅ Passed checks (4 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly summarizes the main change: enforcing proof-of-work validation when blocks are accepted.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@minichain/chain.py`:
- Around line 28-31: The PoW validation in block handling is currently tied to
fragile string matching in add_block, where ValueError classification depends on
whether the message contains “hash.” Update the proof-of-work check in the block
validation path to raise a distinct error type or carry an explicit reason/code
from the PoW check, and update add_block to classify based on that symbol
instead of substring inspection. Use the existing block validation logic and
add_block flow to keep INVALID vs FAILED handling stable even if the error
wording changes.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro

Run ID: 3f2bc44e-a4f5-4c11-a81e-8a5cdfd08fec

📥 Commits

Reviewing files that changed from the base of the PR and between 4334478 and 2b20b43.

📒 Files selected for processing (2)
  • minichain/chain.py
  • tests/test_pow_validation.py

Comment thread minichain/chain.py
@github-actions

github-actions Bot commented Jul 6, 2026

Copy link
Copy Markdown

⚠️ This PR has merge conflicts.

Please resolve the merge conflicts before review.

Your PR will only be reviewed by a maintainer after all conflicts have been resolved.

📺 Watch this video to understand why conflicts occur and how to resolve them:
https://www.youtube.com/watch?v=Sqsz1-o7nXk

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@minichain/chain.py`:
- Around line 32-34: The PoW validation in validate_block_link_and_hash() uses
block.difficulty directly, which can cause type coercion issues or expensive
string allocation before the later checks in _apply_block(). Add a difficulty
sanity check in validate_block_link_and_hash() using the existing
block.difficulty and InvalidProofOfWorkError path so add_block() rejects
non-integer, boolean, negative, or otherwise invalid difficulty values early and
consistently.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro

Run ID: ada65b4d-f692-4efc-9c72-48ee7c94821e

📥 Commits

Reviewing files that changed from the base of the PR and between 2b20b43 and 9423173.

📒 Files selected for processing (2)
  • minichain/chain.py
  • tests/test_pow_validation.py

Comment thread minichain/chain.py
Comment thread minichain/chain.py
pass


def validate_difficulty(difficulty, max_difficulty):

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do we really need this validation function? Don't we know that we will always call this function with arguments that satisfy the conditions in line 18?

Also, some conditions in line 18 seem redundant anyway. For example, if difficulty is greater than len(block.hash), line 39 will fail anyway.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Unless I'm overlooking something important, let's remove this validation function.

Comment thread minichain/chain.py
raise ValueError(f"invalid difficulty {difficulty}")


def validate_block_link_and_hash(previous_block, block):

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This function is now also checking difficulty, but its name is still suggesting that it checks only block link and hash.

Let's rename it to validate_block.

Comment thread minichain/chain.py
raise ValueError(f"invalid hash {block.hash}")

validate_difficulty(block.difficulty, len(block.hash))

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In addition to the check in line 39, we must also check that block.difficulty is equal to the expected difficulty based on previous blocks.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Otherwise, the miner can circumvent the difficulty check, by simply writing a small difficulty in block.difficulty.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@Zahnentferner you're right. When I reviewed the attack was blocked by the separate difficulty checks in add_block and resolve_conflicts in the initial commit, but the architecture was flawed which I didn't notice since the checks already protected.
The difficulty check should have been moved inside the validator at the same time as the PoW check. That would have been the proper, complete fix. I focused too narrowly on, if the PoW check now exists or not.
The validation function and related issues came in later commits.

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.

3 participants