@opendatalabs/vana-sdk 2.3.0 → 3.0.1-canary.b068ac6

package/dist/protocol/eip712.d.ts

@@ -0,0 +1,117 @@
+/**
+ * EIP-712 domain and type builders for Data Portability protocol writes.
+ *
+ * These helpers are shared primitives only. Personal Server runtimes own when
+ * to sign and submit these payloads.
+ *
+ * @category Protocol
+ */
+import type { TypedDataDomain } from "viem";
+export interface DataPortabilityContracts {
+    dataRegistry: string;
+    dataPortabilityPermissions: string;
+    dataPortabilityServer: string;
+    dataPortabilityGrantees: string;
+}
+export interface DataPortabilityGatewayConfig {
+    chainId: number;
+    contracts: DataPortabilityContracts;
+}
+export declare function fileRegistrationDomain(config: DataPortabilityGatewayConfig): TypedDataDomain;
+export declare function grantRegistrationDomain(config: DataPortabilityGatewayConfig): TypedDataDomain;
+export declare function grantRevocationDomain(config: DataPortabilityGatewayConfig): TypedDataDomain;
+export declare function serverRegistrationDomain(config: DataPortabilityGatewayConfig): TypedDataDomain;
+export declare function builderRegistrationDomain(config: DataPortabilityGatewayConfig): TypedDataDomain;
+export declare const FILE_REGISTRATION_TYPES: {
+    readonly FileRegistration: readonly [{
+        readonly name: "ownerAddress";
+        readonly type: "address";
+    }, {
+        readonly name: "url";
+        readonly type: "string";
+    }, {
+        readonly name: "schemaId";
+        readonly type: "bytes32";
+    }];
+};
+export declare const GRANT_REGISTRATION_TYPES: {
+    readonly GrantRegistration: readonly [{
+        readonly name: "grantorAddress";
+        readonly type: "address";
+    }, {
+        readonly name: "granteeId";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "grant";
+        readonly type: "string";
+    }, {
+        readonly name: "fileIds";
+        readonly type: "uint256[]";
+    }];
+};
+export declare const GRANT_REVOCATION_TYPES: {
+    readonly GrantRevocation: readonly [{
+        readonly name: "grantorAddress";
+        readonly type: "address";
+    }, {
+        readonly name: "grantId";
+        readonly type: "bytes32";
+    }];
+};
+export declare const SERVER_REGISTRATION_TYPES: {
+    readonly ServerRegistration: readonly [{
+        readonly name: "ownerAddress";
+        readonly type: "address";
+    }, {
+        readonly name: "serverAddress";
+        readonly type: "address";
+    }, {
+        readonly name: "publicKey";
+        readonly type: "string";
+    }, {
+        readonly name: "serverUrl";
+        readonly type: "string";
+    }];
+};
+export declare const BUILDER_REGISTRATION_TYPES: {
+    readonly BuilderRegistration: readonly [{
+        readonly name: "ownerAddress";
+        readonly type: "address";
+    }, {
+        readonly name: "granteeAddress";
+        readonly type: "address";
+    }, {
+        readonly name: "publicKey";
+        readonly type: "string";
+    }, {
+        readonly name: "appUrl";
+        readonly type: "string";
+    }];
+};
+export interface FileRegistrationMessage {
+    ownerAddress: `0x${string}`;
+    url: string;
+    schemaId: `0x${string}`;
+}
+export interface GrantRegistrationMessage {
+    grantorAddress: `0x${string}`;
+    granteeId: `0x${string}`;
+    grant: string;
+    fileIds: bigint[];
+}
+export interface GrantRevocationMessage {
+    grantorAddress: `0x${string}`;
+    grantId: `0x${string}`;
+}
+export interface ServerRegistrationMessage {
+    ownerAddress: `0x${string}`;
+    serverAddress: `0x${string}`;
+    publicKey: `0x${string}`;
+    serverUrl: string;
+}
+export interface BuilderRegistrationMessage {
+    ownerAddress: `0x${string}`;
+    granteeAddress: `0x${string}`;
+    publicKey: string;
+    appUrl: string;
+}

package/dist/protocol/eip712.js

@@ -0,0 +1,90 @@
+const DOMAIN_NAME = "Vana Data Portability";
+const DOMAIN_VERSION = "1";
+function buildDomain(chainId, verifyingContract) {
+  return {
+    name: DOMAIN_NAME,
+    version: DOMAIN_VERSION,
+    chainId,
+    verifyingContract
+  };
+}
+function fileRegistrationDomain(config) {
+  return buildDomain(
+    config.chainId,
+    config.contracts.dataRegistry
+  );
+}
+function grantRegistrationDomain(config) {
+  return buildDomain(
+    config.chainId,
+    config.contracts.dataPortabilityPermissions
+  );
+}
+function grantRevocationDomain(config) {
+  return buildDomain(
+    config.chainId,
+    config.contracts.dataPortabilityPermissions
+  );
+}
+function serverRegistrationDomain(config) {
+  return buildDomain(
+    config.chainId,
+    config.contracts.dataPortabilityServer
+  );
+}
+function builderRegistrationDomain(config) {
+  return buildDomain(
+    config.chainId,
+    config.contracts.dataPortabilityGrantees
+  );
+}
+const FILE_REGISTRATION_TYPES = {
+  FileRegistration: [
+    { name: "ownerAddress", type: "address" },
+    { name: "url", type: "string" },
+    { name: "schemaId", type: "bytes32" }
+  ]
+};
+const GRANT_REGISTRATION_TYPES = {
+  GrantRegistration: [
+    { name: "grantorAddress", type: "address" },
+    { name: "granteeId", type: "bytes32" },
+    { name: "grant", type: "string" },
+    { name: "fileIds", type: "uint256[]" }
+  ]
+};
+const GRANT_REVOCATION_TYPES = {
+  GrantRevocation: [
+    { name: "grantorAddress", type: "address" },
+    { name: "grantId", type: "bytes32" }
+  ]
+};
+const SERVER_REGISTRATION_TYPES = {
+  ServerRegistration: [
+    { name: "ownerAddress", type: "address" },
+    { name: "serverAddress", type: "address" },
+    { name: "publicKey", type: "string" },
+    { name: "serverUrl", type: "string" }
+  ]
+};
+const BUILDER_REGISTRATION_TYPES = {
+  BuilderRegistration: [
+    { name: "ownerAddress", type: "address" },
+    { name: "granteeAddress", type: "address" },
+    { name: "publicKey", type: "string" },
+    { name: "appUrl", type: "string" }
+  ]
+};
+export {
+  BUILDER_REGISTRATION_TYPES,
+  FILE_REGISTRATION_TYPES,
+  GRANT_REGISTRATION_TYPES,
+  GRANT_REVOCATION_TYPES,
+  SERVER_REGISTRATION_TYPES,
+  builderRegistrationDomain,
+  fileRegistrationDomain,
+  grantRegistrationDomain,
+  grantRevocationDomain,
+  serverRegistrationDomain
+};
+//# sourceMappingURL=eip712.js.map

package/dist/protocol/eip712.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/protocol/eip712.ts"],"sourcesContent":["/**\n * EIP-712 domain and type builders for Data Portability protocol writes.\n *\n * These helpers are shared primitives only. Personal Server runtimes own when\n * to sign and submit these payloads.\n *\n * @category Protocol\n */\n\nimport type { TypedDataDomain } from \"viem\";\n\nconst DOMAIN_NAME = \"Vana Data Portability\";\nconst DOMAIN_VERSION = \"1\";\n\nexport interface DataPortabilityContracts {\n  dataRegistry: string;\n  dataPortabilityPermissions: string;\n  dataPortabilityServer: string;\n  dataPortabilityGrantees: string;\n}\n\nexport interface DataPortabilityGatewayConfig {\n  chainId: number;\n  contracts: DataPortabilityContracts;\n}\n\nfunction buildDomain(\n  chainId: number,\n  verifyingContract: `0x${string}`,\n): TypedDataDomain {\n  return {\n    name: DOMAIN_NAME,\n    version: DOMAIN_VERSION,\n    chainId,\n    verifyingContract,\n  };\n}\n\nexport function fileRegistrationDomain(\n  config: DataPortabilityGatewayConfig,\n): TypedDataDomain {\n  return buildDomain(\n    config.chainId,\n    config.contracts.dataRegistry as `0x${string}`,\n  );\n}\n\nexport function grantRegistrationDomain(\n  config: DataPortabilityGatewayConfig,\n): TypedDataDomain {\n  return buildDomain(\n    config.chainId,\n    config.contracts.dataPortabilityPermissions as `0x${string}`,\n  );\n}\n\nexport function grantRevocationDomain(\n  config: DataPortabilityGatewayConfig,\n): TypedDataDomain {\n  return buildDomain(\n    config.chainId,\n    config.contracts.dataPortabilityPermissions as `0x${string}`,\n  );\n}\n\nexport function serverRegistrationDomain(\n  config: DataPortabilityGatewayConfig,\n): TypedDataDomain {\n  return buildDomain(\n    config.chainId,\n    config.contracts.dataPortabilityServer as `0x${string}`,\n  );\n}\n\nexport function builderRegistrationDomain(\n  config: DataPortabilityGatewayConfig,\n): TypedDataDomain {\n  return buildDomain(\n    config.chainId,\n    config.contracts.dataPortabilityGrantees as `0x${string}`,\n  );\n}\n\nexport const FILE_REGISTRATION_TYPES = {\n  FileRegistration: [\n    { name: \"ownerAddress\", type: \"address\" },\n    { name: \"url\", type: \"string\" },\n    { name: \"schemaId\", type: \"bytes32\" },\n  ],\n} as const;\n\nexport const GRANT_REGISTRATION_TYPES = {\n  GrantRegistration: [\n    { name: \"grantorAddress\", type: \"address\" },\n    { name: \"granteeId\", type: \"bytes32\" },\n    { name: \"grant\", type: \"string\" },\n    { name: \"fileIds\", type: \"uint256[]\" },\n  ],\n} as const;\n\nexport const GRANT_REVOCATION_TYPES = {\n  GrantRevocation: [\n    { name: \"grantorAddress\", type: \"address\" },\n    { name: \"grantId\", type: \"bytes32\" },\n  ],\n} as const;\n\nexport const SERVER_REGISTRATION_TYPES = {\n  ServerRegistration: [\n    { name: \"ownerAddress\", type: \"address\" },\n    { name: \"serverAddress\", type: \"address\" },\n    { name: \"publicKey\", type: \"string\" },\n    { name: \"serverUrl\", type: \"string\" },\n  ],\n} as const;\n\nexport const BUILDER_REGISTRATION_TYPES = {\n  BuilderRegistration: [\n    { name: \"ownerAddress\", type: \"address\" },\n    { name: \"granteeAddress\", type: \"address\" },\n    { name: \"publicKey\", type: \"string\" },\n    { name: \"appUrl\", type: \"string\" },\n  ],\n} as const;\n\nexport interface FileRegistrationMessage {\n  ownerAddress: `0x${string}`;\n  url: string;\n  schemaId: `0x${string}`;\n}\n\nexport interface GrantRegistrationMessage {\n  grantorAddress: `0x${string}`;\n  granteeId: `0x${string}`;\n  grant: string;\n  fileIds: bigint[];\n}\n\nexport interface GrantRevocationMessage {\n  grantorAddress: `0x${string}`;\n  grantId: `0x${string}`;\n}\n\nexport interface ServerRegistrationMessage {\n  ownerAddress: `0x${string}`;\n  serverAddress: `0x${string}`;\n  publicKey: `0x${string}`;\n  serverUrl: string;\n}\n\nexport interface BuilderRegistrationMessage {\n  ownerAddress: `0x${string}`;\n  granteeAddress: `0x${string}`;\n  publicKey: string;\n  appUrl: string;\n}\n"],"mappings":"AAWA,MAAM,cAAc;AACpB,MAAM,iBAAiB;AAcvB,SAAS,YACP,SACA,mBACiB;AACjB,SAAO;AAAA,IACL,MAAM;AAAA,IACN,SAAS;AAAA,IACT;AAAA,IACA;AAAA,EACF;AACF;AAEO,SAAS,uBACd,QACiB;AACjB,SAAO;AAAA,IACL,OAAO;AAAA,IACP,OAAO,UAAU;AAAA,EACnB;AACF;AAEO,SAAS,wBACd,QACiB;AACjB,SAAO;AAAA,IACL,OAAO;AAAA,IACP,OAAO,UAAU;AAAA,EACnB;AACF;AAEO,SAAS,sBACd,QACiB;AACjB,SAAO;AAAA,IACL,OAAO;AAAA,IACP,OAAO,UAAU;AAAA,EACnB;AACF;AAEO,SAAS,yBACd,QACiB;AACjB,SAAO;AAAA,IACL,OAAO;AAAA,IACP,OAAO,UAAU;AAAA,EACnB;AACF;AAEO,SAAS,0BACd,QACiB;AACjB,SAAO;AAAA,IACL,OAAO;AAAA,IACP,OAAO,UAAU;AAAA,EACnB;AACF;AAEO,MAAM,0BAA0B;AAAA,EACrC,kBAAkB;AAAA,IAChB,EAAE,MAAM,gBAAgB,MAAM,UAAU;AAAA,IACxC,EAAE,MAAM,OAAO,MAAM,SAAS;AAAA,IAC9B,EAAE,MAAM,YAAY,MAAM,UAAU;AAAA,EACtC;AACF;AAEO,MAAM,2BAA2B;AAAA,EACtC,mBAAmB;AAAA,IACjB,EAAE,MAAM,kBAAkB,MAAM,UAAU;AAAA,IAC1C,EAAE,MAAM,aAAa,MAAM,UAAU;AAAA,IACrC,EAAE,MAAM,SAAS,MAAM,SAAS;AAAA,IAChC,EAAE,MAAM,WAAW,MAAM,YAAY;AAAA,EACvC;AACF;AAEO,MAAM,yBAAyB;AAAA,EACpC,iBAAiB;AAAA,IACf,EAAE,MAAM,kBAAkB,MAAM,UAAU;AAAA,IAC1C,EAAE,MAAM,WAAW,MAAM,UAAU;AAAA,EACrC;AACF;AAEO,MAAM,4BAA4B;AAAA,EACvC,oBAAoB;AAAA,IAClB,EAAE,MAAM,gBAAgB,MAAM,UAAU;AAAA,IACxC,EAAE,MAAM,iBAAiB,MAAM,UAAU;AAAA,IACzC,EAAE,MAAM,aAAa,MAAM,SAAS;AAAA,IACpC,EAAE,MAAM,aAAa,MAAM,SAAS;AAAA,EACtC;AACF;AAEO,MAAM,6BAA6B;AAAA,EACxC,qBAAqB;AAAA,IACnB,EAAE,MAAM,gBAAgB,MAAM,UAAU;AAAA,IACxC,EAAE,MAAM,kBAAkB,MAAM,UAAU;AAAA,IAC1C,EAAE,MAAM,aAAa,MAAM,SAAS;AAAA,IACpC,EAAE,MAAM,UAAU,MAAM,SAAS;AAAA,EACnC;AACF;","names":[]}

package/dist/protocol/gateway.cjs

@@ -0,0 +1,226 @@
+"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 gateway_exports = {};
+__export(gateway_exports, {
+  createGatewayClient: () => createGatewayClient
+});
+module.exports = __toCommonJS(gateway_exports);
+function createGatewayClient(baseUrl) {
+  const base = baseUrl.replace(/\/+$/, "");
+  async function unwrapEnvelope(res) {
+    const envelope = await res.json();
+    return envelope.data;
+  }
+  function normalizeFileRecord(record) {
+    return {
+      fileId: record.fileId ?? record.id ?? "",
+      owner: record.owner ?? record.ownerAddress ?? "",
+      url: record.url,
+      schemaId: record.schemaId,
+      createdAt: record.createdAt ?? record.addedAt ?? ""
+    };
+  }
+  function getMutationId(body, key) {
+    const value = body[key] ?? body["id"];
+    return typeof value === "string" ? value : void 0;
+  }
+  return {
+    async isRegisteredBuilder(address) {
+      const builder = await this.getBuilder(address);
+      return builder !== null;
+    },
+    async getBuilder(address) {
+      const res = await fetch(`${base}/v1/builders/${address}`);
+      if (res.status === 404) return null;
+      if (!res.ok) {
+        throw new Error(`Gateway error: ${res.status} ${res.statusText}`);
+      }
+      return unwrapEnvelope(res);
+    },
+    async getGrant(grantId) {
+      const res = await fetch(`${base}/v1/grants/${grantId}`);
+      if (res.status === 404) return null;
+      if (!res.ok) {
+        throw new Error(`Gateway error: ${res.status} ${res.statusText}`);
+      }
+      return unwrapEnvelope(res);
+    },
+    async listGrantsByUser(userAddress) {
+      const res = await fetch(`${base}/v1/grants?user=${userAddress}`);
+      if (res.status === 404) return [];
+      if (!res.ok) {
+        throw new Error(`Gateway error: ${res.status} ${res.statusText}`);
+      }
+      return unwrapEnvelope(res);
+    },
+    async getSchemaForScope(scope) {
+      const res = await fetch(`${base}/v1/schemas?scope=${scope}`);
+      if (res.status === 404) return null;
+      if (!res.ok) {
+        throw new Error(`Gateway error: ${res.status} ${res.statusText}`);
+      }
+      return unwrapEnvelope(res);
+    },
+    async getServer(address) {
+      const res = await fetch(`${base}/v1/servers/${address}`);
+      if (res.status === 404) return null;
+      if (!res.ok) {
+        throw new Error(`Gateway error: ${res.status} ${res.statusText}`);
+      }
+      return unwrapEnvelope(res);
+    },
+    async getFile(fileId) {
+      const res = await fetch(`${base}/v1/files/${fileId}`);
+      if (res.status === 404) return null;
+      if (!res.ok) {
+        throw new Error(`Gateway error: ${res.status} ${res.statusText}`);
+      }
+      return normalizeFileRecord(await unwrapEnvelope(res));
+    },
+    async listFilesSince(owner, cursor) {
+      const params = new URLSearchParams({ user: owner });
+      if (cursor !== null) {
+        params.set("since", cursor);
+      }
+      const res = await fetch(`${base}/v1/files?${params.toString()}`);
+      if (!res.ok) {
+        throw new Error(`Gateway error: ${res.status} ${res.statusText}`);
+      }
+      const data = await unwrapEnvelope(res);
+      return {
+        files: data.files.map(normalizeFileRecord),
+        cursor: data.cursor
+      };
+    },
+    async getSchema(schemaId) {
+      const res = await fetch(`${base}/v1/schemas/${schemaId}`);
+      if (res.status === 404) return null;
+      if (!res.ok) {
+        throw new Error(`Gateway error: ${res.status} ${res.statusText}`);
+      }
+      return unwrapEnvelope(res);
+    },
+    async registerServer(params) {
+      const res = await fetch(`${base}/v1/servers`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          Authorization: `Web3Signed ${params.signature}`
+        },
+        body: JSON.stringify({
+          ownerAddress: params.ownerAddress,
+          serverAddress: params.serverAddress,
+          publicKey: params.publicKey,
+          serverUrl: params.serverUrl
+        })
+      });
+      if (res.status === 409) {
+        const body2 = await res.json().catch(() => ({}));
+        return {
+          serverId: getMutationId(body2, "serverId"),
+          alreadyRegistered: true
+        };
+      }
+      if (!res.ok) {
+        throw new Error(`Gateway error: ${res.status} ${res.statusText}`);
+      }
+      const body = await res.json().catch(() => ({}));
+      return {
+        serverId: getMutationId(body, "serverId"),
+        alreadyRegistered: false
+      };
+    },
+    async registerFile(params) {
+      const res = await fetch(`${base}/v1/files`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          Authorization: `Web3Signed ${params.signature}`
+        },
+        body: JSON.stringify({
+          ownerAddress: params.ownerAddress,
+          url: params.url,
+          schemaId: params.schemaId
+        })
+      });
+      if (res.status === 409) {
+        const body2 = await res.json().catch(() => ({}));
+        return {
+          fileId: getMutationId(body2, "fileId")
+        };
+      }
+      if (!res.ok) {
+        throw new Error(`Gateway error: ${res.status} ${res.statusText}`);
+      }
+      const body = await res.json();
+      return {
+        fileId: getMutationId(body, "fileId")
+      };
+    },
+    async createGrant(params) {
+      const res = await fetch(`${base}/v1/grants`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          Authorization: `Web3Signed ${params.signature}`
+        },
+        body: JSON.stringify({
+          grantorAddress: params.grantorAddress,
+          granteeId: params.granteeId,
+          grant: params.grant,
+          fileIds: params.fileIds
+        })
+      });
+      if (res.status === 409) {
+        const body2 = await res.json().catch(() => ({}));
+        return {
+          grantId: getMutationId(body2, "grantId")
+        };
+      }
+      if (!res.ok) {
+        throw new Error(`Gateway error: ${res.status} ${res.statusText}`);
+      }
+      const body = await res.json();
+      return {
+        grantId: getMutationId(body, "grantId")
+      };
+    },
+    async revokeGrant(params) {
+      const res = await fetch(`${base}/v1/grants/${params.grantId}`, {
+        method: "DELETE",
+        headers: {
+          "Content-Type": "application/json",
+          Authorization: `Web3Signed ${params.signature}`
+        },
+        body: JSON.stringify({
+          grantorAddress: params.grantorAddress
+        })
+      });
+      if (res.status === 409) return;
+      if (!res.ok) {
+        throw new Error(`Gateway error: ${res.status} ${res.statusText}`);
+      }
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createGatewayClient
+});
+//# sourceMappingURL=gateway.cjs.map

package/dist/protocol/gateway.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/protocol/gateway.ts"],"sourcesContent":["export interface GatewayEnvelope<T> {\n  data: T;\n  proof: GatewayProof;\n}\n\nexport interface GatewayProof {\n  signature: string;\n  timestamp: string;\n  gatewayAddress: string;\n  requestHash: string;\n  responseHash: string;\n  userSignature: string;\n  status: string;\n  chainBlockHeight: number;\n}\n\nexport interface Builder {\n  id: string;\n  ownerAddress: string;\n  granteeAddress: string;\n  publicKey: string;\n  appUrl: string;\n  addedAt: string;\n}\n\nexport interface Schema {\n  id: string;\n  ownerAddress: string;\n  name: string;\n  definitionUrl: string;\n  scope: string;\n  addedAt: string;\n}\n\nexport interface ServerInfo {\n  id: string;\n  ownerAddress: string;\n  serverAddress: string;\n  publicKey: string;\n  serverUrl: string;\n  addedAt: string;\n}\n\nexport interface GatewayGrantResponse {\n  id: string;\n  grantorAddress: string;\n  granteeId: string;\n  grant: string;\n  fileIds: string[];\n  status: \"pending\" | \"confirmed\";\n  addedAt: string;\n  revokedAt: string | null;\n  revocationSignature: string | null;\n}\n\nexport interface GrantListItem {\n  id: string;\n  grantorAddress: string;\n  granteeId: string;\n  grant: string;\n  fileIds: string[];\n  status: \"pending\" | \"confirmed\";\n  addedAt: string;\n  revokedAt: string | null;\n  revocationSignature: string | null;\n}\n\nexport interface FileRecord {\n  fileId: string;\n  owner: string;\n  url: string;\n  schemaId: string;\n  createdAt: string;\n}\n\nexport interface FileListResult {\n  files: FileRecord[];\n  cursor: string | null;\n}\n\ninterface GatewayFileRecord {\n  id?: string;\n  fileId?: string;\n  ownerAddress?: string;\n  owner?: string;\n  url: string;\n  schemaId: string;\n  addedAt?: string;\n  createdAt?: string;\n}\n\nexport interface RegisterFileParams {\n  ownerAddress: string;\n  url: string;\n  schemaId: string;\n  signature: string;\n}\n\nexport interface CreateGrantParams {\n  grantorAddress: string;\n  granteeId: string;\n  grant: string;\n  fileIds: string[];\n  signature: string;\n}\n\nexport interface RevokeGrantParams {\n  grantId: string;\n  grantorAddress: string;\n  signature: string;\n}\n\nexport interface RegisterServerParams {\n  ownerAddress: string;\n  serverAddress: string;\n  publicKey: string;\n  serverUrl: string;\n  signature: string;\n}\n\nexport interface RegisterServerResult {\n  serverId?: string;\n  alreadyRegistered: boolean;\n}\n\nexport interface GatewayClient {\n  isRegisteredBuilder(address: string): Promise<boolean>;\n  getBuilder(address: string): Promise<Builder | null>;\n  getGrant(grantId: string): Promise<GatewayGrantResponse | null>;\n  listGrantsByUser(userAddress: string): Promise<GrantListItem[]>;\n  getSchemaForScope(scope: string): Promise<Schema | null>;\n  getServer(address: string): Promise<ServerInfo | null>;\n  getFile(fileId: string): Promise<FileRecord | null>;\n  listFilesSince(owner: string, cursor: string | null): Promise<FileListResult>;\n  getSchema(schemaId: string): Promise<Schema | null>;\n  registerServer(params: RegisterServerParams): Promise<RegisterServerResult>;\n  registerFile(params: RegisterFileParams): Promise<{ fileId?: string }>;\n  createGrant(params: CreateGrantParams): Promise<{ grantId?: string }>;\n  revokeGrant(params: RevokeGrantParams): Promise<void>;\n}\n\nexport function createGatewayClient(baseUrl: string): GatewayClient {\n  const base = baseUrl.replace(/\\/+$/, \"\");\n\n  async function unwrapEnvelope<T>(res: Response): Promise<T> {\n    const envelope = (await res.json()) as GatewayEnvelope<T>;\n    return envelope.data;\n  }\n\n  function normalizeFileRecord(record: GatewayFileRecord): FileRecord {\n    return {\n      fileId: record.fileId ?? record.id ?? \"\",\n      owner: record.owner ?? record.ownerAddress ?? \"\",\n      url: record.url,\n      schemaId: record.schemaId,\n      createdAt: record.createdAt ?? record.addedAt ?? \"\",\n    };\n  }\n\n  function getMutationId(\n    body: Record<string, unknown>,\n    key: string,\n  ): string | undefined {\n    const value = body[key] ?? body[\"id\"];\n    return typeof value === \"string\" ? value : undefined;\n  }\n\n  return {\n    async isRegisteredBuilder(address: string): Promise<boolean> {\n      const builder = await this.getBuilder(address);\n      return builder !== null;\n    },\n\n    async getBuilder(address: string): Promise<Builder | null> {\n      const res = await fetch(`${base}/v1/builders/${address}`);\n      if (res.status === 404) return null;\n      if (!res.ok) {\n        throw new Error(`Gateway error: ${res.status} ${res.statusText}`);\n      }\n      return unwrapEnvelope<Builder>(res);\n    },\n\n    async getGrant(grantId: string): Promise<GatewayGrantResponse | null> {\n      const res = await fetch(`${base}/v1/grants/${grantId}`);\n      if (res.status === 404) return null;\n      if (!res.ok) {\n        throw new Error(`Gateway error: ${res.status} ${res.statusText}`);\n      }\n      return unwrapEnvelope<GatewayGrantResponse>(res);\n    },\n\n    async listGrantsByUser(userAddress: string): Promise<GrantListItem[]> {\n      const res = await fetch(`${base}/v1/grants?user=${userAddress}`);\n      if (res.status === 404) return [];\n      if (!res.ok) {\n        throw new Error(`Gateway error: ${res.status} ${res.statusText}`);\n      }\n      return unwrapEnvelope<GrantListItem[]>(res);\n    },\n\n    async getSchemaForScope(scope: string): Promise<Schema | null> {\n      const res = await fetch(`${base}/v1/schemas?scope=${scope}`);\n      if (res.status === 404) return null;\n      if (!res.ok) {\n        throw new Error(`Gateway error: ${res.status} ${res.statusText}`);\n      }\n      return unwrapEnvelope<Schema>(res);\n    },\n\n    async getServer(address: string): Promise<ServerInfo | null> {\n      const res = await fetch(`${base}/v1/servers/${address}`);\n      if (res.status === 404) return null;\n      if (!res.ok) {\n        throw new Error(`Gateway error: ${res.status} ${res.statusText}`);\n      }\n      return unwrapEnvelope<ServerInfo>(res);\n    },\n\n    async getFile(fileId: string): Promise<FileRecord | null> {\n      const res = await fetch(`${base}/v1/files/${fileId}`);\n      if (res.status === 404) return null;\n      if (!res.ok) {\n        throw new Error(`Gateway error: ${res.status} ${res.statusText}`);\n      }\n      return normalizeFileRecord(await unwrapEnvelope<GatewayFileRecord>(res));\n    },\n\n    async listFilesSince(\n      owner: string,\n      cursor: string | null,\n    ): Promise<FileListResult> {\n      const params = new URLSearchParams({ user: owner });\n      if (cursor !== null) {\n        params.set(\"since\", cursor);\n      }\n      const res = await fetch(`${base}/v1/files?${params.toString()}`);\n      if (!res.ok) {\n        throw new Error(`Gateway error: ${res.status} ${res.statusText}`);\n      }\n      const data = await unwrapEnvelope<{\n        files: GatewayFileRecord[];\n        cursor: string | null;\n      }>(res);\n      return {\n        files: data.files.map(normalizeFileRecord),\n        cursor: data.cursor,\n      };\n    },\n\n    async getSchema(schemaId: string): Promise<Schema | null> {\n      const res = await fetch(`${base}/v1/schemas/${schemaId}`);\n      if (res.status === 404) return null;\n      if (!res.ok) {\n        throw new Error(`Gateway error: ${res.status} ${res.statusText}`);\n      }\n      return unwrapEnvelope<Schema>(res);\n    },\n\n    async registerServer(\n      params: RegisterServerParams,\n    ): Promise<RegisterServerResult> {\n      const res = await fetch(`${base}/v1/servers`, {\n        method: \"POST\",\n        headers: {\n          \"Content-Type\": \"application/json\",\n          Authorization: `Web3Signed ${params.signature}`,\n        },\n        body: JSON.stringify({\n          ownerAddress: params.ownerAddress,\n          serverAddress: params.serverAddress,\n          publicKey: params.publicKey,\n          serverUrl: params.serverUrl,\n        }),\n      });\n      if (res.status === 409) {\n        const body = await res.json().catch(() => ({}));\n        return {\n          serverId: getMutationId(body as Record<string, unknown>, \"serverId\"),\n          alreadyRegistered: true,\n        };\n      }\n      if (!res.ok) {\n        throw new Error(`Gateway error: ${res.status} ${res.statusText}`);\n      }\n      const body = await res.json().catch(() => ({}));\n      return {\n        serverId: getMutationId(body as Record<string, unknown>, \"serverId\"),\n        alreadyRegistered: false,\n      };\n    },\n\n    async registerFile(\n      params: RegisterFileParams,\n    ): Promise<{ fileId?: string }> {\n      const res = await fetch(`${base}/v1/files`, {\n        method: \"POST\",\n        headers: {\n          \"Content-Type\": \"application/json\",\n          Authorization: `Web3Signed ${params.signature}`,\n        },\n        body: JSON.stringify({\n          ownerAddress: params.ownerAddress,\n          url: params.url,\n          schemaId: params.schemaId,\n        }),\n      });\n      if (res.status === 409) {\n        const body = await res.json().catch(() => ({}));\n        return {\n          fileId: getMutationId(body as Record<string, unknown>, \"fileId\"),\n        };\n      }\n      if (!res.ok) {\n        throw new Error(`Gateway error: ${res.status} ${res.statusText}`);\n      }\n      const body = await res.json();\n      return {\n        fileId: getMutationId(body as Record<string, unknown>, \"fileId\"),\n      };\n    },\n\n    async createGrant(\n      params: CreateGrantParams,\n    ): Promise<{ grantId?: string }> {\n      const res = await fetch(`${base}/v1/grants`, {\n        method: \"POST\",\n        headers: {\n          \"Content-Type\": \"application/json\",\n          Authorization: `Web3Signed ${params.signature}`,\n        },\n        body: JSON.stringify({\n          grantorAddress: params.grantorAddress,\n          granteeId: params.granteeId,\n          grant: params.grant,\n          fileIds: params.fileIds,\n        }),\n      });\n      if (res.status === 409) {\n        const body = await res.json().catch(() => ({}));\n        return {\n          grantId: getMutationId(body as Record<string, unknown>, \"grantId\"),\n        };\n      }\n      if (!res.ok) {\n        throw new Error(`Gateway error: ${res.status} ${res.statusText}`);\n      }\n      const body = await res.json();\n      return {\n        grantId: getMutationId(body as Record<string, unknown>, \"grantId\"),\n      };\n    },\n\n    async revokeGrant(params: RevokeGrantParams): Promise<void> {\n      const res = await fetch(`${base}/v1/grants/${params.grantId}`, {\n        method: \"DELETE\",\n        headers: {\n          \"Content-Type\": \"application/json\",\n          Authorization: `Web3Signed ${params.signature}`,\n        },\n        body: JSON.stringify({\n          grantorAddress: params.grantorAddress,\n        }),\n      });\n      if (res.status === 409) return;\n      if (!res.ok) {\n        throw new Error(`Gateway error: ${res.status} ${res.statusText}`);\n      }\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AA6IO,SAAS,oBAAoB,SAAgC;AAClE,QAAM,OAAO,QAAQ,QAAQ,QAAQ,EAAE;AAEvC,iBAAe,eAAkB,KAA2B;AAC1D,UAAM,WAAY,MAAM,IAAI,KAAK;AACjC,WAAO,SAAS;AAAA,EAClB;AAEA,WAAS,oBAAoB,QAAuC;AAClE,WAAO;AAAA,MACL,QAAQ,OAAO,UAAU,OAAO,MAAM;AAAA,MACtC,OAAO,OAAO,SAAS,OAAO,gBAAgB;AAAA,MAC9C,KAAK,OAAO;AAAA,MACZ,UAAU,OAAO;AAAA,MACjB,WAAW,OAAO,aAAa,OAAO,WAAW;AAAA,IACnD;AAAA,EACF;AAEA,WAAS,cACP,MACA,KACoB;AACpB,UAAM,QAAQ,KAAK,GAAG,KAAK,KAAK,IAAI;AACpC,WAAO,OAAO,UAAU,WAAW,QAAQ;AAAA,EAC7C;AAEA,SAAO;AAAA,IACL,MAAM,oBAAoB,SAAmC;AAC3D,YAAM,UAAU,MAAM,KAAK,WAAW,OAAO;AAC7C,aAAO,YAAY;AAAA,IACrB;AAAA,IAEA,MAAM,WAAW,SAA0C;AACzD,YAAM,MAAM,MAAM,MAAM,GAAG,IAAI,gBAAgB,OAAO,EAAE;AACxD,UAAI,IAAI,WAAW,IAAK,QAAO;AAC/B,UAAI,CAAC,IAAI,IAAI;AACX,cAAM,IAAI,MAAM,kBAAkB,IAAI,MAAM,IAAI,IAAI,UAAU,EAAE;AAAA,MAClE;AACA,aAAO,eAAwB,GAAG;AAAA,IACpC;AAAA,IAEA,MAAM,SAAS,SAAuD;AACpE,YAAM,MAAM,MAAM,MAAM,GAAG,IAAI,cAAc,OAAO,EAAE;AACtD,UAAI,IAAI,WAAW,IAAK,QAAO;AAC/B,UAAI,CAAC,IAAI,IAAI;AACX,cAAM,IAAI,MAAM,kBAAkB,IAAI,MAAM,IAAI,IAAI,UAAU,EAAE;AAAA,MAClE;AACA,aAAO,eAAqC,GAAG;AAAA,IACjD;AAAA,IAEA,MAAM,iBAAiB,aAA+C;AACpE,YAAM,MAAM,MAAM,MAAM,GAAG,IAAI,mBAAmB,WAAW,EAAE;AAC/D,UAAI,IAAI,WAAW,IAAK,QAAO,CAAC;AAChC,UAAI,CAAC,IAAI,IAAI;AACX,cAAM,IAAI,MAAM,kBAAkB,IAAI,MAAM,IAAI,IAAI,UAAU,EAAE;AAAA,MAClE;AACA,aAAO,eAAgC,GAAG;AAAA,IAC5C;AAAA,IAEA,MAAM,kBAAkB,OAAuC;AAC7D,YAAM,MAAM,MAAM,MAAM,GAAG,IAAI,qBAAqB,KAAK,EAAE;AAC3D,UAAI,IAAI,WAAW,IAAK,QAAO;AAC/B,UAAI,CAAC,IAAI,IAAI;AACX,cAAM,IAAI,MAAM,kBAAkB,IAAI,MAAM,IAAI,IAAI,UAAU,EAAE;AAAA,MAClE;AACA,aAAO,eAAuB,GAAG;AAAA,IACnC;AAAA,IAEA,MAAM,UAAU,SAA6C;AAC3D,YAAM,MAAM,MAAM,MAAM,GAAG,IAAI,eAAe,OAAO,EAAE;AACvD,UAAI,IAAI,WAAW,IAAK,QAAO;AAC/B,UAAI,CAAC,IAAI,IAAI;AACX,cAAM,IAAI,MAAM,kBAAkB,IAAI,MAAM,IAAI,IAAI,UAAU,EAAE;AAAA,MAClE;AACA,aAAO,eAA2B,GAAG;AAAA,IACvC;AAAA,IAEA,MAAM,QAAQ,QAA4C;AACxD,YAAM,MAAM,MAAM,MAAM,GAAG,IAAI,aAAa,MAAM,EAAE;AACpD,UAAI,IAAI,WAAW,IAAK,QAAO;AAC/B,UAAI,CAAC,IAAI,IAAI;AACX,cAAM,IAAI,MAAM,kBAAkB,IAAI,MAAM,IAAI,IAAI,UAAU,EAAE;AAAA,MAClE;AACA,aAAO,oBAAoB,MAAM,eAAkC,GAAG,CAAC;AAAA,IACzE;AAAA,IAEA,MAAM,eACJ,OACA,QACyB;AACzB,YAAM,SAAS,IAAI,gBAAgB,EAAE,MAAM,MAAM,CAAC;AAClD,UAAI,WAAW,MAAM;AACnB,eAAO,IAAI,SAAS,MAAM;AAAA,MAC5B;AACA,YAAM,MAAM,MAAM,MAAM,GAAG,IAAI,aAAa,OAAO,SAAS,CAAC,EAAE;AAC/D,UAAI,CAAC,IAAI,IAAI;AACX,cAAM,IAAI,MAAM,kBAAkB,IAAI,MAAM,IAAI,IAAI,UAAU,EAAE;AAAA,MAClE;AACA,YAAM,OAAO,MAAM,eAGhB,GAAG;AACN,aAAO;AAAA,QACL,OAAO,KAAK,MAAM,IAAI,mBAAmB;AAAA,QACzC,QAAQ,KAAK;AAAA,MACf;AAAA,IACF;AAAA,IAEA,MAAM,UAAU,UAA0C;AACxD,YAAM,MAAM,MAAM,MAAM,GAAG,IAAI,eAAe,QAAQ,EAAE;AACxD,UAAI,IAAI,WAAW,IAAK,QAAO;AAC/B,UAAI,CAAC,IAAI,IAAI;AACX,cAAM,IAAI,MAAM,kBAAkB,IAAI,MAAM,IAAI,IAAI,UAAU,EAAE;AAAA,MAClE;AACA,aAAO,eAAuB,GAAG;AAAA,IACnC;AAAA,IAEA,MAAM,eACJ,QAC+B;AAC/B,YAAM,MAAM,MAAM,MAAM,GAAG,IAAI,eAAe;AAAA,QAC5C,QAAQ;AAAA,QACR,SAAS;AAAA,UACP,gBAAgB;AAAA,UAChB,eAAe,cAAc,OAAO,SAAS;AAAA,QAC/C;AAAA,QACA,MAAM,KAAK,UAAU;AAAA,UACnB,cAAc,OAAO;AAAA,UACrB,eAAe,OAAO;AAAA,UACtB,WAAW,OAAO;AAAA,UAClB,WAAW,OAAO;AAAA,QACpB,CAAC;AAAA,MACH,CAAC;AACD,UAAI,IAAI,WAAW,KAAK;AACtB,cAAMA,QAAO,MAAM,IAAI,KAAK,EAAE,MAAM,OAAO,CAAC,EAAE;AAC9C,eAAO;AAAA,UACL,UAAU,cAAcA,OAAiC,UAAU;AAAA,UACnE,mBAAmB;AAAA,QACrB;AAAA,MACF;AACA,UAAI,CAAC,IAAI,IAAI;AACX,cAAM,IAAI,MAAM,kBAAkB,IAAI,MAAM,IAAI,IAAI,UAAU,EAAE;AAAA,MAClE;AACA,YAAM,OAAO,MAAM,IAAI,KAAK,EAAE,MAAM,OAAO,CAAC,EAAE;AAC9C,aAAO;AAAA,QACL,UAAU,cAAc,MAAiC,UAAU;AAAA,QACnE,mBAAmB;AAAA,MACrB;AAAA,IACF;AAAA,IAEA,MAAM,aACJ,QAC8B;AAC9B,YAAM,MAAM,MAAM,MAAM,GAAG,IAAI,aAAa;AAAA,QAC1C,QAAQ;AAAA,QACR,SAAS;AAAA,UACP,gBAAgB;AAAA,UAChB,eAAe,cAAc,OAAO,SAAS;AAAA,QAC/C;AAAA,QACA,MAAM,KAAK,UAAU;AAAA,UACnB,cAAc,OAAO;AAAA,UACrB,KAAK,OAAO;AAAA,UACZ,UAAU,OAAO;AAAA,QACnB,CAAC;AAAA,MACH,CAAC;AACD,UAAI,IAAI,WAAW,KAAK;AACtB,cAAMA,QAAO,MAAM,IAAI,KAAK,EAAE,MAAM,OAAO,CAAC,EAAE;AAC9C,eAAO;AAAA,UACL,QAAQ,cAAcA,OAAiC,QAAQ;AAAA,QACjE;AAAA,MACF;AACA,UAAI,CAAC,IAAI,IAAI;AACX,cAAM,IAAI,MAAM,kBAAkB,IAAI,MAAM,IAAI,IAAI,UAAU,EAAE;AAAA,MAClE;AACA,YAAM,OAAO,MAAM,IAAI,KAAK;AAC5B,aAAO;AAAA,QACL,QAAQ,cAAc,MAAiC,QAAQ;AAAA,MACjE;AAAA,IACF;AAAA,IAEA,MAAM,YACJ,QAC+B;AAC/B,YAAM,MAAM,MAAM,MAAM,GAAG,IAAI,cAAc;AAAA,QAC3C,QAAQ;AAAA,QACR,SAAS;AAAA,UACP,gBAAgB;AAAA,UAChB,eAAe,cAAc,OAAO,SAAS;AAAA,QAC/C;AAAA,QACA,MAAM,KAAK,UAAU;AAAA,UACnB,gBAAgB,OAAO;AAAA,UACvB,WAAW,OAAO;AAAA,UAClB,OAAO,OAAO;AAAA,UACd,SAAS,OAAO;AAAA,QAClB,CAAC;AAAA,MACH,CAAC;AACD,UAAI,IAAI,WAAW,KAAK;AACtB,cAAMA,QAAO,MAAM,IAAI,KAAK,EAAE,MAAM,OAAO,CAAC,EAAE;AAC9C,eAAO;AAAA,UACL,SAAS,cAAcA,OAAiC,SAAS;AAAA,QACnE;AAAA,MACF;AACA,UAAI,CAAC,IAAI,IAAI;AACX,cAAM,IAAI,MAAM,kBAAkB,IAAI,MAAM,IAAI,IAAI,UAAU,EAAE;AAAA,MAClE;AACA,YAAM,OAAO,MAAM,IAAI,KAAK;AAC5B,aAAO;AAAA,QACL,SAAS,cAAc,MAAiC,SAAS;AAAA,MACnE;AAAA,IACF;AAAA,IAEA,MAAM,YAAY,QAA0C;AAC1D,YAAM,MAAM,MAAM,MAAM,GAAG,IAAI,cAAc,OAAO,OAAO,IAAI;AAAA,QAC7D,QAAQ;AAAA,QACR,SAAS;AAAA,UACP,gBAAgB;AAAA,UAChB,eAAe,cAAc,OAAO,SAAS;AAAA,QAC/C;AAAA,QACA,MAAM,KAAK,UAAU;AAAA,UACnB,gBAAgB,OAAO;AAAA,QACzB,CAAC;AAAA,MACH,CAAC;AACD,UAAI,IAAI,WAAW,IAAK;AACxB,UAAI,CAAC,IAAI,IAAI;AACX,cAAM,IAAI,MAAM,kBAAkB,IAAI,MAAM,IAAI,IAAI,UAAU,EAAE;AAAA,MAClE;AAAA,IACF;AAAA,EACF;AACF;","names":["body"]}

package/dist/protocol/gateway.d.ts

@@ -0,0 +1,120 @@
+export interface GatewayEnvelope<T> {
+    data: T;
+    proof: GatewayProof;
+}
+export interface GatewayProof {
+    signature: string;
+    timestamp: string;
+    gatewayAddress: string;
+    requestHash: string;
+    responseHash: string;
+    userSignature: string;
+    status: string;
+    chainBlockHeight: number;
+}
+export interface Builder {
+    id: string;
+    ownerAddress: string;
+    granteeAddress: string;
+    publicKey: string;
+    appUrl: string;
+    addedAt: string;
+}
+export interface Schema {
+    id: string;
+    ownerAddress: string;
+    name: string;
+    definitionUrl: string;
+    scope: string;
+    addedAt: string;
+}
+export interface ServerInfo {
+    id: string;
+    ownerAddress: string;
+    serverAddress: string;
+    publicKey: string;
+    serverUrl: string;
+    addedAt: string;
+}
+export interface GatewayGrantResponse {
+    id: string;
+    grantorAddress: string;
+    granteeId: string;
+    grant: string;
+    fileIds: string[];
+    status: "pending" | "confirmed";
+    addedAt: string;
+    revokedAt: string | null;
+    revocationSignature: string | null;
+}
+export interface GrantListItem {
+    id: string;
+    grantorAddress: string;
+    granteeId: string;
+    grant: string;
+    fileIds: string[];
+    status: "pending" | "confirmed";
+    addedAt: string;
+    revokedAt: string | null;
+    revocationSignature: string | null;
+}
+export interface FileRecord {
+    fileId: string;
+    owner: string;
+    url: string;
+    schemaId: string;
+    createdAt: string;
+}
+export interface FileListResult {
+    files: FileRecord[];
+    cursor: string | null;
+}
+export interface RegisterFileParams {
+    ownerAddress: string;
+    url: string;
+    schemaId: string;
+    signature: string;
+}
+export interface CreateGrantParams {
+    grantorAddress: string;
+    granteeId: string;
+    grant: string;
+    fileIds: string[];
+    signature: string;
+}
+export interface RevokeGrantParams {
+    grantId: string;
+    grantorAddress: string;
+    signature: string;
+}
+export interface RegisterServerParams {
+    ownerAddress: string;
+    serverAddress: string;
+    publicKey: string;
+    serverUrl: string;
+    signature: string;
+}
+export interface RegisterServerResult {
+    serverId?: string;
+    alreadyRegistered: boolean;
+}
+export interface GatewayClient {
+    isRegisteredBuilder(address: string): Promise<boolean>;
+    getBuilder(address: string): Promise<Builder | null>;
+    getGrant(grantId: string): Promise<GatewayGrantResponse | null>;
+    listGrantsByUser(userAddress: string): Promise<GrantListItem[]>;
+    getSchemaForScope(scope: string): Promise<Schema | null>;
+    getServer(address: string): Promise<ServerInfo | null>;
+    getFile(fileId: string): Promise<FileRecord | null>;
+    listFilesSince(owner: string, cursor: string | null): Promise<FileListResult>;
+    getSchema(schemaId: string): Promise<Schema | null>;
+    registerServer(params: RegisterServerParams): Promise<RegisterServerResult>;
+    registerFile(params: RegisterFileParams): Promise<{
+        fileId?: string;
+    }>;
+    createGrant(params: CreateGrantParams): Promise<{
+        grantId?: string;
+    }>;
+    revokeGrant(params: RevokeGrantParams): Promise<void>;
+}
+export declare function createGatewayClient(baseUrl: string): GatewayClient;