@treza/react 0.0.4

package/dist/index.d.ts

@@ -0,0 +1,347 @@
+import React from 'react';
+import { ethers } from 'ethers';
+import { ComplianceRequirements, VerificationResult, TrezaComplianceSDK, ComplianceStatus } from '@treza/sdk';
+export { ComplianceRequirements, ComplianceStatus, TrezaComplianceConfig, VerificationResult } from '@treza/sdk';
+
+/**
+ * React Components for TREZA Compliance Integration
+ *
+ * These components provide easy-to-use React integration for DApps
+ * that want to add ZKPassport compliance features.
+ */
+interface ComplianceProviderProps {
+    provider: ethers.Provider;
+    signer?: ethers.Signer;
+    children: React.ReactNode;
+}
+interface ComplianceContextType {
+    sdk: TrezaComplianceSDK | null;
+    isLoading: boolean;
+    error: string | null;
+}
+/**
+ * Provider component that initializes the compliance SDK
+ */
+declare const ComplianceProvider: React.FC<ComplianceProviderProps>;
+/**
+ * Hook to use compliance context (for use within ComplianceProvider)
+ */
+declare const useComplianceContext: () => ComplianceContextType;
+/**
+ * Props for ComplianceVerification component
+ */
+interface ComplianceVerificationProps {
+    userAddress: string;
+    requirements?: ComplianceRequirements;
+    onVerificationComplete?: (result: VerificationResult) => void;
+    onError?: (error: string) => void;
+    className?: string;
+}
+/**
+ * Main compliance verification component
+ */
+declare const ComplianceVerification: React.FC<ComplianceVerificationProps>;
+/**
+ * Props for ComplianceStatus component
+ */
+interface ComplianceStatusProps {
+    userAddress: string;
+    showDetails?: boolean;
+    className?: string;
+}
+/**
+ * Component to display current compliance status
+ */
+declare const ComplianceStatusDisplay: React.FC<ComplianceStatusProps>;
+/**
+ * Props for GovernanceEligibility component
+ */
+interface GovernanceEligibilityProps {
+    userAddress: string;
+    proposalId: number;
+    className?: string;
+}
+/**
+ * Component to display governance eligibility
+ */
+declare const GovernanceEligibility: React.FC<GovernanceEligibilityProps>;
+declare const complianceStyles = "\n.treza-compliance-verification {\n    max-width: 500px;\n    margin: 0 auto;\n    padding: 20px;\n    border: 1px solid #e0e0e0;\n    border-radius: 8px;\n    background: #fff;\n}\n\n.verification-header h3 {\n    margin: 0 0 10px 0;\n    color: #333;\n}\n\n.verification-header p {\n    margin: 0 0 20px 0;\n    color: #666;\n    font-size: 14px;\n}\n\n.btn-primary, .btn-secondary {\n    padding: 12px 24px;\n    border: none;\n    border-radius: 6px;\n    font-size: 16px;\n    cursor: pointer;\n    transition: background-color 0.2s;\n}\n\n.btn-primary {\n    background: #007bff;\n    color: white;\n}\n\n.btn-primary:hover {\n    background: #0056b3;\n}\n\n.btn-primary:disabled {\n    background: #ccc;\n    cursor: not-allowed;\n}\n\n.btn-secondary {\n    background: #6c757d;\n    color: white;\n}\n\n.qr-code {\n    max-width: 200px;\n    height: auto;\n    margin: 10px 0;\n}\n\n.spinner {\n    width: 20px;\n    height: 20px;\n    border: 2px solid #f3f3f3;\n    border-top: 2px solid #007bff;\n    border-radius: 50%;\n    animation: spin 1s linear infinite;\n    display: inline-block;\n    margin-right: 10px;\n}\n\n@keyframes spin {\n    0% { transform: rotate(0deg); }\n    100% { transform: rotate(360deg); }\n}\n\n.compliance-status {\n    display: flex;\n    align-items: center;\n    padding: 10px;\n    border-radius: 6px;\n    margin: 10px 0;\n}\n\n.compliance-status.compliant {\n    background: #d4edda;\n    color: #155724;\n    border: 1px solid #c3e6cb;\n}\n\n.compliance-status.non-compliant {\n    background: #f8d7da;\n    color: #721c24;\n    border: 1px solid #f5c6cb;\n}\n\n.status-icon {\n    margin-right: 8px;\n    font-size: 18px;\n}\n\n.status-details {\n    margin-top: 10px;\n    font-size: 14px;\n}\n\n.detail-item {\n    margin: 5px 0;\n}\n\n.label {\n    font-weight: bold;\n    margin-right: 8px;\n}\n\n.attributes {\n    display: flex;\n    gap: 8px;\n    flex-wrap: wrap;\n}\n\n.attribute {\n    background: #e9ecef;\n    padding: 2px 6px;\n    border-radius: 4px;\n    font-size: 12px;\n}\n";
+
+/**
+ * React-specific service wrapper for TREZA Compliance SDK
+ *
+ * This service provides React-optimized methods for compliance operations
+ * with proper error handling and state management integration.
+ */
+interface ComplianceServiceConfig {
+    zkPassportDomain?: string;
+    zkVerifyEndpoint?: string;
+    zkVerifyApiKey?: string;
+    trezaTokenAddress?: string;
+    complianceVerifierAddress?: string;
+    complianceIntegrationAddress?: string;
+}
+declare class ComplianceService {
+    private sdk;
+    private config;
+    constructor(config?: ComplianceServiceConfig);
+    /**
+     * Initialize the compliance SDK with provider and signer
+     */
+    initialize(provider: ethers.Provider, signer?: ethers.Signer): Promise<void>;
+    /**
+     * Get the initialized SDK instance
+     */
+    getSDK(): TrezaComplianceSDK;
+    /**
+     * Check if the service is initialized
+     */
+    isInitialized(): boolean;
+    /**
+     * Initiate verification with React-friendly error handling
+     */
+    initiateVerification(requirements?: ComplianceRequirements): Promise<{
+        success: boolean;
+        url?: string;
+        error?: string;
+    }>;
+    /**
+     * Process verification result with React-friendly error handling
+     */
+    processVerificationResult(zkPassportResult: any, userAddress: string): Promise<{
+        success: boolean;
+        result?: VerificationResult;
+        error?: string;
+    }>;
+    /**
+     * Check compliance status with React-friendly error handling
+     */
+    checkComplianceStatus(userAddress: string): Promise<{
+        success: boolean;
+        status?: ComplianceStatus;
+        error?: string;
+    }>;
+    /**
+     * Generate QR code for verification URL
+     */
+    generateQRCode(url: string): Promise<{
+        success: boolean;
+        qrCode?: string;
+        error?: string;
+    }>;
+    /**
+     * Batch check compliance for multiple users
+     */
+    batchCheckCompliance(userAddresses: string[]): Promise<{
+        success: boolean;
+        results?: ComplianceStatus[];
+        error?: string;
+    }>;
+    /**
+     * Check governance eligibility
+     */
+    checkGovernanceEligibility(userAddress: string, proposalId?: string): Promise<{
+        success: boolean;
+        eligibility?: any;
+        error?: string;
+    }>;
+    /**
+     * Cleanup resources
+     */
+    destroy(): void;
+}
+/**
+ * Get or create the global compliance service instance
+ */
+declare function getComplianceService(config?: ComplianceServiceConfig): ComplianceService;
+/**
+ * Reset the global compliance service instance
+ */
+declare function resetComplianceService(): void;
+
+/**
+ * Wallet Service for React applications
+ *
+ * Provides React-friendly wallet connection and management utilities
+ * with proper error handling and state management integration.
+ */
+interface WalletConnectionResult {
+    success: boolean;
+    provider?: ethers.Provider;
+    signer?: ethers.Signer;
+    address?: string;
+    chainId?: number;
+    error?: string;
+}
+interface WalletInfo {
+    address: string;
+    chainId: number;
+    balance: string;
+    isConnected: boolean;
+}
+declare class WalletService {
+    private provider;
+    private signer;
+    private currentAddress;
+    /**
+     * Connect to MetaMask or other Web3 wallet
+     */
+    connectWallet(): Promise<WalletConnectionResult>;
+    /**
+     * Disconnect wallet
+     */
+    disconnect(): void;
+    /**
+     * Get current wallet info
+     */
+    getWalletInfo(): Promise<WalletInfo | null>;
+    /**
+     * Switch to a specific network
+     */
+    switchNetwork(chainId: number): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    /**
+     * Add a custom network to the wallet
+     */
+    addNetwork(networkConfig: {
+        chainId: number;
+        chainName: string;
+        rpcUrls: string[];
+        nativeCurrency: {
+            name: string;
+            symbol: string;
+            decimals: number;
+        };
+        blockExplorerUrls?: string[];
+    }): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    /**
+     * Sign a message
+     */
+    signMessage(message: string): Promise<{
+        success: boolean;
+        signature?: string;
+        error?: string;
+    }>;
+    /**
+     * Get current provider
+     */
+    getProvider(): ethers.Provider | null;
+    /**
+     * Get current signer
+     */
+    getSigner(): ethers.Signer | null;
+    /**
+     * Get current address
+     */
+    getCurrentAddress(): string | null;
+    /**
+     * Check if wallet is connected
+     */
+    isConnected(): boolean;
+    /**
+     * Listen for account changes
+     */
+    onAccountsChanged(callback: (accounts: string[]) => void): void;
+    /**
+     * Listen for chain changes
+     */
+    onChainChanged(callback: (chainId: string) => void): void;
+    /**
+     * Remove event listeners
+     */
+    removeAllListeners(): void;
+}
+/**
+ * Get or create the global wallet service instance
+ */
+declare function getWalletService(): WalletService;
+/**
+ * Reset the global wallet service instance
+ */
+declare function resetWalletService(): void;
+declare global {
+    interface Window {
+        ethereum?: {
+            request: (args: {
+                method: string;
+                params?: any[];
+            }) => Promise<any>;
+            on: (event: string, callback: (...args: any[]) => void) => void;
+            removeAllListeners: (event: string) => void;
+        };
+    }
+}
+
+/**
+ * Custom React hooks for TREZA SDK integration
+ *
+ * These hooks provide easy-to-use React integration for compliance and wallet functionality
+ */
+interface UseWalletResult {
+    isConnected: boolean;
+    isConnecting: boolean;
+    walletInfo: WalletInfo | null;
+    provider: ethers.Provider | null;
+    signer: ethers.Signer | null;
+    address: string | null;
+    error: string | null;
+    connect: () => Promise<void>;
+    disconnect: () => void;
+    switchNetwork: (chainId: number) => Promise<void>;
+}
+/**
+ * Hook for wallet connection and management
+ */
+declare function useWallet(): UseWalletResult;
+interface UseComplianceResult {
+    isInitialized: boolean;
+    isLoading: boolean;
+    error: string | null;
+    initiateVerification: (requirements?: ComplianceRequirements) => Promise<string | null>;
+    processVerification: (zkPassportResult: any, userAddress: string) => Promise<VerificationResult | null>;
+    checkCompliance: (userAddress: string) => Promise<ComplianceStatus | null>;
+    generateQRCode: (url: string) => Promise<string | null>;
+}
+/**
+ * Hook for compliance operations
+ */
+declare function useCompliance(provider?: ethers.Provider, signer?: ethers.Signer): UseComplianceResult;
+interface UseTrezaResult {
+    wallet: UseWalletResult;
+    compliance: UseComplianceResult;
+    isReady: boolean;
+}
+/**
+ * Combined hook for wallet and compliance functionality
+ */
+declare function useTreza(): UseTrezaResult;
+interface UseVerificationFlowResult {
+    status: 'idle' | 'generating' | 'waiting' | 'processing' | 'completed' | 'error';
+    verificationUrl: string | null;
+    qrCode: string | null;
+    result: VerificationResult | null;
+    error: string | null;
+    startVerification: (userAddress: string, requirements?: ComplianceRequirements) => Promise<void>;
+    processResult: (zkPassportResult: any) => Promise<void>;
+    reset: () => void;
+}
+/**
+ * Hook for managing the complete verification flow
+ */
+declare function useVerificationFlow(provider?: ethers.Provider, signer?: ethers.Signer): UseVerificationFlowResult;
+
+/**
+ * @treza/react - React components for TREZA SDK
+ *
+ * Privacy-first DeFi UI components with zero-knowledge compliance
+ */
+
+declare const VERSION = "1.0.0";
+
+export { ComplianceProvider, ComplianceService, ComplianceStatusDisplay, ComplianceVerification, GovernanceEligibility, VERSION, WalletService, complianceStyles, getComplianceService, getWalletService, resetComplianceService, resetWalletService, useCompliance, useComplianceContext, useTreza, useVerificationFlow, useWallet };
+export type { ComplianceServiceConfig, UseComplianceResult, UseTrezaResult, UseVerificationFlowResult, UseWalletResult, WalletConnectionResult, WalletInfo };