@aaronbassett/midnight-local-devnet 0.1.0

package/dist/core/types.js

@@ -0,0 +1,11 @@
+export class DevnetError extends Error {
+    code;
+    suggestion;
+    constructor(message, code, suggestion) {
+        super(message);
+        this.code = code;
+        this.suggestion = suggestion;
+        this.name = 'DevnetError';
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAuDA,MAAM,OAAO,WAAY,SAAQ,KAAK;IAGlB;IACA;IAHlB,YACE,OAAe,EACC,IAAY,EACZ,UAAmB;QAEnC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAAQ;QACZ,eAAU,GAAV,UAAU,CAAS;QAGnC,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF"}

package/dist/core/wallet.d.ts

@@ -0,0 +1,23 @@
+import * as ledger from '@midnight-ntwrk/ledger-v7';
+import { WalletFacade } from '@midnight-ntwrk/wallet-sdk-facade';
+import { type UnshieldedKeystore } from '@midnight-ntwrk/wallet-sdk-unshielded-wallet';
+import { Buffer } from 'buffer';
+import type { NetworkConfig, WalletBalances } from './types.js';
+import type { Logger } from 'pino';
+export interface WalletContext {
+    wallet: WalletFacade;
+    shieldedSecretKeys: ledger.ZswapSecretKeys;
+    dustSecretKey: ledger.DustSecretKey;
+    unshieldedKeystore: UnshieldedKeystore;
+}
+export declare function setLogger(l: Logger): void;
+export declare function generateNewMnemonic(): string;
+export declare function mnemonicToSeed(mnemonic: string): Buffer;
+export declare function initWalletFromSeed(seed: Buffer, config: NetworkConfig): Promise<WalletContext>;
+export declare function initWalletFromMnemonic(mnemonic: string, config: NetworkConfig): Promise<WalletContext>;
+export declare function initMasterWallet(config: NetworkConfig): Promise<WalletContext>;
+export declare function waitForSync(wallet: WalletFacade): Promise<unknown>;
+export declare function waitForFunds(wallet: WalletFacade, timeoutMs?: number): Promise<bigint>;
+export declare function getWalletBalances(ctx: WalletContext): Promise<WalletBalances>;
+export declare function registerNightForDust(ctx: WalletContext): Promise<boolean>;
+export declare function closeWallet(ctx: WalletContext): Promise<void>;

package/dist/core/wallet.js

@@ -0,0 +1,163 @@
+import * as ledger from '@midnight-ntwrk/ledger-v7';
+import { HDWallet, Roles } from '@midnight-ntwrk/wallet-sdk-hd';
+import { WalletFacade } from '@midnight-ntwrk/wallet-sdk-facade';
+import { ShieldedWallet } from '@midnight-ntwrk/wallet-sdk-shielded';
+import { DustWallet } from '@midnight-ntwrk/wallet-sdk-dust-wallet';
+import { createKeystore, InMemoryTransactionHistoryStorage, PublicKey as UnshieldedPublicKey, UnshieldedWallet, } from '@midnight-ntwrk/wallet-sdk-unshielded-wallet';
+import { setNetworkId } from '@midnight-ntwrk/midnight-js-network-id';
+import { generateMnemonic, mnemonicToSeedSync } from '@scure/bip39';
+import { wordlist as english } from '@scure/bip39/wordlists/english.js';
+import * as Rx from 'rxjs';
+import { WebSocket } from 'ws';
+import { Buffer } from 'buffer';
+import { DevnetError } from './types.js';
+import { GENESIS_SEED } from './config.js';
+// Required for wallet SDK WebSocket support (Apollo uses globalThis.WebSocket)
+// @ts-expect-error: Needed to enable WebSocket usage through apollo
+globalThis.WebSocket = WebSocket;
+let logger = null;
+export function setLogger(l) {
+    logger = l;
+}
+// ── Mnemonic / seed helpers ────────────────────────────────────────────────
+export function generateNewMnemonic() {
+    return generateMnemonic(english, 256);
+}
+export function mnemonicToSeed(mnemonic) {
+    return Buffer.from(mnemonicToSeedSync(mnemonic));
+}
+// ── Wallet initialization ──────────────────────────────────────────────────
+export async function initWalletFromSeed(seed, config) {
+    setNetworkId(config.networkId);
+    // 1. HD key derivation (discriminated union — MUST check .type)
+    const hdResult = HDWallet.fromSeed(seed);
+    if (hdResult.type !== 'seedOk') {
+        throw new DevnetError('Failed to initialize HDWallet from seed', 'HD_WALLET_ERROR');
+    }
+    const derivationResult = hdResult.hdWallet
+        .selectAccount(0)
+        .selectRoles([Roles.Zswap, Roles.NightExternal, Roles.Dust])
+        .deriveKeysAt(0);
+    if (derivationResult.type !== 'keysDerived') {
+        throw new DevnetError('Failed to derive wallet keys', 'KEY_DERIVATION_ERROR');
+    }
+    // Zeroize HD wallet memory after derivation
+    hdResult.hdWallet.clear();
+    // 2. Build secret keys / keystore from derived seeds
+    const shieldedSecretKeys = ledger.ZswapSecretKeys.fromSeed(derivationResult.keys[Roles.Zswap]);
+    const dustSecretKey = ledger.DustSecretKey.fromSeed(derivationResult.keys[Roles.Dust]);
+    const unshieldedKeystore = createKeystore(derivationResult.keys[Roles.NightExternal], config.networkId);
+    // 3. Per-wallet configs
+    const relayURL = new URL(config.node.replace(/^http/, 'ws'));
+    // Shielded wallet config: networkId + sync + proving + submission
+    const shieldedConfig = {
+        networkId: config.networkId,
+        indexerClientConnection: {
+            indexerHttpUrl: config.indexer,
+            indexerWsUrl: config.indexerWS,
+        },
+        provingServerUrl: new URL(config.proofServer),
+        relayURL,
+    };
+    // Unshielded wallet config: networkId + sync + transacting + txHistoryStorage
+    const unshieldedConfig = {
+        networkId: config.networkId,
+        indexerClientConnection: {
+            indexerHttpUrl: config.indexer,
+            indexerWsUrl: config.indexerWS,
+        },
+        txHistoryStorage: new InMemoryTransactionHistoryStorage(),
+    };
+    // Dust wallet config: networkId + costParameters + sync + proving + submission
+    const dustConfig = {
+        networkId: config.networkId,
+        costParameters: {
+            additionalFeeOverhead: 300000000000000n,
+            feeBlocksMargin: 5,
+        },
+        indexerClientConnection: {
+            indexerHttpUrl: config.indexer,
+            indexerWsUrl: config.indexerWS,
+        },
+        provingServerUrl: new URL(config.proofServer),
+        relayURL,
+    };
+    // 4. Sub-wallet construction (factory functions, NOT constructors)
+    const shieldedWallet = ShieldedWallet(shieldedConfig).startWithSecretKeys(shieldedSecretKeys);
+    const unshieldedWallet = UnshieldedWallet(unshieldedConfig).startWithPublicKey(UnshieldedPublicKey.fromKeyStore(unshieldedKeystore));
+    const dustWallet = DustWallet(dustConfig).startWithSecretKey(dustSecretKey, ledger.LedgerParameters.initialParameters().dust);
+    // 5. WalletFacade: 3 sub-wallets
+    const wallet = new WalletFacade(shieldedWallet, unshieldedWallet, dustWallet);
+    await wallet.start(shieldedSecretKeys, dustSecretKey);
+    logger?.info('Waiting for wallet to sync...');
+    await waitForSync(wallet);
+    logger?.info('Wallet synced');
+    return { wallet, shieldedSecretKeys, dustSecretKey, unshieldedKeystore };
+}
+export async function initWalletFromMnemonic(mnemonic, config) {
+    const seed = mnemonicToSeed(mnemonic);
+    return initWalletFromSeed(seed, config);
+}
+export async function initMasterWallet(config) {
+    logger?.info('Initializing master wallet from genesis seed...');
+    const seed = Buffer.from(GENESIS_SEED, 'hex');
+    return initWalletFromSeed(seed, config);
+}
+// ── State observation ──────────────────────────────────────────────────────
+export function waitForSync(wallet) {
+    return Rx.firstValueFrom(wallet.state().pipe(Rx.throttleTime(5_000), Rx.tap((state) => {
+        logger?.info(`Waiting for wallet sync. Synced: ${state.isSynced}`);
+    }), Rx.filter((state) => state.isSynced)));
+}
+export function waitForFunds(wallet, timeoutMs = 60_000) {
+    return Rx.firstValueFrom(wallet.state().pipe(Rx.throttleTime(10_000), Rx.tap((state) => {
+        const unshielded = state.unshielded?.balances[ledger.nativeToken().raw] ?? 0n;
+        const shielded = state.shielded?.balances[ledger.nativeToken().raw] ?? 0n;
+        logger?.info(`Waiting for funds. Synced: ${state.isSynced}, Unshielded: ${unshielded}, Shielded: ${shielded}`);
+    }), Rx.filter((state) => state.isSynced), Rx.map((s) => (s.unshielded?.balances[ledger.nativeToken().raw] ?? 0n) +
+        (s.shielded?.balances[ledger.nativeToken().raw] ?? 0n)), Rx.filter((balance) => balance > 0n), Rx.timeout(timeoutMs)));
+}
+export async function getWalletBalances(ctx) {
+    const state = await Rx.firstValueFrom(ctx.wallet.state());
+    const nativeToken = ledger.nativeToken().raw;
+    const unshielded = state.unshielded?.balances[nativeToken] ?? 0n;
+    const shielded = state.shielded?.balances[nativeToken] ?? 0n;
+    const dust = state.dust?.walletBalance(new Date()) ?? 0n;
+    return {
+        unshielded,
+        shielded,
+        dust,
+        total: unshielded + shielded,
+    };
+}
+// ── DUST registration ──────────────────────────────────────────────────────
+export async function registerNightForDust(ctx) {
+    logger?.info('Registering NIGHT UTXOs for DUST generation...');
+    try {
+        const state = await Rx.firstValueFrom(ctx.wallet.state());
+        const unregistered = state.unshielded?.availableCoins?.filter((coin) => !coin.meta?.registeredForDustGeneration);
+        if (!unregistered || unregistered.length === 0) {
+            logger?.info('No unregistered UTXOs found (may already be registered)');
+            return true;
+        }
+        const recipe = await ctx.wallet.registerNightUtxosForDustGeneration(unregistered, UnshieldedPublicKey.fromKeyStore(ctx.unshieldedKeystore).publicKey, (payload) => ctx.unshieldedKeystore.signData(payload));
+        const finalized = await ctx.wallet.finalizeRecipe(recipe);
+        await ctx.wallet.submitTransaction(finalized);
+        logger?.info('DUST registration transaction submitted');
+        return true;
+    }
+    catch (err) {
+        logger?.error({ err }, 'DUST registration failed');
+        return false;
+    }
+}
+// ── Cleanup ────────────────────────────────────────────────────────────────
+export async function closeWallet(ctx) {
+    try {
+        await ctx.wallet.stop();
+    }
+    catch {
+        // Ignore stop errors
+    }
+}
+//# sourceMappingURL=wallet.js.map

package/dist/core/wallet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.js","sourceRoot":"","sources":["../../src/core/wallet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,2BAA2B,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,wCAAwC,CAAC;AACpE,OAAO,EACL,cAAc,EACd,iCAAiC,EACjC,SAAS,IAAI,mBAAmB,EAEhC,gBAAgB,GACjB,MAAM,8CAA8C,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,QAAQ,IAAI,OAAO,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,KAAK,EAAE,MAAM,MAAM,CAAC;AAC3B,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAC/B,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,+EAA+E;AAC/E,oEAAoE;AACpE,UAAU,CAAC,SAAS,GAAG,SAAS,CAAC;AASjC,IAAI,MAAM,GAAkB,IAAI,CAAC;AAEjC,MAAM,UAAU,SAAS,CAAC,CAAS;IACjC,MAAM,GAAG,CAAC,CAAC;AACb,CAAC;AAED,8EAA8E;AAE9E,MAAM,UAAU,mBAAmB;IACjC,OAAO,gBAAgB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,OAAO,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC;AACnD,CAAC;AAED,8EAA8E;AAE9E,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,IAAY,EACZ,MAAqB;IAErB,YAAY,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAE/B,gEAAgE;IAChE,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACzC,IAAI,QAAQ,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC/B,MAAM,IAAI,WAAW,CAAC,yCAAyC,EAAE,iBAAiB,CAAC,CAAC;IACtF,CAAC;IAED,MAAM,gBAAgB,GAAG,QAAQ,CAAC,QAAQ;SACvC,aAAa,CAAC,CAAC,CAAC;SAChB,WAAW,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,aAAa,EAAE,KAAK,CAAC,IAAI,CAAU,CAAC;SACpE,YAAY,CAAC,CAAC,CAAC,CAAC;IAEnB,IAAI,gBAAgB,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;QAC5C,MAAM,IAAI,WAAW,CAAC,8BAA8B,EAAE,sBAAsB,CAAC,CAAC;IAChF,CAAC;IAED,4CAA4C;IAC5C,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IAE1B,qDAAqD;IACrD,MAAM,kBAAkB,GAAG,MAAM,CAAC,eAAe,CAAC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IAC/F,MAAM,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IACvF,MAAM,kBAAkB,GAAG,cAAc,CACvC,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,EAC1C,MAAM,CAAC,SAAgB,CACxB,CAAC;IAEF,wBAAwB;IACxB,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;IAE7D,kEAAkE;IAClE,MAAM,cAAc,GAAG;QACrB,SAAS,EAAE,MAAM,CAAC,SAAgB;QAClC,uBAAuB,EAAE;YACvB,cAAc,EAAE,MAAM,CAAC,OAAO;YAC9B,YAAY,EAAE,MAAM,CAAC,SAAS;SAC/B;QACD,gBAAgB,EAAE,IAAI,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC;QAC7C,QAAQ;KACT,CAAC;IAEF,8EAA8E;IAC9E,MAAM,gBAAgB,GAAG;QACvB,SAAS,EAAE,MAAM,CAAC,SAAgB;QAClC,uBAAuB,EAAE;YACvB,cAAc,EAAE,MAAM,CAAC,OAAO;YAC9B,YAAY,EAAE,MAAM,CAAC,SAAS;SAC/B;QACD,gBAAgB,EAAE,IAAI,iCAAiC,EAAE;KAC1D,CAAC;IAEF,+EAA+E;IAC/E,MAAM,UAAU,GAAG;QACjB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,cAAc,EAAE;YACd,qBAAqB,EAAE,gBAAoB;YAC3C,eAAe,EAAE,CAAC;SACnB;QACD,uBAAuB,EAAE;YACvB,cAAc,EAAE,MAAM,CAAC,OAAO;YAC9B,YAAY,EAAE,MAAM,CAAC,SAAS;SAC/B;QACD,gBAAgB,EAAE,IAAI,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC;QAC7C,QAAQ;KACT,CAAC;IAEF,mEAAmE;IACnE,MAAM,cAAc,GAAG,cAAc,CAAC,cAAqB,CAAC,CAAC,mBAAmB,CAAC,kBAAkB,CAAC,CAAC;IACrG,MAAM,gBAAgB,GAAG,gBAAgB,CAAC,gBAAuB,CAAC,CAAC,kBAAkB,CACnF,mBAAmB,CAAC,YAAY,CAAC,kBAAkB,CAAC,CACrD,CAAC;IACF,MAAM,UAAU,GAAG,UAAU,CAAC,UAAiB,CAAC,CAAC,kBAAkB,CACjE,aAAa,EACb,MAAM,CAAC,gBAAgB,CAAC,iBAAiB,EAAE,CAAC,IAAI,CACjD,CAAC;IAEF,iCAAiC;IACjC,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,cAAc,EAAE,gBAAgB,EAAE,UAAU,CAAC,CAAC;IAC9E,MAAM,MAAM,CAAC,KAAK,CAAC,kBAAkB,EAAE,aAAa,CAAC,CAAC;IAEtD,MAAM,EAAE,IAAI,CAAC,+BAA+B,CAAC,CAAC;IAC9C,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC;IAC1B,MAAM,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;IAE9B,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,aAAa,EAAE,kBAAkB,EAAE,CAAC;AAC3E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,QAAgB,EAChB,MAAqB;IAErB,MAAM,IAAI,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IACtC,OAAO,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAqB;IAC1D,MAAM,EAAE,IAAI,CAAC,iDAAiD,CAAC,CAAC;IAChE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IAC9C,OAAO,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC1C,CAAC;AAED,8EAA8E;AAE9E,MAAM,UAAU,WAAW,CAAC,MAAoB;IAC9C,OAAO,EAAE,CAAC,cAAc,CACtB,MAAM,CAAC,KAAK,EAAE,CAAC,IAAI,CACjB,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,EACtB,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACf,MAAM,EAAE,IAAI,CAAC,oCAAoC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;IACrE,CAAC,CAAC,EACF,EAAE,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CACrC,CACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAoB,EAAE,SAAS,GAAG,MAAM;IACnE,OAAO,EAAE,CAAC,cAAc,CACtB,MAAM,CAAC,KAAK,EAAE,CAAC,IAAI,CACjB,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,EACvB,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACf,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9E,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QAC1E,MAAM,EAAE,IAAI,CACV,8BAA8B,KAAK,CAAC,QAAQ,iBAAiB,UAAU,eAAe,QAAQ,EAAE,CACjG,CAAC;IACJ,CAAC,CAAC,EACF,EAAE,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,EACpC,EAAE,CAAC,GAAG,CACJ,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QACxD,CAAC,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CACzD,EACD,EAAE,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,GAAG,EAAE,CAAC,EACpC,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CACtB,CACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,GAAkB;IACxD,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IAC1D,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC,GAAG,CAAC;IAC7C,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,EAAE,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;IACjE,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,EAAE,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;IAC7D,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,aAAa,CAAC,IAAI,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;IACzD,OAAO;QACL,UAAU;QACV,QAAQ;QACR,IAAI;QACJ,KAAK,EAAE,UAAU,GAAG,QAAQ;KAC7B,CAAC;AACJ,CAAC;AAED,8EAA8E;AAE9E,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,GAAkB;IAC3D,MAAM,EAAE,IAAI,CAAC,gDAAgD,CAAC,CAAC;IAC/D,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QAE1D,MAAM,YAAY,GAAG,KAAK,CAAC,UAAU,EAAE,cAAc,EAAE,MAAM,CAC3D,CAAC,IAAS,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,2BAA2B,CACvD,CAAC;QAEF,IAAI,CAAC,YAAY,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/C,MAAM,EAAE,IAAI,CAAC,yDAAyD,CAAC,CAAC;YACxE,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,mCAAmC,CACjE,YAAY,EACZ,mBAAmB,CAAC,YAAY,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,SAAS,EAClE,CAAC,OAAmB,EAAE,EAAE,CAAC,GAAG,CAAC,kBAAkB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAClE,CAAC;QACF,MAAM,SAAS,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QAC1D,MAAM,GAAG,CAAC,MAAM,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;QAE9C,MAAM,EAAE,IAAI,CAAC,yCAAyC,CAAC,CAAC;QACxD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG,EAAE,EAAE,0BAA0B,CAAC,CAAC;QACnD,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,8EAA8E;AAE9E,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAkB;IAClD,IAAI,CAAC;QACH,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,qBAAqB;IACvB,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,34 @@
+#!/usr/bin/env node
+// src/index.ts
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createServer } from './mcp/server.js';
+import { NetworkManager } from './core/network-manager.js';
+import { createLogger } from './core/logger.js';
+import { setLogger as setWalletLogger } from './core/wallet.js';
+import { setLogger as setFundingLogger } from './core/funding.js';
+import { setLogger as setAccountsLogger } from './core/accounts.js';
+async function main() {
+    const manager = new NetworkManager();
+    const logger = createLogger();
+    setWalletLogger(logger);
+    setFundingLogger(logger);
+    setAccountsLogger(logger);
+    manager.setLogger(logger);
+    // Detect if network is already running (recovers state after restart)
+    await manager.detectRunningNetwork();
+    const server = createServer(manager);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Graceful shutdown: close wallet but leave Docker containers running
+    const shutdown = async () => {
+        await manager.shutdown();
+        process.exit(0);
+    };
+    process.on('SIGINT', shutdown);
+    process.on('SIGTERM', shutdown);
+}
+main().catch((err) => {
+    console.error('Fatal error:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,eAAe;AACf,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,SAAS,IAAI,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,SAAS,IAAI,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,SAAS,IAAI,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEpE,KAAK,UAAU,IAAI;IACjB,MAAM,OAAO,GAAG,IAAI,cAAc,EAAE,CAAC;IAErC,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,eAAe,CAAC,MAAM,CAAC,CAAC;IACxB,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACzB,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAE1B,sEAAsE;IACtE,MAAM,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAErC,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,sEAAsE;IACtE,MAAM,QAAQ,GAAG,KAAK,IAAI,EAAE;QAC1B,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC;QACzB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IACF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;IACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/mcp/resources/config.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { NetworkManager } from '../../core/network-manager.js';
+export declare function registerResources(server: McpServer, manager: NetworkManager): void;

package/dist/mcp/resources/config.js

@@ -0,0 +1,28 @@
+import { DOCKER_IMAGES } from '../../core/config.js';
+export function registerResources(server, manager) {
+    server.resource('devnet-config', 'devnet://config', { description: 'Current network configuration including endpoints and image versions.', mimeType: 'application/json' }, async (uri) => ({
+        contents: [{
+                uri: uri.href,
+                text: JSON.stringify({ ...manager.config, images: DOCKER_IMAGES }, null, 2),
+            }],
+    }));
+    server.resource('devnet-status', 'devnet://status', { description: 'Live network status including services and health.', mimeType: 'application/json' }, async (uri) => {
+        const status = manager.getStatus();
+        let services = [];
+        if (status !== 'stopped') {
+            try {
+                services = await manager.getServices();
+            }
+            catch {
+                // Network might be partially up
+            }
+        }
+        return {
+            contents: [{
+                    uri: uri.href,
+                    text: JSON.stringify({ status, services }, null, 2),
+                }],
+        };
+    });
+}
+//# sourceMappingURL=config.js.map

package/dist/mcp/resources/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/mcp/resources/config.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,MAAM,UAAU,iBAAiB,CAAC,MAAiB,EAAE,OAAuB;IAC1E,MAAM,CAAC,QAAQ,CACb,eAAe,EACf,iBAAiB,EACjB,EAAE,WAAW,EAAE,uEAAuE,EAAE,QAAQ,EAAE,kBAAkB,EAAE,EACtH,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;QACd,QAAQ,EAAE,CAAC;gBACT,GAAG,EAAE,GAAG,CAAC,IAAI;gBACb,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;aAC5E,CAAC;KACH,CAAC,CACH,CAAC;IAEF,MAAM,CAAC,QAAQ,CACb,eAAe,EACf,iBAAiB,EACjB,EAAE,WAAW,EAAE,oDAAoD,EAAE,QAAQ,EAAE,kBAAkB,EAAE,EACnG,KAAK,EAAE,GAAG,EAAE,EAAE;QACZ,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;QACnC,IAAI,QAAQ,GAAc,EAAE,CAAC;QAC7B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,IAAI,CAAC;gBACH,QAAQ,GAAG,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC;YACzC,CAAC;YAAC,MAAM,CAAC;gBACP,gCAAgC;YAClC,CAAC;QACH,CAAC;QACD,OAAO;YACL,QAAQ,EAAE,CAAC;oBACT,GAAG,EAAE,GAAG,CAAC,IAAI;oBACb,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;iBACpD,CAAC;SACH,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/mcp/server.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { NetworkManager } from '../core/network-manager.js';
+export declare function createServer(manager: NetworkManager): McpServer;

package/dist/mcp/server.js

@@ -0,0 +1,28 @@
+// src/mcp/server.ts
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { registerNetworkTools } from './tools/network.js';
+import { registerHealthTools } from './tools/health.js';
+import { registerWalletTools } from './tools/wallet.js';
+import { registerFundingTools } from './tools/funding.js';
+import { registerAccountTools } from './tools/accounts.js';
+import { registerResources } from './resources/config.js';
+export function createServer(manager) {
+    const server = new McpServer({
+        name: 'midnight-local-devnet',
+        version: '0.1.0',
+    }, {
+        capabilities: {
+            logging: {},
+            resources: {},
+            tools: {},
+        },
+    });
+    registerNetworkTools(server, manager);
+    registerHealthTools(server, manager);
+    registerWalletTools(server, manager);
+    registerFundingTools(server, manager);
+    registerAccountTools(server, manager);
+    registerResources(server, manager);
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA,oBAAoB;AACpB,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE1D,MAAM,UAAU,YAAY,CAAC,OAAuB;IAClD,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B;QACE,IAAI,EAAE,uBAAuB;QAC7B,OAAO,EAAE,OAAO;KACjB,EACD;QACE,YAAY,EAAE;YACZ,OAAO,EAAE,EAAE;YACX,SAAS,EAAE,EAAE;YACb,KAAK,EAAE,EAAE;SACV;KACF,CACF,CAAC;IAEF,oBAAoB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,oBAAoB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,oBAAoB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEnC,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/mcp/tools/accounts.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { NetworkManager } from '../../core/network-manager.js';
+export declare function registerAccountTools(server: McpServer, manager: NetworkManager): void;

package/dist/mcp/tools/accounts.js

@@ -0,0 +1,28 @@
+// src/mcp/tools/accounts.ts
+import { z } from 'zod';
+import { generateAccounts, generateAndFundAccounts, writeAccountsFile } from '../../core/accounts.js';
+export function registerAccountTools(server, manager) {
+    server.tool('generate-test-account', 'Generate random test accounts with BIP39 mnemonics or private keys. Optionally fund and register DUST.', {
+        format: z.enum(['mnemonic', 'privateKey']).describe('Credential format'),
+        count: z.number().optional().describe('Number of accounts (default: 1)'),
+        fund: z.boolean().optional().describe('Fund accounts from master wallet'),
+        registerDust: z.boolean().optional().describe('Register DUST for funded accounts'),
+        outputFile: z.string().optional().describe('Write accounts to file'),
+    }, async ({ format, count, fund, registerDust: regDust, outputFile }) => {
+        let accounts;
+        if (fund) {
+            const wallet = await manager.ensureWallet();
+            accounts = await generateAndFundAccounts(wallet, manager.config, { format, count, fund: true, registerDust: regDust });
+        }
+        else {
+            accounts = await generateAccounts({ format, count });
+        }
+        if (outputFile) {
+            await writeAccountsFile(outputFile, accounts);
+        }
+        return {
+            content: [{ type: 'text', text: JSON.stringify(accounts, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=accounts.js.map

package/dist/mcp/tools/accounts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accounts.js","sourceRoot":"","sources":["../../../src/mcp/tools/accounts.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAC5B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEtG,MAAM,UAAU,oBAAoB,CAAC,MAAiB,EAAE,OAAuB;IAC7E,MAAM,CAAC,IAAI,CACT,uBAAuB,EACvB,wGAAwG,EACxG;QACE,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC;QACxE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;QACxE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;QACzE,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;QAClF,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;KACrE,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE;QACnE,IAAI,QAAQ,CAAC;QAEb,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,YAAY,EAAE,CAAC;YAC5C,QAAQ,GAAG,MAAM,uBAAuB,CACtC,MAAM,EACN,OAAO,CAAC,MAAM,EACd,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,CACrD,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,QAAQ,GAAG,MAAM,gBAAgB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QACvD,CAAC;QAED,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,iBAAiB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAChD,CAAC;QAED,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SAC9E,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/mcp/tools/funding.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { NetworkManager } from '../../core/network-manager.js';
+export declare function registerFundingTools(server: McpServer, manager: NetworkManager): void;

package/dist/mcp/tools/funding.js

@@ -0,0 +1,59 @@
+// src/mcp/tools/funding.ts
+import { z } from 'zod';
+import { fundAccount, fundAccountFromMnemonic, fundAccountsFromFile } from '../../core/funding.js';
+export function registerFundingTools(server, manager) {
+    server.tool('fund-account', 'Transfer NIGHT tokens from master wallet to a Bech32 address. Default: 50,000 NIGHT.', {
+        address: z.string().describe('Bech32 address to fund'),
+        amount: z.string().optional().describe('Amount in smallest unit (default: 50,000 NIGHT)'),
+    }, async ({ address, amount }) => {
+        const wallet = await manager.ensureWallet();
+        const result = await fundAccount(wallet, address, amount ? BigInt(amount) : undefined);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        address: result.address,
+                        amount: result.amount.toString(),
+                        txHash: result.txHash,
+                        hasDust: result.hasDust,
+                    }, null, 2),
+                }],
+        };
+    });
+    server.tool('fund-account-from-mnemonic', 'Derive wallet from mnemonic, transfer NIGHT, and register DUST. Full account setup.', {
+        name: z.string().describe('Display name for the account'),
+        mnemonic: z.string().describe('BIP39 mnemonic phrase (24 words)'),
+    }, async ({ name, mnemonic }) => {
+        const wallet = await manager.ensureWallet();
+        const result = await fundAccountFromMnemonic(wallet, name, mnemonic, manager.config);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        name: result.name,
+                        address: result.address,
+                        amount: result.amount.toString(),
+                        txHash: result.txHash,
+                        hasDust: result.hasDust,
+                    }, null, 2),
+                }],
+        };
+    });
+    server.tool('fund-accounts-from-file', 'Batch fund accounts from an accounts.json file. Each gets 50,000 NIGHT + DUST.', { filePath: z.string().describe('Path to accounts.json file') }, async ({ filePath }) => {
+        const wallet = await manager.ensureWallet();
+        const results = await fundAccountsFromFile(wallet, filePath, manager.config);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify(results.map((r) => ({
+                        name: r.name,
+                        address: r.address,
+                        amount: r.amount.toString(),
+                        txHash: r.txHash,
+                        hasDust: r.hasDust,
+                    })), null, 2),
+                }],
+        };
+    });
+}
+//# sourceMappingURL=funding.js.map

package/dist/mcp/tools/funding.js.map

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

package/dist/mcp/tools/health.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { NetworkManager } from '../../core/network-manager.js';
+export declare function registerHealthTools(server: McpServer, manager: NetworkManager): void;

package/dist/mcp/tools/health.js

@@ -0,0 +1,19 @@
+import { checkAllHealth } from '../../core/health.js';
+import { DOCKER_IMAGES } from '../../core/config.js';
+export function registerHealthTools(server, manager) {
+    server.tool('health-check', 'Check health of all network services by hitting their endpoints.', {}, async () => {
+        const health = await checkAllHealth(manager.config);
+        return {
+            content: [{ type: 'text', text: JSON.stringify(health, null, 2) }],
+        };
+    });
+    server.tool('get-network-config', 'Get all endpoint URLs, network ID, and Docker image versions for connecting a DApp.', {}, async () => {
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ ...manager.config, images: DOCKER_IMAGES }, null, 2),
+                }],
+        };
+    });
+}
+//# sourceMappingURL=health.js.map

package/dist/mcp/tools/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../../src/mcp/tools/health.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,MAAM,UAAU,mBAAmB,CAAC,MAAiB,EAAE,OAAuB;IAC5E,MAAM,CAAC,IAAI,CACT,cAAc,EACd,kEAAkE,EAClE,EAAE,EACF,KAAK,IAAI,EAAE;QACT,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACpD,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SAC5E,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,oBAAoB,EACpB,qFAAqF,EACrF,EAAE,EACF,KAAK,IAAI,EAAE;QACT,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;iBAC5E,CAAC;SACH,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/mcp/tools/network.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { NetworkManager } from '../../core/network-manager.js';
+export declare function registerNetworkTools(server: McpServer, manager: NetworkManager): void;

package/dist/mcp/tools/network.js

@@ -0,0 +1,64 @@
+// src/mcp/tools/network.ts
+import { z } from 'zod';
+export function registerNetworkTools(server, manager) {
+    server.tool('start-network', 'Start the local Midnight development network (node, indexer, proof-server). Initializes the genesis master wallet and registers DUST.', { pull: z.boolean().optional().describe('Pull latest Docker images before starting') }, async ({ pull }) => {
+        const result = await manager.start({ pull: pull ?? false });
+        if (result === 'already-running') {
+            return { content: [{ type: 'text', text: 'Network is already running.' }] };
+        }
+        const services = await manager.getServices();
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        status: 'running',
+                        services: services.map((s) => ({ name: s.name, url: s.url, port: s.port })),
+                        config: manager.config,
+                    }, null, 2),
+                }],
+        };
+    });
+    server.tool('stop-network', 'Stop the local Midnight development network and close all wallets.', { removeVolumes: z.boolean().optional().describe('Remove volumes (clean slate)') }, async ({ removeVolumes }) => {
+        await manager.stop({ removeVolumes: removeVolumes ?? false });
+        return { content: [{ type: 'text', text: 'Network stopped.' }] };
+    });
+    server.tool('restart-network', 'Restart the network. With removeVolumes, performs a clean-slate restart.', {
+        pull: z.boolean().optional().describe('Pull latest Docker images'),
+        removeVolumes: z.boolean().optional().describe('Remove volumes for clean restart'),
+    }, async ({ pull, removeVolumes }) => {
+        await manager.restart({
+            pull: pull ?? false,
+            removeVolumes: removeVolumes ?? false,
+        });
+        const services = await manager.getServices();
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        status: 'running',
+                        services: services.map((s) => ({ name: s.name, url: s.url, port: s.port })),
+                    }, null, 2),
+                }],
+        };
+    });
+    server.tool('network-status', 'Get current network status including per-service container status.', {}, async () => {
+        const status = manager.getStatus();
+        if (status === 'stopped') {
+            return {
+                content: [{ type: 'text', text: JSON.stringify({ status: 'stopped', services: [] }) }],
+            };
+        }
+        const services = await manager.getServices();
+        return {
+            content: [{ type: 'text', text: JSON.stringify({ status, services }, null, 2) }],
+        };
+    });
+    server.tool('network-logs', 'Get recent logs from network services.', {
+        service: z.enum(['node', 'indexer', 'proof-server']).optional().describe('Specific service'),
+        lines: z.number().optional().describe('Number of log lines (default: 50)'),
+    }, async ({ service, lines }) => {
+        const logs = await manager.getLogs({ service, lines });
+        return { content: [{ type: 'text', text: logs }] };
+    });
+}
+//# sourceMappingURL=network.js.map

package/dist/mcp/tools/network.js.map

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

package/dist/mcp/tools/wallet.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { NetworkManager } from '../../core/network-manager.js';
+export declare function registerWalletTools(server: McpServer, manager: NetworkManager): void;

package/dist/mcp/tools/wallet.js

@@ -0,0 +1,19 @@
+import { getWalletBalances } from '../../core/wallet.js';
+export function registerWalletTools(server, manager) {
+    server.tool('get-wallet-balances', 'Get current NIGHT and DUST balances of the genesis master wallet.', {}, async () => {
+        const wallet = await manager.ensureWallet();
+        const balances = await getWalletBalances(wallet);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        unshielded: balances.unshielded.toString(),
+                        shielded: balances.shielded.toString(),
+                        dust: balances.dust.toString(),
+                        total: balances.total.toString(),
+                    }, null, 2),
+                }],
+        };
+    });
+}
+//# sourceMappingURL=wallet.js.map

package/dist/mcp/tools/wallet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.js","sourceRoot":"","sources":["../../../src/mcp/tools/wallet.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD,MAAM,UAAU,mBAAmB,CAAC,MAAiB,EAAE,OAAuB;IAC5E,MAAM,CAAC,IAAI,CACT,qBAAqB,EACrB,mEAAmE,EACnE,EAAE,EACF,KAAK,IAAI,EAAE;QACT,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,YAAY,EAAE,CAAC;QAC5C,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,MAAM,CAAC,CAAC;QACjD,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,UAAU,EAAE,QAAQ,CAAC,UAAU,CAAC,QAAQ,EAAE;wBAC1C,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE;wBACtC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE;wBAC9B,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,QAAQ,EAAE;qBACjC,EAAE,IAAI,EAAE,CAAC,CAAC;iBACZ,CAAC;SACH,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/docker/standalone.env

@@ -0,0 +1,5 @@
+APP__INFRA__NODE__URL=ws://node:9944
+APP__INFRA__STORAGE__PASSWORD=indexer
+APP__INFRA__PUB_SUB__PASSWORD=indexer
+APP__INFRA__LEDGER_STATE_STORAGE__PASSWORD=indexer
+APP__INFRA__SECRET=303132333435363738393031323334353637383930313233343536373839303132