@aaronbassett/midnight-local-devnet 0.1.0

package/dist/core/accounts.js

@@ -0,0 +1,80 @@
+import { writeFile } from 'node:fs/promises';
+import { generateNewMnemonic, mnemonicToSeed, initWalletFromMnemonic, waitForFunds, registerNightForDust, closeWallet, } from './wallet.js';
+import { fundAccount } from './funding.js';
+import { PublicKey as UnshieldedPublicKey } from '@midnight-ntwrk/wallet-sdk-unshielded-wallet';
+import { DEFAULT_NIGHT_AMOUNT } from './config.js';
+let logger = null;
+export function setLogger(l) {
+    logger = l;
+}
+export async function generateAccounts(opts) {
+    const count = opts.count ?? 1;
+    const accounts = [];
+    for (let i = 0; i < count; i++) {
+        const mnemonic = generateNewMnemonic();
+        if (opts.format === 'privateKey') {
+            // Derive actual hex seed from mnemonic (review fix #5)
+            const seed = mnemonicToSeed(mnemonic);
+            accounts.push({
+                name: `Account ${i + 1}`,
+                privateKey: seed.toString('hex'),
+                address: '', // Address is derived when wallet is initialized on-chain
+            });
+        }
+        else {
+            accounts.push({
+                name: `Account ${i + 1}`,
+                mnemonic,
+                address: '', // Address is derived when wallet is initialized on-chain
+            });
+        }
+    }
+    return accounts;
+}
+export async function generateAndFundAccounts(masterWallet, config, opts) {
+    const accounts = await generateAccounts(opts);
+    const results = [];
+    for (const account of accounts) {
+        const mnemonic = account.mnemonic;
+        if (!mnemonic) {
+            results.push({ ...account, funded: false, dustRegistered: false });
+            continue;
+        }
+        if (opts.fund) {
+            logger?.info({ name: account.name }, 'Funding account...');
+            const ctx = await initWalletFromMnemonic(mnemonic, config);
+            try {
+                const address = UnshieldedPublicKey.fromKeyStore(ctx.unshieldedKeystore).address;
+                account.address = address;
+                await fundAccount(masterWallet, address, DEFAULT_NIGHT_AMOUNT);
+                await waitForFunds(ctx.wallet);
+                if (opts.registerDust) {
+                    const dustOk = await registerNightForDust(ctx);
+                    results.push({ ...account, funded: true, dustRegistered: dustOk });
+                }
+                else {
+                    results.push({ ...account, funded: true, dustRegistered: false });
+                }
+            }
+            finally {
+                await closeWallet(ctx);
+            }
+        }
+        else {
+            results.push({ ...account, funded: false, dustRegistered: false });
+        }
+    }
+    return results;
+}
+export async function writeAccountsFile(filePath, accounts) {
+    const fileContent = {
+        accounts: accounts.map((a) => ({
+            name: a.name,
+            ...(a.mnemonic ? { mnemonic: a.mnemonic } : {}),
+            ...(a.privateKey ? { privateKey: a.privateKey } : {}),
+        })),
+    };
+    await writeFile(filePath, JSON.stringify(fileContent, null, 2) + '\n', 'utf-8');
+    logger?.info({ filePath, count: accounts.length }, 'Accounts file written');
+}
+//# sourceMappingURL=accounts.js.map

package/dist/core/accounts.js.map

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

package/dist/core/config.d.ts

@@ -0,0 +1,12 @@
+import type { NetworkConfig } from './types.js';
+export declare const DOCKER_COMPOSE_DIR: string;
+export declare const DOCKER_COMPOSE_FILE = "standalone.yml";
+export declare const GENESIS_SEED = "0000000000000000000000000000000000000000000000000000000000000001";
+export declare const DEFAULT_NIGHT_AMOUNT: bigint;
+export declare const MAX_ACCOUNTS_PER_BATCH = 10;
+export declare const DOCKER_IMAGES: {
+    readonly node: "midnightntwrk/midnight-node:0.20.0";
+    readonly indexer: "midnightntwrk/indexer-standalone:3.0.0";
+    readonly proofServer: "midnightntwrk/proof-server:7.0.0";
+};
+export declare const defaultConfig: NetworkConfig;

package/dist/core/config.js

@@ -0,0 +1,22 @@
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+export const DOCKER_COMPOSE_DIR = path.resolve(__dirname, '../../docker');
+export const DOCKER_COMPOSE_FILE = 'standalone.yml';
+// Dev-only genesis seed (private key = 1). Never use on a live network.
+export const GENESIS_SEED = '0000000000000000000000000000000000000000000000000000000000000001';
+export const DEFAULT_NIGHT_AMOUNT = 50000n * 10n ** 6n; // 50,000 NIGHT in smallest unit
+export const MAX_ACCOUNTS_PER_BATCH = 10;
+export const DOCKER_IMAGES = {
+    node: 'midnightntwrk/midnight-node:0.20.0',
+    indexer: 'midnightntwrk/indexer-standalone:3.0.0',
+    proofServer: 'midnightntwrk/proof-server:7.0.0',
+};
+export const defaultConfig = {
+    indexer: 'http://127.0.0.1:8088/api/v3/graphql',
+    indexerWS: 'ws://127.0.0.1:8088/api/v3/graphql/ws',
+    node: 'http://127.0.0.1:9944',
+    proofServer: 'http://127.0.0.1:6300',
+    networkId: 'undeployed',
+};
+//# sourceMappingURL=config.js.map

package/dist/core/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE/D,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;AAC1E,MAAM,CAAC,MAAM,mBAAmB,GAAG,gBAAgB,CAAC;AAEpD,wEAAwE;AACxE,MAAM,CAAC,MAAM,YAAY,GAAG,kEAAkE,CAAC;AAC/F,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAO,GAAG,GAAG,IAAI,EAAE,CAAC,CAAC,gCAAgC;AACzF,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAC;AAEzC,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,IAAI,EAAE,oCAAoC;IAC1C,OAAO,EAAE,wCAAwC;IACjD,WAAW,EAAE,kCAAkC;CACvC,CAAC;AAEX,MAAM,CAAC,MAAM,aAAa,GAAkB;IAC1C,OAAO,EAAE,sCAAsC;IAC/C,SAAS,EAAE,uCAAuC;IAClD,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EAAE,uBAAuB;IACpC,SAAS,EAAE,YAAY;CACxB,CAAC"}

package/dist/core/docker.d.ts

@@ -0,0 +1,13 @@
+import { type ServiceStatus, type ServiceName } from './types.js';
+export declare function isDockerRunning(): Promise<boolean>;
+export declare function composeUp(opts: {
+    pull: boolean;
+}): Promise<void>;
+export declare function composeDown(opts: {
+    removeVolumes: boolean;
+}): Promise<void>;
+export declare function composePs(): Promise<ServiceStatus[]>;
+export declare function composeLogs(opts: {
+    service?: ServiceName;
+    lines?: number;
+}): Promise<string>;

package/dist/core/docker.js

@@ -0,0 +1,101 @@
+// src/core/docker.ts
+import { execFile as execFileCb } from 'node:child_process';
+import { DOCKER_COMPOSE_DIR, DOCKER_COMPOSE_FILE } from './config.js';
+import { DevnetError } from './types.js';
+function execFile(cmd, args, opts = {}) {
+    return new Promise((resolve, reject) => {
+        execFileCb(cmd, args, opts, (error, stdout, stderr) => {
+            if (error) {
+                reject(error);
+            }
+            else {
+                resolve({ stdout: stdout, stderr: stderr });
+            }
+        });
+    });
+}
+const COMPOSE_ARGS = [
+    'compose',
+    '-f',
+    `${DOCKER_COMPOSE_DIR}/${DOCKER_COMPOSE_FILE}`,
+];
+const CONTAINER_TO_SERVICE = {
+    'midnight-node': { name: 'node', port: 9944, url: 'http://127.0.0.1:9944' },
+    'midnight-indexer': { name: 'indexer', port: 8088, url: 'http://127.0.0.1:8088/api/v3/graphql' },
+    'midnight-proof-server': { name: 'proof-server', port: 6300, url: 'http://127.0.0.1:6300' },
+};
+export async function isDockerRunning() {
+    try {
+        await execFile('docker', ['info'], { timeout: 5000 });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function assertDocker() {
+    const running = await isDockerRunning();
+    if (!running) {
+        throw new DevnetError('Docker is not running.', 'DOCKER_NOT_RUNNING', 'Please start Docker Desktop.');
+    }
+}
+export async function composeUp(opts) {
+    await assertDocker();
+    if (opts.pull) {
+        await execFile('docker', [...COMPOSE_ARGS, 'pull'], { timeout: 300_000 });
+    }
+    await execFile('docker', [...COMPOSE_ARGS, 'up', '-d', '--wait'], { timeout: 300_000 });
+}
+export async function composeDown(opts) {
+    const args = [...COMPOSE_ARGS, 'down'];
+    if (opts.removeVolumes) {
+        args.push('-v');
+    }
+    await execFile('docker', args, { timeout: 60_000 });
+}
+export async function composePs() {
+    let stdout;
+    try {
+        const result = await execFile('docker', [...COMPOSE_ARGS, 'ps', '--format', 'json'], { timeout: 10_000 });
+        stdout = result.stdout;
+    }
+    catch {
+        return [];
+    }
+    if (!stdout.trim())
+        return [];
+    let containers;
+    try {
+        containers = JSON.parse(stdout);
+    }
+    catch {
+        // docker compose ps --format json may output one JSON object per line
+        containers = stdout
+            .trim()
+            .split('\n')
+            .filter(Boolean)
+            .map((line) => JSON.parse(line));
+    }
+    if (!Array.isArray(containers)) {
+        containers = [containers];
+    }
+    return containers.map((c) => {
+        const svc = CONTAINER_TO_SERVICE[c.Name];
+        return {
+            name: svc?.name ?? c.Name,
+            containerName: c.Name,
+            status: c.State === 'running' ? 'running' : 'stopped',
+            port: svc?.port ?? 0,
+            url: svc?.url ?? '',
+        };
+    });
+}
+export async function composeLogs(opts) {
+    const args = [...COMPOSE_ARGS, 'logs', '--tail', String(opts.lines ?? 50)];
+    if (opts.service) {
+        args.push(opts.service);
+    }
+    const { stdout } = await execFile('docker', args, { timeout: 10_000 });
+    return stdout;
+}
+//# sourceMappingURL=docker.js.map

package/dist/core/docker.js.map

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

package/dist/core/funding.d.ts

@@ -0,0 +1,15 @@
+import type { Logger } from 'pino';
+import type { NetworkConfig, FundedAccount } from './types.js';
+import { type WalletContext } from './wallet.js';
+export declare function setLogger(l: Logger): void;
+/**
+ * Transfer NIGHT tokens using the 4-step recipe pattern:
+ * 1. Build recipe (transferTransaction)
+ * 2. Sign recipe (signRecipe)
+ * 3. Finalize (finalizeRecipe)
+ * 4. Submit (submitTransaction)
+ */
+export declare function transferNight(masterWallet: WalletContext, receiverAddress: string, amount: bigint): Promise<string>;
+export declare function fundAccount(masterWallet: WalletContext, address: string, amount?: bigint): Promise<FundedAccount>;
+export declare function fundAccountFromMnemonic(masterWallet: WalletContext, name: string, mnemonic: string, config: NetworkConfig, amount?: bigint): Promise<FundedAccount>;
+export declare function fundAccountsFromFile(masterWallet: WalletContext, filePath: string, config: NetworkConfig): Promise<FundedAccount[]>;

package/dist/core/funding.js

@@ -0,0 +1,105 @@
+import { readFile } from 'node:fs/promises';
+import * as ledger from '@midnight-ntwrk/ledger-v7';
+import { PublicKey as UnshieldedPublicKey } from '@midnight-ntwrk/wallet-sdk-unshielded-wallet';
+import { DevnetError } from './types.js';
+import { DEFAULT_NIGHT_AMOUNT, MAX_ACCOUNTS_PER_BATCH } from './config.js';
+import { initWalletFromMnemonic, waitForFunds, registerNightForDust, closeWallet, getWalletBalances, } from './wallet.js';
+let logger = null;
+export function setLogger(l) {
+    logger = l;
+}
+/**
+ * Transfer NIGHT tokens using the 4-step recipe pattern:
+ * 1. Build recipe (transferTransaction)
+ * 2. Sign recipe (signRecipe)
+ * 3. Finalize (finalizeRecipe)
+ * 4. Submit (submitTransaction)
+ */
+export async function transferNight(masterWallet, receiverAddress, amount) {
+    logger?.info({ receiverAddress, amount: amount.toString() }, 'Transferring NIGHT...');
+    const ttl = new Date(Date.now() + 30 * 60 * 1000); // 30-minute TTL
+    // Step 1: Build recipe via transferTransaction
+    const recipe = await masterWallet.wallet.transferTransaction([
+        {
+            type: 'unshielded',
+            outputs: [
+                {
+                    type: ledger.nativeToken().raw,
+                    receiverAddress,
+                    amount,
+                },
+            ],
+        },
+    ], {
+        shieldedSecretKeys: masterWallet.shieldedSecretKeys,
+        dustSecretKey: masterWallet.dustSecretKey,
+    }, { ttl });
+    // Step 2: Sign with unshielded keystore
+    const signed = await masterWallet.wallet.signRecipe(recipe, (data) => masterWallet.unshieldedKeystore.signData(data));
+    // Step 3: Finalize
+    const finalized = await masterWallet.wallet.finalizeRecipe(signed);
+    // Step 4: Submit
+    const txHash = await masterWallet.wallet.submitTransaction(finalized);
+    logger?.info({ txHash }, 'Transfer complete');
+    return String(txHash);
+}
+export async function fundAccount(masterWallet, address, amount = DEFAULT_NIGHT_AMOUNT) {
+    // Check master wallet has sufficient balance
+    const balances = await getWalletBalances(masterWallet);
+    if (balances.unshielded < amount) {
+        throw new DevnetError(`Insufficient master wallet balance: ${balances.unshielded} < ${amount}`, 'INSUFFICIENT_BALANCE', 'The master wallet does not have enough NIGHT to fund this account.');
+    }
+    const txHash = await transferNight(masterWallet, address, amount);
+    logger?.info({ address, txHash }, 'Account funded');
+    return {
+        name: address.slice(0, 12) + '...',
+        address,
+        amount,
+        txHash,
+        hasDust: false,
+    };
+}
+export async function fundAccountFromMnemonic(masterWallet, name, mnemonic, config, amount = DEFAULT_NIGHT_AMOUNT) {
+    logger?.info({ name }, 'Deriving wallet from mnemonic...');
+    const recipientCtx = await initWalletFromMnemonic(mnemonic, config);
+    // Get recipient address from unshielded keystore
+    const address = UnshieldedPublicKey.fromKeyStore(recipientCtx.unshieldedKeystore).address;
+    // Transfer NIGHT from master
+    const txHash = await transferNight(masterWallet, address, amount);
+    // Wait for recipient to see funds
+    logger?.info({ name }, 'Waiting for recipient to sync funds...');
+    await waitForFunds(recipientCtx.wallet);
+    // Register DUST
+    const hasDust = await registerNightForDust(recipientCtx);
+    // Close recipient wallet
+    await closeWallet(recipientCtx);
+    return { name, address, amount, txHash, hasDust };
+}
+export async function fundAccountsFromFile(masterWallet, filePath, config) {
+    const raw = await readFile(filePath, 'utf-8');
+    let accountsFile;
+    try {
+        accountsFile = JSON.parse(raw);
+    }
+    catch {
+        throw new DevnetError(`Invalid JSON in accounts file: ${filePath}`, 'INVALID_ACCOUNTS_FILE');
+    }
+    if (!accountsFile.accounts || !Array.isArray(accountsFile.accounts)) {
+        throw new DevnetError('Accounts file must contain an "accounts" array', 'INVALID_ACCOUNTS_FILE');
+    }
+    if (accountsFile.accounts.length > MAX_ACCOUNTS_PER_BATCH) {
+        throw new DevnetError(`Maximum ${MAX_ACCOUNTS_PER_BATCH} accounts per batch. Got ${accountsFile.accounts.length}.`, 'TOO_MANY_ACCOUNTS');
+    }
+    const funded = [];
+    for (const account of accountsFile.accounts) {
+        if (account.mnemonic) {
+            const result = await fundAccountFromMnemonic(masterWallet, account.name, account.mnemonic, config);
+            funded.push(result);
+        }
+        else {
+            throw new DevnetError(`Account "${account.name}" has no mnemonic`, 'INVALID_ACCOUNT_ENTRY');
+        }
+    }
+    return funded;
+}
+//# sourceMappingURL=funding.js.map

package/dist/core/funding.js.map

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

package/dist/core/health.d.ts

@@ -0,0 +1,13 @@
+import type { NetworkConfig } from './types.js';
+export interface ServiceHealth {
+    healthy: boolean;
+    responseTime?: number;
+    error?: string;
+}
+export interface HealthReport {
+    node: ServiceHealth;
+    indexer: ServiceHealth;
+    proofServer: ServiceHealth;
+    allHealthy: boolean;
+}
+export declare function checkAllHealth(config?: NetworkConfig): Promise<HealthReport>;

package/dist/core/health.js

@@ -0,0 +1,34 @@
+import { defaultConfig } from './config.js';
+async function checkEndpoint(url) {
+    const start = Date.now();
+    try {
+        const response = await fetch(url, { signal: AbortSignal.timeout(5000) });
+        return {
+            healthy: response.ok,
+            responseTime: Date.now() - start,
+        };
+    }
+    catch (err) {
+        return {
+            healthy: false,
+            responseTime: Date.now() - start,
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+}
+export async function checkAllHealth(config) {
+    const cfg = config ?? defaultConfig;
+    const indexerOrigin = new URL(cfg.indexer).origin;
+    const [node, indexer, proofServer] = await Promise.all([
+        checkEndpoint(`${cfg.node}/health`),
+        checkEndpoint(`${indexerOrigin}/ready`),
+        checkEndpoint(`${cfg.proofServer}/version`),
+    ]);
+    return {
+        node,
+        indexer,
+        proofServer,
+        allHealthy: node.healthy && indexer.healthy && proofServer.healthy,
+    };
+}
+//# sourceMappingURL=health.js.map

package/dist/core/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../src/core/health.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAgB5C,KAAK,UAAU,aAAa,CAAC,GAAW;IACtC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACzE,OAAO;YACL,OAAO,EAAE,QAAQ,CAAC,EAAE;YACpB,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;SACjC,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,OAAO,EAAE,KAAK;YACd,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;YAChC,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SACxD,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,MAAsB;IACzD,MAAM,GAAG,GAAG,MAAM,IAAI,aAAa,CAAC;IACpC,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;IAClD,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,WAAW,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACrD,aAAa,CAAC,GAAG,GAAG,CAAC,IAAI,SAAS,CAAC;QACnC,aAAa,CAAC,GAAG,aAAa,QAAQ,CAAC;QACvC,aAAa,CAAC,GAAG,GAAG,CAAC,WAAW,UAAU,CAAC;KAC5C,CAAC,CAAC;IAEH,OAAO;QACL,IAAI;QACJ,OAAO;QACP,WAAW;QACX,UAAU,EAAE,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,IAAI,WAAW,CAAC,OAAO;KACnE,CAAC;AACJ,CAAC"}

package/dist/core/logger.d.ts

@@ -0,0 +1,2 @@
+import pino from 'pino';
+export declare function createLogger(level?: string): pino.Logger;

package/dist/core/logger.js

@@ -0,0 +1,16 @@
+// src/core/logger.ts
+import pino from 'pino';
+export function createLogger(level = 'info') {
+    return pino({
+        level,
+        transport: {
+            target: 'pino-pretty',
+            options: {
+                colorize: true,
+                translateTime: 'SYS:standard',
+                ignore: 'pid,hostname',
+            },
+        },
+    });
+}
+//# sourceMappingURL=logger.js.map

package/dist/core/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/core/logger.ts"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,MAAM,UAAU,YAAY,CAAC,QAAgB,MAAM;IACjD,OAAO,IAAI,CAAC;QACV,KAAK;QACL,SAAS,EAAE;YACT,MAAM,EAAE,aAAa;YACrB,OAAO,EAAE;gBACP,QAAQ,EAAE,IAAI;gBACd,aAAa,EAAE,cAAc;gBAC7B,MAAM,EAAE,cAAc;aACvB;SACF;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/core/network-manager.d.ts

@@ -0,0 +1,31 @@
+import type { Logger } from 'pino';
+import type { NetworkConfig, NetworkStatus, ServiceStatus } from './types.js';
+import { type WalletContext } from './wallet.js';
+export declare class NetworkManager {
+    private status;
+    private masterWallet;
+    private logger;
+    readonly config: NetworkConfig;
+    constructor(config?: NetworkConfig);
+    setLogger(l: Logger): void;
+    getStatus(): NetworkStatus;
+    getMasterWallet(): WalletContext | null;
+    detectRunningNetwork(): Promise<void>;
+    ensureWallet(): Promise<WalletContext>;
+    start(opts: {
+        pull: boolean;
+    }): Promise<'started' | 'already-running'>;
+    stop(opts: {
+        removeVolumes: boolean;
+    }): Promise<void>;
+    restart(opts: {
+        pull: boolean;
+        removeVolumes: boolean;
+    }): Promise<void>;
+    getServices(): Promise<ServiceStatus[]>;
+    getLogs(opts: {
+        service?: 'node' | 'indexer' | 'proof-server';
+        lines?: number;
+    }): Promise<string>;
+    shutdown(): Promise<void>;
+}

package/dist/core/network-manager.js

@@ -0,0 +1,101 @@
+import { DevnetError } from './types.js';
+import { defaultConfig } from './config.js';
+import { composeUp, composeDown, composePs, composeLogs } from './docker.js';
+import { initMasterWallet, registerNightForDust, closeWallet, } from './wallet.js';
+export class NetworkManager {
+    status = 'stopped';
+    masterWallet = null;
+    logger = null;
+    config;
+    constructor(config) {
+        this.config = config ?? defaultConfig;
+    }
+    setLogger(l) {
+        this.logger = l;
+    }
+    getStatus() {
+        return this.status;
+    }
+    getMasterWallet() {
+        return this.masterWallet;
+    }
+    async detectRunningNetwork() {
+        try {
+            const services = await composePs();
+            const allRunning = services.length >= 3 &&
+                services.every((s) => s.status === 'running');
+            if (allRunning) {
+                this.logger?.info('Detected running network containers');
+                this.status = 'running';
+            }
+        }
+        catch {
+            // Docker not available or compose not set up — stay stopped
+        }
+    }
+    async ensureWallet() {
+        if (this.status !== 'running') {
+            throw new DevnetError('Network is not running. Call start-network first.', 'NETWORK_NOT_RUNNING');
+        }
+        if (!this.masterWallet) {
+            this.logger?.info('Auto-initializing master wallet...');
+            this.masterWallet = await initMasterWallet(this.config);
+            await registerNightForDust(this.masterWallet);
+        }
+        return this.masterWallet;
+    }
+    async start(opts) {
+        if (this.status === 'running') {
+            return 'already-running';
+        }
+        this.status = 'starting';
+        try {
+            await composeUp({ pull: opts.pull });
+            this.masterWallet = await initMasterWallet(this.config);
+            await registerNightForDust(this.masterWallet);
+            this.status = 'running';
+            this.logger?.info('Network started and master wallet initialized');
+            return 'started';
+        }
+        catch (err) {
+            try {
+                await composeDown({ removeVolumes: false });
+            }
+            catch {
+                // best-effort cleanup
+            }
+            this.status = 'stopped';
+            throw err;
+        }
+    }
+    async stop(opts) {
+        this.status = 'stopping';
+        try {
+            if (this.masterWallet) {
+                await closeWallet(this.masterWallet);
+                this.masterWallet = null;
+            }
+            await composeDown({ removeVolumes: opts.removeVolumes });
+        }
+        finally {
+            this.status = 'stopped';
+        }
+    }
+    async restart(opts) {
+        await this.stop({ removeVolumes: opts.removeVolumes });
+        await this.start({ pull: opts.pull });
+    }
+    async getServices() {
+        return composePs();
+    }
+    async getLogs(opts) {
+        return composeLogs(opts);
+    }
+    async shutdown() {
+        if (this.masterWallet) {
+            await closeWallet(this.masterWallet);
+            this.masterWallet = null;
+        }
+    }
+}
+//# sourceMappingURL=network-manager.js.map

package/dist/core/network-manager.js.map

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

package/dist/core/types.d.ts

@@ -0,0 +1,51 @@
+export interface NetworkConfig {
+    readonly indexer: string;
+    readonly indexerWS: string;
+    readonly node: string;
+    readonly proofServer: string;
+    readonly networkId: string;
+}
+export type NetworkStatus = 'stopped' | 'starting' | 'running' | 'stopping';
+export type ServiceName = 'node' | 'indexer' | 'proof-server';
+export interface ServiceStatus {
+    name: ServiceName;
+    containerName: string;
+    status: 'running' | 'stopped' | 'unhealthy' | 'unknown';
+    port: number;
+    url: string;
+}
+export interface NetworkState {
+    status: NetworkStatus;
+    services: ServiceStatus[];
+}
+export interface WalletBalances {
+    unshielded: bigint;
+    shielded: bigint;
+    dust: bigint;
+    total: bigint;
+}
+export interface FundedAccount {
+    name: string;
+    address: string;
+    amount: bigint;
+    txHash: string;
+    hasDust: boolean;
+}
+export interface GeneratedAccount {
+    name: string;
+    mnemonic?: string;
+    privateKey?: string;
+    address: string;
+}
+export interface AccountsFileFormat {
+    accounts: Array<{
+        name: string;
+        mnemonic?: string;
+        privateKey?: string;
+    }>;
+}
+export declare class DevnetError extends Error {
+    readonly code: string;
+    readonly suggestion?: string | undefined;
+    constructor(message: string, code: string, suggestion?: string | undefined);
+}