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. CRYPTO ML-DSA-65 signature verification (NIST FIPS 204)
2. TEMPORAL Challenge/response timing analysis
3. BEHAVIORAL Pattern consistency over time
4. HARDWARE AES-NI timing attestation (real silicon proof)
5. NETWORK Latency fingerprinting
6. GEOGRAPHIC Speed-of-light location proof
7. SOCIAL Cross-node vouching from Guardians
KARMA Trust Tiers
Tier Nepali Name Multiplier Requirements
ORACLE SARATHI (सारथी) 2.0× Atomic clock + AES-NI + 30 days
ANCHOR SAMRAT (सम्राट) 1.5× GPS+PPS + AES-NI + 14 days
SENTINEL SIPAHI (सिपाही) 1.25× PTP + AES-NI + 7 days
PARTICIPANT PATHIK (पथिक) 1.0× NTP + AES-NI verified
OBSERVER PARYATAK (पर्यटक) 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"
RTT Minimum Distance Physics
1ms ≥100 km Fiber: 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:
NAMCHE Named after Namche Bazaar, Sherpa gateway
SHERPA Mountain guides who lead the way
KARMA Buddhist concept of cause and effect
TATTVA Sanskrit for "essence" or "truth"
GRANTH Sanskrit for "text" or "scripture"
SURAKSHA Hindi for "security" or "protection"
PRAMAAN Sanskrit for "proof" or "evidence"
DOKO Nepali basket carried by porters
MANTRA Sacred utterance, repeated prayer
STUPA Buddhist monument, sacred structure
LAMA Tibetan teacher, wise guide
MANI Prayer wheels, time cycles
MANDALA Sacred geometric pattern
NAKPAK Layered backpack, nested protection