// Copyright (c) 2015-2016 The btcsuite developers // Use of this source code is governed by an ISC // license that can be found in the LICENSE file. package wallet import ( "errors" "fmt" "os" "path/filepath" "sync" "time" "github.com/btcsuite/btcd/chaincfg" "github.com/btcsuite/btcwallet/internal/prompt" "github.com/btcsuite/btcwallet/waddrmgr" "github.com/btcsuite/btcwallet/walletdb" ) const ( // WalletDBName specified the database filename for the wallet. WalletDBName = "wallet.db" // DefaultDBTimeout is the default timeout value when opening the wallet // database. DefaultDBTimeout = 60 * time.Second ) var ( // ErrLoaded describes the error condition of attempting to load or // create a wallet when the loader has already done so. ErrLoaded = errors.New("wallet already loaded") // ErrNotLoaded describes the error condition of attempting to close a // loaded wallet when a wallet has not been loaded. ErrNotLoaded = errors.New("wallet is not loaded") // ErrExists describes the error condition of attempting to create a new // wallet when one exists already. ErrExists = errors.New("wallet already exists") ) // Loader implements the creating of new and opening of existing wallets, while // providing a callback system for other subsystems to handle the loading of a // wallet. This is primarily intended for use by the RPC servers, to enable // methods and services which require the wallet when the wallet is loaded by // another subsystem. // // Loader is safe for concurrent access. type Loader struct { callbacks []func(*Wallet) chainParams *chaincfg.Params dbDirPath string noFreelistSync bool timeout time.Duration recoveryWindow uint32 wallet *Wallet localDB bool walletExists func() (bool, error) walletCreated func(db walletdb.ReadWriteTx) error db walletdb.DB mu sync.Mutex } // NewLoader constructs a Loader with an optional recovery window. If the // recovery window is non-zero, the wallet will attempt to recovery addresses // starting from the last SyncedTo height. func NewLoader(chainParams *chaincfg.Params, dbDirPath string, noFreelistSync bool, timeout time.Duration, recoveryWindow uint32) *Loader { return &Loader{ chainParams: chainParams, dbDirPath: dbDirPath, noFreelistSync: noFreelistSync, timeout: timeout, recoveryWindow: recoveryWindow, localDB: true, } } // NewLoaderWithDB constructs a Loader with an externally provided DB. This way // users are free to use their own walletdb implementation (eg. leveldb, etcd) // to store the wallet. Given that the external DB may be shared an additional // function is also passed which will override Loader.WalletExists(). func NewLoaderWithDB(chainParams *chaincfg.Params, recoveryWindow uint32, db walletdb.DB, walletExists func() (bool, error)) (*Loader, error) { if db == nil { return nil, fmt.Errorf("no DB provided") } if walletExists == nil { return nil, fmt.Errorf("unable to check if wallet exists") } return &Loader{ chainParams: chainParams, recoveryWindow: recoveryWindow, localDB: false, walletExists: walletExists, db: db, }, nil } // onLoaded executes each added callback and prevents loader from loading any // additional wallets. Requires mutex to be locked. func (l *Loader) onLoaded(w *Wallet) { for _, fn := range l.callbacks { fn(w) } l.wallet = w l.callbacks = nil // not needed anymore } // RunAfterLoad adds a function to be executed when the loader creates or opens // a wallet. Functions are executed in a single goroutine in the order they are // added. func (l *Loader) RunAfterLoad(fn func(*Wallet)) { l.mu.Lock() if l.wallet != nil { w := l.wallet l.mu.Unlock() fn(w) } else { l.callbacks = append(l.callbacks, fn) l.mu.Unlock() } } // OnWalletCreated adds a function that will be executed the wallet structure // is initialized in the wallet database. This is useful if users want to add // extra fields in the same transaction (eg. to flag wallet existence). func (l *Loader) OnWalletCreated(fn func(walletdb.ReadWriteTx) error) { l.mu.Lock() defer l.mu.Unlock() l.walletCreated = fn } // CreateNewWallet creates a new wallet using the provided public and private // passphrases. The seed is optional. If non-nil, addresses are derived from // this seed. If nil, a secure random seed is generated. func (l *Loader) CreateNewWallet(pubPassphrase, privPassphrase, seed []byte, bday time.Time) (*Wallet, error) { return l.createNewWallet( pubPassphrase, privPassphrase, seed, bday, false, ) } // CreateNewWatchingOnlyWallet creates a new wallet using the provided // public passphrase. No seed or private passphrase may be provided // since the wallet is watching-only. func (l *Loader) CreateNewWatchingOnlyWallet(pubPassphrase []byte, bday time.Time) (*Wallet, error) { return l.createNewWallet( pubPassphrase, nil, nil, bday, true, ) } func (l *Loader) createNewWallet(pubPassphrase, privPassphrase, seed []byte, bday time.Time, isWatchingOnly bool) (*Wallet, error) { defer l.mu.Unlock() l.mu.Lock() if l.wallet != nil { return nil, ErrLoaded } exists, err := l.WalletExists() if err != nil { return nil, err } if exists { return nil, ErrExists } if l.localDB { dbPath := filepath.Join(l.dbDirPath, WalletDBName) // Create the wallet database backed by bolt db. err = os.MkdirAll(l.dbDirPath, 0700) if err != nil { return nil, err } l.db, err = walletdb.Create( "bdb", dbPath, l.noFreelistSync, l.timeout, ) if err != nil { return nil, err } } // Initialize the newly created database for the wallet before opening. if isWatchingOnly { err := CreateWatchingOnlyWithCallback( l.db, pubPassphrase, l.chainParams, bday, l.walletCreated, ) if err != nil { return nil, err } } else { err := CreateWithCallback( l.db, pubPassphrase, privPassphrase, seed, l.chainParams, bday, l.walletCreated, ) if err != nil { return nil, err } } // Open the newly-created wallet. w, err := Open(l.db, pubPassphrase, nil, l.chainParams, l.recoveryWindow) if err != nil { return nil, err } w.Start() l.onLoaded(w) return w, nil } var errNoConsole = errors.New("db upgrade requires console access for additional input") func noConsole() ([]byte, error) { return nil, errNoConsole } // OpenExistingWallet opens the wallet from the loader's wallet database path // and the public passphrase. If the loader is being called by a context where // standard input prompts may be used during wallet upgrades, setting // canConsolePrompt will enables these prompts. func (l *Loader) OpenExistingWallet(pubPassphrase []byte, canConsolePrompt bool) (*Wallet, error) { defer l.mu.Unlock() l.mu.Lock() if l.wallet != nil { return nil, ErrLoaded } if l.localDB { var err error // Ensure that the network directory exists. if err = checkCreateDir(l.dbDirPath); err != nil { return nil, err } // Open the database using the boltdb backend. dbPath := filepath.Join(l.dbDirPath, WalletDBName) l.db, err = walletdb.Open( "bdb", dbPath, l.noFreelistSync, l.timeout, ) if err != nil { log.Errorf("Failed to open database: %v", err) return nil, err } } var cbs *waddrmgr.OpenCallbacks if canConsolePrompt { cbs = &waddrmgr.OpenCallbacks{ ObtainSeed: prompt.ProvideSeed, ObtainPrivatePass: prompt.ProvidePrivPassphrase, } } else { cbs = &waddrmgr.OpenCallbacks{ ObtainSeed: noConsole, ObtainPrivatePass: noConsole, } } w, err := Open(l.db, pubPassphrase, cbs, l.chainParams, l.recoveryWindow) if err != nil { // If opening the wallet fails (e.g. because of wrong // passphrase), we must close the backing database to // allow future calls to walletdb.Open(). if l.localDB { e := l.db.Close() if e != nil { log.Warnf("Error closing database: %v", e) } } return nil, err } w.Start() l.onLoaded(w) return w, nil } // WalletExists returns whether a file exists at the loader's database path. // This may return an error for unexpected I/O failures. func (l *Loader) WalletExists() (bool, error) { if l.localDB { dbPath := filepath.Join(l.dbDirPath, WalletDBName) return fileExists(dbPath) } return l.walletExists() } // LoadedWallet returns the loaded wallet, if any, and a bool for whether the // wallet has been loaded or not. If true, the wallet pointer should be safe to // dereference. func (l *Loader) LoadedWallet() (*Wallet, bool) { l.mu.Lock() w := l.wallet l.mu.Unlock() return w, w != nil } // UnloadWallet stops the loaded wallet, if any, and closes the wallet database. // This returns ErrNotLoaded if the wallet has not been loaded with // CreateNewWallet or LoadExistingWallet. The Loader may be reused if this // function returns without error. func (l *Loader) UnloadWallet() error { defer l.mu.Unlock() l.mu.Lock() if l.wallet == nil { return ErrNotLoaded } l.wallet.Stop() l.wallet.WaitForShutdown() if l.localDB { err := l.db.Close() if err != nil { return err } } l.wallet = nil l.db = nil return nil } func fileExists(filePath string) (bool, error) { _, err := os.Stat(filePath) if err != nil { if os.IsNotExist(err) { return false, nil } return false, err } return true, nil }