Skip to content

neus/network

Repository files navigation

NEUS

NEUS turns verification into reusable proof receipts for apps, agents, wallets, APIs, gates, audit, and payments.
It issues a proof receipt after a verification or trusted action, reuse that receipt across surfaces without rebuilding the same trust flow from scratch.

npm License Discussions

Get started | Hosted Verify | Quickstart | Docs | Examples | Live demo


Why teams pick NEUS

Outcome How NEUS delivers it
Ship faster with less “prove it again” One flow, a receipt ID, lookup before you re-run verification
Reuse trust across web, API, and agents Resolvable URLs and handles. Not screenshots that go stale
Safe agent identity and delegation agent-identity and agent-delegation with scoped permissions
Tools that see live truth Remote MCP over HTTPS so assistants read current results, not pasted text

Who this is for

  • Product and GTM teams turning wallet, token, NFT, or human checks into gates for drops, bounties, or paid tiers
  • Platforms standardizing one trust model across web, API, and automation
  • Agent builders shipping identity, delegation, and optional x402 payment unlock (docs)

Quickstart

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

const client = new NeusClient({ appId: 'your-app-id' });

const proof = await client.verify({
  verifier: 'ownership-basic',
  content: 'Verified bounty submission',
  wallet: window.ethereum,
});

const { proofId } = proof;
const signerAddress = '0x...';

const check = await client.gateCheck({
  address: signerAddress,
  verifierIds: ['ownership-basic'],
});

console.log(check.data?.eligible);

Next: SDK README | docs.neus.network

Linked profiles, agents, and automation

Layer What
Core flows agent-identity, optional agent-delegation
Resolvable handles https://neus.network/agent/<agentId>, result URLs, wallet, DID
Tooling manifest Optional JSON from the agent profile. See Agents.
Live checks NEUS MCP: neus_context, neus_proofs_get (MCP docs)
Linked accounts Ownership verifiers + wallet-link with the same result model (verifier table)

Fast path: Hosted Verify | billing and caps in app setup | paid flows: x402

Setup (any chat or IDE)

  1. Get started
  2. Register agents via SDK, Hosted Verify, or MCP neus_agent_create, then neus_agent_link. Agents | Cookbook.
  3. Share a resolvable handle (agent URL, result URL, wallet, DID) and use NEUS MCP for live state.
  4. Optional: export config JSON for hosts that load tool manifests from a URL.

More: Agents.

React gate

import { VerifyGate } from '@neus/sdk/widgets';

<VerifyGate
  appId="your-app-id"
  requiredVerifiers={['token-holding']}
  verifierData={{
    'token-holding': {
      contractAddress: '0x...',
      minBalance: '100.0',
      chainId: 1,
    },
  }}
>
  <RewardClaimForm />
</VerifyGate>

Widgets

MCP (agents / tools)

{
  "mcpServers": {
    "neus": {
      "type": "streamableHttp",
      "url": "https://mcp.neus.network/mcp"
    }
  }
}

docs.neus.network/mcp | MCP package

Hosted Verify

Hosted Verify is the browser flow at https://neus.network/verify: a parameterized checkout on NEUS. Your app keeps the proof ID and checks before you prompt again.

Examples:

https://neus.network/verify?verifiers=proof-of-human&returnUrl=https://myapp.com/callback

Agent onboarding: https://neus.network/verify?preset=agent-pack

Verifiers

Live catalog: Verifier catalog. Machine-readable lists and schemas ship in spec/ for reference and validation tooling.

Use case ID
Social ownership ownership-social
Domain ownership-dns-txt
Org OAuth ownership-org-oauth
Pseudonym ownership-pseudonym
Content / provenance ownership-basic
Human verification proof-of-human
Token balance token-holding
NFT nft-ownership
Contract contract-ownership
Wallet risk wallet-risk
Linked wallets wallet-link
Content moderation ai-content-moderation
Agent identity agent-identity
Agent delegation agent-delegation

Agents (SDK)

await client.verify({
  verifier: 'agent-identity',
  data: {
    agentId: 'my-bot',
    agentWallet: '0x...',
    agentChainRef: 'eip155:8453',
    agentType: 'ai',
  },
  walletAddress: agentWallet,
});

await client.verify({
  verifier: 'agent-delegation',
  data: {
    controllerWallet: '0x...',
    controllerChainRef: 'eip155:8453',
    agentWallet: '0x...',
    agentChainRef: 'eip155:8453',
    scope: 'payments:x402',
    permissions: ['execute', 'read'],
    maxSpend: '25000000',
    expiresAt: Date.now() + 7 * 24 * 60 * 60 * 1000,
  },
  walletAddress: controllerWallet,
});

Agent identity | Delegation

Visibility

Mode Role
Vaulted Owner-only reads
Unlisted Reuse links, not discoverable
Public Discoverable

Security and trust

Support

Channel Use for
Docs Reference and integration
Discussions Questions and patterns
Issues Bugs and requests
dev@neus.network Security

CONTRIBUTING.md

License

  • SDK & tools: Apache-2.0
  • Smart contracts: BUSL-1.1 to Apache-2.0 (Aug 2028)

Packages

 
 
 

Contributors