@iam-protocol/pulse-sdk 0.2.1 → 0.2.3

package/README.md

@@ -1,5 +1,8 @@
 # @iam-protocol/pulse-sdk
 
+[![npm version](https://img.shields.io/npm/v/@iam-protocol/pulse-sdk.svg)](https://www.npmjs.com/package/@iam-protocol/pulse-sdk)
+[![npm downloads](https://img.shields.io/npm/dm/@iam-protocol/pulse-sdk.svg)](https://www.npmjs.com/package/@iam-protocol/pulse-sdk)
+
 Client-side SDK for the IAM Protocol. Captures behavioral biometrics (voice, motion, touch), generates a Temporal-Biometric Hash, produces a Groth16 zero-knowledge proof, and submits it for on-chain verification on Solana.
 
 ## Install

package/dist/index.d.mts

@@ -13,6 +13,7 @@ interface PulseConfig {
     cluster: "devnet" | "mainnet-beta" | "localnet";
     rpcEndpoint?: string;
     relayerUrl?: string;
+    relayerApiKey?: string;
     zkeyUrl?: string;
     wasmUrl?: string;
     threshold?: number;
@@ -51,6 +52,8 @@ 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";
@@ -119,7 +122,7 @@ declare class PulseSession {
     private motionData;
     private touchData;
     constructor(config: ResolvedConfig, touchElement?: HTMLElement);
-    startAudio(): Promise<void>;
+    startAudio(onAudioLevel?: (rms: number) => void): Promise<void>;
     stopAudio(): Promise<AudioCapture | null>;
     skipAudio(): void;
     startMotion(): Promise<void>;

package/dist/index.d.ts

@@ -13,6 +13,7 @@ interface PulseConfig {
     cluster: "devnet" | "mainnet-beta" | "localnet";
     rpcEndpoint?: string;
     relayerUrl?: string;
+    relayerApiKey?: string;
     zkeyUrl?: string;
     wasmUrl?: string;
     threshold?: number;
@@ -51,6 +52,8 @@ 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";
@@ -119,7 +122,7 @@ declare class PulseSession {
     private motionData;
     private touchData;
     constructor(config: ResolvedConfig, touchElement?: HTMLElement);
-    startAudio(): Promise<void>;
+    startAudio(onAudioLevel?: (rms: number) => void): Promise<void>;
     stopAudio(): Promise<AudioCapture | null>;
     skipAudio(): void;
     startMotion(): Promise<void>;

package/dist/index.js

@@ -13049,7 +13049,8 @@ async function captureAudio(options = {}) {
   const {
     signal,
     minDurationMs = MIN_CAPTURE_MS,
-    maxDurationMs = MAX_CAPTURE_MS
+    maxDurationMs = MAX_CAPTURE_MS,
+    onAudioLevel
   } = options;
   const stream = await navigator.mediaDevices.getUserMedia({
     audio: {
@@ -13069,7 +13070,13 @@ async function captureAudio(options = {}) {
     const bufferSize = 4096;
     const processor = ctx.createScriptProcessor(bufferSize, 1, 1);
     processor.onaudioprocess = (e2) => {
-      chunks.push(new Float32Array(e2.inputBuffer.getChannelData(0)));
+      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));
+      }
     };
     source.connect(processor);
     processor.connect(ctx.destination);
@@ -13848,7 +13855,32 @@ function extractFeatures(data) {
   const touchFeatures = extractTouchFeatures(data.touch);
   return fuseFeatures(audioFeatures, motionFeatures, touchFeatures);
 }
+var MIN_AUDIO_SAMPLES = 16e3;
+var MIN_MOTION_SAMPLES = 10;
+var MIN_TOUCH_SAMPLES = 10;
 async function processSensorData(sensorData, config, wallet, connection) {
+  const audioSamples = sensorData.audio?.samples.length ?? 0;
+  const motionSamples = sensorData.motion.length;
+  const touchSamples = sensorData.touch.length;
+  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."
+    };
+  }
   const features = extractFeatures(sensorData);
   const fingerprint = simhash(features);
   const tbh = await generateTBH(fingerprint);
@@ -13895,7 +13927,7 @@ async function processSensorData(sensorData, config, wallet, connection) {
     submission = await submitViaRelayer(
       solanaProof ?? { proofBytes: new Uint8Array(0), publicInputs: [] },
       tbh.commitmentBytes,
-      { relayerUrl: config.relayerUrl, isFirstVerification }
+      { relayerUrl: config.relayerUrl, apiKey: config.relayerApiKey, isFirstVerification }
     );
   } else {
     return {
@@ -13939,13 +13971,14 @@ var PulseSession = class {
     this.touchElement = touchElement;
   }
   // --- Audio ---
-  async startAudio() {
+  async startAudio(onAudioLevel) {
     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
+      signal: this.audioController.signal,
+      onAudioLevel
     }).catch(() => null);
   }
   async stopAudio() {