@keelcodes/self-host 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 Keel contributors
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -1,3 +1,88 @@
-# Temporary Holding Version
+# @keelcodes/self-host
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The **reference self-host stack** for Keel: a complete ERC-4337 environment with
+no hosted provider in the loop — the OxaChain path, and the local sandbox every
+other chain can be developed against.
+
+The deployable artifact is [`infra/docker-compose.yml`](../../infra/docker-compose.yml).
+This package is its typed companion — the service model, the endpoint derivation
+and the readiness probes — and it has **no runtime dependencies**.
+
+## The stack
+
+| Service | Image | Role | Port |
+|---|---|---|---|
+| `anvil` | `ghcr.io/foundry-rs/foundry` | local EVM node, chain `31337` | `8545` |
+| `contract-deployer` | `ghcr.io/pimlicolabs/mock-contract-deployer` | one-shot: EntryPoint + account factories | — |
+| `bundler` | `ghcr.io/pimlicolabs/alto` | ERC-4337 bundler | `4337` |
+| `paymaster` | `ghcr.io/pimlicolabs/mock-verifying-paymaster` | ERC-7677 paymaster service | `3000` |
+
+```bash
+docker compose -f infra/docker-compose.yml up
+```
+
+Then:
+
+```ts
+import { localEndpoints, stackRpc, waitForStack, type FetchLike } from '@keelcodes/self-host';
+
+const endpoints = localEndpoints();          // { chainId: 31337, rpcUrl, bundlerUrl, paymasterUrl }
+const fetchImpl = fetch as unknown as FetchLike;
+const { chain, bundler, paymaster } = stackRpc(endpoints, fetchImpl);
+
+const readiness = await waitForStack({ chain, bundler, chainId: endpoints.chainId });
+// { chain: true, bundler: true, ready: true, timedOut: false, elapsedMs: … }
+```
+
+Point the rest of Keel at the same endpoints:
+
+```ts
+import { createBundlerAdapter, createPaymasterAdapter } from '@keelcodes/adapters';
+
+const bundlerAdapter = createBundlerAdapter('skandha', { url: endpoints.bundlerUrl });
+const paymasterAdapter = createPaymasterAdapter('pimlico', { url: endpoints.paymasterUrl });
+```
+
+The `kind` is only used for a provider's built-in URL layout; a self-hosted
+endpoint always supplies an explicit `url`, so any kind works.
+
+## Why these services
+
+- **anvil** — a deterministic local chain; its dev accounts and mnemonic
+  ([`ANVIL_MNEMONIC`](./src/stack.ts)) are public and funded on a local chain only.
+- **contract-deployer** — deploys the canonical EntryPoint (v0.6 / v0.7 / v0.8)
+  and the Kernel / Nexus / Safe7579 account factories, so a fresh stack is usable
+  with no manual deploy step.
+- **bundler (Alto)** — Pimlico's open-source bundler, driven by
+  [`infra/alto-config.json`](../../infra/alto-config.json).
+- **paymaster** — the mock ERC-7677 service forwards every bundler method to the
+  bundler, so it doubles as a drop-in bundler URL, exactly how a hosted provider
+  exposes one URL for both.
+
+## Model
+
+`SELF_HOST_SERVICES` is the machine-readable mirror of the compose file: the same
+names, images, ports and dependencies. `localEndpoints()` derives the three URLs
+from a host and port set, and the probes talk to injected `RpcCall` ports so they
+run in CI with no chain and no network:
+
+- `checkChain(rpc, chainId)` — `eth_chainId` matches.
+- `checkBundler(rpc)` — `eth_supported_entryPoints` is non-empty.
+- `waitForStack({ chain, bundler, ... })` — polls until both hold or the timeout
+  elapses. A probe that throws counts as "not ready yet", so a booting stack
+  never surfaces as an error. The paymaster is not polled: it forwards to the
+  bundler, so bundler readiness is the last thing to arrive.
+
+## Images and licensing
+
+This compose file pulls **third-party images**; they are not built or distributed
+by Keel. Alto and the two mock services are published by Pimlico (Alto is
+GPL-3.0). Pin every image to a digest before running this anywhere but a sandbox,
+and swap the mock paymaster for a real verifying paymaster service in production.
+
+## Develop
+
+```bash
+pnpm --filter @keelcodes/self-host test
+pnpm --filter @keelcodes/self-host typecheck
+```

package/dist/endpoints.d.ts

@@ -0,0 +1,26 @@
+export interface LocalStackPorts {
+    anvil: number;
+    bundler: number;
+    paymaster: number;
+}
+export interface LocalStackOptions {
+    /** Host the stack runs on. Defaults to `127.0.0.1`. */
+    host?: string;
+    /** Overrides for the published ports. */
+    ports?: Partial<LocalStackPorts>;
+    /** Expected chain id. Defaults to {@link LOCAL_CHAIN_ID}. */
+    chainId?: number;
+}
+/** The three JSON-RPC endpoints the reference stack exposes. */
+export interface LocalStackEndpoints {
+    chainId: number;
+    rpcUrl: string;
+    bundlerUrl: string;
+    paymasterUrl: string;
+}
+/**
+ * Derives the endpoints of the local reference stack, so a consumer can point
+ * `@keelcodes/adapters` (or any ERC-4337 client) at it without hardcoding ports.
+ */
+export declare function localEndpoints(options?: LocalStackOptions): LocalStackEndpoints;
+//# sourceMappingURL=endpoints.d.ts.map

package/dist/endpoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoints.d.ts","sourceRoot":"","sources":["../src/endpoints.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,KAAK,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IACjC,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,gEAAgE;AAChE,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,iBAAsB,GAAG,mBAAmB,CASnF"}

package/dist/endpoints.js

@@ -0,0 +1,16 @@
+import { DEFAULT_LOCAL_PORTS, LOCAL_CHAIN_ID } from './stack.js';
+/**
+ * Derives the endpoints of the local reference stack, so a consumer can point
+ * `@keelcodes/adapters` (or any ERC-4337 client) at it without hardcoding ports.
+ */
+export function localEndpoints(options = {}) {
+    const host = options.host ?? '127.0.0.1';
+    const ports = { ...DEFAULT_LOCAL_PORTS, ...options.ports };
+    return {
+        chainId: options.chainId ?? LOCAL_CHAIN_ID,
+        rpcUrl: `http://${host}:${ports.anvil}`,
+        bundlerUrl: `http://${host}:${ports.bundler}`,
+        paymasterUrl: `http://${host}:${ports.paymaster}`,
+    };
+}
+//# sourceMappingURL=endpoints.js.map

package/dist/endpoints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoints.js","sourceRoot":"","sources":["../src/endpoints.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAyBjE;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,UAA6B,EAAE;IAC5D,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,WAAW,CAAC;IACzC,MAAM,KAAK,GAAoB,EAAE,GAAG,mBAAmB,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAC5E,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,cAAc;QAC1C,MAAM,EAAE,UAAU,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE;QACvC,UAAU,EAAE,UAAU,IAAI,IAAI,KAAK,CAAC,OAAO,EAAE;QAC7C,YAAY,EAAE,UAAU,IAAI,IAAI,KAAK,CAAC,SAAS,EAAE;KAClD,CAAC;AACJ,CAAC"}

package/dist/health.d.ts

@@ -0,0 +1,35 @@
+import type { RpcCall } from './rpc.js';
+/** The chain is up and reporting the expected chain id. */
+export declare function checkChain(rpc: RpcCall, expectedChainId: number): Promise<boolean>;
+/** The bundler is up and advertising at least one EntryPoint. */
+export declare function checkBundler(rpc: RpcCall): Promise<boolean>;
+export interface StackReadiness {
+    chain: boolean;
+    bundler: boolean;
+    ready: boolean;
+    timedOut: boolean;
+    elapsedMs: number;
+}
+export interface WaitForStackOptions {
+    chain: RpcCall;
+    bundler: RpcCall;
+    chainId: number;
+    /** Give up after this long. Defaults to 30s. */
+    timeoutMs?: number;
+    /** Delay between attempts. Defaults to 250ms. */
+    intervalMs?: number;
+    /** Clock, injectable for tests. Defaults to `Date.now`. */
+    now?: () => number;
+    /** Sleep, injectable for tests. Defaults to a timer. */
+    sleep?: (ms: number) => Promise<void>;
+}
+/**
+ * Polls the stack until the chain and the bundler are both up, or the timeout
+ * elapses. A probe that throws counts as "not ready yet", so a stack that is
+ * still booting never surfaces as an error.
+ *
+ * The paymaster is intentionally not polled: it forwards to the bundler, so
+ * bundler readiness is the last thing to arrive.
+ */
+export declare function waitForStack(options: WaitForStackOptions): Promise<StackReadiness>;
+//# sourceMappingURL=health.d.ts.map

package/dist/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../src/health.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAExC,2DAA2D;AAC3D,wBAAsB,UAAU,CAAC,GAAG,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGxF;AAED,iEAAiE;AACjE,wBAAsB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAGjE;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,wDAAwD;IACxD,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAsBD;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC,CA2BxF"}

package/dist/health.js

@@ -0,0 +1,61 @@
+/** The chain is up and reporting the expected chain id. */
+export async function checkChain(rpc, expectedChainId) {
+    const raw = await rpc('eth_chainId');
+    return typeof raw === 'string' && Number.parseInt(raw, 16) === expectedChainId;
+}
+/** The bundler is up and advertising at least one EntryPoint. */
+export async function checkBundler(rpc) {
+    const raw = await rpc('eth_supportedEntryPoints');
+    return Array.isArray(raw) && raw.length > 0;
+}
+function defaultSleep(ms) {
+    const setTimer = globalThis.setTimeout;
+    if (setTimer === undefined) {
+        throw new Error('waitForStack: no timer available; pass options.sleep');
+    }
+    return new Promise((resolve) => {
+        setTimer(() => resolve(), ms);
+    });
+}
+async function safely(fn) {
+    try {
+        return await fn();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Polls the stack until the chain and the bundler are both up, or the timeout
+ * elapses. A probe that throws counts as "not ready yet", so a stack that is
+ * still booting never surfaces as an error.
+ *
+ * The paymaster is intentionally not polled: it forwards to the bundler, so
+ * bundler readiness is the last thing to arrive.
+ */
+export async function waitForStack(options) {
+    const now = options.now ?? Date.now;
+    const sleep = options.sleep ?? defaultSleep;
+    const timeoutMs = options.timeoutMs ?? 30_000;
+    const intervalMs = options.intervalMs ?? 250;
+    const startedAt = now();
+    let chain = false;
+    let bundler = false;
+    while (!(chain && bundler)) {
+        if (!chain) {
+            chain = await safely(() => checkChain(options.chain, options.chainId));
+        }
+        if (chain && !bundler) {
+            bundler = await safely(() => checkBundler(options.bundler));
+        }
+        if (chain && bundler)
+            break;
+        const elapsedMs = now() - startedAt;
+        if (elapsedMs >= timeoutMs) {
+            return { chain, bundler, ready: false, timedOut: true, elapsedMs };
+        }
+        await sleep(intervalMs);
+    }
+    return { chain, bundler, ready: true, timedOut: false, elapsedMs: now() - startedAt };
+}
+//# sourceMappingURL=health.js.map

package/dist/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../src/health.ts"],"names":[],"mappings":"AAEA,2DAA2D;AAC3D,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAY,EAAE,eAAuB;IACpE,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,aAAa,CAAC,CAAC;IACrC,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,eAAe,CAAC;AACjF,CAAC;AAED,iEAAiE;AACjE,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAY;IAC7C,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,0BAA0B,CAAC,CAAC;IAClD,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC;AAC9C,CAAC;AA0BD,SAAS,YAAY,CAAC,EAAU;IAC9B,MAAM,QAAQ,GAAI,UAAwB,CAAC,UAAU,CAAC;IACtD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,QAAQ,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,MAAM,CAAC,EAA0B;IAC9C,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,EAAE,CAAC;IACpB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAA4B;IAC7D,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;IACpC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,YAAY,CAAC;IAC5C,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC;IAC9C,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,GAAG,CAAC;IAC7C,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC;IAExB,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,OAAO,CAAC,CAAC,KAAK,IAAI,OAAO,CAAC,EAAE,CAAC;QAC3B,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,KAAK,GAAG,MAAM,MAAM,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;QACzE,CAAC;QACD,IAAI,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;YACtB,OAAO,GAAG,MAAM,MAAM,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;QAC9D,CAAC;QACD,IAAI,KAAK,IAAI,OAAO;YAAE,MAAM;QAE5B,MAAM,SAAS,GAAG,GAAG,EAAE,GAAG,SAAS,CAAC;QACpC,IAAI,SAAS,IAAI,SAAS,EAAE,CAAC;YAC3B,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QACrE,CAAC;QACD,MAAM,KAAK,CAAC,UAAU,CAAC,CAAC;IAC1B,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,SAAS,EAAE,CAAC;AACxF,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @keelcodes/self-host
+ *
+ * The reference stack a Keel consumer runs when it wants no hosted bundler or
+ * paymaster in the loop — the OxaChain path, and the local sandbox every other
+ * chain can be tested against.
+ *
+ * The deployable artifact is
+ * [`infra/docker-compose.yml`](../../../infra/docker-compose.yml); this package
+ * is its typed companion: the service model, the endpoint derivation and the
+ * readiness probes. It has no runtime dependencies.
+ */
+export { ANVIL_MNEMONIC, DEFAULT_LOCAL_PORTS, LOCAL_CHAIN_ID, SELF_HOST_SERVICES, } from './stack.js';
+export type { StackService, StackServiceRole } from './stack.js';
+export { localEndpoints } from './endpoints.js';
+export type { LocalStackEndpoints, LocalStackOptions, LocalStackPorts } from './endpoints.js';
+export { httpRpc, stackRpc } from './rpc.js';
+export type { FetchLike, JsonRpcError, JsonRpcRequest, JsonRpcResponse, RpcCall, StackRpc, } from './rpc.js';
+export { checkBundler, checkChain, waitForStack } from './health.js';
+export type { StackReadiness, WaitForStackOptions } from './health.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,kBAAkB,GACnB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEjE,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,YAAY,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAE9F,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAC7C,YAAY,EACV,SAAS,EACT,YAAY,EACZ,cAAc,EACd,eAAe,EACf,OAAO,EACP,QAAQ,GACT,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACrE,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+/**
+ * @keelcodes/self-host
+ *
+ * The reference stack a Keel consumer runs when it wants no hosted bundler or
+ * paymaster in the loop — the OxaChain path, and the local sandbox every other
+ * chain can be tested against.
+ *
+ * The deployable artifact is
+ * [`infra/docker-compose.yml`](../../../infra/docker-compose.yml); this package
+ * is its typed companion: the service model, the endpoint derivation and the
+ * readiness probes. It has no runtime dependencies.
+ */
+export { ANVIL_MNEMONIC, DEFAULT_LOCAL_PORTS, LOCAL_CHAIN_ID, SELF_HOST_SERVICES, } from './stack.js';
+export { localEndpoints } from './endpoints.js';
+export { httpRpc, stackRpc } from './rpc.js';
+export { checkBundler, checkChain, waitForStack } from './health.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGhD,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAU7C,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/rpc.d.ts

@@ -0,0 +1,42 @@
+import type { LocalStackEndpoints } from './endpoints.js';
+/** A minimal JSON-RPC request envelope. */
+export interface JsonRpcRequest {
+    jsonrpc: '2.0';
+    id: number;
+    method: string;
+    params: readonly unknown[];
+}
+export interface JsonRpcError {
+    code: number;
+    message: string;
+}
+export interface JsonRpcResponse {
+    result?: unknown;
+    error?: JsonRpcError;
+}
+/**
+ * The subset of `fetch` this package needs. Injectable so the probes run in
+ * tests and CI with no network, mirroring the port style used across Keel.
+ */
+export type FetchLike = (url: string, init: {
+    method: string;
+    headers: Record<string, string>;
+    body: string;
+}) => Promise<{
+    ok: boolean;
+    status: number;
+    json(): Promise<unknown>;
+}>;
+/** A single JSON-RPC method call bound to one endpoint. */
+export type RpcCall = (method: string, params?: readonly unknown[]) => Promise<unknown>;
+/** Builds an {@link RpcCall} for one JSON-RPC endpoint over an injected fetch. */
+export declare function httpRpc(url: string, fetchImpl: FetchLike): RpcCall;
+/** One {@link RpcCall} per stack endpoint. */
+export interface StackRpc {
+    chain: RpcCall;
+    bundler: RpcCall;
+    paymaster: RpcCall;
+}
+/** Binds the three stack endpoints to JSON-RPC calls. */
+export declare function stackRpc(endpoints: LocalStackEndpoints, fetchImpl: FetchLike): StackRpc;
+//# sourceMappingURL=rpc.d.ts.map

package/dist/rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.d.ts","sourceRoot":"","sources":["../src/rpc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,2CAA2C;AAC3C,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,SAAS,OAAO,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,CACtB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,KACpE,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;CAAE,CAAC,CAAC;AAExE,2DAA2D;AAC3D,MAAM,MAAM,OAAO,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAExF,kFAAkF;AAClF,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAkBlE;AAED,8CAA8C;AAC9C,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,yDAAyD;AACzD,wBAAgB,QAAQ,CAAC,SAAS,EAAE,mBAAmB,EAAE,SAAS,EAAE,SAAS,GAAG,QAAQ,CAMvF"}

package/dist/rpc.js

@@ -0,0 +1,29 @@
+/** Builds an {@link RpcCall} for one JSON-RPC endpoint over an injected fetch. */
+export function httpRpc(url, fetchImpl) {
+    let id = 0;
+    return async (method, params = []) => {
+        const request = { jsonrpc: '2.0', id: ++id, method, params };
+        const response = await fetchImpl(url, {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify(request),
+        });
+        if (!response.ok) {
+            throw new Error(`rpc ${method}: HTTP ${response.status}`);
+        }
+        const payload = (await response.json());
+        if (payload.error) {
+            throw new Error(`rpc ${method}: ${payload.error.code} ${payload.error.message}`);
+        }
+        return payload.result;
+    };
+}
+/** Binds the three stack endpoints to JSON-RPC calls. */
+export function stackRpc(endpoints, fetchImpl) {
+    return {
+        chain: httpRpc(endpoints.rpcUrl, fetchImpl),
+        bundler: httpRpc(endpoints.bundlerUrl, fetchImpl),
+        paymaster: httpRpc(endpoints.paymasterUrl, fetchImpl),
+    };
+}
+//# sourceMappingURL=rpc.js.map

package/dist/rpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.js","sourceRoot":"","sources":["../src/rpc.ts"],"names":[],"mappings":"AAgCA,kFAAkF;AAClF,MAAM,UAAU,OAAO,CAAC,GAAW,EAAE,SAAoB;IACvD,IAAI,EAAE,GAAG,CAAC,CAAC;IACX,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,GAAG,EAAE,EAAE,EAAE;QACnC,MAAM,OAAO,GAAmB,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QAC7E,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE;YACpC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;SAC9B,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,OAAO,MAAM,UAAU,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAC5D,CAAC;QACD,MAAM,OAAO,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAoB,CAAC;QAC3D,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,OAAO,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACnF,CAAC;QACD,OAAO,OAAO,CAAC,MAAM,CAAC;IACxB,CAAC,CAAC;AACJ,CAAC;AASD,yDAAyD;AACzD,MAAM,UAAU,QAAQ,CAAC,SAA8B,EAAE,SAAoB;IAC3E,OAAO;QACL,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,MAAM,EAAE,SAAS,CAAC;QAC3C,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,UAAU,EAAE,SAAS,CAAC;QACjD,SAAS,EAAE,OAAO,CAAC,SAAS,CAAC,YAAY,EAAE,SAAS,CAAC;KACtD,CAAC;AACJ,CAAC"}

package/dist/stack.d.ts

@@ -0,0 +1,41 @@
+/**
+ * The self-host reference stack, as data.
+ *
+ * This is the machine-readable mirror of [`infra/docker-compose.yml`](../../../infra/docker-compose.yml):
+ * one entry per service, with the same image, port and dependency wiring the
+ * compose file declares. Keeping it here lets the endpoint model and the
+ * readiness probes share a single, testable description instead of scraping the
+ * YAML.
+ *
+ * The stack is deliberately small and neutral — a chain, a deployer, a bundler
+ * and a paymaster — because that is the minimum a Keel consumer needs to run
+ * ERC-4337 user operations with no hosted provider in the loop.
+ */
+/** The reference chain's id (Foundry's default). */
+export declare const LOCAL_CHAIN_ID = 31337;
+/**
+ * Foundry's canonical development mnemonic. Every account it derives is public
+ * and funded on a local chain only — never point this at anything else.
+ */
+export declare const ANVIL_MNEMONIC = "test test test test test test test test test test test junk";
+/** Host ports the compose stack publishes. */
+export declare const DEFAULT_LOCAL_PORTS: {
+    readonly anvil: 8545;
+    readonly bundler: 4337;
+    readonly paymaster: 3000;
+};
+export type StackServiceRole = 'chain' | 'deployer' | 'bundler' | 'paymaster';
+/** One service in the reference stack. */
+export interface StackService {
+    name: string;
+    image: string;
+    role: StackServiceRole;
+    /** Host port published by the service, when it exposes one. */
+    port?: number;
+    /** Services that must be healthy (or completed) first. */
+    dependsOn?: readonly string[];
+    note: string;
+}
+/** The reference stack, in dependency order. */
+export declare const SELF_HOST_SERVICES: readonly StackService[];
+//# sourceMappingURL=stack.d.ts.map

package/dist/stack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack.d.ts","sourceRoot":"","sources":["../src/stack.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,oDAAoD;AACpD,eAAO,MAAM,cAAc,QAAQ,CAAC;AAEpC;;;GAGG;AACH,eAAO,MAAM,cAAc,gEACoC,CAAC;AAEhE,8CAA8C;AAC9C,eAAO,MAAM,mBAAmB;;;;CAItB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,WAAW,CAAC;AAE9E,0CAA0C;AAC1C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,gBAAgB,CAAC;IACvB,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,gDAAgD;AAChD,eAAO,MAAM,kBAAkB,EAAE,SAAS,YAAY,EA+BrD,CAAC"}

package/dist/stack.js

@@ -0,0 +1,60 @@
+/**
+ * The self-host reference stack, as data.
+ *
+ * This is the machine-readable mirror of [`infra/docker-compose.yml`](../../../infra/docker-compose.yml):
+ * one entry per service, with the same image, port and dependency wiring the
+ * compose file declares. Keeping it here lets the endpoint model and the
+ * readiness probes share a single, testable description instead of scraping the
+ * YAML.
+ *
+ * The stack is deliberately small and neutral — a chain, a deployer, a bundler
+ * and a paymaster — because that is the minimum a Keel consumer needs to run
+ * ERC-4337 user operations with no hosted provider in the loop.
+ */
+/** The reference chain's id (Foundry's default). */
+export const LOCAL_CHAIN_ID = 31337;
+/**
+ * Foundry's canonical development mnemonic. Every account it derives is public
+ * and funded on a local chain only — never point this at anything else.
+ */
+export const ANVIL_MNEMONIC = 'test test test test test test test test test test test junk';
+/** Host ports the compose stack publishes. */
+export const DEFAULT_LOCAL_PORTS = {
+    anvil: 8545,
+    bundler: 4337,
+    paymaster: 3000,
+};
+/** The reference stack, in dependency order. */
+export const SELF_HOST_SERVICES = [
+    {
+        name: 'anvil',
+        image: 'ghcr.io/foundry-rs/foundry:latest',
+        role: 'chain',
+        port: 8545,
+        note: `local EVM node, chain ${LOCAL_CHAIN_ID}, deterministic dev accounts`,
+    },
+    {
+        name: 'contract-deployer',
+        image: 'ghcr.io/pimlicolabs/mock-contract-deployer:main',
+        role: 'deployer',
+        dependsOn: ['anvil'],
+        note: 'one-shot: deploys EntryPoint and the account factories, then exits',
+    },
+    {
+        name: 'bundler',
+        image: 'ghcr.io/pimlicolabs/alto:latest',
+        role: 'bundler',
+        port: 4337,
+        dependsOn: ['anvil', 'contract-deployer'],
+        note: 'ERC-4337 bundler (Alto), driven by infra/alto-config.json',
+    },
+    {
+        name: 'paymaster',
+        image: 'ghcr.io/pimlicolabs/mock-verifying-paymaster:main',
+        role: 'paymaster',
+        port: 3000,
+        dependsOn: ['anvil', 'contract-deployer'],
+        note: 'ERC-7677 paymaster service; the mock forwards to the bundler',
+    },
+];
+//# sourceMappingURL=stack.js.map

package/dist/stack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack.js","sourceRoot":"","sources":["../src/stack.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,oDAAoD;AACpD,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,CAAC;AAEpC;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GACzB,6DAA6D,CAAC;AAEhE,8CAA8C;AAC9C,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,KAAK,EAAE,IAAI;IACX,OAAO,EAAE,IAAI;IACb,SAAS,EAAE,IAAI;CACP,CAAC;AAgBX,gDAAgD;AAChD,MAAM,CAAC,MAAM,kBAAkB,GAA4B;IACzD;QACE,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,mCAAmC;QAC1C,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,IAAI;QACV,IAAI,EAAE,yBAAyB,cAAc,8BAA8B;KAC5E;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,KAAK,EAAE,iDAAiD;QACxD,IAAI,EAAE,UAAU;QAChB,SAAS,EAAE,CAAC,OAAO,CAAC;QACpB,IAAI,EAAE,oEAAoE;KAC3E;IACD;QACE,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,iCAAiC;QACxC,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,IAAI;QACV,SAAS,EAAE,CAAC,OAAO,EAAE,mBAAmB,CAAC;QACzC,IAAI,EAAE,2DAA2D;KAClE;IACD;QACE,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE,mDAAmD;QAC1D,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,IAAI;QACV,SAAS,EAAE,CAAC,OAAO,EAAE,mBAAmB,CAAC;QACzC,IAAI,EAAE,8DAA8D;KACrE;CACF,CAAC"}

package/package.json

@@ -1,6 +1,50 @@
 {
   "name": "@keelcodes/self-host",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Reference self-host stack for Keel: the model, endpoints and readiness probes for a local anvil + bundler + paymaster sandbox.",
+  "license": "Apache-2.0",
+  "homepage": "https://keel.codes",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/keelcodes/keel.git",
+    "directory": "packages/self-host"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "devDependencies": {
+    "vitest": "^2.1.4"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [
+    "erc-4337",
+    "account-abstraction",
+    "bundler",
+    "paymaster",
+    "anvil",
+    "self-host",
+    "docker-compose"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "clean": "rm -rf dist"
+  }
 }