@no-witness-labs/midday-sdk 0.1.1 → 0.2.0

package/dist/devnet/Cluster.js

@@ -0,0 +1,487 @@
+/**
+ * DevNet cluster orchestration.
+ *
+ * Manages the lifecycle of a complete Midnight development environment
+ * consisting of a node, indexer, and proof server.
+ *
+ * ## API Design
+ *
+ * This module uses an **instance-based pattern**:
+ *
+ * - **Stateful**: A Cluster holds references to Docker containers
+ * - **Instance methods**: `cluster.start()`, `cluster.stop()`, etc.
+ * - **Effect-first**: Internal implementation uses Effect
+ * - **Promise wrapper**: `.effect` namespace exposes raw Effects
+ *
+ * ### Usage Patterns
+ *
+ * ```typescript
+ * // Promise user (majority)
+ * const cluster = await Cluster.make();
+ * await cluster.start();           // instance method
+ * const config = cluster.networkConfig;  // accessor
+ * await cluster.stop();
+ *
+ * // Effect user (composable)
+ * const cluster = yield* Cluster.effect.make();
+ * yield* cluster.effect.start();   // raw Effect access
+ *
+ * // Effect DI user (dependency injection)
+ * const cluster = yield* ClusterService;
+ * yield* cluster.effect.start();
+ * // provide with: Effect.provide(Cluster.Live) or Cluster.layer({ ... })
+ * ```
+ *
+ * @since 0.2.0
+ * @module
+ */
+import { Context, Effect, Layer } from 'effect';
+import * as Config from './Config.js';
+import * as Container from './Container.js';
+import * as Health from './Health.js';
+import { ClusterError } from './errors.js';
+/**
+ * Context.Tag for ClusterService dependency injection.
+ *
+ * Yields a Cluster instance directly. Use `Cluster.layer()` to provide
+ * with custom configuration.
+ *
+ * @example
+ * ```typescript
+ * import { Effect } from 'effect';
+ * import { Cluster, ClusterService } from '@no-witness-labs/midday-sdk/devnet';
+ *
+ * const program = Effect.gen(function* () {
+ *   const cluster = yield* ClusterService;
+ *   yield* cluster.effect.start();
+ *   return cluster.networkConfig;
+ * });
+ *
+ * // With default config
+ * await Effect.runPromise(program.pipe(Effect.provide(Cluster.Live)));
+ *
+ * // With custom config
+ * await Effect.runPromise(program.pipe(
+ *   Effect.provide(Cluster.layer({ clusterName: 'my-devnet' }))
+ * ));
+ * ```
+ *
+ * @since 0.2.0
+ * @category service
+ */
+export class ClusterService extends Context.Tag('ClusterService')() {
+}
+// =============================================================================
+// Internal Effect Implementations
+// =============================================================================
+/**
+ * Internal Effect implementation for creating a cluster.
+ * @internal
+ */
+const makeEffect = (config = {}) => Effect.gen(function* () {
+    // Resolve configuration with defaults
+    const fullConfig = {
+        clusterName: config.clusterName ?? Config.DEFAULT_DEVNET_CONFIG.clusterName,
+        node: {
+            ...Config.DEFAULT_NODE_CONFIG,
+            ...config.node,
+        },
+        indexer: {
+            ...Config.DEFAULT_INDEXER_CONFIG,
+            ...config.indexer,
+        },
+        proofServer: {
+            ...Config.DEFAULT_PROOF_SERVER_CONFIG,
+            ...config.proofServer,
+        },
+    };
+    // Clean up existing containers
+    const containerNames = [
+        `${fullConfig.clusterName}-node`,
+        `${fullConfig.clusterName}-indexer`,
+        `${fullConfig.clusterName}-proof-server`,
+    ];
+    yield* Effect.tryPromise({
+        try: async () => {
+            for (const name of containerNames) {
+                try {
+                    await Container.removeByName(name);
+                }
+                catch {
+                    // Ignore cleanup errors
+                }
+            }
+        },
+        catch: (cause) => new ClusterError({ operation: 'cleanup', cause }),
+    });
+    // Create node first (indexer depends on it via Docker links)
+    const nodeContainer = yield* Effect.tryPromise({
+        try: () => Container.createNode(fullConfig),
+        catch: (cause) => new ClusterError({ operation: 'create', cause }),
+    });
+    // Create indexer and proof server in parallel (both depend on node existing)
+    const [indexerContainer, proofServerContainer] = yield* Effect.all([
+        Effect.tryPromise({
+            try: () => Container.createIndexer(fullConfig),
+            catch: (cause) => new ClusterError({ operation: 'create', cause }),
+        }),
+        Effect.tryPromise({
+            try: () => Container.createProofServer(fullConfig),
+            catch: (cause) => new ClusterError({ operation: 'create', cause }),
+        }),
+    ], { concurrency: 2 });
+    const data = {
+        node: {
+            id: nodeContainer.id,
+            name: `${fullConfig.clusterName}-node`,
+        },
+        indexer: {
+            id: indexerContainer.id,
+            name: `${fullConfig.clusterName}-indexer`,
+        },
+        proofServer: {
+            id: proofServerContainer.id,
+            name: `${fullConfig.clusterName}-proof-server`,
+        },
+        config: fullConfig,
+    };
+    // Create instance with bound methods
+    const cluster = {
+        ...data,
+        networkConfig: Config.toNetworkConfig({
+            node: fullConfig.node.port,
+            indexer: fullConfig.indexer.port,
+            proofServer: fullConfig.proofServer.port,
+        }),
+        // Promise lifecycle methods
+        start: () => Effect.runPromise(startEffect(data)),
+        stop: () => Effect.runPromise(stopEffect(data)),
+        remove: () => Effect.runPromise(removeEffect(data)),
+        isRunning: () => isRunningImpl(data),
+        // Effect namespace
+        effect: {
+            start: () => startEffect(data),
+            stop: () => stopEffect(data),
+            remove: () => removeEffect(data),
+        },
+    };
+    return cluster;
+});
+/**
+ * Internal Effect implementation for starting a cluster.
+ * @internal
+ */
+const startEffect = (data) => Effect.gen(function* () {
+    // Start node first
+    yield* Effect.tryPromise({
+        try: () => Container.start(data.node),
+        catch: (cause) => new ClusterError({
+            operation: 'start',
+            cluster: data.node.name,
+            cause,
+        }),
+    });
+    // Wait for node to be ready
+    yield* Effect.tryPromise({
+        try: () => Health.waitForNode(data.config.node.port),
+        catch: (cause) => new ClusterError({
+            operation: 'start',
+            cluster: data.node.name,
+            cause,
+        }),
+    });
+    // Start indexer (depends on node)
+    yield* Effect.tryPromise({
+        try: () => Container.start(data.indexer),
+        catch: (cause) => new ClusterError({
+            operation: 'start',
+            cluster: data.indexer.name,
+            cause,
+        }),
+    });
+    // Wait for indexer to be ready
+    yield* Effect.tryPromise({
+        try: () => Health.waitForIndexer(data.config.indexer.port),
+        catch: (cause) => new ClusterError({
+            operation: 'start',
+            cluster: data.indexer.name,
+            cause,
+        }),
+    });
+    // Start proof server (independent)
+    yield* Effect.tryPromise({
+        try: () => Container.start(data.proofServer),
+        catch: (cause) => new ClusterError({
+            operation: 'start',
+            cluster: data.proofServer.name,
+            cause,
+        }),
+    });
+    // Wait for proof server to be ready
+    yield* Effect.tryPromise({
+        try: () => Health.waitForProofServer(data.config.proofServer.port),
+        catch: (cause) => new ClusterError({
+            operation: 'start',
+            cluster: data.proofServer.name,
+            cause,
+        }),
+    });
+});
+/**
+ * Internal Effect implementation for stopping a cluster.
+ * @internal
+ */
+const stopEffect = (data) => Effect.gen(function* () {
+    // Stop in reverse order, collecting errors but continuing
+    yield* Effect.all([
+        Effect.tryPromise({
+            try: () => Container.stop(data.proofServer),
+            catch: (cause) => new ClusterError({
+                operation: 'stop',
+                cluster: data.proofServer.name,
+                cause,
+            }),
+        }).pipe(Effect.either),
+        Effect.tryPromise({
+            try: () => Container.stop(data.indexer),
+            catch: (cause) => new ClusterError({
+                operation: 'stop',
+                cluster: data.indexer.name,
+                cause,
+            }),
+        }).pipe(Effect.either),
+        Effect.tryPromise({
+            try: () => Container.stop(data.node),
+            catch: (cause) => new ClusterError({
+                operation: 'stop',
+                cluster: data.node.name,
+                cause,
+            }),
+        }).pipe(Effect.either),
+    ], { concurrency: 3 });
+});
+/**
+ * Internal Effect implementation for removing a cluster.
+ * @internal
+ */
+const removeEffect = (data) => Effect.gen(function* () {
+    // Remove in reverse order, collecting errors but continuing
+    yield* Effect.all([
+        Effect.tryPromise({
+            try: () => Container.remove(data.proofServer),
+            catch: (cause) => new ClusterError({
+                operation: 'remove',
+                cluster: data.proofServer.name,
+                cause,
+            }),
+        }).pipe(Effect.either),
+        Effect.tryPromise({
+            try: () => Container.remove(data.indexer),
+            catch: (cause) => new ClusterError({
+                operation: 'remove',
+                cluster: data.indexer.name,
+                cause,
+            }),
+        }).pipe(Effect.either),
+        Effect.tryPromise({
+            try: () => Container.remove(data.node),
+            catch: (cause) => new ClusterError({
+                operation: 'remove',
+                cluster: data.node.name,
+                cause,
+            }),
+        }).pipe(Effect.either),
+    ], { concurrency: 3 });
+});
+// =============================================================================
+// Promise API (Default)
+// =============================================================================
+/**
+ * Create a new DevNet cluster instance.
+ *
+ * Returns a cluster with bound lifecycle methods.
+ * This creates the containers but does not start them.
+ *
+ * @example
+ * ```typescript
+ * import { Cluster } from '@no-witness-labs/midday-sdk/devnet';
+ *
+ * const cluster = await Cluster.make();
+ * await cluster.start();
+ *
+ * // Access network config directly
+ * const client = await Midday.Client.create({
+ *   networkConfig: cluster.networkConfig,
+ *   seed: 'your-wallet-seed',
+ * });
+ *
+ * // ... run tests ...
+ *
+ * await cluster.remove();
+ * ```
+ *
+ * @since 0.2.0
+ * @category constructors
+ */
+export const make = (config) => Effect.runPromise(makeEffect(config));
+/**
+ * Internal implementation for checking if a cluster is running.
+ * @internal
+ */
+const isRunningImpl = async (data) => {
+    const [nodeRunning, indexerRunning, proofServerRunning] = await Promise.all([
+        Container.isRunning(data.node),
+        Container.isRunning(data.indexer),
+        Container.isRunning(data.proofServer),
+    ]);
+    return nodeRunning && indexerRunning && proofServerRunning;
+};
+/**
+ * Get the network configuration for use with midday-sdk client.
+ *
+ * @deprecated Prefer using `cluster.networkConfig` property instead.
+ *
+ * @since 0.2.0
+ * @category utilities
+ */
+export const toNetworkConfig = (cluster) => Config.toNetworkConfig({
+    node: cluster.config.node.port,
+    indexer: cluster.config.indexer.port,
+    proofServer: cluster.config.proofServer.port,
+});
+/**
+ * Helper function to run code with an automatically managed cluster.
+ * The cluster is created, started, and cleaned up automatically.
+ *
+ * @example
+ * ```typescript
+ * import { Cluster } from '@no-witness-labs/midday-sdk/devnet';
+ *
+ * await Cluster.withCluster(async (cluster) => {
+ *   // Use cluster.networkConfig directly
+ *   const config = cluster.networkConfig;
+ *   // Your code here - cluster will be cleaned up automatically
+ *   return config;
+ * });
+ * ```
+ *
+ * @since 0.2.0
+ * @category utilities
+ */
+export const withCluster = async (fn, config) => {
+    const cluster = await make(config);
+    try {
+        await cluster.start();
+        return await fn(cluster);
+    }
+    finally {
+        await cluster.remove();
+    }
+};
+// =============================================================================
+// Effect Namespace (Advanced)
+// =============================================================================
+/**
+ * Effect API for advanced users who want full composability,
+ * type-safe errors, retries, and other Effect benefits.
+ *
+ * @example
+ * ```typescript
+ * import { Effect } from 'effect';
+ * import { Cluster } from '@no-witness-labs/midday-sdk/devnet';
+ *
+ * const program = Effect.gen(function* () {
+ *   const cluster = yield* Cluster.effect.make();
+ *   yield* cluster.effect.start();  // Use instance method
+ *   return cluster;
+ * }).pipe(
+ *   Effect.retry({ times: 3 }),
+ *   Effect.timeout('5 minutes')
+ * );
+ *
+ * await Effect.runPromise(program);
+ * ```
+ *
+ * @since 0.2.0
+ * @category effect
+ */
+export const effect = {
+    /**
+     * Create a cluster instance (returns raw Effect).
+     *
+     * The returned cluster has an `.effect` namespace for lifecycle methods.
+     *
+     * @since 0.2.0
+     */
+    make: makeEffect,
+    /**
+     * Run code with an automatically managed cluster (returns raw Effect).
+     *
+     * @example
+     * ```typescript
+     * import { Effect } from 'effect';
+     * import { Cluster } from '@no-witness-labs/midday-sdk/devnet';
+     *
+     * const program = Cluster.effect.withCluster((cluster) =>
+     *   Effect.gen(function* () {
+     *     const config = cluster.networkConfig;
+     *     return config;
+     *   })
+     * );
+     *
+     * await Effect.runPromise(program);
+     * ```
+     *
+     * @since 0.2.0
+     */
+    withCluster: (fn, config) => Effect.gen(function* () {
+        const cluster = yield* makeEffect(config);
+        yield* cluster.effect.start();
+        return yield* fn(cluster).pipe(Effect.ensuring(cluster.effect.remove().pipe(Effect.ignore)));
+    }),
+};
+/**
+ * Create a Layer that provides ClusterService with custom configuration.
+ *
+ * @example
+ * ```typescript
+ * import { Effect } from 'effect';
+ * import { Cluster, ClusterService } from '@no-witness-labs/midday-sdk/devnet';
+ *
+ * const program = Effect.gen(function* () {
+ *   const cluster = yield* ClusterService;
+ *   yield* cluster.effect.start();
+ *   return cluster;
+ * });
+ *
+ * await Effect.runPromise(program.pipe(
+ *   Effect.provide(Cluster.layer({ clusterName: 'my-devnet' }))
+ * ));
+ * ```
+ *
+ * @since 0.2.0
+ * @category layer
+ */
+export const layer = (config) => Layer.effect(ClusterService, makeEffect(config));
+/**
+ * Live Layer for ClusterService with default configuration.
+ *
+ * @example
+ * ```typescript
+ * import { Effect } from 'effect';
+ * import { Cluster, ClusterService } from '@no-witness-labs/midday-sdk/devnet';
+ *
+ * const program = Effect.gen(function* () {
+ *   const cluster = yield* ClusterService;
+ *   yield* cluster.effect.start();
+ *   return cluster;
+ * });
+ *
+ * await Effect.runPromise(program.pipe(Effect.provide(Cluster.Live)));
+ * ```
+ *
+ * @since 0.2.0
+ * @category layer
+ */
+export const Live = layer();
+//# sourceMappingURL=Cluster.js.map

package/dist/devnet/Cluster.js.map

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

package/dist/devnet/Config.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Configuration for Midnight DevNet.
+ *
+ * @since 0.2.0
+ * @module
+ */
+import type { NetworkConfig } from '../Config.js';
+/**
+ * Configuration for the Midnight node container.
+ *
+ * @since 0.2.0
+ * @category model
+ */
+export interface NodeConfig {
+    readonly image?: string;
+    readonly port?: number;
+    /** Node configuration preset (default: 'dev') */
+    readonly cfgPreset?: string;
+}
+/**
+ * Configuration for the indexer container.
+ *
+ * @since 0.2.0
+ * @category model
+ */
+export interface IndexerConfig {
+    readonly image?: string;
+    readonly port?: number;
+    readonly logLevel?: string;
+}
+/**
+ * Configuration for the proof server container.
+ *
+ * @since 0.2.0
+ * @category model
+ */
+export interface ProofServerConfig {
+    readonly image?: string;
+    readonly port?: number;
+    /** Path to ZK params directory on host */
+    readonly zkParamsPath?: string;
+}
+/**
+ * Configuration interface for Midnight DevNet setup.
+ * All properties are optional, with sensible defaults provided.
+ *
+ * @since 0.2.0
+ * @category model
+ */
+export interface DevNetConfig {
+    /** Unique name for this cluster (default: 'midday-devnet') */
+    readonly clusterName?: string;
+    /** Node configuration */
+    readonly node?: NodeConfig;
+    /** Indexer configuration */
+    readonly indexer?: IndexerConfig;
+    /** Proof server configuration */
+    readonly proofServer?: ProofServerConfig;
+}
+/**
+ * Fully resolved DevNet configuration with all defaults applied.
+ *
+ * @since 0.2.0
+ * @category model
+ */
+export interface ResolvedDevNetConfig {
+    readonly clusterName: string;
+    readonly node: Required<NodeConfig>;
+    readonly indexer: Required<IndexerConfig>;
+    readonly proofServer: Required<ProofServerConfig>;
+}
+/**
+ * Default Midnight node configuration.
+ *
+ * @since 0.2.0
+ * @category constants
+ */
+export declare const DEFAULT_NODE_CONFIG: Required<NodeConfig>;
+/**
+ * Default indexer configuration.
+ *
+ * @since 0.2.0
+ * @category constants
+ */
+export declare const DEFAULT_INDEXER_CONFIG: Required<IndexerConfig>;
+/**
+ * Default proof server configuration.
+ *
+ * @since 0.2.0
+ * @category constants
+ */
+export declare const DEFAULT_PROOF_SERVER_CONFIG: Required<ProofServerConfig>;
+/**
+ * Default DevNet configuration.
+ *
+ * @since 0.2.0
+ * @category constants
+ */
+export declare const DEFAULT_DEVNET_CONFIG: Required<DevNetConfig>;
+/**
+ * Indexer secret for local development (matches docker-compose).
+ * DO NOT use in production.
+ *
+ * @since 0.2.0
+ * @category constants
+ */
+export declare const DEV_INDEXER_SECRET = "303132333435363738393031323334353637383930313233343536373839303132";
+/**
+ * Convert cluster ports to a NetworkConfig compatible with midday-sdk.
+ *
+ * @since 0.2.0
+ * @category utilities
+ */
+export declare function toNetworkConfig(ports: {
+    node: number;
+    indexer: number;
+    proofServer: number;
+}): NetworkConfig;
+//# sourceMappingURL=Config.d.ts.map

package/dist/devnet/Config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Config.d.ts","sourceRoot":"","sources":["../../src/devnet/Config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,iDAAiD;IACjD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,0CAA0C;IAC1C,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,8DAA8D;IAC9D,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,yBAAyB;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC;IAC3B,4BAA4B;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC;IACjC,iCAAiC;IACjC,QAAQ,CAAC,WAAW,CAAC,EAAE,iBAAiB,CAAC;CAC1C;AAED;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,iBAAiB,CAAC,CAAC;CACnD;AAED;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,UAAU,CAI3C,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAAC,aAAa,CAIjD,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,EAAE,QAAQ,CAAC,iBAAiB,CAI1D,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,YAAY,CAK/C,CAAC;AAEX;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,uEACuC,CAAC;AAEvE;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB,GAAG,aAAa,CAQhB"}

package/dist/devnet/Config.js

@@ -0,0 +1,75 @@
+/**
+ * Configuration for Midnight DevNet.
+ *
+ * @since 0.2.0
+ * @module
+ */
+/**
+ * Default Midnight node configuration.
+ *
+ * @since 0.2.0
+ * @category constants
+ */
+export const DEFAULT_NODE_CONFIG = {
+    image: 'midnightntwrk/midnight-node:0.18.0',
+    port: 9944,
+    cfgPreset: 'dev',
+};
+/**
+ * Default indexer configuration.
+ *
+ * @since 0.2.0
+ * @category constants
+ */
+export const DEFAULT_INDEXER_CONFIG = {
+    image: 'midnightntwrk/indexer-standalone:3.0.0-alpha.20',
+    port: 8088,
+    logLevel: 'info',
+};
+/**
+ * Default proof server configuration.
+ *
+ * @since 0.2.0
+ * @category constants
+ */
+export const DEFAULT_PROOF_SERVER_CONFIG = {
+    image: 'bricktowers/proof-server:6.1.0-alpha.6',
+    port: 6300,
+    zkParamsPath: '',
+};
+/**
+ * Default DevNet configuration.
+ *
+ * @since 0.2.0
+ * @category constants
+ */
+export const DEFAULT_DEVNET_CONFIG = {
+    clusterName: 'midday-devnet',
+    node: DEFAULT_NODE_CONFIG,
+    indexer: DEFAULT_INDEXER_CONFIG,
+    proofServer: DEFAULT_PROOF_SERVER_CONFIG,
+};
+/**
+ * Indexer secret for local development (matches docker-compose).
+ * DO NOT use in production.
+ *
+ * @since 0.2.0
+ * @category constants
+ */
+export const DEV_INDEXER_SECRET = '303132333435363738393031323334353637383930313233343536373839303132';
+/**
+ * Convert cluster ports to a NetworkConfig compatible with midday-sdk.
+ *
+ * @since 0.2.0
+ * @category utilities
+ */
+export function toNetworkConfig(ports) {
+    return {
+        networkId: 'undeployed',
+        indexer: `http://localhost:${ports.indexer}/api/v3/graphql`,
+        indexerWS: `ws://localhost:${ports.indexer}/api/v3/graphql/ws`,
+        node: `ws://localhost:${ports.node}`,
+        proofServer: `http://localhost:${ports.proofServer}`,
+    };
+}
+//# sourceMappingURL=Config.js.map