prool 0.0.13 → 0.0.15

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # prool
 
+## 0.0.15
+
+### Patch Changes
+
+- [#20](https://github.com/wevm/prool/pull/20) [`e1ebc61`](https://github.com/wevm/prool/commit/e1ebc61a888751298526f7126fe69d042551da7b) Thanks [@jxom](https://github.com/jxom)! - Added Silius instance.
+
+## 0.0.14
+
+### Patch Changes
+
+- [`0187ef8`](https://github.com/wevm/prool/commit/0187ef8a00ea4b25367b8427ed00d217388f3d65) Thanks [@jxom](https://github.com/jxom)! - Added Rundler instance.
+
 ## 0.0.13
 
 ### Patch Changes

package/README.md

@@ -39,7 +39,7 @@ Prool is a library that provides programmatic HTTP testing instances for Ethereu
 Prool contains a set of pre-configured instances that can be used to simulate Ethereum server environments, being:
 
 - **Local Execution Nodes:** [`anvil`](#anvil-execution-node)
-- **Bundler Nodes:** [`alto`](#alto-bundler-node), [`rundler`](#rundler), `silius`⚠️, [`stackup`](#stackup-bundler-node)
+- **Bundler Nodes:** [`alto`](#alto-bundler-node), [`rundler`](#rundler-bundler-node), [`silius`](#silius-bundler-node), [`stackup`](#stackup-bundler-node)
 - **Indexer Nodes:** `ponder`⚠️
 
 ⚠️ = soon
@@ -53,6 +53,7 @@ You can also create your own custom instances by using the [`defineInstance` fun
   - [Anvil (Execution Node)](#anvil-execution-node)
   - [Alto (Bundler Node)](#alto-bundler-node)
   - [Rundler (Bundler Node)](#rundler-bundler-node)
+  - [Silius (Bundler Node)](#silius-bundler-node)
   - [Stackup (Bundler Node)](#stackup-bundler-node)
 - [Reference](#reference)
   - [`createServer`](#createserver)
@@ -188,6 +189,48 @@ await bundlerServer.start()
 
 See [RundlerParameters]().
 
+### Silius (Bundler Node)
+
+#### Requirements
+
+- [Docker](https://docs.docker.com/get-docker/)
+- Silius Docker Image: `docker pull silius-rs/silius`
+
+#### Usage
+
+```ts
+import { createServer } from 'prool'
+import { anvil, silius } from 'prool/instances'
+
+const executionServer = createServer({
+  instance: anvil(),
+  port: 8545
+})
+await executionServer.start() 
+// Instances accessible at:
+// "http://localhost:8545/1"
+// "http://localhost:8545/2"
+// "http://localhost:8545/3"
+// "http://localhost:8545/n"
+
+const bundlerServer = createServer({
+  instance: (key) => silius({
+    ethClientAddress: `http://localhost:8545/${key}`,
+    mnemonicPath: './keys/0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266',
+  })
+})
+await bundlerServer.start()
+// Instances accessible at:
+// "http://localhost:4000/1" (→ http://localhost:8545/1)
+// "http://localhost:4000/2" (→ http://localhost:8545/2)
+// "http://localhost:4000/3" (→ http://localhost:8545/3)
+// "http://localhost:4000/n" (→ http://localhost:8545/n)
+```
+
+#### Parameters
+
+See [`SiliusParameters`]().
+
 ### Stackup (Bundler Node)
 
 #### Requirements

package/_lib/exports/instances.d.ts

@@ -1,5 +1,6 @@
 export { alto, type AltoParameters } from '../instances/alto.js';
 export { anvil, type AnvilParameters } from '../instances/anvil.js';
 export { rundler, type RundlerParameters } from '../instances/rundler.js';
+export { silius, type SiliusParameters } from '../instances/silius.js';
 export { stackup, type StackupParameters } from '../instances/stackup.js';
 //# sourceMappingURL=instances.d.ts.map

package/_lib/exports/instances.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"instances.d.ts","sourceRoot":"","sources":["../../exports/instances.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAChE,OAAO,EAAE,KAAK,EAAE,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACnE,OAAO,EAAE,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AACzE,OAAO,EAAE,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,yBAAyB,CAAA"}
+{"version":3,"file":"instances.d.ts","sourceRoot":"","sources":["../../exports/instances.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAChE,OAAO,EAAE,KAAK,EAAE,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACnE,OAAO,EAAE,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AACzE,OAAO,EAAE,MAAM,EAAE,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AACtE,OAAO,EAAE,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,yBAAyB,CAAA"}

package/_lib/exports/instances.js

@@ -1,5 +1,6 @@
 export { alto } from '../instances/alto.js';
 export { anvil } from '../instances/anvil.js';
 export { rundler } from '../instances/rundler.js';
+export { silius } from '../instances/silius.js';
 export { stackup } from '../instances/stackup.js';
 //# sourceMappingURL=instances.js.map

package/_lib/exports/instances.js.map

@@ -1 +1 @@
-{"version":3,"file":"instances.js","sourceRoot":"","sources":["../../exports/instances.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAuB,MAAM,sBAAsB,CAAA;AAChE,OAAO,EAAE,KAAK,EAAwB,MAAM,uBAAuB,CAAA;AACnE,OAAO,EAAE,OAAO,EAA0B,MAAM,yBAAyB,CAAA;AACzE,OAAO,EAAE,OAAO,EAA0B,MAAM,yBAAyB,CAAA"}
+{"version":3,"file":"instances.js","sourceRoot":"","sources":["../../exports/instances.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAuB,MAAM,sBAAsB,CAAA;AAChE,OAAO,EAAE,KAAK,EAAwB,MAAM,uBAAuB,CAAA;AACnE,OAAO,EAAE,OAAO,EAA0B,MAAM,yBAAyB,CAAA;AACzE,OAAO,EAAE,MAAM,EAAyB,MAAM,wBAAwB,CAAA;AACtE,OAAO,EAAE,OAAO,EAA0B,MAAM,yBAAyB,CAAA"}

package/_lib/instances/silius.d.ts

@@ -0,0 +1,224 @@
+export type SiliusParameters = {
+    /**
+     * The bundler beneficiary address.
+     */
+    beneficiary?: string | undefined;
+    /**
+     * The bundle interval in seconds.
+     * @default 10
+     */
+    bundleInterval?: number | undefined;
+    bundler?: {
+        /**
+         * Bundler gRPC address to listen on.
+         * @default '127.0.0.1'
+         */
+        addr?: string | undefined;
+        /**
+         * Bundler gRPC port to listen on.
+         * @default 3003
+         */
+        port?: number | undefined;
+    } | undefined;
+    /**
+     * The chain id.
+     * @default 1
+     */
+    chain?: number | undefined;
+    /**
+     * Path to the data directory.
+     */
+    dataDir?: string | undefined;
+    discovery?: {
+        /**
+         * The udp4 port to broadcast to peers in order to reach back for discovery.
+         * @default 9000
+         */
+        port?: number | undefined;
+    } | undefined;
+    /**
+     * Indicates whether the access list is enabled.
+     */
+    enableAccessList?: boolean | undefined;
+    /**
+     * Indicates whether the P2P mode is enabled.
+     */
+    enableP2p?: boolean | undefined;
+    /**
+     * Indicates whether the metrics are enabled.
+     */
+    enableMetrics?: boolean | undefined;
+    /**
+     * The entry points for the bundler.
+     */
+    entryPoints?: string[] | undefined;
+    /**
+     * RPC URL of the execution client.
+     */
+    ethClientAddress?: string | undefined;
+    /**
+     * Ethereum execution client proxy HTTP RPC endpoint.
+     */
+    ethClientProxyAddress?: string | undefined;
+    http?: {
+        /**
+         * HTTP address to listen on.
+         * @default '127.0.0.1'
+         */
+        addr?: string | undefined;
+        /**
+         * Configures the HTTP RPC API modules
+         * @default 'eth'
+         */
+        api?: string[] | undefined;
+        /**
+         * Configures the allowed CORS domains.
+         * @default '*'
+         */
+        corsdomain?: string[] | undefined;
+        /**
+         * HTTP port to listen on.
+         * @default 3000
+         */
+        port?: number | undefined;
+    } | undefined;
+    /**
+     * Maximum gas for verification.
+     * @default 5000000
+     */
+    maxVerificationGas?: bigint | undefined;
+    metrics?: {
+        /**
+         * Metrics address to listen on.
+         * @default '127.0.0.1'
+         */
+        addr?: string | undefined;
+        /**
+         * Metrics port to listen on.
+         * @default 3030
+         */
+        port?: number | undefined;
+    } | undefined;
+    /**
+     * Minimum balance for the beneficiary account.
+     * @default 100000000000000000 wei
+     */
+    minBalance?: bigint | undefined;
+    /**
+     * Minimum priority fee per gas.
+     * @default 0
+     */
+    minPriorityFeePerGas?: bigint | undefined;
+    /**
+     * Minimum stake required for entities.
+     * @default 1
+     */
+    minStake?: number | undefined;
+    /**
+     * Path to the mnemonic file.
+     */
+    mnemonicPath: string | undefined;
+    /**
+     * The path to the file where the p2p private key is stored.
+     */
+    nodekey?: string | undefined;
+    /**
+     * The path to the file where the p2p enr is stored.
+     */
+    nodeenr?: string | undefined;
+    p2p?: {
+        /**
+         * Sets the p2p listen address
+         * @default '0.0.0.0'
+         */
+        addr?: string | undefined;
+        /**
+         * The ipv4 address to broadcast to peers about which address we are listening on.
+         */
+        baddr?: string | undefined;
+        /**
+         * The tcp4 port to boardcast to peers in order to reach back for discovery.
+         * @default 9000
+         */
+        bport?: number | undefined;
+    } | undefined;
+    /**
+     * Poll interval event filters and pending transactions in milliseconds.
+     * @default 500
+     */
+    pollInterval?: number | undefined;
+    /**
+     * Port to start the instance on.
+     */
+    port?: number | undefined;
+    /**
+     * Sets the send bundle mode.
+     * @default "ethereum-client"
+     */
+    sendBundleMode?: string | undefined;
+    uopool?: {
+        /**
+         * UoPool gRPC address to listen on.
+         * @default '127.0.0.1'
+         */
+        addr?: string | undefined;
+        /**
+         * UoPool gRPC port to listen on.
+         * @default 3002
+         */
+        port?: number | undefined;
+    } | undefined;
+    /**
+     * Sets the UoPool mode.
+     */
+    uopoolMode?: string | undefined;
+    /**
+     * Sets the verbosity level.
+     * @default 2
+     */
+    verbosity?: number | undefined;
+    /**
+     * Addresses of whitelisted entities.
+     */
+    whitelist?: string[] | undefined;
+    ws?: {
+        /**
+         * WS address to listen on.
+         * @default '127.0.0.1'
+         */
+        addr?: string | undefined;
+        /**
+         * Configures the HTTP RPC API modules
+         * @default 'eth'
+         */
+        api?: string[] | undefined;
+        /**
+         * Configures the allowed WS origins.
+         * @default '*'
+         */
+        origins?: string[] | undefined;
+        /**
+         * WS port to listen on.
+         * @default 3001
+         */
+        port?: number | undefined;
+    } | undefined;
+};
+/**
+ * Defines an Anvil instance.
+ *
+ * @example
+ * ```ts
+ * const instance = silius({
+ *  port: 4337,
+ * })
+ * await instance.start()
+ * // ...
+ * await instance.stop()
+ * ```
+ */
+export declare const silius: import("../instance.js").DefineInstanceReturnType<{
+    args: SiliusParameters;
+    readonly process: import("../processes/execa.js").Process_internal;
+}, SiliusParameters | undefined>;
+//# sourceMappingURL=silius.d.ts.map

package/_lib/instances/silius.d.ts.map

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

package/_lib/instances/silius.js

@@ -0,0 +1,117 @@
+import { platform } from 'node:os';
+import { rmSync } from 'node:fs';
+import { defineInstance } from '../instance.js';
+import { execa } from '../processes/execa.js';
+import { toArgs } from '../utils.js';
+/**
+ * Defines an Anvil instance.
+ *
+ * @example
+ * ```ts
+ * const instance = silius({
+ *  port: 4337,
+ * })
+ * await instance.start()
+ * // ...
+ * await instance.stop()
+ * ```
+ */
+export const silius = defineInstance((parameters) => {
+    const args = (parameters || {});
+    const { dataDir = '.local', mnemonicPath, port: _, ...rest } = args;
+    const host = 'localhost';
+    const name = 'silius';
+    const process = execa({ name });
+    let port = args.port ?? 4000;
+    return {
+        _internal: {
+            args,
+            get process() {
+                return process._internal.process;
+            },
+        },
+        host,
+        name,
+        port,
+        async start({ port: port_ = port }, options) {
+            port = port_;
+            const args_ = [
+                ...(platform() === 'linux' ? ['--net', 'host'] : []),
+                '--add-host',
+                'host.docker.internal:host-gateway',
+                '--add-host',
+                'localhost:host-gateway',
+                '-p',
+                `${port}:${port}`,
+                '-v',
+                `${mnemonicPath}:/data/silius/mnemonic`,
+                '-v',
+                `./${dataDir}/${port_}/db:/data/silius/db`,
+                'ghcr.io/silius-rs/silius:latest',
+                'node',
+                '--datadir',
+                'data/silius',
+                '--mnemonic-file',
+                'data/silius/mnemonic',
+                '--http',
+                '--ws',
+                ...toArgs({
+                    ...rest,
+                    beneficiary: rest.beneficiary ?? '0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266',
+                    bundler: {
+                        ...rest.bundler,
+                        addr: rest.bundler?.addr ?? '0.0.0.0',
+                    },
+                    entryPoints: rest.entryPoints ?? [
+                        '0x0000000071727De22E5E9d8BAf0edAc6f37da032',
+                    ],
+                    ethClientAddress: rest.ethClientAddress?.replaceAll(/127\.0\.0\.1|0\.0\.0\.0/g, 'host.docker.internal'),
+                    ethClientProxyAddress: rest.ethClientProxyAddress?.replaceAll(/127\.0\.0\.1|0\.0\.0\.0/g, 'host.docker.internal'),
+                    http: {
+                        ...rest.http,
+                        addr: rest.http?.addr ?? '0.0.0.0',
+                        api: rest.http?.api ?? ['eth', 'debug', 'web3'],
+                        port,
+                    },
+                    metrics: {
+                        ...rest.metrics,
+                        addr: rest.metrics?.addr ?? '0.0.0.0',
+                    },
+                    uopool: {
+                        ...rest.uopool,
+                        addr: rest.uopool?.addr ?? '0.0.0.0',
+                    },
+                    ws: {
+                        ...rest.ws,
+                        addr: rest.ws?.addr ?? '0.0.0.0',
+                        api: rest.ws?.api ?? ['eth', 'debug', 'web3'],
+                        port: rest.ws?.port ?? 4001,
+                    },
+                }),
+            ];
+            return await process.start(($) => $ `docker run ${args_}`, {
+                ...options,
+                resolver({ process, resolve, reject }) {
+                    process.stdout.on('data', (data) => {
+                        const message = data.toString();
+                        if (message.includes('Started bundler JSON-RPC server'))
+                            resolve();
+                    });
+                    process.stderr.on('data', (data) => {
+                        if (data.toString().includes('WARNING'))
+                            return;
+                        reject(data);
+                    });
+                },
+            });
+        },
+        async stop() {
+            try {
+                rmSync(`${dataDir}/${port}`, { recursive: true, force: true });
+            }
+            catch { }
+            await process.stop();
+        },
+    };
+});
+//# sourceMappingURL=silius.js.map

package/_lib/instances/silius.js.map

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

package/_lib/utils.js

@@ -48,7 +48,7 @@ export function toArgs(obj, options = { casing: 'kebab' }) {
                 if (subValue === undefined)
                     return [];
                 const flag = toFlagCase(`${key}.${subKey}`, casing === 'kebab' ? '-' : '_');
-                return [flag, subValue];
+                return [flag, Array.isArray(subValue) ? subValue.join(',') : subValue];
             });
         }
         const flag = toFlagCase(key, casing === 'kebab' ? '-' : '_');

package/_lib/utils.js.map

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

package/exports/instances.test.ts

@@ -7,6 +7,7 @@ test('exports', () => {
       "alto",
       "anvil",
       "rundler",
+      "silius",
       "stackup",
     ]
   `)

package/exports/instances.ts

@@ -1,4 +1,5 @@
 export { alto, type AltoParameters } from '../instances/alto.js'
 export { anvil, type AnvilParameters } from '../instances/anvil.js'
 export { rundler, type RundlerParameters } from '../instances/rundler.js'
+export { silius, type SiliusParameters } from '../instances/silius.js'
 export { stackup, type StackupParameters } from '../instances/stackup.js'

package/instances/anvil.test.ts

@@ -86,7 +86,7 @@ test('behavior: can subscribe to stderr', async () => {
   )
 })
 
-test('behavior: starts anvil with custom options', async () => {
+test.skip('behavior: starts anvil with custom options', async () => {
   const instance = defineInstance({
     timestamp,
     chainId: 123,

package/instances/silius.test.ts

@@ -0,0 +1,108 @@
+import getPort from 'get-port'
+import { afterEach, beforeAll, expect, test } from 'vitest'
+
+import { siliusOptions } from '../../test/utils.js'
+import type { Instance } from '../instance.js'
+import { anvil } from './anvil.js'
+import { silius } from './silius.js'
+
+const instances: Instance[] = []
+
+const port = await getPort()
+
+const defineInstance = (parameters?: Partial<{}>) => {
+  const instance = silius({
+    ...siliusOptions({ port }),
+    ...parameters,
+  })
+  instances.push(instance)
+  return instance
+}
+
+beforeAll(() => anvil({ port }).start())
+
+afterEach(async () => {
+  for (const instance of instances) await instance.stop().catch(() => {})
+})
+
+test('default', async () => {
+  const messages: string[] = []
+  const stdouts: string[] = []
+
+  const instance = defineInstance()
+
+  instance.on('message', (m) => messages.push(m))
+  instance.on('stdout', (m) => stdouts.push(m))
+
+  expect(instance.messages.get()).toMatchInlineSnapshot('[]')
+
+  await instance.start()
+  expect(instance.status).toEqual('started')
+
+  expect(messages.join('')).toBeDefined()
+  expect(stdouts.join('')).toBeDefined()
+  expect(instance.messages.get().join('')).toBeDefined()
+
+  await instance.stop()
+  expect(instance.status).toEqual('stopped')
+
+  expect(messages.join('')).toBeDefined()
+  expect(stdouts.join('')).toBeDefined()
+  expect(instance.messages.get()).toMatchInlineSnapshot('[]')
+})
+
+test('behavior: instance errored (duplicate ports)', async () => {
+  const instance_1 = defineInstance({
+    port: 1337,
+  })
+  const instance_2 = defineInstance({
+    port: 1337,
+  })
+
+  await instance_1.start()
+  await expect(() => instance_2.start()).rejects.toThrowError()
+})
+
+test('behavior: start and stop multiple times', async () => {
+  const instance = defineInstance()
+
+  await instance.start()
+  await instance.stop()
+  await instance.start()
+  await instance.stop()
+  await instance.start()
+  await instance.stop()
+  await instance.start()
+  await instance.stop()
+})
+
+test('behavior: can subscribe to stderr', async () => {
+  const messages: string[] = []
+
+  const instance_1 = defineInstance({ port: 1338 })
+  const instance_2 = defineInstance({ port: 1338 })
+
+  await instance_1.start()
+  instance_2.on('stderr', (message) => messages.push(message))
+  await expect(instance_2.start()).rejects.toThrowError()
+})
+
+test('behavior: exit', async () => {
+  const instance = defineInstance()
+  const { promise, resolve } = Promise.withResolvers<void>()
+
+  let exitCode: number | null | undefined = undefined
+  instance.on('exit', (code) => {
+    exitCode = code
+    resolve()
+  })
+
+  await instance.start()
+  expect(instance.status).toEqual('started')
+
+  instance._internal.process.kill()
+
+  await promise
+  expect(instance.status).toEqual('stopped')
+  expect(typeof exitCode !== 'undefined').toBeTruthy()
+})