neozip-cli 0.70.0-alpha

package/WHY_NEOZIP.md

@@ -0,0 +1,212 @@
+# Why NeoZip?
+
+## A New Generation of Archive Applications
+
+NeoZip CLI represents the first release of a new generation of archive applications that integrate blockchain technology for data integrity, authenticity, and provenance. While maintaining near-perfect compatibility with traditional ZIP utilities, NeoZip introduces revolutionary capabilities that transform archives from simple containers into cryptographically verifiable, blockchain-anchored data structures.
+
+For more information, visit [https://neozip.io](https://neozip.io).
+
+## The Problem with Traditional Archives
+
+Traditional ZIP files have served us well for decades, but they have fundamental limitations:
+
+- **No Cryptographic Proof**: Traditional ZIPs lack cryptographic proof of integrity. You can't verify that an archive hasn't been tampered with without external verification systems.
+- **No Authenticity Verification**: There's no built-in way to verify that an archive is authentic or that it was created by a specific party.
+- **No Immutable Record**: Archive creation and modification history can be lost or altered. There's no permanent, immutable record of when or how an archive was created.
+- **Limited Provenance Tracking**: Tracking the origin and history of archived data requires external systems and manual processes.
+
+These limitations become critical in scenarios where data integrity, authenticity, and provenance matter—legal documentation, software distribution, digital preservation, and compliance requirements.
+
+## The NeoZip Solution
+
+NeoZip solves these problems by integrating blockchain technology directly into the archive format:
+
+### Blockchain Tokenization
+
+Each archive can be tokenized as an NFT on a blockchain network. This creates an immutable, on-chain record of the archive's existence and contents. The token serves as a permanent cryptographic proof of the archive's creation.
+
+### Smart Contract Integration
+
+NeoZip archives connect to smart contracts for automated verification and interaction. This enables archives to participate in decentralized workflows, automated compliance checks, and programmable data management.
+
+### Integrity Verification
+
+NeoZip calculates SHA-256 hashes for all files in an archive and constructs a Merkle tree. The Merkle root is stored on-chain, providing cryptographic proof that the archive contents haven't been modified. Anyone can verify an archive's integrity by comparing the calculated Merkle root with the on-chain value.
+
+### Provenance Tracking
+
+Every tokenized archive has an immutable blockchain record showing when it was created, on which network, and by which wallet address. This creates a permanent audit trail for compliance and legal purposes.
+
+### Standard Compatibility
+
+Despite these advanced features, NeoZip maintains ~99% compatibility with PKzip, InfoZip utilities and the standard ZIP format. NeoZip archives work with existing ZIP tools and infrastructure, ensuring backward compatibility while adding new capabilities.
+
+## Key Features & Benefits
+
+### Data Integrity
+
+- SHA-256 hashes for all files ensure data integrity
+- Merkle root stored on-chain provides tamper-proof verification
+- Automatic integrity checks during extraction
+
+### Authenticity Verification
+
+- Verify that archives haven't been tampered with
+- Cryptographic proof of archive contents
+- On-chain verification without external systems
+
+### Blockchain Provenance
+
+- Immutable record of archive creation
+- Permanent audit trail on the blockchain
+- Timestamp and creator information stored on-chain
+
+### Smart Contract Integration
+
+- Archives can interact with decentralized applications
+- Programmable archive management
+- Integration with DeFi and Web3 ecosystems
+
+### Standard ZIP Format
+
+- Works with existing ZIP tools
+- Compatible with standard ZIP infrastructure
+- No vendor lock-in
+
+## Technical Innovation
+
+NeoZip is the first archive utility to integrate blockchain tokenization natively. Key innovations include:
+
+- **Merkle Tree-Based Verification**: Uses cryptographic Merkle trees to create tamper-proof integrity proofs
+- **Multi-Network Support**: Supports multiple EVM blockchain networks including Base, Arbitrum, and Ethereum
+- **OpenTimestamp Integration**: Optional Bitcoin blockchain timestamping for additional verification
+- **Smart Contract Architecture**: Designed to work with smart contracts for automated verification and management
+
+## The NeoZip Ecosystem
+
+NeoZip is more than a single tool—it's an ecosystem of applications and libraries. Learn more about the NeoZip ecosystem at [https://neozip.io](https://neozip.io):
+
+### neozip-cli
+
+The command-line interface (this package) is the first release of the NeoZip ecosystem. It provides full-featured ZIP creation, extraction, and listing capabilities with integrated blockchain tokenization.
+
+### NeoZip GUI
+
+A graphical user interface is currently in development. The GUI will provide a user-friendly interface for blockchain-enabled archives, making blockchain tokenization accessible to non-technical users while maintaining all the power and features of the CLI.
+
+### neozipkit
+
+The core library will be released as open-source software, enabling developers to build custom archive applications. This open-source release will:
+
+- Enable developers to build custom archive applications
+- Encourage community development and innovation
+- Provide the foundation for next-generation archive tools
+- Support integration with other blockchain protocols and applications
+
+## Use Cases
+
+NeoZip's blockchain integration opens up new possibilities across industries and applications. Learn more about specific use cases at [https://neozip.io](https://neozip.io):
+
+### Secure Document Archiving
+
+Safeguard sensitive documents by creating NeoZip archives that are tokenized as NFTs on the blockchain, ensuring verifiable ownership and protection against tampering. The immutable blockchain record provides cryptographic proof that documents haven't been altered, making NeoZip ideal for:
+
+- **Legal Documentation**: Contracts, agreements, and legal filings with provable authenticity
+- **Medical Records**: Patient data archives with immutable integrity verification
+- **Financial Documents**: Transaction records, invoices, and audit trails
+- **Government Records**: Public records and official documentation with permanent verification
+
+### Digital Asset Management
+
+Manage and transfer digital assets securely by tokenizing ZIP files, providing a transparent and immutable record of ownership and authenticity. NeoZip enables:
+
+- **Content Distribution**: Verify that digital content (media, software, documents) hasn't been modified during distribution
+- **Asset Provenance**: Track the origin and ownership history of digital assets
+- **Transfer Verification**: Ensure digital assets maintain integrity during transfers between parties
+- **Collection Management**: Create verifiable collections of digital assets with blockchain-backed ownership records
+
+### Intellectual Property Protection
+
+Protect intellectual property by creating NeoZip archives that serve as proof of creation and ownership, deterring unauthorized use or distribution. The blockchain timestamp provides indisputable evidence of:
+
+- **Copyright Claims**: Prove when creative works were created and archived
+- **Patent Documentation**: Maintain immutable records of invention documentation
+- **Trade Secrets**: Archive confidential information with cryptographic integrity guarantees
+- **Research Data**: Preserve research findings with verifiable timestamps and integrity
+
+### Regulatory Compliance
+
+Meet compliance requirements by maintaining unalterable records of file existence and integrity, facilitated through blockchain timestamping. NeoZip helps organizations satisfy:
+
+- **GDPR Requirements**: Immutable audit trails for data processing and archival
+- **SOX Compliance**: Financial records with tamper-proof verification
+- **HIPAA Compliance**: Healthcare data archives with cryptographic integrity
+- **Industry Standards**: Sector-specific compliance requirements with blockchain-backed verification
+
+### Software Distribution
+
+Verify that software packages haven't been tampered with between creation and installation. The blockchain record provides cryptographic proof of package integrity, essential for:
+
+- **Package Repositories**: Verify software packages before installation
+- **CI/CD Pipelines**: Integrate NeoZip into automated workflows for verifiable build artifacts
+- **Software Supply Chain**: Ensure software integrity throughout the distribution chain
+- **Update Verification**: Verify that software updates are authentic and unmodified
+
+### Automated Workflows
+
+Integrate NeoZip into automated workflows using the command-line interface to create verifiable archives programmatically, enhancing efficiency in:
+
+- **CI/CD Pipelines**: Automatically create blockchain-verified archives of build artifacts
+- **Batch Processing**: Process large volumes of files with automated tokenization
+- **Scheduled Backups**: Create cryptographically verified backups on a schedule
+- **Data Pipeline Integration**: Integrate blockchain verification into existing data processing workflows
+
+### Digital Preservation
+
+Long-term archival with cryptographic proof ensures that archived data can be verified decades later, even if the original systems are no longer available. NeoZip provides:
+
+- **Museum Archives**: Preserve digital collections with permanent integrity verification
+- **Library Systems**: Maintain digital archives with blockchain-backed authenticity
+- **Historical Records**: Archive historical documents with immutable verification
+- **Cultural Heritage**: Preserve cultural artifacts in digital form with cryptographic guarantees
+
+### Document Management
+
+Prove document authenticity and creation time with immutable blockchain records. This is valuable for:
+
+- **Contract Management**: Maintain verifiable records of contract creation and modifications
+- **Certificate Verification**: Issue and verify certificates with blockchain-backed authenticity
+- **Notarization**: Create blockchain-backed notarized documents
+- **Chain of Custody**: Track document handling with immutable audit trails
+
+### Data Backup & Recovery
+
+Cryptographically verified backups ensure that backup data hasn't been corrupted or tampered with, providing confidence in data recovery:
+
+- **Enterprise Backups**: Verify backup integrity before and after storage
+- **Disaster Recovery**: Ensure recovery data is authentic and unmodified
+- **Cloud Storage Verification**: Verify data integrity in cloud storage systems
+- **Backup Validation**: Automatically verify backup archives during creation and restoration
+
+## Future Vision
+
+The upcoming open-source release of neozipkit will enable:
+
+- **Custom Archive Applications**: Developers can build specialized archive tools for specific use cases
+- **Protocol Integration**: Integration with other blockchain protocols and decentralized storage systems
+- **Community Innovation**: Open-source development will drive new features and use cases
+- **Ecosystem Growth**: A thriving ecosystem of NeoZip-based applications and tools
+
+NeoZip represents the evolution of archive technology—combining the reliability and compatibility of traditional ZIP files with the security, verifiability, and programmability of blockchain technology. It's not just a new tool—it's a new foundation for how we think about data archiving, integrity, and provenance in the digital age.
+
+---
+
+**Get Started**: Install NeoZip CLI and begin creating blockchain-verified archives today.
+
+```bash
+npm install -g neozip-cli@alpha
+```
+
+---
+
+**Learn More**: For detailed documentation, tutorials, and the latest updates, visit [https://neozip.io](https://neozip.io).

package/bin/neolist

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+
+/**
+ * NeoZip CLI - Full-featured command-line ZIP application
+ * Executable entry point for neolist command
+ */
+
+// Import and run the main CLI (properly handle async)
+// Note: Environment variables should be set by user or in their shell profile
+// For blockchain features, set: NEOWARE_WALLET_KEY, NEOWARE_NETWORK, etc.
+const main = require('../dist/src/index.js').default;
+main().catch(error => {
+  console.error('Error:', error);
+  process.exit(1);
+});
+

package/bin/neounzip

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+
+/**
+ * NeoZip CLI - Full-featured command-line ZIP application
+ * Executable entry point for neounzip command
+ */
+
+// Import and run the main CLI (properly handle async)
+// Note: Environment variables should be set by user or in their shell profile
+// For blockchain features, set: NEOWARE_WALLET_KEY, NEOWARE_NETWORK, etc.
+const main = require('../dist/src/index.js').default;
+main().catch(error => {
+  console.error('Error:', error);
+  process.exit(1);
+});
+

package/bin/neozip

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+
+/**
+ * NeoZip CLI - Full-featured command-line ZIP application
+ * Executable entry point for neozip command
+ */
+
+// Import and run the main CLI (properly handle async)
+// Note: Environment variables should be set by user or in their shell profile
+// For blockchain features, set: NEOWARE_WALLET_KEY, NEOWARE_NETWORK, etc.
+const main = require('../dist/src/index.js').default;
+main().catch(error => {
+  console.error('Error:', error);
+  process.exit(1);
+});