@neus/sdk 1.1.0 → 1.1.2

package/cjs/index.cjs

@@ -167,6 +167,89 @@ var init_errors = __esm({
   }
 });
 
+// sponsor.js
+async function fetchSponsorGrant(params = {}) {
+  const {
+    apiUrl = "https://api.neus.network",
+    appId,
+    orgWallet,
+    verifierIds = [],
+    targetChains = [],
+    origin,
+    expiresInSeconds = 900,
+    fetchImpl = fetch
+  } = params;
+  const normalizedAppId = typeof appId === "string" ? appId.trim() : "";
+  const normalizedOrg = typeof orgWallet === "string" ? orgWallet.trim().toLowerCase() : "";
+  if (!normalizedAppId) {
+    throw new ValidationError("appId is required for sponsor grant");
+  }
+  if (!normalizedOrg || !/^0x[a-f0-9]{40}$/.test(normalizedOrg)) {
+    throw new ValidationError("orgWallet must be a valid EVM address");
+  }
+  let base = String(apiUrl || "https://api.neus.network").replace(/\/+$/, "");
+  try {
+    const url = new URL(base);
+    if (url.hostname.endsWith("neus.network") && url.protocol === "http:") {
+      url.protocol = "https:";
+    }
+    base = url.toString().replace(/\/+$/, "");
+  } catch {
+  }
+  const headers = {
+    "Content-Type": "application/json",
+    Accept: "application/json",
+    "X-Neus-App": normalizedAppId,
+    "X-Neus-Sdk": "js"
+  };
+  if (typeof origin === "string" && origin.trim()) {
+    headers.Origin = origin.trim();
+  }
+  const body = {
+    orgWallet: normalizedOrg,
+    scope: "sponsored-verification",
+    expiresInSeconds,
+    ...Array.isArray(verifierIds) && verifierIds.length > 0 ? { verifierIds: verifierIds.map((v) => String(v).trim()).filter(Boolean).slice(0, 25) } : {},
+    ...Array.isArray(targetChains) && targetChains.length > 0 ? { targetChains: targetChains.filter((n) => Number.isFinite(Number(n))).slice(0, 25) } : {}
+  };
+  let response;
+  try {
+    response = await fetchImpl(`${base}/api/v1/sponsor/grant`, {
+      method: "POST",
+      headers,
+      body: JSON.stringify(body)
+    });
+  } catch (error) {
+    throw new NetworkError(`Sponsor grant request failed: ${error?.message || String(error)}`);
+  }
+  let payload;
+  try {
+    payload = await response.json();
+  } catch {
+    payload = { success: false, error: { message: "Invalid JSON response" } };
+  }
+  if (!response.ok || payload?.success !== true) {
+    throw ApiError.fromResponse(response, payload);
+  }
+  const token = payload?.data?.sponsorGrant;
+  if (!token || typeof token !== "string") {
+    throw new ApiError("Sponsor grant response missing sponsorGrant token", payload?.error);
+  }
+  return {
+    sponsorGrant: token,
+    exp: payload?.data?.exp,
+    orgWallet: payload?.data?.orgWallet || normalizedOrg,
+    appId: payload?.data?.appId || normalizedAppId,
+    maxCredits: payload?.data?.maxCredits
+  };
+}
+var init_sponsor = __esm({
+  "sponsor.js"() {
+    "use strict";
+    init_errors();
+  }
+});
+
 // utils.js
 function encodeBase58Bytes(input) {
   let source;
@@ -956,6 +1039,8 @@ function getHostedCheckoutUrl(opts = {}) {
   if (opts.intent) params.set("intent", String(opts.intent));
   if (opts.origin) params.set("origin", String(opts.origin));
   if (opts.oauthProvider) params.set("oauthProvider", String(opts.oauthProvider));
+  if (opts.appId) params.set("appId", String(opts.appId));
+  if (opts.billingWallet) params.set("billingWallet", String(opts.billingWallet).trim().toLowerCase());
   const qs = params.toString();
   return qs ? `${base}?${qs}` : base;
 }
@@ -1091,6 +1176,7 @@ var init_client = __esm({
   "client.js"() {
     "use strict";
     init_errors();
+    init_sponsor();
     init_utils();
     FALLBACK_PUBLIC_VERIFIER_CATALOG = {
       "ownership-basic": { supportsDirectApi: true },
@@ -1430,6 +1516,54 @@ var init_client = __esm({
           }
         } catch {
         }
+        this._sponsorGrantCache = null;
+      }
+      _getBillingWallet() {
+        const raw = this.config.billingWallet || this.config.sponsorOrgWallet || this.config.orgWallet || null;
+        if (typeof raw !== "string") return null;
+        const trimmed = raw.trim().toLowerCase();
+        return /^0x[a-f0-9]{40}$/.test(trimmed) ? trimmed : null;
+      }
+      _resolveIntegratorOrigin() {
+        if (typeof this.config.appOrigin === "string" && this.config.appOrigin.trim()) {
+          return this.config.appOrigin.trim();
+        }
+        try {
+          if (typeof window !== "undefined" && window.location?.origin) {
+            return window.location.origin;
+          }
+        } catch {
+        }
+        return null;
+      }
+      async _resolveSponsorGrantHeaders(verifierIds = []) {
+        const appId = typeof this.config.appId === "string" ? this.config.appId.trim() : "";
+        const orgWallet = this._getBillingWallet();
+        if (!appId || !orgWallet) {
+          return {};
+        }
+        const normalizedVerifierIds = Array.isArray(verifierIds) ? verifierIds.map((v) => String(v || "").trim()).filter(Boolean).slice(0, 25) : [];
+        const cacheKey = `${appId}:${orgWallet}:${normalizedVerifierIds.join(",")}`;
+        const now = Date.now();
+        if (this._sponsorGrantCache && this._sponsorGrantCache.key === cacheKey && this._sponsorGrantCache.expMs > now + 3e4) {
+          return { "X-Sponsor-Grant": this._sponsorGrantCache.token };
+        }
+        const origin = this._resolveIntegratorOrigin();
+        const grant = await fetchSponsorGrant({
+          apiUrl: this.baseUrl,
+          appId,
+          orgWallet,
+          verifierIds: normalizedVerifierIds,
+          origin
+        });
+        const expSeconds = Number(grant?.exp);
+        const expMs = Number.isFinite(expSeconds) && expSeconds > 0 ? expSeconds * 1e3 : now + 15 * 60 * 1e3;
+        this._sponsorGrantCache = {
+          key: cacheKey,
+          token: grant.sponsorGrant,
+          expMs
+        };
+        return { "X-Sponsor-Grant": grant.sponsorGrant };
       }
       _getHubChainId() {
         const configured = Number(this.config?.hubChainId);
@@ -1955,21 +2089,20 @@ var init_client = __esm({
                 return hex;
               }
             };
-            const isFarcasterWallet = (() => {
+            const isBaseMiniAppWallet = (() => {
               if (typeof window === "undefined") return false;
               try {
                 const w = window;
-                const fc = w.farcaster;
-                if (!fc || !fc.context) return false;
-                const fcProvider = fc.provider || fc.walletProvider || fc.context && fc.context.walletProvider;
-                if (fcProvider === provider) return true;
-                if (w.mini && w.mini.wallet === provider && fc && fc.context) return true;
-                if (w.ethereum === provider && fc && fc.context) return true;
+                const mini = w.mini;
+                if (!mini) return false;
+                const miniProvider = mini.wallet || mini.provider;
+                if (miniProvider === provider) return true;
+                if (w.ethereum === provider && mini) return true;
               } catch {
               }
               return false;
             })();
-            if (isFarcasterWallet) {
+            if (isBaseMiniAppWallet) {
               try {
                 const hexMsg = toHexUtf82(message);
                 signature2 = await provider.request({ method: "personal_sign", params: [hexMsg, walletAddress2] });
@@ -2102,7 +2235,8 @@ ${bytes.length}`;
           ...delegationQHash && { delegationQHash },
           options: optionsPayload
         };
-        const response = await this._makeRequest("POST", "/api/v1/verification", requestData);
+        const sponsorHeaders = await this._resolveSponsorGrantHeaders(normalizedVerifierIds);
+        const response = await this._makeRequest("POST", "/api/v1/verification", requestData, sponsorHeaders);
         if (!response.success) {
           throw new ApiError(`Verification failed: ${response.error?.message || "Unknown error"}`, response.error);
         }
@@ -2317,7 +2451,9 @@ ${bytes.length}`;
         const pathId = /^0x[a-fA-F0-9]{40}$/i.test(id) ? id.toLowerCase() : id;
         const qs = [];
         if (options.limit) qs.push(`limit=${encodeURIComponent(String(options.limit))}`);
-        if (options.offset) qs.push(`offset=${encodeURIComponent(String(options.offset))}`);
+        const cursorRaw = options.cursor !== null && options.cursor !== void 0 ? String(options.cursor).trim() : "";
+        if (cursorRaw) qs.push(`cursor=${encodeURIComponent(cursorRaw)}`);
+        else if (options.offset) qs.push(`offset=${encodeURIComponent(String(options.offset))}`);
         if (options.qHash) qs.push(`qHash=${encodeURIComponent(options.qHash.toLowerCase())}`);
         const query = qs.length ? `?${qs.join("&")}` : "";
         const response = await this._makeRequest(
@@ -2333,7 +2469,8 @@ ${bytes.length}`;
           proofs: Array.isArray(proofs) ? proofs : [],
           totalCount: response.data?.totalCount ?? proofs.length,
           hasMore: Boolean(response.data?.hasMore),
-          nextOffset: response.data?.nextOffset ?? null
+          nextOffset: response.data?.nextOffset ?? null,
+          nextCursor: typeof response.data?.nextCursor === "string" && response.data.nextCursor.trim() ? response.data.nextCursor.trim() : null
         };
       }
       async getPrivateProofsByWallet(walletAddress, options = {}, wallet = null) {
@@ -2385,7 +2522,9 @@ ${bytes.length}`;
         }
         const qs = [];
         if (options.limit) qs.push(`limit=${encodeURIComponent(String(options.limit))}`);
-        if (options.offset) qs.push(`offset=${encodeURIComponent(String(options.offset))}`);
+        const cursorRaw = options.cursor !== null && options.cursor !== void 0 ? String(options.cursor).trim() : "";
+        if (cursorRaw) qs.push(`cursor=${encodeURIComponent(cursorRaw)}`);
+        else if (options.offset) qs.push(`offset=${encodeURIComponent(String(options.offset))}`);
         if (options.qHash) qs.push(`qHash=${encodeURIComponent(options.qHash.toLowerCase())}`);
         const query = qs.length ? `?${qs.join("&")}` : "";
         const response = await this._makeRequest("GET", `/api/v1/proofs/by-wallet/${encodeURIComponent(pathId)}${query}`, null, {
@@ -2403,7 +2542,8 @@ ${bytes.length}`;
           proofs: Array.isArray(proofs) ? proofs : [],
           totalCount: response.data?.totalCount ?? proofs.length,
           hasMore: Boolean(response.data?.hasMore),
-          nextOffset: response.data?.nextOffset ?? null
+          nextOffset: response.data?.nextOffset ?? null,
+          nextCursor: typeof response.data?.nextCursor === "string" && response.data.nextCursor.trim() ? response.data.nextCursor.trim() : null
         };
       }
       async gateCheck(params = {}) {
@@ -2411,6 +2551,8 @@ ${bytes.length}`;
         if (!validateUniversalAddress(address, params.chain)) {
           throw new ValidationError("Valid address is required");
         }
+        const gateIdParam = typeof params.gateId === "string" ? params.gateId.trim() : "";
+        const verifierIds = gateIdParam ? void 0 : params.verifierIds;
         const qs = new URLSearchParams();
         qs.set("address", address);
         const setIfPresent = (key, value) => {
@@ -2432,7 +2574,8 @@ ${bytes.length}`;
           }
           setIfPresent(key, value);
         };
-        setCsvIfPresent("verifierIds", params.verifierIds);
+        setIfPresent("gateId", gateIdParam);
+        setCsvIfPresent("verifierIds", verifierIds);
         setBoolIfPresent("requireAll", params.requireAll);
         setIfPresent("minCount", params.minCount);
         setIfPresent("sinceDays", params.sinceDays);
@@ -2495,7 +2638,20 @@ ${bytes.length}`;
             };
           }
         }
-        const response = await this._makeRequest("GET", `/api/v1/proofs/check?${qs.toString()}`, null, headersOverride);
+        let mergedHeaders = headersOverride;
+        if (!mergedHeaders && !gateIdParam) {
+          try {
+            const sponsorHeaders = await this._resolveSponsorGrantHeaders(
+              Array.isArray(verifierIds) ? verifierIds : verifierIds ? [verifierIds] : []
+            );
+            if (sponsorHeaders && Object.keys(sponsorHeaders).length > 0) {
+              mergedHeaders = sponsorHeaders;
+            }
+          } catch (error) {
+            this._log("Sponsor grant unavailable for gateCheck (continuing without)", error?.message || String(error));
+          }
+        }
+        const response = await this._makeRequest("GET", `/api/v1/proofs/check?${qs.toString()}`, null, mergedHeaders);
         if (!response.success) {
           throw new ApiError(`Gate check failed: ${response.error?.message || "Unknown error"}`, response.error);
         }
@@ -2784,6 +2940,7 @@ __export(index_exports, {
   default: () => index_default,
   delay: () => delay,
   deriveDid: () => deriveDid,
+  fetchSponsorGrant: () => fetchSponsorGrant,
   formatTimestamp: () => formatTimestamp,
   formatVerificationStatus: () => formatVerificationStatus,
   getHostedCheckoutUrl: () => getHostedCheckoutUrl,
@@ -2850,6 +3007,7 @@ function combineGates(...gates) {
 }
 
 // index.js
+init_sponsor();
 init_errors();
 var index_default = {
   NeusClient: () => Promise.resolve().then(() => (init_client(), client_exports)).then((m) => m.NeusClient),
@@ -2892,6 +3050,7 @@ var index_default = {
   createVerificationData,
   delay,
   deriveDid,
+  fetchSponsorGrant,
   formatTimestamp,
   formatVerificationStatus,
   getHostedCheckoutUrl,

package/cjs/mcp-hosts.cjs

@@ -0,0 +1,125 @@
+"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);
+
+// mcp-hosts.js
+var mcp_hosts_exports = {};
+__export(mcp_hosts_exports, {
+  IDE_HOST_BRAND_LOGOS: () => IDE_HOST_BRAND_LOGOS,
+  IDE_HOST_LABELS: () => IDE_HOST_LABELS,
+  MCP_INSTALL_CLIENTS: () => MCP_INSTALL_CLIENTS,
+  MCP_INSTALL_HOSTS: () => MCP_INSTALL_HOSTS,
+  NEUS_AUTH_CLI: () => NEUS_AUTH_CLI,
+  NEUS_MCP_SERVER_NAME: () => NEUS_MCP_SERVER_NAME,
+  NEUS_MCP_SETUP_DOCS_URL: () => NEUS_MCP_SETUP_DOCS_URL,
+  NEUS_MCP_URL: () => NEUS_MCP_URL,
+  NEUS_SETUP_CLI: () => NEUS_SETUP_CLI,
+  buildAuthCommandForClient: () => buildAuthCommandForClient,
+  buildCursorMcpInstallUrl: () => buildCursorMcpInstallUrl,
+  buildNeusMcpHttpConfig: () => buildNeusMcpHttpConfig,
+  buildSetupCommandForClient: () => buildSetupCommandForClient,
+  buildSetupCommandForHost: () => buildSetupCommandForHost,
+  buildVsCodeMcpInstallUrl: () => buildVsCodeMcpInstallUrl,
+  supportsMcpInstallDeeplink: () => supportsMcpInstallDeeplink
+});
+module.exports = __toCommonJS(mcp_hosts_exports);
+var NEUS_MCP_SERVER_NAME = "neus";
+var NEUS_MCP_URL = "https://mcp.neus.network/mcp";
+var NEUS_SETUP_CLI = "npx -y -p @neus/sdk neus setup";
+var NEUS_AUTH_CLI = "npx -y -p @neus/sdk neus auth";
+var NEUS_MCP_SETUP_DOCS_URL = "https://docs.neus.network/mcp/ide-plugin";
+var MCP_INSTALL_CLIENTS = ["claude", "codex", "cursor", "vscode"];
+var MCP_INSTALL_HOSTS = ["cursor", "claude", "codex"];
+var IDE_HOST_LABELS = {
+  cursor: "Cursor",
+  claude: "Claude Code",
+  codex: "Codex"
+};
+var IDE_HOST_BRAND_LOGOS = {
+  cursor: "/images/brandLogos/cursor.svg",
+  claude: "/images/brandLogos/anthropic.svg",
+  codex: "/images/brandLogos/openai.svg"
+};
+function buildNeusMcpHttpConfig(accessKey) {
+  const key = String(accessKey || "").trim();
+  return {
+    type: "http",
+    url: NEUS_MCP_URL,
+    ...key ? { headers: { Authorization: `Bearer ${key}` } } : {}
+  };
+}
+function encodeBase64Json(value) {
+  const json = JSON.stringify(value);
+  if (typeof globalThis.btoa === "function") {
+    return globalThis.btoa(json);
+  }
+  return Buffer.from(json, "utf8").toString("base64");
+}
+function buildCursorMcpInstallUrl(accessKey) {
+  const config = buildNeusMcpHttpConfig(accessKey);
+  const encoded = encodeBase64Json(config);
+  return `cursor://anysphere.cursor-deeplink/mcp/install?name=${encodeURIComponent(NEUS_MCP_SERVER_NAME)}&config=${encodeURIComponent(encoded)}`;
+}
+function buildVsCodeMcpInstallUrl(accessKey) {
+  const payload = {
+    name: NEUS_MCP_SERVER_NAME,
+    ...buildNeusMcpHttpConfig(accessKey)
+  };
+  return `vscode:mcp/install?${encodeURIComponent(JSON.stringify(payload))}`;
+}
+function buildAuthCommandForClient(client) {
+  if (client === "codex") {
+    return `${NEUS_AUTH_CLI} --client codex`;
+  }
+  return NEUS_AUTH_CLI;
+}
+function buildSetupCommandForClient(client, accessKey) {
+  const key = String(accessKey || "").trim();
+  const setup = key ? `${NEUS_SETUP_CLI} --client ${client} --access-key ${key}` : `${NEUS_SETUP_CLI} --client ${client}`;
+  if (key) return setup;
+  return `${setup}
+${buildAuthCommandForClient(client)}`;
+}
+function buildSetupCommandForHost(host, accessKey) {
+  return buildSetupCommandForClient(host, accessKey);
+}
+function supportsMcpInstallDeeplink(host) {
+  if (host !== "cursor") return false;
+  if (typeof navigator === "undefined") return false;
+  const ua = navigator.userAgent || "";
+  return !/Android|webOS|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini/i.test(ua);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  IDE_HOST_BRAND_LOGOS,
+  IDE_HOST_LABELS,
+  MCP_INSTALL_CLIENTS,
+  MCP_INSTALL_HOSTS,
+  NEUS_AUTH_CLI,
+  NEUS_MCP_SERVER_NAME,
+  NEUS_MCP_SETUP_DOCS_URL,
+  NEUS_MCP_URL,
+  NEUS_SETUP_CLI,
+  buildAuthCommandForClient,
+  buildCursorMcpInstallUrl,
+  buildNeusMcpHttpConfig,
+  buildSetupCommandForClient,
+  buildSetupCommandForHost,
+  buildVsCodeMcpInstallUrl,
+  supportsMcpInstallDeeplink
+});

package/cjs/utils.cjs

@@ -1012,6 +1012,8 @@ function getHostedCheckoutUrl(opts = {}) {
   if (opts.intent) params.set("intent", String(opts.intent));
   if (opts.origin) params.set("origin", String(opts.origin));
   if (opts.oauthProvider) params.set("oauthProvider", String(opts.oauthProvider));
+  if (opts.appId) params.set("appId", String(opts.appId));
+  if (opts.billingWallet) params.set("billingWallet", String(opts.billingWallet).trim().toLowerCase());
   const qs = params.toString();
   return qs ? `${base}?${qs}` : base;
 }