@toon-protocol/connector 3.3.1 → 3.3.2

package/dist/transport/socks-transport-provider.js

@@ -0,0 +1,136 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SocksTransportProvider = void 0;
+const socks_proxy_agent_1 = require("socks-proxy-agent");
+const probe_tcp_port_1 = require("./probe-tcp-port");
+const socks_url_1 = require("./socks-url");
+const START_PROBE_TIMEOUT_MS = 2000;
+const HEALTH_PROBE_TIMEOUT_MS = 1000;
+class SocksTransportProvider {
+    _socksProxy;
+    _externalUrl;
+    _logger;
+    _proxyHost;
+    _proxyPort;
+    _managedClient;
+    _resolveExternalUrlOnStart;
+    _managedHealthy = true;
+    constructor(options) {
+        const { socksProxy, externalUrl, logger, managedClient, resolveExternalUrlOnStart } = options;
+        if (!socksProxy || typeof socksProxy !== 'string') {
+            throw new Error('SocksTransportProvider: socksProxy must be a non-empty string starting with "socks5h://" ' +
+                '(socks5h:// is required to prevent DNS leaks -- the proxy, not the local resolver, ' +
+                'must resolve target hostnames)');
+        }
+        let host;
+        let port;
+        try {
+            const parsed = (0, socks_url_1.parseSocks5hUrl)(socksProxy);
+            host = parsed.host;
+            port = parsed.port;
+        }
+        catch (err) {
+            throw new Error(`SocksTransportProvider: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        if (!externalUrl || typeof externalUrl !== 'string') {
+            throw new Error('SocksTransportProvider: externalUrl must be a non-empty string');
+        }
+        this._socksProxy = socksProxy;
+        this._externalUrl = externalUrl;
+        this._proxyHost = host;
+        this._proxyPort = port;
+        this._logger = logger.child({ component: 'socks-transport-provider' });
+        this._managedClient = managedClient;
+        this._resolveExternalUrlOnStart = resolveExternalUrlOnStart;
+    }
+    createAgent(peerUrl) {
+        this._logger.debug({ event: 'socks_create_agent', peerUrl }, 'Creating SOCKS5 agent for peer');
+        return new socks_proxy_agent_1.SocksProxyAgent(this._socksProxy);
+    }
+    getExternalUrl() {
+        return this._externalUrl;
+    }
+    async start() {
+        if (this._managedClient) {
+            await this._managedClient.start();
+        }
+        if (this._resolveExternalUrlOnStart) {
+            try {
+                const resolved = await this._resolveExternalUrlOnStart();
+                if (!resolved || typeof resolved !== 'string') {
+                    throw new Error('resolver returned a non-string value');
+                }
+                if (!resolved.startsWith('ws://') && !resolved.startsWith('wss://')) {
+                    throw new Error('resolved externalUrl must start with ws:// or wss://');
+                }
+                this._externalUrl = resolved;
+            }
+            catch (err) {
+                const reason = err instanceof Error ? err.message : String(err);
+                throw new Error(`SocksTransportProvider: failed to resolve externalUrl from managed hidden service (${reason})`);
+            }
+        }
+        try {
+            await this._probeProxy(START_PROBE_TIMEOUT_MS);
+        }
+        catch (err) {
+            const reason = err instanceof Error ? err.message : String(err);
+            throw new Error(`SocksTransportProvider: SOCKS5 proxy unreachable at ${this._proxyHost}:${this._proxyPort} (${reason})`);
+        }
+        this._managedHealthy = true;
+        this._logger.info({ event: 'socks_transport_started', proxyHost: this._proxyHost, proxyPort: this._proxyPort }, 'SOCKS5 transport started');
+    }
+    async stop() {
+        this._logger.info({ event: 'socks_transport_stopped' }, 'SOCKS5 transport stopped');
+        if (this._managedClient) {
+            await this._managedClient.stop();
+        }
+    }
+    async healthCheck() {
+        let managedOk = true;
+        if (this._managedClient) {
+            try {
+                managedOk = await this._managedClient.healthCheck();
+            }
+            catch {
+                managedOk = false;
+            }
+            if (!managedOk && this._managedHealthy) {
+                this._managedHealthy = false;
+                this._logger.warn({
+                    event: 'managed_anon_crash_detected',
+                    proxyHost: this._proxyHost,
+                    proxyPort: this._proxyPort,
+                }, 'Managed anon client reports not running');
+            }
+            else if (managedOk) {
+                this._managedHealthy = true;
+            }
+        }
+        try {
+            await this._probeProxy(HEALTH_PROBE_TIMEOUT_MS);
+            if (!managedOk) {
+                return false;
+            }
+            this._logger.debug({
+                event: 'socks_transport_health_ok',
+                proxyHost: this._proxyHost,
+                proxyPort: this._proxyPort,
+            }, 'SOCKS5 proxy healthy');
+            return true;
+        }
+        catch {
+            this._logger.warn({
+                event: 'socks_transport_health_failed',
+                proxyHost: this._proxyHost,
+                proxyPort: this._proxyPort,
+            }, 'SOCKS5 proxy health check failed');
+            return false;
+        }
+    }
+    _probeProxy(timeoutMs) {
+        return (0, probe_tcp_port_1.probeTcpPort)(this._proxyHost, this._proxyPort, timeoutMs);
+    }
+}
+exports.SocksTransportProvider = SocksTransportProvider;
+//# sourceMappingURL=socks-transport-provider.js.map

package/dist/transport/socks-transport-provider.js.map

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

package/dist/transport/socks-url.d.ts

@@ -0,0 +1,6 @@
+export interface ParsedSocks5Url {
+    host: string;
+    port: number;
+}
+export declare function parseSocks5hUrl(socksProxy: string): ParsedSocks5Url;
+//# sourceMappingURL=socks-url.d.ts.map

package/dist/transport/socks-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socks-url.d.ts","sourceRoot":"","sources":["../../src/transport/socks-url.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,eAAe;IAE9B,IAAI,EAAE,MAAM,CAAC;IAEb,IAAI,EAAE,MAAM,CAAC;CACd;AAYD,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,CAiCnE"}

package/dist/transport/socks-url.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseSocks5hUrl = parseSocks5hUrl;
+function parseSocks5hUrl(socksProxy) {
+    if (!socksProxy || typeof socksProxy !== 'string') {
+        throw new Error('socksProxy must be a non-empty string starting with "socks5h://" ' +
+            '(socks5h:// is required to prevent DNS leaks -- the proxy, not the local resolver, ' +
+            'must resolve target hostnames)');
+    }
+    if (!socksProxy.startsWith('socks5h://')) {
+        throw new Error(`socksProxy scheme must be "socks5h://" (got "${socksProxy.split('://')[0]}://"). ` +
+            'The "h" suffix is required to prevent DNS leaks: with socks5h, hostname resolution ' +
+            'happens at the proxy (Tor exit / ATOR), not on the local host.');
+    }
+    let parsed;
+    try {
+        parsed = new URL(socksProxy.replace(/^socks5h:\/\//, 'http://'));
+    }
+    catch {
+        throw new Error(`socksProxy is not a valid URL (expected socks5h://host:port)`);
+    }
+    const host = parsed.hostname;
+    const port = parsed.port ? Number.parseInt(parsed.port, 10) : NaN;
+    if (!host || !Number.isFinite(port) || port < 0 || port > 65535) {
+        throw new Error('socksProxy must include a valid host and port (e.g., socks5h://127.0.0.1:9050)');
+    }
+    return { host, port };
+}
+//# sourceMappingURL=socks-url.js.map

package/dist/transport/socks-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"socks-url.js","sourceRoot":"","sources":["../../src/transport/socks-url.ts"],"names":[],"mappings":";;AA8BA,0CAiCC;AAjCD,SAAgB,eAAe,CAAC,UAAkB;IAChD,IAAI,CAAC,UAAU,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CACb,mEAAmE;YACjE,qFAAqF;YACrF,gCAAgC,CACnC,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CACb,gDAAgD,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;YACjF,qFAAqF;YACrF,gEAAgE,CACnE,CAAC;IACJ,CAAC;IAED,IAAI,MAAW,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC,CAAC;IACnE,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC;IAC7B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IAClE,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,KAAK,EAAE,CAAC;QAChE,MAAM,IAAI,KAAK,CACb,gFAAgF,CACjF,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACxB,CAAC"}

package/dist/transport/transport-provider.d.ts

@@ -0,0 +1,9 @@
+import type http from 'http';
+export interface TransportProvider {
+    createAgent(peerUrl: string): http.Agent | undefined;
+    getExternalUrl(): string;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    healthCheck(): Promise<boolean>;
+}
+//# sourceMappingURL=transport-provider.d.ts.map

package/dist/transport/transport-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-provider.d.ts","sourceRoot":"","sources":["../../src/transport/transport-provider.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAY7B,MAAM,WAAW,iBAAiB;IAYhC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;IASrD,cAAc,IAAI,MAAM,CAAC;IASzB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IASvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAStB,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CACjC"}

package/dist/transport/transport-provider.js

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

package/dist/transport/transport-provider.js.map

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

package/dist/utils/connection-pool.d.ts

@@ -0,0 +1,42 @@
+import { Logger } from 'pino';
+import { EventEmitter } from 'events';
+export interface Connection<T> {
+    endpoint: string;
+    client: T;
+    isHealthy: boolean;
+    lastHealthCheck: number;
+}
+export interface ConnectionPoolConfig {
+    poolSize: number;
+    endpoints: string[];
+    healthCheckIntervalMs?: number;
+    reconnectDelayMs?: number;
+    maxReconnectAttempts?: number;
+}
+export interface ConnectionFactory<T> {
+    create(endpoint: string): Promise<T>;
+    disconnect(client: T): Promise<void>;
+    healthCheck(client: T): Promise<boolean>;
+}
+export declare class ConnectionPool<T> extends EventEmitter {
+    private readonly logger;
+    private readonly config;
+    private readonly factory;
+    private readonly connections;
+    private currentIndex;
+    private healthCheckTimer?;
+    private isShuttingDown;
+    constructor(config: ConnectionPoolConfig, factory: ConnectionFactory<T>, logger: Logger);
+    initialize(): Promise<void>;
+    getConnection(): Connection<T> | null;
+    getStats(): {
+        totalConnections: number;
+        healthyConnections: number;
+        unhealthyConnections: number;
+    };
+    private startHealthChecks;
+    private performHealthChecks;
+    private reconnectConnection;
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=connection-pool.d.ts.map

package/dist/utils/connection-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-pool.d.ts","sourceRoot":"","sources":["../../src/utils/connection-pool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAC9B,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,CAAC,CAAC;IACV,SAAS,EAAE,OAAO,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACrC,UAAU,CAAC,MAAM,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,WAAW,CAAC,MAAM,EAAE,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1C;AAMD,qBAAa,cAAc,CAAC,CAAC,CAAE,SAAQ,YAAY;IACjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiC;IACxD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;IAC/C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAkB;IAC9C,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,gBAAgB,CAAC,CAAiB;IAC1C,OAAO,CAAC,cAAc,CAAU;gBAEpB,MAAM,EAAE,oBAAoB,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM;IA4BjF,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA+CjC,aAAa,IAAI,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI;IA8BrC,QAAQ,IAAI;QACV,gBAAgB,EAAE,MAAM,CAAC;QACzB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,oBAAoB,EAAE,MAAM,CAAC;KAC9B;IAaD,OAAO,CAAC,iBAAiB;YAgBX,mBAAmB;YAsDnB,mBAAmB;IA4E3B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAgChC"}

package/dist/utils/connection-pool.js

@@ -0,0 +1,209 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConnectionPool = void 0;
+const events_1 = require("events");
+class ConnectionPool extends events_1.EventEmitter {
+    logger;
+    config;
+    factory;
+    connections;
+    currentIndex;
+    healthCheckTimer;
+    isShuttingDown;
+    constructor(config, factory, logger) {
+        super();
+        this.logger = logger.child({ component: 'connection-pool' });
+        this.config = {
+            poolSize: config.poolSize,
+            endpoints: config.endpoints,
+            healthCheckIntervalMs: config.healthCheckIntervalMs || 30000,
+            reconnectDelayMs: config.reconnectDelayMs || 1000,
+            maxReconnectAttempts: config.maxReconnectAttempts || 5,
+        };
+        this.factory = factory;
+        this.connections = [];
+        this.currentIndex = 0;
+        this.isShuttingDown = false;
+        this.logger.info({
+            poolSize: this.config.poolSize,
+            endpoints: this.config.endpoints,
+            healthCheckIntervalMs: this.config.healthCheckIntervalMs,
+        }, 'ConnectionPool initialized');
+    }
+    async initialize() {
+        this.logger.info('Initializing connection pool');
+        const endpointsToUse = this.config.endpoints.slice(0, this.config.poolSize);
+        for (const endpoint of endpointsToUse) {
+            try {
+                const client = await this.factory.create(endpoint);
+                this.connections.push({
+                    endpoint,
+                    client,
+                    isHealthy: true,
+                    lastHealthCheck: Date.now(),
+                });
+                this.logger.info({ endpoint }, 'Connection created successfully');
+            }
+            catch (error) {
+                this.logger.error({ endpoint, error: error.message }, 'Failed to create connection');
+                this.connections.push({
+                    endpoint,
+                    client: null,
+                    isHealthy: false,
+                    lastHealthCheck: Date.now(),
+                });
+            }
+        }
+        this.startHealthChecks();
+        this.logger.info({
+            totalConnections: this.connections.length,
+            healthyConnections: this.connections.filter((c) => c.isHealthy).length,
+        }, 'Connection pool initialized');
+    }
+    getConnection() {
+        if (this.connections.length === 0) {
+            this.logger.warn('No connections available in pool');
+            return null;
+        }
+        let attempts = 0;
+        do {
+            const connection = this.connections[this.currentIndex];
+            this.currentIndex = (this.currentIndex + 1) % this.connections.length;
+            if (connection && connection.isHealthy) {
+                this.logger.trace({ endpoint: connection.endpoint }, 'Connection selected from pool');
+                return connection;
+            }
+            attempts++;
+        } while (attempts < this.connections.length);
+        this.logger.warn('No healthy connections available in pool');
+        return null;
+    }
+    getStats() {
+        const healthyCount = this.connections.filter((c) => c.isHealthy).length;
+        return {
+            totalConnections: this.connections.length,
+            healthyConnections: healthyCount,
+            unhealthyConnections: this.connections.length - healthyCount,
+        };
+    }
+    startHealthChecks() {
+        if (this.healthCheckTimer) {
+            clearInterval(this.healthCheckTimer);
+        }
+        this.healthCheckTimer = setInterval(async () => {
+            await this.performHealthChecks();
+        }, this.config.healthCheckIntervalMs);
+        this.healthCheckTimer.unref();
+    }
+    async performHealthChecks() {
+        if (this.isShuttingDown) {
+            return;
+        }
+        this.logger.debug('Performing health checks on all connections');
+        for (const connection of this.connections) {
+            try {
+                if (connection.client && connection.isHealthy) {
+                    const isHealthy = await this.factory.healthCheck(connection.client);
+                    if (!isHealthy) {
+                        this.logger.warn({ endpoint: connection.endpoint }, 'Connection health check failed');
+                        connection.isHealthy = false;
+                        this.emit('connection-unhealthy', { endpoint: connection.endpoint });
+                        this.reconnectConnection(connection);
+                    }
+                    connection.lastHealthCheck = Date.now();
+                }
+                else if (!connection.isHealthy) {
+                    await this.reconnectConnection(connection);
+                }
+            }
+            catch (error) {
+                this.logger.error({
+                    endpoint: connection.endpoint,
+                    error: error.message,
+                }, 'Error during health check');
+                connection.isHealthy = false;
+            }
+        }
+        const stats = this.getStats();
+        this.logger.debug({
+            healthyConnections: stats.healthyConnections,
+            unhealthyConnections: stats.unhealthyConnections,
+        }, 'Health checks completed');
+    }
+    async reconnectConnection(connection) {
+        let attempts = 0;
+        while (attempts < this.config.maxReconnectAttempts && !this.isShuttingDown) {
+            try {
+                this.logger.info({
+                    endpoint: connection.endpoint,
+                    attempt: attempts + 1,
+                    maxAttempts: this.config.maxReconnectAttempts,
+                }, 'Attempting to reconnect');
+                if (connection.client) {
+                    try {
+                        await this.factory.disconnect(connection.client);
+                    }
+                    catch (error) {
+                        this.logger.warn({
+                            endpoint: connection.endpoint,
+                            error: error.message,
+                        }, 'Error disconnecting old client');
+                    }
+                }
+                const newClient = await this.factory.create(connection.endpoint);
+                connection.client = newClient;
+                connection.isHealthy = true;
+                connection.lastHealthCheck = Date.now();
+                this.logger.info({ endpoint: connection.endpoint }, 'Connection reconnected successfully');
+                this.emit('connection-reconnected', { endpoint: connection.endpoint });
+                return;
+            }
+            catch (error) {
+                this.logger.warn({
+                    endpoint: connection.endpoint,
+                    attempt: attempts + 1,
+                    error: error.message,
+                }, 'Reconnection attempt failed');
+                attempts++;
+                if (attempts < this.config.maxReconnectAttempts) {
+                    await new Promise((resolve) => {
+                        const timer = setTimeout(resolve, this.config.reconnectDelayMs);
+                        if (typeof timer.unref === 'function')
+                            timer.unref();
+                    });
+                }
+            }
+        }
+        this.logger.error({
+            endpoint: connection.endpoint,
+            attempts,
+        }, 'Failed to reconnect after maximum attempts');
+        this.emit('connection-failed', { endpoint: connection.endpoint });
+    }
+    async shutdown() {
+        this.logger.info('Shutting down connection pool');
+        this.isShuttingDown = true;
+        if (this.healthCheckTimer) {
+            clearInterval(this.healthCheckTimer);
+            this.healthCheckTimer = undefined;
+        }
+        for (const connection of this.connections) {
+            if (connection.client) {
+                try {
+                    await this.factory.disconnect(connection.client);
+                    this.logger.debug({ endpoint: connection.endpoint }, 'Connection disconnected');
+                }
+                catch (error) {
+                    this.logger.error({
+                        endpoint: connection.endpoint,
+                        error: error.message,
+                    }, 'Error disconnecting connection');
+                }
+            }
+        }
+        this.connections.length = 0;
+        this.logger.info('Connection pool shutdown complete');
+    }
+}
+exports.ConnectionPool = ConnectionPool;
+//# sourceMappingURL=connection-pool.js.map

package/dist/utils/connection-pool.js.map

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

package/dist/utils/evm-rpc-connection-pool.d.ts

@@ -0,0 +1,8 @@
+import { Logger } from 'pino';
+import type { JsonRpcProvider } from 'ethers';
+import { ConnectionPool } from './connection-pool';
+export declare class EVMRPCConnectionPool extends ConnectionPool<JsonRpcProvider> {
+    constructor(rpcUrls: string[], poolSize: number, logger: Logger);
+    getProvider(): JsonRpcProvider | null;
+}
+//# sourceMappingURL=evm-rpc-connection-pool.d.ts.map

package/dist/utils/evm-rpc-connection-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evm-rpc-connection-pool.d.ts","sourceRoot":"","sources":["../../src/utils/evm-rpc-connection-pool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAC9B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAqB,MAAM,mBAAmB,CAAC;AAkCtE,qBAAa,oBAAqB,SAAQ,cAAc,CAAC,eAAe,CAAC;gBAO3D,OAAO,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAmB/D,WAAW,IAAI,eAAe,GAAG,IAAI;CAItC"}

package/dist/utils/evm-rpc-connection-pool.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EVMRPCConnectionPool = void 0;
+const connection_pool_1 = require("./connection-pool");
+const optional_require_1 = require("./optional-require");
+class EVMRPCConnectionFactory {
+    async create(endpoint) {
+        const { ethers } = await (0, optional_require_1.requireOptional)('ethers', 'EVM settlement');
+        const provider = new ethers.JsonRpcProvider(endpoint);
+        await provider.getBlockNumber();
+        return provider;
+    }
+    async disconnect(client) {
+        client.destroy();
+    }
+    async healthCheck(client) {
+        try {
+            await client.getBlockNumber();
+            return true;
+        }
+        catch (error) {
+            return false;
+        }
+    }
+}
+class EVMRPCConnectionPool extends connection_pool_1.ConnectionPool {
+    constructor(rpcUrls, poolSize, logger) {
+        const factory = new EVMRPCConnectionFactory();
+        super({
+            poolSize,
+            endpoints: rpcUrls,
+        }, factory, logger);
+    }
+    getProvider() {
+        const connection = this.getConnection();
+        return connection ? connection.client : null;
+    }
+}
+exports.EVMRPCConnectionPool = EVMRPCConnectionPool;
+//# sourceMappingURL=evm-rpc-connection-pool.js.map

package/dist/utils/evm-rpc-connection-pool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evm-rpc-connection-pool.js","sourceRoot":"","sources":["../../src/utils/evm-rpc-connection-pool.ts"],"names":[],"mappings":";;;AAEA,uDAAsE;AACtE,yDAAqD;AAKrD,MAAM,uBAAuB;IAC3B,KAAK,CAAC,MAAM,CAAC,QAAgB;QAC3B,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAA,kCAAe,EAA0B,QAAQ,EAAE,gBAAgB,CAAC,CAAC;QAC9F,MAAM,QAAQ,GAAG,IAAI,MAAM,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;QAEtD,MAAM,QAAQ,CAAC,cAAc,EAAE,CAAC;QAChC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAAuB;QACtC,MAAM,CAAC,OAAO,EAAE,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,MAAuB;QACvC,IAAI,CAAC;YAEH,MAAM,MAAM,CAAC,cAAc,EAAE,CAAC;YAC9B,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;CACF;AAMD,MAAa,oBAAqB,SAAQ,gCAA+B;IAOvE,YAAY,OAAiB,EAAE,QAAgB,EAAE,MAAc;QAC7D,MAAM,OAAO,GAAG,IAAI,uBAAuB,EAAE,CAAC;QAE9C,KAAK,CACH;YACE,QAAQ;YACR,SAAS,EAAE,OAAO;SACnB,EACD,OAAO,EACP,MAAM,CACP,CAAC;IACJ,CAAC;IAQD,WAAW;QACT,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;QACxC,OAAO,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/C,CAAC;CACF;AA9BD,oDA8BC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,6 @@
+import pino from 'pino';
+export type Logger = pino.Logger;
+export declare function sanitizeWalletForLogs(wallet: Record<string, unknown>): Record<string, unknown>;
+export declare function createLogger(nodeId: string, logLevel?: string): Logger;
+export declare function generateCorrelationId(): string;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAQA,OAAO,IAAI,MAAM,MAAM,CAAC;AASxB,MAAM,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;AA2CjC,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAuB9F;AAuBD,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAwBtE;AAiBD,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C"}

package/dist/utils/logger.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sanitizeWalletForLogs = sanitizeWalletForLogs;
+exports.createLogger = createLogger;
+exports.generateCorrelationId = generateCorrelationId;
+const tslib_1 = require("tslib");
+const pino_1 = tslib_1.__importDefault(require("pino"));
+const crypto_1 = require("crypto");
+const DEFAULT_LOG_LEVEL = 'info';
+function getValidLogLevel(envLevel) {
+    if (!envLevel) {
+        return DEFAULT_LOG_LEVEL;
+    }
+    const normalized = envLevel.toLowerCase();
+    const validLevels = ['debug', 'info', 'warn', 'error'];
+    if (validLevels.includes(normalized)) {
+        return normalized;
+    }
+    return DEFAULT_LOG_LEVEL;
+}
+function sanitizeWalletForLogs(wallet) {
+    if (!wallet || typeof wallet !== 'object') {
+        return wallet;
+    }
+    const sanitized = { ...wallet };
+    sanitized.privateKey = '[REDACTED]';
+    sanitized.mnemonic = '[REDACTED]';
+    sanitized.seed = '[REDACTED]';
+    sanitized.encryptionKey = '[REDACTED]';
+    sanitized.secret = '[REDACTED]';
+    if (sanitized.signer && typeof sanitized.signer === 'object') {
+        sanitized.signer = { ...sanitized.signer };
+        sanitized.signer.privateKey = '[REDACTED]';
+        sanitized.signer.secret = '[REDACTED]';
+    }
+    return sanitized;
+}
+function createLogger(nodeId, logLevel) {
+    const level = logLevel ? getValidLogLevel(logLevel) : getValidLogLevel(process.env.LOG_LEVEL);
+    const serializers = {
+        wallet: sanitizeWalletForLogs,
+        masterSeed: () => '[REDACTED]',
+        privateKey: () => '[REDACTED]',
+        mnemonic: () => '[REDACTED]',
+        seed: () => '[REDACTED]',
+        encryptionKey: () => '[REDACTED]',
+        secret: () => '[REDACTED]',
+    };
+    const baseLogger = (0, pino_1.default)({
+        level,
+        serializers,
+    });
+    return baseLogger.child({ nodeId });
+}
+function generateCorrelationId() {
+    return `pkt_${(0, crypto_1.randomBytes)(8).toString('hex')}`;
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":";;AA4DA,sDAuBC;AAuBD,oCAwBC;AAiBD,sDAEC;;AA7ID,wDAAwB;AACxB,mCAAqC;AAkBrC,MAAM,iBAAiB,GAAa,MAAM,CAAC;AAU3C,SAAS,gBAAgB,CAAC,QAAiB;IACzC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IAED,MAAM,UAAU,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;IAC1C,MAAM,WAAW,GAAe,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAEnE,IAAI,WAAW,CAAC,QAAQ,CAAC,UAAsB,CAAC,EAAE,CAAC;QACjD,OAAO,UAAsB,CAAC;IAChC,CAAC;IAED,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAUD,SAAgB,qBAAqB,CAAC,MAA+B;IACnE,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC1C,OAAO,MAAM,CAAC;IAChB,CAAC;IAGD,MAAM,SAAS,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC;IAGhC,SAAS,CAAC,UAAU,GAAG,YAAY,CAAC;IACpC,SAAS,CAAC,QAAQ,GAAG,YAAY,CAAC;IAClC,SAAS,CAAC,IAAI,GAAG,YAAY,CAAC;IAC9B,SAAS,CAAC,aAAa,GAAG,YAAY,CAAC;IACvC,SAAS,CAAC,MAAM,GAAG,YAAY,CAAC;IAGhC,IAAI,SAAS,CAAC,MAAM,IAAI,OAAO,SAAS,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC7D,SAAS,CAAC,MAAM,GAAG,EAAE,GAAI,SAAS,CAAC,MAAkC,EAAE,CAAC;QACvE,SAAS,CAAC,MAAkC,CAAC,UAAU,GAAG,YAAY,CAAC;QACvE,SAAS,CAAC,MAAkC,CAAC,MAAM,GAAG,YAAY,CAAC;IACtE,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAuBD,SAAgB,YAAY,CAAC,MAAc,EAAE,QAAiB;IAE5D,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAG9F,MAAM,WAAW,GAAG;QAClB,MAAM,EAAE,qBAAqB;QAC7B,UAAU,EAAE,GAAG,EAAE,CAAC,YAAY;QAC9B,UAAU,EAAE,GAAG,EAAE,CAAC,YAAY;QAC9B,QAAQ,EAAE,GAAG,EAAE,CAAC,YAAY;QAC5B,IAAI,EAAE,GAAG,EAAE,CAAC,YAAY;QACxB,aAAa,EAAE,GAAG,EAAE,CAAC,YAAY;QACjC,MAAM,EAAE,GAAG,EAAE,CAAC,YAAY;KAC3B,CAAC;IAGF,MAAM,UAAU,GAAG,IAAA,cAAI,EAAC;QACtB,KAAK;QACL,WAAW;KACZ,CAAC,CAAC;IAIH,OAAO,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;AACtC,CAAC;AAiBD,SAAgB,qBAAqB;IACnC,OAAO,OAAO,IAAA,oBAAW,EAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;AACjD,CAAC"}

package/dist/utils/optional-require.d.ts

@@ -0,0 +1,2 @@
+export declare function requireOptional<T>(packageName: string, feature: string): Promise<T>;
+//# sourceMappingURL=optional-require.d.ts.map

package/dist/utils/optional-require.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optional-require.d.ts","sourceRoot":"","sources":["../../src/utils/optional-require.ts"],"names":[],"mappings":"AAMA,wBAAsB,eAAe,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAkBzF"}