@keelcodes/adapters 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,173 @@
-# Temporary Holding Version
+# @keelcodes/adapters
+
+Thin adapters that expose different smart-account implementations behind a
+single interface.
+
+## Principle
+
+Keel does **not** implement account modules. Every supported account already
+speaks **ERC-7579**:
+
+- Safe7579 is itself an adapter that makes Safe ERC-7579 compatible.
+- Kernel (ZeroDev) and Nexus (Biconomy) are ERC-7579 compatible.
+
+So supporting three accounts is **one interface plus thin per-account install
+glue**, not three separate stacks.
+
+```
+            keel policy (account-agnostic)
+                       ▲
+              ERC-7579 (unified interface)
+        ┌──────────────┼──────────────┐
+      Kernel         Nexus         Safe7579
+```
+
+## Adapters
+
+| kind | account | notes |
+|---|---|---|
+| `kernel` | Kernel (ZeroDev) | version-branched validator `initData` (`0.3.0-beta` / `0.3.1`) |
+| `nexus` | Nexus (Biconomy) | standards-faithful, no install-time quirk |
+| `safe7579` | Safe7579 | account must already have Safe7579 enabled |
+
+Every adapter shares one ERC-7579 base (`ERC7579AccountAdapter`) and exposes:
+
+- `isModuleInstalled({ account, module, moduleType? })` — on-chain probe; returns
+  `false` for an undeployed account
+- `encodeInstallModule({ moduleType, module, initData? })`
+- `encodeUninstallModule({ moduleType, module, deInitData? })`
+
+Use `createAdapter(kind, { client })` when the account kind is only known at
+runtime, or instantiate a concrete adapter when it is known statically.
+
+```ts
+import { createPublicClient, http } from 'viem';
+import { bsc } from 'viem/chains';
+import { KernelAdapter, MODULE_TYPE } from '@keelcodes/adapters';
+
+const client = createPublicClient({ chain: bsc, transport: http() });
+const kernel = new KernelAdapter({ client }); // defaults to Kernel 0.3.1
+
+await kernel.isModuleInstalled({ account, module });
+
+const initData = kernel.encodeValidatorInstallData(enableData); // Kernel layout
+const call = kernel.encodeInstallModule({
+  moduleType: MODULE_TYPE.VALIDATOR,
+  module,
+  initData,
+});
+// → wrap `call` in the account's execute() inside a UserOp
+```
+
+## Module probe
+
+`createViemModuleProbe(client)` returns the two-sided ERC-7579 probe that
+`@keelcodes/migrate` consumes: `isModuleInstalled` asks the **account** whether a
+module is registered, and `isModuleInitialized` asks the **module** whether it
+stored state for the account. Modules that do not implement `isInitialized`
+revert, so the probe catches that and returns `false` — a silent no-op install
+surfaces as data instead of an exception. The return value is structurally
+compatible with migrate's `ModuleProbe`; the packages stay decoupled (no import
+either way).
+
+```ts
+import { createPublicClient, http } from 'viem';
+import { bsc } from 'viem/chains';
+import { createViemModuleProbe } from '@keelcodes/adapters';
+
+const probe = createViemModuleProbe(createPublicClient({ chain: bsc, transport: http() }));
+await probe.isModuleInstalled({ account, module, moduleTypeId: 4n });
+await probe.isModuleInitialized(module, account); // false on revert, never throws
+```
+
+### Fork drill
+
+`pnpm --filter @keelcodes/adapters fork-drill` forks BSC with anvil (port 8546),
+validates the real address book, deploys Keel's own validator, hook and minimal
+account to the fork, and runs the probe positive and negative — no credentials,
+no real transactions. Override the fork source with `BSC_RPC_URL`; the drill
+always tears the fork down and exits non-zero on any failed assertion.
+
+### Migration drill
+
+`pnpm --filter @keelcodes/adapters migration-drill` forks BSC with anvil (port
+8547) and rehearses the path the fork drill does **not** cover: installing Keel
+onto an account that **already exists**, rather than at creation. It creates a
+Rhinestone MSA without the hook, drives the real `@keelcodes/migrate` state
+machine (`routeSession` → `migrateSession`) with the real two-sided probe, then
+hot-installs the hook in a **separate** transaction from the account itself
+(`installModule(4, hook, initData)`), asserts the account address is unchanged,
+and confirms the cut-over only once both probe halves hold. It exits non-zero on
+any failed assertion. (Requires this package and `packages/migrate` built.)
+
+Two findings it reports rather than hides:
+
+- **The state machine refuses to confirm a migration on absent evidence** —
+  `migrateSession` before the install lands in `exception`, never `migrated`.
+- **On accounts that gate module management with their hook** (the MSA's
+  `withHook` passes `uninstallModule` calldata to `preCheck`, which only parses
+  `execute(...)`), the on-chain **reverse is refused**: the drill attempts it and
+  asserts the migrated state is left intact. Kernel does not gate module
+  management this way, so a reverse there needs its own rehearsal.
+
+## Bundler & paymaster
+
+Bundlers and paymaster services are both addressed **per chain** — ERC-7677 states
+that paymaster service URLs are "not typically multichain" — so adapters resolve an
+endpoint per chain rather than assuming one multichain URL.
+
+```ts
+import { createBundlerAdapter, createPaymasterAdapter, BUNDLER_RPC, PAYMASTER_RPC } from '@keelcodes/adapters';
+
+const bundler = createBundlerAdapter('pimlico', { apiKey: process.env.PIMLICO_KEY! });
+bundler.endpoint({ chainId: 56 }).url; // https://api.pimlico.io/v2/56/rpc?apikey=...
+BUNDLER_RPC.sendUserOperation;         // 'eth_sendUserOperation'
+
+const paymaster = createPaymasterAdapter('alchemy', { urls: { 8453: 'https://…/paymaster' } });
+paymaster.endpoint({ chainId: 8453 }).url;
+PAYMASTER_RPC.getPaymasterStubData;    // 'pm_getPaymasterStubData'
+```
+
+Endpoint precedence is `urls[chainId]` → `url` → provider builder, and a missing
+endpoint throws rather than dialling the wrong host.
+
+Keel hardcodes a URL builder **only for Pimlico** (a stable, public layout); every
+other provider's endpoint is caller-supplied, so a provider re-sharding its URL can
+never silently break a consumer. Adapters resolve endpoints only — they do **not**
+implement the JSON-RPC calls.
+
+## Chains
+
+`chains.ts` is the single source of truth for which chains Keel ships defaults
+for and which account kinds run on them. The per-chain `accountKinds` are
+derived from the per-account chain sets, so the two can never drift.
+
+`DEFAULT_CHAIN_ID` is **BSC mainnet** — the primary launch chain, and the chain
+the fleet is deployed on. Testnets remain in the per-account chain sets but are
+no longer the default.
+
+```ts
+import { DEFAULT_CHAIN_ID, accountsFor, getChain } from '@keelcodes/adapters';
+
+getChain(DEFAULT_CHAIN_ID); // { chainId: 56, name: 'BNB Smart Chain', testnet: false, accountKinds: ['kernel', 'safe7579'] }
+accountsFor(8453);          // ['kernel', 'nexus', 'safe7579']
+```
+
+`getChain` / `accountsFor` throw on an unknown chain rather than returning a
+partial default, so a typo surfaces as a config error.
+
+## Status
+
+- ✅ Account adapters (Kernel / Nexus / Safe7579)
+- ✅ Bundler endpoint adapters (Pimlico, Alchemy, CDP, Skandha, Rundler, MegaFuel)
+- ✅ Paymaster endpoint adapters (ERC-7677: Pimlico, Alchemy, CDP, MegaFuel)
+- ✅ Multi-chain configuration helper (`CHAINS` / `getChain` / `accountsFor`)
+
+Pre-alpha. The public API is not stable yet.
+
+## Out of scope
+
+- Account module implementations
+- Bundler or paymaster implementations
+- Custody, billing, multi-tenancy
 
-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.

package/dist/abi.d.ts

@@ -0,0 +1,84 @@
+/**
+ * ERC-7579 account module-manager surface, shared by Kernel, Nexus and
+ * Safe7579. All three speak this exact ABI, which is why Keel needs a single
+ * base implementation plus three thin account-specific shims.
+ */
+export declare const erc7579AccountAbi: readonly [{
+    readonly name: "isModuleInstalled";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly type: "uint256";
+        readonly name: "moduleTypeId";
+    }, {
+        readonly type: "address";
+        readonly name: "module";
+    }, {
+        readonly type: "bytes";
+        readonly name: "additionalContext";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "bool";
+    }];
+}, {
+    readonly name: "installModule";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly type: "uint256";
+        readonly name: "moduleTypeId";
+    }, {
+        readonly type: "address";
+        readonly name: "module";
+    }, {
+        readonly type: "bytes";
+        readonly name: "initData";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly name: "uninstallModule";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly type: "uint256";
+        readonly name: "moduleTypeId";
+    }, {
+        readonly type: "address";
+        readonly name: "module";
+    }, {
+        readonly type: "bytes";
+        readonly name: "deInitData";
+    }];
+    readonly outputs: readonly [];
+}];
+/**
+ * The ERC-7579 `IModule` surface a module exposes about itself. `isInitialized`
+ * is the module-side half of the migration probe: it reports whether the module
+ * actually stored state for an account during `onInstall`, which is the fact an
+ * AA24-class silent no-op install gets wrong while `isModuleInstalled` on the
+ * account still returns true.
+ */
+export declare const erc7579ModuleAbi: readonly [{
+    readonly name: "isInitialized";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly type: "address";
+        readonly name: "smartAccount";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "bool";
+    }];
+}, {
+    readonly name: "isModuleType";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly type: "uint256";
+        readonly name: "moduleTypeId";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "bool";
+    }];
+}];
+//# sourceMappingURL=abi.d.ts.map

package/dist/abi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abi.d.ts","sourceRoot":"","sources":["../src/abi.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAI5B,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;EAG3B,CAAC"}

package/dist/abi.js

@@ -0,0 +1,23 @@
+import { parseAbi } from 'viem';
+/**
+ * ERC-7579 account module-manager surface, shared by Kernel, Nexus and
+ * Safe7579. All three speak this exact ABI, which is why Keel needs a single
+ * base implementation plus three thin account-specific shims.
+ */
+export const erc7579AccountAbi = parseAbi([
+    'function isModuleInstalled(uint256 moduleTypeId, address module, bytes additionalContext) view returns (bool)',
+    'function installModule(uint256 moduleTypeId, address module, bytes initData)',
+    'function uninstallModule(uint256 moduleTypeId, address module, bytes deInitData)',
+]);
+/**
+ * The ERC-7579 `IModule` surface a module exposes about itself. `isInitialized`
+ * is the module-side half of the migration probe: it reports whether the module
+ * actually stored state for an account during `onInstall`, which is the fact an
+ * AA24-class silent no-op install gets wrong while `isModuleInstalled` on the
+ * account still returns true.
+ */
+export const erc7579ModuleAbi = parseAbi([
+    'function isInitialized(address smartAccount) view returns (bool)',
+    'function isModuleType(uint256 moduleTypeId) view returns (bool)',
+]);
+//# sourceMappingURL=abi.js.map

package/dist/abi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abi.js","sourceRoot":"","sources":["../src/abi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAEhC;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,QAAQ,CAAC;IACxC,+GAA+G;IAC/G,8EAA8E;IAC9E,kFAAkF;CACnF,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,QAAQ,CAAC;IACvC,kEAAkE;IAClE,iEAAiE;CAClE,CAAC,CAAC"}

package/dist/bundler.d.ts

@@ -0,0 +1,24 @@
+import { type EndpointResolver, type EndpointResolverOptions } from './endpoints.js';
+/** Bundler providers Keel ships endpoint glue for. */
+export type BundlerKind = 'pimlico' | 'alchemy' | 'cdp' | 'skandha' | 'rundler' | 'megafuel';
+/** Standard ERC-4337 bundler JSON-RPC methods. */
+export declare const BUNDLER_RPC: {
+    readonly sendUserOperation: "eth_sendUserOperation";
+    readonly estimateUserOperationGas: "eth_estimateUserOperationGas";
+    readonly getUserOperationReceipt: "eth_getUserOperationReceipt";
+    readonly getUserOperationByHash: "eth_getUserOperationByHash";
+    readonly supportedEntryPoints: "eth_supportedEntryPoints";
+};
+/** Resolves the bundler endpoint for a chain. */
+export type BundlerAdapter = EndpointResolver<BundlerKind>;
+export type BundlerAdapterOptions = EndpointResolverOptions;
+/**
+ * Builds a bundler adapter. Only `pimlico` has a built-in URL builder (see
+ * {@link pimlicoUrl}); every other kind requires an explicit `url`/`urls`,
+ * because their endpoints are account- or deployment-specific.
+ *
+ * The adapter resolves endpoints only — it does not implement the bundler RPC.
+ * {@link BUNDLER_RPC} provides the method names to call against the endpoint.
+ */
+export declare function createBundlerAdapter(kind: BundlerKind, options: BundlerAdapterOptions): BundlerAdapter;
+//# sourceMappingURL=bundler.d.ts.map

package/dist/bundler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundler.d.ts","sourceRoot":"","sources":["../src/bundler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsC,KAAK,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAEzH,sDAAsD;AACtD,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,KAAK,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;AAE7F,kDAAkD;AAClD,eAAO,MAAM,WAAW;;;;;;CAMd,CAAC;AAEX,iDAAiD;AACjD,MAAM,MAAM,cAAc,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;AAE3D,MAAM,MAAM,qBAAqB,GAAG,uBAAuB,CAAC;AAE5D;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,qBAAqB,GAC7B,cAAc,CAGhB"}

package/dist/bundler.js

@@ -0,0 +1,22 @@
+import { createEndpointResolver, pimlicoUrl } from './endpoints.js';
+/** Standard ERC-4337 bundler JSON-RPC methods. */
+export const BUNDLER_RPC = {
+    sendUserOperation: 'eth_sendUserOperation',
+    estimateUserOperationGas: 'eth_estimateUserOperationGas',
+    getUserOperationReceipt: 'eth_getUserOperationReceipt',
+    getUserOperationByHash: 'eth_getUserOperationByHash',
+    supportedEntryPoints: 'eth_supportedEntryPoints',
+};
+/**
+ * Builds a bundler adapter. Only `pimlico` has a built-in URL builder (see
+ * {@link pimlicoUrl}); every other kind requires an explicit `url`/`urls`,
+ * because their endpoints are account- or deployment-specific.
+ *
+ * The adapter resolves endpoints only — it does not implement the bundler RPC.
+ * {@link BUNDLER_RPC} provides the method names to call against the endpoint.
+ */
+export function createBundlerAdapter(kind, options) {
+    const fallback = kind === 'pimlico' ? pimlicoUrl : undefined;
+    return createEndpointResolver(kind, options, fallback);
+}
+//# sourceMappingURL=bundler.js.map

package/dist/bundler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundler.js","sourceRoot":"","sources":["../src/bundler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,UAAU,EAAuD,MAAM,gBAAgB,CAAC;AAKzH,kDAAkD;AAClD,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,iBAAiB,EAAE,uBAAuB;IAC1C,wBAAwB,EAAE,8BAA8B;IACxD,uBAAuB,EAAE,6BAA6B;IACtD,sBAAsB,EAAE,4BAA4B;IACpD,oBAAoB,EAAE,0BAA0B;CACxC,CAAC;AAOX;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAClC,IAAiB,EACjB,OAA8B;IAE9B,MAAM,QAAQ,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7D,OAAO,sBAAsB,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;AACzD,CAAC"}

package/dist/chains.d.ts

@@ -0,0 +1,41 @@
+import type { AccountKind } from './types.js';
+/** Well-known chain ids referenced by the default adapter chain sets. */
+export declare const CHAIN_ID: {
+    readonly ethereum: 1;
+    readonly sepolia: 11155111;
+    readonly bsc: 56;
+    readonly bscTestnet: 97;
+    readonly base: 8453;
+    readonly baseSepolia: 84532;
+    readonly arbitrum: 42161;
+    readonly optimism: 10;
+    readonly polygon: 137;
+};
+/**
+ * Default chain sets. BSC leads the Kernel set because BSC is Keel's primary
+ * launch chain; the others are kept for the standard account/ecosystem spread.
+ */
+export declare const KERNEL_CHAIN_IDS: readonly number[];
+export declare const NEXUS_CHAIN_IDS: readonly number[];
+export declare const SAFE7579_CHAIN_IDS: readonly number[];
+/** A chain Keel ships defaults for, plus the account kinds supported there. */
+export interface ChainInfo {
+    readonly chainId: number;
+    readonly name: string;
+    readonly testnet: boolean;
+    /** Account implementations known to support this chain. */
+    readonly accountKinds: readonly AccountKind[];
+}
+/** Keel's default chain: BSC mainnet — the primary launch chain, and the one the
+ *  fleet is actually deployed on. Testnets stay in the chain sets below but are
+ *  no longer the default. */
+export declare const DEFAULT_CHAIN_ID: number;
+/** Every chain Keel ships defaults for, with the account kinds supported there. */
+export declare const CHAINS: readonly ChainInfo[];
+/** Whether Keel ships defaults for `chainId`. */
+export declare function isChainSupported(chainId: number): boolean;
+/** Chain metadata for `chainId`; throws rather than returning a partial default. */
+export declare function getChain(chainId: number): ChainInfo;
+/** Account kinds supported on `chainId`; throws for an unsupported chain. */
+export declare function accountsFor(chainId: number): readonly AccountKind[];
+//# sourceMappingURL=chains.d.ts.map

package/dist/chains.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chains.d.ts","sourceRoot":"","sources":["../src/chains.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,yEAAyE;AACzE,eAAO,MAAM,QAAQ;;;;;;;;;;CAUX,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,MAAM,EAO7C,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAO5C,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,SAAS,MAAM,EAO/C,CAAC;AAEF,+EAA+E;AAC/E,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,2DAA2D;IAC3D,QAAQ,CAAC,YAAY,EAAE,SAAS,WAAW,EAAE,CAAC;CAC/C;AAED;;6BAE6B;AAC7B,eAAO,MAAM,gBAAgB,EAAE,MAAqB,CAAC;AAwBrD,mFAAmF;AACnF,eAAO,MAAM,MAAM,EAAE,SAAS,SAAS,EAGpC,CAAC;AAIJ,iDAAiD;AACjD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,oFAAoF;AACpF,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAMnD;AAED,6EAA6E;AAC7E,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,WAAW,EAAE,CAEnE"}