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.2.2026080407.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.2.2026080407-py3-none-any.whl (3.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: arc76_bitcoin-1.2.2026080407.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.2.2026080407.tar.gz
Algorithm Hash digest
SHA256 2c91f85ce0f6765fe9a5846ed945378f22c412348f2d4271fd3f5e3b3fb4d11b
MD5 f5dda8946a23f0fe68a01950822a1b4e
BLAKE2b-256 fb17503b5a09a452720593d839ce4c05b6ac312e7be22a3560a8e4844cd0e68a

See more details on using hashes here.

Provenance

The following attestation bundles were made for arc76_bitcoin-1.2.2026080407.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.2.2026080407-py3-none-any.whl.

File metadata

File hashes

Hashes for arc76_bitcoin-1.2.2026080407-py3-none-any.whl
Algorithm Hash digest
SHA256 9122b37b93d77872194411f946ab3a8bcdf99670ee342aa3425edba5c1472d57
MD5 5cd31fa3e9b5b64953cd5c3127652c06
BLAKE2b-256 dbc26bd4cd950cd4b51d26aa0a63207cf7f41f02c98ea50adfec38ac85855c97

See more details on using hashes here.

Provenance

The following attestation bundles were made for arc76_bitcoin-1.2.2026080407-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