@keelcodes/adapters 0.0.0-stage → 0.1.0

package/dist/paymaster.js

@@ -0,0 +1,22 @@
+import { createEndpointResolver, pimlicoUrl } from './endpoints.js';
+/** Standard ERC-7677 paymaster web-service JSON-RPC methods. */
+export const PAYMASTER_RPC = {
+    getPaymasterStubData: 'pm_getPaymasterStubData',
+    getPaymasterData: 'pm_getPaymasterData',
+};
+/**
+ * Builds a paymaster adapter. Per ERC-7677 a paymaster service URL is provided
+ * per chain, so the endpoint is resolved per chain rather than assumed to be
+ * multichain. Only `pimlico` has a built-in URL builder; the rest require an
+ * explicit `url`/`urls`.
+ *
+ * The adapter resolves endpoints only — it does not implement the paymaster
+ * RPC. {@link PAYMASTER_RPC} provides the method names to call against the
+ * endpoint; provider-specific `context` fields are owned by the caller, since
+ * ERC-7677 leaves `context` to each provider.
+ */
+export function createPaymasterAdapter(kind, options) {
+    const fallback = kind === 'pimlico' ? pimlicoUrl : undefined;
+    return createEndpointResolver(kind, options, fallback);
+}
+//# sourceMappingURL=paymaster.js.map

package/dist/paymaster.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paymaster.js","sourceRoot":"","sources":["../src/paymaster.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,UAAU,EAAuD,MAAM,gBAAgB,CAAC;AAKzH,gEAAgE;AAChE,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,oBAAoB,EAAE,yBAAyB;IAC/C,gBAAgB,EAAE,qBAAqB;CAC/B,CAAC;AAOX;;;;;;;;;;GAUG;AACH,MAAM,UAAU,sBAAsB,CACpC,IAAmB,EACnB,OAAgC;IAEhC,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/registry.d.ts

@@ -0,0 +1,9 @@
+import { type KernelVersion } from './kernel.js';
+import type { AccountAdapter, AccountAdapterOptions, AccountKind } from './types.js';
+export interface CreateAdapterOptions extends AccountAdapterOptions {
+    /** Kernel only: selects the validator `initData` layout. */
+    kernelVersion?: KernelVersion;
+}
+/** Builds the adapter for a given account implementation. */
+export declare function createAdapter(kind: AccountKind, options: CreateAdapterOptions): AccountAdapter;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAGhE,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAErF,MAAM,WAAW,oBAAqB,SAAQ,qBAAqB;IACjE,4DAA4D;IAC5D,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED,6DAA6D;AAC7D,wBAAgB,aAAa,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,oBAAoB,GAAG,cAAc,CAiB9F"}

package/dist/registry.js

@@ -0,0 +1,23 @@
+import { KernelAdapter } from './kernel.js';
+import { NexusAdapter } from './nexus.js';
+import { Safe7579Adapter } from './safe7579.js';
+/** Builds the adapter for a given account implementation. */
+export function createAdapter(kind, options) {
+    switch (kind) {
+        case 'kernel':
+            return new KernelAdapter({
+                client: options.client,
+                chainIds: options.chainIds,
+                version: options.kernelVersion,
+            });
+        case 'nexus':
+            return new NexusAdapter(options);
+        case 'safe7579':
+            return new Safe7579Adapter(options);
+        default: {
+            const unreachable = kind;
+            throw new Error(`unknown account kind: ${String(unreachable)}`);
+        }
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAsB,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAQhD,6DAA6D;AAC7D,MAAM,UAAU,aAAa,CAAC,IAAiB,EAAE,OAA6B;IAC5E,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,QAAQ;YACX,OAAO,IAAI,aAAa,CAAC;gBACvB,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,OAAO,EAAE,OAAO,CAAC,aAAa;aAC/B,CAAC,CAAC;QACL,KAAK,OAAO;YACV,OAAO,IAAI,YAAY,CAAC,OAAO,CAAC,CAAC;QACnC,KAAK,UAAU;YACb,OAAO,IAAI,eAAe,CAAC,OAAO,CAAC,CAAC;QACtC,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,WAAW,GAAU,IAAI,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,yBAAyB,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/safe7579.d.ts

@@ -0,0 +1,20 @@
+import { ERC7579AccountAdapter } from './erc7579.js';
+import type { AccountAdapterOptions } from './types.js';
+/**
+ * Safe7579 adapter.
+ *
+ * A Safe account only speaks ERC-7579 once the Safe7579 adapter (module +
+ * fallback handler) is enabled on it, and install/uninstall calls are executed
+ * through that adapter. From the outside the module-manager ABI is standard,
+ * so the base implementation is reused as-is; the adapter pins Safe's default
+ * chain set and documents the precondition.
+ *
+ * Precondition for every call: the target `account` already has Safe7579
+ * enabled. {@link ERC7579AccountAdapter.isModuleInstalled} reports `false` for
+ * a Safe that has not been upgraded yet, which is the correct signal.
+ */
+export declare class Safe7579Adapter extends ERC7579AccountAdapter {
+    readonly kind: "safe7579";
+    constructor(options: AccountAdapterOptions);
+}
+//# sourceMappingURL=safe7579.d.ts.map

package/dist/safe7579.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe7579.d.ts","sourceRoot":"","sources":["../src/safe7579.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD;;;;;;;;;;;;GAYG;AACH,qBAAa,eAAgB,SAAQ,qBAAqB;IACxD,QAAQ,CAAC,IAAI,EAAG,UAAU,CAAU;gBAExB,OAAO,EAAE,qBAAqB;CAG3C"}

package/dist/safe7579.js

@@ -0,0 +1,22 @@
+import { SAFE7579_CHAIN_IDS } from './chains.js';
+import { ERC7579AccountAdapter } from './erc7579.js';
+/**
+ * Safe7579 adapter.
+ *
+ * A Safe account only speaks ERC-7579 once the Safe7579 adapter (module +
+ * fallback handler) is enabled on it, and install/uninstall calls are executed
+ * through that adapter. From the outside the module-manager ABI is standard,
+ * so the base implementation is reused as-is; the adapter pins Safe's default
+ * chain set and documents the precondition.
+ *
+ * Precondition for every call: the target `account` already has Safe7579
+ * enabled. {@link ERC7579AccountAdapter.isModuleInstalled} reports `false` for
+ * a Safe that has not been upgraded yet, which is the correct signal.
+ */
+export class Safe7579Adapter extends ERC7579AccountAdapter {
+    kind = 'safe7579';
+    constructor(options) {
+        super(options.client, options.chainIds ?? SAFE7579_CHAIN_IDS);
+    }
+}
+//# sourceMappingURL=safe7579.js.map

package/dist/safe7579.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe7579.js","sourceRoot":"","sources":["../src/safe7579.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAGrD;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,eAAgB,SAAQ,qBAAqB;IAC/C,IAAI,GAAG,UAAmB,CAAC;IAEpC,YAAY,OAA8B;QACxC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,IAAI,kBAAkB,CAAC,CAAC;IAChE,CAAC;CACF"}

package/dist/types.d.ts

@@ -0,0 +1,60 @@
+import type { PublicClient } from 'viem';
+/** Supported smart-account implementations. */
+export type AccountKind = 'kernel' | 'nexus' | 'safe7579';
+export type Address = `0x${string}`;
+export type Hex = `0x${string}`;
+/** ERC-7579 module type ids. */
+export declare const MODULE_TYPE: {
+    readonly VALIDATOR: 1n;
+    readonly EXECUTOR: 2n;
+    readonly FALLBACK: 3n;
+    readonly HOOK: 4n;
+};
+export interface IsModuleInstalledArgs {
+    account: Address;
+    module: Address;
+    /** Defaults to {@link MODULE_TYPE}.VALIDATOR. */
+    moduleType?: bigint;
+}
+export interface InstallModuleArgs {
+    moduleType: bigint;
+    module: Address;
+    /** ERC-7579 `initData`. Defaults to `0x`. */
+    initData?: Hex;
+}
+export interface UninstallModuleArgs {
+    moduleType: bigint;
+    module: Address;
+    /** ERC-7579 `deInitData`. Defaults to `0x`. */
+    deInitData?: Hex;
+}
+/**
+ * Thin adapter exposing one smart-account implementation behind the standard
+ * ERC-7579 module-manager surface. Keel never re-implements account modules:
+ * every supported account already speaks ERC-7579, so an adapter only encodes
+ * and probes standard install/uninstall calls.
+ */
+export interface AccountAdapter {
+    readonly kind: AccountKind;
+    /** Chain ids this adapter is known to support. */
+    readonly chainIds: readonly number[];
+    /**
+     * Returns whether `module` is installed on `account`.
+     *
+     * Adapters expose this so callers can verify module state explicitly instead
+     * of relying on silent failure modes (e.g. a mismatched initData layout that
+     * does not revert but leaves the module uninitialized).
+     */
+    isModuleInstalled(args: IsModuleInstalledArgs): Promise<boolean>;
+    /** Encodes an ERC-7579 `installModule` call. */
+    encodeInstallModule(args: InstallModuleArgs): Hex;
+    /** Encodes an ERC-7579 `uninstallModule` call. */
+    encodeUninstallModule(args: UninstallModuleArgs): Hex;
+}
+export interface AccountAdapterOptions {
+    /** viem public client used for on-chain probes. */
+    client: PublicClient;
+    /** Override the adapter's default set of supported chain ids. */
+    chainIds?: readonly number[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAEzC,+CAA+C;AAC/C,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC;AAE1D,MAAM,MAAM,OAAO,GAAG,KAAK,MAAM,EAAE,CAAC;AACpC,MAAM,MAAM,GAAG,GAAG,KAAK,MAAM,EAAE,CAAC;AAEhC,gCAAgC;AAChC,eAAO,MAAM,WAAW;;;;;CAKd,CAAC;AAEX,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,GAAG,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,GAAG,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAE3B,kDAAkD;IAClD,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAErC;;;;;;OAMG;IACH,iBAAiB,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEjE,gDAAgD;IAChD,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,GAAG,GAAG,CAAC;IAElD,kDAAkD;IAClD,qBAAqB,CAAC,IAAI,EAAE,mBAAmB,GAAG,GAAG,CAAC;CACvD;AAED,MAAM,WAAW,qBAAqB;IACpC,mDAAmD;IACnD,MAAM,EAAE,YAAY,CAAC;IACrB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9B"}

package/dist/types.js

@@ -0,0 +1,8 @@
+/** ERC-7579 module type ids. */
+export const MODULE_TYPE = {
+    VALIDATOR: 1n,
+    EXECUTOR: 2n,
+    FALLBACK: 3n,
+    HOOK: 4n,
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAQA,gCAAgC;AAChC,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,SAAS,EAAE,EAAE;IACb,QAAQ,EAAE,EAAE;IACZ,QAAQ,EAAE,EAAE;IACZ,IAAI,EAAE,EAAE;CACA,CAAC"}

package/package.json

@@ -1,6 +1,54 @@
 {
   "name": "@keelcodes/adapters",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Thin account, bundler and paymaster adapters that expose Kernel, Nexus and Safe7579 behind a single ERC-7579 interface.",
+  "license": "Apache-2.0",
+  "homepage": "https://keel.codes",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/keelcodes/keel.git",
+    "directory": "packages/adapters"
+  },
+  "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,
+  "dependencies": {
+    "viem": "^2.21.0"
+  },
+  "devDependencies": {
+    "vitest": "^2.1.4"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [
+    "erc-4337",
+    "erc-7579",
+    "kernel",
+    "nexus",
+    "safe7579",
+    "account-abstraction"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "fork-drill": "node scripts/fork-drill.mjs",
+    "migration-drill": "node scripts/migration-drill.mjs",
+    "clean": "rm -rf dist"
+  }
 }