neozipkit 0.1.1

package/src/server/blockchain/CertificateToken.ts

@@ -0,0 +1,444 @@
+// ======================================
+//	CertificateToken.ts
+//  Copyright (c) 2025 NeoWare, Inc. All rights reserved.
+//  
+//  Standalone certificate generator for tokenized ZIP files
+//  This will be integrated into neozipkit once fully functional
+// ======================================
+
+import fs from 'fs';
+import path from 'path';
+
+// Token-specific types
+export interface TokenInfo {
+  tokenId: string;
+  contractAddress: string;
+  network: string;
+  transactionHash: string;
+  wallet?: string;
+  timestamp?: number;
+  note?: string;
+}
+
+export interface BlockchainVerification {
+  merkleRootMatches: boolean;
+  blockchainMerkleRoot: string;
+  calculatedMerkleRoot: string;
+  verificationStatus: 'PASSED' | 'FAILED' | 'UNAVAILABLE';
+  verificationTime?: number;
+  blockNumber?: number;
+}
+
+export interface WalletInfo {
+  address: string;
+  balance?: string;
+  network: string;
+  ensName?: string;
+}
+
+export interface ZipFileInfo {
+  filename: string;
+  size: number;
+  date: string;
+  hash: string;
+}
+
+/**
+ * Generates a certificate HTML document for tokenized ZIP files
+ * 
+ * @param tokenInfo - NFT token information
+ * @param zipFile - Name of the zip file
+ * @param blockchainVerification - Blockchain verification results
+ * @param walletInfo - Wallet information (optional)
+ * @param zipFiles - Array of file information (optional)
+ * @param options - Certificate generation options
+ * @returns Generated HTML certificate as string
+ */
+export function createTokenCertificate(
+  tokenInfo: TokenInfo,
+  zipFile: string,
+  blockchainVerification: BlockchainVerification,
+  walletInfo?: WalletInfo,
+  zipFiles?: ZipFileInfo[],
+  options?: { narrow?: boolean; includeQR?: boolean }
+): string {
+  
+  // Generate token information HTML
+  const tokenHTML = generateTokenSection(tokenInfo);
+  
+  // Generate blockchain verification HTML
+  const verificationHTML = generateVerificationSection(blockchainVerification);
+  
+  // Generate wallet information HTML
+  const walletHTML = walletInfo ? generateWalletSection(walletInfo) : '';
+  
+  // Generate files table HTML
+  const filesTableHTML = zipFiles ? generateFilesTable(zipFiles) : '';
+  
+  // Get the complete HTML template
+  const htmlTemplate = 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 to disk
+ */
+export function saveCertificate(
+  fileName: string,
+  certificateHTML: string,
+  outputDir?: string
+): string {
+  try {
+    const dir = outputDir || path.dirname(fileName);
+    const baseName = path.basename(fileName, '.zip');
+    const certFileName = path.join(dir, `${baseName}.token-certificate.html`);
+    
+    // Ensure directory exists
+    if (!fs.existsSync(dir)) {
+      fs.mkdirSync(dir, { recursive: true });
+    }
+    
+    // Write the certificate HTML to a file
+    fs.writeFileSync(certFileName, certificateHTML, { encoding: 'utf8' });
+    return certFileName;
+  } catch (error) {
+    throw new Error(`Failed to save certificate: ${error}`);
+  }
+}
+
+/**
+ * Generate token information section
+ */
+function generateTokenSection(tokenInfo: TokenInfo): string {
+  return `
+    <div class="token-section">
+      <h3>🎫 NFT Token Information</h3>
+      <div class="key-value-pair">
+        <div class="key">Token ID:</div>
+        <div class="value">${tokenInfo.tokenId}</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">Network:</div>
+        <div class="value">${tokenInfo.network}</div>
+      </div>
+      <div class="key-value-pair">
+        <div class="key">Minting Transaction:</div>
+        <div class="value"><code>${tokenInfo.transactionHash}</code></div>
+      </div>
+      ${tokenInfo.timestamp ? `
+      <div class="key-value-pair">
+        <div class="key">Token Created:</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
+ */
+function generateVerificationSection(verification: BlockchainVerification): string {
+  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
+ */
+function generateWalletSection(walletInfo: WalletInfo): string {
+  return `
+    <div class="wallet-section">
+      <h3>👛 Wallet Information</h3>
+      <div class="key-value-pair">
+        <div class="key">Wallet Address:</div>
+        <div class="value"><code>${walletInfo.address}</code></div>
+      </div>
+      ${walletInfo.ensName ? `
+      <div class="key-value-pair">
+        <div class="key">ENS Name:</div>
+        <div class="value">${walletInfo.ensName}</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>
+      ` : ''}
+    </div>
+  `;
+}
+
+/**
+ * Generate files table HTML
+ */
+function generateFilesTable(files: ZipFileInfo[]): string {
+  let filesTableHTML = '';
+  
+  files.forEach((file) => {
+    filesTableHTML += `
+      <tr>
+        <td class="table-data1">${file.filename}</td>
+        <td class="table-data">${file.size.toString()}</td>
+        <td class="table-data">${file.date}</td>
+        <td class="table-data"><code>${file.hash}</code></td>
+      </tr>
+    `;
+  });
+  
+  return filesTableHTML;
+}
+
+/**
+ * Get the HTML template for certificates
+ */
+function getCertificateTemplate(): string {
+  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>`;
+}