/*! * 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'; const assert = require('assert'); const util = require('../utils/util'); const digest = require('../crypto/digest'); const StaticWriter = require('../utils/staticwriter'); const InvItem = require('./invitem'); const encoding = require('../utils/encoding'); const 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) { this._hash = null; this._hhash = null; this._size = -1; this._witness = -1; if (!all) return; if (!this.txs) return; for (let tx of this.txs) 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) { let hash = this._hash; if (!hash) { hash = digest.hash256(this.abbr()); if (!this.mutable) this._hash = hash; } if (enc === 'hex') { let 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. * @returns {Boolean} */ AbstractBlock.prototype.verifyBody = function verifyBody() { throw new Error('Abstract method.'); }; /** * Get little-endian block hash. * @returns {Hash} */ AbstractBlock.prototype.rhash = function rhash() { 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;