neozipkit 0.1.1 → 0.3.0

package/dist/blockchain/core/ZipkitVerifier.d.ts

@@ -0,0 +1,177 @@
+#!/usr/bin/env node
+/**
+ * ZipkitVerifier - Handles NFT token verification for ZIP files
+ * Verifier API for NZIP-NFT smart contract.
+ */
+import { type ContractConfig } from './contracts';
+import type { TokenMetadata } from '../../types';
+export interface VerificationOptions {
+    debug?: boolean;
+    skipHash?: boolean;
+}
+export interface VerificationResult {
+    success: boolean;
+    message: string;
+    tokenMetadata?: TokenMetadata;
+    verificationDetails?: {
+        tokenId: string;
+        network: string;
+        contractAddress: string;
+        merkleRoot: string;
+        mintDate: string;
+        calculatedMerkleRoot?: string;
+        declaredMerkleRoot?: string;
+        merkleRootMatch?: boolean;
+        onChainValid?: boolean;
+        currentWallet?: string;
+    };
+    errorDetails?: {
+        errorType: 'METADATA_ERROR' | 'MERKLE_ERROR' | 'NETWORK_ERROR' | 'CONTRACT_ERROR';
+        networkName?: string;
+        rpcUrl?: string;
+        contractAddress?: string;
+        tokenId?: string;
+        merkleRoot?: string;
+        calculatedMerkleRoot?: string;
+        onChainMerkleRoot?: string;
+    };
+}
+export interface EnhancedVerificationResult extends VerificationResult {
+    retryAttempts?: number;
+    processingTime?: number;
+    timestamp?: number;
+}
+export interface BatchVerificationResult {
+    success: boolean;
+    totalTokens: number;
+    successfulVerifications: number;
+    failedVerifications: number;
+    results: EnhancedVerificationResult[];
+    processingTime: number;
+}
+export interface VerificationJob {
+    tokenId: string;
+    merkleRoot?: string;
+    priority?: 'low' | 'normal' | 'high';
+    retryCount?: number;
+}
+/**
+ * Blockchain Token Verifier for ZIP files
+ */
+export declare class ZipkitVerifier {
+    private debug;
+    protected maxRetries: number;
+    protected retryDelay: number;
+    protected batchDelay: number;
+    constructor(options?: VerificationOptions & {
+        maxRetries?: number;
+        retryDelay?: number;
+        batchDelay?: number;
+    });
+    /**
+     * Extract and validate token metadata from ZIP
+     */
+    extractTokenMetadata(tokenBuffer: Buffer): Promise<{
+        success: boolean;
+        metadata?: TokenMetadata;
+        error?: string;
+    }>;
+    /**
+     * Map network name to RPC configuration using contracts.ts (single source of truth)
+     * Supports both old metadata (without networkChainId) and new metadata (with networkChainId)
+     */
+    private getNetworkConfig;
+    /**
+     * Perform merkle root comparison
+     */
+    private compareMerkleRoots;
+    /**
+     * Verify token against blockchain
+     * @param rpcUrlIndex Optional index of RPC URL to use (default: 0)
+     */
+    verifyOnChain(tokenId: string, contractAddress: string, networkConfig: ContractConfig, merkleRoot: string, rpcUrlIndex?: number): Promise<{
+        success: boolean;
+        isValid?: boolean;
+        onChainMerkleRoot?: string;
+        onChainTokenizationTime?: number;
+        onChainCreator?: string;
+        onChainBlockNumber?: number;
+        error?: string;
+        rpcUrl?: string;
+    }>;
+    /**
+     * Complete verification process
+     * @param rpcUrlIndex Optional index of RPC URL to use (default: 0)
+     */
+    verifyToken(tokenMetadata: TokenMetadata, calculatedMerkleRoot: string | null, options?: VerificationOptions, rpcUrlIndex?: number): Promise<VerificationResult>;
+    /**
+     * Verify token with retry logic and exponential backoff
+     * @param tokenMetadata Token metadata to verify
+     * @param calculatedMerkleRoot Calculated merkle root from archive
+     * @param maxRetries Maximum number of retry attempts (default: uses instance maxRetries)
+     * @returns Enhanced verification result with retry information
+     */
+    verifyTokenWithRetry(tokenMetadata: TokenMetadata, calculatedMerkleRoot: string | null, maxRetries?: number): Promise<EnhancedVerificationResult>;
+    /**
+     * Batch verification for multiple tokens with rate limiting
+     * @param tokens Array of token metadata and merkle roots to verify
+     * @param options Batch processing options
+     * @returns Batch verification result
+     */
+    verifyBatch(tokens: Array<{
+        tokenMetadata: TokenMetadata;
+        calculatedMerkleRoot: string | null;
+    }>, options?: {
+        parallel?: boolean;
+        maxConcurrent?: number;
+    }): Promise<BatchVerificationResult>;
+    /**
+     * Verify tokens in parallel with concurrency control
+     */
+    private verifyBatchParallel;
+    /**
+     * Verify tokens sequentially with rate limiting
+     */
+    private verifyBatchSequential;
+    /**
+     * Process verification jobs with priority queue
+     * @param jobs Array of verification jobs
+     * @param options Processing options
+     * @returns Batch verification result
+     */
+    processVerificationJobs(jobs: VerificationJob[], options?: {
+        maxConcurrent?: number;
+        priorityOrder?: boolean;
+        getTokenMetadata?: (tokenId: string) => Promise<TokenMetadata | null>;
+        getCalculatedMerkleRoot?: (tokenId: string) => Promise<string | null>;
+    }): Promise<BatchVerificationResult>;
+    /**
+     * Sort verification jobs by priority
+     */
+    private sortJobsByPriority;
+    /**
+     * Calculate retry delay with exponential backoff
+     */
+    protected calculateRetryDelay(attempt: number): number;
+    /**
+     * Utility method for delays
+     */
+    protected delay(ms: number): Promise<void>;
+    /**
+     * Get verification statistics
+     */
+    getVerificationStats(): {
+        maxRetries: number;
+        retryDelay: number;
+        batchDelay: number;
+    };
+    /**
+     * Update verification configuration
+     */
+    updateConfig(config: {
+        maxRetries?: number;
+        retryDelay?: number;
+        batchDelay?: number;
+    }): void;
+}
+//# sourceMappingURL=ZipkitVerifier.d.ts.map

package/dist/blockchain/core/ZipkitVerifier.d.ts.map

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