NEUS Docs

Send users to https://neus.network/verify for sign-in, human checks, social links, or gate checkout. You never embed passkey, OAuth, or wallet UI. Wallet steps appear only when a published gate requires them. Sign-in and gate checkout share one surface. See Trust stack.

What runs here

Query intent	User completes on NEUS
`intent=login`	NEUS session: passkey sign-in (primary), optional wallet attach
`gateId`	Gate checkout; wallet steps only if the published gate requires them
Social / org check	OAuth inside a check. ownership-social, ownership-org-oauth

Topic	`intent=login`	Gate checkout (`gateId`, no login-only intent)
Purpose	NEUS session (Hub, profile, later checks)	Proof / gate outcome
Screen	Dedicated login shell	Composer

Parameters

Param	Use
`intent=login`	Hosted login only
`returnUrl`	Absolute `https://…` back to your app after completion. Validated before redirect.
`returnTo`	neus.network path only (e.g. `/profile`). Not for third-party domains. `@neus/sdk` `getHostedCheckoutUrl` does not set this; append manually if needed.
`connect=1`	Optional for wallet-native products. With `intent=login`, auto-starts wallet connect on load
`gateId`	Gate definition
`mode=popup`	Popup; requires `origin`
`origin`	Opener origin for postMessage
`appId`	Advanced server/app attribution only; not required for published gate checkout

Redirect examples

Checkout / proof (your app):

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

window.location.href = getHostedCheckoutUrl({
  gateId: 'gate_your-app-name',
  returnUrl: 'https://myapp.com/auth/callback',
});

After redirect, read qHash (and related fields) from your callback URL. Login then return to your app:

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

window.location.href = getHostedCheckoutUrl({
  intent: 'login',
  returnUrl: 'https://myapp.com/auth/after-login',
});

First-party only (stay on neus.network):

https://neus.network/verify?intent=login&returnTo=/profile

/login on neus.network redirects to /verify?intent=login&… with a validated returnTo. Open with mode: 'popup' and origin: window.location.origin.

Flow	Opener listens for
Verification / gate	`neus_checkout_done` (includes `qHash` when applicable)
`intent=login`	`neus_login_complete`

No browser handoff

Server-created receipts and access keys: Integrations.

Playbooks

Hosted sign-in and checks

What runs here

Parameters

Redirect examples

No browser handoff

​What runs here

​Login vs verification

​Parameters

​Redirect examples

​Popup

​No browser handoff

What runs here

Login vs verification

Parameters

Redirect examples

Popup

No browser handoff