@pepu-chain/sdk 0.0.0-stage → 0.2.0

package/dist/combo.js

@@ -0,0 +1,249 @@
+import { buildKernelSessionPolicies, isLive, loadKernelSessionAccount, generateSessionKey, expectedPermissionId } from './chunk-KVG3AYYR.js';
+export { createMemoryStore, isLive } from './chunk-KVG3AYYR.js';
+import { createPepuSponsoredClient, sendSponsored, getKernelAddress } from './chunk-ZB6SVBK4.js';
+import './chunk-IB2FSPMJ.js';
+import { normalizeCalls } from './chunk-VBH3JLQ5.js';
+import './chunk-IY3ALPUJ.js';
+import { buildPaymasterContext } from './chunk-MBA4CLA5.js';
+import './chunk-D52PADVY.js';
+import './chunk-FCXSP2YF.js';
+import { isCallInScope, describeKernelSessionScope, checkApproval } from './chunk-ESMNAXUI.js';
+import './chunk-J6UXXHBE.js';
+import { resolvePepuEndpoints } from './chunk-XC4IBCI2.js';
+import { pepuMainnet } from './chunk-VTQIHMF3.js';
+import { requireUser, createPrivyServer } from './chunk-62M2LKQW.js';
+import { assertServerOnly } from './chunk-W3JN3YIW.js';
+import './chunk-3XUGQODR.js';
+import { sessionExpiry, resolveSessionMinutes } from './chunk-YKEWWQEJ.js';
+export { resolveSessionMinutes } from './chunk-YKEWWQEJ.js';
+import { PepuPolicyError, toErrorResponse, PepuConfigError, toPepuError, PepuError, PepuChainError, PepuSessionError, PepuAuthError } from './chunk-6DSZ4Z2N.js';
+import { createPublicClient, http } from 'viem';
+
+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 = toPepuError(e, { op });
+  if (err.code === "UNKNOWN" && !(e instanceof PepuError)) {
+    return new PepuChainError("UNKNOWN", err.message, { status: 502, cause: e });
+  }
+  return err;
+}
+async function guard(op, fn) {
+  try {
+    return await fn();
+  } catch (e) {
+    return 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 createPublicClient({ chain: pepuMainnet, transport: http(resolvePepuEndpoints().rpcUrl) });
+}
+function createSponsoredSessionRoutes(o) {
+  const unconfigured = o.scope.calls.some((c) => !c.target || String(c.target).trim() === "");
+  if (unconfigured) {
+    const unset = async () => toErrorResponse(
+      new 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 }
+    };
+  }
+  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 PepuAuthError("AUTH_INVALID_TOKEN", "Missing or invalid Privy access token.");
+      return user;
+    }
+    const auth = await requireUser(request, { privy: o.privy ?? createPrivyServer() });
+    if (!auth.ok) return auth.response;
+    if (!auth.user.address) {
+      throw new 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 ?? resolveSessionMinutes(process.env.SESSION_DURATION_MINUTES);
+  const policiesFor = (validUntil) => 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 = sessionExpiry(nowSeconds(), mins);
+        const key = generateSessionKey();
+        const policies = policiesFor(validUntil);
+        const [kernelAddress, permissionId] = await Promise.all([
+          getKernelAddress(client(), ownerAddress),
+          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: 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 PepuPolicyError("UNKNOWN", "Missing approval.", { status: 400, hint: "Send { approval }." });
+        }
+        const record = await o.store.get(user.userId);
+        if (!record || record.approval !== null) {
+          throw new PepuSessionError("SESSION_NONE", "No pending session. Start again.");
+        }
+        if (nowSeconds() >= record.validUntil) {
+          await o.store.delete(record.userId);
+          throw new PepuSessionError("SESSION_EXPIRED", "The session offer expired. Start again.");
+        }
+        const check = checkApproval(body.approval, {
+          kernelAddress: record.kernelAddress,
+          permissionId: record.permissionId
+        });
+        if (!check.ok) throw new 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 || !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 || !isLive(record, nowSeconds())) {
+          throw new PepuSessionError("SESSION_NONE", "No active session. Start one first.");
+        }
+        let input;
+        try {
+          input = o.act.parse(await request.json().catch(() => ({})));
+        } catch (e) {
+          throw new 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(describeKernelSessionScope({ calls: o.scope.calls, validUntil: record.validUntil }), calls);
+        if (!await o.store.tryLock(user.userId)) {
+          throw new 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 loadKernelSessionAccount({
+            publicClient: client(),
+            approval: record.approval,
+            sessionPrivateKey: record.sessionPrivateKey
+          });
+          const kernel = 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: buildPaymasterContext({ privyAccessToken: privyToken }) } : {}
+          });
+          const result = await 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 normalizeCalls(calls)) {
+    if (!isCallInScope(scope, c)) {
+      throw new PepuPolicyError("POLICY_UNSCOPED", "A call is outside the session scope.", {
+        status: 403,
+        hint: "Only the contracts and functions the user approved can be called."
+      });
+    }
+  }
+}
+
+export { assertCallsInScope, createSponsoredSessionRoutes };
+//# sourceMappingURL=combo.js.map
+//# sourceMappingURL=combo.js.map

package/dist/combo.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/combo/server.ts"],"names":[],"mappings":"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","file":"combo.js","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/config-CHjz7ZjZ.d.cts

@@ -0,0 +1,57 @@
+import { P as PepuChain } from './chains-DK13zGIp.cjs';
+
+/**
+ * Typed Privy client config for PEPU (`@pepu-chain/sdk/privy`). Client-safe:
+ * no secrets, no Node APIs, and no dependency on any Privy package (the result
+ * is structurally assignable to `PrivyClientConfig` from
+ * `@privy-io/react-auth`).
+ *
+ * What it encodes, each a real, reproduced PEPU requirement:
+ *
+ * - `defaultChain` / `supportedChains` are PEPU mainnet only.
+ * - `embeddedWallets.ethereum.createOnLogin` defaults to `"off"`: the
+ *   recommended pattern is to provision the wallet server-side (see the
+ *   wallet-provisioning recipe). NOTE the Privy Dashboard's setting wins over
+ *   this value at runtime; it is kept for intent and documentation.
+ * - Coinbase Wallet is pinned to `eoaOnly`: Coinbase Smart Wallet does not
+ *   support chain 97741, and the default floods the console with "The
+ *   configured chains are not supported by Coinbase Smart Wallet".
+ */
+type PrivyLoginMethod = "email" | "google" | "wallet" | "sms" | "apple" | "twitter" | "discord" | "github";
+type EmbeddedWalletCreateOnLogin = "off" | "users-without-wallets" | "all-users";
+interface PepuPrivyClientConfig {
+    loginMethods?: PrivyLoginMethod[];
+    appearance?: {
+        theme?: "light" | "dark" | `#${string}`;
+        accentColor?: `#${string}`;
+        logo?: string;
+    };
+    defaultChain: PepuChain;
+    supportedChains: PepuChain[];
+    embeddedWallets: {
+        ethereum: {
+            createOnLogin: EmbeddedWalletCreateOnLogin;
+        };
+    };
+    externalWallets: {
+        coinbaseWallet: {
+            config: {
+                preference: {
+                    options: "eoaOnly";
+                };
+            };
+        };
+    };
+}
+interface CreatePepuPrivyConfigOptions {
+    loginMethods?: PrivyLoginMethod[];
+    appearance?: PepuPrivyClientConfig["appearance"];
+    /** Default `"off"`. The Privy Dashboard setting overrides this at runtime. */
+    createOnLogin?: EmbeddedWalletCreateOnLogin;
+    /** Default {@link pepuMainnet}. Only pass a different PEPU chain deliberately. */
+    chain?: PepuChain;
+}
+/** Build the `config` prop for Privy's `<PrivyProvider>` on PEPU. */
+declare function createPepuPrivyConfig(options?: CreatePepuPrivyConfigOptions): PepuPrivyClientConfig;
+
+export { type CreatePepuPrivyConfigOptions as C, type EmbeddedWalletCreateOnLogin as E, type PepuPrivyClientConfig as P, type PrivyLoginMethod as a, createPepuPrivyConfig as c };

package/dist/config-COjhIZTh.d.ts

@@ -0,0 +1,57 @@
+import { P as PepuChain } from './chains-DK13zGIp.js';
+
+/**
+ * Typed Privy client config for PEPU (`@pepu-chain/sdk/privy`). Client-safe:
+ * no secrets, no Node APIs, and no dependency on any Privy package (the result
+ * is structurally assignable to `PrivyClientConfig` from
+ * `@privy-io/react-auth`).
+ *
+ * What it encodes, each a real, reproduced PEPU requirement:
+ *
+ * - `defaultChain` / `supportedChains` are PEPU mainnet only.
+ * - `embeddedWallets.ethereum.createOnLogin` defaults to `"off"`: the
+ *   recommended pattern is to provision the wallet server-side (see the
+ *   wallet-provisioning recipe). NOTE the Privy Dashboard's setting wins over
+ *   this value at runtime; it is kept for intent and documentation.
+ * - Coinbase Wallet is pinned to `eoaOnly`: Coinbase Smart Wallet does not
+ *   support chain 97741, and the default floods the console with "The
+ *   configured chains are not supported by Coinbase Smart Wallet".
+ */
+type PrivyLoginMethod = "email" | "google" | "wallet" | "sms" | "apple" | "twitter" | "discord" | "github";
+type EmbeddedWalletCreateOnLogin = "off" | "users-without-wallets" | "all-users";
+interface PepuPrivyClientConfig {
+    loginMethods?: PrivyLoginMethod[];
+    appearance?: {
+        theme?: "light" | "dark" | `#${string}`;
+        accentColor?: `#${string}`;
+        logo?: string;
+    };
+    defaultChain: PepuChain;
+    supportedChains: PepuChain[];
+    embeddedWallets: {
+        ethereum: {
+            createOnLogin: EmbeddedWalletCreateOnLogin;
+        };
+    };
+    externalWallets: {
+        coinbaseWallet: {
+            config: {
+                preference: {
+                    options: "eoaOnly";
+                };
+            };
+        };
+    };
+}
+interface CreatePepuPrivyConfigOptions {
+    loginMethods?: PrivyLoginMethod[];
+    appearance?: PepuPrivyClientConfig["appearance"];
+    /** Default `"off"`. The Privy Dashboard setting overrides this at runtime. */
+    createOnLogin?: EmbeddedWalletCreateOnLogin;
+    /** Default {@link pepuMainnet}. Only pass a different PEPU chain deliberately. */
+    chain?: PepuChain;
+}
+/** Build the `config` prop for Privy's `<PrivyProvider>` on PEPU. */
+declare function createPepuPrivyConfig(options?: CreatePepuPrivyConfigOptions): PepuPrivyClientConfig;
+
+export { type CreatePepuPrivyConfigOptions as C, type EmbeddedWalletCreateOnLogin as E, type PepuPrivyClientConfig as P, type PrivyLoginMethod as a, createPepuPrivyConfig as c };