@semaphore-protocol/identity 4.0.0-beta.9 → 4.0.0

package/README.md

@@ -84,6 +84,28 @@ const { privateKey, publicKey, commitment } = new Identity()
 const identity = new Identity("your-private-key")
 ```
 
+\# **identity.export**(): _string_
+
+```typescript
+import { Identity } from "@semaphore-protocol/identity"
+
+const identity = new Identity()
+
+const privateKey = identity.export()
+```
+
+\# **identity.import**(privateKey: _string_): _Identity_
+
+```typescript
+import { Identity } from "@semaphore-protocol/identity"
+
+const identity = new Identity()
+
+const privateKey = identity.export()
+
+const identity2 = Identity.import(privateKey)
+```
+
 \# **identity.signMessage**(message: _BigNumberish_): _Signature\<string>_
 
 ```typescript

package/dist/index.cjs

@@ -1,6 +1,6 @@
 /**
  * @module @semaphore-protocol/identity
- * @version 4.0.0-beta.9
+ * @version 4.0.0
  * @file A library to create Semaphore identities.
  * @copyright Ethereum Foundation 2024
  * @license MIT
@@ -1709,15 +1709,13 @@ ieee754.write = function (buffer, value, offset, isLE, mLen, nBytes) {
 	  if (value > max || value < min) {
 	    const n = typeof min === 'bigint' ? 'n' : '';
 	    let range;
-	    if (byteLength > 3) {
+	    {
 	      if (min === 0 || min === BigInt(0)) {
 	        range = `>= 0${n} and < 2${n} ** ${(byteLength + 1) * 8}${n}`;
 	      } else {
 	        range = `>= -(2${n} ** ${(byteLength + 1) * 8 - 1}${n}) and < 2 ** ` +
 	                `${(byteLength + 1) * 8 - 1}${n}`;
 	      }
-	    } else {
-	      range = `>= ${min}${n} and <= ${max}${n}`;
 	    }
 	    throw new errors.ERR_OUT_OF_RANGE('value', range, value)
 	  }
@@ -1731,13 +1729,13 @@ ieee754.write = function (buffer, value, offset, isLE, mLen, nBytes) {
 	function boundsError (value, length, type) {
 	  if (Math.floor(value) !== value) {
 	    validateNumber(value, type);
-	    throw new errors.ERR_OUT_OF_RANGE(type || 'offset', 'an integer', value)
+	    throw new errors.ERR_OUT_OF_RANGE('offset', 'an integer', value)
 	  }
 	  if (length < 0) {
 	    throw new errors.ERR_BUFFER_OUT_OF_BOUNDS()
 	  }
-	  throw new errors.ERR_OUT_OF_RANGE(type || 'offset',
-	                                    `>= ${type ? 1 : 0} and <= ${length}`,
+	  throw new errors.ERR_OUT_OF_RANGE('offset',
+	                                    `>= ${0} and <= ${length}`,
 	                                    value)
 	}
 	const INVALID_BASE64_RE = /[^+/0-9A-Za-z-_]/g;
@@ -1871,7 +1869,7 @@ getDefaultExportFromCjs(buffer);
 
 /**
  * @module @zk-kit/utils
- * @version 0.8.1
+ * @version 1.2.0
  * @file Essential zero-knowledge utility library for JavaScript developers.
  * @copyright Ethereum Foundation 2024
  * @license MIT
@@ -1885,6 +1883,7 @@ getDefaultExportFromCjs(buffer);
  * are useful for type checking and validation in the other libraries,
  * enhancing code robustness and reliability.
  */
+/** @internal */
 const supportedTypes = [
     "number",
     "string",
@@ -1968,7 +1967,7 @@ function isStringifiedBigInt(value) {
         BigInt(value);
         return true;
     }
-    catch (_a) {
+    catch {
         return false;
     }
 }
@@ -2017,6 +2016,7 @@ function isBigNumberish(value) {
 /**
  * Returns true if the value type is the same as the type passed
  * as the second parameter, false otherwise.
+ * @param value
  * @param type The expected type.
  */
 function isType(value, type) {
@@ -2060,7 +2060,7 @@ function isSupportedType(type) {
 
 /**
  * @module @zk-kit/utils
- * @version 0.8.1
+ * @version 1.2.0
  * @file Essential zero-knowledge utility library for JavaScript developers.
  * @copyright Ethereum Foundation 2024
  * @license MIT
@@ -2076,20 +2076,6 @@ function requireString(parameterValue, parameterName) {
         throw new TypeError(`Parameter '${parameterName}' is not a string, received type: ${typeof parameterValue}`);
     }
 }
-/**
- * @throws Throws a type error if the parameter value is not a hexadecimal string.
- * If 'prefix' is 'true', the string must start with '0x' or '0X' followed by one or more
- * hexadecimal digits (0-9, a-f, A-F), otherwise no prefix is expected. 'prefix' is optional and
- * if its value it is not explicitly defined it will be set to 'true' by default.
- * @param parameterValue The parameter value.
- * @param parameterName The parameter name.
- * @param prefix A boolean to include or not a '0x' or '0X' prefix.
- */
-function requireHexadecimal(parameterValue, parameterName, prefix = true) {
-    if (!isHexadecimal(parameterValue, prefix)) {
-        throw new TypeError(`Parameter '${parameterName}' is not a hexadecimal string`);
-    }
-}
 /**
  * @throws Throws a type error if the parameter value type is not part of the list of types.
  * @param parameterValue The parameter value.
@@ -2111,34 +2097,40 @@ function requireTypes(parameterValue, parameterName, types) {
 
 /**
  * @module @zk-kit/utils
- * @version 0.8.1
+ * @version 1.2.0
  * @file Essential zero-knowledge utility library for JavaScript developers.
  * @copyright Ethereum Foundation 2024
  * @license MIT
  * @see [Github]{@link https://github.com/privacy-scaling-explorations/zk-kit/tree/main/packages/utils}
 */
 /**
- * Converts an hexadecimal string to a buffer. The hexadecimal string
- * should not start with '0x' or '0X'. It keeps the bytes in the same order.
- * @param value The hexadecimal string to convert.
- * @returns The buffer representation of the hexadecimal string.
+ * Converts bytes to a base64 string. It accepts 'Buffer' or 'Uint8Array'.
+ * @param value The bytes to convert.
+ * @returns The converted base64 string.
  */
-function hexadecimalToBuffer(value) {
-    requireHexadecimal(value, "value", false);
-    if (value.length % 2 !== 0) {
-        value = `0${value}`;
-    }
-    return buffer.Buffer.from(value, "hex");
+function bufferToBase64(value) {
+    requireTypes(value, "value", ["Buffer", "Uint8Array"]);
+    return buffer.Buffer.from(value).toString("base64");
 }
 /**
- * Converts a buffer to a hexadecimal string. It accepts 'Buffer' or 'Uint8Array'.
- * The hexadecimal string will not start with '0x' or '0X'. It keeps the bytes in the same order.
- * @param value The buffer to convert.
- * @returns The converted hexadecimal string.
+ * Converts a base64 string to bytes (i.e. a buffer). This function does not check
+ * if the input value is a valid base64 string. If there are unsupported characters
+ * they will be ignored.
+ * @param value The base64 string to convert.
+ * @returns The converted buffer.
  */
-function bufferToHexadecimal(value) {
-    requireTypes(value, "value", ["Buffer", "Uint8Array"]);
-    return buffer.Buffer.from(value).toString("hex");
+function base64ToBuffer(value) {
+    requireString(value, "value");
+    return buffer.Buffer.from(value, "base64");
+}
+/**
+ * Converts text (utf8) to a base64 string.
+ * @param value The text to convert.
+ * @returns The converted base64 string.
+ */
+function textToBase64(value) {
+    requireString(value, "value");
+    return buffer.Buffer.from(value, "utf8").toString("base64");
 }
 
 var poseidon2$1 = {};
@@ -2245,14 +2237,12 @@ function poseidon2(inputs) {
  * and {@link https://www.poseidon-hash.info | Poseidon} for signatures.
  * In addition, the commitment, i.e. the hash of the public key, is used to represent
  * Semaphore identities in groups, adding an additional layer of privacy and security.
- * The private key of the identity is stored as a hexadecimal string or text.
- * The other attributes are stored as stringified bigint.
+ * The private key of the identity can be exported as a base64 string.
  */
 class Identity {
     /**
-     * Initializes the class attributes based on a given private key, which must be a hexadecimal string or a text.
-     * Hexadecimal strings must not start with '0x' or '0X'.
-     * If the private key is not passed as a parameter, a random hexadecimal key will be generated.
+     * Initializes the class attributes based on a given private key, which must be text or a buffer.
+     * If the private key is not passed as a parameter, a random private key will be generated.
      * The EdDSAPoseidon class is used to generate the secret scalar and the public key.
      * Additionally, the constructor computes a commitment of the public key using a hash function (Poseidon).
      *
@@ -2266,28 +2256,15 @@ class Identity {
      * @param privateKey The private key used to derive the public key (hexadecimal or string).
      */
     constructor(privateKey) {
-        let eddsa;
-        if (privateKey) {
-            requireString(privateKey, "privateKey");
-            this._privateKey = privateKey;
-            if (isHexadecimal(privateKey, false)) {
-                eddsa = new eddsaPoseidon.EdDSAPoseidon(hexadecimalToBuffer(privateKey));
-            }
-            else {
-                eddsa = new eddsaPoseidon.EdDSAPoseidon(privateKey);
-            }
-        }
-        else {
-            eddsa = new eddsaPoseidon.EdDSAPoseidon();
-            this._privateKey = bufferToHexadecimal(eddsa.privateKey);
-        }
+        const eddsa = new eddsaPoseidon.EdDSAPoseidon(privateKey);
+        this._privateKey = eddsa.privateKey;
         this._secretScalar = eddsa.secretScalar;
         this._publicKey = eddsa.publicKey;
         this._commitment = poseidon2_2(this._publicKey);
     }
     /**
      * Returns the private key.
-     * @returns The private key as a string (hexadecimal or text).
+     * @returns The private key as a buffer or text.
      */
     get privateKey() {
         return this._privateKey;
@@ -2313,6 +2290,25 @@ class Identity {
     get commitment() {
         return this._commitment;
     }
+    /**
+     * Returns the private key encoded as a base64 string.
+     * @returns The private key as a base64 string.
+     */
+    export() {
+        if (isString(this._privateKey)) {
+            return textToBase64(this._privateKey);
+        }
+        return bufferToBase64(this.privateKey);
+    }
+    /**
+     * Returns a Semaphore identity based on a private key encoded as a base64 string.
+     * The private key will be converted to a buffer, regardless of its original type.
+     * @param privateKey The private key as a base64 string.
+     * @returns The Semaphore identity.
+     */
+    static import(privateKey) {
+        return new Identity(base64ToBuffer(privateKey));
+    }
     /**
      * Generates a signature for a given message using the private key.
      * This method demonstrates how to sign a message and could be used
@@ -2326,10 +2322,7 @@ class Identity {
      * @returns A {@link https://zkkit.pse.dev/types/_zk_kit_eddsa_poseidon.Signature.html | Signature} object containing the signature components.
      */
     signMessage(message) {
-        const privateKey = isHexadecimal(this.privateKey, false)
-            ? hexadecimalToBuffer(this.privateKey)
-            : this.privateKey;
-        return eddsaPoseidon.signMessage(privateKey, message);
+        return eddsaPoseidon.signMessage(this.privateKey, message);
     }
     /**
      * Verifies a signature against a given message and public key.

package/dist/index.js

@@ -1,6 +1,6 @@
 /**
  * @module @semaphore-protocol/identity
- * @version 4.0.0-beta.9
+ * @version 4.0.0
  * @file A library to create Semaphore identities.
  * @copyright Ethereum Foundation 2024
  * @license MIT
@@ -1707,15 +1707,13 @@ ieee754.write = function (buffer, value, offset, isLE, mLen, nBytes) {
 	  if (value > max || value < min) {
 	    const n = typeof min === 'bigint' ? 'n' : '';
 	    let range;
-	    if (byteLength > 3) {
+	    {
 	      if (min === 0 || min === BigInt(0)) {
 	        range = `>= 0${n} and < 2${n} ** ${(byteLength + 1) * 8}${n}`;
 	      } else {
 	        range = `>= -(2${n} ** ${(byteLength + 1) * 8 - 1}${n}) and < 2 ** ` +
 	                `${(byteLength + 1) * 8 - 1}${n}`;
 	      }
-	    } else {
-	      range = `>= ${min}${n} and <= ${max}${n}`;
 	    }
 	    throw new errors.ERR_OUT_OF_RANGE('value', range, value)
 	  }
@@ -1729,13 +1727,13 @@ ieee754.write = function (buffer, value, offset, isLE, mLen, nBytes) {
 	function boundsError (value, length, type) {
 	  if (Math.floor(value) !== value) {
 	    validateNumber(value, type);
-	    throw new errors.ERR_OUT_OF_RANGE(type || 'offset', 'an integer', value)
+	    throw new errors.ERR_OUT_OF_RANGE('offset', 'an integer', value)
 	  }
 	  if (length < 0) {
 	    throw new errors.ERR_BUFFER_OUT_OF_BOUNDS()
 	  }
-	  throw new errors.ERR_OUT_OF_RANGE(type || 'offset',
-	                                    `>= ${type ? 1 : 0} and <= ${length}`,
+	  throw new errors.ERR_OUT_OF_RANGE('offset',
+	                                    `>= ${0} and <= ${length}`,
 	                                    value)
 	}
 	const INVALID_BASE64_RE = /[^+/0-9A-Za-z-_]/g;
@@ -1869,7 +1867,7 @@ getDefaultExportFromCjs(buffer);
 
 /**
  * @module @zk-kit/utils
- * @version 0.8.1
+ * @version 1.2.0
  * @file Essential zero-knowledge utility library for JavaScript developers.
  * @copyright Ethereum Foundation 2024
  * @license MIT
@@ -1883,6 +1881,7 @@ getDefaultExportFromCjs(buffer);
  * are useful for type checking and validation in the other libraries,
  * enhancing code robustness and reliability.
  */
+/** @internal */
 const supportedTypes = [
     "number",
     "string",
@@ -1966,7 +1965,7 @@ function isStringifiedBigInt(value) {
         BigInt(value);
         return true;
     }
-    catch (_a) {
+    catch {
         return false;
     }
 }
@@ -2015,6 +2014,7 @@ function isBigNumberish(value) {
 /**
  * Returns true if the value type is the same as the type passed
  * as the second parameter, false otherwise.
+ * @param value
  * @param type The expected type.
  */
 function isType(value, type) {
@@ -2058,7 +2058,7 @@ function isSupportedType(type) {
 
 /**
  * @module @zk-kit/utils
- * @version 0.8.1
+ * @version 1.2.0
  * @file Essential zero-knowledge utility library for JavaScript developers.
  * @copyright Ethereum Foundation 2024
  * @license MIT
@@ -2074,20 +2074,6 @@ function requireString(parameterValue, parameterName) {
         throw new TypeError(`Parameter '${parameterName}' is not a string, received type: ${typeof parameterValue}`);
     }
 }
-/**
- * @throws Throws a type error if the parameter value is not a hexadecimal string.
- * If 'prefix' is 'true', the string must start with '0x' or '0X' followed by one or more
- * hexadecimal digits (0-9, a-f, A-F), otherwise no prefix is expected. 'prefix' is optional and
- * if its value it is not explicitly defined it will be set to 'true' by default.
- * @param parameterValue The parameter value.
- * @param parameterName The parameter name.
- * @param prefix A boolean to include or not a '0x' or '0X' prefix.
- */
-function requireHexadecimal(parameterValue, parameterName, prefix = true) {
-    if (!isHexadecimal(parameterValue, prefix)) {
-        throw new TypeError(`Parameter '${parameterName}' is not a hexadecimal string`);
-    }
-}
 /**
  * @throws Throws a type error if the parameter value type is not part of the list of types.
  * @param parameterValue The parameter value.
@@ -2109,34 +2095,40 @@ function requireTypes(parameterValue, parameterName, types) {
 
 /**
  * @module @zk-kit/utils
- * @version 0.8.1
+ * @version 1.2.0
  * @file Essential zero-knowledge utility library for JavaScript developers.
  * @copyright Ethereum Foundation 2024
  * @license MIT
  * @see [Github]{@link https://github.com/privacy-scaling-explorations/zk-kit/tree/main/packages/utils}
 */
 /**
- * Converts an hexadecimal string to a buffer. The hexadecimal string
- * should not start with '0x' or '0X'. It keeps the bytes in the same order.
- * @param value The hexadecimal string to convert.
- * @returns The buffer representation of the hexadecimal string.
+ * Converts bytes to a base64 string. It accepts 'Buffer' or 'Uint8Array'.
+ * @param value The bytes to convert.
+ * @returns The converted base64 string.
  */
-function hexadecimalToBuffer(value) {
-    requireHexadecimal(value, "value", false);
-    if (value.length % 2 !== 0) {
-        value = `0${value}`;
-    }
-    return buffer.Buffer.from(value, "hex");
+function bufferToBase64(value) {
+    requireTypes(value, "value", ["Buffer", "Uint8Array"]);
+    return buffer.Buffer.from(value).toString("base64");
 }
 /**
- * Converts a buffer to a hexadecimal string. It accepts 'Buffer' or 'Uint8Array'.
- * The hexadecimal string will not start with '0x' or '0X'. It keeps the bytes in the same order.
- * @param value The buffer to convert.
- * @returns The converted hexadecimal string.
+ * Converts a base64 string to bytes (i.e. a buffer). This function does not check
+ * if the input value is a valid base64 string. If there are unsupported characters
+ * they will be ignored.
+ * @param value The base64 string to convert.
+ * @returns The converted buffer.
  */
-function bufferToHexadecimal(value) {
-    requireTypes(value, "value", ["Buffer", "Uint8Array"]);
-    return buffer.Buffer.from(value).toString("hex");
+function base64ToBuffer(value) {
+    requireString(value, "value");
+    return buffer.Buffer.from(value, "base64");
+}
+/**
+ * Converts text (utf8) to a base64 string.
+ * @param value The text to convert.
+ * @returns The converted base64 string.
+ */
+function textToBase64(value) {
+    requireString(value, "value");
+    return buffer.Buffer.from(value, "utf8").toString("base64");
 }
 
 var poseidon2$1 = {};
@@ -2243,14 +2235,12 @@ function poseidon2(inputs) {
  * and {@link https://www.poseidon-hash.info | Poseidon} for signatures.
  * In addition, the commitment, i.e. the hash of the public key, is used to represent
  * Semaphore identities in groups, adding an additional layer of privacy and security.
- * The private key of the identity is stored as a hexadecimal string or text.
- * The other attributes are stored as stringified bigint.
+ * The private key of the identity can be exported as a base64 string.
  */
 class Identity {
     /**
-     * Initializes the class attributes based on a given private key, which must be a hexadecimal string or a text.
-     * Hexadecimal strings must not start with '0x' or '0X'.
-     * If the private key is not passed as a parameter, a random hexadecimal key will be generated.
+     * Initializes the class attributes based on a given private key, which must be text or a buffer.
+     * If the private key is not passed as a parameter, a random private key will be generated.
      * The EdDSAPoseidon class is used to generate the secret scalar and the public key.
      * Additionally, the constructor computes a commitment of the public key using a hash function (Poseidon).
      *
@@ -2264,28 +2254,15 @@ class Identity {
      * @param privateKey The private key used to derive the public key (hexadecimal or string).
      */
     constructor(privateKey) {
-        let eddsa;
-        if (privateKey) {
-            requireString(privateKey, "privateKey");
-            this._privateKey = privateKey;
-            if (isHexadecimal(privateKey, false)) {
-                eddsa = new EdDSAPoseidon(hexadecimalToBuffer(privateKey));
-            }
-            else {
-                eddsa = new EdDSAPoseidon(privateKey);
-            }
-        }
-        else {
-            eddsa = new EdDSAPoseidon();
-            this._privateKey = bufferToHexadecimal(eddsa.privateKey);
-        }
+        const eddsa = new EdDSAPoseidon(privateKey);
+        this._privateKey = eddsa.privateKey;
         this._secretScalar = eddsa.secretScalar;
         this._publicKey = eddsa.publicKey;
         this._commitment = poseidon2_2(this._publicKey);
     }
     /**
      * Returns the private key.
-     * @returns The private key as a string (hexadecimal or text).
+     * @returns The private key as a buffer or text.
      */
     get privateKey() {
         return this._privateKey;
@@ -2311,6 +2288,25 @@ class Identity {
     get commitment() {
         return this._commitment;
     }
+    /**
+     * Returns the private key encoded as a base64 string.
+     * @returns The private key as a base64 string.
+     */
+    export() {
+        if (isString(this._privateKey)) {
+            return textToBase64(this._privateKey);
+        }
+        return bufferToBase64(this.privateKey);
+    }
+    /**
+     * Returns a Semaphore identity based on a private key encoded as a base64 string.
+     * The private key will be converted to a buffer, regardless of its original type.
+     * @param privateKey The private key as a base64 string.
+     * @returns The Semaphore identity.
+     */
+    static import(privateKey) {
+        return new Identity(base64ToBuffer(privateKey));
+    }
     /**
      * Generates a signature for a given message using the private key.
      * This method demonstrates how to sign a message and could be used
@@ -2324,10 +2320,7 @@ class Identity {
      * @returns A {@link https://zkkit.pse.dev/types/_zk_kit_eddsa_poseidon.Signature.html | Signature} object containing the signature components.
      */
     signMessage(message) {
-        const privateKey = isHexadecimal(this.privateKey, false)
-            ? hexadecimalToBuffer(this.privateKey)
-            : this.privateKey;
-        return signMessage(privateKey, message);
+        return signMessage(this.privateKey, message);
     }
     /**
      * Verifies a signature against a given message and public key.

package/dist/types/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="node" />
 import type { Point } from "@zk-kit/baby-jubjub";
 import { Signature } from "@zk-kit/eddsa-poseidon";
 import type { BigNumberish } from "@zk-kit/utils";
@@ -8,8 +9,7 @@ import type { BigNumberish } from "@zk-kit/utils";
  * and {@link https://www.poseidon-hash.info | Poseidon} for signatures.
  * In addition, the commitment, i.e. the hash of the public key, is used to represent
  * Semaphore identities in groups, adding an additional layer of privacy and security.
- * The private key of the identity is stored as a hexadecimal string or text.
- * The other attributes are stored as stringified bigint.
+ * The private key of the identity can be exported as a base64 string.
  */
 export declare class Identity {
     private _privateKey;
@@ -17,9 +17,8 @@ export declare class Identity {
     private _publicKey;
     private _commitment;
     /**
-     * Initializes the class attributes based on a given private key, which must be a hexadecimal string or a text.
-     * Hexadecimal strings must not start with '0x' or '0X'.
-     * If the private key is not passed as a parameter, a random hexadecimal key will be generated.
+     * Initializes the class attributes based on a given private key, which must be text or a buffer.
+     * If the private key is not passed as a parameter, a random private key will be generated.
      * The EdDSAPoseidon class is used to generate the secret scalar and the public key.
      * Additionally, the constructor computes a commitment of the public key using a hash function (Poseidon).
      *
@@ -32,12 +31,12 @@ export declare class Identity {
      *
      * @param privateKey The private key used to derive the public key (hexadecimal or string).
      */
-    constructor(privateKey?: string);
+    constructor(privateKey?: string | Buffer | Uint8Array);
     /**
      * Returns the private key.
-     * @returns The private key as a string (hexadecimal or text).
+     * @returns The private key as a buffer or text.
      */
-    get privateKey(): string;
+    get privateKey(): string | Buffer | Uint8Array;
     /**
      * Returns the secret scalar.
      * @returns The secret scalar as a string.
@@ -53,6 +52,18 @@ export declare class Identity {
      * @returns The commitment as a string.
      */
     get commitment(): bigint;
+    /**
+     * Returns the private key encoded as a base64 string.
+     * @returns The private key as a base64 string.
+     */
+    export(): string;
+    /**
+     * Returns a Semaphore identity based on a private key encoded as a base64 string.
+     * The private key will be converted to a buffer, regardless of its original type.
+     * @param privateKey The private key as a base64 string.
+     * @returns The Semaphore identity.
+     */
+    static import(privateKey: string): Identity;
     /**
      * Generates a signature for a given message using the private key.
      * This method demonstrates how to sign a message and could be used

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@semaphore-protocol/identity",
-  "version": "4.0.0-beta.9",
+  "version": "4.0.0",
   "description": "A library to create Semaphore identities.",
   "type": "module",
   "license": "MIT",
@@ -39,9 +39,9 @@
     "rollup-plugin-cleanup": "^3.2.1"
   },
   "dependencies": {
-    "@zk-kit/baby-jubjub": "0.3.0",
-    "@zk-kit/eddsa-poseidon": "0.10.0",
-    "@zk-kit/utils": "0.8.1",
+    "@zk-kit/baby-jubjub": "1.0.1",
+    "@zk-kit/eddsa-poseidon": "1.0.2",
+    "@zk-kit/utils": "1.2.0",
     "poseidon-lite": "0.2.0"
   }
 }

package/src/index.ts

@@ -1,9 +1,8 @@
 import type { Point } from "@zk-kit/baby-jubjub"
 import { EdDSAPoseidon, Signature, signMessage, verifySignature } from "@zk-kit/eddsa-poseidon"
 import type { BigNumberish } from "@zk-kit/utils"
-import { bufferToHexadecimal, hexadecimalToBuffer } from "@zk-kit/utils/conversions"
-import { requireString } from "@zk-kit/utils/error-handlers"
-import { isHexadecimal } from "@zk-kit/utils/type-checks"
+import { base64ToBuffer, bufferToBase64, textToBase64 } from "@zk-kit/utils/conversions"
+import { isString } from "@zk-kit/utils/type-checks"
 import { poseidon2 } from "poseidon-lite/poseidon2"
 
 /**
@@ -13,12 +12,11 @@ import { poseidon2 } from "poseidon-lite/poseidon2"
  * and {@link https://www.poseidon-hash.info | Poseidon} for signatures.
  * In addition, the commitment, i.e. the hash of the public key, is used to represent
  * Semaphore identities in groups, adding an additional layer of privacy and security.
- * The private key of the identity is stored as a hexadecimal string or text.
- * The other attributes are stored as stringified bigint.
+ * The private key of the identity can be exported as a base64 string.
  */
 export class Identity {
     // The EdDSA private key, passed as a parameter or generated randomly.
-    private _privateKey: string
+    private _privateKey: string | Buffer | Uint8Array
     // The secret scalar derived from the private key.
     // It is used in circuits to derive the public key.
     private _secretScalar: bigint
@@ -28,9 +26,8 @@ export class Identity {
     private _commitment: bigint
 
     /**
-     * Initializes the class attributes based on a given private key, which must be a hexadecimal string or a text.
-     * Hexadecimal strings must not start with '0x' or '0X'.
-     * If the private key is not passed as a parameter, a random hexadecimal key will be generated.
+     * Initializes the class attributes based on a given private key, which must be text or a buffer.
+     * If the private key is not passed as a parameter, a random private key will be generated.
      * The EdDSAPoseidon class is used to generate the secret scalar and the public key.
      * Additionally, the constructor computes a commitment of the public key using a hash function (Poseidon).
      *
@@ -43,25 +40,10 @@ export class Identity {
      *
      * @param privateKey The private key used to derive the public key (hexadecimal or string).
      */
-    constructor(privateKey?: string) {
-        let eddsa: EdDSAPoseidon
-
-        if (privateKey) {
-            requireString(privateKey, "privateKey")
-
-            this._privateKey = privateKey
-
-            if (isHexadecimal(privateKey, false)) {
-                eddsa = new EdDSAPoseidon(hexadecimalToBuffer(privateKey))
-            } else {
-                eddsa = new EdDSAPoseidon(privateKey)
-            }
-        } else {
-            eddsa = new EdDSAPoseidon()
-
-            this._privateKey = bufferToHexadecimal(eddsa.privateKey as any)
-        }
+    constructor(privateKey?: string | Buffer | Uint8Array) {
+        const eddsa = new EdDSAPoseidon(privateKey)
 
+        this._privateKey = eddsa.privateKey
         this._secretScalar = eddsa.secretScalar
         this._publicKey = eddsa.publicKey
         this._commitment = poseidon2(this._publicKey)
@@ -69,9 +51,9 @@ export class Identity {
 
     /**
      * Returns the private key.
-     * @returns The private key as a string (hexadecimal or text).
+     * @returns The private key as a buffer or text.
      */
-    public get privateKey(): string {
+    public get privateKey(): string | Buffer | Uint8Array {
         return this._privateKey
     }
 
@@ -99,6 +81,28 @@ export class Identity {
         return this._commitment
     }
 
+    /**
+     * Returns the private key encoded as a base64 string.
+     * @returns The private key as a base64 string.
+     */
+    public export(): string {
+        if (isString(this._privateKey)) {
+            return textToBase64(this._privateKey as string)
+        }
+
+        return bufferToBase64(this.privateKey as Buffer | Uint8Array)
+    }
+
+    /**
+     * Returns a Semaphore identity based on a private key encoded as a base64 string.
+     * The private key will be converted to a buffer, regardless of its original type.
+     * @param privateKey The private key as a base64 string.
+     * @returns The Semaphore identity.
+     */
+    static import(privateKey: string): Identity {
+        return new Identity(base64ToBuffer(privateKey))
+    }
+
     /**
      * Generates a signature for a given message using the private key.
      * This method demonstrates how to sign a message and could be used
@@ -112,11 +116,7 @@ export class Identity {
      * @returns A {@link https://zkkit.pse.dev/types/_zk_kit_eddsa_poseidon.Signature.html | Signature} object containing the signature components.
      */
     public signMessage(message: BigNumberish): Signature<bigint> {
-        const privateKey = isHexadecimal(this.privateKey, false)
-            ? hexadecimalToBuffer(this.privateKey)
-            : this.privateKey
-
-        return signMessage(privateKey, message)
+        return signMessage(this.privateKey, message)
     }
 
     /**