163 lines
3.7 KiB
JavaScript
163 lines
3.7 KiB
JavaScript
/*!
|
|
* headers.js - headers object for bcoin
|
|
* 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 bcoin = require('./env');
|
|
var utils = require('./utils');
|
|
|
|
/**
|
|
* Represents block headers obtained from the network via `headers`.
|
|
* @exports Headers
|
|
* @constructor
|
|
* @extends AbstractBlock
|
|
* @param {NakedBlock} data
|
|
* @property {Number} version - Block version. Note
|
|
* that BCoin reads versions as unsigned despite
|
|
* them being signed on the protocol level. This
|
|
* number will never be negative.
|
|
* @property {Hash} prevBlock - Previous block hash.
|
|
* @property {Hash} merkleRoot - Merkle root hash.
|
|
* @property {Number} ts - Timestamp.
|
|
* @property {Number} bits
|
|
* @property {Number} nonce
|
|
* @property {Number} totalTX - Transaction count.
|
|
* @property {Number} height - Block height (-1 if not present).
|
|
* @property {ReversedHash} rhash - Reversed block hash (uint256le).
|
|
*/
|
|
|
|
function Headers(data) {
|
|
if (!(this instanceof Headers))
|
|
return new Headers(data);
|
|
|
|
bcoin.abstractblock.call(this, data);
|
|
}
|
|
|
|
utils.inherits(Headers, bcoin.abstractblock);
|
|
|
|
/**
|
|
* Do non-contextual verification on the headers.
|
|
* @alias Headers#verify
|
|
* @param {Object?} ret - Return object, may be
|
|
* set with properties `reason` and `score`.
|
|
* @returns {Boolean}
|
|
*/
|
|
|
|
Headers.prototype._verify = function _verify(ret) {
|
|
return this.verifyHeaders(ret);
|
|
};
|
|
|
|
/**
|
|
* Get size of the headers.
|
|
* @returns {Number}
|
|
*/
|
|
|
|
Headers.prototype.getSize = function getSize() {
|
|
var writer = new bcoin.writer();
|
|
this.toRaw(writer);
|
|
return writer.written;
|
|
};
|
|
|
|
/**
|
|
* Inspect the headers and return a more
|
|
* user-friendly representation of the data.
|
|
* @returns {Object}
|
|
*/
|
|
|
|
Headers.prototype.inspect = function inspect() {
|
|
return {
|
|
type: 'headers',
|
|
hash: this.rhash,
|
|
height: this.height,
|
|
date: utils.date(this.ts),
|
|
version: this.version,
|
|
prevBlock: utils.revHex(this.prevBlock),
|
|
merkleRoot: utils.revHex(this.merkleRoot),
|
|
ts: this.ts,
|
|
bits: this.bits,
|
|
nonce: this.nonce,
|
|
totalTX: this.totalTX
|
|
};
|
|
};
|
|
|
|
/**
|
|
* Serialize the headers.
|
|
* @see {Headers#render}
|
|
* @param {String?} enc - Encoding, can be `'hex'` or null.
|
|
* @returns {Buffer|String}
|
|
*/
|
|
|
|
Headers.prototype.toRaw = function toRaw(writer) {
|
|
var p = bcoin.writer(writer);
|
|
|
|
p.write32(this.version);
|
|
p.writeHash(this.prevBlock);
|
|
p.writeHash(this.merkleRoot);
|
|
p.writeU32(this.ts);
|
|
p.writeU32(this.bits);
|
|
p.writeU32(this.nonce);
|
|
p.writeVarint(this.totalTX);
|
|
|
|
if (!writer)
|
|
p = p.render();
|
|
|
|
return p;
|
|
};
|
|
|
|
/**
|
|
* Parse a serialized headers.
|
|
* @param {Buffer} data
|
|
* @param {String?} enc - Encoding, can be `'hex'` or null.
|
|
* @returns {NakedBlock} A "naked" headers object.
|
|
*/
|
|
|
|
Headers.prototype.fromRaw = function fromRaw(data) {
|
|
var p = bcoin.reader(data);
|
|
|
|
this.version = p.readU32(); // Technically signed
|
|
this.prevBlock = p.readHash('hex');
|
|
this.merkleRoot = p.readHash('hex');
|
|
this.ts = p.readU32();
|
|
this.bits = p.readU32();
|
|
this.nonce = p.readU32();
|
|
this.totalTX = p.readVarint();
|
|
|
|
return this;
|
|
};
|
|
|
|
/**
|
|
* Instantiate headers from a serialized Buffer.
|
|
* @param {Buffer} data
|
|
* @param {String?} enc - Encoding, can be `'hex'` or null.
|
|
* @returns {Headers}
|
|
*/
|
|
|
|
Headers.fromRaw = function fromRaw(data, enc) {
|
|
if (typeof data === 'string')
|
|
data = new Buffer(data, enc);
|
|
return new Headers().fromRaw(data);
|
|
};
|
|
|
|
/**
|
|
* Test an object to see if it is a Headers object.
|
|
* @param {Object} obj
|
|
* @returns {Boolean}
|
|
*/
|
|
|
|
Headers.isHeaders = function isHeaders(obj) {
|
|
return obj
|
|
&& !obj.txs
|
|
&& typeof obj.abbr === 'function'
|
|
&& typeof obj.toBlock !== 'function';
|
|
};
|
|
|
|
/*
|
|
* Expose
|
|
*/
|
|
|
|
module.exports = Headers;
|