@degengineering/web3pgp-cli 1.0.0

package/dist/commands/blockchain/sync.js

@@ -0,0 +1,246 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSyncCommand = createSyncCommand;
+const commander_1 = require("commander");
+const dexes_1 = require("@degengineering/dexes");
+const factory_1 = require("../factory");
+/**
+ * Creates a command for listening to Web3PGP blockchain events and relay valid OpenPGP messages.
+ *
+ * This command synchronizes key-related events (registrations, subkey additions, revocations)
+ * from the blockchain and outputs valid OpenPGP messages in armored format to stdout.
+ *
+ * The listener supports graceful shutdown via SIGINT (Ctrl+C) and SIGTERM signals.
+ *
+ * @param deps Command dependencies (logger, service)
+ * @returns Configured Commander command
+ */
+function createSyncCommand(deps) {
+    const { logger, service } = deps;
+    const cmdLogger = logger.child({ command: 'sync' });
+    return new commander_1.Command('sync')
+        .description('Listen for Web3PGP events related to public keys (registrations, added subkeys, revocations) and output valid OpenPGP messages in armored format to stdout')
+        .option('--from <block>', 'Optional starting block - starts from latest block if not specified')
+        .option('--to <block>', 'Optional ending block - listens indefinitely if not specified')
+        .option('--interval <seconds>', 'Polling interval in seconds when listening for new events (default: 15)', '15')
+        .option('--max-range <blocks>', 'Maximum number of blocks to process in one batch when syncing historical events (default: 10000)', '10000')
+        .action(async (options) => {
+        // Track whether a graceful shutdown has been requested
+        let shouldExit = false;
+        /**
+         * Signal handler for graceful shutdown.
+         * Allows the current event processing batch to complete before exiting.
+         */
+        const handleShutdown = (signal) => {
+            if (shouldExit) {
+                // Force exit if already shutting down
+                cmdLogger.warn(`Received ${signal} again - forcing exit`);
+                process.exit(1);
+            }
+            cmdLogger.info(`Received ${signal} - initiating graceful shutdown`);
+            shouldExit = true;
+        };
+        // Register signal handlers
+        process.on('SIGINT', () => handleShutdown('SIGINT'));
+        process.on('SIGTERM', () => handleShutdown('SIGTERM'));
+        try {
+            // Validate inputs - From
+            let fromBlock;
+            let toBlock;
+            if (options.from) {
+                fromBlock = BigInt(options.from);
+                cmdLogger.debug({ fromBlock }, `Starting synchronization from block ${fromBlock}`);
+            }
+            else {
+                fromBlock = await service.getBlockNumber();
+                cmdLogger.debug({ fromBlock }, `Starting synchronization from latest block ${fromBlock}`);
+            }
+            // Validate inputs - To
+            if (options.to) {
+                toBlock = BigInt(options.to);
+                if (toBlock < fromBlock) {
+                    throw new Error(`Ending block (${toBlock}) cannot be less than starting block (${fromBlock})`);
+                }
+                cmdLogger.debug({ toBlock }, `Ending synchronization at block ${toBlock}`);
+            }
+            else {
+                cmdLogger.debug('Listening indefinitely for new events');
+            }
+            // Validate inputs - Interval
+            const intervalSeconds = options.interval ? parseInt(options.interval, 10) : 15;
+            if (isNaN(intervalSeconds) || intervalSeconds <= 0) {
+                throw new Error('Polling interval (--interval) must be a positive integer representing seconds');
+            }
+            cmdLogger.debug({ intervalSeconds }, `Using polling interval of ${intervalSeconds} seconds`);
+            // Validate inputs - Max Range
+            const maxRange = options['max-range'] ? BigInt(options['max-range']) : 10000n;
+            if (maxRange <= 0n) {
+                throw new Error('Maximum range (--max-range) must be a positive integer representing number of blocks');
+            }
+            cmdLogger.debug({ maxRange }, `Using maximum block range of ${maxRange} for event syncing`);
+            // Event listening loop
+            while (!shouldExit && (toBlock === undefined || fromBlock <= toBlock)) {
+                // Get latest block number and determine the next target given the range to process
+                let target = await service.getBlockNumber();
+                if (toBlock !== undefined) {
+                    // Ensure we do not exceed the specified toBlock
+                    target = target > toBlock ? toBlock : target;
+                }
+                target = fromBlock + maxRange - 1n < target ? fromBlock + maxRange - 1n : target;
+                if (target < fromBlock) {
+                    // No new blocks to process - wait before next check
+                    cmdLogger.info('No new blocks to process - waiting before next check');
+                    await sleep(intervalSeconds * 1000);
+                    continue;
+                }
+                // Fetch the events
+                cmdLogger.info({ fromBlock, toBlock: target }, `Fetching events from blockchain from block ${fromBlock} to ${target}`);
+                const logs = await service.searchKeyEvents(undefined, fromBlock, target);
+                // Process and output events
+                await processKeyEvents(logs, service, cmdLogger);
+                // Update fromBlock for next iteration
+                fromBlock = target + 1n;
+                // Check for shutdown signal before waiting
+                if (shouldExit || (toBlock !== undefined && fromBlock > toBlock)) {
+                    break;
+                }
+            }
+            // Exit gracefully
+            cmdLogger.info('Event synchronization completed - exiting gracefully');
+            process.exit(0);
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            cmdLogger.error({ error: msg }, 'Failed to synchronize with blockchain events');
+            (0, factory_1.exitWithError)(msg);
+        }
+        finally {
+            // Clean up signal handlers
+            process.removeAllListeners('SIGINT');
+            process.removeAllListeners('SIGTERM');
+        }
+    });
+}
+/**
+ * Process key events and output armored OpenPGP messages to stdout.
+ *
+ * @param logs Array of key-related event logs
+ * @param service Web3PGP service for extracting key data
+ * @param logger Logger instance
+ * @throws Will not throw; validation errors are logged and skipped
+ */
+async function processKeyEvents(logs, service, logger) {
+    for (const log of logs) {
+        try {
+            switch (log.type) {
+                case dexes_1.Web3PGPEvents.KeyRegistered: {
+                    logger.info({
+                        block: log.blockNumber,
+                        tx: log.transactionHash,
+                        primaryKeyFingerprint: log.primaryKeyFingerprint,
+                    }, 'Processing KeyRegistered event');
+                    const pk = await service.extractFromKeyRegisteredLog(log);
+                    console.log(await pk.armor());
+                    break;
+                }
+                case dexes_1.Web3PGPEvents.SubkeyAdded: {
+                    logger.info({
+                        block: log.blockNumber,
+                        tx: log.transactionHash,
+                        primaryKeyFingerprint: log.primaryKeyFingerprint,
+                        subkeyFingerprint: log.subkeyFingerprint,
+                    }, 'Processing SubkeyAdded event');
+                    const subPk = await service.extractFromSubkeyAddedLog(log);
+                    console.log(await subPk.armor());
+                    break;
+                }
+                case dexes_1.Web3PGPEvents.KeyRevoked: {
+                    logger.info({
+                        block: log.blockNumber,
+                        tx: log.transactionHash,
+                        fingerprint: log.fingerprint,
+                    }, 'Processing KeyRevoked event');
+                    const [revoked, cert] = await service.extractFromKeyRevokedLog(log);
+                    if (revoked) {
+                        console.log(await revoked.armor());
+                    }
+                    else if (cert) {
+                        console.log(cert);
+                    }
+                    else {
+                        logger.warn({ log }, 'No revocation information found in KeyRevoked event - skipping');
+                    }
+                    break;
+                }
+                case dexes_1.Web3PGPEvents.KeyUpdated: {
+                    logger.info({
+                        block: log.blockNumber,
+                        tx: log.transactionHash,
+                        fingerprint: log.fingerprint,
+                    }, 'Processing KeyUpdated event');
+                    const updatedPk = await service.extractFromKeyUpdatedLog(log);
+                    console.log(await updatedPk.armor());
+                    break;
+                }
+                case dexes_1.Web3PGPEvents.KeyCertified: {
+                    logger.info({
+                        block: log.blockNumber,
+                        tx: log.transactionHash,
+                        issuerFingerprint: log.issuerFingerprint,
+                        subjectFingerprint: log.fingerprint,
+                    }, 'Processing KeyCertified event');
+                    const certifiedPk = await service.extractFromKeyCertifiedLog(log);
+                    console.log(await certifiedPk.armor());
+                    break;
+                }
+                case dexes_1.Web3PGPEvents.KeyCertificationRevoked: {
+                    logger.info({
+                        block: log.blockNumber,
+                        tx: log.transactionHash,
+                        issuerFingerprint: log.issuerFingerprint,
+                        subjectFingerprint: log.fingerprint,
+                    }, 'Processing KeyCertificationRevoked event');
+                    const decertifiedPk = await service.extractFromKeyCertificationRevokedLog(log);
+                    console.log(await decertifiedPk.armor());
+                    break;
+                }
+                case dexes_1.Web3PGPEvents.OwnershipChallenged:
+                    logger.info({
+                        block: log.blockNumber,
+                        tx: log.transactionHash,
+                        fingerprint: log.fingerprint,
+                    }, 'Received OwnershipChallenged event - no OpenPGP message to output');
+                    break;
+                case dexes_1.Web3PGPEvents.OwnershipProved:
+                    logger.info({
+                        block: log.blockNumber,
+                        tx: log.transactionHash,
+                        fingerprint: log.fingerprint,
+                    }, 'Received OwnershipProved event - no OpenPGP message to output');
+                    break;
+                default:
+                    logger.warn({ log }, 'Unknown event type - skipping');
+            }
+        }
+        catch (error) {
+            if (error instanceof dexes_1.Web3PGPServiceValidationError) {
+                // Warn if validation error - skip the log
+                logger.warn({ log, error: error.message }, 'The key event is not valid - skipping');
+            }
+            else {
+                // Critical error - rethrow to stop processing
+                throw error;
+            }
+        }
+    }
+}
+/**
+ * Sleep utility function.
+ *
+ * @param ms Milliseconds to sleep
+ * @returns Promise that resolves after the specified duration
+ */
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=sync.js.map

package/dist/commands/blockchain/sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.js","sourceRoot":"","sources":["../../../src/commands/blockchain/sync.ts"],"names":[],"mappings":"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"}

package/dist/commands/blockchain/update.d.ts

@@ -0,0 +1,13 @@
+import { Command } from 'commander';
+import { Logger } from 'pino';
+import { IWeb3PGPService } from '@degengineering/dexes';
+export interface UpdateDeps {
+    logger: Logger;
+    service: IWeb3PGPService;
+}
+/**
+ * Update a public key on the blockchain
+ * Usage: web3pgp update --key <path> | read from stdin
+ */
+export declare function createUpdateCommand(deps: UpdateDeps): Command;
+//# sourceMappingURL=update.d.ts.map

package/dist/commands/blockchain/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/commands/blockchain/update.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAKxD,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,eAAe,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CA0D7D"}

package/dist/commands/blockchain/update.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createUpdateCommand = createUpdateCommand;
+const commander_1 = require("commander");
+const factory_1 = require("../factory");
+const input_1 = require("../../utils/input");
+/**
+ * Update a public key on the blockchain
+ * Usage: web3pgp update --key <path> | read from stdin
+ */
+function createUpdateCommand(deps) {
+    const { logger, service } = deps;
+    const cmdLogger = logger.child({ command: 'update' });
+    return new commander_1.Command('update')
+        .description('Update a public key on the blockchain')
+        .option('--key <path>', 'Path to PGP public key file (armored or binary)')
+        .action(async (options) => {
+        try {
+            let keyData;
+            // Determine source and read input
+            if (options.key) {
+                cmdLogger.info({ path: options.key }, 'Reading PGP key from file');
+                keyData = (0, input_1.readInputFromFile)(options.key);
+            }
+            else {
+                cmdLogger.info('Reading PGP key from stdin');
+                keyData = await (0, input_1.readInputFromStdin)();
+            }
+            cmdLogger.debug({ dataLength: keyData.length }, 'Key data received');
+            // Parse key - tries armor format first, then binary
+            cmdLogger.info('Parsing and validating PGP key');
+            const publicKey = (await (0, input_1.readKeyData)(keyData));
+            cmdLogger.debug({ fingerprint: publicKey.getFingerprint() }, 'Key parsed successfully');
+            const result = await service.update(publicKey);
+            cmdLogger.info({
+                fingerprint: publicKey.getFingerprint(),
+                transactionHash: result.transactionHash,
+                blockNumber: result.blockNumber,
+            }, 'Key update successful');
+            // Output result as JSON
+            (0, factory_1.outputJson)({
+                success: true,
+                message: 'Public key updated successfully',
+                fingerprint: publicKey.getFingerprint(),
+                users: publicKey.users.map((user) => user.userID?.toString() || ''),
+                transaction: {
+                    hash: result.transactionHash,
+                    blockNumber: result.blockNumber.toString(),
+                },
+            });
+            process.exit(0);
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            cmdLogger.error({ error: msg }, 'Failed to update key');
+            (0, factory_1.exitWithError)(msg);
+        }
+    });
+}
+//# sourceMappingURL=update.js.map

package/dist/commands/blockchain/update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../../src/commands/blockchain/update.ts"],"names":[],"mappings":";;AAgBA,kDA0DC;AA1ED,yCAAoC;AAIpC,wCAAuD;AACvD,6CAAuF;AAOvF;;;GAGG;AACH,SAAgB,mBAAmB,CAAC,IAAgB;IAClD,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACjC,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;IAEtD,OAAO,IAAI,mBAAO,CAAC,QAAQ,CAAC;SACzB,WAAW,CAAC,uCAAuC,CAAC;SACpD,MAAM,CAAC,cAAc,EAAE,iDAAiD,CAAC;SACzE,MAAM,CAAC,KAAK,EAAE,OAAyB,EAAE,EAAE;QAC1C,IAAI,CAAC;YACH,IAAI,OAAwB,CAAC;YAE7B,kCAAkC;YAClC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;gBAChB,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,2BAA2B,CAAC,CAAC;gBACnE,OAAO,GAAG,IAAA,yBAAiB,EAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAC3C,CAAC;iBAAM,CAAC;gBACN,SAAS,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;gBAC7C,OAAO,GAAG,MAAM,IAAA,0BAAkB,GAAE,CAAC;YACvC,CAAC;YAED,SAAS,CAAC,KAAK,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,MAAM,EAAE,EAAE,mBAAmB,CAAC,CAAC;YAErE,oDAAoD;YACpD,SAAS,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;YACjD,MAAM,SAAS,GAAG,CAAC,MAAM,IAAA,mBAAW,EAAC,OAAO,CAAC,CAAsB,CAAC;YAEpE,SAAS,CAAC,KAAK,CAAC,EAAE,WAAW,EAAE,SAAS,CAAC,cAAc,EAAE,EAAE,EAAE,yBAAyB,CAAC,CAAC;YAExF,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAE/C,SAAS,CAAC,IAAI,CACZ;gBACE,WAAW,EAAE,SAAS,CAAC,cAAc,EAAE;gBACvC,eAAe,EAAE,MAAM,CAAC,eAAe;gBACvC,WAAW,EAAE,MAAM,CAAC,WAAW;aAChC,EACD,uBAAuB,CACxB,CAAC;YAEF,wBAAwB;YACxB,IAAA,oBAAU,EAAC;gBACT,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,iCAAiC;gBAC1C,WAAW,EAAE,SAAS,CAAC,cAAc,EAAE;gBACvC,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;gBACnE,WAAW,EAAE;oBACX,IAAI,EAAE,MAAM,CAAC,eAAe;oBAC5B,WAAW,EAAE,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE;iBAC3C;aACF,CAAC,CAAC;YAEH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACnE,SAAS,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,sBAAsB,CAAC,CAAC;YACxD,IAAA,uBAAa,EAAC,GAAG,CAAC,CAAC;QACrB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/configuration/display.d.ts

@@ -0,0 +1,10 @@
+import { Command } from 'commander';
+import { Logger } from 'pino';
+export interface ConfigDisplayCommandDeps {
+    logger: Logger;
+}
+/**
+ * Create the 'configuration display' command
+ */
+export declare function createConfigDisplayCommand(deps: ConfigDisplayCommandDeps): Command;
+//# sourceMappingURL=display.d.ts.map

package/dist/commands/configuration/display.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"display.d.ts","sourceRoot":"","sources":["../../../src/commands/configuration/display.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAuB9B,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,wBAAwB,GAAG,OAAO,CAqClF"}

package/dist/commands/configuration/display.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createConfigDisplayCommand = createConfigDisplayCommand;
+const commander_1 = require("commander");
+const yaml_1 = require("yaml");
+const loader_1 = require("../../config/loader");
+/**
+ * Mask sensitive values in configuration
+ */
+function maskSensitiveData(config) {
+    const masked = JSON.parse(JSON.stringify(config));
+    // Mask private key: show only first 4 and last 4 chars
+    if (masked.ethereum.wallet?.privateKey) {
+        const key = masked.ethereum.wallet.privateKey;
+        if (key.length > 8) {
+            const start = key.substring(0, 4);
+            const end = key.substring(key.length - 4);
+            masked.ethereum.wallet.privateKey = `${start}...${end}`;
+        }
+    }
+    return masked;
+}
+/**
+ * Create the 'configuration display' command
+ */
+function createConfigDisplayCommand(deps) {
+    const { logger } = deps;
+    const cmdLogger = logger.child({ command: 'display' });
+    return new commander_1.Command('display')
+        .description('Display the current configuration (merged from all sources)')
+        .option('--show-secrets', 'Show full private key (not masked)')
+        .option('--config <path>', 'Custom config file path')
+        .action(async (options) => {
+        try {
+            cmdLogger.info('Loading configuration');
+            const config = (0, loader_1.loadConfig)({
+                configPath: options.config,
+            });
+            cmdLogger.info({ chain: config.ethereum.chain }, 'Configuration loaded');
+            // Mask sensitive data unless explicitly requested
+            const displayConfig = options['show-secrets'] ? config : maskSensitiveData(config);
+            // Convert to YAML for display
+            const yaml = (0, yaml_1.stringify)(displayConfig, {
+                indent: 2,
+                lineWidth: 0,
+            });
+            console.log('# Current Configuration (merged from defaults/file/env/flags)\n');
+            console.log(yaml);
+            process.exit(0);
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            cmdLogger.error({ error: msg }, 'Failed to display config');
+            process.exit(2);
+        }
+    });
+}
+//# sourceMappingURL=display.js.map

package/dist/commands/configuration/display.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"display.js","sourceRoot":"","sources":["../../../src/commands/configuration/display.ts"],"names":[],"mappings":";;AAgCA,gEAqCC;AArED,yCAAoC;AACpC,+BAAkD;AAElD,gDAAiD;AAGjD;;GAEG;AACH,SAAS,iBAAiB,CAAC,MAAoB;IAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAiB,CAAC;IAElE,uDAAuD;IACvD,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC;QACvC,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC;QAC9C,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnB,MAAM,KAAK,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAClC,MAAM,GAAG,GAAG,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YAC1C,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,GAAG,GAAG,KAAK,MAAM,GAAG,EAAmB,CAAC;QAC3E,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAMD;;GAEG;AACH,SAAgB,0BAA0B,CAAC,IAA8B;IACvE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACxB,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;IAEvD,OAAO,IAAI,mBAAO,CAAC,SAAS,CAAC;SAC1B,WAAW,CAAC,6DAA6D,CAAC;SAC1E,MAAM,CAAC,gBAAgB,EAAE,oCAAoC,CAAC;SAC9D,MAAM,CAAC,iBAAiB,EAAE,yBAAyB,CAAC;SACpD,MAAM,CAAC,KAAK,EAAE,OAAsD,EAAE,EAAE;QACvE,IAAI,CAAC;YACH,SAAS,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;YAExC,MAAM,MAAM,GAAG,IAAA,mBAAU,EAAC;gBACxB,UAAU,EAAE,OAAO,CAAC,MAAM;aAC3B,CAAC,CAAC;YAEH,SAAS,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,sBAAsB,CAAC,CAAC;YAEzE,kDAAkD;YAClD,MAAM,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;YAEnF,8BAA8B;YAC9B,MAAM,IAAI,GAAG,IAAA,gBAAa,EAAC,aAAa,EAAE;gBACxC,MAAM,EAAE,CAAC;gBACT,SAAS,EAAE,CAAC;aACb,CAAC,CAAC;YAEH,OAAO,CAAC,GAAG,CAAC,iEAAiE,CAAC,CAAC;YAC/E,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAElB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACnE,SAAS,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,0BAA0B,CAAC,CAAC;YAC5D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/configuration/generate.d.ts

@@ -0,0 +1,14 @@
+import { Command } from 'commander';
+import { Logger } from 'pino';
+/**
+ * Generate a template configuration file for test environment
+ */
+export declare function generateConfigTemplate(environment?: 'test' | 'prod'): string;
+export interface ConfigGenerateCommandDeps {
+    logger: Logger;
+}
+/**
+ * Create the 'configuration generate' command
+ */
+export declare function createConfigGenerateCommand(deps: ConfigGenerateCommandDeps): Command;
+//# sourceMappingURL=generate.d.ts.map

package/dist/commands/configuration/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../src/commands/configuration/generate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAE9B;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,GAAE,MAAM,GAAG,MAAe,GAAG,MAAM,CA4KpF;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAgCpF"}

package/dist/commands/configuration/generate.js

@@ -0,0 +1,222 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateConfigTemplate = generateConfigTemplate;
+exports.createConfigGenerateCommand = createConfigGenerateCommand;
+const fs_1 = __importDefault(require("fs"));
+const commander_1 = require("commander");
+/**
+ * Generate a template configuration file for test environment
+ */
+function generateConfigTemplate(environment = 'test') {
+    if (environment === 'test') {
+        return `# Web3PGP CLI Configuration - TEST Environment
+# Location: ~/.web3pgp/config.yaml
+# 
+# This file configures the Web3PGP CLI for the TEST environment.
+# You can override any value using:
+# - Environment variables (DEXES_* prefix)
+# - Command-line flags
+#
+# Environment variables take precedence over this file.
+# CLI flags take precedence over environment variables.
+
+ethereum:
+  # Blockchain network configuration
+  # Using Sepolia testnet
+  chain: sepolia  # or use numeric ID: 11155111
+
+  # RPC endpoint configuration
+  # Multiple endpoints with fallback support and per-endpoint batching configuration
+  rpc:
+    # Array of RPC endpoints with priority-based failover
+    # Lower priority number = higher priority (1 is highest)
+    endpoints:
+      # Primary RPC endpoint - PublicNode
+      - url: https://ethereum-sepolia-rpc.publicnode.com
+        priority: 1
+        batching:
+          size: 20         # Maximum requests per batch
+          waitMs: 100      # Maximum wait time before sending batch in milliseconds
+      
+      # Backup 1 - Tenderly
+      - url: https://sepolia.gateway.tenderly.co
+        priority: 2
+        batching:
+          size: 20
+          waitMs: 100
+      
+      # Backup 2 - dRPC
+      - url: https://sepolia.drpc.org
+        priority: 3
+        batching:
+          size: 20
+          waitMs: 100
+      
+      # Backup 3 - 1RPC
+      - url: https://1rpc.io/sepolia
+        priority: 4
+        batching:
+          size: 20
+          waitMs: 100
+
+    # Shared retry configuration (applied to all endpoints)
+    retry:
+      count: 3             # Number of retry attempts
+      delayMs: 200         # Delay between retries in milliseconds
+
+    # Maximum block range for eth_getLogs queries
+    # Use this value when querying logs to avoid exceeding provider limits
+    maxBlockRange: 10000
+
+  # wallet: (OPTIONAL - required only for signing transactions)
+  #   # Wallet configuration (currently only 'private-key' is supported)
+  #   type: private-key
+  #   
+  #   # Private key for signing transactions
+  #   # WARNING: Store this securely! Better to use the DEXES_WALLET_PRIVATE_KEY env var.
+  #   # Support for \${VAR_NAME} syntax: privateKey: "\${DEXES_WALLET_PRIVATE_KEY}"
+  #   # privateKey: "<YOUR_PRIVATE_KEY>"
+
+web3pgp:
+  # Web3PGP smart contract address (test deployment on Sepolia)
+  contract: "0x82733B49e65A2FE6B611e5CE454AC21237071638"
+
+monitoring:
+  logging:
+    # Log level: debug, info, warn, error
+    level: info
+
+# ============================================================================
+# ENVIRONMENT VARIABLES
+# ============================================================================
+# You can override any configuration value using environment variables:
+#
+# DEXES_CHAIN=sepolia
+# DEXES_RPC_ENDPOINTS='[{"url":"...","priority":1,"batching":{"size":100,"waitMs":50}}]'
+# DEXES_WALLET_PRIVATE_KEY=<YOUR_PRIVATE_KEY>
+# DEXES_WEB3PGP_CONTRACT=<CONTRACT_ADDRESS>
+# DEXES_LOG_LEVEL=debug
+`;
+    }
+    else {
+        return `# Web3PGP CLI Configuration - PRODUCTION Environment
+# Location: ~/.web3pgp/config.yaml
+# 
+# This file configures the Web3PGP CLI for the PRODUCTION environment.
+# You can override any value using:
+# - Environment variables (DEXES_* prefix)
+# - Command-line flags
+#
+# Environment variables take precedence over this file.
+# CLI flags take precedence over environment variables.
+
+ethereum:
+  # Blockchain network configuration
+  # Using Scroll mainnet
+  chain: 534352
+
+  # RPC endpoint configuration
+  rpc:
+    endpoints:
+      # Primary RPC endpoint - Scroll official
+      - url: https://rpc.scroll.io
+        priority: 1
+        batching:
+          size: 20
+          waitMs: 150
+      # Secondary RPC endpoint - 1RPC
+      - url: https://1rpc.io/scroll
+        priority: 2
+        batching:
+          size: 20
+          waitMs: 150
+      # Tertiary RPC endpoint - PublicNode
+      - url: https://scroll-rpc.publicnode.com
+        priority: 3
+        batching:
+          size: 20
+          waitMs: 150
+      # Quaternary RPC endpoint - DRPC
+      - url: https://scroll.drpc.org
+        priority: 4
+        batching:
+          size: 20
+          waitMs: 150
+
+    retry:
+      count: 3
+      delayMs: 500
+
+    maxBlockRange: 10000
+
+  # wallet: (OPTIONAL - required only for signing transactions)
+  #   # Wallet configuration (currently only 'private-key' is supported)
+  #   type: private-key
+  #   
+  #   # Private key for signing transactions
+  #   # WARNING: Store this securely! Better to use the DEXES_WALLET_PRIVATE_KEY env var.
+  #   # Support for \${VAR_NAME} syntax: privateKey: "\${DEXES_WALLET_PRIVATE_KEY}"
+  #   # privateKey: "<YOUR_PRIVATE_KEY>"
+
+web3pgp:
+  # Web3PGP smart contract address (production deployment on Scroll)
+  contract: "0xDa63568866C8eB53627a5CCF27DaB76061538dB1"
+
+monitoring:
+  logging:
+    # Log level: debug, info, warn, error
+    level: info
+
+# ============================================================================
+# ENVIRONMENT VARIABLES
+# ============================================================================
+# You can override any configuration value using environment variables:
+#
+# DEXES_CHAIN=534352
+# DEXES_RPC_URL=https://rpc.scroll.io  # Single RPC endpoint override
+# DEXES_RPC_ENDPOINTS='[{"url":"https://rpc.scroll.io","priority":1,"batching":{"size":20,"waitMs":150}}]'
+# DEXES_WALLET_PRIVATE_KEY=<YOUR_PRIVATE_KEY>
+# DEXES_WEB3PGP_CONTRACT=0xDa63568866C8eB53627a5CCF27DaB76061538dB1
+# DEXES_LOG_LEVEL=info
+`;
+    }
+}
+/**
+ * Create the 'configuration generate' command
+ */
+function createConfigGenerateCommand(deps) {
+    const { logger } = deps;
+    const cmdLogger = logger.child({ command: 'generate' });
+    return new commander_1.Command('generate')
+        .description('Generate a template configuration file')
+        .argument('[environment]', 'Environment: test or prod (default: test)', 'test')
+        .option('-o, --output <path>', 'Output file path (default: stdout)')
+        .action(async (environment, options) => {
+        try {
+            // Validate environment argument
+            if (!['test', 'prod'].includes(environment)) {
+                throw new Error(`Invalid environment: ${environment}. Must be 'test' or 'prod'.`);
+            }
+            cmdLogger.info({ environment }, 'Generating config template');
+            const template = generateConfigTemplate(environment);
+            if (options.output) {
+                fs_1.default.writeFileSync(options.output, template);
+                cmdLogger.info({ path: options.output, environment }, 'Config template written');
+                console.log(`Configuration template written to ${options.output} (${environment} environment)`);
+            }
+            else {
+                console.log(template);
+            }
+            process.exit(0);
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            cmdLogger.error({ error: msg }, 'Failed to generate config');
+            process.exit(2);
+        }
+    });
+}
+//# sourceMappingURL=generate.js.map