@neus/sdk 1.0.3 → 1.0.4

package/widgets/README.md

@@ -1,64 +1,45 @@
-# NEUS Widgets (VerifyGate + ProofBadge)
-
-React components for NEUS verification and access gating.
-
-## Install
-
-```bash
-npm install @neus/sdk react react-dom
-```
-
-## VerifyGate
-
-Gate UI behind verification requirements.
-
-```jsx
-import { VerifyGate } from '@neus/sdk/widgets';
-
-export function Page() {
-  return (
-    <VerifyGate
-      requiredVerifiers={['nft-ownership']}
-      verifierData={{
-        'nft-ownership': { contractAddress: '0x...', tokenId: '1', chainId: 8453 }
-      }}
-    >
-      <div>Unlocked</div>
-    </VerifyGate>
-  );
-}
-```
-
-### Key props
-
-- `requiredVerifiers`: `string[]` (default: `['ownership-basic']`)
-- `verifierData`: object keyed by verifier id
-- `strategy`: `'reuse-or-create' | 'reuse' | 'fresh'` (default: `'reuse-or-create'`)
-- `proofOptions`: `{ privacyLevel, publicDisplay, storeOriginalContent, enableIpfs? }` (defaults: private)
-- `mode`: `'create' | 'access'` (default: `'create'`)
-- `proofId`: string (required for `mode="access"`)
-- `maxProofAgeMs`: `number` (optional) - max proof age override in milliseconds for reuse checks
-- `onError`: `(error: Error) => void` (optional) - called when verification/gating errors occur
-- `apiUrl`: protocol API base URL (optional)
-- `hostedCheckoutUrl`: hosted verify page URL (optional, recommended when `apiUrl` is custom)
-
-Notes:
-- Reuse without prompting can only see **public + discoverable** proofs.
-- Reusing private proofs requires an **owner signature** (wallet grants read access).
-- Interactive verifiers (`ownership-social`, `ownership-org-oauth`, `proof-of-human`) use NEUS hosted checkout automatically when required.
-- If you set a custom `apiUrl`, also set `hostedCheckoutUrl` to your hosted verify UI (for example `https://neus.network/verify`).
-  `apiUrl` is used for API calls; `hostedCheckoutUrl` is used for popup checkout routing.
-
-## ProofBadge
-
-Display verification status by Proof ID (`proofId`).
-
-```jsx
-import { ProofBadge } from '@neus/sdk/widgets';
-
-<ProofBadge proofId="0x..." showChains />
-```
-
-Notes:
-- Widgets default to a bundled NEUS logo asset (inlined at build time), so no external logo fetch is required.
-- You can override with `logoUrl` in `ProofBadge`, `SimpleProofBadge`, `NeusPillLink`, and `VerifiedIcon`.
+# NEUS Widgets
+
+**Proof-aware React components** (VerifyGate, ProofBadge) so your UI can show verified state and gate content **using the same checks your server already trusts** - avoid re-implementing verifier rules only in the browser.
+
+## Install
+
+```bash
+npm install @neus/sdk react react-dom
+```
+
+## VerifyGate
+
+Create mode defaults to **unlisted public** for gate-friendly reuse. Override `proofOptions` when you need listed public or private.
+
+```jsx
+import { VerifyGate } from '@neus/sdk/widgets';
+
+export function Page() {
+  return (
+    <VerifyGate
+      appId="your-app-id"
+      requiredVerifiers={['nft-ownership']}
+      verifierData={{
+        'nft-ownership': { contractAddress: '0x...', tokenId: '1', chainId: 8453 }
+      }}
+    >
+      <div>Unlocked</div>
+    </VerifyGate>
+  );
+}
+```
+
+## ProofBadge
+
+```jsx
+import { ProofBadge } from '@neus/sdk/widgets';
+
+<ProofBadge proofId="0x..." showChains />
+```
+
+## Docs
+
+- [Widgets Overview](https://docs.neus.network/widgets/overview)
+- [Verify Component](https://docs.neus.network/widgets/verifygate)
+- [Quickstart](https://docs.neus.network/quickstart)

package/widgets/index.js

@@ -1,6 +1,6 @@
 /**
  * NEUS Widgets
- * 
+ *
  * Core Widgets:
  * - VerifyGate: Universal verification gate component
  * - ProofBadge: Display verification status

package/widgets/verify-gate/dist/ProofBadge.js

@@ -58,22 +58,19 @@ function ProofBadge({
     return 0;
   });
   useEffect(() => {
-    if (!resolvedProofId || proof)
-      return;
+    if (!resolvedProofId || proof) return;
     let cancelled = false;
     async function checkStatus() {
       try {
-        const res = await fetch(`${apiUrl}/api/v1/verification/status/${resolvedProofId}`, {
+        const res = await fetch(`${apiUrl}/api/v1/proofs/${resolvedProofId}`, {
           headers: { Accept: "application/json" }
         });
         if (!res.ok) {
-          if (!cancelled)
-            setStatus("failed");
+          if (!cancelled) setStatus("failed");
           return;
         }
         const json = await res.json();
-        if (cancelled)
-          return;
+        if (cancelled) return;
         const proofStatus = json?.data?.status || "";
         const isVerified = proofStatus.toLowerCase().includes("verified");
         const isPending = proofStatus.toLowerCase().includes("processing") || proofStatus.toLowerCase().includes("pending");
@@ -86,8 +83,7 @@ function ProofBadge({
           setChainCount(count);
         }
       } catch (_) {
-        if (!cancelled)
-          setStatus("failed");
+        if (!cancelled) setStatus("failed");
       }
     }
     checkStatus();
@@ -174,27 +170,23 @@ function SimpleProofBadge({
     return resolvedProofId ? "pending" : "unknown";
   });
   useEffect(() => {
-    if (!resolvedProofId || proof)
-      return;
+    if (!resolvedProofId || proof) return;
     let cancelled = false;
     async function checkStatus() {
       try {
-        const res = await fetch(`${apiUrl}/api/v1/verification/status/${resolvedProofId}`, {
+        const res = await fetch(`${apiUrl}/api/v1/proofs/${resolvedProofId}`, {
           headers: { Accept: "application/json" }
         });
         if (!res.ok) {
-          if (!cancelled)
-            setStatus("failed");
+          if (!cancelled) setStatus("failed");
           return;
         }
         const json = await res.json();
-        if (cancelled)
-          return;
+        if (cancelled) return;
         const isVerified = json?.success === true || json?.data?.status?.toLowerCase()?.includes("verified");
         setStatus(isVerified ? "verified" : "failed");
       } catch (_) {
-        if (!cancelled)
-          setStatus("failed");
+        if (!cancelled) setStatus("failed");
       }
     }
     checkStatus();