refactor(utils)!: migrate keystore.js to ts

BREAKING CHANGE: `validateKeyObj` removed
Rely TypeScript checks instead.

BREAKING CHANGE: `deriveKeyUsingArgon2id` removed
Use `argon2-browser` package instead.

docs/guides/error-handling.md

@@ -68,11 +68,9 @@ BaseError
 └───CryptographyError
 │   │   InvalidChecksumError
 │   │   InvalidDerivationPathError
-│   │   InvalidKeyError
 │   │   InvalidPasswordError
 │   │   MerkleTreeHashMismatchError
 │   │   MissingNodeInTreeError
-│   │   UnsupportedAlgorithmError
 │   │   NotHardenedSegmentError
 │   │   UnknownNodeLengthError
 │   │   UnknownPathNibbleError

package.json

@@ -74,13 +74,15 @@
     "@commitlint/cli": "^16.1.0",
     "@commitlint/config-conventional": "^16.0.0",
     "@types/aes-js": "^3.1.1",
+    "@types/argon2-browser": "^1.18.1",
     "@types/bn.js": "^5.1.0",
     "@types/bs58": "^4.0.1",
     "@types/chai": "^4.3.0",
     "@types/json-bigint": "^1.0.1",
     "@types/mocha": "^9.1.0",
     "@types/node": "^17.0.17",
     "@types/sha.js": "^2.4.0",
+    "@types/uuid": "^8.3.4",
     "@typescript-eslint/eslint-plugin": "^5.11.0",
     "@typescript-eslint/parser": "^5.11.0",
     "babel-loader": "^8.2.3",

src/typings/@aeternity__argon2-browser/index.d.ts

@@ -0,0 +1,3 @@
+declare module '@aeternity/argon2-browser/dist/argon2-bundled.min.js' {
+  export * from 'argon2-browser'
+}

src/typings/@aeternity__uuid/index.d.ts

@@ -0,0 +1,3 @@
+declare module '@aeternity/uuid' {
+  export * from 'uuid'
+}

src/utils/bytes.ts

@@ -72,3 +72,7 @@ export function str2buf (str: string, enc?: BufferEncoding): Buffer {
     enc ?? (isHex(str) ? 'hex' : undefined) ?? (isBase64(str) ? 'base64' : undefined)
   )
 }
+
+export const bytesToHex = (b: Uint8Array): string => Buffer.from(b).toString('hex')
+
+export const hexToBytes = (s: string): Uint8Array => Buffer.from(s, 'hex')

src/utils/crypto.ts

@@ -36,14 +36,13 @@ const Ecb = aesjs.ModeOfOperation.ecb
 /**
  * Generate address from secret key
  * @rtype (secret: String) => tx: Promise[String]
- * @param {String | Buffer} secret - Private key
+ * @param {String | Uint8Array} secret - Private key
  * @return {String} Public key
  */
-export function getAddressFromPriv (secret: string | Buffer): string {
-  const secretBuffer = Buffer.isBuffer(secret) ? secret : str2buf(secret)
+export function getAddressFromPriv (secret: string | Uint8Array): string {
+  const secretBuffer = typeof secret === 'string' ? str2buf(secret) : secret
   const keys = nacl.sign.keyPair.fromSecretKey(secretBuffer)
-  const publicBuffer = Buffer.from(keys.publicKey)
-  return encode(publicBuffer, 'ak')
+  return encode(keys.publicKey, 'ak')
 }
 
 /**

src/utils/errors.ts

@@ -448,16 +448,9 @@ export class InvalidDerivationPathError extends CryptographyError {
   }
 }
 
-export class InvalidKeyError extends CryptographyError {
-  constructor (message: string) {
-    super(message)
-    this.name = 'InvalidKeyError'
-  }
-}
-
 export class InvalidPasswordError extends CryptographyError {
-  constructor (message: string) {
-    super(message)
+  constructor () {
+    super('Invalid password or nonce')
     this.name = 'InvalidPasswordError'
   }
 }
@@ -476,13 +469,6 @@ export class MissingNodeInTreeError extends CryptographyError {
   }
 }
 
-export class UnsupportedAlgorithmError extends CryptographyError {
-  constructor (algo: string) {
-    super(algo + ' is not available')
-    this.name = 'UnsupportedAlgorithmError'
-  }
-}
-
 export class NotHardenedSegmentError extends CryptographyError {
   constructor (message: string) {
     super(message)