@claw-network/node 0.2.0

package/dist/daemon.js

@@ -0,0 +1,248 @@
+#!/usr/bin/env node
+import { readFile } from 'node:fs/promises';
+import { parse } from 'yaml';
+import { ClawNetNode } from './index.js';
+import { createLogger } from './logger.js';
+import { loadConfig, resolveStoragePaths } from '@claw-network/core';
+import { ChainConfigSchema } from './services/chain-config.js';
+import { validateLiquidityPolicyFromEnv } from './policy/liquidity-policy.js';
+function parseArgs(argv) {
+    let dataDir;
+    let noApi = false;
+    let apiHost;
+    let apiPort;
+    const listen = [];
+    const bootstrap = [];
+    let healthIntervalMs = 30_000;
+    let passphrase;
+    let network;
+    for (let i = 0; i < argv.length; i += 1) {
+        const arg = argv[i];
+        if (arg === '--data-dir') {
+            dataDir = argv[++i];
+            continue;
+        }
+        if (arg === '--no-api') {
+            noApi = true;
+            continue;
+        }
+        if (arg === '--api-host') {
+            apiHost = argv[++i];
+            continue;
+        }
+        if (arg === '--api-port') {
+            const raw = argv[++i] ?? '';
+            const parsed = Number.parseInt(raw, 10);
+            if (Number.isNaN(parsed) || parsed < 1 || parsed > 65535) {
+                console.error(`Invalid --api-port value: '${raw}'. Must be 1–65535.`);
+                process.exit(1);
+            }
+            apiPort = parsed;
+            continue;
+        }
+        if (arg === '--listen') {
+            const value = argv[++i];
+            if (value) {
+                listen.push(value);
+            }
+            continue;
+        }
+        if (arg === '--bootstrap') {
+            const value = argv[++i];
+            if (value) {
+                bootstrap.push(value);
+            }
+            continue;
+        }
+        if (arg === '--health-interval-ms') {
+            healthIntervalMs = Number.parseInt(argv[++i] ?? '', 10);
+            continue;
+        }
+        if (arg === '--passphrase') {
+            passphrase = argv[++i];
+            continue;
+        }
+        if (arg === '--network') {
+            const val = argv[++i];
+            if (val !== 'mainnet' && val !== 'testnet' && val !== 'devnet') {
+                console.error(`[clawnetd] invalid --network value: ${val} (must be mainnet|testnet|devnet)`);
+                process.exit(1);
+            }
+            network = val;
+            continue;
+        }
+        if (arg === '--help' || arg === '-h') {
+            printHelp();
+            process.exit(0);
+        }
+        console.error(`[clawnetd] unknown option: ${arg}`);
+        process.exit(1);
+    }
+    if (Number.isNaN(healthIntervalMs) || healthIntervalMs < 0) {
+        console.error('[clawnetd] invalid --health-interval-ms');
+        process.exit(1);
+    }
+    return {
+        dataDir,
+        noApi,
+        apiHost,
+        apiPort,
+        listen,
+        bootstrap,
+        healthIntervalMs,
+        passphrase: passphrase ?? process.env.CLAW_PASSPHRASE,
+        network: network ?? process.env.CLAW_NETWORK,
+    };
+}
+async function main(argv = process.argv.slice(2)) {
+    await startDaemon(argv, { attachSignals: true });
+}
+export async function startDaemon(argv, options = {}) {
+    const args = parseArgs(argv);
+    const liquidityPolicyValidation = validateLiquidityPolicyFromEnv();
+    if (liquidityPolicyValidation.enabled && liquidityPolicyValidation.errors.length > 0) {
+        const details = liquidityPolicyValidation.errors.map((msg) => `- ${msg}`).join('\n');
+        console.error(`[clawnetd] FATAL: invalid liquidity policy configuration.\n\n${details}\n\n` +
+            'Set a dedicated CLAW_LIQUIDITY_ADDRESS and keep it separate from treasury/faucet/reserve wallets.\n' +
+            'Required controls: multisig wallet, monthly budget cap, recycle-to-treasury policy.');
+        process.exit(1);
+    }
+    // ── Passphrase is REQUIRED ──────────────────────────────────────────
+    // Without a passphrase the node cannot create or decrypt its identity
+    // key record, which means: no DID, no signing, no transactions.
+    if (!args.passphrase) {
+        console.error(`[clawnetd] FATAL: No passphrase configured.
+
+A passphrase is required so the node can create its on-chain identity (DID).
+Without it the node cannot sign transactions, participate in markets, or
+hold a wallet — it is essentially non-functional.
+
+Provide one via either:
+  --passphrase <string>
+  CLAW_PASSPHRASE=<string>   (environment variable)
+
+Example:
+  clawnetd --passphrase "my-secure-passphrase"
+  CLAW_PASSPHRASE="my-secure-passphrase" clawnetd
+`);
+        process.exit(1);
+    }
+    const paths = resolveStoragePaths(args.dataDir);
+    const config = await loadConfig(paths);
+    const logger = createLogger({
+        level: config.logging?.level ?? 'info',
+        file: config.logging?.file,
+    });
+    // ── Load optional chain config from config.yaml ─────────────────────
+    let chainConfig;
+    try {
+        const raw = await readFile(paths.configFile, 'utf8');
+        const parsed = parse(raw);
+        if (parsed?.chain) {
+            chainConfig = ChainConfigSchema.parse(parsed.chain);
+            logger.info('[clawnetd] On-chain config loaded — EventIndexer will start');
+        }
+    }
+    catch (err) {
+        // If the file exists but chain section is invalid, warn but continue
+        if (err instanceof Error && 'issues' in err) {
+            logger.warn('[clawnetd] Invalid chain config in config.yaml — skipping: %s', err.message);
+        }
+        // ENOENT is fine — no config file means no chain config
+    }
+    const node = new ClawNetNode({
+        dataDir: args.dataDir,
+        passphrase: args.passphrase,
+        chain: chainConfig,
+        network: args.network,
+        api: {
+            enabled: args.noApi ? false : true,
+            host: args.apiHost,
+            port: args.apiPort,
+        },
+        p2p: {
+            listen: args.listen.length ? args.listen : config.p2p?.listen,
+            bootstrap: args.bootstrap.length ? args.bootstrap : config.p2p?.bootstrap,
+        },
+    });
+    if (options.attachSignals !== false) {
+        process.on('SIGINT', () => void shutdown(node, 'SIGINT', logger));
+        process.on('SIGTERM', () => void shutdown(node, 'SIGTERM', logger));
+    }
+    await node.start();
+    logger.info('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    logger.info('clawnetd');
+    logger.info('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    logger.info(`Data Dir : ${paths.root}`);
+    logger.info(`Peer Id  : ${node.getPeerId() ?? 'unknown'}`);
+    logger.info(`DID      : ${node.getDid() ?? '(pending)'}`);
+    const effectiveNetwork = args.network ?? config.network;
+    logger.info(`Network  : ${effectiveNetwork}`);
+    if (effectiveNetwork === 'mainnet') {
+        logger.info('[clawnetd] Mainnet mode: dev routes (faucet) disabled, API key required');
+    }
+    if (liquidityPolicyValidation.config) {
+        const lp = liquidityPolicyValidation.config;
+        logger.info(`Liquidity policy: address=${lp.liquidityAddress}, multisig=${lp.liquidityWalletControl}, monthlyCap=${lp.liquidityMonthlyBudgetCap}%, recycleEvery=${lp.liquidityRecycleIntervalDays}d`);
+    }
+    logger.info('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    let healthTimer;
+    if (args.healthIntervalMs > 0) {
+        healthTimer = setInterval(() => {
+            const health = node.getHealth();
+            if (health.ok) {
+                logger.debug('[clawnetd] health ok', health.checks);
+            }
+            else {
+                logger.warn('[clawnetd] health check failed', health.checks);
+            }
+        }, args.healthIntervalMs);
+        healthTimer.unref();
+    }
+    const stop = async () => {
+        if (healthTimer) {
+            clearInterval(healthTimer);
+            healthTimer = undefined;
+        }
+        await node.stop();
+    };
+    return { node, logger, stop };
+}
+async function shutdown(node, signal, logger) {
+    if (logger) {
+        logger.info(`[clawnetd] received ${signal}, stopping...`);
+    }
+    else {
+        console.log(`[clawnetd] received ${signal}, stopping...`);
+    }
+    await node.stop();
+    process.exit(0);
+}
+function printHelp() {
+    console.log(`
+clawnetd [options]
+
+Options:
+  --data-dir <path>          Override storage root
+  --no-api                   Disable local API server
+  --api-host <host>          API host (default: 127.0.0.1)
+  --api-port <port>          API port (default: 9528)
+  --listen <multiaddr>       Add libp2p listen multiaddr (repeatable)
+  --bootstrap <multiaddr>    Add bootstrap peer multiaddr (repeatable)
+  --health-interval-ms <ms>  Health check interval (default: 30000, 0 to disable)
+  --passphrase <str>         Passphrase for node identity key (REQUIRED, env: CLAW_PASSPHRASE)
+  --network <type>           Network type: mainnet|testnet|devnet (overrides config.yaml, env: CLAW_NETWORK)
+  -h, --help                 Show help
+`);
+}
+// Only auto-run when executed directly (not when imported by tests)
+const isDirectRun = typeof process !== 'undefined' &&
+    process.argv[1] &&
+    (process.argv[1].endsWith('daemon.js') || process.argv[1].endsWith('daemon.ts'));
+if (isDirectRun) {
+    void main().catch((error) => {
+        console.error('[clawnetd] fatal error:', error);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=daemon.js.map

package/dist/daemon.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,137 @@
+import { EventEnvelope, EventStore, P2PConfig, SnapshotRecord, SnapshotSchedulePolicy, SnapshotStore } from '@claw-network/core';
+import { P2PSyncConfig } from './p2p/sync.js';
+import { ApiServerConfig } from './api/server.js';
+import { type ChainConfig } from './services/index.js';
+import { type EventIndexerConfig } from './indexer/index.js';
+export interface NodeRuntimeConfig {
+    dataDir?: string;
+    passphrase?: string;
+    api?: Partial<ApiServerConfig> & {
+        enabled?: boolean;
+    };
+    p2p?: Partial<P2PConfig>;
+    sync?: Partial<P2PSyncConfig> & {
+        rangeIntervalMs?: number;
+        snapshotIntervalMs?: number;
+        requestRangeOnStart?: boolean;
+        requestSnapshotOnStart?: boolean;
+        validateSnapshotState?: (snapshot: import('@claw-network/core').SnapshotRecord, events: Uint8Array[]) => Promise<boolean> | boolean;
+    };
+    snapshotBuilder?: (context: {
+        eventStore: EventStore;
+        snapshotStore: SnapshotStore;
+        lastSnapshot: SnapshotRecord | null;
+    }) => Promise<SnapshotRecord | null>;
+    snapshotPolicy?: Partial<SnapshotSchedulePolicy>;
+    resolveControllerPublicKey?: (controllerDid: string) => Promise<Uint8Array | null>;
+    /** On-chain configuration. When provided, enables chain read/write via ContractProvider + WalletService. */
+    chain?: ChainConfig;
+    /** Optional overrides for the event indexer polling behaviour. */
+    indexer?: EventIndexerConfig;
+    /** Network type override (mainnet|testnet|devnet). Overrides config.yaml value. */
+    network?: 'mainnet' | 'testnet' | 'devnet';
+}
+export declare const DEFAULT_SYNC_RUNTIME_CONFIG: {
+    rangeIntervalMs: number;
+    snapshotIntervalMs: number;
+    requestRangeOnStart: boolean;
+    requestSnapshotOnStart: boolean;
+};
+export declare const DEFAULT_NODE_RUNTIME_CONFIG: NodeRuntimeConfig;
+export declare class ClawNetNode {
+    private readonly config;
+    private p2p?;
+    private sync?;
+    private eventDb?;
+    private stateDb?;
+    private eventStore?;
+    private snapshotStore?;
+    private snapshotScheduler?;
+    private contractStore?;
+    private reputationStore?;
+    private daoStore?;
+    private marketSearchStore?;
+    private infoContentStore?;
+    private rangeTimer?;
+    private snapshotTimer?;
+    private meshAmplifierTimer?;
+    private apiServer?;
+    private contractProvider?;
+    private indexerStore?;
+    private eventIndexer?;
+    private indexerQuery?;
+    private walletService?;
+    private identityService?;
+    private reputationService?;
+    private contractsService?;
+    private daoService?;
+    private apiKeyStore?;
+    private peerId?;
+    private peerPrivateKey?;
+    private startedAt?;
+    private persistedConfig?;
+    private starting?;
+    private stopping?;
+    private cachedDid?;
+    constructor(config?: NodeRuntimeConfig);
+    start(): Promise<void>;
+    private startInternal;
+    stop(): Promise<void>;
+    private stopInternal;
+    getPeerId(): string | null;
+    /** Return the node's DID (synchronous, cached after start). */
+    getDid(): string | null;
+    getHealth(): {
+        ok: boolean;
+        checks: {
+            p2p: boolean;
+            sync: boolean;
+            eventStore: boolean;
+            api: boolean;
+        };
+    };
+    private buildNodeStatus;
+    private buildNodePeers;
+    private buildNodeConfig;
+    publishEvent(envelope: EventEnvelope): Promise<string>;
+    private initReputationStore;
+    private initContractStore;
+    private initDaoStore;
+    private initMarketSearchStore;
+    private initInfoContentStore;
+    private applyEventStores;
+    private parseEventEnvelope;
+    private resolveNetwork;
+    private resolveP2PPort;
+    private resolveLocalDid;
+    private startSyncLoops;
+    private stopSyncLoops;
+    /**
+     * Persistent connection watchdog with two phases:
+     *
+     *   Phase 1 (0–60 s): Aggressive mesh amplification every 5 s.
+     *                       Discovers peers via DHT random-walk + peerStore dial.
+     *   Phase 2 (60 s+):   Every 30 s, check connection count. If below
+     *                       `minConnections` (1), re-dial bootstrap peers and
+     *                       run another amplify cycle to rejoin the mesh.
+     *
+     * This replaces the old one-shot amplifier that stopped permanently after 60 s
+     * and left the node unable to reconnect after transient network disruptions.
+     */
+    private startMeshAmplifier;
+    private stopMeshAmplifier;
+    private requestRangeTick;
+    private requestSnapshotTick;
+    private maybeCreateSnapshot;
+    private loadOrCreatePeerId;
+    private ensureIdentityKeyRecord;
+    private extractPeerPrivateKey;
+}
+export { DEFAULT_P2P_SYNC_CONFIG } from './p2p/sync.js';
+export * from './p2p/sync.js';
+export { ApiKeyStore } from './api/api-key-store.js';
+export type { ApiKeyRecord, ApiKeySummary } from './api/api-key-store.js';
+export { getApiKeyAuth } from './api/auth.js';
+export type { ApiKeyAuth } from './api/auth.js';
+export type { NetworkType } from './api/types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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