@neus/sdk 1.0.12 → 1.1.1

package/gates.js

@@ -51,23 +51,3 @@ export function combineGates(...gates) {
 
   return combined;
 }
-
-export default {
-  HOUR,
-  DAY,
-  WEEK,
-  MONTH,
-  YEAR,
-  GATE_NFT_HOLDER,
-  GATE_TOKEN_HOLDER,
-  GATE_CONTRACT_ADMIN,
-  GATE_DOMAIN_OWNER,
-  GATE_LINKED_WALLETS,
-  GATE_AGENT_IDENTITY,
-  GATE_AGENT_DELEGATION,
-  GATE_CONTENT_MODERATION,
-  GATE_WALLET_RISK,
-  GATE_PSEUDONYM,
-  createGate,
-  combineGates
-};

package/index.js

@@ -55,6 +55,8 @@ export {
   combineGates
 } from './gates.js';
 
+export { fetchSponsorGrant } from './sponsor.js';
+
 export {
   SDKError,
   ApiError,

package/package.json

@@ -1,135 +1,142 @@
-{
-  "name": "@neus/sdk",
-  "version": "1.0.12",
-  "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"
-  },
-  "main": "index.js",
-  "type": "module",
-  "types": "types.d.ts",
-  "exports": {
-    ".": {
-      "types": "./types.d.ts",
-      "import": "./index.js",
-      "require": "./cjs/index.cjs"
-    },
-    "./client": {
-      "types": "./types.d.ts",
-      "import": "./client.js",
-      "require": "./cjs/client.cjs"
-    },
-    "./utils": {
-      "import": "./utils.js",
-      "require": "./cjs/utils.cjs"
-    },
-    "./errors": {
-      "import": "./errors.js",
-      "require": "./cjs/errors.cjs"
-    },
-    "./gates": {
-      "import": "./gates.js",
-      "require": "./cjs/gates.cjs"
-    },
-    "./widgets": {
-      "types": "./types.d.ts",
-      "import": "./widgets/index.js",
-      "require": "./widgets.cjs"
-    },
-    "./widgets/verify-gate": {
-      "types": "./types.d.ts",
-      "import": "./widgets/verify-gate/index.js",
-      "require": "./widgets.cjs"
-    }
-  },
-  "sideEffects": false,
-  "scripts": {
-    "test": "npm run build:cjs && vitest run",
-    "test:coverage": "vitest run --coverage",
-    "lint": "eslint . --ignore-pattern widgets/verify-gate/dist/**",
-    "format": "prettier --write \"**/*.js\"",
-    "build": "npm run build:widgets && npm run build:cjs",
-    "build:widgets": "npx esbuild widgets/verify-gate/VerifyGate.jsx widgets/verify-gate/ProofBadge.jsx --bundle --platform=browser --format=esm --outdir=widgets/verify-gate/dist --jsx=automatic --legal-comments=none --loader:.svg=dataurl --external:react --external:react-dom --external:react/jsx-runtime --external:@neus/sdk/client",
-    "build:cjs": "npx esbuild index.js client.js utils.js errors.js gates.js --bundle --platform=node --format=cjs --outdir=cjs --out-extension:.js=.cjs --legal-comments=none --external:ethers --external:@zkpassport/sdk --external:react --external:react-dom --external:react/jsx-runtime",
-    "prepack": "npm run build",
-    "prepublishOnly": "npm run lint && npm test && npm run build"
-  },
-  "keywords": [
-    "neus",
-    "verification",
-    "cryptographic-proofs",
-    "identity",
-    "authentication",
-    "blockchain",
-    "cross-chain",
-    "web3",
-    "passwordless",
-    "universal-protocol",
-    "proof",
-    "ownership",
-    "sdk"
-  ],
-  "author": "NEUS Network",
-  "license": "Apache-2.0",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/neus/network.git",
-    "directory": "sdk"
-  },
-  "bugs": {
-    "url": "https://github.com/neus/network/issues"
-  },
-  "homepage": "https://neus.network",
-  "engines": {
-    "node": ">=20.0.0"
-  },
-  "peerDependencies": {
-    "ethers": "^6.0.0",
-    "react": ">=17.0.0",
-    "react-dom": ">=17.0.0"
-  },
-  "peerDependenciesMeta": {
-    "@zkpassport/sdk": {
-      "optional": true
-    },
-    "react": {
-      "optional": true
-    },
-    "react-dom": {
-      "optional": true
-    }
-  },
-  "optionalDependencies": {
-    "@zkpassport/sdk": "^0.14.0"
-  },
-  "dependencies": {
-    "bs58": "^6.0.0"
-  },
-  "devDependencies": {
-    "@vitest/coverage-v8": "^4.1.3",
-    "esbuild": "^0.28.0",
-    "eslint": "^8.56.0",
-    "eslint-plugin-react": "^7.37.2",
-    "prettier": "^3.2.0",
-    "vitest": "^4.1.3"
-  },
-  "files": [
-    "cli/neus.mjs",
-    "index.js",
-    "client.js",
-    "utils.js",
-    "errors.js",
-    "gates.js",
-    "cjs/**",
-    "widgets.cjs",
-    "types.d.ts",
-    "README.md",
-    "SECURITY.md",
-    "LICENSE",
-    "neus-logo.svg",
-    "widgets/index.js",
-    "widgets/verify-gate/index.js",
-    "widgets/verify-gate/dist/VerifyGate.js",
-    "widgets/verify-gate/dist/ProofBadge.js"
-  ]
-}
+{
+  "name": "@neus/sdk",
+  "version": "1.1.1",
+  "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"
+  },
+  "main": "index.js",
+  "type": "module",
+  "types": "types.d.ts",
+  "exports": {
+    ".": {
+      "types": "./types.d.ts",
+      "import": "./index.js",
+      "require": "./cjs/index.cjs"
+    },
+    "./client": {
+      "types": "./types.d.ts",
+      "import": "./client.js",
+      "require": "./cjs/client.cjs"
+    },
+    "./utils": {
+      "import": "./utils.js",
+      "require": "./cjs/utils.cjs"
+    },
+    "./errors": {
+      "import": "./errors.js",
+      "require": "./cjs/errors.cjs"
+    },
+    "./gates": {
+      "import": "./gates.js",
+      "require": "./cjs/gates.cjs"
+    },
+    "./widgets": {
+      "types": "./types.d.ts",
+      "import": "./widgets/index.js",
+      "require": "./widgets.cjs"
+    },
+    "./widgets/verify-gate": {
+      "types": "./types.d.ts",
+      "import": "./widgets/verify-gate/index.js",
+      "require": "./widgets.cjs"
+    }
+  },
+  "sideEffects": false,
+  "scripts": {
+    "test": "npm run build:cjs && vitest run",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint . --ignore-pattern widgets/verify-gate/dist/**",
+    "format": "prettier --write \"**/*.js\"",
+    "build": "npm run build:widgets && npm run build:cjs",
+    "build:widgets": "npx esbuild widgets/verify-gate/VerifyGate.jsx widgets/verify-gate/ProofBadge.jsx --bundle --platform=browser --format=esm --outdir=widgets/verify-gate/dist --jsx=automatic --legal-comments=none --loader:.svg=dataurl --external:react --external:react-dom --external:react/jsx-runtime --external:@neus/sdk/client",
+    "build:cjs": "npx esbuild index.js client.js utils.js errors.js gates.js --bundle --platform=node --format=cjs --outdir=cjs --out-extension:.js=.cjs --legal-comments=none --external:ethers --external:@zkpassport/sdk --external:react --external:react-dom --external:react/jsx-runtime",
+    "prepack": "npm run build",
+    "prepublishOnly": "npm run lint && npm test && npm run build"
+  },
+  "keywords": [
+    "neus",
+    "verification",
+    "cryptographic-proofs",
+    "identity",
+    "authentication",
+    "blockchain",
+    "cross-chain",
+    "web3",
+    "passwordless",
+    "universal-protocol",
+    "proof",
+    "ownership",
+    "sdk",
+    "mcp",
+    "model-context-protocol",
+    "oauth"
+  ],
+  "author": "NEUS Network",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/neus/network.git",
+    "directory": "sdk"
+  },
+  "bugs": {
+    "url": "https://github.com/neus/network/issues"
+  },
+  "homepage": "https://neus.network",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "peerDependencies": {
+    "ethers": "^6.0.0",
+    "react": ">=17.0.0",
+    "react-dom": ">=17.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@zkpassport/sdk": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    }
+  },
+  "optionalDependencies": {
+    "@zkpassport/sdk": "^0.14.0"
+  },
+  "dependencies": {
+    "bs58": "^6.0.0"
+  },
+  "devDependencies": {
+    "@vitest/coverage-v8": "^4.1.3",
+    "esbuild": "^0.28.0",
+    "eslint": "^8.56.0",
+    "eslint-plugin-react": "^7.37.2",
+    "prettier": "^3.2.0",
+    "vitest": "^4.1.3"
+  },
+  "files": [
+    "cli/neus.mjs",
+    "index.js",
+    "client.js",
+    "utils.js",
+    "errors.js",
+    "gates.js",
+    "sponsor.js",
+    "cjs/**",
+    "widgets.cjs",
+    "types.d.ts",
+    "README.md",
+    "SECURITY.md",
+    "LICENSE",
+    "widgets/index.js",
+    "widgets/verify-gate/index.js",
+    "widgets/verify-gate/dist/VerifyGate.js",
+    "widgets/verify-gate/dist/ProofBadge.js"
+  ]
+}

package/sponsor.js

@@ -0,0 +1,95 @@
+import { ValidationError, ApiError, NetworkError } from './errors.js';
+
+/**
+ * Request short-lived billing authorization so verification usage bills the app owner.
+ * Requires a completed app registration (`sponsor-grants` delegation) on orgWallet.
+ */
+export 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 {
+    void 0;
+  }
+
+  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
+  };
+}

package/types.d.ts

@@ -57,9 +57,18 @@ declare module '@neus/sdk' {
 
   export interface NeusClientConfig {
     apiUrl?: string;
+    /** Optional server profile key — MCP/CI only; not required for VerifyGate or gateCheck. */
     apiKey?: string;
+    /** Public app attribution id (non-secret). */
     appId?: string;
-    /** Optional: only when using legacy `delegationQHash` on verify requests. App-linked servers rely on `appId` + Origin + stored delegation. */
+    /** Hub wallet that pays for user verification checks (your NEUS account). */
+    billingWallet?: string;
+    /** Alias for billingWallet. */
+    sponsorOrgWallet?: string;
+    orgWallet?: string;
+    /** Site origin used when issuing billing authorization (defaults to browser origin). */
+    appOrigin?: string;
+    /** @deprecated Advanced server path only — use appId + billingWallet for the default app flow. */
     appLinkQHash?: string;
     paymentSignature?: string;
     extraHeaders?: Record<string, string>;
@@ -68,6 +77,26 @@ declare module '@neus/sdk' {
     enableLogging?: boolean;
   }
 
+  export interface FetchSponsorGrantParams {
+    apiUrl?: string;
+    appId: string;
+    orgWallet: string;
+    verifierIds?: string[];
+    targetChains?: number[];
+    origin?: string;
+    expiresInSeconds?: number;
+  }
+
+  export interface FetchSponsorGrantResult {
+    sponsorGrant: string;
+    exp?: number;
+    orgWallet: string;
+    appId: string;
+    maxCredits?: number;
+  }
+
+  export function fetchSponsorGrant(params: FetchSponsorGrantParams): Promise<FetchSponsorGrantResult>;
+
   export interface VerificationOptions {
     privacyLevel?: PrivacyLevel;
     enableIpfs?: boolean;
@@ -81,8 +110,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 +632,8 @@ declare module '@neus/sdk' {
         | 'doc'
         | 'media'
         | 'username-claim'
+        | 'job'
+        | 'job-status'
         | 'other';
       id?: string;
       title?: string;
@@ -646,7 +681,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 +691,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 +737,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 +860,8 @@ declare module '@neus/sdk' {
         | 'doc'
         | 'media'
         | 'username-claim'
+        | 'job'
+        | 'job-status'
         | 'other';
       id?: string;
       title?: string;

package/utils.js

@@ -1023,6 +1023,8 @@ export 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;
 }

package/widgets/README.md

@@ -35,7 +35,7 @@ export function Page() {
 ```jsx
 import { ProofBadge } from '@neus/sdk/widgets';
 
-<ProofBadge qHash="0x..." showChains />
+<ProofBadge qHash={proof.qHash} showChains />
 ```
 
 ## Docs