fcoin/lib/wallet/walletdb.js
Christopher Jeffrey 69242f5228
walletdb: refactor.
2016-11-09 18:25:33 -08:00

2095 lines
42 KiB
JavaScript

/*!
* walletdb.js - storage for wallets
* Copyright (c) 2014-2015, Fedor Indutny (MIT License)
* Copyright (c) 2014-2016, Christopher Jeffrey (MIT License).
* https://github.com/bcoin-org/bcoin
*/
'use strict';
var AsyncObject = require('../utils/async');
var utils = require('../utils/utils');
var co = require('../utils/co');
var Locker = require('../utils/locker');
var LRU = require('../utils/lru');
var crypto = require('../crypto/crypto');
var assert = require('assert');
var constants = require('../protocol/constants');
var Network = require('../protocol/network');
var Path = require('./path');
var Wallet = require('./wallet');
var Account = require('./account');
var ldb = require('../db/ldb');
var Bloom = require('../utils/bloom');
var Logger = require('../node/logger');
var TX = require('../primitives/tx');
var Outpoint = require('../primitives/outpoint');
var records = require('./records');
var ChainState = records.ChainState;
var BlockMapRecord = records.BlockMapRecord;
var BlockMeta = records.BlockMeta;
var PathMapRecord = records.PathMapRecord;
var OutpointMapRecord = records.OutpointMapRecord;
var TXDB = require('./txdb');
var U32 = utils.U32;
/*
* Database Layout:
* p[addr-hash] -> wallet ids
* P[wid][addr-hash] -> path data
* w[wid] -> wallet
* l[id] -> wid
* a[wid][index] -> account
* i[wid][name] -> account index
* t[wid]* -> txdb
* R -> chain sync state
* h[height] -> recent block hash
* b[height] -> block->wid map
* o[hash][index] -> outpoint->wid map
*/
var layout = {
p: function p(hash) {
var key = new Buffer(1 + (hash.length / 2));
key[0] = 0x70;
key.write(hash, 1, 'hex');
return key;
},
pp: function pp(key) {
return key.toString('hex', 1);
},
P: function P(wid, hash) {
var key = new Buffer(1 + 4 + (hash.length / 2));
key[0] = 0x50;
key.writeUInt32BE(wid, 1, true);
key.write(hash, 5, 'hex');
return key;
},
Pp: function Pp(key) {
return key.toString('hex', 5);
},
w: function w(wid) {
var key = new Buffer(5);
key[0] = 0x77;
key.writeUInt32BE(wid, 1, true);
return key;
},
ww: function ww(key) {
return key.readUInt32BE(1, true);
},
l: function l(id) {
var len = Buffer.byteLength(id, 'ascii');
var key = new Buffer(1 + len);
key[0] = 0x6c;
if (len > 0)
key.write(id, 1, 'ascii');
return key;
},
ll: function ll(key) {
return key.toString('ascii', 1);
},
a: function a(wid, index) {
var key = new Buffer(9);
key[0] = 0x61;
key.writeUInt32BE(wid, 1, true);
key.writeUInt32BE(index, 5, true);
return key;
},
i: function i(wid, name) {
var len = Buffer.byteLength(name, 'ascii');
var key = new Buffer(5 + len);
key[0] = 0x69;
key.writeUInt32BE(wid, 1, true);
if (len > 0)
key.write(name, 5, 'ascii');
return key;
},
ii: function ii(key) {
return [key.readUInt32BE(1, true), key.toString('ascii', 5)];
},
R: new Buffer([0x52]),
h: function h(height) {
var key = new Buffer(5);
key[0] = 0x68;
key.writeUInt32BE(height, 1, true);
return key;
},
b: function b(height) {
var key = new Buffer(5);
key[0] = 0x62;
key.writeUInt32BE(height, 1, true);
return key;
},
bb: function bb(key) {
return key.readUInt32BE(1, true);
},
o: function o(hash, index) {
var key = new Buffer(37);
key[0] = 0x6f;
key.write(hash, 1, 'hex');
key.writeUInt32BE(index, 33, true);
return key;
},
oo: function oo(key) {
return [key.toString('hex', 1, 33), key.readUInt32BE(33, true)];
}
};
if (utils.isBrowser)
layout = require('./browser').walletdb;
/**
* WalletDB
* @exports WalletDB
* @constructor
* @param {Object} options
* @param {String?} options.name - Database name.
* @param {String?} options.location - Database file location.
* @param {String?} options.db - Database backend (`"leveldb"` by default).
* @param {Boolean?} options.verify - Verify transactions as they
* come in (note that this will not happen on the worker pool).
* @property {Boolean} loaded
*/
function WalletDB(options) {
if (!(this instanceof WalletDB))
return new WalletDB(options);
if (!options)
options = {};
AsyncObject.call(this);
this.options = options;
this.network = Network.get(options.network);
this.logger = options.logger || Logger.global;
this.client = options.client;
this.state = new ChainState();
this.depth = 0;
this.wallets = {};
this.keepBlocks = this.network.block.keepBlocks;
// We need one read lock for `get` and `create`.
// It will hold locks specific to wallet ids.
this.readLock = new Locker.Mapped();
this.writeLock = new Locker();
this.txLock = new Locker();
this.widCache = new LRU(10000);
this.pathMapCache = new LRU(100000);
// Try to optimize for up to 1m addresses.
// We use a regular bloom filter here
// because we never want members to
// lose membership, even if quality
// degrades.
// Memory used: 1.7mb
this.filter = Bloom.fromRate(1000000, 0.001, -1);
this.db = ldb({
location: this.options.location,
db: this.options.db,
maxOpenFiles: this.options.maxFiles,
cacheSize: 8 << 20,
writeBufferSize: 4 << 20,
bufferKeys: !utils.isBrowser
});
}
utils.inherits(WalletDB, AsyncObject);
/**
* Database layout.
* @type {Object}
*/
WalletDB.layout = layout;
/**
* Open the walletdb, wait for the database to load.
* @alias WalletDB#open
* @returns {Promise}
*/
WalletDB.prototype._open = co(function* open() {
yield this.db.open();
yield this.db.checkVersion('V', 5);
this.depth = yield this.getDepth();
if (this.options.wipeNoReally)
yield this.wipe();
yield this.init();
yield this.watch();
yield this.sync();
yield this.resend();
this.logger.info(
'WalletDB loaded (depth=%d, height=%d, start=%d).',
this.depth,
this.state.height,
this.state.startHeight);
});
/**
* Close the walletdb, wait for the database to close.
* @alias WalletDB#close
* @returns {Promise}
*/
WalletDB.prototype._close = co(function* close() {
var keys = Object.keys(this.wallets);
var i, key, wallet;
for (i = 0; i < keys.length; i++) {
key = keys[i];
wallet = this.wallets[key];
yield wallet.destroy();
}
yield this.db.close();
});
/**
* Watch addresses and outpoints.
* @private
* @returns {Promise}
*/
WalletDB.prototype.watch = co(function* watch() {
var hashes = yield this.getHashes();
var outpoints = yield this.getOutpoints();
var chunks = [];
var i, hash, outpoint;
for (i = 0; i < hashes.length; i++) {
hash = hashes[i];
chunks.push(hash);
}
for (i = 0; i < outpoints.length; i++) {
outpoint = outpoints[i];
chunks.push(outpoint.toRaw());
}
this.logger.info('Adding %d chunks to WalletDB filter.', chunks.length);
this.addFilter(chunks);
});
/**
* Connect and sync with the chain server.
* @returns {Promise}
*/
WalletDB.prototype.sync = co(function* sync() {
var unlock = yield this.txLock.lock();
try {
return yield this._sync();
} finally {
unlock();
}
});
/**
* Connect and sync with the chain server (without a lock).
* @private
* @returns {Promise}
*/
WalletDB.prototype._sync = co(function* connect() {
var height = this.state.height;
var tip, entry;
if (!this.client)
return;
while (height >= 0) {
tip = yield this.getBlock(height);
if (!tip)
break;
entry = yield this.client.getEntry(tip.hash);
if (entry)
break;
height--;
}
if (!entry) {
height = this.state.startHeight;
entry = yield this.client.getEntry(this.state.startHash);
if (!entry)
height = 0;
}
yield this.scan(height);
});
/**
* Force a rescan.
* @param {Number} height
* @returns {Promise}
*/
WalletDB.prototype.rescan = co(function* rescan(height) {
var unlock = yield this.txLock.lock();
try {
return yield this._rescan(height);
} finally {
unlock();
}
});
/**
* Force a rescan (without a lock).
* @private
* @param {Number} height
* @returns {Promise}
*/
WalletDB.prototype._rescan = co(function* rescan(height) {
return yield this.scan(height);
});
/**
* Rescan blockchain from a given height.
* @private
* @param {Number} height
* @returns {Promise}
*/
WalletDB.prototype.scan = co(function* scan(height) {
var self = this;
var tip;
if (!this.client)
return;
if (height == null)
height = this.state.startHeight;
assert(utils.isUInt32(height), 'WDB: Must pass in a height.');
yield this.rollback(height);
this.logger.info(
'WalletDB is scanning %d blocks.',
this.state.height - height + 1);
tip = yield this.getTip();
yield this.client.scan(tip.hash, this.filter, function(block, txs) {
return self._addBlock(block, txs);
});
});
/**
* Add address or outpoints to chain server filter.
* @param {Hashes[]} chunks
* @returns {Promise}
*/
WalletDB.prototype.watchData = co(function* watchData(chunks) {
if (!this.client) {
this.emit('watch data', chunks);
return;
}
yield this.client.watchData(chunks);
});
/**
* Broadcast a transaction via chain server.
* @param {TX} tx
* @returns {Promise}
*/
WalletDB.prototype.send = co(function* send(tx) {
if (!this.client) {
this.emit('send', tx);
return;
}
yield this.client.send(tx);
});
/**
* Estimate smart fee from chain server.
* @param {Number} blocks
* @returns {Promise}
*/
WalletDB.prototype.estimateFee = co(function* estimateFee(blocks) {
if (!this.client)
return this.network.feeRate;
return yield this.client.estimateFee(blocks);
});
/**
* Backup the wallet db.
* @param {String} path
* @returns {Promise}
*/
WalletDB.prototype.backup = function backup(path) {
return this.db.backup(path);
};
/**
* Wipe the txdb - NEVER USE.
* @returns {Promise}
*/
WalletDB.prototype.wipe = co(function* wipe() {
var batch = this.db.batch();
var dummy = new Buffer(0);
var i, keys, key, gte, lte;
this.logger.warning('Wiping WalletDB TXDB...');
this.logger.warning('I hope you know what you\'re doing.');
// All TXDB records
keys = yield this.db.keys({
gte: TXDB.layout.prefix(0x00000000, dummy),
lte: TXDB.layout.prefix(0xffffffff, dummy)
});
for (i = 0; i < keys.length; i++) {
key = keys[i];
batch.del(key);
}
// All recent block hashes
keys = yield this.db.keys({
gte: layout.h(0),
lte: layout.h(0xffffffff)
});
for (i = 0; i < keys.length; i++) {
key = keys[i];
batch.del(key);
}
// The state record
batch.del(layout.R);
// All block maps
keys = yield this.db.keys({
gte: layout.b(0),
lte: layout.b(0xffffffff)
});
for (i = 0; i < keys.length; i++) {
key = keys[i];
batch.del(key);
}
// All outpoint maps
keys = yield this.db.keys({
gte: layout.o(constants.NULL_HASH, 0),
lte: layout.o(constants.HIGH_HASH, 0xffffffff)
});
for (i = 0; i < keys.length; i++) {
key = keys[i];
batch.del(key);
}
// All TX maps (e -- old)
gte = new Buffer(33);
gte.fill(0);
gte[0] = 0x65;
lte = new Buffer(33);
lte.fill(255);
lte[0] = 0x65;
keys = yield this.db.keys({
gte: gte,
lte: lte
});
for (i = 0; i < keys.length; i++) {
key = keys[i];
batch.del(key);
}
// All block maps (b -- 32 byte old)
gte = new Buffer(33);
gte.fill(0);
gte[0] = 0x62;
lte = new Buffer(33);
lte.fill(255);
lte[0] = 0x62;
keys = yield this.db.keys({
gte: gte,
lte: lte
});
for (i = 0; i < keys.length; i++) {
key = keys[i];
batch.del(key);
}
// All block records (c -- old)
gte = new Buffer(33);
gte.fill(0);
gte[0] = 0x63;
lte = new Buffer(33);
lte.fill(255);
lte[0] = 0x63;
keys = yield this.db.keys({
gte: gte,
lte: lte
});
for (i = 0; i < keys.length; i++) {
key = keys[i];
batch.del(key);
}
yield batch.write();
});
/**
* Get current wallet wid depth.
* @private
* @returns {Promise}
*/
WalletDB.prototype.getDepth = co(function* getDepth() {
var iter, item, depth;
// This may seem like a strange way to do
// this, but updating a global state when
// creating a new wallet is actually pretty
// damn tricky. There would be major atomicity
// issues if updating a global state inside
// a "scoped" state. So, we avoid all the
// nonsense of adding a global lock to
// walletdb.create by simply seeking to the
// highest wallet wid.
iter = this.db.iterator({
gte: layout.w(0x00000000),
lte: layout.w(0xffffffff),
reverse: true
});
item = yield iter.next();
if (!item)
return 1;
yield iter.end();
depth = layout.ww(item.key);
return depth + 1;
});
/**
* Start batch.
* @private
* @param {WalletID} wid
*/
WalletDB.prototype.start = function start(wallet) {
assert(!wallet.current, 'WDB: Batch already started.');
wallet.current = this.db.batch();
wallet.accountCache.start();
wallet.pathCache.start();
return wallet.current;
};
/**
* Drop batch.
* @private
* @param {WalletID} wid
*/
WalletDB.prototype.drop = function drop(wallet) {
var batch = this.batch(wallet);
wallet.current = null;
wallet.accountCache.drop();
wallet.pathCache.drop();
batch.clear();
};
/**
* Clear batch.
* @private
* @param {WalletID} wid
*/
WalletDB.prototype.clear = function clear(wallet) {
var batch = this.batch(wallet);
wallet.accountCache.clear();
wallet.pathCache.clear();
batch.clear();
};
/**
* Get batch.
* @private
* @param {WalletID} wid
* @returns {Leveldown.Batch}
*/
WalletDB.prototype.batch = function batch(wallet) {
assert(wallet.current, 'WDB: Batch does not exist.');
return wallet.current;
};
/**
* Save batch.
* @private
* @param {WalletID} wid
* @returns {Promise}
*/
WalletDB.prototype.commit = co(function* commit(wallet) {
var batch = this.batch(wallet);
try {
yield batch.write();
} catch (e) {
wallet.current = null;
wallet.accountCache.drop();
wallet.pathCache.drop();
throw e;
}
wallet.current = null;
wallet.accountCache.commit();
wallet.pathCache.commit();
});
/**
* Test the bloom filter against a tx or address hash.
* @private
* @param {Hash} hash
* @returns {Boolean}
*/
WalletDB.prototype.testFilter = function testFilter(data) {
return this.filter.test(data, 'hex');
};
/**
* Add hash to filter.
* @private
* @param {Hash} hash
*/
WalletDB.prototype.addFilter = function addFilter(chunks) {
var i, data;
if (!Array.isArray(chunks))
chunks = [chunks];
if (this.client)
this.client.watchData(chunks);
for (i = 0; i < chunks.length; i++) {
data = chunks[i];
this.filter.add(data, 'hex');
}
};
/**
* Dump database (for debugging).
* @returns {Promise} - Returns Object.
*/
WalletDB.prototype.dump = function dump() {
return this.db.dump();
};
/**
* Register an object with the walletdb.
* @param {Object} object
*/
WalletDB.prototype.register = function register(wallet) {
assert(!this.wallets[wallet.wid]);
this.wallets[wallet.wid] = wallet;
};
/**
* Unregister a object with the walletdb.
* @param {Object} object
* @returns {Boolean}
*/
WalletDB.prototype.unregister = function unregister(wallet) {
assert(this.wallets[wallet.wid]);
delete this.wallets[wallet.wid];
};
/**
* Map wallet label to wallet id.
* @param {String} label
* @returns {Promise}
*/
WalletDB.prototype.getWalletID = co(function* getWalletID(id) {
var wid, data;
if (!id)
return;
if (typeof id === 'number')
return id;
wid = this.widCache.get(id);
if (wid)
return wid;
data = yield this.db.get(layout.l(id));
if (!data)
return;
wid = data.readUInt32LE(0, true);
this.widCache.set(id, wid);
return wid;
});
/**
* Get a wallet from the database, setup watcher.
* @param {WalletID} wid
* @returns {Promise} - Returns {@link Wallet}.
*/
WalletDB.prototype.get = co(function* get(id) {
var wid = yield this.getWalletID(id);
var unlock;
if (!wid)
return;
unlock = yield this.readLock.lock(wid);
try {
return yield this._get(wid);
} finally {
unlock();
}
});
/**
* Get a wallet from the database without a lock.
* @private
* @param {WalletID} wid
* @returns {Promise} - Returns {@link Wallet}.
*/
WalletDB.prototype._get = co(function* get(wid) {
var wallet = this.wallets[wid];
var data;
if (wallet)
return wallet;
data = yield this.db.get(layout.w(wid));
if (!data)
return;
wallet = Wallet.fromRaw(this, data);
yield wallet.open();
this.register(wallet);
return wallet;
});
/**
* Save a wallet to the database.
* @param {Wallet} wallet
*/
WalletDB.prototype.save = function save(wallet) {
var wid = wallet.wid;
var id = wallet.id;
var batch = this.batch(wallet);
this.widCache.set(id, wid);
batch.put(layout.w(wid), wallet.toRaw());
batch.put(layout.l(id), U32(wid));
};
/**
* Rename a wallet.
* @param {Wallet} wallet
* @param {String} id
* @returns {Promise}
*/
WalletDB.prototype.rename = co(function* rename(wallet, id) {
var unlock = yield this.writeLock.lock();
try {
return yield this._rename(wallet, id);
} finally {
unlock();
}
});
/**
* Rename a wallet without a lock.
* @private
* @param {Wallet} wallet
* @param {String} id
* @returns {Promise}
*/
WalletDB.prototype._rename = co(function* _rename(wallet, id) {
var old = wallet.id;
var i, paths, path, batch;
if (!utils.isName(id))
throw new Error('WDB: Bad wallet ID.');
if (yield this.has(id))
throw new Error('WDB: ID not available.');
batch = this.start(wallet);
batch.del(layout.l(old));
wallet.id = id;
this.save(wallet);
yield this.commit(wallet);
this.widCache.remove(old);
paths = wallet.pathCache.values();
for (i = 0; i < paths.length; i++) {
path = paths[i];
path.id = id;
}
});
/**
* Rename an account.
* @param {Account} account
* @param {String} name
*/
WalletDB.prototype.renameAccount = function renameAccount(account, name) {
var wallet = account.wallet;
var batch = this.batch(wallet);
batch.del(layout.i(account.wid, account.name));
account.name = name;
this.saveAccount(account);
};
/**
* Test an api key against a wallet's api key.
* @param {WalletID} wid
* @param {String|Buffer} token
* @returns {Promise}
*/
WalletDB.prototype.auth = co(function* auth(wid, token) {
var wallet = yield this.get(wid);
if (!wallet)
return;
if (typeof token === 'string') {
if (!utils.isHex256(token))
throw new Error('WDB: Authentication error.');
token = new Buffer(token, 'hex');
}
// Compare in constant time:
if (!crypto.ccmp(token, wallet.token))
throw new Error('WDB: Authentication error.');
return wallet;
});
/**
* Create a new wallet, save to database, setup watcher.
* @param {Object} options - See {@link Wallet}.
* @returns {Promise} - Returns {@link Wallet}.
*/
WalletDB.prototype.create = co(function* create(options) {
var unlock = yield this.writeLock.lock();
if (!options)
options = {};
try {
return yield this._create(options);
} finally {
unlock();
}
});
/**
* Create a new wallet, save to database without a lock.
* @private
* @param {Object} options - See {@link Wallet}.
* @returns {Promise} - Returns {@link Wallet}.
*/
WalletDB.prototype._create = co(function* create(options) {
var exists = yield this.has(options.id);
var wallet;
if (exists)
throw new Error('WDB: Wallet already exists.');
wallet = Wallet.fromOptions(this, options);
wallet.wid = this.depth++;
yield wallet.init(options);
this.register(wallet);
this.logger.info('Created wallet %s in WalletDB.', wallet.id);
return wallet;
});
/**
* Test for the existence of a wallet.
* @param {WalletID} id
* @returns {Promise}
*/
WalletDB.prototype.has = co(function* has(id) {
var wid = yield this.getWalletID(id);
return wid != null;
});
/**
* Attempt to create wallet, return wallet if already exists.
* @param {Object} options - See {@link Wallet}.
* @returns {Promise}
*/
WalletDB.prototype.ensure = co(function* ensure(options) {
var wallet = yield this.get(options.id);
if (wallet)
return wallet;
return yield this.create(options);
});
/**
* Get an account from the database by wid.
* @private
* @param {WalletID} wid
* @param {Number} index - Account index.
* @returns {Promise} - Returns {@link Wallet}.
*/
WalletDB.prototype.getAccount = co(function* getAccount(wid, index) {
var data = yield this.db.get(layout.a(wid, index));
if (!data)
return;
return Account.fromRaw(this, data);
});
/**
* List account names and indexes from the db.
* @param {WalletID} wid
* @returns {Promise} - Returns Array.
*/
WalletDB.prototype.getAccounts = co(function* getAccounts(wid) {
var map = [];
var i, items, item, name, index, accounts;
items = yield this.db.range({
gte: layout.i(wid, '\x00'),
lte: layout.i(wid, '\xff')
});
for (i = 0; i < items.length; i++) {
item = items[i];
name = layout.ii(item.key)[1];
index = item.value.readUInt32LE(0, true);
map[index] = name;
}
// Get it out of hash table mode.
accounts = [];
for (i = 0; i < map.length; i++) {
assert(map[i] != null);
accounts.push(map[i]);
}
return accounts;
});
/**
* Lookup the corresponding account name's index.
* @param {WalletID} wid
* @param {String|Number} name - Account name/index.
* @returns {Promise} - Returns Number.
*/
WalletDB.prototype.getAccountIndex = co(function* getAccountIndex(wid, name) {
var index = yield this.db.get(layout.i(wid, name));
if (!index)
return -1;
return index.readUInt32LE(0, true);
});
/**
* Save an account to the database.
* @param {Account} account
* @returns {Promise}
*/
WalletDB.prototype.saveAccount = function saveAccount(account) {
var wid = account.wid;
var wallet = account.wallet;
var index = account.accountIndex;
var name = account.name;
var batch = this.batch(wallet);
batch.put(layout.a(wid, index), account.toRaw());
batch.put(layout.i(wid, name), U32(index));
wallet.accountCache.push(index, account);
};
/**
* Test for the existence of an account.
* @param {WalletID} wid
* @param {String|Number} acct
* @returns {Promise} - Returns Boolean.
*/
WalletDB.prototype.hasAccount = function hasAccount(wid, index) {
return this.db.has(layout.a(wid, index));
};
/**
* Lookup the corresponding account name's index.
* @param {WalletID} wid
* @param {String|Number} name - Account name/index.
* @returns {Promise} - Returns Number.
*/
WalletDB.prototype.getPathMap = co(function* getPathMap(hash) {
var map = this.pathMapCache.get(hash);
var data;
if (map)
return map;
data = yield this.db.get(layout.p(hash));
if (!data)
return;
map = PathMapRecord.fromRaw(hash, data);
this.pathMapCache.set(hash, map);
return map;
});
/**
* Save an address to the path map.
* @param {WalletID} wid
* @param {KeyRing[]} ring
* @returns {Promise}
*/
WalletDB.prototype.saveKey = function saveKey(wallet, ring) {
return this.savePath(wallet, ring.toPath());
};
/**
* Save a path to the path map.
*
* The path map exists in the form of:
* - `p[address-hash] -> wids`
* - `P[wid][address-hash] -> path`
*
* @param {WalletID} wid
* @param {Path[]} path
* @returns {Promise}
*/
WalletDB.prototype.savePath = co(function* savePath(wallet, path) {
var wid = wallet.wid;
var hash = path.hash;
var batch = this.batch(wallet);
var map;
this.addFilter(hash);
map = yield this.getPathMap(hash);
if (!map)
map = new PathMapRecord(hash);
if (!map.add(wid))
return;
this.pathMapCache.set(hash, map);
wallet.pathCache.push(hash, path);
batch.put(layout.p(hash), map.toRaw());
batch.put(layout.P(wid, hash), path.toRaw());
});
/**
* Retrieve path by hash.
* @param {WalletID} wid
* @param {Hash} hash
* @returns {Promise}
*/
WalletDB.prototype.getPath = co(function* getPath(wid, hash) {
var data = yield this.db.get(layout.P(wid, hash));
var path;
if (!data)
return;
path = Path.fromRaw(data);
path.wid = wid;
path.hash = hash;
return path;
});
/**
* Test whether a wallet contains a path.
* @param {WalletID} wid
* @param {Hash} hash
* @returns {Promise}
*/
WalletDB.prototype.hasPath = co(function* hasPath(wid, hash) {
var data = yield this.db.get(layout.P(wid, hash));
return data != null;
});
/**
* Get all address hashes.
* @returns {Promise}
*/
WalletDB.prototype.getHashes = function getHashes() {
return this.db.keys({
gte: layout.p(constants.NULL_HASH),
lte: layout.p(constants.HIGH_HASH),
parse: layout.pp
});
};
/**
* Get all tx hashes.
* @returns {Promise}
*/
WalletDB.prototype.getTXHashes = function getTXHashes() {
return this.db.keys({
gte: layout.e(constants.NULL_HASH),
lte: layout.e(constants.HIGH_HASH),
parse: layout.ee
});
};
/**
* Get all tx hashes.
* @returns {Promise}
*/
WalletDB.prototype.getOutpoints = function getOutpoints() {
return this.db.keys({
gte: layout.o(constants.NULL_HASH, 0),
lte: layout.o(constants.HIGH_HASH, 0xffffffff),
parse: function(key) {
var items = layout.oo(key);
return new Outpoint(items[0], items[1]);
}
});
};
/**
* Get all address hashes.
* @param {WalletID} wid
* @returns {Promise}
*/
WalletDB.prototype.getWalletHashes = function getWalletHashes(wid) {
return this.db.keys({
gte: layout.P(wid, constants.NULL_HASH),
lte: layout.P(wid, constants.HIGH_HASH),
parse: layout.Pp
});
};
/**
* Get all paths for a wallet.
* @param {WalletID} wid
* @returns {Promise}
*/
WalletDB.prototype.getWalletPaths = co(function* getWalletPaths(wid) {
var i, item, items, hash, path;
items = yield this.db.range({
gte: layout.P(wid, constants.NULL_HASH),
lte: layout.P(wid, constants.HIGH_HASH)
});
for (i = 0; i < items.length; i++) {
item = items[i];
hash = layout.Pp(item.key);
path = Path.fromRaw(item.value);
path.hash = hash;
path.wid = wid;
items[i] = path;
}
return items;
});
/**
* Get all wallet ids.
* @returns {Promise}
*/
WalletDB.prototype.getWallets = function getWallets() {
return this.db.keys({
gte: layout.l('\x00'),
lte: layout.l('\xff'),
parse: layout.ll
});
};
/**
* Encrypt all imported keys for a wallet.
* @param {WalletID} wid
* @returns {Promise}
*/
WalletDB.prototype.encryptKeys = co(function* encryptKeys(wallet, key) {
var wid = wallet.wid;
var paths = yield wallet.getPaths();
var batch = this.batch(wallet);
var i, path, iv;
for (i = 0; i < paths.length; i++) {
path = paths[i];
if (!path.data)
continue;
assert(!path.encrypted);
iv = new Buffer(path.hash, 'hex');
iv = iv.slice(0, 16);
path = path.clone();
path.data = crypto.encipher(path.data, key, iv);
path.encrypted = true;
wallet.pathCache.push(path.hash, path);
batch.put(layout.P(wid, path.hash), path.toRaw());
}
});
/**
* Decrypt all imported keys for a wallet.
* @param {WalletID} wid
* @returns {Promise}
*/
WalletDB.prototype.decryptKeys = co(function* decryptKeys(wallet, key) {
var wid = wallet.wid;
var paths = yield wallet.getPaths();
var batch = this.batch(wallet);
var i, path, iv;
for (i = 0; i < paths.length; i++) {
path = paths[i];
if (!path.data)
continue;
assert(path.encrypted);
iv = new Buffer(path.hash, 'hex');
iv = iv.slice(0, 16);
path = path.clone();
path.data = crypto.decipher(path.data, key, iv);
path.encrypted = false;
wallet.pathCache.push(path.hash, path);
batch.put(layout.P(wid, path.hash), path.toRaw());
}
});
/**
* Get keys of all pending transactions
* in the wallet db (for resending).
* @returns {Promise}
*/
WalletDB.prototype.getPendingKeys = co(function* getPendingKeys() {
var layout = TXDB.layout;
var dummy = new Buffer(0);
var keys = [];
var iter, item;
iter = this.db.iterator({
gte: layout.prefix(0x00000000, dummy),
lte: layout.prefix(0xffffffff, dummy)
});
for (;;) {
item = yield iter.next();
if (!item)
break;
if (item.key[5] === 0x70)
keys.push(item.key);
}
return keys;
});
/**
* Get keys of all pending transactions
* in the wallet db (for resending).
* @returns {Promise}
*/
WalletDB.prototype.getPendingTX = co(function* getPendingTX() {
var layout = TXDB.layout;
var keys = yield this.getPendingKeys();
var uniq = {};
var result = [];
var i, key, wid, hash;
for (i = 0; i < keys.length; i++) {
key = keys[i];
wid = layout.pre(key);
hash = layout.pp(key);
if (uniq[hash])
continue;
uniq[hash] = true;
key = layout.prefix(wid, layout.t(hash));
result.push(key);
}
return result;
});
/**
* Resend all pending transactions.
* @returns {Promise}
*/
WalletDB.prototype.resend = co(function* resend() {
var keys = yield this.getPendingTX();
var i, key, data, tx;
if (keys.length > 0)
this.logger.info('Rebroadcasting %d WalletDB transactions.', keys.length);
for (i = 0; i < keys.length; i++) {
key = keys[i];
data = yield this.db.get(key);
if (!data)
continue;
tx = TX.fromExtended(data);
if (tx.isCoinbase())
continue;
yield this.send(tx);
}
});
/**
* Get all wallet ids by output addresses and outpoints.
* @param {Hash[]} hashes
* @returns {Promise}
*/
WalletDB.prototype.getWalletsByTX = co(function* getWalletsByTX(tx) {
var hashes = tx.getOutputHashes('hex');
var result = [];
var i, j, input, prevout, hash, map;
if (!tx.isCoinbase()) {
for (i = 0; i < tx.inputs.length; i++) {
input = tx.inputs[i];
prevout = input.prevout;
if (!this.testFilter(prevout.toRaw())) {
// Special behavior for SPV.
if (this.options.resolution) {
hash = input.getHash('hex');
if (!hash)
continue;
if (!this.testFilter(hash))
continue;
map = yield this.getPathMap(hash);
if (!map)
continue;
for (j = 0; j < map.wids.length; j++)
utils.binaryInsert(result, map.wids[j], cmp, true);
}
continue;
}
map = yield this.getOutpointMap(prevout.hash, prevout.index);
if (!map)
continue;
for (j = 0; j < map.wids.length; j++)
utils.binaryInsert(result, map.wids[j], cmp, true);
}
}
for (i = 0; i < hashes.length; i++) {
hash = hashes[i];
if (!this.testFilter(hash))
continue;
map = yield this.getPathMap(hash);
if (!map)
continue;
for (j = 0; j < map.wids.length; j++)
utils.binaryInsert(result, map.wids[j], cmp, true);
}
if (result.length === 0)
return;
return result;
});
/**
* Write the genesis block as the best hash.
* @returns {Promise}
*/
WalletDB.prototype.init = co(function* init() {
var state = yield this.getState();
var tip;
if (state) {
this.state = state;
return;
}
if (this.client) {
tip = yield this.client.getTip();
tip = BlockMeta.fromEntry(tip);
} else {
tip = BlockMeta.fromEntry(this.network.genesis);
}
this.logger.info(
'Initializing WalletDB chain state at %s (%d).',
utils.revHex(tip.hash), tip.height);
yield this.resetState(tip);
});
/**
* Get the best block hash.
* @returns {Promise}
*/
WalletDB.prototype.getState = co(function* getState() {
var data = yield this.db.get(layout.R);
if (!data)
return;
return ChainState.fromRaw(data);
});
/**
* Reset the chain state to a tip/start-block.
* @param {BlockMeta} tip
* @returns {Promise}
*/
WalletDB.prototype.resetState = co(function* resetState(tip) {
var batch = this.db.batch();
var state = this.state.clone();
var iter, item;
iter = this.db.iterator({
gte: layout.h(0),
lte: layout.h(0xffffffff),
values: false
});
for (;;) {
item = yield iter.next();
if (!item)
break;
try {
batch.del(item.key);
} catch (e) {
yield iter.end();
throw e;
}
}
state.startHeight = tip.height;
state.startHash = tip.hash;
state.height = tip.height;
batch.put(layout.h(tip.height), tip.toHash());
batch.put(layout.R, state.toRaw());
yield batch.write();
this.state = state;
});
/**
* Sync the current chain state to tip.
* @param {BlockMeta} tip
* @returns {Promise}
*/
WalletDB.prototype.syncState = co(function* syncState(tip) {
var batch = this.db.batch();
var state = this.state.clone();
var i, state, height, blocks;
if (tip.height < state.height) {
// Hashes ahead of our new tip
// that we need to delete.
height = state.height;
blocks = height - tip.height;
if (blocks > this.keepBlocks)
blocks = this.keepBlocks;
for (i = 0; i < blocks; i++) {
batch.del(layout.h(height));
height--;
}
} else if (tip.height > state.height) {
// Prune old hashes.
assert(tip.height === state.height + 1, 'Bad chain sync.');
height = tip.height - this.keepBlocks;
if (height >= 0)
batch.del(layout.h(height));
}
state.height = tip.height;
// Save tip and state.
batch.put(layout.h(tip.height), tip.toHash());
batch.put(layout.R, state.toRaw());
yield batch.write();
this.state = state;
});
/**
* Get a block->wallet map.
* @param {Number} height
* @returns {Promise}
*/
WalletDB.prototype.getBlockMap = co(function* getBlockMap(height) {
var data = yield this.db.get(layout.b(height));
if (!data)
return;
return BlockMapRecord.fromRaw(height, data);
});
/**
* Add block to the global block map.
* @param {Wallet} wallet
* @param {Number} height
* @param {BlockMapRecord} block
*/
WalletDB.prototype.writeBlockMap = function writeBlockMap(wallet, height, block) {
var batch = this.batch(wallet);
batch.put(layout.b(height), block.toRaw());
};
/**
* Remove a block from the global block map.
* @param {Wallet} wallet
* @param {Number} height
*/
WalletDB.prototype.unwriteBlockMap = function unwriteBlockMap(wallet, height) {
var batch = this.batch(wallet);
batch.del(layout.b(height));
};
/**
* Get a Unspent->Wallet map.
* @param {Hash} hash
* @param {Number} index
* @returns {Promise}
*/
WalletDB.prototype.getOutpointMap = co(function* getOutpointMap(hash, i) {
var data = yield this.db.get(layout.o(hash, i));
if (!data)
return;
return OutpointMapRecord.fromRaw(hash, i, data);
});
/**
* Add an outpoint to global unspent map.
* @param {Wallet} wallet
* @param {Hash} hash
* @param {Number} index
* @param {OutpointMapRecord} map
*/
WalletDB.prototype.writeOutpointMap = function writeOutpointMap(wallet, hash, i, map) {
var batch = this.batch(wallet);
this.addFilter(new Outpoint(hash, i).toRaw());
batch.put(layout.o(hash, i), map.toRaw());
};
/**
* Remove an outpoint from global unspent map.
* @param {Wallet} wallet
* @param {Hash} hash
* @param {Number} index
*/
WalletDB.prototype.unwriteOutpointMap = function unwriteOutpointMap(wallet, hash, i) {
var batch = this.batch(wallet);
batch.del(layout.o(hash, i));
};
/**
* Get a wallet block meta.
* @param {Hash} hash
* @returns {Promise}
*/
WalletDB.prototype.getBlock = co(function* getBlock(height) {
var data = yield this.db.get(layout.h(height));
var block;
if (!data)
return;
block = new BlockMeta();
block.hash = data.toString('hex');
block.height = height;
return block;
});
/**
* Get wallet tip.
* @param {Hash} hash
* @returns {Promise}
*/
WalletDB.prototype.getTip = co(function* getTip() {
var tip = yield this.getBlock(this.state.height);
if (!tip)
throw new Error('WDB: Tip not found!');
return tip;
});
/**
* Sync with chain height.
* @param {Number} height
* @returns {Promise}
*/
WalletDB.prototype.rollback = co(function* rollback(height) {
var tip;
if (height > this.state.height)
throw new Error('WDB: Cannot rollback to the future.');
if (height === this.state.height) {
this.logger.debug('Rolled back to same height (%d).', height);
return;
}
this.logger.info(
'Rolling back %d WalletDB blocks to height %d.',
this.state.height - height, height);
tip = yield this.getBlock(height);
if (tip) {
yield this.revert(tip.height);
yield this.syncState(tip);
return;
}
tip = new BlockMeta();
if (height >= this.state.startHeight) {
tip.height = this.state.startHeight;
tip.hash = this.state.startHash;
this.logger.warning(
'Rolling back WalletDB to start block (%d).',
tip.height);
} else {
tip.height = 0;
tip.hash = this.network.genesis.hash;
this.logger.warning('Rolling back WalletDB to genesis block.');
}
yield this.revert(tip.height);
yield this.resetState(tip);
});
/**
* Revert TXDB to an older state.
* @param {Number} height
* @returns {Promise}
*/
WalletDB.prototype.revert = co(function* revert(height) {
var total = 0;
var i, iter, item, height, block, tx;
iter = this.db.iterator({
gte: layout.b(height + 1),
lte: layout.b(0xffffffff),
reverse: true,
values: true
});
for (;;) {
item = yield iter.next();
if (!item)
break;
try {
height = layout.bb(item.key);
block = BlockMapRecord.fromRaw(height, item.value);
total += block.txs.length;
for (i = block.txs.length - 1; i >= 0; i--) {
tx = block.txs[i];
yield this._unconfirm(tx);
}
} catch (e) {
yield iter.end();
throw e;
}
}
this.logger.info('Rolled back %d WalletDB transactions.', total);
});
/**
* Add a block's transactions and write the new best hash.
* @param {ChainEntry} entry
* @returns {Promise}
*/
WalletDB.prototype.addBlock = co(function* addBlock(entry, txs) {
var unlock = yield this.txLock.lock();
try {
return yield this._addBlock(entry, txs);
} finally {
unlock();
}
});
/**
* Add a block's transactions without a lock.
* @private
* @param {ChainEntry} entry
* @returns {Promise}
*/
WalletDB.prototype._addBlock = co(function* addBlock(entry, txs) {
var tip = BlockMeta.fromEntry(entry);
var total = 0;
var i, tx;
if (tip.height < this.state.height) {
this.logger.warning(
'WalletDB is connecting low blocks (%d).',
tip.height);
return total;
}
if (tip.height === this.state.height) {
// We let blocks of the same height
// through specifically for rescans:
// we always want to rescan the last
// block since the state may have
// updated before the block was fully
// processed (in the case of a crash).
this.logger.warning('Already saw WalletDB block (%d).', tip.height);
} else if (tip.height !== this.state.height + 1) {
throw new Error('WDB: Bad connection (height mismatch).');
}
yield this.syncState(tip);
if (this.options.useCheckpoints) {
if (tip.height <= this.network.checkpoints.lastHeight)
return total;
}
for (i = 0; i < txs.length; i++) {
tx = txs[i];
if (yield this._insert(tx, tip))
total++;
}
if (total > 0) {
this.logger.info('Connected WalletDB block %s (tx=%d).',
utils.revHex(tip.hash), total);
}
return total;
});
/**
* Unconfirm a block's transactions
* and write the new best hash (SPV version).
* @param {ChainEntry} entry
* @returns {Promise}
*/
WalletDB.prototype.removeBlock = co(function* removeBlock(entry) {
var unlock = yield this.txLock.lock();
try {
return yield this._removeBlock(entry);
} finally {
unlock();
}
});
/**
* Unconfirm a block's transactions.
* @private
* @param {ChainEntry} entry
* @returns {Promise}
*/
WalletDB.prototype._removeBlock = co(function* removeBlock(entry) {
var tip = BlockMeta.fromEntry(entry);
var i, tx, prev, block;
if (tip.height > this.state.height) {
this.logger.warning(
'WalletDB is disconnecting high blocks (%d).',
tip.height);
return 0;
}
if (tip.height !== this.state.height)
throw new Error('WDB: Bad disconnection (height mismatch).');
prev = yield this.getBlock(tip.height - 1);
if (!prev)
throw new Error('WDB: Bad disconnection (no previous block).');
block = yield this.getBlockMap(tip.height);
if (!block) {
yield this.syncState(prev);
return 0;
}
for (i = block.txs.length - 1; i >= 0; i--) {
tx = block.txs[i];
yield this._unconfirm(tx);
}
yield this.syncState(prev);
this.logger.warning('Disconnected wallet block %s (tx=%d).',
utils.revHex(tip.hash), block.txs.length);
return block.txs.length;
});
/**
* Add a transaction to the database, map addresses
* to wallet IDs, potentially store orphans, resolve
* orphans, or confirm a transaction.
* @param {TX} tx
* @returns {Promise}
*/
WalletDB.prototype.addTX = co(function* addTX(tx) {
var unlock = yield this.txLock.lock();
var block;
try {
if (tx.height !== -1) {
block = yield this.getBlock(tx.height);
if (!block)
throw new Error('WDB: Inserting confirmed transaction.');
if (tx.block !== block.hash)
throw new Error('WDB: Inserting confirmed transaction.');
this.logger.warning('WalletDB is inserting confirmed transaction.');
}
return yield this._insert(tx);
} finally {
unlock();
}
});
/**
* Add a transaction to the database without a lock.
* @private
* @param {TX} tx
* @param {BlockMeta} block
* @returns {Promise}
*/
WalletDB.prototype._insert = co(function* insert(tx, block) {
var result = false;
var i, wids, wid, wallet;
assert(!tx.mutable, 'WDB: Cannot add mutable TX.');
wids = yield this.getWalletsByTX(tx);
if (!wids)
return;
this.logger.info(
'Incoming transaction for %d wallets in WalletDB (%s).',
wids.length, tx.rhash);
for (i = 0; i < wids.length; i++) {
wid = wids[i];
wallet = yield this.get(wid);
assert(wallet);
if (yield wallet.add(tx, block)) {
this.logger.info(
'Added transaction to wallet in WalletDB: %s (%d).',
wallet.id, wid);
result = true;
}
}
if (!result)
return;
return wids;
});
/**
* Unconfirm a transaction from all
* relevant wallets without a lock.
* @private
* @param {TXMapRecord} tx
* @returns {Promise}
*/
WalletDB.prototype._unconfirm = co(function* unconfirm(tx) {
var i, wid, wallet;
for (i = 0; i < tx.wids.length; i++) {
wid = tx.wids[i];
wallet = yield this.get(wid);
assert(wallet);
yield wallet.unconfirm(tx.hash);
}
});
/*
* Helpers
*/
function cmp(a, b) {
return a - b;
}
/*
* Expose
*/
module.exports = WalletDB;