neozipkit 0.1.1

package/contracts/deploy/deploy-both-contracts.js

@@ -0,0 +1,286 @@
+const { ethers } = require('ethers');
+const fs = require('fs');
+const path = require('path');
+
+/**
+ * Deployment script for both NZIP NFT contracts
+ * 
+ * This script deploys:
+ * 1. NZIP-NFT.sol (Public contract with universal verification)
+ * 2. NZIP-NFT-Private.sol (Private contract with owner-only verification)
+ * 
+ * Usage:
+ * 1. Compile both contracts in Remix or using solc
+ * 2. Copy the bytecode and ABI for both contracts into this script
+ * 3. Run: node deploy-both-contracts.js
+ */
+
+// =============================================================================
+// CONFIGURATION
+// =============================================================================
+
+const NETWORK_CONFIG = {
+  // Base Sepolia (Testnet)
+  84532: {
+    name: "Base Sepolia",
+    rpcUrl: "https://sepolia.base.org",
+    explorerUrl: "https://sepolia.basescan.org",
+    chainId: 84532
+  },
+  // Base Mainnet
+  8453: {
+    name: "Base Mainnet", 
+    rpcUrl: "https://mainnet.base.org",
+    explorerUrl: "https://basescan.org",
+    chainId: 8453
+  }
+};
+
+// Configuration - Load from environment variables or config file
+function loadConfig() {
+  let config = {};
+  
+  // Try to load from deployment.config.js first
+  try {
+    config = require('../../deployment.config.js');
+    console.log('📁 Loaded configuration from deployment.config.js');
+  } catch (err) {
+    console.log('📁 No deployment.config.js found, using environment variables');
+  }
+  
+  // Environment variables override config file
+  const CHAIN_ID = process.env.CHAIN_ID ? parseInt(process.env.CHAIN_ID) : (config.CHAIN_ID || 84532);
+  const PRIVATE_KEY = process.env.PRIVATE_KEY || config.PRIVATE_KEY;
+  
+  return { CHAIN_ID, PRIVATE_KEY, EXISTING_CONTRACT: config.EXISTING_CONTRACT };
+}
+
+// Default to Base Sepolia for testing
+const { CHAIN_ID, PRIVATE_KEY, EXISTING_CONTRACT } = loadConfig();
+
+// =============================================================================
+// CONTRACT BYTECODE AND ABI (REPLACE WITH COMPILED CONTRACT DATA)
+// =============================================================================
+
+// TODO: Replace with actual compiled bytecode from Remix/solc
+const PUBLIC_CONTRACT_BYTECODE = "0x608060405234801561001057600080fd5b50..."; // REPLACE ME
+const PRIVATE_CONTRACT_BYTECODE = "0x608060405234801561001057600080fd5b50..."; // REPLACE ME
+
+// TODO: Replace with actual compiled ABI from Remix/solc
+const PUBLIC_CONTRACT_ABI = [
+  // REPLACE WITH ACTUAL ABI FROM NZIP-NFT.sol
+  "constructor()",
+  "function publicMintZipFile(string memory fileName, string memory merkleRootHash, uint256 creationTimestamp, string memory ipfsHash, string memory tokenURI) public returns (uint256)",
+  "function getZipFileInfo(uint256 tokenId) external view returns (tuple(string fileName, string merkleRootHash, string ipfsHash, address creator, uint256 creationTimestamp, uint256 tokenizationTime, uint256 blockNumber, bytes32 blockHash))",
+  "function totalSupply() public view returns (uint256)"
+];
+
+const PRIVATE_CONTRACT_ABI = [
+  // REPLACE WITH ACTUAL ABI FROM NZIP-NFT-Private.sol  
+  "constructor()",
+  "function publicMintZipFile(string memory fileName, string memory merkleRootHash, uint256 creationTimestamp, string memory ipfsHash, string memory tokenURI) public returns (uint256)",
+  "function getZipFileInfo(uint256 tokenId) external view returns (tuple(string fileName, string merkleRootHash, string ipfsHash, address creator, uint256 creationTimestamp, uint256 tokenizationTime, uint256 blockNumber, bytes32 blockHash))",
+  "function authorizeVerifier(uint256 tokenId, address authorizedAddress, bool authorized) external",
+  "function totalSupply() public view returns (uint256)"
+];
+
+// =============================================================================
+// DEPLOYMENT FUNCTIONS
+// =============================================================================
+
+async function deployContract(contractName, bytecode, abi, signer) {
+  console.log(`\n🚀 Deploying ${contractName}...`);
+  
+  try {
+    // Create contract factory
+    const contractFactory = new ethers.ContractFactory(abi, bytecode, signer);
+    
+    // Estimate gas for deployment
+    const gasEstimate = await contractFactory.estimateDeployment();
+    console.log(`⛽ Estimated gas: ${gasEstimate.toString()}`);
+    
+    // Deploy the contract
+    const contract = await contractFactory.deploy();
+    console.log(`📋 Transaction hash: ${contract.deploymentTransaction().hash}`);
+    console.log(`⏳ Waiting for confirmation...`);
+    
+    // Wait for deployment to be mined
+    await contract.waitForDeployment();
+    const address = await contract.getAddress();
+    
+    console.log(`✅ ${contractName} deployed successfully!`);
+    console.log(`📍 Contract address: ${address}`);
+    
+    return {
+      address,
+      transactionHash: contract.deploymentTransaction().hash,
+      contract
+    };
+    
+  } catch (error) {
+    console.error(`❌ Failed to deploy ${contractName}:`, error);
+    throw error;
+  }
+}
+
+async function deployBothContracts() {
+  console.log('🎯 NZIP NFT Contracts Deployment');
+  console.log('=======================================');
+  
+  // Validate configuration
+  if (!PRIVATE_KEY) {
+    throw new Error('❌ PRIVATE_KEY environment variable is required');
+  }
+  
+  if (!NETWORK_CONFIG[CHAIN_ID]) {
+    throw new Error(`❌ Unsupported chain ID: ${CHAIN_ID}`);
+  }
+  
+  const networkConfig = NETWORK_CONFIG[CHAIN_ID];
+  console.log(`🌐 Network: ${networkConfig.name}`);
+  console.log(`🔗 RPC URL: ${networkConfig.rpcUrl}`);
+  console.log(`🔍 Explorer: ${networkConfig.explorerUrl}`);
+  
+  // Validate contract data
+  if (PUBLIC_CONTRACT_BYTECODE.length < 10 || PRIVATE_CONTRACT_BYTECODE.length < 10) {
+    throw new Error('❌ Contract bytecode not provided. Please compile contracts and update the script.');
+  }
+  
+  try {
+    // Initialize provider and wallet
+    console.log('\n🔑 Initializing wallet...');
+    const provider = new ethers.JsonRpcProvider(networkConfig.rpcUrl);
+    const wallet = new ethers.Wallet(PRIVATE_KEY, provider);
+    
+    console.log(`👛 Deployer address: ${wallet.address}`);
+    
+    // Check balance
+    const balance = await provider.getBalance(wallet.address);
+    const balanceEth = ethers.formatEther(balance);
+    console.log(`💰 Balance: ${balanceEth} ETH`);
+    
+    if (parseFloat(balanceEth) < 0.01) {
+      console.warn('⚠️ Low balance detected. Make sure you have enough ETH for deployment.');
+    }
+    
+    // Deploy both contracts
+    const deploymentResults = {};
+    
+    // Deploy Public Contract
+    const publicResult = await deployContract(
+      "NZIP NFT (Public)",
+      PUBLIC_CONTRACT_BYTECODE,
+      PUBLIC_CONTRACT_ABI,
+      wallet
+    );
+    deploymentResults.public = publicResult;
+    
+    // Deploy Private Contract  
+    const privateResult = await deployContract(
+      "NZIP NFT (Private)",
+      PRIVATE_CONTRACT_BYTECODE,
+      PRIVATE_CONTRACT_ABI,
+      wallet
+    );
+    deploymentResults.private = privateResult;
+    
+    // Test basic functionality
+    console.log('\n🧪 Testing deployed contracts...');
+    
+    try {
+      const publicSupply = await deploymentResults.public.contract.totalSupply();
+      const privateSupply = await deploymentResults.private.contract.totalSupply();
+      
+      console.log(`✅ Public contract total supply: ${publicSupply}`);
+      console.log(`✅ Private contract total supply: ${privateSupply}`);
+    } catch (testError) {
+      console.warn('⚠️ Contract testing failed (this may be expected):', testError.message);
+    }
+    
+    // Generate deployment summary
+    const summary = {
+      network: networkConfig.name,
+      chainId: CHAIN_ID,
+      deployerAddress: wallet.address,
+      deployedAt: new Date().toISOString(),
+      contracts: {
+        public: {
+          name: "NZIP NFT (Public)",
+          address: deploymentResults.public.address,
+          transactionHash: deploymentResults.public.transactionHash,
+          explorerUrl: `${networkConfig.explorerUrl}/address/${deploymentResults.public.address}`,
+          txExplorerUrl: `${networkConfig.explorerUrl}/tx/${deploymentResults.public.transactionHash}`
+        },
+        private: {
+          name: "NZIP NFT (Private)", 
+          address: deploymentResults.private.address,
+          transactionHash: deploymentResults.private.transactionHash,
+          explorerUrl: `${networkConfig.explorerUrl}/address/${deploymentResults.private.address}`,
+          txExplorerUrl: `${networkConfig.explorerUrl}/tx/${deploymentResults.private.transactionHash}`
+        }
+      }
+    };
+    
+    // Save deployment info
+    const deploymentFile = `deployment-${networkConfig.name.toLowerCase().replace(' ', '-')}-${Date.now()}.json`;
+    fs.writeFileSync(deploymentFile, JSON.stringify(summary, null, 2));
+    
+    // Display final summary
+    console.log('\n🎉 DEPLOYMENT COMPLETE!');
+    console.log('=======================================');
+    console.log(`📄 Deployment summary saved to: ${deploymentFile}`);
+    console.log('\n📋 Contract Addresses:');
+    console.log(`🌐 Public Contract:  ${summary.contracts.public.address}`);
+    console.log(`🔒 Private Contract: ${summary.contracts.private.address}`);
+    
+    console.log('\n🔗 Explorer Links:');
+    console.log(`🌐 Public Contract:  ${summary.contracts.public.explorerUrl}`);
+    console.log(`🔒 Private Contract: ${summary.contracts.private.explorerUrl}`);
+    
+    console.log('\n📜 Transaction Links:');
+    console.log(`🌐 Public TX:  ${summary.contracts.public.txExplorerUrl}`);
+    console.log(`🔒 Private TX: ${summary.contracts.private.txExplorerUrl}`);
+    
+    console.log('\n⚙️ Next Steps:');
+    console.log('1. Verify contracts on the block explorer');
+    console.log('2. Update portal configuration with new contract addresses');
+    console.log('3. Update neozipkit package with new ABIs');
+    console.log('4. Test minting functionality');
+    
+    console.log('\n🔧 Portal Configuration Updates Needed:');
+    console.log('File: apps/portal/src/lib/tokenization.ts');
+    console.log(`- Update CONTRACT_CONFIG.contractAddress to: "${summary.contracts.public.address}"`);
+    console.log('\nFile: apps/portal/src/services/nftTokenService.ts');
+    console.log('- Add private contract configuration if needed');
+    
+    return summary;
+    
+  } catch (error) {
+    console.error('\n❌ Deployment failed:', error);
+    throw error;
+  }
+}
+
+// =============================================================================
+// MAIN EXECUTION
+// =============================================================================
+
+if (require.main === module) {
+  // Only run if this file is executed directly
+  deployBothContracts()
+    .then((summary) => {
+      console.log('\n✅ All deployments completed successfully!');
+      process.exit(0);
+    })
+    .catch((error) => {
+      console.error('\n❌ Deployment process failed:', error);
+      process.exit(1);
+    });
+}
+
+// Export for use in other scripts
+module.exports = {
+  deployBothContracts,
+  deployContract,
+  NETWORK_CONFIG
+}; 

package/contracts/deploy/deploy-enhanced-contract.js

@@ -0,0 +1,197 @@
+const { ethers } = require('ethers');
+const fs = require('fs');
+const path = require('path');
+
+// Contract deployment configuration
+const DEPLOYMENT_CONFIG = {
+  networks: {
+    'base-sepolia': {
+      name: 'Base Sepolia',
+      chainId: 84532,
+      rpcUrl: 'https://sepolia.base.org',
+      explorerUrl: 'https://sepolia.basescan.org'
+    },
+    'base-mainnet': {
+      name: 'Base Mainnet', 
+      chainId: 8453,
+      rpcUrl: 'https://mainnet.base.org',
+      explorerUrl: 'https://basescan.org'
+    }
+  }
+};
+
+// Contract source (you'll need to compile this or use Remix)
+const CONTRACT_SOURCE = `
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.19;
+
+// NOTE: This script expects the compiled contract bytecode and ABI
+// Compile ZipFileNFT-Enhanced.sol using Remix, Hardhat, or Foundry
+`;
+
+async function deployEnhancedContract(networkName = 'base-sepolia', privateKey = null) {
+  try {
+    console.log('🚀 Starting Enhanced NZIP Contract Deployment');
+    console.log('='.repeat(50));
+    
+    const network = DEPLOYMENT_CONFIG.networks[networkName];
+    if (!network) {
+      throw new Error(`Network ${networkName} not supported. Available: ${Object.keys(DEPLOYMENT_CONFIG.networks).join(', ')}`);
+    }
+    
+    console.log(`📡 Network: ${network.name} (Chain ID: ${network.chainId})`);
+    console.log(`🔗 RPC URL: ${network.rpcUrl}`);
+    
+    // Setup provider and wallet
+    const provider = new ethers.JsonRpcProvider(network.rpcUrl);
+    
+    if (!privateKey) {
+      privateKey = process.env.DEPLOYER_PRIVATE_KEY;
+      if (!privateKey) {
+        throw new Error('Please provide DEPLOYER_PRIVATE_KEY environment variable or pass privateKey parameter');
+      }
+    }
+    
+    const wallet = new ethers.Wallet(privateKey, provider);
+    const deployerAddress = await wallet.getAddress();
+    
+    console.log(`👛 Deployer Address: ${deployerAddress}`);
+    
+    // Check balance
+    const balance = await provider.getBalance(deployerAddress);
+    const balanceInEth = ethers.formatEther(balance);
+    console.log(`💰 Deployer Balance: ${balanceInEth} ETH`);
+    
+    if (parseFloat(balanceInEth) < 0.01) {
+      console.warn('⚠️  Low balance detected. You may need more ETH for deployment.');
+    }
+    
+    // Contract bytecode and ABI (these need to be compiled first)
+    console.log('📄 Loading contract artifacts...');
+    
+    // NOTE: You'll need to replace these with actual compiled contract data
+    const contractBytecode = "0x608060405234801561001057600080fd5b50..." // Replace with actual bytecode
+    const contractABI = [
+      // Replace with actual ABI from compilation
+      "constructor()",
+      "function publicMintZipFile(string memory fileName, string memory merkleRootHash, uint256 creationTimestamp, string memory ipfsHash, string memory tokenURI) public returns (uint256)",
+      "function getZipFileInfo(uint256 tokenId) external view returns (tuple(string fileName, string merkleRootHash, string ipfsHash, address creator, uint256 creationTimestamp, uint256 tokenizationTime, uint256 blockNumber, bytes32 blockHash))"
+    ];
+    
+    // Create contract factory
+    const contractFactory = new ethers.ContractFactory(contractABI, contractBytecode, wallet);
+    
+    // Estimate gas
+    console.log('⛽ Estimating deployment gas...');
+    const deploymentGas = await contractFactory.getDeployTransaction().gasLimit;
+    
+    const gasPrice = await provider.getFeeData();
+    const estimatedCost = deploymentGas * gasPrice.gasPrice;
+    const costInEth = ethers.formatEther(estimatedCost);
+    
+    console.log(`📊 Estimated Gas: ${deploymentGas.toString()}`);
+    console.log(`💰 Estimated Cost: ${costInEth} ETH`);
+    
+    // Deploy contract
+    console.log('🏗️  Deploying Enhanced NZIP Contract...');
+    console.log('⏳ Please wait for deployment confirmation...');
+    
+    const contract = await contractFactory.deploy();
+    
+    console.log(`📜 Transaction Hash: ${contract.deploymentTransaction().hash}`);
+    console.log('⏳ Waiting for deployment confirmation...');
+    
+    // Wait for deployment
+    await contract.waitForDeployment();
+    const contractAddress = await contract.getAddress();
+    
+    console.log('✅ Contract Deployed Successfully!');
+    console.log('='.repeat(50));
+    console.log(`📍 Contract Address: ${contractAddress}`);
+    console.log(`🔗 Explorer: ${network.explorerUrl}/address/${contractAddress}`);
+    console.log(`📜 Transaction: ${network.explorerUrl}/tx/${contract.deploymentTransaction().hash}`);
+    
+    // Verify deployment
+    console.log('🔍 Verifying deployment...');
+    try {
+      const code = await provider.getCode(contractAddress);
+      if (code !== '0x') {
+        console.log('✅ Contract code verified on blockchain');
+      } else {
+        console.log('❌ No contract code found at address');
+      }
+    } catch (error) {
+      console.log('⚠️  Could not verify contract code:', error.message);
+    }
+    
+    // Generate deployment summary
+    const deploymentSummary = {
+      network: network.name,
+      chainId: network.chainId,
+      contractAddress: contractAddress,
+      transactionHash: contract.deploymentTransaction().hash,
+      deployerAddress: deployerAddress,
+      blockNumber: contract.deploymentTransaction().blockNumber,
+      gasUsed: deploymentGas.toString(),
+      deploymentTime: new Date().toISOString(),
+      explorerUrl: `${network.explorerUrl}/address/${contractAddress}`
+    };
+    
+    // Save deployment info
+    const deploymentFile = `deployment-${networkName}-${Date.now()}.json`;
+    fs.writeFileSync(deploymentFile, JSON.stringify(deploymentSummary, null, 2));
+    console.log(`📄 Deployment info saved to: ${deploymentFile}`);
+    
+    // Update portal configuration instructions
+    console.log('\n🔧 Next Steps:');
+    console.log('1. Update portal configuration:');
+    console.log(`   - File: apps/portal/src/lib/tokenization.ts`);
+    console.log(`   - Update contractAddress: "${contractAddress}"`);
+    console.log('\n2. Update server configuration:');
+    console.log(`   - File: apps/portal/src/services/nftTokenService.ts`);
+    console.log(`   - Update NZIP_CONTRACT_ADDRESSES[${network.chainId}]: "${contractAddress}"`);
+    console.log('\n3. Update neozipkit configuration:');
+    console.log(`   - Files: packages/neozipkit/server-components/blockchain/*.ts`);
+    console.log(`   - Update contract addresses to: "${contractAddress}"`);
+    
+    return deploymentSummary;
+    
+  } catch (error) {
+    console.error('❌ Deployment failed:', error);
+    throw error;
+  }
+}
+
+// Helper function to compile contract (requires solc)
+async function compileContract() {
+  console.log('🔨 Compiling Enhanced NZIP Contract...');
+  
+  // This is a placeholder - you'll need to implement actual compilation
+  // or use external tools like Remix, Hardhat, or Foundry
+  
+  console.log('📝 Please compile ZipFileNFT-Enhanced.sol using:');
+  console.log('   - Remix IDE (https://remix.ethereum.org)');
+  console.log('   - Hardhat: npx hardhat compile');
+  console.log('   - Foundry: forge build');
+  console.log('   - Solc: solc --optimize --bin --abi ZipFileNFT-Enhanced.sol');
+  
+  throw new Error('Contract compilation not implemented. Please compile manually and update bytecode/ABI in this script.');
+}
+
+// Main execution
+if (require.main === module) {
+  const args = process.argv.slice(2);
+  const networkName = args[0] || 'base-sepolia';
+  
+  deployEnhancedContract(networkName)
+    .then((result) => {
+      console.log('\n🎉 Deployment completed successfully!');
+      process.exit(0);
+    })
+    .catch((error) => {
+      console.error('\n💥 Deployment failed:', error.message);
+      process.exit(1);
+    });
+}
+
+module.exports = { deployEnhancedContract, DEPLOYMENT_CONFIG }; 

package/contracts/deploy/deploy-private-contract.js

@@ -0,0 +1,190 @@
+const { deployContract, NETWORK_CONFIG } = require('./deploy-both-contracts');
+const { ethers } = require('ethers');
+const fs = require('fs');
+
+/**
+ * Deployment script for NZIP NFT Private Contract Only
+ * 
+ * This script deploys only the private NZIP-NFT-Private.sol contract
+ * Usage: node deploy-private-contract.js
+ */
+
+// Configuration - Load from environment variables or config file
+function loadConfig() {
+  let config = {};
+  
+  // Try to load from deployment.config.js first
+  try {
+    config = require('../deployment.config.js');
+    console.log('📁 Loaded configuration from deployment.config.js');
+  } catch (err) {
+    console.log('📁 No deployment.config.js found, using environment variables');
+  }
+  
+  // Environment variables override config file
+  const CHAIN_ID = process.env.CHAIN_ID ? parseInt(process.env.CHAIN_ID) : (config.CHAIN_ID || 84532);
+  const PRIVATE_KEY = process.env.PRIVATE_KEY || config.PRIVATE_KEY;
+  
+  return { CHAIN_ID, PRIVATE_KEY, EXISTING_CONTRACT: config.EXISTING_CONTRACT };
+}
+
+const { CHAIN_ID, PRIVATE_KEY, EXISTING_CONTRACT } = loadConfig();
+
+// TODO: Replace with actual compiled bytecode and ABI from NZIP-NFT-Private.sol
+const CONTRACT_BYTECODE = "0x608060405234801561001057600080fd5b50..."; // REPLACE ME
+const CONTRACT_ABI = [
+  // REPLACE WITH ACTUAL ABI FROM NZIP-NFT-Private.sol
+  "constructor()",
+  "function publicMintZipFile(string memory fileName, string memory merkleRootHash, uint256 creationTimestamp, string memory ipfsHash, string memory tokenURI) public returns (uint256)",
+  "function getZipFileInfo(uint256 tokenId) external view returns (tuple(string fileName, string merkleRootHash, string ipfsHash, address creator, uint256 creationTimestamp, uint256 tokenizationTime, uint256 blockNumber, bytes32 blockHash))",
+  "function getPublicTokenInfo(uint256 tokenId) external view returns (string memory fileName, address creator, uint256 tokenizationTime, uint256 blockNumber)",
+  "function verifyZipFile(uint256 tokenId, string memory providedMerkleRoot) external view returns (bool isValid)",
+  "function authorizeVerifier(uint256 tokenId, address authorizedAddress, bool authorized) external",
+  "function isAuthorizedVerifier(uint256 tokenId, address verifierAddress) external view returns (bool)",
+  "function getBlockchainMetadata(uint256 tokenId) external view returns (uint256 blockNumber, bytes32 blockHash, uint256 tokenizationTime)",
+  "function getTokensByOwner(address owner) external view returns (uint256[] memory)",
+  "function totalSupply() public view returns (uint256)"
+];
+
+async function deployPrivateContract() {
+  console.log('🔒 NZIP NFT Private Contract Deployment');
+  console.log('======================================');
+  
+  // Validate configuration
+  if (!PRIVATE_KEY) {
+    throw new Error('❌ PRIVATE_KEY environment variable is required');
+  }
+  
+  if (!NETWORK_CONFIG[CHAIN_ID]) {
+    throw new Error(`❌ Unsupported chain ID: ${CHAIN_ID}`);
+  }
+  
+  const networkConfig = NETWORK_CONFIG[CHAIN_ID];
+  console.log(`🌐 Network: ${networkConfig.name}`);
+  console.log(`🔗 RPC URL: ${networkConfig.rpcUrl}`);
+  console.log(`🔍 Explorer: ${networkConfig.explorerUrl}`);
+  
+  // Validate contract data
+  if (CONTRACT_BYTECODE.length < 10) {
+    throw new Error('❌ Contract bytecode not provided. Please compile NZIP-NFT-Private.sol and update the script.');
+  }
+  
+  try {
+    // Initialize provider and wallet
+    console.log('\n🔑 Initializing wallet...');
+    const provider = new ethers.JsonRpcProvider(networkConfig.rpcUrl);
+    const wallet = new ethers.Wallet(PRIVATE_KEY, provider);
+    
+    console.log(`👛 Deployer address: ${wallet.address}`);
+    
+    // Check balance
+    const balance = await provider.getBalance(wallet.address);
+    const balanceEth = ethers.formatEther(balance);
+    console.log(`💰 Balance: ${balanceEth} ETH`);
+    
+    if (parseFloat(balanceEth) < 0.01) {
+      console.warn('⚠️ Low balance detected. Make sure you have enough ETH for deployment.');
+    }
+    
+    // Deploy contract
+    const result = await deployContract(
+      "NZIP NFT (Private)",
+      CONTRACT_BYTECODE,
+      CONTRACT_ABI,
+      wallet
+    );
+    
+    // Test basic functionality
+    console.log('\n🧪 Testing deployed contract...');
+    
+    try {
+      const totalSupply = await result.contract.totalSupply();
+      console.log(`✅ Contract total supply: ${totalSupply}`);
+    } catch (testError) {
+      console.warn('⚠️ Contract testing failed:', testError.message);
+    }
+    
+    // Generate deployment summary
+    const summary = {
+      network: networkConfig.name,
+      chainId: CHAIN_ID,
+      deployerAddress: wallet.address,
+      deployedAt: new Date().toISOString(),
+      contract: {
+        name: "NZIP NFT (Private)",
+        type: "private",
+        address: result.address,
+        transactionHash: result.transactionHash,
+        explorerUrl: `${networkConfig.explorerUrl}/address/${result.address}`,
+        txExplorerUrl: `${networkConfig.explorerUrl}/tx/${result.transactionHash}`,
+        features: [
+          "Owner-only verification",
+          "Private blockchain metadata access",
+          "8-field enhanced structure",
+          "Selective authorization system",
+          "Privacy-conscious events",
+          "Owner dashboard support"
+        ]
+      }
+    };
+    
+    // Save deployment info
+    const deploymentFile = `deployment-private-${networkConfig.name.toLowerCase().replace(' ', '-')}-${Date.now()}.json`;
+    fs.writeFileSync(deploymentFile, JSON.stringify(summary, null, 2));
+    
+    // Display final summary
+    console.log('\n🎉 PRIVATE CONTRACT DEPLOYMENT COMPLETE!');
+    console.log('=======================================');
+    console.log(`📄 Deployment summary saved to: ${deploymentFile}`);
+    console.log(`📋 Contract Address: ${summary.contract.address}`);
+    console.log(`🔗 Explorer Link: ${summary.contract.explorerUrl}`);
+    console.log(`📜 Transaction Link: ${summary.contract.txExplorerUrl}`);
+    
+    console.log('\n✨ Contract Features:');
+    summary.contract.features.forEach(feature => {
+      console.log(`  🔒 ${feature}`);
+    });
+    
+    console.log('\n🔐 Privacy Features:');
+    console.log('  • Only token owners can verify their tokens');
+    console.log('  • Sensitive data (merkle root, IPFS hash) stored privately');
+    console.log('  • Owners can authorize specific addresses for verification');
+    console.log('  • Events do not expose sensitive information');
+    console.log('  • Public functions only reveal safe metadata');
+    
+    console.log('\n⚙️ Next Steps:');
+    console.log('1. Verify contract on the block explorer');
+    console.log('2. Update portal configuration for private contracts:');
+    console.log(`   - File: apps/portal/src/services/nftTokenService.ts`);
+    console.log(`   - Add private contract configuration`);
+    console.log('3. Test minting and authorization functionality');
+    console.log('4. Deploy public contract if needed for comparison');
+    
+    console.log('\n📖 Usage Examples:');
+    console.log('• Mint a private token: contract.publicMintZipFile(...)');
+    console.log('• Authorize verifier: contract.authorizeVerifier(tokenId, address, true)');
+    console.log('• Verify as owner: contract.verifyZipFile(tokenId, merkleRoot)');
+    console.log('• Get owner tokens: contract.getTokensByOwner(ownerAddress)');
+    
+    return summary;
+    
+  } catch (error) {
+    console.error('\n❌ Deployment failed:', error);
+    throw error;
+  }
+}
+
+// Main execution
+if (require.main === module) {
+  deployPrivateContract()
+    .then((summary) => {
+      console.log('\n✅ Private contract deployment completed successfully!');
+      process.exit(0);
+    })
+    .catch((error) => {
+      console.error('\n❌ Private contract deployment failed:', error);
+      process.exit(1);
+    });
+}
+
+module.exports = { deployPrivateContract };