feat: refactor validate

BREAKING CHANGE: validate no longer returns a boolean, but throws an
error on invalid input.

package.json

@@ -45,6 +45,7 @@
     "aegir": "^22.0.0",
     "benchmark": "^2.1.4",
     "chai": "^4.2.0",
+    "chai-as-promised": "^7.1.1",
     "chai-spies": "^1.0.0",
     "dirty-chai": "^2.0.1",
     "it-pair": "^1.0.0",

src/index.js

@@ -267,21 +267,19 @@ class PubsubBaseProtocol extends EventEmitter {
 
   /**
    * Validates the given message. The signature will be checked for authenticity.
+   * Throws an error on invalid messages
    * @param {InMessage} message
-   * @returns {Promise<Boolean>}
+   * @returns {Promise<void>}
    */
   async validate (message) { // eslint-disable-line require-await
     // If strict signing is on and we have no signature, abort
     if (this.strictSigning && !message.signature) {
-      this.log('Signing required and no signature was present, dropping message:', message)
-      return false
+      throw errcode(new Error('Signing required and no signature was present'), 'ERR_MISSING_SIGNATURE')
     }
 
     // Check the message signature if present
-    if (message.signature) {
-      return verifySignature(message)
-    } else {
-      return true
+    if (message.signature && !verifySignature(message)) {
+      throw errcode(new Error('Invalid message signature'), 'ERR_INVALID_SIGNATURE')
     }
   }
 

test/pubsub.spec.js

@@ -4,6 +4,7 @@
 const chai = require('chai')
 chai.use(require('dirty-chai'))
 chai.use(require('chai-spies'))
+chai.use(require('chai-as-promised'))
 const expect = chai.expect
 const sinon = require('sinon')
 
@@ -91,20 +92,20 @@ describe('pubsub base protocol', () => {
 
     it('_buildMessage normalizes and signs messages', async () => {
       const message = {
+        receivedFrom: peerId.id,
         from: peerId.id,
         data: 'hello',
         seqno: randomSeqno(),
         topicIDs: ['test-topic']
       }
 
       const signedMessage = await pubsub._buildMessage(message)
-      const verified = await pubsub.validate(signedMessage)
-
-      expect(verified).to.eql(true)
+      expect(pubsub.validate(signedMessage)).to.not.be.rejected()
     })
 
     it('validate with strict signing off will validate a present signature', async () => {
       const message = {
+        receivedFrom: peerId.id,
         from: peerId.id,
         data: 'hello',
         seqno: randomSeqno(),
@@ -114,22 +115,19 @@ describe('pubsub base protocol', () => {
       sinon.stub(pubsub, 'strictSigning').value(false)
 
       const signedMessage = await pubsub._buildMessage(message)
-      const verified = await pubsub.validate(signedMessage)
-
-      expect(verified).to.eql(true)
+      expect(pubsub.validate(signedMessage)).to.not.be.rejected()
     })
 
     it('validate with strict signing requires a signature', async () => {
       const message = {
+        receivedFrom: peerId.id,
         from: peerId.id,
         data: 'hello',
         seqno: randomSeqno(),
         topicIDs: ['test-topic']
       }
 
-      const verified = await pubsub.validate(message)
-
-      expect(verified).to.eql(false)
+      await expect(pubsub.validate(message)).to.be.rejectedWith(Error, 'Signing required and no signature was present')
     })
   })