neozip-cli 0.70.0-alpha

package/dist/src/config/WalletConfig.js

@@ -0,0 +1,372 @@
+"use strict";
+/**
+ * WalletConfig - Configuration manager for NeoZip wallet and blockchain settings
+ * Supports wallet.json file in user's home directory with fallback to environment variables
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WalletConfig = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const contracts_1 = require('../../neozipkit-wrappers/blockchain/core/contracts');
+const DEFAULTS = {
+    network: 'base-sepolia',
+    rpcUrls: {
+        baseSepolia: 'https://sepolia.base.org',
+        baseMainnet: 'https://mainnet.base.org',
+    },
+    gas: {
+        multiplier: 1.0,
+        maxPriceGwei: 100,
+    },
+    debug: {
+        verbose: false,
+        enabled: false,
+    },
+};
+class WalletConfig {
+    /**
+     * Get the configuration directory path
+     */
+    static getConfigDir() {
+        return this.configDir;
+    }
+    /**
+     * Get the configuration file path
+     */
+    static getConfigPath() {
+        return this.configPath;
+    }
+    /**
+     * Check if wallet.json exists
+     */
+    static exists() {
+        return fs.existsSync(this.getConfigPath());
+    }
+    /**
+     * Load configuration from wallet.json
+     */
+    static load() {
+        if (!this.exists()) {
+            return null;
+        }
+        try {
+            const content = fs.readFileSync(this.getConfigPath(), 'utf-8');
+            return JSON.parse(content);
+        }
+        catch (error) {
+            console.error(`⚠️  Failed to load wallet.json: ${error}`);
+            return null;
+        }
+    }
+    /**
+     * Save configuration to wallet.json
+     */
+    static save(config) {
+        try {
+            // Ensure config directory exists
+            const configDir = this.getConfigDir();
+            if (!fs.existsSync(configDir)) {
+                fs.mkdirSync(configDir, { recursive: true, mode: 0o700 });
+            }
+            // Write config file with restricted permissions
+            fs.writeFileSync(this.getConfigPath(), JSON.stringify(config, null, 2), { mode: 0o600 });
+            return true;
+        }
+        catch (error) {
+            console.error(`❌ Failed to save wallet.json: ${error}`);
+            return false;
+        }
+    }
+    /**
+     * Delete wallet.json configuration
+     */
+    static reset() {
+        try {
+            if (this.exists()) {
+                fs.unlinkSync(this.getConfigPath());
+            }
+            return true;
+        }
+        catch (error) {
+            console.error(`❌ Failed to delete wallet.json: ${error}`);
+            return false;
+        }
+    }
+    /**
+     * Get resolved configuration with precedence: CLI args > ENV vars > wallet.json > defaults
+     * @param cliWalletKey - Wallet key from CLI argument (highest priority)
+     */
+    static getConfig(cliWalletKey) {
+        const jsonConfig = this.load();
+        // Wallet key precedence: CLI > ENV > wallet.json
+        let walletKey = null;
+        if (cliWalletKey) {
+            walletKey = cliWalletKey;
+        }
+        else if (process.env.NEOZIP_WALLET_PASSKEY) {
+            walletKey = process.env.NEOZIP_WALLET_PASSKEY;
+        }
+        else if (jsonConfig?.wallet?.privateKey) {
+            walletKey = jsonConfig.wallet.privateKey;
+        }
+        // Network precedence: ENV > wallet.json > default
+        const network = process.env.NEOZIP_NETWORK ||
+            jsonConfig?.wallet?.network ||
+            DEFAULTS.network;
+        // RPC URLs precedence: ENV > wallet.json > default
+        const rpcUrls = {
+            baseSepolia: process.env.NEOZIP_BASE_SEPOLIA_RPC_URL ||
+                jsonConfig?.rpc?.baseSepolia ||
+                DEFAULTS.rpcUrls.baseSepolia,
+            baseMainnet: process.env.NEOZIP_BASE_MAINNET_RPC_URL ||
+                jsonConfig?.rpc?.baseMainnet ||
+                DEFAULTS.rpcUrls.baseMainnet,
+        };
+        // Gas settings precedence: ENV > wallet.json > default
+        const gas = {
+            multiplier: process.env.NEOZIP_GAS_MULTIPLIER ?
+                parseFloat(process.env.NEOZIP_GAS_MULTIPLIER) :
+                jsonConfig?.gas?.multiplier ||
+                    DEFAULTS.gas.multiplier,
+            maxPriceGwei: process.env.NEOZIP_MAX_GAS_PRICE ?
+                parseInt(process.env.NEOZIP_MAX_GAS_PRICE) :
+                jsonConfig?.gas?.maxPriceGwei ||
+                    DEFAULTS.gas.maxPriceGwei,
+        };
+        // Debug settings precedence: ENV > wallet.json > default
+        const debug = {
+            verbose: process.env.NEOZIP_VERBOSE === 'true' ||
+                jsonConfig?.debug?.verbose ||
+                DEFAULTS.debug.verbose,
+            enabled: process.env.NEOZIP_DEBUG === 'true' ||
+                jsonConfig?.debug?.enabled ||
+                DEFAULTS.debug.enabled,
+        };
+        return {
+            walletKey,
+            network,
+            rpcUrls,
+            gas,
+            debug,
+        };
+    }
+    /**
+     * Validate wallet private key format
+     */
+    static validatePrivateKey(key) {
+        // Must be 66 characters (0x + 64 hex chars) or 64 characters (without 0x)
+        const withPrefix = /^0x[0-9a-fA-F]{64}$/;
+        const withoutPrefix = /^[0-9a-fA-F]{64}$/;
+        return withPrefix.test(key) || withoutPrefix.test(key);
+    }
+    /**
+     * Validate network name (uses nameAliases from CONTRACT_CONFIGS)
+     */
+    static validateNetwork(network) {
+        return (0, contracts_1.getChainIdByName)(network) !== null;
+    }
+    /**
+     * Update a specific configuration value
+     */
+    static set(key, value) {
+        let config = this.load() || {
+            wallet: {},
+            rpc: {},
+            gas: {},
+            debug: {},
+        };
+        // Parse the key path (e.g., "wallet.privateKey", "gas.multiplier")
+        const parts = key.split('.');
+        switch (parts[0]) {
+            case 'wallet':
+                if (parts[1] === 'privateKey') {
+                    if (!this.validatePrivateKey(value)) {
+                        console.error('❌ Invalid private key format');
+                        return false;
+                    }
+                    config.wallet.privateKey = value.startsWith('0x') ? value : `0x${value}`;
+                }
+                else if (parts[1] === 'network') {
+                    if (!this.validateNetwork(value)) {
+                        const supportedNetworks = (0, contracts_1.getSupportedNetworkNames)();
+                        console.error(`❌ Invalid network: "${value}"`);
+                        console.error(`Supported networks: ${supportedNetworks.join(', ')}`);
+                        return false;
+                    }
+                    config.wallet.network = value;
+                }
+                break;
+            case 'rpc':
+                if (!config.rpc)
+                    config.rpc = {};
+                // Support both legacy keys and dynamic network keys
+                if (parts[1] === 'baseSepolia') {
+                    config.rpc.baseSepolia = value;
+                }
+                else if (parts[1] === 'baseMainnet') {
+                    config.rpc.baseMainnet = value;
+                }
+                else {
+                    // Allow dynamic network keys (e.g., "rpc.baseSepolia", "rpc.arbitrumSepolia")
+                    config.rpc[parts[1]] = value;
+                }
+                break;
+            case 'gas':
+                if (!config.gas)
+                    config.gas = {};
+                if (parts[1] === 'multiplier') {
+                    config.gas.multiplier = parseFloat(value);
+                }
+                else if (parts[1] === 'maxPriceGwei') {
+                    config.gas.maxPriceGwei = parseInt(value);
+                }
+                break;
+            case 'debug':
+                if (!config.debug)
+                    config.debug = {};
+                if (parts[1] === 'verbose') {
+                    config.debug.verbose = value === 'true';
+                }
+                else if (parts[1] === 'enabled') {
+                    config.debug.enabled = value === 'true';
+                }
+                break;
+            default:
+                console.error(`❌ Unknown configuration key: ${key}`);
+                return false;
+        }
+        return this.save(config);
+    }
+    /**
+     * Delete a specific configuration key
+     */
+    static delete(key) {
+        const config = this.load();
+        if (!config) {
+            console.error('❌ No configuration found');
+            return false;
+        }
+        // Parse the key path (e.g., "wallet.privateKey", "gas.multiplier")
+        const parts = key.split('.');
+        switch (parts[0]) {
+            case 'wallet':
+                if (parts[1] === 'privateKey') {
+                    delete config.wallet.privateKey;
+                }
+                else if (parts[1] === 'network') {
+                    delete config.wallet.network;
+                }
+                else {
+                    console.error(`❌ Unknown wallet key: ${parts[1]}`);
+                    return false;
+                }
+                break;
+            case 'rpc':
+                if (!config.rpc) {
+                    console.error('❌ No RPC configuration found');
+                    return false;
+                }
+                // Support both legacy keys and dynamic network keys
+                if (parts[1] === 'baseSepolia' || parts[1] === 'baseMainnet' || parts[1] in config.rpc) {
+                    delete config.rpc[parts[1]];
+                }
+                else {
+                    console.error(`❌ Unknown RPC key: ${parts[1]}`);
+                    return false;
+                }
+                break;
+            case 'gas':
+                if (!config.gas) {
+                    console.error('❌ No gas configuration found');
+                    return false;
+                }
+                if (parts[1] === 'multiplier') {
+                    delete config.gas.multiplier;
+                }
+                else if (parts[1] === 'maxPriceGwei') {
+                    delete config.gas.maxPriceGwei;
+                }
+                else {
+                    console.error(`❌ Unknown gas key: ${parts[1]}`);
+                    return false;
+                }
+                break;
+            case 'debug':
+                if (!config.debug) {
+                    console.error('❌ No debug configuration found');
+                    return false;
+                }
+                if (parts[1] === 'verbose') {
+                    delete config.debug.verbose;
+                }
+                else if (parts[1] === 'enabled') {
+                    delete config.debug.enabled;
+                }
+                else {
+                    console.error(`❌ Unknown debug key: ${parts[1]}`);
+                    return false;
+                }
+                break;
+            default:
+                console.error(`❌ Unknown configuration key: ${key}`);
+                return false;
+        }
+        return this.save(config);
+    }
+    /**
+     * Get a masked version of the config for display (hides sensitive data)
+     */
+    static getMaskedConfig() {
+        const config = this.getConfig();
+        const masked = {
+            wallet: {
+                privateKey: config.walletKey ?
+                    `${config.walletKey.substring(0, 6)}...${config.walletKey.substring(config.walletKey.length - 4)}` :
+                    '(not set)',
+                network: config.network,
+            },
+            rpc: config.rpcUrls,
+            gas: config.gas,
+            debug: config.debug,
+        };
+        return JSON.stringify(masked, null, 2);
+    }
+}
+exports.WalletConfig = WalletConfig;
+WalletConfig.configDir = path.join(os.homedir(), '.neozip');
+WalletConfig.configPath = path.join(WalletConfig.configDir, 'wallet.json');
+//# sourceMappingURL=WalletConfig.js.map

package/dist/src/exit-codes.js

@@ -0,0 +1,210 @@
+"use strict";
+/**
+ * Exit Codes for NeoZip Applications
+ *
+ * Standardized exit codes matching InfoZip conventions for compatibility
+ * and consistency across neozip, neounzip, and neolist applications.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZIPINFO_EXIT_CODES = exports.UNZIP_EXIT_CODES = exports.ZIP_EXIT_CODES = void 0;
+exports.exitZip = exitZip;
+exports.exitUnzip = exitUnzip;
+exports.exitZipinfo = exitZipinfo;
+exports.getExitCodeDescription = getExitCodeDescription;
+/**
+ * Exit codes for NEOZIP application
+ * Based on InfoZip ZIP exit codes
+ */
+exports.ZIP_EXIT_CODES = {
+    SUCCESS: 0, // Normal (no errors)
+    UNEXPECTED_END: 2, // Unexpected end of ZIP file
+    STRUCTURAL_ERROR: 3, // Structural error in ZIP file
+    MEMORY_ERROR: 4, // Memory allocation error
+    WRITE_ERROR: 5, // Write error (disk full?)
+    CANT_CREATE_FILE: 6, // Can't create file
+    CANT_CREATE_DIR: 7, // Can't create directory
+    USER_INTERRUPT: 9, // User interrupt (Ctrl-C)
+    PARAMETER_ERROR: 10, // Parameter error
+    NO_FILES_MATCHED: 11, // No files matched pattern
+    BAD_ARCHIVE_FORMAT: 12, // Bad archive format
+    CANT_OPEN_ARCHIVE: 13, // Can't open archive
+    READ_ERROR: 14, // Read error
+    CANT_WRITE_ARCHIVE: 15, // Can't write archive
+    CANT_FIND_ARCHIVE: 18, // Can't find archive
+    // NeoZip-specific exit codes (20-49)
+    TOKEN_MINT_FAILED: 20, // Token minting failed (non-fatal, ZIP created without token)
+    TOKEN_MINT_TIMEOUT: 21, // Token minting timeout
+    TOKEN_MINT_NETWORK_ERROR: 22, // Token minting network/RPC error
+    TOKEN_MINT_INSUFFICIENT_BALANCE: 23, // Insufficient balance for token minting
+    TOKEN_MINT_GAS_ERROR: 24, // Gas estimation/submission error
+    TOKEN_MINT_USER_CANCELLED: 25, // User cancelled token minting
+    BLOCKCHAIN_CONFIG_ERROR: 26, // Blockchain configuration error (wallet, network)
+    OTS_CREATE_FAILED: 27, // OpenTimestamp creation failed
+    OTS_MERKLE_ERROR: 28, // OpenTimestamp merkle root calculation error
+};
+/**
+ * Exit codes for NEOUNZIP application
+ * Based on InfoZip UNZIP exit codes
+ */
+exports.UNZIP_EXIT_CODES = {
+    SUCCESS: 0, // Success
+    WARNING: 1, // Warning errors (but completed)
+    ZIP_FORMAT_ERROR: 2, // Generic ZIP format error
+    SEVERE_ZIP_ERROR: 3, // Severe ZIP format error
+    MEMORY_ERROR: 4, // Memory allocation error
+    MEMORY_PASSWORD_ERROR: 5, // Memory/password error
+    MEMORY_DECOMPRESS_ERROR: 6, // Memory error during decompression
+    MEMORY_INMEMORY_ERROR: 7, // Memory error (in-memory decompression)
+    FILES_NOT_FOUND: 9, // Specified files not found
+    INVALID_OPTIONS: 10, // Invalid options on command line
+    NO_MATCHING_FILES: 11, // No matching files found
+    DISK_FULL: 50, // Disk full
+    UNEXPECTED_END: 51, // Unexpected end of ZIP file
+    USER_ABORTED: 80, // User aborted (Ctrl-C)
+    UNSUPPORTED_COMPRESSION: 81, // Unsupported compression/decryption
+    BAD_PASSWORD: 82, // Bad password
+    // NeoZip-specific exit codes (83-89)
+    TOKEN_VERIFY_FAILED: 83, // Token verification failed
+    TOKEN_VERIFY_TIMEOUT: 84, // Token verification timeout
+    TOKEN_VERIFY_NETWORK_ERROR: 85, // Token verification network/RPC error
+    TOKEN_VERIFY_METADATA_ERROR: 86, // Token metadata missing or invalid
+    TOKEN_VERIFY_MERKLE_MISMATCH: 87, // Merkle root mismatch during verification
+    TOKEN_VERIFY_USER_CANCELLED: 88, // User cancelled verification
+    OTS_VERIFY_FAILED: 89, // OpenTimestamp verification failed
+};
+/**
+ * Exit codes for NEOLIST application
+ * Based on InfoZip ZIPINFO exit codes
+ */
+exports.ZIPINFO_EXIT_CODES = {
+    SUCCESS: 0, // Success
+    WARNING: 1, // One or more warnings (but completed)
+    ZIP_FORMAT_ERROR: 2, // Error in ZIP file format
+    SEVERE_ZIP_ERROR: 3, // Severe error in ZIP file format
+    MEMORY_ERROR: 4, // Memory allocation error
+    FILES_NOT_FOUND: 9, // Specified files not found
+    INVALID_OPTIONS: 10, // Invalid command-line options
+    NO_MATCHING_FILES: 11, // No matching files found
+    USER_ABORTED: 80, // User aborted (Ctrl-C)
+    PASSWORD_PROTECTED: 82, // Archive is password-protected (can't list without password)
+    // NeoZip-specific exit codes (83-89)
+    TOKEN_VERIFY_FAILED: 83, // Token verification failed
+    TOKEN_VERIFY_TIMEOUT: 84, // Token verification timeout
+    TOKEN_VERIFY_NETWORK_ERROR: 85, // Token verification network/RPC error
+    TOKEN_VERIFY_METADATA_ERROR: 86, // Token metadata missing or invalid
+    TOKEN_VERIFY_MERKLE_MISMATCH: 87, // Merkle root mismatch during verification
+    TOKEN_VERIFY_USER_CANCELLED: 88, // User cancelled verification
+    OTS_VERIFY_FAILED: 89, // OpenTimestamp verification failed
+};
+/**
+ * Helper function to exit with a ZIP exit code
+ */
+function exitZip(code, message) {
+    if (message) {
+        console.error(message);
+    }
+    process.exit(code);
+}
+/**
+ * Helper function to exit with an UNZIP exit code
+ */
+function exitUnzip(code, message) {
+    if (message) {
+        console.error(message);
+    }
+    process.exit(code);
+}
+/**
+ * Helper function to exit with a ZIPINFO exit code
+ */
+function exitZipinfo(code, message) {
+    if (message) {
+        console.error(message);
+    }
+    process.exit(code);
+}
+/**
+ * Get exit code description for documentation
+ */
+function getExitCodeDescription(app, code) {
+    if (app === 'zip') {
+        const descriptions = {
+            0: 'Normal (no errors)',
+            2: 'Unexpected end of ZIP file',
+            3: 'Structural error in ZIP file',
+            4: 'Memory allocation error',
+            5: 'Write error (disk full?)',
+            6: 'Can\'t create file',
+            7: 'Can\'t create directory',
+            9: 'User interrupt (Ctrl-C)',
+            10: 'Parameter error',
+            11: 'No files matched pattern',
+            12: 'Bad archive format',
+            13: 'Can\'t open archive',
+            14: 'Read error',
+            15: 'Can\'t write archive',
+            18: 'Can\'t find archive',
+            20: 'Token minting failed (non-fatal, ZIP created without token)',
+            21: 'Token minting timeout',
+            22: 'Token minting network/RPC error',
+            23: 'Insufficient balance for token minting',
+            24: 'Gas estimation/submission error',
+            25: 'User cancelled token minting',
+            26: 'Blockchain configuration error (wallet, network)',
+            27: 'OpenTimestamp creation failed',
+            28: 'OpenTimestamp merkle root calculation error',
+        };
+        return descriptions[code] || 'Unknown exit code';
+    }
+    else if (app === 'unzip') {
+        const descriptions = {
+            0: 'Success',
+            1: 'Warning errors (but completed)',
+            2: 'Generic ZIP format error',
+            3: 'Severe ZIP format error',
+            4: 'Memory allocation error',
+            5: 'Memory/password error',
+            6: 'Memory error during decompression',
+            7: 'Memory error (in-memory decompression)',
+            9: 'Specified files not found',
+            10: 'Invalid options on command line',
+            11: 'No matching files found',
+            50: 'Disk full',
+            51: 'Unexpected end of ZIP file',
+            80: 'User aborted (Ctrl-C)',
+            81: 'Unsupported compression/decryption',
+            82: 'Bad password',
+            83: 'Token verification failed',
+            84: 'Token verification timeout',
+            85: 'Token verification network/RPC error',
+            86: 'Token metadata missing or invalid',
+            87: 'Merkle root mismatch during verification',
+            88: 'User cancelled verification',
+            89: 'OpenTimestamp verification failed',
+        };
+        return descriptions[code] || 'Unknown exit code';
+    }
+    else {
+        const descriptions = {
+            0: 'Success',
+            1: 'One or more warnings (but completed)',
+            2: 'Error in ZIP file format',
+            3: 'Severe error in ZIP file format',
+            4: 'Memory allocation error',
+            9: 'Specified files not found',
+            10: 'Invalid command-line options',
+            11: 'No matching files found',
+            80: 'User aborted (Ctrl-C)',
+            82: 'Archive is password-protected (can\'t list without password)',
+            83: 'Token verification failed',
+            84: 'Token verification timeout',
+            85: 'Token verification network/RPC error',
+            86: 'Token metadata missing or invalid',
+            87: 'Merkle root mismatch during verification',
+            88: 'User cancelled verification',
+            89: 'OpenTimestamp verification failed',
+        };
+        return descriptions[code] || 'Unknown exit code';
+    }
+}
+//# sourceMappingURL=exit-codes.js.map