prool 0.0.8 → 0.0.10

package/_lib/utils.js

@@ -40,6 +40,8 @@ export function toArgs(parameters) {
     return Object.entries(parameters).flatMap(([key, value]) => {
         if (value === undefined)
             return [];
+        if (Array.isArray(value))
+            return [toFlagCase(key), value.join(',')];
         if (typeof value === 'object' && value !== null)
             return Object.entries(value).flatMap(([subKey, subValue]) => {
                 if (subValue === undefined)

package/_lib/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../utils.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,MAAM,IAAI,GAAG,kBAAkB,CAAA,CAAC,kCAAkC;IAClE,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,IAAI,GAAG,OAAO,IAAI,GAAG,EAAE,CAAC,CAAA;IAC/C,MAAM,CAAC,QAAQ,EAAE,GAAG,QAAQ,CAAC,GAAG,GAAG,CAAC,QAAQ;SACzC,KAAK,CAAC,GAAG,CAAC;SACV,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,CAAA;IAEhC,MAAM,EAAE,GACN,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC;QACrD,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;QAClB,CAAC,CAAC,SAAS,CAAA;IACf,MAAM,IAAI,GAAG,IACX,OAAO,EAAE,KAAK,QAAQ;QACpB,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC;QACpB,CAAC,CAAC,CAAC,QAAQ,EAAE,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,CACtC,EAAE,CAAA;IAEF,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAA;AACrB,CAAC;AAED,MAAM,cAAc;AAClB,yEAAyE;AACzE,6EAA6E,CAAA;AAE/E;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAA;AAC5C,CAAC;AAYD;;;;;GAKG;AACH,MAAM,UAAU,MAAM,CAAC,UAA4B;IACjD,OAAO,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QACzD,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,EAAE,CAAA;QAElC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;YAC7C,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,EAAE;gBAC1D,IAAI,QAAQ,KAAK,SAAS;oBAAE,OAAO,EAAE,CAAA;gBACrC,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAA;gBAC5B,MAAM,KAAK,GAAG,GAAG,MAAM,KAAK,QAAQ,EAAE,CAAA;gBACtC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;YACtB,CAAC,CAAC,CAAA;QAEJ,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAA;QAE5B,IAAI,KAAK,KAAK,KAAK;YAAE,OAAO,EAAE,CAAA;QAC9B,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,CAAC,IAAI,CAAC,CAAA;QAEjC,MAAM,WAAW,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAA;QACpC,IAAI,WAAW,KAAK,EAAE;YAAE,OAAO,CAAC,IAAI,CAAC,CAAA;QAErC,OAAO,CAAC,IAAI,EAAE,WAAW,CAAC,CAAA;IAC5B,CAAC,CAAC,CAAA;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,OAAO,KAAK,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC,EAAE,CAAA;AAC3E,CAAC"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../utils.ts"],"names":[],"mappings":"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"}

package/exports/index.test.ts

@@ -6,7 +6,6 @@ test('exports', () => {
     [
       "defineInstance",
       "definePool",
-      "execa",
       "createServer",
     ]
   `)

package/exports/index.ts

@@ -14,14 +14,6 @@ export {
   definePool,
 } from '../pool.js'
 
-export {
-  type ExecaParameters,
-  type ExecaProcess,
-  type ExecaReturnType,
-  type ExecaStartOptions,
-  execa,
-} from '../processes/execa.js'
-
 export {
   type CreateServerParameters,
   type CreateServerReturnType,

package/exports/instances.test.ts

@@ -4,6 +4,7 @@ import * as exports from './instances.js'
 test('exports', () => {
   expect(Object.keys(exports)).toMatchInlineSnapshot(`
     [
+      "alto",
       "anvil",
       "stackup",
     ]

package/exports/instances.ts

@@ -1,2 +1,3 @@
+export { type AltoParameters, alto } from '../instances/alto.js'
 export { type AnvilParameters, anvil } from '../instances/anvil.js'
 export { type StackupParameters, stackup } from '../instances/stackup.js'

package/instances/alto.test.ts

@@ -0,0 +1,124 @@
+import getPort from 'get-port'
+import { afterEach, beforeAll, expect, test } from 'vitest'
+
+import { altoOptions } from '../../test/utils.js'
+import type { Instance } from '../instance.js'
+import { type AltoParameters, alto } from './alto.js'
+import { anvil } from './anvil.js'
+
+const instances: Instance[] = []
+
+const port = await getPort()
+
+const defineInstance = (parameters: Partial<AltoParameters> = {}) => {
+  const instance = alto({
+    ...altoOptions({ 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: 8545 })
+  const instance_2 = defineInstance({ port: 8545 })
+
+  await instance_1.start()
+  await expect(() => instance_2.start()).rejects.toThrowError('EADDRINUSE')
+})
+
+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 stdout', async () => {
+  const messages: string[] = []
+  const instance = defineInstance()
+  instance.on('stdout', (message) => messages.push(message))
+
+  await instance.start()
+  expect(messages.length).toBeGreaterThanOrEqual(1)
+})
+
+test('behavior: can subscribe to stderr', async () => {
+  const messages: string[] = []
+
+  const instance_1 = defineInstance({ port: 8545 })
+  const instance_2 = defineInstance({ port: 8545 })
+
+  await instance_1.start()
+  instance_2.on('stderr', (message) => messages.push(message))
+  await expect(instance_2.start()).rejects.toThrow('EADDRINUSE')
+})
+
+test('behavior: exit', async () => {
+  const instance = defineInstance()
+
+  let exitCode: number | null | undefined = undefined
+  instance.on('exit', (code) => {
+    exitCode = code
+  })
+
+  await instance.start()
+  expect(instance.status).toEqual('started')
+
+  instance._internal.process.kill()
+
+  await new Promise<void>((res) => setTimeout(res, 500))
+  expect(instance.status).toEqual('stopped')
+  expect(typeof exitCode !== 'undefined').toBeTruthy()
+})
+
+test('behavior: exit when status is starting', async () => {
+  const instance = defineInstance()
+
+  const promise = instance.start()
+  expect(instance.status).toEqual('starting')
+
+  instance._internal.process.kill()
+
+  await expect(promise).rejects.toThrowErrorMatchingInlineSnapshot(
+    `[Error: Failed to start process "alto": exited]`,
+  )
+})

package/instances/alto.ts

@@ -0,0 +1,293 @@
+import { readFileSync, writeFileSync } from 'node:fs'
+import { resolve } from 'node:path'
+import { defineInstance } from '../instance.js'
+import { execa } from '../processes/execa.js'
+import { toArgs } from '../utils.js'
+
+export type AltoParameters = {
+  /**
+   * API version (used for internal Pimlico versioning compatibility).
+   */
+  apiVersion?: readonly string[] | undefined
+  /**
+   * Override the sender native token balance during estimation
+   */
+  balanceOverride?: boolean | undefined
+  /**
+   * Binary path of the `alto` executable.
+   */
+  binary?: string | undefined
+  /**
+   * Address of the `BundleBulker` contract.
+   */
+  bundleBulkerAddress?: `0x${string}` | undefined
+  /**
+   * Set if the bundler bundle user operations automatically or only when calling `debug_bundler_sendBundleNow`.
+   * @default "auto"
+   */
+  bundleMode?: 'auto' | 'manual' | undefined
+  /**
+   * Indicates weather the chain is a OP stack chain, arbitrum chain, or default EVM chain.
+   */
+  chainType?: 'default' | 'op-stack' | 'arbitrum' | undefined
+  /**
+   * Path to JSON config file.
+   */
+  config?: string | undefined
+  /**
+   * Skip user operation validation, use with caution.
+   */
+  dangerousSkipUserOperationValidation?: boolean | undefined
+  /**
+   * Default API version.
+   */
+  defaultApiVersion?: string | undefined
+  /**
+   * Enable debug endpoints.
+   * @default false
+   */
+  enableDebugEndpoints?: boolean | undefined
+  /**
+   * Include user ops with the same sender in the single bundle.
+   * @default true
+   */
+  enforceUniqueSendersPerBundle?: boolean | undefined
+  /**
+   * EntryPoint contract addresses.
+   */
+  entrypoints: readonly `0x${string}`[]
+  /**
+   * Address of the EntryPoint simulations contract.
+   */
+  entrypointSimulationContract?: `0x${string}` | undefined
+  /**
+   * Private keys of the executor accounts.
+   */
+  executorPrivateKeys?: readonly `0x${string}`[]
+  /**
+   * Interval to refill the signer balance (seconds).
+   * @default 1200
+   */
+  executorRefillInterval?: number | undefined
+  /**
+   * Should the node make expiration checks.
+   * @default true
+   */
+  expirationCheck?: boolean | undefined
+  /**
+   * Amount to multiply the gas prices fetched from the node.
+   * @default "100"
+   */
+  gasPriceBump?: string | undefined
+  /**
+   * Maximum that the gas prices fetched using pimlico_getUserOperationGasPrice will be accepted for (seconds).
+   * @default 10
+   */
+  gasPriceExpiry?: number | undefined
+  /**
+   * The minimum percentage of incoming user operation gas prices compared to the gas price used by the bundler to submit bundles.
+   * @default 101
+   */
+  gasPriceFloorPercent?: number | undefined
+  /**
+   * Amount to multiply the gas prices fetched using `pimlico_getUserOperationGasPrice`.
+   * @default "105,110,115"
+   */
+  gasPriceMultipliers?: readonly string[] | undefined
+  /**
+   * Use a fixed value for gas limits during bundle transaction gas limit estimations
+   */
+  fixedGasLimitForEstimation?: string | undefined
+  /**
+   * Flush stuck transactions with old nonces during bundler startup.
+   */
+  flushStuckTransactionsDuringStartup?: boolean | undefined
+  /**
+   * Log in JSON format.
+   */
+  json?: boolean | undefined
+  /**
+   * Send legacy transactions instead of an EIP-1559 transactions.
+   * @default false
+   */
+  legacyTransactions?: boolean | undefined
+  /**
+   * Calculate the bundle transaction gas limits locally instead of using the RPC gas limit estimation.
+   */
+  localGasLimitCalculation?: boolean | undefined
+  /**
+   * Default log level.
+   */
+  logLevel?: 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'fatal' | undefined
+  /**
+   * Max block range for `eth_getLogs` calls.
+   */
+  maxBlockRange?: number | undefined
+  /**
+   * Maximum number of operations allowed in the mempool before a bundle is submitted.
+   * @default 10
+   */
+  maxBundleSize?: number | undefined
+  /**
+   * Maximum time to wait for a bundle to be submitted (ms).
+   * @default 1000
+   */
+  maxBundleWait?: number | undefined
+  /**
+   * Maximum amount of gas per bundle.
+   * @default "5000000"
+   */
+  maxGasPerBundle?: string | undefined
+  /**
+   * Maximum number of executor accounts to use from the list of executor private keys.
+   */
+  maxExecutors?: number | undefined
+  /**
+   * Maximum amount of parallel user ops to keep in the meempool (same sender, different nonce keys).
+   * @default 10
+   */
+  mempoolMaxParallelOps?: number | undefined
+  /**
+   * Maximum amount of sequential user ops to keep in the mempool (same sender and nonce key, different nonce values).
+   * @default 0
+   */
+  mempoolMaxQueuedOps?: number | undefined
+  /**
+   * Minimum stake required for a relay (in 10e18).
+   * @default 1
+   */
+  minEntityStake?: number | undefined
+  /**
+   * Minimum unstake delay (seconds).
+   * @default 1
+   */
+  minEntityUnstakeDelay?: number | undefined
+  /**
+   * Minimum balance required for each executor account (below which the utility account will refill).
+   */
+  minExecutorBalance?: string | undefined
+  /**
+   * Name of the network (used for metrics).
+   * @default "localhost"
+   */
+  networkName?: string | undefined
+  /**
+   * Amount to multiply the paymaster gas limits fetched from simulations.
+   */
+  paymasterGasLimitMultiplier?: string | undefined
+  /**
+   * Address of the `PerOpInflator` contract.
+   */
+  perOpInflatorAddress?: `0x${string}` | undefined
+  /**
+   * Polling interval for querying for new blocks (ms).
+   * @default 1000
+   */
+  pollingInterval?: number | undefined
+  /**
+   * Port to listen on.
+   * @default 3000
+   */
+  port?: number | undefined
+  /**
+   * RPC url to connect to.
+   */
+  rpcUrl: string
+  /**
+   * Enable safe mode (enforcing all ERC-4337 rules).
+   * @default true
+   */
+  safeMode?: boolean | undefined
+  /**
+   * RPC url to send transactions to (e.g. flashbots relay).
+   */
+  sendTransactionRpcUrl?: string | undefined
+  /**
+   * Timeout for incoming requests (in ms).
+   */
+  timeout?: number | undefined
+  /**
+   * Private key of the utility account.
+   */
+  utilityPrivateKey?: string | undefined
+  /**
+   * Maximum payload size for websocket messages in bytes (default to 1MB).
+   */
+  websocketMaxPayloadSize?: number | undefined
+  /**
+   * Enable websocket server.
+   */
+  websocket?: boolean | undefined
+}
+
+/**
+ * Defines an Alto instance.
+ *
+ * @example
+ * ```ts
+ * const instance = alto({
+ *  entrypoints: ['0x0000000071727De22E5E9d8BAf0edAc6f37da032'],
+ *  rpcUrl: `http://localhost:8545`,
+ *  executorPrivateKeys: ['0x...'],
+ * })
+ * await instance.start()
+ * // ...
+ * await instance.stop()
+ * ```
+ */
+export const alto = defineInstance((parameters?: AltoParameters) => {
+  const { ...args } = (parameters || {}) as AltoParameters
+
+  const name = 'alto'
+  const process = execa({ name })
+
+  return {
+    _internal: {
+      args,
+      get process() {
+        return process._internal.process
+      },
+    },
+    host: 'localhost',
+    name,
+    port: args.port ?? 3000,
+    async start({ port = args.port ?? 3000 }, options) {
+      const binary = (() => {
+        if (args.binary) return [args.binary]
+        const libPath = (
+          'resolve' in import.meta
+            ? import.meta.resolve('@pimlico/alto').split('file:')[1]
+            : require.resolve('@pimlico/alto')
+        )!
+
+        // Remove the `type` field from the package.json file.
+        // `@pimlico/alto`'s CLI is packaged as a CJS module.
+        // TODO: Fix upstream in `@pimlico/alto`.
+        const { type: _, ...packageJson } = JSON.parse(
+          readFileSync(resolve(libPath, '../../package.json'), 'utf-8'),
+        )
+        writeFileSync(
+          resolve(libPath, '../../package.json'),
+          JSON.stringify(packageJson),
+        )
+
+        return ['node', resolve(libPath, '../cli/alto.js')]
+      })()
+
+      await process.start(($) => $`${binary} ${toArgs({ port, ...args })}`, {
+        ...options,
+        // Resolve when the process is listening via a "Server listening at" message.
+        resolver({ process, reject, resolve }) {
+          process.stdout.on('data', (data) => {
+            const message = data.toString()
+            if (message.includes('Server listening at')) resolve()
+          })
+          process.stderr.on('data', reject)
+        },
+      })
+    },
+    async stop() {
+      await process.stop()
+    },
+  }
+})

package/instances/anvil.test.ts

@@ -124,6 +124,6 @@ test('behavior: exit when status is starting', async () => {
   instance._internal.process.kill()
 
   await expect(promise).rejects.toThrowErrorMatchingInlineSnapshot(
-    '[Error: Failed to start process "anvil": exited.]',
+    `[Error: Failed to start process "anvil": exited]`,
   )
 })

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "prool",
   "description": "HTTP testing instances for Ethereum",
-  "version": "0.0.8",
+  "version": "0.0.10",
   "type": "module",
   "module": "_lib/exports/index.mjs",
   "types": "_lib/exports/index.d.ts",
@@ -30,6 +30,14 @@
     "get-port": "^7.1.0",
     "http-proxy": "^1.18.1"
   },
+  "peerDependencies": {
+    "@pimlico/alto": "*"
+  },
+  "peerDependenciesMeta": {
+    "@pimlico/alto": {
+      "optional": true
+    }
+  },
   "license": "MIT",
   "homepage": "https://wevm.dev",
   "repository": "wevm/prool",

package/pool.test.ts

@@ -1,7 +1,8 @@
 import getPort from 'get-port'
 import { afterEach, beforeAll, describe, expect, test } from 'vitest'
 
-import { stackupOptions } from '../test/utils.js'
+import { altoOptions, stackupOptions } from '../test/utils.js'
+import { alto } from './instances/alto.js'
 import { anvil } from './instances/anvil.js'
 import { stackup } from './instances/stackup.js'
 import { definePool } from './pool.js'
@@ -21,6 +22,9 @@ afterEach(async () => {
 
 describe.each([
   { instance: anvil() },
+  {
+    instance: alto(altoOptions({ port })),
+  },
   {
     instance: stackup(stackupOptions({ port })),
   },

package/processes/execa.ts

@@ -30,6 +30,7 @@ export type ExecaReturnType = ExecaProcess
 export function execa(parameters: ExecaParameters): ExecaReturnType {
   const { name } = parameters
 
+  const errorMessages: string[] = []
   let process: Process_internal
 
   async function stop() {
@@ -76,6 +77,10 @@ export function execa(parameters: ExecaParameters): ExecaReturnType {
       })
       process.stderr.on('data', async (data) => {
         const message = stripColors(data.toString())
+
+        errorMessages.push(message)
+        if (errorMessages.length > 20) errorMessages.shift()
+
         emitter.emit('message', message)
         emitter.emit('stderr', message)
       })
@@ -86,7 +91,15 @@ export function execa(parameters: ExecaParameters): ExecaReturnType {
         if (!code) {
           process.removeAllListeners()
           if (status === 'starting')
-            reject(new Error(`Failed to start process "${name}": exited.`))
+            reject(
+              new Error(
+                `Failed to start process "${name}": ${
+                  errorMessages.length > 0
+                    ? `\n\n${errorMessages.join('\n')}`
+                    : 'exited'
+                }`,
+              ),
+            )
         }
       })
 

package/server.test.ts

@@ -1,7 +1,8 @@
 import getPort from 'get-port'
 import { beforeAll, describe, expect, test } from 'vitest'
 import { type MessageEvent, WebSocket } from 'ws'
-import { stackupOptions } from '../test/utils.js'
+import { altoOptions, stackupOptions } from '../test/utils.js'
+import { alto } from './instances/alto.js'
 import { anvil } from './instances/anvil.js'
 import { stackup } from './instances/stackup.js'
 import { createServer } from './server.js'
@@ -12,6 +13,9 @@ beforeAll(() => anvil({ port }).start())
 
 describe.each([
   { instance: anvil() },
+  {
+    instance: alto(altoOptions({ port })),
+  },
   {
     instance: stackup(stackupOptions({ port })),
   },
@@ -357,30 +361,63 @@ describe("instance: 'anvil'", () => {
   })
 })
 
+describe("instance: 'alto'", () => {
+  test('request: /{id}', async () => {
+    const server = createServer({
+      instance: alto(altoOptions({ port })),
+    })
+
+    const stop = await server.start()
+    const { port: port_2 } = server.address()!
+    const response = await fetch(`http://localhost:${port_2}/1`, {
+      body: JSON.stringify({
+        method: 'eth_supportedEntryPoints',
+        params: [],
+        id: 0,
+        jsonrpc: '2.0',
+      }),
+      headers: {
+        'Content-Type': 'application/json',
+      },
+      method: 'POST',
+    })
+    expect(response.status).toBe(200)
+    expect(await response.json()).toMatchInlineSnapshot(`
+        {
+          "id": 0,
+          "jsonrpc": "2.0",
+          "result": [
+            "0x0000000071727De22E5E9d8BAf0edAc6f37da032",
+          ],
+        }
+      `)
+
+    await stop()
+  })
+})
+
 describe("instance: 'stackup'", () => {
-  test(
-    'request: /{id}',
-    async () => {
-      const server = createServer({
-        instance: stackup(stackupOptions({ port })),
-      })
-
-      const stop = await server.start()
-      const { port: port_2 } = server.address()!
-      const response = await fetch(`http://localhost:${port_2}/1`, {
-        body: JSON.stringify({
-          method: 'eth_supportedEntryPoints',
-          params: [],
-          id: 0,
-          jsonrpc: '2.0',
-        }),
-        headers: {
-          'Content-Type': 'application/json',
-        },
-        method: 'POST',
-      })
-      expect(response.status).toBe(200)
-      expect(await response.json()).toMatchInlineSnapshot(`
+  test('request: /{id}', async () => {
+    const server = createServer({
+      instance: stackup(stackupOptions({ port })),
+    })
+
+    const stop = await server.start()
+    const { port: port_2 } = server.address()!
+    const response = await fetch(`http://localhost:${port_2}/1`, {
+      body: JSON.stringify({
+        method: 'eth_supportedEntryPoints',
+        params: [],
+        id: 0,
+        jsonrpc: '2.0',
+      }),
+      headers: {
+        'Content-Type': 'application/json',
+      },
+      method: 'POST',
+    })
+    expect(response.status).toBe(200)
+    expect(await response.json()).toMatchInlineSnapshot(`
         {
           "id": 0,
           "jsonrpc": "2.0",
@@ -390,10 +427,8 @@ describe("instance: 'stackup'", () => {
         }
       `)
 
-      await stop()
-    },
-    { timeout: 600000 },
-  )
+    await stop()
+  })
 })
 
 test('404', async () => {