@toon-protocol/connector 1.7.1

package/dist/cli/index.js

@@ -0,0 +1,175 @@
+#!/usr/bin/env node
+"use strict";
+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 });
+const commander_1 = require("commander");
+const onboarding_wizard_1 = require("./onboarding-wizard");
+const program = new commander_1.Command();
+program
+    .name('m2m-connector')
+    .description('M2M ILP Connector CLI - Production deployment and management tool')
+    .version('0.1.0');
+program
+    .command('setup')
+    .description('Run the interactive onboarding wizard to configure your connector')
+    .option('-o, --output <path>', 'Output path for the .env file', '.env')
+    .action(async (options) => {
+    try {
+        await (0, onboarding_wizard_1.runOnboarding)(options.output);
+    }
+    catch (error) {
+        console.error('Setup failed:', error.message);
+        process.exit(1);
+    }
+});
+program
+    .command('start')
+    .description('Start the connector with existing configuration')
+    .option('-c, --config <path>', 'Path to configuration file', 'config.yaml')
+    .action(async (options) => {
+    console.log(`Starting connector with config: ${options.config}`);
+    console.log('');
+    console.log('For production deployment, use Docker Compose:');
+    console.log('  docker-compose -f docker-compose-production.yml up -d');
+    console.log('');
+    console.log('For development, run directly:');
+    console.log('  npm run start --workspace=packages/connector');
+    console.log('');
+});
+program
+    .command('health')
+    .description('Check the health status of a running connector')
+    .option('-u, --url <url>', 'Health endpoint URL', 'http://localhost:8080/health')
+    .action(async (options) => {
+    try {
+        console.log(`Checking health at: ${options.url}\n`);
+        const response = await fetch(options.url, {
+            method: 'GET',
+            headers: { Accept: 'application/json' },
+            signal: AbortSignal.timeout(5000),
+        });
+        if (!response.ok) {
+            console.log(`Status: UNHEALTHY (HTTP ${response.status})`);
+            process.exit(1);
+        }
+        const health = (await response.json());
+        console.log(`Status: ${health.status.toUpperCase()}`);
+        if (health.version) {
+            console.log(`Version: ${health.version}`);
+        }
+        if (health.uptime !== undefined) {
+            const uptimeMinutes = Math.floor(health.uptime / 60);
+            console.log(`Uptime: ${uptimeMinutes} minutes`);
+        }
+        if (health.dependencies) {
+            console.log('\nDependencies:');
+            for (const [name, dep] of Object.entries(health.dependencies)) {
+                const latency = dep.latencyMs ? ` (${dep.latencyMs}ms)` : '';
+                console.log(`  ${name}: ${dep.status}${latency}`);
+            }
+        }
+        if (health.status === 'unhealthy') {
+            process.exit(1);
+        }
+        else if (health.status === 'degraded') {
+            process.exit(2);
+        }
+    }
+    catch (error) {
+        const err = error;
+        if (err.name === 'AbortError' || err.name === 'TimeoutError') {
+            console.log('Status: UNREACHABLE (timeout)');
+        }
+        else if (err.message?.includes('ECONNREFUSED')) {
+            console.log('Status: UNREACHABLE (connection refused)');
+            console.log('\nIs the connector running? Start with:');
+            console.log('  docker-compose -f docker-compose-production.yml up -d');
+        }
+        else {
+            console.log(`Status: ERROR (${err.message})`);
+        }
+        process.exit(1);
+    }
+});
+program
+    .command('validate')
+    .description('Validate a configuration file')
+    .argument('<file>', 'Path to the configuration file to validate')
+    .action(async (file) => {
+    try {
+        const fs = await Promise.resolve().then(() => __importStar(require('fs/promises')));
+        await fs.access(file);
+        const content = await fs.readFile(file, 'utf8');
+        if (file.endsWith('.env')) {
+            const lines = content.split('\n');
+            let errors = 0;
+            for (let i = 0; i < lines.length; i++) {
+                const line = lines[i]?.trim() ?? '';
+                if (line && !line.startsWith('#') && !line.includes('=')) {
+                    console.log(`Line ${i + 1}: Invalid format (missing =)`);
+                    errors++;
+                }
+            }
+            if (errors === 0) {
+                console.log('Configuration file is valid.');
+            }
+            else {
+                console.log(`\nFound ${errors} error(s).`);
+                process.exit(1);
+            }
+        }
+        else if (file.endsWith('.yaml') || file.endsWith('.yml')) {
+            const yaml = await Promise.resolve().then(() => __importStar(require('js-yaml')));
+            yaml.load(content);
+            console.log('Configuration file is valid YAML.');
+        }
+        else {
+            console.log('Unknown file type. Supported: .env, .yaml, .yml');
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        const err = error;
+        if (err.code === 'ENOENT') {
+            console.log(`File not found: ${file}`);
+        }
+        else {
+            console.log(`Validation failed: ${err.message}`);
+        }
+        process.exit(1);
+    }
+});
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/cli/onboarding-wizard.d.ts

@@ -0,0 +1,7 @@
+import { OnboardingConfig } from './types';
+export declare function validateEthereumAddress(address: string): boolean;
+export declare function runOnboardingWizard(): Promise<OnboardingConfig>;
+export declare function generateEnvFile(config: OnboardingConfig): string;
+export declare function writeEnvFile(content: string, filePath: string): Promise<void>;
+export declare function runOnboarding(outputPath?: string): Promise<void>;
+//# sourceMappingURL=onboarding-wizard.d.ts.map

package/dist/cli/onboarding-wizard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding-wizard.d.ts","sourceRoot":"","sources":["../../src/cli/onboarding-wizard.ts"],"names":[],"mappings":"AAYA,OAAO,EACL,gBAAgB,EAKjB,MAAM,SAAS,CAAC;AAWjB,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEhE;AAeD,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAqIrE;AAOD,wBAAgB,eAAe,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CA0EhE;AAQD,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CASnF;AAMD,wBAAsB,aAAa,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoDtE"}

package/dist/cli/onboarding-wizard.js

@@ -0,0 +1,257 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateEthereumAddress = validateEthereumAddress;
+exports.runOnboardingWizard = runOnboardingWizard;
+exports.generateEnvFile = generateEnvFile;
+exports.writeEnvFile = writeEnvFile;
+exports.runOnboarding = runOnboarding;
+const tslib_1 = require("tslib");
+const inquirer_1 = tslib_1.__importDefault(require("inquirer"));
+const fs = tslib_1.__importStar(require("fs/promises"));
+const path = tslib_1.__importStar(require("path"));
+const crypto = tslib_1.__importStar(require("crypto"));
+const ETH_ADDRESS_REGEX = /^0x[a-fA-F0-9]{40}$/;
+function validateEthereumAddress(address) {
+    return ETH_ADDRESS_REGEX.test(address);
+}
+function generateNodeId() {
+    const randomSuffix = crypto.randomBytes(4).toString('hex');
+    return `connector-${randomSuffix}`;
+}
+async function runOnboardingWizard() {
+    console.log('\n========================================');
+    console.log('  M2M Connector Onboarding Wizard');
+    console.log('========================================\n');
+    console.log('This wizard will guide you through configuring your connector.');
+    console.log('Press Ctrl+C at any time to cancel.\n');
+    const defaultNodeId = generateNodeId();
+    const basicAnswers = await inquirer_1.default.prompt([
+        {
+            type: 'input',
+            name: 'nodeId',
+            message: 'Enter a unique node ID for this connector:',
+            default: defaultNodeId,
+            validate: (input) => {
+                if (!input || input.trim().length === 0) {
+                    return 'Node ID cannot be empty';
+                }
+                if (!/^[a-zA-Z0-9-_]+$/.test(input)) {
+                    return 'Node ID can only contain letters, numbers, hyphens, and underscores';
+                }
+                return true;
+            },
+        },
+        {
+            type: 'list',
+            name: 'settlementPreference',
+            message: 'Select your settlement preference:',
+            choices: [{ name: 'EVM only (Base L2)', value: 'evm' }],
+            default: 'evm',
+        },
+    ]);
+    const evmAnswer = await inquirer_1.default.prompt([
+        {
+            type: 'input',
+            name: 'evmAddress',
+            message: 'Enter your Ethereum address (0x...):',
+            validate: (input) => {
+                if (!input || input.trim().length === 0) {
+                    return 'Ethereum address is required for EVM settlement';
+                }
+                if (!validateEthereumAddress(input)) {
+                    return 'Invalid Ethereum address format. Must be 0x followed by 40 hex characters.';
+                }
+                return true;
+            },
+        },
+    ]);
+    const addressAnswers = { evmAddress: evmAnswer.evmAddress };
+    const keyAnswers = await inquirer_1.default.prompt([
+        {
+            type: 'list',
+            name: 'keyBackend',
+            message: 'Select your key management backend:',
+            choices: [
+                { name: 'Environment variables (development only)', value: 'env' },
+                { name: 'AWS KMS (production)', value: 'aws-kms' },
+                { name: 'GCP KMS (production)', value: 'gcp-kms' },
+                { name: 'Azure Key Vault (production)', value: 'azure-kv' },
+            ],
+            default: 'env',
+        },
+    ]);
+    const advancedAnswers = await inquirer_1.default.prompt([
+        {
+            type: 'confirm',
+            name: 'enableMonitoring',
+            message: 'Enable Prometheus/Grafana monitoring?',
+            default: true,
+        },
+        {
+            type: 'number',
+            name: 'btpPort',
+            message: 'BTP server port:',
+            default: 4000,
+            validate: (input) => {
+                if (!Number.isInteger(input) || input < 1 || input > 65535) {
+                    return 'Port must be a valid number between 1 and 65535';
+                }
+                return true;
+            },
+        },
+        {
+            type: 'number',
+            name: 'healthCheckPort',
+            message: 'Health check and metrics HTTP port:',
+            default: 8080,
+            validate: (input) => {
+                if (!Number.isInteger(input) || input < 1 || input > 65535) {
+                    return 'Port must be a valid number between 1 and 65535';
+                }
+                return true;
+            },
+        },
+        {
+            type: 'list',
+            name: 'logLevel',
+            message: 'Select log level:',
+            choices: [
+                { name: 'debug - Verbose debugging information', value: 'debug' },
+                { name: 'info - General operational information (recommended)', value: 'info' },
+                { name: 'warn - Warning messages only', value: 'warn' },
+                { name: 'error - Error messages only', value: 'error' },
+            ],
+            default: 'info',
+        },
+    ]);
+    const config = {
+        nodeId: basicAnswers.nodeId,
+        settlementPreference: basicAnswers.settlementPreference,
+        evmAddress: addressAnswers.evmAddress,
+        keyBackend: keyAnswers.keyBackend,
+        enableMonitoring: advancedAnswers.enableMonitoring,
+        btpPort: advancedAnswers.btpPort,
+        healthCheckPort: advancedAnswers.healthCheckPort,
+        logLevel: advancedAnswers.logLevel,
+    };
+    return config;
+}
+function generateEnvFile(config) {
+    const lines = [
+        '# =============================================================================',
+        '# M2M Connector Configuration',
+        '# Generated by onboarding wizard',
+        '# =============================================================================',
+        '',
+        '# Core Configuration',
+        `NODE_ID=${config.nodeId}`,
+        `SETTLEMENT_PREFERENCE=${config.settlementPreference}`,
+        '',
+    ];
+    lines.push('# Blockchain Configuration');
+    lines.push('BASE_RPC_URL=https://mainnet.base.org');
+    lines.push(`EVM_ADDRESS=${config.evmAddress || ''}`);
+    lines.push('');
+    lines.push('# Key Management');
+    lines.push(`KEY_BACKEND=${config.keyBackend}`);
+    if (config.keyBackend === 'env') {
+        lines.push('# WARNING: env backend is for development only!');
+        lines.push('# Uncomment and set your private key:');
+        lines.push('# EVM_PRIVATE_KEY=0x...');
+    }
+    else if (config.keyBackend === 'aws-kms') {
+        lines.push('AWS_REGION=us-east-1');
+        lines.push('# AWS_KMS_EVM_KEY_ID=arn:aws:kms:...');
+    }
+    else if (config.keyBackend === 'gcp-kms') {
+        lines.push('# GCP_PROJECT_ID=my-project');
+        lines.push('GCP_LOCATION_ID=us-east1');
+        lines.push('GCP_KEY_RING_ID=connector-keyring');
+        lines.push('# GCP_KMS_EVM_KEY_ID=evm-signing-key');
+    }
+    else if (config.keyBackend === 'azure-kv') {
+        lines.push('# AZURE_VAULT_URL=https://my-vault.vault.azure.net');
+        lines.push('AZURE_EVM_KEY_NAME=evm-signing-key');
+    }
+    lines.push('');
+    lines.push('# Network Configuration');
+    lines.push(`BTP_PORT=${config.btpPort}`);
+    lines.push(`HEALTH_CHECK_PORT=${config.healthCheckPort}`);
+    lines.push('');
+    lines.push('# Monitoring');
+    lines.push(`PROMETHEUS_ENABLED=${config.enableMonitoring}`);
+    if (config.enableMonitoring) {
+        lines.push('GRAFANA_PASSWORD=admin  # Change this in production!');
+    }
+    lines.push('');
+    lines.push('# Logging');
+    lines.push(`LOG_LEVEL=${config.logLevel}`);
+    lines.push('');
+    lines.push('# TigerBeetle');
+    lines.push('TIGERBEETLE_CLUSTER_ID=0');
+    lines.push('TIGERBEETLE_REPLICAS=tigerbeetle:3000');
+    lines.push('');
+    lines.push('# Peer Discovery (optional)');
+    lines.push('PEER_DISCOVERY_ENABLED=false');
+    lines.push('# PEER_DISCOVERY_ENDPOINTS=http://discovery.example.com:9999');
+    lines.push('');
+    return lines.join('\n');
+}
+async function writeEnvFile(content, filePath) {
+    const absolutePath = path.resolve(filePath);
+    const directory = path.dirname(absolutePath);
+    await fs.mkdir(directory, { recursive: true });
+    await fs.writeFile(absolutePath, content, 'utf8');
+}
+async function runOnboarding(outputPath) {
+    try {
+        const config = await runOnboardingWizard();
+        const envContent = generateEnvFile(config);
+        const targetPath = outputPath || path.join(process.cwd(), '.env');
+        try {
+            await fs.access(targetPath);
+            const { overwrite } = await inquirer_1.default.prompt([
+                {
+                    type: 'confirm',
+                    name: 'overwrite',
+                    message: `.env file already exists at ${targetPath}. Overwrite?`,
+                    default: false,
+                },
+            ]);
+            if (!overwrite) {
+                console.log('\nOnboarding cancelled. Existing .env file preserved.');
+                return;
+            }
+        }
+        catch {
+        }
+        await writeEnvFile(envContent, targetPath);
+        console.log('\n========================================');
+        console.log('  Configuration Complete!');
+        console.log('========================================\n');
+        console.log(`Configuration saved to: ${targetPath}\n`);
+        console.log('Next steps:');
+        console.log('1. Review and edit the .env file as needed');
+        if (config.keyBackend === 'env') {
+            console.log('2. Add your private keys to the .env file');
+            console.log('   WARNING: Use KMS in production!');
+        }
+        else {
+            console.log(`2. Configure your ${config.keyBackend} credentials`);
+        }
+        console.log('3. Initialize TigerBeetle (one-time):');
+        console.log('   docker run --rm -v tigerbeetle-data:/data tigerbeetle/tigerbeetle \\');
+        console.log('     format --cluster=0 --replica=0 --replica-count=1 /data/0_0.tigerbeetle');
+        console.log('4. Start the production stack:');
+        console.log('   docker-compose -f docker-compose-production.yml up -d');
+        console.log('');
+    }
+    catch (error) {
+        if (error.message?.includes('User force closed')) {
+            console.log('\n\nOnboarding cancelled by user.');
+            return;
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=onboarding-wizard.js.map

package/dist/cli/onboarding-wizard.js.map

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

package/dist/cli/types.d.ts

@@ -0,0 +1,38 @@
+export type SettlementPreference = 'evm';
+export type KeyBackend = 'env' | 'aws-kms' | 'gcp-kms' | 'azure-kv';
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export interface OnboardingConfig {
+    nodeId: string;
+    settlementPreference: SettlementPreference;
+    evmAddress?: string;
+    keyBackend: KeyBackend;
+    enableMonitoring: boolean;
+    btpPort: number;
+    healthCheckPort: number;
+    logLevel: LogLevel;
+}
+export interface WizardAnswers {
+    nodeId: string;
+    settlementPreference: SettlementPreference;
+    evmAddress?: string;
+    keyBackend: KeyBackend;
+    enableMonitoring: boolean;
+    btpPort: number;
+    healthCheckPort: number;
+    logLevel: LogLevel;
+}
+export interface EnvFileResult {
+    path: string;
+    success: boolean;
+    error?: string;
+}
+export interface HealthCheckResponse {
+    status: 'healthy' | 'degraded' | 'unhealthy';
+    version?: string;
+    uptime?: number;
+    dependencies?: Record<string, {
+        status: string;
+        latencyMs?: number;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/cli/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cli/types.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,oBAAoB,GAAG,KAAK,CAAC;AAKzC,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;AAKpE,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAK3D,MAAM,WAAW,gBAAgB;IAE/B,MAAM,EAAE,MAAM,CAAC;IAGf,oBAAoB,EAAE,oBAAoB,CAAC;IAG3C,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB,UAAU,EAAE,UAAU,CAAC;IAGvB,gBAAgB,EAAE,OAAO,CAAC;IAG1B,OAAO,EAAE,MAAM,CAAC;IAGhB,eAAe,EAAE,MAAM,CAAC;IAGxB,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAKD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB,EAAE,oBAAoB,CAAC;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,UAAU,CAAC;IACvB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAKD,MAAM,WAAW,aAAa;IAE5B,IAAI,EAAE,MAAM,CAAC;IAGb,OAAO,EAAE,OAAO,CAAC;IAGjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAKD,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACvE"}

package/dist/cli/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/cli/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/cli/types.ts"],"names":[],"mappings":""}

package/dist/config/aptos-env-validator.d.ts

@@ -0,0 +1,8 @@
+import type { Logger } from 'pino';
+export interface AptosEnvValidation {
+    enabled: boolean;
+    valid: boolean;
+    missing?: string[];
+}
+export declare function validateAptosEnvironment(logger: Logger): AptosEnvValidation;
+//# sourceMappingURL=aptos-env-validator.d.ts.map

package/dist/config/aptos-env-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aptos-env-validator.d.ts","sourceRoot":"","sources":["../../src/config/aptos-env-validator.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAKnC,MAAM,WAAW,kBAAkB;IAIjC,OAAO,EAAE,OAAO,CAAC;IAMjB,KAAK,EAAE,OAAO,CAAC;IAMf,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAsCD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB,CAsB3E"}

package/dist/config/aptos-env-validator.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateAptosEnvironment = validateAptosEnvironment;
+const REQUIRED_APTOS_ENV_VARS = [
+    'APTOS_NODE_URL',
+    'APTOS_PRIVATE_KEY',
+    'APTOS_ACCOUNT_ADDRESS',
+    'APTOS_CLAIM_PRIVATE_KEY',
+    'APTOS_MODULE_ADDRESS',
+];
+function validateAptosEnvironment(logger) {
+    const enabled = process.env.APTOS_ENABLED === 'true';
+    if (!enabled) {
+        return { enabled: false, valid: true };
+    }
+    const missing = REQUIRED_APTOS_ENV_VARS.filter((v) => !process.env[v]);
+    if (missing.length > 0) {
+        logger.warn({ missing, event: 'aptos_env_validation_failed' }, 'APTOS_ENABLED=true but required environment variables are missing. ' +
+            'Connector will continue without Aptos settlement support.');
+        return { enabled: true, valid: false, missing };
+    }
+    logger.info({ event: 'aptos_env_validation_passed' }, 'Aptos environment validation passed');
+    return { enabled: true, valid: true };
+}
+//# sourceMappingURL=aptos-env-validator.js.map

package/dist/config/aptos-env-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aptos-env-validator.js","sourceRoot":"","sources":["../../src/config/aptos-env-validator.ts"],"names":[],"mappings":";;AAyEA,4DAsBC;AArDD,MAAM,uBAAuB,GAAG;IAC9B,gBAAgB;IAChB,mBAAmB;IACnB,uBAAuB;IACvB,yBAAyB;IACzB,sBAAsB;CACvB,CAAC;AAyBF,SAAgB,wBAAwB,CAAC,MAAc;IACrD,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,KAAK,MAAM,CAAC;IAGrD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzC,CAAC;IAGD,MAAM,OAAO,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAEvE,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,CAAC,IAAI,CACT,EAAE,OAAO,EAAE,KAAK,EAAE,6BAA6B,EAAE,EACjD,qEAAqE;YACnE,2DAA2D,CAC9D,CAAC;QACF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;IAClD,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,6BAA6B,EAAE,EAAE,qCAAqC,CAAC,CAAC;IAC7F,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACxC,CAAC"}

package/dist/config/config-loader.d.ts

@@ -0,0 +1,20 @@
+import { ConnectorConfig } from './types';
+export declare class ConfigurationError extends Error {
+    constructor(message: string);
+}
+export declare class ConnectorNotStartedError extends Error {
+    constructor(message?: string);
+}
+export declare class ConfigLoader {
+    static loadConfig(filePath: string): ConnectorConfig;
+    static validateConfig(raw: unknown): ConnectorConfig;
+    private static loadEnvironment;
+    private static loadBlockchainConfig;
+    private static loadBaseBlockchainConfig;
+    private static loadArbitrumBlockchainConfig;
+    private static validateRequiredFields;
+    private static validatePeers;
+    private static validateRoutes;
+    private static validatePorts;
+}
+//# sourceMappingURL=config-loader.d.ts.map

package/dist/config/config-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.d.ts","sourceRoot":"","sources":["../../src/config/config-loader.ts"],"names":[],"mappings":"AAYA,OAAO,EACL,eAAe,EAWhB,MAAM,SAAS,CAAC;AAejB,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM;CAQ5B;AAKD,qBAAa,wBAAyB,SAAQ,KAAK;gBACrC,OAAO,GAAE,MAAsE;CAI5F;AAuBD,qBAAa,YAAY;IAiBvB,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe;IA2DpD,MAAM,CAAC,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,eAAe;IA4DpD,OAAO,CAAC,MAAM,CAAC,eAAe;IAuB9B,OAAO,CAAC,MAAM,CAAC,oBAAoB;IA8CnC,OAAO,CAAC,MAAM,CAAC,wBAAwB;IAqDvC,OAAO,CAAC,MAAM,CAAC,4BAA4B;IA4C3C,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAiErC,OAAO,CAAC,MAAM,CAAC,aAAa;IA4D5B,OAAO,CAAC,MAAM,CAAC,cAAc;IA2D7B,OAAO,CAAC,MAAM,CAAC,aAAa;CA2B7B"}