Practical overview
When it fits
Use it when an extended public key is available and you need to map an HD wallet's derived receive and change addresses to blockchain activity or prepare an address report.
Who it is for
- Bitcoin wallet owners who need to identify previously funded receive and change addresses.
- People preparing address records for wallet accounting workflows.
- Technical users working with extended public keys and command-line wallet tools.
Documented uses
- Discover which derived receive and change addresses have received funds.
- Generate address lists for regular or supported multisig HD wallets.
- Export discovery results with selected address, path, and transaction-total fields.
- Generate addresses without blockchain lookups when only derivation is needed.
Requirements & limits
The project is documented as a command-line utility. Its installation instructions require PHP CLI with GMP and Composer dependencies.
- Blockchain activity checks depend on a selected API provider; the README lists provider choices and describes local operation as a privacy-oriented option.
- Unused-address discovery is governed by a gap limit, which defaults to 20 according to the usage documentation.
- Multisig use requires multiple extended public keys and a signer threshold; the README specifically notes testing with Copay under BIP44 and BIP45.
- The optional secp256k1 PHP extension is described as a way to speed up key generation.
- The repository README points to a separate web frontend; it does not establish that the frontend uses this repository's code.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Install the command-line utility
Set up Hd Wallet Addrs and its documented dependencies before using the address-discovery command.
Before you start
- PHP CLI with the GMP extension
- Composer
- Git
Steps
Install PHP CLI, PHP GMP, and Composer using the package manager for your environment.
Clone the repository and change into its directory.
Run
composer installto install the project dependencies.
Expected outcome
The repository and its Composer dependencies are set up for the documented command-line workflow.
Guide limitations
- This covers installation only; it does not verify a successful run or specify environment compatibility beyond the README's Ubuntu package example.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 18 October 2026
- Original website title
- dan-da/hd-wallet-addrs · Official homepage title · retained in its source language

