@neus/sdk 1.0.12 → 1.1.0

package/CHANGELOG.md

@@ -0,0 +1,3 @@
+# Changelog
+
+Release notes: [github.com/neus/network/blob/main/CHANGELOG.md](https://github.com/neus/network/blob/main/CHANGELOG.md)

package/README.md

@@ -1,8 +1,10 @@
 # @neus/sdk
 
-Create, check, and reuse NEUS trust receipts from apps and backends. The same package ships the **`neus`** CLI for wiring **hosted NEUS MCP** into editors and agents.
+Create, check, and reuse NEUS trust receipts from apps and backends. The same package ships the **`neus`** CLI for hosted MCP setup and portable agent import.
 
-NEUS makes trust portable across the internet so people, apps, and AI agents can prove what is real before access, payout, or execution.
+NEUS makes trust portable across apps, agents, and ecosystems before access, payment, or action.
+
+**Status:** [Live and Operational for Production Apps](https://docs.neus.network/platform/status).
 
 ## Install (library)
 
@@ -10,44 +12,39 @@ NEUS makes trust portable across the internet so people, apps, and AI agents can
 npm install @neus/sdk
 ```
 
-## Connect editors and assistants (MCP)
-
-Use one command to merge NEUS into Cursor, VS Code, and Claude Code when those tools are detected. No separate NEUS editor extension is required.
-
-```bash
-npx -y -p @neus/sdk neus setup
-```
+## Bring Your Own Agent (BYOA) in 30 Seconds
 
-Add your NEUS Profile access key in the same step (needed for account-aware tools such as `neus_me`):
+Already have an agent setup? Use the CLI to instantly scan and import your local agent setups—including instructions, memories, rules, skills, and MCP servers from **OpenClaw, Cursor, Claude Code, and Claude Desktop**—straight into the NEUS trust network:
 
 ```bash
-npx -y -p @neus/sdk neus setup --access-key <npk_...>
+npx -y -p @neus/sdk neus import
 ```
 
-Check configuration and connectivity:
+This automatically prepares your portable NEUS agent manifest, maps your credentials, and secures a reusable trust receipt for your workflows.
 
+*To check what will be imported without writing changes:*
 ```bash
-npx -y -p @neus/sdk neus doctor
+npx -y -p @neus/sdk neus import --dry-run
 ```
 
-Create keys under **Profile → Account → Access keys** on [neus.network](https://neus.network/profile?tab=account). Never put access keys in browser bundles or public repos.
+## Connect editors and assistants
 
-| Topic | Link |
-| --- | --- |
-| Setup, JSON snippets, and headers | [MCP setup](https://docs.neus.network/mcp/setup) |
-| Tools and session order | [MCP overview](https://docs.neus.network/mcp/overview) |
-| Discovery URLs | [Discovery and endpoints](https://docs.neus.network/mcp/endpoints) |
-| Optional Claude Code plugin + skill | [NEUS for Claude Code](https://docs.neus.network/mcp/claude-code-marketplace) |
+| Topic                             | Link                                                                          |
+| --------------------------------- | ----------------------------------------------------------------------------- |
+| Setup, JSON snippets, and headers | [MCP setup](https://docs.neus.network/mcp/setup)                              |
+| Tools and session order           | [MCP overview](https://docs.neus.network/mcp/overview)                        |
+| Discovery URLs                    | [Discovery and endpoints](https://docs.neus.network/mcp/endpoints)            |
+| Claude Code skill bundle          | [NEUS for Claude Code](https://docs.neus.network/mcp/claude-code-marketplace) |
 
 Prefer `neus setup` over hand-editing config files so every host stays on **`https://mcp.neus.network/mcp`**.
 
-## What you can build
+## What you can ship
 
-- Issue a proof that a user, wallet, org, app, file, release, profile, or result belongs to someone
-- Store the returned `qHash` as a durable trust receipt ID
-- Check receipts later for access, eligibility, provenance, or display
-- Add proof-gated UX with React widgets
-- Connect IDEs and agents through optional MCP
+- Hosted verification flows that return a reusable receipt
+- Server checks before access, rewards, payments, or actions
+- React gates with `VerifyGate`
+- Agent identity and scoped delegation
+- MCP setup for assistants and agent tools
 
 ## Fastest path: Hosted Verify
 
@@ -64,13 +61,11 @@ const url = getHostedCheckoutUrl({
 window.location.assign(url);
 ```
 
-After completion, NEUS redirects back with a `qHash`.
+After completion, NEUS redirects back with a receipt ID. Store it with your user or record.
 
-Store that `qHash` with your user record.
+## Create a receipt directly
 
-## Create a signed receipt directly
-
-When your app handles signing. This example is EVM. For non-EVM wallets, pass the provider explicitly and include `chain` as a CAIP-2 value; see the CAIP-380 standards page in the docs.
+Use this when your app handles signing. This example is EVM. For non-EVM wallets, pass the provider explicitly and include `chain` as a CAIP-2 value.
 
 ```js
 import { NeusClient } from '@neus/sdk';
@@ -128,7 +123,7 @@ export function Page() {
           }
         }
       }}
-      onVerified={(result) => {
+      onVerified={result => {
         console.log(result.qHash || result.qHashes);
       }}
     />
@@ -165,11 +160,11 @@ Never ship access keys in browser code.
 | ------------------------------- | ------------------------------------------- |
 | `getHostedCheckoutUrl()`        | Send a user to Hosted Verify                |
 | `client.verify()`               | Create a proof                              |
-| `client.getProof()`             | Fetch a proof by `qHash`                    |
+| `client.getProof()`             | Fetch a receipt by `qHash`                  |
 | `client.pollProofStatus()`      | Wait for async completion                   |
 | `client.gateCheck()`            | Server-side eligibility checks              |
 | `client.checkGate()`            | Local preview against already-loaded proofs |
-| `client.createWalletLinkData()` | Advanced wallet-link payloads               |
+| `client.createWalletLinkData()` | Wallet-link payloads                        |
 
 ## Configuration
 
@@ -184,19 +179,22 @@ const client = new NeusClient({
 `appId` is public attribution for your app.
 `apiKey` / `npk_*` is optional and server-side only.
 
-## MCP: step-by-step (alternative to `setup`)
+## MCP step-by-step
 
 ```bash
-npx -y -p @neus/sdk neus init
+npx -y -p @neus/sdk neus setup
+npx -y -p @neus/sdk neus auth
+npx -y -p @neus/sdk neus doctor --live
 ```
 
-Add or rotate a Profile access key on an existing install:
+Re-sign in or rotate credentials:
 
 ```bash
-npx -y -p @neus/sdk neus auth --access-key <npk_...>
+npx -y -p @neus/sdk neus auth
+npx -y -p @neus/sdk neus auth --access-key <npk_...>   # servers and CI only
 ```
 
-Claude Code (optional): add marketplace `https://github.com/neus/network`, install **`neus-mcp@neus`**, then run **`neus setup`** so your key matches every editor. See [NEUS for Claude Code](https://docs.neus.network/mcp/claude-code-marketplace).
+Claude Code users can add the optional **`neus-mcp@neus`** skill bundle, then run **`neus setup`** and **`neus auth`**. See [NEUS for Claude Code](https://docs.neus.network/mcp/claude-code-marketplace).
 
 ## Docs
 

package/cjs/client.cjs

@@ -599,6 +599,17 @@ var validateVerifierData = (verifierId, data) => {
       if (data.agentType && !["ai", "bot", "service", "automation", "agent"].includes(data.agentType)) {
         return { valid: false, error: "agentType must be one of: ai, bot, service, automation, agent" };
       }
+      if (data.defaultRuntime && typeof data.defaultRuntime === "object") {
+        if (data.defaultRuntime.provider && typeof data.defaultRuntime.provider === "string" && data.defaultRuntime.provider.length > 64) {
+          return { valid: false, error: "defaultRuntime.provider must be 64 chars or less" };
+        }
+        if (data.defaultRuntime.model && typeof data.defaultRuntime.model === "string" && data.defaultRuntime.model.length > 128) {
+          return { valid: false, error: "defaultRuntime.model must be 128 chars or less" };
+        }
+        if (data.defaultRuntime.mode && typeof data.defaultRuntime.mode === "string" && data.defaultRuntime.mode.length > 64) {
+          return { valid: false, error: "defaultRuntime.mode must be 64 chars or less" };
+        }
+      }
       break;
     case "agent-delegation":
       if (!data.controllerWallet || !validateWalletAddress(data.controllerWallet)) {
@@ -613,6 +624,18 @@ var validateVerifierData = (verifierId, data) => {
       if (data.expiresAt && (typeof data.expiresAt !== "number" || data.expiresAt < Date.now())) {
         return { valid: false, error: "expiresAt must be a future timestamp" };
       }
+      if (data.model && typeof data.model === "string" && data.model.length > 128) {
+        return { valid: false, error: "model must be 128 chars or less" };
+      }
+      if (data.provider && typeof data.provider === "string" && data.provider.length > 64) {
+        return { valid: false, error: "provider must be 64 chars or less" };
+      }
+      if (data.allowedActions && Array.isArray(data.allowedActions) && data.allowedActions.length > 32) {
+        return { valid: false, error: "allowedActions must have 32 items or less" };
+      }
+      if (data.deniedActions && Array.isArray(data.deniedActions) && data.deniedActions.length > 32) {
+        return { valid: false, error: "deniedActions must have 32 items or less" };
+      }
       break;
     case "ai-content-moderation":
       if (!data.content || typeof data.content !== "string") {
@@ -1146,9 +1169,13 @@ var NeusClient = class {
         verificationData = {
           agentId: data2.agentId,
           agentWallet: data2?.agentWallet || walletAddress2,
+          ...data2?.agentChainRef && { agentChainRef: data2.agentChainRef },
+          ...data2?.agentAccountId && { agentAccountId: data2.agentAccountId },
           ...data2?.agentLabel && { agentLabel: data2.agentLabel },
           ...data2?.agentType && { agentType: data2.agentType },
+          ...data2?.avatar && { avatar: data2.avatar },
           ...data2?.description && { description: data2.description },
+          ...data2?.defaultRuntime && { defaultRuntime: data2.defaultRuntime },
           ...data2?.capabilities && { capabilities: data2.capabilities },
           ...data2?.instructions && { instructions: data2.instructions },
           ...data2?.skills && { skills: data2.skills },
@@ -1160,7 +1187,11 @@ var NeusClient = class {
         }
         verificationData = {
           controllerWallet: data2?.controllerWallet || walletAddress2,
+          ...data2?.controllerChainRef && { controllerChainRef: data2.controllerChainRef },
           agentWallet: data2.agentWallet,
+          ...data2?.agentChainRef && { agentChainRef: data2.agentChainRef },
+          ...data2?.controllerAccountId && { controllerAccountId: data2.controllerAccountId },
+          ...data2?.agentAccountId && { agentAccountId: data2.agentAccountId },
           ...data2?.agentId && { agentId: data2.agentId },
           ...data2?.scope && { scope: data2.scope },
           ...data2?.permissions && { permissions: data2.permissions },
@@ -1169,7 +1200,13 @@ var NeusClient = class {
           ...data2?.receiptDisclosure && { receiptDisclosure: data2.receiptDisclosure },
           ...data2?.expiresAt && { expiresAt: data2.expiresAt },
           ...data2?.instructions && { instructions: data2.instructions },
-          ...data2?.skills && { skills: data2.skills }
+          ...data2?.skills && { skills: data2.skills },
+          ...data2?.model && { model: data2.model },
+          ...data2?.provider && { provider: data2.provider },
+          ...data2?.runtimePolicy && { runtimePolicy: data2.runtimePolicy },
+          ...data2?.allowedActions && { allowedActions: data2.allowedActions },
+          ...data2?.deniedActions && { deniedActions: data2.deniedActions },
+          ...data2?.approvalPolicy && { approvalPolicy: data2.approvalPolicy }
         };
       } else if (verifier === "ai-content-moderation") {
         if (!data2?.content) {
@@ -1388,19 +1425,17 @@ ${bytes.length}`;
     return this._formatResponse(response);
   }
   async getProof(qHash) {
-    const resolvedQHash = qHash;
-    if (!resolvedQHash || typeof resolvedQHash !== "string") {
+    if (!qHash || typeof qHash !== "string") {
       throw new ValidationError("qHash is required");
     }
-    const response = await this._makeRequest("GET", `/api/v1/proofs/${resolvedQHash}`);
+    const response = await this._makeRequest("GET", `/api/v1/proofs/${qHash}`);
     if (!response.success) {
       throw new ApiError(`Failed to get proof: ${response.error?.message || "Unknown error"}`, response.error);
     }
     return this._formatResponse(response);
   }
   async getPrivateProof(qHash, wallet = null) {
-    const resolvedQHash = qHash;
-    if (!resolvedQHash || typeof resolvedQHash !== "string") {
+    if (!qHash || typeof qHash !== "string") {
       throw new ValidationError("qHash is required");
     }
     const isPreSignedAuth = wallet && typeof wallet === "object" && typeof wallet.walletAddress === "string" && typeof wallet.signature === "string" && typeof wallet.signedTimestamp === "number";
@@ -1413,7 +1448,7 @@ ${bytes.length}`;
         ...typeof auth.chain === "string" && auth.chain.trim() ? { "x-chain": auth.chain.trim() } : {},
         ...typeof auth.signatureMethod === "string" && auth.signatureMethod.trim() ? { "x-signature-method": auth.signatureMethod.trim() } : {}
       };
-      const response2 = await this._makeRequest("GET", `/api/v1/proofs/${resolvedQHash}`, null, headers);
+      const response2 = await this._makeRequest("GET", `/api/v1/proofs/${qHash}`, null, headers);
       if (!response2.success) {
         throw new ApiError(
           `Failed to access private proof: ${response2.error?.message || "Unauthorized"}`,
@@ -1434,7 +1469,7 @@ ${bytes.length}`;
     const message = constructVerificationMessage({
       walletAddress,
       signedTimestamp,
-      data: { action: "access_private_proof", qHash: resolvedQHash },
+      data: { action: "access_private_proof", qHash },
       verifierIds: ["ownership-basic"],
       ...signerIsEvm ? { chainId: this._getHubChainId() } : { chain }
     });
@@ -1452,7 +1487,7 @@ ${bytes.length}`;
       }
       throw new ValidationError(`Failed to sign message: ${error.message}`);
     }
-    const response = await this._makeRequest("GET", `/api/v1/proofs/${resolvedQHash}`, null, {
+    const response = await this._makeRequest("GET", `/api/v1/proofs/${qHash}`, null, {
       "x-wallet-address": walletAddress,
       "x-signature": signature,
       "x-signed-timestamp": signedTimestamp.toString(),
@@ -1490,20 +1525,19 @@ ${bytes.length}`;
     };
   }
   async pollProofStatus(qHash, options = {}) {
-    const resolvedQHash = qHash;
     const {
       interval = 5e3,
       timeout = 12e4,
       onProgress
     } = options;
-    if (!resolvedQHash || typeof resolvedQHash !== "string") {
+    if (!qHash || typeof qHash !== "string") {
       throw new ValidationError("qHash is required");
     }
     const startTime = Date.now();
     let consecutiveRateLimits = 0;
     while (Date.now() - startTime < timeout) {
       try {
-        const status = await this.getProof(resolvedQHash);
+        const status = await this.getProof(qHash);
         consecutiveRateLimits = 0;
         if (onProgress && typeof onProgress === "function") {
           onProgress(status.data || status);
@@ -1546,8 +1580,7 @@ ${bytes.length}`;
     }
   }
   async revokeOwnProof(qHash, wallet) {
-    const resolvedQHash = qHash;
-    if (!resolvedQHash || typeof resolvedQHash !== "string") {
+    if (!qHash || typeof qHash !== "string") {
       throw new ValidationError("qHash is required");
     }
     const providerWallet = wallet || this._getDefaultBrowserWallet();
@@ -1562,7 +1595,7 @@ ${bytes.length}`;
     const message = constructVerificationMessage({
       walletAddress: address,
       signedTimestamp,
-      data: { action: "revoke_proof", qHash: resolvedQHash },
+      data: { action: "revoke_proof", qHash },
       verifierIds: ["ownership-basic"],
       ...signerIsEvm ? { chainId: this._getHubChainId() } : { chain }
     });
@@ -1580,7 +1613,7 @@ ${bytes.length}`;
       }
       throw new ValidationError(`Failed to sign revocation: ${error.message}`);
     }
-    const res = await this._makeRequest("POST", `/api/v1/proofs/revoke-self/${resolvedQHash}`, {
+    const res = await this._makeRequest("POST", `/api/v1/proofs/revoke-self/${qHash}`, {
       walletAddress: address,
       signature,
       signedTimestamp,
@@ -1987,10 +2020,7 @@ ${bytes.length}`;
     }
   }
   _formatResponse(response) {
-    const qHash = response?.data?.qHash || response?.qHash || response?.data?.resource?.qHash || response?.data?.proofId || // Legacy input compatibility only. Do not expose or store proofId.
-    response?.proofId || // Legacy input compatibility only. Do not expose or store proofId.
-    response?.data?.resource?.proofId || // Legacy input compatibility only. Do not expose or store proofId.
-    response?.data?.id;
+    const qHash = response?.data?.qHash || response?.qHash || response?.data?.resource?.qHash || response?.data?.id;
     const status = response?.data?.status || response?.status || response?.data?.resource?.status || (response?.success ? "completed" : "unknown");
     return {
       success: response.success,

package/cjs/index.cjs

@@ -1283,6 +1283,17 @@ var init_client = __esm({
           if (data.agentType && !["ai", "bot", "service", "automation", "agent"].includes(data.agentType)) {
             return { valid: false, error: "agentType must be one of: ai, bot, service, automation, agent" };
           }
+          if (data.defaultRuntime && typeof data.defaultRuntime === "object") {
+            if (data.defaultRuntime.provider && typeof data.defaultRuntime.provider === "string" && data.defaultRuntime.provider.length > 64) {
+              return { valid: false, error: "defaultRuntime.provider must be 64 chars or less" };
+            }
+            if (data.defaultRuntime.model && typeof data.defaultRuntime.model === "string" && data.defaultRuntime.model.length > 128) {
+              return { valid: false, error: "defaultRuntime.model must be 128 chars or less" };
+            }
+            if (data.defaultRuntime.mode && typeof data.defaultRuntime.mode === "string" && data.defaultRuntime.mode.length > 64) {
+              return { valid: false, error: "defaultRuntime.mode must be 64 chars or less" };
+            }
+          }
           break;
         case "agent-delegation":
           if (!data.controllerWallet || !validateWalletAddress(data.controllerWallet)) {
@@ -1297,6 +1308,18 @@ var init_client = __esm({
           if (data.expiresAt && (typeof data.expiresAt !== "number" || data.expiresAt < Date.now())) {
             return { valid: false, error: "expiresAt must be a future timestamp" };
           }
+          if (data.model && typeof data.model === "string" && data.model.length > 128) {
+            return { valid: false, error: "model must be 128 chars or less" };
+          }
+          if (data.provider && typeof data.provider === "string" && data.provider.length > 64) {
+            return { valid: false, error: "provider must be 64 chars or less" };
+          }
+          if (data.allowedActions && Array.isArray(data.allowedActions) && data.allowedActions.length > 32) {
+            return { valid: false, error: "allowedActions must have 32 items or less" };
+          }
+          if (data.deniedActions && Array.isArray(data.deniedActions) && data.deniedActions.length > 32) {
+            return { valid: false, error: "deniedActions must have 32 items or less" };
+          }
           break;
         case "ai-content-moderation":
           if (!data.content || typeof data.content !== "string") {
@@ -1830,9 +1853,13 @@ var init_client = __esm({
             verificationData = {
               agentId: data2.agentId,
               agentWallet: data2?.agentWallet || walletAddress2,
+              ...data2?.agentChainRef && { agentChainRef: data2.agentChainRef },
+              ...data2?.agentAccountId && { agentAccountId: data2.agentAccountId },
               ...data2?.agentLabel && { agentLabel: data2.agentLabel },
               ...data2?.agentType && { agentType: data2.agentType },
+              ...data2?.avatar && { avatar: data2.avatar },
               ...data2?.description && { description: data2.description },
+              ...data2?.defaultRuntime && { defaultRuntime: data2.defaultRuntime },
               ...data2?.capabilities && { capabilities: data2.capabilities },
               ...data2?.instructions && { instructions: data2.instructions },
               ...data2?.skills && { skills: data2.skills },
@@ -1844,7 +1871,11 @@ var init_client = __esm({
             }
             verificationData = {
               controllerWallet: data2?.controllerWallet || walletAddress2,
+              ...data2?.controllerChainRef && { controllerChainRef: data2.controllerChainRef },
               agentWallet: data2.agentWallet,
+              ...data2?.agentChainRef && { agentChainRef: data2.agentChainRef },
+              ...data2?.controllerAccountId && { controllerAccountId: data2.controllerAccountId },
+              ...data2?.agentAccountId && { agentAccountId: data2.agentAccountId },
               ...data2?.agentId && { agentId: data2.agentId },
               ...data2?.scope && { scope: data2.scope },
               ...data2?.permissions && { permissions: data2.permissions },
@@ -1853,7 +1884,13 @@ var init_client = __esm({
               ...data2?.receiptDisclosure && { receiptDisclosure: data2.receiptDisclosure },
               ...data2?.expiresAt && { expiresAt: data2.expiresAt },
               ...data2?.instructions && { instructions: data2.instructions },
-              ...data2?.skills && { skills: data2.skills }
+              ...data2?.skills && { skills: data2.skills },
+              ...data2?.model && { model: data2.model },
+              ...data2?.provider && { provider: data2.provider },
+              ...data2?.runtimePolicy && { runtimePolicy: data2.runtimePolicy },
+              ...data2?.allowedActions && { allowedActions: data2.allowedActions },
+              ...data2?.deniedActions && { deniedActions: data2.deniedActions },
+              ...data2?.approvalPolicy && { approvalPolicy: data2.approvalPolicy }
             };
           } else if (verifier === "ai-content-moderation") {
             if (!data2?.content) {
@@ -2072,19 +2109,17 @@ ${bytes.length}`;
         return this._formatResponse(response);
       }
       async getProof(qHash) {
-        const resolvedQHash = qHash;
-        if (!resolvedQHash || typeof resolvedQHash !== "string") {
+        if (!qHash || typeof qHash !== "string") {
           throw new ValidationError("qHash is required");
         }
-        const response = await this._makeRequest("GET", `/api/v1/proofs/${resolvedQHash}`);
+        const response = await this._makeRequest("GET", `/api/v1/proofs/${qHash}`);
         if (!response.success) {
           throw new ApiError(`Failed to get proof: ${response.error?.message || "Unknown error"}`, response.error);
         }
         return this._formatResponse(response);
       }
       async getPrivateProof(qHash, wallet = null) {
-        const resolvedQHash = qHash;
-        if (!resolvedQHash || typeof resolvedQHash !== "string") {
+        if (!qHash || typeof qHash !== "string") {
           throw new ValidationError("qHash is required");
         }
         const isPreSignedAuth = wallet && typeof wallet === "object" && typeof wallet.walletAddress === "string" && typeof wallet.signature === "string" && typeof wallet.signedTimestamp === "number";
@@ -2097,7 +2132,7 @@ ${bytes.length}`;
             ...typeof auth.chain === "string" && auth.chain.trim() ? { "x-chain": auth.chain.trim() } : {},
             ...typeof auth.signatureMethod === "string" && auth.signatureMethod.trim() ? { "x-signature-method": auth.signatureMethod.trim() } : {}
           };
-          const response2 = await this._makeRequest("GET", `/api/v1/proofs/${resolvedQHash}`, null, headers);
+          const response2 = await this._makeRequest("GET", `/api/v1/proofs/${qHash}`, null, headers);
           if (!response2.success) {
             throw new ApiError(
               `Failed to access private proof: ${response2.error?.message || "Unauthorized"}`,
@@ -2118,7 +2153,7 @@ ${bytes.length}`;
         const message = constructVerificationMessage({
           walletAddress,
           signedTimestamp,
-          data: { action: "access_private_proof", qHash: resolvedQHash },
+          data: { action: "access_private_proof", qHash },
           verifierIds: ["ownership-basic"],
           ...signerIsEvm ? { chainId: this._getHubChainId() } : { chain }
         });
@@ -2136,7 +2171,7 @@ ${bytes.length}`;
           }
           throw new ValidationError(`Failed to sign message: ${error.message}`);
         }
-        const response = await this._makeRequest("GET", `/api/v1/proofs/${resolvedQHash}`, null, {
+        const response = await this._makeRequest("GET", `/api/v1/proofs/${qHash}`, null, {
           "x-wallet-address": walletAddress,
           "x-signature": signature,
           "x-signed-timestamp": signedTimestamp.toString(),
@@ -2174,20 +2209,19 @@ ${bytes.length}`;
         };
       }
       async pollProofStatus(qHash, options = {}) {
-        const resolvedQHash = qHash;
         const {
           interval = 5e3,
           timeout = 12e4,
           onProgress
         } = options;
-        if (!resolvedQHash || typeof resolvedQHash !== "string") {
+        if (!qHash || typeof qHash !== "string") {
           throw new ValidationError("qHash is required");
         }
         const startTime = Date.now();
         let consecutiveRateLimits = 0;
         while (Date.now() - startTime < timeout) {
           try {
-            const status = await this.getProof(resolvedQHash);
+            const status = await this.getProof(qHash);
             consecutiveRateLimits = 0;
             if (onProgress && typeof onProgress === "function") {
               onProgress(status.data || status);
@@ -2230,8 +2264,7 @@ ${bytes.length}`;
         }
       }
       async revokeOwnProof(qHash, wallet) {
-        const resolvedQHash = qHash;
-        if (!resolvedQHash || typeof resolvedQHash !== "string") {
+        if (!qHash || typeof qHash !== "string") {
           throw new ValidationError("qHash is required");
         }
         const providerWallet = wallet || this._getDefaultBrowserWallet();
@@ -2246,7 +2279,7 @@ ${bytes.length}`;
         const message = constructVerificationMessage({
           walletAddress: address,
           signedTimestamp,
-          data: { action: "revoke_proof", qHash: resolvedQHash },
+          data: { action: "revoke_proof", qHash },
           verifierIds: ["ownership-basic"],
           ...signerIsEvm ? { chainId: this._getHubChainId() } : { chain }
         });
@@ -2264,7 +2297,7 @@ ${bytes.length}`;
           }
           throw new ValidationError(`Failed to sign revocation: ${error.message}`);
         }
-        const res = await this._makeRequest("POST", `/api/v1/proofs/revoke-self/${resolvedQHash}`, {
+        const res = await this._makeRequest("POST", `/api/v1/proofs/revoke-self/${qHash}`, {
           walletAddress: address,
           signature,
           signedTimestamp,
@@ -2671,10 +2704,7 @@ ${bytes.length}`;
         }
       }
       _formatResponse(response) {
-        const qHash = response?.data?.qHash || response?.qHash || response?.data?.resource?.qHash || response?.data?.proofId || // Legacy input compatibility only. Do not expose or store proofId.
-        response?.proofId || // Legacy input compatibility only. Do not expose or store proofId.
-        response?.data?.resource?.proofId || // Legacy input compatibility only. Do not expose or store proofId.
-        response?.data?.id;
+        const qHash = response?.data?.qHash || response?.qHash || response?.data?.resource?.qHash || response?.data?.id;
         const status = response?.data?.status || response?.status || response?.data?.resource?.status || (response?.success ? "completed" : "unknown");
         return {
           success: response.success,