/** * HMAC: RFC2104 message authentication code. * @module */ import { abytes, aexists, ahash, aoutput, clean, type CHash, type Hash, type TArg, type TRet, } from './utils.ts'; /** * Internal class for HMAC. * Accepts any byte key, although RFC 2104 ยง3 recommends keys at least * `HashLen` bytes long. */ export class _HMAC> implements Hash<_HMAC> { oHash: T; iHash: T; blockLen: number; outputLen: number; canXOF = false; private finished = false; private destroyed = false; constructor(hash: TArg, key: TArg) { ahash(hash); abytes(key, undefined, 'key'); this.iHash = hash.create() as T; if (typeof this.iHash.update !== 'function') throw new Error('Expected instance of class which extends utils.Hash'); this.blockLen = this.iHash.blockLen; this.outputLen = this.iHash.outputLen; const blockLen = this.blockLen; const pad = new Uint8Array(blockLen); // blockLen can be bigger than outputLen pad.set(key.length > blockLen ? hash.create().update(key).digest() : key); for (let i = 0; i < pad.length; i++) pad[i] ^= 0x36; this.iHash.update(pad); // By doing update (processing of the first block) of the outer hash here, // we can re-use it between multiple calls via clone. this.oHash = hash.create() as T; // Undo internal XOR && apply outer XOR for (let i = 0; i < pad.length; i++) pad[i] ^= 0x36 ^ 0x5c; this.oHash.update(pad); clean(pad); } update(buf: TArg): this { aexists(this); this.iHash.update(buf); return this; } digestInto(out: TArg): void { aexists(this); aoutput(out, this); this.finished = true; const buf = out.subarray(0, this.outputLen); // Reuse the first outputLen bytes for the inner digest; the outer hash consumes them before // overwriting that same prefix with the final tag, leaving any oversized tail untouched. this.iHash.digestInto(buf); this.oHash.update(buf); this.oHash.digestInto(buf); this.destroy(); } digest(): TRet { const out = new Uint8Array(this.oHash.outputLen); this.digestInto(out); return out as TRet; } _cloneInto(to?: _HMAC): _HMAC { // Create new instance without calling constructor since the key // is already in state and we don't know it. to ||= Object.create(Object.getPrototypeOf(this), {}); const { oHash, iHash, finished, destroyed, blockLen, outputLen } = this; to = to as this; to.finished = finished; to.destroyed = destroyed; to.blockLen = blockLen; to.outputLen = outputLen; to.oHash = oHash._cloneInto(to.oHash); to.iHash = iHash._cloneInto(to.iHash); return to; } clone(): _HMAC { return this._cloneInto(); } destroy(): void { this.destroyed = true; this.oHash.destroy(); this.iHash.destroy(); } } /** * HMAC: RFC2104 message authentication code. * @param hash - function that would be used e.g. sha256 * @param key - authentication key bytes * @param message - message bytes to authenticate * @returns Authentication tag bytes. * @example * Compute an RFC 2104 HMAC. * ```ts * import { hmac } from '@noble/hashes/hmac.js'; * import { sha256 } from '@noble/hashes/sha2.js'; * const mac = hmac(sha256, new Uint8Array([1, 2, 3]), new Uint8Array([4, 5, 6])); * ``` */ type HmacFn = { (hash: TArg, key: TArg, message: TArg): TRet; create(hash: TArg, key: TArg): TRet<_HMAC>; }; export const hmac: TRet = /* @__PURE__ */ (() => { const hmac_ = (( hash: TArg, key: TArg, message: TArg ): TRet => new _HMAC(hash, key).update(message).digest()) as TRet; hmac_.create = (hash: TArg, key: TArg): TRet<_HMAC> => new _HMAC(hash, key) as TRet<_HMAC>; return hmac_; })();