Quick Reference

Everything at a glance — protocols, commands, APIs, and version history.

Version History

Version Highlights
v2.8.2 SETU trust-tier bridge, SAKSHI integration complete
v2.8.1 SAKSHI observational system, VIVAAD disagreement analysis, VARNA removed
v2.8.0 TRIBHUJ balanced ternary math, TATTVA ternary ValidationResult, LAMA ternary consensus
v2.7.1 YPC-27 quantum-hard checksums (STUPA, NAKPAK, KHATA, SHERPA integrations)
v2.6.6 Philosophy page, Himalayan tribute, favicon fixes, docs bundle sync
v2.6.5 Production Tailwind CSS build, remove CDN dependency
v2.6.4 YAK icon fix, sidebar toggle fix, protocol stack complete
v2.6.3 YAK icon refinements, sidebar improvements
v2.6.0 GRANTH embedded docs, Himalayan naming, KARMA trust tiers
v2.5.0 Geographic Exclusion (PRAMAAN) — "Physics Don't Lie"
v2.3.0 Mesh test expansion, structured logging, bug fixes
v2.2.0 Consolidation release (includes v2.0.1 and v2.1.0)
v2.0.0 NAMCHE Gateway, DOKO Identity, Hybrid Trust, mTLS
v1.7.0 SLH-DSA backup signatures, monitoring dashboard
v1.6.0 NAKPAK onion routing, ANNEX encrypted channels
v1.5.1 SHERPA peer discovery, beacon protocol
v1.4.0 Gossip protocol (KHATA), mesh networking foundation
v1.0.0 Initial release — post-quantum crypto foundation

Protocol Stack

Protocol Purpose Key Feature
YAK:// URL scheme Custom protocol handler for mesh resources
GRANTH Embedded docs SHA3-256 hash-verified, tamper-proof bundle
KHATA Gossip Epidemic-style message propagation with TTL
ANNEX Encrypted channels ML-KEM-768 + XChaCha20-Poly1305
NAKPAK Onion routing 3-hop anonymous routing, Sphinx packets
SHERPA Peer discovery DHT-less beacon discovery, RTT measurement
STUPA Broadcasts Priority-based emergency beacons
LAMA Consensus Deterministic agreement, no voting
MANI Time sync Precision time source hierarchy
MANTRA Propagation Prayer wheel-style epidemic spreading
MANDALA Topology Mesh geometry, partition healing
ECHO Discovery 8D virtual coordinates, encrypted probes
PULSE Heartbeat Cryptographic liveness detection
TRIBHUJ Ternary math Balanced ternary {−1, 0, +1} primitives
YPC-27 Checksums 27-trit polynomial, SIS-hard quantum-resistant
SAKSHI Observation Capability witnessing, no permissions
VIVAAD Disagreement 16 causes, 11 remediations, no bans
SETU Bridge Trust-tier ↔ SAKSHI compatibility

Identity & Security (SURAKSHA)

NAMCHE Gateway — 7 Mathematical Gates

1. CRYPTOML-DSA-65 signature verification (NIST FIPS 204)
2. TEMPORALChallenge/response timing analysis
3. BEHAVIORALPattern consistency over time
4. HARDWAREAES-NI timing attestation (real silicon proof)
5. NETWORKLatency fingerprinting
6. GEOGRAPHICSpeed-of-light location proof
7. SOCIALCross-node vouching from Guardians

KARMA Trust Tiers

TierNepali NameMultiplierRequirements
ORACLESARATHI (सारथी)2.0×Atomic clock + AES-NI + 30 days
ANCHORSAMRAT (सम्राट)1.5×GPS+PPS + AES-NI + 14 days
SENTINELSIPAHI (सिपाही)1.25×PTP + AES-NI + 7 days
PARTICIPANTPATHIK (पथिक)1.0×NTP + AES-NI verified
OBSERVERPARYATAK (पर्यटक)0.25×New/unverified nodes

Defense Systems

  • Replay Protection — Nonce tracking, timestamp validation, sequence enforcement
  • Rate Limiting — Adaptive connection and message rate controls
  • Sybil Defense — Proof-of-work challenges, behavioral reputation tracking
  • Strike System — "Three Strikes — Then Math Speaks" (progressive trust reduction)
  • Silicon Parity — "One Silicon = One Vote" (anti-ASIC/farm defense)

Geographic Proof (PRAMAAN)

"We prove where you CANNOT be, not where you ARE"

RTTMinimum DistancePhysics
1ms≥100 kmFiber: 199,861 km/s (0.67c)
Vacuum: 299,792 km/s
5ms≥500 km
10ms≥999 km
50ms≥4,997 km
100ms≥9,993 km

CLI Commands

Basic Operations

npx yakmesh init              # Initialize new node
npx yakmesh start             # Start node
npx yakmesh status            # Show node status
npx yakmesh peers             # List connected peers
npx yakmesh info              # Detailed node info
npx yakmesh join <endpoint>   # Connect to peer

YAK:// Protocol

npx yakmesh protocol register            # Register yak:// with OS
npx yakmesh protocol unregister          # Unregister yak://
npx yakmesh protocol test <url>          # Test URL parsing
npx yakmesh protocol open <url>          # Open in browser
npx yakmesh protocol bookmark add <n> <t> # Add bookmark
npx yakmesh protocol bookmark list       # List bookmarks

Geographic Proof

npx yakmesh geo status        # Geo proof status
npx yakmesh geo landmarks     # List landmarks
npx yakmesh geo zones         # List exclusion zones
npx yakmesh geo prove         # Generate proof
npx yakmesh geo verify <id>   # Verify another node
npx yakmesh geo physics       # Show physics constants

Documentation

npx yakmesh docs info         # Bundle information
npx yakmesh docs verify       # Verify bundle integrity
npx yakmesh docs list         # List all files
npx yakmesh docs serve        # Start local docs server

API Exports

import { 
  YakmeshNode,           // Main node class
  NAMCHE,                // 7-gate identity verification
  DOKO,                  // Distributed identity
  SHERPA,                // Peer discovery
  NAKPAK,                // Onion routing
  ANNEX,                 // Encrypted channels
  KHATA,                 // Gossip protocol
  GeographicProof,       // Location verification
  HardwareAttestation,   // AES-NI verification
  TrustTier,             // KARMA trust levels
  StrikeSystem,          // 3-strike system
  SybilDetection,        // Fake identity detection
  CodeProofProtocol,     // Code verification
  CodebaseLock,          // Runtime file locking
} from 'yakmesh';

// Network identity
import { 
  deriveNetworkName, 
  deriveVerificationPhrase 
} from 'yakmesh/oracle/network-identity.js';

// Embedded docs
import { 
  BUNDLE_HASH, 
  BUNDLE_VERSION, 
  getDocsFile,
  verifyFile,
} from 'yakmesh/embedded-docs/index.js';

REST API Endpoints

Core

GET /healthNode health
GET /nodeNode identity
GET /peersConnected peers
GET /dashboardWeb UI
GET /metricsPrometheus

Network

POST /connectConnect to peer
POST /dataSubmit data
POST /rumorSpread gossip
GET /gossipGossip stats
GET /replicationSync status

Oracle (TATTVA)

GET /oracle/statusCode proof status
POST /oracle/challengeIssue challenge
GET /oracle/peersVerified peers
POST /oracle/submitSubmit content
GET /oracle/consensusConsensus state

Geographic

GET /geo/statusGeo proof status
GET /geo/landmarksList landmarks
GET /geo/zonesExclusion zones
POST /geo/proveGenerate proof
POST /geo/verifyVerify proof

Security

GET /security/statusSecurity overview
GET /security/namche/gatesGate status
GET /security/doko/statsDOKO stats
POST /security/doko/verifyVerify identity

Time

GET /time/statusTime source
GET /time/detectDetect sources
GET /time/capabilitiesTiming caps

Quick Start

npm install yakmesh
npx yakmesh init --name "My Node" --port 3000
npx yakmesh start
import { YakmeshNode } from 'yakmesh';

const node = new YakmeshNode({
  node: { name: 'My Node', region: 'local' },
  network: { httpPort: 3000, wsPort: 9001 },
});

await node.start();

Himalayan Naming

YAKMESH honors mountain peoples with Nepali/Tibetan naming:

NAMCHENamed after Namche Bazaar, Sherpa gateway
SHERPAMountain guides who lead the way
KARMABuddhist concept of cause and effect
TATTVASanskrit for "essence" or "truth"
GRANTHSanskrit for "text" or "scripture"
SURAKSHAHindi for "security" or "protection"
PRAMAANSanskrit for "proof" or "evidence"
DOKONepali basket carried by porters
MANTRASacred utterance, repeated prayer
STUPABuddhist monument, sacred structure
LAMATibetan teacher, wise guide
MANIPrayer wheels, time cycles
MANDALASacred geometric pattern
NAKPAKLayered backpack, nested protection