d0938d817f
This commit implements a new secure, scalable, hierarchical deterministic
wallet address manager package.
The following is an overview of features:
- BIP0032 hierarchical deterministic keys
- BIP0043/BIP0044 multi-account hierarchy
- Strong focus on security:
- Fully encrypted database including public information such as
addresses as well as private information such as private keys and
scripts needed to redeem pay-to-script-hash transactions
- Hardened against memory scraping through the use of actively clearing
private material from memory when locked
- Different crypto keys used for public, private, and script data
- Ability for different passphrases for public and private data
- Scrypt-based key derivation
- NaCl-based secretbox cryptography (XSalsa20 and Poly1305)
- Multi-tier scalable key design to allow instant password changes
regardless of the number of addresses stored
- Import WIF keys
- Import pay-to-script-hash scripts for things such as multi-signature
transactions
- Ability to export a watching-only version which does not contain any
private key material
- Programmatically detectable errors, including encapsulation of errors
from packages it relies on
- Address synchronization capabilities
This commit only provides the implementation package. It does not
include integration into to the existing wallet code base or conversion of
existing addresses. That functionality will be provided by future
commits.
119 lines
3.5 KiB
Go
119 lines
3.5 KiB
Go
/*
|
|
* Copyright (c) 2014 Conformal Systems LLC <info@conformal.com>
|
|
*
|
|
* Permission to use, copy, modify, and distribute this software for any
|
|
* purpose with or without fee is hereby granted, provided that the above
|
|
* copyright notice and this permission notice appear in all copies.
|
|
*
|
|
* THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
|
|
* WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
|
|
* MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
|
|
* ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
|
|
* WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
|
|
* ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
|
|
* OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
|
*/
|
|
|
|
package waddrmgr_test
|
|
|
|
import (
|
|
"fmt"
|
|
"testing"
|
|
|
|
"github.com/conformal/btcwallet/waddrmgr"
|
|
)
|
|
|
|
// TestErrorCodeStringer tests the stringized output for the ErrorCode type.
|
|
func TestErrorCodeStringer(t *testing.T) {
|
|
tests := []struct {
|
|
in waddrmgr.ErrorCode
|
|
want string
|
|
}{
|
|
{waddrmgr.ErrDatabase, "ErrDatabase"},
|
|
{waddrmgr.ErrKeyChain, "ErrKeyChain"},
|
|
{waddrmgr.ErrCrypto, "ErrCrypto"},
|
|
{waddrmgr.ErrNoExist, "ErrNoExist"},
|
|
{waddrmgr.ErrAlreadyExists, "ErrAlreadyExists"},
|
|
{waddrmgr.ErrCoinTypeTooHigh, "ErrCoinTypeTooHigh"},
|
|
{waddrmgr.ErrAccountNumTooHigh, "ErrAccountNumTooHigh"},
|
|
{waddrmgr.ErrLocked, "ErrLocked"},
|
|
{waddrmgr.ErrWatchingOnly, "ErrWatchingOnly"},
|
|
{waddrmgr.ErrInvalidAccount, "ErrInvalidAccount"},
|
|
{waddrmgr.ErrAddressNotFound, "ErrAddressNotFound"},
|
|
{waddrmgr.ErrAccountNotFound, "ErrAccountNotFound"},
|
|
{waddrmgr.ErrDuplicate, "ErrDuplicate"},
|
|
{waddrmgr.ErrTooManyAddresses, "ErrTooManyAddresses"},
|
|
{waddrmgr.ErrWrongPassphrase, "ErrWrongPassphrase"},
|
|
{waddrmgr.ErrWrongNet, "ErrWrongNet"},
|
|
{0xffff, "Unknown ErrorCode (65535)"},
|
|
}
|
|
t.Logf("Running %d tests", len(tests))
|
|
for i, test := range tests {
|
|
result := test.in.String()
|
|
if result != test.want {
|
|
t.Errorf("String #%d\ngot: %s\nwant: %s", i, result,
|
|
test.want)
|
|
continue
|
|
}
|
|
}
|
|
}
|
|
|
|
// TestManagerError tests the error output for the ManagerError type.
|
|
func TestManagerError(t *testing.T) {
|
|
tests := []struct {
|
|
in waddrmgr.ManagerError
|
|
want string
|
|
}{
|
|
// Manager level error.
|
|
{
|
|
waddrmgr.ManagerError{Description: "human-readable error"},
|
|
"human-readable error",
|
|
},
|
|
|
|
// Encapsulated database error.
|
|
{
|
|
waddrmgr.ManagerError{
|
|
Description: "failed to store master private " +
|
|
"key parameters",
|
|
ErrorCode: waddrmgr.ErrDatabase,
|
|
Err: fmt.Errorf("underlying db error"),
|
|
},
|
|
"failed to store master private key parameters: " +
|
|
"underlying db error",
|
|
},
|
|
|
|
// Encapsulated key chain error.
|
|
{
|
|
waddrmgr.ManagerError{
|
|
Description: "failed to derive extended key " +
|
|
"branch 0",
|
|
ErrorCode: waddrmgr.ErrKeyChain,
|
|
Err: fmt.Errorf("underlying error"),
|
|
},
|
|
"failed to derive extended key branch 0: underlying " +
|
|
"error",
|
|
},
|
|
|
|
// Encapsulated crypto error.
|
|
{
|
|
waddrmgr.ManagerError{
|
|
Description: "failed to decrypt account 0 " +
|
|
"private key",
|
|
ErrorCode: waddrmgr.ErrCrypto,
|
|
Err: fmt.Errorf("underlying error"),
|
|
},
|
|
"failed to decrypt account 0 private key: underlying " +
|
|
"error",
|
|
},
|
|
}
|
|
|
|
t.Logf("Running %d tests", len(tests))
|
|
for i, test := range tests {
|
|
result := test.in.Error()
|
|
if result != test.want {
|
|
t.Errorf("Error #%d\ngot: %s\nwant: %s", i, result,
|
|
test.want)
|
|
continue
|
|
}
|
|
}
|
|
}
|