@sudoplatform/sudo-common 6.3.0 → 7.0.0

package/lib/sudoKeyArchive/sudoKeyArchive.d.ts

@@ -142,7 +142,7 @@ export declare class DefaultSudoKeyArchive implements SudoKeyArchive {
      *
      * @param excludedKeyTypes
      *     Set of key types to exclude from archive or restore operation.
-     *     Default: {{@link KeyArchiveKeyType.PublicKey}}
+     *     Default: {@link KeyArchiveKeyType.PublicKey}
      *
      * @param metaInfo
      *     Meta information to include with the key archive

package/lib/sudoKeyArchive/sudoKeyArchive.js

@@ -81,7 +81,7 @@ class DefaultSudoKeyArchive {
    *
    * @param excludedKeyTypes
    *     Set of key types to exclude from archive or restore operation.
-   *     Default: {{@link KeyArchiveKeyType.PublicKey}}
+   *     Default: {@link KeyArchiveKeyType.PublicKey}
    *
    * @param metaInfo
    *     Meta information to include with the key archive

package/lib/sudoKeyManager/sudoCryptoProvider.d.ts

@@ -4,6 +4,7 @@ import { PublicKey } from './publicKey';
 export declare class SudoCryptoProviderDefaults {
     static readonly aesIVSize = 16;
     static readonly aesKeySize = 256;
+    static readonly rsaKeySize = 2048;
     static readonly pbkdfRounds = 10000;
     static readonly pbkdfSaltSize = 16;
 }
@@ -74,6 +75,14 @@ export interface SudoCryptoProvider {
      *
      * @param name The name of the symmetric key.
      */
+    doesSymmetricKeyExist(name: string): Promise<boolean>;
+    /**
+     * Checks to see if the specified symmetric key exists.
+     *
+     * @param name The name of the symmetric key.
+     *
+     * @deprecated Use doesSymmetricKeyExist
+     */
     doesSymmetricKeyExists(name: string): Promise<boolean>;
     /**
      * Deletes a symmetric key from the secure store.
@@ -113,6 +122,27 @@ export interface SudoCryptoProvider {
      * @param name The name of the key pair to be deleted.
      */
     deleteKeyPair(name: string): Promise<void>;
+    /**
+     * Generates a signature for the given data with the specified private key.
+     *
+     * @param name The name of the private key to use for generation.
+     * @param data The data to sign.
+     *
+     * @returns Data signature
+     *
+     * @throws {@link KeyNotFoundError}
+     */
+    generateSignatureWithPrivateKey(name: string, data: ArrayBuffer): Promise<ArrayBuffer>;
+    /**
+     * Verifies the given data against the provided signature using the specified public key.
+     *
+     * @param name The name of the public key to use for validation.
+     * @param data The data to verify
+     * @param signature The signature to verify against
+     *
+     * @returns True if the data and signature could be successfully verified
+     */
+    verifySignatureWithPublicKey(name: string, data: ArrayBuffer, signature: ArrayBuffer): Promise<boolean>;
     /**
      * Adds a private key to the secure store.
      *
@@ -133,6 +163,14 @@ export interface SudoCryptoProvider {
      *
      * @param name The name of the private key.
      */
+    doesPrivateKeyExist(name: string): Promise<boolean>;
+    /**
+     * Checks to see if the specified private key exists.
+     *
+     * @param name The name of the private key.
+     *
+     * @deprecated Use doesPrivateKeyExist
+     */
     doesPrivateKeyExists(name: string): Promise<boolean>;
     /**
      * Adds a public key to the secure store.
@@ -141,6 +179,12 @@ export interface SudoCryptoProvider {
      * @param name The name of the public key to be stored.
      */
     addPublicKey(key: ArrayBuffer, name: string): Promise<void>;
+    /**
+     * Deletes the specified public key from the secure store.
+     *
+     * @param name The name of the public key to be removed.
+     */
+    deletePublicKey(name: string): Promise<void>;
     /**
      * Retrieves the public key from the secure store.
      *
@@ -175,6 +219,7 @@ export interface SudoCryptoProvider {
      * @returns Encrypted data and IV
      *
      * @throws {@link UnrecognizedAlgorithmError}
+     * @throws {@link KeyNotFoundError}
      */
     encryptWithSymmetricKeyName(name: string, data: ArrayBuffer, options?: SymmetricEncryptionOptions): Promise<ArrayBuffer>;
     /**
@@ -198,6 +243,7 @@ export interface SudoCryptoProvider {
      * @returns Decrypted data
      *
      * @throws {@link UnrecognizedAlgorithmError}
+     * @throws {@link KeyNotFoundError}
      */
     decryptWithSymmetricKeyName(name: string, data: ArrayBuffer, options?: SymmetricEncryptionOptions): Promise<ArrayBuffer>;
     /**
@@ -255,6 +301,7 @@ export interface SudoCryptoProvider {
      * @returns Encrypted data
      *
      * @throws {@link UnrecognizedAlgorithmError}
+     * @throws {@link KeyNotFoundError}
      */
     encryptWithPublicKey(name: string, data: ArrayBuffer, options?: AsymmetricEncryptionOptions): Promise<ArrayBuffer>;
     /**
@@ -263,9 +310,10 @@ export interface SudoCryptoProvider {
      * @param name The name of the private key to use for decryption.
      * @param data The data to decrypt.
      *
-     * @returns Decrypted data or undefined if the private key is not found.
+     * @returns Decrypted data.
      *
      * @throws {@link UnrecognizedAlgorithmError}
+     * @throws {@link KeyNotFoundError}
      */
     decryptWithPrivateKey(name: string, data: ArrayBuffer, options?: AsymmetricEncryptionOptions): Promise<ArrayBuffer>;
     /**

package/lib/sudoKeyManager/sudoCryptoProvider.js

@@ -19,6 +19,8 @@ _defineProperty(SudoCryptoProviderDefaults, "aesIVSize", 16);
 
 _defineProperty(SudoCryptoProviderDefaults, "aesKeySize", 256);
 
+_defineProperty(SudoCryptoProviderDefaults, "rsaKeySize", 2048);
+
 _defineProperty(SudoCryptoProviderDefaults, "pbkdfRounds", 10000);
 
 _defineProperty(SudoCryptoProviderDefaults, "pbkdfSaltSize", 16);

package/lib/sudoKeyManager/sudoKeyManager.d.ts

@@ -56,6 +56,14 @@ export interface SudoKeyManager {
      *
      * @param name The name of the symmetric key.
      */
+    doesSymmetricKeyExist(name: string): Promise<boolean>;
+    /**
+     * Checks to see if the specified symmetric key exists.
+     *
+     * @param name The name of the symmetric key.
+     *
+     * @deprecated Use doesSymmetricKeyExist
+     */
     doesSymmetricKeyExists(name: string): Promise<boolean>;
     /**
      * Deletes a symmetric key from the secure store.
@@ -83,6 +91,14 @@ export interface SudoKeyManager {
      *
      * @param name The name of the private key.
      */
+    doesPrivateKeyExist(name: string): Promise<boolean>;
+    /**
+     * Checks to see if the specified private key exists.
+     *
+     * @param name The name of the private key.
+     *
+     * @deprecated Use doesPrivateKeyExist
+     */
     doesPrivateKeyExists(name: string): Promise<boolean>;
     /**
      * Adds a public key to the secure store.
@@ -93,6 +109,12 @@ export interface SudoKeyManager {
      * @param name The name of the public key to be stored.
      */
     addPublicKey(key: ArrayBuffer, name: string): Promise<void>;
+    /**
+     * Deletes the specified public key from the secure store.
+     *
+     * @param name The name of the public key to be removed.
+     */
+    deletePublicKey(name: string): Promise<void>;
     /**
      * Retrieves the public key from the secure store.
      *
@@ -109,6 +131,25 @@ export interface SudoKeyManager {
      * @param name The name of the key pair to be deleted.
      */
     deleteKeyPair(name: string): Promise<void>;
+    /**
+     * Generates a signature for the given data with the specified private key.
+     *
+     * @param name The name of the private key to use for generation.
+     * @param data The data to sign.
+     *
+     * @returns Data signature or undefined if the private key is not found.
+     */
+    generateSignatureWithPrivateKey(name: string, data: ArrayBuffer): Promise<ArrayBuffer>;
+    /**
+     * Verifies the given data against the provided signature using the specified public key.
+     *
+     * @param name The name of the public key to use for validation.
+     * @param data The data to verify
+     * @param signature The signature to verify against
+     *
+     * @returns True if the data and signature could be successfully verified
+     */
+    verifySignatureWithPublicKey(name: string, data: ArrayBuffer, signature: ArrayBuffer): Promise<boolean>;
     /**
      * @deprecated Use version with `options` param.
      *
@@ -290,15 +331,20 @@ export declare class DefaultSudoKeyManager implements SudoKeyManager {
     updatePassword(password: ArrayBuffer, name: string): Promise<void>;
     addSymmetricKey(key: ArrayBuffer, name: string): Promise<void>;
     getSymmetricKey(name: string): Promise<ArrayBuffer | undefined>;
+    doesSymmetricKeyExist(name: string): Promise<boolean>;
     doesSymmetricKeyExists(name: string): Promise<boolean>;
     deleteSymmetricKey(name: string): Promise<void>;
     generateKeyPair(name: string): Promise<void>;
     addPrivateKey(key: ArrayBuffer, name: string): Promise<void>;
     getPrivateKey(name: string): Promise<ArrayBuffer | undefined>;
+    doesPrivateKeyExist(name: string): Promise<boolean>;
     doesPrivateKeyExists(name: string): Promise<boolean>;
     addPublicKey(key: ArrayBuffer, name: string): Promise<void>;
+    deletePublicKey(name: string): Promise<void>;
     getPublicKey(name: string): Promise<PublicKey | undefined>;
     deleteKeyPair(name: string): Promise<void>;
+    generateSignatureWithPrivateKey(name: string, data: ArrayBuffer): Promise<ArrayBuffer>;
+    verifySignatureWithPublicKey(name: string, data: ArrayBuffer, signature: ArrayBuffer): Promise<boolean>;
     encryptWithSymmetricKey(key: ArrayBuffer, data: ArrayBuffer, ivOrOptions?: ArrayBuffer | SymmetricEncryptionOptions): Promise<ArrayBuffer>;
     decryptWithSymmetricKey(key: ArrayBuffer, data: ArrayBuffer, ivOrOptions?: ArrayBuffer | SymmetricEncryptionOptions): Promise<ArrayBuffer>;
     encryptWithSymmetricKeyName(name: string, data: ArrayBuffer, ivOrOptions?: ArrayBuffer | SymmetricEncryptionOptions): Promise<ArrayBuffer>;

package/lib/sudoKeyManager/sudoKeyManager.js

@@ -49,6 +49,10 @@ class DefaultSudoKeyManager {
     return this.sudoCryptoProvider.getSymmetricKey(name);
   }
 
+  doesSymmetricKeyExist(name) {
+    return this.sudoCryptoProvider.doesSymmetricKeyExists(name);
+  }
+
   doesSymmetricKeyExists(name) {
     return this.sudoCryptoProvider.doesSymmetricKeyExists(name);
   }
@@ -69,6 +73,10 @@ class DefaultSudoKeyManager {
     return this.sudoCryptoProvider.getPrivateKey(name);
   }
 
+  doesPrivateKeyExist(name) {
+    return this.sudoCryptoProvider.doesPrivateKeyExists(name);
+  }
+
   doesPrivateKeyExists(name) {
     return this.sudoCryptoProvider.doesPrivateKeyExists(name);
   }
@@ -77,6 +85,10 @@ class DefaultSudoKeyManager {
     return this.sudoCryptoProvider.addPublicKey(key, name);
   }
 
+  deletePublicKey(name) {
+    return this.sudoCryptoProvider.deletePublicKey(name);
+  }
+
   getPublicKey(name) {
     return this.sudoCryptoProvider.getPublicKey(name);
   }
@@ -85,9 +97,19 @@ class DefaultSudoKeyManager {
     return this.sudoCryptoProvider.deleteKeyPair(name);
   }
 
+  generateSignatureWithPrivateKey(name, data) {
+    return this.sudoCryptoProvider.generateSignatureWithPrivateKey(name, data);
+  }
+
+  verifySignatureWithPublicKey(name, data, signature) {
+    return this.sudoCryptoProvider.verifySignatureWithPublicKey(name, data, signature);
+  }
+
   encryptWithSymmetricKey(key, data, ivOrOptions) {
     if (_buffer.Buffer.isArrayBuffer(ivOrOptions)) {
-      return this.sudoCryptoProvider.encryptWithSymmetricKey(key, data, ivOrOptions);
+      return this.sudoCryptoProvider.encryptWithSymmetricKey(key, data, {
+        iv: ivOrOptions
+      });
     } else {
       return this.sudoCryptoProvider.encryptWithSymmetricKey(key, data, ivOrOptions);
     }
@@ -95,7 +117,9 @@ class DefaultSudoKeyManager {
 
   decryptWithSymmetricKey(key, data, ivOrOptions) {
     if (_buffer.Buffer.isArrayBuffer(ivOrOptions)) {
-      return this.sudoCryptoProvider.decryptWithSymmetricKey(key, data, ivOrOptions);
+      return this.sudoCryptoProvider.decryptWithSymmetricKey(key, data, {
+        iv: ivOrOptions
+      });
     } else {
       return this.sudoCryptoProvider.decryptWithSymmetricKey(key, data, ivOrOptions);
     }
@@ -103,7 +127,9 @@ class DefaultSudoKeyManager {
 
   encryptWithSymmetricKeyName(name, data, ivOrOptions) {
     if (_buffer.Buffer.isArrayBuffer(ivOrOptions)) {
-      return this.sudoCryptoProvider.encryptWithSymmetricKeyName(name, data, ivOrOptions);
+      return this.sudoCryptoProvider.encryptWithSymmetricKeyName(name, data, {
+        iv: ivOrOptions
+      });
     } else {
       return this.sudoCryptoProvider.encryptWithSymmetricKeyName(name, data, ivOrOptions);
     }
@@ -111,7 +137,9 @@ class DefaultSudoKeyManager {
 
   decryptWithSymmetricKeyName(name, data, ivOrOptions) {
     if (_buffer.Buffer.isArrayBuffer(ivOrOptions)) {
-      return this.sudoCryptoProvider.decryptWithSymmetricKeyName(name, data, ivOrOptions);
+      return this.sudoCryptoProvider.decryptWithSymmetricKeyName(name, data, {
+        iv: ivOrOptions
+      });
     } else {
       return this.sudoCryptoProvider.decryptWithSymmetricKeyName(name, data, ivOrOptions);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sudoplatform/sudo-common",
-  "version": "6.3.0",
+  "version": "7.0.0",
   "author": "Anonyome Labs, Inc.",
   "repository": {
     "type": "git",
@@ -44,40 +44,48 @@
   },
   "dependencies": {
     "apollo-client": "^2.6.10",
-    "aws-sdk": "^2.973.0",
+    "aws-sdk": "^2.1181.0",
     "browser-bunyan": "^1.8.0",
     "fflate": "^0.7.3",
     "graphql": "^15.8.0"
   },
   "peerDependencies": {
-    "io-ts": "^2.2.10"
+    "io-ts": "^2.2.16"
   },
   "devDependencies": {
-    "@babel/cli": "^7.17.10",
-    "@babel/core": "^7.17.10",
-    "@babel/plugin-proposal-class-properties": "^7.16.7",
-    "@babel/plugin-proposal-private-methods": "^7.16.11",
-    "@babel/preset-env": "^7.17.10",
-    "@babel/preset-typescript": "^7.16.7",
-    "@types/jest": "^27.5.0",
-    "@typescript-eslint/eslint-plugin": "^5.22.0",
-    "@typescript-eslint/parser": "^5.22.0",
+    "@babel/cli": "^7.18.9",
+    "@babel/core": "^7.18.9",
+    "@babel/plugin-proposal-class-properties": "^7.18.6",
+    "@babel/plugin-proposal-private-methods": "^7.18.6",
+    "@babel/preset-env": "^7.18.9",
+    "@babel/preset-typescript": "^7.18.6",
+    "@types/jest": "^27.5.2",
+    "@typescript-eslint/eslint-plugin": "^5.30.7",
+    "@typescript-eslint/parser": "^5.30.7",
     "aws-sdk-mock": "^5.7.0",
-    "eslint": "^8.14.0",
+    "eslint": "^8.20.0",
     "eslint-config-prettier": "^8.5.0",
     "eslint-plugin-import": "^2.26.0",
-    "eslint-plugin-prettier": "^4.0.0",
-    "fp-ts": "^2.11.8",
+    "eslint-plugin-prettier": "^4.2.1",
+    "fp-ts": "^2.12.1",
     "io-ts": "^2.2.16",
     "io-ts-types": "^0.5.16",
     "isomorphic-webcrypto": "^2.3.8",
     "jest": "^27.5.1",
     "monocle-ts": "^2.3.13",
     "newtype-ts": "^0.3.5",
-    "prettier": "^2.6.2",
+    "prettier": "^2.7.1",
     "rimraf": "^3.0.2",
     "ts-mockito": "^2.6.1",
-    "typedoc": "^0.22.15",
-    "typescript": "^4.6.4"
+    "typedoc": "^0.23.8",
+    "typescript": "^4.7.4"
+  },
+  "outdatedSuppressions": {
+    "major": {
+      "@types/jest": 1661135936,
+      "ansi-regex": 1661135937,
+      "graphql": 1661135937,
+      "jest": 1661135937
+    }
   }
 }

package/src/sudoKeyArchive/sudoKeyArchive.ts

@@ -195,7 +195,7 @@ export class DefaultSudoKeyArchive implements SudoKeyArchive {
    *
    * @param excludedKeyTypes
    *     Set of key types to exclude from archive or restore operation.
-   *     Default: {{@link KeyArchiveKeyType.PublicKey}}
+   *     Default: {@link KeyArchiveKeyType.PublicKey}
    *
    * @param metaInfo
    *     Meta information to include with the key archive

package/src/sudoKeyManager/sudoCryptoProvider.ts

@@ -5,6 +5,7 @@ import { PublicKey } from './publicKey'
 export class SudoCryptoProviderDefaults {
   public static readonly aesIVSize = 16
   public static readonly aesKeySize = 256
+  public static readonly rsaKeySize = 2048
   public static readonly pbkdfRounds = 10000
   public static readonly pbkdfSaltSize = 16
 }
@@ -90,6 +91,15 @@ export interface SudoCryptoProvider {
    *
    * @param name The name of the symmetric key.
    */
+  doesSymmetricKeyExist(name: string): Promise<boolean>
+
+  /**
+   * Checks to see if the specified symmetric key exists.
+   *
+   * @param name The name of the symmetric key.
+   *
+   * @deprecated Use doesSymmetricKeyExist
+   */
   doesSymmetricKeyExists(name: string): Promise<boolean>
 
   /**
@@ -137,6 +147,36 @@ export interface SudoCryptoProvider {
    */
   deleteKeyPair(name: string): Promise<void>
 
+  /**
+   * Generates a signature for the given data with the specified private key.
+   *
+   * @param name The name of the private key to use for generation.
+   * @param data The data to sign.
+   *
+   * @returns Data signature
+   *
+   * @throws {@link KeyNotFoundError}
+   */
+  generateSignatureWithPrivateKey(
+    name: string,
+    data: ArrayBuffer,
+  ): Promise<ArrayBuffer>
+
+  /**
+   * Verifies the given data against the provided signature using the specified public key.
+   *
+   * @param name The name of the public key to use for validation.
+   * @param data The data to verify
+   * @param signature The signature to verify against
+   *
+   * @returns True if the data and signature could be successfully verified
+   */
+  verifySignatureWithPublicKey(
+    name: string,
+    data: ArrayBuffer,
+    signature: ArrayBuffer,
+  ): Promise<boolean>
+
   /**
    * Adds a private key to the secure store.
    *
@@ -159,6 +199,15 @@ export interface SudoCryptoProvider {
    *
    * @param name The name of the private key.
    */
+  doesPrivateKeyExist(name: string): Promise<boolean>
+
+  /**
+   * Checks to see if the specified private key exists.
+   *
+   * @param name The name of the private key.
+   *
+   * @deprecated Use doesPrivateKeyExist
+   */
   doesPrivateKeyExists(name: string): Promise<boolean>
 
   /**
@@ -169,6 +218,13 @@ export interface SudoCryptoProvider {
    */
   addPublicKey(key: ArrayBuffer, name: string): Promise<void>
 
+  /**
+   * Deletes the specified public key from the secure store.
+   *
+   * @param name The name of the public key to be removed.
+   */
+  deletePublicKey(name: string): Promise<void>
+
   /**
    * Retrieves the public key from the secure store.
    *
@@ -210,6 +266,7 @@ export interface SudoCryptoProvider {
    * @returns Encrypted data and IV
    *
    * @throws {@link UnrecognizedAlgorithmError}
+   * @throws {@link KeyNotFoundError}
    */
   encryptWithSymmetricKeyName(
     name: string,
@@ -243,6 +300,7 @@ export interface SudoCryptoProvider {
    * @returns Decrypted data
    *
    * @throws {@link UnrecognizedAlgorithmError}
+   * @throws {@link KeyNotFoundError}
    */
   decryptWithSymmetricKeyName(
     name: string,
@@ -325,6 +383,7 @@ export interface SudoCryptoProvider {
    * @returns Encrypted data
    *
    * @throws {@link UnrecognizedAlgorithmError}
+   * @throws {@link KeyNotFoundError}
    */
   encryptWithPublicKey(
     name: string,
@@ -338,9 +397,10 @@ export interface SudoCryptoProvider {
    * @param name The name of the private key to use for decryption.
    * @param data The data to decrypt.
    *
-   * @returns Decrypted data or undefined if the private key is not found.
+   * @returns Decrypted data.
    *
    * @throws {@link UnrecognizedAlgorithmError}
+   * @throws {@link KeyNotFoundError}
    */
   decryptWithPrivateKey(
     name: string,