Thanks to visit codestin.com
Credit goes to Github.com

Skip to content
/ network Public

An open verification protocol that turns claims into portable proofs that can be verified across apps and chains.

License

Notifications You must be signed in to change notification settings

neus/network

Repository files navigation

NEUS Network

License npm

NEUS is an extensible, privacy-first verification infrastructure that works across apps, chains, and identities.

Prove something once and get a portable proof, private by default or public if you choose.

Verify once, prove anywhere.

Quick Start

JavaScript SDK (Recommended)

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

const client = new NeusClient();
const proof = await client.verify({
  verifier: 'ownership-basic',
  content: 'Hello NEUS Network'
});

console.log('Proof created:', proof.qHash);

Configure privacy and cross-chain (optional)

Add options only when you need public visibility, IPFS anchoring, or cross-chain propagation:

// Full options example: privacy + IPFS + cross-chain
const proof = await client.verify({
  verifier: 'ownership-basic',
  content: 'Hello NEUS Network',
  options: {
    // Privacy
    privacyLevel: 'private',        // 'private' or 'public'
    publicDisplay: false,           // Public UI previews (requires privacyLevel='public')
    storeOriginalContent: false,    // Include full plaintext in public snapshot (public only)

    // Distribution
    enableIpfs: true,               // Create privacy-aware IPFS snapshot
    targetChains: [11155111, 80002],// Propagate to Ethereum Sepolia + Polygon Amoy

    // Optional public metadata (used when privacyLevel='public')
    meta: {
      publicTitle: 'Ownership proof',
      contentType: 'text/plain',
      displayName: 'NEUS user'
    }
  }
});

HTTP API (Any Language)

curl -X POST https://api.neus.network/api/v1/verification \
  -H "Content-Type: application/json" \
  -d '{
    "walletAddress": "0x742d35Cc6634C0532925a3b8D82AB78c0D73C3Db",
    "signature": "0x...",
    "verifierIds": ["ownership-basic"],
    "data": {"content": "Hello NEUS", "owner": "0x742d35Cc6634C0532925a3b8D82AB78c0D73C3Db"},
    "options": {
      "privacyLevel": "private",
      "publicDisplay": false,
      "storeOriginalContent": false,
      "enableIpfs": true,
      "targetChains": [11155111, 80002]
    },
    "signedTimestamp": 1678886400000,
    "chainId": 84532
  }'

Message to sign:

NEUS Verification Request
Wallet: 0x742d35cc6634c0532925a3b8d82ab78c0d73c3db
Chain: 84532
Verifiers: ownership-basic
Data: {"content":"Hello NEUS","owner":"0x742d35Cc6634C0532925a3b8D82AB78c0D73C3Db"}
Timestamp: 1678886400000

What You Can Verify

  • Content Ownership - Prove authorship of content
  • NFT Ownership - Verify ownership of specific NFTs
  • Token Holdings - Prove balances without revealing amounts
  • Licensed Content - Verify content rights via licenses

Use Cases

Content Creators

// Create a content ownership proof
const proof = await client.verify({
  verifier: 'ownership-basic',
  content: 'My original article'
});

NFT Communities

// Verify NFT ownership for exclusive access
const proof = await client.verify({
  verifier: 'nft-ownership',
  data: {
    ownerAddress: walletAddress,
    contractAddress: '0x...',
    tokenId: '1234',
    chainId: 1
  }
});

DAO Governance

// Verify token holdings for voting eligibility
const proof = await client.verify({
  verifier: 'token-holding', 
  data: {
    ownerAddress: walletAddress,
    contractAddress: '0x...',
    minBalance: '100.0',
    chainId: 1
  }
});

Available Packages

@neus/sdk - JavaScript SDK

npm install @neus/sdk

@neus/widgets - React components

npm install @neus/widgets @neus/sdk

Framework Examples

Documentation

Network Details

API Endpoint: https://api.neus.network
Hub Chain: Base Sepolia (84532)
Contract Addresses: Deployments

Current Status

Testnet: Free verification services for development and testing

Contributing

We welcome contributions to the NEUS Network ecosystem:

Support

Repository Structure

/sdk          # @neus/sdk - JavaScript client
/widgets      # @neus/widgets - React components  
/docs         # Developer documentation
/examples     # Integration examples
/contracts    # Smart contract source
/abis         # Contract ABIs
/signing      # Multi-language implementations

License & Legal

  • Smart Contracts: Business Source License 1.1 (converts to Apache 2.0 on August 1, 2028)
  • SDK & Developer Tools: Apache 2.0 License (unrestricted commercial use)
  • ABIs: Apache 2.0 (maximum interoperability for integrators)

Legal Framework: Legal documentation | Repository overview

See LICENSE for complete dual-license terms.


NEUS Network | The Proof Layer

© NEUS Network, Inc. All rights reserved. See LICENSE.

About

An open verification protocol that turns claims into portable proofs that can be verified across apps and chains.

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Sponsor this project

Packages

No packages published