@neus/sdk 1.0.8 → 1.0.9

package/client.js

@@ -924,22 +924,12 @@ export class NeusClient {
                 for (let i = 0; i < full.length; i++) payloadHex += full[i].toString(16).padStart(2, '0');
                 try {
                   if (typeof window !== 'undefined') window.__NEUS_ALLOW_ETH_SIGN__ = true;
-                } catch {
-                  void 0;
-                }
-                signature = await provider.request({ method: 'eth_sign', params: [walletAddress, payloadHex], neusAllowEthSign: true });
-                try {
-                  if (typeof window !== 'undefined') delete window.__NEUS_ALLOW_ETH_SIGN__;
-                } catch {
-                  void 0;
+                  signature = await provider.request({ method: 'eth_sign', params: [walletAddress, payloadHex], neusAllowEthSign: true });
+                } finally {
+                  try { if (typeof window !== 'undefined') delete window.__NEUS_ALLOW_ETH_SIGN__; } catch { void 0; }
                 }
               } catch (fallbackErr) {
                 this._log('eth_sign fallback failed', { message: fallbackErr?.message || String(fallbackErr) });
-                try {
-                  if (typeof window !== 'undefined') delete window.__NEUS_ALLOW_ETH_SIGN__;
-                } catch {
-                  void 0;
-                }
                 throw e;
               }
             } else if (needsHex) {
@@ -1046,11 +1036,12 @@ export class NeusClient {
     return this._formatResponse(response);
   }
 
-  async getProof(proofId) {
-    if (!proofId || typeof proofId !== 'string') {
-      throw new ValidationError('proofId is required');
+  async getProof(qHash) {
+    const resolvedQHash = qHash; // Legacy input compatibility only. Do not expose or store proofId.
+    if (!resolvedQHash || typeof resolvedQHash !== 'string') {
+      throw new ValidationError('qHash is required');
     }
-    const response = await this._makeRequest('GET', `/api/v1/proofs/${proofId}`);
+    const response = await this._makeRequest('GET', `/api/v1/proofs/${resolvedQHash}`);
 
     if (!response.success) {
       throw new ApiError(`Failed to get proof: ${response.error?.message || 'Unknown error'}`, response.error);
@@ -1059,9 +1050,10 @@ export class NeusClient {
     return this._formatResponse(response);
   }
 
-  async getPrivateProof(proofId, wallet = null) {
-    if (!proofId || typeof proofId !== 'string') {
-      throw new ValidationError('proofId is required');
+  async getPrivateProof(qHash, wallet = null) {
+    const resolvedQHash = qHash; // Legacy input compatibility only. Do not expose or store proofId.
+    if (!resolvedQHash || typeof resolvedQHash !== 'string') {
+      throw new ValidationError('qHash is required');
     }
 
     const isPreSignedAuth = wallet &&
@@ -1078,7 +1070,7 @@ export class NeusClient {
         ...(typeof auth.chain === 'string' && auth.chain.trim() ? { 'x-chain': auth.chain.trim() } : {}),
         ...(typeof auth.signatureMethod === 'string' && auth.signatureMethod.trim() ? { 'x-signature-method': auth.signatureMethod.trim() } : {})
       };
-      const response = await this._makeRequest('GET', `/api/v1/proofs/${proofId}`, null, headers);
+      const response = await this._makeRequest('GET', `/api/v1/proofs/${resolvedQHash}`, null, headers);
       if (!response.success) {
         throw new ApiError(
           `Failed to access private proof: ${response.error?.message || 'Unauthorized'}`,
@@ -1102,7 +1094,7 @@ export class NeusClient {
     const message = constructVerificationMessage({
       walletAddress,
       signedTimestamp,
-      data: { action: 'access_private_proof', qHash: proofId },
+      data: { action: 'access_private_proof', qHash: resolvedQHash },
       verifierIds: ['ownership-basic'],
       ...(signerIsEvm ? { chainId: this._getHubChainId() } : { chain })
     });
@@ -1122,7 +1114,7 @@ export class NeusClient {
       throw new ValidationError(`Failed to sign message: ${error.message}`);
     }
 
-    const response = await this._makeRequest('GET', `/api/v1/proofs/${proofId}`, null, {
+    const response = await this._makeRequest('GET', `/api/v1/proofs/${resolvedQHash}`, null, {
       'x-wallet-address': walletAddress,
       'x-signature': signature,
       'x-signed-timestamp': signedTimestamp.toString(),
@@ -1171,15 +1163,16 @@ export class NeusClient {
     };
   }
 
-  async pollProofStatus(proofId, options = {}) {
+  async pollProofStatus(qHash, options = {}) {
+    const resolvedQHash = qHash; // Legacy input compatibility only. Do not expose or store proofId.
     const {
       interval = 5000,
       timeout = 120000,
       onProgress
     } = options;
 
-    if (!proofId || typeof proofId !== 'string') {
-      throw new ValidationError('proofId is required');
+    if (!resolvedQHash || typeof resolvedQHash !== 'string') {
+      throw new ValidationError('qHash is required');
     }
 
     const startTime = Date.now();
@@ -1187,7 +1180,7 @@ export class NeusClient {
 
     while (Date.now() - startTime < timeout) {
       try {
-        const status = await this.getProof(proofId);
+        const status = await this.getProof(resolvedQHash);
         consecutiveRateLimits = 0;
 
         if (onProgress && typeof onProgress === 'function') {
@@ -1239,9 +1232,10 @@ export class NeusClient {
     }
   }
 
-  async revokeOwnProof(proofId, wallet) {
-    if (!proofId || typeof proofId !== 'string') {
-      throw new ValidationError('proofId is required');
+  async revokeOwnProof(qHash, wallet) {
+    const resolvedQHash = qHash; // Legacy input compatibility only. Do not expose or store proofId.
+    if (!resolvedQHash || typeof resolvedQHash !== 'string') {
+      throw new ValidationError('qHash is required');
     }
     const providerWallet = wallet || this._getDefaultBrowserWallet();
     const { signerWalletAddress: address, provider } = await this._resolveWalletSigner(providerWallet);
@@ -1256,7 +1250,7 @@ export class NeusClient {
     const message = constructVerificationMessage({
       walletAddress: address,
       signedTimestamp,
-      data: { action: 'revoke_proof', qHash: proofId },
+      data: { action: 'revoke_proof', qHash: resolvedQHash },
       verifierIds: ['ownership-basic'],
       ...(signerIsEvm ? { chainId: this._getHubChainId() } : { chain })
     });
@@ -1276,15 +1270,11 @@ export class NeusClient {
       throw new ValidationError(`Failed to sign revocation: ${error.message}`);
     }
 
-    const res = await fetch(`${this.config.apiUrl}/api/v1/proofs/revoke-self/${proofId}`, {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify({
-        walletAddress: address,
-        signature,
-        signedTimestamp,
-        ...(signerIsEvm ? {} : { chain, signatureMethod })
-      })
+    const res = await this._makeRequest('POST', `/api/v1/proofs/revoke-self/${resolvedQHash}`, {
+      walletAddress: address,
+      signature,
+      signedTimestamp,
+      ...(signerIsEvm ? {} : { chain, signatureMethod })
     });
     const json = await res.json();
     if (!json.success) {
@@ -1476,6 +1466,7 @@ export class NeusClient {
     setIfPresent('primaryWalletAddress', params.primaryWalletAddress);
     setIfPresent('secondaryWalletAddress', params.secondaryWalletAddress);
     setIfPresent('verificationMethod', params.verificationMethod);
+    setIfPresent('neusPersonhoodId', params.neusPersonhoodId);
 
     let headersOverride = null;
     if (params.includePrivate === true) {
@@ -1771,20 +1762,13 @@ export class NeusClient {
   }
 
   _formatResponse(response) {
-    const proofId = response?.data?.proofId ||
-                    response?.proofId ||
-                    response?.data?.resource?.proofId ||
-                    response?.data?.qHash ||
-                    response?.qHash ||
-                    response?.data?.resource?.qHash ||
-                    response?.data?.id;
     const qHash = response?.data?.qHash ||
                   response?.qHash ||
                   response?.data?.resource?.qHash ||
-                  proofId ||
+                  response?.data?.proofId || // Legacy input compatibility only. Do not expose or store proofId.
+                  response?.proofId || // Legacy input compatibility only. Do not expose or store proofId.
+                  response?.data?.resource?.proofId || // Legacy input compatibility only. Do not expose or store proofId.
                   response?.data?.id;
-    const finalProofId = proofId || qHash || null;
-    const finalQHash = qHash || proofId || finalProofId;
 
     const status = response?.data?.status ||
                    response?.status ||
@@ -1793,13 +1777,12 @@ export class NeusClient {
 
     return {
       success: response.success,
-      proofId: finalProofId,
-      qHash: finalQHash,
+      qHash,
       status,
       data: response.data,
       message: response.message,
       timestamp: Date.now(),
-      proofUrl: finalProofId ? `${this.baseUrl}/api/v1/proofs/${finalProofId}` : null
+      proofUrl: qHash ? `${this.baseUrl}/api/v1/proofs/${qHash}` : null
     };
   }
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@neus/sdk",
-  "version": "1.0.8",
-  "description": "Portable trust receipts for people, apps, and agents. Verify once, check gates across surfaces.",
+  "version": "1.0.9",
+  "description": "Issue and check NEUS trust receipts across apps, agents, gates, payments, and workflows.",
   "bin": {
     "neus": "cli/neus.mjs"
   },
@@ -84,7 +84,6 @@
     "node": ">=20.0.0"
   },
   "peerDependencies": {
-    "@zkpassport/sdk": "0.13.1",
     "ethers": "^6.0.0",
     "react": ">=17.0.0",
     "react-dom": ">=17.0.0"
@@ -101,7 +100,7 @@
     }
   },
   "optionalDependencies": {
-    "@zkpassport/sdk": "0.13.1"
+    "@zkpassport/sdk": "^0.14.0"
   },
   "dependencies": {
     "bs58": "^6.0.0"

package/types.d.ts

@@ -10,9 +10,9 @@ declare module '@neus/sdk' {
     
     verify(params: VerifyParams): Promise<VerificationResult>;
     
-    getProof(proofId: string): Promise<StatusResult>;
-    
-    getPrivateProof(proofId: string, wallet?: WalletLike | GatePrivateAuth): Promise<StatusResult>;
+    getProof(qHash: string): Promise<StatusResult>;
+
+    getPrivateProof(qHash: string, wallet?: WalletLike | GatePrivateAuth): Promise<StatusResult>;
     
     isHealthy(): Promise<boolean>;
     
@@ -30,9 +30,9 @@ declare module '@neus/sdk' {
       label?: string;
     }): Promise<WalletLinkData>;
 
-    pollProofStatus(proofId: string, options?: PollOptions): Promise<StatusResult>;
+    pollProofStatus(qHash: string, options?: PollOptions): Promise<StatusResult>;
 
-    revokeOwnProof(proofId: string, wallet?: { address: string }): Promise<boolean>;
+    revokeOwnProof(qHash: string, wallet?: { address: string }): Promise<boolean>;
 
     getProofsByWallet(walletAddress: string, options?: GetProofsOptions): Promise<ProofsResult>;
 
@@ -109,16 +109,14 @@ declare module '@neus/sdk' {
   }
     
   export interface ProofResult {
-    proofId: string;
     qHash: string;
     status: string;
     walletAddress?: string;
     proofUrl?: string;
     crossChain?: boolean;
   }
-  
+
   export interface VerificationResult {
-    proofId: string;
     qHash: string;
     status: VerificationStatus;
     success: boolean;
@@ -126,13 +124,11 @@ declare module '@neus/sdk' {
   }
   
   export interface StatusResult {
-    proofId?: string;
     qHash?: string;
     proofUrl?: string | null;
     success: boolean;
     status: VerificationStatus;
     data?: {
-      proofId?: string;
       qHash?: string;
       status: string;
       walletAddress: string;
@@ -341,7 +337,7 @@ declare module '@neus/sdk' {
   };
   
   export class StatusPoller {
-    constructor(client: NeusClient, proofId: string, options?: { interval?: number; maxAttempts?: number; exponentialBackoff?: boolean; maxInterval?: number });
+    constructor(client: NeusClient, qHash: string, options?: { interval?: number; maxAttempts?: number; exponentialBackoff?: boolean; maxInterval?: number });
     poll(): Promise<StatusResult>;
   }
   
@@ -505,6 +501,8 @@ declare module '@neus/sdk' {
     primaryWalletAddress?: string;
     secondaryWalletAddress?: string;
     verificationMethod?: string;
+    /** Personhood ID for proof-of-human sybil resistance matching (0x-prefixed 64-hex-char SHA-256 digest) */
+    neusPersonhoodId?: string;
   }
 
   export interface GatePrivateAuth {
@@ -521,7 +519,6 @@ declare module '@neus/sdk' {
       eligible: boolean;
       matchedCount?: number;
       matchedQHashes?: string[];
-      matchedProofIds?: string[];
       matchedTags?: string[];
       projections?: Array<Record<string, any>> | null;
       criteria?: Record<string, any>;
@@ -790,9 +787,7 @@ declare module '@neus/sdk/widgets' {
   export interface VerifyGateProps {
     requiredVerifiers?: string[];
     onVerified?: (result: {
-      proofId: string;
       qHash: string;
-      proofIds?: string[];
       qHashes?: string[];
       address?: string;
       txHash?: string | null;
@@ -805,7 +800,6 @@ declare module '@neus/sdk/widgets' {
       data?: any;
       results?: Array<{
         verifierId: string;
-        proofId: string;
         qHash: string;
         address?: string;
         txHash?: string | null;
@@ -833,7 +827,6 @@ declare module '@neus/sdk/widgets' {
     disabled?: boolean;
     buttonText?: string;
     mode?: 'create' | 'access';
-    proofId?: string | null;
     qHash?: string | null;
     wallet?: WalletLike | any;
     chain?: string;
@@ -845,7 +838,6 @@ declare module '@neus/sdk/widgets' {
   export function VerifyGate(props: VerifyGateProps): any;
 
   export interface ProofBadgeProps {
-    proofId?: string;
     qHash?: string;
     proofUrlPattern?: string;
     size?: 'sm' | 'md';
@@ -855,14 +847,13 @@ declare module '@neus/sdk/widgets' {
     showChains?: boolean;
     showLabel?: boolean;
     logoUrl?: string;
-    onClick?: (data: { proofId: string; qHash: string; status: string; chainCount?: number }) => void;
+    onClick?: (data: { qHash: string; status: string; chainCount?: number }) => void;
     className?: string;
   }
 
   export function ProofBadge(props: ProofBadgeProps): any;
 
   export interface SimpleProofBadgeProps {
-    proofId?: string;
     qHash?: string;
     proofUrlPattern?: string;
     uiLinkBase?: string;
@@ -871,35 +862,33 @@ declare module '@neus/sdk/widgets' {
     label?: string;
     logoUrl?: string;
     proof?: any;
-    onClick?: (data: { proofId: string; qHash: string; status: string }) => void;
+    onClick?: (data: { qHash: string; status: string }) => void;
     className?: string;
   }
 
   export function SimpleProofBadge(props: SimpleProofBadgeProps): any;
 
   export interface NeusPillLinkProps {
-    proofId?: string;
     qHash?: string;
     proofUrlPattern?: string;
     uiLinkBase?: string;
     label?: string;
     size?: 'sm' | 'md';
     logoUrl?: string;
-    onClick?: (data: { proofId?: string; qHash?: string }) => void;
+    onClick?: (data: { qHash?: string }) => void;
     className?: string;
   }
 
   export function NeusPillLink(props: NeusPillLinkProps): any;
 
   export interface VerifiedIconProps {
-    proofId?: string;
     qHash?: string;
     proofUrlPattern?: string;
     uiLinkBase?: string;
     size?: number;
     logoUrl?: string;
     tooltip?: string;
-    onClick?: (data: { proofId?: string; qHash?: string }) => void;
+    onClick?: (data: { qHash?: string }) => void;
     className?: string;
   }
 

package/widgets/README.md

@@ -35,7 +35,7 @@ export function Page() {
 ```jsx
 import { ProofBadge } from '@neus/sdk/widgets';
 
-<ProofBadge proofId="0x..." showChains />
+<ProofBadge qHash="0x..." showChains />
 ```
 
 ## Docs