yakmesh 2.8.2 → 3.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (232) hide show
  1. package/CHANGELOG.md +637 -0
  2. package/CONTRIBUTING.md +42 -0
  3. package/Caddyfile +77 -0
  4. package/README.md +119 -29
  5. package/adapters/adapter-mlv-bible/README.md +124 -0
  6. package/adapters/adapter-mlv-bible/index.js +400 -0
  7. package/adapters/chat-mod-adapter.js +532 -0
  8. package/adapters/content-adapter.js +273 -0
  9. package/content/api.js +50 -41
  10. package/content/index.js +2 -2
  11. package/content/store.js +355 -173
  12. package/dashboard/index.html +19 -3
  13. package/database/replication.js +117 -37
  14. package/docs/CRYPTO-AGILITY.md +204 -0
  15. package/docs/MTLS-RESEARCH.md +367 -0
  16. package/docs/NAMCHE-SPEC.md +681 -0
  17. package/docs/PEERQUANTA-YAKMESH-INTEGRATION.md +407 -0
  18. package/docs/PRECISION-DISCLOSURE.md +96 -0
  19. package/docs/README.md +76 -0
  20. package/docs/ROADMAP-2.4.0.md +447 -0
  21. package/docs/ROADMAP-2.5.0.md +244 -0
  22. package/docs/SECURITY-AUDIT-REPORT.md +306 -0
  23. package/docs/SST-INTEGRATION.md +712 -0
  24. package/docs/STEADYWATCH-IMPLEMENTATION.md +303 -0
  25. package/docs/TERNARY-AUDIT-REPORT.md +247 -0
  26. package/docs/TME-FAQ.md +221 -0
  27. package/docs/WHITEPAPER.md +623 -0
  28. package/docs/adapters.html +1001 -0
  29. package/docs/advanced-systems.html +1045 -0
  30. package/docs/annex.html +1046 -0
  31. package/docs/api.html +970 -0
  32. package/docs/business/response-templates.md +160 -0
  33. package/docs/c2c.html +1225 -0
  34. package/docs/cli.html +1332 -0
  35. package/docs/configuration.html +1248 -0
  36. package/docs/darshan.html +1085 -0
  37. package/docs/dharma.html +966 -0
  38. package/docs/docs-bundle.html +1075 -0
  39. package/docs/docs.css +3120 -0
  40. package/docs/docs.js +556 -0
  41. package/docs/doko.html +969 -0
  42. package/docs/geo-proof.html +858 -0
  43. package/docs/getting-started.html +840 -0
  44. package/docs/gumba-tutorial.html +1144 -0
  45. package/docs/gumba.html +1098 -0
  46. package/docs/index.html +914 -0
  47. package/docs/jhilke.html +1312 -0
  48. package/docs/karma.html +1100 -0
  49. package/docs/katha.html +1037 -0
  50. package/docs/lama.html +978 -0
  51. package/docs/mandala.html +1067 -0
  52. package/docs/mani.html +964 -0
  53. package/docs/mantra.html +967 -0
  54. package/docs/mesh.html +1409 -0
  55. package/docs/nakpak.html +869 -0
  56. package/docs/namche.html +928 -0
  57. package/docs/nav-order.json +53 -0
  58. package/docs/prahari.html +1043 -0
  59. package/docs/prism-bash.min.js +1 -0
  60. package/docs/prism-javascript.min.js +1 -0
  61. package/docs/prism-json.min.js +1 -0
  62. package/docs/prism-tomorrow.min.css +1 -0
  63. package/docs/prism.min.js +1 -0
  64. package/docs/privacy.html +699 -0
  65. package/docs/quick-reference.html +1181 -0
  66. package/docs/sakshi.html +1402 -0
  67. package/docs/sandboxing.md +386 -0
  68. package/docs/seva.html +911 -0
  69. package/docs/sherpa.html +871 -0
  70. package/docs/studio.html +860 -0
  71. package/docs/stupa.html +995 -0
  72. package/docs/tailwind.min.css +2 -0
  73. package/docs/tattva.html +1332 -0
  74. package/docs/terms.html +686 -0
  75. package/docs/time-server-deployment.md +166 -0
  76. package/docs/time-sources.html +1392 -0
  77. package/docs/tivra.html +1127 -0
  78. package/docs/trademark-policy.html +686 -0
  79. package/docs/tribhuj.html +1183 -0
  80. package/docs/trust-security.html +1029 -0
  81. package/docs/tutorials/backup-recovery.html +654 -0
  82. package/docs/tutorials/dashboard.html +604 -0
  83. package/docs/tutorials/domain-setup.html +605 -0
  84. package/docs/tutorials/host-website.html +456 -0
  85. package/docs/tutorials/mesh-network.html +505 -0
  86. package/docs/tutorials/mobile-access.html +445 -0
  87. package/docs/tutorials/privacy.html +467 -0
  88. package/docs/tutorials/raspberry-pi.html +600 -0
  89. package/docs/tutorials/security-basics.html +539 -0
  90. package/docs/tutorials/share-files.html +431 -0
  91. package/docs/tutorials/troubleshooting.html +637 -0
  92. package/docs/tutorials/trust-karma.html +419 -0
  93. package/docs/tutorials/yak-protocol.html +456 -0
  94. package/docs/tutorials.html +1034 -0
  95. package/docs/vani.html +1270 -0
  96. package/docs/webserver.html +809 -0
  97. package/docs/yak-protocol.html +940 -0
  98. package/docs/yak-timeserver-design.md +475 -0
  99. package/docs/yakapp.html +1015 -0
  100. package/docs/ypc27.html +1069 -0
  101. package/docs/yurt.html +1344 -0
  102. package/embedded-docs/bundle.js +334 -74
  103. package/gossip/protocol.js +247 -27
  104. package/identity/key-resolver.js +262 -0
  105. package/identity/machine-seed.js +632 -0
  106. package/identity/node-key.js +669 -368
  107. package/identity/tribhuj-ratchet.js +506 -0
  108. package/knowledge-base.js +37 -8
  109. package/launcher/yakmesh.bat +62 -0
  110. package/launcher/yakmesh.sh +70 -0
  111. package/mesh/annex.js +462 -108
  112. package/mesh/beacon-broadcast.js +113 -1
  113. package/mesh/darshan.js +1718 -0
  114. package/mesh/gumba.js +1567 -0
  115. package/mesh/jhilke.js +651 -0
  116. package/mesh/katha.js +1012 -0
  117. package/mesh/nakpak-routing.js +8 -5
  118. package/mesh/network.js +724 -34
  119. package/mesh/pulse-sync.js +4 -1
  120. package/mesh/rate-limiter.js +127 -15
  121. package/mesh/seva.js +526 -0
  122. package/mesh/sherpa-discovery.js +89 -8
  123. package/mesh/sybil-defense.js +19 -5
  124. package/mesh/temporal-encoder.js +4 -3
  125. package/mesh/vani.js +1364 -0
  126. package/mesh/yurt.js +1340 -0
  127. package/models/entropy-sentinel.onnx +0 -0
  128. package/models/karma-trust.onnx +0 -0
  129. package/models/manifest.json +43 -0
  130. package/models/sakshi-anomaly.onnx +0 -0
  131. package/oracle/code-proof-protocol.js +7 -6
  132. package/oracle/codebase-lock.js +257 -28
  133. package/oracle/index.js +74 -15
  134. package/oracle/ma902-snmp.js +678 -0
  135. package/oracle/module-sealer.js +5 -3
  136. package/oracle/network-identity.js +16 -0
  137. package/oracle/packet-checksum.js +201 -0
  138. package/oracle/sst.js +579 -0
  139. package/oracle/ternary-144t.js +714 -0
  140. package/oracle/ternary-ml.js +481 -0
  141. package/oracle/time-api.js +239 -0
  142. package/oracle/time-source.js +137 -47
  143. package/oracle/validation-oracle-hardened.js +1111 -1071
  144. package/oracle/validation-oracle.js +4 -2
  145. package/oracle/ypc27.js +211 -0
  146. package/package.json +20 -3
  147. package/protocol/yak-handler.js +35 -9
  148. package/protocol/yak-protocol.js +28 -13
  149. package/reference/cpp/yakmesh_mceliece_shard.cpp +168 -0
  150. package/reference/cpp/yakmesh_ypc27.cpp +179 -0
  151. package/sbom.json +87 -0
  152. package/scripts/security-audit.mjs +264 -0
  153. package/scripts/update-docs-nav.js +194 -0
  154. package/scripts/update-docs-sidebar.cjs +164 -0
  155. package/security/crypto-config.js +4 -3
  156. package/security/dharma-moderation.js +517 -0
  157. package/security/doko-identity.js +193 -143
  158. package/security/domain-consensus.js +86 -85
  159. package/security/fs-hardening.js +620 -0
  160. package/security/hardware-attestation.js +5 -3
  161. package/security/hybrid-trust.js +227 -87
  162. package/security/karma-rate-limiter.js +692 -0
  163. package/security/khata-protocol.js +22 -21
  164. package/security/khata-trust-integration.js +277 -150
  165. package/security/memory-safety.js +635 -0
  166. package/security/mesh-auth.js +11 -10
  167. package/security/mesh-revocation.js +373 -5
  168. package/security/namche-gateway.js +298 -69
  169. package/security/sakshi.js +460 -3
  170. package/security/sangha.js +770 -0
  171. package/security/secure-config.js +473 -0
  172. package/security/silicon-parity.js +13 -10
  173. package/security/steadywatch.js +1142 -0
  174. package/security/strike-system.js +32 -3
  175. package/security/temporal-signing.js +488 -0
  176. package/security/trit-commitment.js +464 -0
  177. package/server/crypto/annex.js +247 -0
  178. package/server/darshan-api.js +343 -0
  179. package/server/index.js +3259 -362
  180. package/server/komm-api.js +668 -0
  181. package/utils/accel.js +2273 -0
  182. package/utils/ternary-id.js +79 -0
  183. package/utils/verify-worker.js +57 -0
  184. package/webserver/index.js +95 -5
  185. package/assets/yakmesh-logo.png +0 -0
  186. package/assets/yakmesh-logo.svg +0 -80
  187. package/assets/yakmesh-logo2.png +0 -0
  188. package/assets/yakmesh-logo2sm.png +0 -0
  189. package/assets/ymsm.png +0 -0
  190. package/website/assets/silhouettes/adapters.svg +0 -107
  191. package/website/assets/silhouettes/api-endpoints.svg +0 -115
  192. package/website/assets/silhouettes/atomic-clock.svg +0 -83
  193. package/website/assets/silhouettes/base-camp.svg +0 -81
  194. package/website/assets/silhouettes/bridge.svg +0 -69
  195. package/website/assets/silhouettes/docs-bundle.svg +0 -113
  196. package/website/assets/silhouettes/doko-basket.svg +0 -70
  197. package/website/assets/silhouettes/fortress.svg +0 -93
  198. package/website/assets/silhouettes/gateway.svg +0 -54
  199. package/website/assets/silhouettes/gears.svg +0 -93
  200. package/website/assets/silhouettes/globe-satellite.svg +0 -67
  201. package/website/assets/silhouettes/karma-wheel.svg +0 -137
  202. package/website/assets/silhouettes/lama-council.svg +0 -141
  203. package/website/assets/silhouettes/mandala-network.svg +0 -169
  204. package/website/assets/silhouettes/mani-stones.svg +0 -149
  205. package/website/assets/silhouettes/mantra-wheel.svg +0 -116
  206. package/website/assets/silhouettes/mesh-nodes.svg +0 -113
  207. package/website/assets/silhouettes/nakpak.svg +0 -56
  208. package/website/assets/silhouettes/peak-lightning.svg +0 -73
  209. package/website/assets/silhouettes/sherpa.svg +0 -69
  210. package/website/assets/silhouettes/stupa-tower.svg +0 -119
  211. package/website/assets/silhouettes/tattva-eye.svg +0 -78
  212. package/website/assets/silhouettes/terminal.svg +0 -74
  213. package/website/assets/silhouettes/webserver.svg +0 -145
  214. package/website/assets/silhouettes/yak.svg +0 -78
  215. package/website/assets/yakmesh-logo.png +0 -0
  216. package/website/assets/yakmesh-logo.webp +0 -0
  217. package/website/assets/yakmesh-logo128x140.webp +0 -0
  218. package/website/assets/yakmesh-logo2.png +0 -0
  219. package/website/assets/yakmesh-logo2.svg +0 -51
  220. package/website/assets/yakmesh-logo40x44.webp +0 -0
  221. package/website/assets/yakmesh.gif +0 -0
  222. package/website/assets/yakmesh.ico +0 -0
  223. package/website/assets/yakmesh.jpg +0 -0
  224. package/website/assets/yakmesh.pdf +0 -0
  225. package/website/assets/yakmesh.png +0 -0
  226. package/website/assets/yakmesh.svg +0 -70
  227. package/website/assets/yakmesh128.webp +0 -0
  228. package/website/assets/yakmesh32.png +0 -0
  229. package/website/assets/yakmesh32.svg +0 -65
  230. package/website/assets/yakmesh32o.ico +0 -2
  231. package/website/assets/yakmesh32o.svg +0 -65
  232. package/website/assets/yakmesh32o.svgz +0 -0
@@ -0,0 +1,419 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en" data-theme="tutorials">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <link rel="icon" href="../favicon.ico" sizes="32x32">
7
+ <link rel="icon" href="../icon.svg" type="image/svg+xml">
8
+ <link rel="apple-touch-icon" href="../apple-touch-icon.png">
9
+ <title>Trust & Reputation - YAKMESH Tutorials</title>
10
+ <meta name="description" content="Learn how KARMA trust system works in YAKMESH. Understand reputation tiers, how to earn trust, and how bad actors are detected.">
11
+
12
+ <link rel="stylesheet" href="../tailwind.min.css">
13
+ <link rel="stylesheet" href="../prism-tomorrow.min.css">
14
+ <link rel="stylesheet" href="../docs.css">
15
+ <style>
16
+ .theme-accent { color: #10b981; }
17
+ .theme-accent-hover:hover { color: #34d399; }
18
+ .theme-badge { background: rgba(16, 185, 129, 0.2); color: #34d399; }
19
+ .theme-border { border-color: #10b981; }
20
+ .theme-callout { background: rgba(16, 185, 129, 0.1); border-color: #059669; }
21
+ .active-link { background: rgba(16, 185, 129, 0.2) !important; color: #34d399 !important; }
22
+ .tutorial-card { background: rgba(30, 41, 59, 0.5); border: 1px solid #334155; border-radius: 0.75rem; padding: 1.5rem; margin-bottom: 1.5rem; }
23
+ .step-number { display: inline-flex; align-items: center; justify-content: center; width: 2rem; height: 2rem; background: #10b981; color: white; border-radius: 50%; font-weight: bold; margin-right: 0.75rem; flex-shrink: 0; }
24
+ .tier-card { background: rgba(30, 41, 59, 0.6); border: 1px solid #334155; border-radius: 0.5rem; padding: 1rem; margin-bottom: 0.75rem; }
25
+ .tier-card.new { border-left: 4px solid #6b7280; }
26
+ .tier-card.established { border-left: 4px solid #3b82f6; }
27
+ .tier-card.trusted { border-left: 4px solid #10b981; }
28
+ .tier-card.elder { border-left: 4px solid #f59e0b; }
29
+ .analogy-box { background: rgba(245, 158, 11, 0.1); border: 1px solid rgba(245, 158, 11, 0.3); border-radius: 0.5rem; padding: 1rem; margin: 1rem 0; }
30
+ .analogy-box::before { content: '💡 '; }
31
+ .warning-box { background: rgba(239, 68, 68, 0.1); border: 1px solid rgba(239, 68, 68, 0.3); border-radius: 0.5rem; padding: 1rem; margin: 1rem 0; }
32
+ .warning-box::before { content: '⚠️ '; }
33
+ </style>
34
+ </head>
35
+ <body class="bg-mountain-900 text-white min-h-screen">
36
+
37
+ <nav class="docs-sidebar" id="sidebar">
38
+ <a href="../index.html" class="sidebar-logo">
39
+ <span class="logo-icon">🏔️</span>
40
+ <span class="logo-text">Yakmesh</span>
41
+ </a>
42
+ <a href="/dashboard" class="sidebar-dashboard-link"><span>📊</span> <span>Dashboard</span></a>
43
+ <ul class="sidebar-nav">
44
+ <li><a href="../index.html"><span>🏠</span> <span>Overview</span></a></li>
45
+ <li><a href="../getting-started.html"><span>🚀</span> <span>Getting Started</span></a></li>
46
+ <li><a href="../tutorials.html"><span>📖</span> <span>Tutorials</span></a></li>
47
+ <li><a href="../yak-protocol.html"><span class="yak-icon"></span> <span>YAK://</span></a></li>
48
+ <li><a href="../annex.html"><span>🌉</span> <span>ANNEX</span></a></li>
49
+ <li><a href="../nakpak.html"><span>🎒</span> <span>NAKPAK</span></a></li>
50
+ <li><a href="../namche.html"><span>🚪</span> <span>NAMCHE</span></a></li>
51
+ <li><a href="../doko.html"><span>🧺</span> <span>DOKO</span></a></li>
52
+ <li><a href="../sherpa.html"><span>🧗</span> <span>SHERPA</span></a></li>
53
+ <li><a href="../mandala.html"><span>🌐</span> <span>MANDALA</span></a></li>
54
+ <li><a href="../mantra.html"><span>🕉️</span> <span>MANTRA</span></a></li>
55
+ <li><a href="../gumba.html"><span>🛕</span> <span>GUMBA</span></a></li>
56
+ <li><a href="../yurt.html"><span>🏕️</span> <span>YURT</span></a></li>
57
+ <li><a href="../katha.html"><span>💬</span> <span>KATHA</span></a></li>
58
+ <li><a href="../vani.html"><span>🎙️</span> <span>VANI</span></a></li>
59
+ <li><a href="../darshan.html"><span>👁️</span> <span>DARSHAN</span></a></li>
60
+ <li><a href="../stupa.html"><span>🛕</span> <span>STUPA</span></a></li>
61
+ <li><a href="../lama.html"><span>🔮</span> <span>LAMA</span></a></li>
62
+ <li><a href="../mani.html"><span>⏱️</span> <span>MANI</span></a></li>
63
+ <li><a href="../karma.html"><span>☯️</span> <span>KARMA</span></a></li>
64
+ <li><a href="../tattva.html"><span>🔯</span> <span>TATTVA</span></a></li>
65
+ <li><a href="../tribhuj.html"><span>🔺</span> <span>TRIBHUJ</span></a></li>
66
+ <li><a href="../ypc27.html"><span>🔐</span> <span>YPC-27</span></a></li>
67
+ <li><a href="../sakshi.html"><span>👁️</span> <span>SAKSHI</span></a></li>
68
+ <li><a href="../geo-proof.html"><span>🌍</span> <span>PRAMAAN</span></a></li>
69
+ <li><a href="../trust-security.html"><span>🔒</span> <span>SURAKSHA</span></a></li>
70
+ <li><a href="../docs-bundle.html"><span>📚</span> <span>GRANTH</span></a></li>
71
+ <li><a href="../api.html"><span>📡</span> <span>API</span></a></li>
72
+ <li><a href="../adapters.html"><span>🔌</span> <span>Adapters</span></a></li>
73
+ <li><a href="../studio.html"><span>🎨</span> <span>Studio</span></a></li>
74
+ <li><a href="../quick-reference.html"><span>📋</span> <span>Quick Ref</span></a></li>
75
+ </ul>
76
+ </nav>
77
+
78
+ <button class="sidebar-toggle" id="sidebarToggle" title="Toggle sidebar">
79
+ <svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke="currentColor">
80
+ <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M11 19l-7-7 7-7m8 14l-7-7 7-7" />
81
+ </svg>
82
+ </button>
83
+
84
+ <div class="sidebar-overlay" id="sidebarOverlay"></div>
85
+
86
+ <main class="docs-main" id="mainContent">
87
+ <div class="docs-content">
88
+
89
+ <!-- Breadcrumb -->
90
+ <nav class="text-sm text-mountain-400 mb-6">
91
+ <a href="../tutorials.html" class="hover:text-white transition">Tutorials</a>
92
+ <span class="mx-2">/</span>
93
+ <span class="text-white">Trust & Reputation</span>
94
+ </nav>
95
+
96
+ <!-- Page Header -->
97
+ <div class="mb-8">
98
+ <div class="flex items-center gap-3 mb-2">
99
+ <span class="text-4xl">☯️</span>
100
+ <h1 class="text-4xl font-bold">Trust & Reputation</h1>
101
+ <span class="theme-badge text-xs px-2 py-1 rounded-full">8 min read</span>
102
+ </div>
103
+ <p class="theme-accent text-lg">How KARMA works, explained simply</p>
104
+ <p class="text-mountain-300 mt-2">
105
+ Learn how nodes build trust in YAKMESH—no math required. Understand reputation tiers
106
+ and why trust matters for a healthy network.
107
+ </p>
108
+ </div>
109
+
110
+ <!-- Section 1: What is Reputation? -->
111
+ <div class="tutorial-card">
112
+ <h2 class="text-2xl font-bold mb-4 flex items-center">
113
+ <span class="step-number">1</span>
114
+ What Is Reputation?
115
+ </h2>
116
+ <p class="text-mountain-300 mb-4">
117
+ Think of reputation like your credit score, but for network trust. Instead of measuring
118
+ how well you pay bills, it measures how reliably your node behaves on the network.
119
+ </p>
120
+
121
+ <div class="analogy-box">
122
+ <strong>Real-world analogy:</strong> Imagine moving to a new neighborhood. At first,
123
+ nobody knows you. Over time, as you help neighbors, keep your lawn tidy, and show
124
+ up to community events, people start trusting you more. That's exactly how KARMA works.
125
+ </div>
126
+
127
+ <p class="text-mountain-300 mt-4">
128
+ Your node's reputation is <strong>earned, not given</strong>. New nodes start with
129
+ minimal trust, and over time—by being reliable, responding correctly, and not
130
+ misbehaving—they climb the trust ladder.
131
+ </p>
132
+ </div>
133
+
134
+ <!-- Section 2: How Do You Earn It? -->
135
+ <div class="tutorial-card">
136
+ <h2 class="text-2xl font-bold mb-4 flex items-center">
137
+ <span class="step-number">2</span>
138
+ How Do You Earn Reputation?
139
+ </h2>
140
+ <p class="text-mountain-300 mb-4">
141
+ KARMA tracks multiple signals to calculate your trustworthiness:
142
+ </p>
143
+
144
+ <ul class="space-y-3 text-mountain-300">
145
+ <li class="flex items-start gap-3">
146
+ <span class="text-green-400">✓</span>
147
+ <div>
148
+ <strong class="text-white">Time online</strong> — The longer your node has been
149
+ running consistently, the more trust you build. Patience pays off.
150
+ </div>
151
+ </li>
152
+ <li class="flex items-start gap-3">
153
+ <span class="text-green-400">✓</span>
154
+ <div>
155
+ <strong class="text-white">Correct responses</strong> — When other nodes ask
156
+ for data, do you deliver valid content? Accuracy builds trust.
157
+ </div>
158
+ </li>
159
+ <li class="flex items-start gap-3">
160
+ <span class="text-green-400">✓</span>
161
+ <div>
162
+ <strong class="text-white">Good timing</strong> — Does your node keep good time?
163
+ Nodes with accurate clocks (especially hardware clocks like GPS) score higher.
164
+ </div>
165
+ </li>
166
+ <li class="flex items-start gap-3">
167
+ <span class="text-green-400">✓</span>
168
+ <div>
169
+ <strong class="text-white">Peer endorsements</strong> — When trusted nodes vouch
170
+ for you, that matters. It's like a job reference.
171
+ </div>
172
+ </li>
173
+ <li class="flex items-start gap-3">
174
+ <span class="text-green-400">✓</span>
175
+ <div>
176
+ <strong class="text-white">Hardware verification</strong> — Modern CPUs have
177
+ security features. Using them proves you're running real software, not a fake.
178
+ </div>
179
+ </li>
180
+ </ul>
181
+ </div>
182
+
183
+ <!-- Section 3: Trust Tiers -->
184
+ <div class="tutorial-card">
185
+ <h2 class="text-2xl font-bold mb-4 flex items-center">
186
+ <span class="step-number">3</span>
187
+ Trust Tiers: The Ladder of Trust
188
+ </h2>
189
+ <p class="text-mountain-300 mb-4">
190
+ Every node falls into one of these tiers. Think of them as levels in a video game—
191
+ you start at Level 0 and work your way up.
192
+ </p>
193
+
194
+ <div class="tier-card new">
195
+ <div class="flex items-center justify-between mb-2">
196
+ <h3 class="font-bold text-lg">🌱 NAYA (New Node)</h3>
197
+ <span class="text-xs bg-gray-600 px-2 py-1 rounded">Level 0</span>
198
+ </div>
199
+ <p class="text-mountain-400 text-sm mb-2">
200
+ <em>"The newcomer"</em> — Just joined the network.
201
+ </p>
202
+ <ul class="text-sm text-mountain-300 space-y-1">
203
+ <li>• Can browse and request content</li>
204
+ <li>• Limited ability to serve content to others</li>
205
+ <li>• Other nodes watch your behavior carefully</li>
206
+ </ul>
207
+ </div>
208
+
209
+ <div class="tier-card established">
210
+ <div class="flex items-center justify-between mb-2">
211
+ <h3 class="font-bold text-lg">🥈 YATRI (Established)</h3>
212
+ <span class="text-xs bg-blue-600 px-2 py-1 rounded">Level 1</span>
213
+ </div>
214
+ <p class="text-mountain-400 text-sm mb-2">
215
+ <em>"The traveler"</em> — Been around for a few days, behaving well.
216
+ </p>
217
+ <ul class="text-sm text-mountain-300 space-y-1">
218
+ <li>• 1+ day of consistent uptime</li>
219
+ <li>• Hardware security features verified</li>
220
+ <li>• Can serve content to other nodes</li>
221
+ </ul>
222
+ </div>
223
+
224
+ <div class="tier-card trusted">
225
+ <div class="flex items-center justify-between mb-2">
226
+ <h3 class="font-bold text-lg">💎 SATHI (Trusted)</h3>
227
+ <span class="text-xs bg-emerald-600 px-2 py-1 rounded">Level 3</span>
228
+ </div>
229
+ <p class="text-mountain-400 text-sm mb-2">
230
+ <em>"The companion"</em> — A reliable member of the network.
231
+ </p>
232
+ <ul class="text-sm text-mountain-300 space-y-1">
233
+ <li>• 14+ days of consistent uptime</li>
234
+ <li>• GPS or high-quality time source</li>
235
+ <li>• Endorsed by higher-tier nodes</li>
236
+ <li>• Priority access to network resources</li>
237
+ </ul>
238
+ </div>
239
+
240
+ <div class="tier-card elder">
241
+ <div class="flex items-center justify-between mb-2">
242
+ <h3 class="font-bold text-lg">🏔️ SIRDAR (Elder)</h3>
243
+ <span class="text-xs bg-amber-600 px-2 py-1 rounded">Level 4</span>
244
+ </div>
245
+ <p class="text-mountain-400 text-sm mb-2">
246
+ <em>"The expedition leader"</em> — The most trusted nodes on the network.
247
+ </p>
248
+ <ul class="text-sm text-mountain-300 space-y-1">
249
+ <li>• 30+ days of consistent uptime</li>
250
+ <li>• Atomic or GPS time source</li>
251
+ <li>• Full hardware attestation</li>
252
+ <li>• Can endorse other nodes</li>
253
+ <li>• Helps make network-wide decisions</li>
254
+ </ul>
255
+ </div>
256
+ </div>
257
+
258
+ <!-- Section 4: Why Trust Matters -->
259
+ <div class="tutorial-card">
260
+ <h2 class="text-2xl font-bold mb-4 flex items-center">
261
+ <span class="step-number">4</span>
262
+ Why Trust Matters for Content Delivery
263
+ </h2>
264
+ <p class="text-mountain-300 mb-4">
265
+ Trust isn't just about feeling good—it has real practical effects:
266
+ </p>
267
+
268
+ <ul class="space-y-3 text-mountain-300">
269
+ <li class="flex items-start gap-3">
270
+ <span class="text-2xl">🚀</span>
271
+ <div>
272
+ <strong class="text-white">Faster routing</strong> — High-trust nodes get priority
273
+ when routing content. Your files arrive faster.
274
+ </div>
275
+ </li>
276
+ <li class="flex items-start gap-3">
277
+ <span class="text-2xl">🛡️</span>
278
+ <div>
279
+ <strong class="text-white">Better security</strong> — You receive content from
280
+ trusted sources, reducing the risk of corrupted or malicious data.
281
+ </div>
282
+ </li>
283
+ <li class="flex items-start gap-3">
284
+ <span class="text-2xl">🌐</span>
285
+ <div>
286
+ <strong class="text-white">Network stability</strong> — Trusted nodes form the
287
+ backbone of the mesh. They're the reliable infrastructure everyone depends on.
288
+ </div>
289
+ </li>
290
+ <li class="flex items-start gap-3">
291
+ <span class="text-2xl">⚖️</span>
292
+ <div>
293
+ <strong class="text-white">Fair resource allocation</strong> — Limited resources
294
+ (like bandwidth) go to nodes that have proven they're good citizens.
295
+ </div>
296
+ </li>
297
+ </ul>
298
+ </div>
299
+
300
+ <!-- Section 5: Bad Actors -->
301
+ <div class="tutorial-card">
302
+ <h2 class="text-2xl font-bold mb-4 flex items-center">
303
+ <span class="step-number">5</span>
304
+ How Bad Actors Are Detected and Isolated
305
+ </h2>
306
+ <p class="text-mountain-300 mb-4">
307
+ Not everyone plays nice. Here's how YAKMESH protects itself:
308
+ </p>
309
+
310
+ <h3 class="text-lg font-semibold mb-3 text-white">What gets you in trouble:</h3>
311
+ <ul class="space-y-2 text-mountain-300 mb-6">
312
+ <li class="flex items-start gap-3">
313
+ <span class="text-red-400">✗</span>
314
+ <span><strong>Serving bad data</strong> — Content that doesn't match its hash</span>
315
+ </li>
316
+ <li class="flex items-start gap-3">
317
+ <span class="text-red-400">✗</span>
318
+ <span><strong>Going offline often</strong> — Unreliable availability</span>
319
+ </li>
320
+ <li class="flex items-start gap-3">
321
+ <span class="text-red-400">✗</span>
322
+ <span><strong>Bad timing</strong> — Clock way off from the network</span>
323
+ </li>
324
+ <li class="flex items-start gap-3">
325
+ <span class="text-red-400">✗</span>
326
+ <span><strong>Spam behavior</strong> — Sending too many requests or fake messages</span>
327
+ </li>
328
+ <li class="flex items-start gap-3">
329
+ <span class="text-red-400">✗</span>
330
+ <span><strong>Eclipse attacks</strong> — Trying to isolate nodes from the network</span>
331
+ </li>
332
+ </ul>
333
+
334
+ <h3 class="text-lg font-semibold mb-3 text-white">What happens to bad actors:</h3>
335
+ <ol class="space-y-2 text-mountain-300">
336
+ <li><strong>1. Warning</strong> — First offense might just reduce your score slightly</li>
337
+ <li><strong>2. Demotion</strong> — Keep misbehaving and you drop to a lower tier</li>
338
+ <li><strong>3. Isolation</strong> — Serious offenders get disconnected from trusted nodes</li>
339
+ <li><strong>4. Blacklist</strong> — The worst actors are blocked entirely</li>
340
+ </ol>
341
+
342
+ <div class="warning-box mt-4">
343
+ <strong>Important:</strong> Reputation is hard to earn and easy to lose. A single
344
+ serious offense can undo weeks of good behavior. Play nice!
345
+ </div>
346
+ </div>
347
+
348
+ <!-- Section 6: Check Your Status -->
349
+ <div class="tutorial-card">
350
+ <h2 class="text-2xl font-bold mb-4 flex items-center">
351
+ <span class="step-number">6</span>
352
+ Check Your Reputation
353
+ </h2>
354
+ <p class="text-mountain-300 mb-4">
355
+ Want to see where you stand? Use these commands:
356
+ </p>
357
+
358
+ <pre class="language-bash mb-4"><code># See your current karma tier and score
359
+ npx yakmesh karma status
360
+
361
+ # View detailed karma breakdown
362
+ npx yakmesh karma details
363
+
364
+ # See what your peers think of you
365
+ npx yakmesh karma endorsements</code></pre>
366
+
367
+ <p class="text-mountain-300 mt-4">
368
+ You can also check your Dashboard at <code class="bg-mountain-800 px-2 py-1 rounded">http://localhost:9526</code>
369
+ to see your trust score in real-time.
370
+ </p>
371
+ </div>
372
+
373
+ <!-- Summary -->
374
+ <div class="bg-mountain-800/50 rounded-xl p-6 border border-mountain-700 mb-8">
375
+ <h2 class="text-xl font-bold mb-4">📌 Key Takeaways</h2>
376
+ <ul class="space-y-2 text-mountain-300">
377
+ <li>✓ Reputation is earned through consistent good behavior over time</li>
378
+ <li>✓ Trust tiers range from NAYA (new) to SIRDAR (elder)</li>
379
+ <li>✓ Higher trust = faster routing, better security, more privileges</li>
380
+ <li>✓ Bad actors are automatically detected and isolated</li>
381
+ <li>✓ Keep your node online, accurate, and honest to build trust</li>
382
+ </ul>
383
+ </div>
384
+
385
+ <!-- Navigation Footer -->
386
+ <div class="border-t border-mountain-700 mt-12 pt-8">
387
+ <div class="flex flex-col sm:flex-row gap-4">
388
+ <a href="backup-recovery.html" class="flex-1 block bg-mountain-800 border border-mountain-700 rounded-xl p-4 hover:border-emerald-500 transition group">
389
+ <div class="text-xs text-mountain-400 mb-1">← Previous</div>
390
+ <div class="flex items-center gap-2">
391
+ <span class="text-xl">💾</span>
392
+ <span class="font-semibold group-hover:text-emerald-400">Backup & Recovery</span>
393
+ </div>
394
+ </a>
395
+ <a href="privacy.html" class="flex-1 block bg-mountain-800 border border-mountain-700 rounded-xl p-4 hover:border-emerald-500 transition group">
396
+ <div class="text-xs text-mountain-400 mb-1">Next →</div>
397
+ <div class="flex items-center gap-2">
398
+ <span class="text-xl">🔏</span>
399
+ <span class="font-semibold group-hover:text-emerald-400">Privacy Guide</span>
400
+ </div>
401
+ </a>
402
+ </div>
403
+ </div>
404
+
405
+ <!-- Version Badge -->
406
+ <div class="mt-8 pt-6 border-t border-mountain-700">
407
+ <span class="inline-block text-xs theme-badge px-2 py-1 rounded">v2.8.2</span>
408
+ <span class="text-mountain-500 text-sm ml-2">Last updated: February 2026</span>
409
+ </div>
410
+
411
+ </div>
412
+ </main>
413
+
414
+ <script src="../prism.min.js"></script>
415
+ <script src="../prism-javascript.min.js"></script>
416
+ <script src="../prism-bash.min.js"></script>
417
+ <script src="../docs.js"></script>
418
+ </body>
419
+ </html>