2014-07-19 09:13:00 +02:00
|
|
|
hdkeychain
|
|
|
|
==========
|
|
|
|
|
2015-10-24 00:10:35 +02:00
|
|
|
[![Build Status](http://img.shields.io/travis/btcsuite/btcutil.svg)]
|
|
|
|
(https://travis-ci.org/btcsuite/btcutil) [![ISC License]
|
|
|
|
(http://img.shields.io/badge/license-ISC-blue.svg)](http://copyfree.org)
|
|
|
|
[![GoDoc](http://img.shields.io/badge/godoc-reference-blue.svg)]
|
|
|
|
(http://godoc.org/github.com/btcsuite/btcutil/hdkeychain)
|
2014-07-19 09:13:00 +02:00
|
|
|
|
|
|
|
Package hdkeychain provides an API for bitcoin hierarchical deterministic
|
|
|
|
extended keys (BIP0032).
|
|
|
|
|
|
|
|
A comprehensive suite of tests is provided to ensure proper functionality. See
|
|
|
|
`test_coverage.txt` for the gocov coverage report. Alternatively, if you are
|
|
|
|
running a POSIX OS, you can run the `cov_report.sh` script for a real-time
|
2015-10-24 00:10:35 +02:00
|
|
|
report.
|
2014-07-19 09:13:00 +02:00
|
|
|
|
|
|
|
## Feature Overview
|
|
|
|
|
|
|
|
- Full BIP0032 implementation
|
|
|
|
- Single type for private and public extended keys
|
|
|
|
- Convenient cryptograpically secure seed generation
|
|
|
|
- Simple creation of master nodes
|
|
|
|
- Support for multi-layer derivation
|
|
|
|
- Easy serialization and deserialization for both private and public extended
|
|
|
|
keys
|
2015-02-06 05:04:58 +01:00
|
|
|
- Support for custom networks by registering them with chaincfg
|
2014-07-19 09:13:00 +02:00
|
|
|
- Obtaining the underlying EC pubkeys, EC privkeys, and associated bitcoin
|
|
|
|
addresses ties in seamlessly with existing btcec and btcutil types which
|
|
|
|
provide powerful tools for working with them to do things like sign
|
|
|
|
transations and generate payment scripts
|
|
|
|
- Uses the btcec package which is highly optimized for secp256k1
|
|
|
|
- Code examples including:
|
|
|
|
- Generating a cryptographically secure random seed and deriving a
|
|
|
|
master node from it
|
|
|
|
- Default HD wallet layout as described by BIP0032
|
|
|
|
- Audits use case as described by BIP0032
|
|
|
|
- Comprehensive test coverage including the BIP0032 test vectors
|
|
|
|
- Benchmarks
|
|
|
|
|
2015-10-24 00:10:35 +02:00
|
|
|
## Installation and Updating
|
2014-07-19 09:13:00 +02:00
|
|
|
|
|
|
|
```bash
|
2015-10-24 00:10:35 +02:00
|
|
|
$ go get -u github.com/btcsuite/btcutil/hdkeychain
|
2014-07-19 09:13:00 +02:00
|
|
|
```
|
|
|
|
|
|
|
|
## Examples
|
|
|
|
|
|
|
|
* [NewMaster Example]
|
2015-01-16 04:35:16 +01:00
|
|
|
(http://godoc.org/github.com/btcsuite/btcutil/hdkeychain#example-NewMaster)
|
2014-07-19 09:13:00 +02:00
|
|
|
Demonstrates how to generate a cryptographically random seed then use it to
|
|
|
|
create a new master node (extended key).
|
|
|
|
* [Default Wallet Layout Example]
|
2015-01-16 04:35:16 +01:00
|
|
|
(http://godoc.org/github.com/btcsuite/btcutil/hdkeychain#example-package--DefaultWalletLayout)
|
2014-07-19 09:13:00 +02:00
|
|
|
Demonstrates the default hierarchical deterministic wallet layout as described
|
|
|
|
in BIP0032.
|
|
|
|
* [Audits Use Case Example]
|
2015-01-16 04:35:16 +01:00
|
|
|
(http://godoc.org/github.com/btcsuite/btcutil/hdkeychain#example-package--Audits)
|
2014-07-19 09:13:00 +02:00
|
|
|
Demonstrates the audits use case in BIP0032.
|
|
|
|
|
|
|
|
## License
|
|
|
|
|
|
|
|
Package hdkeychain is licensed under the [copyfree](http://copyfree.org) ISC
|
|
|
|
License.
|