@neus/sdk 1.0.1 → 1.0.3

package/types.d.ts

@@ -3,6 +3,20 @@
  */
 
 declare module '@neus/sdk' {
+  /**
+   * Minimal EIP-1193 provider interface (browser wallets like MetaMask).
+   * The SDK also supports other wallet objects; use this for typing in integrations.
+   */
+  export interface Eip1193Provider {
+    request(args: { method: string; params?: unknown[] | Record<string, unknown> }): Promise<unknown>;
+  }
+
+  /**
+   * Wallet/provider object accepted by SDK methods that require signing.
+   * Prefer passing an EIP-1193 provider in browser environments.
+   */
+  export type WalletLike = Eip1193Provider | { address?: string } | { getAddress?: () => Promise<string> } | { signMessage?: (message: string) => Promise<string> };
+
   /**
    * Main NEUS SDK client for creating and verifying proofs
    */
@@ -18,17 +32,17 @@ declare module '@neus/sdk' {
     
     /**
      * Get verification status by proof ID
-     * @param qHash - Proof ID (wire field: qHash)
+     * @param proofId - Proof ID (standard). `qHash` is a deprecated alias (same value).
      * @returns Promise resolving to current status
      */
-    getStatus(qHash: string): Promise<StatusResult>;
+    getStatus(proofId: string): Promise<StatusResult>;
     
     /**
      * Get private proof status (owner-signed)
-     * @param qHash - Proof ID (wire field: qHash)
+     * @param proofId - Proof ID (standard). `qHash` is a deprecated alias (same value).
      * @param wallet - Optional injected wallet/provider (MetaMask/ethers Wallet)
      */
-    getPrivateStatus(qHash: string, wallet?: any): Promise<StatusResult>;
+    getPrivateStatus(proofId: string, wallet?: WalletLike | GatePrivateAuth): Promise<StatusResult>;
     
     /**
      * Check API health
@@ -41,24 +55,24 @@ declare module '@neus/sdk' {
     
   /**
    * Poll verification status until completion
-   * @param qHash - Proof ID (wire field: qHash)
+   * @param proofId - Proof ID (standard). `qHash` is a deprecated alias (same value).
    * @param options - Polling configuration options
    * @returns Promise resolving to final status
    * @example
-   * const finalStatus = await client.pollProofStatus(qHash, {
+   * const finalStatus = await client.pollProofStatus(proofId, {
    *   interval: 3000,
    *   onProgress: (status) => {
    *     // Handle status updates
    *   }
    * });
    */
-   pollProofStatus(qHash: string, options?: PollOptions): Promise<StatusResult>;
+   pollProofStatus(proofId: string, options?: PollOptions): Promise<StatusResult>;
     
     /** Revoke own proof (owner-signed) */
-    revokeOwnProof(qHash: string, wallet?: { address: string }): Promise<boolean>;
+    revokeOwnProof(proofId: string, wallet?: { address: string }): Promise<boolean>;
 
     // ═══════════════════════════════════════════════════════════════
-    // GATE & LOOKUP METHODS
+    // PROOFS & GATING METHODS
     // ═══════════════════════════════════════════════════════════════
 
     /**
@@ -73,7 +87,7 @@ declare module '@neus/sdk' {
      * Get proofs by wallet or DID (owner access)
      * Requests private proofs using owner signature headers.
      */
-    getPrivateProofsByWallet(walletAddress: string, options?: GetProofsOptions, wallet?: any): Promise<ProofsResult>;
+    getPrivateProofsByWallet(walletAddress: string, options?: GetProofsOptions, wallet?: WalletLike): Promise<ProofsResult>;
 
     /**
      * Minimal eligibility check against public + discoverable proofs only (API-backed).
@@ -82,10 +96,14 @@ declare module '@neus/sdk' {
     gateCheck(params: GateCheckApiParams): Promise<GateCheckApiResponse>;
 
     /**
-     * Non-persistent lookup mode (API-backed, server-side only).
-     * Requires Premium API key and does NOT mint/store proofs.
+     * Pre-sign owner auth payload for repeated includePrivate gate checks (single prompt).
      */
-    lookup(params: LookupParams): Promise<LookupApiResponse>;
+    createGatePrivateAuth(params: {
+      address: string;
+      wallet?: WalletLike;
+      chain?: string;
+      signatureMethod?: string;
+    }): Promise<GatePrivateAuth>;
 
     /**
      * Evaluate gate requirements against existing proofs
@@ -117,10 +135,20 @@ declare module '@neus/sdk' {
   export interface NeusClientConfig {
     /** API endpoint URL (defaults to hosted public API) */
     apiUrl?: string;
-    /** Optional premium API key (server-side only; do not embed in browser apps) */
+    /** Optional API key (server-side only; do not embed in browser apps) */
     apiKey?: string;
+    /** Optional public app attribution ID (maps to X-Neus-App) */
+    appId?: string;
+    /** Optional sponsor capability token (maps to X-Sponsor-Grant) */
+    sponsorGrant?: string;
+    /** Optional x402 receipt token for retry calls (maps to PAYMENT-SIGNATURE) */
+    paymentSignature?: string;
+    /** Optional extra passthrough headers for advanced integrations */
+    extraHeaders?: Record<string, string>;
     /** Request timeout in milliseconds */
     timeout?: number;
+    /** Optional chain override used by some app integrations */
+    hubChainId?: number;
     /** Enable SDK logging */
     enableLogging?: boolean;
   }
@@ -168,19 +196,21 @@ declare module '@neus/sdk' {
     signedTimestamp?: number;
     /** Advanced/manual path: chain ID for verification context; optional, managed by protocol */
     chainId?: number;
-    /** Reserved (preview): non-EVM chain context as "namespace:reference" (not part of the stable public path) */
+    /** CAIP-2 chain reference for universal mode (e.g. eip155:1, solana:mainnet) */
     chain?: string;
-    /** Reserved (preview): signature method hint (not part of the stable public path) */
+    /** Signature method hint for universal mode (eip191, ed25519, ...) */
     signatureMethod?: string;
     /** Auto path: optional wallet instance (browser/provider) */
-    wallet?: any;
+    wallet?: WalletLike;
   }
     
   /**
    * Result from proof creation
    */
   export interface ProofResult {
-    /** Proof ID (qHash) */
+    /** Proof ID (standard) */
+    proofId: string;
+    /** @deprecated qHash is a deprecated alias of proofId (same value). */
     qHash: string;
     /** Current status */
     status: string;
@@ -196,7 +226,9 @@ declare module '@neus/sdk' {
    * Verification result
    */
   export interface VerificationResult {
-    /** Proof ID (qHash) */
+    /** Proof ID (standard) */
+    proofId: string;
+    /** @deprecated qHash is a deprecated alias of proofId (same value). */
     qHash: string;
     /** Current status */
     status: VerificationStatus;
@@ -210,13 +242,19 @@ declare module '@neus/sdk' {
    * Status check result
    */
   export interface StatusResult {
+    /** Proof ID (standard) */
+    proofId?: string;
+    /** @deprecated qHash is a deprecated alias of proofId (same value). */
+    qHash?: string;
     /** Whether verification succeeded */
     success: boolean;
     /** Current status */
     status: VerificationStatus;
     /** Full verification data */
     data?: {
-      qHash: string;
+      proofId?: string;
+      /** @deprecated qHash is a deprecated alias of proofId (same value). */
+      qHash?: string;
       status: string;
       walletAddress: string;
       verifierIds?: string[];
@@ -312,13 +350,16 @@ declare module '@neus/sdk' {
   export type CoreVerifierId =
     // Public verifiers (auto-path via verify())
     | 'ownership-basic'
+    | 'ownership-social'       // Hosted OAuth social ownership
     | 'ownership-pseudonym'    // Pseudonymous identity verification
+    | 'ownership-org-oauth'    // Hosted OAuth organization ownership
     | 'nft-ownership'
     | 'token-holding'
     | 'ownership-dns-txt'
     | 'wallet-link'
     | 'contract-ownership'
     | 'wallet-risk'            // Wallet risk assessment
+    | 'proof-of-human'         // Hosted ZK personhood verification
     // AI & Agent verifiers (ERC-8004 aligned)
     | 'agent-identity'
     | 'agent-delegation'
@@ -366,13 +407,19 @@ declare module '@neus/sdk' {
     signedTimestamp: number;
     data: any;
     verifierIds: VerifierId[];
-    chainId: number;
+    chainId?: number;
+    chain?: string;
   }): string;
   
   /**
    * Validate Ethereum wallet address
    */
   export function validateWalletAddress(address: string): boolean;
+
+  /**
+   * Validate universal wallet address format (EVM/non-EVM).
+   */
+  export function validateUniversalAddress(address: string, chain?: string): boolean;
   
   /**
    * Validate timestamp freshness
@@ -380,7 +427,7 @@ declare module '@neus/sdk' {
   export function validateTimestamp(timestamp: number, maxAgeMs?: number): boolean;
   
   /**
-   * Validate Proof ID (qHash) format
+   * Validate Proof ID format (`qHash` wire alias)
    */
   export function validateQHash(qHash: string): boolean;
   
@@ -389,6 +436,71 @@ declare module '@neus/sdk' {
    */
   export function normalizeAddress(address: string): string;
 
+  /**
+   * Resolve DID from wallet identity via profile resolver endpoint.
+   * Use `chainId` for EVM wallets and `chain` (CAIP-2) for non-EVM wallets
+   * such as Solana (`solana:mainnet`).
+   */
+  export function resolveDID(
+    params: {
+      walletAddress?: string;
+      chainId?: number;
+      chain?: string;
+    },
+    options?: {
+      endpoint?: string;
+      apiUrl?: string;
+      credentials?: 'omit' | 'same-origin' | 'include';
+      headers?: Record<string, string>;
+    }
+  ): Promise<{
+    did: string;
+    data: unknown;
+    raw: unknown;
+  }>;
+
+  /**
+   * Build a server-standardized signing payload.
+   */
+  export function standardizeVerificationRequest(
+    params: Record<string, any>,
+    options?: {
+      endpoint?: string;
+      apiUrl?: string;
+      credentials?: 'omit' | 'same-origin' | 'include';
+      headers?: Record<string, string>;
+    }
+  ): Promise<any>;
+
+  /**
+   * Resolve ZK Passport default configuration.
+   */
+  export function resolveZkPassportConfig(overrides?: Record<string, any>): {
+    provider: string;
+    scope: string;
+    checkSanctions: boolean;
+    requireFaceMatch: boolean;
+    faceMatchMode: string;
+    [key: string]: any;
+  };
+
+  /**
+   * Convert a UTF-8 message string to a 0x-prefixed hex payload.
+   */
+  export function toHexUtf8(message: string): string;
+
+  /**
+   * Sign a message with an injected/provider wallet.
+   * Uses `personal_sign` and retries with UTF-8 hex payloads when providers
+   * report encoding/non-hex input issues (common with some embedded wallets).
+   */
+  export function signMessage(params: {
+    provider?: any;
+    message: string;
+    walletAddress?: string;
+    chain?: string;
+  }): Promise<string>;
+
   /**
    * Validate a verifier payload for basic structural integrity
    */
@@ -402,9 +514,10 @@ declare module '@neus/sdk' {
     data: any;
     walletAddress: string;
     chainId?: number;
+    chain?: string;
     options?: any;
     signedTimestamp?: number;
-  }): { message: string; request: { verifierIds: string[]; data: any; walletAddress: string; signedTimestamp: number; chainId: number; options?: any } };
+  }): { message: string; request: { verifierIds: string[]; data: any; walletAddress: string; signedTimestamp: number; chainId?: number; chain?: string; options?: any } };
   
   /**
    * Check if status is terminal (complete)
@@ -435,7 +548,7 @@ declare module '@neus/sdk' {
    * Status polling utility
    */
   export class StatusPoller {
-    constructor(client: NeusClient, qHash: string, options?: { interval?: number; maxAttempts?: number; exponentialBackoff?: boolean; maxInterval?: number });
+    constructor(client: NeusClient, proofId: string, options?: { interval?: number; maxAttempts?: number; exponentialBackoff?: boolean; maxInterval?: number });
     poll(): Promise<StatusResult>;
   }
   
@@ -467,7 +580,7 @@ declare module '@neus/sdk' {
   /**
    * Proof status
    */
-  // Use NeusClient.getStatus(qHash) for status checks.
+  // Use NeusClient.getStatus(proofId) for status checks (`qHash` remains as deprecated alias).
   
   
   // ============================================================================
@@ -548,7 +661,7 @@ declare module '@neus/sdk' {
   
   
   // ============================================================================
-  // GATE & LOOKUP TYPES
+  // PROOFS & GATING TYPES
   // ============================================================================
 
   /**
@@ -559,6 +672,10 @@ declare module '@neus/sdk' {
     limit?: number;
     /** Offset for pagination */
     offset?: number;
+    /** CAIP-2 signer chain for owner-signed private access (non-EVM) */
+    chain?: string;
+    /** Signature method hint for owner-signed private access (eip191, ed25519, ...) */
+    signatureMethod?: string;
   }
 
   /**
@@ -616,10 +733,10 @@ declare module '@neus/sdk' {
 
   /**
    * Parameters for gateCheck() (API-backed).
-   * Mirrors `GET /api/v1/proofs/gate/check` query parameters.
+   * Mirrors `GET /api/v1/proofs/check` query parameters.
    */
   export interface GateCheckApiParams {
-    /** Wallet address to check (0x...) */
+    /** Wallet identity to check (EVM/Solana/NEAR) */
     address: string;
     /** Verifier IDs to match (array or comma-separated string) */
     verifierIds?: string[] | string;
@@ -633,6 +750,18 @@ declare module '@neus/sdk' {
     since?: number;
     /** Max rows to scan (server may clamp) */
     limit?: number;
+    /** Include private proofs for owner-authenticated checks */
+    includePrivate?: boolean;
+    /** Include matched qHashes in response (minimal identifiers only) */
+    includeQHashes?: boolean;
+    /** Optional wallet/provider used to sign includePrivate owner checks */
+    wallet?: WalletLike;
+    /** CAIP-2 signer chain for universal owner signatures (e.g. solana:mainnet) */
+    chain?: string;
+    /** Signature method hint for universal owner signatures (eip191, ed25519, ...) */
+    signatureMethod?: string;
+    /** Optional pre-signed owner auth payload to reuse across multiple gateCheck calls */
+    privateAuth?: GatePrivateAuth;
 
     // Common match filters
     referenceType?: string;
@@ -650,9 +779,9 @@ declare module '@neus/sdk' {
     domain?: string;
     minBalance?: string;
 
-    // Social / wallet filters
+    // Wallet filters
+    /** Risk assessment provider hint. Known value: webacy. */
     provider?: string;
-    handle?: string;
     ownerAddress?: string;
     riskLevel?: string;
     sanctioned?: boolean;
@@ -660,12 +789,14 @@ declare module '@neus/sdk' {
     primaryWalletAddress?: string;
     secondaryWalletAddress?: string;
     verificationMethod?: string;
+  }
 
-    // Trait checks + projections
-    traitPath?: string;
-    traitGte?: number;
-    /** Comma-separated projection fields (handle,provider,profileUrl,traits.<key>) */
-    select?: string[] | string;
+  export interface GatePrivateAuth {
+    walletAddress: string;
+    signature: string;
+    signedTimestamp: number;
+    chain?: string;
+    signatureMethod?: string;
   }
 
   export interface GateCheckApiResponse {
@@ -674,6 +805,8 @@ declare module '@neus/sdk' {
       eligible: boolean;
       matchedCount?: number;
       matchedQHashes?: string[];
+      /** @deprecated matchedProofIds is a legacy alias of matchedQHashes (same values when provided). */
+      matchedProofIds?: string[];
       matchedTags?: string[];
       projections?: Array<Record<string, any>> | null;
       criteria?: Record<string, any>;
@@ -681,38 +814,6 @@ declare module '@neus/sdk' {
     error?: any;
   }
 
-  /**
-   * Parameters for lookup() (API-backed).
-   * Mirrors `POST /api/v1/verification/lookup` body.
-   */
-  export interface LookupParams {
-    /** Premium API key (sk_live_... or sk_test_...) */
-    apiKey: string;
-    /** Verifiers to run (external_lookup only) */
-    verifierIds: string[];
-    /** Wallet to evaluate */
-    targetWalletAddress: string;
-    /** Verifier input data (e.g., contractAddress/tokenId/chainId) */
-    data?: Record<string, any>;
-  }
-
-  export interface LookupApiResponse {
-    success: boolean;
-    data?: {
-      mode: 'lookup';
-      requestId: string;
-      targetWalletAddress: string;
-      payerWallet: string;
-      verifierIds: string[];
-      verified: boolean;
-      results: any[];
-      timing?: {
-        startedAt: number;
-        durationMs: number;
-      };
-    };
-    error?: any;
-  }
 
   export interface ApiResponse<T = any> {
     success: boolean;
@@ -778,12 +879,27 @@ declare module '@neus/sdk' {
   // SUPPORTING TYPES
   // ============================================================================
   
-  interface VerificationData {
-    content?: string;
+  type OwnershipBasicData = {
     owner: string;
+    content?: string;
+    contentHash?: string;
+    contentType?: string;
     reference?: {
-      type: string;
-      /** Optional reference identifier (required only for reference-only proofs). */
+      type:
+        | 'ipfs'
+        | 'ipfs-hash'
+        | 'url'
+        | 'license-nft'
+        | 'contract'
+        | 'qhash'
+        | 'ethereum-tx'
+        | 'on-chain-tx'
+        | 'tx'
+        | 'file'
+        | 'doc'
+        | 'media'
+        | 'username-claim'
+        | 'other';
       id?: string;
       title?: string;
       description?: string;
@@ -791,8 +907,136 @@ declare module '@neus/sdk' {
       name?: string;
       size?: number;
     };
+    provenance?: {
+      declaredKind?: 'human' | 'ai' | 'mixed' | 'unknown';
+      aiContext?: {
+        generatorType?: 'local' | 'saas' | 'agent';
+        provider?: string;
+        model?: string;
+        runId?: string;
+      };
+    };
     [key: string]: any;
-  }
+  };
+
+  type OwnershipPseudonymData = {
+    pseudonymId: string;
+    namespace?: string;
+    displayName?: string;
+    metadata?: Record<string, any>;
+    [key: string]: any;
+  };
+
+  type OwnershipDnsTxtData = {
+    domain: string;
+    walletAddress?: string;
+    [key: string]: any;
+  };
+
+  type ContractOwnershipData = {
+    contractAddress: string;
+    chainId: number;
+    walletAddress?: string;
+    method?: 'owner' | 'admin' | 'accessControl';
+    [key: string]: any;
+  };
+
+  type NftOwnershipData = {
+    ownerAddress?: string;
+    contractAddress: string;
+    tokenId: string;
+    tokenType?: 'erc721' | 'erc1155';
+    chainId: number;
+    blockNumber?: number;
+    [key: string]: any;
+  };
+
+  type TokenHoldingData = {
+    ownerAddress?: string;
+    contractAddress: string;
+    minBalance: string;
+    chainId: number;
+    blockNumber?: number;
+    [key: string]: any;
+  };
+
+  type WalletRiskData = {
+    /** Risk assessment provider hint. Known value: webacy. */
+    provider?: string;
+    walletAddress?: string;
+    chainId?: number;
+    includeDetails?: boolean;
+    [key: string]: any;
+  };
+
+  type WalletLinkData = {
+    primaryWalletAddress: string;
+    secondaryWalletAddress: string;
+    signature: string;
+    chain: string;
+    signatureMethod: string;
+    signedTimestamp: number;
+    relationshipType?: 'primary' | 'personal' | 'org' | 'affiliate' | 'agent' | 'linked';
+    label?: string;
+    [key: string]: any;
+  };
+
+  type AiContentModerationData = {
+    content: string;
+    contentType:
+      | 'image/jpeg'
+      | 'image/png'
+      | 'image/webp'
+      | 'image/gif'
+      | 'text/plain'
+      | 'text/markdown'
+      | 'text/x-markdown'
+      | 'application/json'
+      | 'application/xml';
+    provider?: 'google-vision' | 'google-perspective';
+    [key: string]: any;
+  };
+
+  type AgentIdentityData = {
+    agentId: string;
+    agentWallet: string;
+    agentLabel?: string;
+    agentType?: 'ai' | 'bot' | 'service' | 'automation' | 'agent';
+    description?: string;
+    capabilities?: any[];
+    [key: string]: any;
+  };
+
+  type AgentDelegationData = {
+    controllerWallet: string;
+    agentWallet: string;
+    agentId?: string;
+    scope?: string;
+    permissions?: any[];
+    maxSpend?: string;
+    allowedPaymentTypes?: string[];
+    receiptDisclosure?: 'none' | 'summary' | 'full';
+    expiresAt?: number;
+    [key: string]: any;
+  };
+
+  type CoreVerificationData =
+    | OwnershipBasicData
+    | OwnershipPseudonymData
+    | OwnershipDnsTxtData
+    | ContractOwnershipData
+    | NftOwnershipData
+    | TokenHoldingData
+    | WalletRiskData
+    | WalletLinkData
+    | AiContentModerationData
+    | AgentIdentityData
+    | AgentDelegationData;
+
+  type VerificationData =
+    | CoreVerificationData
+    | Record<string, CoreVerificationData>
+    | Record<string, any>;
 
   
   
@@ -869,7 +1113,11 @@ declare module '@neus/sdk/widgets' {
     requiredVerifiers?: string[];
     /** Callback when verification completes successfully */
     onVerified?: (result: {
+      proofId: string;
+      /** @deprecated qHash is a deprecated alias of proofId (same value). */
       qHash: string;
+      proofIds?: string[];
+      /** @deprecated qHashes is a deprecated alias of proofIds (same values). */
       qHashes?: string[];
       address?: string;
       txHash?: string | null;
@@ -877,10 +1125,13 @@ declare module '@neus/sdk/widgets' {
       verifiedVerifiers?: any[];
       statusUrl?: string | null;
       existing?: boolean;
+      eligible?: boolean;
       mode?: 'create' | 'access';
       data?: any;
       results?: Array<{
         verifierId: string;
+        proofId: string;
+        /** @deprecated qHash is a deprecated alias of proofId (same value). */
         qHash: string;
         address?: string;
         txHash?: string | null;
@@ -891,6 +1142,16 @@ declare module '@neus/sdk/widgets' {
     }) => void;
     /** Custom API endpoint URL */
     apiUrl?: string;
+    /** Optional public app attribution ID (maps to X-Neus-App) */
+    appId?: string;
+    /** Optional sponsor capability token (maps to X-Sponsor-Grant) */
+    sponsorGrant?: string;
+    /** Optional x402 receipt token for retry calls (maps to PAYMENT-SIGNATURE) */
+    paymentSignature?: string;
+    /** Optional extra passthrough headers for advanced integrations */
+    extraHeaders?: Record<string, string>;
+    /** Hosted checkout URL for interactive verifiers (default: https://neus.network/verify) */
+    hostedCheckoutUrl?: string;
     /** Custom inline styles */
     style?: Record<string, any>;
     /** Child content to show when verified */
@@ -917,8 +1178,16 @@ declare module '@neus/sdk/widgets' {
     buttonText?: string;
     /** Mode: 'create' for new verification, 'access' for private proof access */
     mode?: 'create' | 'access';
-    /** qHash for private proof access (required when mode='access') */
+    /** proofId for private proof access (required when mode='access') */
+    proofId?: string | null;
+    /** @deprecated qHash is a deprecated alias of proofId (same value). */
     qHash?: string | null;
+    /** Optional injected wallet/provider for signing flows */
+    wallet?: WalletLike | any;
+    /** Optional CAIP-2 chain context for non-EVM owner signatures */
+    chain?: string;
+    /** Optional signature method hint for non-EVM owner signatures */
+    signatureMethod?: string;
     /** Callback for state changes */
     onStateChange?: (state: string) => void;
     /** Callback for errors */
@@ -928,8 +1197,12 @@ declare module '@neus/sdk/widgets' {
   export function VerifyGate(props: VerifyGateProps): any;
 
   export interface ProofBadgeProps {
-    /** Proof ID (qHash) */
-    qHash: string;
+    /** Proof ID (standard). Provide either proofId or qHash. */
+    proofId?: string;
+    /** @deprecated qHash is a deprecated alias of proofId (same value). */
+    qHash?: string;
+    /** URL path pattern for proof links. Supports :proofId and legacy :qHash tokens. */
+    proofUrlPattern?: string;
     /** Badge size */
     size?: 'sm' | 'md';
     /** UI platform base URL */
@@ -942,8 +1215,10 @@ declare module '@neus/sdk/widgets' {
     showChains?: boolean;
     /** Show status label (default: true) */
     showLabel?: boolean;
+    /** Logo URL override (defaults to bundled NEUS logo) */
+    logoUrl?: string;
     /** Custom click handler */
-    onClick?: (data: { qHash: string; status: string; chainCount?: number }) => void;
+    onClick?: (data: { proofId: string; qHash: string; status: string; chainCount?: number }) => void;
     /** Additional CSS class */
     className?: string;
   }
@@ -951,41 +1226,59 @@ declare module '@neus/sdk/widgets' {
   export function ProofBadge(props: ProofBadgeProps): any;
 
   export interface SimpleProofBadgeProps {
-    qHash: string;
+    proofId?: string;
+    /** @deprecated qHash is a deprecated alias of proofId (same value). */
+    qHash?: string;
+    /** URL path pattern for proof links. Supports :proofId and legacy :qHash tokens. */
+    proofUrlPattern?: string;
     uiLinkBase?: string;
     apiUrl?: string;
     size?: 'sm' | 'md';
     /** Label text (default: 'Verified') */
     label?: string;
+    /** Logo URL override (defaults to bundled NEUS logo) */
+    logoUrl?: string;
     proof?: any;
-    onClick?: (data: { qHash: string; status: string }) => void;
+    onClick?: (data: { proofId: string; qHash: string; status: string }) => void;
     className?: string;
   }
 
   export function SimpleProofBadge(props: SimpleProofBadgeProps): any;
 
   export interface NeusPillLinkProps {
+    proofId?: string;
+    /** @deprecated qHash is a deprecated alias of proofId (same value). */
     qHash?: string;
+    /** URL path pattern for proof links. Supports :proofId and legacy :qHash tokens. */
+    proofUrlPattern?: string;
     uiLinkBase?: string;
     label?: string;
     size?: 'sm' | 'md';
-    onClick?: (data: { qHash?: string }) => void;
+    /** Logo URL override (defaults to bundled NEUS logo) */
+    logoUrl?: string;
+    onClick?: (data: { proofId?: string; qHash?: string }) => void;
     className?: string;
   }
 
   export function NeusPillLink(props: NeusPillLinkProps): any;
 
   export interface VerifiedIconProps {
-    /** Proof ID (qHash) for link */
+    /** Proof ID (standard) for link */
+    proofId?: string;
+    /** @deprecated qHash is a deprecated alias of proofId (same value). */
     qHash?: string;
+    /** URL path pattern for proof links. Supports :proofId and legacy :qHash tokens. */
+    proofUrlPattern?: string;
     /** UI platform base URL */
     uiLinkBase?: string;
     /** Icon size in pixels */
     size?: number;
+    /** Logo URL override (defaults to bundled NEUS logo) */
+    logoUrl?: string;
     /** Tooltip text */
     tooltip?: string;
     /** Custom click handler */
-    onClick?: (data: { qHash?: string }) => void;
+    onClick?: (data: { proofId?: string; qHash?: string }) => void;
     /** Additional CSS class */
     className?: string;
   }
@@ -995,4 +1288,8 @@ declare module '@neus/sdk/widgets' {
 
 declare module '@neus/sdk/widgets/verify-gate' {
   export * from '@neus/sdk/widgets';
-}
+}
+
+declare module '@neus/sdk/client' {
+  export { NeusClient } from '@neus/sdk';
+}