btclib-node
btclib-node is a full node bitcoin implementation written in Python and based on btclib.
To install, or upgrade:
python -m pip install --upgrade btclib-node
Python 3.14 or newer: pyproject.toml's requires-python says so and
says why, and pip refuses the wheel below it rather than installing
something that will not import. btclib-node is the command this puts
on PATH; btclib-node -h lists every option, spelled the way Bitcoin
Core spells its own. Read Security before running the node — the
classifier is 3 - Alpha and the JSON-RPC listener is not something to
expose.
A checkout of main is a cycle in progress, declaring the month with no
day, so it is not the same thing as what pip installs;
CONTRIBUTING.md has how to work from one.
Running a node
Running a node is what comes after
pip install: the command against each of the four chains, pointing it
at a peer of your own, reading its progress, the RPC methods it
answers, what it validates and what it does not, and what a mainnet
sync has actually been measured to cost.
Security
The JSON-RPC listener binds every interface and authenticates nothing — SECURITY.md carries that and the rest of what is known and recorded rather than a vulnerability to report again, and how to report one that is not already there.
Contributing
CONTRIBUTING.md's last section has the commands, and
they are the ones CI runs: uv sync builds the environment, uv run pytest is the suite and its coverage floor, and the lint gate is
.pre-commit-config.yaml run as lint.yml runs it. uv is the only tool
that has to be installed; it fetches the interpreter and every dependency
group itself.
REVIEWING.md is what a pull request here is answered against.
Links
- Source: https://github.com/btclib-org/btclib-node
- Releases: https://github.com/btclib-org/btclib-node/releases
- CHANGELOG.md for what changed, and
RELEASE_NOTES.md for what a release asks a user
to act on.
pyproject.tomlbetween releases declares the month a cycle is open on rather than a version anybody can install, andCONTRIBUTING.md's A release path, and what it has published is what that shape is for - REPOSITORY.md for the settings that live outside the tree
The btclib organization and its projects are actively supported by DGI and CheckSig.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file btclib_node-2026.9.4.tar.gz.
File metadata
- Download URL: btclib_node-2026.9.4.tar.gz
- Upload date:
- Size: 1.0 MB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e83d048bedbd8f6887ad1d65dce6f1cb52d7770bc2c4876748ed3addb0834b20
|
|
| MD5 |
26b7f9c249ea7c793297ad1c22f36029
|
|
| BLAKE2b-256 |
f556789ff20f4f1fa14dd9bc670dd19f9a7ad056ff6d086eeb9c50979027083f
|
Provenance
The following attestation bundles were made for btclib_node-2026.9.4.tar.gz:
Publisher:
release.yml on btclib-org/btclib-node
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
btclib_node-2026.9.4.tar.gz -
Subject digest:
e83d048bedbd8f6887ad1d65dce6f1cb52d7770bc2c4876748ed3addb0834b20 - Sigstore transparency entry: 2709895606
- Sigstore integration time:
-
Permalink:
btclib-org/btclib-node@893ba15ea97d8599a320461c0bf9dbe490100dc4 -
Branch / Tag:
refs/tags/v2026.9.4 - Owner: https://github.com/btclib-org
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@893ba15ea97d8599a320461c0bf9dbe490100dc4 -
Trigger Event:
push
-
Statement type:
File details
Details for the file btclib_node-2026.9.4-py3-none-any.whl.
File metadata
- Download URL: btclib_node-2026.9.4-py3-none-any.whl
- Upload date:
- Size: 276.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
cfb6ae7184e2f98802fe688cb3a9b3d75d9830cce636c3acf12b27bd8ddc240f
|
|
| MD5 |
8fb25aa26f0ed698bd9f0daaad9bad31
|
|
| BLAKE2b-256 |
5106798fc3461d27804fc20ec16dd144a3eb88c905549bb61fb6c70a874f6f4b
|
Provenance
The following attestation bundles were made for btclib_node-2026.9.4-py3-none-any.whl:
Publisher:
release.yml on btclib-org/btclib-node
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
btclib_node-2026.9.4-py3-none-any.whl -
Subject digest:
cfb6ae7184e2f98802fe688cb3a9b3d75d9830cce636c3acf12b27bd8ddc240f - Sigstore transparency entry: 2709895815
- Sigstore integration time:
-
Permalink:
btclib-org/btclib-node@893ba15ea97d8599a320461c0bf9dbe490100dc4 -
Branch / Tag:
refs/tags/v2026.9.4 - Owner: https://github.com/btclib-org
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@893ba15ea97d8599a320461c0bf9dbe490100dc4 -
Trigger Event:
push
-
Statement type:
