@iam-protocol/pulse-sdk 0.2.5 → 0.3.0

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 declare const FINGERPRINT_BITS = 256;
-declare const DEFAULT_THRESHOLD = 30;
+declare const DEFAULT_THRESHOLD = 96;
 declare const DEFAULT_MIN_DISTANCE = 3;
 declare const MIN_CAPTURE_MS = 2000;
 declare const MAX_CAPTURE_MS = 60000;
@@ -235,6 +235,56 @@ declare function entropy(values: number[], bins?: number): number;
 declare function autocorrelation(values: number[], lag?: number): number;
 declare function fuseFeatures(audio: number[], motion: number[], touch: number[]): number[];
 
+/**
+ * Speaker-dependent audio feature extraction.
+ *
+ * Extracts features that characterize HOW someone speaks (prosody, vocal physiology)
+ * rather than WHAT they say (phonetic content). These features are stable across
+ * different utterances from the same speaker.
+ *
+ * Output: 44 values
+ *   F0 statistics (5) + F0 delta (4) + jitter (4) + shimmer (4) +
+ *   HNR statistics (5) + formant ratios (8) + LTAS (8) + voicing ratio (1) +
+ *   amplitude statistics (5)
+ */
+
+declare const SPEAKER_FEATURE_COUNT = 44;
+/**
+ * Extract speaker-dependent audio features.
+ *
+ * Captures physiological vocal characteristics (F0, jitter, shimmer, HNR, formant
+ * ratios) that are stable across different utterances from the same speaker.
+ * Content-independent by design — different phrases produce similar feature values.
+ *
+ * Returns 44 values.
+ */
+declare function extractSpeakerFeatures(audio: AudioCapture): Promise<number[]>;
+
+/**
+ * Extract kinematic features from motion (IMU) data.
+ * Computes jerk (3rd derivative) and jounce (4th derivative) of acceleration,
+ * then condenses each axis into statistics.
+ *
+ * Returns: ~54 values (6 axes × 2 derivatives × 4 stats + 6 jitter variance values)
+ */
+declare function extractMotionFeatures(samples: MotionSample[]): number[];
+/**
+ * Extract kinematic features from touch data.
+ * Computes velocity and acceleration of touch coordinates,
+ * plus pressure and area statistics.
+ *
+ * Returns: ~36 values (32 base + 4 jitter variance for x, y, pressure, area)
+ */
+declare function extractTouchFeatures(samples: TouchSample[]): number[];
+/**
+ * Extract mouse dynamics features as a desktop replacement for motion sensor data.
+ * Captures behavioral patterns from mouse/pointer movement that are user-specific:
+ * path curvature, speed patterns, micro-corrections, pause behavior.
+ *
+ * Returns: 54 values (matches motion feature dimension for consistent SimHash input)
+ */
+declare function extractMouseDynamics(samples: TouchSample[]): number[];
+
 /** Serialized proof ready for on-chain submission */
 interface SolanaProof {
     proofBytes: Uint8Array;
@@ -397,4 +447,4 @@ declare function generateLissajousSequence(count?: number): {
     points: Point2D[];
 }[];
 
-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 };
+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, SPEAKER_FEATURE_COUNT, 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, extractMotionFeatures, extractMouseDynamics, extractSpeakerFeatures, extractTouchFeatures, 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,5 @@
 declare const FINGERPRINT_BITS = 256;
-declare const DEFAULT_THRESHOLD = 30;
+declare const DEFAULT_THRESHOLD = 96;
 declare const DEFAULT_MIN_DISTANCE = 3;
 declare const MIN_CAPTURE_MS = 2000;
 declare const MAX_CAPTURE_MS = 60000;
@@ -235,6 +235,56 @@ declare function entropy(values: number[], bins?: number): number;
 declare function autocorrelation(values: number[], lag?: number): number;
 declare function fuseFeatures(audio: number[], motion: number[], touch: number[]): number[];
 
+/**
+ * Speaker-dependent audio feature extraction.
+ *
+ * Extracts features that characterize HOW someone speaks (prosody, vocal physiology)
+ * rather than WHAT they say (phonetic content). These features are stable across
+ * different utterances from the same speaker.
+ *
+ * Output: 44 values
+ *   F0 statistics (5) + F0 delta (4) + jitter (4) + shimmer (4) +
+ *   HNR statistics (5) + formant ratios (8) + LTAS (8) + voicing ratio (1) +
+ *   amplitude statistics (5)
+ */
+
+declare const SPEAKER_FEATURE_COUNT = 44;
+/**
+ * Extract speaker-dependent audio features.
+ *
+ * Captures physiological vocal characteristics (F0, jitter, shimmer, HNR, formant
+ * ratios) that are stable across different utterances from the same speaker.
+ * Content-independent by design — different phrases produce similar feature values.
+ *
+ * Returns 44 values.
+ */
+declare function extractSpeakerFeatures(audio: AudioCapture): Promise<number[]>;
+
+/**
+ * Extract kinematic features from motion (IMU) data.
+ * Computes jerk (3rd derivative) and jounce (4th derivative) of acceleration,
+ * then condenses each axis into statistics.
+ *
+ * Returns: ~54 values (6 axes × 2 derivatives × 4 stats + 6 jitter variance values)
+ */
+declare function extractMotionFeatures(samples: MotionSample[]): number[];
+/**
+ * Extract kinematic features from touch data.
+ * Computes velocity and acceleration of touch coordinates,
+ * plus pressure and area statistics.
+ *
+ * Returns: ~36 values (32 base + 4 jitter variance for x, y, pressure, area)
+ */
+declare function extractTouchFeatures(samples: TouchSample[]): number[];
+/**
+ * Extract mouse dynamics features as a desktop replacement for motion sensor data.
+ * Captures behavioral patterns from mouse/pointer movement that are user-specific:
+ * path curvature, speed patterns, micro-corrections, pause behavior.
+ *
+ * Returns: 54 values (matches motion feature dimension for consistent SimHash input)
+ */
+declare function extractMouseDynamics(samples: TouchSample[]): number[];
+
 /** Serialized proof ready for on-chain submission */
 interface SolanaProof {
     proofBytes: Uint8Array;
@@ -397,4 +447,4 @@ declare function generateLissajousSequence(count?: number): {
     points: Point2D[];
 }[];
 
-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 };
+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, SPEAKER_FEATURE_COUNT, 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, extractMotionFeatures, extractMouseDynamics, extractSpeakerFeatures, extractTouchFeatures, 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 };