Skip to main content

Deterministic ARC76 account derivation for Bitcoin (native SegWit / bech32 addresses). https://github.com/algorandfoundation/ARCs/blob/main/ARCs/arc-0076.md

Project description

arc76-bitcoin

ARC76 Account

Deterministic ARC76 account derivation for Bitcoin (native SegWit / bech32 addresses).

Usage

pip install arc76-bitcoin
from arc76.bitcoin import get_account, get_email_account

account = get_account(password)  # slot 0
print(account.address())         # bech32 P2WPKH address, e.g. "bc1..."
print(account.wif())             # WIF-encoded private key

email_account = get_email_account(email, password)

Both functions return a BitcoinAccount(private_key, public_key):

  • private_key — the raw 32-byte secp256k1 private key (identical to the ARC76 seed).
  • public_key — the 33-byte compressed secp256k1 public key.
  • .address(hrp="bc") — the native SegWit (bech32, P2WPKH) address; pass hrp="tb" for testnet.
  • .wif() — the WIF-encoded private key (compressed-public-key convention).

Elliptic-curve operations use coincurve, Python bindings for libsecp256k1 — the same constant-time, side-channel-hardened library Bitcoin Core itself uses for secp256k1. RIPEMD-160 (for the address hash) is taken from pycryptodome rather than the standard library, since hashlib's ripemd160 depends on OpenSSL's legacy provider being enabled (not guaranteed on OpenSSL 3.0+); pycryptodome ships its own implementation so address derivation doesn't silently vary by platform.

Please use a password of at least 50 characters for real accounts — the account's security is entirely the password's security.

⚠️ Same-curve chains share the literal same private key. arc76-bitcoin, arc76-bitcoincash, and arc76-ethereum derive the identical secp256k1 private key from the same password/email/slot — leaking the key on one of those chains leaks it on all of them. Use a different password (or slot) per chain if you need isolation.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

arc76_bitcoin-1.1.2026080321.tar.gz (6.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

arc76_bitcoin-1.1.2026080321-py3-none-any.whl (3.6 kB view details)

Uploaded Python 3

File details

Details for the file arc76_bitcoin-1.1.2026080321.tar.gz.

File metadata

  • Download URL: arc76_bitcoin-1.1.2026080321.tar.gz
  • Upload date:
  • Size: 6.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for arc76_bitcoin-1.1.2026080321.tar.gz
Algorithm Hash digest
SHA256 604f4d62636ced5ddfe6fa842b635c17814a930205387359dc745928a61b769d
MD5 4c766b9581722abf0312c186f7f0d6e8
BLAKE2b-256 a767011539ba570e8ce98d7ff77bea991055a790026214af24c57e94b979300c

See more details on using hashes here.

Provenance

The following attestation bundles were made for arc76_bitcoin-1.1.2026080321.tar.gz:

Publisher: publish-pypi.yml on scholtz/ARC76Account

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file arc76_bitcoin-1.1.2026080321-py3-none-any.whl.

File metadata

File hashes

Hashes for arc76_bitcoin-1.1.2026080321-py3-none-any.whl
Algorithm Hash digest
SHA256 411ba3ef9e48e78ca7b57bf375c351dd80e42fe19c49e2794cd41f39df95b503
MD5 4316cfcf82957ec8c3039b1c13b46219
BLAKE2b-256 064e137b18521732453d2554442f559ce200c4e4f9c9d4d088410abd9aa4c45d

See more details on using hashes here.

Provenance

The following attestation bundles were made for arc76_bitcoin-1.1.2026080321-py3-none-any.whl:

Publisher: publish-pypi.yml on scholtz/ARC76Account

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page