@opendatalabs/vana-sdk 3.8.3 → 3.9.0

package/README.md

@@ -29,6 +29,10 @@ encryption, storage providers, and a shared isomorphic platform layer.
 - **Storage providers** — `VanaStorage` (default, talks to `storage.vana.org`),
   `R2Storage`, `StorageManager`, `IpfsStorage`, `PinataStorage`,
   `GoogleDriveStorage`, `DropboxStorage`, `CallbackStorage`.
+- **Vana service integrations** — `@opendatalabs/vana-sdk/server`,
+  `@opendatalabs/vana-sdk/react`, and `@opendatalabs/vana-sdk/session-relay`
+  for Vana-operated app handoff flows. These are integration helpers, not
+  protocol-core modules.
 - **Platform adapters** — `NodePlatformAdapter` and `BrowserPlatformAdapter`
   with a shared `VanaPlatformAdapter` interface, plus detection helpers
   (`detectPlatform`, `isPlatformSupported`, `createPlatformAdapter`,
@@ -104,12 +108,12 @@ const result = await storage.upload(myBlob, "report.json");
 console.log(result.url);
 ```
 
-## Build a direct Vana app
+## Build a Vana app
 
 Request user-approved data, read it from the user's Personal Server, and pay
 for the read — without the browser ever seeing your app private key or choosing
-scopes. Your **backend** owns the controller (`@opendatalabs/vana-sdk/server`);
-your **frontend** drives a two-tab approval flow with a React hook
+scopes. Your **backend** owns the Data Portability controller
+(`@opendatalabs/vana-sdk/server`); your **frontend** drives a two-tab approval flow with a React hook
 (`@opendatalabs/vana-sdk/react`).
 
 > **How it fits together.** Access requests are created through the Vana Account
@@ -136,12 +140,12 @@ export const vana = createDirectDataController({
   network: process.env.VANA_NETWORK === "moksha" ? "moksha" : "mainnet",
   appPrivateKey: process.env.VANA_APP_PRIVATE_KEY!,
   app: {
-    id: "notes-lens",
-    name: "Notes Lens",
+    id: "spotify-taste",
+    name: "Spotify Taste",
     homepageUrl: process.env.VANA_APP_URL!,
   },
-  source: "icloud_notes",
-  scopes: ["icloud_notes.notes"],
+  source: "spotify",
+  scopes: ["spotify.savedTracks"],
   // Settle paid reads through the DPv2 escrow gateway. The controller signs the
   // GenericPayment with your app key; you supply the gateway client + contract.
   escrow: {
@@ -172,7 +176,7 @@ const status = await vana.getAccessRequestStatus(requestId);
 // GET /api/vana/data?requestId=...
 const result = await vana.readApprovedData({ requestId });
 // -> {
-//   scope: "icloud_notes.notes",
+//   scope: "spotify.savedTracks",
 //   data: ...,
 //   payment?: {            // present only when this read settled a payment
 //     amount, asset, paymentNonce, paidAt,
@@ -194,7 +198,7 @@ amount and asset owed.
 "use client";
 import { useDirectVanaConnect } from "@opendatalabs/vana-sdk/react";
 
-export function ConnectNotesButton() {
+export function ConnectSpotifyButton() {
   const connect = useDirectVanaConnect({
     createRequest: () =>
       fetch("/api/vana/request", { method: "POST" }).then((r) => r.json()),
@@ -214,7 +218,7 @@ export function ConnectNotesButton() {
       onClick={connect.start}
       type="button"
     >
-      {connect.state.type === "idle" ? "Connect Apple Notes" : "Connecting..."}
+      {connect.state.type === "idle" ? "Connect Spotify" : "Connecting..."}
     </button>
   );
 }
@@ -225,6 +229,23 @@ until the request is approved, then calls `readResult`. `react` is an optional
 peer dependency. The underlying `createDirectConnectFlow` store is also exported
 for non-React frontends.
 
+### Test with large sample data
+
+When testing with realistic exports, use the public fixture catalog in
+[`vana-com/data-connectors`](https://github.com/vana-com/data-connectors). Keep
+the payload in a file or raw URL and point your app or agent at that location.
+Do not paste large JSON into the terminal.
+
+The controller can run against local test data by injecting an
+`accessRequestClient` that returns an approved request and a
+`personalServerFetch` that loads the sample payload, while the rest of your app
+still calls `readApprovedData`.
+
+See [`examples/vana-app`](../../examples/vana-app) for a runnable Next.js Vana
+app. It includes the route handlers, return page, and React connect button from
+this flow, defaults to sample-data mode using `vana-com/data-connectors`, and
+can be switched to live protocol mode with environment variables.
+
 ## Networks
 
 | Network        | Chain ID | RPC URL                     |

package/dist/session-relay/client.cjs

@@ -0,0 +1,215 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var client_exports = {};
+__export(client_exports, {
+  createSessionRelayBuilderClient: () => createSessionRelayBuilderClient,
+  createSessionRelayClient: () => createSessionRelayClient
+});
+module.exports = __toCommonJS(client_exports);
+var import_endpoints = require("./endpoints");
+var import_errors = require("./errors");
+var import_signing = require("./signing");
+const DEFAULT_POLL_INTERVAL_MS = 2e3;
+const DEFAULT_POLL_TIMEOUT_MS = 15 * 6e4;
+function stripTrailingSlash(url) {
+  return url.replace(/\/+$/, "");
+}
+function resolveFetch(fetchFn) {
+  const resolved = fetchFn ?? globalThis.fetch;
+  if (!resolved) {
+    throw new import_errors.SessionRelayError(
+      "No fetch implementation available. Pass `fetchFn` to the Session Relay client.",
+      { relayErrorCode: "SESSION_RELAY_CONFIG_ERROR" }
+    );
+  }
+  return resolved;
+}
+function endpoint(options) {
+  return stripTrailingSlash(options.baseUrl ?? (0, import_endpoints.getSessionRelayUrl)(options.env));
+}
+async function parseJson(res) {
+  if (res.status === 204) return void 0;
+  if (res.text) {
+    const text = await res.text();
+    if (text.length === 0) return void 0;
+    try {
+      return JSON.parse(text);
+    } catch {
+      throw new import_errors.SessionRelayError(
+        `Session Relay returned a non-JSON response (HTTP ${res.status})`,
+        { status: res.status }
+      );
+    }
+  }
+  try {
+    return await res.json();
+  } catch {
+    throw new import_errors.SessionRelayError(
+      `Session Relay returned a non-JSON response (HTTP ${res.status})`,
+      { status: res.status }
+    );
+  }
+}
+function relayErrorFromBody(body) {
+  if (body === null || typeof body !== "object" || !("error" in body)) {
+    return void 0;
+  }
+  const error = body.error;
+  if (error === null || typeof error !== "object") return void 0;
+  return error;
+}
+async function relayFetch(fetchFn, url, init) {
+  let res;
+  try {
+    res = await fetchFn(url, init);
+  } catch (err) {
+    throw new import_errors.SessionRelayError(
+      "Network error communicating with Session Relay",
+      {
+        body: err
+      }
+    );
+  }
+  const body = await parseJson(res);
+  if (!res.ok) {
+    const relayError = relayErrorFromBody(body);
+    throw new import_errors.SessionRelayError(
+      relayError?.message ?? `Session Relay request failed (HTTP ${res.status})`,
+      {
+        status: res.status,
+        relayCode: relayError?.code,
+        relayErrorCode: relayError?.errorCode,
+        body
+      }
+    );
+  }
+  return body;
+}
+async function pollSession(fetchFn, baseUrl, sessionId) {
+  return relayFetch(
+    fetchFn,
+    `${baseUrl}/v1/session/${encodeURIComponent(sessionId)}/poll`,
+    { method: "GET" }
+  );
+}
+async function pollUntilComplete(fetchFn, baseUrl, sessionId, opts) {
+  const intervalMs = opts?.intervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+  const timeoutMs = opts?.timeoutMs ?? DEFAULT_POLL_TIMEOUT_MS;
+  const deadline = Date.now() + timeoutMs;
+  while (Date.now() < deadline) {
+    const result = await pollSession(fetchFn, baseUrl, sessionId);
+    if (result.status === "approved" || result.status === "denied" || result.status === "expired") {
+      return result;
+    }
+    await new Promise((resolve) => setTimeout(resolve, intervalMs));
+  }
+  throw new import_errors.SessionRelayError("Polling timed out", {
+    relayErrorCode: "SESSION_RELAY_POLL_TIMEOUT"
+  });
+}
+function createSessionRelayClient(options = {}) {
+  const fetchFn = resolveFetch(options.fetchFn);
+  const baseUrl = endpoint(options);
+  return {
+    claimSession(request) {
+      return relayFetch(
+        fetchFn,
+        `${baseUrl}/v1/session/claim`,
+        {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify(request)
+        }
+      );
+    },
+    async approveSession(sessionId, request) {
+      await relayFetch(
+        fetchFn,
+        `${baseUrl}/v1/session/${encodeURIComponent(sessionId)}/approve`,
+        {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify(request)
+        }
+      );
+    },
+    async denySession(sessionId, request) {
+      await relayFetch(
+        fetchFn,
+        `${baseUrl}/v1/session/${encodeURIComponent(sessionId)}/deny`,
+        {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify(request)
+        }
+      );
+    },
+    pollSession(sessionId) {
+      return pollSession(fetchFn, baseUrl, sessionId);
+    },
+    pollUntilComplete(sessionId, opts) {
+      return pollUntilComplete(fetchFn, baseUrl, sessionId, opts);
+    }
+  };
+}
+function createSessionRelayBuilderClient(options) {
+  const fetchFn = resolveFetch(options.fetchFn);
+  const baseUrl = endpoint(options);
+  return {
+    async initSession(params) {
+      const path = "/v1/session/init";
+      const body = JSON.stringify({
+        granteeAddress: options.granteeAddress,
+        scopes: params.scopes,
+        ...params.webhookUrl && { webhookUrl: params.webhookUrl },
+        ...params.appUserId && { appUserId: params.appUserId }
+      });
+      const iat = options.now?.() ?? Math.floor(Date.now() / 1e3);
+      const authHeader = await (0, import_signing.buildSessionRelayWeb3SignedHeader)({
+        signMessage: options.signMessage,
+        aud: baseUrl,
+        method: "POST",
+        uri: path,
+        body,
+        iat,
+        exp: iat + 300
+      });
+      return relayFetch(fetchFn, `${baseUrl}${path}`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          Authorization: authHeader
+        },
+        body
+      });
+    },
+    pollSession(sessionId) {
+      return pollSession(fetchFn, baseUrl, sessionId);
+    },
+    pollUntilComplete(sessionId, opts) {
+      return pollUntilComplete(fetchFn, baseUrl, sessionId, opts);
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createSessionRelayBuilderClient,
+  createSessionRelayClient
+});
+//# sourceMappingURL=client.cjs.map

package/dist/session-relay/client.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/session-relay/client.ts"],"sourcesContent":["import { getSessionRelayUrl } from \"./endpoints\";\nimport { SessionRelayError } from \"./errors\";\nimport { buildSessionRelayWeb3SignedHeader } from \"./signing\";\nimport type {\n  SessionRelayApproveRequest,\n  SessionRelayBuilderClient,\n  SessionRelayBuilderClientOptions,\n  SessionRelayClaimRequest,\n  SessionRelayClaimResponse,\n  SessionRelayClient,\n  SessionRelayClientOptions,\n  SessionRelayDenyRequest,\n  SessionRelayFetch,\n  SessionRelayInitParams,\n  SessionRelayInitResult,\n  SessionRelayPollResult,\n} from \"./types\";\n\nconst DEFAULT_POLL_INTERVAL_MS = 2_000;\nconst DEFAULT_POLL_TIMEOUT_MS = 15 * 60_000;\n\nfunction stripTrailingSlash(url: string): string {\n  return url.replace(/\\/+$/, \"\");\n}\n\nfunction resolveFetch(fetchFn?: SessionRelayFetch): SessionRelayFetch {\n  const resolved = fetchFn ?? (globalThis.fetch as SessionRelayFetch);\n  if (!resolved) {\n    throw new SessionRelayError(\n      \"No fetch implementation available. Pass `fetchFn` to the Session Relay client.\",\n      { relayErrorCode: \"SESSION_RELAY_CONFIG_ERROR\" },\n    );\n  }\n  return resolved;\n}\n\nfunction endpoint(options: SessionRelayClientOptions): string {\n  return stripTrailingSlash(options.baseUrl ?? getSessionRelayUrl(options.env));\n}\n\nasync function parseJson(res: Awaited<ReturnType<SessionRelayFetch>>) {\n  if (res.status === 204) return undefined;\n\n  if (res.text) {\n    const text = await res.text();\n    if (text.length === 0) return undefined;\n    try {\n      return JSON.parse(text) as unknown;\n    } catch {\n      throw new SessionRelayError(\n        `Session Relay returned a non-JSON response (HTTP ${res.status})`,\n        { status: res.status },\n      );\n    }\n  }\n\n  try {\n    return await res.json();\n  } catch {\n    throw new SessionRelayError(\n      `Session Relay returned a non-JSON response (HTTP ${res.status})`,\n      { status: res.status },\n    );\n  }\n}\n\nfunction relayErrorFromBody(\n  body: unknown,\n):\n  | { message?: string; code?: number; errorCode?: string; details?: unknown }\n  | undefined {\n  if (body === null || typeof body !== \"object\" || !(\"error\" in body)) {\n    return undefined;\n  }\n  const error = (body as { error?: unknown }).error;\n  if (error === null || typeof error !== \"object\") return undefined;\n  return error as {\n    message?: string;\n    code?: number;\n    errorCode?: string;\n    details?: unknown;\n  };\n}\n\nasync function relayFetch<T>(\n  fetchFn: SessionRelayFetch,\n  url: string,\n  init: { method: string; headers?: Record<string, string>; body?: string },\n): Promise<T> {\n  let res: Awaited<ReturnType<SessionRelayFetch>>;\n  try {\n    res = await fetchFn(url, init);\n  } catch (err) {\n    throw new SessionRelayError(\n      \"Network error communicating with Session Relay\",\n      {\n        body: err,\n      },\n    );\n  }\n\n  const body = await parseJson(res);\n  if (!res.ok) {\n    const relayError = relayErrorFromBody(body);\n    throw new SessionRelayError(\n      relayError?.message ??\n        `Session Relay request failed (HTTP ${res.status})`,\n      {\n        status: res.status,\n        relayCode: relayError?.code,\n        relayErrorCode: relayError?.errorCode,\n        body,\n      },\n    );\n  }\n\n  return body as T;\n}\n\nasync function pollSession(\n  fetchFn: SessionRelayFetch,\n  baseUrl: string,\n  sessionId: string,\n): Promise<SessionRelayPollResult> {\n  return relayFetch<SessionRelayPollResult>(\n    fetchFn,\n    `${baseUrl}/v1/session/${encodeURIComponent(sessionId)}/poll`,\n    { method: \"GET\" },\n  );\n}\n\nasync function pollUntilComplete(\n  fetchFn: SessionRelayFetch,\n  baseUrl: string,\n  sessionId: string,\n  opts?: { intervalMs?: number; timeoutMs?: number },\n): Promise<SessionRelayPollResult> {\n  const intervalMs = opts?.intervalMs ?? DEFAULT_POLL_INTERVAL_MS;\n  const timeoutMs = opts?.timeoutMs ?? DEFAULT_POLL_TIMEOUT_MS;\n  const deadline = Date.now() + timeoutMs;\n\n  while (Date.now() < deadline) {\n    const result = await pollSession(fetchFn, baseUrl, sessionId);\n    if (\n      result.status === \"approved\" ||\n      result.status === \"denied\" ||\n      result.status === \"expired\"\n    ) {\n      return result;\n    }\n    await new Promise((resolve) => setTimeout(resolve, intervalMs));\n  }\n\n  throw new SessionRelayError(\"Polling timed out\", {\n    relayErrorCode: \"SESSION_RELAY_POLL_TIMEOUT\",\n  });\n}\n\n/**\n * Create a Session Relay client for app-side claim/approve/deny calls and\n * unsigned polling.\n *\n * @remarks\n * This is a Vana service integration client, not a protocol-core primitive.\n * It intentionally models the current Session Relay HTTP API while leaving\n * user-facing grant orchestration to the app using it.\n */\nexport function createSessionRelayClient(\n  options: SessionRelayClientOptions = {},\n): SessionRelayClient {\n  const fetchFn = resolveFetch(options.fetchFn);\n  const baseUrl = endpoint(options);\n\n  return {\n    claimSession(\n      request: SessionRelayClaimRequest,\n    ): Promise<SessionRelayClaimResponse> {\n      return relayFetch<SessionRelayClaimResponse>(\n        fetchFn,\n        `${baseUrl}/v1/session/claim`,\n        {\n          method: \"POST\",\n          headers: { \"Content-Type\": \"application/json\" },\n          body: JSON.stringify(request),\n        },\n      );\n    },\n\n    async approveSession(\n      sessionId: string,\n      request: SessionRelayApproveRequest,\n    ): Promise<void> {\n      await relayFetch<unknown>(\n        fetchFn,\n        `${baseUrl}/v1/session/${encodeURIComponent(sessionId)}/approve`,\n        {\n          method: \"POST\",\n          headers: { \"Content-Type\": \"application/json\" },\n          body: JSON.stringify(request),\n        },\n      );\n    },\n\n    async denySession(\n      sessionId: string,\n      request: SessionRelayDenyRequest,\n    ): Promise<void> {\n      await relayFetch<unknown>(\n        fetchFn,\n        `${baseUrl}/v1/session/${encodeURIComponent(sessionId)}/deny`,\n        {\n          method: \"POST\",\n          headers: { \"Content-Type\": \"application/json\" },\n          body: JSON.stringify(request),\n        },\n      );\n    },\n\n    pollSession(sessionId: string): Promise<SessionRelayPollResult> {\n      return pollSession(fetchFn, baseUrl, sessionId);\n    },\n\n    pollUntilComplete(\n      sessionId: string,\n      opts?: { intervalMs?: number; timeoutMs?: number },\n    ): Promise<SessionRelayPollResult> {\n      return pollUntilComplete(fetchFn, baseUrl, sessionId, opts);\n    },\n  };\n}\n\n/**\n * Create a builder-side Session Relay client for signed session init and\n * unsigned polling.\n */\nexport function createSessionRelayBuilderClient(\n  options: SessionRelayBuilderClientOptions,\n): SessionRelayBuilderClient {\n  const fetchFn = resolveFetch(options.fetchFn);\n  const baseUrl = endpoint(options);\n\n  return {\n    async initSession(\n      params: SessionRelayInitParams,\n    ): Promise<SessionRelayInitResult> {\n      const path = \"/v1/session/init\";\n      const body = JSON.stringify({\n        granteeAddress: options.granteeAddress,\n        scopes: params.scopes,\n        ...(params.webhookUrl && { webhookUrl: params.webhookUrl }),\n        ...(params.appUserId && { appUserId: params.appUserId }),\n      });\n      const iat = options.now?.() ?? Math.floor(Date.now() / 1000);\n      const authHeader = await buildSessionRelayWeb3SignedHeader({\n        signMessage: options.signMessage,\n        aud: baseUrl,\n        method: \"POST\",\n        uri: path,\n        body,\n        iat,\n        exp: iat + 300,\n      });\n\n      return relayFetch<SessionRelayInitResult>(fetchFn, `${baseUrl}${path}`, {\n        method: \"POST\",\n        headers: {\n          \"Content-Type\": \"application/json\",\n          Authorization: authHeader,\n        },\n        body,\n      });\n    },\n\n    pollSession(sessionId: string): Promise<SessionRelayPollResult> {\n      return pollSession(fetchFn, baseUrl, sessionId);\n    },\n\n    pollUntilComplete(\n      sessionId: string,\n      opts?: { intervalMs?: number; timeoutMs?: number },\n    ): Promise<SessionRelayPollResult> {\n      return pollUntilComplete(fetchFn, baseUrl, sessionId, opts);\n    },\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/session-relay/client.d.ts

@@ -0,0 +1,16 @@
+import type { SessionRelayBuilderClient, SessionRelayBuilderClientOptions, SessionRelayClient, SessionRelayClientOptions } from "./types";
+/**
+ * Create a Session Relay client for app-side claim/approve/deny calls and
+ * unsigned polling.
+ *
+ * @remarks
+ * This is a Vana service integration client, not a protocol-core primitive.
+ * It intentionally models the current Session Relay HTTP API while leaving
+ * user-facing grant orchestration to the app using it.
+ */
+export declare function createSessionRelayClient(options?: SessionRelayClientOptions): SessionRelayClient;
+/**
+ * Create a builder-side Session Relay client for signed session init and
+ * unsigned polling.
+ */
+export declare function createSessionRelayBuilderClient(options: SessionRelayBuilderClientOptions): SessionRelayBuilderClient;

package/dist/session-relay/client.js

@@ -0,0 +1,190 @@
+import { getSessionRelayUrl } from "./endpoints.js";
+import { SessionRelayError } from "./errors.js";
+import { buildSessionRelayWeb3SignedHeader } from "./signing.js";
+const DEFAULT_POLL_INTERVAL_MS = 2e3;
+const DEFAULT_POLL_TIMEOUT_MS = 15 * 6e4;
+function stripTrailingSlash(url) {
+  return url.replace(/\/+$/, "");
+}
+function resolveFetch(fetchFn) {
+  const resolved = fetchFn ?? globalThis.fetch;
+  if (!resolved) {
+    throw new SessionRelayError(
+      "No fetch implementation available. Pass `fetchFn` to the Session Relay client.",
+      { relayErrorCode: "SESSION_RELAY_CONFIG_ERROR" }
+    );
+  }
+  return resolved;
+}
+function endpoint(options) {
+  return stripTrailingSlash(options.baseUrl ?? getSessionRelayUrl(options.env));
+}
+async function parseJson(res) {
+  if (res.status === 204) return void 0;
+  if (res.text) {
+    const text = await res.text();
+    if (text.length === 0) return void 0;
+    try {
+      return JSON.parse(text);
+    } catch {
+      throw new SessionRelayError(
+        `Session Relay returned a non-JSON response (HTTP ${res.status})`,
+        { status: res.status }
+      );
+    }
+  }
+  try {
+    return await res.json();
+  } catch {
+    throw new SessionRelayError(
+      `Session Relay returned a non-JSON response (HTTP ${res.status})`,
+      { status: res.status }
+    );
+  }
+}
+function relayErrorFromBody(body) {
+  if (body === null || typeof body !== "object" || !("error" in body)) {
+    return void 0;
+  }
+  const error = body.error;
+  if (error === null || typeof error !== "object") return void 0;
+  return error;
+}
+async function relayFetch(fetchFn, url, init) {
+  let res;
+  try {
+    res = await fetchFn(url, init);
+  } catch (err) {
+    throw new SessionRelayError(
+      "Network error communicating with Session Relay",
+      {
+        body: err
+      }
+    );
+  }
+  const body = await parseJson(res);
+  if (!res.ok) {
+    const relayError = relayErrorFromBody(body);
+    throw new SessionRelayError(
+      relayError?.message ?? `Session Relay request failed (HTTP ${res.status})`,
+      {
+        status: res.status,
+        relayCode: relayError?.code,
+        relayErrorCode: relayError?.errorCode,
+        body
+      }
+    );
+  }
+  return body;
+}
+async function pollSession(fetchFn, baseUrl, sessionId) {
+  return relayFetch(
+    fetchFn,
+    `${baseUrl}/v1/session/${encodeURIComponent(sessionId)}/poll`,
+    { method: "GET" }
+  );
+}
+async function pollUntilComplete(fetchFn, baseUrl, sessionId, opts) {
+  const intervalMs = opts?.intervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+  const timeoutMs = opts?.timeoutMs ?? DEFAULT_POLL_TIMEOUT_MS;
+  const deadline = Date.now() + timeoutMs;
+  while (Date.now() < deadline) {
+    const result = await pollSession(fetchFn, baseUrl, sessionId);
+    if (result.status === "approved" || result.status === "denied" || result.status === "expired") {
+      return result;
+    }
+    await new Promise((resolve) => setTimeout(resolve, intervalMs));
+  }
+  throw new SessionRelayError("Polling timed out", {
+    relayErrorCode: "SESSION_RELAY_POLL_TIMEOUT"
+  });
+}
+function createSessionRelayClient(options = {}) {
+  const fetchFn = resolveFetch(options.fetchFn);
+  const baseUrl = endpoint(options);
+  return {
+    claimSession(request) {
+      return relayFetch(
+        fetchFn,
+        `${baseUrl}/v1/session/claim`,
+        {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify(request)
+        }
+      );
+    },
+    async approveSession(sessionId, request) {
+      await relayFetch(
+        fetchFn,
+        `${baseUrl}/v1/session/${encodeURIComponent(sessionId)}/approve`,
+        {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify(request)
+        }
+      );
+    },
+    async denySession(sessionId, request) {
+      await relayFetch(
+        fetchFn,
+        `${baseUrl}/v1/session/${encodeURIComponent(sessionId)}/deny`,
+        {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify(request)
+        }
+      );
+    },
+    pollSession(sessionId) {
+      return pollSession(fetchFn, baseUrl, sessionId);
+    },
+    pollUntilComplete(sessionId, opts) {
+      return pollUntilComplete(fetchFn, baseUrl, sessionId, opts);
+    }
+  };
+}
+function createSessionRelayBuilderClient(options) {
+  const fetchFn = resolveFetch(options.fetchFn);
+  const baseUrl = endpoint(options);
+  return {
+    async initSession(params) {
+      const path = "/v1/session/init";
+      const body = JSON.stringify({
+        granteeAddress: options.granteeAddress,
+        scopes: params.scopes,
+        ...params.webhookUrl && { webhookUrl: params.webhookUrl },
+        ...params.appUserId && { appUserId: params.appUserId }
+      });
+      const iat = options.now?.() ?? Math.floor(Date.now() / 1e3);
+      const authHeader = await buildSessionRelayWeb3SignedHeader({
+        signMessage: options.signMessage,
+        aud: baseUrl,
+        method: "POST",
+        uri: path,
+        body,
+        iat,
+        exp: iat + 300
+      });
+      return relayFetch(fetchFn, `${baseUrl}${path}`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          Authorization: authHeader
+        },
+        body
+      });
+    },
+    pollSession(sessionId) {
+      return pollSession(fetchFn, baseUrl, sessionId);
+    },
+    pollUntilComplete(sessionId, opts) {
+      return pollUntilComplete(fetchFn, baseUrl, sessionId, opts);
+    }
+  };
+}
+export {
+  createSessionRelayBuilderClient,
+  createSessionRelayClient
+};
+//# sourceMappingURL=client.js.map

package/dist/session-relay/client.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/session-relay/client.ts"],"sourcesContent":["import { getSessionRelayUrl } from \"./endpoints\";\nimport { SessionRelayError } from \"./errors\";\nimport { buildSessionRelayWeb3SignedHeader } from \"./signing\";\nimport type {\n  SessionRelayApproveRequest,\n  SessionRelayBuilderClient,\n  SessionRelayBuilderClientOptions,\n  SessionRelayClaimRequest,\n  SessionRelayClaimResponse,\n  SessionRelayClient,\n  SessionRelayClientOptions,\n  SessionRelayDenyRequest,\n  SessionRelayFetch,\n  SessionRelayInitParams,\n  SessionRelayInitResult,\n  SessionRelayPollResult,\n} from \"./types\";\n\nconst DEFAULT_POLL_INTERVAL_MS = 2_000;\nconst DEFAULT_POLL_TIMEOUT_MS = 15 * 60_000;\n\nfunction stripTrailingSlash(url: string): string {\n  return url.replace(/\\/+$/, \"\");\n}\n\nfunction resolveFetch(fetchFn?: SessionRelayFetch): SessionRelayFetch {\n  const resolved = fetchFn ?? (globalThis.fetch as SessionRelayFetch);\n  if (!resolved) {\n    throw new SessionRelayError(\n      \"No fetch implementation available. Pass `fetchFn` to the Session Relay client.\",\n      { relayErrorCode: \"SESSION_RELAY_CONFIG_ERROR\" },\n    );\n  }\n  return resolved;\n}\n\nfunction endpoint(options: SessionRelayClientOptions): string {\n  return stripTrailingSlash(options.baseUrl ?? getSessionRelayUrl(options.env));\n}\n\nasync function parseJson(res: Awaited<ReturnType<SessionRelayFetch>>) {\n  if (res.status === 204) return undefined;\n\n  if (res.text) {\n    const text = await res.text();\n    if (text.length === 0) return undefined;\n    try {\n      return JSON.parse(text) as unknown;\n    } catch {\n      throw new SessionRelayError(\n        `Session Relay returned a non-JSON response (HTTP ${res.status})`,\n        { status: res.status },\n      );\n    }\n  }\n\n  try {\n    return await res.json();\n  } catch {\n    throw new SessionRelayError(\n      `Session Relay returned a non-JSON response (HTTP ${res.status})`,\n      { status: res.status },\n    );\n  }\n}\n\nfunction relayErrorFromBody(\n  body: unknown,\n):\n  | { message?: string; code?: number; errorCode?: string; details?: unknown }\n  | undefined {\n  if (body === null || typeof body !== \"object\" || !(\"error\" in body)) {\n    return undefined;\n  }\n  const error = (body as { error?: unknown }).error;\n  if (error === null || typeof error !== \"object\") return undefined;\n  return error as {\n    message?: string;\n    code?: number;\n    errorCode?: string;\n    details?: unknown;\n  };\n}\n\nasync function relayFetch<T>(\n  fetchFn: SessionRelayFetch,\n  url: string,\n  init: { method: string; headers?: Record<string, string>; body?: string },\n): Promise<T> {\n  let res: Awaited<ReturnType<SessionRelayFetch>>;\n  try {\n    res = await fetchFn(url, init);\n  } catch (err) {\n    throw new SessionRelayError(\n      \"Network error communicating with Session Relay\",\n      {\n        body: err,\n      },\n    );\n  }\n\n  const body = await parseJson(res);\n  if (!res.ok) {\n    const relayError = relayErrorFromBody(body);\n    throw new SessionRelayError(\n      relayError?.message ??\n        `Session Relay request failed (HTTP ${res.status})`,\n      {\n        status: res.status,\n        relayCode: relayError?.code,\n        relayErrorCode: relayError?.errorCode,\n        body,\n      },\n    );\n  }\n\n  return body as T;\n}\n\nasync function pollSession(\n  fetchFn: SessionRelayFetch,\n  baseUrl: string,\n  sessionId: string,\n): Promise<SessionRelayPollResult> {\n  return relayFetch<SessionRelayPollResult>(\n    fetchFn,\n    `${baseUrl}/v1/session/${encodeURIComponent(sessionId)}/poll`,\n    { method: \"GET\" },\n  );\n}\n\nasync function pollUntilComplete(\n  fetchFn: SessionRelayFetch,\n  baseUrl: string,\n  sessionId: string,\n  opts?: { intervalMs?: number; timeoutMs?: number },\n): Promise<SessionRelayPollResult> {\n  const intervalMs = opts?.intervalMs ?? DEFAULT_POLL_INTERVAL_MS;\n  const timeoutMs = opts?.timeoutMs ?? DEFAULT_POLL_TIMEOUT_MS;\n  const deadline = Date.now() + timeoutMs;\n\n  while (Date.now() < deadline) {\n    const result = await pollSession(fetchFn, baseUrl, sessionId);\n    if (\n      result.status === \"approved\" ||\n      result.status === \"denied\" ||\n      result.status === \"expired\"\n    ) {\n      return result;\n    }\n    await new Promise((resolve) => setTimeout(resolve, intervalMs));\n  }\n\n  throw new SessionRelayError(\"Polling timed out\", {\n    relayErrorCode: \"SESSION_RELAY_POLL_TIMEOUT\",\n  });\n}\n\n/**\n * Create a Session Relay client for app-side claim/approve/deny calls and\n * unsigned polling.\n *\n * @remarks\n * This is a Vana service integration client, not a protocol-core primitive.\n * It intentionally models the current Session Relay HTTP API while leaving\n * user-facing grant orchestration to the app using it.\n */\nexport function createSessionRelayClient(\n  options: SessionRelayClientOptions = {},\n): SessionRelayClient {\n  const fetchFn = resolveFetch(options.fetchFn);\n  const baseUrl = endpoint(options);\n\n  return {\n    claimSession(\n      request: SessionRelayClaimRequest,\n    ): Promise<SessionRelayClaimResponse> {\n      return relayFetch<SessionRelayClaimResponse>(\n        fetchFn,\n        `${baseUrl}/v1/session/claim`,\n        {\n          method: \"POST\",\n          headers: { \"Content-Type\": \"application/json\" },\n          body: JSON.stringify(request),\n        },\n      );\n    },\n\n    async approveSession(\n      sessionId: string,\n      request: SessionRelayApproveRequest,\n    ): Promise<void> {\n      await relayFetch<unknown>(\n        fetchFn,\n        `${baseUrl}/v1/session/${encodeURIComponent(sessionId)}/approve`,\n        {\n          method: \"POST\",\n          headers: { \"Content-Type\": \"application/json\" },\n          body: JSON.stringify(request),\n        },\n      );\n    },\n\n    async denySession(\n      sessionId: string,\n      request: SessionRelayDenyRequest,\n    ): Promise<void> {\n      await relayFetch<unknown>(\n        fetchFn,\n        `${baseUrl}/v1/session/${encodeURIComponent(sessionId)}/deny`,\n        {\n          method: \"POST\",\n          headers: { \"Content-Type\": \"application/json\" },\n          body: JSON.stringify(request),\n        },\n      );\n    },\n\n    pollSession(sessionId: string): Promise<SessionRelayPollResult> {\n      return pollSession(fetchFn, baseUrl, sessionId);\n    },\n\n    pollUntilComplete(\n      sessionId: string,\n      opts?: { intervalMs?: number; timeoutMs?: number },\n    ): Promise<SessionRelayPollResult> {\n      return pollUntilComplete(fetchFn, baseUrl, sessionId, opts);\n    },\n  };\n}\n\n/**\n * Create a builder-side Session Relay client for signed session init and\n * unsigned polling.\n */\nexport function createSessionRelayBuilderClient(\n  options: SessionRelayBuilderClientOptions,\n): SessionRelayBuilderClient {\n  const fetchFn = resolveFetch(options.fetchFn);\n  const baseUrl = endpoint(options);\n\n  return {\n    async initSession(\n      params: SessionRelayInitParams,\n    ): Promise<SessionRelayInitResult> {\n      const path = \"/v1/session/init\";\n      const body = JSON.stringify({\n        granteeAddress: options.granteeAddress,\n        scopes: params.scopes,\n        ...(params.webhookUrl && { webhookUrl: params.webhookUrl }),\n        ...(params.appUserId && { appUserId: params.appUserId }),\n      });\n      const iat = options.now?.() ?? Math.floor(Date.now() / 1000);\n      const authHeader = await buildSessionRelayWeb3SignedHeader({\n        signMessage: options.signMessage,\n        aud: baseUrl,\n        method: \"POST\",\n        uri: path,\n        body,\n        iat,\n        exp: iat + 300,\n      });\n\n      return relayFetch<SessionRelayInitResult>(fetchFn, `${baseUrl}${path}`, {\n        method: \"POST\",\n        headers: {\n          \"Content-Type\": \"application/json\",\n          Authorization: authHeader,\n        },\n        body,\n      });\n    },\n\n    pollSession(sessionId: string): Promise<SessionRelayPollResult> {\n      return pollSession(fetchFn, baseUrl, sessionId);\n    },\n\n    pollUntilComplete(\n      sessionId: string,\n      opts?: { intervalMs?: number; timeoutMs?: number },\n    ): Promise<SessionRelayPollResult> {\n      return pollUntilComplete(fetchFn, baseUrl, sessionId, opts);\n    },\n  };\n}\n"],"mappings":"AAAA,SAAS,0BAA0B;AACnC,SAAS,yBAAyB;AAClC,SAAS,yCAAyC;AAgBlD,MAAM,2BAA2B;AACjC,MAAM,0BAA0B,KAAK;AAErC,SAAS,mBAAmB,KAAqB;AAC/C,SAAO,IAAI,QAAQ,QAAQ,EAAE;AAC/B;AAEA,SAAS,aAAa,SAAgD;AACpE,QAAM,WAAW,WAAY,WAAW;AACxC,MAAI,CAAC,UAAU;AACb,UAAM,IAAI;AAAA,MACR;AAAA,MACA,EAAE,gBAAgB,6BAA6B;AAAA,IACjD;AAAA,EACF;AACA,SAAO;AACT;AAEA,SAAS,SAAS,SAA4C;AAC5D,SAAO,mBAAmB,QAAQ,WAAW,mBAAmB,QAAQ,GAAG,CAAC;AAC9E;AAEA,eAAe,UAAU,KAA6C;AACpE,MAAI,IAAI,WAAW,IAAK,QAAO;AAE/B,MAAI,IAAI,MAAM;AACZ,UAAM,OAAO,MAAM,IAAI,KAAK;AAC5B,QAAI,KAAK,WAAW,EAAG,QAAO;AAC9B,QAAI;AACF,aAAO,KAAK,MAAM,IAAI;AAAA,IACxB,QAAQ;AACN,YAAM,IAAI;AAAA,QACR,oDAAoD,IAAI,MAAM;AAAA,QAC9D,EAAE,QAAQ,IAAI,OAAO;AAAA,MACvB;AAAA,IACF;AAAA,EACF;AAEA,MAAI;AACF,WAAO,MAAM,IAAI,KAAK;AAAA,EACxB,QAAQ;AACN,UAAM,IAAI;AAAA,MACR,oDAAoD,IAAI,MAAM;AAAA,MAC9D,EAAE,QAAQ,IAAI,OAAO;AAAA,IACvB;AAAA,EACF;AACF;AAEA,SAAS,mBACP,MAGY;AACZ,MAAI,SAAS,QAAQ,OAAO,SAAS,YAAY,EAAE,WAAW,OAAO;AACnE,WAAO;AAAA,EACT;AACA,QAAM,QAAS,KAA6B;AAC5C,MAAI,UAAU,QAAQ,OAAO,UAAU,SAAU,QAAO;AACxD,SAAO;AAMT;AAEA,eAAe,WACb,SACA,KACA,MACY;AACZ,MAAI;AACJ,MAAI;AACF,UAAM,MAAM,QAAQ,KAAK,IAAI;AAAA,EAC/B,SAAS,KAAK;AACZ,UAAM,IAAI;AAAA,MACR;AAAA,MACA;AAAA,QACE,MAAM;AAAA,MACR;AAAA,IACF;AAAA,EACF;AAEA,QAAM,OAAO,MAAM,UAAU,GAAG;AAChC,MAAI,CAAC,IAAI,IAAI;AACX,UAAM,aAAa,mBAAmB,IAAI;AAC1C,UAAM,IAAI;AAAA,MACR,YAAY,WACV,sCAAsC,IAAI,MAAM;AAAA,MAClD;AAAA,QACE,QAAQ,IAAI;AAAA,QACZ,WAAW,YAAY;AAAA,QACvB,gBAAgB,YAAY;AAAA,QAC5B;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;AAEA,eAAe,YACb,SACA,SACA,WACiC;AACjC,SAAO;AAAA,IACL;AAAA,IACA,GAAG,OAAO,eAAe,mBAAmB,SAAS,CAAC;AAAA,IACtD,EAAE,QAAQ,MAAM;AAAA,EAClB;AACF;AAEA,eAAe,kBACb,SACA,SACA,WACA,MACiC;AACjC,QAAM,aAAa,MAAM,cAAc;AACvC,QAAM,YAAY,MAAM,aAAa;AACrC,QAAM,WAAW,KAAK,IAAI,IAAI;AAE9B,SAAO,KAAK,IAAI,IAAI,UAAU;AAC5B,UAAM,SAAS,MAAM,YAAY,SAAS,SAAS,SAAS;AAC5D,QACE,OAAO,WAAW,cAClB,OAAO,WAAW,YAClB,OAAO,WAAW,WAClB;AACA,aAAO;AAAA,IACT;AACA,UAAM,IAAI,QAAQ,CAAC,YAAY,WAAW,SAAS,UAAU,CAAC;AAAA,EAChE;AAEA,QAAM,IAAI,kBAAkB,qBAAqB;AAAA,IAC/C,gBAAgB;AAAA,EAClB,CAAC;AACH;AAWO,SAAS,yBACd,UAAqC,CAAC,GAClB;AACpB,QAAM,UAAU,aAAa,QAAQ,OAAO;AAC5C,QAAM,UAAU,SAAS,OAAO;AAEhC,SAAO;AAAA,IACL,aACE,SACoC;AACpC,aAAO;AAAA,QACL;AAAA,QACA,GAAG,OAAO;AAAA,QACV;AAAA,UACE,QAAQ;AAAA,UACR,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,UAC9C,MAAM,KAAK,UAAU,OAAO;AAAA,QAC9B;AAAA,MACF;AAAA,IACF;AAAA,IAEA,MAAM,eACJ,WACA,SACe;AACf,YAAM;AAAA,QACJ;AAAA,QACA,GAAG,OAAO,eAAe,mBAAmB,SAAS,CAAC;AAAA,QACtD;AAAA,UACE,QAAQ;AAAA,UACR,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,UAC9C,MAAM,KAAK,UAAU,OAAO;AAAA,QAC9B;AAAA,MACF;AAAA,IACF;AAAA,IAEA,MAAM,YACJ,WACA,SACe;AACf,YAAM;AAAA,QACJ;AAAA,QACA,GAAG,OAAO,eAAe,mBAAmB,SAAS,CAAC;AAAA,QACtD;AAAA,UACE,QAAQ;AAAA,UACR,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,UAC9C,MAAM,KAAK,UAAU,OAAO;AAAA,QAC9B;AAAA,MACF;AAAA,IACF;AAAA,IAEA,YAAY,WAAoD;AAC9D,aAAO,YAAY,SAAS,SAAS,SAAS;AAAA,IAChD;AAAA,IAEA,kBACE,WACA,MACiC;AACjC,aAAO,kBAAkB,SAAS,SAAS,WAAW,IAAI;AAAA,IAC5D;AAAA,EACF;AACF;AAMO,SAAS,gCACd,SAC2B;AAC3B,QAAM,UAAU,aAAa,QAAQ,OAAO;AAC5C,QAAM,UAAU,SAAS,OAAO;AAEhC,SAAO;AAAA,IACL,MAAM,YACJ,QACiC;AACjC,YAAM,OAAO;AACb,YAAM,OAAO,KAAK,UAAU;AAAA,QAC1B,gBAAgB,QAAQ;AAAA,QACxB,QAAQ,OAAO;AAAA,QACf,GAAI,OAAO,cAAc,EAAE,YAAY,OAAO,WAAW;AAAA,QACzD,GAAI,OAAO,aAAa,EAAE,WAAW,OAAO,UAAU;AAAA,MACxD,CAAC;AACD,YAAM,MAAM,QAAQ,MAAM,KAAK,KAAK,MAAM,KAAK,IAAI,IAAI,GAAI;AAC3D,YAAM,aAAa,MAAM,kCAAkC;AAAA,QACzD,aAAa,QAAQ;AAAA,QACrB,KAAK;AAAA,QACL,QAAQ;AAAA,QACR,KAAK;AAAA,QACL;AAAA,QACA;AAAA,QACA,KAAK,MAAM;AAAA,MACb,CAAC;AAED,aAAO,WAAmC,SAAS,GAAG,OAAO,GAAG,IAAI,IAAI;AAAA,QACtE,QAAQ;AAAA,QACR,SAAS;AAAA,UACP,gBAAgB;AAAA,UAChB,eAAe;AAAA,QACjB;AAAA,QACA;AAAA,MACF,CAAC;AAAA,IACH;AAAA,IAEA,YAAY,WAAoD;AAC9D,aAAO,YAAY,SAAS,SAAS,SAAS;AAAA,IAChD;AAAA,IAEA,kBACE,WACA,MACiC;AACjC,aAAO,kBAAkB,SAAS,SAAS,WAAW,IAAI;AAAA,IAC5D;AAAA,EACF;AACF;","names":[]}

package/dist/session-relay/client.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/session-relay/endpoints.cjs

@@ -0,0 +1,37 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var endpoints_exports = {};
+__export(endpoints_exports, {
+  SESSION_RELAY_DEV_URL: () => SESSION_RELAY_DEV_URL,
+  SESSION_RELAY_PRODUCTION_URL: () => SESSION_RELAY_PRODUCTION_URL,
+  getSessionRelayUrl: () => getSessionRelayUrl
+});
+module.exports = __toCommonJS(endpoints_exports);
+const SESSION_RELAY_PRODUCTION_URL = "https://session-relay.vana.org";
+const SESSION_RELAY_DEV_URL = "https://dev.session-relay.vana.org";
+function getSessionRelayUrl(env = "production") {
+  return env === "dev" ? SESSION_RELAY_DEV_URL : SESSION_RELAY_PRODUCTION_URL;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SESSION_RELAY_DEV_URL,
+  SESSION_RELAY_PRODUCTION_URL,
+  getSessionRelayUrl
+});
+//# sourceMappingURL=endpoints.cjs.map

package/dist/session-relay/endpoints.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/session-relay/endpoints.ts"],"sourcesContent":["import type { SessionRelayEnvironment } from \"./types\";\n\n/** Production Session Relay URL. */\nexport const SESSION_RELAY_PRODUCTION_URL = \"https://session-relay.vana.org\";\n\n/** Internal dev Session Relay URL. */\nexport const SESSION_RELAY_DEV_URL = \"https://dev.session-relay.vana.org\";\n\n/** Resolve the default Session Relay URL for a deployment environment. */\nexport function getSessionRelayUrl(\n  env: SessionRelayEnvironment = \"production\",\n): string {\n  return env === \"dev\" ? SESSION_RELAY_DEV_URL : SESSION_RELAY_PRODUCTION_URL;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAGO,MAAM,+BAA+B;AAGrC,MAAM,wBAAwB;AAG9B,SAAS,mBACd,MAA+B,cACvB;AACR,SAAO,QAAQ,QAAQ,wBAAwB;AACjD;","names":[]}

package/dist/session-relay/endpoints.d.ts

@@ -0,0 +1,7 @@
+import type { SessionRelayEnvironment } from "./types";
+/** Production Session Relay URL. */
+export declare const SESSION_RELAY_PRODUCTION_URL = "https://session-relay.vana.org";
+/** Internal dev Session Relay URL. */
+export declare const SESSION_RELAY_DEV_URL = "https://dev.session-relay.vana.org";
+/** Resolve the default Session Relay URL for a deployment environment. */
+export declare function getSessionRelayUrl(env?: SessionRelayEnvironment): string;

package/dist/session-relay/endpoints.js

@@ -0,0 +1,11 @@
+const SESSION_RELAY_PRODUCTION_URL = "https://session-relay.vana.org";
+const SESSION_RELAY_DEV_URL = "https://dev.session-relay.vana.org";
+function getSessionRelayUrl(env = "production") {
+  return env === "dev" ? SESSION_RELAY_DEV_URL : SESSION_RELAY_PRODUCTION_URL;
+}
+export {
+  SESSION_RELAY_DEV_URL,
+  SESSION_RELAY_PRODUCTION_URL,
+  getSessionRelayUrl
+};
+//# sourceMappingURL=endpoints.js.map

package/dist/session-relay/endpoints.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/session-relay/endpoints.ts"],"sourcesContent":["import type { SessionRelayEnvironment } from \"./types\";\n\n/** Production Session Relay URL. */\nexport const SESSION_RELAY_PRODUCTION_URL = \"https://session-relay.vana.org\";\n\n/** Internal dev Session Relay URL. */\nexport const SESSION_RELAY_DEV_URL = \"https://dev.session-relay.vana.org\";\n\n/** Resolve the default Session Relay URL for a deployment environment. */\nexport function getSessionRelayUrl(\n  env: SessionRelayEnvironment = \"production\",\n): string {\n  return env === \"dev\" ? SESSION_RELAY_DEV_URL : SESSION_RELAY_PRODUCTION_URL;\n}\n"],"mappings":"AAGO,MAAM,+BAA+B;AAGrC,MAAM,wBAAwB;AAG9B,SAAS,mBACd,MAA+B,cACvB;AACR,SAAO,QAAQ,QAAQ,wBAAwB;AACjD;","names":[]}

package/dist/session-relay/errors.cjs

@@ -0,0 +1,36 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var errors_exports = {};
+__export(errors_exports, {
+  SessionRelayError: () => SessionRelayError
+});
+module.exports = __toCommonJS(errors_exports);
+var import_errors = require("../errors");
+class SessionRelayError extends import_errors.VanaError {
+  constructor(message, details = {}) {
+    super(message, details.relayErrorCode ?? "SESSION_RELAY_ERROR");
+    this.details = details;
+  }
+  details;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SessionRelayError
+});
+//# sourceMappingURL=errors.cjs.map

package/dist/session-relay/errors.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/session-relay/errors.ts"],"sourcesContent":["import { VanaError } from \"../errors\";\n\n/** Error details returned by Session Relay. */\nexport interface SessionRelayErrorDetails {\n  status?: number;\n  relayCode?: number;\n  relayErrorCode?: string;\n  body?: unknown;\n}\n\n/** Error thrown by Session Relay client operations. */\nexport class SessionRelayError extends VanaError {\n  constructor(\n    message: string,\n    public readonly details: SessionRelayErrorDetails = {},\n  ) {\n    super(message, details.relayErrorCode ?? \"SESSION_RELAY_ERROR\");\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,oBAA0B;AAWnB,MAAM,0BAA0B,wBAAU;AAAA,EAC/C,YACE,SACgB,UAAoC,CAAC,GACrD;AACA,UAAM,SAAS,QAAQ,kBAAkB,qBAAqB;AAF9C;AAAA,EAGlB;AAAA,EAHkB;AAIpB;","names":[]}

package/dist/session-relay/errors.d.ts

@@ -0,0 +1,13 @@
+import { VanaError } from "../errors";
+/** Error details returned by Session Relay. */
+export interface SessionRelayErrorDetails {
+    status?: number;
+    relayCode?: number;
+    relayErrorCode?: string;
+    body?: unknown;
+}
+/** Error thrown by Session Relay client operations. */
+export declare class SessionRelayError extends VanaError {
+    readonly details: SessionRelayErrorDetails;
+    constructor(message: string, details?: SessionRelayErrorDetails);
+}

package/dist/session-relay/errors.js

@@ -0,0 +1,12 @@
+import { VanaError } from "../errors.js";
+class SessionRelayError extends VanaError {
+  constructor(message, details = {}) {
+    super(message, details.relayErrorCode ?? "SESSION_RELAY_ERROR");
+    this.details = details;
+  }
+  details;
+}
+export {
+  SessionRelayError
+};
+//# sourceMappingURL=errors.js.map

package/dist/session-relay/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/session-relay/errors.ts"],"sourcesContent":["import { VanaError } from \"../errors\";\n\n/** Error details returned by Session Relay. */\nexport interface SessionRelayErrorDetails {\n  status?: number;\n  relayCode?: number;\n  relayErrorCode?: string;\n  body?: unknown;\n}\n\n/** Error thrown by Session Relay client operations. */\nexport class SessionRelayError extends VanaError {\n  constructor(\n    message: string,\n    public readonly details: SessionRelayErrorDetails = {},\n  ) {\n    super(message, details.relayErrorCode ?? \"SESSION_RELAY_ERROR\");\n  }\n}\n"],"mappings":"AAAA,SAAS,iBAAiB;AAWnB,MAAM,0BAA0B,UAAU;AAAA,EAC/C,YACE,SACgB,UAAoC,CAAC,GACrD;AACA,UAAM,SAAS,QAAQ,kBAAkB,qBAAqB;AAF9C;AAAA,EAGlB;AAAA,EAHkB;AAIpB;","names":[]}

package/dist/session-relay/index.cjs

@@ -0,0 +1,46 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var session_relay_exports = {};
+__export(session_relay_exports, {
+  SESSION_RELAY_DEV_URL: () => import_endpoints.SESSION_RELAY_DEV_URL,
+  SESSION_RELAY_PRODUCTION_URL: () => import_endpoints.SESSION_RELAY_PRODUCTION_URL,
+  SessionRelayError: () => import_errors.SessionRelayError,
+  buildSessionRelayWeb3SignedHeader: () => import_signing.buildSessionRelayWeb3SignedHeader,
+  computeSessionRelayBodyHash: () => import_signing.computeSessionRelayBodyHash,
+  createSessionRelayBuilderClient: () => import_client.createSessionRelayBuilderClient,
+  createSessionRelayClient: () => import_client.createSessionRelayClient,
+  getSessionRelayUrl: () => import_endpoints.getSessionRelayUrl
+});
+module.exports = __toCommonJS(session_relay_exports);
+var import_endpoints = require("./endpoints");
+var import_errors = require("./errors");
+var import_signing = require("./signing");
+var import_client = require("./client");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SESSION_RELAY_DEV_URL,
+  SESSION_RELAY_PRODUCTION_URL,
+  SessionRelayError,
+  buildSessionRelayWeb3SignedHeader,
+  computeSessionRelayBodyHash,
+  createSessionRelayBuilderClient,
+  createSessionRelayClient,
+  getSessionRelayUrl
+});
+//# sourceMappingURL=index.cjs.map

package/dist/session-relay/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/session-relay/index.ts"],"sourcesContent":["export {\n  SESSION_RELAY_DEV_URL,\n  SESSION_RELAY_PRODUCTION_URL,\n  getSessionRelayUrl,\n} from \"./endpoints\";\nexport { SessionRelayError, type SessionRelayErrorDetails } from \"./errors\";\nexport {\n  computeSessionRelayBodyHash,\n  buildSessionRelayWeb3SignedHeader,\n} from \"./signing\";\nexport {\n  createSessionRelayClient,\n  createSessionRelayBuilderClient,\n} from \"./client\";\nexport type {\n  SessionRelayEnvironment,\n  SessionRelayFetch,\n  SessionRelayClientOptions,\n  SessionRelayBuilderClientOptions,\n  SessionRelayInitParams,\n  SessionRelayInitResult,\n  SessionRelayGrantPayload,\n  SessionRelayPollResult,\n  SessionRelayClaimRequest,\n  SessionRelayClaimResponse,\n  SessionRelayApproveRequest,\n  SessionRelayDenyRequest,\n  SessionRelayClient,\n  SessionRelayBuilderClient,\n} from \"./types\";\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,uBAIO;AACP,oBAAiE;AACjE,qBAGO;AACP,oBAGO;","names":[]}

package/dist/session-relay/index.d.ts

@@ -0,0 +1,5 @@
+export { SESSION_RELAY_DEV_URL, SESSION_RELAY_PRODUCTION_URL, getSessionRelayUrl, } from "./endpoints";
+export { SessionRelayError, type SessionRelayErrorDetails } from "./errors";
+export { computeSessionRelayBodyHash, buildSessionRelayWeb3SignedHeader, } from "./signing";
+export { createSessionRelayClient, createSessionRelayBuilderClient, } from "./client";
+export type { SessionRelayEnvironment, SessionRelayFetch, SessionRelayClientOptions, SessionRelayBuilderClientOptions, SessionRelayInitParams, SessionRelayInitResult, SessionRelayGrantPayload, SessionRelayPollResult, SessionRelayClaimRequest, SessionRelayClaimResponse, SessionRelayApproveRequest, SessionRelayDenyRequest, SessionRelayClient, SessionRelayBuilderClient, } from "./types";

package/dist/session-relay/index.js

@@ -0,0 +1,25 @@
+import {
+  SESSION_RELAY_DEV_URL,
+  SESSION_RELAY_PRODUCTION_URL,
+  getSessionRelayUrl
+} from "./endpoints.js";
+import { SessionRelayError } from "./errors.js";
+import {
+  computeSessionRelayBodyHash,
+  buildSessionRelayWeb3SignedHeader
+} from "./signing.js";
+import {
+  createSessionRelayClient,
+  createSessionRelayBuilderClient
+} from "./client.js";
+export {
+  SESSION_RELAY_DEV_URL,
+  SESSION_RELAY_PRODUCTION_URL,
+  SessionRelayError,
+  buildSessionRelayWeb3SignedHeader,
+  computeSessionRelayBodyHash,
+  createSessionRelayBuilderClient,
+  createSessionRelayClient,
+  getSessionRelayUrl
+};
+//# sourceMappingURL=index.js.map

package/dist/session-relay/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/session-relay/index.ts"],"sourcesContent":["export {\n  SESSION_RELAY_DEV_URL,\n  SESSION_RELAY_PRODUCTION_URL,\n  getSessionRelayUrl,\n} from \"./endpoints\";\nexport { SessionRelayError, type SessionRelayErrorDetails } from \"./errors\";\nexport {\n  computeSessionRelayBodyHash,\n  buildSessionRelayWeb3SignedHeader,\n} from \"./signing\";\nexport {\n  createSessionRelayClient,\n  createSessionRelayBuilderClient,\n} from \"./client\";\nexport type {\n  SessionRelayEnvironment,\n  SessionRelayFetch,\n  SessionRelayClientOptions,\n  SessionRelayBuilderClientOptions,\n  SessionRelayInitParams,\n  SessionRelayInitResult,\n  SessionRelayGrantPayload,\n  SessionRelayPollResult,\n  SessionRelayClaimRequest,\n  SessionRelayClaimResponse,\n  SessionRelayApproveRequest,\n  SessionRelayDenyRequest,\n  SessionRelayClient,\n  SessionRelayBuilderClient,\n} from \"./types\";\n"],"mappings":"AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,yBAAwD;AACjE;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,OACK;","names":[]}

package/dist/session-relay/signing.cjs

@@ -0,0 +1,62 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var signing_exports = {};
+__export(signing_exports, {
+  buildSessionRelayWeb3SignedHeader: () => buildSessionRelayWeb3SignedHeader,
+  computeSessionRelayBodyHash: () => computeSessionRelayBodyHash
+});
+module.exports = __toCommonJS(signing_exports);
+var import_sha2 = require("@noble/hashes/sha2");
+var import_viem = require("viem");
+var import_web3_signed_builder = require("../auth/web3-signed-builder");
+const textEncoder = new TextEncoder();
+function canonicalizeJson(value) {
+  if (value === null || typeof value !== "object") return value;
+  if (Array.isArray(value)) return value.map(canonicalizeJson);
+  const sorted = {};
+  for (const key of Object.keys(value).sort()) {
+    if (key === "signature") continue;
+    sorted[key] = canonicalizeJson(value[key]);
+  }
+  return sorted;
+}
+function computeSessionRelayBodyHash(body) {
+  if (!body || body.length === 0) return "";
+  const parsed = JSON.parse(body);
+  const canonical = canonicalizeJson(parsed);
+  const digest = (0, import_sha2.sha256)(textEncoder.encode(JSON.stringify(canonical)));
+  return (0, import_viem.bytesToHex)(digest).slice(2);
+}
+function buildSessionRelayWeb3SignedHeader(params) {
+  return (0, import_web3_signed_builder.buildWeb3SignedHeader)({
+    signMessage: params.signMessage,
+    aud: params.aud,
+    method: params.method,
+    uri: params.uri,
+    bodyHash: computeSessionRelayBodyHash(params.body),
+    iat: params.iat,
+    exp: params.exp
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  buildSessionRelayWeb3SignedHeader,
+  computeSessionRelayBodyHash
+});
+//# sourceMappingURL=signing.cjs.map

package/dist/session-relay/signing.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/session-relay/signing.ts"],"sourcesContent":["import { sha256 } from \"@noble/hashes/sha2\";\nimport { bytesToHex } from \"viem\";\nimport {\n  buildWeb3SignedHeader,\n  type Web3SignedSignFn,\n} from \"../auth/web3-signed-builder\";\n\nconst textEncoder = new TextEncoder();\n\nfunction canonicalizeJson(value: unknown): unknown {\n  if (value === null || typeof value !== \"object\") return value;\n  if (Array.isArray(value)) return value.map(canonicalizeJson);\n\n  const sorted: Record<string, unknown> = {};\n  for (const key of Object.keys(value as Record<string, unknown>).sort()) {\n    if (key === \"signature\") continue;\n    sorted[key] = canonicalizeJson((value as Record<string, unknown>)[key]);\n  }\n  return sorted;\n}\n\n/**\n * Compute the legacy bodyHash shape currently accepted by Session Relay.\n *\n * @remarks\n * Personal Server Web3Signed requests use `sha256:<hex>`, including a canonical\n * empty-body hash. Session Relay's current signed init endpoint verifies a\n * legacy body hash: bare SHA-256 hex for non-empty JSON bodies and `\"\"` for\n * empty bodies. Keep this compatibility local to the Relay integration.\n */\nexport function computeSessionRelayBodyHash(body: string | undefined): string {\n  if (!body || body.length === 0) return \"\";\n\n  const parsed = JSON.parse(body);\n  const canonical = canonicalizeJson(parsed);\n  const digest = sha256(textEncoder.encode(JSON.stringify(canonical)));\n  return bytesToHex(digest).slice(2);\n}\n\n/** Build a Web3Signed header compatible with Session Relay's signed endpoints. */\nexport function buildSessionRelayWeb3SignedHeader(params: {\n  signMessage: Web3SignedSignFn;\n  aud: string;\n  method: string;\n  uri: string;\n  body?: string;\n  iat?: number;\n  exp?: number;\n}): Promise<string> {\n  return buildWeb3SignedHeader({\n    signMessage: params.signMessage,\n    aud: params.aud,\n    method: params.method,\n    uri: params.uri,\n    bodyHash: computeSessionRelayBodyHash(params.body),\n    iat: params.iat,\n    exp: params.exp,\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,kBAAuB;AACvB,kBAA2B;AAC3B,iCAGO;AAEP,MAAM,cAAc,IAAI,YAAY;AAEpC,SAAS,iBAAiB,OAAyB;AACjD,MAAI,UAAU,QAAQ,OAAO,UAAU,SAAU,QAAO;AACxD,MAAI,MAAM,QAAQ,KAAK,EAAG,QAAO,MAAM,IAAI,gBAAgB;AAE3D,QAAM,SAAkC,CAAC;AACzC,aAAW,OAAO,OAAO,KAAK,KAAgC,EAAE,KAAK,GAAG;AACtE,QAAI,QAAQ,YAAa;AACzB,WAAO,GAAG,IAAI,iBAAkB,MAAkC,GAAG,CAAC;AAAA,EACxE;AACA,SAAO;AACT;AAWO,SAAS,4BAA4B,MAAkC;AAC5E,MAAI,CAAC,QAAQ,KAAK,WAAW,EAAG,QAAO;AAEvC,QAAM,SAAS,KAAK,MAAM,IAAI;AAC9B,QAAM,YAAY,iBAAiB,MAAM;AACzC,QAAM,aAAS,oBAAO,YAAY,OAAO,KAAK,UAAU,SAAS,CAAC,CAAC;AACnE,aAAO,wBAAW,MAAM,EAAE,MAAM,CAAC;AACnC;AAGO,SAAS,kCAAkC,QAQ9B;AAClB,aAAO,kDAAsB;AAAA,IAC3B,aAAa,OAAO;AAAA,IACpB,KAAK,OAAO;AAAA,IACZ,QAAQ,OAAO;AAAA,IACf,KAAK,OAAO;AAAA,IACZ,UAAU,4BAA4B,OAAO,IAAI;AAAA,IACjD,KAAK,OAAO;AAAA,IACZ,KAAK,OAAO;AAAA,EACd,CAAC;AACH;","names":[]}

package/dist/session-relay/signing.d.ts

@@ -0,0 +1,21 @@
+import { type Web3SignedSignFn } from "../auth/web3-signed-builder";
+/**
+ * Compute the legacy bodyHash shape currently accepted by Session Relay.
+ *
+ * @remarks
+ * Personal Server Web3Signed requests use `sha256:<hex>`, including a canonical
+ * empty-body hash. Session Relay's current signed init endpoint verifies a
+ * legacy body hash: bare SHA-256 hex for non-empty JSON bodies and `""` for
+ * empty bodies. Keep this compatibility local to the Relay integration.
+ */
+export declare function computeSessionRelayBodyHash(body: string | undefined): string;
+/** Build a Web3Signed header compatible with Session Relay's signed endpoints. */
+export declare function buildSessionRelayWeb3SignedHeader(params: {
+    signMessage: Web3SignedSignFn;
+    aud: string;
+    method: string;
+    uri: string;
+    body?: string;
+    iat?: number;
+    exp?: number;
+}): Promise<string>;

package/dist/session-relay/signing.js

@@ -0,0 +1,39 @@
+import { sha256 } from "@noble/hashes/sha2";
+import { bytesToHex } from "viem";
+import {
+  buildWeb3SignedHeader
+} from "../auth/web3-signed-builder.js";
+const textEncoder = new TextEncoder();
+function canonicalizeJson(value) {
+  if (value === null || typeof value !== "object") return value;
+  if (Array.isArray(value)) return value.map(canonicalizeJson);
+  const sorted = {};
+  for (const key of Object.keys(value).sort()) {
+    if (key === "signature") continue;
+    sorted[key] = canonicalizeJson(value[key]);
+  }
+  return sorted;
+}
+function computeSessionRelayBodyHash(body) {
+  if (!body || body.length === 0) return "";
+  const parsed = JSON.parse(body);
+  const canonical = canonicalizeJson(parsed);
+  const digest = sha256(textEncoder.encode(JSON.stringify(canonical)));
+  return bytesToHex(digest).slice(2);
+}
+function buildSessionRelayWeb3SignedHeader(params) {
+  return buildWeb3SignedHeader({
+    signMessage: params.signMessage,
+    aud: params.aud,
+    method: params.method,
+    uri: params.uri,
+    bodyHash: computeSessionRelayBodyHash(params.body),
+    iat: params.iat,
+    exp: params.exp
+  });
+}
+export {
+  buildSessionRelayWeb3SignedHeader,
+  computeSessionRelayBodyHash
+};
+//# sourceMappingURL=signing.js.map

package/dist/session-relay/signing.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/session-relay/signing.ts"],"sourcesContent":["import { sha256 } from \"@noble/hashes/sha2\";\nimport { bytesToHex } from \"viem\";\nimport {\n  buildWeb3SignedHeader,\n  type Web3SignedSignFn,\n} from \"../auth/web3-signed-builder\";\n\nconst textEncoder = new TextEncoder();\n\nfunction canonicalizeJson(value: unknown): unknown {\n  if (value === null || typeof value !== \"object\") return value;\n  if (Array.isArray(value)) return value.map(canonicalizeJson);\n\n  const sorted: Record<string, unknown> = {};\n  for (const key of Object.keys(value as Record<string, unknown>).sort()) {\n    if (key === \"signature\") continue;\n    sorted[key] = canonicalizeJson((value as Record<string, unknown>)[key]);\n  }\n  return sorted;\n}\n\n/**\n * Compute the legacy bodyHash shape currently accepted by Session Relay.\n *\n * @remarks\n * Personal Server Web3Signed requests use `sha256:<hex>`, including a canonical\n * empty-body hash. Session Relay's current signed init endpoint verifies a\n * legacy body hash: bare SHA-256 hex for non-empty JSON bodies and `\"\"` for\n * empty bodies. Keep this compatibility local to the Relay integration.\n */\nexport function computeSessionRelayBodyHash(body: string | undefined): string {\n  if (!body || body.length === 0) return \"\";\n\n  const parsed = JSON.parse(body);\n  const canonical = canonicalizeJson(parsed);\n  const digest = sha256(textEncoder.encode(JSON.stringify(canonical)));\n  return bytesToHex(digest).slice(2);\n}\n\n/** Build a Web3Signed header compatible with Session Relay's signed endpoints. */\nexport function buildSessionRelayWeb3SignedHeader(params: {\n  signMessage: Web3SignedSignFn;\n  aud: string;\n  method: string;\n  uri: string;\n  body?: string;\n  iat?: number;\n  exp?: number;\n}): Promise<string> {\n  return buildWeb3SignedHeader({\n    signMessage: params.signMessage,\n    aud: params.aud,\n    method: params.method,\n    uri: params.uri,\n    bodyHash: computeSessionRelayBodyHash(params.body),\n    iat: params.iat,\n    exp: params.exp,\n  });\n}\n"],"mappings":"AAAA,SAAS,cAAc;AACvB,SAAS,kBAAkB;AAC3B;AAAA,EACE;AAAA,OAEK;AAEP,MAAM,cAAc,IAAI,YAAY;AAEpC,SAAS,iBAAiB,OAAyB;AACjD,MAAI,UAAU,QAAQ,OAAO,UAAU,SAAU,QAAO;AACxD,MAAI,MAAM,QAAQ,KAAK,EAAG,QAAO,MAAM,IAAI,gBAAgB;AAE3D,QAAM,SAAkC,CAAC;AACzC,aAAW,OAAO,OAAO,KAAK,KAAgC,EAAE,KAAK,GAAG;AACtE,QAAI,QAAQ,YAAa;AACzB,WAAO,GAAG,IAAI,iBAAkB,MAAkC,GAAG,CAAC;AAAA,EACxE;AACA,SAAO;AACT;AAWO,SAAS,4BAA4B,MAAkC;AAC5E,MAAI,CAAC,QAAQ,KAAK,WAAW,EAAG,QAAO;AAEvC,QAAM,SAAS,KAAK,MAAM,IAAI;AAC9B,QAAM,YAAY,iBAAiB,MAAM;AACzC,QAAM,SAAS,OAAO,YAAY,OAAO,KAAK,UAAU,SAAS,CAAC,CAAC;AACnE,SAAO,WAAW,MAAM,EAAE,MAAM,CAAC;AACnC;AAGO,SAAS,kCAAkC,QAQ9B;AAClB,SAAO,sBAAsB;AAAA,IAC3B,aAAa,OAAO;AAAA,IACpB,KAAK,OAAO;AAAA,IACZ,QAAQ,OAAO;AAAA,IACf,KAAK,OAAO;AAAA,IACZ,UAAU,4BAA4B,OAAO,IAAI;AAAA,IACjD,KAAK,OAAO;AAAA,IACZ,KAAK,OAAO;AAAA,EACd,CAAC;AACH;","names":[]}

package/dist/session-relay/signing.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/session-relay/types.cjs

@@ -0,0 +1,17 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);
+//# sourceMappingURL=types.cjs.map

package/dist/session-relay/types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/session-relay/types.ts"],"sourcesContent":["import type { Web3SignedSignFn } from \"../auth/web3-signed-builder\";\n\n/** Deployment environment for Vana's Session Relay service. */\nexport type SessionRelayEnvironment = \"production\" | \"dev\";\n\n/** Minimal fetch signature accepted by the Session Relay clients. */\nexport type SessionRelayFetch = (\n  input: string,\n  init?: {\n    method?: string;\n    headers?: Record<string, string>;\n    body?: string;\n  },\n) => Promise<{\n  ok: boolean;\n  status: number;\n  statusText?: string;\n  json(): Promise<unknown>;\n  text?(): Promise<string>;\n}>;\n\n/** Shared Session Relay client options. */\nexport interface SessionRelayClientOptions {\n  /** Session Relay base URL. Defaults from `env` when omitted. */\n  baseUrl?: string;\n  /** Vana deployment environment. Defaults to `\"production\"`. */\n  env?: SessionRelayEnvironment;\n  /** Fetch implementation. Defaults to `globalThis.fetch`. */\n  fetchFn?: SessionRelayFetch;\n}\n\n/** Builder-side Session Relay options. */\nexport interface SessionRelayBuilderClientOptions extends SessionRelayClientOptions {\n  /** Builder/app address registered with the Vana builder registry. */\n  granteeAddress: `0x${string}`;\n  /** EIP-191 signer for Web3Signed Relay requests. */\n  signMessage: Web3SignedSignFn;\n  /** Clock source used for signed request freshness claims. */\n  now?: () => number;\n}\n\n/** Parameters for creating a Session Relay session. */\nexport interface SessionRelayInitParams {\n  /** Data scopes requested from the user. */\n  scopes: string[];\n  /** Public HTTPS callback URL for grant notifications. */\n  webhookUrl?: string;\n  /** App-owned user id for correlating the approved grant. */\n  appUserId?: string;\n}\n\n/** Raw Session Relay init result. */\nexport interface SessionRelayInitResult {\n  sessionId: string;\n  deepLinkUrl: string;\n  expiresAt: string;\n}\n\n/** Grant payload returned after a Relay session is approved. */\nexport interface SessionRelayGrantPayload {\n  grantId: string;\n  userAddress: string;\n  builderAddress: string;\n  scopes: string[];\n  serverAddress?: string;\n  appUserId?: string;\n}\n\n/** Session Relay poll result. */\nexport interface SessionRelayPollResult {\n  /**\n   * Current session status.\n   *\n   * @remarks\n   * Current Session Relay deployments may report expired sessions as a\n   * structured `SESSION_EXPIRED` error instead of a JSON body with\n   * `status: \"expired\"`. The `\"expired\"` status is accepted for deployments\n   * that return expiry as a terminal poll body.\n   */\n  status: \"pending\" | \"claimed\" | \"approved\" | \"denied\" | \"expired\";\n  grant?: SessionRelayGrantPayload;\n  reason?: string;\n}\n\n/** Desktop/app-side claim request. */\nexport interface SessionRelayClaimRequest {\n  sessionId: string;\n  secret: string;\n}\n\n/** Claimed session data returned to the app that completes user consent. */\nexport interface SessionRelayClaimResponse {\n  sessionId: string;\n  granteeAddress: string;\n  scopes: string[];\n  expiresAt: string;\n  webhookUrl?: string;\n  appUserId?: string;\n}\n\n/** Desktop/app-side approval request. */\nexport interface SessionRelayApproveRequest {\n  secret: string;\n  grantId: string;\n  userAddress: string;\n  serverAddress?: string;\n  scopes: string[];\n}\n\n/** Desktop/app-side denial request. */\nexport interface SessionRelayDenyRequest {\n  secret: string;\n  reason?: string;\n}\n\n/** Session Relay methods that do not require builder signing. */\nexport interface SessionRelayClient {\n  claimSession(\n    request: SessionRelayClaimRequest,\n  ): Promise<SessionRelayClaimResponse>;\n  approveSession(\n    sessionId: string,\n    request: SessionRelayApproveRequest,\n  ): Promise<void>;\n  denySession(\n    sessionId: string,\n    request: SessionRelayDenyRequest,\n  ): Promise<void>;\n  pollSession(sessionId: string): Promise<SessionRelayPollResult>;\n  pollUntilComplete(\n    sessionId: string,\n    opts?: { intervalMs?: number; timeoutMs?: number },\n  ): Promise<SessionRelayPollResult>;\n}\n\n/** Builder-side Session Relay methods. */\nexport interface SessionRelayBuilderClient {\n  initSession(params: SessionRelayInitParams): Promise<SessionRelayInitResult>;\n  pollSession(sessionId: string): Promise<SessionRelayPollResult>;\n  pollUntilComplete(\n    sessionId: string,\n    opts?: { intervalMs?: number; timeoutMs?: number },\n  ): Promise<SessionRelayPollResult>;\n}\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/session-relay/types.d.ts

@@ -0,0 +1,119 @@
+import type { Web3SignedSignFn } from "../auth/web3-signed-builder";
+/** Deployment environment for Vana's Session Relay service. */
+export type SessionRelayEnvironment = "production" | "dev";
+/** Minimal fetch signature accepted by the Session Relay clients. */
+export type SessionRelayFetch = (input: string, init?: {
+    method?: string;
+    headers?: Record<string, string>;
+    body?: string;
+}) => Promise<{
+    ok: boolean;
+    status: number;
+    statusText?: string;
+    json(): Promise<unknown>;
+    text?(): Promise<string>;
+}>;
+/** Shared Session Relay client options. */
+export interface SessionRelayClientOptions {
+    /** Session Relay base URL. Defaults from `env` when omitted. */
+    baseUrl?: string;
+    /** Vana deployment environment. Defaults to `"production"`. */
+    env?: SessionRelayEnvironment;
+    /** Fetch implementation. Defaults to `globalThis.fetch`. */
+    fetchFn?: SessionRelayFetch;
+}
+/** Builder-side Session Relay options. */
+export interface SessionRelayBuilderClientOptions extends SessionRelayClientOptions {
+    /** Builder/app address registered with the Vana builder registry. */
+    granteeAddress: `0x${string}`;
+    /** EIP-191 signer for Web3Signed Relay requests. */
+    signMessage: Web3SignedSignFn;
+    /** Clock source used for signed request freshness claims. */
+    now?: () => number;
+}
+/** Parameters for creating a Session Relay session. */
+export interface SessionRelayInitParams {
+    /** Data scopes requested from the user. */
+    scopes: string[];
+    /** Public HTTPS callback URL for grant notifications. */
+    webhookUrl?: string;
+    /** App-owned user id for correlating the approved grant. */
+    appUserId?: string;
+}
+/** Raw Session Relay init result. */
+export interface SessionRelayInitResult {
+    sessionId: string;
+    deepLinkUrl: string;
+    expiresAt: string;
+}
+/** Grant payload returned after a Relay session is approved. */
+export interface SessionRelayGrantPayload {
+    grantId: string;
+    userAddress: string;
+    builderAddress: string;
+    scopes: string[];
+    serverAddress?: string;
+    appUserId?: string;
+}
+/** Session Relay poll result. */
+export interface SessionRelayPollResult {
+    /**
+     * Current session status.
+     *
+     * @remarks
+     * Current Session Relay deployments may report expired sessions as a
+     * structured `SESSION_EXPIRED` error instead of a JSON body with
+     * `status: "expired"`. The `"expired"` status is accepted for deployments
+     * that return expiry as a terminal poll body.
+     */
+    status: "pending" | "claimed" | "approved" | "denied" | "expired";
+    grant?: SessionRelayGrantPayload;
+    reason?: string;
+}
+/** Desktop/app-side claim request. */
+export interface SessionRelayClaimRequest {
+    sessionId: string;
+    secret: string;
+}
+/** Claimed session data returned to the app that completes user consent. */
+export interface SessionRelayClaimResponse {
+    sessionId: string;
+    granteeAddress: string;
+    scopes: string[];
+    expiresAt: string;
+    webhookUrl?: string;
+    appUserId?: string;
+}
+/** Desktop/app-side approval request. */
+export interface SessionRelayApproveRequest {
+    secret: string;
+    grantId: string;
+    userAddress: string;
+    serverAddress?: string;
+    scopes: string[];
+}
+/** Desktop/app-side denial request. */
+export interface SessionRelayDenyRequest {
+    secret: string;
+    reason?: string;
+}
+/** Session Relay methods that do not require builder signing. */
+export interface SessionRelayClient {
+    claimSession(request: SessionRelayClaimRequest): Promise<SessionRelayClaimResponse>;
+    approveSession(sessionId: string, request: SessionRelayApproveRequest): Promise<void>;
+    denySession(sessionId: string, request: SessionRelayDenyRequest): Promise<void>;
+    pollSession(sessionId: string): Promise<SessionRelayPollResult>;
+    pollUntilComplete(sessionId: string, opts?: {
+        intervalMs?: number;
+        timeoutMs?: number;
+    }): Promise<SessionRelayPollResult>;
+}
+/** Builder-side Session Relay methods. */
+export interface SessionRelayBuilderClient {
+    initSession(params: SessionRelayInitParams): Promise<SessionRelayInitResult>;
+    pollSession(sessionId: string): Promise<SessionRelayPollResult>;
+    pollUntilComplete(sessionId: string, opts?: {
+        intervalMs?: number;
+        timeoutMs?: number;
+    }): Promise<SessionRelayPollResult>;
+}

package/dist/session-relay/types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=types.js.map

package/dist/session-relay/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/session-relay.cjs

@@ -0,0 +1,46 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var session_relay_exports = {};
+__export(session_relay_exports, {
+  SESSION_RELAY_DEV_URL: () => import_endpoints.SESSION_RELAY_DEV_URL,
+  SESSION_RELAY_PRODUCTION_URL: () => import_endpoints.SESSION_RELAY_PRODUCTION_URL,
+  SessionRelayError: () => import_errors.SessionRelayError,
+  buildSessionRelayWeb3SignedHeader: () => import_signing.buildSessionRelayWeb3SignedHeader,
+  computeSessionRelayBodyHash: () => import_signing.computeSessionRelayBodyHash,
+  createSessionRelayBuilderClient: () => import_client.createSessionRelayBuilderClient,
+  createSessionRelayClient: () => import_client.createSessionRelayClient,
+  getSessionRelayUrl: () => import_endpoints.getSessionRelayUrl
+});
+module.exports = __toCommonJS(session_relay_exports);
+var import_endpoints = require("./session-relay/endpoints");
+var import_errors = require("./session-relay/errors");
+var import_signing = require("./session-relay/signing");
+var import_client = require("./session-relay/client");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SESSION_RELAY_DEV_URL,
+  SESSION_RELAY_PRODUCTION_URL,
+  SessionRelayError,
+  buildSessionRelayWeb3SignedHeader,
+  computeSessionRelayBodyHash,
+  createSessionRelayBuilderClient,
+  createSessionRelayClient,
+  getSessionRelayUrl
+});
+//# sourceMappingURL=session-relay.cjs.map

package/dist/session-relay.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/session-relay.ts"],"sourcesContent":["/**\n * Session Relay service integration for Vana app flows.\n *\n * @remarks\n * Session Relay coordinates the handoff between a builder app and the Vana app\n * that completes user consent. This entry point is intentionally separate from\n * `protocol/*`: it is a Vana-operated service integration, like Account or\n * Storage integrations, not a canonical on-chain protocol primitive.\n *\n * @example\n * ```typescript\n * import { createSessionRelayBuilderClient } from \"@opendatalabs/vana-sdk/session-relay\";\n *\n * const relay = createSessionRelayBuilderClient({\n *   granteeAddress: appAddress,\n *   signMessage,\n * });\n * ```\n *\n * @category Integrations\n * @module session-relay\n */\n\nexport {\n  SESSION_RELAY_DEV_URL,\n  SESSION_RELAY_PRODUCTION_URL,\n  getSessionRelayUrl,\n} from \"./session-relay/endpoints\";\nexport {\n  SessionRelayError,\n  type SessionRelayErrorDetails,\n} from \"./session-relay/errors\";\nexport {\n  computeSessionRelayBodyHash,\n  buildSessionRelayWeb3SignedHeader,\n} from \"./session-relay/signing\";\nexport {\n  createSessionRelayClient,\n  createSessionRelayBuilderClient,\n} from \"./session-relay/client\";\nexport type {\n  SessionRelayEnvironment,\n  SessionRelayFetch,\n  SessionRelayClientOptions,\n  SessionRelayBuilderClientOptions,\n  SessionRelayInitParams,\n  SessionRelayInitResult,\n  SessionRelayGrantPayload,\n  SessionRelayPollResult,\n  SessionRelayClaimRequest,\n  SessionRelayClaimResponse,\n  SessionRelayApproveRequest,\n  SessionRelayDenyRequest,\n  SessionRelayClient,\n  SessionRelayBuilderClient,\n} from \"./session-relay/types\";\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAuBA,uBAIO;AACP,oBAGO;AACP,qBAGO;AACP,oBAGO;","names":[]}

package/dist/session-relay.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Session Relay service integration for Vana app flows.
+ *
+ * @remarks
+ * Session Relay coordinates the handoff between a builder app and the Vana app
+ * that completes user consent. This entry point is intentionally separate from
+ * `protocol/*`: it is a Vana-operated service integration, like Account or
+ * Storage integrations, not a canonical on-chain protocol primitive.
+ *
+ * @example
+ * ```typescript
+ * import { createSessionRelayBuilderClient } from "@opendatalabs/vana-sdk/session-relay";
+ *
+ * const relay = createSessionRelayBuilderClient({
+ *   granteeAddress: appAddress,
+ *   signMessage,
+ * });
+ * ```
+ *
+ * @category Integrations
+ * @module session-relay
+ */
+export { SESSION_RELAY_DEV_URL, SESSION_RELAY_PRODUCTION_URL, getSessionRelayUrl, } from "./session-relay/endpoints";
+export { SessionRelayError, type SessionRelayErrorDetails, } from "./session-relay/errors";
+export { computeSessionRelayBodyHash, buildSessionRelayWeb3SignedHeader, } from "./session-relay/signing";
+export { createSessionRelayClient, createSessionRelayBuilderClient, } from "./session-relay/client";
+export type { SessionRelayEnvironment, SessionRelayFetch, SessionRelayClientOptions, SessionRelayBuilderClientOptions, SessionRelayInitParams, SessionRelayInitResult, SessionRelayGrantPayload, SessionRelayPollResult, SessionRelayClaimRequest, SessionRelayClaimResponse, SessionRelayApproveRequest, SessionRelayDenyRequest, SessionRelayClient, SessionRelayBuilderClient, } from "./session-relay/types";

package/dist/session-relay.js

@@ -0,0 +1,27 @@
+import {
+  SESSION_RELAY_DEV_URL,
+  SESSION_RELAY_PRODUCTION_URL,
+  getSessionRelayUrl
+} from "./session-relay/endpoints.js";
+import {
+  SessionRelayError
+} from "./session-relay/errors.js";
+import {
+  computeSessionRelayBodyHash,
+  buildSessionRelayWeb3SignedHeader
+} from "./session-relay/signing.js";
+import {
+  createSessionRelayClient,
+  createSessionRelayBuilderClient
+} from "./session-relay/client.js";
+export {
+  SESSION_RELAY_DEV_URL,
+  SESSION_RELAY_PRODUCTION_URL,
+  SessionRelayError,
+  buildSessionRelayWeb3SignedHeader,
+  computeSessionRelayBodyHash,
+  createSessionRelayBuilderClient,
+  createSessionRelayClient,
+  getSessionRelayUrl
+};
+//# sourceMappingURL=session-relay.js.map

package/dist/session-relay.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/session-relay.ts"],"sourcesContent":["/**\n * Session Relay service integration for Vana app flows.\n *\n * @remarks\n * Session Relay coordinates the handoff between a builder app and the Vana app\n * that completes user consent. This entry point is intentionally separate from\n * `protocol/*`: it is a Vana-operated service integration, like Account or\n * Storage integrations, not a canonical on-chain protocol primitive.\n *\n * @example\n * ```typescript\n * import { createSessionRelayBuilderClient } from \"@opendatalabs/vana-sdk/session-relay\";\n *\n * const relay = createSessionRelayBuilderClient({\n *   granteeAddress: appAddress,\n *   signMessage,\n * });\n * ```\n *\n * @category Integrations\n * @module session-relay\n */\n\nexport {\n  SESSION_RELAY_DEV_URL,\n  SESSION_RELAY_PRODUCTION_URL,\n  getSessionRelayUrl,\n} from \"./session-relay/endpoints\";\nexport {\n  SessionRelayError,\n  type SessionRelayErrorDetails,\n} from \"./session-relay/errors\";\nexport {\n  computeSessionRelayBodyHash,\n  buildSessionRelayWeb3SignedHeader,\n} from \"./session-relay/signing\";\nexport {\n  createSessionRelayClient,\n  createSessionRelayBuilderClient,\n} from \"./session-relay/client\";\nexport type {\n  SessionRelayEnvironment,\n  SessionRelayFetch,\n  SessionRelayClientOptions,\n  SessionRelayBuilderClientOptions,\n  SessionRelayInitParams,\n  SessionRelayInitResult,\n  SessionRelayGrantPayload,\n  SessionRelayPollResult,\n  SessionRelayClaimRequest,\n  SessionRelayClaimResponse,\n  SessionRelayApproveRequest,\n  SessionRelayDenyRequest,\n  SessionRelayClient,\n  SessionRelayBuilderClient,\n} from \"./session-relay/types\";\n"],"mappings":"AAuBA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,OAEK;AACP;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,OACK;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opendatalabs/vana-sdk",
-  "version": "3.8.3",
+  "version": "3.9.0",
   "description": "A TypeScript library for interacting with Vana Network smart contracts.",
   "publishConfig": {
     "access": "public"
@@ -37,6 +37,15 @@
       "types": "./dist/react.d.ts",
       "import": "./dist/react.js"
     },
+    "./session-relay": {
+      "browser": {
+        "types": "./dist/session-relay.d.ts",
+        "import": "./dist/session-relay.js"
+      },
+      "types": "./dist/session-relay.d.ts",
+      "import": "./dist/session-relay.js",
+      "require": "./dist/session-relay.cjs"
+    },
     "./chains": {
       "browser": {
         "types": "./dist/chains.browser.d.ts",