Add error codes documentation with resolution suggestions #307
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Add comprehensive section on common error codes and troubleshooting: - Block validation errors (codes 16-68) including the specific bad-fork-prior-to-checkpoint (code 67) error - RPC error codes (-1 through -28) with explanations - Wallet-specific error codes - Network error codes - Debugging tips for developers This helps developers quickly identify and resolve common issues when testing applications with Bitcoin Core. Addresses bitcoin-dot-org/Bitcoin.org#1837 Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
There was a problem hiding this comment.
Pull request overview
This PR adds comprehensive error code documentation to the testing examples, helping developers understand and resolve common errors when testing applications with Bitcoin Core. The documentation addresses a specific bounty request from the bitcoin.org repository.
Changes:
- Added "Common Error Codes" section to testing.rst with four categories of errors (Block Validation, RPC, Wallet, and Network)
- Included specific error code 67 (
bad-fork-prior-to-checkpoint) that was mentioned in the original bounty - Added debugging tips section with practical troubleshooting guidance
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
This PR adds comprehensive documentation on common error codes that developers encounter when testing applications with Bitcoin Core, along with resolution suggestions for each error.
New Sections Added:
Block Validation Errors (codes 16-68)
bad-fork-prior-to-checkpoint(code 67) error mentioned in the original requestRPC Error Codes (-1 through -28)
Wallet Error Codes
Network Error Codes
Debugging Tips
Context
This PR addresses a bounty originally listed on bitcoin.org (issue #1837: "Add section with possible error codes and resolution suggestions"). Since the developer documentation was moved from bitcoin.org to developer.bitcoin.org, I'm submitting the PR here where the documentation now lives.
Original bounty: bitcoin-dot-org/Bitcoin.org#1837
The bounty specifically mentioned the error:
This error and its resolution are now documented in the Block Validation Errors section.
Payment Address
Bitcoin address for bounty payment:
bc1qax8d6etvphms3tqqc7hy52vas4af7ezv4msvqd🤖 Generated with Claude Code