@noble/hashes 2.3.0: sha384

audit=false

Clean-room public code sample — generation instructions

Write a brand-new, minimal, self-contained code sample in this clean-room directory.
Do not copy, paraphrase, or reference any existing project source. Work only from this spec.

A csx.json manifest scaffold already exists. Do not recreate it from memory. Preserve its case.goal, packages and symbols; fill its empty case.contract with exact assertions and correct its environment, commands and verifierAdapter for the files you generate.

Goal: verify @noble/hashes.sha384 in pkg:npm/%40noble/hashes@2.3.0
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:npm/%40noble/hashes@2.3.0
Demonstrate these symbols/APIs:
  - @noble/hashes.sha384

Rules:
  - One focused purpose; the smallest project that proves the goal.
  - Include a contract test (test/contract.*) that runs OFFLINE and exits 0 exactly when the goal behavior works.
  - Pin every dependency with a lockfile so resolution is reproducible.
  - No secrets, credentials, or tokens. No real URLs (only example.com or localhost). No absolute paths.
  - No personal names, emails, company names, or project identifiers of any kind.
  - No binaries and no generated output (node_modules, dist, target, venv, .git, .env).
  - Keep it under 200 files and 256KB packed.

{"case":{"caseId":"case:sha256:db3d3904de2f0aa4188221525f91543065b1ab76153aeec7a28c1c6720f46748","contract":["sha384 computes a 48-byte (384-bit) digest for Uint8Array message input matching the standard test vector","sha384 correctly computes the 48-byte SHA-384 digest for empty input","sha384 supports incremental hashing via create() updating with multiple Uint8Array chunks","sha384 hasher instances support clone() preserving intermediate state for independent digest streams","sha384 exposes outputLen of 48 and blockLen of 128 bytes","sha384 supports writing directly into a preallocated Uint8Array output buffer via digestInto","sha384 rejects non-Uint8Array inputs by throwing TypeError","sha384 marks hasher instance as destroyed after digest() rejecting subsequent update or digest calls"],"goal":"verify @noble/hashes.sha384 in pkg:npm/%40noble/hashes@2.3.0","kind":"HOW","packages":["pkg:npm/%40noble/hashes@2.3.0"],"schemaVersion":1,"symbols":["@noble/hashes.sha384"]},"contractCommand":["node","test/contract.mjs"],"environment":{"arch":"x64","distro":"ubuntu","ecosystem":"npm","executionContext":"node","language":"javascript","libc":"glibc","libcVersion":"2.39","moduleSystem":"esm","os":"linux","osVersionBucket":"24","packageManager":"npm","packageManagerVersion":"10.9.8","runtime":"node","runtimeVersion":"22.23.2","schemaVersion":1},"license":"MIT-0","packages":["pkg:npm/%40noble/hashes@2.3.0"],"schemaVersion":1,"subject":"pkg:npm/%40noble/hashes@2.3.0","symbols":["@noble/hashes.sha384"],"verifierAdapter":"node-typescript@1"}

{
  "name": "sample-noble-hashes-sha384",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "sample-noble-hashes-sha384",
      "version": "1.0.0",
      "license": "MIT-0",
      "dependencies": {
        "@noble/hashes": "2.3.0"
      }
    },
    "node_modules/@noble/hashes": {
      "version": "2.3.0",
      "resolved": "https://registry.npmjs.org/@noble/hashes/-/hashes-2.3.0.tgz",
      "integrity": "sha512-oN+QwyX7VSHotibwubG3kpzbwKrfnyR6OOO+3Nk/53ADL7FmgHHz4TgrbaYKvvOw09u6QTx0oiH1cNCIOuN0CQ==",
      "license": "MIT",
      "engines": {
        "node": ">= 20.19.0"
      },
      "funding": {
        "url": "https://paulmillr.com/funding/"
      }
    }
  }
}

{
  "name": "sample-noble-hashes-sha384",
  "version": "1.0.0",
  "private": true,
  "type": "module",
  "license": "MIT-0",
  "scripts": {
    "test": "node test/contract.mjs"
  },
  "dependencies": {
    "@noble/hashes": "2.3.0"
  }
}

{
  "schemaVersion": 1,
  "goal": "verify @noble/hashes.sha384 in pkg:npm/%40noble/hashes@2.3.0",
  "kind": "HOW",
  "packages": [
    "pkg:npm/%40noble/hashes@2.3.0"
  ],
  "symbols": [
    "@noble/hashes.sha384"
  ]
}

import { sha384 } from '@noble/hashes/sha2.js';

/**
 * Computes the SHA-384 digest for a Uint8Array message.
 *
 * @param {Uint8Array} message - Byte array to hash
 * @returns {Uint8Array} 48-byte SHA-384 digest
 */
export function hashSha384(message) {
  return sha384(message);
}

/**
 * Creates an incremental SHA-384 hasher instance.
 *
 * @returns {ReturnType<typeof sha384.create>} Hasher instance
 */
export function createSha384Hasher() {
  return sha384.create();
}

export { sha384 };
export default sha384;

import assert from 'node:assert/strict';
import { sha384, hashSha384, createSha384Hasher } from '../src/index.mjs';

const encoder = new TextEncoder();
const toHex = (arr) => Buffer.from(arr).toString('hex');

// 1. sha384 computes a 48-byte (384-bit) digest for Uint8Array message input matching the standard test vector
{
  const input = encoder.encode('abc');
  const digest = hashSha384(input);

  assert.equal(digest instanceof Uint8Array, true);
  assert.equal(digest.length, 48);

  const expectedHex = 'cb00753f45a35e8bb5a03d699ac65007272c32ab0eded1631a8b605a43ff5bed8086072ba1e7cc2358baeca134c825a7';
  assert.equal(toHex(digest), expectedHex);
}

// 2. sha384 correctly computes the 48-byte SHA-384 digest for empty input
{
  const emptyDigest = sha384(new Uint8Array(0));
  assert.equal(emptyDigest.length, 48);

  const expectedEmptyHex = '38b060a751ac96384cd9327eb1b1e36a21fdb71114be07434c0cc7bf63f6e1da274edebfe76f65fbd51ad2f14898b95b';
  assert.equal(toHex(emptyDigest), expectedEmptyHex);
}

// 3. sha384 supports incremental hashing via create() updating with multiple Uint8Array chunks
{
  const hasher = createSha384Hasher();
  hasher.update(encoder.encode('a'));
  hasher.update(encoder.encode('b'));
  hasher.update(encoder.encode('c'));
  const digest = hasher.digest();

  assert.equal(digest.length, 48);
  const expectedHex = 'cb00753f45a35e8bb5a03d699ac65007272c32ab0eded1631a8b605a43ff5bed8086072ba1e7cc2358baeca134c825a7';
  assert.equal(toHex(digest), expectedHex);
}

// 4. sha384 hasher instances support clone() preserving intermediate state for independent digest streams
{
  const baseHasher = sha384.create();
  baseHasher.update(encoder.encode('a'));

  const branch1 = baseHasher.clone();
  const branch2 = baseHasher.clone();

  branch1.update(encoder.encode('bc'));
  branch2.update(encoder.encode('bc'));

  const digest1 = branch1.digest();
  const digest2 = branch2.digest();

  assert.deepEqual(digest1, digest2);
  const expectedHex = 'cb00753f45a35e8bb5a03d699ac65007272c32ab0eded1631a8b605a43ff5bed8086072ba1e7cc2358baeca134c825a7';
  assert.equal(toHex(digest1), expectedHex);
}

// 5. sha384 exposes outputLen of 48 and blockLen of 128 bytes
{
  assert.equal(sha384.outputLen, 48);
  assert.equal(sha384.blockLen, 128);
}

// 6. sha384 supports writing directly into a preallocated Uint8Array output buffer via digestInto
{
  const hasher = sha384.create();
  hasher.update(encoder.encode('abc'));

  const outputBuffer = new Uint8Array(48);
  hasher.digestInto(outputBuffer);

  const expectedHex = 'cb00753f45a35e8bb5a03d699ac65007272c32ab0eded1631a8b605a43ff5bed8086072ba1e7cc2358baeca134c825a7';
  assert.equal(toHex(outputBuffer), expectedHex);
}

// 7. sha384 rejects non-Uint8Array inputs by throwing TypeError
{
  assert.throws(() => sha384('not bytes'), TypeError);
  assert.throws(() => sha384(123), TypeError);
  assert.throws(() => sha384(null), TypeError);

  const hasher = sha384.create();
  assert.throws(() => hasher.update('string chunk'), TypeError);
}

// 8. sha384 marks hasher instance as destroyed after digest() rejecting subsequent update or digest calls
{
  const hasher = sha384.create();
  hasher.update(encoder.encode('data'));
  hasher.digest();

  assert.throws(() => hasher.update(encoder.encode('more')), /hash was destroyed/);
  assert.throws(() => hasher.digest(), /hash was destroyed/);

  const hasher2 = sha384.create();
  hasher2.destroy();
  assert.throws(() => hasher2.update(encoder.encode('data')), /hash was destroyed/);
}

console.log('Contract tests passed successfully.');