@iam-protocol/pulse-sdk 0.1.1 → 0.2.1

package/dist/index.d.mts

@@ -1,5 +1,6 @@
 declare const FINGERPRINT_BITS = 256;
 declare const DEFAULT_THRESHOLD = 30;
+declare const DEFAULT_MIN_DISTANCE = 3;
 declare const MIN_CAPTURE_MS = 2000;
 declare const MAX_CAPTURE_MS = 60000;
 declare const DEFAULT_CAPTURE_MS = 7000;
@@ -50,8 +51,6 @@ interface CaptureOptions {
     minDurationMs?: number;
     /** Maximum capture duration in ms. Auto-stops if signal hasn't fired. Default: 60000 */
     maxDurationMs?: number;
-    /** Called with RMS audio level (0-1) on each buffer during audio capture (~4x per second). */
-    onAudioLevel?: (rms: number) => void;
 }
 /** Stage of a capture session */
 type CaptureStage = "audio" | "motion" | "touch";
@@ -120,7 +119,7 @@ declare class PulseSession {
     private motionData;
     private touchData;
     constructor(config: ResolvedConfig, touchElement?: HTMLElement);
-    startAudio(onAudioLevel?: (rms: number) => void): Promise<void>;
+    startAudio(): Promise<void>;
     stopAudio(): Promise<AudioCapture | null>;
     skipAudio(): void;
     startMotion(): Promise<void>;
@@ -224,6 +223,18 @@ declare function variance(values: number[], mu?: number): number;
 declare function skewness(values: number[]): number;
 declare function kurtosis(values: number[]): number;
 declare function condense(values: number[]): StatsSummary;
+/**
+ * Shannon entropy over histogram bins. Measures information density.
+ * Real human data has moderate entropy (varied but structured).
+ * Synthetic data is either too uniform (high entropy) or too structured (low entropy).
+ */
+declare function entropy(values: number[], bins?: number): number;
+/**
+ * Autocorrelation at a given lag. Detects periodic synthetic patterns.
+ * Real human data has low autocorrelation at most lags (chaotic/noisy).
+ * Synthetic data often has high autocorrelation (periodic/smooth).
+ */
+declare function autocorrelation(values: number[], lag?: number): number;
 declare function fuseFeatures(audio: number[], motion: number[], touch: number[]): number[];
 
 /** Serialized proof ready for on-chain submission */
@@ -248,6 +259,7 @@ interface CircuitInput {
     commitment_new: string;
     commitment_prev: string;
     threshold: string;
+    min_distance: string;
 }
 /** Proof generation result */
 interface ProofResult {
@@ -271,7 +283,7 @@ declare function serializeProof(proof: RawProof, publicSignals: string[]): Solan
 /**
  * Prepare circuit input from current and previous TBH data.
  */
-declare function prepareCircuitInput(current: TBH, previous: TBH, threshold?: number): CircuitInput;
+declare function prepareCircuitInput(current: TBH, previous: TBH, threshold?: number, minDistance?: number): CircuitInput;
 /**
  * Generate a Groth16 proof for the Hamming distance circuit.
  *
@@ -348,6 +360,11 @@ declare function loadVerificationData(): StoredVerificationData | null;
  * Each phrase is 5-6 syllable pairs, forming nonsensical but speakable words.
  */
 declare function generatePhrase(wordCount?: number): string;
+/**
+ * Generate a sequence of phrases for dynamic mid-session switching.
+ * Each phrase uses a different syllable subset to prevent pre-computation.
+ */
+declare function generatePhraseSequence(count?: number, wordCount?: number): string[];
 
 /**
  * Generate Lissajous curve points for the touch tracing challenge.
@@ -374,5 +391,13 @@ declare function randomLissajousParams(): LissajousParams;
  * Generate Lissajous curve points normalized to [0, 1] range.
  */
 declare function generateLissajousPoints(params: LissajousParams): Point2D[];
+/**
+ * Generate a sequence of Lissajous curves for dynamic mid-session switching.
+ * Each curve uses different parameters, preventing pre-computation.
+ */
+declare function generateLissajousSequence(count?: number): {
+    params: LissajousParams;
+    points: Point2D[];
+}[];
 
-export { type AudioCapture, type CaptureOptions, type CaptureStage, type CircuitInput, DEFAULT_CAPTURE_MS, DEFAULT_THRESHOLD, FINGERPRINT_BITS, type FeatureVector, type FusedFeatureVector, type IdentityState, type LissajousParams, MAX_CAPTURE_MS, MIN_CAPTURE_MS, type MotionSample, PROGRAM_IDS, type PackedFingerprint, type Point2D, type ProofResult, type PulseConfig, PulseSDK, PulseSession, type SensorData, type SolanaProof, type StageState, type StatsSummary, type StoredVerificationData, type SubmissionResult, type TBH, type TemporalFingerprint, type TouchSample, type VerificationResult, bigintToBytes32, computeCommitment, condense, fetchIdentityState, fuseFeatures, generateLissajousPoints, generatePhrase, generateProof, generateSalt, generateSolanaProof, generateTBH, hammingDistance, kurtosis, loadVerificationData, mean, packBits, prepareCircuitInput, randomLissajousParams, serializeProof, simhash, skewness, storeVerificationData, submitViaRelayer, submitViaWallet, toBigEndian32, variance };
+export { type AudioCapture, type CaptureOptions, type CaptureStage, type CircuitInput, DEFAULT_CAPTURE_MS, DEFAULT_MIN_DISTANCE, DEFAULT_THRESHOLD, FINGERPRINT_BITS, type FeatureVector, type FusedFeatureVector, type IdentityState, type LissajousParams, MAX_CAPTURE_MS, MIN_CAPTURE_MS, type MotionSample, PROGRAM_IDS, type PackedFingerprint, type Point2D, type ProofResult, type PulseConfig, PulseSDK, PulseSession, type SensorData, type SolanaProof, type StageState, type StatsSummary, type StoredVerificationData, type SubmissionResult, type TBH, type TemporalFingerprint, type TouchSample, type VerificationResult, autocorrelation, bigintToBytes32, computeCommitment, condense, entropy, fetchIdentityState, fuseFeatures, generateLissajousPoints, generateLissajousSequence, generatePhrase, generatePhraseSequence, generateProof, generateSalt, generateSolanaProof, generateTBH, hammingDistance, kurtosis, loadVerificationData, mean, packBits, prepareCircuitInput, randomLissajousParams, serializeProof, simhash, skewness, storeVerificationData, submitViaRelayer, submitViaWallet, toBigEndian32, variance };

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 declare const FINGERPRINT_BITS = 256;
 declare const DEFAULT_THRESHOLD = 30;
+declare const DEFAULT_MIN_DISTANCE = 3;
 declare const MIN_CAPTURE_MS = 2000;
 declare const MAX_CAPTURE_MS = 60000;
 declare const DEFAULT_CAPTURE_MS = 7000;
@@ -50,8 +51,6 @@ interface CaptureOptions {
     minDurationMs?: number;
     /** Maximum capture duration in ms. Auto-stops if signal hasn't fired. Default: 60000 */
     maxDurationMs?: number;
-    /** Called with RMS audio level (0-1) on each buffer during audio capture (~4x per second). */
-    onAudioLevel?: (rms: number) => void;
 }
 /** Stage of a capture session */
 type CaptureStage = "audio" | "motion" | "touch";
@@ -120,7 +119,7 @@ declare class PulseSession {
     private motionData;
     private touchData;
     constructor(config: ResolvedConfig, touchElement?: HTMLElement);
-    startAudio(onAudioLevel?: (rms: number) => void): Promise<void>;
+    startAudio(): Promise<void>;
     stopAudio(): Promise<AudioCapture | null>;
     skipAudio(): void;
     startMotion(): Promise<void>;
@@ -224,6 +223,18 @@ declare function variance(values: number[], mu?: number): number;
 declare function skewness(values: number[]): number;
 declare function kurtosis(values: number[]): number;
 declare function condense(values: number[]): StatsSummary;
+/**
+ * Shannon entropy over histogram bins. Measures information density.
+ * Real human data has moderate entropy (varied but structured).
+ * Synthetic data is either too uniform (high entropy) or too structured (low entropy).
+ */
+declare function entropy(values: number[], bins?: number): number;
+/**
+ * Autocorrelation at a given lag. Detects periodic synthetic patterns.
+ * Real human data has low autocorrelation at most lags (chaotic/noisy).
+ * Synthetic data often has high autocorrelation (periodic/smooth).
+ */
+declare function autocorrelation(values: number[], lag?: number): number;
 declare function fuseFeatures(audio: number[], motion: number[], touch: number[]): number[];
 
 /** Serialized proof ready for on-chain submission */
@@ -248,6 +259,7 @@ interface CircuitInput {
     commitment_new: string;
     commitment_prev: string;
     threshold: string;
+    min_distance: string;
 }
 /** Proof generation result */
 interface ProofResult {
@@ -271,7 +283,7 @@ declare function serializeProof(proof: RawProof, publicSignals: string[]): Solan
 /**
  * Prepare circuit input from current and previous TBH data.
  */
-declare function prepareCircuitInput(current: TBH, previous: TBH, threshold?: number): CircuitInput;
+declare function prepareCircuitInput(current: TBH, previous: TBH, threshold?: number, minDistance?: number): CircuitInput;
 /**
  * Generate a Groth16 proof for the Hamming distance circuit.
  *
@@ -348,6 +360,11 @@ declare function loadVerificationData(): StoredVerificationData | null;
  * Each phrase is 5-6 syllable pairs, forming nonsensical but speakable words.
  */
 declare function generatePhrase(wordCount?: number): string;
+/**
+ * Generate a sequence of phrases for dynamic mid-session switching.
+ * Each phrase uses a different syllable subset to prevent pre-computation.
+ */
+declare function generatePhraseSequence(count?: number, wordCount?: number): string[];
 
 /**
  * Generate Lissajous curve points for the touch tracing challenge.
@@ -374,5 +391,13 @@ declare function randomLissajousParams(): LissajousParams;
  * Generate Lissajous curve points normalized to [0, 1] range.
  */
 declare function generateLissajousPoints(params: LissajousParams): Point2D[];
+/**
+ * Generate a sequence of Lissajous curves for dynamic mid-session switching.
+ * Each curve uses different parameters, preventing pre-computation.
+ */
+declare function generateLissajousSequence(count?: number): {
+    params: LissajousParams;
+    points: Point2D[];
+}[];
 
-export { type AudioCapture, type CaptureOptions, type CaptureStage, type CircuitInput, DEFAULT_CAPTURE_MS, DEFAULT_THRESHOLD, FINGERPRINT_BITS, type FeatureVector, type FusedFeatureVector, type IdentityState, type LissajousParams, MAX_CAPTURE_MS, MIN_CAPTURE_MS, type MotionSample, PROGRAM_IDS, type PackedFingerprint, type Point2D, type ProofResult, type PulseConfig, PulseSDK, PulseSession, type SensorData, type SolanaProof, type StageState, type StatsSummary, type StoredVerificationData, type SubmissionResult, type TBH, type TemporalFingerprint, type TouchSample, type VerificationResult, bigintToBytes32, computeCommitment, condense, fetchIdentityState, fuseFeatures, generateLissajousPoints, generatePhrase, generateProof, generateSalt, generateSolanaProof, generateTBH, hammingDistance, kurtosis, loadVerificationData, mean, packBits, prepareCircuitInput, randomLissajousParams, serializeProof, simhash, skewness, storeVerificationData, submitViaRelayer, submitViaWallet, toBigEndian32, variance };
+export { type AudioCapture, type CaptureOptions, type CaptureStage, type CircuitInput, DEFAULT_CAPTURE_MS, DEFAULT_MIN_DISTANCE, DEFAULT_THRESHOLD, FINGERPRINT_BITS, type FeatureVector, type FusedFeatureVector, type IdentityState, type LissajousParams, MAX_CAPTURE_MS, MIN_CAPTURE_MS, type MotionSample, PROGRAM_IDS, type PackedFingerprint, type Point2D, type ProofResult, type PulseConfig, PulseSDK, PulseSession, type SensorData, type SolanaProof, type StageState, type StatsSummary, type StoredVerificationData, type SubmissionResult, type TBH, type TemporalFingerprint, type TouchSample, type VerificationResult, autocorrelation, bigintToBytes32, computeCommitment, condense, entropy, fetchIdentityState, fuseFeatures, generateLissajousPoints, generateLissajousSequence, generatePhrase, generatePhraseSequence, generateProof, generateSalt, generateSolanaProof, generateTBH, hammingDistance, kurtosis, loadVerificationData, mean, packBits, prepareCircuitInput, randomLissajousParams, serializeProof, simhash, skewness, storeVerificationData, submitViaRelayer, submitViaWallet, toBigEndian32, variance };

package/dist/index.js

@@ -12978,6 +12978,7 @@ var init_esm4 = __esm({
 var index_exports = {};
 __export(index_exports, {
   DEFAULT_CAPTURE_MS: () => DEFAULT_CAPTURE_MS,
+  DEFAULT_MIN_DISTANCE: () => DEFAULT_MIN_DISTANCE,
   DEFAULT_THRESHOLD: () => DEFAULT_THRESHOLD,
   FINGERPRINT_BITS: () => FINGERPRINT_BITS,
   MAX_CAPTURE_MS: () => MAX_CAPTURE_MS,
@@ -12985,13 +12986,17 @@ __export(index_exports, {
   PROGRAM_IDS: () => PROGRAM_IDS,
   PulseSDK: () => PulseSDK,
   PulseSession: () => PulseSession,
+  autocorrelation: () => autocorrelation,
   bigintToBytes32: () => bigintToBytes32,
   computeCommitment: () => computeCommitment,
   condense: () => condense,
+  entropy: () => entropy,
   fetchIdentityState: () => fetchIdentityState,
   fuseFeatures: () => fuseFeatures,
   generateLissajousPoints: () => generateLissajousPoints,
+  generateLissajousSequence: () => generateLissajousSequence,
   generatePhrase: () => generatePhrase,
+  generatePhraseSequence: () => generatePhraseSequence,
   generateProof: () => generateProof,
   generateSalt: () => generateSalt,
   generateSolanaProof: () => generateSolanaProof,
@@ -13023,6 +13028,7 @@ var BN254_SCALAR_FIELD = BigInt(
 );
 var FINGERPRINT_BITS = 256;
 var DEFAULT_THRESHOLD = 30;
+var DEFAULT_MIN_DISTANCE = 3;
 var PROOF_A_SIZE = 64;
 var PROOF_B_SIZE = 128;
 var PROOF_C_SIZE = 64;
@@ -13043,8 +13049,7 @@ async function captureAudio(options = {}) {
   const {
     signal,
     minDurationMs = MIN_CAPTURE_MS,
-    maxDurationMs = MAX_CAPTURE_MS,
-    onAudioLevel
+    maxDurationMs = MAX_CAPTURE_MS
   } = options;
   const stream = await navigator.mediaDevices.getUserMedia({
     audio: {
@@ -13064,13 +13069,7 @@ async function captureAudio(options = {}) {
     const bufferSize = 4096;
     const processor = ctx.createScriptProcessor(bufferSize, 1, 1);
     processor.onaudioprocess = (e2) => {
-      const data = e2.inputBuffer.getChannelData(0);
-      chunks.push(new Float32Array(data));
-      if (onAudioLevel) {
-        let sum = 0;
-        for (let i = 0; i < data.length; i++) sum += data[i] * data[i];
-        onAudioLevel(Math.sqrt(sum / data.length));
-      }
+      chunks.push(new Float32Array(e2.inputBuffer.getChannelData(0)));
     };
     source.connect(processor);
     processor.connect(ctx.destination);
@@ -13269,6 +13268,37 @@ function condense(values) {
     kurtosis: kurtosis(values)
   };
 }
+function entropy(values, bins = 16) {
+  if (values.length < 2) return 0;
+  const min = Math.min(...values);
+  const max = Math.max(...values);
+  if (min === max) return 0;
+  const counts = new Array(bins).fill(0);
+  const range = max - min;
+  for (const v of values) {
+    const idx = Math.min(Math.floor((v - min) / range * bins), bins - 1);
+    counts[idx]++;
+  }
+  let h = 0;
+  for (const c of counts) {
+    if (c > 0) {
+      const p = c / values.length;
+      h -= p * Math.log2(p);
+    }
+  }
+  return h;
+}
+function autocorrelation(values, lag = 1) {
+  if (values.length <= lag) return 0;
+  const m = mean(values);
+  const v = variance(values, m);
+  if (v === 0) return 0;
+  let sum = 0;
+  for (let i = 0; i < values.length - lag; i++) {
+    sum += (values[i] - m) * (values[i + lag] - m);
+  }
+  return sum / ((values.length - lag) * v);
+}
 function fuseFeatures(audio, motion, touch) {
   return [...audio, ...motion, ...touch];
 }
@@ -13283,10 +13313,10 @@ function extractMFCC(audio) {
   try {
     Meyda = require("meyda");
   } catch {
-    return new Array(NUM_MFCC * 3 * 4).fill(0);
+    return new Array(NUM_MFCC * 3 * 4 + NUM_MFCC).fill(0);
   }
   const numFrames = Math.floor((samples.length - FRAME_SIZE) / HOP_SIZE) + 1;
-  if (numFrames < 3) return new Array(NUM_MFCC * 3 * 4).fill(0);
+  if (numFrames < 3) return new Array(NUM_MFCC * 3 * 4 + NUM_MFCC).fill(0);
   const mfccFrames = [];
   for (let i = 0; i < numFrames; i++) {
     const start = i * HOP_SIZE;
@@ -13321,6 +13351,10 @@ function extractMFCC(audio) {
     const stats = condense(dd);
     features.push(stats.mean, stats.variance, stats.skewness, stats.kurtosis);
   }
+  for (let c = 0; c < NUM_MFCC; c++) {
+    const raw = mfccFrames.map((f) => f[c] ?? 0);
+    features.push(entropy(raw));
+  }
   return features;
 }
 function computeDeltas(frames) {
@@ -13335,7 +13369,7 @@ function computeDeltas(frames) {
 
 // src/extraction/kinematic.ts
 function extractMotionFeatures(samples) {
-  if (samples.length < 5) return new Array(48).fill(0);
+  if (samples.length < 5) return new Array(54).fill(0);
   const axes = {
     ax: samples.map((s) => s.ax),
     ay: samples.map((s) => s.ay),
@@ -13361,10 +13395,19 @@ function extractMotionFeatures(samples) {
       jounceStats.kurtosis
     );
   }
+  for (const values of Object.values(axes)) {
+    const jerk = derivative(values);
+    const windowSize = Math.max(5, Math.floor(jerk.length / 4));
+    const windowVariances = [];
+    for (let i = 0; i <= jerk.length - windowSize; i += windowSize) {
+      windowVariances.push(variance(jerk.slice(i, i + windowSize)));
+    }
+    features.push(windowVariances.length >= 2 ? variance(windowVariances) : 0);
+  }
   return features;
 }
 function extractTouchFeatures(samples) {
-  if (samples.length < 5) return new Array(32).fill(0);
+  if (samples.length < 5) return new Array(36).fill(0);
   const x = samples.map((s) => s.x);
   const y = samples.map((s) => s.y);
   const pressure = samples.map((s) => s.pressure);
@@ -13384,6 +13427,14 @@ function extractTouchFeatures(samples) {
   const jerkY = derivative(accY);
   features.push(...Object.values(condense(jerkX)));
   features.push(...Object.values(condense(jerkY)));
+  for (const values of [vx, vy, pressure, area]) {
+    const windowSize = Math.max(5, Math.floor(values.length / 4));
+    const windowVariances = [];
+    for (let i = 0; i <= values.length - windowSize; i += windowSize) {
+      windowVariances.push(variance(values.slice(i, i + windowSize)));
+    }
+    features.push(windowVariances.length >= 2 ? variance(windowVariances) : 0);
+  }
   return features;
 }
 function derivative(values) {
@@ -13565,7 +13616,7 @@ async function getSnarkjs() {
   }
   return snarkjsModule;
 }
-function prepareCircuitInput(current, previous, threshold = DEFAULT_THRESHOLD) {
+function prepareCircuitInput(current, previous, threshold = DEFAULT_THRESHOLD, minDistance = DEFAULT_MIN_DISTANCE) {
   return {
     ft_new: current.fingerprint,
     ft_prev: previous.fingerprint,
@@ -13573,7 +13624,8 @@ function prepareCircuitInput(current, previous, threshold = DEFAULT_THRESHOLD) {
     salt_prev: previous.salt.toString(),
     commitment_new: current.commitment.toString(),
     commitment_prev: previous.commitment.toString(),
-    threshold: threshold.toString()
+    threshold: threshold.toString(),
+    min_distance: minDistance.toString()
   };
 }
 async function generateProof(input, wasmPath, zkeyPath) {
@@ -13791,7 +13843,7 @@ var inMemoryStore = null;
 
 // src/pulse.ts
 function extractFeatures(data) {
-  const audioFeatures = data.audio ? extractMFCC(data.audio) : new Array(156).fill(0);
+  const audioFeatures = data.audio ? extractMFCC(data.audio) : new Array(169).fill(0);
   const motionFeatures = extractMotionFeatures(data.motion);
   const touchFeatures = extractTouchFeatures(data.touch);
   return fuseFeatures(audioFeatures, motionFeatures, touchFeatures);
@@ -13887,14 +13939,13 @@ var PulseSession = class {
     this.touchElement = touchElement;
   }
   // --- Audio ---
-  async startAudio(onAudioLevel) {
+  async startAudio() {
     if (this.audioStageState !== "idle")
       throw new Error("Audio capture already started");
     this.audioStageState = "capturing";
     this.audioController = new AbortController();
     this.audioPromise = captureAudio({
-      signal: this.audioController.signal,
-      onAudioLevel
+      signal: this.audioController.signal
     }).catch(() => null);
   }
   async stopAudio() {
@@ -14142,6 +14193,28 @@ function generatePhrase(wordCount = 5) {
   }
   return words.join(" ");
 }
+function generatePhraseSequence(count = 3, wordCount = 4) {
+  const subsetSize = Math.floor(SYLLABLES.length / count);
+  const phrases = [];
+  for (let p = 0; p < count; p++) {
+    const start = p * subsetSize % SYLLABLES.length;
+    const subset = [
+      ...SYLLABLES.slice(start, start + subsetSize),
+      ...SYLLABLES.slice(0, Math.max(0, start + subsetSize - SYLLABLES.length))
+    ];
+    const words = [];
+    for (let w = 0; w < wordCount; w++) {
+      const syllableCount = 2 + Math.floor(Math.random() * 2);
+      let word = "";
+      for (let s = 0; s < syllableCount; s++) {
+        word += subset[Math.floor(Math.random() * subset.length)];
+      }
+      words.push(word);
+    }
+    phrases.push(words.join(" "));
+  }
+  return phrases;
+}
 
 // src/challenge/lissajous.ts
 function randomLissajousParams() {
@@ -14172,9 +14245,37 @@ function generateLissajousPoints(params) {
   }
   return result;
 }
+function generateLissajousSequence(count = 2) {
+  const allRatios = [
+    [1, 2],
+    [2, 3],
+    [3, 4],
+    [3, 5],
+    [4, 5],
+    [1, 3],
+    [2, 5],
+    [5, 6],
+    [3, 7],
+    [4, 7]
+  ];
+  const shuffled = [...allRatios].sort(() => Math.random() - 0.5);
+  const sequence = [];
+  for (let i = 0; i < count; i++) {
+    const pair = shuffled[i % shuffled.length];
+    const params = {
+      a: pair[0],
+      b: pair[1],
+      delta: Math.PI * (0.1 + Math.random() * 0.8),
+      points: 200
+    };
+    sequence.push({ params, points: generateLissajousPoints(params) });
+  }
+  return sequence;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   DEFAULT_CAPTURE_MS,
+  DEFAULT_MIN_DISTANCE,
   DEFAULT_THRESHOLD,
   FINGERPRINT_BITS,
   MAX_CAPTURE_MS,
@@ -14182,13 +14283,17 @@ function generateLissajousPoints(params) {
   PROGRAM_IDS,
   PulseSDK,
   PulseSession,
+  autocorrelation,
   bigintToBytes32,
   computeCommitment,
   condense,
+  entropy,
   fetchIdentityState,
   fuseFeatures,
   generateLissajousPoints,
+  generateLissajousSequence,
   generatePhrase,
+  generatePhraseSequence,
   generateProof,
   generateSalt,
   generateSolanaProof,