neozipkit 0.1.1

package/dist/browser/CertificateGeneratorBrowser.js

@@ -0,0 +1,433 @@
+"use strict";
+// ======================================
+//	CertificateGeneratorBrowser.ts
+//  Browser-compatible certificate generator for tokenized ZIP files
+//  Copyright (c) 2025 NeoWare, Inc. All rights reserved.
+// ======================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CertificateGeneratorBrowser = void 0;
+exports.createCertificateGenerator = createCertificateGenerator;
+exports.generateTokenCertificate = generateTokenCertificate;
+const Headers_1 = require("../shared/constants/Headers");
+/**
+ * Browser-compatible certificate generator class
+ */
+class CertificateGeneratorBrowser {
+    /**
+     * Generates a certificate HTML document for tokenized ZIP files
+     */
+    createTokenCertificate(tokenInfo, zipFile, blockchainVerification, walletInfo, zipFiles, options) {
+        // Generate token information HTML
+        const tokenHTML = this.generateTokenSection(tokenInfo);
+        // Generate blockchain verification HTML
+        const verificationHTML = this.generateVerificationSection(blockchainVerification);
+        // Generate wallet information HTML
+        const walletHTML = walletInfo ? this.generateWalletSection(walletInfo) : '';
+        // Generate files table HTML
+        const filesTableHTML = zipFiles ? this.generateFilesTable(zipFiles) : '';
+        // Get the complete HTML template
+        const htmlTemplate = this.getCertificateTemplate();
+        // Create the complete attestation HTML combining all sections
+        const attestHTML = tokenHTML + verificationHTML + walletHTML;
+        // Replace placeholders in the template
+        const html = htmlTemplate
+            .replace(/{{ATTEST_STR}}/g, `NFT Token Certificate for ${zipFile}`)
+            .replace(/{{UPDATE_WARNING}}/g, blockchainVerification.verificationStatus === 'FAILED' ?
+            '<div class="warning">⚠️ Warning: Blockchain verification failed. This archive may have been tampered with.</div>' : '')
+            .replace(/{{ZIP_FILE}}/g, zipFile)
+            .replace(/{{HASH_DIGEST}}/g, blockchainVerification.calculatedMerkleRoot)
+            .replace(/{{ATTESTATION_HTML}}/g, attestHTML)
+            .replace(/{{FILES_TABLE_HTML}}/g, filesTableHTML)
+            .replace(/{{GENERATION_TIME}}/g, new Date().toUTCString());
+        return html;
+    }
+    /**
+     * Saves a certificate as a downloadable file (browser-compatible)
+     */
+    saveCertificate(fileName, certificateHTML) {
+        const baseName = fileName.replace(/\.zip$/i, '');
+        const certFileName = `${baseName}.token-certificate.html`;
+        // Create a blob with the HTML content
+        const blob = new Blob([certificateHTML], { type: 'text/html' });
+        // Create a download link
+        const url = URL.createObjectURL(blob);
+        const link = document.createElement('a');
+        link.href = url;
+        link.download = certFileName;
+        // Trigger download
+        document.body.appendChild(link);
+        link.click();
+        document.body.removeChild(link);
+        // Clean up the URL object
+        URL.revokeObjectURL(url);
+    }
+    /**
+     * Generate token information section
+     */
+    generateTokenSection(tokenInfo) {
+        return `
+      <div class="token-section">
+        <h3>🎫 NFT Token Information</h3>
+        <div class="key-value-pair">
+          <div class="key">Token ID:</div>
+          <div class="value"><code>${tokenInfo.tokenId}</code></div>
+        </div>
+        <div class="key-value-pair">
+          <div class="key">Network:</div>
+          <div class="value">${tokenInfo.network}</div>
+        </div>
+        <div class="key-value-pair">
+          <div class="key">Contract Address:</div>
+          <div class="value"><code>${tokenInfo.contractAddress}</code></div>
+        </div>
+        <div class="key-value-pair">
+          <div class="key">Transaction Hash:</div>
+          <div class="value"><code>${tokenInfo.transactionHash}</code></div>
+        </div>
+        ${tokenInfo.wallet ? `
+        <div class="key-value-pair">
+          <div class="key">Wallet:</div>
+          <div class="value"><code>${tokenInfo.wallet}</code></div>
+        </div>
+        ` : ''}
+        ${tokenInfo.timestamp ? `
+        <div class="key-value-pair">
+          <div class="key">Minted At:</div>
+          <div class="value">${new Date(tokenInfo.timestamp * 1000).toUTCString()}</div>
+        </div>
+        ` : ''}
+        ${tokenInfo.note ? `
+        <div class="key-value-pair">
+          <div class="key">Note:</div>
+          <div class="value">${tokenInfo.note}</div>
+        </div>
+        ` : ''}
+      </div>
+    `;
+    }
+    /**
+     * Generate blockchain verification section
+     */
+    generateVerificationSection(verification) {
+        const statusIcon = verification.verificationStatus === 'PASSED' ? '✅' :
+            verification.verificationStatus === 'FAILED' ? '❌' : '⚠️';
+        return `
+      <div class="verification-section ${verification.verificationStatus.toLowerCase()}">
+        <h3>🔐 Blockchain Verification</h3>
+        <div class="verification-status ${verification.verificationStatus.toLowerCase()}">
+          ${statusIcon} <strong>Status: ${verification.verificationStatus}</strong>
+        </div>
+        <div class="key-value-pair">
+          <div class="key">Blockchain Merkle Root:</div>
+          <div class="value"><code>${verification.blockchainMerkleRoot}</code></div>
+        </div>
+        <div class="key-value-pair">
+          <div class="key">Calculated Merkle Root:</div>
+          <div class="value"><code>${verification.calculatedMerkleRoot}</code></div>
+        </div>
+        <div class="key-value-pair">
+          <div class="key">Integrity Check:</div>
+          <div class="value">${verification.merkleRootMatches ?
+            '✅ Archive contents match blockchain record' :
+            '❌ Archive contents do not match blockchain record'}</div>
+        </div>
+        ${verification.verificationTime ? `
+        <div class="key-value-pair">
+          <div class="key">Verified At:</div>
+          <div class="value">${new Date(verification.verificationTime * 1000).toUTCString()}</div>
+        </div>
+        ` : ''}
+        ${verification.blockNumber ? `
+        <div class="key-value-pair">
+          <div class="key">Block Number:</div>
+          <div class="value">${verification.blockNumber}</div>
+        </div>
+        ` : ''}
+      </div>
+    `;
+    }
+    /**
+     * Generate wallet information section
+     */
+    generateWalletSection(walletInfo) {
+        return `
+      <div class="wallet-section">
+        <h3>👛 Wallet Information</h3>
+        <div class="key-value-pair">
+          <div class="key">Address:</div>
+          <div class="value"><code>${walletInfo.address}</code></div>
+        </div>
+        <div class="key-value-pair">
+          <div class="key">Network:</div>
+          <div class="value">${walletInfo.network}</div>
+        </div>
+        ${walletInfo.balance ? `
+        <div class="key-value-pair">
+          <div class="key">Balance:</div>
+          <div class="value">${walletInfo.balance}</div>
+        </div>
+        ` : ''}
+        ${walletInfo.ensName ? `
+        <div class="key-value-pair">
+          <div class="key">ENS Name:</div>
+          <div class="value">${walletInfo.ensName}</div>
+        </div>
+        ` : ''}
+      </div>
+    `;
+    }
+    /**
+     * Generate files table
+     */
+    generateFilesTable(zipFiles) {
+        if (zipFiles.length === 0) {
+            return '<tr><td colspan="4">No files found</td></tr>';
+        }
+        return zipFiles.map(file => `
+      <tr>
+        <td class="table-data1">${file.filename}</td>
+        <td>${file.size.toLocaleString()}</td>
+        <td>${file.date}</td>
+        <td><code>${file.hash}</code></td>
+      </tr>
+    `).join('');
+    }
+    /**
+     * Get the HTML template for certificates
+     */
+    getCertificateTemplate() {
+        return `<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>NFT Token Certificate - {{ZIP_FILE}}</title>
+    <style>
+        body {
+            font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif;
+            line-height: 1.6;
+            margin: 0;
+            padding: 20px;
+            background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+            min-height: 100vh;
+        }
+        .certificate {
+            max-width: 900px;
+            margin: 0 auto;
+            background: white;
+            border-radius: 15px;
+            box-shadow: 0 20px 40px rgba(0,0,0,0.1);
+            overflow: hidden;
+        }
+        .header {
+            background: linear-gradient(135deg, #2c3e50 0%, #3498db 100%);
+            color: white;
+            padding: 30px;
+            text-align: center;
+        }
+        .header h1 {
+            margin: 0;
+            font-size: 2.5em;
+            font-weight: 300;
+        }
+        .header h2 {
+            margin: 10px 0 0 0;
+            font-size: 1.2em;
+            opacity: 0.9;
+        }
+        .content {
+            padding: 40px;
+        }
+        .token-section, .verification-section, .wallet-section {
+            margin-bottom: 30px;
+            padding: 20px;
+            border-radius: 10px;
+            border-left: 4px solid #3498db;
+            background: #f8f9fa;
+        }
+        .verification-section.passed {
+            border-left-color: #27ae60;
+        }
+        .verification-section.failed {
+            border-left-color: #e74c3c;
+        }
+        .verification-section.unavailable {
+            border-left-color: #f39c12;
+        }
+        .verification-status {
+            font-size: 1.2em;
+            margin-bottom: 15px;
+            padding: 10px;
+            border-radius: 5px;
+        }
+        .verification-status.passed {
+            background: #d4edda;
+            color: #155724;
+        }
+        .verification-status.failed {
+            background: #f8d7da;
+            color: #721c24;
+        }
+        .verification-status.unavailable {
+            background: #fff3cd;
+            color: #856404;
+        }
+        .key-value-pair {
+            display: flex;
+            margin-bottom: 10px;
+            align-items: flex-start;
+        }
+        .key {
+            font-weight: bold;
+            min-width: 200px;
+            color: #2c3e50;
+        }
+        .value {
+            flex: 1;
+            word-break: break-all;
+        }
+        .value code {
+            background: #e9ecef;
+            padding: 2px 6px;
+            border-radius: 3px;
+            font-family: 'Monaco', 'Menlo', monospace;
+            font-size: 0.9em;
+        }
+        .files-section {
+            margin-top: 30px;
+        }
+        .files-table {
+            width: 100%;
+            border-collapse: collapse;
+            margin-top: 15px;
+        }
+        .files-table th,
+        .files-table td {
+            padding: 12px;
+            text-align: left;
+            border-bottom: 1px solid #dee2e6;
+        }
+        .files-table th {
+            background: #f8f9fa;
+            font-weight: bold;
+            color: #2c3e50;
+        }
+        .table-data1 {
+            font-weight: bold;
+        }
+        .warning {
+            background: #fff3cd;
+            color: #856404;
+            padding: 15px;
+            border-radius: 5px;
+            margin-bottom: 20px;
+            border-left: 4px solid #ffc107;
+        }
+        .footer {
+            text-align: center;
+            padding: 20px;
+            background: #f8f9fa;
+            color: #6c757d;
+            font-size: 0.9em;
+        }
+        h3 {
+            margin-top: 0;
+            color: #2c3e50;
+            font-size: 1.3em;
+        }
+    </style>
+</head>
+<body>
+    <div class="certificate">
+        <div class="header">
+            <h1>🎫 NFT Token Certificate</h1>
+            <h2>Blockchain-Verified Digital Archive</h2>
+        </div>
+        
+        <div class="content">
+            {{UPDATE_WARNING}}
+            
+            <div class="key-value-pair" style="margin-bottom: 30px; font-size: 1.1em;">
+                <div class="key">Archive File:</div>
+                <div class="value"><strong>{{ZIP_FILE}}</strong></div>
+            </div>
+            
+            {{ATTESTATION_HTML}}
+            
+            <div class="files-section">
+                <h3>📁 Archive Contents</h3>
+                <table class="files-table">
+                    <thead>
+                        <tr>
+                            <th>File Name</th>
+                            <th>Size (bytes)</th>
+                            <th>Date Modified</th>
+                            <th>SHA256 Hash</th>
+                        </tr>
+                    </thead>
+                    <tbody>
+                        {{FILES_TABLE_HTML}}
+                    </tbody>
+                </table>
+            </div>
+        </div>
+        
+        <div class="footer">
+            <p>This certificate verifies the integrity and authenticity of the tokenized archive through blockchain technology.</p>
+            <p>Generated on: {{GENERATION_TIME}}</p>
+        </div>
+    </div>
+</body>
+</html>`;
+    }
+    /**
+     * Prepares file information from ZIP entries for certificate generation
+     */
+    prepareZipFileInfo(zipEntries) {
+        const zipFiles = [];
+        for (const entry of zipEntries) {
+            // Skip the token file itself and directories
+            if (entry.filename !== Headers_1.TOKENIZED_METADATA &&
+                !entry.isDirectory &&
+                entry.sha256) {
+                zipFiles.push({
+                    filename: entry.filename,
+                    size: entry.uncompressedSize,
+                    date: this.formatEntryDate(entry),
+                    hash: entry.sha256
+                });
+            }
+        }
+        return zipFiles;
+    }
+    /**
+     * Formats the date from a ZIP entry
+     */
+    formatEntryDate(entry) {
+        try {
+            // Try to use the entry's date formatting if available
+            if (typeof entry.toFormattedUTCDateString === 'function') {
+                return entry.toFormattedUTCDateString();
+            }
+            // Fallback to current date
+            return new Date().toUTCString();
+        }
+        catch (error) {
+            return new Date().toUTCString();
+        }
+    }
+}
+exports.CertificateGeneratorBrowser = CertificateGeneratorBrowser;
+/**
+ * Creates a new CertificateGeneratorBrowser instance
+ */
+function createCertificateGenerator() {
+    return new CertificateGeneratorBrowser();
+}
+/**
+ * Convenience function to generate a certificate
+ */
+function generateTokenCertificate(tokenInfo, zipFile, blockchainVerification, walletInfo, zipFiles) {
+    const generator = new CertificateGeneratorBrowser();
+    return generator.createTokenCertificate(tokenInfo, zipFile, blockchainVerification, walletInfo, zipFiles);
+}

package/dist/browser/TokenVerifierBrowser.d.ts

@@ -0,0 +1,76 @@
+import ZipKitBrowser from './ZipKitBrowser';
+import { ZipEntry } from '../shared/ZipKit';
+export interface NZipTokenInfo {
+    version: string;
+    tokenId: string;
+    contractAddress: string;
+    network: string;
+    networkChainId: number;
+    transactionHash: string;
+    merkleRoot: string;
+    fileName: string;
+    mintedAt: string;
+}
+export interface TokenVerificationOptions {
+    skipHash?: boolean;
+    skipToken?: boolean;
+    generateCertificate?: boolean;
+    zipFileName?: string;
+}
+export interface TokenVerificationResult {
+    isTokenized: boolean;
+    tokenMetadata: NZipTokenInfo | null;
+    calculatedMerkleRoot: string | null;
+    blockchainMerkleRoot: string | null;
+    blockchainTimestamp?: number;
+    verificationPassed: boolean;
+    certificatePath?: string;
+    errorMessage?: string;
+}
+export interface BlockchainVerification {
+    merkleRootMatches: boolean;
+    blockchainMerkleRoot: string;
+    calculatedMerkleRoot: string;
+    verificationStatus: 'PASSED' | 'FAILED' | 'UNAVAILABLE';
+    verificationTime?: number;
+    blockNumber?: number;
+}
+/**
+ * Browser-compatible token verification class
+ */
+export declare class TokenVerifierBrowser {
+    private zipKit;
+    constructor(zipKit: ZipKitBrowser);
+    /**
+     * Checks if the ZIP file contains NFT token metadata and verifies the merkle root
+     */
+    checkForTokenization(zipEntries: ZipEntry[], options?: TokenVerificationOptions): Promise<TokenVerificationResult>;
+    /**
+     * Validates token metadata structure
+     */
+    private validateTokenInfo;
+    /**
+     * Calculates the merkle root excluding the token metadata file
+     */
+    private calculateMerkleRootExcludingToken;
+    /**
+     * Queries the blockchain to get the actual merkle root and timestamp stored in the smart contract
+     */
+    private queryBlockchainData;
+    /**
+     * Helper to convert Blob to string
+     */
+    private blobToString;
+    /**
+     * Creates a formatted summary of token information
+     */
+    createTokenSummary(tokenMetadata: NZipTokenInfo): string;
+}
+/**
+ * Creates a new TokenVerifierBrowser instance
+ */
+export declare function createTokenVerifier(zipKit: ZipKitBrowser): TokenVerifierBrowser;
+/**
+ * Convenience function to check for tokenization
+ */
+export declare function checkForTokenization(zipKit: ZipKitBrowser, zipEntries: ZipEntry[], options?: TokenVerificationOptions): Promise<TokenVerificationResult>;