@aeternity/aepp-sdk 10.0.0 → 12.0.0

package/es/utils/crypto.d.ts

@@ -0,0 +1,103 @@
+/// <reference types="node" />
+import { SignKeyPair } from 'tweetnacl';
+import { Data } from 'blakejs';
+import { sha256hash, EncodedData, EncodingType } from './encoder';
+export { sha256hash };
+/**
+ * Generate address from secret key
+ * @param secret - Private key
+ * @returns Public key encoded as address
+ */
+export declare function getAddressFromPriv(secret: string | Uint8Array): EncodedData<'ak'>;
+/**
+ * Check if address is valid
+ * @param address - Address
+ * @param prefix - Transaction prefix. Default: 'ak'
+ * @returns is valid
+ */
+export declare function isAddressValid(address: string, prefix?: EncodingType): boolean;
+/**
+ * Generate a random salt (positive integer)
+ * @returns random salt
+ */
+export declare function salt(): number;
+/**
+ * Converts a positive integer to the smallest possible
+ * representation in a binary digit representation
+ * @param value - Value to encode
+ * @returns Encoded number
+ */
+export declare function encodeUnsigned(value: number): Buffer;
+/**
+ * Calculate 256bits Blake2b hash of `input`
+ * @param input - Data to hash
+ * @returns Hash
+ */
+export declare function hash(input: Data): Buffer;
+/**
+ * Compute contract address
+ * @param owner - Address of contract owner
+ * @param nonce - Round when contract was created
+ * @returns Contract address
+ */
+export declare function encodeContractAddress(owner: EncodedData<'ak'>, nonce: number): EncodedData<'ct'>;
+/**
+ * Generate keyPair from secret key
+ * @param secret - secret key
+ * @returns Object with Private(privateKey) and Public(publicKey) keys
+ */
+export declare function generateKeyPairFromSecret(secret: Uint8Array): SignKeyPair;
+/**
+ * Generate a random ED25519 keypair
+ * @param raw - Whether to return raw (binary) keys
+ * @returns Key pair
+ */
+export declare function generateKeyPair(raw: true): {
+    publicKey: Buffer;
+    secretKey: Buffer;
+};
+export declare function generateKeyPair(raw?: false): {
+    publicKey: EncodedData<'ak'>;
+    secretKey: string;
+};
+/**
+ * Encrypt given data using `password`
+ * @param password - Password to encrypt with
+ * @param binaryData - Data to encrypt
+ * @returns Encrypted data
+ */
+export declare function encryptKey(password: string, binaryData: Uint8Array): Uint8Array;
+/**
+ * Decrypt given data using `password`
+ * @param password - Password to decrypt with
+ * @param encrypted - Data to decrypt
+ * @returns Decrypted data
+ */
+export declare function decryptKey(password: string, encrypted: Uint8Array): Uint8Array;
+/**
+ * Generate signature
+ * @param data - Data to sign
+ * @param privateKey - Key to sign with
+ * @returns Signature
+ */
+export declare function sign(data: string | Uint8Array, privateKey: string | Uint8Array): Uint8Array;
+/**
+ * Verify that signature was signed by public key
+ * @param data - Data to verify
+ * @param signature - Signature to verify
+ * @param publicKey - Key to verify against
+ * @returns Valid?
+ */
+export declare function verify(data: Uint8Array, signature: Uint8Array, publicKey: string | Uint8Array): boolean;
+export declare function messageToHash(message: string): Buffer;
+export declare function signMessage(message: string, privateKey: string | Buffer): Uint8Array;
+export declare function verifyMessage(str: string, signature: Uint8Array, publicKey: string | Uint8Array): boolean;
+/**
+ * Check key pair for validity
+ *
+ * Sign a message, and then verifying that signature
+ * @param privateKey - Private key to verify
+ * @param publicKey - Public key to verify
+ * @returns Valid?
+ */
+export declare function isValidKeypair(privateKey: string | Uint8Array, publicKey: string | Uint8Array): boolean;

package/es/utils/crypto.mjs

@@ -0,0 +1,221 @@
+import _buffer from "buffer";
+const {
+  Buffer: _Buffer
+} = _buffer;
+
+/*
+ * ISC License (ISC)
+ * Copyright 2018 aeternity developers
+ *
+ *  Permission to use, copy, modify, and/or distribute this software for any
+ *  purpose with or without fee is hereby granted, provided that the above
+ *  copyright notice and this permission notice appear in all copies.
+ *
+ *  THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+ *  REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+ *  AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+ *  INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+ *  LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+ *  OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+ *  PERFORMANCE OF THIS SOFTWARE.
+ */
+import nacl from 'tweetnacl';
+import aesjs from 'aes-js';
+import _blakejs from 'blakejs';
+const {
+  blake2b
+} = _blakejs;
+import _varuintBitcoin from 'varuint-bitcoin';
+const {
+  encode: varuintEncode
+} = _varuintBitcoin;
+import { str2buf } from "./bytes.mjs";
+import { concatBuffers } from "./other.mjs";
+import { encode, decode, sha256hash } from "./encoder.mjs";
+export { sha256hash };
+const Ecb = aesjs.ModeOfOperation.ecb;
+/**
+ * Generate address from secret key
+ * @param secret - Private key
+ * @returns Public key encoded as address
+ */
+
+export function getAddressFromPriv(secret) {
+  const secretBuffer = typeof secret === 'string' ? str2buf(secret) : secret;
+  const keys = nacl.sign.keyPair.fromSecretKey(secretBuffer);
+  return encode(keys.publicKey, 'ak');
+}
+/**
+ * Check if address is valid
+ * @param address - Address
+ * @param prefix - Transaction prefix. Default: 'ak'
+ * @returns is valid
+ */
+
+export function isAddressValid(address) {
+  let prefix = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 'ak';
+
+  try {
+    decode(address);
+    return true;
+  } catch (e) {
+    return false;
+  }
+}
+/**
+ * Generate a random salt (positive integer)
+ * @returns random salt
+ */
+
+export function salt() {
+  return Math.floor(Math.random() * Math.floor(Number.MAX_SAFE_INTEGER));
+}
+/**
+ * Converts a positive integer to the smallest possible
+ * representation in a binary digit representation
+ * @param value - Value to encode
+ * @returns Encoded number
+ */
+
+export function encodeUnsigned(value) {
+  const binary = _Buffer.allocUnsafe(4);
+
+  binary.writeUInt32BE(value);
+  return binary.slice(binary.findIndex(i => i !== 0));
+}
+/**
+ * Calculate 256bits Blake2b hash of `input`
+ * @param input - Data to hash
+ * @returns Hash
+ */
+
+export function hash(input) {
+  return _Buffer.from(blake2b(input, undefined, 32)); // 256 bits
+} // Todo Duplicated in tx builder. remove
+
+/**
+ * Compute contract address
+ * @param owner - Address of contract owner
+ * @param nonce - Round when contract was created
+ * @returns Contract address
+ */
+
+export function encodeContractAddress(owner, nonce) {
+  const publicKey = decode(owner);
+  const binary = concatBuffers([publicKey, encodeUnsigned(nonce)]);
+  return encode(hash(binary), 'ct');
+} // KEY-PAIR HELPERS
+
+/**
+ * Generate keyPair from secret key
+ * @param secret - secret key
+ * @returns Object with Private(privateKey) and Public(publicKey) keys
+ */
+
+export function generateKeyPairFromSecret(secret) {
+  return nacl.sign.keyPair.fromSecretKey(secret);
+}
+/**
+ * Generate a random ED25519 keypair
+ * @param raw - Whether to return raw (binary) keys
+ * @returns Key pair
+ */
+
+export function generateKeyPair() {
+  let raw = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : false;
+  const keyPair = nacl.sign.keyPair();
+
+  const publicBuffer = _Buffer.from(keyPair.publicKey);
+
+  const secretBuffer = _Buffer.from(keyPair.secretKey);
+
+  if (raw) {
+    return {
+      publicKey: publicBuffer,
+      secretKey: secretBuffer
+    };
+  } else {
+    return {
+      publicKey: encode(publicBuffer, 'ak'),
+      secretKey: secretBuffer.toString('hex')
+    };
+  }
+}
+/**
+ * Encrypt given data using `password`
+ * @param password - Password to encrypt with
+ * @param binaryData - Data to encrypt
+ * @returns Encrypted data
+ */
+
+export function encryptKey(password, binaryData) {
+  const hashedPasswordBytes = sha256hash(password);
+  const aesEcb = new Ecb(hashedPasswordBytes);
+  return aesEcb.encrypt(binaryData);
+}
+/**
+ * Decrypt given data using `password`
+ * @param password - Password to decrypt with
+ * @param encrypted - Data to decrypt
+ * @returns Decrypted data
+ */
+
+export function decryptKey(password, encrypted) {
+  const encryptedBytes = _Buffer.from(encrypted);
+
+  const hashedPasswordBytes = sha256hash(password);
+  const aesEcb = new Ecb(hashedPasswordBytes);
+  return aesEcb.decrypt(encryptedBytes);
+} // SIGNATURES
+
+/**
+ * Generate signature
+ * @param data - Data to sign
+ * @param privateKey - Key to sign with
+ * @returns Signature
+ */
+
+export function sign(data, privateKey) {
+  return nacl.sign.detached(_Buffer.from(data), _Buffer.from(privateKey));
+}
+/**
+ * Verify that signature was signed by public key
+ * @param data - Data to verify
+ * @param signature - Signature to verify
+ * @param publicKey - Key to verify against
+ * @returns Valid?
+ */
+
+export function verify(data, signature, publicKey) {
+  const publicKeyBuffer = typeof publicKey === 'string' ? str2buf(publicKey) : publicKey;
+  return nacl.sign.detached.verify(data, signature, publicKeyBuffer);
+}
+export function messageToHash(message) {
+  const p = _Buffer.from('aeternity Signed Message:\n', 'utf8');
+
+  const msg = _Buffer.from(message, 'utf8');
+
+  return hash(concatBuffers([varuintEncode(p.length), p, varuintEncode(msg.length), msg]));
+}
+export function signMessage(message, privateKey) {
+  return sign(messageToHash(message), privateKey);
+}
+export function verifyMessage(str, signature, publicKey) {
+  return verify(messageToHash(str), signature, publicKey);
+}
+/**
+ * Check key pair for validity
+ *
+ * Sign a message, and then verifying that signature
+ * @param privateKey - Private key to verify
+ * @param publicKey - Public key to verify
+ * @returns Valid?
+ */
+
+export function isValidKeypair(privateKey, publicKey) {
+  const message = _Buffer.from('TheMessage');
+
+  const signature = sign(message, privateKey);
+  return verify(message, signature, publicKey);
+}
+//# sourceMappingURL=crypto.mjs.map

package/es/utils/crypto.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.mjs","names":["nacl","aesjs","str2buf","concatBuffers","encode","decode","sha256hash","Ecb","ModeOfOperation","ecb","getAddressFromPriv","secret","secretBuffer","keys","sign","keyPair","fromSecretKey","publicKey","isAddressValid","address","prefix","e","salt","Math","floor","random","Number","MAX_SAFE_INTEGER","encodeUnsigned","value","binary","allocUnsafe","writeUInt32BE","slice","findIndex","i","hash","input","from","blake2b","undefined","encodeContractAddress","owner","nonce","generateKeyPairFromSecret","generateKeyPair","raw","publicBuffer","secretKey","toString","encryptKey","password","binaryData","hashedPasswordBytes","aesEcb","encrypt","decryptKey","encrypted","encryptedBytes","decrypt","data","privateKey","detached","verify","signature","publicKeyBuffer","messageToHash","message","p","msg","varuintEncode","length","signMessage","verifyMessage","str","isValidKeypair"],"sources":["../../src/utils/crypto.ts"],"sourcesContent":["/*\n * ISC License (ISC)\n * Copyright 2018 aeternity developers\n *\n *  Permission to use, copy, modify, and/or distribute this software for any\n *  purpose with or without fee is hereby granted, provided that the above\n *  copyright notice and this permission notice appear in all copies.\n *\n *  THE SOFTWARE IS PROVIDED \"AS IS\" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH\n *  REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY\n *  AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,\n *  INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM\n *  LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR\n *  OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR\n *  PERFORMANCE OF THIS SOFTWARE.\n */\nimport nacl, { SignKeyPair } from 'tweetnacl'\nimport aesjs from 'aes-js'\nimport { blake2b, Data } from 'blakejs'\nimport { encode as varuintEncode } from 'varuint-bitcoin'\n\nimport { str2buf } from './bytes'\nimport { concatBuffers } from './other'\nimport { encode, decode, sha256hash, EncodedData, EncodingType } from './encoder'\n\nexport { sha256hash }\n\nconst Ecb = aesjs.ModeOfOperation.ecb\n\n/**\n * Generate address from secret key\n * @param secret - Private key\n * @returns Public key encoded as address\n */\nexport function getAddressFromPriv (secret: string | Uint8Array): EncodedData<'ak'> {\n  const secretBuffer = typeof secret === 'string' ? str2buf(secret) : secret\n  const keys = nacl.sign.keyPair.fromSecretKey(secretBuffer)\n  return encode(keys.publicKey, 'ak')\n}\n\n/**\n * Check if address is valid\n * @param address - Address\n * @param prefix - Transaction prefix. Default: 'ak'\n * @returns is valid\n */\nexport function isAddressValid (address: string, prefix: EncodingType = 'ak'): boolean {\n  try {\n    decode(address as EncodedData<typeof prefix>)\n    return true\n  } catch (e) {\n    return false\n  }\n}\n\n/**\n * Generate a random salt (positive integer)\n * @returns random salt\n */\nexport function salt (): number {\n  return Math.floor(Math.random() * Math.floor(Number.MAX_SAFE_INTEGER))\n}\n\n/**\n * Converts a positive integer to the smallest possible\n * representation in a binary digit representation\n * @param value - Value to encode\n * @returns Encoded number\n */\nexport function encodeUnsigned (value: number): Buffer {\n  const binary = Buffer.allocUnsafe(4)\n  binary.writeUInt32BE(value)\n  return binary.slice(binary.findIndex(i => i !== 0))\n}\n\n/**\n * Calculate 256bits Blake2b hash of `input`\n * @param input - Data to hash\n * @returns Hash\n */\nexport function hash (input: Data): Buffer {\n  return Buffer.from(blake2b(input, undefined, 32)) // 256 bits\n}\n\n// Todo Duplicated in tx builder. remove\n/**\n * Compute contract address\n * @param owner - Address of contract owner\n * @param nonce - Round when contract was created\n * @returns Contract address\n */\nexport function encodeContractAddress (owner: EncodedData<'ak'>, nonce: number): EncodedData<'ct'> {\n  const publicKey = decode(owner)\n  const binary = concatBuffers([publicKey, encodeUnsigned(nonce)])\n  return encode(hash(binary), 'ct')\n}\n\n// KEY-PAIR HELPERS\n\n/**\n * Generate keyPair from secret key\n * @param secret - secret key\n * @returns Object with Private(privateKey) and Public(publicKey) keys\n */\nexport function generateKeyPairFromSecret (secret: Uint8Array): SignKeyPair {\n  return nacl.sign.keyPair.fromSecretKey(secret)\n}\n\n/**\n * Generate a random ED25519 keypair\n * @param raw - Whether to return raw (binary) keys\n * @returns Key pair\n */\nexport function generateKeyPair (raw: true): { publicKey: Buffer, secretKey: Buffer }\nexport function generateKeyPair (raw?: false): { publicKey: EncodedData<'ak'>, secretKey: string }\nexport function generateKeyPair (raw: boolean = false): {\n  publicKey: EncodedData<'ak'> | Buffer\n  secretKey: string | Buffer\n} {\n  const keyPair = nacl.sign.keyPair()\n  const publicBuffer = Buffer.from(keyPair.publicKey)\n  const secretBuffer = Buffer.from(keyPair.secretKey)\n\n  if (raw) {\n    return {\n      publicKey: publicBuffer,\n      secretKey: secretBuffer\n    }\n  } else {\n    return {\n      publicKey: encode(publicBuffer, 'ak'),\n      secretKey: secretBuffer.toString('hex')\n    }\n  }\n}\n\n/**\n * Encrypt given data using `password`\n * @param password - Password to encrypt with\n * @param binaryData - Data to encrypt\n * @returns Encrypted data\n */\nexport function encryptKey (password: string, binaryData: Uint8Array): Uint8Array {\n  const hashedPasswordBytes = sha256hash(password)\n  const aesEcb = new Ecb(hashedPasswordBytes)\n  return aesEcb.encrypt(binaryData)\n}\n\n/**\n * Decrypt given data using `password`\n * @param password - Password to decrypt with\n * @param encrypted - Data to decrypt\n * @returns Decrypted data\n */\nexport function decryptKey (password: string, encrypted: Uint8Array): Uint8Array {\n  const encryptedBytes = Buffer.from(encrypted)\n  const hashedPasswordBytes = sha256hash(password)\n  const aesEcb = new Ecb(hashedPasswordBytes)\n  return aesEcb.decrypt(encryptedBytes)\n}\n\n// SIGNATURES\n\n/**\n * Generate signature\n * @param data - Data to sign\n * @param privateKey - Key to sign with\n * @returns Signature\n */\nexport function sign (data: string | Uint8Array, privateKey: string | Uint8Array): Uint8Array {\n  return nacl.sign.detached(Buffer.from(data), Buffer.from(privateKey))\n}\n\n/**\n * Verify that signature was signed by public key\n * @param data - Data to verify\n * @param signature - Signature to verify\n * @param publicKey - Key to verify against\n * @returns Valid?\n */\nexport function verify (\n  data: Uint8Array, signature: Uint8Array, publicKey: string | Uint8Array\n): boolean {\n  const publicKeyBuffer = typeof publicKey === 'string' ? str2buf(publicKey) : publicKey\n  return nacl.sign.detached.verify(data, signature, publicKeyBuffer)\n}\n\nexport function messageToHash (message: string): Buffer {\n  const p = Buffer.from('aeternity Signed Message:\\n', 'utf8')\n  const msg = Buffer.from(message, 'utf8')\n  return hash(concatBuffers([varuintEncode(p.length), p, varuintEncode(msg.length), msg]))\n}\n\nexport function signMessage (message: string, privateKey: string | Buffer): Uint8Array {\n  return sign(messageToHash(message), privateKey)\n}\n\nexport function verifyMessage (\n  str: string, signature: Uint8Array, publicKey: string | Uint8Array): boolean {\n  return verify(messageToHash(str), signature, publicKey)\n}\n\n/**\n * Check key pair for validity\n *\n * Sign a message, and then verifying that signature\n * @param privateKey - Private key to verify\n * @param publicKey - Public key to verify\n * @returns Valid?\n */\nexport function isValidKeypair (\n  privateKey: string | Uint8Array, publicKey: string | Uint8Array\n): boolean {\n  const message = Buffer.from('TheMessage')\n  const signature = sign(message, privateKey)\n  return verify(message, signature, publicKey)\n}\n"],"mappings":"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"}

package/es/utils/encoder.d.ts

@@ -0,0 +1,26 @@
+/// <reference types="node" />
+/**
+ * Calculate SHA256 hash of `input`
+ * @param input - Data to hash
+ * @returns Hash
+ */
+export declare function sha256hash(input: Uint8Array | string): Buffer;
+declare const base64Types: readonly ["ba", "cb", "or", "ov", "pi", "ss", "cs", "ck", "cv", "st", "tx"];
+declare const base58Types: readonly ["ak", "bf", "bs", "bx", "ch", "cm", "ct", "kh", "mh", "nm", "ok", "oq", "pp", "sg", "th"];
+export declare type EncodingType = typeof base64Types[number] | typeof base58Types[number];
+export declare type EncodedData<Type extends EncodingType> = `${Type}_${string}`;
+/**
+ * Decode data using the default encoding/decoding algorithm
+ * @param data - An Base58/64check encoded and prefixed string
+ * (ex tx_..., sg_..., ak_....)
+ * @returns Decoded data
+ */
+export declare function decode(data: EncodedData<EncodingType>): Buffer;
+/**
+ * Encode data using the default encoding/decoding algorithm
+ * @param data - An decoded data
+ * @param type - Prefix of Transaction
+ * @returns Encoded string Base58check or Base64check data
+ */
+export declare function encode<Type extends EncodingType>(data: Uint8Array, type: Type): EncodedData<Type>;
+export {};

package/es/utils/encoder.mjs

@@ -0,0 +1,102 @@
+import _buffer from "buffer";
+const {
+  Buffer: _Buffer
+} = _buffer;
+import _bs from 'bs58';
+const {
+  encode: bs58Encode,
+  decode: bs58Decode
+} = _bs;
+import _shaJs from 'sha.js';
+const {
+  sha256: Sha256
+} = _shaJs;
+import { DecodeError, ArgumentError, InvalidChecksumError, PayloadLengthError } from "./errors.mjs";
+import { concatBuffers } from "./other.mjs";
+/**
+ * Calculate SHA256 hash of `input`
+ * @param input - Data to hash
+ * @returns Hash
+ */
+
+export function sha256hash(input) {
+  return new Sha256().update(input).digest();
+} // based on https://github.com/aeternity/protocol/blob/master/node/api/api_encoding.md
+
+const base64Types = ['ba', 'cb', 'or', 'ov', 'pi', 'ss', 'cs', 'ck', 'cv', 'st', 'tx'];
+const base58Types = ['ak', 'bf', 'bs', 'bx', 'ch', 'cm', 'ct', 'kh', 'mh', 'nm', 'ok', 'oq', 'pp', 'sg', 'th'];
+// TODO: add all types with a fixed length
+const typesLength = {
+  ak: 32,
+  ct: 32,
+  ok: 32
+};
+
+function ensureValidLength(data, type) {
+  const reqLen = typesLength[type];
+  if (reqLen == null || data.length === reqLen) return;
+  throw new PayloadLengthError(`Payload should be ${reqLen} bytes, got ${data.length} instead`);
+}
+
+const getChecksum = payload => sha256hash(sha256hash(payload)).slice(0, 4);
+
+const addChecksum = payload => {
+  return concatBuffers([payload, getChecksum(payload)]);
+};
+
+function getPayload(buffer) {
+  const payload = buffer.slice(0, -4);
+  if (!getChecksum(payload).equals(buffer.slice(-4))) throw new InvalidChecksumError();
+  return payload;
+}
+
+const base64 = {
+  encode: buffer => addChecksum(buffer).toString('base64'),
+  decode: string => getPayload(_Buffer.from(string, 'base64'))
+};
+const base58 = {
+  encode: buffer => bs58Encode(addChecksum(buffer)),
+  decode: string => getPayload(_Buffer.from(bs58Decode(string)))
+};
+
+const parseType = maybeType => {
+  const base64Type = base64Types.find(t => t === maybeType);
+  if (base64Type != null) return [base64Type, base64];
+  const base58Type = base58Types.find(t => t === maybeType);
+  if (base58Type != null) return [base58Type, base58];
+  throw new ArgumentError('prefix', `one of ${[...base58Types, ...base64Types].join(', ')}`, maybeType);
+};
+/**
+ * Decode data using the default encoding/decoding algorithm
+ * @param data - An Base58/64check encoded and prefixed string
+ * (ex tx_..., sg_..., ak_....)
+ * @returns Decoded data
+ */
+
+
+export function decode(data) {
+  const [prefix, encodedPayload, extra] = data.split('_');
+  if (encodedPayload == null) throw new DecodeError(`Encoded string missing payload: ${data}`);
+  if (extra != null) throw new DecodeError(`Encoded string have extra parts: ${data}`);
+  const [type, {
+    decode
+  }] = parseType(prefix);
+  const payload = decode(encodedPayload);
+  ensureValidLength(payload, type);
+  return payload;
+}
+/**
+ * Encode data using the default encoding/decoding algorithm
+ * @param data - An decoded data
+ * @param type - Prefix of Transaction
+ * @returns Encoded string Base58check or Base64check data
+ */
+
+export function encode(data, type) {
+  const [, {
+    encode
+  }] = parseType(type);
+  ensureValidLength(data, type);
+  return `${type}_${encode(data)}`;
+}
+//# sourceMappingURL=encoder.mjs.map

package/es/utils/encoder.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoder.mjs","names":["DecodeError","ArgumentError","InvalidChecksumError","PayloadLengthError","concatBuffers","sha256hash","input","Sha256","update","digest","base64Types","base58Types","typesLength","ak","ct","ok","ensureValidLength","data","type","reqLen","length","getChecksum","payload","slice","addChecksum","getPayload","buffer","equals","base64","encode","toString","decode","string","from","base58","bs58Encode","bs58Decode","parseType","maybeType","base64Type","find","t","base58Type","join","prefix","encodedPayload","extra","split"],"sources":["../../src/utils/encoder.ts"],"sourcesContent":["import { encode as bs58Encode, decode as bs58Decode } from 'bs58'\nimport { sha256 as Sha256 } from 'sha.js'\nimport {\n  DecodeError,\n  ArgumentError,\n  InvalidChecksumError,\n  PayloadLengthError\n} from './errors'\nimport { concatBuffers } from './other'\n\n/**\n * Calculate SHA256 hash of `input`\n * @param input - Data to hash\n * @returns Hash\n */\nexport function sha256hash (input: Uint8Array | string): Buffer {\n  return new Sha256().update(input).digest()\n}\n\n// based on https://github.com/aeternity/protocol/blob/master/node/api/api_encoding.md\nconst base64Types = ['ba', 'cb', 'or', 'ov', 'pi', 'ss', 'cs', 'ck', 'cv', 'st', 'tx'] as const\nconst base58Types = ['ak', 'bf', 'bs', 'bx', 'ch', 'cm', 'ct', 'kh', 'mh', 'nm', 'ok', 'oq', 'pp', 'sg', 'th'] as const\n\nexport type EncodingType = typeof base64Types[number] | typeof base58Types[number]\nexport type EncodedData<Type extends EncodingType> = `${Type}_${string}`\n// TODO: add all types with a fixed length\nconst typesLength: { [name in EncodingType]?: number } = {\n  ak: 32,\n  ct: 32,\n  ok: 32\n} as const\n\nfunction ensureValidLength (data: Uint8Array, type: EncodingType): void {\n  const reqLen = typesLength[type]\n  if (reqLen == null || data.length === reqLen) return\n  throw new PayloadLengthError(`Payload should be ${reqLen} bytes, got ${data.length} instead`)\n}\n\nconst getChecksum = (payload: Uint8Array): Buffer =>\n  sha256hash(sha256hash(payload)).slice(0, 4)\n\nconst addChecksum = (payload: Uint8Array): Buffer => {\n  return concatBuffers([payload, getChecksum(payload)])\n}\n\nfunction getPayload (buffer: Buffer): Buffer {\n  const payload = buffer.slice(0, -4)\n  if (!getChecksum(payload).equals(buffer.slice(-4))) throw new InvalidChecksumError()\n  return payload\n}\n\nconst base64 = {\n  encode: (buffer: Uint8Array) => addChecksum(buffer).toString('base64'),\n  decode: (string: string) => getPayload(Buffer.from(string, 'base64'))\n}\n\nconst base58 = {\n  encode: (buffer: Uint8Array) => bs58Encode(addChecksum(buffer)),\n  decode: (string: string) => getPayload(Buffer.from(bs58Decode(string)))\n}\n\nconst parseType = (maybeType: unknown): [EncodingType, typeof base64] => {\n  const base64Type = base64Types.find(t => t === maybeType)\n  if (base64Type != null) return [base64Type, base64]\n  const base58Type = base58Types.find(t => t === maybeType)\n  if (base58Type != null) return [base58Type, base58]\n  throw new ArgumentError('prefix', `one of ${[...base58Types, ...base64Types].join(', ')}`, maybeType)\n}\n\n/**\n * Decode data using the default encoding/decoding algorithm\n * @param data - An Base58/64check encoded and prefixed string\n * (ex tx_..., sg_..., ak_....)\n * @returns Decoded data\n */\nexport function decode (data: EncodedData<EncodingType>): Buffer {\n  const [prefix, encodedPayload, extra] = data.split('_')\n  if (encodedPayload == null) throw new DecodeError(`Encoded string missing payload: ${data}`)\n  if (extra != null) throw new DecodeError(`Encoded string have extra parts: ${data}`)\n  const [type, { decode }] = parseType(prefix)\n  const payload = decode(encodedPayload)\n  ensureValidLength(payload, type)\n  return payload\n}\n\n/**\n * Encode data using the default encoding/decoding algorithm\n * @param data - An decoded data\n * @param type - Prefix of Transaction\n * @returns Encoded string Base58check or Base64check data\n */\nexport function encode<Type extends EncodingType> (\n  data: Uint8Array, type: Type\n): EncodedData<Type> {\n  const [, { encode }] = parseType(type)\n  ensureValidLength(data, type)\n  return `${type}_${encode(data)}`\n}\n"],"mappings":"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"}