@neus/sdk 1.0.12 → 1.1.0

package/client.js

@@ -239,6 +239,17 @@ const 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)) {
@@ -253,6 +264,18 @@ const 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') {
@@ -457,12 +480,12 @@ export class NeusClient {
     throw new ConfigurationError('Invalid wallet provider');
   }
 
-  _getDefaultBrowserWallet() {
-    if (typeof window === 'undefined') return null;
-    // Legacy convenience fallback only. Non-EVM wallets must be passed explicitly
-    // with CAIP-2 chain context so the SDK does not route them through EVM RPC.
-    return window.ethereum || null;
-  }
+  _getDefaultBrowserWallet() {
+    if (typeof window === 'undefined') return null;
+    // Legacy convenience fallback only. Non-EVM wallets must be passed explicitly
+    // with CAIP-2 chain context so the SDK does not route them through EVM RPC.
+    return window.ethereum || null;
+  }
 
   async _buildPrivateGateAuth({ address, wallet, chain, signatureMethod } = {}) {
     const providerWallet = wallet || this._getDefaultBrowserWallet();
@@ -732,10 +755,10 @@ export class NeusClient {
             walletAddress = Array.isArray(accounts) && accounts.length > 0 ? accounts[0] : null;
           }
         }
-      } else {
-        if (typeof window === 'undefined' || !window.ethereum) {
-          throw new ConfigurationError('No EVM browser wallet detected. Provide wallet explicitly for non-EVM flows and include chain as a CAIP-2 value.');
-        }
+      } else {
+        if (typeof window === 'undefined' || !window.ethereum) {
+          throw new ConfigurationError('No EVM browser wallet detected. Provide wallet explicitly for non-EVM flows and include chain as a CAIP-2 value.');
+        }
         await window.ethereum.request({ method: 'eth_requestAccounts' });
         provider = window.ethereum;
         const accounts = await provider.request({ method: 'eth_accounts' });
@@ -852,9 +875,13 @@ export class NeusClient {
         verificationData = {
           agentId: data.agentId,
           agentWallet: data?.agentWallet || walletAddress,
+          ...(data?.agentChainRef && { agentChainRef: data.agentChainRef }),
+          ...(data?.agentAccountId && { agentAccountId: data.agentAccountId }),
           ...(data?.agentLabel && { agentLabel: data.agentLabel }),
           ...(data?.agentType && { agentType: data.agentType }),
+          ...(data?.avatar && { avatar: data.avatar }),
           ...(data?.description && { description: data.description }),
+          ...(data?.defaultRuntime && { defaultRuntime: data.defaultRuntime }),
           ...(data?.capabilities && { capabilities: data.capabilities }),
           ...(data?.instructions && { instructions: data.instructions }),
           ...(data?.skills && { skills: data.skills }),
@@ -866,7 +893,11 @@ export class NeusClient {
         }
         verificationData = {
           controllerWallet: data?.controllerWallet || walletAddress,
+          ...(data?.controllerChainRef && { controllerChainRef: data.controllerChainRef }),
           agentWallet: data.agentWallet,
+          ...(data?.agentChainRef && { agentChainRef: data.agentChainRef }),
+          ...(data?.controllerAccountId && { controllerAccountId: data.controllerAccountId }),
+          ...(data?.agentAccountId && { agentAccountId: data.agentAccountId }),
           ...(data?.agentId && { agentId: data.agentId }),
           ...(data?.scope && { scope: data.scope }),
           ...(data?.permissions && { permissions: data.permissions }),
@@ -875,7 +906,13 @@ export class NeusClient {
           ...(data?.receiptDisclosure && { receiptDisclosure: data.receiptDisclosure }),
           ...(data?.expiresAt && { expiresAt: data.expiresAt }),
           ...(data?.instructions && { instructions: data.instructions }),
-          ...(data?.skills && { skills: data.skills })
+          ...(data?.skills && { skills: data.skills }),
+          ...(data?.model && { model: data.model }),
+          ...(data?.provider && { provider: data.provider }),
+          ...(data?.runtimePolicy && { runtimePolicy: data.runtimePolicy }),
+          ...(data?.allowedActions && { allowedActions: data.allowedActions }),
+          ...(data?.deniedActions && { deniedActions: data.deniedActions }),
+          ...(data?.approvalPolicy && { approvalPolicy: data.approvalPolicy })
         };
       } else if (verifier === 'ai-content-moderation') {
         if (!data?.content) {
@@ -1120,11 +1157,10 @@ export class NeusClient {
   }
 
   async getProof(qHash) {
-    const resolvedQHash = qHash; // Legacy input compatibility only. Do not expose or store proofId.
-    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);
@@ -1134,8 +1170,7 @@ export class NeusClient {
   }
 
   async getPrivateProof(qHash, wallet = null) {
-    const resolvedQHash = qHash; // Legacy input compatibility only. Do not expose or store proofId.
-    if (!resolvedQHash || typeof resolvedQHash !== 'string') {
+    if (!qHash || typeof qHash !== 'string') {
       throw new ValidationError('qHash is required');
     }
 
@@ -1153,7 +1188,7 @@ export class NeusClient {
         ...(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 response = await this._makeRequest('GET', `/api/v1/proofs/${resolvedQHash}`, null, headers);
+      const response = await this._makeRequest('GET', `/api/v1/proofs/${qHash}`, null, headers);
       if (!response.success) {
         throw new ApiError(
           `Failed to access private proof: ${response.error?.message || 'Unauthorized'}`,
@@ -1177,7 +1212,7 @@ export class NeusClient {
     const message = constructVerificationMessage({
       walletAddress,
       signedTimestamp,
-      data: { action: 'access_private_proof', qHash: resolvedQHash },
+      data: { action: 'access_private_proof', qHash: qHash },
       verifierIds: ['ownership-basic'],
       ...(signerIsEvm ? { chainId: this._getHubChainId() } : { chain })
     });
@@ -1197,7 +1232,7 @@ export class NeusClient {
       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(),
@@ -1247,14 +1282,13 @@ export class NeusClient {
   }
 
   async pollProofStatus(qHash, options = {}) {
-    const resolvedQHash = qHash; // Legacy input compatibility only. Do not expose or store proofId.
     const {
       interval = 5000,
       timeout = 120000,
       onProgress
     } = options;
 
-    if (!resolvedQHash || typeof resolvedQHash !== 'string') {
+    if (!qHash || typeof qHash !== 'string') {
       throw new ValidationError('qHash is required');
     }
 
@@ -1263,7 +1297,7 @@ export class NeusClient {
 
     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') {
@@ -1316,8 +1350,7 @@ export class NeusClient {
   }
 
   async revokeOwnProof(qHash, wallet) {
-    const resolvedQHash = qHash; // Legacy input compatibility only. Do not expose or store proofId.
-    if (!resolvedQHash || typeof resolvedQHash !== 'string') {
+    if (!qHash || typeof qHash !== 'string') {
       throw new ValidationError('qHash is required');
     }
     const providerWallet = wallet || this._getDefaultBrowserWallet();
@@ -1333,7 +1366,7 @@ export class NeusClient {
     const message = constructVerificationMessage({
       walletAddress: address,
       signedTimestamp,
-      data: { action: 'revoke_proof', qHash: resolvedQHash },
+      data: { action: 'revoke_proof', qHash: qHash },
       verifierIds: ['ownership-basic'],
       ...(signerIsEvm ? { chainId: this._getHubChainId() } : { chain })
     });
@@ -1353,7 +1386,7 @@ export class NeusClient {
       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,
@@ -1848,9 +1881,6 @@ export class NeusClient {
     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 status = response?.data?.status ||

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neus/sdk",
-  "version": "1.0.12",
+  "version": "1.1.0",
   "description": "NEUS makes trust portable across the internet — so people, apps, and AI agents can prove what is real before access, payout, or execution.",
   "bin": {
     "neus": "cli/neus.mjs"
@@ -67,7 +67,10 @@
     "universal-protocol",
     "proof",
     "ownership",
-    "sdk"
+    "sdk",
+    "mcp",
+    "model-context-protocol",
+    "oauth"
   ],
   "author": "NEUS Network",
   "license": "Apache-2.0",
@@ -80,6 +83,10 @@
     "url": "https://github.com/neus/network/issues"
   },
   "homepage": "https://neus.network",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
   "engines": {
     "node": ">=20.0.0"
   },
@@ -124,6 +131,7 @@
     "widgets.cjs",
     "types.d.ts",
     "README.md",
+    "CHANGELOG.md",
     "SECURITY.md",
     "LICENSE",
     "neus-logo.svg",

package/types.d.ts

@@ -81,8 +81,12 @@ declare module '@neus/sdk' {
   export interface VerifierCatalogMetadataEntry {
     category?: string;
     description?: string;
+    accessLevel?: 'public' | 'pro' | 'custom' | 'admin' | string;
     flowType?: 'instant' | 'interactive' | 'external_lookup' | string;
     expiryType?: 'permanent' | 'point_in_time' | 'expiring' | string;
+    allowsDelegatedSubject?: boolean;
+    compatibleWith?: string[];
+    conflictsWith?: string[];
     supportsDirectApi?: boolean;
     supportsHostedVerify?: boolean;
     dataSchema?: Record<string, any>;
@@ -599,6 +603,8 @@ declare module '@neus/sdk' {
         | 'doc'
         | 'media'
         | 'username-claim'
+        | 'job'
+        | 'job-status'
         | 'other';
       id?: string;
       title?: string;
@@ -646,7 +652,8 @@ declare module '@neus/sdk' {
     contractAddress: string;
     tokenId: string;
     tokenType?: 'erc721' | 'erc1155';
-    chainId: number;
+    chainId?: number;
+    chain?: string;
     blockNumber?: number;
     [key: string]: any;
   };
@@ -655,24 +662,29 @@ declare module '@neus/sdk' {
     ownerAddress?: string;
     contractAddress: string;
     minBalance: string;
-    chainId: number;
+    chainId?: number;
+    chain?: string;
     blockNumber?: number;
     [key: string]: any;
   };
 
   type WalletRiskData = {
+    walletAddress: string;
     provider?: string;
-    walletAddress?: string;
     chainId?: number;
-    includeDetails?: boolean;
+    chain?: string;
     [key: string]: any;
   };
 
   type WalletLinkData = {
-    primaryWalletAddress: string;
-    secondaryWalletAddress: string;
+    primaryWalletAddress?: string;
+    secondaryWalletAddress?: string;
+    primaryAccountId?: string;
+    secondaryAccountId?: string;
+    primaryChainRef?: string;
+    secondaryChainRef?: string;
     signature: string;
-    chain: string;
+    chain?: string;
     signatureMethod: string;
     signedTimestamp: number;
     relationshipType?: 'primary' | 'personal' | 'org' | 'affiliate' | 'agent' | 'linked';
@@ -696,36 +708,70 @@ declare module '@neus/sdk' {
     [key: string]: any;
   };
 
+  type AgentSkillRef = {
+    id: string;
+    label?: string;
+    version?: string;
+    provider?: string;
+    kind?: 'native' | 'integration' | 'plugin' | 'mcp' | 'toolkit';
+    configId?: string;
+    enabled?: boolean;
+  };
+
   type AgentIdentityData = {
     agentId: string;
     agentWallet: string;
+    agentChainRef: string;
+    agentAccountId?: string;
     agentLabel?: string;
     agentType?: 'ai' | 'bot' | 'service' | 'automation' | 'agent';
+    avatar?: string;
     description?: string;
-    capabilities?: any[];
+    defaultRuntime?: {
+      provider?: string;
+      model?: string;
+      mode?: string;
+    };
+    capabilities?: Record<string, boolean>;
     instructions?: string;
-    skills?: string[];
+    skills?: AgentSkillRef[];
     services?: Array<{
       name: string;
       endpoint: string;
       version?: string;
     }>;
-    [key: string]: any;
   };
 
   type AgentDelegationData = {
     controllerWallet: string;
+    controllerChainRef: string;
     agentWallet: string;
+    agentChainRef: string;
+    controllerAccountId?: string;
+    agentAccountId?: string;
     agentId?: string;
     scope?: string;
-    permissions?: any[];
+    permissions?: string[];
     maxSpend?: string;
     allowedPaymentTypes?: string[];
     receiptDisclosure?: 'none' | 'summary' | 'full';
     expiresAt?: number;
     instructions?: string;
-    skills?: string[];
-    [key: string]: any;
+    skills?: AgentSkillRef[];
+    model?: string;
+    provider?: string;
+    runtimePolicy?: {
+      allowedProviders?: string[];
+      allowedModelClasses?: string[];
+      requiresHumanApproval?: boolean;
+      secretsExposedToReceipt?: boolean;
+    };
+    allowedActions?: string[];
+    deniedActions?: string[];
+    approvalPolicy?: {
+      humanApprovalRequiredForNewClaims?: boolean;
+      preApprovedContentOnly?: boolean;
+    };
   };
 
   type CoreVerificationData =
@@ -785,6 +831,8 @@ declare module '@neus/sdk' {
         | 'doc'
         | 'media'
         | 'username-claim'
+        | 'job'
+        | 'job-status'
         | 'other';
       id?: string;
       title?: string;

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

@@ -28,7 +28,7 @@ var NeusLogo = ({ size = 12, logoUrl }) => /* @__PURE__ */ jsx(
   }
 );
 function ProofBadge({
-  qHash: qHashProp,
+  qHash,
   proofUrlPattern = "/proof/:qHash",
   size = "sm",
   uiLinkBase = "https://neus.network",
@@ -38,10 +38,8 @@ function ProofBadge({
   showLabel = true,
   logoUrl = void 0,
   onClick = void 0,
-  className = "",
-  ...legacyProps
+  className = ""
 }) {
-  const qHash = qHashProp ?? legacyProps.proofId;
   const resolvedQHash = qHash;
   const [status, setStatus] = useState(() => {
     if (proof) {
@@ -149,7 +147,7 @@ function ProofBadge({
   );
 }
 function SimpleProofBadge({
-  qHash: qHashProp,
+  qHash,
   proofUrlPattern = "/proof/:qHash",
   uiLinkBase = "https://neus.network",
   apiUrl = DEFAULT_API_BASE,
@@ -158,10 +156,8 @@ function SimpleProofBadge({
   logoUrl = void 0,
   proof = void 0,
   onClick = void 0,
-  className = "",
-  ...legacyProps
+  className = ""
 }) {
-  const qHash = qHashProp ?? legacyProps.proofId;
   const resolvedQHash = qHash;
   const [status, setStatus] = useState(() => {
     if (proof) {
@@ -244,17 +240,15 @@ function SimpleProofBadge({
   );
 }
 function NeusPillLink({
-  qHash: qHashProp,
+  qHash,
   proofUrlPattern = "/proof/:qHash",
   uiLinkBase = "https://neus.network",
   label = "View",
   size = "sm",
   logoUrl = void 0,
   onClick = void 0,
-  className = "",
-  ...legacyProps
+  className = ""
 }) {
-  const qHash = qHashProp ?? legacyProps.proofId;
   const resolvedQHash = qHash;
   const base = String(uiLinkBase).replace(/\/$/, "");
   const href = resolvedQHash ? `${base}${String(proofUrlPattern).replace(":qHash", resolvedQHash)}` : base;
@@ -304,17 +298,15 @@ function NeusPillLink({
   );
 }
 function VerifiedIcon({
-  qHash: qHashProp,
+  qHash,
   proofUrlPattern = "/proof/:qHash",
   uiLinkBase = "https://neus.network",
   size = 14,
   logoUrl = void 0,
   tooltip = "Proof",
   onClick = void 0,
-  className = "",
-  ...legacyProps
+  className = ""
 }) {
-  const qHash = qHashProp ?? legacyProps.proofId;
   const resolvedQHash = qHash;
   const href = resolvedQHash ? `${String(uiLinkBase).replace(/\/$/, "")}${String(proofUrlPattern).replace(":qHash", resolvedQHash)}` : void 0;
   const handleClick = (e) => {

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

@@ -124,11 +124,10 @@ function getVerifyGateUserError(err) {
   }
   return null;
 }
-function dispatchNeusProofCreatedForHost({ qHash, walletAddress, ...legacyInput }) {
+function dispatchNeusProofCreatedForHost({ qHash, walletAddress }) {
   try {
     if (typeof window === "undefined") return;
-    const raw = typeof qHash === "string" && qHash.trim() || typeof legacyInput.proofId === "string" && legacyInput.proofId.trim() || // Legacy input compatibility only. Do not expose or store proofId.
-    "";
+    const raw = typeof qHash === "string" ? qHash.trim() : "";
     if (!raw) return;
     const w = typeof walletAddress === "string" ? walletAddress.trim() : "";
     const normalizedWallet = w && /^0x[a-fA-F0-9]{40}$/.test(w) ? w.toLowerCase() : w;
@@ -211,8 +210,7 @@ function VerifyGate({
   onError = void 0,
   wallet = void 0,
   chain = void 0,
-  signatureMethod = void 0,
-  ...legacyProps
+  signatureMethod = void 0
 }) {
   const [state, setState] = useState("idle");
   const [error, setError] = useState(null);
@@ -229,7 +227,7 @@ function VerifyGate({
     return Array.isArray(requiredVerifiers) && requiredVerifiers.length > 0 ? requiredVerifiers : ["ownership-basic"];
   }, [requiredVerifiers]);
   const primaryVerifier = verifierList[0];
-  const qHash = qHashProp || legacyProps.proofId || null;
+  const qHash = qHashProp || null;
   const resolvedQHash = qHash;
   const hasInteractiveVerifier = useMemo(
     () => verifierList.some((verifierId) => {
@@ -277,7 +275,7 @@ function VerifyGate({
     setExistingProofs(gateResult);
     const existingProof = gateResult.existing?.[primaryVerifier];
     if (existingProof && onVerified) {
-      const existingQHash = existingProof.qHash || existingProof.proofId || null;
+      const existingQHash = existingProof.qHash || null;
       onVerified({
         qHash: existingQHash,
         address: existingProof.walletAddress || address,
@@ -546,7 +544,7 @@ function VerifyGate({
           setState("interactive-checkout");
           onStateChange?.("interactive-checkout");
           const checkoutResult = await launchHostedCheckout();
-          const checkoutQHash = checkoutResult?.qHash || checkoutResult?.proofId || null;
+          const checkoutQHash = checkoutResult?.qHash || null;
           const handoffWallet = typeof checkoutResult?.walletAddress === "string" && checkoutResult.walletAddress.trim() || walletAddress && String(walletAddress).trim() || "";
           setState("verified");
           dispatchNeusProofCreatedForHost({
@@ -611,7 +609,7 @@ function VerifyGate({
             wallet: wallet || (typeof window !== "undefined" ? window.ethereum : void 0)
           });
           setState("verifying");
-          const qHashToCheck = created.qHash || created.proofId || created?.data?.qHash || created?.data?.proofId;
+          const qHashToCheck = created.qHash || created?.data?.qHash;
           const final = await client.pollProofStatus(qHashToCheck, { interval: 3e3, timeout: 6e4 });
           const verifiedVerifiers = final?.data?.verifiedVerifiers || [];
           const verifierResult = verifiedVerifiers.find((v) => v.verifierId === verifierId);
@@ -621,7 +619,7 @@ function VerifyGate({
           const hubTx = final?.data?.hubTransaction || {};
           const crosschain = final?.data?.crosschain || {};
           const txHash = hubTx?.txHash || crosschain?.hubTxHash || null;
-          const finalQHash = final?.qHash || final?.proofId || qHashToCheck;
+          const finalQHash = final?.qHash || qHashToCheck;
           return {
             verifierId,
             qHash: finalQHash,