prool 0.0.25 → 0.1.0

package/instances/silius.ts

@@ -1,347 +0,0 @@
-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'
-
-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 const silius = defineInstance((parameters?: SiliusParameters) => {
-  const args = (parameters || {}) as SiliusParameters
-  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,
-          },
-        } satisfies Partial<SiliusParameters>),
-      ]
-
-      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()
-    },
-  }
-})

package/instances/stackup.test.ts

@@ -1,106 +0,0 @@
-import getPort from 'get-port'
-import { afterEach, beforeAll, expect, test } from 'vitest'
-
-import { stackupOptions } from '../../test/utils.js'
-import type { Instance } from '../instance.js'
-import { anvil } from './anvil.js'
-import { type StackupParameters, stackup } from './stackup.js'
-
-const instances: Instance[] = []
-
-const port = await getPort()
-
-const defineInstance = (parameters?: Partial<StackupParameters>) => {
-  const instance = stackup({
-    ...stackupOptions({ port, pool: false }),
-    ...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: 1337 })
-  const instance_2 = defineInstance({ port: 1337 })
-
-  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()
-
-  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, 100))
-  expect(instance.status).toEqual('stopped')
-  expect(typeof exitCode !== 'undefined').toBeTruthy()
-})

package/instances/stackup.ts

@@ -1,162 +0,0 @@
-import { platform } from 'node:os'
-import { defineInstance } from '../instance.js'
-import { execa } from '../processes/execa.js'
-
-export type StackupParameters = {
-  /**
-   * The name of the native tracer to use during validation. This will be "bundlerCollectorTracer" if using builds from ERC-4337 execution client repo.
-   * Defaults to address of `privateKey`.
-   */
-  beneficiary?: string | undefined
-  /**
-   * Directory to store the embedded database.
-   * @default /tmp/stackup_bundler
-   */
-  dataDirectory?: string | undefined
-  /**
-   * RPC url to the execution client.
-   */
-  ethClientUrl: string
-  /**
-   * A boolean value for bundlers on an Arbitrum stack network to properly account for the L1 callData cost.
-   * @default false
-   */
-  isArbStackNetwork?: boolean | undefined
-  /**
-   * A boolean value for bundlers on an OP stack network to properly account for the L1 callData cost.
-   * @default false
-   */
-  isOpStackNetwork?: boolean | undefined
-  /**
-   * A boolean value for bundlers on a network that supports RIP-7212 precompile for secp256r1 signature verification.
-   * @default false
-   */
-  isRip7212Supported?: boolean | undefined
-  /**
-   * The maximum gas limit that can be submitted per UserOperation batch.
-   * @default 18_000_000
-   */
-  maxBatchGasLimit?: number | undefined
-  /**
-   * The maximum duration that a userOp can stay in the mempool before getting dropped.
-   * @default 180
-   */
-  maxOpTtlSeconds?: number | undefined
-  /**
-   * The maximum verificationGasLimit on a received UserOperation.
-   * @default 6_000_000
-   */
-  maxVerificationGas?: number | undefined
-  /**
-   * The maximum block range when looking up a User Operation with eth_getUserOperationReceipt or eth_getUserOperationByHash.
-   *
-   * Higher limits allow for fetching older User Operations but will result in higher request latency due to additional compute on the underlying node.
-   *
-   * @default 2_000
-   */
-  opLookupLimit?: number | undefined
-  /**
-   * Port to start the instance on.
-   */
-  port?: number | undefined
-  /**
-   * The private key for the EOA used to relay User Operation bundles to the EntryPoint.
-   */
-  privateKey: string
-  /**
-   * EntryPoint addresses to support. The first address is the preferred EntryPoint.
-   */
-  supportedEntryPoints?: string[]
-}
-
-/**
- * Defines an Anvil instance.
- *
- * @example
- * ```ts
- * const instance = stackup({
- *  ethClientUrl: 'http://localhost:8545',
- *  port: 4337,
- *  privateKey: '0x...'
- * })
- * await instance.start()
- * // ...
- * await instance.stop()
- * ```
- */
-export const stackup = defineInstance((parameters?: StackupParameters) => {
-  const args = (parameters || {}) as StackupParameters
-
-  const host = 'localhost'
-  const name = 'stackup'
-  const process = execa({ name })
-
-  return {
-    _internal: {
-      args,
-      get process() {
-        return process._internal.process
-      },
-    },
-    host,
-    name,
-    port: args.port ?? 4337,
-    async start({ port = args.port }, options) {
-      const args_ = [
-        ...(platform() === 'linux' ? ['--net', 'host'] : []),
-        '--add-host',
-        'host.docker.internal:host-gateway',
-        '--add-host',
-        'localhost:host-gateway',
-        '-p',
-        `${port}:${port}`,
-        '-e',
-        `ERC4337_BUNDLER_PORT=${port}`,
-        ...Object.entries(args).flatMap(([key, value]) => {
-          if (key === 'port') return []
-          if (value === undefined) return []
-
-          if (key === 'ethClientUrl')
-            value = (value as string).replaceAll(
-              /127\.0\.0\.1|0\.0\.0\.0/g,
-              'host.docker.internal',
-            )
-          if (key === 'privateKey') value = (value as string).replace('0x', '')
-
-          return [
-            '-e',
-            `ERC4337_BUNDLER_${key
-              .replace(/([a-z])([A-Z])/g, '$1_$2')
-              .toUpperCase()}=${value}`,
-          ]
-        }),
-        'stackupwallet/stackup-bundler:latest',
-        '/app/stackup-bundler',
-        'start',
-        '--mode',
-        'private',
-      ]
-      return await process.start(($) => $`docker run ${args_}`, {
-        ...options,
-        resolver({ process, resolve, reject }) {
-          process.stderr.on('data', async (data) => {
-            const message = data.toString()
-            // For some reason, `stackup-bundler` logs to stderr. So we have to try
-            // and dissect what is an error, and what is not. 😅
-            if (message.includes('Set nextTxnTs to'))
-              setTimeout(() => resolve(), 100)
-            else if (
-              message
-                .toLowerCase()
-                .match(/panic|error|connection refused|address already in use/)
-            )
-              reject(data)
-          })
-        },
-      })
-    },
-    async stop() {
-      await process.stop()
-    },
-  }
-})

package/processes/package.json

@@ -1,5 +0,0 @@
-{
-  "type": "module",
-  "types": "../_lib/exports/processes/index.d.ts",
-  "module": "../_lib/exports/processes/index.js"
-}