@mindpeeker/entropy 0.1.0

package/dist/providers/drand.js

@@ -0,0 +1,87 @@
+import { EntropyError } from '../errors.js';
+import { concatBytes, hexToBytes } from '../internal/bytes.js';
+import { fetchJson } from '../internal/http.js';
+import { defineProvider } from '../internal/provider.js';
+import { beaconStream } from '../internal/stream.js';
+const INFO = Object.freeze({
+    name: 'drand',
+    kind: 'beacon',
+    privacy: 'public',
+});
+const ROUND_BYTES = 32;
+const DEFAULT_BASE_URLS = ['https://api.drand.sh', 'https://api2.drand.sh', 'https://api3.drand.sh'];
+// quicknet emits a round every 3 seconds.
+const DEFAULT_POLL_INTERVAL_MS = 3000;
+/**
+ * drand / League of Entropy distributed randomness beacon (threshold BLS).
+ * PUBLIC randomness: everyone sees every round — never seed secrets from it
+ * alone; combine via `xorMix` with a private source for auditable secrets.
+ * Randomness is derived as SHA-256(signature), as specified for unchained
+ * beacons like quicknet.
+ */
+export function drand(opts = {}) {
+    const { baseUrls = DEFAULT_BASE_URLS, beacon = 'quicknet', pollIntervalMs = DEFAULT_POLL_INTERVAL_MS, fetch: fetchImpl, } = opts;
+    async function fetchRound(which, signal) {
+        let lastError;
+        for (const base of baseUrls) {
+            try {
+                const res = await fetchJson(`${base}/v2/beacons/${beacon}/rounds/${which}`, {
+                    provider: INFO.name,
+                    signal,
+                    fetchImpl,
+                });
+                const { round, signature } = res ?? {};
+                if (!Number.isInteger(round) || typeof signature !== 'string' || signature.length === 0) {
+                    throw new EntropyError('bad_response', 'malformed drand round', { provider: INFO.name });
+                }
+                return { round: round, signature };
+            }
+            catch (error) {
+                if (!(error instanceof EntropyError) || error.code === 'aborted')
+                    throw error;
+                lastError = error; // try the next mirror
+            }
+        }
+        throw lastError;
+    }
+    async function randomnessOf(signature) {
+        let sigBytes;
+        try {
+            sigBytes = hexToBytes(signature);
+        }
+        catch (error) {
+            throw new EntropyError('bad_response', 'invalid signature hex', {
+                provider: INFO.name,
+                cause: error,
+            });
+        }
+        return new Uint8Array(await crypto.subtle.digest('SHA-256', sigBytes));
+    }
+    return defineProvider({
+        ...INFO,
+        defaultChunkBytes: ROUND_BYTES,
+        async getBytes(length, reqOpts) {
+            const roundsNeeded = Math.ceil(length / ROUND_BYTES);
+            const latest = await fetchRound('latest', reqOpts?.signal);
+            const chunks = [await randomnessOf(latest.signature)];
+            // Past rounds are just as public as the latest one — walk backwards.
+            for (let i = 1; i < roundsNeeded; i++) {
+                const round = latest.round - i;
+                if (round < 1) {
+                    throw new EntropyError('insufficient_entropy', 'drand chain too short for request', {
+                        provider: INFO.name,
+                    });
+                }
+                chunks.push(await randomnessOf((await fetchRound(round, reqOpts?.signal)).signature));
+            }
+            return { bytes: concatBytes(chunks).slice(0, length), sources: [INFO] };
+        },
+        stream(streamOpts = {}) {
+            return beaconStream(async (signal) => {
+                const { round, signature } = await fetchRound('latest', signal);
+                return { id: round, bytes: await randomnessOf(signature) };
+            }, pollIntervalMs, ROUND_BYTES, INFO.name, streamOpts);
+        },
+    });
+}
+//# sourceMappingURL=drand.js.map

package/dist/providers/drand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drand.js","sourceRoot":"","sources":["../../src/providers/drand.ts"],"names":[],"mappings":"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"}

package/dist/providers/flow.d.ts

@@ -0,0 +1,15 @@
+import type { EntropyProvider } from '../types.js';
+export interface FlowBeaconOptions {
+    fetch?: typeof fetch;
+    baseUrl?: string;
+    /** Wait between retries when consecutive draws are identical. Default 1000. */
+    retryDelayMs?: number;
+}
+/**
+ * Flow protocol randomness via keyless script execution (`revertibleRandom`)
+ * on the public access node. PUBLIC crypto-beacon class: 8 bytes per call,
+ * re-derived per execution from Flow's DKG random beacon. Rate limits apply
+ * on the public node.
+ */
+export declare function flowBeacon(opts?: FlowBeaconOptions): EntropyProvider;
+//# sourceMappingURL=flow.d.ts.map

package/dist/providers/flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow.d.ts","sourceRoot":"","sources":["../../src/providers/flow.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAqB,MAAM,aAAa,CAAA;AASrE,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,+EAA+E;IAC/E,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,GAAE,iBAAsB,GAAG,eAAe,CAoExE"}

package/dist/providers/flow.js

@@ -0,0 +1,82 @@
+import { EntropyError } from '../errors.js';
+import { base64ToBytes, concatBytes } from '../internal/bytes.js';
+import { fetchJson } from '../internal/http.js';
+import { defineProvider } from '../internal/provider.js';
+import { sleep } from '../internal/rate-limit.js';
+const INFO = Object.freeze({ name: 'flow', kind: 'beacon', privacy: 'public' });
+const DRAW_BYTES = 8;
+const DEFAULT_BASE_URL = 'https://rest-mainnet.onflow.org';
+const CADENCE_SCRIPT = 'access(all) fun main(): UInt64 { return revertibleRandom<UInt64>() }';
+const SCRIPT_B64 = btoa(CADENCE_SCRIPT);
+/**
+ * Flow protocol randomness via keyless script execution (`revertibleRandom`)
+ * on the public access node. PUBLIC crypto-beacon class: 8 bytes per call,
+ * re-derived per execution from Flow's DKG random beacon. Rate limits apply
+ * on the public node.
+ */
+export function flowBeacon(opts = {}) {
+    const { baseUrl = DEFAULT_BASE_URL, retryDelayMs = 1000, fetch: fetchImpl } = opts;
+    async function fetchDraw(signal) {
+        // The response is DOUBLE-encoded: a JSON string containing base64 of a
+        // JSON-Cadence value (plus a trailing newline).
+        const outer = await fetchJson(`${baseUrl}/v1/scripts?block_height=sealed`, {
+            provider: INFO.name,
+            method: 'POST',
+            body: { script: SCRIPT_B64, arguments: [] },
+            signal,
+            fetchImpl,
+        });
+        if (typeof outer !== 'string') {
+            throw new EntropyError('bad_response', 'expected a base64 script result', {
+                provider: INFO.name,
+            });
+        }
+        try {
+            const inner = new TextDecoder().decode(base64ToBytes(outer)).trim();
+            const cadence = JSON.parse(inner);
+            if (cadence.type !== 'UInt64' || typeof cadence.value !== 'string') {
+                throw new Error(`unexpected Cadence value of type ${cadence.type}`);
+            }
+            return BigInt(cadence.value);
+        }
+        catch (error) {
+            if (error instanceof EntropyError)
+                throw error;
+            throw new EntropyError('bad_response', 'malformed JSON-Cadence payload', {
+                provider: INFO.name,
+                cause: error,
+            });
+        }
+    }
+    function drawToBytes(value) {
+        const out = new Uint8Array(DRAW_BYTES);
+        for (let i = 0; i < DRAW_BYTES; i++) {
+            out[i] = Number((value >> BigInt(8 * (DRAW_BYTES - 1 - i))) & 0xffn);
+        }
+        return out;
+    }
+    let lastDraw = null;
+    async function nextFreshDraw(signal) {
+        while (true) {
+            const draw = await fetchDraw(signal);
+            if (draw !== lastDraw) {
+                lastDraw = draw;
+                return draw;
+            }
+            // identical consecutive draws — likely the same sealed block; wait it out
+            await sleep(retryDelayMs, signal);
+        }
+    }
+    return defineProvider({
+        ...INFO,
+        defaultChunkBytes: DRAW_BYTES,
+        async getBytes(length, reqOpts) {
+            const chunks = [];
+            for (let collected = 0; collected < length; collected += DRAW_BYTES) {
+                chunks.push(drawToBytes(await nextFreshDraw(reqOpts?.signal)));
+            }
+            return { bytes: concatBytes(chunks).slice(0, length), sources: [INFO] };
+        },
+    });
+}
+//# sourceMappingURL=flow.js.map

package/dist/providers/flow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow.js","sourceRoot":"","sources":["../../src/providers/flow.ts"],"names":[],"mappings":"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"}

package/dist/providers/index.d.ts

@@ -0,0 +1,56 @@
+export type { AnuOptions } from './anu.js';
+export { anu } from './anu.js';
+export type { AnuLegacyOptions } from './anu-legacy.js';
+export { anuLegacy } from './anu-legacy.js';
+export type { BitcoinBeaconOptions } from './bitcoin.js';
+export { bitcoinBeacon } from './bitcoin.js';
+export type { CameraOptions, Frame, FrameSource } from './camera.js';
+export { cameraEntropy, lsbBits, signBits } from './camera.js';
+export { cryptoProvider } from './crypto.js';
+export type { CurbyOptions } from './curby.js';
+export { curby } from './curby.js';
+export type { DrandOptions } from './drand.js';
+export { drand } from './drand.js';
+export type { FlowBeaconOptions } from './flow.js';
+export { flowBeacon } from './flow.js';
+export type { InmetroOptions, InmetroVariant } from './inmetro.js';
+export { inmetro } from './inmetro.js';
+export type { JitterOptions } from './jitter.js';
+export { jitterEntropy } from './jitter.js';
+export type { LfdrOptions } from './lfdr.js';
+export { lfdr } from './lfdr.js';
+export type { MicrophoneOptions, SampleSource } from './microphone.js';
+export { micEntropy, sampleLsbBits } from './microphone.js';
+export type { NistBeaconOptions } from './nist-beacon.js';
+export { nistBeacon } from './nist-beacon.js';
+export type { NqsnOptions } from './nqsn.js';
+export { nqsn } from './nqsn.js';
+export type { OutshiftOptions } from './outshift.js';
+export { outshift } from './outshift.js';
+export type { PadovaOptions } from './padova.js';
+export { padova } from './padova.js';
+export type { QbckOptions } from './qbck.js';
+export { qbck } from './qbck.js';
+export type { QciOptions } from './qci.js';
+export { qci } from './qci.js';
+export type { QrandomIoOptions } from './qrandom.js';
+export { qrandomIo } from './qrandom.js';
+export type { RandaoOptions } from './randao.js';
+export { randao } from './randao.js';
+export type { RandomOrgOptions } from './random-org.js';
+export { randomOrg } from './random-org.js';
+export type { SdrOptions } from './sdr.js';
+export { iqLsbBits, sdrEntropy } from './sdr.js';
+export type { SensorOptions, SensorSource } from './sensor.js';
+export { sensorEntropy, sensorReadingBytes } from './sensor.js';
+export type { SerialOptions, SerialPortLike } from './serial.js';
+export { serialEntropy } from './serial.js';
+export type { SolanaBeaconOptions } from './solana.js';
+export { solanaBeacon } from './solana.js';
+export type { SuperRandOptions, WebSocketConstructor, WebSocketLike, } from './superrand.js';
+export { superRand } from './superrand.js';
+export type { TezosBeaconOptions } from './tezos.js';
+export { tezosBeacon } from './tezos.js';
+export type { UchileOptions } from './uchile.js';
+export { uchile } from './uchile.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"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"}

package/dist/providers/index.js

@@ -0,0 +1,32 @@
+// All entropy providers — import from '@mindpeeker/entropy/providers'.
+// The root '@mindpeeker/entropy' entry carries the core (types, errors,
+// strategies, defineProvider) only.
+export { anu } from './anu.js';
+export { anuLegacy } from './anu-legacy.js';
+export { bitcoinBeacon } from './bitcoin.js';
+export { cameraEntropy, lsbBits, signBits } from './camera.js';
+export { cryptoProvider } from './crypto.js';
+export { curby } from './curby.js';
+export { drand } from './drand.js';
+export { flowBeacon } from './flow.js';
+export { inmetro } from './inmetro.js';
+export { jitterEntropy } from './jitter.js';
+export { lfdr } from './lfdr.js';
+export { micEntropy, sampleLsbBits } from './microphone.js';
+export { nistBeacon } from './nist-beacon.js';
+export { nqsn } from './nqsn.js';
+export { outshift } from './outshift.js';
+export { padova } from './padova.js';
+export { qbck } from './qbck.js';
+export { qci } from './qci.js';
+export { qrandomIo } from './qrandom.js';
+export { randao } from './randao.js';
+export { randomOrg } from './random-org.js';
+export { iqLsbBits, sdrEntropy } from './sdr.js';
+export { sensorEntropy, sensorReadingBytes } from './sensor.js';
+export { serialEntropy } from './serial.js';
+export { solanaBeacon } from './solana.js';
+export { superRand } from './superrand.js';
+export { tezosBeacon } from './tezos.js';
+export { uchile } from './uchile.js';
+//# sourceMappingURL=index.js.map

package/dist/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,wEAAwE;AACxE,oCAAoC;AAGpC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAE9B,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAE3C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAE5C,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAE5C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAElC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAElC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAEtC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAE3C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAE3D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAExC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEpC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAE9B,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAExC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEpC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAE3C,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAEhD,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAE/D,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAE3C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAM1C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE1C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAExC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA"}

package/dist/providers/inmetro.d.ts

@@ -0,0 +1,17 @@
+import { type NistFamilyOptions } from '../internal/nist-pulse.js';
+import type { EntropyProvider } from '../types.js';
+export type InmetroVariant = 'primary' | 'combination';
+export interface InmetroOptions extends NistFamilyOptions {
+    /**
+     * 'primary' (default): Inmetro's own quantum-optical beacon, 60 s pulses.
+     * 'combination': CONCAT+VDF combination of UChile, RANDOM.ORG and NIST
+     * seeds, one pulse every 10 minutes.
+     */
+    variant?: InmetroVariant;
+}
+/**
+ * Inmetro Brazilian randomness beacon (national metrology institute) —
+ * NIST IR 8213 format. PUBLIC randomness.
+ */
+export declare function inmetro(opts?: InmetroOptions): EntropyProvider;
+//# sourceMappingURL=inmetro.d.ts.map

package/dist/providers/inmetro.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inmetro.d.ts","sourceRoot":"","sources":["../../src/providers/inmetro.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,iBAAiB,EAAmB,MAAM,2BAA2B,CAAA;AACnF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAElD,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,aAAa,CAAA;AAEtD,MAAM,WAAW,cAAe,SAAQ,iBAAiB;IACvD;;;;OAIG;IACH,OAAO,CAAC,EAAE,cAAc,CAAA;CACzB;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,IAAI,GAAE,cAAmB,GAAG,eAAe,CAwBlE"}

package/dist/providers/inmetro.js

@@ -0,0 +1,25 @@
+import { nistPulseBeacon } from '../internal/nist-pulse.js';
+/**
+ * Inmetro Brazilian randomness beacon (national metrology institute) —
+ * NIST IR 8213 format. PUBLIC randomness.
+ */
+export function inmetro(opts = {}) {
+    const { variant = 'primary', ...rest } = opts;
+    if (variant === 'combination') {
+        return nistPulseBeacon({
+            info: Object.freeze({ name: 'inmetro(combination)', kind: 'beacon', privacy: 'public' }),
+            defaultBaseUrl: 'https://beacon.inmetro.gov.br/combination/beacon/2.0',
+            // quirk: latest has NO /pulse segment, but by-index DOES
+            latestPath: '/last',
+            pulsePath: (_chain, i) => `/pulse/${i}`,
+            defaultPollIntervalMs: 600_000,
+        }, rest);
+    }
+    return nistPulseBeacon({
+        info: Object.freeze({ name: 'inmetro', kind: 'beacon', privacy: 'public' }),
+        defaultBaseUrl: 'https://beacon.inmetro.gov.br/beacon/2.1',
+        latestPath: '/pulse/last',
+        defaultPollIntervalMs: 60_000,
+    }, rest);
+}
+//# sourceMappingURL=inmetro.js.map

package/dist/providers/inmetro.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inmetro.js","sourceRoot":"","sources":["../../src/providers/inmetro.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAcnF;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,OAAuB,EAAE;IAC/C,MAAM,EAAE,OAAO,GAAG,SAAS,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAA;IAC7C,IAAI,OAAO,KAAK,aAAa,EAAE,CAAC;QAC9B,OAAO,eAAe,CACpB;YACE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,sBAAsB,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;YACxF,cAAc,EAAE,sDAAsD;YACtE,yDAAyD;YACzD,UAAU,EAAE,OAAO;YACnB,SAAS,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE;YACvC,qBAAqB,EAAE,OAAO;SAC/B,EACD,IAAI,CACL,CAAA;IACH,CAAC;IACD,OAAO,eAAe,CACpB;QACE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;QAC3E,cAAc,EAAE,0CAA0C;QAC1D,UAAU,EAAE,aAAa;QACzB,qBAAqB,EAAE,MAAM;KAC9B,EACD,IAAI,CACL,CAAA;AACH,CAAC"}

package/dist/providers/jitter.d.ts

@@ -0,0 +1,33 @@
+import type { ConditioningOptions } from '../internal/condition.js';
+import type { EntropyProvider } from '../types.js';
+export interface JitterOptions extends ConditioningOptions {
+    /** Timing deltas gathered per internal batch (event loop yields between). Default 4096. */
+    batchSamples?: number;
+    /**
+     * Opt in to the coarse browser clock (performance.now, 100µs+ granularity).
+     * Coarse mode counts operations per fixed window instead of measuring
+     * per-operation deltas; its entropy is real but UNQUANTIFIED — mix it via
+     * xorMix, never use it as your only source.
+     */
+    allowCoarseClock?: boolean;
+}
+interface HrtimeClock {
+    kind: 'hrtime';
+    now: () => bigint;
+}
+interface CoarseClock {
+    kind: 'coarse';
+    now: () => number;
+}
+/** Resolve the best available clock without importing node: modules. */
+export declare function pickClock(allowCoarse: boolean, g?: typeof globalThis): HrtimeClock | CoarseClock;
+/**
+ * CPU timing jitter (the jitterentropy concept in plain JS). With
+ * process.hrtime.bigint (Node/Bun) it measures per-iteration nanosecond
+ * deltas of a data-dependent memory walk, credited very conservatively at
+ * 1/16 bit per delta. Software-only and unattested — prefer hardware sources
+ * where available; ideal as an always-on xorMix member.
+ */
+export declare function jitterEntropy(opts?: JitterOptions): EntropyProvider;
+export {};
+//# sourceMappingURL=jitter.d.ts.map

package/dist/providers/jitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jitter.d.ts","sourceRoot":"","sources":["../../src/providers/jitter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAGnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAElD,MAAM,WAAW,aAAc,SAAQ,mBAAmB;IACxD,2FAA2F;IAC3F,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B;AAED,UAAU,WAAW;IACnB,IAAI,EAAE,QAAQ,CAAA;IACd,GAAG,EAAE,MAAM,MAAM,CAAA;CAClB;AAED,UAAU,WAAW;IACnB,IAAI,EAAE,QAAQ,CAAA;IACd,GAAG,EAAE,MAAM,MAAM,CAAA;CAClB;AAED,wEAAwE;AACxE,wBAAgB,SAAS,CACvB,WAAW,EAAE,OAAO,EACpB,CAAC,GAAE,OAAO,UAAuB,GAChC,WAAW,GAAG,WAAW,CAiB3B;AAMD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,GAAE,aAAkB,GAAG,eAAe,CA0DvE"}

package/dist/providers/jitter.js

@@ -0,0 +1,81 @@
+import { sleep } from '../internal/rate-limit.js';
+import { sampledProvider } from '../internal/sampled.js';
+/** Resolve the best available clock without importing node: modules. */
+export function pickClock(allowCoarse, g = globalThis) {
+    const bigint = g.process?.hrtime?.bigint;
+    if (typeof bigint === 'function') {
+        return { kind: 'hrtime', now: () => bigint() };
+    }
+    const perf = g.performance;
+    const perfNow = perf?.now;
+    if (typeof perfNow === 'function') {
+        if (!allowCoarse) {
+            throw new TypeError('jitterEntropy: this runtime only offers a coarse clock (performance.now) — pass allowCoarseClock: true to accept unquantified supplementary entropy');
+        }
+        // performance.now needs its receiver — a detached call throws in browsers
+        return { kind: 'coarse', now: () => perfNow.call(perf) };
+    }
+    throw new TypeError('jitterEntropy: no usable high-resolution clock found in this runtime');
+}
+const WALK_SIZE = 65_536;
+const COARSE_WINDOW_MS = 0.5;
+const COARSE_BATCH = 64;
+/**
+ * CPU timing jitter (the jitterentropy concept in plain JS). With
+ * process.hrtime.bigint (Node/Bun) it measures per-iteration nanosecond
+ * deltas of a data-dependent memory walk, credited very conservatively at
+ * 1/16 bit per delta. Software-only and unattested — prefer hardware sources
+ * where available; ideal as an always-on xorMix member.
+ */
+export function jitterEntropy(opts = {}) {
+    const { batchSamples = 4096, allowCoarseClock = false } = opts;
+    const clock = pickClock(allowCoarseClock);
+    const walk = new Uint8Array(WALK_SIZE);
+    let index = 0;
+    function mix(i) {
+        index = (index * 31 + walk[index] + i) & (WALK_SIZE - 1);
+        walk[index] = (walk[index] + 0x9e) & 0xff;
+    }
+    async function* hrtimeSamples(signal) {
+        const now = clock.now;
+        while (true) {
+            const samples = new Uint8Array(batchSamples);
+            let prev = now();
+            for (let i = 0; i < batchSamples; i++) {
+                mix(i);
+                const t = now();
+                samples[i] = Number((t - prev) & 0xffn);
+                prev = t;
+            }
+            yield samples;
+            await sleep(0, signal);
+        }
+    }
+    async function* coarseSamples(signal) {
+        const now = clock.now;
+        while (true) {
+            const samples = new Uint8Array(COARSE_BATCH);
+            for (let i = 0; i < COARSE_BATCH; i++) {
+                const start = now();
+                let ops = 0;
+                while (now() - start < COARSE_WINDOW_MS) {
+                    mix(ops);
+                    ops++;
+                }
+                samples[i] = ops & 0xff;
+            }
+            yield samples;
+            await sleep(0, signal);
+        }
+    }
+    return sampledProvider({
+        name: clock.kind === 'coarse' ? 'jitter(coarse)' : 'jitter',
+        kind: 'trng',
+        privacy: 'private',
+        open: clock.kind === 'coarse' ? coarseSamples : hrtimeSamples,
+        defaultMinEntropyPerSample: clock.kind === 'coarse' ? 0.01 : 0.0625,
+        defaultSafetyFactor: 2,
+        defaultTimeoutMs: 30_000,
+    }, opts);
+}
+//# sourceMappingURL=jitter.js.map

package/dist/providers/jitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jitter.js","sourceRoot":"","sources":["../../src/providers/jitter.ts"],"names":[],"mappings":"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"}

package/dist/providers/lfdr.d.ts

@@ -0,0 +1,11 @@
+import type { EntropyProvider } from '../types.js';
+export interface LfdrOptions {
+    fetch?: typeof fetch;
+    baseUrl?: string;
+}
+/**
+ * LfD (Germany) QRNG — an ID Quantique Quantis PCIe card behind a free,
+ * keyless HTTP API. Hobby-grade: no SLA, no published limits.
+ */
+export declare function lfdr(opts?: LfdrOptions): EntropyProvider;
+//# sourceMappingURL=lfdr.d.ts.map

package/dist/providers/lfdr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lfdr.d.ts","sourceRoot":"","sources":["../../src/providers/lfdr.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAqB,MAAM,aAAa,CAAA;AAOrE,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAOD;;;GAGG;AACH,wBAAgB,IAAI,CAAC,IAAI,GAAE,WAAgB,GAAG,eAAe,CAqB5D"}

package/dist/providers/lfdr.js

@@ -0,0 +1,34 @@
+import { concatBytes } from '../internal/bytes.js';
+import { fetchJson } from '../internal/http.js';
+import { defineProvider } from '../internal/provider.js';
+import { bytesFromHexField } from '../internal/validate.js';
+const INFO = Object.freeze({ name: 'lfdr', kind: 'qrng', privacy: 'private' });
+// No documented cap — self-imposed politeness limit per request.
+const MAX_PER_REQUEST = 1024;
+const DEFAULT_BASE_URL = 'https://lfdr.de/qrng_api/qrng';
+/**
+ * LfD (Germany) QRNG — an ID Quantique Quantis PCIe card behind a free,
+ * keyless HTTP API. Hobby-grade: no SLA, no published limits.
+ */
+export function lfdr(opts = {}) {
+    const { baseUrl = DEFAULT_BASE_URL, fetch: fetchImpl } = opts;
+    return defineProvider({
+        ...INFO,
+        async getBytes(length, reqOpts) {
+            const chunks = [];
+            for (let remaining = length; remaining > 0;) {
+                const n = Math.min(MAX_PER_REQUEST, remaining);
+                const query = new URLSearchParams({ length: String(n), format: 'HEX' });
+                const res = await fetchJson(`${baseUrl}?${query}`, {
+                    provider: INFO.name,
+                    signal: reqOpts?.signal,
+                    fetchImpl,
+                });
+                chunks.push(bytesFromHexField(res?.qrn, n, INFO.name));
+                remaining -= n;
+            }
+            return { bytes: concatBytes(chunks), sources: [INFO] };
+        },
+    });
+}
+//# sourceMappingURL=lfdr.js.map

package/dist/providers/lfdr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lfdr.js","sourceRoot":"","sources":["../../src/providers/lfdr.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAG3D,MAAM,IAAI,GAAsB,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAA;AACjG,iEAAiE;AACjE,MAAM,eAAe,GAAG,IAAI,CAAA;AAC5B,MAAM,gBAAgB,GAAG,+BAA+B,CAAA;AAYxD;;;GAGG;AACH,MAAM,UAAU,IAAI,CAAC,OAAoB,EAAE;IACzC,MAAM,EAAE,OAAO,GAAG,gBAAgB,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,IAAI,CAAA;IAE7D,OAAO,cAAc,CAAC;QACpB,GAAG,IAAI;QACP,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO;YAC5B,MAAM,MAAM,GAAiB,EAAE,CAAA;YAC/B,KAAK,IAAI,SAAS,GAAG,MAAM,EAAE,SAAS,GAAG,CAAC,GAAI,CAAC;gBAC7C,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,SAAS,CAAC,CAAA;gBAC9C,MAAM,KAAK,GAAG,IAAI,eAAe,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAA;gBACvE,MAAM,GAAG,GAAG,MAAM,SAAS,CAAe,GAAG,OAAO,IAAI,KAAK,EAAE,EAAE;oBAC/D,QAAQ,EAAE,IAAI,CAAC,IAAI;oBACnB,MAAM,EAAE,OAAO,EAAE,MAAM;oBACvB,SAAS;iBACV,CAAC,CAAA;gBACF,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;gBACtD,SAAS,IAAI,CAAC,CAAA;YAChB,CAAC;YACD,OAAO,EAAE,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,CAAA;QACxD,CAAC;KACF,CAAC,CAAA;AACJ,CAAC"}

package/dist/providers/microphone.d.ts

@@ -0,0 +1,26 @@
+import type { ConditioningOptions } from '../internal/condition.js';
+import type { EntropyProvider } from '../types.js';
+export interface SampleSource {
+    /** A fresh PCM sample iterable per session; stop capturing in the generator's finally. */
+    samples(signal?: AbortSignal): AsyncIterable<Float32Array | Int16Array>;
+    close?(): void | Promise<void>;
+}
+export interface MicrophoneOptions extends ConditioningOptions {
+    /** Injected PCM samples (Node, tests). Default: getUserMedia audio (browser only). */
+    source?: SampleSource;
+    /** LSBs kept per 16-bit sample. Default 1. */
+    bitsPerSample?: 1 | 2 | 4;
+    /** Audio discarded at session start. Default 200. */
+    warmupMs?: number;
+    /** Used to convert warmupMs into a sample count. Default 48_000. */
+    sampleRate?: number;
+}
+/** Extract the lowest `bitsPerSample` bits of each sample (Float32 scaled to int16 first). */
+export declare function sampleLsbBits(samples: Float32Array | Int16Array, bitsPerSample: 1 | 2 | 4): number[];
+/**
+ * Microphone ADC noise — the least significant bits of the audio samples.
+ * MEMS microphones and browser DSP can interfere; keep expectations modest
+ * and rely on the health tests to catch dead or processed inputs.
+ */
+export declare function micEntropy(opts?: MicrophoneOptions): EntropyProvider;
+//# sourceMappingURL=microphone.d.ts.map

package/dist/providers/microphone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"microphone.d.ts","sourceRoot":"","sources":["../../src/providers/microphone.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAEnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAElD,MAAM,WAAW,YAAY;IAC3B,0FAA0F;IAC1F,OAAO,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,aAAa,CAAC,YAAY,GAAG,UAAU,CAAC,CAAA;IACvE,KAAK,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC/B;AAED,MAAM,WAAW,iBAAkB,SAAQ,mBAAmB;IAC5D,sFAAsF;IACtF,MAAM,CAAC,EAAE,YAAY,CAAA;IACrB,8CAA8C;IAC9C,aAAa,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IACzB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,8FAA8F;AAC9F,wBAAgB,aAAa,CAC3B,OAAO,EAAE,YAAY,GAAG,UAAU,EAClC,aAAa,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GACvB,MAAM,EAAE,CAaV;AA+DD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,GAAE,iBAAsB,GAAG,eAAe,CAqCxE"}