chore: namespace imports

Author: jxom

.changeset/giant-knives-rhyme.md

@@ -0,0 +1,5 @@
+---
+"prool": minor
+---
+
+**Breaking:** Removed `silius` + `stackup` instances.

.changeset/lazy-toys-report.md

@@ -0,0 +1,60 @@
+---
+"prool": minor
+---
+
+**Breaking:** Refactored to use namespace imports.
+
+### Imports
+
+```diff
+- import { createServer } from 'prool'
+- import { anvil, alto, rundler } from 'prool/instances'
+- import { defineInstance } from 'prool'
+- import { definePool } from 'prool'
++ import { Instance, Pool, Server } from 'prool'
+```
+
+### `Server.create` → `Server.create`
+
+```diff
+- const server = createServer({
+-   instance: anvil(),
++ const server = Server.create({
++   instance: Instance.anvil(),
+  })
+```
+
+### `anvil`, `alto`, `rundler` → `Instance.anvil`, `Instance.alto`, `Instance.rundler`
+
+```diff
+- const instance = anvil({ ... })
++ const instance = Instance.anvil({ ... })
+
+- const instance = alto({ ... })
++ const instance = Instance.alto({ ... })
+
+- const instance = rundler({ ... })
++ const instance = Instance.rundler({ ... })
+```
+
+### `defineInstance` → `Instance.define`
+
+```diff
+- const foo = defineInstance((parameters) => {
++ const foo = Instance.define((parameters) => {
+    return {
+      name: 'foo',
+      // ...
+    }
+  })
+```
+
+### `definePool` → `Pool.define`
+
+```diff
+- const pool = definePool({
+-   instance: anvil(),
++ const pool = Pool.define({
++   instance: Instance.anvil(),
+  })
+```

README.md

@@ -39,24 +39,21 @@ 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-bundler-node)
-- **Indexer Nodes:** `ponder`⚠️
+- **ERC-4337 Bundler Nodes:** [`alto`](#alto-bundler-node), [`rundler`](#rundler-bundler-node)
 
-⚠️ = soon
-
-You can also create your own custom instances by using the [`defineInstance` function](#defineinstance).
+You can also create your own custom instances by using the [`Instance.define` function](#instancedefine).
 
 ## Table of Contents
 
 - [Install](#install)
 - [Getting Started](#getting-started)
   - [Anvil (Execution Node)](#anvil-execution-node)
-  - [Alto (Bundler Node)](#alto-bundler-node)
-  - [Rundler (Bundler Node)](#rundler-bundler-node)
+  - [Alto (ERC-4337 Bundler Node)](#alto-bundler-node)
+  - [Rundler (ERC-4337 Bundler Node)](#rundler-bundler-node)
 - [Reference](#reference)
-  - [`createServer`](#createserver)
-  - [`defineInstance`](#defineinstance)
-  - [`definePool`](#definepool)
+  - [`Server.create`](#servercreate)
+  - [`Instance.define`](#instancedefine)
+  - [`Pool.define`](#pooldefine)
 
 
 ## Install
@@ -85,11 +82,10 @@ bun i prool
 #### Usage
 
 ```ts
-import { createServer } from 'prool'
-import { anvil } from 'prool/instances'
+import { Instance, Server } from 'prool'
 
-const server = createServer({
-  instance: anvil(),
+const server = Server.create({
+  instance: Instance.anvil(),
 })
 
 await server.start() 
@@ -113,11 +109,10 @@ See [`AnvilParameters`](https://github.com/wevm/prool/blob/801ede06ded8b2cb2d59c
 #### Usage
 
 ```ts
-import { createServer } from 'prool'
-import { anvil, alto } from 'prool/instances'
+import { Instance, Server } from 'prool'
 
-const executionServer = createServer({
-  instance: anvil(),
+const executionServer = Server.create({
+  instance: Instance.anvil(),
   port: 8545
 })
 await executionServer.start() 
@@ -127,8 +122,8 @@ await executionServer.start()
 // "http://localhost:8545/3"
 // "http://localhost:8545/n"
 
-const bundlerServer = createServer({
-  instance: (key) => alto({
+const bundlerServer = Server.create({
+  instance: (key) => Instance.alto({
     entrypoints: ['0x0000000071727De22E5E9d8BAf0edAc6f37da032'],
     rpcUrl: `http://localhost:8545/${key}`,
     executorPrivateKeys: ['0x...'],
@@ -156,11 +151,10 @@ See [`AltoParameters`](https://github.com/wevm/prool/blob/801ede06ded8b2cb2d59c9
 #### Usage
 
 ```ts
-import { createServer } from 'prool'
-import { anvil, rundler } from 'prool/instances'
+import { Instance, Server } from 'prool'
 
-const executionServer = createServer({
-  instance: anvil(),
+const executionServer = Server.create({
+  instance: Instance.anvil(),
   port: 8545
 })
 await executionServer.start() 
@@ -170,8 +164,8 @@ await executionServer.start()
 // "http://localhost:8545/3"
 // "http://localhost:8545/n"
 
-const bundlerServer = createServer({
-  instance: (key) => rundler({
+const bundlerServer = Server.create({
+  instance: (key) => Instance.rundler({
     nodeHttp: `http://localhost:8545/${key}`,
   })
 })
@@ -189,18 +183,17 @@ See [RundlerParameters]().
 
 ## Reference
 
-### `createServer`
+### `Server.create`
 
 Creates a server that manages a pool of instances via a proxy.
 
 #### Usage
 
 ```ts
-import { createServer } from 'prool'
-import { anvil } from 'prool/instances'
+import { Instance, Server } from 'prool'
 
-const executionServer = createServer({
-  instance: anvil(),
+const executionServer = Server.create({
+  instance: Instance.anvil(),
 })
 await executionServer.start() 
 // Instances accessible at:
@@ -229,18 +222,18 @@ await executionServer.start()
 | `limit`    | Number of instances that can be instantiated in the pool | `number`                                |
 | `host`     | Host for the server.                                     | `string`                                |
 | `port`     | Port for the server.                                     | `number`                                |
-| returns    | Server                                                   | `CreateServerReturnType`                |
+| returns    | Server                                                   | `Server.Server`                         |
 
-### `defineInstance`
+### `Instance.define`
 
-Creates an instance definition, that can be used with [`createServer`](#createserver) or [`definePool`](#definepool).
+Creates an instance definition, that can be used with [`Server.create`](#servercreate) or [`Pool.define`](#pooldefine).
 
 #### Usage
 
 ```ts
-import { defineInstance } from 'prool'
+import { Instance } from 'prool'
 
-const foo = defineInstance((parameters: FooParameters) => {
+const foo = Instance.define((parameters: FooParameters) => {
  return {
    name: 'foo',
    host: 'localhost',
@@ -262,18 +255,17 @@ const foo = defineInstance((parameters: FooParameters) => {
 | `fn`    | Instance definition. | `DefineInstanceFn` |
 | returns | Instance.            | `Instance`         |
 
-### `definePool`
+### `Pool.define`
 
 Defines a pool of instances. Instances can be started, cached, and stopped against an identifier.
 
 #### Usage
 
 ```ts
-import { definePool } from 'prool'
-import { anvil } from 'prool/instances'
+import { Instance, Pool } from 'prool'
 
-const pool = definePool({
- instance: anvil(),
+const pool = Pool.define({
+ instance: Instance.anvil(),
 })
 const instance_1 = await pool.start(1)
 const instance_2 = await pool.start(2)

package.json

@@ -17,9 +17,9 @@
     "@types/http-proxy": "^1.17.17",
     "@types/node": "^24.10.2",
     "@types/ws": "^8.18.1",
-    "@vitest/coverage-v8": "^1.6.0",
+    "@vitest/coverage-v8": "^4.0.15",
     "typescript": "^5.9.3",
-    "vitest": "^1.6.0",
+    "vitest": "^4.0.15",
     "ws": "^8.18.3",
     "zile": "^0.0.13"
   },
@@ -35,19 +35,9 @@
   },
   "exports": {
     ".": {
-      "src": "./src/exports/index.ts",
-      "types": "./dist/exports/index.d.ts",
-      "default": "./dist/exports/index.js"
-    },
-    "./processes": {
-      "src": "./src/exports/processes.ts",
-      "types": "./dist/exports/processes.d.ts",
-      "default": "./dist/exports/processes.js"
-    },
-    "./instances": {
-      "src": "./src/exports/instances.ts",
-      "types": "./dist/exports/instances.d.ts",
-      "default": "./dist/exports/instances.js"
+      "src": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
     }
   },
   "dependencies": {
@@ -80,7 +70,7 @@
     }
   ],
   "keywords": [],
-  "main": "./dist/exports/index.js",
-  "module": "./dist/exports/index.js",
-  "types": "./dist/exports/index.d.ts"
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts"
 }