What is the NEUS SDK?

A typed package for Hosted Verify links, React gates, and server checks. Most apps publish a gate, open Hosted Verify in the browser, then call gateCheck on the server with the visitor’s account address.

How do I install the SDK?

Install `@neus/sdk` from npm. Browser flows need no access key. Profile access keys are for servers, CI, and MCP only.

Can I use the SDK on a server?

Yes. Use NeusClient with gateCheck({ gateId, address }) before trusted actions. Pass a profile access key only when your server acts as your NEUS profile.

Does the SDK replace my existing auth stack?

No. NEUS adds reusable trust receipts on top of what you already use. Visitors complete checks on NEUS; your app reuses the receipt at every connected gate.

Ship a gate. Reuse the receipt.

Publish a gate, open Hosted Verify in the browser, then confirm on your server with gateCheck. No wallet code in your app. No access key for the default path.

Read the docs See pricing

One package for links, widgets, and server checks — browser first, keys only on the server.

Browser

Send visitors to Hosted Verify.

Pass your published gate ID. NEUS runs the checks, saves the receipt, and returns the visitor to your app.

import { getHostedCheckoutUrl } from '@neus/sdk';

const url = getHostedCheckoutUrl({
  gateId: 'gate_your-app-name',
  returnUrl: 'https://yourapp.com/continue',
});

window.location.assign(url);

How it works

CHECK | RECEIPT

01Verify onceComplete a supported check
02Get a receiptResult becomes a reusable record
03Check before accessApps confirm before action
04Share lessPresent the result, not the file

Server

Confirm before you act.

On your server, check that the visitor still meets the gate. Use the account address from Hosted Verify. Ready means every required check is satisfied.

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

const client = new NeusClient();
const result = await client.gateCheck({
  gateId: 'gate_your-app-name',
  address: user.accountAddress,
});

if (result.data?.gate?.allRequiredSatisfied !== true) {
  // Send the visitor back to Hosted Verify
}

Trust receipt

Current

One check. Reusable everywhere it is accepted.

SubjectAcme Ops | Organization

CheckOrganization

ScopeAccess | Payout

StatusActive

Expires2026-12-01

Connected apps confirm status before access without the full source file.

Assistants

Same install for the CLI and MCP.

The package also ships the CLI. One setup command connects Cursor, Claude Code, and Codex so assistants can reuse the same receipts.

Profile access keys are for servers and CI only. Never put them in browser bundles.

Install

~/neus

Ready

$npx @neus/sdk setup

Cursor connected

Claude Code connected

Signed in | profile ready

$neus check

Identity: current

Permissions: scoped

Trust ready before action

SDK FAQ

Hosted Verify, gates, and server checks.

Ready to build?

Publish a gate and run the quickstart.

Send visitors to Hosted Verify.

Pass your published gate ID. NEUS runs the checks, saves the receipt, and returns the visitor to your app.

import { getHostedCheckoutUrl } from '@neus/sdk';

const url = getHostedCheckoutUrl({
  gateId: 'gate_your-app-name',
  returnUrl: 'https://yourapp.com/continue',
});

window.location.assign(url);

Confirm before you act.

On your server, check that the visitor still meets the gate. Use the account address from Hosted Verify. Ready means every required check is satisfied.

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

const client = new NeusClient();
const result = await client.gateCheck({
  gateId: 'gate_your-app-name',
  address: user.accountAddress,
});

if (result.data?.gate?.allRequiredSatisfied !== true) {
  // Send the visitor back to Hosted Verify
}