@semaphore-protocol/utils 4.0.0-beta.1 → 4.0.0-beta.3

package/README.md

@@ -70,10 +70,10 @@ yarn add @semaphore-protocol/utils
 For more information on the functions and modules provided by `@semaphore-protocol/utils`, please refer to the [TypeDoc documentation](https://js.semaphore.pse.dev/modules/_semaphore_protocol_utils).
 
 ```typescript
-// You can import modules from the main bundle.
-import { errors, types } from "@semaphore-protocol/utils"
+// You can import functions/parameters from the main bundle.
+import { supportedNetworks, decodeMessage } from "@semaphore-protocol/utils"
 
 // Or by using conditional exports.
-import { requireNumber } from "@semaphore-protocol/utils/errors"
-import { isNumber } from "@semaphore-protocol/utils/types"
+import supportedNetworks from "@semaphore-protocol/utils/supported-networks"
+import decodeMessage from "@semaphore-protocol/utils/decode-message"
 ```

package/dist/index.cjs

@@ -1,6 +1,6 @@
 /**
  * @module @semaphore-protocol/utils
- * @version 4.0.0-beta.1
+ * @version 4.0.0-beta.3
  * @file A library to provide utility functions to the other Semaphore packages.
  * @copyright Ethereum Foundation 2024
  * @license MIT
@@ -8,252 +8,36 @@
 */
 'use strict';
 
-/**
- * @module Types
- * This module provides utility functions to check data types.
- * It defines a set of supported types and includes functions to check if
- * a value is defined and if it matches a supported type. These functions
- * are useful for type checking and validation in the other libraries,
- * enhancing code robustness and reliability.
- */
-// The list of types supported by this utility functions.
-var supportedTypes = ["number", "string", "function", "array", "uint8array", "object", "bigint"];
-/**
- * It returns true if the value is defined, false otherwise.
- * @param value The value to be checked.
- * @returns True or false.
- */
-function isDefined(value) {
-    return typeof value !== "undefined";
-}
-/**
- * It returns true if the value is a number, false otherwise.
- * @param value The value to be checked.
- * @returns True or false.
- */
-function isNumber(value) {
-    return typeof value === "number";
-}
-/**
- * It returns true if the value is a string, false otherwise.
- * @param value The value to be checked.
- * @returns True or false.
- */
-function isString(value) {
-    return typeof value === "string";
-}
-/**
- * It returns true if the value is a function, false otherwise.
- * @param value The value to be checked.
- * @returns True or false.
- */
-function isFunction(value) {
-    return typeof value === "function";
-}
-/**
- * It returns true if the value is an array, false otherwise.
- * @param value The value to be checked.
- * @returns True or false.
- */
-function isArray(value) {
-    return typeof value === "object" && Array.isArray(value);
-}
-/**
- * It returns true if the value is a uint8array, false otherwise.
- * @param value The value to be checked.
- * @returns True or false.
- */
-function isUint8Array(value) {
-    return value instanceof Uint8Array;
-}
-/**
- * It returns true if the value is an object, false otherwise.
- * @param value The value to be checked.
- * @returns True or false.
- */
-function isObject(value) {
-    return typeof value === "object";
-}
-/**
- * It returns true if the value is a bigint, false otherwise.
- * @param value The value to be checked.
- * @returns True or false.
- */
-function isBigInt(value) {
-    return typeof value === "bigint";
-}
-/**
- * It returns true if the value type is the same as the type passed
- * as the second parameter, false otherwise.
- * @param type The expected type.
- * @returns True or false.
- */
-function isType(value, type) {
-    switch (type) {
-        case "number":
-            return isNumber(value);
-        case "string":
-            return isString(value);
-        case "function":
-            return isFunction(value);
-        case "array":
-            return isArray(value);
-        case "uint8array":
-            return isUint8Array(value);
-        case "object":
-            return isObject(value);
-        case "bigint":
-            return isBigInt(value);
-        default:
-            return false;
-    }
-}
-/**
- * Return true if the type is being supported by this utility
- * functions, false otherwise.
- * @param type The type to be checked.
- * @returns True or false
- */
-function isSupportedType(type) {
-    return supportedTypes.includes(type);
-}
+var abi = require('ethers/abi');
+var utils = require('ethers/utils');
+
+// TODO: Support all tree depths after trusted-setup. MAX_DEPTH would be 32.
+var MIN_DEPTH = 1;
+var MAX_DEPTH = 12;
 
-var types = /*#__PURE__*/Object.freeze({
+var constants = /*#__PURE__*/Object.freeze({
     __proto__: null,
-    isArray: isArray,
-    isBigInt: isBigInt,
-    isDefined: isDefined,
-    isFunction: isFunction,
-    isNumber: isNumber,
-    isObject: isObject,
-    isString: isString,
-    isSupportedType: isSupportedType,
-    isType: isType,
-    isUint8Array: isUint8Array
+    MAX_DEPTH: MAX_DEPTH,
+    MIN_DEPTH: MIN_DEPTH
 });
 
 /**
- * @module Errors
- * This module is designed to provide utility functions for validating
- * function parameters. It includes functions that throw type errors if
- * the parameters do not meet specified criteria, such as being defined,
- * a number, a string, a function, or an array. This module helps ensure
- * that functions receive the correct types of inputs, enhancing code
- * reliability and reducing runtime errors.
- */
-/**
- * It throws a type error if the parameter value has not been defined.
- * @param parameterValue The parameter value.
- * @param parameterName The parameter name.
- */
-function requireDefined(parameterValue, parameterName) {
-    if (!isDefined(parameterValue)) {
-        throw new TypeError("Parameter '".concat(parameterName, "' is not defined"));
-    }
-}
-/**
- * It throws a type error if the parameter value is not a number.
- * @param parameterValue The parameter value.
- * @param parameterName The parameter name.
- */
-function requireNumber(parameterValue, parameterName) {
-    if (!isNumber(parameterValue)) {
-        throw new TypeError("Parameter '".concat(parameterName, "' is not a number"));
-    }
-}
-/**
- * It throws a type error if the parameter value is not a string.
- * @param parameterValue The parameter value.
- * @param parameterName The parameter name.
- */
-function requireString(parameterValue, parameterName) {
-    if (!isString(parameterValue)) {
-        throw new TypeError("Parameter '".concat(parameterName, "' is not a string"));
-    }
-}
-/**
- * It throws a type error if the parameter value is not a function.
- * @param parameterValue The parameter value.
- * @param parameterName The parameter name.
- */
-function requireFunction(parameterValue, parameterName) {
-    if (!isFunction(parameterValue)) {
-        throw new TypeError("Parameter '".concat(parameterName, "' is not a function"));
-    }
-}
-/**
- * It throws a type error if the parameter value is not an array.
- * @param parameterValue The parameter value.
- * @param parameterName The parameter name.
- */
-function requireArray(parameterValue, parameterName) {
-    if (!isArray(parameterValue)) {
-        throw new TypeError("Parameter '".concat(parameterName, "' is not an array"));
-    }
-}
-/**
- * It throws a type error if the parameter value is not a uint8array.
- * @param parameterValue The parameter value.
- * @param parameterName The parameter name.
+ * Typically used for decoding on-chain Semaphore messages.
+ * When Semaphore messages are text they are converted to bigints before
+ * the proof is generated (and eventually sent on-chain).
+ * This function help devs converting bigint messages to text again.
+ * If the original message was not text the output of this
+ * function won't probably be human-readable text.
+ * @param message The Semaphore message as a bigint.
+ * @returns The Semaphore message as a text.
  */
-function requireUint8Array(parameterValue, parameterName) {
-    if (!isUint8Array(parameterValue)) {
-        throw new TypeError("Parameter '".concat(parameterName, "' is not a Uint8Array"));
-    }
-}
-/**
- * It throws a type error if the parameter value is not an object.
- * @param parameterValue The parameter value.
- * @param parameterName The parameter name.
- */
-function requireObject(parameterValue, parameterName) {
-    if (!isObject(parameterValue)) {
-        throw new TypeError("Parameter '".concat(parameterName, "' is not an object"));
-    }
-}
-/**
- * It throws a type error if the parameter value is not a bigint.
- * @param parameterValue The parameter value.
- * @param parameterName The parameter name.
- */
-function requireBigInt(parameterValue, parameterName) {
-    if (!isBigInt(parameterValue)) {
-        throw new TypeError("Parameter '".concat(parameterName, "' is not a bigint"));
-    }
-}
-/**
- * It throws a type error if the parameter value type is not part of the list of types.
- * @param parameterValue The parameter value.
- * @param parameterName The parameter name.
- */
-function requireTypes(parameterValue, parameterName, types) {
-    for (var _i = 0, types_1 = types; _i < types_1.length; _i++) {
-        var type = types_1[_i];
-        if (!isSupportedType(type)) {
-            throw new Error("Type '".concat(type, "' is not supported"));
-        }
-    }
-    for (var _a = 0, types_2 = types; _a < types_2.length; _a++) {
-        var type = types_2[_a];
-        if (isType(parameterValue, type)) {
-            return;
-        }
-    }
-    throw new TypeError("Parameter '".concat(parameterName, "' is none of the following types: ").concat(types.join(", ")));
+function decodeMessage(message) {
+    return abi.decodeBytes32String(utils.toBeHex(message, 32));
 }
 
-var errors = /*#__PURE__*/Object.freeze({
-    __proto__: null,
-    requireArray: requireArray,
-    requireBigInt: requireBigInt,
-    requireDefined: requireDefined,
-    requireFunction: requireFunction,
-    requireNumber: requireNumber,
-    requireObject: requireObject,
-    requireString: requireString,
-    requireTypes: requireTypes,
-    requireUint8Array: requireUint8Array
-});
+// List of Semaphore supported networks.
+var supportedNetwork = ["sepolia", "mumbai", "optimism-sepolia", "arbitrum-sepolia", "arbitrum"];
 
-exports.errors = errors;
-exports.types = types;
+exports.constants = constants;
+exports.decodeMessage = decodeMessage;
+exports.supportedNetworks = supportedNetwork;

package/dist/index.js

@@ -1,256 +1,39 @@
 /**
  * @module @semaphore-protocol/utils
- * @version 4.0.0-beta.1
+ * @version 4.0.0-beta.3
  * @file A library to provide utility functions to the other Semaphore packages.
  * @copyright Ethereum Foundation 2024
  * @license MIT
  * @see [Github]{@link https://github.com/semaphore-protocol/semaphore/tree/main/packages/utils}
 */
-/**
- * @module Types
- * This module provides utility functions to check data types.
- * It defines a set of supported types and includes functions to check if
- * a value is defined and if it matches a supported type. These functions
- * are useful for type checking and validation in the other libraries,
- * enhancing code robustness and reliability.
- */
-// The list of types supported by this utility functions.
-var supportedTypes = ["number", "string", "function", "array", "uint8array", "object", "bigint"];
-/**
- * It returns true if the value is defined, false otherwise.
- * @param value The value to be checked.
- * @returns True or false.
- */
-function isDefined(value) {
-    return typeof value !== "undefined";
-}
-/**
- * It returns true if the value is a number, false otherwise.
- * @param value The value to be checked.
- * @returns True or false.
- */
-function isNumber(value) {
-    return typeof value === "number";
-}
-/**
- * It returns true if the value is a string, false otherwise.
- * @param value The value to be checked.
- * @returns True or false.
- */
-function isString(value) {
-    return typeof value === "string";
-}
-/**
- * It returns true if the value is a function, false otherwise.
- * @param value The value to be checked.
- * @returns True or false.
- */
-function isFunction(value) {
-    return typeof value === "function";
-}
-/**
- * It returns true if the value is an array, false otherwise.
- * @param value The value to be checked.
- * @returns True or false.
- */
-function isArray(value) {
-    return typeof value === "object" && Array.isArray(value);
-}
-/**
- * It returns true if the value is a uint8array, false otherwise.
- * @param value The value to be checked.
- * @returns True or false.
- */
-function isUint8Array(value) {
-    return value instanceof Uint8Array;
-}
-/**
- * It returns true if the value is an object, false otherwise.
- * @param value The value to be checked.
- * @returns True or false.
- */
-function isObject(value) {
-    return typeof value === "object";
-}
-/**
- * It returns true if the value is a bigint, false otherwise.
- * @param value The value to be checked.
- * @returns True or false.
- */
-function isBigInt(value) {
-    return typeof value === "bigint";
-}
-/**
- * It returns true if the value type is the same as the type passed
- * as the second parameter, false otherwise.
- * @param type The expected type.
- * @returns True or false.
- */
-function isType(value, type) {
-    switch (type) {
-        case "number":
-            return isNumber(value);
-        case "string":
-            return isString(value);
-        case "function":
-            return isFunction(value);
-        case "array":
-            return isArray(value);
-        case "uint8array":
-            return isUint8Array(value);
-        case "object":
-            return isObject(value);
-        case "bigint":
-            return isBigInt(value);
-        default:
-            return false;
-    }
-}
-/**
- * Return true if the type is being supported by this utility
- * functions, false otherwise.
- * @param type The type to be checked.
- * @returns True or false
- */
-function isSupportedType(type) {
-    return supportedTypes.includes(type);
-}
+import { decodeBytes32String } from 'ethers/abi';
+import { toBeHex } from 'ethers/utils';
+
+// TODO: Support all tree depths after trusted-setup. MAX_DEPTH would be 32.
+var MIN_DEPTH = 1;
+var MAX_DEPTH = 12;
 
-var types = /*#__PURE__*/Object.freeze({
+var constants = /*#__PURE__*/Object.freeze({
     __proto__: null,
-    isArray: isArray,
-    isBigInt: isBigInt,
-    isDefined: isDefined,
-    isFunction: isFunction,
-    isNumber: isNumber,
-    isObject: isObject,
-    isString: isString,
-    isSupportedType: isSupportedType,
-    isType: isType,
-    isUint8Array: isUint8Array
+    MAX_DEPTH: MAX_DEPTH,
+    MIN_DEPTH: MIN_DEPTH
 });
 
 /**
- * @module Errors
- * This module is designed to provide utility functions for validating
- * function parameters. It includes functions that throw type errors if
- * the parameters do not meet specified criteria, such as being defined,
- * a number, a string, a function, or an array. This module helps ensure
- * that functions receive the correct types of inputs, enhancing code
- * reliability and reducing runtime errors.
- */
-/**
- * It throws a type error if the parameter value has not been defined.
- * @param parameterValue The parameter value.
- * @param parameterName The parameter name.
- */
-function requireDefined(parameterValue, parameterName) {
-    if (!isDefined(parameterValue)) {
-        throw new TypeError("Parameter '".concat(parameterName, "' is not defined"));
-    }
-}
-/**
- * It throws a type error if the parameter value is not a number.
- * @param parameterValue The parameter value.
- * @param parameterName The parameter name.
- */
-function requireNumber(parameterValue, parameterName) {
-    if (!isNumber(parameterValue)) {
-        throw new TypeError("Parameter '".concat(parameterName, "' is not a number"));
-    }
-}
-/**
- * It throws a type error if the parameter value is not a string.
- * @param parameterValue The parameter value.
- * @param parameterName The parameter name.
- */
-function requireString(parameterValue, parameterName) {
-    if (!isString(parameterValue)) {
-        throw new TypeError("Parameter '".concat(parameterName, "' is not a string"));
-    }
-}
-/**
- * It throws a type error if the parameter value is not a function.
- * @param parameterValue The parameter value.
- * @param parameterName The parameter name.
- */
-function requireFunction(parameterValue, parameterName) {
-    if (!isFunction(parameterValue)) {
-        throw new TypeError("Parameter '".concat(parameterName, "' is not a function"));
-    }
-}
-/**
- * It throws a type error if the parameter value is not an array.
- * @param parameterValue The parameter value.
- * @param parameterName The parameter name.
- */
-function requireArray(parameterValue, parameterName) {
-    if (!isArray(parameterValue)) {
-        throw new TypeError("Parameter '".concat(parameterName, "' is not an array"));
-    }
-}
-/**
- * It throws a type error if the parameter value is not a uint8array.
- * @param parameterValue The parameter value.
- * @param parameterName The parameter name.
+ * Typically used for decoding on-chain Semaphore messages.
+ * When Semaphore messages are text they are converted to bigints before
+ * the proof is generated (and eventually sent on-chain).
+ * This function help devs converting bigint messages to text again.
+ * If the original message was not text the output of this
+ * function won't probably be human-readable text.
+ * @param message The Semaphore message as a bigint.
+ * @returns The Semaphore message as a text.
  */
-function requireUint8Array(parameterValue, parameterName) {
-    if (!isUint8Array(parameterValue)) {
-        throw new TypeError("Parameter '".concat(parameterName, "' is not a Uint8Array"));
-    }
-}
-/**
- * It throws a type error if the parameter value is not an object.
- * @param parameterValue The parameter value.
- * @param parameterName The parameter name.
- */
-function requireObject(parameterValue, parameterName) {
-    if (!isObject(parameterValue)) {
-        throw new TypeError("Parameter '".concat(parameterName, "' is not an object"));
-    }
-}
-/**
- * It throws a type error if the parameter value is not a bigint.
- * @param parameterValue The parameter value.
- * @param parameterName The parameter name.
- */
-function requireBigInt(parameterValue, parameterName) {
-    if (!isBigInt(parameterValue)) {
-        throw new TypeError("Parameter '".concat(parameterName, "' is not a bigint"));
-    }
-}
-/**
- * It throws a type error if the parameter value type is not part of the list of types.
- * @param parameterValue The parameter value.
- * @param parameterName The parameter name.
- */
-function requireTypes(parameterValue, parameterName, types) {
-    for (var _i = 0, types_1 = types; _i < types_1.length; _i++) {
-        var type = types_1[_i];
-        if (!isSupportedType(type)) {
-            throw new Error("Type '".concat(type, "' is not supported"));
-        }
-    }
-    for (var _a = 0, types_2 = types; _a < types_2.length; _a++) {
-        var type = types_2[_a];
-        if (isType(parameterValue, type)) {
-            return;
-        }
-    }
-    throw new TypeError("Parameter '".concat(parameterName, "' is none of the following types: ").concat(types.join(", ")));
+function decodeMessage(message) {
+    return decodeBytes32String(toBeHex(message, 32));
 }
 
-var errors = /*#__PURE__*/Object.freeze({
-    __proto__: null,
-    requireArray: requireArray,
-    requireBigInt: requireBigInt,
-    requireDefined: requireDefined,
-    requireFunction: requireFunction,
-    requireNumber: requireNumber,
-    requireObject: requireObject,
-    requireString: requireString,
-    requireTypes: requireTypes,
-    requireUint8Array: requireUint8Array
-});
+// List of Semaphore supported networks.
+var supportedNetwork = ["sepolia", "mumbai", "optimism-sepolia", "arbitrum-sepolia", "arbitrum"];
 
-export { errors, types };
+export { constants, decodeMessage, supportedNetwork as supportedNetworks };

package/dist/lib.commonjs/constants.cjs

@@ -0,0 +1,16 @@
+/**
+ * @module @semaphore-protocol/utils
+ * @version 4.0.0-beta.3
+ * @file A library to provide utility functions to the other Semaphore packages.
+ * @copyright Ethereum Foundation 2024
+ * @license MIT
+ * @see [Github]{@link https://github.com/semaphore-protocol/semaphore/tree/main/packages/utils}
+*/
+'use strict';
+
+// TODO: Support all tree depths after trusted-setup. MAX_DEPTH would be 32.
+var MIN_DEPTH = 1;
+var MAX_DEPTH = 12;
+
+exports.MAX_DEPTH = MAX_DEPTH;
+exports.MIN_DEPTH = MIN_DEPTH;

package/dist/lib.commonjs/decode-message.cjs

@@ -0,0 +1,28 @@
+/**
+ * @module @semaphore-protocol/utils
+ * @version 4.0.0-beta.3
+ * @file A library to provide utility functions to the other Semaphore packages.
+ * @copyright Ethereum Foundation 2024
+ * @license MIT
+ * @see [Github]{@link https://github.com/semaphore-protocol/semaphore/tree/main/packages/utils}
+*/
+'use strict';
+
+var abi = require('ethers/abi');
+var utils = require('ethers/utils');
+
+/**
+ * Typically used for decoding on-chain Semaphore messages.
+ * When Semaphore messages are text they are converted to bigints before
+ * the proof is generated (and eventually sent on-chain).
+ * This function help devs converting bigint messages to text again.
+ * If the original message was not text the output of this
+ * function won't probably be human-readable text.
+ * @param message The Semaphore message as a bigint.
+ * @returns The Semaphore message as a text.
+ */
+function decodeMessage(message) {
+    return abi.decodeBytes32String(utils.toBeHex(message, 32));
+}
+
+module.exports = decodeMessage;

package/dist/lib.commonjs/index.cjs

@@ -1,6 +1,6 @@
 /**
  * @module @semaphore-protocol/utils
- * @version 4.0.0-beta.1
+ * @version 4.0.0-beta.3
  * @file A library to provide utility functions to the other Semaphore packages.
  * @copyright Ethereum Foundation 2024
  * @license MIT
@@ -8,10 +8,12 @@
 */
 'use strict';
 
-var errors = require('./errors.cjs');
-var types = require('./types.cjs');
+var constants = require('./constants.cjs');
+var decodeMessage = require('./decode-message.cjs');
+var supportedNetworks = require('./supported-networks.cjs');
 
 
 
-exports.errors = errors;
-exports.types = types;
+exports.constants = constants;
+exports.decodeMessage = decodeMessage;
+exports.supportedNetworks = supportedNetworks;

package/dist/lib.commonjs/supported-networks.cjs

@@ -0,0 +1,14 @@
+/**
+ * @module @semaphore-protocol/utils
+ * @version 4.0.0-beta.3
+ * @file A library to provide utility functions to the other Semaphore packages.
+ * @copyright Ethereum Foundation 2024
+ * @license MIT
+ * @see [Github]{@link https://github.com/semaphore-protocol/semaphore/tree/main/packages/utils}
+*/
+'use strict';
+
+// List of Semaphore supported networks.
+var supportedNetwork = ["sepolia", "mumbai", "optimism-sepolia", "arbitrum-sepolia", "arbitrum"];
+
+module.exports = supportedNetwork;

package/dist/lib.esm/constants.js

@@ -0,0 +1,13 @@
+/**
+ * @module @semaphore-protocol/utils
+ * @version 4.0.0-beta.3
+ * @file A library to provide utility functions to the other Semaphore packages.
+ * @copyright Ethereum Foundation 2024
+ * @license MIT
+ * @see [Github]{@link https://github.com/semaphore-protocol/semaphore/tree/main/packages/utils}
+*/
+// TODO: Support all tree depths after trusted-setup. MAX_DEPTH would be 32.
+var MIN_DEPTH = 1;
+var MAX_DEPTH = 12;
+
+export { MAX_DEPTH, MIN_DEPTH };