@iam-protocol/pulse-sdk 0.2.1 → 0.2.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iam-protocol/pulse-sdk",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "Client-side SDK for IAM Protocol — sensor capture, TBH generation, ZK proof construction",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/config.ts

@@ -35,6 +35,7 @@ export interface PulseConfig {
   cluster: "devnet" | "mainnet-beta" | "localnet";
   rpcEndpoint?: string;
   relayerUrl?: string;
+  relayerApiKey?: string;
   zkeyUrl?: string;
   wasmUrl?: string;
   threshold?: number;

package/src/pulse.ts

@@ -45,12 +45,45 @@ function extractFeatures(data: SensorData): number[] {
  * Shared pipeline: features → simhash → TBH → proof → submit.
  * Used by both PulseSDK.verify() and PulseSession.complete().
  */
+// Minimum sample counts for meaningful feature extraction
+const MIN_AUDIO_SAMPLES = 16000; // ~1 second at 16kHz
+const MIN_MOTION_SAMPLES = 10;
+const MIN_TOUCH_SAMPLES = 10;
+
 async function processSensorData(
   sensorData: SensorData,
   config: ResolvedConfig,
   wallet?: any,
   connection?: any
 ): Promise<VerificationResult> {
+  // Data quality gate: reject if insufficient behavioral data captured
+  const audioSamples = sensorData.audio?.samples.length ?? 0;
+  const motionSamples = sensorData.motion.length;
+  const touchSamples = sensorData.touch.length;
+
+  // Need at least audio OR (motion + touch) to produce a meaningful fingerprint
+  const hasAudio = audioSamples >= MIN_AUDIO_SAMPLES;
+  const hasMotion = motionSamples >= MIN_MOTION_SAMPLES;
+  const hasTouch = touchSamples >= MIN_TOUCH_SAMPLES;
+
+  if (!hasAudio && !hasMotion && !hasTouch) {
+    return {
+      success: false,
+      commitment: new Uint8Array(32),
+      isFirstVerification: true,
+      error: "Insufficient behavioral data. Please speak the phrase and trace the curve during capture.",
+    };
+  }
+
+  if (!hasAudio) {
+    return {
+      success: false,
+      commitment: new Uint8Array(32),
+      isFirstVerification: true,
+      error: "No voice data detected. Please speak the phrase clearly during capture.",
+    };
+  }
+
   // Extract features
   const features = extractFeatures(sensorData);
 
@@ -113,7 +146,7 @@ async function processSensorData(
     submission = await submitViaRelayer(
       solanaProof ?? { proofBytes: new Uint8Array(0), publicInputs: [] },
       tbh.commitmentBytes,
-      { relayerUrl: config.relayerUrl, isFirstVerification }
+      { relayerUrl: config.relayerUrl, apiKey: config.relayerApiKey, isFirstVerification }
     );
   } else {
     return {
@@ -189,13 +222,14 @@ export class PulseSession {
 
   // --- Audio ---
 
-  async startAudio(): Promise<void> {
+  async startAudio(onAudioLevel?: (rms: number) => void): Promise<void> {
     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,
     }).catch(() => null);
   }
 

package/src/sensor/audio.ts

@@ -19,6 +19,7 @@ export async function captureAudio(
     signal,
     minDurationMs = MIN_CAPTURE_MS,
     maxDurationMs = MAX_CAPTURE_MS,
+    onAudioLevel,
   } = options;
 
   const stream = await navigator.mediaDevices.getUserMedia({
@@ -42,7 +43,14 @@ export async function captureAudio(
     const processor = ctx.createScriptProcessor(bufferSize, 1, 1);
 
     processor.onaudioprocess = (e: AudioProcessingEvent) => {
-      chunks.push(new Float32Array(e.inputBuffer.getChannelData(0)));
+      const data = e.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));
+      }
     };
 
     source.connect(processor);

package/src/sensor/types.ts

@@ -34,6 +34,8 @@ export 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 */