fcoin/lib/bcoin/mtx.js
2016-04-15 06:43:44 -07:00

1407 lines
36 KiB
JavaScript

/*!
* mtx.js - mutable transaction object for bcoin
* Copyright (c) 2014-2015, Fedor Indutny (MIT License)
* Copyright (c) 2014-2016, Christopher Jeffrey (MIT License).
* https://github.com/indutny/bcoin
*/
module.exports = function(bcoin) {
var bn = require('bn.js');
var utils = require('./utils');
var assert = utils.assert;
var constants = bcoin.protocol.constants;
var network = bcoin.protocol.network;
var Script = bcoin.script;
var Witness = bcoin.script.witness;
var opcodes = constants.opcodes;
/**
* A mutable transaction object.
* @exports MTX
* @extends TX
* @constructor
* @param {Object} options
* @param {Number?} options.version
* @param {Number?} options.ps
* @param {Number?} options.changeIndex
* @param {Input[]?} options.inputs
* @param {Output[]?} options.outputs
* @property {String} type - "tx" (inv type).
* @property {Number} version - Transaction version. Note that BCoin reads
* versions as unsigned even though they are signed at the protocol level.
* This value will never be negative.
* @property {Number} flag - Flag field for segregated witness.
* Always non-zero (1 if not present).
* @property {Input[]} inputs
* @property {Output[]} outputs
* @property {Number} locktime - nLockTime
* @property {Number} ts - Timestamp of the block the transaction
* was included in (unix time).
* @property {Hash|null} block - Hash of the block the transaction
* was included in.
* @property {Number} index - Transaction's index in the block tx vector.
* @property {Number} ps - "Pending Since": The time at which the transaction
* was first seen. Only non-zero on unconfirmed transactions.
* @property {Number} changeIndex - Index of the change output (-1 if unknown).
* @property {Number} height - Height of the block the
* transaction was included in (-1 if unconfirmed).
* @property {ReversedHash|null} rblock - Reversed block hash (uint256le).
* @property {ReversedHash} rhash - Reversed transaction hash (uint256le).
* @property {ReversedHash} rwhash - Reversed witness
* transaction hash (uint256le).
* @property {String} txid - Transaction ID.
* @property {String} wtxid - Witness transaction ID (Same as txid if no
* witness is present. All zeroes if coinbase).
*/
function MTX(options) {
var i;
if (!(this instanceof MTX))
return new MTX(options);
if (!options)
options = {};
this.type = 'tx';
this.version = options.version || 1;
this.inputs = [];
this.outputs = [];
this.locktime = 0;
this.ts = 0;
this.block = null;
this.index = -1;
this.ps = options.ps != null ? options.ps : utils.now();
this.changeIndex = options.changeIndex != null ? options.changeIndex : -1;
this.height = -1;
this._hash = null;
this._whash = null;
this._raw = null;
this._size = 0;
this._witnessSize = 0;
if (options.inputs) {
for (i = 0; i < options.inputs.length; i++)
this.addInput(options.inputs[i]);
}
if (options.outputs) {
for (i = 0; i < options.outputs.length; i++)
this.addOutput(options.outputs[i]);
}
}
utils.inherits(MTX, bcoin.tx);
/**
* Clone the transaction.
* @returns {MTX}
*/
MTX.prototype.clone = function clone() {
var tx = new MTX(this);
tx.locktime = this.locktime;
tx.ts = this.ts;
tx.block = this.block;
tx.index = this.index;
tx.ps = this.ps;
tx.height = this.height;
return tx;
};
/**
* Hash the transaction with the non-witness serialization.
* Note that this is not cached.
* @param {String?} enc - Can be `'hex'` or `null`.
* @returns {Hash|Buffer} hash
*/
MTX.prototype.hash = function hash(enc) {
var hash = utils.dsha256(this.renderNormal());
return enc === 'hex' ? utils.toHex(hash) : hash;
};
/**
* Hash the transaction with the witness
* serialization, return the wtxid (normal
* hash if no witness is present, all zeroes
* if coinbase). Note that this is not cached.
* @param {String?} enc - Can be `'hex'` or `null`.
* @returns {Hash|Buffer} hash
*/
MTX.prototype.witnessHash = function witnessHash(enc) {
var hash;
if (this.isCoinbase()) {
return enc === 'hex'
? utils.toHex(constants.zeroHash)
: utils.slice(constants.zeroHash);
}
if (!this.hasWitness())
return this.hash(enc);
hash = utils.dsha256(this.renderWitness());
return enc === 'hex' ? utils.toHex(hash) : hash;
};
/**
* Serialize the transaction. Note
* that this is _not_ cached. This will use
* the witness serialization if a
* witness is present.
* @returns {Buffer} Serialized transaction.
*/
MTX.prototype.render = function render() {
return this.getRaw();
};
/**
* Serialize the transaction without the
* witness vector, regardless of whether it
* is a witness transaction or not. Note
* that this is _not_ cached.
* @returns {Buffer} Serialized transaction.
*/
MTX.prototype.renderNormal = function renderNormal() {
return bcoin.protocol.framer.tx(this);
};
/**
* Serialize the transaction with the
* witness vector, regardless of whether it
* is a witness transaction or not. Note that
* this is _not_ cached.
* @returns {Buffer} Serialized transaction.
*/
MTX.prototype.renderWitness = function renderWitness() {
return bcoin.protocol.framer.witnessTX(this);
};
/**
* Serialize the transaction. Note
* that this is cached. This will use
* the witness serialization if a
* witness is present. Note that this
* is _not_ cached.
* @returns {Buffer} Serialized transaction.
*/
MTX.prototype.getRaw = function getRaw() {
if (this.hasWitness())
return bcoin.protocol.framer.witnessTX(this);
return bcoin.protocol.framer.tx(this);
};
/**
* Calculate the real size of the transaction
* with the witness included. Note that this
* is _not_ cached.
* @returns {Number} size
*/
MTX.prototype.getSize = function getSize() {
return bcoin.protocol.framer.tx.witnessSize(this);
};
/**
* Calculate the virtual size of the transaction.
* Note that this is _not_ cached.
* @returns {Number} vsize
*/
MTX.prototype.getVirtualSize = function getVirtualSize() {
return bcoin.protocol.framer.tx.virtualSize(this);
};
/**
* Add an input to the transaction.
* @example
* tx.addInput({ prevout: { hash: ... }, sequence: ... });
* tx.addInput(prev, prevIndex);
* tx.addInput(coin);
* tx.addInput(bcoin.coin(prev, prevIndex));
* @param {Object|TX|Coin} options - Options object, transaction, or coin.
* @param {Number?} index - Input of output if `options` is a TX.
*/
MTX.prototype.addInput = function addInput(options, index) {
var input;
assert(this.ts === 0, 'Cannot modify a confirmed tx.');
if (options instanceof bcoin.tx)
options = bcoin.coin(options, index);
if (options instanceof bcoin.coin) {
assert(typeof options.hash === 'string');
assert(typeof options.index === 'number');
options = {
prevout: { hash: options.hash, index: options.index },
coin: options
};
}
assert(options.prevout);
input = bcoin.input(options, this);
if (options.script instanceof Script)
input.script = options.script.clone();
if (options.witness instanceof Witness)
input.witness = options.witness.clone();
this.inputs.push(input);
return this;
};
/**
* Build input script (or witness) templates (with
* OP_0 in place of signatures).
* @param {Number} index - Input index.
* @param {Address} addr - Address used to build. The address
* must be able to redeem the coin.
* @returns {Boolean} Whether the script was able to be built.
* @throws on unavailable coins.
*/
MTX.prototype.scriptInput = function scriptInput(index, addr) {
var input, prev, n, i, redeemScript, witnessScript, vector, dummy;
assert(this.ts === 0, 'Cannot modify a confirmed tx.');
if (typeof index !== 'number')
index = this.inputs.indexOf(index);
// Get the input
input = this.inputs[index];
assert(input);
// We should have previous outputs by now.
assert(input.coin, 'Coins are not available for scripting.');
// Optimization: Don't bother with any below
// calculation if the output is already templated.
// Just say this is "our" output.
if (input.script.code.length || input.witness.items.length)
return true;
// Optimization: test output against the
// address map to avoid unnecessary calculation.
// A hash table lookup may be faster than all
// the nonsense below.
if (!addr.ownOutput(input.coin))
return false;
// Get the previous output's script
prev = input.coin.script;
// This is easily the hardest part about building a transaction
// with segwit: figuring out where the redeem script and witness
// redeem scripts go.
if (prev.isScripthash()) {
if (addr.program && utils.isEqual(prev.code[1], addr.programHash)) {
// Witness program nested in regular P2SH.
redeemScript = addr.program.encode();
vector = input.witness.items;
dummy = new Buffer([]);
if (addr.program.isWitnessScripthash()) {
// P2WSH nested within pay-to-scripthash
// (it had to be this complicated, didn't it?)
witnessScript = addr.script.encode();
prev = addr.script;
} else if (addr.program.isWitnessPubkeyhash()) {
// P2WPKH nested within pay-to-scripthash.
prev = Script.createPubkeyhash(addr.keyHash);
} else {
assert(false, 'Unknown program.');
}
} else if (addr.script && utils.isEqual(prev.code[1], addr.scriptHash160)) {
// Regular P2SH.
redeemScript = addr.script.encode();
vector = input.script.code;
prev = addr.script;
dummy = opcodes.OP_0;
} else {
return false;
}
} else if (prev.isWitnessProgram()) {
// Witness program.
vector = input.witness.items;
dummy = new Buffer([]);
if (prev.isWitnessScripthash()) {
// Bare P2WSH.
if (!addr.script || !utils.isEqual(prev.code[1], addr.scriptHash256))
return false;
witnessScript = addr.script.encode();
prev = addr.script;
} else if (prev.isWitnessPubkeyhash()) {
// Bare P2WPKH.
if (!utils.isEqual(prev.code[1], addr.keyHash))
return false;
prev = Script.createPubkeyhash(prev.code[1]);
} else {
// Bare... who knows?
return false;
}
} else {
// Wow, a normal output! Praise be to Jengus and Gord.
vector = input.script.code;
dummy = opcodes.OP_0;
}
if (prev.isPubkey()) {
// P2PK
if (!utils.isEqual(prev.code[0], addr.publicKey))
return false;
// Already has a script template (at least)
if (vector.length)
return true;
vector[0] = dummy;
} else if (prev.isPubkeyhash()) {
// P2PKH
if (!utils.isEqual(prev.code[2], addr.keyHash))
return false;
// Already has a script template (at least)
if (vector.length)
return true;
vector[0] = dummy;
vector[1] = addr.publicKey;
} else if (prev.isMultisig()) {
// Multisig
if (utils.indexOf(prev.code, addr.publicKey) === -1)
return false;
// Already has a script template (at least)
if (vector.length)
return true;
// Technically we should create m signature slots,
// but we create n signature slots so we can order
// the signatures properly.
vector[0] = dummy;
// Grab `n` value (number of keys).
n = Script.getSmall(prev.code[prev.code.length - 2]);
// Fill script with `n` signature slots.
for (i = 0; i < n; i++)
vector[i + 1] = dummy;
} else {
if (utils.indexOf(prev.code, addr.publicKey) === -1)
return false;
// Already has a script template (at least)
if (vector.length)
return true;
// Likely a non-standard scripthash multisig
// input. Determine n value by counting keys.
// Also, only allow nonstandard types for
// scripthash.
vector[0] = dummy;
// Fill script with `n` signature slots.
for (i = 0; i < prev.code.length; i++) {
if (Script.isKey(prev.code[i]))
vector[i + 1] = dummy;
}
}
// P2SH requires the redeem
// script after signatures.
if (redeemScript)
input.script.code.push(redeemScript);
// P2WSH requires the witness
// script after signatures.
if (witnessScript)
input.witness.items.push(witnessScript);
return true;
};
/**
* Create a signature suitable for inserting into scriptSigs/witnesses.
* @param {Number} index - Index of input being signed.
* @param {Script} prev - Previous output script or redeem script
* (in the case of witnesspubkeyhash, this should be the generated
* p2pkh script).
* @param {SighashType} type
* @param {Number} version - Sighash version (0=legacy, 1=segwit).
* @returns {Buffer} Signature in DER format.
*/
MTX.prototype.createSignature = function createSignature(index, prev, key, type, version) {
var hash;
if (typeof index !== 'number')
index = this.inputs.indexOf(index);
if (type == null)
type = 'all';
if (typeof type === 'string')
type = constants.hashType[type];
// Get the hash of the current tx, minus the other
// inputs, plus the sighash type.
hash = this.signatureHash(index, prev, type, version);
// Sign the transaction with our one input
return Script.sign(hash, key, type);
};
/**
* Sign an input.
* @param {Number} index - Index of input being signed.
* @param {Address} addr - Address used to sign. The address
* must be able to redeem the coin.
* @param {SighashType} type
* @returns {Boolean} Whether the input was able to be signed.
* @throws on unavailable coins.
*/
MTX.prototype.signInput = function signInput(index, addr, type) {
var input, prev, signature, index, signatures, i;
var len, m, n, keys, vector, dummy, version;
assert(this.ts === 0, 'Cannot modify a confirmed tx.');
if (typeof index !== 'number')
index = this.inputs.indexOf(index);
// Get the input
input = this.inputs[index];
assert(input);
// We should have previous outputs by now.
assert(input.coin, 'Coins are not available for signing.');
// Get the previous output's script
prev = input.coin.script;
vector = input.script.code;
len = vector.length;
dummy = opcodes.OP_0;
version = 0;
// We need to grab the redeem script when
// signing p2sh transactions.
if (prev.isScripthash()) {
prev = input.script.getRedeem();
len = vector.length - 1;
}
// If the output script is a witness program,
// we have to switch the vector to the witness
// and potentially alter the length. Note that
// witnesses are stack items, so the `dummy`
// _has_ to be an empty buffer (what OP_0
// pushes onto the stack).
if (prev.isWitnessScripthash()) {
prev = input.witness.getRedeem();
vector = input.witness.items;
len = vector.length - 1;
dummy = new Buffer([]);
version = 1;
} else if (prev.isWitnessPubkeyhash()) {
prev = Script.createPubkeyhash(prev.code[1]);
vector = input.witness.items;
len = vector.length;
dummy = new Buffer([]);
version = 1;
}
// Create our signature.
signature = this.createSignature(index, prev, addr.key, type, version);
// P2PK
if (prev.isPubkey()) {
// Already signed.
if (Script.isSignature(vector[0]))
return true;
// Make sure the pubkey is ours.
if (!utils.isEqual(addr.publicKey, prev.code[0]))
return false;
vector[0] = signature;
return true;
}
// P2PKH
if (prev.isPubkeyhash()) {
// Already signed.
if (Script.isSignature(vector[0]))
return true;
// Make sure the pubkey hash is ours.
if (!utils.isEqual(addr.keyHash, prev.code[2]))
return false;
vector[0] = signature;
return true;
}
// Multisig
if (prev.isMultisig()) {
// Grab the redeem script's keys to figure
// out where our key should go.
keys = prev.code.slice(1, -2);
// Grab `m` value (number of sigs required).
m = Script.getSmall(prev.code[0]);
// Grab `n` value (number of keys).
n = Script.getSmall(prev.code[prev.code.length - 2]);
} else {
// Only allow non-standard signing for
// scripthash.
if (len !== vector.length - 1)
return false;
keys = [];
for (i = 0; i < prev.code.length; i++) {
if (Script.isKey(prev.code[i]))
keys.push(prev.code[i]);
}
// We don't know what m is, so
// we can never finalize the signatures.
m = keys.length;
n = keys.length;
}
// Something is very wrong here. Abort.
if (len - 1 > n)
return false;
// Count the number of current signatures.
signatures = 0;
for (i = 1; i < len; i++) {
if (Script.isSignature(vector[i]))
signatures++;
}
// Signatures are already finalized.
if (signatures === m && len - 1 === m)
return true;
// This can happen in a case where another
// implementation adds signatures willy-nilly
// or by `m`. Add some signature slots for
// us to use.
while (len - 1 < n) {
vector.splice(len, 0, dummy);
len++;
}
// Find the key index so we can place
// the signature in the same index.
index = utils.indexOf(keys, addr.publicKey);
// Our public key is not in the prev_out
// script. We tried to sign a transaction
// that is not redeemable by us.
if (index === -1)
return false;
// Offset key index by one to turn it into
// "sig index". Accounts for OP_0 byte at
// the start.
index++;
// Add our signature to the correct slot
// and increment the total number of
// signatures.
if (index < len && signatures < m) {
if (Script.isZero(vector[index])) {
vector[index] = signature;
signatures++;
}
}
// All signatures added. Finalize.
if (signatures >= m) {
// Remove empty slots left over.
for (i = len - 1; i >= 1; i--) {
if (Script.isZero(vector[i])) {
vector.splice(i, 1);
len--;
}
}
// Remove signatures which are not required.
// This should never happen except when dealing
// with implementations that potentially handle
// signature slots differently.
while (signatures > m) {
vector.splice(len - 1, 1);
signatures--;
len--;
}
// Sanity checks.
assert(signatures === m);
assert(len - 1 === m);
}
return signatures === m;
};
/**
* Test whether the transaction is fully-signed.
* @returns {Boolean}
*/
MTX.prototype.isSigned = function isSigned() {
var i, input, prev, vector, m, len, j;
var total = 0;
for (i = 0; i < this.inputs.length; i++) {
input = this.inputs[i];
// We can't check for signatures unless
// we have the previous output.
if (!input.coin)
return false;
// Get the prevout's script
prev = input.coin.script;
// Script length, needed for multisig
vector = input.script.code;
len = vector.length;
// We need to grab the redeem script when
// signing p2sh transactions.
if (prev.isScripthash()) {
prev = input.script.getRedeem();
len = vector.length - 1;
}
// If the output script is a witness program,
// we have to switch the vector to the witness
// and potentially alter the length.
if (prev.isWitnessScripthash()) {
prev = input.witness.getRedeem();
vector = input.witness.items;
len = vector.length - 1;
} else if (prev.isWitnessPubkeyhash()) {
prev = Script.createPubkeyhash(prev.code[1]);
vector = input.witness.items;
len = vector.length;
}
if (prev.isPubkey()) {
if (!Script.isSignature(vector[0]))
return false;
} else if (prev.isPubkeyhash()) {
if (!Script.isSignature(vector[0]))
return false;
} else if (prev.isMultisig()) {
// Grab `m` value (number of required sigs).
m = Script.getSmall(prev.code[0]);
// Ensure all members are signatures.
for (j = 1; j < len; j++) {
if (!Script.isSignature(vector[j]))
return false;
}
// Ensure we have the correct number
// of required signatures.
if (len - 1 !== m)
return false;
} else {
return false;
}
}
return true;
};
/**
* Built input scripts (or witnesses) and sign the inputs.
* @param {Number} index - Index of input being signed.
* @param {Address} addr - Address used to sign. The address
* must be able to redeem the coin.
* @param {SighashType} type
* @returns {Boolean} Whether the input was able to be signed.
* @throws on unavailable coins.
*/
MTX.prototype.sign = function sign(index, addr, type) {
var input;
if (index && typeof index === 'object')
index = this.inputs.indexOf(index);
input = this.inputs[index];
assert(input);
// Build script for input
if (!this.scriptInput(index, addr))
return false;
// Sign input
if (!this.signInput(index, addr, type))
return false;
return true;
};
/**
* Add an output.
* @example
* tx.addOutput({ address: ..., value: new bn(100000) });
* tx.addOutput({ address: ..., value: utils.satoshi('0.1') });
* tx.addOutput(receivingWallet, utils.satoshi('0.1'));
* @param {Wallet|Address|Object} obj - Wallet, Address, or options (see {@link Script.createOutputScript} for options).
* @param {BN?} value - Only needs to be present for non-options.
*/
MTX.prototype.addOutput = function addOutput(obj, value) {
var options, output;
assert(this.ts === 0, 'Cannot modify a confirmed tx.');
if ((obj instanceof bcoin.wallet) || (obj instanceof bcoin.address))
obj = obj.getAddress();
if (typeof obj === 'string') {
options = {
address: obj,
value: value
};
} else {
options = obj;
}
output = bcoin.output(options, this);
this.outputs.push(output);
this.scriptOutput(this.outputs.length - 1, options);
return this;
};
/**
* Build output script (called automatically from {@link MTX#addOutput}).
* @param {Number} index - Output index.
* @param {Object} options - See {@link Script.createOutputScript}.
*/
MTX.prototype.scriptOutput = function scriptOutput(index, options) {
var output;
assert(this.ts === 0, 'Cannot modify a confirmed tx.');
if (options instanceof bcoin.output)
return;
if (typeof index !== 'number')
index = this.outputs.indexOf(index);
output = this.outputs[index];
assert(output);
if (options.script instanceof Script)
output.script = options.script.clone();
else if (options.script)
output.script = Script(options.script);
else
output.script = Script.createOutputScript(options);
};
/**
* Test whether the transaction at least
* has all script templates built.
* @returns {Boolean}
*/
MTX.prototype.isScripted = function isScripted() {
var i, input;
if (this.outputs.length === 0)
return false;
if (this.inputs.length === 0)
return false;
for (i = 0; i < this.inputs.length; i++) {
input = this.inputs[i];
if (input.script.code.length === 0)
return false;
if (input.witness.items.length === 0)
return false;
}
return true;
};
/**
* Estimate maximum possible size.
* @param {(Wallet|Object)?} options - Wallet or options object.
* @param {Number} options.m - Multisig `m` value.
* @param {Number} options.n - Multisig `n` value.
* @param {Boolean} force - `maxSize` will just calculate
* the virtual size instead of _estimating_ it if the
* templates are already built. If true, this will force
* estimation of the size.
* @returns {Number}
*/
MTX.prototype.maxSize = function maxSize(options, force) {
var i, j, input, total, size, prev, m, n;
var witness, hadWitness, redeem, wallet;
if (!force && this.isScripted())
return this.getVirtualSize();
if (!options)
options = {};
if (options instanceof bcoin.wallet)
options = { wallet: options, m: options.m, n: options.n };
if (options.wallet)
wallet = options.wallet;
// Calculate the size, minus the input scripts.
total = bcoin.protocol.framer.tx.size(this);
for (i = 0; i < this.inputs.length; i++) {
input = this.inputs[i];
size = input.script.getSize();
total -= utils.sizeVarint(size) + size;
total += 1;
}
// Add size for signatures and public keys
for (i = 0; i < this.inputs.length; i++) {
input = this.inputs[i];
size = 0;
witness = false;
// We're out of luck here.
// Just assume it's a p2pkh.
if (!input.coin) {
total += 110;
continue;
}
// Get the previous output's script
prev = input.coin.script;
// If we have access to the redeem script,
// we can use it to calculate size much easier.
if (prev.isScripthash()) {
// Need to add the redeem script size
// here since it will be ignored by
// the isMultisig clause.
// OP_PUSHDATA2 [redeem]
redeem = wallet
? wallet.getRedeem(prev.code[1])
: input.script.getRedeem();
if (redeem) {
prev = redeem;
size += utils.sizePush(prev.getSize());
size += prev.getSize();
}
}
if (prev.isWitnessProgram()) {
witness = true;
// Now calculating vsize. The regular
// redeem script (if there was one)
// is now worth 4 points.
size *= 4;
// Add 2 bytes for flag and marker.
if (!hadWitness)
size += 2;
hadWitness = true;
if (prev.isWitnessScripthash()) {
redeem = wallet
? wallet.getRedeem(prev.code[1])
: input.witness.getRedeem();
if (redeem) {
prev = redeem;
size += utils.sizePush(prev.getSize());
size += prev.getSize();
}
} else if (prev.isWitnessPubkeyhash()) {
prev = Script.createPubkeyhash(prev.code[1]);
}
}
if (prev.isPubkey()) {
// P2PK
// OP_PUSHDATA0 [signature]
size += 1 + 73;
} else if (prev.isPubkeyhash()) {
// P2PKH
// OP_PUSHDATA0 [signature]
size += 1 + 73;
// OP_PUSHDATA0 [key]
size += 1 + 33;
} else if (prev.isMultisig()) {
// Bare Multisig
// Get the previous m value:
m = Script.getSmall(prev.code[0]);
// OP_0
size += 1;
// OP_PUSHDATA0 [signature] ...
size += (1 + 73) * m;
} else if (prev.isScripthash() || prev.isWitnessScripthash()) {
// P2SH Multisig
// This technically won't work well for other
// kinds of P2SH. It will also over-estimate
// the fee by a lot (at least 10000 satoshis
// since we don't have access to the m and n
// values), which will be recalculated later.
// If fee turns out to be smaller later, we
// simply add more of the fee to the change
// output.
// m value
m = options.m || 15;
// n value
n = options.n || 15;
// OP_0
size += 1;
// OP_PUSHDATA0 [signature] ...
size += (1 + 73) * m;
// OP_PUSHDATA2 [redeem]
size += 3;
// m value
size += 1;
// OP_PUSHDATA0 [key] ...
size += (1 + 33) * n;
// n value
size += 1;
// OP_CHECKMULTISIG
size += 1;
} else {
// OP_PUSHDATA0 [signature]
for (j = 0; j < prev.code.length; j++) {
if (Script.isKey(prev.code[j]))
size += 1 + 73;
}
}
// Byte for varint size of input script or witness.
size += utils.sizeVarint(size);
// Calculate vsize if we're a witness program.
if (witness) {
// Add one byte back for the 0-byte input script.
size += 1 * 4;
size = (size + 3) / 4 | 0;
}
total += size;
}
return total;
};
/**
* Select necessary coins based on total output value.
* @param {Coin[]} coins
* @param {Object?} options
* @param {String?} options.selection - Coin selection priority. Can
* be `age`, `random`, or `all`. (default=age).
* @param {Boolean} options.accurate - Whether to use "accurate"
* fee calculatation rather than rounding to the nearest kilobyte.
* See {@link TX#getMinFee} vs. {@link TX#getMaxFee}.
* @param {Boolean} options.confirmed - Select only confirmed coins.
* @param {Boolean} options.free - Do not apply a fee if the
* transaction priority is high enough to be considered free.
* @param {BN?} options.fee - Use a hard fee rather than calculating one.
* @param {Number|Boolean} options.subtractFee - Whether to subtract the
* fee from * existing outputs rather than adding more inputs.
* @returns {Object} {
* chosen: {@link Coin}[],
* change: {@link BN},
* fee: {@link BN},
* total: {@link BN}
* }
* @throws on not enough funds available.
* @throws on unable to subtract fee.
*/
MTX.prototype.selectCoins = function selectCoins(coins, options) {
var chosen = [];
var index = 0;
var tx = this.clone();
var outputValue = tx.getOutputValue();
var tryFree, i, size, change, fee, minValue;
if (!options)
options = {};
tryFree = options.free;
// Null the inputs if there are any.
tx.inputs.length = 0;
if (options.confirmed) {
coins = coins.filter(function(coin) {
return coin.height !== -1;
});
}
if (!options.selection || options.selection === 'age') {
// Oldest unspents first
coins = coins.slice().sort(function(a, b) {
a = a.height === -1 ? 0x7fffffff : a.height;
b = b.height === -1 ? 0x7fffffff : b.height;
return a - b;
});
} else if (options.selection === 'random' || options.selection === 'all') {
// Random unspents
coins = coins.slice().sort(function() {
return Math.random() > 0.5 ? 1 : -1;
});
}
function total() {
if (options.subtractFee != null)
return outputValue;
return outputValue.add(fee);
}
function isFull() {
return tx.getInputValue().cmp(total()) >= 0;
}
function addCoins() {
while (index < coins.length) {
// Add new inputs until TX will have enough
// funds to cover both minimum post cost
// and fee.
tx.addInput(coins[index]);
chosen.push(coins[index]);
index++;
if (options.selection === 'all')
continue;
// Stop once we're full.
if (isFull())
break;
}
}
if (options.fee) {
fee = options.fee;
// Transfer `total` funds maximum.
addCoins();
} else {
fee = new bn(constants.tx.minFee);
// Transfer `total` funds maximum.
addCoins();
// Add dummy output (for `change`) to
// calculate maximum TX size.
tx.addOutput({
address: options.changeAddress,
// In case we don't have a change address,
// use a fake p2pkh output to gauge size.
keyHash: constants.zeroHash.slice(0, 20),
value: new bn(0)
});
// Change fee value if it is more than 1024
// bytes (10000 satoshi for every 1024 bytes).
do {
// Calculate max possible size after signing.
size = tx.maxSize(options, true);
if (tryFree) {
if (tx.isFree(network.height + 1, size)) {
fee = new bn(0);
break;
}
tryFree = false;
}
if (options.accurate)
fee = tx.getMinFee(size);
else
fee = tx.getMaxFee(size);
// Failed to get enough funds, add more coins.
if (!isFull())
addCoins();
} while (!isFull() && index < coins.length);
}
if (!isFull()) {
// Still failing to get enough funds.
err = new Error('Could not select coins.');
err.requiredFunds = total();
throw err;
}
// How much money is left after filling outputs.
change = tx.getInputValue().sub(total());
// Attempt to subtract fee.
if (options.subtractFee != null) {
minValue = fee.addn(constants.tx.dustThreshold);
if (typeof options.subtractFee === 'number') {
i = options.subtractFee;
if (i > tx.outputs.length - 1)
throw new Error('Subtraction index does not exist.');
if (tx.outputs[i].value.cmp(minValue) < 0)
throw new Error('Could not subtract fee.');
tx.outputs[i].value.isub(fee);
} else {
for (i = 0; i < tx.outputs.length; i++) {
if (tx.outputs[i].value.cmp(minValue) >= 0) {
tx.outputs[i].value.isub(fee);
break;
}
}
if (i === tx.outputs.length)
throw new Error('Could not subtract fee.');
}
}
// Return necessary inputs and change.
return {
coins: chosen,
change: change,
fee: fee,
total: total()
};
};
/**
* Select coins and fill the inputs.
* @param {Coin[]} coins
* @param {Object} options - See {@link MTX#selectCoins} options.
* @returns {Object} See {@link MTX#selectCoins} return value.
*/
MTX.prototype.fill = function fill(coins, options) {
var result, i;
assert(this.ts === 0, 'Cannot modify a confirmed tx.');
assert(this.inputs.length === 0, 'TX is already filled.');
assert(options, '`options` are required.');
assert(options.changeAddress, '`changeAddress` is required.');
// Select necessary coins.
result = this.selectCoins(coins, options);
// Add coins to transaction.
for (i = 0; i < result.coins.length; i++)
this.addInput(result.coins[i]);
if (result.change.cmpn(constants.tx.dustThreshold) < 0) {
// Do nothing. Change is added to fee.
assert(this.getFee().cmp(result.fee.add(result.change)) === 0);
this.changeIndex = -1;
} else {
// Add a change output.
this.addOutput({
address: options.changeAddress,
value: result.change
});
this.changeIndex = this.outputs.length - 1;
assert(this.getFee().cmp(result.fee) === 0);
}
return result;
};
/**
* Sort inputs and outputs according to BIP69.
* @see https://github.com/bitcoin/bips/blob/master/bip-0069.mediawiki
*/
MTX.prototype.sortMembers = function sortMembers() {
var changeOutput;
assert(this.ts === 0, 'Cannot modify a confirmed tx.');
if (this.changeIndex !== -1) {
changeOutput = this.outputs[this.changeIndex];
assert(changeOutput);
}
this.inputs = this.inputs.slice().sort(function(a, b) {
var h1 = new Buffer(a.prevout.hash, 'hex');
var h2 = new Buffer(b.prevout.hash, 'hex');
var res = utils.cmp(h1, h2);
if (res !== 0)
return res;
return a.prevout.index - b.prevout.index;
});
this.outputs = this.outputs.slice().sort(function(a, b) {
var res = a.value.cmp(b.value);
if (res !== 0)
return res;
return utils.cmp(a.encode(), b.encode());
});
if (this.changeIndex !== -1) {
this.changeIndex = this.outputs.indexOf(changeOutput);
assert(this.changeIndex !== -1);
}
};
/**
* Avoid fee sniping.
* @param {Number?} [height=network.height] - Current chain height.
* @see bitcoin/src/wallet/wallet.cpp
*/
MTX.prototype.avoidFeeSniping = function avoidFeeSniping(height) {
if (height == null)
height = network.height;
if (height === -1)
height = 0;
if ((Math.random() * 10 | 0) === 0)
this.setLocktime(Math.max(0, height - (Math.random() * 100 | 0)));
else
this.setLocktime(height);
};
/**
* Set locktime and sequences appropriately.
* @param {Number} locktime
*/
MTX.prototype.setLocktime = function setLocktime(locktime) {
var i, input;
assert(this.ts === 0, 'Cannot modify a confirmed tx.');
for (i = 0; i < this.inputs.length; i++) {
input = this.inputs[i];
if (input.sequence === 0xffffffff)
input.sequence = 0xffffffff - 1;
}
this.locktime = locktime;
};
/**
* @see TX._fromJSON
*/
MTX._fromJSON = bcoin.tx._fromJSON;
/**
* @see TX.fromJSON
*/
MTX.fromJSON = function fromJSON(json) {
return new MTX(MTX._fromJSON(json));
};
/**
* @see TX._fromRaw
*/
MTX._fromRaw = bcoin.tx._fromRaw;
/**
* @see TX.fromRaw
*/
MTX.fromRaw = function fromRaw(data, enc) {
return new MTX(MTX._fromRaw(data, enc));
};
/**
* @see TX._fromExtended
*/
MTX._fromExtended = bcoin.tx._fromExtended;
/**
* @see TX.fromExtended
*/
MTX.fromExtended = function fromExtended(data, enc) {
return new MTX(MTX._fromExtended(data, enc));
};
/**
* Convert a TX to an MTX.
* @param {TX} tx
* @returns {MTX}
*/
MTX.fromTX = function fromTX(tx) {
return new MTX(tx);
};
/**
* Convert the MTX to a TX.
* @returns {TX}
*/
MTX.prototype.toTX = function toTX() {
return new bcoin.tx(this);
};
/**
* Test an object to see if it is a TX.
* @param {Object} obj
* @returns {Boolean}
*/
MTX.isMTX = function isMTX(obj) {
return obj
&& Array.isArray(obj.inputs)
&& typeof obj.ps === 'number'
&& typeof obj.changeIndex === 'number'
&& typeof obj.scriptInput === 'function';
};
return MTX;
};