/*! * abstractblock.js - abstract block object for bcoin * Copyright (c) 2014-2015, Fedor Indutny (MIT License) * Copyright (c) 2014-2017, Christopher Jeffrey (MIT License). * https://github.com/bcoin-org/bcoin */ 'use strict'; var assert = require('assert'); var util = require('../utils/util'); var crypto = require('../crypto/crypto'); var StaticWriter = require('../utils/staticwriter'); var InvItem = require('./invitem'); var encoding = require('../utils/encoding'); var consensus = require('../protocol/consensus'); /** * The class which all block-like objects inherit from. * @alias module:primitives.AbstractBlock * @constructor * @abstract * @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 {TX[]} txs - Transaction vector. * @property {ReversedHash} rhash - Reversed block hash (uint256le). */ function AbstractBlock() { if (!(this instanceof AbstractBlock)) return new AbstractBlock(); this.version = 1; this.prevBlock = encoding.NULL_HASH; this.merkleRoot = encoding.NULL_HASH; this.ts = 0; this.bits = 0; this.nonce = 0; this.txs = null; this.mutable = false; this._hash = null; this._hhash = null; this._size = -1; this._witness = -1; } /** * Memory flag. * @const {Boolean} * @default * @memberof AbstractBlock# */ AbstractBlock.prototype.memory = false; /** * Inject properties from options object. * @private * @param {NakedBlock} options */ AbstractBlock.prototype.parseOptions = function parseOptions(options) { assert(options, 'Block data is required.'); assert(util.isNumber(options.version)); assert(typeof options.prevBlock === 'string'); assert(typeof options.merkleRoot === 'string'); assert(util.isNumber(options.ts)); assert(util.isNumber(options.bits)); assert(util.isNumber(options.nonce)); this.version = options.version; this.prevBlock = options.prevBlock; this.merkleRoot = options.merkleRoot; this.ts = options.ts; this.bits = options.bits; this.nonce = options.nonce; if (options.mutable != null) this.mutable = !!options.mutable; return this; }; /** * Inject properties from json object. * @private * @param {Object} json */ AbstractBlock.prototype.parseJSON = function parseJSON(json) { assert(json, 'Block data is required.'); assert(util.isNumber(json.version)); assert(typeof json.prevBlock === 'string'); assert(typeof json.merkleRoot === 'string'); assert(util.isNumber(json.ts)); assert(util.isNumber(json.bits)); assert(util.isNumber(json.nonce)); this.version = json.version; this.prevBlock = util.revHex(json.prevBlock); this.merkleRoot = util.revHex(json.merkleRoot); this.ts = json.ts; this.bits = json.bits; this.nonce = json.nonce; return this; }; /** * Clear any cached values (abstract). * @param {Boolean?} all - Clear transactions. */ AbstractBlock.prototype._refresh = function refresh(all) { var i, tx; this._hash = null; this._hhash = null; this._size = -1; this._witness = -1; if (!all) return; if (!this.txs) return; for (i = 0; i < this.txs.length; i++) { tx = this.txs[i]; tx.refresh(); } }; /** * Clear any cached values. * @param {Boolean?} all - Clear transactions. */ AbstractBlock.prototype.refresh = function refresh(all) { return this._refresh(all); }; /** * Hash the block headers. * @param {String?} enc - Can be `'hex'` or `null`. * @returns {Hash|Buffer} hash */ AbstractBlock.prototype.hash = function hash(enc) { var hash = this._hash; var hex; if (!hash) { hash = crypto.hash256(this.abbr()); if (!this.mutable) this._hash = hash; } if (enc === 'hex') { hex = this._hhash; if (!hex) { hex = hash.toString('hex'); if (!this.mutable) this._hhash = hex; } hash = hex; } return hash; }; /** * Serialize the block headers. * @returns {Buffer} */ AbstractBlock.prototype.abbr = function abbr() { return this.writeAbbr(new StaticWriter(80)).render(); }; /** * Serialize the block headers. * @param {BufferWriter} bw */ AbstractBlock.prototype.writeAbbr = function writeAbbr(bw) { bw.writeU32(this.version); bw.writeHash(this.prevBlock); bw.writeHash(this.merkleRoot); bw.writeU32(this.ts); bw.writeU32(this.bits); bw.writeU32(this.nonce); return bw; }; /** * Parse the block headers. * @param {BufferReader} br */ AbstractBlock.prototype.parseAbbr = function parseAbbr(br) { this.version = br.readU32(); this.prevBlock = br.readHash('hex'); this.merkleRoot = br.readHash('hex'); this.ts = br.readU32(); this.bits = br.readU32(); this.nonce = br.readU32(); return this; }; /** * Verify the block. * @returns {Boolean} */ AbstractBlock.prototype.verify = function verify() { if (!this.verifyPOW()) return false; if (!this.verifyBody()) return false; return true; }; /** * Verify proof-of-work. * @returns {Boolean} */ AbstractBlock.prototype.verifyPOW = function verifyPOW() { return consensus.verifyPOW(this.hash(), this.bits); }; /** * Verify the block. * @param {Object?} ret - Return object, may be * set with properties `reason` and `score`. * @returns {Boolean} */ AbstractBlock.prototype.verifyBody = function verifyBody(ret) { throw new Error('Abstract method.'); }; /** * Get little-endian block hash. * @returns {Hash} */ AbstractBlock.prototype.rhash = function() { return util.revHex(this.hash('hex')); }; /** * Convert the block to an inv item. * @returns {InvItem} */ AbstractBlock.prototype.toInv = function toInv() { return new InvItem(InvItem.types.BLOCK, this.hash('hex')); }; /* * Expose */ module.exports = AbstractBlock;