@noble/hashes 2.3.0: sha512

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.sha512 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.sha512

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:57e5d98f4c0a98df7288aa0ccdfa3227053dfb6299b5499014d361034d9fe72a","contract":["sha512 computes a 64-byte (512-bit) digest for Uint8Array message input matching the standard test vector","sha512 correctly computes the 64-byte SHA-512 digest for empty input","sha512 supports incremental hashing via create() updating with multiple Uint8Array chunks","sha512 hasher instances support clone() preserving intermediate state for independent digest streams","sha512 exposes outputLen of 64 and blockLen of 128 bytes","sha512 supports writing directly into a preallocated Uint8Array output buffer via digestInto","sha512 rejects non-Uint8Array inputs by throwing TypeError","sha512 marks hasher instance as destroyed after digest() rejecting subsequent update or digest calls"],"goal":"verify @noble/hashes.sha512 in pkg:npm/%40noble/hashes@2.3.0","kind":"HOW","packages":["pkg:npm/%40noble/hashes@2.3.0"],"schemaVersion":1,"symbols":["@noble/hashes.sha512"]},"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.sha512"],"verifierAdapter":"node-typescript@1"}

{
  "name": "sample-noble-hashes-sha512",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "sample-noble-hashes-sha512",
      "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-sha512",
  "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.sha512 in pkg:npm/%40noble/hashes@2.3.0",
  "kind": "HOW",
  "packages": [
    "pkg:npm/%40noble/hashes@2.3.0"
  ],
  "symbols": [
    "@noble/hashes.sha512"
  ]
}

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

/**
 * Computes the SHA-512 digest for a Uint8Array message.
 *
 * @param {Uint8Array} message - Byte array to hash
 * @returns {Uint8Array} 64-byte SHA-512 digest
 */
export function hashSha512(message) {
  return sha512(message);
}

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

export { sha512 };
export default sha512;

import assert from 'node:assert/strict';
import { sha512, hashSha512, createSha512Hasher } from '../src/index.mjs';

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

// 1. sha512 computes a 64-byte (512-bit) digest for Uint8Array message input matching the standard test vector
{
  const input = encoder.encode('abc');
  const digest = hashSha512(input);

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

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

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

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

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

  assert.equal(digest.length, 64);
  const expectedHex = 'ddaf35a193617abacc417349ae20413112e6fa4e89a97ea20a9eeee64b55d39a2192992a274fc1a836ba3c23a3feebbd454d4423643ce80e2a9ac94fa54ca49f';
  assert.equal(toHex(digest), expectedHex);
}

// 4. sha512 hasher instances support clone() preserving intermediate state for independent digest streams
{
  const baseHasher = sha512.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 = 'ddaf35a193617abacc417349ae20413112e6fa4e89a97ea20a9eeee64b55d39a2192992a274fc1a836ba3c23a3feebbd454d4423643ce80e2a9ac94fa54ca49f';
  assert.equal(toHex(digest1), expectedHex);
}

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

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

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

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

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

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

// 8. sha512 marks hasher instance as destroyed after digest() rejecting subsequent update or digest calls
{
  const hasher = sha512.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 = sha512.create();
  hasher2.destroy();
  assert.throws(() => hasher2.update(encoder.encode('data')), /hash was destroyed/);
}

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