sawtooth-sdk/processor/exceptions.js

An SDK for interacting with the Hyperledger Sawtooth distributed ledger.

/**
 * Copyright 2016 Intel Corporation
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 * ------------------------------------------------------------------------------
 */

'use strict'

class _TransactionProcessorError extends Error {
  constructor (message = '', extendedData = null) {
    super(message)
    this.name = this.constructor.name

    if (extendedData) {
      if (Buffer.isBuffer(extendedData) || extendedData instanceof Uint8Array) {
        this.extendedData = extendedData
      } else {
        throw new TypeError('extendedData must be a Buffer or a Uint8Array')
      }
    }
  }
}

/**
 * Thrown for an Invalid Transaction.
 */
class InvalidTransaction extends _TransactionProcessorError {
  /**
   * Constructs a new InvalidTransaction.
   *
   * @param {string} [message] - an optional message, defaults to the empty
   * string
   * @param {Buffer|Uint8Array} [extendedData] - optional, application-specific
   * serialized data to returned to the transaction submitter.
   */
  constructor (message, extendedData) {
    super(message, extendedData)
    this.name = this.constructor.name
  }
}

/**
 * Thrown when an internal error occurs during transaction processing.
 */
class InternalError extends _TransactionProcessorError {
  /**
   * Constructs a new InternalError
   * @param {string} [message] - an optional message, defaults to the empty
   * string
   * @param {Buffer|Uint8Array} [extendedData] - optional, application-specific
   * serialized data to returned to the transaction submitter.
   */
  constructor (message, extendedData) {
    super(message, extendedData)
    this.name = this.constructor.name
  }
}

/**
 * Thrown when a connection error occurs between the validator and the
 * transaction processor.
 */
class ValidatorConnectionError extends Error {
  /**
   * Construcs a new ValidatorConnectionError
   *
   * @param {string} [message] - an optional message, defaults to the empty
   * string
   */
  constructor (message = '') {
    super(message)
    this.name = this.constructor.name
  }
}

/**
 * Thrown when a authorization error occurs.
 */
class AuthorizationException extends Error {
  /**
   * Construcs a new AuthorizationException
   *
   * @param {string} [message] - an optional message, defaults to the empty
   * string
   */
  constructor (message = '') {
    super(message)
    this.name = this.constructor.name
  }
}

module.exports = {
  InvalidTransaction,
  InternalError,
  ValidatorConnectionError,
  AuthorizationException
}