@entros/pulse-sdk 1.4.2 → 1.5.1

package/README.md

@@ -5,6 +5,8 @@
 
 Client-side SDK for the Entros Protocol. Captures behavioral biometrics (voice, motion, touch), extracts 134 statistical features, 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.
 
+> **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).
+
 ## Install
 
 ```bash

package/dist/index.d.mts

@@ -622,6 +622,18 @@ interface StoredVerificationData {
 
 /**
  * Fetch identity state from the on-chain IdentityState PDA.
+ *
+ * Uses the bundled `entros_anchor.json` IDL (copied verbatim from
+ * `protocol-core/target/idl/`) instead of `Program.fetchIdl`, which
+ * adds a 150-300ms RPC round-trip per call to fetch the IDL from chain.
+ * Account decoding is identical; the only difference is that IDL changes
+ * now require an SDK bump rather than a chain-side IDL upload — in
+ * practice that's already true since on-chain Anchor changes need
+ * matching SDK updates anyway.
+ *
+ * When the on-chain `entros_anchor` program changes, re-copy
+ * `protocol-core/target/idl/entros_anchor.json` into `src/protocol/idl/`
+ * and bump the SDK minor version.
  */
 declare function fetchIdentityState(walletPubkey: string, connection: any): Promise<IdentityState | null>;
 /**

package/dist/index.d.ts

@@ -622,6 +622,18 @@ interface StoredVerificationData {
 
 /**
  * Fetch identity state from the on-chain IdentityState PDA.
+ *
+ * Uses the bundled `entros_anchor.json` IDL (copied verbatim from
+ * `protocol-core/target/idl/`) instead of `Program.fetchIdl`, which
+ * adds a 150-300ms RPC round-trip per call to fetch the IDL from chain.
+ * Account decoding is identical; the only difference is that IDL changes
+ * now require an SDK bump rather than a chain-side IDL upload — in
+ * practice that's already true since on-chain Anchor changes need
+ * matching SDK updates anyway.
+ *
+ * When the on-chain `entros_anchor` program changes, re-copy
+ * `protocol-core/target/idl/entros_anchor.json` into `src/protocol/idl/`
+ * and bump the SDK minor version.
  */
 declare function fetchIdentityState(walletPubkey: string, connection: any): Promise<IdentityState | null>;
 /**