Files
2026-03-06 18:22:02 +01:00

29 lines
1015 B
Python

from __future__ import annotations
from .common import base58check_verify, bech32_decode
def validate_btc_address(address: str) -> tuple[bool, str]:
address = address.strip()
if address.lower().startswith("bc1"):
hrp, data, spec = bech32_decode(address)
if hrp is None:
return False, "Invalid Bech32 or Bech32m checksum"
if hrp != "bc":
return False, "Invalid HRP for BTC"
if not data:
return False, "Missing witness program"
return True, f"Valid {spec} address"
if not (address.startswith("1") or address.startswith("3")):
return False, "BTC Base58 addresses must start with 1 or 3"
valid, reason, version, payload_len = base58check_verify(address)
if not valid:
return False, reason
if payload_len != 21:
return False, "Unexpected Base58 payload length"
if version not in (0x00, 0x05):
return False, "Invalid BTC version byte"
return True, "Valid Base58Check address"