@opendatalabs/vana-sdk 3.8.3 → 3.10.0

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.10.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",