NEUS Docs | Portable Trust Infrastructure

Most products use Sell access or Hosted sign-in: VerifyGate or Hosted Verify, then gateCheck on the server with the visitor’s account address. Use this page only when your backend creates proofs directly, or when you automate NEUS as your own profile.

When you need this

Need	Use
Visitor verifies in the browser; you only check later	Sell access. No access key
Your server creates proofs for an approved user	`verifyFromApp` after one-time approval
MCP, CI, or raw HTTP as your NEUS profile	Profile access key (`npk_*`)

Backend proof creation (`verifyFromApp`)

After a user approves your product once (app-link permission), your server can create proofs for them without a per-request signature.

import { NeusClient } from "@neus/sdk";

// Server only. Never put this config in a browser bundle
const client = new NeusClient({
  appId: process.env.NEUS_APP_ID,
  // Must match the origin the user approved (or use origin:* on the approval)
  appOrigin: process.env.NEUS_APP_ORIGIN, // e.g. https://yourapp.com
  // Optional: bills/automates as your builder profile
  apiKey: process.env.NEUS_ACCESS_KEY,
});

const proof = await client.verifyFromApp({
  user: { walletAddress: user.accountAddress },
  verifier: "ownership-basic",
  content: { claim: "User completed onboarding", source: "your-app" },
});

Requirements:

Active user approval for your appId and site origin (Agent permissions: App link)
X-Neus-App (from appId) and matching Origin on the request (appOrigin sets both for Node)

If approval is missing, send the user through Hosted Verify first. This is not the same as creating a listing under Profile → Listings, which bills hosted checks to your account.

Profile access keys

Create keys under Profile → Account. Pass the key to NeusClient as apiKey on the server. The SDK sends Authorization: Bearer npk_.... Never ship keys in browser bundles. Access keys identify your builder profile for automation. They do not replace per-user approval for backend proof creation.

Billing

Published gates are the default billing source. Pass gateId on hosted checkout and gateCheck; NEUS resolves owner, usage, and payment from that gate. appId is public attribution for advanced server flows. It does not bill your account by itself. See Billing. Next: API Authentication

Agents

Recipes

Integrations

When you need this

Backend proof creation (`verifyFromApp`)

Profile access keys

Billing

​When you need this

​Backend proof creation (verifyFromApp)

​Profile access keys

​Billing

When you need this

Backend proof creation (`verifyFromApp`)

Profile access keys

Billing