@dashevo/dash-spv 0.24.11 → 0.24.12

package/.mocharc.yml

@@ -0,0 +1,4 @@
+exit: true
+timeout: 3000
+file:
+  - ./lib/test/bootstrap.js

package/.ultra.cache.json

@@ -1 +1 @@
-{"files":{".eslintignore":"5772aab4a649e8c99c5b74bd685792cd6a69f9ac",".eslintrc.json":"41aa1d3c1477f203b588dcb5c0015454edd94481",".gitignore":"095d365a56f423d4fab2345c95c137e7c6ea45c0","LICENSE":"95bf3c7cb642fb61c1bbbb319fd3c83e47a5af96","README.md":"3659fd1bfb44b5e6916679ae586ccbff18683e59","config/config.js":"267c3536b5fe54c88080a56241c34d7393a54ac2","index.js":"4413accedb71ffb73ea7ce4ad45a2035c2ce92ca","lib/blockstore.js":"1ed82a8c1cfb4bc3aa96f0669a27c94d2e76b164","lib/consensus.js":"73201c7fec9c62f5f87dba7b2d0d54c08fa4fa6f","lib/errors/SPVError.js":"08b7af972c146bcdf29ffaa06eb90ca2c5660914","lib/merkleproofs.js":"dca09952c352109795af64f9490209a96e483e2f","lib/spvchain.js":"dfb38386a8c0eb1fee0c64e1b1a950125811f6db","lib/utils.js":"c2119b88a67698053e783f09c038a04ae208f232","package.json":"b16d6e333ecb69fd9b6393adc2f050ca6e016006","test/data/headers.js":"eb9cae85ee11027338fbf1f69e373d22388286d6","test/data/merkleproofs.js":"49ea4c29fb1f0cf6378ed7ee46b0a1db3bb555c1","test/data/rawHeaders.js":"03fed6ca2f8c2d1b63cfa13743431a2d551c7ad9","test/index.js":"e937184e5ee21ba882e09fcd5e5f5228d9b7ef68","test/spvchain.js":"7e6c93b2e623a3ddb93e9f250133e83f28c882e2"},"deps":{}}
+{"files":{".eslintignore":"5772aab4a649e8c99c5b74bd685792cd6a69f9ac",".eslintrc.json":"41aa1d3c1477f203b588dcb5c0015454edd94481",".gitignore":"095d365a56f423d4fab2345c95c137e7c6ea45c0",".mocharc.yml":"4b2c6eac5413c431a990afeec68f34c8398891ad","LICENSE":"95bf3c7cb642fb61c1bbbb319fd3c83e47a5af96","README.md":"3659fd1bfb44b5e6916679ae586ccbff18683e59","config/config.js":"267c3536b5fe54c88080a56241c34d7393a54ac2","index.js":"4413accedb71ffb73ea7ce4ad45a2035c2ce92ca","lib/blockstore.js":"1ed82a8c1cfb4bc3aa96f0669a27c94d2e76b164","lib/consensus.js":"73201c7fec9c62f5f87dba7b2d0d54c08fa4fa6f","lib/errors/SPVError.js":"08b7af972c146bcdf29ffaa06eb90ca2c5660914","lib/merkleproofs.js":"dca09952c352109795af64f9490209a96e483e2f","lib/spvchain.js":"167c1fecd83df5ae597c7af87471ec972c6b782e","lib/test/.eslintrc":"4c2b11fe8177c0c2fd0667acb599fc44c4c9741a","lib/test/bootstrap.js":"53142f9ec29cd1e75714de8a0be0080cf3bbda04","lib/utils.js":"c2119b88a67698053e783f09c038a04ae208f232","lib/x11.js":"d85e555bad579a8b3e2e92447331933ce9b0c4b1","package.json":"5157625ed2e10b6b204aff6591bf2957bd693786","test/data/headers.js":"eb9cae85ee11027338fbf1f69e373d22388286d6","test/data/merkleproofs.js":"49ea4c29fb1f0cf6378ed7ee46b0a1db3bb555c1","test/data/rawHeaders.js":"03fed6ca2f8c2d1b63cfa13743431a2d551c7ad9","test/index.js":"4b67c838fadf0baac0207b13ddd99b0bc8d228c0","test/spvchain.js":"58a7716c91830e0a23bd27ab857cbba70b8bee93"},"deps":{}}

package/lib/spvchain.js

@@ -1,26 +1,50 @@
+const X11 = require('./x11');
+
 const config = require('../config/config');
 const Consensus = require('./consensus');
 const utils = require('./utils');
 const SPVError = require('./errors/SPVError');
 
-const SpvChain = class {
-  // TODO: move chainType and confirms to `options`
-  constructor(chainType, confirms = 100, startBlock, startBlockHeight) {
-    this.confirmsBeforeFinal = confirms;
+const CHAIN_TYPE_NETWORKS = {
+  testnet: 'testnet',
+  devnet: 'devnet',
+  local: 'regtest',
+  regtest: 'regtest',
+  lowdiff: 'regtest',
+  livenet: 'mainnet',
+  mainnet: 'mainnet',
+};
 
-    this.reset(startBlockHeight);
-    this.init(chainType, startBlock);
+const createGenesis = (chainType) => {
+  switch (chainType) {
+    case 'testnet': return config.getTestnetGenesis();
+    case 'devnet': return config.getDevnetGenesis();
+    case 'local':
+    case 'regtest': return config.getRegtestGenesis();
+    case 'livenet':
+    case 'mainnet': return config.getLivenetGenesis();
+    case 'lowdiff': return config.getLowDiffGenesis();
+    default: throw new SPVError(`Unsupported chain type ${chainType}`);
+  }
+};
 
-    this.hashesByHeight = new Map([[this.startBlockHeight, this.root.hash]]);
+const SpvChain = class {
+  constructor(chainType, confirms = 100) {
+    this.confirmsBeforeFinal = confirms;
+    this.network = CHAIN_TYPE_NETWORKS[chainType];
+    if (!this.network) {
+      throw new SPVError(`Unsupported chain type "${chainType}"`);
+    }
+    this.genesis = createGenesis(chainType);
 
-    this.heightByHash = new Map([[this.root.hash, this.startBlockHeight]]);
+    this.reset();
+  }
 
-    // TODO: legacy - remove this
-    this.orphanBlocks = [];
+  static async wasmX11Ready() {
+    return X11.load();
   }
 
-  reset(fromBlockHeight = 0) {
-    this.root = null;
+  reset() {
     this.allBranches = [[]];
     this.orphanChunks = [];
     this.prunedHeaders = [];
@@ -28,71 +52,52 @@ const SpvChain = class {
     this.hashesByHeight = new Map();
     this.heightByHash = new Map();
     this.orphansHashes = new Set();
-    this.startBlockHeight = fromBlockHeight < 0 ? 0 : fromBlockHeight;
+    // Height of the first header in the chain.
+    // 0 - if we are synchronizing from genesis
+    // > 0 if part of the chain is pruned and we are synchronizing from checkpoint where
+    this.startBlockHeight = null;
+
+    // Head of pending first header.
+    // Used in situations where we don't know root in advance
+    this.pendingStartBlockHeight = null;
   }
 
-  init(chainType, startBlock) {
-    switch (chainType) {
-      case 'testnet':
-        this.network = 'testnet';
-        if (startBlock) {
-          this.root = startBlock;
-          break;
-        }
-        this.root = config.getTestnetGenesis();
-        break;
-      case 'devnet':
-        this.network = 'devnet';
-        if (startBlock) {
-          this.root = startBlock;
-          break;
-        }
-        this.root = config.getDevnetGenesis();
-        break;
-      case 'local':
-      case 'regtest':
-        this.network = 'regtest';
-        if (startBlock) {
-          this.root = startBlock;
-          break;
-        }
-        this.root = config.getRegtestGenesis();
-        break;
-      case 'livenet':
-        this.network = 'mainnet';
-        if (startBlock) {
-          this.root = startBlock;
-          break;
-        }
-        this.root = config.getLivenetGenesis();
-        break;
-      case 'mainnet':
-        this.network = 'mainnet';
-        if (startBlock) {
-          this.root = startBlock;
-          break;
-        }
-        this.root = config.getLivenetGenesis();
-        break;
-      case 'lowdiff':
-        this.network = 'regtest';
-        if (startBlock) {
-          this.root = startBlock;
-          break;
-        }
-        this.root = config.getLowDiffGenesis();
-        break;
-      default:
-        if (startBlock) {
-          this.root = startBlock;
-          this.network = 'mainnet';
-        } else {
-          throw new SPVError('Unhandled chaintype or startBlock not provided');
-        }
-        break;
+  /**
+   * Initializes chain with a start block and height
+   * - When no arguments provided, chain is initialized from genesis block
+   * - If startBlock is provided, height must be provided as well
+   * @param {BlockHeader} [startBlock]
+   * @param {number} [height]
+   */
+  initialize(startBlock, height) {
+    if (!X11.ready()) {
+      throw new SPVError('X11 wasm not ready, call wasmX11Ready() first');
+    }
+
+    if (this.startBlockHeight !== null) {
+      throw new SPVError('Chain already initialized');
+    }
+
+    if (startBlock && typeof height === 'number') {
+      // eslint-disable-next-line
+      startBlock = utils.normalizeHeader(startBlock);
+    } else if (!startBlock && typeof height !== 'number') {
+      // eslint-disable-next-line
+      startBlock = this.genesis;
+      // eslint-disable-next-line
+      height = 0;
+    } else {
+      throw new SPVError('Initialization error, please provide both startBlock and height');
     }
-    // this.root.children = [];
-    this.setAllBranches();
+
+    this.startBlockHeight = height;
+    this.hashesByHeight = new Map([[height, startBlock.hash]]);
+    this.heightByHash = new Map([[startBlock.hash, height]]);
+    this.setAllBranches(startBlock);
+  }
+
+  initialized() {
+    return this.startBlockHeight !== null || this.pendingStartBlockHeight !== null;
   }
 
   validate() {
@@ -146,30 +151,15 @@ const SpvChain = class {
   }
 
   /** @private */
-  findConnection(newHeader) {
-    const stack = [this.root];
-    while (stack.length > 0) {
-      const node = stack.pop();
-      if (node.hash === utils.getCorrectedHash(newHeader.prevHash)) {
-        return node;
-      }
-      // node.children.forEach((c) => { stack.push(c); });
+  setAllBranches(node, branch = []) {
+    if (!node) {
+      throw new SPVError('Root node for a branch is not defined');
     }
-    return null;
-  }
 
-  /** @private */
-  setAllBranches(node = this.root, branch = []) {
     this.allBranches = [];
     branch.push(node);
 
-    // node.children.forEach((c) => {
-    //   this.setAllBranches(c, Array.from(branch));
-    // });
-
-    // if (node.children.length === 0) {
     this.allBranches.push(branch);
-    // }
   }
 
   /** @private */
@@ -200,17 +190,6 @@ const SpvChain = class {
     return this.heightByHash.has(hash) || this.orphansHashes.has(hash);
   }
 
-  /** @private */
-  // orphanReconnect() {
-  // for (let i = 0; i < this.orphanBlocks.length; i += 1) {
-  // const connectionTip = this.findConnection(this.orphanBlocks[i]);
-  // if (connectionTip) {
-  //   connectionTip.children.push(this.orphanBlocks[i]);
-  //   this.orphanBlocks.splice(i, 1);
-  // }
-  // }
-  // }
-
   /** @private */
   orphanChunksReconnect() {
     // TODO: consider optimizing with map of { [chunkHeadHash]: chunkIndex }
@@ -233,28 +212,11 @@ const SpvChain = class {
     }
   }
 
-  /** @private */
-  // TODO: remove
-  // getOrphans() {
-  //   return this.orphanBlocks;
-  // }
-
   /** @private */
   getOrphanChunks() {
     return this.orphanChunks;
   }
 
-  /** @private */
-  // processValidHeader(header) {
-  //   const connection = this.findConnection(header);
-  //   if (connection) {
-  //     // connection.children.push(header);
-  //     this.orphanReconnect();
-  //   } else {
-  //     this.orphanBlocks.push(header);
-  //   }
-  // }
-
   /** @private
    * validates a dashcore.BlockHeader object
    *
@@ -281,16 +243,9 @@ const SpvChain = class {
     if (utils.getCorrectedHash(header.prevHash) !== previousHeader.hash) {
       return false;
     }
-    // if (!header.children) {
-    //   header.children = [];
-    // }
-    // if (!previousHeader.children) {
-    //   previousHeader.children = [];
-    // }
-    // previousHeader.children.push(header);
+
     return true;
   }
-  /* eslint-enable no-param-reassign */
 
   /**
    * Returns the longest chain of headers
@@ -337,44 +292,6 @@ const SpvChain = class {
     return this.getLongestChain().filter((h) => h.hash === hash)[0];
   }
 
-  /**
-   * Gets specified amount of headers in the confirmed chain
-   * @param n
-   * @return Object[]
-   */
-  getLastHeaders(n) {
-    const longestChain = this.getLongestChain();
-    let headers = longestChain.slice(-n);
-
-    if (headers.length < n) {
-      const remaining = n - headers.length;
-      headers = [...this.prunedHeaders.slice(-remaining), ...headers];
-    }
-
-    return headers;
-  }
-
-  /**
-   * adds a valid header to the tip of the longest spv chain.
-   * If it cannot be connected to the tip it gets temporarily
-   * added to an orphan array for possible later reconnection
-   *
-   * @param {Object[]|string[]|buffer[]} header
-   * @return {boolean}
-   */
-  // addHeader(header) {
-  //   const headerNormalised = utils.normalizeHeader(header);
-  //
-  //   if (this.isValid(headerNormalised, this.getLongestChain())) {
-  //     // headerNormalised.children = [];
-  //     this.processValidHeader(headerNormalised);
-  //     this.setAllBranches();
-  //     this.checkPruneBlocks();
-  //     return true;
-  //   }
-  //   return false;
-  // }
-
   /**
    * adds an array of valid headers to the longest spv chain.
    * If they cannot be connected to last tip they get temporarily
@@ -385,39 +302,45 @@ const SpvChain = class {
    * @return {BlockHeader[]}
    */
   addHeaders(headers, batchHeadHeight = 0) {
-    let headHeight = batchHeadHeight;
-    const normalizedHeaders = headers.map((h) => utils.normalizeHeader(h));
-
-    const tip = this.getTipHeader();
-    // Handle 1 block intersection of batches
-    if (tip && tip.hash === normalizedHeaders[0].hash) {
-      normalizedHeaders.splice(0, 1);
-      // Patch head height value after splice
-      headHeight += 1;
+    if (!X11.ready()) {
+      throw new SPVError('X11 wasm not ready, call wasmX11Ready() first');
     }
 
-    if (normalizedHeaders.length === 0) {
-      // The batch already in the chain, do nothing
-      return [];
+    if (!this.initialized()) {
+      throw new SPVError('Chain not initialized, either call initialize() or set pendingStartBlockHeight');
     }
 
-    const firstHeader = normalizedHeaders[0];
-    const connectsToTip = tip && SpvChain.isParentChild(firstHeader, tip);
+    const normalizedHeaders = headers.map((h) => utils.normalizeHeader(h));
 
-    //
-    // Reorg detection
-    // Get prev header hash
-    const prevHash = utils.getCorrectedHash(firstHeader.prevHash);
-    const prevHeaderHeight = this.heightByHash.get(prevHash);
+    let isOrphan = false;
 
-    // Test on initial wallet load
-    if (prevHeaderHeight && prevHeaderHeight > 0 && prevHeaderHeight !== headHeight - 1) {
-      console.log('SPVCHAIN: Reorg detected.');
-      console.log(`------->: Batch head ${firstHeader.hash} at height ${headHeight} has parent at height ${prevHeaderHeight}`);
-    }
+    // Chain is initialized, root block, and it's height are known
+    if (this.pendingStartBlockHeight === null) {
+      const tip = this.getTipHeader();
+      // Handle 1 block intersection of batches
+      if (tip.hash === normalizedHeaders[0].hash) {
+        normalizedHeaders.splice(0, 1);
+      }
 
-    const isOrphan = tip ? !connectsToTip
-      : headHeight !== this.startBlockHeight;
+      if (normalizedHeaders.length === 0) {
+        // The batch already in the chain, do nothing
+        return [];
+      }
+
+      const firstHeader = normalizedHeaders[0];
+
+      isOrphan = !SpvChain.isParentChild(firstHeader, tip);
+    } else if (batchHeadHeight === this.pendingStartBlockHeight) {
+      // Header at pendingStartBlockHeight is found, initialize chain
+      this.startBlockHeight = this.pendingStartBlockHeight;
+      this.pendingStartBlockHeight = null;
+      isOrphan = false;
+    } else if (batchHeadHeight > this.pendingStartBlockHeight) {
+      // Orphan chunk has arrived
+      isOrphan = true;
+    } else {
+      throw new SPVError(`Batch at invalid height arrived: ${batchHeadHeight}, expected > ${this.pendingStartBlockHeight}`);
+    }
 
     const allValid = normalizedHeaders.reduce(
       (acc, header, index, array) => {

package/lib/test/.eslintrc

@@ -0,0 +1,9 @@
+{
+  "env": {
+    "node": true,
+    "mocha": true
+  },
+  "rules": {
+    "import/no-extraneous-dependencies": "off"
+  }
+}

package/lib/test/bootstrap.js

@@ -0,0 +1,19 @@
+const sinon = require('sinon');
+
+beforeEach(function beforeEach() {
+  if (!this.sinon) {
+    this.sinon = sinon.createSandbox();
+  } else {
+    this.sinon.restore();
+  }
+});
+
+before(function before() {
+  if (!this.sinon) {
+    this.sinon = sinon.createSandbox();
+  }
+});
+
+afterEach(function afterEach() {
+  this.sinon.restore();
+});

package/lib/x11.js

@@ -0,0 +1,27 @@
+const { configure: configureDashcore } = require('@dashevo/dashcore-lib');
+const X11 = require('wasm-x11-hash');
+
+let x11Promise = null;
+let x11Ready = false;
+
+const load = async () => {
+  if (!x11Promise) {
+    x11Promise = X11().then(
+      (x11Hash) => {
+        configureDashcore({
+          x11hash: x11Hash,
+        });
+        x11Ready = true;
+      },
+    );
+  }
+
+  return x11Promise;
+};
+
+const ready = () => x11Ready;
+
+module.exports = {
+  ready,
+  load,
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dashevo/dash-spv",
-  "version": "0.24.11",
+  "version": "0.24.12",
   "description": "Repository containing SPV functions used by @dashevo",
   "main": "index.js",
   "scripts": {
@@ -16,7 +16,8 @@
     "@dashevo/dash-util": "^2.0.3",
     "@dashevo/dashcore-lib": "~0.20.9",
     "levelup": "^4.4.0",
-    "memdown": "^5.1.0"
+    "memdown": "^5.1.0",
+    "wasm-x11-hash": "~0.0.2"
   },
   "devDependencies": {
     "chai": "^4.3.4",
@@ -24,6 +25,7 @@
     "eslint-config-airbnb-base": "^14.2.1",
     "eslint-plugin-import": "^2.24.2",
     "mocha": "^9.1.2",
-    "should": "^13.2.3"
+    "should": "^13.2.3",
+    "sinon": "^11.1.2"
   }
 }

package/test/index.js

@@ -16,8 +16,10 @@ let merkleBlock = null;
 let merkleBlock2 = null;
 
 describe('SPV-DASH (forks & re-orgs) deserialized headers', () => {
-  before(() => {
+  before(async () => {
     chain = new Blockchain('testnet');
+    await Blockchain.wasmX11Ready();
+    chain.initialize();
   });
 
   it('should get 26 testnet headers', () => {
@@ -83,8 +85,9 @@ describe('SPV-DASH (forks & re-orgs) deserialized headers', () => {
 });
 
 describe('SPV-DASH (forks & re-orgs) serialized raw headers for mainnet', () => {
-  before(() => {
-    chain = new Blockchain('mainnet', 10000, utils.normalizeHeader(mainnet[0]));
+  before(async () => {
+    chain = new Blockchain('mainnet', 10000);
+    chain.initialize(utils.normalizeHeader(mainnet[0]), 1);
   });
 
   it('should get 2000 mainnet headers', () => {
@@ -127,8 +130,9 @@ describe('SPV-DASH (forks & re-orgs) serialized raw headers for mainnet', () =>
 });
 
 describe('SPV-DASH (addHeaders) add many headers for testnet', () => {
-  before(() => {
-    chain = new Blockchain('testnet', 10000, utils.normalizeHeader(testnet[0]));
+  before(async () => {
+    chain = new Blockchain('testnet', 10000);
+    chain.initialize(utils.normalizeHeader(testnet[0]), 1);
   });
 
   it('should add the 1st 250 testnet headers', () => {
@@ -146,7 +150,8 @@ describe('SPV-DASH (addHeaders) add many headers for testnet', () => {
   });
 
   it('should add the 1st 250 testnet2 headers', () => {
-    chain = new Blockchain('testnet', 10000, utils.normalizeHeader(testnet2[0]));
+    chain = new Blockchain('testnet', 10000);
+    chain.initialize(utils.normalizeHeader(testnet2[0]), 1);
     chain.addHeaders(testnet2.slice(1, 250));
     chain.getOrphanChunks().length.should.equal(0);
     chain.getAllBranches().length.should.equal(1);
@@ -161,7 +166,8 @@ describe('SPV-DASH (addHeaders) add many headers for testnet', () => {
   });
 
   it('should add the 1st 250 testnet3 headers', () => {
-    chain = new Blockchain('testnet', 10000, utils.normalizeHeader(testnet3[0]));
+    chain = new Blockchain('testnet', 10000);
+    chain.initialize(utils.normalizeHeader(testnet3[0]), 1);
     chain.addHeaders(testnet3.slice(1, 250));
     chain.getOrphanChunks().length.should.equal(0);
     chain.getAllBranches().length.should.equal(1);
@@ -199,7 +205,8 @@ describe('SPV-DASH (addHeaders) add many headers for testnet', () => {
 
 describe('SPV-DASH (addHeaders) add testnet headers out of order', () => {
   before(() => {
-    chain = new Blockchain('testnet', 10000, utils.normalizeHeader(testnet[0]));
+    chain = new Blockchain('testnet', 10000);
+    chain.initialize(utils.normalizeHeader(testnet[0]), 1);
   });
 
   it('should add the 1st 100 testnet headers', () => {
@@ -242,7 +249,8 @@ describe('SPV-DASH (addHeaders) add testnet headers out of order', () => {
 
 describe('SPV-DASH (addHeaders) add many headers for mainnet', () => {
   before(() => {
-    chain = new Blockchain('mainnet', 10000, utils.normalizeHeader(mainnet[0]));
+    chain = new Blockchain('mainnet', 10000);
+    chain.initialize(utils.normalizeHeader(mainnet[0]), 1);
   });
 
   it('should add the 1st 500 mainnet headers', () => {
@@ -290,7 +298,8 @@ describe('SPV-DASH (addHeaders) add many headers for mainnet', () => {
 
 describe('SPV-DASH (addHeaders) add mainnet headers out of order', () => {
   before(() => {
-    chain = new Blockchain('mainnet', 10000, utils.normalizeHeader(mainnet[0]));
+    chain = new Blockchain('mainnet', 10000);
+    chain.initialize(utils.normalizeHeader(mainnet[0]), 1);
   });
 
   it('should add the 1st 100 mainnet headers', () => {
@@ -377,7 +386,8 @@ describe('MerkleProofs', () => {
 
 describe('Transaction validation', () => {
   before(() => {
-    chain = new Blockchain('testnet', 10000, utils.normalizeHeader(testnet[0]));
+    chain = new Blockchain('testnet', 10000);
+    chain.initialize(utils.normalizeHeader(testnet[0]), 1);
     chain.addHeaders(testnet.slice(1, 500));
   });
 

package/test/spvchain.js

@@ -1,19 +1,65 @@
 const { expect } = require('chai');
+const X11 = require('../lib/x11');
 const { SpvChain } = require('../index');
-
 const { testnet } = require('./data/rawHeaders');
 
 describe('SPVChain', () => {
   let spvChain;
 
-  beforeEach(() => {
+  beforeEach(async () => {
     spvChain = new SpvChain('testnet', 100);
+    await SpvChain.wasmX11Ready();
+  });
+
+  describe('#initialize', () => {
+    it('should throw an error if wasmX11 is not initialized', function it() {
+      this.sinon.stub(X11, 'ready').returns(false);
+      expect(() => spvChain.initialize())
+        .to.throw('X11 wasm not ready, call wasmX11Ready() first');
+    });
+
+    it('should throw an error if chain is already initialized', async () => {
+      spvChain.initialize(testnet[0], 10000);
+      expect(() => spvChain.initialize())
+        .to.throw('Chain already initialized');
+    });
+
+    it('should initialize chain with genesis header', async () => {
+      spvChain.initialize();
+      expect(spvChain.startBlockHeight).to.be.equal(0);
+      expect(spvChain.getLongestChain())
+        .to.be.deep.equal([spvChain.genesis]);
+    });
+
+    it('should not allow initializing from arbitrary block without height', () => {
+      expect(() => spvChain.initialize(testnet[0]))
+        .to.throw('Initialization error, please provide both startBlock and height');
+    });
+
+    it('should initialize from arbitrary block', () => {
+      spvChain.initialize(testnet[0], 10000);
+      expect(spvChain.startBlockHeight).to.be.equal(10000);
+      expect(spvChain.getLongestChain()[0].toBuffer().toString('hex'))
+        .to.be.equal(testnet[0]);
+    });
   });
 
   describe('#addHeaders', () => {
-    it('should assemble headers chain if headers arriving out of order', () => {
+    it('should throw an error if wasmX11 is not initialized', function it() {
+      this.sinon.stub(X11, 'ready').returns(false);
+      expect(() => spvChain.addHeaders(testnet.slice(400)))
+        .to.throw('X11 wasm not ready, call wasmX11Ready() first');
+    });
+
+    it('should throw an error if chain is not initialized', async () => {
+      expect(() => spvChain.addHeaders(testnet.slice(400)))
+        .to.throw('Chain not initialized, either call initialize() or set pendingStartBlockHeight');
+    });
+
+    it('should assemble headers chain if headers arriving out of order', async () => {
       expect(true).to.equal(true);
-      spvChain.reset(10000);
+
+      spvChain.initialize(testnet[0], 10000);
 
       spvChain.addHeaders(testnet.slice(400), 10400);
       expect(spvChain.getOrphanChunks()).to.have.length(1);