prool 0.0.12 → 0.0.13

package/_lib/utils.d.ts

@@ -16,21 +16,17 @@ export declare function extractPath(request: string): ExtractPathReturnType;
  * @returns The stripped string.
  */
 export declare function stripColors(message: string): string;
-export type ToArgsParameters = {
-    [key: string]: Record<string, string> | string | readonly string[] | boolean | number | bigint | undefined;
-};
 /**
  * Converts an object of options to an array of command line arguments.
  *
  * @param options The options object.
  * @returns The command line arguments.
  */
-export declare function toArgs(parameters: ToArgsParameters): string[];
-/**
- * Converts a camelCase string to a flag case string.
- *
- * @param key The camelCase string.
- * @returns The flag case string.
- */
-export declare function toFlagCase(key: string): string;
+export declare function toArgs(obj: {
+    [key: string]: Record<string, any> | string | readonly string[] | boolean | number | bigint | undefined;
+}, options?: {
+    casing: 'kebab' | 'snake';
+}): any[];
+/** Converts to a --flag-case string. */
+export declare function toFlagCase(str: string, separator?: string): string;
 //# sourceMappingURL=utils.d.ts.map

package/_lib/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../utils.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qBAAqB,GAAG;IAClC,EAAE,EAAE,MAAM,GAAG,SAAS,CAAA;IACtB,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,qBAAqB,CAkBlE;AAMD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,UAE1C;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,CAAC,GAAG,EAAE,MAAM,GACR,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACtB,MAAM,GACN,SAAS,MAAM,EAAE,GACjB,OAAO,GACP,MAAM,GACN,MAAM,GACN,SAAS,CAAA;CACd,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,UAAU,EAAE,gBAAgB,YAwBlD;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,UAErC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../utils.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qBAAqB,GAAG;IAClC,EAAE,EAAE,MAAM,GAAG,SAAS,CAAA;IACtB,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,qBAAqB,CAkBlE;AAMD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,UAE1C;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CACpB,GAAG,EAAE;IACH,CAAC,GAAG,EAAE,MAAM,GACR,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACnB,MAAM,GACN,SAAS,MAAM,EAAE,GACjB,OAAO,GACP,MAAM,GACN,MAAM,GACN,SAAS,CAAA;CACd,EACD,OAAO,GAAE;IAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAA;CAAwB,SA6B7D;AAED,wCAAwC;AACxC,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,SAAM,UAatD"}

package/_lib/utils.js

@@ -36,21 +36,22 @@ export function stripColors(message) {
  * @param options The options object.
  * @returns The command line arguments.
  */
-export function toArgs(parameters) {
-    return Object.entries(parameters).flatMap(([key, value]) => {
+export function toArgs(obj, options = { casing: 'kebab' }) {
+    const { casing } = options;
+    return Object.entries(obj).flatMap(([key, value]) => {
         if (value === undefined)
             return [];
         if (Array.isArray(value))
             return [toFlagCase(key), value.join(',')];
-        if (typeof value === 'object' && value !== null)
+        if (typeof value === 'object' && value !== null) {
             return Object.entries(value).flatMap(([subKey, subValue]) => {
                 if (subValue === undefined)
                     return [];
-                const flag = toFlagCase(key);
-                const value = `${subKey}: ${subValue}`;
-                return [flag, value];
+                const flag = toFlagCase(`${key}.${subKey}`, casing === 'kebab' ? '-' : '_');
+                return [flag, subValue];
             });
-        const flag = toFlagCase(key);
+        }
+        const flag = toFlagCase(key, casing === 'kebab' ? '-' : '_');
         if (value === false)
             return [flag, 'false'];
         if (value === true)
@@ -61,13 +62,18 @@ export function toArgs(parameters) {
         return [flag, stringified];
     });
 }
-/**
- * Converts a camelCase string to a flag case string.
- *
- * @param key The camelCase string.
- * @returns The flag case string.
- */
-export function toFlagCase(key) {
-    return `--${key.replace(/[A-Z]/g, (match) => `-${match.toLowerCase()}`)}`;
+/** Converts to a --flag-case string. */
+export function toFlagCase(str, separator = '-') {
+    const keys = [];
+    for (let i = 0; i < str.split('.').length; i++) {
+        const key = str.split('.')[i];
+        if (!key)
+            continue;
+        keys.push(key
+            .replace(/\s+/g, separator)
+            .replace(/([a-z])([A-Z])/g, `$1${separator}$2`)
+            .toLowerCase());
+    }
+    return `--${keys.join('.')}`;
 }
 //# sourceMappingURL=utils.js.map

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

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

package/exports/instances.ts

@@ -1,3 +1,4 @@
-export { type AltoParameters, alto } from '../instances/alto.js'
-export { type AnvilParameters, anvil } from '../instances/anvil.js'
-export { type StackupParameters, stackup } from '../instances/stackup.js'
+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 { stackup, type StackupParameters } from '../instances/stackup.js'

package/instances/package.json

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

package/instances/rundler.test.ts

@@ -0,0 +1,115 @@
+import { afterEach, expect, test } from 'vitest'
+import type { Instance } from '../instance.js'
+import { type RundlerParameters, rundler } from './rundler.js'
+
+const instances: Instance[] = []
+
+const defineInstance = (parameters: RundlerParameters = {}) => {
+  const instance = rundler(parameters)
+  instances.push(instance)
+  return instance
+}
+
+afterEach(async () => {
+  for (const instance of instances) await instance.stop()
+})
+
+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({
+    rpc: {
+      port: 1337,
+    },
+  })
+  const instance_2 = defineInstance({
+    rpc: {
+      port: 1337,
+    },
+  })
+
+  await instance_1.start()
+  await expect(() =>
+    instance_2.start(),
+  ).rejects.toThrowErrorMatchingInlineSnapshot(
+    `[Error: Failed to start process "rundler": exited]`,
+  )
+})
+
+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({
+    rpc: {
+      port: 1338,
+    },
+  })
+  const instance_2 = defineInstance({
+    rpc: {
+      port: 1338,
+    },
+  })
+
+  await instance_1.start()
+  instance_2.on('stderr', (message) => messages.push(message))
+  await expect(() =>
+    instance_2.start(),
+  ).rejects.toThrowErrorMatchingInlineSnapshot(
+    `[Error: Failed to start process "rundler": exited]`,
+  )
+})
+
+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/rundler.ts

@@ -0,0 +1,451 @@
+import getPort from 'get-port'
+
+import { defineInstance } from '../instance.js'
+import { execa } from '../processes/execa.js'
+import { toArgs } from '../utils.js'
+
+export type RundlerParameters = {
+  /**
+   * The path to the rundler binary
+   *
+   * @default rundler
+   */
+  binary?: string
+
+  /**
+   * The version of the entrypoint to use
+   *
+   * @default 0.6.0
+   */
+  entryPointVersion?: '0.6.0' | '0.7.0'
+
+  /**
+   * Network to look up a hardcoded chain spec.
+   * @default dev
+   */
+  network?: string
+
+  /**
+   * Path to a chain spec TOML file.
+   */
+  chainSpec?: string
+
+  /**
+   * EVM Node HTTP URL to use.
+   *
+   * @default http://localhost:8545
+   */
+  nodeHttp?: string
+
+  /**
+   * Maximum verification gas.
+   * @default 5000000
+   */
+  maxVerificationGas?: number
+
+  /**
+   * Maximum bundle gas.
+   * @default 25000000
+   */
+  maxBundleGas?: number
+
+  /**
+   * Minimum stake value.
+   * @default 1000000000000000000
+   */
+  minStakeValue?: number
+
+  /**
+   * Minimum unstake delay.
+   * @default 84600
+   */
+  minUnstakeDelay?: number
+
+  /**
+   * Number of blocks to search when calling eth_getUserOperationByHash.
+   * @default 100
+   */
+  userOperationEventBlockDistance?: number
+
+  /**
+   * Maximum gas for simulating handle operations.
+   * @default 20000000
+   */
+  maxSimulateHandleOpsGas?: number
+
+  /**
+   * The gas fee to use during verification estimation.
+   * @default 1000000000000 10K gwei
+   */
+  verificationEstimationGasFee?: number
+
+  /**
+   * Bundle transaction priority fee overhead over network value.
+   * @default 0
+   */
+  bundlePriorityFeeOverheadPercent?: number
+
+  /**
+   * Priority fee mode kind.
+   * Possible values are base_fee_percent and priority_fee_increase_percent.
+   * @default priority_fee_increase_percent
+   */
+  priorityFeeModeKind?: 'base_fee_percent' | 'priority_fee_increase_percent'
+
+  /**
+   * Priority fee mode value.
+   * @default 0
+   */
+  priorityFeeModeValue?: number
+
+  /**
+   * Percentage of the current network fees a user operation must have in order to be accepted into the mempool.
+   * @default 100
+   */
+  baseFeeAcceptPercent?: number
+
+  /**
+   * AWS region.
+   * @default us-east-1
+   */
+  awsRegion?: string
+
+  /**
+   * Interval at which the builder polls an RPC node for new blocks and mined transactions.
+   * @default 100
+   */
+  ethPollIntervalMillis?: number
+
+  /**
+   * Flag for unsafe bundling mode. When set Rundler will skip checking simulation rules (and any debug_traceCall).
+   *
+   * @default true
+   */
+  unsafe?: boolean
+
+  /**
+   * Path to the mempool configuration file.
+   * This path can either be a local file path or an S3 url.
+   */
+  mempoolConfigPath?: string
+
+  metrics?: {
+    /**
+     * Port to listen on for metrics requests.
+     * @default 8080
+     */
+    port?: number
+
+    /**
+     * Host to listen on for metrics requests.
+     * @default 0.0.0.0
+     */
+    host?: string
+
+    /**
+     * Tags for metrics in the format key1=value1,key2=value2,...
+     */
+    tags?: string
+
+    /**
+     * Sample interval to use for sampling metrics.
+     * @default 1000
+     */
+    sampleIntervalMillis?: number
+  }
+
+  logging?: {
+    /**
+     * Log file. If not provided, logs will be written to stdout.
+     */
+    file?: string
+
+    /**
+     * If set, logs will be written in JSON format.
+     */
+    json?: boolean
+  }
+
+  rpc?: {
+    /**
+     * Port to listen on for JSON-RPC requests.
+     * @default 3000
+     */
+    port?: number
+
+    /**
+     * Host to listen on for JSON-RPC requests.
+     * @default 127.0.0.1
+     */
+    host?: string
+
+    /**
+     * Which APIs to expose over the RPC interface.
+     * @default eth,rundler
+     */
+    api?: string
+
+    /**
+     * Timeout for RPC requests.
+     * @default 20
+     */
+    timeoutSeconds?: number
+
+    /**
+     * Maximum number of concurrent connections.
+     * @default 100
+     */
+    maxConnections?: number
+  }
+
+  pool?: {
+    /**
+     * Maximum size in bytes for the pool.
+     * @default 500000000, 0.5 GB
+     */
+    maxSizeInBytes?: number
+
+    /**
+     * Maximum number of user operations for an unstaked sender.
+     * @default 4
+     */
+    sameSenderMempoolCount?: number
+
+    /**
+     * Minimum replacement fee increase percentage.
+     * @default 10
+     */
+    minReplacementFeeIncreasePercentage?: number
+
+    /**
+     * Path to a blocklist file.
+     * This path can either be a local file path or an S3 url.
+     */
+    blocklistPath?: string
+
+    /**
+     * Path to an allowlist file.
+     * This path can either be a local file path or an S3 url.
+     */
+    allowlistPath?: string
+
+    /**
+     * Size of the chain history.
+     */
+    chainHistorySize?: number
+
+    /**
+     * Boolean field that sets whether the pool server starts with paymaster tracking enabled.
+     * @default true
+     */
+    paymasterTrackingEnabled?: boolean
+
+    /**
+     * Length of the paymaster cache.
+     * @default 10_000
+     */
+    paymasterCacheLength?: number
+
+    /**
+     * Boolean field that sets whether the pool server starts with reputation tracking enabled.
+     * @default true
+     */
+    reputationTrackingEnabled?: boolean
+
+    /**
+     * The minimum number of blocks that a UO must stay in the mempool before it can be requested to be dropped by the user.
+     * @default 10
+     */
+    dropMinNumBlocks?: number
+  }
+
+  builder?: {
+    /**
+     * Private key to use for signing transactions.
+     * If used with awsKmsKeyIds, then explicitly pass in `null` here.
+     *
+     * @default 0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80
+     */
+    privateKey?: string
+
+    /**
+     * AWS KMS key IDs to use for signing transactions (comma-separated).
+     * Only required if privateKey is not provided.
+     */
+    awsKmsKeyIds?: string
+
+    /**
+     * Redis URI to use for KMS leasing.
+     * Only required when awsKmsKeyIds are provided.
+     *
+     * @default ""
+     */
+    redisUri?: string
+
+    /**
+     * Redis lock TTL in milliseconds.
+     * Only required when awsKmsKeyIds are provided.
+     * @default 60000
+     */
+    redisLockTtlMillis?: number
+
+    /**
+     * Maximum number of ops to include in one bundle.
+     * @default 128
+     */
+    maxBundleSize?: number
+
+    /**
+     * If present, the URL of the ETH provider that will be used to send transactions.
+     * Defaults to the value of nodeHttp.
+     */
+    submitUrl?: string
+
+    /**
+     * Choice of what sender type to use for transaction submission.
+     * @default raw
+     * options: raw, conditional, flashbots, polygon_bloxroute
+     */
+    sender?: 'raw' | 'conditional' | 'flashbots' | 'polygonBloxroute'
+
+    /**
+     * After submitting a bundle transaction, the maximum number of blocks to wait for that transaction to mine before trying to resend with higher gas fees.
+     * @default 2
+     */
+    maxBlocksToWaitForMine?: number
+
+    /**
+     * Percentage amount to increase gas fees when retrying a transaction after it failed to mine.
+     * @default 10
+     */
+    replacementFeePercentIncrease?: number
+
+    /**
+     * Maximum number of fee increases to attempt.
+     * Seven increases of 10% is roughly 2x the initial fees.
+     * @default 7
+     */
+    maxFeeIncreases?: number
+
+    /**
+     * Additional builders to send bundles to through the Flashbots relay RPC (comma-separated).
+     * List of builders that the Flashbots RPC supports can be found here.
+     * @default flashbots
+     */
+    flashbotsRelayBuilders?: string
+
+    /**
+     * Authorization key to use with the Flashbots relay.
+     * See here for more info.
+     * @default None
+     */
+    flashbotsRelayAuthKey?: string
+
+    /**
+     * If using the bloxroute transaction sender on Polygon, this is the auth header to supply with the requests.
+     * @default None
+     */
+    bloxrouteAuthHeader?: string
+
+    /**
+     * If running multiple builder processes, this is the index offset to assign unique indexes to each bundle sender.
+     * @default 0
+     */
+    indexOffset?: number
+  }
+}
+
+/**
+ * Defines a Rundler instance.
+ *
+ * @example
+ * ```ts
+ * const instance = rundler({
+ *  nodeHttp: 'http://localhost:8545',
+ * });
+ *
+ * await instance.start()
+ * // ...
+ * await instance.stop()
+ * ```
+ */
+export const rundler = defineInstance((parameters?: RundlerParameters) => {
+  const { binary = 'rundler', ...args } = (parameters ??
+    {}) as RundlerParameters
+
+  const host = '127.0.0.1'
+  const name = 'rundler'
+  const process = execa({ name })
+
+  return {
+    _internal: {
+      args,
+      get process() {
+        return process._internal.process
+      },
+    },
+    host,
+    port: args.rpc?.port ?? 3000,
+    name,
+    async start({ port = args.rpc?.port ?? 3000 }, options) {
+      const args_ = {
+        ...args,
+        builder: {
+          ...args.builder,
+          privateKey:
+            args.builder?.privateKey ??
+            '0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80',
+        },
+        entryPointVersion: undefined,
+        maxVerificationGas: args.maxVerificationGas ?? 10000000,
+        network: args.network ?? 'dev',
+        nodeHttp: args.nodeHttp ?? 'http://localhost:8545',
+        metrics: {
+          ...args.metrics,
+          port: await getPort(),
+        },
+        rpc: {
+          ...args.rpc,
+          port,
+        },
+        unsafe: args.unsafe ?? true,
+        userOperationEventBlockDistance:
+          args.userOperationEventBlockDistance ?? 100,
+      } satisfies RundlerParameters
+
+      const entrypointArgs = (() => {
+        if (args.entryPointVersion === '0.6.0')
+          return ['--disable_entry_point_v0_7']
+        return ['--disable_entry_point_v0_6']
+      })()
+
+      return await process.start(
+        ($) =>
+          $(
+            binary,
+            ['node', ...toArgs(args_, { casing: 'snake' }), ...entrypointArgs],
+            {
+              env: {
+                RUST_LOG: 'debug',
+              },
+            },
+          ),
+        {
+          ...options,
+          resolver({ process, reject, resolve }) {
+            process.stdout.on('data', (data) => {
+              const message = data.toString()
+              if (message.includes('Started RPC server')) resolve()
+            })
+            process.stderr.on('data', (data) => {
+              reject(data.toString())
+            })
+          },
+        },
+      )
+    },
+    async stop() {
+      await process.stop()
+    },
+  }
+})