@entros/pulse-sdk 3.0.0 → 3.2.0

package/README.md

@@ -3,7 +3,7 @@
 [![npm version](https://img.shields.io/npm/v/@entros/pulse-sdk.svg)](https://www.npmjs.com/package/@entros/pulse-sdk)
 [![npm downloads](https://img.shields.io/npm/dm/@entros/pulse-sdk.svg)](https://www.npmjs.com/package/@entros/pulse-sdk)
 
-Client-side SDK for the Entros Protocol. Captures behavioral biometrics (voice, motion, touch), extracts a 308-dimensional statistical feature vector (v3 expansion: MFCCs with pre-emphasis (C1-C12, MFCC[0] dropped), LPC coefficients, formant trajectories, voice quality, pitch contour shape, IMU FFT-band tremor, cross-axis covariance, mouse-derived FFT / autocorrelation analogues for desktop, touch curvature, gap distribution, path efficiency — see `docs/master/BLUEPRINT-feature-pipeline-v2.md`), generates a Groth16 zero-knowledge proof, and submits for on-chain verification on Solana. Raw biometric data stays on-device — only derived features and the proof are transmitted.
+Client-side SDK for the Entros Protocol. Captures behavioral biometrics (voice, motion, touch), extracts a 308-dimensional statistical feature vector (v3 expansion: MFCCs with pre-emphasis (C1-C12, MFCC[0] dropped), LPC coefficients, formant trajectories, voice quality, pitch contour shape, IMU FFT-band tremor, cross-axis covariance, mouse-derived FFT / autocorrelation analogues for desktop, touch curvature, gap distribution, path efficiency — see `docs/master/BLUEPRINT-feature-pipeline-v2.md`), generates a Groth16 zero-knowledge proof, and submits for on-chain verification on Solana. Raw biometric data never persists — only derived features and the proof are retained.
 
 > **Looking for a drop-in?** Most integrators want [`@entros/verify`](https://github.com/entros-protocol/entros-verify) — a popup-pattern React component that wraps this SDK and ships verification in five lines of JSX. Use this package directly when you need to own the verification UX (custom capture canvas, branded loading states, mobile-native).
 

package/dist/index.d.mts

@@ -3,7 +3,7 @@ declare const DEFAULT_THRESHOLD = 96;
 declare const DEFAULT_MIN_DISTANCE = 3;
 declare const MIN_CAPTURE_MS = 2000;
 declare const MAX_CAPTURE_MS = 60000;
-declare const DEFAULT_CAPTURE_MS = 7000;
+declare const DEFAULT_CAPTURE_MS = 12000;
 declare const PROGRAM_IDS: {
     readonly entrosAnchor: "GZYwTp2ozeuRA5Gof9vs4ya961aANcJBdUzB7LN6q4b2";
     readonly entrosVerifier: "4F97jNoxQzT2qRbkWpW3ztC3Nz2TtKj3rnKG8ExgnrfV";
@@ -316,23 +316,6 @@ interface FeatureVector {
 /** Concatenated feature vector for SimHash input */
 type FusedFeatureVector = number[];
 
-declare function mean(values: number[]): number;
-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;
 /**
  * Concatenate raw features without normalization.
  * Used for server-side validation where physical units matter.
@@ -383,6 +366,8 @@ declare function extractSpeakerFeaturesDetailed(audio: AudioCapture): Promise<{
  */
 declare function extractSpeakerFeatures(audio: AudioCapture): Promise<number[]>;
 
+declare const MOTION_FEATURE_COUNT: number;
+declare const TOUCH_FEATURE_COUNT: number;
 /**
  * Compute per-sample acceleration magnitude |a| = √(ax² + ay² + az²) and
  * linearly resample to a target frame count. Surfaced for server-side
@@ -785,4 +770,4 @@ declare function fetchChallenge(executorUrl: string, walletAddress: string, apiK
  */
 declare function encodeAudioAsBase64(samples: Float32Array): string;
 
-export { type AgentHumanOperator, type AudioCapture, type CaptureOptions, type CaptureStage, type ChallengeResponse, type CircuitInput, DEFAULT_CAPTURE_MS, DEFAULT_MIN_DISTANCE, DEFAULT_THRESHOLD, type EntrosAttestation, FINGERPRINT_BITS, type FeatureVector, type FusedFeatureVector, type IdentityState, type LissajousParams, MAX_CAPTURE_MS, MIN_AUDIO_SAMPLES, MIN_CAPTURE_MS, MIN_MOTION_SAMPLES, MIN_TOUCH_SAMPLES, 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, attestAgentOperator, autocorrelation, bigintToBytes32, computeCommitment, condense, encodeAudioAsBase64, entropy, extractAccelerationMagnitude, extractMotionFeatures, extractMouseDynamics, extractSpeakerFeatures, extractSpeakerFeaturesDetailed, extractTouchFeatures, fetchChallenge, fetchIdentityState, fuseFeatures, fuseRawFeatures, generateLissajousPoints, generateLissajousSequence, generatePhrase, generatePhraseSequence, generateProof, generateSalt, generateSolanaProof, generateTBH, getAgentHumanOperator, hammingDistance, kurtosis, loadVerificationData, mean, packBits, prepareCircuitInput, randomLissajousParams, serializeProof, simhash, skewness, storeVerificationData, submitResetViaWallet, submitViaRelayer, submitViaWallet, toBigEndian32, variance, verifyEntrosAttestation };
+export { type AgentHumanOperator, type AudioCapture, type CaptureOptions, type CaptureStage, type ChallengeResponse, type CircuitInput, DEFAULT_CAPTURE_MS, DEFAULT_MIN_DISTANCE, DEFAULT_THRESHOLD, type EntrosAttestation, FINGERPRINT_BITS, type FeatureVector, type FusedFeatureVector, type IdentityState, type LissajousParams, MAX_CAPTURE_MS, MIN_AUDIO_SAMPLES, MIN_CAPTURE_MS, MIN_MOTION_SAMPLES, MIN_TOUCH_SAMPLES, MOTION_FEATURE_COUNT, 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, TOUCH_FEATURE_COUNT, type TemporalFingerprint, type TouchSample, type VerificationResult, attestAgentOperator, bigintToBytes32, computeCommitment, encodeAudioAsBase64, extractAccelerationMagnitude, extractMotionFeatures, extractMouseDynamics, extractSpeakerFeatures, extractSpeakerFeaturesDetailed, extractTouchFeatures, fetchChallenge, fetchIdentityState, fuseFeatures, fuseRawFeatures, generateLissajousPoints, generateLissajousSequence, generatePhrase, generatePhraseSequence, generateProof, generateSalt, generateSolanaProof, generateTBH, getAgentHumanOperator, hammingDistance, loadVerificationData, packBits, prepareCircuitInput, randomLissajousParams, serializeProof, simhash, storeVerificationData, submitResetViaWallet, submitViaRelayer, submitViaWallet, toBigEndian32, verifyEntrosAttestation };

package/dist/index.d.ts

@@ -3,7 +3,7 @@ declare const DEFAULT_THRESHOLD = 96;
 declare const DEFAULT_MIN_DISTANCE = 3;
 declare const MIN_CAPTURE_MS = 2000;
 declare const MAX_CAPTURE_MS = 60000;
-declare const DEFAULT_CAPTURE_MS = 7000;
+declare const DEFAULT_CAPTURE_MS = 12000;
 declare const PROGRAM_IDS: {
     readonly entrosAnchor: "GZYwTp2ozeuRA5Gof9vs4ya961aANcJBdUzB7LN6q4b2";
     readonly entrosVerifier: "4F97jNoxQzT2qRbkWpW3ztC3Nz2TtKj3rnKG8ExgnrfV";
@@ -316,23 +316,6 @@ interface FeatureVector {
 /** Concatenated feature vector for SimHash input */
 type FusedFeatureVector = number[];
 
-declare function mean(values: number[]): number;
-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;
 /**
  * Concatenate raw features without normalization.
  * Used for server-side validation where physical units matter.
@@ -383,6 +366,8 @@ declare function extractSpeakerFeaturesDetailed(audio: AudioCapture): Promise<{
  */
 declare function extractSpeakerFeatures(audio: AudioCapture): Promise<number[]>;
 
+declare const MOTION_FEATURE_COUNT: number;
+declare const TOUCH_FEATURE_COUNT: number;
 /**
  * Compute per-sample acceleration magnitude |a| = √(ax² + ay² + az²) and
  * linearly resample to a target frame count. Surfaced for server-side
@@ -785,4 +770,4 @@ declare function fetchChallenge(executorUrl: string, walletAddress: string, apiK
  */
 declare function encodeAudioAsBase64(samples: Float32Array): string;
 
-export { type AgentHumanOperator, type AudioCapture, type CaptureOptions, type CaptureStage, type ChallengeResponse, type CircuitInput, DEFAULT_CAPTURE_MS, DEFAULT_MIN_DISTANCE, DEFAULT_THRESHOLD, type EntrosAttestation, FINGERPRINT_BITS, type FeatureVector, type FusedFeatureVector, type IdentityState, type LissajousParams, MAX_CAPTURE_MS, MIN_AUDIO_SAMPLES, MIN_CAPTURE_MS, MIN_MOTION_SAMPLES, MIN_TOUCH_SAMPLES, 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, attestAgentOperator, autocorrelation, bigintToBytes32, computeCommitment, condense, encodeAudioAsBase64, entropy, extractAccelerationMagnitude, extractMotionFeatures, extractMouseDynamics, extractSpeakerFeatures, extractSpeakerFeaturesDetailed, extractTouchFeatures, fetchChallenge, fetchIdentityState, fuseFeatures, fuseRawFeatures, generateLissajousPoints, generateLissajousSequence, generatePhrase, generatePhraseSequence, generateProof, generateSalt, generateSolanaProof, generateTBH, getAgentHumanOperator, hammingDistance, kurtosis, loadVerificationData, mean, packBits, prepareCircuitInput, randomLissajousParams, serializeProof, simhash, skewness, storeVerificationData, submitResetViaWallet, submitViaRelayer, submitViaWallet, toBigEndian32, variance, verifyEntrosAttestation };
+export { type AgentHumanOperator, type AudioCapture, type CaptureOptions, type CaptureStage, type ChallengeResponse, type CircuitInput, DEFAULT_CAPTURE_MS, DEFAULT_MIN_DISTANCE, DEFAULT_THRESHOLD, type EntrosAttestation, FINGERPRINT_BITS, type FeatureVector, type FusedFeatureVector, type IdentityState, type LissajousParams, MAX_CAPTURE_MS, MIN_AUDIO_SAMPLES, MIN_CAPTURE_MS, MIN_MOTION_SAMPLES, MIN_TOUCH_SAMPLES, MOTION_FEATURE_COUNT, 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, TOUCH_FEATURE_COUNT, type TemporalFingerprint, type TouchSample, type VerificationResult, attestAgentOperator, bigintToBytes32, computeCommitment, encodeAudioAsBase64, extractAccelerationMagnitude, extractMotionFeatures, extractMouseDynamics, extractSpeakerFeatures, extractSpeakerFeaturesDetailed, extractTouchFeatures, fetchChallenge, fetchIdentityState, fuseFeatures, fuseRawFeatures, generateLissajousPoints, generateLissajousSequence, generatePhrase, generatePhraseSequence, generateProof, generateSalt, generateSolanaProof, generateTBH, getAgentHumanOperator, hammingDistance, loadVerificationData, packBits, prepareCircuitInput, randomLissajousParams, serializeProof, simhash, storeVerificationData, submitResetViaWallet, submitViaRelayer, submitViaWallet, toBigEndian32, verifyEntrosAttestation };

package/dist/index.js

@@ -39,17 +39,16 @@ __export(index_exports, {
   MIN_CAPTURE_MS: () => MIN_CAPTURE_MS,
   MIN_MOTION_SAMPLES: () => MIN_MOTION_SAMPLES,
   MIN_TOUCH_SAMPLES: () => MIN_TOUCH_SAMPLES,
+  MOTION_FEATURE_COUNT: () => MOTION_FEATURE_COUNT,
   PROGRAM_IDS: () => PROGRAM_IDS,
   PulseSDK: () => PulseSDK,
   PulseSession: () => PulseSession,
   SPEAKER_FEATURE_COUNT: () => SPEAKER_FEATURE_COUNT,
+  TOUCH_FEATURE_COUNT: () => TOUCH_FEATURE_COUNT,
   attestAgentOperator: () => attestAgentOperator,
-  autocorrelation: () => autocorrelation,
   bigintToBytes32: () => bigintToBytes32,
   computeCommitment: () => computeCommitment,
-  condense: () => condense,
   encodeAudioAsBase64: () => encodeAudioAsBase64,
-  entropy: () => entropy,
   extractAccelerationMagnitude: () => extractAccelerationMagnitude,
   extractMotionFeatures: () => extractMotionFeatures,
   extractMouseDynamics: () => extractMouseDynamics,
@@ -70,21 +69,17 @@ __export(index_exports, {
   generateTBH: () => generateTBH,
   getAgentHumanOperator: () => getAgentHumanOperator,
   hammingDistance: () => hammingDistance,
-  kurtosis: () => kurtosis,
   loadVerificationData: () => loadVerificationData,
-  mean: () => mean,
   packBits: () => packBits,
   prepareCircuitInput: () => prepareCircuitInput,
   randomLissajousParams: () => randomLissajousParams,
   serializeProof: () => serializeProof,
   simhash: () => simhash,
-  skewness: () => skewness,
   storeVerificationData: () => storeVerificationData,
   submitResetViaWallet: () => submitResetViaWallet,
   submitViaRelayer: () => submitViaRelayer,
   submitViaWallet: () => submitViaWallet,
   toBigEndian32: () => toBigEndian32,
-  variance: () => variance,
   verifyEntrosAttestation: () => verifyEntrosAttestation
 });
 module.exports = __toCommonJS(index_exports);
@@ -107,7 +102,7 @@ var TOTAL_PROOF_SIZE = 256;
 var SIMHASH_SEED = "IAM-PROTOCOL-SIMHASH-V1";
 var MIN_CAPTURE_MS = 2e3;
 var MAX_CAPTURE_MS = 6e4;
-var DEFAULT_CAPTURE_MS = 7e3;
+var DEFAULT_CAPTURE_MS = 12e3;
 var PROGRAM_IDS = {
   entrosAnchor: "GZYwTp2ozeuRA5Gof9vs4ya961aANcJBdUzB7LN6q4b2",
   entrosVerifier: "4F97jNoxQzT2qRbkWpW3ztC3Nz2TtKj3rnKG8ExgnrfV",
@@ -6433,17 +6428,16 @@ async function fetchChallenge(executorUrl, walletAddress, apiKey) {
   MIN_CAPTURE_MS,
   MIN_MOTION_SAMPLES,
   MIN_TOUCH_SAMPLES,
+  MOTION_FEATURE_COUNT,
   PROGRAM_IDS,
   PulseSDK,
   PulseSession,
   SPEAKER_FEATURE_COUNT,
+  TOUCH_FEATURE_COUNT,
   attestAgentOperator,
-  autocorrelation,
   bigintToBytes32,
   computeCommitment,
-  condense,
   encodeAudioAsBase64,
-  entropy,
   extractAccelerationMagnitude,
   extractMotionFeatures,
   extractMouseDynamics,
@@ -6464,21 +6458,17 @@ async function fetchChallenge(executorUrl, walletAddress, apiKey) {
   generateTBH,
   getAgentHumanOperator,
   hammingDistance,
-  kurtosis,
   loadVerificationData,
-  mean,
   packBits,
   prepareCircuitInput,
   randomLissajousParams,
   serializeProof,
   simhash,
-  skewness,
   storeVerificationData,
   submitResetViaWallet,
   submitViaRelayer,
   submitViaWallet,
   toBigEndian32,
-  variance,
   verifyEntrosAttestation
 });
 //# sourceMappingURL=index.js.map