722 GitHub stars and counting — paritytech/parity-bitcoin is a Rust project TopGit is tracking across repositories on the platform. The Parity Bitcoin client
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
pbtc is now available at either ./target/debug/pbtc or ./target/release/pbtc.
Installing the snap
In any of the supported Linux distros:
sudo snap install parity-bitcoin --edge
Running tests
pbtc has internal unit tests and it conforms to external integration tests.
Running unit tests
Assuming that repository is already cloned, we can run unit tests with this command:
cargo test --all
Running external integration tests
Running integration tests is automated, as the regtests repository is one of the submodules. Let's download it first:
git submodule update --init
Now we can run them using the command:
./tools/regtests.sh
It is also possible to run regtests manually:
# let's start pbtc in regtest compatible mode
./target/release/pbtc --btc --regtest
# now in second shell window
cd $HOME
git clone https://github.com/TheBlueMatt/test-scripts
cd test-scripts
java -jar pull-tests-f56eec3.jar
Going online
By default parity connects to bitcoind-seednodes. Full list is available here.
Before starting synchronization, you must decide - which fork to follow - Bitcoin Core (--btc flag) or Bitcoin Cash (--bch flag). On next start, passing the same flag is optional, as the database is already bound to selected fork and won't be synchronized using other verification rules.
To start syncing the main network, just start the client, passing selected fork flag. For example:
./target/release/pbtc --btc
To start syncing the testnet:
./target/release/pbtc --btc --testnet
To not print any syncing progress add --quiet flag:
./target/release/pbtc --btc --quiet
Importing bitcoind database
It is possible to import existing bitcoind database:
# where $BITCOIND_DB is path to your bitcoind database, e.g., "/Users/user/Library/Application Support"
./target/release/pbtc import "$BITCOIND_DB/Bitcoin/blocks"
By default import verifies imported the blocks. You can disable this, by adding --verification-level=none flag.
Full list of CLI options, which is available under pbtc --help:
pbtc 0.1.0
Parity Technologies <[email protected]>
Parity Bitcoin client
USAGE:
pbtc [FLAGS] [OPTIONS] [SUBCOMMAND]
FLAGS:
--bch Use Bitcoin Cash verification rules (BCH).
--btc Use Bitcoin Core verification rules (BTC).
-h, --help Prints help information
--no-jsonrpc Disable the JSON-RPC API server.
-q, --quiet Do not show any synchronization information in the console.
--regtest Use a private network for regression tests.
--testnet Use the test network (Testnet3).
-V, --version Prints version information
OPTIONS:
--blocknotify <COMMAND> Execute COMMAND when the best block changes (%s in COMMAND is replaced by the block hash).
-c, --connect <IP> Connect only to the specified node.
-d, --data-dir <PATH> Specify the database and configuration directory PATH.
--db-cache <SIZE> Sets the database cache size.
--jsonrpc-apis <APIS> Specify the APIs available through the JSONRPC interface. APIS is a comma-delimited list of API names.
--jsonrpc-cors <URL> Specify CORS header for JSON-RPC API responses.
--jsonrpc-hosts <HOSTS> List of allowed Host header values.
--jsonrpc-interface <INTERFACE> The hostname portion of the JSONRPC API server.
--jsonrpc-port <PORT> Specify the PORT for the JSONRPC API server.
--only-net <NET> Only connect to nodes in network version <NET> (ipv4 or ipv6).
--port <PORT> Listen for connections on PORT.
-s, --seednode <IP> Connect to a seed-node to retrieve peer addresses, and disconnect.
--verification-edge <BLOCK> Non-default verification-level is applied until a block with given hash is met.
--verification-level <LEVEL> Sets the Blocks verification level to full (default), header (scripts are not verified), or none (no verification at all).
SUBCOMMANDS:
help Prints this message or the help of the given subcommand(s)
import Import blocks from a Bitcoin Core database.
rollback Rollback the database to given canonical-chain block.
JSON-RPC
The JSON-RPC interface is served on port :8332 for mainnet and :18332 for testnet unless you specified otherwise. So if you are using testnet, you will need to change the port in the sample curl requests shown below.
pbtc started with this environment variable will print all logs coming from verification module with verbosity info or higher. Available log levels are:
error
warn
info
debug
trace
It's also possible to start logging from multiple modules in the same time:
How does paritytech/parity-bitcoin compare to other Backend projects?
paritytech/parity-bitcoin is tracked by TopGit in the Backend category, with 722 GitHub stars and written in Rust. Browse the Backend topic page on TopGit to compare it against similar projects by stars and activity.
Is paritytech/parity-bitcoin open source?
Yes — paritytech/parity-bitcoin ships under the GPL-3.0 license, which makes its source code freely readable (and, depending on license terms, forkable and reusable). Source: github.com/paritytech/parity-bitcoin.
What else is in the Backend space?
paritytech/parity-bitcoin is tracked by TopGit under the Backend category, alongside 6 GitHub-tagged topics. Trending and Topics pages list peer repositories of comparable stars and language.
What is paritytech/parity-bitcoin?
paritytech/parity-bitcoin (paritytech/parity-bitcoin) is a Rust project on GitHub. From the project's own README: The Parity Bitcoin client
Where do I read more about paritytech/parity-bitcoin?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/paritytech/parity-bitcoin is the definitive source.
Why is paritytech/parity-bitcoin categorized under Backend?
TopGit places paritytech/parity-bitcoin in the Backend category based on its GitHub topics and description (tagged: "bitcoin", "blockchain", "client"). Categories are assigned from real repository metadata, not editorial guesswork.
Read full README in the tab above.
Curious whether parity-bitcoin is right for you?
Let ChatGPT, Claude, or Perplexity look into it — click below and see what AI actually says about parity-bitcoin.