@pepu-chain/sdk 0.0.0-stage → 0.2.1

package/dist/combo.cjs

@@ -0,0 +1,263 @@
+'use strict';
+/* @pepu-chain/peer-guard */(function(){var p=["@privy-io/node","@zerodev/sdk","@zerodev/permissions","@zerodev/ecdsa-validator"];for(var i=0;i<p.length;i++){try{require.resolve(p[i])}catch(e){if(e&&e.code==="MODULE_NOT_FOUND"){var m="@pepu-chain/sdk/combo needs peer packages that are not installed: @privy-io/node @zerodev/sdk @zerodev/permissions @zerodev/ecdsa-validator. Install with: npm i @privy-io/node @zerodev/sdk @zerodev/permissions @zerodev/ecdsa-validator  (or let create-pepu-app scaffold everything).";var x=new Error(m);x.code="PEPU_MISSING_PEER";throw x}}}})();
+
+var chunkPHM3ZORG_cjs = require('./chunk-PHM3ZORG.cjs');
+var chunkNVOPDXTA_cjs = require('./chunk-NVOPDXTA.cjs');
+require('./chunk-7MNJF2OB.cjs');
+var chunkAJS4UFQX_cjs = require('./chunk-AJS4UFQX.cjs');
+require('./chunk-A5LP2UCS.cjs');
+var chunkRCMKPJZO_cjs = require('./chunk-RCMKPJZO.cjs');
+require('./chunk-WANILJZQ.cjs');
+require('./chunk-K7JSQPZO.cjs');
+var chunkJ3O2ZGG3_cjs = require('./chunk-J3O2ZGG3.cjs');
+require('./chunk-4GINFJO6.cjs');
+var chunkVF3D6KLQ_cjs = require('./chunk-VF3D6KLQ.cjs');
+var chunkDPCZJLB3_cjs = require('./chunk-DPCZJLB3.cjs');
+var chunk45KSZH26_cjs = require('./chunk-45KSZH26.cjs');
+var chunkSVWRRALU_cjs = require('./chunk-SVWRRALU.cjs');
+require('./chunk-C2XW44FI.cjs');
+var chunkIG7RSL2Y_cjs = require('./chunk-IG7RSL2Y.cjs');
+var chunkYQL7NISX_cjs = require('./chunk-YQL7NISX.cjs');
+var viem = require('viem');
+
+chunkSVWRRALU_cjs.assertServerOnly("@pepu-chain/sdk/combo");
+function json(body, status = 200) {
+  return new Response(JSON.stringify(body), { status, headers: { "content-type": "application/json" } });
+}
+function upstream(e, op) {
+  const err = chunkYQL7NISX_cjs.toPepuError(e, { op });
+  if (err.code === "UNKNOWN" && !(e instanceof chunkYQL7NISX_cjs.PepuError)) {
+    return new chunkYQL7NISX_cjs.PepuChainError("UNKNOWN", err.message, { status: 502, cause: e });
+  }
+  return err;
+}
+async function guard(op, fn) {
+  try {
+    return await fn();
+  } catch (e) {
+    return chunkYQL7NISX_cjs.toErrorResponse(upstream(e, op));
+  }
+}
+function bearerToken(request) {
+  return (request.headers.get("authorization") ?? "").replace(/^Bearer\s+/i, "").trim();
+}
+var nowSeconds = () => Math.floor(Date.now() / 1e3);
+function defaultPublicClient() {
+  return viem.createPublicClient({ chain: chunkDPCZJLB3_cjs.pepuMainnet, transport: viem.http(chunkVF3D6KLQ_cjs.resolvePepuEndpoints().rpcUrl) });
+}
+function createSponsoredSessionRoutes(o) {
+  const unconfigured = o.scope.calls.some((c) => !c.target || String(c.target).trim() === "");
+  if (unconfigured) {
+    const unset = async () => chunkYQL7NISX_cjs.toErrorResponse(
+      new chunkYQL7NISX_cjs.PepuConfigError(
+        "CONFIG_MISSING_ENV",
+        `${o.scope.targetEnv ?? "A session target contract address"} is not set to a valid address. See .env.example.`,
+        { hint: "Set it and restart the server." }
+      )
+    );
+    return {
+      prepare: { POST: unset },
+      activate: { POST: unset },
+      status: { GET: unset },
+      act: { POST: unset },
+      revoke: { POST: unset }
+    };
+  }
+  chunkPHM3ZORG_cjs.buildKernelSessionPolicies({ calls: o.scope.calls, validUntil: 1 });
+  let publicClient = o.publicClient;
+  const client = () => publicClient ??= defaultPublicClient();
+  const authenticate = async (request) => {
+    if (o.authenticate) {
+      const user = await o.authenticate(request);
+      if (!user) throw new chunkYQL7NISX_cjs.PepuAuthError("AUTH_INVALID_TOKEN", "Missing or invalid Privy access token.");
+      return user;
+    }
+    const auth = await chunk45KSZH26_cjs.requireUser(request, { privy: o.privy ?? chunk45KSZH26_cjs.createPrivyServer() });
+    if (!auth.ok) return auth.response;
+    if (!auth.user.address) {
+      throw new chunkYQL7NISX_cjs.PepuAuthError("WALLET_NOT_PROVISIONED", "No embedded wallet yet. Create it first (ensure-wallet route).", {
+        status: 409
+      });
+    }
+    return { userId: auth.user.userId, ownerAddress: auth.user.address };
+  };
+  const minutes = () => o.minutes ?? chunkIG7RSL2Y_cjs.resolveSessionMinutes(process.env.SESSION_DURATION_MINUTES);
+  const policiesFor = (validUntil) => chunkPHM3ZORG_cjs.buildKernelSessionPolicies({ calls: o.scope.calls, validUntil });
+  return {
+    prepare: {
+      POST: (request) => guard("combo prepare", async () => {
+        const user = await authenticate(request);
+        if (user instanceof Response) return user;
+        const { userId, ownerAddress } = user;
+        const mins = minutes();
+        const validUntil = chunkIG7RSL2Y_cjs.sessionExpiry(nowSeconds(), mins);
+        const key = chunkPHM3ZORG_cjs.generateSessionKey();
+        const policies = policiesFor(validUntil);
+        const [kernelAddress, permissionId] = await Promise.all([
+          chunkNVOPDXTA_cjs.getKernelAddress(client(), ownerAddress),
+          chunkPHM3ZORG_cjs.expectedPermissionId({ publicClient: client(), sessionKeyAddress: key.address, policies })
+        ]);
+        const record = {
+          userId,
+          ownerAddress,
+          kernelAddress,
+          sessionPrivateKey: key.privateKey,
+          sessionKeyAddress: key.address,
+          permissionId,
+          validUntil,
+          approval: null,
+          actions: 0
+        };
+        await o.store.set(record);
+        return json({
+          ownerAddress,
+          kernelAddress,
+          sessionKeyAddress: key.address,
+          validUntil,
+          minutes: mins,
+          scope: chunkJ3O2ZGG3_cjs.describeKernelSessionScope({ calls: o.scope.calls, validUntil })
+        });
+      })
+    },
+    activate: {
+      POST: (request) => guard("combo activate", async () => {
+        const user = await authenticate(request);
+        if (user instanceof Response) return user;
+        const body = await request.json().catch(() => null);
+        if (typeof body?.approval !== "string") {
+          throw new chunkYQL7NISX_cjs.PepuPolicyError("UNKNOWN", "Missing approval.", { status: 400, hint: "Send { approval }." });
+        }
+        const record = await o.store.get(user.userId);
+        if (!record || record.approval !== null) {
+          throw new chunkYQL7NISX_cjs.PepuSessionError("SESSION_NONE", "No pending session. Start again.");
+        }
+        if (nowSeconds() >= record.validUntil) {
+          await o.store.delete(record.userId);
+          throw new chunkYQL7NISX_cjs.PepuSessionError("SESSION_EXPIRED", "The session offer expired. Start again.");
+        }
+        const check = chunkJ3O2ZGG3_cjs.checkApproval(body.approval, {
+          kernelAddress: record.kernelAddress,
+          permissionId: record.permissionId
+        });
+        if (!check.ok) throw new chunkYQL7NISX_cjs.PepuSessionError("SESSION_APPROVAL_MISMATCH", check.reason, { status: 400 });
+        await o.store.set({ ...record, approval: body.approval });
+        return json({ active: true, validUntil: record.validUntil });
+      })
+    },
+    status: {
+      GET: (request) => guard("combo status", async () => {
+        const user = await authenticate(request);
+        if (user instanceof Response) return user;
+        const record = await o.store.get(user.userId);
+        if (!record || !chunkPHM3ZORG_cjs.isLive(record, nowSeconds())) return json({ active: false });
+        return json({
+          active: true,
+          validUntil: record.validUntil,
+          kernelAddress: record.kernelAddress,
+          ownerAddress: record.ownerAddress,
+          sessionKeyAddress: record.sessionKeyAddress,
+          actions: record.actions
+        });
+      })
+    },
+    act: {
+      POST: (request) => guard("combo act", async () => {
+        const user = await authenticate(request);
+        if (user instanceof Response) return user;
+        const record = await o.store.get(user.userId);
+        if (!record || !record.approval || !chunkPHM3ZORG_cjs.isLive(record, nowSeconds())) {
+          throw new chunkYQL7NISX_cjs.PepuSessionError("SESSION_NONE", "No active session. Start one first.");
+        }
+        let input;
+        try {
+          input = o.act.parse(await request.json().catch(() => ({})));
+        } catch (e) {
+          throw new chunkYQL7NISX_cjs.PepuPolicyError("UNKNOWN", e instanceof Error ? e.message : "Invalid request body.", {
+            status: 400,
+            hint: "Fix the request body.",
+            cause: e
+          });
+        }
+        const calls = o.act.buildCalls(input, {
+          kernelAddress: record.kernelAddress,
+          ownerAddress: record.ownerAddress
+        });
+        assertCallsInScope(chunkJ3O2ZGG3_cjs.describeKernelSessionScope({ calls: o.scope.calls, validUntil: record.validUntil }), calls);
+        if (!await o.store.tryLock(user.userId)) {
+          throw new chunkYQL7NISX_cjs.PepuChainError("UNKNOWN", "An action is already in flight.", {
+            status: 429,
+            retryable: true,
+            hint: "Wait for the current action to finish."
+          });
+        }
+        const privyToken = o.forwardPrivyToken === false ? "" : bearerToken(request);
+        try {
+          const account = await chunkPHM3ZORG_cjs.loadKernelSessionAccount({
+            publicClient: client(),
+            approval: record.approval,
+            sessionPrivateKey: record.sessionPrivateKey
+          });
+          const kernel = chunkNVOPDXTA_cjs.createPepuSponsoredClient({
+            account,
+            publicClient: client(),
+            ...o.endpoints?.bundlerUrl !== void 0 ? { bundlerUrl: o.endpoints.bundlerUrl } : {},
+            ...o.endpoints?.paymasterUrl !== void 0 ? { paymasterUrl: o.endpoints.paymasterUrl } : {},
+            ...o.endpoints?.paymasterToken !== void 0 ? { paymasterToken: o.endpoints.paymasterToken } : {},
+            ...privyToken ? { paymasterContext: chunkRCMKPJZO_cjs.buildPaymasterContext({ privyAccessToken: privyToken }) } : {}
+          });
+          const result = await chunkNVOPDXTA_cjs.sendSponsored({ client: kernel, calls });
+          const actions = record.actions + (result.success ? 1 : 0);
+          if (result.success) await o.store.set({ ...record, actions });
+          const out = {
+            userOpHash: result.userOpHash,
+            transactionHash: result.transactionHash,
+            kernelAddress: record.kernelAddress,
+            success: result.success,
+            paymaster: result.paymaster,
+            actualGasCostWei: result.actualGasCostWei.toString(),
+            explorerUrl: result.explorerUrl,
+            actions
+          };
+          return json(out);
+        } finally {
+          await o.store.unlock(user.userId);
+        }
+      })
+    },
+    revoke: {
+      POST: (request) => guard("combo revoke", async () => {
+        const user = await authenticate(request);
+        if (user instanceof Response) return user;
+        await o.store.delete(user.userId);
+        return json({ active: false });
+      })
+    }
+  };
+}
+function assertCallsInScope(scope, calls) {
+  for (const c of chunkAJS4UFQX_cjs.normalizeCalls(calls)) {
+    if (!chunkJ3O2ZGG3_cjs.isCallInScope(scope, c)) {
+      throw new chunkYQL7NISX_cjs.PepuPolicyError("POLICY_UNSCOPED", "A call is outside the session scope.", {
+        status: 403,
+        hint: "Only the contracts and functions the user approved can be called."
+      });
+    }
+  }
+}
+
+Object.defineProperty(exports, "createMemoryStore", {
+  enumerable: true,
+  get: function () { return chunkPHM3ZORG_cjs.createMemoryStore; }
+});
+Object.defineProperty(exports, "isLive", {
+  enumerable: true,
+  get: function () { return chunkPHM3ZORG_cjs.isLive; }
+});
+Object.defineProperty(exports, "resolveSessionMinutes", {
+  enumerable: true,
+  get: function () { return chunkIG7RSL2Y_cjs.resolveSessionMinutes; }
+});
+exports.assertCallsInScope = assertCallsInScope;
+exports.createSponsoredSessionRoutes = createSponsoredSessionRoutes;
+//# sourceMappingURL=combo.cjs.map
+//# sourceMappingURL=combo.cjs.map

package/dist/combo.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/combo/server.ts"],"names":["assertServerOnly","toPepuError","PepuError","PepuChainError","toErrorResponse","createPublicClient","pepuMainnet","http","resolvePepuEndpoints","PepuConfigError","buildKernelSessionPolicies","PepuAuthError","requireUser","createPrivyServer","resolveSessionMinutes","sessionExpiry","generateSessionKey","getKernelAddress","expectedPermissionId","describeKernelSessionScope","PepuPolicyError","PepuSessionError","checkApproval","isLive","loadKernelSessionAccount","createPepuSponsoredClient","buildPaymasterContext","sendSponsored","normalizeCalls","isCallInScope"],"mappings":"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","file":"combo.cjs","sourcesContent":["import type { PrivyClient } from \"@privy-io/node\";\nimport { createPublicClient, http } from \"viem\";\nimport type { Address, PublicClient } from \"viem\";\nimport type { SponsoredActResult } from \"./types.js\";\nimport { createPepuSponsoredClient, sendSponsored } from \"../aa/kernel.js\";\nimport { normalizeCalls } from \"../aa/calls.js\";\nimport type { Call } from \"../aa/types.js\";\nimport { pepuMainnet } from \"../chains.js\";\nimport { resolvePepuEndpoints } from \"../endpoints.js\";\nimport { buildPaymasterContext } from \"../erc7677.js\";\nimport {\n  PepuAuthError,\n  PepuChainError,\n  PepuConfigError,\n  PepuError,\n  PepuPolicyError,\n  PepuSessionError,\n  toErrorResponse,\n  toPepuError,\n} from \"../errors.js\";\nimport { assertServerOnly } from \"../internal/assert-server.js\";\nimport { createPrivyServer, requireUser } from \"../privy/server.js\";\nimport { resolveSessionMinutes, sessionExpiry } from \"../session/policy.js\";\nimport {\n  buildKernelSessionPolicies,\n  checkApproval,\n  describeKernelSessionScope,\n  expectedPermissionId,\n  generateSessionKey,\n  getKernelAddress,\n  isCallInScope,\n  loadKernelSessionAccount,\n} from \"../session/kernel.js\";\nimport type { KernelSessionCall, KernelSessionScope } from \"../session/kernel.js\";\nimport { isLive } from \"../session/store.js\";\nimport type { SessionRecord, SessionStore } from \"../session/store.js\";\n\nassertServerOnly(\"@pepu-chain/sdk/combo\");\n\n/**\n * `@pepu-chain/sdk/combo` (server): the combined flow. Google sign-in (Privy),\n * a ONE-TIME on-chain session, and sponsored gas. Route factories for the\n * Kernel session lifecycle: prepare, activate, status, act, revoke.\n *\n * Extracted from templates/sponsored-session-app/app/api/session/* and\n * lib/{kernel,session-auth}.ts.\n *\n * Trust model: the chain, not these routes, enforces scope. The owner's single\n * EIP-712 signature enables a permission whose call policy (targets,\n * selectors, zero value) and timestamp policy the Kernel account verifies on\n * every UserOperation. The checks here only fail fast.\n *\n * Optional peers: `@privy-io/node`, `@zerodev/*`.\n */\n\nexport { createMemoryStore, isLive } from \"../session/store.js\";\nexport type { SessionRecord, SessionStore } from \"../session/store.js\";\nexport type { KernelSessionCall, KernelSessionScope } from \"../session/kernel.js\";\nexport type { SponsoredActResult } from \"./types.js\";\n/** Session length from `SESSION_DURATION_MINUTES` (default 15, clamped to 1..1440), the same rule the routes use. */\nexport { resolveSessionMinutes } from \"../session/policy.js\";\n\n/** The authenticated caller of a combo route. */\nexport interface ComboUser {\n  userId: string;\n  /** The user's Privy embedded wallet: the owner of their Kernel account. From Privy, never the request. */\n  ownerAddress: Address;\n}\n\n/** Authenticate a request. Throw a `PepuError` (or return `null`) when it is not valid. */\nexport type ComboAuthenticate = (request: Request) => Promise<ComboUser | null>;\n\n/** Options for {@link createSponsoredSessionRoutes}. */\nexport interface SponsoredSessionRoutesOptions<I> {\n  /** What the session may call. Enforced on-chain by the call policy. */\n  scope: {\n    calls: readonly KernelSessionCall[];\n    /** Env variable named in the `CONFIG_MISSING_ENV` message when a call target is empty (unset). */\n    targetEnv?: string;\n  };\n  /**\n   * Where session records (including the session private key) live. Use\n   * `createMemoryStore()` for development only: production needs a persistent\n   * store with the key encrypted at rest.\n   */\n  store: SessionStore;\n  /**\n   * Bundler and paymaster. The bundler defaults to env `PEPU_BUNDLER_URL`, then the hosted bundler. The paymaster\n   * needs a complete ERC-7677 URL (env `PEPU_PAYMASTER_URL`, or `paymasterUrl`) or a project `paymasterToken`\n   * (built against the hosted paymaster base).\n   */\n  endpoints?: { bundlerUrl?: string; paymasterUrl?: string; paymasterToken?: string };\n  /**\n   * Forward the caller's Privy access token (the request's `Authorization: Bearer`) to the paymaster as ERC-7677\n   * `context.privyAccessToken`. The v2 FREE TIER requires it; a project paying from its own deposit does not.\n   * Default `true`. Set `false` if your paymaster URL is not a PEPU policy service you trust with the token.\n   */\n  forwardPrivyToken?: boolean;\n  /** Session length. Default env `SESSION_DURATION_MINUTES`, then 15; clamped to 1..1440. */\n  minutes?: number;\n  /** The one action users take with their session. */\n  act: {\n    /** Validate the client body. Throw to reject with 400. */\n    parse(body: unknown): I;\n    /** The calls to send. Each is re-checked against `scope` before sponsoring. */\n    buildCalls(input: I, ctx: { kernelAddress: Address; ownerAddress: Address }): Call[];\n  };\n  /** Privy client for the default authentication. Default `createPrivyServer()`. */\n  privy?: PrivyClient;\n  /**\n   * Custom authentication. Default: B1's `requireUser` (verifies the Privy\n   * bearer token and reads the user's embedded wallet from Privy).\n   */\n  authenticate?: ComboAuthenticate;\n  /** Chain reads. Default: viem on the PEPU RPC (`PEPU_RPC_URL` aware). */\n  publicClient?: PublicClient;\n}\n\n/** The five route handlers returned by {@link createSponsoredSessionRoutes}. */\nexport interface SponsoredSessionRoutes {\n  prepare: { POST(request: Request): Promise<Response> };\n  activate: { POST(request: Request): Promise<Response> };\n  status: { GET(request: Request): Promise<Response> };\n  act: { POST(request: Request): Promise<Response> };\n  revoke: { POST(request: Request): Promise<Response> };\n}\n\nfunction json(body: unknown, status = 200): Response {\n  return new Response(JSON.stringify(body), { status, headers: { \"content-type\": \"application/json\" } });\n}\n\n/** Anything unclassified that reaches a route is an upstream failure, not our 500. */\nfunction upstream(e: unknown, op: string): PepuError {\n  const err = toPepuError(e, { op });\n  if (err.code === \"UNKNOWN\" && !(e instanceof PepuError)) {\n    return new PepuChainError(\"UNKNOWN\", err.message, { status: 502, cause: e });\n  }\n  return err;\n}\n\nasync function guard(op: string, fn: () => Promise<Response>): Promise<Response> {\n  try {\n    return await fn();\n  } catch (e) {\n    return toErrorResponse(upstream(e, op));\n  }\n}\n\n/** The bearer token on a request, or `\"\"`. */\nfunction bearerToken(request: Request): string {\n  return (request.headers.get(\"authorization\") ?? \"\").replace(/^Bearer\\s+/i, \"\").trim();\n}\n\nconst nowSeconds = (): number => Math.floor(Date.now() / 1000);\n\nfunction defaultPublicClient(): PublicClient {\n  return createPublicClient({ chain: pepuMainnet, transport: http(resolvePepuEndpoints().rpcUrl) }) as PublicClient;\n}\n\n/**\n * Route handlers for the Kernel session lifecycle.\n *\n * - `prepare.POST`: the server creates a fresh session key and decides the\n *   expiry. The private key stays on the server; the response carries only the\n *   key's address, the expiry and the scope, so the browser can ask the owner\n *   for the ONE signature that grants exactly that. Calling it again replaces\n *   any pending or active session (the old key is dropped).\n * - `activate.POST` `{ approval }`: checks the approval is for this user's\n *   smart account and for exactly the key, scope and expiry issued in\n *   `prepare`, then stores it. 409 `SESSION_NONE` when nothing is pending,\n *   410 `SESSION_EXPIRED` for an expired offer, 400 `SESSION_APPROVAL_MISMATCH`.\n * - `status.GET`: `{ active: false }` or `{ active: true, validUntil, ... }`.\n *   Never returns the session key or approval.\n * - `act.POST`: signs ONE sponsored UserOperation with the session key. 409\n *   `SESSION_NONE` without a live session, 429 while another action runs.\n * - `revoke.POST`: deletes the session key and approval from the server, so\n *   the app can no longer act, immediately. It does NOT uninstall the\n *   permission on-chain: that grant stays valid until its expiry, but only the\n *   deleted key can use it and only within the scope. An on-chain uninstall is\n *   an owner-signed call to the user's own account, which a paymaster\n *   destination allowlist rightly does not sponsor.\n *\n * Gas: the paymaster policy service reserves worst-case cost per operation:\n * about 20.5 PEPU for a session's first operation and about 6.9 PEPU for later\n * ones (`SESSION_GAS_RESERVATION_PEPU`). Size spend caps above that. Fees come\n * from the chain with 20% headroom.\n *\n * @example\n * // lib/session-routes.ts\n * export const routes = createSponsoredSessionRoutes({\n *   scope: { calls: [{ target: tapScore, abi: tapScoreAbi, functionName: \"tap\" }] },\n *   store: createMemoryStore(), // DEV ONLY\n *   act: {\n *     parse: () => ({}),\n *     buildCalls: () => [{ to: tapScore, abi: tapScoreAbi, functionName: \"tap\" }],\n *   },\n * });\n * // app/api/session/prepare/route.ts: export const { POST } = routes.prepare;\n */\nexport function createSponsoredSessionRoutes<I>(o: SponsoredSessionRoutesOptions<I>): SponsoredSessionRoutes {\n  // A call whose target is empty or undefined (an unset env variable) is \"not configured yet\":\n  // every route then answers CONFIG_MISSING_ENV at request time. A malformed non-empty scope\n  // still fails at startup, not on the first request.\n  const unconfigured = o.scope.calls.some((c) => !c.target || String(c.target).trim() === \"\");\n  if (unconfigured) {\n    const unset = async (): Promise<Response> =>\n      toErrorResponse(\n        new PepuConfigError(\n          \"CONFIG_MISSING_ENV\",\n          `${o.scope.targetEnv ?? \"A session target contract address\"} is not set to a valid address. See .env.example.`,\n          { hint: \"Set it and restart the server.\" },\n        ),\n      );\n    return {\n      prepare: { POST: unset },\n      activate: { POST: unset },\n      status: { GET: unset },\n      act: { POST: unset },\n      revoke: { POST: unset },\n    };\n  }\n  buildKernelSessionPolicies({ calls: o.scope.calls, validUntil: 1 });\n  let publicClient = o.publicClient;\n  const client = (): PublicClient => (publicClient ??= defaultPublicClient());\n\n  const authenticate = async (request: Request): Promise<ComboUser | Response> => {\n    if (o.authenticate) {\n      const user = await o.authenticate(request);\n      if (!user) throw new PepuAuthError(\"AUTH_INVALID_TOKEN\", \"Missing or invalid Privy access token.\");\n      return user;\n    }\n    const auth = await requireUser(request, { privy: o.privy ?? createPrivyServer() });\n    if (!auth.ok) return auth.response;\n    if (!auth.user.address) {\n      throw new PepuAuthError(\"WALLET_NOT_PROVISIONED\", \"No embedded wallet yet. Create it first (ensure-wallet route).\", {\n        status: 409,\n      });\n    }\n    return { userId: auth.user.userId, ownerAddress: auth.user.address };\n  };\n\n  const minutes = (): number => o.minutes ?? resolveSessionMinutes(process.env.SESSION_DURATION_MINUTES);\n  const policiesFor = (validUntil: number) => buildKernelSessionPolicies({ calls: o.scope.calls, validUntil });\n\n  return {\n    prepare: {\n      POST: (request) =>\n        guard(\"combo prepare\", async () => {\n          const user = await authenticate(request);\n          if (user instanceof Response) return user;\n          const { userId, ownerAddress } = user;\n          const mins = minutes();\n          const validUntil = sessionExpiry(nowSeconds(), mins);\n          const key = generateSessionKey();\n          const policies = policiesFor(validUntil);\n          const [kernelAddress, permissionId] = await Promise.all([\n            getKernelAddress(client(), ownerAddress),\n            expectedPermissionId({ publicClient: client(), sessionKeyAddress: key.address, policies }),\n          ]);\n          const record: SessionRecord = {\n            userId,\n            ownerAddress,\n            kernelAddress,\n            sessionPrivateKey: key.privateKey,\n            sessionKeyAddress: key.address,\n            permissionId,\n            validUntil,\n            approval: null,\n            actions: 0,\n          };\n          await o.store.set(record);\n          return json({\n            ownerAddress,\n            kernelAddress,\n            sessionKeyAddress: key.address,\n            validUntil,\n            minutes: mins,\n            scope: describeKernelSessionScope({ calls: o.scope.calls, validUntil }),\n          });\n        }),\n    },\n\n    activate: {\n      POST: (request) =>\n        guard(\"combo activate\", async () => {\n          const user = await authenticate(request);\n          if (user instanceof Response) return user;\n          const body = (await request.json().catch(() => null)) as { approval?: unknown } | null;\n          if (typeof body?.approval !== \"string\") {\n            throw new PepuPolicyError(\"UNKNOWN\", \"Missing approval.\", { status: 400, hint: \"Send { approval }.\" });\n          }\n          const record = await o.store.get(user.userId);\n          if (!record || record.approval !== null) {\n            throw new PepuSessionError(\"SESSION_NONE\", \"No pending session. Start again.\");\n          }\n          if (nowSeconds() >= record.validUntil) {\n            await o.store.delete(record.userId);\n            throw new PepuSessionError(\"SESSION_EXPIRED\", \"The session offer expired. Start again.\");\n          }\n          const check = checkApproval(body.approval, {\n            kernelAddress: record.kernelAddress,\n            permissionId: record.permissionId,\n          });\n          if (!check.ok) throw new PepuSessionError(\"SESSION_APPROVAL_MISMATCH\", check.reason, { status: 400 });\n          await o.store.set({ ...record, approval: body.approval });\n          return json({ active: true, validUntil: record.validUntil });\n        }),\n    },\n\n    status: {\n      GET: (request) =>\n        guard(\"combo status\", async () => {\n          const user = await authenticate(request);\n          if (user instanceof Response) return user;\n          const record = await o.store.get(user.userId);\n          if (!record || !isLive(record, nowSeconds())) return json({ active: false });\n          return json({\n            active: true,\n            validUntil: record.validUntil,\n            kernelAddress: record.kernelAddress,\n            ownerAddress: record.ownerAddress,\n            sessionKeyAddress: record.sessionKeyAddress,\n            actions: record.actions,\n          });\n        }),\n    },\n\n    act: {\n      POST: (request) =>\n        guard(\"combo act\", async () => {\n          const user = await authenticate(request);\n          if (user instanceof Response) return user;\n          const record = await o.store.get(user.userId);\n          if (!record || !record.approval || !isLive(record, nowSeconds())) {\n            throw new PepuSessionError(\"SESSION_NONE\", \"No active session. Start one first.\");\n          }\n\n          let input: I;\n          try {\n            input = o.act.parse(await request.json().catch(() => ({})));\n          } catch (e) {\n            throw new PepuPolicyError(\"UNKNOWN\", e instanceof Error ? e.message : \"Invalid request body.\", {\n              status: 400,\n              hint: \"Fix the request body.\",\n              cause: e,\n            });\n          }\n          const calls = o.act.buildCalls(input, {\n            kernelAddress: record.kernelAddress,\n            ownerAddress: record.ownerAddress,\n          });\n          // Fail fast; the chain is the real enforcement (see the file comment).\n          assertCallsInScope(describeKernelSessionScope({ calls: o.scope.calls, validUntil: record.validUntil }), calls);\n\n          if (!(await o.store.tryLock(user.userId))) {\n            throw new PepuChainError(\"UNKNOWN\", \"An action is already in flight.\", {\n              status: 429,\n              retryable: true,\n              hint: \"Wait for the current action to finish.\",\n            });\n          }\n          const privyToken = o.forwardPrivyToken === false ? \"\" : bearerToken(request);\n          try {\n            const account = await loadKernelSessionAccount({\n              publicClient: client(),\n              approval: record.approval,\n              sessionPrivateKey: record.sessionPrivateKey,\n            });\n            const kernel = createPepuSponsoredClient({\n              account,\n              publicClient: client(),\n              ...(o.endpoints?.bundlerUrl !== undefined ? { bundlerUrl: o.endpoints.bundlerUrl } : {}),\n              ...(o.endpoints?.paymasterUrl !== undefined ? { paymasterUrl: o.endpoints.paymasterUrl } : {}),\n              ...(o.endpoints?.paymasterToken !== undefined ? { paymasterToken: o.endpoints.paymasterToken } : {}),\n              ...(privyToken ? { paymasterContext: buildPaymasterContext({ privyAccessToken: privyToken }) } : {}),\n            });\n            const result = await sendSponsored({ client: kernel, calls });\n            const actions = record.actions + (result.success ? 1 : 0);\n            if (result.success) await o.store.set({ ...record, actions });\n            const out: SponsoredActResult = {\n              userOpHash: result.userOpHash,\n              transactionHash: result.transactionHash,\n              kernelAddress: record.kernelAddress,\n              success: result.success,\n              paymaster: result.paymaster,\n              actualGasCostWei: result.actualGasCostWei.toString(),\n              explorerUrl: result.explorerUrl,\n              actions,\n            };\n            return json(out);\n          } finally {\n            await o.store.unlock(user.userId);\n          }\n        }),\n    },\n\n    revoke: {\n      POST: (request) =>\n        guard(\"combo revoke\", async () => {\n          const user = await authenticate(request);\n          if (user instanceof Response) return user;\n          await o.store.delete(user.userId);\n          return json({ active: false });\n        }),\n    },\n  };\n}\n\n/**\n * Throws `POLICY_UNSCOPED` (403) unless every call targets an allowed contract\n * and function selector with a value within the limit. Pure; used by the act\n * route and exported for custom routes.\n *\n * @example\n * assertCallsInScope(describeKernelSessionScope({ calls, validUntil }), [{ to, abi, functionName: \"tap\" }]);\n */\nexport function assertCallsInScope(scope: Pick<KernelSessionScope, \"calls\">, calls: readonly Call[]): void {\n  for (const c of normalizeCalls(calls)) {\n    if (!isCallInScope(scope, c)) {\n      throw new PepuPolicyError(\"POLICY_UNSCOPED\", \"A call is outside the session scope.\", {\n        status: 403,\n        hint: \"Only the contracts and functions the user approved can be called.\",\n      });\n    }\n  }\n}\n"]}

package/dist/combo.d.cts

@@ -0,0 +1,139 @@
+import { PrivyClient } from '@privy-io/node';
+import { Address, PublicClient } from 'viem';
+import { C as Call } from './types-BilBTDqK.cjs';
+import { K as KernelSessionCall, a as KernelSessionScope } from './scope-DBRkN7bR.cjs';
+import { S as SessionStore } from './store-CjmLgp9g.cjs';
+export { a as SessionRecord, c as createMemoryStore, i as isLive } from './store-CjmLgp9g.cjs';
+export { S as SponsoredActResult } from './types-BEEM7WdG.cjs';
+export { resolveSessionMinutes } from './server.cjs';
+
+/** The authenticated caller of a combo route. */
+interface ComboUser {
+    userId: string;
+    /** The user's Privy embedded wallet: the owner of their Kernel account. From Privy, never the request. */
+    ownerAddress: Address;
+}
+/** Authenticate a request. Throw a `PepuError` (or return `null`) when it is not valid. */
+type ComboAuthenticate = (request: Request) => Promise<ComboUser | null>;
+/** Options for {@link createSponsoredSessionRoutes}. */
+interface SponsoredSessionRoutesOptions<I> {
+    /** What the session may call. Enforced on-chain by the call policy. */
+    scope: {
+        calls: readonly KernelSessionCall[];
+        /** Env variable named in the `CONFIG_MISSING_ENV` message when a call target is empty (unset). */
+        targetEnv?: string;
+    };
+    /**
+     * Where session records (including the session private key) live. Use
+     * `createMemoryStore()` for development only: production needs a persistent
+     * store with the key encrypted at rest.
+     */
+    store: SessionStore;
+    /**
+     * Bundler and paymaster. The bundler defaults to env `PEPU_BUNDLER_URL`, then the hosted bundler. The paymaster
+     * needs a complete ERC-7677 URL (env `PEPU_PAYMASTER_URL`, or `paymasterUrl`) or a project `paymasterToken`
+     * (built against the hosted paymaster base).
+     */
+    endpoints?: {
+        bundlerUrl?: string;
+        paymasterUrl?: string;
+        paymasterToken?: string;
+    };
+    /**
+     * Forward the caller's Privy access token (the request's `Authorization: Bearer`) to the paymaster as ERC-7677
+     * `context.privyAccessToken`. The v2 FREE TIER requires it; a project paying from its own deposit does not.
+     * Default `true`. Set `false` if your paymaster URL is not a PEPU policy service you trust with the token.
+     */
+    forwardPrivyToken?: boolean;
+    /** Session length. Default env `SESSION_DURATION_MINUTES`, then 15; clamped to 1..1440. */
+    minutes?: number;
+    /** The one action users take with their session. */
+    act: {
+        /** Validate the client body. Throw to reject with 400. */
+        parse(body: unknown): I;
+        /** The calls to send. Each is re-checked against `scope` before sponsoring. */
+        buildCalls(input: I, ctx: {
+            kernelAddress: Address;
+            ownerAddress: Address;
+        }): Call[];
+    };
+    /** Privy client for the default authentication. Default `createPrivyServer()`. */
+    privy?: PrivyClient;
+    /**
+     * Custom authentication. Default: B1's `requireUser` (verifies the Privy
+     * bearer token and reads the user's embedded wallet from Privy).
+     */
+    authenticate?: ComboAuthenticate;
+    /** Chain reads. Default: viem on the PEPU RPC (`PEPU_RPC_URL` aware). */
+    publicClient?: PublicClient;
+}
+/** The five route handlers returned by {@link createSponsoredSessionRoutes}. */
+interface SponsoredSessionRoutes {
+    prepare: {
+        POST(request: Request): Promise<Response>;
+    };
+    activate: {
+        POST(request: Request): Promise<Response>;
+    };
+    status: {
+        GET(request: Request): Promise<Response>;
+    };
+    act: {
+        POST(request: Request): Promise<Response>;
+    };
+    revoke: {
+        POST(request: Request): Promise<Response>;
+    };
+}
+/**
+ * Route handlers for the Kernel session lifecycle.
+ *
+ * - `prepare.POST`: the server creates a fresh session key and decides the
+ *   expiry. The private key stays on the server; the response carries only the
+ *   key's address, the expiry and the scope, so the browser can ask the owner
+ *   for the ONE signature that grants exactly that. Calling it again replaces
+ *   any pending or active session (the old key is dropped).
+ * - `activate.POST` `{ approval }`: checks the approval is for this user's
+ *   smart account and for exactly the key, scope and expiry issued in
+ *   `prepare`, then stores it. 409 `SESSION_NONE` when nothing is pending,
+ *   410 `SESSION_EXPIRED` for an expired offer, 400 `SESSION_APPROVAL_MISMATCH`.
+ * - `status.GET`: `{ active: false }` or `{ active: true, validUntil, ... }`.
+ *   Never returns the session key or approval.
+ * - `act.POST`: signs ONE sponsored UserOperation with the session key. 409
+ *   `SESSION_NONE` without a live session, 429 while another action runs.
+ * - `revoke.POST`: deletes the session key and approval from the server, so
+ *   the app can no longer act, immediately. It does NOT uninstall the
+ *   permission on-chain: that grant stays valid until its expiry, but only the
+ *   deleted key can use it and only within the scope. An on-chain uninstall is
+ *   an owner-signed call to the user's own account, which a paymaster
+ *   destination allowlist rightly does not sponsor.
+ *
+ * Gas: the paymaster policy service reserves worst-case cost per operation:
+ * about 20.5 PEPU for a session's first operation and about 6.9 PEPU for later
+ * ones (`SESSION_GAS_RESERVATION_PEPU`). Size spend caps above that. Fees come
+ * from the chain with 20% headroom.
+ *
+ * @example
+ * // lib/session-routes.ts
+ * export const routes = createSponsoredSessionRoutes({
+ *   scope: { calls: [{ target: tapScore, abi: tapScoreAbi, functionName: "tap" }] },
+ *   store: createMemoryStore(), // DEV ONLY
+ *   act: {
+ *     parse: () => ({}),
+ *     buildCalls: () => [{ to: tapScore, abi: tapScoreAbi, functionName: "tap" }],
+ *   },
+ * });
+ * // app/api/session/prepare/route.ts: export const { POST } = routes.prepare;
+ */
+declare function createSponsoredSessionRoutes<I>(o: SponsoredSessionRoutesOptions<I>): SponsoredSessionRoutes;
+/**
+ * Throws `POLICY_UNSCOPED` (403) unless every call targets an allowed contract
+ * and function selector with a value within the limit. Pure; used by the act
+ * route and exported for custom routes.
+ *
+ * @example
+ * assertCallsInScope(describeKernelSessionScope({ calls, validUntil }), [{ to, abi, functionName: "tap" }]);
+ */
+declare function assertCallsInScope(scope: Pick<KernelSessionScope, "calls">, calls: readonly Call[]): void;
+
+export { type ComboAuthenticate, type ComboUser, KernelSessionCall, KernelSessionScope, SessionStore, type SponsoredSessionRoutes, type SponsoredSessionRoutesOptions, assertCallsInScope, createSponsoredSessionRoutes };

package/dist/combo.d.ts

@@ -0,0 +1,139 @@
+import { PrivyClient } from '@privy-io/node';
+import { Address, PublicClient } from 'viem';
+import { C as Call } from './types-BilBTDqK.js';
+import { K as KernelSessionCall, a as KernelSessionScope } from './scope-DBRkN7bR.js';
+import { S as SessionStore } from './store-CjmLgp9g.js';
+export { a as SessionRecord, c as createMemoryStore, i as isLive } from './store-CjmLgp9g.js';
+export { S as SponsoredActResult } from './types-BEEM7WdG.js';
+export { resolveSessionMinutes } from './server.js';
+
+/** The authenticated caller of a combo route. */
+interface ComboUser {
+    userId: string;
+    /** The user's Privy embedded wallet: the owner of their Kernel account. From Privy, never the request. */
+    ownerAddress: Address;
+}
+/** Authenticate a request. Throw a `PepuError` (or return `null`) when it is not valid. */
+type ComboAuthenticate = (request: Request) => Promise<ComboUser | null>;
+/** Options for {@link createSponsoredSessionRoutes}. */
+interface SponsoredSessionRoutesOptions<I> {
+    /** What the session may call. Enforced on-chain by the call policy. */
+    scope: {
+        calls: readonly KernelSessionCall[];
+        /** Env variable named in the `CONFIG_MISSING_ENV` message when a call target is empty (unset). */
+        targetEnv?: string;
+    };
+    /**
+     * Where session records (including the session private key) live. Use
+     * `createMemoryStore()` for development only: production needs a persistent
+     * store with the key encrypted at rest.
+     */
+    store: SessionStore;
+    /**
+     * Bundler and paymaster. The bundler defaults to env `PEPU_BUNDLER_URL`, then the hosted bundler. The paymaster
+     * needs a complete ERC-7677 URL (env `PEPU_PAYMASTER_URL`, or `paymasterUrl`) or a project `paymasterToken`
+     * (built against the hosted paymaster base).
+     */
+    endpoints?: {
+        bundlerUrl?: string;
+        paymasterUrl?: string;
+        paymasterToken?: string;
+    };
+    /**
+     * Forward the caller's Privy access token (the request's `Authorization: Bearer`) to the paymaster as ERC-7677
+     * `context.privyAccessToken`. The v2 FREE TIER requires it; a project paying from its own deposit does not.
+     * Default `true`. Set `false` if your paymaster URL is not a PEPU policy service you trust with the token.
+     */
+    forwardPrivyToken?: boolean;
+    /** Session length. Default env `SESSION_DURATION_MINUTES`, then 15; clamped to 1..1440. */
+    minutes?: number;
+    /** The one action users take with their session. */
+    act: {
+        /** Validate the client body. Throw to reject with 400. */
+        parse(body: unknown): I;
+        /** The calls to send. Each is re-checked against `scope` before sponsoring. */
+        buildCalls(input: I, ctx: {
+            kernelAddress: Address;
+            ownerAddress: Address;
+        }): Call[];
+    };
+    /** Privy client for the default authentication. Default `createPrivyServer()`. */
+    privy?: PrivyClient;
+    /**
+     * Custom authentication. Default: B1's `requireUser` (verifies the Privy
+     * bearer token and reads the user's embedded wallet from Privy).
+     */
+    authenticate?: ComboAuthenticate;
+    /** Chain reads. Default: viem on the PEPU RPC (`PEPU_RPC_URL` aware). */
+    publicClient?: PublicClient;
+}
+/** The five route handlers returned by {@link createSponsoredSessionRoutes}. */
+interface SponsoredSessionRoutes {
+    prepare: {
+        POST(request: Request): Promise<Response>;
+    };
+    activate: {
+        POST(request: Request): Promise<Response>;
+    };
+    status: {
+        GET(request: Request): Promise<Response>;
+    };
+    act: {
+        POST(request: Request): Promise<Response>;
+    };
+    revoke: {
+        POST(request: Request): Promise<Response>;
+    };
+}
+/**
+ * Route handlers for the Kernel session lifecycle.
+ *
+ * - `prepare.POST`: the server creates a fresh session key and decides the
+ *   expiry. The private key stays on the server; the response carries only the
+ *   key's address, the expiry and the scope, so the browser can ask the owner
+ *   for the ONE signature that grants exactly that. Calling it again replaces
+ *   any pending or active session (the old key is dropped).
+ * - `activate.POST` `{ approval }`: checks the approval is for this user's
+ *   smart account and for exactly the key, scope and expiry issued in
+ *   `prepare`, then stores it. 409 `SESSION_NONE` when nothing is pending,
+ *   410 `SESSION_EXPIRED` for an expired offer, 400 `SESSION_APPROVAL_MISMATCH`.
+ * - `status.GET`: `{ active: false }` or `{ active: true, validUntil, ... }`.
+ *   Never returns the session key or approval.
+ * - `act.POST`: signs ONE sponsored UserOperation with the session key. 409
+ *   `SESSION_NONE` without a live session, 429 while another action runs.
+ * - `revoke.POST`: deletes the session key and approval from the server, so
+ *   the app can no longer act, immediately. It does NOT uninstall the
+ *   permission on-chain: that grant stays valid until its expiry, but only the
+ *   deleted key can use it and only within the scope. An on-chain uninstall is
+ *   an owner-signed call to the user's own account, which a paymaster
+ *   destination allowlist rightly does not sponsor.
+ *
+ * Gas: the paymaster policy service reserves worst-case cost per operation:
+ * about 20.5 PEPU for a session's first operation and about 6.9 PEPU for later
+ * ones (`SESSION_GAS_RESERVATION_PEPU`). Size spend caps above that. Fees come
+ * from the chain with 20% headroom.
+ *
+ * @example
+ * // lib/session-routes.ts
+ * export const routes = createSponsoredSessionRoutes({
+ *   scope: { calls: [{ target: tapScore, abi: tapScoreAbi, functionName: "tap" }] },
+ *   store: createMemoryStore(), // DEV ONLY
+ *   act: {
+ *     parse: () => ({}),
+ *     buildCalls: () => [{ to: tapScore, abi: tapScoreAbi, functionName: "tap" }],
+ *   },
+ * });
+ * // app/api/session/prepare/route.ts: export const { POST } = routes.prepare;
+ */
+declare function createSponsoredSessionRoutes<I>(o: SponsoredSessionRoutesOptions<I>): SponsoredSessionRoutes;
+/**
+ * Throws `POLICY_UNSCOPED` (403) unless every call targets an allowed contract
+ * and function selector with a value within the limit. Pure; used by the act
+ * route and exported for custom routes.
+ *
+ * @example
+ * assertCallsInScope(describeKernelSessionScope({ calls, validUntil }), [{ to, abi, functionName: "tap" }]);
+ */
+declare function assertCallsInScope(scope: Pick<KernelSessionScope, "calls">, calls: readonly Call[]): void;
+
+export { type ComboAuthenticate, type ComboUser, KernelSessionCall, KernelSessionScope, SessionStore, type SponsoredSessionRoutes, type SponsoredSessionRoutesOptions, assertCallsInScope, createSponsoredSessionRoutes };

package/dist/combo.guard.js

@@ -0,0 +1,15 @@
+// Generated by scripts/guard-peers.mjs. Used only under the "node" export condition.
+const peers = ["@privy-io/node","@zerodev/sdk","@zerodev/permissions","@zerodev/ecdsa-validator"];
+for (const peer of peers) {
+  try {
+    import.meta.resolve?.(peer);
+  } catch (e) {
+    if (e && e.code === "ERR_MODULE_NOT_FOUND") {
+      const err = new Error("@pepu-chain/sdk/combo needs peer packages that are not installed: @privy-io/node @zerodev/sdk @zerodev/permissions @zerodev/ecdsa-validator. Install with: npm i @privy-io/node @zerodev/sdk @zerodev/permissions @zerodev/ecdsa-validator  (or let create-pepu-app scaffold everything).");
+      err.code = "PEPU_MISSING_PEER";
+      throw err;
+    }
+  }
+}
+const mod = await import("./combo.js");
+export const { createMemoryStore, isLive, resolveSessionMinutes, assertCallsInScope, createSponsoredSessionRoutes } = mod;