@iam-protocol/pulse-sdk 0.1.0 → 0.2.0

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;
@@ -222,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 */
@@ -246,6 +259,7 @@ interface CircuitInput {
     commitment_new: string;
     commitment_prev: string;
     threshold: string;
+    min_distance: string;
 }
 /** Proof generation result */
 interface ProofResult {
@@ -269,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.
  *
@@ -373,4 +387,4 @@ declare function randomLissajousParams(): LissajousParams;
  */
 declare function generateLissajousPoints(params: LissajousParams): 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, generatePhrase, 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;
@@ -222,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 */
@@ -246,6 +259,7 @@ interface CircuitInput {
     commitment_new: string;
     commitment_prev: string;
     threshold: string;
+    min_distance: string;
 }
 /** Proof generation result */
 interface ProofResult {
@@ -269,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.
  *
@@ -373,4 +387,4 @@ declare function randomLissajousParams(): LissajousParams;
  */
 declare function generateLissajousPoints(params: LissajousParams): 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, generatePhrase, 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,9 +12986,11 @@ __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,
@@ -13023,6 +13026,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;
@@ -13262,6 +13266,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];
 }
@@ -13276,10 +13311,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;
@@ -13314,6 +13349,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) {
@@ -13328,7 +13367,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),
@@ -13354,10 +13393,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);
@@ -13377,6 +13425,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) {
@@ -13558,7 +13614,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,
@@ -13566,7 +13622,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) {
@@ -13784,7 +13841,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);
@@ -14167,6 +14224,7 @@ function generateLissajousPoints(params) {
 // 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,
@@ -14174,9 +14232,11 @@ function generateLissajousPoints(params) {
   PROGRAM_IDS,
   PulseSDK,
   PulseSession,
+  autocorrelation,
   bigintToBytes32,
   computeCommitment,
   condense,
+  entropy,
   fetchIdentityState,
   fuseFeatures,
   generateLissajousPoints,