Quick Reference

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

Provenance full version history →

Package lineage runs v1.0.0 (2026-01-13) through v3.5.10 (current) — 45 releases across 19 git tags.

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 MQ checksum over F327, non-linear
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
SIRDARसिरदार — Expedition Leader2.0×Atomic clock + AES-NI + 30 days
SATHIसाथी — Trusted Companion1.5×GPS+PPS + AES-NI + 14 days
PATHIKपथिक — Traveler on Path1.25×PTP + AES-NI + 7 days
YATRIयात्री — Pilgrim/Journeyer1.0×NTP/SYSTEM + AES-NI, 1 day
NAYAनया — Newcomer0.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

// The root module exports the node class; subsystems use subpath imports
import { YakmeshNode } from 'yakmesh';

import { NamcheGateway } from 'yakmesh/security/namche-gateway';
import { DOKOGenerator, DOKODocument } from 'yakmesh/security/doko-identity';
import { SherpaDiscovery } from 'yakmesh/mesh/sherpa-discovery';
import { NakpakRouter } from 'yakmesh/mesh/nakpak-routing';
import { Annex } from 'yakmesh/mesh/annex';
import { MantraProtocol } from 'yakmesh/gossip/protocol';
import { HardwareAttestation } from 'yakmesh/security/hardware-attestation';
import { KARMA_TIER, TrustTierRegistry } from 'yakmesh/security/trust-tier';
import { StrikeRegistry } from 'yakmesh/security/strike-system';
import { SybilDefense } from 'yakmesh/mesh/sybil-defense';
import { CodebaseLock } from 'yakmesh/oracle/codebase-lock';

// Network identity
import { 
  deriveNetworkName, 
  deriveVerificationPhrase 
} from 'yakmesh/oracle/identity';

// Embedded docs (GRANTH)
import { 
  BUNDLE_HASH, 
  BUNDLE_VERSION, 
  getDocsFile,
  verifyFile,
} from 'yakmesh/embedded-docs';

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 3080
npx yakmesh start
import { YakmeshNode } from 'yakmesh';

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

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