Developer Documentation

Ecosystem Status

Quick Connect

MetaMask Setup

Open MetaMask, go to Settings -- Networks -- Add Network -- Add a network manually. Enter the parameters below exactly as shown:

Supported JSON-RPC Methods

NV-CHAIN implements EIP-1474 standard methods. Gas is natively feeless -- eth_gasPrice returns 0x0.

EIP-155 Registration Metadata

{
  "name": "NV-CHAIN",
  "chain": "NVC",
  "shortName": "nvc",
  "chainId": 73790,
  "networkId": 73790,
  "nativeCurrency": {
    "name": "NeuroVaticCoin",
    "symbol": "NVC",
    "decimals": 18
  },
  "rpc": ["https://rpc.neurovatic.ai/rpc"],
  "explorers": [{"name": "nvScan", "url": "https://explorer.neurovatic.ai", "standard": "EIP3091"}],
  "infoURL": "https://neurovatic.ai"
}

WebSocket Block Feed

Real-time block subscription at wss://rpc.neurovatic.ai/ws/blocks.

// JavaScript
const ws = new WebSocket('wss://rpc.neurovatic.ai/ws/blocks');
ws.onmessage = (e) => {
  const block = JSON.parse(e.data);
  console.log('New block:', block.block_number, block.block_type);
};

// Message format
{
  "block_number": 7905,
  "hash": "0x...",
  "timestamp": 1774382100,
  "block_type": "CHAIN",
  "event": "new_block"
}

Block Types -- AI Provenance Ledger

Every AI decision and human action is recorded as an immutable block on NV-CHAIN. This enables full EU AI Act Art. 13 compliance (transparency) and Art. 22 (human oversight).

3-Layer Architecture

Neural-ID Types

A KYC-verified identity NID must be registered before any asset NIDs can be linked to it. The identity NID is the immutable root of the identity tree.

Tier System

Identity Truth Object (ITO)

The ITO is the canonical data structure returned by the Neural-ID resolution API. It contains exactly 7 sections -- no more, no less. This is the frozen enterprise API contract.

Practical Example -- Bank KYC/AML Integration

ITO Response Example

{
  "identity": {
    "nid": "alice",
    "id_type": "identity",
    "created": "2026-04-21T00:00:00Z",
    "block": 12345
  },
  "wallet": {
    "owner": "0xABC...",
    "wallet_address": "0xABC..."
  },
  "trust": {
    "tier": "VERIFIED",
    "npoi_score": 72,
    "verified_human": true
  },
  "consent": {
    "active_grants": ["tier", "kyc_hash", "npoi_score"],
    "granted_to": "partner_system",
    "expires_at": null
  },
  "proof": {
    "compact_proof": "a7f3c201...72hexchars...",
    "nexus_anchor_id": "nxa-a7f3c201-1745280000"
  },
  "meta": {
    "namespace_class": "standard",
    "aegis_nonce": "b4e7...",
    "liminal_id": "lim-def456"
  },
  "ok": {
    "status": "verified",
    "verified_at": "2026-04-21T12:00:00Z",
    "signature": "ed25519:7a3f..."
  }
}

nv:// URI Protocol

The nv:// scheme is the sovereign URI protocol for NV-CHAIN identity resolution, analogous to HTTP but anchored on-chain.

Resolution flow: Browser / App -- NV-EXTENSION -- Local Gateway (port 7474) -- Registry lookup -- On-chain resolution -- Returns HTML page or JSON record.

Namespace Classification

Variant protection: Registration of "brand" also blocks "br-and", "bra-nd", "b-rand" (edit distance 1). All NIDs are stored as lowercase ASCII; Unicode is normalized to ASCII equivalent.

KYC Integration -- GDPR Safe Model

Zero raw PII is stored on-chain. Only cryptographic commitments are recorded.

B2B API -- Neural-ID Identity Service

The B2B Identity API enables any enterprise system (banks, fintechs, AI platforms, regulatory bodies) to perform cryptographically verifiable identity checks against the NV-CHAIN identity layer. The full REST endpoint is currently in private testnet and will be available for B2B integration in Q3 2026.

Available Endpoints (Private Testnet)

web3.js

const { Web3 } = require("web3");
const web3 = new Web3("https://rpc.neurovatic.ai/rpc");

const chainId = await web3.eth.getChainId();
console.log("Chain ID:", chainId); // 73790n

const balance = await web3.eth.getBalance("0xAddress");
console.log("Balance:", web3.utils.fromWei(balance, "ether"), "NVC");

NVC-20 Token Standard

NVC-20 is the NEUROVATIC native token standard, EVM-compatible and equivalent to ERC-20 on Ethereum. Use NVC-20 to issue tokens on NV-CHAIN.

// Minimal NVC-20 interface (Solidity)
interface INVC20 {
    function name() external view returns (string memory);
    function symbol() external view returns (string memory);
    function decimals() external view returns (uint8);
    function totalSupply() external view returns (uint256);
    function balanceOf(address account) external view returns (uint256);
    function transfer(address to, uint256 amount) external returns (bool);
    function allowance(address owner, address spender) external view returns (uint256);
    function approve(address spender, uint256 amount) external returns (bool);
    function transferFrom(address from, address to, uint256 amount) external returns (bool);
    event Transfer(address indexed from, address indexed to, uint256 value);
    event Approval(address indexed owner, address indexed spender, uint256 value);
}

Smart Contracts

AgentRegistry -- Key Methods

// AgentRegistry v1.2.0
// Address: Published at public launch (NV-CHAIN Mainnet)

registerNID(nid, id_type, wallet, tier)   // Register new Neural-ID
resolveNID(nid) -> record                 // Resolve Neural-ID to full record
updateTier(nid, new_tier)                 // Update tier (KYC/NPoI gated)
transferNID(nid, to_address)              // Transfer asset-type NIDs only
revokeKYC(nid)                            // GDPR Art. 17 erasure

Smart Contract Security -- 5-Layer Validation Pipeline

ValidatorRegistry.sol and NVTimelockGovernance.sol are continuously validated through a 5-layer automated security pipeline on every commit. Audit results are publicly verifiable via the GitHub CI/CD badge.

Repository: github.com/Neurovatic-Inc/validator-registry

Validation Flow

1. Transaction submitted to NV-CHAIN BFT Aggregator
2. The gateway node calls NPoI consensus in parallel:
   -- SENTINEL (UNDECA INT8, 40% weight) -- fast inference
   -- COGNITUM (UNDECA FP32, 60% weight) -- full precision
3. Weighted softmax aggregation
4. NPoI verdict: ACCEPT if confidence >= 0.35
5. Block relayed to all N=12 nodes via /bft/vote
6. Agreement threshold: 2f+1 = 9/12 nodes
7. Block finalized -- all nodes sync state
8. NPoI Patrol Agent: independent check every 30 seconds

Fault Tolerance

• f=3: can tolerate 3 simultaneous Byzantine nodes
• Finality requires 9 of 12 honest nodes
• NPoI fallback: if AI is offline, chain continues (ACCEPT fallback -- availability over strict enforcement)
• SENTINEL node: special guardian + auditor role

NPoI Reputation Score

NPoI score (0-100) is an AI-calculated reputation score used solely for ecosystem access control. It has no financial or legal effect. Users may request review or correction.

RFC-001 -- On-Chain Proposal Protocol

RFC-001 defines the canonical structure for governance proposals recorded on NV-CHAIN. Every proposal is immutable once committed.

Proposal lifecycle: DRAFT -- DOMAIN_REVIEW -- VOTING_OPEN -- QUORUM_CHECK -- FINAL_TALLY -- TIMELOCK -- IMPLEMENTED / REJECTED. Each state transition is recorded as an immutable block on NV-CHAIN.

Hardware Requirements

Reward Structure

Competent Democracy Model

Standard DAO governance fails because token weight equals influence, regardless of expertise. SocietyDAO gates voting eligibility by domain competency:

• A proposal to change the AI consensus algorithm can only be voted on by members with a verified AI/ML competency score
• A proposal to change financial parameters requires financial domain competency
• A proposal to modify legal/compliance structure requires legal domain competency
• Cross-domain proposals require a quorum of competent members across all affected domains

The Three Socratic Pillars

Voting Eligibility Flow

User has Neural-ID (ACTIVE or EMANCIPATED tier)
    |
    v
Domain assigned based on Neural-ID activity + knowledge assessments
    |
    v
Competency Score calculated per domain (Episteme + Logos + Ethos)
    |
    v
Proposal published with domain tag
    |
    v
Only members with competency score >= threshold in that domain
may vote on that proposal
    |
    v
Vote weight = f(competency_score, npoi_score, involvement_score)
NOT token weight alone

Post-Quantum Security (FIPS 203/204)

Smart Contract Security -- CI/CD Pipeline

ValidatorRegistry.sol v2.0 is continuously validated through a 5-layer automated security pipeline on every commit. Current audit result: 4 Low findings (all accepted -- internal low-level calls on NVC transfers following CEI pattern with state zeroed before transfer).

View repository and CI badge: github.com/Neurovatic-Inc/validator-registry

Neural-ID Registration Fees

Multi-Token Architecture

N=12 BFT Cluster

Byzantine Fault Tolerant consensus tolerates f=3 compromised nodes simultaneously. Block finality requires 9 of 12 honest nodes. Infrastructure: 11 nodes on Hetzner dedicated servers + 1 independent node on Contabo (provider diversity for audit-grade decentralization).

Observability Stack

In Progress -- Q2-Q3 2026

Planned -- Q4 2026 and Beyond

Intellectual Property

Regulatory Compliance Mapping