@awacloud/fw 0.1.0 → 1.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 (609) hide show
  1. package/CHANGELOG.md +125 -0
  2. package/NOTICE +8 -0
  3. package/README.md +163 -31
  4. package/dist/build/fw.core.pure.meta.json +6 -6
  5. package/dist/build/fw.core.pure.min.js +15 -12
  6. package/dist/build/fw.full.pure.meta.json +13 -7
  7. package/dist/build/fw.full.pure.min.js +45 -42
  8. package/dist/build/fw.minimal.pure.meta.json +6 -6
  9. package/dist/build/fw.minimal.pure.min.js +16 -13
  10. package/dist/build/fw.pack.compress-heavy.pure.meta.json +6 -6
  11. package/dist/build/fw.pack.compress-heavy.pure.min.js +3 -3
  12. package/dist/build/fw.pack.crypto-advanced.pure.meta.json +6 -6
  13. package/dist/build/fw.pack.crypto-advanced.pure.min.js +1 -1
  14. package/dist/build/fw.pack.crypto-basic.pure.meta.json +6 -6
  15. package/dist/build/fw.pack.crypto-basic.pure.min.js +1 -1
  16. package/dist/build/fw.pack.crypto-identity.pure.meta.json +7 -6
  17. package/dist/build/fw.pack.crypto-identity.pure.min.js +4 -4
  18. package/dist/build/fw.pwa.pure.meta.json +7 -6
  19. package/dist/build/fw.pwa.pure.min.js +38 -35
  20. package/dist/build/fw.site-interactive.pure.meta.json +6 -6
  21. package/dist/build/fw.site-interactive.pure.min.js +37 -34
  22. package/dist/build/fw.site.pure.meta.json +6 -6
  23. package/dist/build/fw.site.pure.min.js +24 -21
  24. package/dist/build/fw.spa.pure.meta.json +8 -7
  25. package/dist/build/fw.spa.pure.min.js +41 -38
  26. package/dist/build/sanity-base-classic.min.js +1 -1
  27. package/dist/build/sanity.min.js +1 -1
  28. package/dist/types/core/internal.d.ts +29 -0
  29. package/dist/types/core/internal.d.ts.map +1 -0
  30. package/dist/types/core/logger.d.ts +23 -4
  31. package/dist/types/core/logger.d.ts.map +1 -1
  32. package/dist/types/core/modules.d.ts +374 -61
  33. package/dist/types/core/modules.d.ts.map +1 -1
  34. package/dist/types/core/runtime.d.ts +10 -6
  35. package/dist/types/core/runtime.d.ts.map +1 -1
  36. package/dist/types/core/worker-helper.d.ts +35 -0
  37. package/dist/types/core/worker-helper.d.ts.map +1 -1
  38. package/dist/types/crypto/cipher/aes.d.ts +1 -7
  39. package/dist/types/crypto/cipher/aes.d.ts.map +1 -1
  40. package/dist/types/crypto/cipher/chacha20.d.ts +0 -10
  41. package/dist/types/crypto/cipher/chacha20.d.ts.map +1 -1
  42. package/dist/types/crypto/hash/argon2.d.ts +0 -15
  43. package/dist/types/crypto/hash/argon2.d.ts.map +1 -1
  44. package/dist/types/crypto/hash/blake2b.d.ts.map +1 -1
  45. package/dist/types/crypto/hash/hmac.d.ts.map +1 -1
  46. package/dist/types/crypto/hash/pbkdf2.d.ts.map +1 -1
  47. package/dist/types/crypto/hash/poly1305.d.ts.map +1 -1
  48. package/dist/types/crypto/hash/sha224.d.ts +1 -1
  49. package/dist/types/crypto/hash/sha256.d.ts +4 -13
  50. package/dist/types/crypto/hash/sha256.d.ts.map +1 -1
  51. package/dist/types/crypto/hash/sha3.d.ts.map +1 -1
  52. package/dist/types/crypto/hash/sha384.d.ts +1 -1
  53. package/dist/types/crypto/hash/sha512.d.ts +4 -13
  54. package/dist/types/crypto/hash/sha512.d.ts.map +1 -1
  55. package/dist/types/crypto/mode/cmac.d.ts +0 -6
  56. package/dist/types/crypto/mode/cmac.d.ts.map +1 -1
  57. package/dist/types/crypto/mode/ctr.d.ts +0 -6
  58. package/dist/types/crypto/mode/ctr.d.ts.map +1 -1
  59. package/dist/types/crypto/mode/gcm.d.ts +0 -9
  60. package/dist/types/crypto/mode/gcm.d.ts.map +1 -1
  61. package/dist/types/crypto/pkc/ecc.d.ts +0 -1
  62. package/dist/types/crypto/pkc/ecc.d.ts.map +1 -1
  63. package/dist/types/crypto/pkc/ed25519.d.ts +4 -25
  64. package/dist/types/crypto/pkc/ed25519.d.ts.map +1 -1
  65. package/dist/types/crypto/pkc/hybridSign.d.ts +25 -5
  66. package/dist/types/crypto/pkc/hybridSign.d.ts.map +1 -1
  67. package/dist/types/crypto/pkc/ml_dsa.d.ts +6 -26
  68. package/dist/types/crypto/pkc/ml_dsa.d.ts.map +1 -1
  69. package/dist/types/crypto/pkc/ml_kem.d.ts +0 -43
  70. package/dist/types/crypto/pkc/ml_kem.d.ts.map +1 -1
  71. package/dist/types/crypto/pkc/rsa.d.ts +0 -24
  72. package/dist/types/crypto/pkc/rsa.d.ts.map +1 -1
  73. package/dist/types/crypto/pkc/slh_dsa.d.ts +6 -16
  74. package/dist/types/crypto/pkc/slh_dsa.d.ts.map +1 -1
  75. package/dist/types/crypto/pkc/x25519.d.ts +0 -6
  76. package/dist/types/crypto/pkc/x25519.d.ts.map +1 -1
  77. package/dist/types/crypto/utils/bitArray.d.ts +0 -8
  78. package/dist/types/crypto/utils/bitArray.d.ts.map +1 -1
  79. package/dist/types/crypto/utils/jws.d.ts +6 -14
  80. package/dist/types/crypto/utils/jws.d.ts.map +1 -1
  81. package/dist/types/crypto/utils/keyformat.d.ts +52 -0
  82. package/dist/types/crypto/utils/keyformat.d.ts.map +1 -1
  83. package/dist/types/crypto/utils/random.d.ts +1 -10
  84. package/dist/types/crypto/utils/random.d.ts.map +1 -1
  85. package/dist/types/crypto/utils/rsaKeygen.d.ts +0 -10
  86. package/dist/types/crypto/utils/rsaKeygen.d.ts.map +1 -1
  87. package/dist/types/crypto/utils/uuid.d.ts.map +1 -1
  88. package/dist/types/crypto/utils/x509.d.ts +397 -0
  89. package/dist/types/crypto/utils/x509.d.ts.map +1 -0
  90. package/dist/types/crypto/wasm/argon2.d.ts +2 -1
  91. package/dist/types/crypto/wasm/argon2.d.ts.map +1 -1
  92. package/dist/types/crypto/wasm/pbkdf2.d.ts +2 -2
  93. package/dist/types/crypto/wasm/pbkdf2.d.ts.map +1 -1
  94. package/dist/types/crypto/wasm/rsa.d.ts.map +1 -1
  95. package/dist/types/crypto/wasm/runtime.d.ts +13 -0
  96. package/dist/types/crypto/wasm/runtime.d.ts.map +1 -1
  97. package/dist/types/crypto/webcrypto/aes.d.ts.map +1 -1
  98. package/dist/types/crypto/webcrypto/aeskw.d.ts.map +1 -1
  99. package/dist/types/crypto/webcrypto/digest.d.ts +0 -4
  100. package/dist/types/crypto/webcrypto/digest.d.ts.map +1 -1
  101. package/dist/types/crypto/webcrypto/rsa.d.ts.map +1 -1
  102. package/dist/types/dom/fs/fileIntake.d.ts +59 -0
  103. package/dist/types/dom/fs/fileIntake.d.ts.map +1 -0
  104. package/dist/types/dom/fs/fsAccess.d.ts.map +1 -1
  105. package/dist/types/dom/query/dnd.d.ts.map +1 -1
  106. package/dist/types/dom/query/sound.d.ts +89 -0
  107. package/dist/types/dom/query/sound.d.ts.map +1 -0
  108. package/dist/types/dom/rendering/chart.d.ts.map +1 -1
  109. package/dist/types/dom/rendering/component.d.ts +9 -3
  110. package/dist/types/dom/rendering/component.d.ts.map +1 -1
  111. package/dist/types/dom/rendering/parser.d.ts +39 -0
  112. package/dist/types/dom/rendering/parser.d.ts.map +1 -1
  113. package/dist/types/dom/rendering/render.d.ts.map +1 -1
  114. package/dist/types/dom/rendering/sanitize.d.ts +4 -0
  115. package/dist/types/dom/rendering/sanitize.d.ts.map +1 -1
  116. package/dist/types/dom/rendering/secPolicy.d.ts.map +1 -1
  117. package/dist/types/dom/rendering/styleSheet.d.ts +74 -0
  118. package/dist/types/dom/rendering/styleSheet.d.ts.map +1 -0
  119. package/dist/types/dom/rendering/template.d.ts +9 -3
  120. package/dist/types/dom/rendering/template.d.ts.map +1 -1
  121. package/dist/types/dom/rendering/themeTokens.d.ts +9 -3
  122. package/dist/types/dom/rendering/themeTokens.d.ts.map +1 -1
  123. package/dist/types/dom/rendering/uiSession-core.d.ts +9 -3
  124. package/dist/types/dom/rendering/uiSession-core.d.ts.map +1 -1
  125. package/dist/types/dom/rendering/uiSession-list.d.ts +9 -3
  126. package/dist/types/dom/rendering/uiSession-list.d.ts.map +1 -1
  127. package/dist/types/dom/rendering/uiSession.d.ts +18 -6
  128. package/dist/types/dom/rendering/uiSession.d.ts.map +1 -1
  129. package/dist/types/dom/sw/installPrompt.d.ts +89 -0
  130. package/dist/types/dom/sw/installPrompt.d.ts.map +1 -0
  131. package/dist/types/dom/sw/precache.d.ts +149 -0
  132. package/dist/types/dom/sw/precache.d.ts.map +1 -0
  133. package/dist/types/dom/sw/swUpdate.d.ts +129 -0
  134. package/dist/types/dom/sw/swUpdate.d.ts.map +1 -0
  135. package/dist/types/dom/utils/clipboard.d.ts +8 -0
  136. package/dist/types/dom/utils/clipboard.d.ts.map +1 -1
  137. package/dist/types/dom/utils/keybindings.d.ts.map +1 -1
  138. package/dist/types/dom/utils/route.d.ts.map +1 -1
  139. package/dist/types/dom/utils/ua.d.ts +2 -2
  140. package/dist/types/dom/utils/ua.d.ts.map +1 -1
  141. package/dist/types/io/calc/crc32.d.ts.map +1 -1
  142. package/dist/types/io/codec/b64.d.ts +24 -0
  143. package/dist/types/io/codec/b64.d.ts.map +1 -1
  144. package/dist/types/io/codec/cbor.d.ts +1 -0
  145. package/dist/types/io/codec/cbor.d.ts.map +1 -1
  146. package/dist/types/io/codec/hex.d.ts.map +1 -1
  147. package/dist/types/io/codec/msgpack.d.ts +1 -0
  148. package/dist/types/io/codec/msgpack.d.ts.map +1 -1
  149. package/dist/types/io/codec/url.d.ts +3 -1
  150. package/dist/types/io/codec/url.d.ts.map +1 -1
  151. package/dist/types/io/codec/utf8.d.ts.map +1 -1
  152. package/dist/types/io/compress/bitstream.d.ts +1 -1
  153. package/dist/types/io/compress/brotli.d.ts +0 -1
  154. package/dist/types/io/compress/brotli.d.ts.map +1 -1
  155. package/dist/types/io/compress/brotli_shared.d.ts +0 -4
  156. package/dist/types/io/compress/brotli_shared.d.ts.map +1 -1
  157. package/dist/types/io/compress/deflate.d.ts +14 -1
  158. package/dist/types/io/compress/deflate.d.ts.map +1 -1
  159. package/dist/types/io/compress/gzip.d.ts +4 -0
  160. package/dist/types/io/compress/gzip.d.ts.map +1 -1
  161. package/dist/types/io/compress/huffman.d.ts +7 -0
  162. package/dist/types/io/compress/huffman.d.ts.map +1 -1
  163. package/dist/types/io/compress/lz4.d.ts +4 -2
  164. package/dist/types/io/compress/lz4.d.ts.map +1 -1
  165. package/dist/types/io/compress/lz77.d.ts +17 -0
  166. package/dist/types/io/compress/lz77.d.ts.map +1 -1
  167. package/dist/types/io/compress/lzw.d.ts +2 -0
  168. package/dist/types/io/compress/lzw.d.ts.map +1 -1
  169. package/dist/types/io/compress/zip.d.ts.map +1 -1
  170. package/dist/types/io/compress/zlib.d.ts +9 -2
  171. package/dist/types/io/compress/zlib.d.ts.map +1 -1
  172. package/dist/types/io/math/linalg.d.ts.map +1 -1
  173. package/dist/types/process/rpc.d.ts.map +1 -1
  174. package/dist/types/process/workerPool.d.ts.map +1 -1
  175. package/dist/types/sanity/base.d.ts +12 -2
  176. package/dist/types/sanity/base.d.ts.map +1 -1
  177. package/dist/types/sanity/lockdown.d.ts +6 -5
  178. package/dist/types/sanity/lockdown.d.ts.map +1 -1
  179. package/dist/types/sanity/wasm-gate.d.ts +1 -1
  180. package/docs/README.md +17 -10
  181. package/docs/api/README.md +5 -5
  182. package/docs/api/core/logger.md +2 -1
  183. package/docs/api/core/modules.md +3 -3
  184. package/docs/api/core/runtime.md +9 -9
  185. package/docs/api/core/worker-helper.md +12 -2
  186. package/docs/api/crypto/README.md +1 -1
  187. package/docs/api/crypto/cipher/README.md +2 -2
  188. package/docs/api/crypto/cipher/aes.md +5 -10
  189. package/docs/api/crypto/cipher/chacha20.md +3 -8
  190. package/docs/api/crypto/hash/README.md +5 -5
  191. package/docs/api/crypto/hash/adf.md +21 -11
  192. package/docs/api/crypto/hash/argon2.md +3 -12
  193. package/docs/api/crypto/hash/blake2b.md +12 -14
  194. package/docs/api/crypto/hash/pbkdf2.md +1 -1
  195. package/docs/api/crypto/hash/sha224.md +2 -2
  196. package/docs/api/crypto/hash/sha256.md +4 -4
  197. package/docs/api/crypto/hash/sha3.md +2 -2
  198. package/docs/api/crypto/hash/sha384.md +1 -1
  199. package/docs/api/crypto/hash/sha512.md +5 -5
  200. package/docs/api/crypto/hash/sha512_224.md +1 -1
  201. package/docs/api/crypto/hash/sha512_256.md +1 -1
  202. package/docs/api/crypto/mode/README.md +3 -3
  203. package/docs/api/crypto/mode/cbc.md +2 -2
  204. package/docs/api/crypto/mode/chacha20poly1305.md +1 -1
  205. package/docs/api/crypto/mode/cmac.md +4 -4
  206. package/docs/api/crypto/mode/ctr.md +2 -3
  207. package/docs/api/crypto/mode/gcm.md +5 -5
  208. package/docs/api/crypto/mode/kw.md +4 -4
  209. package/docs/api/crypto/pkc/README.md +8 -8
  210. package/docs/api/crypto/pkc/ecc.md +19 -17
  211. package/docs/api/crypto/pkc/ed25519.md +10 -15
  212. package/docs/api/crypto/pkc/hybridKem.md +8 -2
  213. package/docs/api/crypto/pkc/hybridSign.md +34 -7
  214. package/docs/api/crypto/pkc/ml_dsa.md +20 -19
  215. package/docs/api/crypto/pkc/ml_kem.md +3 -3
  216. package/docs/api/crypto/pkc/rsa.md +7 -9
  217. package/docs/api/crypto/pkc/slh_dsa.md +12 -12
  218. package/docs/api/crypto/pkc/x25519.md +5 -4
  219. package/docs/api/crypto/utils/README.md +7 -7
  220. package/docs/api/crypto/utils/aes_modes.md +2 -5
  221. package/docs/api/crypto/utils/asn1.md +25 -16
  222. package/docs/api/crypto/utils/jws.md +6 -4
  223. package/docs/api/crypto/utils/keyformat.md +24 -15
  224. package/docs/api/crypto/utils/pad.md +1 -1
  225. package/docs/api/crypto/utils/pem.md +3 -3
  226. package/docs/api/crypto/utils/random.md +3 -4
  227. package/docs/api/crypto/utils/rsaKeygen.md +2 -2
  228. package/docs/api/crypto/utils/totp.md +2 -2
  229. package/docs/api/crypto/utils/uuid.md +5 -5
  230. package/docs/api/crypto/utils/x509.md +124 -0
  231. package/docs/api/crypto/wasm/aes.md +1 -1
  232. package/docs/api/crypto/wasm/argon2.md +6 -4
  233. package/docs/api/crypto/wasm/ml_kem.md +1 -0
  234. package/docs/api/crypto/wasm/pbkdf2.md +8 -8
  235. package/docs/api/crypto/wasm/rsa.md +1 -1
  236. package/docs/api/crypto/wasm/runtime.md +27 -10
  237. package/docs/api/crypto/webcrypto/aes.md +1 -1
  238. package/docs/api/crypto/webcrypto/aeskw.md +2 -2
  239. package/docs/api/crypto/webcrypto/digest.md +3 -5
  240. package/docs/api/crypto/webcrypto/ecc.md +1 -1
  241. package/docs/api/crypto/webcrypto/ed25519.md +1 -1
  242. package/docs/api/crypto/webcrypto/rsa.md +3 -2
  243. package/docs/api/crypto/webcrypto/x25519.md +1 -1
  244. package/docs/api/dom/README.md +6 -1
  245. package/docs/api/dom/fs/README.md +1 -0
  246. package/docs/api/dom/fs/fileIntake.md +120 -0
  247. package/docs/api/dom/fs/fsAccess.md +1 -0
  248. package/docs/api/dom/fs/indexedDB.md +1 -1
  249. package/docs/api/dom/fs/storage.md +1 -1
  250. package/docs/api/dom/query/README.md +2 -1
  251. package/docs/api/dom/query/dnd.md +4 -1
  252. package/docs/api/dom/query/dom.md +5 -0
  253. package/docs/api/dom/query/sound.md +103 -0
  254. package/docs/api/dom/rendering/README.md +4 -3
  255. package/docs/api/dom/rendering/chart.md +5 -4
  256. package/docs/api/dom/rendering/component.md +25 -3
  257. package/docs/api/dom/rendering/parser.md +5 -2
  258. package/docs/api/dom/rendering/reactiveBind.md +1 -1
  259. package/docs/api/dom/rendering/render.md +2 -2
  260. package/docs/api/dom/rendering/sanitize.md +10 -2
  261. package/docs/api/dom/rendering/secPolicy.md +4 -4
  262. package/docs/api/dom/rendering/styleSheet.md +85 -0
  263. package/docs/api/dom/rendering/template.md +20 -5
  264. package/docs/api/dom/rendering/themeTokens.md +6 -3
  265. package/docs/api/dom/rendering/uiSession.md +18 -5
  266. package/docs/api/dom/rendering/virtualScroll.md +2 -2
  267. package/docs/api/dom/sensors/geolocation.md +1 -1
  268. package/docs/api/dom/sw/README.md +7 -1
  269. package/docs/api/dom/sw/cache.md +2 -1
  270. package/docs/api/dom/sw/installPrompt.md +111 -0
  271. package/docs/api/dom/sw/precache.md +124 -0
  272. package/docs/api/dom/sw/serviceWorker.md +4 -2
  273. package/docs/api/dom/sw/swUpdate.md +112 -0
  274. package/docs/api/dom/utils/clipboard.md +56 -5
  275. package/docs/api/dom/utils/entropyCollector.md +1 -1
  276. package/docs/api/dom/utils/keybindings.md +17 -2
  277. package/docs/api/dom/utils/leaderElection.md +2 -2
  278. package/docs/api/dom/utils/route.md +1 -0
  279. package/docs/api/dom/utils/ua.md +15 -10
  280. package/docs/api/io/calc/crc32.md +4 -1
  281. package/docs/api/io/codec/README.md +2 -2
  282. package/docs/api/io/codec/b64.md +31 -2
  283. package/docs/api/io/codec/buffer.md +1 -1
  284. package/docs/api/io/codec/cbor.md +6 -4
  285. package/docs/api/io/codec/csv.md +178 -178
  286. package/docs/api/io/codec/hex.md +10 -2
  287. package/docs/api/io/codec/msgpack.md +4 -3
  288. package/docs/api/io/codec/url.md +4 -3
  289. package/docs/api/io/codec/utf8.md +3 -3
  290. package/docs/api/io/compress/bitstream.md +6 -3
  291. package/docs/api/io/compress/brotli.md +36 -4
  292. package/docs/api/io/compress/brotli_shared.md +1 -1
  293. package/docs/api/io/compress/deflate.md +42 -34
  294. package/docs/api/io/compress/gzip.md +26 -6
  295. package/docs/api/io/compress/huffman.md +2 -1
  296. package/docs/api/io/compress/lz4.md +5 -3
  297. package/docs/api/io/compress/lz77.md +26 -3
  298. package/docs/api/io/compress/lzw.md +13 -8
  299. package/docs/api/io/compress/zip.md +36 -10
  300. package/docs/api/io/compress/zlib.md +21 -5
  301. package/docs/api/io/math/linalg.md +1 -1
  302. package/docs/api/io/utils/valid.md +1 -1
  303. package/docs/api/process/rpc.md +3 -2
  304. package/docs/api/process/workerPool.md +1 -1
  305. package/docs/api/sanity/base.md +9 -5
  306. package/docs/api/sanity/lockdown.md +7 -6
  307. package/docs/api/surface.json +12311 -0
  308. package/docs/api/typed.md +5 -3
  309. package/docs/dev/README.md +2 -0
  310. package/docs/dev/bench.md +76 -0
  311. package/docs/dev/crypto-references.md +54 -0
  312. package/docs/dev/provenance.md +30 -7
  313. package/docs/dev/publishing.md +7 -7
  314. package/docs/dev/runtime.md +1 -1
  315. package/docs/dev/testing.md +13 -0
  316. package/docs/evidence/l4-evidence.md +86 -0
  317. package/docs/evidence/pqc-hybrid-evidence.md +7 -6
  318. package/docs/guide/README.md +1 -0
  319. package/docs/guide/_QUICK_REF.md +5 -5
  320. package/docs/guide/doc-format.md +4 -3
  321. package/docs/guide/integrations-hmr.md +1 -1
  322. package/docs/guide/module-creation-workflow.md +8 -8
  323. package/docs/guide/rendering-pipeline.md +11 -4
  324. package/docs/guide/security.md +7 -5
  325. package/docs/guide/stability.md +123 -0
  326. package/docs/guide/tutorial-todo.md +20 -8
  327. package/docs/guide/typescript.md +9 -0
  328. package/docs/guide/worker-confinement.md +30 -17
  329. package/docs/notes/lz77-deflate-factorization.md +3 -3
  330. package/docs/tools/README.md +1 -1
  331. package/docs/tools/bundler.md +3 -3
  332. package/docs/tools/codegen.md +1 -1
  333. package/docs/tools/standalone.md +0 -1
  334. package/fw.config.json +2 -2
  335. package/integrations/_shared/catalog.generated.json +7 -1
  336. package/integrations/_shared/core.js +1 -1
  337. package/integrations/astro/index.js +1 -1
  338. package/integrations/eslint/README.md +7 -1
  339. package/integrations/nextjs/index.js +1 -1
  340. package/integrations/nodejs/README.md +3 -3
  341. package/integrations/turbopack/index.js +2 -2
  342. package/integrations/typedoc/categorize.js +1 -1
  343. package/integrations/typedoc/typedoc.json +2 -1
  344. package/integrations/vite/index.js +2 -2
  345. package/integrations/vite/vite-env.d.ts +7 -4
  346. package/integrations/webpack/index.js +3 -3
  347. package/package.json +76 -10
  348. package/src/core/internal.js +31 -0
  349. package/src/core/logger.js +95 -23
  350. package/src/core/modules.js +17 -8
  351. package/src/core/readyState.js +1 -1
  352. package/src/core/runtime.js +74 -27
  353. package/src/core/worker-helper.js +83 -4
  354. package/src/crypto/NIST_CONFORMANCE.md +47 -34
  355. package/src/crypto/cipher/aes.acvp.md +7 -8
  356. package/src/crypto/cipher/aes.js +280 -229
  357. package/src/crypto/cipher/chacha20.acvp.md +6 -7
  358. package/src/crypto/cipher/chacha20.js +91 -61
  359. package/src/crypto/hash/adf.js +1 -1
  360. package/src/crypto/hash/argon2.acvp.md +11 -15
  361. package/src/crypto/hash/argon2.js +9 -24
  362. package/src/crypto/hash/blake2b.js +157 -125
  363. package/src/crypto/hash/hkdf.acvp.md +15 -15
  364. package/src/crypto/hash/hkdf.js +1 -1
  365. package/src/crypto/hash/hmac.acvp.md +10 -12
  366. package/src/crypto/hash/hmac.js +5 -1
  367. package/src/crypto/hash/pbkdf2.acvp.md +13 -13
  368. package/src/crypto/hash/pbkdf2.js +36 -8
  369. package/src/crypto/hash/poly1305.acvp.md +10 -6
  370. package/src/crypto/hash/poly1305.js +171 -50
  371. package/src/crypto/hash/sha224.acvp.md +3 -3
  372. package/src/crypto/hash/sha224.js +4 -4
  373. package/src/crypto/hash/sha256.acvp.md +2 -2
  374. package/src/crypto/hash/sha256.js +514 -50
  375. package/src/crypto/hash/sha3.acvp.md +9 -9
  376. package/src/crypto/hash/sha3.js +127 -71
  377. package/src/crypto/hash/sha384.acvp.md +3 -3
  378. package/src/crypto/hash/sha384.js +4 -4
  379. package/src/crypto/hash/sha512.acvp.md +7 -8
  380. package/src/crypto/hash/sha512.js +107 -108
  381. package/src/crypto/hash/sha512_224.acvp.md +6 -6
  382. package/src/crypto/hash/sha512_224.js +2 -2
  383. package/src/crypto/hash/sha512_256.acvp.md +6 -6
  384. package/src/crypto/hash/sha512_256.js +2 -2
  385. package/src/crypto/mode/cbc.acvp.md +2 -2
  386. package/src/crypto/mode/cbc.js +1 -1
  387. package/src/crypto/mode/chacha20poly1305.acvp.md +6 -6
  388. package/src/crypto/mode/chacha20poly1305.js +3 -3
  389. package/src/crypto/mode/cmac.acvp.md +5 -5
  390. package/src/crypto/mode/cmac.js +8 -8
  391. package/src/crypto/mode/ctr.acvp.md +2 -2
  392. package/src/crypto/mode/ctr.js +1 -3
  393. package/src/crypto/mode/gcm.acvp.md +6 -6
  394. package/src/crypto/mode/gcm.js +7 -7
  395. package/src/crypto/mode/kw.acvp.md +4 -4
  396. package/src/crypto/mode/kw.js +5 -5
  397. package/src/crypto/pkc/ecc.acvp.md +13 -13
  398. package/src/crypto/pkc/ecc.js +9 -11
  399. package/src/crypto/pkc/ed25519.acvp.md +30 -34
  400. package/src/crypto/pkc/ed25519.js +453 -94
  401. package/src/crypto/pkc/hybrid-kat.provenance.md +4 -4
  402. package/src/crypto/pkc/hybridSign.js +103 -24
  403. package/src/crypto/pkc/ml_dsa.acvp.md +18 -18
  404. package/src/crypto/pkc/ml_dsa.js +29 -32
  405. package/src/crypto/pkc/ml_kem.acvp.md +7 -7
  406. package/src/crypto/pkc/ml_kem.js +15 -21
  407. package/src/crypto/pkc/rsa.acvp.md +11 -15
  408. package/src/crypto/pkc/rsa.js +7 -44
  409. package/src/crypto/pkc/slh_dsa.acvp.md +16 -16
  410. package/src/crypto/pkc/slh_dsa.js +16 -18
  411. package/src/crypto/pkc/x25519.acvp.md +13 -10
  412. package/src/crypto/pkc/x25519.js +273 -29
  413. package/src/crypto/utils/aes_modes.acvp.md +1 -2
  414. package/src/crypto/utils/aes_modes.js +2 -2
  415. package/src/crypto/utils/asn1-oid.js +1 -1
  416. package/src/crypto/utils/asn1.js +1 -1
  417. package/src/crypto/utils/bitArray.js +33 -48
  418. package/src/crypto/utils/bn.js +1 -1
  419. package/src/crypto/utils/jws.js +37 -41
  420. package/src/crypto/utils/keyformat.js +181 -2
  421. package/src/crypto/utils/pem.js +1 -1
  422. package/src/crypto/utils/random.acvp.md +5 -5
  423. package/src/crypto/utils/random.js +845 -846
  424. package/src/crypto/utils/rsaKeygen.acvp.md +3 -2
  425. package/src/crypto/utils/rsaKeygen.js +6 -6
  426. package/src/crypto/utils/totp.js +1 -1
  427. package/src/crypto/utils/uuid.acvp.md +5 -5
  428. package/src/crypto/utils/uuid.js +11 -10
  429. package/src/crypto/utils/x509.js +591 -0
  430. package/src/crypto/wasm/aes.js +1 -1
  431. package/src/crypto/wasm/aes.scalar.wasm +0 -0
  432. package/src/crypto/wasm/argon2.js +17 -1
  433. package/src/crypto/wasm/argon2.scalar.wasm +0 -0
  434. package/src/crypto/wasm/blake2b.scalar.wasm +0 -0
  435. package/src/crypto/wasm/blake2b.simd.wasm +0 -0
  436. package/src/crypto/wasm/chacha20poly1305.scalar.wasm +0 -0
  437. package/src/crypto/wasm/chacha20poly1305.simd.wasm +0 -0
  438. package/src/crypto/wasm/cmac.scalar.wasm +0 -0
  439. package/src/crypto/wasm/ecc.js +3 -3
  440. package/src/crypto/wasm/ecc.scalar.wasm +0 -0
  441. package/src/crypto/wasm/ed25519.js +1 -1
  442. package/src/crypto/wasm/ed25519.scalar.wasm +0 -0
  443. package/src/crypto/wasm/hkdf.scalar.wasm +0 -0
  444. package/src/crypto/wasm/hmac.scalar.wasm +0 -0
  445. package/src/crypto/wasm/ml_dsa.js +2 -2
  446. package/src/crypto/wasm/ml_dsa.scalar.wasm +0 -0
  447. package/src/crypto/wasm/ml_dsa.simd.wasm +0 -0
  448. package/src/crypto/wasm/ml_kem.js +2 -2
  449. package/src/crypto/wasm/ml_kem.scalar.wasm +0 -0
  450. package/src/crypto/wasm/ml_kem.simd.wasm +0 -0
  451. package/src/crypto/wasm/pbkdf2.js +8 -6
  452. package/src/crypto/wasm/pbkdf2.scalar.wasm +0 -0
  453. package/src/crypto/wasm/rsa.js +6 -5
  454. package/src/crypto/wasm/rsa.scalar.wasm +0 -0
  455. package/src/crypto/wasm/runtime.js +84 -17
  456. package/src/crypto/wasm/sha2.scalar.wasm +0 -0
  457. package/src/crypto/wasm/sha3.scalar.wasm +0 -0
  458. package/src/crypto/wasm/sha3.simd.wasm +0 -0
  459. package/src/crypto/wasm/slh_dsa.js +1 -1
  460. package/src/crypto/wasm/slh_dsa.scalar.wasm +0 -0
  461. package/src/crypto/wasm/x25519.js +1 -1
  462. package/src/crypto/wasm/x25519.scalar.wasm +0 -0
  463. package/src/crypto/webcrypto/aes.js +8 -2
  464. package/src/crypto/webcrypto/aeskw.js +7 -2
  465. package/src/crypto/webcrypto/digest.js +1 -15
  466. package/src/crypto/webcrypto/ecc.js +2 -2
  467. package/src/crypto/webcrypto/ed25519.js +2 -2
  468. package/src/crypto/webcrypto/hmac.js +2 -2
  469. package/src/crypto/webcrypto/rsa.js +7 -2
  470. package/src/crypto/webcrypto/x25519.js +2 -2
  471. package/src/dom/display/animate.js +1 -1
  472. package/src/dom/display/fullscreen.js +1 -1
  473. package/src/dom/fs/download.js +1 -1
  474. package/src/dom/fs/fileIntake.js +192 -0
  475. package/src/dom/fs/fsAccess.js +2 -3
  476. package/src/dom/fs/indexedDB.js +1 -1
  477. package/src/dom/fs/remoteStore.js +1 -1
  478. package/src/dom/fs/storage.js +1 -1
  479. package/src/dom/lifecycle/idle.js +1 -1
  480. package/src/dom/lifecycle/visibility.js +1 -1
  481. package/src/dom/lifecycle/wakeLock.js +1 -1
  482. package/src/dom/net/ajax.js +1 -1
  483. package/src/dom/net/network.js +1 -1
  484. package/src/dom/net/sse.js +1 -1
  485. package/src/dom/net/webrtc.js +1 -1
  486. package/src/dom/net/ws.js +1 -1
  487. package/src/dom/query/dnd.js +56 -4
  488. package/src/dom/query/dom.js +1 -1
  489. package/src/dom/query/events.js +1 -1
  490. package/src/dom/query/gesture.js +1 -1
  491. package/src/dom/query/media.js +1 -1
  492. package/src/dom/query/sound.js +333 -0
  493. package/src/dom/rendering/chart.js +736 -663
  494. package/src/dom/rendering/component.js +25 -14
  495. package/src/dom/rendering/devtools.js +2 -2
  496. package/src/dom/rendering/parser.js +155 -12
  497. package/src/dom/rendering/render.js +14 -4
  498. package/src/dom/rendering/sanitize.js +11 -4
  499. package/src/dom/rendering/secPolicy.js +6 -4
  500. package/src/dom/rendering/styleSheet.js +217 -0
  501. package/src/dom/rendering/template.js +72 -13
  502. package/src/dom/rendering/themeTokens.js +542 -522
  503. package/src/dom/rendering/uiSession-core.js +51 -6
  504. package/src/dom/rendering/uiSession-direct.js +1 -1
  505. package/src/dom/rendering/uiSession-list.js +4 -4
  506. package/src/dom/rendering/uiSession.js +1 -1
  507. package/src/dom/rendering/virtualScroll.js +341 -341
  508. package/src/dom/sensors/battery.js +1 -1
  509. package/src/dom/sensors/geolocation.js +1 -1
  510. package/src/dom/sensors/networkInfo.js +1 -1
  511. package/src/dom/sensors/sensors.js +1 -1
  512. package/src/dom/sw/backgroundSync.js +1 -1
  513. package/src/dom/sw/cache.js +1 -1
  514. package/src/dom/sw/installPrompt.js +151 -0
  515. package/src/dom/sw/precache.js +257 -0
  516. package/src/dom/sw/push.js +1 -1
  517. package/src/dom/sw/sharedWorker.js +1 -1
  518. package/src/dom/sw/swUpdate.js +239 -0
  519. package/src/dom/utils/a11y.js +1 -1
  520. package/src/dom/utils/clipboard.js +56 -6
  521. package/src/dom/utils/entropyCollector.js +1 -1
  522. package/src/dom/utils/focus.js +1 -1
  523. package/src/dom/utils/form.js +1 -1
  524. package/src/dom/utils/keybindings.js +600 -574
  525. package/src/dom/utils/leaderElection.js +1 -1
  526. package/src/dom/utils/notifications.js +1 -1
  527. package/src/dom/utils/permissions.js +107 -107
  528. package/src/dom/utils/route.js +14 -2
  529. package/src/dom/utils/ua.js +42 -28
  530. package/src/dom/utils/webauthn.js +1 -1
  531. package/src/io/binary/reader.js +1 -1
  532. package/src/io/binary/writer.js +1 -1
  533. package/src/io/calc/bigint.js +1 -1
  534. package/src/io/calc/crc32.js +28 -2
  535. package/src/io/calc/easing.js +514 -514
  536. package/src/io/codec/b64.js +189 -52
  537. package/src/io/codec/base32.js +1 -1
  538. package/src/io/codec/base58.js +1 -1
  539. package/src/io/codec/buffer.js +1 -1
  540. package/src/io/codec/cbor.js +111 -18
  541. package/src/io/codec/csv.js +1 -1
  542. package/src/io/codec/hex.js +51 -6
  543. package/src/io/codec/mime.js +1 -1
  544. package/src/io/codec/msgpack.js +47 -6
  545. package/src/io/codec/url.js +24 -7
  546. package/src/io/codec/utf8.js +5 -3
  547. package/src/io/codec/xml.js +1 -1
  548. package/src/io/compress/bitstream.js +2 -2
  549. package/src/io/compress/brotli.js +663 -163
  550. package/src/io/compress/brotli_dict.js +1 -1
  551. package/src/io/compress/brotli_dict_words.js +1 -1
  552. package/src/io/compress/brotli_frame.js +1 -1
  553. package/src/io/compress/brotli_shared.js +7 -7
  554. package/src/io/compress/deflate.js +87 -53
  555. package/src/io/compress/gzip.js +187 -74
  556. package/src/io/compress/huffman.js +24 -1
  557. package/src/io/compress/lz4.js +45 -7
  558. package/src/io/compress/lz77.js +148 -63
  559. package/src/io/compress/lzw.js +35 -19
  560. package/src/io/compress/zip.js +862 -815
  561. package/src/io/compress/zlib.js +87 -7
  562. package/src/io/i18n/i18n.js +1 -1
  563. package/src/io/math/fixed-point.js +1 -1
  564. package/src/io/math/geom.js +1 -1
  565. package/src/io/math/interp.js +1 -1
  566. package/src/io/math/linalg.js +10 -4
  567. package/src/io/math/stats.js +1 -1
  568. package/src/io/structures/btree.js +1 -1
  569. package/src/io/structures/heap.js +1 -1
  570. package/src/io/structures/lruCache.js +1 -1
  571. package/src/io/structures/ringBuffer.js +1 -1
  572. package/src/io/structures/tree-walker.js +1 -1
  573. package/src/io/structures/trie.js +1 -1
  574. package/src/io/sync/abort.js +1 -1
  575. package/src/io/sync/atomics.js +1 -1
  576. package/src/io/sync/cancellable.js +1 -1
  577. package/src/io/sync/channel.js +1 -1
  578. package/src/io/sync/mutex.js +1 -1
  579. package/src/io/sync/semaphore.js +1 -1
  580. package/src/io/sync/tokenBucket.js +1 -1
  581. package/src/io/text/ansi.js +1 -1
  582. package/src/io/text/html-entities.js +1 -1
  583. package/src/io/time/date.js +1 -1
  584. package/src/io/timing/clock.js +1 -1
  585. package/src/io/timing/rateLimit.js +1 -1
  586. package/src/io/timing/scheduler.js +1 -1
  587. package/src/io/utils/errors.js +1 -1
  588. package/src/io/utils/eventBus.js +1 -1
  589. package/src/io/utils/signal.js +1 -1
  590. package/src/io/utils/valid.js +1 -1
  591. package/src/main.js +1 -1
  592. package/src/process/message.js +1 -1
  593. package/src/process/rpc.js +7 -3
  594. package/src/process/workerPool.js +11 -4
  595. package/src/sanity/base.js +85 -39
  596. package/src/sanity/lockdown-apply.js +3 -3
  597. package/src/sanity/lockdown.js +58 -32
  598. package/src/sanity/wasm-gate.js +2 -2
  599. package/src/typed.js +7 -3
  600. package/third-party/NOTICE-brotli-dictionary.txt +69 -0
  601. package/third-party/NOTICE-fw-wasm-crypto.txt +576 -0
  602. package/third-party/NOTICE-whatwg-entities.txt +44 -0
  603. package/types/registry.generated.d.ts +7 -1
  604. package/types/typed.d.ts +7 -3
  605. package/dist/types/crypto/utils/aes_ctr.d.ts +0 -84
  606. package/dist/types/crypto/utils/aes_ctr.d.ts.map +0 -1
  607. package/docs/api/crypto/utils/aes_ctr.md +0 -71
  608. package/src/crypto/utils/aes_ctr.acvp.md +0 -67
  609. package/src/crypto/utils/aes_ctr.js +0 -134
@@ -1,4 +1,4 @@
1
- // Copyright (c) 2026 AwaCloud SAS
1
+ // Copyright (c) 2026 AwaCloud SAS
2
2
  // Author: Matthieu Bouilloux
3
3
  // SPDX-License-Identifier: Apache-2.0
4
4
 
@@ -31,7 +31,6 @@ import { bitArray } from '../utils/bitArray.js';
31
31
  * @typedef {object} CtrAPI
32
32
  * @property {(prf: {encrypt: Function}, plaintext: number[], iv: number[]) => (number[]|false)} encrypt Encrypt in CTR mode.
33
33
  * @property {(prf: {encrypt: Function}, ciphertext: number[], iv: number[]) => (number[]|false)} decrypt Decrypt in CTR mode (identical to encrypt).
34
- * @property {(prf: {encrypt: Function}, data: number[], iv: number[]) => (number[]|false)} _calculate Internal CTR core.
35
34
  * @property {(ui8a: (Uint8Array|number[]), pos: number) => (Uint8Array|number[])} ui8_increase Advance a 16-byte counter by ⌊pos/16⌋ blocks.
36
35
  * @property {(ui8a: (Uint8Array|number[]), pos: number) => (Uint8Array|number[])} ui8_increase_384 As `ui8_increase` over the last 16 bytes of a 48-byte buffer.
37
36
  */
@@ -166,7 +165,6 @@ export const ctr = {
166
165
  return _calculate(prf, ciphertext, iv);
167
166
  },
168
167
 
169
- _calculate,
170
168
  ui8_increase,
171
169
  ui8_increase_384
172
170
  };
@@ -23,7 +23,7 @@ or via GHASH for ivLen ≠ 96. PRF: 128-bit block cipher (`encrypt(block)`),
23
23
 
24
24
  API: `encrypt(prf, pt, iv, aad, tlen)` → `{ ct, tag }`; `decrypt(prf,
25
25
  ct, iv, aad, tag, tlen)` → `pt | false` (plaintext is never released on
26
- an invalid tag; `console.error('CORRUPT:')`). GMAC: `gmac(prf, aad, iv,
26
+ an invalid tag; `console.warn('CORRUPT:')`). GMAC: `gmac(prf, aad, iv,
27
27
  tlen)` / `gmacVerify(prf, aad, iv, tag, tlen)`. Nonce safeguard:
28
28
  `nonceTracker(prf)` (in-process Set of seen IVs, refuses duplicates).
29
29
 
@@ -35,8 +35,8 @@ tlen)` / `gmacVerify(prf, aad, iv, tag, tlen)`. Nonce safeguard:
35
35
  |---|---|---|---|
36
36
  | McGrew-Viega §B | TC 1-6, 13-14 | `AES-128-GCM, McGrew-Viega test case 1..6` + `AES-256-GCM TC 13/14` | KAT byte-exact + round-trip + GHASH-J0 (TC 5/6) |
37
37
  | McGrew-Viega §B | TC 5 (64-bit IV) + TC 6 (480-bit IV) | `non-96-bit IV uses GHASH-derived J0` | alternate J0 code path |
38
- | **McGrew-Viega §B (D1)** | TC 7-12 (AES-192) | `AES-192-GCM, test case 7..12` | KAT byte-exact for AES-192 × {empty, single block, multi-block, AAD, 96/64/480-bit IV}. Cross-checked reference against Node `createCipheriv('aes-192-gcm')` (= OpenSSL libcrypto). |
39
- | **McGrew-Viega §B (D1)** | TC 15-18 (AES-256 extended) | `AES-256-GCM, test case 15..18` | KAT byte-exact extending AES-256 coverage (previously limited to TC 13/14 = empty + single block) to TC 15-18 = full multi-block + AAD + 64/480-bit IV. |
38
+ | **McGrew-Viega §B** | TC 7-12 (AES-192) | `AES-192-GCM, test case 7..12` | KAT byte-exact for AES-192 × {empty, single block, multi-block, AAD, 96/64/480-bit IV}. Cross-checked reference against Node `createCipheriv('aes-192-gcm')` (= OpenSSL libcrypto). |
39
+ | **McGrew-Viega §B** | TC 15-18 (AES-256 extended) | `AES-256-GCM, test case 15..18` | KAT byte-exact extending AES-256 coverage (previously limited to TC 13/14 = empty + single block) to TC 15-18 = full multi-block + AAD + 64/480-bit IV. |
40
40
  | **ACVP-AES-GCM-1.0** | AFT encrypt 30/30 (tg 1, 2) | `AFT encrypt` | KAT byte-exact ct + tag (ivLen 96/120, payloadLen 0/120, aadLen 0/120, tagLen 32/128) |
41
41
  | **ACVP-AES-GCM-1.0** | AFT decrypt 30/30 (tg 3, 4) | `AFT decrypt` | Pass/fail labels honored (10 fail / 30 = `{ corrupt ct/tag/iv/aad }` rejected) |
42
42
  | **ACVP-AES-GMAC-1.0** | AFT encrypt 30/30 (tg 1, 2) | `gmac AFT encrypt` | GMAC tag byte-exact via `gcm.gmac(prf, aad, iv, tlen)` |
@@ -89,7 +89,7 @@ validate rejection of forged tags.
89
89
  | Requirement | Status | Evidence |
90
90
  |---|---|---|
91
91
  | Approved algorithm | ✅ | SP 800-38D + ACVP-AES-GCM-1.0 + ACVP-AES-GMAC-1.0 |
92
- | Validated parameter sizes | ✅ | **AES-128**: 60 ACVP-AES-GCM-1.0 + McGrew-Viega TC 1-6. **AES-192**: McGrew-Viega TC 7-12 (D1). **AES-256**: McGrew-Viega TC 13-18 (D1). All 3 keyLen × {96-bit IV, 64-bit IV, 480-bit IV} × {empty AAD, non-empty AAD} × {payload 0/16/60/64 bytes} covered byte-exact. |
92
+ | Validated parameter sizes | ✅ | **AES-128**: 60 ACVP-AES-GCM-1.0 + McGrew-Viega TC 1-6. **AES-192**: McGrew-Viega TC 7-12. **AES-256**: McGrew-Viega TC 13-18. All 3 keyLen × {96-bit IV, 64-bit IV, 480-bit IV} × {empty AAD, non-empty AAD} × {payload 0/16/60/64 bytes} covered byte-exact. |
93
93
  | KAT power-on / self-test | ✅ | McGrew-Viega + 120 ACVP executed on every `bun test` |
94
94
  | CT comparisons (if secret) | ✅ | `bitArray.equal` (no early exit) |
95
95
  | No `throw` / timing leak | ✅ | Reviewed: `console.warn`/`console.error` + `return false` |
@@ -97,7 +97,7 @@ validate rejection of forged tags.
97
97
 
98
98
  ## Known limitations
99
99
 
100
- - ~~**AES-192 / AES-256 outside integrated ACVP**~~ ✅ **Iteration D1** —
100
+ - ~~**AES-192 / AES-256 outside integrated ACVP**~~ ✅
101
101
  **McGrew-Viega TC 7-12 (AES-192) + TC 15-18 (AES-256 extended)** added.
102
102
  The supplied ACVP-AES-GCM-1.0 suite still only covers `keyLen=128`
103
103
  (60 tests), but McGrew-Viega §B is the historical **canonical source**
@@ -123,7 +123,7 @@ validate rejection of forged tags.
123
123
  ## Cross-references
124
124
 
125
125
  - Module: [`mode/gcm.js`](./gcm.js)
126
- - Tests: [`mode/gcm.test.js`](https://github.com/awacloud/awa/blob/main/packages/front/fw/src/crypto/mode/gcm.test.js) — 156 tests (143 baseline + 13 McGrew-Viega TC 7-12 / 15-18 [D1])
126
+ - Tests: [`mode/gcm.test.js`](https://github.com/awacloud/awa/blob/main/packages/front/fw/src/crypto/mode/gcm.test.js) — 156 tests (143 baseline + 13 McGrew-Viega TC 7-12 / 15-18)
127
127
  - ACVP draft: `references/NIST/ACVP/src/draft-celi-acvp-symmetric.adoc`
128
128
  - Vectors: `references/NIST/ACVP-Server-1.1.0.42/gen-val/json-files/ACVP-AES-GCM-1.0/` + `ACVP-AES-GMAC-1.0/`
129
129
  - Overall conformance: [`NIST_CONFORMANCE.md`](../NIST_CONFORMANCE.md)
@@ -1,4 +1,4 @@
1
- // Copyright (c) 2026 AwaCloud SAS
1
+ // Copyright (c) 2026 AwaCloud SAS
2
2
  // Author: Matthieu Bouilloux
3
3
  // SPDX-License-Identifier: Apache-2.0
4
4
 
@@ -51,7 +51,6 @@ import { bitArray } from '../utils/bitArray.js';
51
51
  * @property {(prf: {encrypt: Function}, adata: number[], iv: number[], tlen?: number) => (number[]|false)} gmac GMAC tag over AAD only.
52
52
  * @property {(prf: {encrypt: Function}, adata: number[], iv: number[], tag: number[], tlen?: number) => boolean} gmacVerify Constant-time GMAC verification.
53
53
  * @property {(prf: {encrypt: Function}) => GcmNonceTracker} nonceTracker Wrap a PRF in an in-process nonce-uniqueness guard.
54
- * @property {{ ghash: (H: number[], data: number[]) => number[], gctr: (prf: {encrypt: Function}, icb: number[], data: number[]) => number[] }} _internal Internal primitives (KAT tests only).
55
54
  */
56
55
 
57
56
  export const gcm = {
@@ -251,7 +250,7 @@ export const gcm = {
251
250
  const expected = _authTag(prf, H, J0, adata, ciphertext, tlen);
252
251
 
253
252
  if (!bitArray.equal(bitArray.clamp(tag, tlen), expected)) {
254
- console.error('[crypto] CORRUPT: gcm: authentication tag mismatch');
253
+ console.warn('[crypto] CORRUPT: gcm: authentication tag mismatch');
255
254
  return false;
256
255
  }
257
256
  return _gctr(prf, _incCb(J0), ciphertext);
@@ -320,14 +319,15 @@ export const gcm = {
320
319
  };
321
320
  }
322
321
 
323
- return /** @type {GcmAPI} */ (/** @type {any} */ ({
322
+ return /** @type {GcmAPI} */ (/** @type {any} */ (Object.defineProperty({
324
323
  encrypt,
325
324
  decrypt,
326
325
  gmac,
327
326
  gmacVerify,
328
- nonceTracker,
327
+ nonceTracker
328
+ }, Symbol.for('@awacloud/fw/internal'), {
329
329
  // Internal primitives - exposed for KAT tests only. Not API.
330
- _internal: { ghash: _ghash, gctr: _gctr }
331
- }));
330
+ value: { ghash: _ghash, gctr: _gctr }
331
+ })));
332
332
  }
333
333
  };
@@ -92,13 +92,13 @@ the constant-time IV+length+padding check (KWP).
92
92
  - [x] **Rejection of empty input in KWP** — `kwp: plaintext must not be empty`.
93
93
  - [x] **Rejection of non-multiple-of-8 input in KW** — `kw: plaintext length
94
94
  must be a positive multiple of 8 bytes`.
95
- - [x] **`kwCipher=inverse` variant** ✅ **Iteration D2** — explicit reject.
95
+ - [x] **`kwCipher=inverse` variant** ✅ explicit reject.
96
96
  Exports `wrapInverseCipher()` / `unwrapInverseCipher()` return
97
97
  `false` + a typed `NOT-IMPLEMENTED` warning. Avoids any silent use
98
98
  of the SP 800-38F §6.3 variant (`CIPH_K⁻¹` in the wrap direction,
99
99
  rare outside embedded TPM). If documented need arises, the
100
100
  implementation will need to be added and separately audited.
101
- - [x] **Rejection of TDES (and other non-AES)** ✅ **Iteration D2** — `_checkBlockSize`
101
+ - [x] **Rejection of TDES (and other non-AES)** ✅ `_checkBlockSize`
102
102
  rejects any PRF with `blockSize !== 16` (TDES = 8 bytes). SP 800-131A
103
103
  §2.4 deprecates 3DES since 2024; SP 800-38F §6.2 mandates AES.
104
104
  - [ ] **Side-channel on AES** — delegated to `aes.js`.
@@ -121,7 +121,7 @@ the constant-time IV+length+padding check (KWP).
121
121
  Our `kw.js` only implements the `cipher` variant (forward `W`), which
122
122
  is the dominant form in TLS/PKCS#8/JOSE. The ACVP provides 3600
123
123
  `inverse` vectors per suite (50 % of the total) which are filtered
124
- out. **Iteration D2**: added `wrapInverseCipher()` / `unwrapInverseCipher()`
124
+ out. `wrapInverseCipher()` / `unwrapInverseCipher()`
125
125
  exports that return `false` + `console.warn('NOT-IMPLEMENTED')` to
126
126
  prevent any silent use by a consumer that believes it has inverse KW-AE.
127
127
  - **No asymmetric KW-AE/KW-AD**: the `wrap`/`unwrap`
@@ -139,7 +139,7 @@ the constant-time IV+length+padding check (KWP).
139
139
  ## Cross-references
140
140
 
141
141
  - Module: [`mode/kw.js`](./kw.js)
142
- - Tests: [`mode/kw.test.js`](https://github.com/awacloud/awa/blob/main/packages/front/fw/src/crypto/mode/kw.test.js) — 240 tests (233 baseline + 7 iteration D2: KW-AE inverse explicit reject + TDES guards)
142
+ - Tests: [`mode/kw.test.js`](https://github.com/awacloud/awa/blob/main/packages/front/fw/src/crypto/mode/kw.test.js) — 240 tests (233 baseline + 7 more: KW-AE inverse explicit reject + TDES guards)
143
143
  - ACVP draft: `references/NIST/ACVP/src/draft-celi-acvp-symmetric.adoc`
144
144
  - Vectors: `references/NIST/ACVP-Server-1.1.0.42/gen-val/json-files/ACVP-AES-KW-1.0/` + `ACVP-AES-KWP-1.0/`
145
145
  - Overall conformance: [`NIST_CONFORMANCE.md`](../NIST_CONFORMANCE.md)
@@ -1,4 +1,4 @@
1
- // Copyright (c) 2026 AwaCloud SAS
1
+ // Copyright (c) 2026 AwaCloud SAS
2
2
  // Author: Matthieu Bouilloux
3
3
  // SPDX-License-Identifier: Apache-2.0
4
4
 
@@ -115,7 +115,7 @@ export const kw = {
115
115
  return { aHi, aLo, R };
116
116
  }
117
117
 
118
- // Iteration D2 of the FIPS 140-3 upgrade plan - TDES rejection.
118
+ // TDES rejection.
119
119
  // SP 800-131A §2.4 marks Triple-DES as deprecated since 2024 and
120
120
  // disallowed for cryptographic protection beyond 2023. SP 800-38F
121
121
  // §6.2 explicitly requires a 128-bit block cipher (AES-128/192/256).
@@ -193,7 +193,7 @@ export const kw = {
193
193
  // skip the second XOR depending on the first).
194
194
  const diff = ((aHi ^ _IV_KW_HI) | (aLo ^ _IV_KW_LO)) >>> 0;
195
195
  if (diff !== 0) {
196
- console.error('[crypto] CORRUPT: kw: integrity check failed');
196
+ console.warn('[crypto] CORRUPT: kw: integrity check failed');
197
197
  return false;
198
198
  }
199
199
  return R;
@@ -287,7 +287,7 @@ export const kw = {
287
287
  bad |= padded[i] & (-inPad);
288
288
  }
289
289
  if (bad !== 0) {
290
- console.error('[crypto] CORRUPT: kwp: integrity check failed');
290
+ console.warn('[crypto] CORRUPT: kwp: integrity check failed');
291
291
  return false;
292
292
  }
293
293
  return padded.subarray(0, mli);
@@ -297,7 +297,7 @@ export const kw = {
297
297
  // applies CIPH_K⁻¹ (decrypt) in the wrap direction. ACVP includes
298
298
  // about 50 % of its KW vectors with this variant for completeness,
299
299
  // but it is rare in practice (legacy embedded TPM only). Iteration
300
- // D2 of the FIPS 140-3 upgrade plan - explicit reject with a typed
300
+ // Explicit reject with a typed
301
301
  // export to prevent any silent use. If a consumer has a
302
302
  // documented need, the implementation must be added separately
303
303
  // and audited.
@@ -51,10 +51,10 @@ the strict RFC 6979 contract (which requires H_K = H_msg).
51
51
  |---|---|---|---|
52
52
  | NIST CAVP / ACVP | `ECDSA-KeyGen-FIPS186-5/expectedResults.json` (24/72) | `ECDSA-KeyGen-FIPS186-5 (...validator-style, 24/72 vectors)` | `Q == d·G` byte-exact (4 NIST curves × 6 tcId) |
53
53
  | NIST CAVP / ACVP | `ECDSA-KeyVer-FIPS186-5/expectedResults.json` (4 positive) | `ECDSA-KeyVer-FIPS186-5 (...4 vectors)` | `deserialize` accepts valid Q values (P-224/256/384/521) |
54
- | **NIST CAVP / ACVP (C1)** | `ECDSA-KeyVer-FIPS186-5` 12/12 (4 pos + 8 neg) across 4 NIST P-curves | `ecc - ACVP ECDSA-KeyVer-FIPS186-5 (subgroup check, itération C1)` | Full §A.4.2 validation: x/y range + on-curve + non-identity + n·Q == O. Covers the 8 negative cases (off-curve point, x/y out of field range — incl. P-521 tg=4 tc=11 where qx ≥ p). |
55
- | **C1 deserialize integration** | pos + neg smoke test | `deserialize integrates subgroup check` | `ecc.deserialize` returns `false` for an out-of-subgroup point |
54
+ | **NIST CAVP / ACVP** | `ECDSA-KeyVer-FIPS186-5` 12/12 (4 pos + 8 neg) across 4 NIST P-curves | `ecc - ACVP ECDSA-KeyVer-FIPS186-5 (subgroup check)` | Full §A.4.2 validation: x/y range + on-curve + non-identity + n·Q == O. Covers the 8 negative cases (off-curve point, x/y out of field range — incl. P-521 tg=4 tc=11 where qx ≥ p). |
55
+ | **deserialize integration** | pos + neg smoke test | `deserialize integrates subgroup check` | `ecc.deserialize` returns `false` for an out-of-subgroup point |
56
56
  | NIST CAVP / ACVP | `ECDSA-SigVer-FIPS186-5/expectedResults.json` (8 sub-sampled positives) | `ECDSA-SigVer-FIPS186-5 (...8 sub-sampled vectors)` | `verify(H, r||s)` byte-exact (P-{224,256,384,521} × {SHA-256, SHA-512}) |
57
- | NIST CAVP / ACVP | `DetECDSA-SigGen-FIPS186-5/internalProjection.json` (16 vectors) | `DetECDSA-SigGen-FIPS186-5 (...RFC 6979 byte-exact)` | RFC 6979 §3.2 byte-exact on 4 (curve, hash) pairs: (P-224, SHA-256), (P-256, SHA-256), (P-384, SHA-384), **(P-521, SHA-512) — iteration C2** × [first/mid/last] |
57
+ | NIST CAVP / ACVP | `DetECDSA-SigGen-FIPS186-5/internalProjection.json` (16 vectors) | `DetECDSA-SigGen-FIPS186-5 (...RFC 6979 byte-exact)` | RFC 6979 §3.2 byte-exact on 4 (curve, hash) pairs: (P-224, SHA-256), (P-256, SHA-256), (P-384, SHA-384), **(P-521, SHA-512)** × [first/mid/last] |
58
58
  | FIPS 186-3 SigVer.rsp | P-256/SHA-256 vector + tampering | `NIST CAVP ECDSA verify` | historical KAT + tampering rejection |
59
59
  | Pre-existing | round-trip | `ECDSA sign/verify` (P-256, P-384, P-521) | basic round-trip |
60
60
  | Pre-existing | round-trip | `elGamal DH`, `kem` | commutative DH + KEM round-trip |
@@ -89,16 +89,16 @@ compare byte-exact against `(qx, qy)`. This simultaneously validates:
89
89
  - [x] **Round-trip sign/verify** — P-256/P-384/P-521 (pre-existing +
90
90
  implicit DetECDSA).
91
91
  - [x] **Public validation §A.4.2 / SP 800-56A Rev.3 §5.6.2.3.3** ✅
92
- **Iteration C1** — implemented in `ecc.deserialize`:
92
+ implemented in `ecc.deserialize`:
93
93
  (1) x, y coordinates in field range (< p), (2) point on curve via
94
94
  `isValid()`, (3) non-identity, (4) subgroup membership via
95
- `n·Q == O`. Exposed via `_internal.{coordsInRange, isInSubgroup,
95
+ `n·Q == O`. Exposed via `internalOf(ecc).{coordsInRange, isInSubgroup,
96
96
  isValidPublicKey}`. **8 negative ACVP KeyVer vectors byte-exact**
97
97
  (off-curve + out-of-range, incl. P-521 tg=4 tc=11 where qx ≥ p — a
98
98
  typical oversize-encoding case not caught by the plain curve
99
99
  equation modulo p).
100
100
  - [x] **Strict ECDSA malleability (s > n/2 rejection)** ✅
101
- **Iteration C3** — implemented. `verify(rs, { strict: true })`
101
+ implemented. `verify(rs, { strict: true })`
102
102
  rejects signatures with `s > ⌊n/2⌋` (BIP62 / NIST strict mode).
103
103
  `sign({ strict: true })` always produces a canonical low-s `s`
104
104
  (replaces `s` with `n − s` if needed). Test: generate a
@@ -108,7 +108,7 @@ compare byte-exact against `(qx, qy)`. This simultaneously validates:
108
108
  dedicated low-s vectors (negatives are *modify r/s*,
109
109
  *zero r/s*, *modify message/key*) — covered by synthetic
110
110
  counter-signature tests instead.
111
- - [x] **RFC 6979 byte-exact P-521** ✅ **Iteration C2** — fixed.
111
+ - [x] **RFC 6979 byte-exact P-521** ✅ fixed.
112
112
  Cause: SJCL `bn.bitLength()` returns 528 (rounded up to a multiple
113
113
  of 16) instead of 521. Helper `_trueBitLength(R)` added, which
114
114
  walks the byte representation to find the true MSB. The RFC 6979
@@ -116,7 +116,7 @@ compare byte-exact against `(qx, qy)`. This simultaneously validates:
116
116
  (modulo the 65 vs 66-byte encoding — RFC uses minimal-length,
117
117
  FIPS uses 66 fixed bytes), and 4 ACVP P-521+SHA-512 DetECDSA
118
118
  sub-samples pass.
119
- - [x] **K-hash decoupled from message-hash** ✅ **Iteration C3** —
119
+ - [x] **K-hash decoupled from message-hash** ✅
120
120
  `sign({ hashForK: <hashMod> })` lets the caller make the K
121
121
  derivation hash explicit (strict RFC 6979 requires H_K = H_msg).
122
122
  The default remains `_hashForBits(curveBitLength)` so as not to
@@ -132,16 +132,16 @@ compare byte-exact against `(qx, qy)`. This simultaneously validates:
132
132
  |---|---|---|
133
133
  | Approved algorithm | ✅ | FIPS 186-5 §6 + ACVP folders |
134
134
  | Approved curves | ✅ | P-{192,224,256,384,521} (FIPS 186-5 §3.1) |
135
- | RFC 6979 deterministic generation | ✅ | **Iteration C2**: byte-exact OK for the 4 NIST P-curves (incl. P-521 now; `_trueBitLength` bug fixed) |
135
+ | RFC 6979 deterministic generation | ✅ | byte-exact OK for the 4 NIST P-curves (incl. P-521 now; `_trueBitLength` bug fixed) |
136
136
  | ECDSA verification | ✅ | 8 ACVP vectors + tampering test |
137
137
  | Q ∈ G validation (point on curve) | ✅ | `point.isValid()` in `curve.fromBits` |
138
- | Q ∈ <G> validation (subgroup) | ✅ | **Iteration C1**: `n·Q == O` verified + range check x,y < p; 12 ACVP `KeyVer-FIPS186-5` vectors (4 pos + 8 neg) byte-exact |
138
+ | Q ∈ <G> validation (subgroup) | ✅ | `n·Q == O` verified + range check x,y < p; 12 ACVP `KeyVer-FIPS186-5` vectors (4 pos + 8 neg) byte-exact |
139
139
  | CT comparisons (if secret) | ⚠️ | `verify` is not constant-time (early return on r, s bounds; OK for pub-key path); `sign` uses non-CT `bn` (SJCL-derived, see docs/dev/provenance.md) |
140
140
  | No `throw` / timing leak | ✅ | Review: `console.error/warn` + `return false`; no `throw` |
141
141
 
142
142
  ## Known limitations
143
143
 
144
- - ~~**P-521 RFC 6979 byte-exact**~~ ✅ **Iteration C2** — fixed.
144
+ - ~~**P-521 RFC 6979 byte-exact**~~ ✅ fixed.
145
145
  Root cause: SJCL `bn.bitLength()` rounds up to a multiple of 16 (528
146
146
  for the 521-bit P-521 order value), which truncated
147
147
  `_bitsToInt(T, 528)` instead of `_bitsToInt(T, 521)` — a 7-bit offset
@@ -150,12 +150,12 @@ compare byte-exact against `(qx, qy)`. This simultaneously validates:
150
150
  P-521/SHA-512 sample vector is now reproduced byte-exact, and 3 ACVP
151
151
  P-521+SHA-512 DetECDSA sub-samples pass (previously filtered out at
152
152
  iteration 18).
153
- - ~~**Missing subgroup check**~~ ✅ **Iteration C1** — implemented.
153
+ - ~~**Missing subgroup check**~~ ✅ implemented.
154
154
  `deserialize` now performs the full §A.4.2 validation: x/y < p range +
155
155
  on-curve + non-identity + n·Q == O. 12 ACVP KeyVer vectors (4 pos + 8
156
156
  neg) byte-exact. Cost: ~1-3 ms/mult on P-256, acceptable for one-shot
157
157
  deserialize.
158
- - ~~**K-hash coupled to `curveBitLength`**~~ ✅ **Iteration C3** —
158
+ - ~~**K-hash coupled to `curveBitLength`**~~ ✅
159
159
  the `sign({ hashForK })` option now lets H_K be set explicitly
160
160
  (strict RFC 6979). The default (`_hashForBits(curveBitLength)`) is
161
161
  unchanged to preserve existing ACVP DetECDSA coverage; callers who
@@ -1,4 +1,4 @@
1
- // Copyright (c) 2026 AwaCloud SAS
1
+ // Copyright (c) 2026 AwaCloud SAS
2
2
  // Author: Matthieu Bouilloux
3
3
  // SPDX-License-Identifier: Apache-2.0
4
4
 
@@ -149,7 +149,6 @@
149
149
  * @property {{ publicKey: EccPublicKeyCtor, secretKey: EccSecretKeyCtor, generateKeys: (cn: string) => Function }} basicKey
150
150
  * @property {{ generateKeys: Function, publicKey: EccPublicKeyCtor, secretKey: EccSecretKeyCtor }} elGamal
151
151
  * @property {{ generateKeys: Function, publicKey: EccPublicKeyCtor, secretKey: EccSecretKeyCtor }} ecdsa
152
- * @property {object} _internal
153
152
  */
154
153
 
155
154
  import { bitArray } from '../utils/bitArray.js';
@@ -217,8 +216,7 @@ export const ecc = {
217
216
  // True (unrounded) bit-length of a positive integer encoded as a
218
217
  // big-endian byte array. SJCL `bn.bitLength()` rounds up to the next
219
218
  // multiple of 16 (storage radix), which breaks RFC 6979 for P-521
220
- // where the curve order n has bit-length 521 (not 528). Iteration C2
221
- // of the FIPS 140-3 upgrade plan - fixes the byte-exact divergence
219
+ // where the curve order n has bit-length 521 (not 528). This fixes the byte-exact divergence
222
220
  // against RFC 6979 §A.2.7 P-521 sample.
223
221
  function _trueBitLength(R) {
224
222
  const bytes = bitArray.ba_to_ui8(R.toBits());
@@ -804,7 +802,7 @@ export const ecc = {
804
802
  // - boolean `fakeLegacyVersion` (back-compat), OR
805
803
  // - object `opts = { fakeLegacyVersion?, strict? }`.
806
804
  //
807
- // Iteration C3 of the FIPS 140-3 upgrade plan - `opts.strict = true`
805
+ // `opts.strict = true`
808
806
  // enables ECDSA "low-s" rejection (BIP62 / NIST strict mode):
809
807
  // a canonical signature has `s ∈ [1, ⌊n/2⌋]`. Any value of s
810
808
  // in (n/2, n) - including the malleable signature `s' = n - s` -
@@ -834,7 +832,7 @@ export const ecc = {
834
832
  const hA = r.mul(s).mod(R);
835
833
  const r2 = this._curve.G.mult2(hG, hA, this._point).x;
836
834
  if (r.equals(0) || ss.equals(0) || r.greaterEquals(R) || ss.greaterEquals(R) || !r2.equals(r)) {
837
- console.error('[crypto] CORRUPT: ecdsa: signature did not verify');
835
+ console.warn('[crypto] CORRUPT: ecdsa: signature did not verify');
838
836
  return false;
839
837
  }
840
838
  if (strict) {
@@ -844,7 +842,7 @@ export const ecc = {
844
842
  const halfR = R.copy().halveM();
845
843
  const upperBoundExcl = halfR.add(new bn.bn(1));
846
844
  if (ss.greaterEquals(upperBoundExcl)) {
847
- console.error('[crypto] CORRUPT: ecdsa: signature is malleable (s > n/2) under strict mode');
845
+ console.warn('[crypto] CORRUPT: ecdsa: signature is malleable (s > n/2) under strict mode');
848
846
  return false;
849
847
  }
850
848
  }
@@ -861,7 +859,7 @@ export const ecc = {
861
859
  ecc.ecdsa.secretKey.prototype = {
862
860
  // Sign `hash` (already-digested message bits) with this private key.
863
861
  //
864
- // Iteration C3 of the FIPS 140-3 upgrade plan:
862
+ // Options:
865
863
  // - `opts.hashForK` : explicit hash module for RFC 6979 §3.2 K
866
864
  // derivation (default: `_hashForBits(curveBitLength)`,
867
865
  // which ties H_K to the curve size instead of H_msg -
@@ -918,10 +916,10 @@ export const ecc = {
918
916
  };
919
917
 
920
918
  // ── Internal escape hatch (test-only) ────────────────────────
921
- // Iteration C1 of the FIPS 140-3 upgrade plan - exposes the subgroup
919
+ // Exposes the subgroup
922
920
  // membership test for direct testing against ACVP KeyVer-FIPS186-5
923
921
  // negative vectors (where Q is on the curve but outside <G>).
924
- ecc._internal = {
922
+ Object.defineProperty(ecc, Symbol.for('@awacloud/fw/internal'), { value: {
925
923
  coordsInRange: _coordsInRange,
926
924
  isInSubgroup: _isInSubgroup,
927
925
  isValidPublicKey(curveName, pointHex) {
@@ -933,7 +931,7 @@ export const ecc = {
933
931
  if (point === false) return false;
934
932
  return _isInSubgroup(point, curve);
935
933
  }
936
- };
934
+ } });
937
935
 
938
936
  // @ts-ignore -- basicKey.generateKeys is assigned dynamically after construction
939
937
  return ecc;
@@ -20,7 +20,13 @@ Ed25519** variant (RFC 8032 §5.1): twisted Edwards curve
20
20
  −x² + y² = 1 − (121665/121666)·x²·y² over GF(2²⁵⁵−19), an
21
21
  implementation derived from TweetNaCl (16 limbs of 16-bit
22
22
  Float64Array, extended projective coordinates `(X, Y, Z, T)` with
23
- `x=X/Z, y=Y/Z, T=XY/Z`).
23
+ `x=X/Z, y=Y/Z, T=XY/Z`), with this project's field multiply and square
24
+ unrolled into locals, inversion and square root by addition chains, a
25
+ constant-time base-point table (`j · 256^i · B`, signed radix-16 digits)
26
+ for `keyPair` / `sign`, and a 4-bit window plus the RFC 8032 §5.1.4
27
+ doubling for `verify`'s public variable-base part. Outputs are
28
+ byte-identical to the TweetNaCl form (checked against it and against
29
+ `node:crypto`).
24
30
 
25
31
  Public API (`Uint8Array` everywhere):
26
32
 
@@ -28,28 +34,26 @@ Public API (`Uint8Array` everywhere):
28
34
  or `false` if seed ≠ 32 bytes.
29
35
  - `sign(privateKey, message)` → 64-byte signature (R || S); rejects
30
36
  privateKey ≠ 64 bytes.
31
- - `verify(publicKey, message, signature)` → `true | false`
37
+ - `verify(publicKey, signature, message)` → `true | false`
32
38
  (constant-time comparison: accumulated XOR over 32 bytes, line 348).
33
39
 
34
40
  Internal API (test-only):
35
41
 
36
- - `_internal.isValidPublicKey(pk)` → `true` iff `pk` deserializes into
42
+ - `internalOf(ed25519).isValidPublicKey(pk)` → `true` iff `pk` deserializes into
37
43
  a valid point on edwards25519 (`_unpackneg() === 0`). Used
38
44
  for the EDDSA-KeyVer-1.0 coverage. Outside the production contract.
39
45
 
40
- **Iteration E1 (FIPS 140-3 upgrade plan)**: added the
46
+ Added the
41
47
  **Ed25519ph** (preHash, RFC 8032 §5.1.1 / FIPS 186-5 §7.6.2) and
42
48
  **Ed25519ctx** (context bytes, RFC 8032 §5.1) variants:
43
- - `signPh(privateKey, message, ctx?)` / `verifyPh(publicKey, message, signature, ctx?)`
49
+ - `signPh(privateKey, message, ctx?)` / `verifyPh(publicKey, signature, message, ctx?)`
44
50
  — applies SHA-512 internally to the message + dom2(F=1, ctx) prefix.
45
- - `signCtx(privateKey, message, ctx)` / `verifyCtx(publicKey, message, signature, ctx)`
51
+ - `signCtx(privateKey, message, ctx)` / `verifyCtx(publicKey, signature, message, ctx)`
46
52
  — dom2(F=0, ctx) prefix; ctx required (1..255 bytes — for an empty
47
53
  ctx, use the pure Ed25519 path via `sign/verify`).
48
54
 
49
55
  Not implemented (see *Known limitations*): **Ed448** (distinct curve,
50
- SHAKE-256) — iteration E2 adds `ed448.{keyPair,sign,verify,
51
- signPh,verifyPh}` stubs that return `false + warn NOT-IMPLEMENTED` for
52
- safety by default.
56
+ SHAKE-256).
53
57
 
54
58
  ## Test coverage
55
59
 
@@ -61,13 +65,13 @@ safety by default.
61
65
  | RFC 8032 §7.1 TEST 2 | 1-byte message | `§7.1 TEST 2 (1-byte message)` | byte-exact KAT (sig) |
62
66
  | RFC 8032 §7.1 TEST 3 | 2-byte message | `§7.1 TEST 3 (2-byte message)` | byte-exact KAT (sig) |
63
67
  | NIST CAVP / ACVP | `EDDSA-KeyGen-1.0` (3/3 ED-25519) | `EDDSA-KeyGen-1.0 (...3/3 vectors)` | `keyPair(d).publicKey == q` byte-exact |
64
- | NIST CAVP / ACVP | `EDDSA-KeyVer-1.0` (4/4 ED-25519) | `EDDSA-KeyVer-1.0 (...4/4 vectors)` | `_internal.isValidPublicKey(q)` ↔ `testPassed` |
68
+ | NIST CAVP / ACVP | `EDDSA-KeyVer-1.0` (4/4 ED-25519) | `EDDSA-KeyVer-1.0 (...4/4 vectors)` | `internalOf(ed25519).isValidPublicKey(q)` ↔ `testPassed` |
65
69
  | NIST CAVP / ACVP | `EDDSA-SigGen-1.0` (3 sub-samples ED-25519/AFT/preHash=False) | `EDDSA-SigGen-1.0 (...byte-exact 3 sub-samples)` | `sign(d, msg) == signature` byte-exact (RFC 8032 deterministic) |
66
70
  | NIST CAVP / ACVP | `EDDSA-SigVer-1.0` (5/5 ED-25519/preHash=False) | `EDDSA-SigVer-1.0 (...5/5 vectors)` | `verify(q, msg, sig)` ↔ `testPassed` (mix pass/fail) |
67
- | **NIST CAVP / ACVP (E1)** | `EDDSA-SigGen-1.0` 3 sub-samples ED-25519/preHash=True | `EDDSA-SigGen-1.0 preHash=True` | `signPh(d, msg, ctx) == signature` byte-exact, 96-byte ctx |
68
- | **NIST CAVP / ACVP (E1)** | `EDDSA-SigVer-1.0` 5/5 ED-25519/preHash=True | `EDDSA-SigVer-1.0 preHash=True` | `verifyPh(q, msg, sig)` ↔ `testPassed` (mix valid/invalid) |
69
- | **E1 round-trip** | Ed25519ph w/ + w/o context | `Ed25519ph cross-check` | round-trip sign+verify, domain separation vs pure |
70
- | **E1 ctx round-trip** | Ed25519ctx w/ context | `Ed25519ctx (RFC 8032 §5.1)` | round-trip + wrong-context rejection + cross-mode rejection |
71
+ | **NIST CAVP / ACVP** | `EDDSA-SigGen-1.0` 3 sub-samples ED-25519/preHash=True | `EDDSA-SigGen-1.0 preHash=True` | `signPh(d, msg, ctx) == signature` byte-exact, 96-byte ctx |
72
+ | **NIST CAVP / ACVP** | `EDDSA-SigVer-1.0` 5/5 ED-25519/preHash=True | `EDDSA-SigVer-1.0 preHash=True` | `verifyPh(q, msg, sig)` ↔ `testPassed` (mix valid/invalid) |
73
+ | **Ed25519ph round-trip** | Ed25519ph w/ + w/o context | `Ed25519ph cross-check` | round-trip sign+verify, domain separation vs pure |
74
+ | **Ed25519ctx round-trip** | Ed25519ctx w/ context | `Ed25519ctx (RFC 8032 §5.1)` | round-trip + wrong-context rejection + cross-mode rejection |
71
75
  | Pre-existing | tampering message | `verify rejects modified message` | rejects altered message |
72
76
  | Pre-existing | tampering signature | `verify rejects modified signature` | rejects altered signature |
73
77
  | Pre-existing | bad seed | `rejects bad seed length` | rejects seed ≠ 32 bytes |
@@ -93,28 +97,23 @@ safety by default.
93
97
  - [x] **Scalar clamping RFC 8032 §5.1.5** — `d[0] &= 248; d[31]
94
98
  &= 127; d[31] |= 64` line 274; indirect proof via byte-exact
95
99
  keyPair on 4 different seeds (3 RFC + 1 ACVP).
96
- - [x] **Ed25519ph (preHash)** ✅ **Iteration E1** — implemented.
100
+ - [x] **Ed25519ph (preHash)** ✅ implemented.
97
101
  `signPh(privateKey, message, ctx?)` / `verifyPh` apply SHA-512
98
102
  to the message + dom2(F=1, ctx) prefix per RFC 8032 §5.1.1. 3
99
103
  ACVP SigGen vectors + 5 SigVer preHash=True byte-exact + 5
100
104
  round-trip tests (incl. domain separation vs pure Ed25519).
101
- - [x] **Ed25519ctx (context bytes)** ✅ **Iteration E1** — implemented.
105
+ - [x] **Ed25519ctx (context bytes)** ✅ implemented.
102
106
  `signCtx(privateKey, message, ctx)` / `verifyCtx` apply
103
107
  dom2(F=0, ctx) prefix per RFC 8032 §5.1. ctx required (1..255 bytes;
104
108
  empty ctx → use pure `sign/verify`). 5 round-trip tests
105
109
  (round-trip + wrong-ctx rejection + cross-mode pure rejection + 0/256 bounds).
106
- - [x] **Ed448 — documented decision** ✅ **Iteration E2** — Ed448
110
+ - [x] **Ed448 — documented decision** ✅ Ed448
107
111
  (FIPS 186-5 §7.7, edwards448 curve + SHAKE-256, 57-byte pk,
108
112
  114-byte sig) **not implemented by design**. ACVP covers:
109
113
  KeyGen 3, KeyVer 4, SigGen 84 (preHash + ctx), SigVer 10 = 101
110
114
  total ED-448 vectors. Rather than partially implementing it,
111
- the module exposes `ed25519.ed448.{keyPair, sign, verify, signPh,
112
- verifyPh}`, which return `false` + typed
113
- `console.warn('NOT-IMPLEMENTED')` pointing to FIPS 186-5 §7.7 +
114
- RFC 8032 §5.2 + a recommendation to create a separate `ed448.js`
115
- (to be derived directly from RFC 8032 §5.2).
116
- **Avoids any silent use** by a consumer that would have
117
- confused the Ed25519/Ed448 variants.
115
+ the module offers none: an Ed448 module would be a separate
116
+ `ed448.js`, derived directly from RFC 8032 §5.2.
118
117
  - [ ] **Strict subgroup check (low-order Q rejection)** — `_unpackneg`
119
118
  accepts points of order 8 (cofactor). RFC 8032 §5.1.7 v2
120
119
  (May 2017) optionally recommends rejecting them but does not
@@ -129,7 +128,7 @@ safety by default.
129
128
  | Approved curve | ✅ | edwards25519 (FIPS 186-5 §7.2.1) |
130
129
  | RFC 8032 deterministic generation | ✅ | byte-exact on 6 pure vectors + 3 ph (RFC + ACVP) |
131
130
  | EdDSA verification | ✅ | 5 ACVP pure vectors + 5 ph + 2 tampering |
132
- | preHash + context variants (FIPS 186-5 §7.6.1/2) | ✅ | **Iteration E1**: `signPh/verifyPh/signCtx/verifyCtx` + 13 dedicated tests |
131
+ | preHash + context variants (FIPS 186-5 §7.6.1/2) | ✅ | `signPh/verifyPh/signCtx/verifyCtx` + 13 dedicated tests |
133
132
  | pk validation (point on curve) | ✅ | `_unpackneg` + 4 ACVP KeyVer vectors |
134
133
  | CT tag comparison | ✅ | accumulated XOR line 347-349 |
135
134
  | Power-on KAT / self-test | N/A | permanent KAT via 6 deterministic vectors |
@@ -139,16 +138,14 @@ safety by default.
139
138
  ## Known limitations
140
139
 
141
140
  - **No Ed448**: edwards448 curve + SHAKE-256 not implemented.
142
- **Iteration E2**: `ed25519.ed448.*` guards that return
143
- `false + warn NOT-IMPLEMENTED` added to prevent any silent use.
144
141
  To enable Ed448: create a separate `ed448.js` (the compression
145
142
  function differs; no sharing with ed25519.js). Output 57 bytes
146
143
  pk + 114 bytes sig. To be implemented directly from RFC 8032 §5.2.
147
- - ~~**No prehash variant (Ed25519ph)**~~ ✅ **Iteration E1** —
144
+ - ~~**No prehash variant (Ed25519ph)**~~ ✅
148
145
  `signPh(sk, message, ctx?)` / `verifyPh` exposed. The module applies
149
146
  SHA-512 internally to the message + dom2(F=1, ctx) prefix per RFC 8032
150
147
  §5.1.1.
151
- - ~~**No `context` (Ed25519ctx)**~~ ✅ **Iteration E1** —
148
+ - ~~**No `context` (Ed25519ctx)**~~ ✅
152
149
  `signCtx(sk, message, ctx)` / `verifyCtx` exposed. ctx required (1..255
153
150
  bytes); empty ctx → use `sign/verify` (pure Ed25519 path).
154
151
  - **Cofactored verification**: `_unpackneg` accepts points
@@ -157,15 +154,14 @@ safety by default.
157
154
  (cf. ed25519-dalek strict mode) reject it. Acceptable for
158
155
  standard usage, worth noting for cryptanalytically
159
156
  sensitive protocols.
160
- - **TweetNaCl implementation**: no demonstrated timing attack but
161
- not formally constant-time (Float64 arithmetic, carry
162
- propagation, `_sel25519` constant-time but `_pow2523` uses a
163
- fixed addition chain).
157
+ - **Timing**: secret data never selects a branch, a loop bound or a table index: the base table is read by a full scan merged by mask, the signed digits are recoded with arithmetic only, swaps and negations go through masks. What JavaScript cannot promise — that the engine executes the same arithmetic in the same time for every value — no JS implementation can. `verify` handles public data only and
158
+ uses a variable-time window. A structural test
159
+ (`ed25519-fast.test.js`) pins the base table's scan.
164
160
 
165
161
  ## Cross-references
166
162
 
167
163
  - Module: [`pkc/ed25519.js`](./ed25519.js)
168
- - Tests: [`pkc/ed25519.test.js`](https://github.com/awacloud/awa/blob/main/packages/front/fw/src/crypto/pkc/ed25519.test.js) — 46 tests (22 baseline + 18 iteration E1 + 6 iteration E2: Ed448 NOT-IMPLEMENTED stubs)
164
+ - Tests: [`pkc/ed25519.test.js`](https://github.com/awacloud/awa/blob/main/packages/front/fw/src/crypto/pkc/ed25519.test.js) — 46 tests (22 baseline + 24 more: 18 for Ed25519ph / Ed25519ctx, 6 for the Ed448 NOT-IMPLEMENTED stubs)
169
165
  - ACVP draft: `references/NIST/ACVP/src/draft-celi-acvp-eddsa.adoc`
170
166
  - Vectors: `references/NIST/ACVP-Server-1.1.0.42/gen-val/json-files/EDDSA-*-1.0/`
171
167
  - Equivalent ECDSA module: [`./ecc.acvp.md`](./ecc.acvp.md)