noah-avalanche-sdk 0.1.2

package/dist/hooks/useUser.d.ts

@@ -0,0 +1,159 @@
+import type { Signer } from 'ethers';
+import { UserClient, type Credential as UserCredential } from '../user/UserClient';
+import type { Requirements, TransactionResult, ZKProof } from '../utils/types';
+/**
+ * Configuration options for useUser hook
+ */
+export interface UseUserOptions {
+    /** User's wallet address */
+    userAddress?: string;
+    /** Protocol address to check requirements/access for */
+    protocolAddress?: string;
+    /** Credential hash to check validity for */
+    credentialHash?: string;
+    /** Whether to enable automatic refetching */
+    enabled?: boolean;
+    /** React Query configuration options */
+    queryOptions?: {
+        refetchInterval?: number;
+        staleTime?: number;
+    };
+}
+/**
+ * Credential structure (re-exported from UserClient for convenience)
+ */
+export type Credential = UserCredential;
+/**
+ * Return type for useUser hook
+ */
+export interface UseUserReturn {
+    user: UserClient | null;
+    protocolRequirements: Requirements | undefined;
+    isLoadingRequirements: boolean;
+    requirementsError: Error | null;
+    refetchRequirements: () => void;
+    isCredentialValid: boolean | undefined;
+    isLoadingCredential: boolean;
+    credentialError: Error | null;
+    refetchCredential: () => void;
+    checkCredentialValidity: {
+        mutate: (credentialHash: string) => void;
+        mutateAsync: (credentialHash: string) => Promise<boolean>;
+        isLoading: boolean;
+        error: Error | null;
+        reset: () => void;
+    };
+    generateProof: {
+        mutate: (params: {
+            credential: Credential;
+            requirements: Requirements & {
+                protocolAddress: string;
+            };
+        }) => void;
+        mutateAsync: (params: {
+            credential: Credential;
+            requirements: Requirements & {
+                protocolAddress: string;
+            };
+        }) => Promise<{
+            proof: ZKProof;
+            publicSignals: string[];
+            nullifier: string;
+            packedFlags: number;
+            credentialHash: string;
+            success: boolean;
+        }>;
+        isLoading: boolean;
+        error: Error | null;
+        reset: () => void;
+    };
+    verifyAndGrantAccess: {
+        mutate: (params: {
+            proof: ZKProof;
+            publicSignals: string[];
+            nullifier: string;
+            packedFlags: number;
+            credentialHash: string;
+            protocolAddress?: string;
+            userAddress?: string;
+        }) => void;
+        mutateAsync: (params: {
+            proof: ZKProof;
+            publicSignals: string[];
+            nullifier: string;
+            packedFlags: number;
+            credentialHash: string;
+            protocolAddress?: string;
+            userAddress?: string;
+        }) => Promise<TransactionResult>;
+        isLoading: boolean;
+        error: Error | null;
+        reset: () => void;
+    };
+}
+/**
+ * React hook for user operations
+ *
+ * Provides easy access to user-related functionality including:
+ * - Getting protocol requirements
+ * - Checking credential validity
+ * - Generating ZK proofs
+ * - Verifying proofs and granting access to protocols
+ *
+ * @param signer - Ethers signer instance (from wallet)
+ * @param options - Configuration options
+ * @returns Hook return object with user operations
+ *
+ * @example
+ * ```tsx
+ * import { useUser } from '@noah-protocol/sdk/hooks';
+ * import { useSigner, useAccount } from 'wagmi';
+ *
+ * function UserDashboard() {
+ *   const { data: signer } = useSigner();
+ *   const { address } = useAccount();
+ *   const {
+ *     protocolRequirements,
+ *     generateProof,
+ *     verifyAndGrantAccess,
+ *     hasAccess
+ *   } = useUser(signer, {
+ *     userAddress: address,
+ *     protocolAddress: '0x...',
+ *     apiBaseUrl: 'https://api.noah.xyz'
+ *   });
+ *
+ *   const handleGenerateProof = async () => {
+ *     const result = await generateProof.mutateAsync({
+ *       credential: {
+ *         actualAge: 25,
+ *         actualJurisdiction: 'US',
+ *         actualAccredited: true,
+ *         credentialHash: '0x...'
+ *       },
+ *       requirements: protocolRequirements!
+ *     });
+ *
+ *     await verifyAndGrantAccess.mutateAsync({
+ *       ...result,
+ *       credentialHash: '0x...',
+ *       protocolAddress: '0x...'
+ *     });
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       {hasAccess ? (
+ *         <p>You have access!</p>
+ *       ) : (
+ *         <button onClick={handleGenerateProof}>
+ *           Request Access
+ *         </button>
+ *       )}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useUser(signer: Signer | null | undefined, options?: UseUserOptions): UseUserReturn;
+//# sourceMappingURL=useUser.d.ts.map

package/dist/hooks/useUser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUser.d.ts","sourceRoot":"","sources":["../../src/hooks/useUser.ts"],"names":[],"mappings":"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"}

package/dist/hooks/useUser.js

@@ -0,0 +1,188 @@
+import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query';
+import { useMemo } from 'react';
+import { UserClient } from '../user/UserClient';
+/**
+ * React hook for user operations
+ *
+ * Provides easy access to user-related functionality including:
+ * - Getting protocol requirements
+ * - Checking credential validity
+ * - Generating ZK proofs
+ * - Verifying proofs and granting access to protocols
+ *
+ * @param signer - Ethers signer instance (from wallet)
+ * @param options - Configuration options
+ * @returns Hook return object with user operations
+ *
+ * @example
+ * ```tsx
+ * import { useUser } from '@noah-protocol/sdk/hooks';
+ * import { useSigner, useAccount } from 'wagmi';
+ *
+ * function UserDashboard() {
+ *   const { data: signer } = useSigner();
+ *   const { address } = useAccount();
+ *   const {
+ *     protocolRequirements,
+ *     generateProof,
+ *     verifyAndGrantAccess,
+ *     hasAccess
+ *   } = useUser(signer, {
+ *     userAddress: address,
+ *     protocolAddress: '0x...',
+ *     apiBaseUrl: 'https://api.noah.xyz'
+ *   });
+ *
+ *   const handleGenerateProof = async () => {
+ *     const result = await generateProof.mutateAsync({
+ *       credential: {
+ *         actualAge: 25,
+ *         actualJurisdiction: 'US',
+ *         actualAccredited: true,
+ *         credentialHash: '0x...'
+ *       },
+ *       requirements: protocolRequirements!
+ *     });
+ *
+ *     await verifyAndGrantAccess.mutateAsync({
+ *       ...result,
+ *       credentialHash: '0x...',
+ *       protocolAddress: '0x...'
+ *     });
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       {hasAccess ? (
+ *         <p>You have access!</p>
+ *       ) : (
+ *         <button onClick={handleGenerateProof}>
+ *           Request Access
+ *         </button>
+ *       )}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export function useUser(signer, options = {}) {
+    const { userAddress, protocolAddress, credentialHash, enabled = true, queryOptions = {}, } = options;
+    const queryClient = useQueryClient();
+    // Create user client instance
+    const user = useMemo(() => {
+        if (!signer)
+            return null;
+        try {
+            return new UserClient(signer);
+        }
+        catch (error) {
+            console.warn('UserClient not available:', error);
+            return null;
+        }
+    }, [signer]);
+    // Note: userAddress is used directly in queries below
+    // Query: Get protocol requirements
+    const { data: protocolRequirements, isLoading: isLoadingRequirements, error: requirementsError, refetch: refetchRequirements, } = useQuery({
+        queryKey: ['user', 'protocol-requirements', protocolAddress],
+        queryFn: async () => {
+            if (!user || !protocolAddress) {
+                throw new Error('User client or protocol address not available');
+            }
+            return user.getProtocolRequirements(protocolAddress);
+        },
+        enabled: enabled && !!user && !!protocolAddress,
+        ...queryOptions,
+    });
+    // Note: To check user access, use the useProtocol hook instead
+    // This is because access checking is a protocol-level operation
+    // Query: Check credential validity
+    const { data: isCredentialValid, isLoading: isLoadingCredential, error: credentialError, refetch: refetchCredential, } = useQuery({
+        queryKey: ['user', 'credential-validity', credentialHash],
+        queryFn: async () => {
+            if (!user || !credentialHash) {
+                throw new Error('User client or credential hash not available');
+            }
+            return user.checkCredentialValidity(credentialHash);
+        },
+        enabled: enabled && !!user && !!credentialHash,
+        ...queryOptions,
+    });
+    // Mutation: Check credential validity
+    const checkCredentialValidityMutation = useMutation({
+        mutationFn: async (credentialHash) => {
+            if (!user) {
+                throw new Error('User client not available');
+            }
+            return user.checkCredentialValidity(credentialHash);
+        },
+    });
+    // Mutation: Generate proof
+    const generateProofMutation = useMutation({
+        mutationFn: async (params) => {
+            if (!user) {
+                throw new Error('User client not available');
+            }
+            return user.generateProof(params.credential, params.requirements);
+        },
+    });
+    // Mutation: Verify and grant access
+    const verifyAndGrantAccessMutation = useMutation({
+        mutationFn: async (params) => {
+            if (!user) {
+                throw new Error('User client not available');
+            }
+            // UserClient.verifyAndGrantAccess expects a ProofResult object
+            return user.verifyAndGrantAccess({
+                proof: params.proof,
+                publicSignals: params.publicSignals,
+                nullifier: params.nullifier,
+                packedFlags: params.packedFlags,
+                credentialHash: params.credentialHash,
+                success: true,
+            }, params.protocolAddress, params.userAddress);
+        },
+        onSuccess: () => {
+            // Invalidate and refetch access status
+            queryClient.invalidateQueries({
+                queryKey: ['user', 'access'],
+            });
+        },
+    });
+    return {
+        user,
+        protocolRequirements,
+        isLoadingRequirements,
+        requirementsError: requirementsError,
+        refetchRequirements: () => {
+            refetchRequirements();
+        },
+        isCredentialValid,
+        isLoadingCredential,
+        credentialError: credentialError,
+        refetchCredential: () => {
+            refetchCredential();
+        },
+        checkCredentialValidity: {
+            mutate: checkCredentialValidityMutation.mutate,
+            mutateAsync: checkCredentialValidityMutation.mutateAsync,
+            isLoading: checkCredentialValidityMutation.isPending,
+            error: checkCredentialValidityMutation.error,
+            reset: checkCredentialValidityMutation.reset,
+        },
+        generateProof: {
+            mutate: generateProofMutation.mutate,
+            mutateAsync: generateProofMutation.mutateAsync,
+            isLoading: generateProofMutation.isPending,
+            error: generateProofMutation.error,
+            reset: generateProofMutation.reset,
+        },
+        verifyAndGrantAccess: {
+            mutate: verifyAndGrantAccessMutation.mutate,
+            mutateAsync: verifyAndGrantAccessMutation.mutateAsync,
+            isLoading: verifyAndGrantAccessMutation.isPending,
+            error: verifyAndGrantAccessMutation.error,
+            reset: verifyAndGrantAccessMutation.reset,
+        },
+    };
+}
+//# sourceMappingURL=useUser.js.map

package/dist/hooks/useUser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUser.js","sourceRoot":"","sources":["../../src/hooks/useUser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC9E,OAAO,EAAE,OAAO,EAAuB,MAAM,OAAO,CAAC;AAErD,OAAO,EAAE,UAAU,EAAqC,MAAM,oBAAoB,CAAC;AAqGnF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+DG;AACH,MAAM,UAAU,OAAO,CACrB,MAAiC,EACjC,UAA0B,EAAE;IAE5B,MAAM,EACJ,WAAW,EACX,eAAe,EACf,cAAc,EACd,OAAO,GAAG,IAAI,EACd,YAAY,GAAG,EAAE,GAClB,GAAG,OAAO,CAAC;IAEZ,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IAErC,8BAA8B;IAC9B,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE;QACxB,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QACzB,IAAI,CAAC;YACH,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,2BAA2B,EAAE,KAAK,CAAC,CAAC;YACjD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAEb,sDAAsD;IAEtD,mCAAmC;IACnC,MAAM,EACJ,IAAI,EAAE,oBAAoB,EAC1B,SAAS,EAAE,qBAAqB,EAChC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC7B,GAAG,QAAQ,CAAC;QACX,QAAQ,EAAE,CAAC,MAAM,EAAE,uBAAuB,EAAE,eAAe,CAAC;QAC5D,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,IAAI,CAAC,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;gBAC9B,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;YACnE,CAAC;YACD,OAAO,IAAI,CAAC,uBAAuB,CAAC,eAAe,CAAC,CAAC;QACvD,CAAC;QACD,OAAO,EAAE,OAAO,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,eAAe;QAC/C,GAAG,YAAY;KAChB,CAAC,CAAC;IAEH,+DAA+D;IAC/D,gEAAgE;IAEhE,mCAAmC;IACnC,MAAM,EACJ,IAAI,EAAE,iBAAiB,EACvB,SAAS,EAAE,mBAAmB,EAC9B,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,iBAAiB,GAC3B,GAAG,QAAQ,CAAC;QACX,QAAQ,EAAE,CAAC,MAAM,EAAE,qBAAqB,EAAE,cAAc,CAAC;QACzD,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,IAAI,CAAC,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;YAClE,CAAC;YACD,OAAO,IAAI,CAAC,uBAAuB,CAAC,cAAc,CAAC,CAAC;QACtD,CAAC;QACD,OAAO,EAAE,OAAO,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,cAAc;QAC9C,GAAG,YAAY;KAChB,CAAC,CAAC;IAEH,sCAAsC;IACtC,MAAM,+BAA+B,GAAG,WAAW,CAAC;QAClD,UAAU,EAAE,KAAK,EAAE,cAAsB,EAAE,EAAE;YAC3C,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;YAC/C,CAAC;YACD,OAAO,IAAI,CAAC,uBAAuB,CAAC,cAAc,CAAC,CAAC;QACtD,CAAC;KACF,CAAC,CAAC;IAEH,2BAA2B;IAC3B,MAAM,qBAAqB,GAAG,WAAW,CAAC;QACxC,UAAU,EAAE,KAAK,EAAE,MAGlB,EAAE,EAAE;YACH,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;YAC/C,CAAC;YACD,OAAO,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;QACpE,CAAC;KACF,CAAC,CAAC;IAEH,oCAAoC;IACpC,MAAM,4BAA4B,GAAG,WAAW,CAAC;QAC/C,UAAU,EAAE,KAAK,EAAE,MAQlB,EAAE,EAAE;YACH,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;YAC/C,CAAC;YACD,+DAA+D;YAC/D,OAAO,IAAI,CAAC,oBAAoB,CAC9B;gBACE,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,aAAa,EAAE,MAAM,CAAC,aAAa;gBACnC,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,cAAc,EAAE,MAAM,CAAC,cAAc;gBACrC,OAAO,EAAE,IAAI;aACd,EACD,MAAM,CAAC,eAAe,EACtB,MAAM,CAAC,WAAW,CACnB,CAAC;QACJ,CAAC;QACD,SAAS,EAAE,GAAG,EAAE;YACd,uCAAuC;YACvC,WAAW,CAAC,iBAAiB,CAAC;gBAC5B,QAAQ,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC;aAC7B,CAAC,CAAC;QACL,CAAC;KACF,CAAC,CAAC;IAEH,OAAO;QACL,IAAI;QACJ,oBAAoB;QACpB,qBAAqB;QACrB,iBAAiB,EAAE,iBAAiC;QACpD,mBAAmB,EAAE,GAAG,EAAE;YACxB,mBAAmB,EAAE,CAAC;QACxB,CAAC;QACD,iBAAiB;QACjB,mBAAmB;QACnB,eAAe,EAAE,eAA+B;QAChD,iBAAiB,EAAE,GAAG,EAAE;YACtB,iBAAiB,EAAE,CAAC;QACtB,CAAC;QACD,uBAAuB,EAAE;YACvB,MAAM,EAAE,+BAA+B,CAAC,MAAM;YAC9C,WAAW,EAAE,+BAA+B,CAAC,WAAW;YACxD,SAAS,EAAE,+BAA+B,CAAC,SAAS;YACpD,KAAK,EAAE,+BAA+B,CAAC,KAAqB;YAC5D,KAAK,EAAE,+BAA+B,CAAC,KAAK;SAC7C;QACD,aAAa,EAAE;YACb,MAAM,EAAE,qBAAqB,CAAC,MAAM;YACpC,WAAW,EAAE,qBAAqB,CAAC,WAAW;YAC9C,SAAS,EAAE,qBAAqB,CAAC,SAAS;YAC1C,KAAK,EAAE,qBAAqB,CAAC,KAAqB;YAClD,KAAK,EAAE,qBAAqB,CAAC,KAAK;SACnC;QACD,oBAAoB,EAAE;YACpB,MAAM,EAAE,4BAA4B,CAAC,MAAM;YAC3C,WAAW,EAAE,4BAA4B,CAAC,WAAW;YACrD,SAAS,EAAE,4BAA4B,CAAC,SAAS;YACjD,KAAK,EAAE,4BAA4B,CAAC,KAAqB;YACzD,KAAK,EAAE,4BAA4B,CAAC,KAAK;SAC1C;KACF,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * NOAH Protocol SDK
+ *
+ * TypeScript/JavaScript SDK for integrating NOAH's privacy-preserving KYC functionality
+ * into DeFi protocols and applications.
+ */
+export { NoahSDK, NoahError, NoahValidationError, NoahProverError } from './core/NoahSDK.js';
+export { ContractClient } from './core/ContractClient.js';
+export { APIClient } from './core/APIClient.js';
+export { WalletAdapter } from './core/WalletAdapter.js';
+export type { WalletAdapterConfig, WalletState, WalletType } from './core/WalletAdapter.js';
+export { ProtocolClient } from './protocol/ProtocolClient.js';
+export { RequirementsManager } from './protocol/RequirementsManager.js';
+export { UserClient } from './user/UserClient.js';
+export { ProofGenerator } from './user/ProofGenerator.js';
+export type { Credential, ProofResult, UserClientConfig } from './user/UserClient.js';
+export { IssuerClient } from './issuer/IssuerClient.js';
+export { jurisdictionStringToHash, jurisdictionStringsToHashes, parseJurisdictions, } from './utils/jurisdiction.js';
+export { generateCredentialHash, isValidCredentialHash, isValidAddress, toChecksumAddress, } from './utils/credentials.js';
+export { parseTD3, validateCheckDigit, } from './utils/mrz.js';
+export type { MRZData } from './utils/mrz.js';
+export { OCRExtractor } from './utils/ocr.js';
+export type { OCROutput } from './utils/ocr.js';
+export { IdentityManager } from './utils/identity.js';
+export type { IdentityProfile } from './utils/identity.js';
+export type { ContractAddresses, Requirements, IssuerInfo, Proof, ZKProof, TransactionResult, ContractClientConfig, ProtocolClientConfig, SetRequirementsParams, VerifyUserAccessParams, CredentialIssuedEvent, AccessGrantedEvent, EventCallback, ContractEventPayload, CredentialData, CredentialHashResult, } from './utils/types.js';
+export type { APIClientConfig, ProofGenerationData, ProofGenerationResult, AccessStatus, CredentialStatus, } from './core/APIClient.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC7F,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,YAAY,EAAE,mBAAmB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAG5F,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAGxE,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAGtF,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,cAAc,EACd,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,QAAQ,EACR,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAG3D,YAAY,EACV,iBAAiB,EACjB,YAAY,EACZ,UAAU,EACV,KAAK,EACL,OAAO,EACP,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,EACrB,kBAAkB,EAClB,aAAa,EACb,oBAAoB,EACpB,cAAc,EACd,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,YAAY,EACZ,gBAAgB,GACjB,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,26 @@
+/**
+ * NOAH Protocol SDK
+ *
+ * TypeScript/JavaScript SDK for integrating NOAH's privacy-preserving KYC functionality
+ * into DeFi protocols and applications.
+ */
+// Core exports
+export { NoahSDK, NoahError, NoahValidationError, NoahProverError } from './core/NoahSDK.js';
+export { ContractClient } from './core/ContractClient.js';
+export { APIClient } from './core/APIClient.js';
+export { WalletAdapter } from './core/WalletAdapter.js';
+// Protocol exports
+export { ProtocolClient } from './protocol/ProtocolClient.js';
+export { RequirementsManager } from './protocol/RequirementsManager.js';
+// User exports
+export { UserClient } from './user/UserClient.js';
+export { ProofGenerator } from './user/ProofGenerator.js';
+// Issuer exports
+export { IssuerClient } from './issuer/IssuerClient.js';
+// Utilities
+export { jurisdictionStringToHash, jurisdictionStringsToHashes, parseJurisdictions, } from './utils/jurisdiction.js';
+export { generateCredentialHash, isValidCredentialHash, isValidAddress, toChecksumAddress, } from './utils/credentials.js';
+export { parseTD3, validateCheckDigit, } from './utils/mrz.js';
+export { OCRExtractor } from './utils/ocr.js';
+export { IdentityManager } from './utils/identity.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAe;AACf,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC7F,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAGxD,mBAAmB;AACnB,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAExE,eAAe;AACf,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG1D,iBAAiB;AACjB,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,YAAY;AACZ,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,cAAc,EACd,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,QAAQ,EACR,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/issuer/IssuerClient.d.ts

@@ -0,0 +1,98 @@
+import type { Signer } from 'ethers';
+import type { TransactionResult, ContractAddresses } from '../utils/types';
+/**
+ * IssuerClient configuration options
+ */
+export interface IssuerClientConfig {
+    apiBaseUrl?: string;
+    contractAddresses?: Partial<ContractAddresses>;
+    rpcUrl?: string;
+}
+/**
+ * Credential status information
+ */
+export interface CredentialStatus {
+    isValid: boolean;
+    credentialHash: string;
+    isRevoked: boolean;
+    issuer?: string;
+}
+/**
+ * IssuerClient - High-level API for credential issuers
+ *
+ * Provides a simple interface for issuers to:
+ * - Register credentials on-chain
+ * - Revoke credentials
+ * - Check credential status
+ *
+ * @example
+ * ```typescript
+ * import { IssuerClient } from '@noah-protocol/sdk';
+ * import { ethers } from 'ethers';
+ *
+ * const provider = new ethers.BrowserProvider(window.ethereum);
+ * const signer = await provider.getSigner();
+ * const issuer = new IssuerClient(signer, { apiBaseUrl: 'https://api.noah.xyz' });
+ *
+ * // Register credential
+ * await issuer.registerCredential(credentialHash, userAddress);
+ *
+ * // Revoke credential
+ * await issuer.revokeCredential(credentialHash);
+ * ```
+ */
+export declare class IssuerClient {
+    private signer;
+    private contractClient;
+    private apiClient;
+    /**
+     * Create a new IssuerClient instance
+     * @param signer - Ethers.js signer from issuer's wallet
+     * @param config - Optional configuration
+     */
+    constructor(signer: Signer, config?: IssuerClientConfig);
+    /**
+     * Register a credential on-chain
+     *
+     * @param credentialHash - The credential hash to register (bytes32)
+     * @param userAddress - The user's wallet address
+     * @param useAPI - If true, use backend API (gasless). If false, use direct contract call.
+     * @returns Promise resolving to transaction result
+     *
+     * @example
+     * ```typescript
+     * const tx = await issuer.registerCredential('0x1234...', '0x5678...');
+     * console.log('Transaction hash:', tx.transactionHash);
+     * ```
+     */
+    registerCredential(credentialHash: string, userAddress: string, useAPI?: boolean): Promise<TransactionResult>;
+    /**
+     * Revoke a credential
+     *
+     * @param credentialHash - The credential hash to revoke (bytes32)
+     * @param useAPI - If true, use backend API (gasless). If false, use direct contract call.
+     * @returns Promise resolving to transaction result
+     *
+     * @example
+     * ```typescript
+     * const tx = await issuer.revokeCredential('0x1234...');
+     * console.log('Transaction hash:', tx.transactionHash);
+     * ```
+     */
+    revokeCredential(credentialHash: string, useAPI?: boolean): Promise<TransactionResult>;
+    /**
+     * Check credential status
+     *
+     * @param credentialHash - The credential hash to check (bytes32)
+     * @returns Promise resolving to credential status information
+     *
+     * @example
+     * ```typescript
+     * const status = await issuer.checkCredential('0x1234...');
+     * console.log('Is valid:', status.isValid);
+     * console.log('Is revoked:', status.isRevoked);
+     * ```
+     */
+    checkCredential(credentialHash: string): Promise<CredentialStatus>;
+}
+//# sourceMappingURL=IssuerClient.d.ts.map

package/dist/issuer/IssuerClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IssuerClient.d.ts","sourceRoot":"","sources":["../../src/issuer/IssuerClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAI3E;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,SAAS,CAAY;IAE7B;;;;OAIG;gBACS,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,kBAAuB;IAoB3D;;;;;;;;;;;;;OAaG;IACG,kBAAkB,CACtB,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,EACnB,MAAM,GAAE,OAAe,GACtB,OAAO,CAAC,iBAAiB,CAAC;IA4B7B;;;;;;;;;;;;OAYG;IACG,gBAAgB,CACpB,cAAc,EAAE,MAAM,EACtB,MAAM,GAAE,OAAe,GACtB,OAAO,CAAC,iBAAiB,CAAC;IAuB7B;;;;;;;;;;;;OAYG;IACG,eAAe,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAgCzE"}