593 lines
16 KiB
JavaScript
593 lines
16 KiB
JavaScript
'use strict';
|
||
|
||
var _ = require('lodash');
|
||
var $ = require('preconditions').singleton();
|
||
var async = require('async');
|
||
var log = require('npmlog');
|
||
log.debug = log.verbose;
|
||
var inherits = require('inherits');
|
||
var events = require('events');
|
||
|
||
var Bitcore = require('bitcore');
|
||
var PublicKey = Bitcore.PublicKey;
|
||
var HDPublicKey = Bitcore.HDPublicKey;
|
||
var Address = Bitcore.Address;
|
||
var Explorers = require('bitcore-explorers');
|
||
|
||
var ClientError = require('./clienterror');
|
||
var Utils = require('./utils');
|
||
var Storage = require('./storage');
|
||
var SignUtils = require('./signutils');
|
||
|
||
var Wallet = require('./model/wallet');
|
||
var Copayer = require('./model/copayer');
|
||
var Address = require('./model/address');
|
||
var TxProposal = require('./model/txproposal');
|
||
|
||
|
||
var initialized = false;
|
||
var storage;
|
||
|
||
/**
|
||
* Creates an instance of the Copay server.
|
||
* @constructor
|
||
*/
|
||
function CopayServer() {
|
||
if (!initialized) throw new Error('Server not initialized');
|
||
this.storage = storage;
|
||
};
|
||
|
||
|
||
/**
|
||
* Initializes global settings for all instances.
|
||
* @param {Object} opts
|
||
* @param {Storage} [opts.storage] - The storage provider.
|
||
*/
|
||
CopayServer.initialize = function(opts) {
|
||
opts = opts || {};
|
||
storage = opts.storage || new Storage();
|
||
initialized = true;
|
||
};
|
||
|
||
/**
|
||
* Gets an instance of the server after authenticating the copayer.
|
||
* @param {Object} opts
|
||
* @param {string} opts.copayerId - The copayer id making the request.
|
||
* @param {string} opts.message - The contents of the request to be signed.
|
||
* @param {string} opts.signature - Signature of message to be verified using the copayer's signingPubKey.
|
||
*/
|
||
CopayServer.getInstanceWithAuth = function(opts, cb) {
|
||
|
||
Utils.checkRequired(opts, ['copayerId', 'message', 'signature']);
|
||
|
||
var server = new CopayServer();
|
||
server.storage.fetchCopayerLookup(opts.copayerId, function(err, copayer) {
|
||
if (err) return cb(err);
|
||
if (!copayer) return cb('Copayer not found');
|
||
|
||
var isValid = server._verifySignature(opts.message, opts.signature, copayer.signingPubKey);
|
||
if (!isValid) return cb('Invalid signature');
|
||
|
||
server.copayerId = opts.copayerId;
|
||
server.walletId = copayer.walletId;
|
||
return cb(null, server);
|
||
});
|
||
};
|
||
|
||
|
||
/**
|
||
* Creates a new wallet.
|
||
* @param {Object} opts
|
||
* @param {string} opts.id - The wallet id.
|
||
* @param {string} opts.name - The wallet name.
|
||
* @param {number} opts.m - Required copayers.
|
||
* @param {number} opts.n - Total copayers.
|
||
* @param {string} opts.pubKey - Public key to verify copayers joining have access to the wallet secret.
|
||
* @param {string} [opts.network = 'livenet'] - The Bitcoin network for this wallet.
|
||
*/
|
||
CopayServer.prototype.createWallet = function(opts, cb) {
|
||
var self = this,
|
||
pubKey;
|
||
|
||
Utils.checkRequired(opts, ['name', 'm', 'n', 'pubKey']);
|
||
|
||
if (!Wallet.verifyCopayerLimits(opts.m, opts.n))
|
||
return cb(new ClientError('Invalid combination of required copayers / total copayers'));
|
||
|
||
var network = opts.network || 'livenet';
|
||
if (network != 'livenet' && network != 'testnet')
|
||
return cb(new ClientError('Invalid network'));
|
||
|
||
try {
|
||
pubKey = new PublicKey.fromString(opts.pubKey);
|
||
} catch (e) {
|
||
return cb(e.toString());
|
||
};
|
||
|
||
var wallet = new Wallet({
|
||
name: opts.name,
|
||
m: opts.m,
|
||
n: opts.n,
|
||
network: opts.network || 'livenet',
|
||
pubKey: pubKey,
|
||
});
|
||
|
||
self.storage.storeWallet(wallet, function(err) {
|
||
return cb(err, wallet.id);
|
||
});
|
||
};
|
||
|
||
/**
|
||
* Retrieves a wallet from storage.
|
||
* @param {Object} opts
|
||
* @returns {Object} wallet
|
||
*/
|
||
CopayServer.prototype.getWallet = function(opts, cb) {
|
||
var self = this;
|
||
|
||
self.storage.fetchWallet(self.walletId, function(err, wallet) {
|
||
if (err) return cb(err);
|
||
if (!wallet) return cb(new ClientError('Wallet not found'));
|
||
return cb(null, wallet);
|
||
});
|
||
};
|
||
|
||
|
||
/**
|
||
* Verifies a signature
|
||
* @param text
|
||
* @param signature
|
||
* @param pubKey
|
||
*/
|
||
CopayServer.prototype._verifySignature = function(text, signature, pubKey) {
|
||
return SignUtils.verify(text, signature, pubKey);
|
||
};
|
||
|
||
/**
|
||
* Joins a wallet in creation.
|
||
* @param {Object} opts
|
||
* @param {string} opts.walletId - The wallet id.
|
||
* @param {string} opts.name - The copayer name.
|
||
* @param {number} opts.xPubKey - Extended Public Key for this copayer.
|
||
* @param {number} opts.xPubKeySignature - Signature of xPubKey using the wallet pubKey.
|
||
*/
|
||
CopayServer.prototype.joinWallet = function(opts, cb) {
|
||
var self = this;
|
||
|
||
Utils.checkRequired(opts, ['walletId', 'name', 'xPubKey', 'xPubKeySignature']);
|
||
|
||
Utils.runLocked(opts.walletId, cb, function(cb) {
|
||
self.storage.fetchWallet(opts.walletId, function(err, wallet) {
|
||
if (err) return cb(err);
|
||
if (!wallet) return cb(new ClientError('Wallet not found'));
|
||
|
||
if (!self._verifySignature(opts.xPubKey, opts.xPubKeySignature, wallet.pubKey)) {
|
||
return cb(new ClientError());
|
||
}
|
||
|
||
if (_.find(wallet.copayers, {
|
||
xPubKey: opts.xPubKey
|
||
})) return cb(new ClientError('CINWALLET', 'Copayer already in wallet'));
|
||
if (wallet.copayers.length == wallet.n) return cb(new ClientError('WFULL', 'Wallet full'));
|
||
|
||
var copayer = new Copayer({
|
||
name: opts.name,
|
||
xPubKey: opts.xPubKey,
|
||
xPubKeySignature: opts.xPubKeySignature,
|
||
copayerIndex: wallet.copayers.length,
|
||
});
|
||
|
||
wallet.addCopayer(copayer);
|
||
self.storage.storeWalletAndUpdateCopayersLookup(wallet, function(err) {
|
||
return cb(err, copayer.id);
|
||
});
|
||
});
|
||
});
|
||
};
|
||
|
||
/**
|
||
* Creates a new address.
|
||
* @param {Object} opts
|
||
* @param {truthy} opts.isChange - Indicates whether this is a regular address or a change address.
|
||
* @returns {Address} address
|
||
*/
|
||
CopayServer.prototype.createAddress = function(opts, cb) {
|
||
var self = this;
|
||
var isChange = opts.isChange || false;
|
||
|
||
Utils.checkRequired(opts, ['isChange']);
|
||
|
||
Utils.runLocked(self.walletId, cb, function(cb) {
|
||
self.getWallet({}, function(err, wallet) {
|
||
if (err) return cb(err);
|
||
if (!wallet.isComplete()) return cb(new ClientError('Wallet is not complete'));
|
||
|
||
var address = wallet.createAddress(opts.isChange);
|
||
|
||
self.storage.storeAddress(wallet.id, address, function(err) {
|
||
if (err) return cb(err);
|
||
|
||
self.storage.storeWallet(wallet, function(err) {
|
||
if (err) {
|
||
self.storage.removeAddress(wallet.id, address, function() {
|
||
return cb(err);
|
||
});
|
||
} else {
|
||
return cb(null, address);
|
||
}
|
||
});
|
||
});
|
||
});
|
||
});
|
||
};
|
||
|
||
/**
|
||
* Get all addresses.
|
||
* @param {Object} opts
|
||
* @returns {Address[]}
|
||
*/
|
||
CopayServer.prototype.getAddresses = function(opts, cb) {
|
||
var self = this;
|
||
|
||
self.storage.fetchAddresses(self.walletId, function(err, addresses) {
|
||
if (err) return cb(err);
|
||
|
||
return cb(null, addresses);
|
||
});
|
||
};
|
||
|
||
/**
|
||
* Verifies that a given message was actually sent by an authorized copayer.
|
||
* @param {Object} opts
|
||
* @param {string} opts.message - The message to verify.
|
||
* @param {string} opts.signature - The signature of message to verify.
|
||
* @returns {truthy} The result of the verification.
|
||
*/
|
||
CopayServer.prototype.verifyMessageSignature = function(opts, cb) {
|
||
var self = this;
|
||
|
||
Utils.checkRequired(opts, ['message', 'signature']);
|
||
|
||
self.getWallet({}, function(err, wallet) {
|
||
if (err) return cb(err);
|
||
|
||
var copayer = wallet.getCopayer(self.copayerId);
|
||
|
||
var isValid = self._verifySignature(opts.message, opts.signature, copayer.signingPubKey);
|
||
return cb(null, isValid);
|
||
});
|
||
};
|
||
|
||
|
||
CopayServer.prototype._getBlockExplorer = function(provider, network) {
|
||
var url;
|
||
|
||
switch (provider) {
|
||
default:
|
||
case 'insight':
|
||
switch (network) {
|
||
default:
|
||
case 'livenet':
|
||
url = 'https://insight.bitpay.com:443';
|
||
break;
|
||
case 'testnet':
|
||
url = 'https://test-insight.bitpay.com:443'
|
||
break;
|
||
}
|
||
return new Explorers.Insight(url, network);
|
||
break;
|
||
}
|
||
};
|
||
|
||
/**
|
||
* _getUtxos
|
||
*
|
||
*/
|
||
CopayServer.prototype._getUtxos = function(cb) {
|
||
var self = this;
|
||
|
||
|
||
// Get addresses for this wallet
|
||
self.storage.fetchAddresses(self.walletId, function(err, addresses) {
|
||
if (err) return cb(err);
|
||
if (addresses.length == 0) return cb(new ClientError('The wallet has no addresses'));
|
||
|
||
var addressStrs = _.pluck(addresses, 'address');
|
||
var addressToPath = _.indexBy(addresses, 'address'); // TODO : check performance
|
||
var networkName = Bitcore.Address(addressStrs[0]).toObject().networkName;
|
||
|
||
var bc = self._getBlockExplorer('insight', networkName);
|
||
bc.getUnspentUtxos(addressStrs, function(err, utxos) {
|
||
if (err) return cb(err);
|
||
|
||
self.getPendingTxs({}, function(err, txps) {
|
||
if (err) return cb(err);
|
||
|
||
var inputs = _.chain(txps)
|
||
.pluck('inputs')
|
||
.flatten()
|
||
.map(function(utxo) {
|
||
return utxo.txid + '|' + utxo.vout
|
||
})
|
||
.value();
|
||
|
||
var dictionary = _.reduce(utxos, function(memo, utxo) {
|
||
memo[utxo.txid + '|' + utxo.vout] = utxo;
|
||
return memo;
|
||
}, {});
|
||
|
||
_.each(inputs, function(input) {
|
||
if (dictionary[input]) {
|
||
dictionary[input].locked = true;
|
||
}
|
||
});
|
||
|
||
// Needed for the clients to sign UTXOs
|
||
_.each(utxos, function(utxo) {
|
||
utxo.path = addressToPath[utxo.address].path;
|
||
utxo.publicKeys = addressToPath[utxo.address].publicKeys;
|
||
});
|
||
|
||
return cb(null, utxos);
|
||
});
|
||
});
|
||
});
|
||
};
|
||
|
||
|
||
/**
|
||
* Creates a new transaction proposal.
|
||
* @param {Object} opts
|
||
* @returns {Object} balance - Total amount & locked amount.
|
||
*/
|
||
CopayServer.prototype.getBalance = function(opts, cb) {
|
||
var self = this;
|
||
|
||
self._getUtxos(function(err, utxos) {
|
||
if (err) return cb(err);
|
||
|
||
var balance = {};
|
||
balance.totalAmount = Utils.strip(_.reduce(utxos, function(sum, utxo) {
|
||
return sum + self._inputSatoshis(utxo);
|
||
}, 0));
|
||
|
||
balance.lockedAmount = Utils.strip(_.reduce(_.filter(utxos, {
|
||
locked: true
|
||
}), function(sum, utxo) {
|
||
return sum + self._inputSatoshis(utxo);
|
||
}, 0));
|
||
|
||
return cb(null, balance);
|
||
});
|
||
};
|
||
|
||
|
||
// TODO: should be in Utils
|
||
CopayServer.prototype._inputSatoshis = function(i) {
|
||
return i.amount ? Utils.strip(i.amount * 1e8) : i.satoshis;
|
||
};
|
||
|
||
CopayServer.prototype._selectUtxos = function(txp, utxos) {
|
||
var i = 0;
|
||
var total = 0;
|
||
var selected = [];
|
||
var inputs = _.sortBy(utxos, 'amount');
|
||
|
||
while (i < inputs.length) {
|
||
selected.push(inputs[i]);
|
||
total += this._inputSatoshis(inputs[i]);
|
||
|
||
if (total >= txp.amount) {
|
||
|
||
break;
|
||
}
|
||
i++;
|
||
};
|
||
return total >= txp.amount ? selected : null;
|
||
};
|
||
|
||
|
||
/**
|
||
* Creates a new transaction proposal.
|
||
* @param {Object} opts
|
||
* @param {string} opts.toAddress - Destination address.
|
||
* @param {number} opts.amount - Amount to transfer in satoshi.
|
||
* @param {string} opts.message - A message to attach to this transaction.
|
||
* @returns {TxProposal} Transaction proposal.
|
||
*/
|
||
CopayServer.prototype.createTx = function(opts, cb) {
|
||
var self = this;
|
||
|
||
Utils.checkRequired(opts, ['toAddress', 'amount']);
|
||
|
||
|
||
// TODO?
|
||
// Check some parameters like:
|
||
// amount > dust
|
||
|
||
self.getWallet({}, function(err, wallet) {
|
||
if (err) return cb(err);
|
||
|
||
self._getUtxos(function(err, utxos) {
|
||
if (err) return cb(err);
|
||
|
||
var changeAddress = wallet.createAddress(true).address;
|
||
|
||
utxos = _.reject(utxos, {
|
||
locked: true
|
||
});
|
||
|
||
var txp = new TxProposal({
|
||
creatorId: self.copayerId,
|
||
toAddress: opts.toAddress,
|
||
amount: opts.amount,
|
||
changeAddress: changeAddress,
|
||
requiredSignatures: wallet.m,
|
||
maxRejections: wallet.n - wallet.m,
|
||
});
|
||
|
||
txp.inputs = self._selectUtxos(txp, utxos);
|
||
if (!txp.inputs) {
|
||
return cb(new ClientError('INSUFFICIENTFUNDS', 'Insufficient funds'));
|
||
}
|
||
|
||
txp.inputPaths = _.pluck(txp.inputs, 'path');
|
||
|
||
// no need to do this now: // TODO remove this comment
|
||
//self._createRawTx(txp);
|
||
self.storage.storeTx(wallet.id, txp, function(err) {
|
||
if (err) return cb(err);
|
||
|
||
return cb(null, txp);
|
||
});
|
||
});
|
||
});
|
||
};
|
||
|
||
/**
|
||
* Retrieves a tx from storage.
|
||
* @param {Object} opts
|
||
* @param {string} opts.id - The tx id.
|
||
* @returns {Object} txProposal
|
||
*/
|
||
CopayServer.prototype.getTx = function(opts, cb) {
|
||
var self = this;
|
||
|
||
self.storage.fetchTx(self.walletId, opts.id, function(err, txp) {
|
||
if (err) return cb(err);
|
||
if (!txp) return cb(new ClientError('Transaction proposal not found'));
|
||
return cb(null, txp);
|
||
});
|
||
};
|
||
|
||
CopayServer.prototype._broadcastTx = function(txp, cb) {
|
||
var raw = txp.getRawTx();
|
||
var bc = this._getBlockExplorer('insight', txp.getNetworkName());
|
||
bc.broadcast(raw, function(err, txid) {
|
||
return cb(err, txid);
|
||
})
|
||
};
|
||
|
||
/**
|
||
* Sign a transaction proposal.
|
||
* @param {Object} opts
|
||
* @param {string} opts.txProposalId - The identifier of the transaction.
|
||
* @param {string} opts.signatures - The signatures of the inputs of this tx for this copayer (in apperance order)
|
||
*/
|
||
CopayServer.prototype.signTx = function(opts, cb) {
|
||
var self = this;
|
||
|
||
Utils.checkRequired(opts, ['txProposalId', 'signatures']);
|
||
|
||
self.getWallet({}, function(err, wallet) {
|
||
if (err) return cb(err);
|
||
|
||
self.getTx({
|
||
id: opts.txProposalId
|
||
}, function(err, txp) {
|
||
if (err) return cb(err);
|
||
if (!txp) return cb(new ClientError('Transaction proposal not found'));
|
||
var action = _.find(txp.actions, {
|
||
copayerId: opts.copayerId
|
||
});
|
||
if (action)
|
||
return cb(new ClientError('CVOTED', 'Copayer already voted on this transaction proposal'));
|
||
if (txp.status != 'pending')
|
||
return cb(new ClientError('TXNOTPENDING', 'The transaction proposal is not pending'));
|
||
|
||
var copayer = wallet.getCopayer(self.copayerId);
|
||
|
||
if (!txp.checkSignatures(opts.signatures, copayer.xPubKey))
|
||
return cb(new ClientError('BADSIGNATURES', 'Bad signatures'));
|
||
|
||
txp.sign(self.copayerId, opts.signatures);
|
||
|
||
self.storage.storeTx(self.walletId, txp, function(err) {
|
||
if (err) return cb(err);
|
||
|
||
if (txp.status == 'accepted') {
|
||
self._broadcastTx(txp, function(err, txid) {
|
||
if (err) return cb(err);
|
||
|
||
txp.setBroadcasted(txid);
|
||
self.storage.storeTx(self.walletId, txp, function(err) {
|
||
if (err) return cb(err);
|
||
|
||
return cb(null, txp);
|
||
});
|
||
});
|
||
} else {
|
||
return cb(null, txp);
|
||
}
|
||
});
|
||
});
|
||
});
|
||
};
|
||
|
||
/**
|
||
* Reject a transaction proposal.
|
||
* @param {Object} opts
|
||
* @param {string} opts.txProposalId - The identifier of the transaction.
|
||
* @param {string} [opts.reason] - A message to other copayers explaining the rejection.
|
||
*/
|
||
CopayServer.prototype.rejectTx = function(opts, cb) {
|
||
var self = this;
|
||
|
||
Utils.checkRequired(opts, ['txProposalId']);
|
||
|
||
self.getTx({
|
||
id: opts.txProposalId
|
||
}, function(err, txp) {
|
||
if (err) return cb(err);
|
||
if (!txp) return cb(new ClientError('Transaction proposal not found'));
|
||
var action = _.find(txp.actions, {
|
||
copayerId: self.copayerId
|
||
});
|
||
if (action) return cb(new ClientError('CVOTED', 'Copayer already voted on this transaction proposal'));
|
||
if (txp.status != 'pending') return cb(new ClientError('TXNOTPENDING', 'The transaction proposal is not pending'));
|
||
|
||
txp.reject(self.copayerId);
|
||
|
||
self.storage.storeTx(self.walletId, txp, function(err) {
|
||
if (err) return cb(err);
|
||
|
||
return cb();
|
||
});
|
||
});
|
||
};
|
||
|
||
/**
|
||
* Retrieves all pending transaction proposals.
|
||
* @param {Object} opts
|
||
* @returns {TxProposal[]} Transaction proposal.
|
||
*/
|
||
CopayServer.prototype.getPendingTxs = function(opts, cb) {
|
||
var self = this;
|
||
|
||
self.storage.fetchPendingTxs(self.walletId, function(err, txps) {
|
||
if (err) return cb(err);
|
||
|
||
return cb(null, txps);
|
||
});
|
||
};
|
||
|
||
/**
|
||
* Retrieves pending transaction proposals in the range (maxTs-minTs)
|
||
* @param {Object} opts.minTs (defaults to 0)
|
||
* @param {Object} opts.maxTs (defaults to now)
|
||
* @param {Object} opts.limit
|
||
* @returns {TxProposal[]} Transaction proposal.
|
||
*/
|
||
CopayServer.prototype.getTxs = function(opts, cb) {
|
||
var self = this;
|
||
self.storage.fetchTxs(self.walletId, opts, function(err, txps) {
|
||
if (err) return cb(err);
|
||
return cb(null, txps);
|
||
});
|
||
};
|
||
|
||
|
||
|
||
|
||
module.exports = CopayServer;
|