noah-avalanche-sdk 0.1.2

package/dist/core/APIClient.d.ts

@@ -0,0 +1,71 @@
+import type { Proof, Requirements, TransactionResult } from '../utils/types.js';
+/**
+ * APIClient configuration
+ */
+export interface APIClientConfig {
+    baseURL?: string;
+    timeout?: number;
+    authToken?: string;
+}
+/**
+ * Proof generation data
+ */
+export interface ProofGenerationData {
+    credential: {
+        age: number;
+        jurisdiction: string | number;
+        accredited: number;
+        credentialHash: string;
+        userAddress?: string;
+    };
+    requirements: Requirements;
+}
+/**
+ * Proof generation result
+ */
+export interface ProofGenerationResult {
+    proof: Proof;
+    publicSignals: string[];
+    credentialHash: string;
+    success: boolean;
+    error?: string;
+}
+/**
+ * Access status information
+ */
+export interface AccessStatus {
+    hasAccess: boolean;
+    protocolAddress: string;
+    userAddress: string;
+    credentialHash?: string;
+}
+/**
+ * Credential status information
+ */
+export interface CredentialStatus {
+    isValid: boolean;
+    credentialHash: string;
+    isRevoked: boolean;
+    issuer?: string;
+}
+/**
+ * APIClient - Handles backend API interactions
+ */
+export declare class APIClient {
+    private client;
+    private authToken;
+    constructor(config?: APIClientConfig);
+    setAuthToken(token: string): void;
+    generateProof(proofData: ProofGenerationData): Promise<ProofGenerationResult>;
+    generateAgeProof(data: {
+        mrzData: any;
+        minAge: number;
+        recipientAddress: string;
+    }): Promise<ProofGenerationResult>;
+    getProtocolRequirements(protocolAddress: string): Promise<Requirements>;
+    checkAccess(protocolAddress: string, userAddress: string): Promise<AccessStatus>;
+    registerCredential(credentialHash: string, userAddress: string): Promise<TransactionResult>;
+    revokeCredential(credentialHash: string): Promise<TransactionResult>;
+    checkCredential(credentialHash: string): Promise<CredentialStatus>;
+}
+//# sourceMappingURL=APIClient.d.ts.map

package/dist/core/APIClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"APIClient.d.ts","sourceRoot":"","sources":["../../src/core/APIClient.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEhF;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE;QACV,GAAG,EAAE,MAAM,CAAC;QACZ,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC;QAC9B,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC;QACvB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,YAAY,EAAE,YAAY,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,KAAK,CAAC;IACb,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,OAAO,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;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;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,SAAS,CAAuB;gBAE5B,MAAM,GAAE,eAAoB;IAsBxC,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI3B,aAAa,CAAC,SAAS,EAAE,mBAAmB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAc7E,gBAAgB,CAAC,IAAI,EAAE;QAC3B,OAAO,EAAE,GAAG,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,gBAAgB,EAAE,MAAM,CAAC;KAC1B,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAiB5B,uBAAuB,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAUvE,WAAW,CAAC,eAAe,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAUhF,kBAAkB,CAAC,cAAc,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAK3F,gBAAgB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAKpE,eAAe,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;CASzE"}

package/dist/core/APIClient.js

@@ -0,0 +1,92 @@
+import axios from 'axios';
+/**
+ * APIClient - Handles backend API interactions
+ */
+export class APIClient {
+    constructor(config = {}) {
+        this.authToken = null;
+        this.client = axios.create({
+            baseURL: config.baseURL || 'http://localhost:3000/api/v1',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            timeout: config.timeout || 30000,
+        });
+        if (config.authToken) {
+            this.setAuthToken(config.authToken);
+        }
+        this.client.interceptors.response.use((response) => response.data, (error) => {
+            const errorMessage = error.response?.data?.error?.message || error.message || 'An error occurred';
+            return Promise.reject(new Error(errorMessage));
+        });
+    }
+    setAuthToken(token) {
+        this.authToken = token;
+    }
+    async generateProof(proofData) {
+        try {
+            const response = await this.client.post('/proof/generate', proofData);
+            return {
+                proof: response.proof,
+                publicSignals: response.publicSignals || response.publicInputs || [],
+                credentialHash: response.credentialHash || proofData.credential.credentialHash,
+                success: response.success !== false,
+            };
+        }
+        catch (error) {
+            throw new Error(`Failed to generate proof: ${error}`);
+        }
+    }
+    async generateAgeProof(data) {
+        return this.generateProof({
+            credential: {
+                age: 0,
+                jurisdiction: "",
+                accredited: 0,
+                credentialHash: "",
+                userAddress: data.recipientAddress
+            },
+            requirements: {
+                minAge: data.minAge,
+                allowedJurisdictions: [],
+                requireAccredited: false
+            }
+        });
+    }
+    async getProtocolRequirements(protocolAddress) {
+        const response = await this.client.get(`/user/protocol/${protocolAddress}/requirements`);
+        return {
+            minAge: Number(response.minAge),
+            allowedJurisdictions: response.allowedJurisdictions || [],
+            requireAccredited: response.requireAccredited || false,
+            isSet: response.isSet !== false,
+        };
+    }
+    async checkAccess(protocolAddress, userAddress) {
+        const response = await this.client.get(`/user/access/${protocolAddress}/${userAddress}`);
+        return {
+            hasAccess: response.hasAccess || false,
+            protocolAddress,
+            userAddress,
+            credentialHash: response.credentialHash,
+        };
+    }
+    async registerCredential(credentialHash, userAddress) {
+        const response = await this.client.post('/issuer/credential/register', { credentialHash, userAddress });
+        return { transactionHash: response.transactionHash, receipt: response.receipt || null };
+    }
+    async revokeCredential(credentialHash) {
+        const response = await this.client.post('/issuer/credential/revoke', { credentialHash });
+        return { transactionHash: response.transactionHash, receipt: response.receipt || null };
+    }
+    async checkCredential(credentialHash) {
+        const response = await this.client.get(`/issuer/credential/check/${credentialHash}`);
+        return {
+            isValid: response.isValid || false,
+            credentialHash,
+            isRevoked: response.isRevoked || false,
+            issuer: response.issuer,
+        };
+    }
+}
+//# sourceMappingURL=APIClient.js.map

package/dist/core/APIClient.js.map

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

package/dist/core/ContractClient.d.ts

@@ -0,0 +1,38 @@
+import { type Provider, type Signer } from 'ethers';
+import type { Requirements, Proof, ZKProof, TransactionResult, ContractClientConfig } from '../utils/types.js';
+/**
+ * Contract Client Service
+ * Handles direct smart contract interactions for read and write operations
+ */
+export declare class ContractClient {
+    private provider;
+    private credentialRegistry;
+    private protocolAccessControl;
+    private contractAddresses;
+    private rpcUrl;
+    /**
+     * Create a new ContractClient instance
+     * @param config - Configuration options including provider, contract addresses, and RPC URL
+     */
+    constructor(config?: ContractClientConfig);
+    /**
+     * Initialize provider and contracts with robust support for various provider types
+     * @param inputProvider - EIP-1193 provider (window.ethereum), Ethers Provider, or custom
+     */
+    initialize(inputProvider?: any): void;
+    /**
+     * Pre-flight validation for proof inputs
+     */
+    validateProofInput(publicSignals: (string | number)[]): void;
+    isCredentialValid(credentialHash: string): Promise<boolean>;
+    isNullifierUsed(nullifier: string): Promise<boolean>;
+    getCredentialByUser(userAddress: string): Promise<string>;
+    hasAccess(protocolAddress: string, userAddress: string): Promise<boolean>;
+    getRequirements(protocolAddress: string): Promise<Requirements>;
+    getUserCredential(protocolAddress: string, userAddress: string): Promise<string>;
+    registerCredential(signer: Signer, credentialHash: string, userAddress: string): Promise<TransactionResult>;
+    revokeCredential(signer: Signer, credentialHash: string): Promise<TransactionResult>;
+    verifyAndGrantAccess(signer: Signer, proof: Proof | ZKProof, publicSignals: (string | number)[], credentialHash: string, userAddress: string): Promise<TransactionResult>;
+    getProvider(): Provider | null;
+}
+//# sourceMappingURL=ContractClient.d.ts.map

package/dist/core/ContractClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContractClient.d.ts","sourceRoot":"","sources":["../../src/core/ContractClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,QAAQ,EACb,KAAK,MAAM,EAIZ,MAAM,QAAQ,CAAC;AAChB,OAAO,KAAK,EAEV,YAAY,EAEZ,KAAK,EACL,OAAO,EACP,iBAAiB,EACjB,oBAAoB,EAErB,MAAM,mBAAmB,CAAC;AAmC3B;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,kBAAkB,CAAyB;IACnD,OAAO,CAAC,qBAAqB,CAAyB;IACtD,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,MAAM,CAAS;IAEvB;;;OAGG;gBACS,MAAM,CAAC,EAAE,oBAAoB;IAczC;;;OAGG;IACH,UAAU,CAAC,aAAa,CAAC,EAAE,GAAG,GAAG,IAAI;IAuBrC;;OAEG;IACH,kBAAkB,CAAC,aAAa,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,IAAI;IAUtD,iBAAiB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAS3D,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUpD,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IASzD,SAAS,CAAC,eAAe,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IASzE,eAAe,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAiB/D,iBAAiB,CAAC,eAAe,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAShF,kBAAkB,CACtB,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,iBAAiB,CAAC;IAYvB,gBAAgB,CACpB,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,iBAAiB,CAAC;IAYvB,oBAAoB,CACxB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,KAAK,GAAG,OAAO,EACtB,aAAa,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAClC,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,iBAAiB,CAAC;IAyC7B,WAAW,IAAI,QAAQ,GAAG,IAAI;CAC/B"}

package/dist/core/ContractClient.js

@@ -0,0 +1,209 @@
+import { ethers, BrowserProvider, JsonRpcProvider } from 'ethers';
+/**
+ * Contract ABIs (synchronized with production contracts)
+ */
+const CREDENTIAL_REGISTRY_ABI = [
+    'function isCredentialValid(bytes32 credentialHash) view returns (bool)',
+    'function credentials(bytes32) view returns (bool)',
+    'function revokedCredentials(bytes32) view returns (bool)',
+    'function trustedIssuers(address) view returns (bool)',
+    'function issuerNames(address) view returns (string)',
+    'function credentialIssuers(bytes32) view returns (address)',
+    'function nullifierOwners(bytes32) view returns (address)',
+    'function userToCredential(address) view returns (bytes32)',
+    'function registerCredential(bytes32 credentialHash, address user)',
+    'function registerNullifier(bytes32 nullifier, bytes32 credentialHash, address user)',
+    'function revokeCredential(bytes32 credentialHash)',
+    'function hasRole(bytes32 role, address account) view returns (bool)',
+    'event CredentialIssued(address indexed user, bytes32 indexed credentialHash, address indexed issuer, uint256 timestamp)',
+    'event CredentialRevoked(bytes32 indexed credentialHash, address indexed issuer, uint256 timestamp)',
+    'event NullifierRegistered(bytes32 indexed nullifier, bytes32 indexed credentialHash, address indexed user)',
+];
+const PROTOCOL_ACCESS_CONTROL_ABI = [
+    'function hasAccess(address protocol, address user) view returns (bool)',
+    'function checkAccess(address user) view returns (bool)',
+    'function protocolRequirements(address) view returns (uint256 minAge, bool requireAccredited, bool isSet)',
+    'function userCredentials(address protocol, address user) view returns (bytes32)',
+    'function setRequirements(uint256 minAge, uint256[] memory allowedJurisdictions, bool requireAccredited)',
+    'function verifyAndGrantAccess(uint[2] a, uint[2][2] b, uint[2] c, uint[28] publicSignals, bytes32 credentialHash, address user)',
+    'event AccessGranted(address indexed user, address indexed protocol, bytes32 indexed credentialHash, uint256 timestamp)',
+    'event AccessRevoked(address indexed user, address indexed protocol, uint256 timestamp)',
+    'event RequirementsSet(address indexed protocol, uint256 minAge, uint256[] allowedJurisdictions, bool requireAccredited)',
+];
+/**
+ * Contract Client Service
+ * Handles direct smart contract interactions for read and write operations
+ */
+export class ContractClient {
+    /**
+     * Create a new ContractClient instance
+     * @param config - Configuration options including provider, contract addresses, and RPC URL
+     */
+    constructor(config) {
+        this.provider = null;
+        this.credentialRegistry = null;
+        this.protocolAccessControl = null;
+        this.contractAddresses = config?.contractAddresses || {
+            CredentialRegistry: '0x8E4B7e3f9F3C55DA50aB587168f1d8A011FC8e95',
+            ZKVerifier: '0x48392A1bE10b5687c06be11152675215dff14512',
+            ProtocolAccessControl: '0xb92f19431617F5B34bFDCb06E3a80533939DD71b',
+        };
+        this.rpcUrl = config?.rpcUrl || 'https://avax-fuji.g.alchemy.com/v2/gu3D3rKyivv6bhmb3UbyUSYxThLz7C_c';
+        if (config?.provider) {
+            this.initialize(config.provider);
+        }
+    }
+    /**
+     * Initialize provider and contracts with robust support for various provider types
+     * @param inputProvider - EIP-1193 provider (window.ethereum), Ethers Provider, or custom
+     */
+    initialize(inputProvider) {
+        if (!inputProvider) {
+            this.provider = new JsonRpcProvider(this.rpcUrl);
+        }
+        else if (inputProvider.request) {
+            // It's an EIP-1193 provider (MetaMask, etc.)
+            this.provider = new BrowserProvider(inputProvider);
+        }
+        else {
+            // Assume it's already an ethers-compatible provider
+            this.provider = inputProvider;
+        }
+        this.credentialRegistry = new ethers.Contract(this.contractAddresses.CredentialRegistry, CREDENTIAL_REGISTRY_ABI, this.provider);
+        this.protocolAccessControl = new ethers.Contract(this.contractAddresses.ProtocolAccessControl, PROTOCOL_ACCESS_CONTROL_ABI, this.provider);
+    }
+    /**
+     * Pre-flight validation for proof inputs
+     */
+    validateProofInput(publicSignals) {
+        if (!publicSignals || publicSignals.length < 28) {
+            throw new Error(`Invalid public signals length: expected 28, got ${publicSignals?.length || 0}`);
+        }
+        // Check isValid bit
+        if (publicSignals[25] != "1" && publicSignals[25] != 1) {
+            throw new Error("ZK Proof internal validation failed (isValid signal is not 1)");
+        }
+    }
+    async isCredentialValid(credentialHash) {
+        if (!this.credentialRegistry)
+            this.initialize();
+        try {
+            return await this.credentialRegistry.isCredentialValid(credentialHash);
+        }
+        catch (error) {
+            throw new Error(`Failed to check credential validity: ${error}`);
+        }
+    }
+    async isNullifierUsed(nullifier) {
+        if (!this.credentialRegistry)
+            this.initialize();
+        try {
+            const owner = await this.credentialRegistry.nullifierOwners(nullifier);
+            return owner !== ethers.ZeroAddress;
+        }
+        catch (error) {
+            throw new Error(`Failed to check nullifier status: ${error}`);
+        }
+    }
+    async getCredentialByUser(userAddress) {
+        if (!this.credentialRegistry)
+            this.initialize();
+        try {
+            return await this.credentialRegistry.userToCredential(userAddress);
+        }
+        catch (error) {
+            throw new Error(`Failed to get credential by user: ${error}`);
+        }
+    }
+    async hasAccess(protocolAddress, userAddress) {
+        if (!this.protocolAccessControl)
+            this.initialize();
+        try {
+            return await this.protocolAccessControl.hasAccess(protocolAddress, userAddress);
+        }
+        catch (error) {
+            throw new Error(`Failed to check access: ${error}`);
+        }
+    }
+    async getRequirements(protocolAddress) {
+        if (!this.protocolAccessControl)
+            this.initialize();
+        try {
+            const [minAge, requireAccredited, isSet] = await this.protocolAccessControl.protocolRequirements(protocolAddress);
+            return {
+                minAge: Number(minAge),
+                allowedJurisdictions: [],
+                requireAccredited,
+                isSet,
+            };
+        }
+        catch (error) {
+            throw new Error(`Failed to get protocol requirements: ${error}`);
+        }
+    }
+    async getUserCredential(protocolAddress, userAddress) {
+        if (!this.protocolAccessControl)
+            this.initialize();
+        try {
+            return await this.protocolAccessControl.userCredentials(protocolAddress, userAddress);
+        }
+        catch (error) {
+            throw new Error(`Failed to get user credential: ${error}`);
+        }
+    }
+    async registerCredential(signer, credentialHash, userAddress) {
+        if (!signer)
+            throw new Error('Signer is required');
+        const contract = new ethers.Contract(this.contractAddresses.CredentialRegistry, CREDENTIAL_REGISTRY_ABI, signer);
+        try {
+            const tx = await contract.registerCredential(credentialHash, userAddress);
+            const receipt = await tx.wait();
+            return { transactionHash: tx.hash, receipt };
+        }
+        catch (error) {
+            throw new Error(`Failed to register credential: ${error}`);
+        }
+    }
+    async revokeCredential(signer, credentialHash) {
+        if (!signer)
+            throw new Error('Signer is required');
+        const contract = new ethers.Contract(this.contractAddresses.CredentialRegistry, CREDENTIAL_REGISTRY_ABI, signer);
+        try {
+            const tx = await contract.revokeCredential(credentialHash);
+            const receipt = await tx.wait();
+            return { transactionHash: tx.hash, receipt };
+        }
+        catch (error) {
+            throw new Error(`Failed to revoke credential: ${error}`);
+        }
+    }
+    async verifyAndGrantAccess(signer, proof, publicSignals, credentialHash, userAddress) {
+        if (!signer)
+            throw new Error('Signer is required to verify and grant access');
+        // Pre-flight check
+        this.validateProofInput(publicSignals);
+        const accessControl = new ethers.Contract(this.contractAddresses.ProtocolAccessControl, PROTOCOL_ACCESS_CONTROL_ABI, signer);
+        const a = [BigInt(proof.a[0]), BigInt(proof.a[1])];
+        const b = [
+            [BigInt(proof.b[0][0]), BigInt(proof.b[0][1])],
+            [BigInt(proof.b[1][0]), BigInt(proof.b[1][1])]
+        ];
+        const c = [BigInt(proof.c[0]), BigInt(proof.c[1])];
+        const publicSignalsArray = publicSignals.slice(0, 28).map(s => BigInt(s));
+        try {
+            const tx = await accessControl.verifyAndGrantAccess(a, b, c, publicSignalsArray, credentialHash, userAddress);
+            const receipt = await tx.wait();
+            if (!receipt)
+                throw new Error('Transaction failed: No receipt returned');
+            return {
+                transactionHash: tx.hash,
+                receipt,
+            };
+        }
+        catch (error) {
+            throw new Error(`Contract verification failed: ${error}`);
+        }
+    }
+    getProvider() { return this.provider; }
+}
+//# sourceMappingURL=ContractClient.js.map

package/dist/core/ContractClient.js.map

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

package/dist/core/NoahSDK.d.ts

@@ -0,0 +1,43 @@
+import { ContractClient } from './ContractClient.js';
+import { APIClient, type APIClientConfig } from './APIClient.js';
+import { type MRZData } from '../utils/mrz.js';
+import type { ContractClientConfig, TransactionResult, Requirements } from '../utils/types.js';
+import type { Signer } from 'ethers';
+export declare class NoahError extends Error {
+    message: string;
+    code: string;
+    constructor(message: string, code: string);
+}
+export declare class NoahValidationError extends NoahError {
+    constructor(message: string);
+}
+export declare class NoahProverError extends NoahError {
+    constructor(message: string);
+}
+/**
+ * NoahSDK - Main entry point for the Noah Protocol
+ */
+export declare class NoahSDK {
+    contracts: ContractClient;
+    api: APIClient;
+    private ocrExtractor;
+    constructor(config?: ContractClientConfig & APIClientConfig);
+    /**
+     * Extract identity data from a document image
+     * @param image - File or URL of the passport image
+     */
+    extractPassportData(image: File | string | Blob): Promise<MRZData>;
+    /**
+     * Initialize the SDK with a provider
+     */
+    init(provider: any): void;
+    /**
+     * High-level method to prove age and grant access in one go
+     */
+    proveAndGrant(signer: Signer, protocolAddress: string, mrzData: any, targetAge: number): Promise<TransactionResult>;
+    /**
+     * Get protocol requirements via contract client
+     */
+    getProtocolRequirements(protocolAddress: string): Promise<Requirements>;
+}
+//# sourceMappingURL=NoahSDK.d.ts.map

package/dist/core/NoahSDK.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NoahSDK.d.ts","sourceRoot":"","sources":["../../src/core/NoahSDK.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjE,OAAO,EAAY,KAAK,OAAO,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,KAAK,EACR,oBAAoB,EAEpB,iBAAiB,EACjB,YAAY,EACf,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAErC,qBAAa,SAAU,SAAQ,KAAK;IACb,OAAO,EAAE,MAAM;IAAS,IAAI,EAAE,MAAM;gBAApC,OAAO,EAAE,MAAM,EAAS,IAAI,EAAE,MAAM;CAI1D;AAED,qBAAa,mBAAoB,SAAQ,SAAS;gBAClC,OAAO,EAAE,MAAM;CAG9B;AAED,qBAAa,eAAgB,SAAQ,SAAS;gBAC9B,OAAO,EAAE,MAAM;CAG9B;AAED;;GAEG;AACH,qBAAa,OAAO;IACT,SAAS,EAAE,cAAc,CAAC;IAC1B,GAAG,EAAE,SAAS,CAAC;IACtB,OAAO,CAAC,YAAY,CAAe;gBAEvB,MAAM,CAAC,EAAE,oBAAoB,GAAG,eAAe;IAM3D;;;OAGG;IACU,mBAAmB,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;IAkB/E;;OAEG;IACI,IAAI,CAAC,QAAQ,EAAE,GAAG,GAAG,IAAI;IAIhC;;OAEG;IACU,aAAa,CACtB,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,GAAG,EACZ,SAAS,EAAE,MAAM,GAClB,OAAO,CAAC,iBAAiB,CAAC;IAkC7B;;OAEG;IACU,uBAAuB,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;CAGvF"}

package/dist/core/NoahSDK.js

@@ -0,0 +1,93 @@
+import { ContractClient } from './ContractClient.js';
+import { APIClient } from './APIClient.js';
+import { OCRExtractor } from '../utils/ocr.js';
+import { parseTD3 } from '../utils/mrz.js';
+export class NoahError extends Error {
+    constructor(message, code) {
+        super(message);
+        this.message = message;
+        this.code = code;
+        this.name = 'NoahError';
+    }
+}
+export class NoahValidationError extends NoahError {
+    constructor(message) {
+        super(message, 'VALIDATION_ERROR');
+    }
+}
+export class NoahProverError extends NoahError {
+    constructor(message) {
+        super(message, 'PROVER_ERROR');
+    }
+}
+/**
+ * NoahSDK - Main entry point for the Noah Protocol
+ */
+export class NoahSDK {
+    constructor(config) {
+        this.contracts = new ContractClient(config);
+        this.api = new APIClient(config);
+        this.ocrExtractor = new OCRExtractor();
+    }
+    /**
+     * Extract identity data from a document image
+     * @param image - File or URL of the passport image
+     */
+    async extractPassportData(image) {
+        const { mrzLines } = await this.ocrExtractor.extractMRZ(image);
+        if (mrzLines.length < 2) {
+            throw new NoahValidationError('Could not detect MRZ lines in the image. Please ensure the bottom part of the passport is clearly visible.');
+        }
+        // We assume the last two lines are the TD3 MRZ lines
+        const line1 = mrzLines[mrzLines.length - 2];
+        const line2 = mrzLines[mrzLines.length - 1];
+        try {
+            return parseTD3(line1, line2);
+        }
+        catch (error) {
+            throw new NoahValidationError(`Failed to parse MRZ: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Initialize the SDK with a provider
+     */
+    init(provider) {
+        this.contracts.initialize(provider);
+    }
+    /**
+     * High-level method to prove age and grant access in one go
+     */
+    async proveAndGrant(signer, protocolAddress, mrzData, targetAge) {
+        try {
+            // 1. Pre-flight check requirements
+            const requirements = await this.contracts.getRequirements(protocolAddress);
+            if (requirements.minAge > targetAge) {
+                throw new NoahValidationError(`Protocol requires age ${requirements.minAge}, but target age is ${targetAge}`);
+            }
+            // 2. Generate Proof via API/Prover
+            const userAddress = await signer.getAddress();
+            const proofResult = await this.api.generateAgeProof({
+                mrzData,
+                minAge: targetAge,
+                recipientAddress: userAddress
+            });
+            if (!proofResult.success) {
+                throw new NoahProverError(proofResult.error || 'Unknown prover error');
+            }
+            // 3. Submit to Chain
+            return await this.contracts.verifyAndGrantAccess(signer, proofResult.proof, proofResult.publicSignals, proofResult.credentialHash, userAddress);
+        }
+        catch (error) {
+            if (error instanceof NoahError)
+                throw error;
+            throw new NoahError(error instanceof Error ? error.message : 'Unknown error', 'INTERNAL_ERROR');
+        }
+    }
+    /**
+     * Get protocol requirements via contract client
+     */
+    async getProtocolRequirements(protocolAddress) {
+        return this.contracts.getRequirements(protocolAddress);
+    }
+}
+//# sourceMappingURL=NoahSDK.js.map

package/dist/core/NoahSDK.js.map

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