@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.
- package/CHANGELOG.md +125 -0
- package/NOTICE +8 -0
- package/README.md +163 -31
- package/dist/build/fw.core.pure.meta.json +6 -6
- package/dist/build/fw.core.pure.min.js +15 -12
- package/dist/build/fw.full.pure.meta.json +13 -7
- package/dist/build/fw.full.pure.min.js +45 -42
- package/dist/build/fw.minimal.pure.meta.json +6 -6
- package/dist/build/fw.minimal.pure.min.js +16 -13
- package/dist/build/fw.pack.compress-heavy.pure.meta.json +6 -6
- package/dist/build/fw.pack.compress-heavy.pure.min.js +3 -3
- package/dist/build/fw.pack.crypto-advanced.pure.meta.json +6 -6
- package/dist/build/fw.pack.crypto-advanced.pure.min.js +1 -1
- package/dist/build/fw.pack.crypto-basic.pure.meta.json +6 -6
- package/dist/build/fw.pack.crypto-basic.pure.min.js +1 -1
- package/dist/build/fw.pack.crypto-identity.pure.meta.json +7 -6
- package/dist/build/fw.pack.crypto-identity.pure.min.js +4 -4
- package/dist/build/fw.pwa.pure.meta.json +7 -6
- package/dist/build/fw.pwa.pure.min.js +38 -35
- package/dist/build/fw.site-interactive.pure.meta.json +6 -6
- package/dist/build/fw.site-interactive.pure.min.js +37 -34
- package/dist/build/fw.site.pure.meta.json +6 -6
- package/dist/build/fw.site.pure.min.js +24 -21
- package/dist/build/fw.spa.pure.meta.json +8 -7
- package/dist/build/fw.spa.pure.min.js +41 -38
- package/dist/build/sanity-base-classic.min.js +1 -1
- package/dist/build/sanity.min.js +1 -1
- package/dist/types/core/internal.d.ts +29 -0
- package/dist/types/core/internal.d.ts.map +1 -0
- package/dist/types/core/logger.d.ts +23 -4
- package/dist/types/core/logger.d.ts.map +1 -1
- package/dist/types/core/modules.d.ts +374 -61
- package/dist/types/core/modules.d.ts.map +1 -1
- package/dist/types/core/runtime.d.ts +10 -6
- package/dist/types/core/runtime.d.ts.map +1 -1
- package/dist/types/core/worker-helper.d.ts +35 -0
- package/dist/types/core/worker-helper.d.ts.map +1 -1
- package/dist/types/crypto/cipher/aes.d.ts +1 -7
- package/dist/types/crypto/cipher/aes.d.ts.map +1 -1
- package/dist/types/crypto/cipher/chacha20.d.ts +0 -10
- package/dist/types/crypto/cipher/chacha20.d.ts.map +1 -1
- package/dist/types/crypto/hash/argon2.d.ts +0 -15
- package/dist/types/crypto/hash/argon2.d.ts.map +1 -1
- package/dist/types/crypto/hash/blake2b.d.ts.map +1 -1
- package/dist/types/crypto/hash/hmac.d.ts.map +1 -1
- package/dist/types/crypto/hash/pbkdf2.d.ts.map +1 -1
- package/dist/types/crypto/hash/poly1305.d.ts.map +1 -1
- package/dist/types/crypto/hash/sha224.d.ts +1 -1
- package/dist/types/crypto/hash/sha256.d.ts +4 -13
- package/dist/types/crypto/hash/sha256.d.ts.map +1 -1
- package/dist/types/crypto/hash/sha3.d.ts.map +1 -1
- package/dist/types/crypto/hash/sha384.d.ts +1 -1
- package/dist/types/crypto/hash/sha512.d.ts +4 -13
- package/dist/types/crypto/hash/sha512.d.ts.map +1 -1
- package/dist/types/crypto/mode/cmac.d.ts +0 -6
- package/dist/types/crypto/mode/cmac.d.ts.map +1 -1
- package/dist/types/crypto/mode/ctr.d.ts +0 -6
- package/dist/types/crypto/mode/ctr.d.ts.map +1 -1
- package/dist/types/crypto/mode/gcm.d.ts +0 -9
- package/dist/types/crypto/mode/gcm.d.ts.map +1 -1
- package/dist/types/crypto/pkc/ecc.d.ts +0 -1
- package/dist/types/crypto/pkc/ecc.d.ts.map +1 -1
- package/dist/types/crypto/pkc/ed25519.d.ts +4 -25
- package/dist/types/crypto/pkc/ed25519.d.ts.map +1 -1
- package/dist/types/crypto/pkc/hybridSign.d.ts +25 -5
- package/dist/types/crypto/pkc/hybridSign.d.ts.map +1 -1
- package/dist/types/crypto/pkc/ml_dsa.d.ts +6 -26
- package/dist/types/crypto/pkc/ml_dsa.d.ts.map +1 -1
- package/dist/types/crypto/pkc/ml_kem.d.ts +0 -43
- package/dist/types/crypto/pkc/ml_kem.d.ts.map +1 -1
- package/dist/types/crypto/pkc/rsa.d.ts +0 -24
- package/dist/types/crypto/pkc/rsa.d.ts.map +1 -1
- package/dist/types/crypto/pkc/slh_dsa.d.ts +6 -16
- package/dist/types/crypto/pkc/slh_dsa.d.ts.map +1 -1
- package/dist/types/crypto/pkc/x25519.d.ts +0 -6
- package/dist/types/crypto/pkc/x25519.d.ts.map +1 -1
- package/dist/types/crypto/utils/bitArray.d.ts +0 -8
- package/dist/types/crypto/utils/bitArray.d.ts.map +1 -1
- package/dist/types/crypto/utils/jws.d.ts +6 -14
- package/dist/types/crypto/utils/jws.d.ts.map +1 -1
- package/dist/types/crypto/utils/keyformat.d.ts +52 -0
- package/dist/types/crypto/utils/keyformat.d.ts.map +1 -1
- package/dist/types/crypto/utils/random.d.ts +1 -10
- package/dist/types/crypto/utils/random.d.ts.map +1 -1
- package/dist/types/crypto/utils/rsaKeygen.d.ts +0 -10
- package/dist/types/crypto/utils/rsaKeygen.d.ts.map +1 -1
- package/dist/types/crypto/utils/uuid.d.ts.map +1 -1
- package/dist/types/crypto/utils/x509.d.ts +397 -0
- package/dist/types/crypto/utils/x509.d.ts.map +1 -0
- package/dist/types/crypto/wasm/argon2.d.ts +2 -1
- package/dist/types/crypto/wasm/argon2.d.ts.map +1 -1
- package/dist/types/crypto/wasm/pbkdf2.d.ts +2 -2
- package/dist/types/crypto/wasm/pbkdf2.d.ts.map +1 -1
- package/dist/types/crypto/wasm/rsa.d.ts.map +1 -1
- package/dist/types/crypto/wasm/runtime.d.ts +13 -0
- package/dist/types/crypto/wasm/runtime.d.ts.map +1 -1
- package/dist/types/crypto/webcrypto/aes.d.ts.map +1 -1
- package/dist/types/crypto/webcrypto/aeskw.d.ts.map +1 -1
- package/dist/types/crypto/webcrypto/digest.d.ts +0 -4
- package/dist/types/crypto/webcrypto/digest.d.ts.map +1 -1
- package/dist/types/crypto/webcrypto/rsa.d.ts.map +1 -1
- package/dist/types/dom/fs/fileIntake.d.ts +59 -0
- package/dist/types/dom/fs/fileIntake.d.ts.map +1 -0
- package/dist/types/dom/fs/fsAccess.d.ts.map +1 -1
- package/dist/types/dom/query/dnd.d.ts.map +1 -1
- package/dist/types/dom/query/sound.d.ts +89 -0
- package/dist/types/dom/query/sound.d.ts.map +1 -0
- package/dist/types/dom/rendering/chart.d.ts.map +1 -1
- package/dist/types/dom/rendering/component.d.ts +9 -3
- package/dist/types/dom/rendering/component.d.ts.map +1 -1
- package/dist/types/dom/rendering/parser.d.ts +39 -0
- package/dist/types/dom/rendering/parser.d.ts.map +1 -1
- package/dist/types/dom/rendering/render.d.ts.map +1 -1
- package/dist/types/dom/rendering/sanitize.d.ts +4 -0
- package/dist/types/dom/rendering/sanitize.d.ts.map +1 -1
- package/dist/types/dom/rendering/secPolicy.d.ts.map +1 -1
- package/dist/types/dom/rendering/styleSheet.d.ts +74 -0
- package/dist/types/dom/rendering/styleSheet.d.ts.map +1 -0
- package/dist/types/dom/rendering/template.d.ts +9 -3
- package/dist/types/dom/rendering/template.d.ts.map +1 -1
- package/dist/types/dom/rendering/themeTokens.d.ts +9 -3
- package/dist/types/dom/rendering/themeTokens.d.ts.map +1 -1
- package/dist/types/dom/rendering/uiSession-core.d.ts +9 -3
- package/dist/types/dom/rendering/uiSession-core.d.ts.map +1 -1
- package/dist/types/dom/rendering/uiSession-list.d.ts +9 -3
- package/dist/types/dom/rendering/uiSession-list.d.ts.map +1 -1
- package/dist/types/dom/rendering/uiSession.d.ts +18 -6
- package/dist/types/dom/rendering/uiSession.d.ts.map +1 -1
- package/dist/types/dom/sw/installPrompt.d.ts +89 -0
- package/dist/types/dom/sw/installPrompt.d.ts.map +1 -0
- package/dist/types/dom/sw/precache.d.ts +149 -0
- package/dist/types/dom/sw/precache.d.ts.map +1 -0
- package/dist/types/dom/sw/swUpdate.d.ts +129 -0
- package/dist/types/dom/sw/swUpdate.d.ts.map +1 -0
- package/dist/types/dom/utils/clipboard.d.ts +8 -0
- package/dist/types/dom/utils/clipboard.d.ts.map +1 -1
- package/dist/types/dom/utils/keybindings.d.ts.map +1 -1
- package/dist/types/dom/utils/route.d.ts.map +1 -1
- package/dist/types/dom/utils/ua.d.ts +2 -2
- package/dist/types/dom/utils/ua.d.ts.map +1 -1
- package/dist/types/io/calc/crc32.d.ts.map +1 -1
- package/dist/types/io/codec/b64.d.ts +24 -0
- package/dist/types/io/codec/b64.d.ts.map +1 -1
- package/dist/types/io/codec/cbor.d.ts +1 -0
- package/dist/types/io/codec/cbor.d.ts.map +1 -1
- package/dist/types/io/codec/hex.d.ts.map +1 -1
- package/dist/types/io/codec/msgpack.d.ts +1 -0
- package/dist/types/io/codec/msgpack.d.ts.map +1 -1
- package/dist/types/io/codec/url.d.ts +3 -1
- package/dist/types/io/codec/url.d.ts.map +1 -1
- package/dist/types/io/codec/utf8.d.ts.map +1 -1
- package/dist/types/io/compress/bitstream.d.ts +1 -1
- package/dist/types/io/compress/brotli.d.ts +0 -1
- package/dist/types/io/compress/brotli.d.ts.map +1 -1
- package/dist/types/io/compress/brotli_shared.d.ts +0 -4
- package/dist/types/io/compress/brotli_shared.d.ts.map +1 -1
- package/dist/types/io/compress/deflate.d.ts +14 -1
- package/dist/types/io/compress/deflate.d.ts.map +1 -1
- package/dist/types/io/compress/gzip.d.ts +4 -0
- package/dist/types/io/compress/gzip.d.ts.map +1 -1
- package/dist/types/io/compress/huffman.d.ts +7 -0
- package/dist/types/io/compress/huffman.d.ts.map +1 -1
- package/dist/types/io/compress/lz4.d.ts +4 -2
- package/dist/types/io/compress/lz4.d.ts.map +1 -1
- package/dist/types/io/compress/lz77.d.ts +17 -0
- package/dist/types/io/compress/lz77.d.ts.map +1 -1
- package/dist/types/io/compress/lzw.d.ts +2 -0
- package/dist/types/io/compress/lzw.d.ts.map +1 -1
- package/dist/types/io/compress/zip.d.ts.map +1 -1
- package/dist/types/io/compress/zlib.d.ts +9 -2
- package/dist/types/io/compress/zlib.d.ts.map +1 -1
- package/dist/types/io/math/linalg.d.ts.map +1 -1
- package/dist/types/process/rpc.d.ts.map +1 -1
- package/dist/types/process/workerPool.d.ts.map +1 -1
- package/dist/types/sanity/base.d.ts +12 -2
- package/dist/types/sanity/base.d.ts.map +1 -1
- package/dist/types/sanity/lockdown.d.ts +6 -5
- package/dist/types/sanity/lockdown.d.ts.map +1 -1
- package/dist/types/sanity/wasm-gate.d.ts +1 -1
- package/docs/README.md +17 -10
- package/docs/api/README.md +5 -5
- package/docs/api/core/logger.md +2 -1
- package/docs/api/core/modules.md +3 -3
- package/docs/api/core/runtime.md +9 -9
- package/docs/api/core/worker-helper.md +12 -2
- package/docs/api/crypto/README.md +1 -1
- package/docs/api/crypto/cipher/README.md +2 -2
- package/docs/api/crypto/cipher/aes.md +5 -10
- package/docs/api/crypto/cipher/chacha20.md +3 -8
- package/docs/api/crypto/hash/README.md +5 -5
- package/docs/api/crypto/hash/adf.md +21 -11
- package/docs/api/crypto/hash/argon2.md +3 -12
- package/docs/api/crypto/hash/blake2b.md +12 -14
- package/docs/api/crypto/hash/pbkdf2.md +1 -1
- package/docs/api/crypto/hash/sha224.md +2 -2
- package/docs/api/crypto/hash/sha256.md +4 -4
- package/docs/api/crypto/hash/sha3.md +2 -2
- package/docs/api/crypto/hash/sha384.md +1 -1
- package/docs/api/crypto/hash/sha512.md +5 -5
- package/docs/api/crypto/hash/sha512_224.md +1 -1
- package/docs/api/crypto/hash/sha512_256.md +1 -1
- package/docs/api/crypto/mode/README.md +3 -3
- package/docs/api/crypto/mode/cbc.md +2 -2
- package/docs/api/crypto/mode/chacha20poly1305.md +1 -1
- package/docs/api/crypto/mode/cmac.md +4 -4
- package/docs/api/crypto/mode/ctr.md +2 -3
- package/docs/api/crypto/mode/gcm.md +5 -5
- package/docs/api/crypto/mode/kw.md +4 -4
- package/docs/api/crypto/pkc/README.md +8 -8
- package/docs/api/crypto/pkc/ecc.md +19 -17
- package/docs/api/crypto/pkc/ed25519.md +10 -15
- package/docs/api/crypto/pkc/hybridKem.md +8 -2
- package/docs/api/crypto/pkc/hybridSign.md +34 -7
- package/docs/api/crypto/pkc/ml_dsa.md +20 -19
- package/docs/api/crypto/pkc/ml_kem.md +3 -3
- package/docs/api/crypto/pkc/rsa.md +7 -9
- package/docs/api/crypto/pkc/slh_dsa.md +12 -12
- package/docs/api/crypto/pkc/x25519.md +5 -4
- package/docs/api/crypto/utils/README.md +7 -7
- package/docs/api/crypto/utils/aes_modes.md +2 -5
- package/docs/api/crypto/utils/asn1.md +25 -16
- package/docs/api/crypto/utils/jws.md +6 -4
- package/docs/api/crypto/utils/keyformat.md +24 -15
- package/docs/api/crypto/utils/pad.md +1 -1
- package/docs/api/crypto/utils/pem.md +3 -3
- package/docs/api/crypto/utils/random.md +3 -4
- package/docs/api/crypto/utils/rsaKeygen.md +2 -2
- package/docs/api/crypto/utils/totp.md +2 -2
- package/docs/api/crypto/utils/uuid.md +5 -5
- package/docs/api/crypto/utils/x509.md +124 -0
- package/docs/api/crypto/wasm/aes.md +1 -1
- package/docs/api/crypto/wasm/argon2.md +6 -4
- package/docs/api/crypto/wasm/ml_kem.md +1 -0
- package/docs/api/crypto/wasm/pbkdf2.md +8 -8
- package/docs/api/crypto/wasm/rsa.md +1 -1
- package/docs/api/crypto/wasm/runtime.md +27 -10
- package/docs/api/crypto/webcrypto/aes.md +1 -1
- package/docs/api/crypto/webcrypto/aeskw.md +2 -2
- package/docs/api/crypto/webcrypto/digest.md +3 -5
- package/docs/api/crypto/webcrypto/ecc.md +1 -1
- package/docs/api/crypto/webcrypto/ed25519.md +1 -1
- package/docs/api/crypto/webcrypto/rsa.md +3 -2
- package/docs/api/crypto/webcrypto/x25519.md +1 -1
- package/docs/api/dom/README.md +6 -1
- package/docs/api/dom/fs/README.md +1 -0
- package/docs/api/dom/fs/fileIntake.md +120 -0
- package/docs/api/dom/fs/fsAccess.md +1 -0
- package/docs/api/dom/fs/indexedDB.md +1 -1
- package/docs/api/dom/fs/storage.md +1 -1
- package/docs/api/dom/query/README.md +2 -1
- package/docs/api/dom/query/dnd.md +4 -1
- package/docs/api/dom/query/dom.md +5 -0
- package/docs/api/dom/query/sound.md +103 -0
- package/docs/api/dom/rendering/README.md +4 -3
- package/docs/api/dom/rendering/chart.md +5 -4
- package/docs/api/dom/rendering/component.md +25 -3
- package/docs/api/dom/rendering/parser.md +5 -2
- package/docs/api/dom/rendering/reactiveBind.md +1 -1
- package/docs/api/dom/rendering/render.md +2 -2
- package/docs/api/dom/rendering/sanitize.md +10 -2
- package/docs/api/dom/rendering/secPolicy.md +4 -4
- package/docs/api/dom/rendering/styleSheet.md +85 -0
- package/docs/api/dom/rendering/template.md +20 -5
- package/docs/api/dom/rendering/themeTokens.md +6 -3
- package/docs/api/dom/rendering/uiSession.md +18 -5
- package/docs/api/dom/rendering/virtualScroll.md +2 -2
- package/docs/api/dom/sensors/geolocation.md +1 -1
- package/docs/api/dom/sw/README.md +7 -1
- package/docs/api/dom/sw/cache.md +2 -1
- package/docs/api/dom/sw/installPrompt.md +111 -0
- package/docs/api/dom/sw/precache.md +124 -0
- package/docs/api/dom/sw/serviceWorker.md +4 -2
- package/docs/api/dom/sw/swUpdate.md +112 -0
- package/docs/api/dom/utils/clipboard.md +56 -5
- package/docs/api/dom/utils/entropyCollector.md +1 -1
- package/docs/api/dom/utils/keybindings.md +17 -2
- package/docs/api/dom/utils/leaderElection.md +2 -2
- package/docs/api/dom/utils/route.md +1 -0
- package/docs/api/dom/utils/ua.md +15 -10
- package/docs/api/io/calc/crc32.md +4 -1
- package/docs/api/io/codec/README.md +2 -2
- package/docs/api/io/codec/b64.md +31 -2
- package/docs/api/io/codec/buffer.md +1 -1
- package/docs/api/io/codec/cbor.md +6 -4
- package/docs/api/io/codec/csv.md +178 -178
- package/docs/api/io/codec/hex.md +10 -2
- package/docs/api/io/codec/msgpack.md +4 -3
- package/docs/api/io/codec/url.md +4 -3
- package/docs/api/io/codec/utf8.md +3 -3
- package/docs/api/io/compress/bitstream.md +6 -3
- package/docs/api/io/compress/brotli.md +36 -4
- package/docs/api/io/compress/brotli_shared.md +1 -1
- package/docs/api/io/compress/deflate.md +42 -34
- package/docs/api/io/compress/gzip.md +26 -6
- package/docs/api/io/compress/huffman.md +2 -1
- package/docs/api/io/compress/lz4.md +5 -3
- package/docs/api/io/compress/lz77.md +26 -3
- package/docs/api/io/compress/lzw.md +13 -8
- package/docs/api/io/compress/zip.md +36 -10
- package/docs/api/io/compress/zlib.md +21 -5
- package/docs/api/io/math/linalg.md +1 -1
- package/docs/api/io/utils/valid.md +1 -1
- package/docs/api/process/rpc.md +3 -2
- package/docs/api/process/workerPool.md +1 -1
- package/docs/api/sanity/base.md +9 -5
- package/docs/api/sanity/lockdown.md +7 -6
- package/docs/api/surface.json +12311 -0
- package/docs/api/typed.md +5 -3
- package/docs/dev/README.md +2 -0
- package/docs/dev/bench.md +76 -0
- package/docs/dev/crypto-references.md +54 -0
- package/docs/dev/provenance.md +30 -7
- package/docs/dev/publishing.md +7 -7
- package/docs/dev/runtime.md +1 -1
- package/docs/dev/testing.md +13 -0
- package/docs/evidence/l4-evidence.md +86 -0
- package/docs/evidence/pqc-hybrid-evidence.md +7 -6
- package/docs/guide/README.md +1 -0
- package/docs/guide/_QUICK_REF.md +5 -5
- package/docs/guide/doc-format.md +4 -3
- package/docs/guide/integrations-hmr.md +1 -1
- package/docs/guide/module-creation-workflow.md +8 -8
- package/docs/guide/rendering-pipeline.md +11 -4
- package/docs/guide/security.md +7 -5
- package/docs/guide/stability.md +123 -0
- package/docs/guide/tutorial-todo.md +20 -8
- package/docs/guide/typescript.md +9 -0
- package/docs/guide/worker-confinement.md +30 -17
- package/docs/notes/lz77-deflate-factorization.md +3 -3
- package/docs/tools/README.md +1 -1
- package/docs/tools/bundler.md +3 -3
- package/docs/tools/codegen.md +1 -1
- package/docs/tools/standalone.md +0 -1
- package/fw.config.json +2 -2
- package/integrations/_shared/catalog.generated.json +7 -1
- package/integrations/_shared/core.js +1 -1
- package/integrations/astro/index.js +1 -1
- package/integrations/eslint/README.md +7 -1
- package/integrations/nextjs/index.js +1 -1
- package/integrations/nodejs/README.md +3 -3
- package/integrations/turbopack/index.js +2 -2
- package/integrations/typedoc/categorize.js +1 -1
- package/integrations/typedoc/typedoc.json +2 -1
- package/integrations/vite/index.js +2 -2
- package/integrations/vite/vite-env.d.ts +7 -4
- package/integrations/webpack/index.js +3 -3
- package/package.json +76 -10
- package/src/core/internal.js +31 -0
- package/src/core/logger.js +95 -23
- package/src/core/modules.js +17 -8
- package/src/core/readyState.js +1 -1
- package/src/core/runtime.js +74 -27
- package/src/core/worker-helper.js +83 -4
- package/src/crypto/NIST_CONFORMANCE.md +47 -34
- package/src/crypto/cipher/aes.acvp.md +7 -8
- package/src/crypto/cipher/aes.js +280 -229
- package/src/crypto/cipher/chacha20.acvp.md +6 -7
- package/src/crypto/cipher/chacha20.js +91 -61
- package/src/crypto/hash/adf.js +1 -1
- package/src/crypto/hash/argon2.acvp.md +11 -15
- package/src/crypto/hash/argon2.js +9 -24
- package/src/crypto/hash/blake2b.js +157 -125
- package/src/crypto/hash/hkdf.acvp.md +15 -15
- package/src/crypto/hash/hkdf.js +1 -1
- package/src/crypto/hash/hmac.acvp.md +10 -12
- package/src/crypto/hash/hmac.js +5 -1
- package/src/crypto/hash/pbkdf2.acvp.md +13 -13
- package/src/crypto/hash/pbkdf2.js +36 -8
- package/src/crypto/hash/poly1305.acvp.md +10 -6
- package/src/crypto/hash/poly1305.js +171 -50
- package/src/crypto/hash/sha224.acvp.md +3 -3
- package/src/crypto/hash/sha224.js +4 -4
- package/src/crypto/hash/sha256.acvp.md +2 -2
- package/src/crypto/hash/sha256.js +514 -50
- package/src/crypto/hash/sha3.acvp.md +9 -9
- package/src/crypto/hash/sha3.js +127 -71
- package/src/crypto/hash/sha384.acvp.md +3 -3
- package/src/crypto/hash/sha384.js +4 -4
- package/src/crypto/hash/sha512.acvp.md +7 -8
- package/src/crypto/hash/sha512.js +107 -108
- package/src/crypto/hash/sha512_224.acvp.md +6 -6
- package/src/crypto/hash/sha512_224.js +2 -2
- package/src/crypto/hash/sha512_256.acvp.md +6 -6
- package/src/crypto/hash/sha512_256.js +2 -2
- package/src/crypto/mode/cbc.acvp.md +2 -2
- package/src/crypto/mode/cbc.js +1 -1
- package/src/crypto/mode/chacha20poly1305.acvp.md +6 -6
- package/src/crypto/mode/chacha20poly1305.js +3 -3
- package/src/crypto/mode/cmac.acvp.md +5 -5
- package/src/crypto/mode/cmac.js +8 -8
- package/src/crypto/mode/ctr.acvp.md +2 -2
- package/src/crypto/mode/ctr.js +1 -3
- package/src/crypto/mode/gcm.acvp.md +6 -6
- package/src/crypto/mode/gcm.js +7 -7
- package/src/crypto/mode/kw.acvp.md +4 -4
- package/src/crypto/mode/kw.js +5 -5
- package/src/crypto/pkc/ecc.acvp.md +13 -13
- package/src/crypto/pkc/ecc.js +9 -11
- package/src/crypto/pkc/ed25519.acvp.md +30 -34
- package/src/crypto/pkc/ed25519.js +453 -94
- package/src/crypto/pkc/hybrid-kat.provenance.md +4 -4
- package/src/crypto/pkc/hybridSign.js +103 -24
- package/src/crypto/pkc/ml_dsa.acvp.md +18 -18
- package/src/crypto/pkc/ml_dsa.js +29 -32
- package/src/crypto/pkc/ml_kem.acvp.md +7 -7
- package/src/crypto/pkc/ml_kem.js +15 -21
- package/src/crypto/pkc/rsa.acvp.md +11 -15
- package/src/crypto/pkc/rsa.js +7 -44
- package/src/crypto/pkc/slh_dsa.acvp.md +16 -16
- package/src/crypto/pkc/slh_dsa.js +16 -18
- package/src/crypto/pkc/x25519.acvp.md +13 -10
- package/src/crypto/pkc/x25519.js +273 -29
- package/src/crypto/utils/aes_modes.acvp.md +1 -2
- package/src/crypto/utils/aes_modes.js +2 -2
- package/src/crypto/utils/asn1-oid.js +1 -1
- package/src/crypto/utils/asn1.js +1 -1
- package/src/crypto/utils/bitArray.js +33 -48
- package/src/crypto/utils/bn.js +1 -1
- package/src/crypto/utils/jws.js +37 -41
- package/src/crypto/utils/keyformat.js +181 -2
- package/src/crypto/utils/pem.js +1 -1
- package/src/crypto/utils/random.acvp.md +5 -5
- package/src/crypto/utils/random.js +845 -846
- package/src/crypto/utils/rsaKeygen.acvp.md +3 -2
- package/src/crypto/utils/rsaKeygen.js +6 -6
- package/src/crypto/utils/totp.js +1 -1
- package/src/crypto/utils/uuid.acvp.md +5 -5
- package/src/crypto/utils/uuid.js +11 -10
- package/src/crypto/utils/x509.js +591 -0
- package/src/crypto/wasm/aes.js +1 -1
- package/src/crypto/wasm/aes.scalar.wasm +0 -0
- package/src/crypto/wasm/argon2.js +17 -1
- package/src/crypto/wasm/argon2.scalar.wasm +0 -0
- package/src/crypto/wasm/blake2b.scalar.wasm +0 -0
- package/src/crypto/wasm/blake2b.simd.wasm +0 -0
- package/src/crypto/wasm/chacha20poly1305.scalar.wasm +0 -0
- package/src/crypto/wasm/chacha20poly1305.simd.wasm +0 -0
- package/src/crypto/wasm/cmac.scalar.wasm +0 -0
- package/src/crypto/wasm/ecc.js +3 -3
- package/src/crypto/wasm/ecc.scalar.wasm +0 -0
- package/src/crypto/wasm/ed25519.js +1 -1
- package/src/crypto/wasm/ed25519.scalar.wasm +0 -0
- package/src/crypto/wasm/hkdf.scalar.wasm +0 -0
- package/src/crypto/wasm/hmac.scalar.wasm +0 -0
- package/src/crypto/wasm/ml_dsa.js +2 -2
- package/src/crypto/wasm/ml_dsa.scalar.wasm +0 -0
- package/src/crypto/wasm/ml_dsa.simd.wasm +0 -0
- package/src/crypto/wasm/ml_kem.js +2 -2
- package/src/crypto/wasm/ml_kem.scalar.wasm +0 -0
- package/src/crypto/wasm/ml_kem.simd.wasm +0 -0
- package/src/crypto/wasm/pbkdf2.js +8 -6
- package/src/crypto/wasm/pbkdf2.scalar.wasm +0 -0
- package/src/crypto/wasm/rsa.js +6 -5
- package/src/crypto/wasm/rsa.scalar.wasm +0 -0
- package/src/crypto/wasm/runtime.js +84 -17
- package/src/crypto/wasm/sha2.scalar.wasm +0 -0
- package/src/crypto/wasm/sha3.scalar.wasm +0 -0
- package/src/crypto/wasm/sha3.simd.wasm +0 -0
- package/src/crypto/wasm/slh_dsa.js +1 -1
- package/src/crypto/wasm/slh_dsa.scalar.wasm +0 -0
- package/src/crypto/wasm/x25519.js +1 -1
- package/src/crypto/wasm/x25519.scalar.wasm +0 -0
- package/src/crypto/webcrypto/aes.js +8 -2
- package/src/crypto/webcrypto/aeskw.js +7 -2
- package/src/crypto/webcrypto/digest.js +1 -15
- package/src/crypto/webcrypto/ecc.js +2 -2
- package/src/crypto/webcrypto/ed25519.js +2 -2
- package/src/crypto/webcrypto/hmac.js +2 -2
- package/src/crypto/webcrypto/rsa.js +7 -2
- package/src/crypto/webcrypto/x25519.js +2 -2
- package/src/dom/display/animate.js +1 -1
- package/src/dom/display/fullscreen.js +1 -1
- package/src/dom/fs/download.js +1 -1
- package/src/dom/fs/fileIntake.js +192 -0
- package/src/dom/fs/fsAccess.js +2 -3
- package/src/dom/fs/indexedDB.js +1 -1
- package/src/dom/fs/remoteStore.js +1 -1
- package/src/dom/fs/storage.js +1 -1
- package/src/dom/lifecycle/idle.js +1 -1
- package/src/dom/lifecycle/visibility.js +1 -1
- package/src/dom/lifecycle/wakeLock.js +1 -1
- package/src/dom/net/ajax.js +1 -1
- package/src/dom/net/network.js +1 -1
- package/src/dom/net/sse.js +1 -1
- package/src/dom/net/webrtc.js +1 -1
- package/src/dom/net/ws.js +1 -1
- package/src/dom/query/dnd.js +56 -4
- package/src/dom/query/dom.js +1 -1
- package/src/dom/query/events.js +1 -1
- package/src/dom/query/gesture.js +1 -1
- package/src/dom/query/media.js +1 -1
- package/src/dom/query/sound.js +333 -0
- package/src/dom/rendering/chart.js +736 -663
- package/src/dom/rendering/component.js +25 -14
- package/src/dom/rendering/devtools.js +2 -2
- package/src/dom/rendering/parser.js +155 -12
- package/src/dom/rendering/render.js +14 -4
- package/src/dom/rendering/sanitize.js +11 -4
- package/src/dom/rendering/secPolicy.js +6 -4
- package/src/dom/rendering/styleSheet.js +217 -0
- package/src/dom/rendering/template.js +72 -13
- package/src/dom/rendering/themeTokens.js +542 -522
- package/src/dom/rendering/uiSession-core.js +51 -6
- package/src/dom/rendering/uiSession-direct.js +1 -1
- package/src/dom/rendering/uiSession-list.js +4 -4
- package/src/dom/rendering/uiSession.js +1 -1
- package/src/dom/rendering/virtualScroll.js +341 -341
- package/src/dom/sensors/battery.js +1 -1
- package/src/dom/sensors/geolocation.js +1 -1
- package/src/dom/sensors/networkInfo.js +1 -1
- package/src/dom/sensors/sensors.js +1 -1
- package/src/dom/sw/backgroundSync.js +1 -1
- package/src/dom/sw/cache.js +1 -1
- package/src/dom/sw/installPrompt.js +151 -0
- package/src/dom/sw/precache.js +257 -0
- package/src/dom/sw/push.js +1 -1
- package/src/dom/sw/sharedWorker.js +1 -1
- package/src/dom/sw/swUpdate.js +239 -0
- package/src/dom/utils/a11y.js +1 -1
- package/src/dom/utils/clipboard.js +56 -6
- package/src/dom/utils/entropyCollector.js +1 -1
- package/src/dom/utils/focus.js +1 -1
- package/src/dom/utils/form.js +1 -1
- package/src/dom/utils/keybindings.js +600 -574
- package/src/dom/utils/leaderElection.js +1 -1
- package/src/dom/utils/notifications.js +1 -1
- package/src/dom/utils/permissions.js +107 -107
- package/src/dom/utils/route.js +14 -2
- package/src/dom/utils/ua.js +42 -28
- package/src/dom/utils/webauthn.js +1 -1
- package/src/io/binary/reader.js +1 -1
- package/src/io/binary/writer.js +1 -1
- package/src/io/calc/bigint.js +1 -1
- package/src/io/calc/crc32.js +28 -2
- package/src/io/calc/easing.js +514 -514
- package/src/io/codec/b64.js +189 -52
- package/src/io/codec/base32.js +1 -1
- package/src/io/codec/base58.js +1 -1
- package/src/io/codec/buffer.js +1 -1
- package/src/io/codec/cbor.js +111 -18
- package/src/io/codec/csv.js +1 -1
- package/src/io/codec/hex.js +51 -6
- package/src/io/codec/mime.js +1 -1
- package/src/io/codec/msgpack.js +47 -6
- package/src/io/codec/url.js +24 -7
- package/src/io/codec/utf8.js +5 -3
- package/src/io/codec/xml.js +1 -1
- package/src/io/compress/bitstream.js +2 -2
- package/src/io/compress/brotli.js +663 -163
- package/src/io/compress/brotli_dict.js +1 -1
- package/src/io/compress/brotli_dict_words.js +1 -1
- package/src/io/compress/brotli_frame.js +1 -1
- package/src/io/compress/brotli_shared.js +7 -7
- package/src/io/compress/deflate.js +87 -53
- package/src/io/compress/gzip.js +187 -74
- package/src/io/compress/huffman.js +24 -1
- package/src/io/compress/lz4.js +45 -7
- package/src/io/compress/lz77.js +148 -63
- package/src/io/compress/lzw.js +35 -19
- package/src/io/compress/zip.js +862 -815
- package/src/io/compress/zlib.js +87 -7
- package/src/io/i18n/i18n.js +1 -1
- package/src/io/math/fixed-point.js +1 -1
- package/src/io/math/geom.js +1 -1
- package/src/io/math/interp.js +1 -1
- package/src/io/math/linalg.js +10 -4
- package/src/io/math/stats.js +1 -1
- package/src/io/structures/btree.js +1 -1
- package/src/io/structures/heap.js +1 -1
- package/src/io/structures/lruCache.js +1 -1
- package/src/io/structures/ringBuffer.js +1 -1
- package/src/io/structures/tree-walker.js +1 -1
- package/src/io/structures/trie.js +1 -1
- package/src/io/sync/abort.js +1 -1
- package/src/io/sync/atomics.js +1 -1
- package/src/io/sync/cancellable.js +1 -1
- package/src/io/sync/channel.js +1 -1
- package/src/io/sync/mutex.js +1 -1
- package/src/io/sync/semaphore.js +1 -1
- package/src/io/sync/tokenBucket.js +1 -1
- package/src/io/text/ansi.js +1 -1
- package/src/io/text/html-entities.js +1 -1
- package/src/io/time/date.js +1 -1
- package/src/io/timing/clock.js +1 -1
- package/src/io/timing/rateLimit.js +1 -1
- package/src/io/timing/scheduler.js +1 -1
- package/src/io/utils/errors.js +1 -1
- package/src/io/utils/eventBus.js +1 -1
- package/src/io/utils/signal.js +1 -1
- package/src/io/utils/valid.js +1 -1
- package/src/main.js +1 -1
- package/src/process/message.js +1 -1
- package/src/process/rpc.js +7 -3
- package/src/process/workerPool.js +11 -4
- package/src/sanity/base.js +85 -39
- package/src/sanity/lockdown-apply.js +3 -3
- package/src/sanity/lockdown.js +58 -32
- package/src/sanity/wasm-gate.js +2 -2
- package/src/typed.js +7 -3
- package/third-party/NOTICE-brotli-dictionary.txt +69 -0
- package/third-party/NOTICE-fw-wasm-crypto.txt +576 -0
- package/third-party/NOTICE-whatwg-entities.txt +44 -0
- package/types/registry.generated.d.ts +7 -1
- package/types/typed.d.ts +7 -3
- package/dist/types/crypto/utils/aes_ctr.d.ts +0 -84
- package/dist/types/crypto/utils/aes_ctr.d.ts.map +0 -1
- package/docs/api/crypto/utils/aes_ctr.md +0 -71
- package/src/crypto/utils/aes_ctr.acvp.md +0 -67
- package/src/crypto/utils/aes_ctr.js +0 -134
|
@@ -21,7 +21,7 @@ bun packages/front/fw/tools/hybrid-kat-regen.js # exit 0 = byte-identica
|
|
|
21
21
|
| Role | Official IETF X-Wing KAT (tv0..tv2) — conformance oracle for `hybridKem` |
|
|
22
22
|
| Standard | `draft-connolly-cfrg-xwing-kem` **rev -06**, Appendix C |
|
|
23
23
|
| Upstream source | Official IETF/libsodium reference KAT `crypto_kem/xwing/kem_xwing.c` |
|
|
24
|
-
| Retrieval | Byte-extracted 2026-07-06 during the hybrid design
|
|
24
|
+
| Retrieval | Byte-extracted 2026-07-06 during the hybrid design; the reference `.c` is UNTRACKED / absent from fresh worktrees, so these transcribed bytes are the tracked source of truth |
|
|
25
25
|
| SHA-256 | `ed610bc7ac6d7f5cb664662d220d977f2c5851cb494c3c83517ecf587f10335e` |
|
|
26
26
|
| Regen | `tools/hybrid-kat-regen.js` recomputes `ekPrefix` / `ctPrefix` / full `ss` from each `seed` + `randomness` and asserts byte-identity |
|
|
27
27
|
|
|
@@ -54,9 +54,9 @@ bun packages/front/fw/tools/hybrid-kat-regen.js # exit 0 = byte-identica
|
|
|
54
54
|
| Field | Value |
|
|
55
55
|
|---|---|
|
|
56
56
|
| Role | Reproducibility lock (self-KAT) for the FROZEN `hybridSign` construction — NOT an external vendor |
|
|
57
|
-
| Origin | Generated by `tools/hybrid-kat-regen.js` from a fixed per-variant DRBG seed (SHAKE-256) driving the frozen keygen +
|
|
58
|
-
| Retrieval | Generated 2026-07-09 from the frozen fw implementations |
|
|
59
|
-
| SHA-256 | `
|
|
57
|
+
| Origin | Generated by `tools/hybrid-kat-regen.js` from a fixed per-variant DRBG seed (SHAKE-256) driving the frozen keygen + the sign path (ML-DSA hedged, its rnd drawn from the same DRBG) |
|
|
58
|
+
| Retrieval | Generated 2026-07-09 from the frozen fw implementations; `sig` regenerated 2026-11-10 when `ml_dsa.sign` became hedged by default (`pk` unchanged) |
|
|
59
|
+
| SHA-256 | `9965ba10a865c5af59b5a66b5480365a572faf0c3641f786c3720f5f1cd603a5` |
|
|
60
60
|
| Regen | `tools/hybrid-kat-regen.js` re-derives `pk` + `sig` per case and asserts byte-identity + `verify() === true` |
|
|
61
61
|
|
|
62
62
|
## -19 re-vendor outcome (cf-a residual)
|
|
@@ -5,8 +5,7 @@
|
|
|
5
5
|
/**
|
|
6
6
|
* @fileoverview Composite (hybrid PQ/T) signatures — `draft-ietf-lamps-pq-composite-sigs`.
|
|
7
7
|
*
|
|
8
|
-
*
|
|
9
|
-
* verdict GO) into an `@awacloud/fw` DI-factory module composing ONLY vetted fw
|
|
8
|
+
* An `@awacloud/fw` DI-factory module composing ONLY vetted fw
|
|
10
9
|
* primitives — no novel cryptography. Two registered variants:
|
|
11
10
|
*
|
|
12
11
|
* - `mldsa65_ed25519` — ML-DSA-65 ∧ Ed25519 (OID 1.3.6.1.5.5.7.6.48)
|
|
@@ -33,7 +32,7 @@
|
|
|
33
32
|
* (not a DER-OID Domain). This exact wiring reproduces the official LAMPS
|
|
34
33
|
* interop vectors — do not deviate.
|
|
35
34
|
*
|
|
36
|
-
* ## Digest domain
|
|
35
|
+
* ## Digest domain
|
|
37
36
|
*
|
|
38
37
|
* fw's pure-JS `sha512.hash()` consumes a **bitArray** (word-packed `number[]`),
|
|
39
38
|
* NOT a raw `Uint8Array`. This module hashes message bytes through the bitArray
|
|
@@ -60,8 +59,6 @@
|
|
|
60
59
|
* - Constant-time is NOT a security boundary in browser JS/WASM (JIT, GC). The
|
|
61
60
|
* ECDSA-P256 scalar path in fw `ecc` is windowed (cache-timing sensitive).
|
|
62
61
|
* - Vectors are pinned to `main` commit 1bb9f5c6 (see the vendored vector files).
|
|
63
|
-
*
|
|
64
|
-
* @see ai/plans/pqc-hybrid/spikes/w0-combiners/FINDINGS.md
|
|
65
62
|
*/
|
|
66
63
|
|
|
67
64
|
import { ml_dsa } from './ml_dsa.js';
|
|
@@ -80,8 +77,29 @@ import { utf8 } from '../../io/codec/utf8.js';
|
|
|
80
77
|
* Generate a composite key pair (independent per-component seeds). TLV-encoded.
|
|
81
78
|
* @property {(secretKey: Uint8Array, message: Uint8Array, ctx?: Uint8Array) => (Uint8Array|false)} sign
|
|
82
79
|
* Composite sign; `false` on invalid input.
|
|
83
|
-
* @property {(publicKey: Uint8Array,
|
|
80
|
+
* @property {(publicKey: Uint8Array, signature: Uint8Array, message: Uint8Array, ctx?: Uint8Array) => boolean} verify
|
|
84
81
|
* Composite verify (AND of both components); `false` on any invalid input.
|
|
82
|
+
* @property {(kind: CompositeKind, parts: CompositeParts) => (Uint8Array|false)} fromComponents
|
|
83
|
+
* Build this variant's public key, secret key or signature container from
|
|
84
|
+
* its two components; `false` on a wrong length or form.
|
|
85
|
+
* @property {(kind: CompositeKind, bytes: Uint8Array) => (CompositeParts|false)} toComponents
|
|
86
|
+
* Split a container into its two components (copies); `false` when it does
|
|
87
|
+
* not decode.
|
|
88
|
+
*/
|
|
89
|
+
|
|
90
|
+
/**
|
|
91
|
+
* Which container `fromComponents` / `toComponents` handle.
|
|
92
|
+
* @typedef {'publicKey' | 'secretKey' | 'signature'} CompositeKind
|
|
93
|
+
*/
|
|
94
|
+
|
|
95
|
+
/**
|
|
96
|
+
* The two components of a composite container: `pq` = the ML-DSA-65 bytes,
|
|
97
|
+
* `trad` = the traditional component — Ed25519 (public key 32, secret key 64 =
|
|
98
|
+
* seed || public key, signature 64) or ECDSA-P256 (public key SEC1
|
|
99
|
+
* uncompressed 65 bytes, secret key the 32-byte scalar, signature DER).
|
|
100
|
+
* @typedef {object} CompositeParts
|
|
101
|
+
* @property {Uint8Array} pq
|
|
102
|
+
* @property {Uint8Array} trad
|
|
85
103
|
*/
|
|
86
104
|
|
|
87
105
|
/**
|
|
@@ -89,14 +107,13 @@ import { utf8 } from '../../io/codec/utf8.js';
|
|
|
89
107
|
* @typedef {object} HybridSignApi
|
|
90
108
|
* @property {HybridSignVariant} mldsa65_ed25519 ML-DSA-65 ∧ Ed25519.
|
|
91
109
|
* @property {HybridSignVariant} mldsa65_ecdsaP256 ML-DSA-65 ∧ ECDSA-P-256.
|
|
92
|
-
* @property {object} _internal Test-only escape hatch.
|
|
93
110
|
*/
|
|
94
111
|
|
|
95
112
|
export const hybridSign = {
|
|
96
113
|
name: 'hybridSign',
|
|
97
114
|
version: '1.0.0',
|
|
98
115
|
type: 'fw.crypto.pkc',
|
|
99
|
-
// NOTE — `sha256` and `random` extend the
|
|
116
|
+
// NOTE — `sha256` and `random` extend the minimal dependency set
|
|
100
117
|
// (`ml_dsa,ed25519,ecc,sha512,utf8`). Both are load-bearing and vector-/
|
|
101
118
|
// implementation-justified: the ECDSA-P256 component hashes M' with SHA-256
|
|
102
119
|
// (proven against the official vectors — SHA-512/384 fail), and Ed25519
|
|
@@ -144,7 +161,7 @@ export const hybridSign = {
|
|
|
144
161
|
|
|
145
162
|
// ── byte-domain helpers (pure; replicate bitArray big-endian packing) ──
|
|
146
163
|
// Local wrappers avoid a `bitArray` dependency while still hashing through
|
|
147
|
-
// the correct (word-packed) domain —
|
|
164
|
+
// the correct (word-packed) domain — hashing raw bytes there would give the wrong digest.
|
|
148
165
|
function _partial(len, x, end) {
|
|
149
166
|
if (len === 32) return x;
|
|
150
167
|
return (end ? x | 0 : x << (32 - len)) + len * 0x10000000000;
|
|
@@ -305,14 +322,14 @@ export const hybridSign = {
|
|
|
305
322
|
const context = ctx || new Uint8Array(0);
|
|
306
323
|
if (context.length > 255) return false;
|
|
307
324
|
const mPrime = _buildMprime(LABEL_ED, message, context);
|
|
308
|
-
const sigMl = MLDSA.sign(
|
|
325
|
+
const sigMl = MLDSA.sign(mldsaSk, mPrime, LABEL_ED);
|
|
309
326
|
if (sigMl === false) return false;
|
|
310
327
|
const sigEd = ed25519.sign(edSk, mPrime);
|
|
311
328
|
if (sigEd === false) return false;
|
|
312
329
|
return _concat([sigMl, sigEd]); // fixed slices, no randomizer
|
|
313
330
|
}
|
|
314
331
|
|
|
315
|
-
function _edVerify(publicKey,
|
|
332
|
+
function _edVerify(publicKey, signature, message, ctx) {
|
|
316
333
|
const parts = _decodeTlv(publicKey, SCHEME_ED, 2);
|
|
317
334
|
if (parts === false) return false;
|
|
318
335
|
const [mldsaPk, edPk] = parts;
|
|
@@ -323,8 +340,8 @@ export const hybridSign = {
|
|
|
323
340
|
const mPrime = _buildMprime(LABEL_ED, message, context);
|
|
324
341
|
const sigMl = signature.subarray(0, MLDSA_SIG);
|
|
325
342
|
const sigEd = signature.subarray(MLDSA_SIG);
|
|
326
|
-
const okMl = MLDSA.verify(sigMl, mPrime,
|
|
327
|
-
const okEd = ed25519.verify(edPk,
|
|
343
|
+
const okMl = MLDSA.verify(mldsaPk, sigMl, mPrime, LABEL_ED);
|
|
344
|
+
const okEd = ed25519.verify(edPk, sigEd, mPrime);
|
|
328
345
|
return okMl === true && okEd === true; // AND — both MUST hold
|
|
329
346
|
}
|
|
330
347
|
|
|
@@ -358,7 +375,7 @@ export const hybridSign = {
|
|
|
358
375
|
const context = ctx || new Uint8Array(0);
|
|
359
376
|
if (context.length > 255) return false;
|
|
360
377
|
const mPrime = _buildMprime(LABEL_EC, message, context);
|
|
361
|
-
const sigMl = MLDSA.sign(
|
|
378
|
+
const sigMl = MLDSA.sign(mldsaSk, mPrime, LABEL_EC);
|
|
362
379
|
if (sigMl === false) return false;
|
|
363
380
|
const secObj = ecc.deserialize({ type: 'ecdsa', secretKey: true, curve: 'c256', exponent: _toHex(ecSk) });
|
|
364
381
|
if (secObj === false) return false;
|
|
@@ -369,7 +386,7 @@ export const hybridSign = {
|
|
|
369
386
|
return _concat([sigMl, _u16(der.length), der]); // length-prefixed DER
|
|
370
387
|
}
|
|
371
388
|
|
|
372
|
-
function _ecVerify(publicKey,
|
|
389
|
+
function _ecVerify(publicKey, signature, message, ctx) {
|
|
373
390
|
const parts = _decodeTlv(publicKey, SCHEME_EC, 2);
|
|
374
391
|
if (parts === false) return false;
|
|
375
392
|
const [mldsaPk, ecPk] = parts;
|
|
@@ -382,7 +399,7 @@ export const hybridSign = {
|
|
|
382
399
|
const mPrime = _buildMprime(LABEL_EC, message, context);
|
|
383
400
|
const sigMl = signature.subarray(0, MLDSA_SIG);
|
|
384
401
|
const der = signature.subarray(MLDSA_SIG + 2);
|
|
385
|
-
const okMl = MLDSA.verify(sigMl, mPrime,
|
|
402
|
+
const okMl = MLDSA.verify(mldsaPk, sigMl, mPrime, LABEL_EC);
|
|
386
403
|
if (okMl !== true) return false;
|
|
387
404
|
const rs = _derToRs(der);
|
|
388
405
|
if (rs === false) return false;
|
|
@@ -394,7 +411,65 @@ export const hybridSign = {
|
|
|
394
411
|
return okEc === true;
|
|
395
412
|
}
|
|
396
413
|
|
|
397
|
-
|
|
414
|
+
// ══════════════════ Composite seam (§3) ══════════════════════
|
|
415
|
+
/**
|
|
416
|
+
* `fromComponents` / `toComponents` for one variant. The containers are
|
|
417
|
+
* the ones `keygen` / `sign` produce: the TLV keys, and the signature
|
|
418
|
+
* as fixed slices (Ed25519) or a length-prefixed DER component (ECDSA).
|
|
419
|
+
* Results are copies; malformed input is `false`, never a throw.
|
|
420
|
+
* @param {number} scheme
|
|
421
|
+
* @param {number} tradPk
|
|
422
|
+
* @param {number} tradSk
|
|
423
|
+
* @param {boolean} isEc
|
|
424
|
+
*/
|
|
425
|
+
function _seam(scheme, tradPk, tradSk, isEc) {
|
|
426
|
+
const isBytes = (x) => x instanceof Uint8Array;
|
|
427
|
+
const pkOk = (pq, trad) => pq.length === MLDSA_PK && trad.length === tradPk && (!isEc || trad[0] === 0x04);
|
|
428
|
+
const skOk = (pq, trad) => pq.length === MLDSA_SK && trad.length === tradSk;
|
|
429
|
+
const derOk = (der) => der.length <= 0xffff && _derToRs(der) !== false;
|
|
430
|
+
|
|
431
|
+
function fromComponents(kind, parts) {
|
|
432
|
+
if (!parts || !isBytes(parts.pq) || !isBytes(parts.trad)) return false;
|
|
433
|
+
const { pq, trad } = parts;
|
|
434
|
+
if (kind === 'publicKey') return pkOk(pq, trad) ? _encodeTlv(scheme, [pq, trad]) : false;
|
|
435
|
+
if (kind === 'secretKey') return skOk(pq, trad) ? _encodeTlv(scheme, [pq, trad]) : false;
|
|
436
|
+
if (kind === 'signature') {
|
|
437
|
+
if (pq.length !== MLDSA_SIG) return false;
|
|
438
|
+
if (!isEc) return trad.length === ED_SIG ? _concat([pq, trad]) : false;
|
|
439
|
+
return derOk(trad) ? _concat([pq, _u16(trad.length), trad]) : false;
|
|
440
|
+
}
|
|
441
|
+
return false;
|
|
442
|
+
}
|
|
443
|
+
|
|
444
|
+
function toComponents(kind, bytes) {
|
|
445
|
+
if (!isBytes(bytes)) return false;
|
|
446
|
+
if (kind === 'publicKey' || kind === 'secretKey') {
|
|
447
|
+
const p = _decodeTlv(bytes, scheme, 2);
|
|
448
|
+
if (p === false) return false;
|
|
449
|
+
if (!(kind === 'publicKey' ? pkOk : skOk)(p[0], p[1])) return false;
|
|
450
|
+
return { pq: new Uint8Array(p[0]), trad: new Uint8Array(p[1]) };
|
|
451
|
+
}
|
|
452
|
+
if (kind === 'signature') {
|
|
453
|
+
if (!isEc) {
|
|
454
|
+
if (bytes.length !== MLDSA_SIG + ED_SIG) return false;
|
|
455
|
+
return { pq: bytes.slice(0, MLDSA_SIG), trad: bytes.slice(MLDSA_SIG) };
|
|
456
|
+
}
|
|
457
|
+
if (bytes.length < MLDSA_SIG + 2) return false;
|
|
458
|
+
const derLen = (bytes[MLDSA_SIG] << 8) | bytes[MLDSA_SIG + 1];
|
|
459
|
+
if (MLDSA_SIG + 2 + derLen !== bytes.length) return false;
|
|
460
|
+
const der = bytes.slice(MLDSA_SIG + 2);
|
|
461
|
+
return derOk(der) ? { pq: bytes.slice(0, MLDSA_SIG), trad: der } : false;
|
|
462
|
+
}
|
|
463
|
+
return false;
|
|
464
|
+
}
|
|
465
|
+
|
|
466
|
+
return { fromComponents, toComponents };
|
|
467
|
+
}
|
|
468
|
+
|
|
469
|
+
const SEAM_ED = _seam(SCHEME_ED, ED_PK, ED_SK, false);
|
|
470
|
+
const SEAM_EC = _seam(SCHEME_EC, EC_PK, EC_SK, true);
|
|
471
|
+
|
|
472
|
+
return Object.defineProperty({
|
|
398
473
|
mldsa65_ed25519: {
|
|
399
474
|
lengths: Object.freeze({
|
|
400
475
|
mldsaPk: MLDSA_PK, tradPk: ED_PK, mldsaSk: MLDSA_SK, tradSk: ED_SK,
|
|
@@ -405,7 +480,9 @@ export const hybridSign = {
|
|
|
405
480
|
}),
|
|
406
481
|
keygen: _edKeygen,
|
|
407
482
|
sign: _edSign,
|
|
408
|
-
verify: _edVerify
|
|
483
|
+
verify: _edVerify,
|
|
484
|
+
fromComponents: SEAM_ED.fromComponents,
|
|
485
|
+
toComponents: SEAM_ED.toComponents
|
|
409
486
|
},
|
|
410
487
|
mldsa65_ecdsaP256: {
|
|
411
488
|
lengths: Object.freeze({
|
|
@@ -417,11 +494,13 @@ export const hybridSign = {
|
|
|
417
494
|
}),
|
|
418
495
|
keygen: _ecKeygen,
|
|
419
496
|
sign: _ecSign,
|
|
420
|
-
verify: _ecVerify
|
|
421
|
-
|
|
422
|
-
|
|
423
|
-
|
|
424
|
-
|
|
497
|
+
verify: _ecVerify,
|
|
498
|
+
fromComponents: SEAM_EC.fromComponents,
|
|
499
|
+
toComponents: SEAM_EC.toComponents
|
|
500
|
+
}
|
|
501
|
+
}, Symbol.for('@awacloud/fw/internal'), {
|
|
502
|
+
// Test-only internals, in the internal slot (core/internal.js): not API.
|
|
503
|
+
value: {
|
|
425
504
|
buildMprime: _buildMprime,
|
|
426
505
|
sha512Bytes: _sha512Bytes,
|
|
427
506
|
ui8ToBa: _ui8ToBa,
|
|
@@ -432,6 +511,6 @@ export const hybridSign = {
|
|
|
432
511
|
labels: { ed: LABEL_ED, ecdsaP256: LABEL_EC },
|
|
433
512
|
schemes: { ed: SCHEME_ED, ecdsaP256: SCHEME_EC }
|
|
434
513
|
}
|
|
435
|
-
};
|
|
514
|
+
});
|
|
436
515
|
}
|
|
437
516
|
};
|
|
@@ -22,23 +22,23 @@ q=8380417 (root 1753, N=256). Public API (`Uint8Array`):
|
|
|
22
22
|
|
|
23
23
|
- `keygen(seed?)` → `{ publicKey, secretKey }`. seed = 32 bytes; sk in
|
|
24
24
|
the full FIPS 204 format = packed `(ρ ‖ K ‖ tr ‖ s₁ ‖ s₂ ‖ t₀)`.
|
|
25
|
-
- `sign(
|
|
25
|
+
- `sign(secretKey, msg, ctx?, rnd?)` → signature (`Uint8Array` or `false`).
|
|
26
26
|
ctx ≤ 255 bytes (§5.4 wrapper M' = `0x00 ‖ |ctx| ‖ ctx ‖ msg`). rnd =
|
|
27
27
|
32 bytes; **zero by default (deterministic)**, hedged mode if supplied.
|
|
28
|
-
- `verify(sig, msg,
|
|
28
|
+
- `verify(publicKey, sig, msg, ctx?)` → `true | false`. Constant-time
|
|
29
29
|
comparison of the recomputed c̃ (accumulated XOR + diff===0, line 733-736).
|
|
30
30
|
|
|
31
|
-
|
|
31
|
+
Added the
|
|
32
32
|
**HashML-DSA** variants (FIPS 204 §5.4 algos 4+5), the **internal**
|
|
33
33
|
interface (§6.2 raw, without the M' wrapper), and the **externalMu**
|
|
34
34
|
mode (pre-computed mu):
|
|
35
|
-
- `signPh(
|
|
35
|
+
- `signPh(sk, msg, hashAlg, hashMod, ctx?, rnd?)` / `verifyPh(pk, sig, msg, hashAlg, hashMod, ctx?)`.
|
|
36
36
|
Supported hashes: `SHA2-{224,256,384,512}`, `SHA2-512/{224,256}`,
|
|
37
37
|
`SHA3-{224,256,384,512}`, `SHAKE-{128,256}` (12 algorithms; DER-encoded
|
|
38
38
|
OIDs conforming to FIPS 204).
|
|
39
|
-
- `
|
|
39
|
+
- `internalOf(ml_dsa).signInternal(M, sk, rnd?)` / `internalOf(ml_dsa).verifyInternal(sig, M, pk)`:
|
|
40
40
|
bypasses the §5.4 M' wrapper (M is used as the raw message bytes).
|
|
41
|
-
- `
|
|
41
|
+
- `internalOf(ml_dsa).signWithMu(mu, sk, rnd?)` / `internalOf(ml_dsa).verifyWithMu(sig, mu, pk)`:
|
|
42
42
|
skips the mu = SHAKE256(tr || M, 64) derivation; the caller supplies mu.
|
|
43
43
|
|
|
44
44
|
## Test coverage
|
|
@@ -48,9 +48,9 @@ mode (pre-computed mu):
|
|
|
48
48
|
| Source | ACVP reference | Test (`describe`) | Property verified |
|
|
49
49
|
|---|---|---|---|
|
|
50
50
|
| NIST CAVP / ACVP | `ML-DSA-keyGen-FIPS204` (9/75 sub-samples) | `ML-DSA-keyGen-FIPS204 (...9 sub-samples)` | `keygen(seed) == (pk, sk)` byte-exact |
|
|
51
|
-
| NIST CAVP / ACVP | `ML-DSA-sigGen-FIPS204` external+pure deterministic=true (9/45) | `.../external+pure (deterministic=$det)` | `sign(
|
|
52
|
-
| NIST CAVP / ACVP | `ML-DSA-sigGen-FIPS204` external+pure deterministic=false (9/45) | `.../external+pure (deterministic=$det)` | `sign(
|
|
53
|
-
| NIST CAVP / ACVP | `ML-DSA-sigVer-FIPS204` external+pure (45/45) | `.../external+pure (45/45 vectors)` | `verify(sig, msg,
|
|
51
|
+
| NIST CAVP / ACVP | `ML-DSA-sigGen-FIPS204` external+pure deterministic=true (9/45) | `.../external+pure (deterministic=$det)` | `sign(sk, msg, ctx, 0) == sig` byte-exact (rnd=zeros) |
|
|
52
|
+
| NIST CAVP / ACVP | `ML-DSA-sigGen-FIPS204` external+pure deterministic=false (9/45) | `.../external+pure (deterministic=$det)` | `sign(sk, msg, ctx, rnd) == sig` byte-exact (ACVP rnd) |
|
|
53
|
+
| NIST CAVP / ACVP | `ML-DSA-sigVer-FIPS204` external+pure (45/45) | `.../external+pure (45/45 vectors)` | `verify(pk, sig, msg, ctx)` ↔ `testPassed` (mix of valid + 14 failure reasons: modified message/signature/z/commitment/etc.) |
|
|
54
54
|
| Pre-existing (Wycheproof) | ML-DSA-65 KAT keygen/sign/verify "Hello world" | `ML-DSA-65 KAT` | byte-exact pk + sign + verify |
|
|
55
55
|
| Pre-existing | round-trip 44/65/87 | `ML-DSA-{44,65,87} round-trip` | `verify(sign(msg)) == true` |
|
|
56
56
|
| Pre-existing | tampering signature | `ML-DSA-65 verify rejects tampered signature` | bit-flip rejection |
|
|
@@ -78,7 +78,7 @@ mode (pre-computed mu):
|
|
|
78
78
|
hint, response, public key bit-flip}`).
|
|
79
79
|
- [x] **No `throw`** — early return + `console.warn/error` (review
|
|
80
80
|
lines 480-557, 670-680).
|
|
81
|
-
- [x] **HashML-DSA (preHash variant)** ✅
|
|
81
|
+
- [x] **HashML-DSA (preHash variant)** ✅ implemented.
|
|
82
82
|
`signPh(msg, sk, hashAlg, hashMod, ctx?, rnd?)` / `verifyPh` apply
|
|
83
83
|
PH(msg) with the injected hash + the FIPS 204 §5.4 algo 4 wrapper
|
|
84
84
|
(`0x01 || |ctx| || ctx || OID(hashAlg) || PH(msg)`). 12 hashAlg
|
|
@@ -86,12 +86,12 @@ mode (pre-computed mu):
|
|
|
86
86
|
SHAKE-{128,256}). **9 SigGen + 45 SigVer ACVP vectors byte-exact**
|
|
87
87
|
(3/group sub-sample across 3 paramSets for SigGen, full coverage
|
|
88
88
|
for SigVer).
|
|
89
|
-
- [x] **"internal" interface** ✅
|
|
90
|
-
`
|
|
89
|
+
- [x] **"internal" interface** ✅ exposed via
|
|
90
|
+
`internalOf(ml_dsa).signInternal(M, sk, rnd?)` and `internalOf(ml_dsa).verifyInternal`.
|
|
91
91
|
Bypasses the §5.4 wrapper; M is passed as-is to mu = SHAKE256(tr||M, 64).
|
|
92
92
|
**9 ACVP vectors byte-exact** (3/paramSet sub-sample).
|
|
93
|
-
- [x] **externalMu** ✅
|
|
94
|
-
`
|
|
93
|
+
- [x] **externalMu** ✅ exposed via
|
|
94
|
+
`internalOf(ml_dsa).signWithMu(mu, sk, rnd?)` and `internalOf(ml_dsa).verifyWithMu`.
|
|
95
95
|
Skips the mu derivation; the caller supplies the pre-computed mu
|
|
96
96
|
(typically `SHAKE256(tr || M, 64)`). **9 ACVP vectors byte-exact**.
|
|
97
97
|
- [ ] **Side-channel NTT/sampling** — not formally constant-time
|
|
@@ -122,11 +122,11 @@ mode (pre-computed mu):
|
|
|
122
122
|
270 vectors = ~25 s per group, exceeding the module's 30 s budget.
|
|
123
123
|
Sub-sampling preserves tcId diversity across the 6 external+pure
|
|
124
124
|
groups. sigVer is exhaustive (45/45 in-scope, ~3-4 ms/op).
|
|
125
|
-
|
|
125
|
+
`CRYPTO_FULL=1` enables 75/75 keyGen + 45/45 sigVer
|
|
126
126
|
external+pure + 90/90 sigGen external+pure → 364 tests in ~4 s; the
|
|
127
|
-
preHash / internal / externalMu variants remain
|
|
127
|
+
preHash / internal / externalMu variants remain sub-sampled
|
|
128
128
|
(already fully covered per variant).
|
|
129
|
-
- ~~**Out of scope**~~ ✅
|
|
129
|
+
- ~~**Out of scope**~~ ✅ HashML-DSA + internal
|
|
130
130
|
interface + externalMu are now all implemented and validated ACVP
|
|
131
131
|
byte-exact. See the `[x]` checks above.
|
|
132
132
|
- **NTT not formally CT**: Int32, branches depending only on
|
|
@@ -137,7 +137,7 @@ mode (pre-computed mu):
|
|
|
137
137
|
## Cross-references
|
|
138
138
|
|
|
139
139
|
- Module: [`pkc/ml_dsa.js`](./ml_dsa.js)
|
|
140
|
-
- Tests: [`pkc/ml_dsa.test.js`](https://github.com/awacloud/awa/blob/main/packages/front/fw/src/crypto/pkc/ml_dsa.test.js) — 154 tests (82 baseline + 72
|
|
140
|
+
- Tests: [`pkc/ml_dsa.test.js`](https://github.com/awacloud/awa/blob/main/packages/front/fw/src/crypto/pkc/ml_dsa.test.js) — 154 tests (82 baseline + 72 more: 9 sigGen-ph + 9 internal + 9 externalMu + 45 sigVer-ph)
|
|
141
141
|
- Pre-existing KAT: [`pkc/ml_dsa.kat.js`](https://github.com/awacloud/awa/blob/main/packages/front/fw/src/crypto/pkc/ml_dsa.kat.js) (Wycheproof "Hello world" ML-DSA-65)
|
|
142
142
|
- ACVP draft: `references/NIST/ACVP/src/draft-celi-acvp-ml-dsa.adoc`
|
|
143
143
|
- Vectors: `references/NIST/ACVP-Server-1.1.0.42/gen-val/json-files/ML-DSA-*-FIPS204/`
|
package/src/crypto/pkc/ml_dsa.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
|
|
1
|
+
// Copyright (c) 2026 AwaCloud SAS
|
|
2
2
|
// Author: Matthieu Bouilloux
|
|
3
3
|
// SPDX-License-Identifier: Apache-2.0
|
|
4
4
|
|
|
@@ -10,14 +10,15 @@
|
|
|
10
10
|
*
|
|
11
11
|
* Public API per parameter set:
|
|
12
12
|
* keygen(seed32?) → { publicKey, secretKey }
|
|
13
|
-
* sign(
|
|
14
|
-
* verify(sig, msg,
|
|
13
|
+
* sign(sk, msg, ctx?, rnd?) → signature (or false on internal failure)
|
|
14
|
+
* verify(pk, sig, msg, ctx?) → boolean
|
|
15
15
|
*
|
|
16
16
|
* Determinism:
|
|
17
17
|
* - keygen(seed) is deterministic.
|
|
18
|
-
* -
|
|
19
|
-
*
|
|
20
|
-
*
|
|
18
|
+
* - With no rnd, sign draws 32 random bytes: the hedged variant FIPS 204
|
|
19
|
+
* §3.4 recommends (fault and side-channel resistance), so two signatures
|
|
20
|
+
* of one message differ. Pass 32 zero bytes as rnd for the FIPS 204
|
|
21
|
+
* deterministic mode (KAT vectors, reproducible signatures).
|
|
21
22
|
*
|
|
22
23
|
* Hash bindings (FIPS 204 §3.7):
|
|
23
24
|
* H_eta uses SHAKE256 (CRH 64 bytes for tr / mu / rhoprime).
|
|
@@ -49,11 +50,10 @@ import { random } from '../utils/random.js';
|
|
|
49
50
|
* @typedef {object} MlDsaInstance
|
|
50
51
|
* @property {MlDsaLengths} lengths Byte sizes of every artefact.
|
|
51
52
|
* @property {(seed?: Uint8Array) => ({ publicKey: Uint8Array, secretKey: Uint8Array }|false)} keygen Generate a key pair (deterministic for a 32-byte seed).
|
|
52
|
-
* @property {(
|
|
53
|
-
* @property {(
|
|
54
|
-
* @property {(
|
|
55
|
-
* @property {(
|
|
56
|
-
* @property {{ signInternal: Function, verifyInternal: Function, signWithMu: Function, verifyWithMu: Function, wrapMessage: Function, wrapMessageHash: Function, computePh: Function }} _internal Test-only escape hatches.
|
|
53
|
+
* @property {(secretKey: Uint8Array, msg: Uint8Array, ctx?: Uint8Array, rnd?: Uint8Array) => (Uint8Array|false)} sign Pure ML-DSA sign (the fw order: key, message).
|
|
54
|
+
* @property {(publicKey: Uint8Array, sig: Uint8Array, msg: Uint8Array, ctx?: Uint8Array) => boolean} verify Pure ML-DSA verify (the fw order: key, signature, message).
|
|
55
|
+
* @property {(secretKey: Uint8Array, msg: Uint8Array, hashAlg: string, hashMod: ({hash: Function, shake?: Function}|Function|null), ctx?: Uint8Array, rnd?: Uint8Array) => (Uint8Array|false)} signPh HashML-DSA sign.
|
|
56
|
+
* @property {(publicKey: Uint8Array, sig: Uint8Array, msg: Uint8Array, hashAlg: string, hashMod: ({hash: Function, shake?: Function}|Function|null), ctx?: Uint8Array) => boolean} verifyPh HashML-DSA verify.
|
|
57
57
|
*/
|
|
58
58
|
|
|
59
59
|
/**
|
|
@@ -62,8 +62,6 @@ import { random } from '../utils/random.js';
|
|
|
62
62
|
* @property {MlDsaInstance} ml_dsa44 ML-DSA-44 instance.
|
|
63
63
|
* @property {MlDsaInstance} ml_dsa65 ML-DSA-65 instance.
|
|
64
64
|
* @property {MlDsaInstance} ml_dsa87 ML-DSA-87 instance.
|
|
65
|
-
* @property {(f: Int32Array) => Int32Array} _ntt Test-only NTT.
|
|
66
|
-
* @property {(f: Int32Array) => Int32Array} _nttInv Test-only inverse NTT.
|
|
67
65
|
*/
|
|
68
66
|
|
|
69
67
|
export const ml_dsa = {
|
|
@@ -578,8 +576,6 @@ export const ml_dsa = {
|
|
|
578
576
|
}
|
|
579
577
|
|
|
580
578
|
// ── HashML-DSA wrapper (FIPS 204 §5.4 Algorithm 4) ──────────
|
|
581
|
-
// Iteration E3 of the FIPS 140-3 upgrade plan.
|
|
582
|
-
//
|
|
583
579
|
// M' = 0x01 || OctetEncode(|ctx|, 1) || ctx || OID(hashAlg) || PH(message)
|
|
584
580
|
//
|
|
585
581
|
// OID is the DER-encoded ASN.1 OBJECT IDENTIFIER of the hash
|
|
@@ -630,8 +626,7 @@ export const ml_dsa = {
|
|
|
630
626
|
|
|
631
627
|
// ── sign (FIPS 204 Algorithm 2 / §6.2) ──────────────────
|
|
632
628
|
|
|
633
|
-
//
|
|
634
|
-
// extract `_signFromMu(mu, sk, rnd)` so callers may bypass the
|
|
629
|
+
// `_signFromMu(mu, sk, rnd)` is extracted so callers may bypass the
|
|
635
630
|
// §5.4 wrapping (internal interface) or supply a pre-computed mu
|
|
636
631
|
// (externalMu, useful when the same key signs many messages with
|
|
637
632
|
// a shared `tr`-based prefix).
|
|
@@ -659,7 +654,7 @@ export const ml_dsa = {
|
|
|
659
654
|
console.warn('[crypto] INVALID: ml_dsa: wrong secretKey length');
|
|
660
655
|
return false;
|
|
661
656
|
}
|
|
662
|
-
const _rnd = rnd ||
|
|
657
|
+
const _rnd = rnd || random.bytes(32);
|
|
663
658
|
if (_rnd.length !== 32) {
|
|
664
659
|
console.warn('[crypto] INVALID: ml_dsa: rnd must be 32 bytes');
|
|
665
660
|
return false;
|
|
@@ -793,7 +788,7 @@ export const ml_dsa = {
|
|
|
793
788
|
* Wraps the message with the §5.4 prefix `0x00 || |ctx| || ctx ||
|
|
794
789
|
* msg` then calls the internal signing path.
|
|
795
790
|
*/
|
|
796
|
-
function sign(
|
|
791
|
+
function sign(secretKey, msg, ctx, rnd) {
|
|
797
792
|
const M = _wrapMessage(msg, ctx);
|
|
798
793
|
if (M === false) return false;
|
|
799
794
|
return _signInternal(M, secretKey, rnd);
|
|
@@ -813,7 +808,7 @@ export const ml_dsa = {
|
|
|
813
808
|
* @param {Uint8Array} [ctx]
|
|
814
809
|
* @param {Uint8Array} [rnd]
|
|
815
810
|
*/
|
|
816
|
-
function signPh(
|
|
811
|
+
function signPh(secretKey, msg, hashAlg, hashMod, ctx, rnd) {
|
|
817
812
|
const ph = _computePh(msg, hashAlg, hashMod);
|
|
818
813
|
if (ph === false) return false;
|
|
819
814
|
const M = _wrapMessageHash(ph, ctx, hashAlg);
|
|
@@ -928,14 +923,14 @@ export const ml_dsa = {
|
|
|
928
923
|
}
|
|
929
924
|
|
|
930
925
|
/** Pure ML-DSA verify (FIPS 204 §5.4 PureML-DSA + §6.3). */
|
|
931
|
-
function verify(sig, msg,
|
|
926
|
+
function verify(publicKey, sig, msg, ctx) {
|
|
932
927
|
const M = _wrapMessage(msg, ctx);
|
|
933
928
|
if (M === false) return false;
|
|
934
929
|
return _verifyInternal(sig, M, publicKey);
|
|
935
930
|
}
|
|
936
931
|
|
|
937
932
|
/** HashML-DSA verify (FIPS 204 §5.4 Algorithm 5). */
|
|
938
|
-
function verifyPh(sig, msg,
|
|
933
|
+
function verifyPh(publicKey, sig, msg, hashAlg, hashMod, ctx) {
|
|
939
934
|
const ph = _computePh(msg, hashAlg, hashMod);
|
|
940
935
|
if (ph === false) return false;
|
|
941
936
|
const M = _wrapMessageHash(ph, ctx, hashAlg);
|
|
@@ -943,19 +938,20 @@ export const ml_dsa = {
|
|
|
943
938
|
return _verifyInternal(sig, M, publicKey);
|
|
944
939
|
}
|
|
945
940
|
|
|
946
|
-
return {
|
|
941
|
+
return Object.defineProperty({
|
|
947
942
|
lengths: Object.freeze({
|
|
948
943
|
publicKey: PK_LEN, secretKey: SK_LEN, signature: SIG_LEN, seed: 32
|
|
949
944
|
}),
|
|
950
945
|
keygen, sign, verify,
|
|
951
|
-
//
|
|
946
|
+
// HashML-DSA
|
|
952
947
|
// (FIPS 204 §5.4 Algorithms 4 + 5).
|
|
953
|
-
signPh, verifyPh
|
|
948
|
+
signPh, verifyPh
|
|
949
|
+
}, Symbol.for('@awacloud/fw/internal'), {
|
|
954
950
|
// Internal escape hatches (test-only). signInternal and
|
|
955
951
|
// verifyInternal expose the §6.2/§6.3 raw paths (no §5.4
|
|
956
952
|
// wrapping). signWithMu / verifyWithMu accept a pre-computed
|
|
957
953
|
// mu for the externalMu API mode.
|
|
958
|
-
|
|
954
|
+
value: {
|
|
959
955
|
signInternal: _signInternal,
|
|
960
956
|
verifyInternal: _verifyInternal,
|
|
961
957
|
signWithMu: _signFromMu,
|
|
@@ -964,7 +960,7 @@ export const ml_dsa = {
|
|
|
964
960
|
wrapMessageHash: _wrapMessageHash,
|
|
965
961
|
computePh: _computePh
|
|
966
962
|
}
|
|
967
|
-
};
|
|
963
|
+
});
|
|
968
964
|
}
|
|
969
965
|
|
|
970
966
|
const PARAMS = {
|
|
@@ -973,12 +969,13 @@ export const ml_dsa = {
|
|
|
973
969
|
87: { K: 8, L: 7, GAMMA1: 1 << 19, GAMMA2: GAMMA2_2, TAU: 60, ETA: 2, OMEGA: 75, C_TILDE_BYTES: 64 }
|
|
974
970
|
};
|
|
975
971
|
|
|
976
|
-
return {
|
|
972
|
+
return Object.defineProperty({
|
|
977
973
|
ml_dsa44: _make(PARAMS[44]),
|
|
978
974
|
ml_dsa65: _make(PARAMS[65]),
|
|
979
|
-
ml_dsa87: _make(PARAMS[87])
|
|
980
|
-
|
|
981
|
-
|
|
982
|
-
|
|
975
|
+
ml_dsa87: _make(PARAMS[87])
|
|
976
|
+
}, Symbol.for('@awacloud/fw/internal'), {
|
|
977
|
+
// Internal (test-only, outside the API).
|
|
978
|
+
value: { ntt: _ntt, nttInv: _nttInv }
|
|
979
|
+
});
|
|
983
980
|
}
|
|
984
981
|
};
|
|
@@ -29,9 +29,9 @@ on top of K-PKE (§5) with NTT modulo q=3329 (ζ=17). Public API (`Uint8Array`):
|
|
|
29
29
|
|
|
30
30
|
Internal API (test-only, added for ACVP `*KeyCheck`):
|
|
31
31
|
|
|
32
|
-
-
|
|
32
|
+
- `internalOf(<variant>).isValidEncapsulationKey(ek)` — §7.2 input
|
|
33
33
|
validation: length + modulus-q (ByteEncode∘ByteDecode round-trip).
|
|
34
|
-
-
|
|
34
|
+
- `internalOf(<variant>).isValidDecapsulationKey(dk)` — §7.3 input
|
|
35
35
|
validation: length + consistency H(ek_embedded) == ek_hash_embedded.
|
|
36
36
|
|
|
37
37
|
## Test coverage
|
|
@@ -43,8 +43,8 @@ Internal API (test-only, added for ACVP `*KeyCheck`):
|
|
|
43
43
|
| NIST CAVP / ACVP | `ML-KEM-keyGen-FIPS203` (9/75 sub-samples) | `ML-KEM-keyGen-FIPS203 (...9 sub-samples)` | `keygen(d‖z) == (ek, dk)` byte-exact (3 paramSets × first/mid/last) |
|
|
44
44
|
| NIST CAVP / ACVP | `ML-KEM-encapDecap` `function=encapsulation` (9/75 sub-samples, AFT) | `.../encapsulation` | `encapsulate(ek, m) == (c, k)` byte-exact |
|
|
45
45
|
| NIST CAVP / ACVP | `ML-KEM-encapDecap` `function=decapsulation` (9/30 sub-samples, VAL) | `.../decapsulation` | `decapsulate(c, dk) == k` (covers the implicit-reject branch on corrupted ct) |
|
|
46
|
-
| NIST CAVP / ACVP | `ML-KEM-encapDecap` `function=decapsulationKeyCheck` (30/30 VAL) | `.../decapsulationKeyCheck` | `
|
|
47
|
-
| NIST CAVP / ACVP | `ML-KEM-encapDecap` `function=encapsulationKeyCheck` (30/30 VAL) | `.../encapsulationKeyCheck` | `
|
|
46
|
+
| NIST CAVP / ACVP | `ML-KEM-encapDecap` `function=decapsulationKeyCheck` (30/30 VAL) | `.../decapsulationKeyCheck` | `internalOf(ml_kem).isValidDecapsulationKey(dk)` ↔ `testPassed` (5 pass + 5 fail / paramSet) |
|
|
47
|
+
| NIST CAVP / ACVP | `ML-KEM-encapDecap` `function=encapsulationKeyCheck` (30/30 VAL) | `.../encapsulationKeyCheck` | `internalOf(ml_kem).isValidEncapsulationKey(ek)` ↔ `testPassed` (5 pass + 5 fail / paramSet) |
|
|
48
48
|
| Pre-existing (noble-post-quantum) | ML-KEM-768 KAT keygen+encaps | `ML-KEM-768 KAT` | byte-exact ek/sk + ss=K |
|
|
49
49
|
| Pre-existing | round-trip 512/768/1024 | `ML-KEM-{512,768,1024} round-trip` | `decapsulate(encapsulate(ek), sk) == K` |
|
|
50
50
|
| Pre-existing | implicit reject | `ML-KEM-768 implicit reject on tampered ciphertext` | different ss but still 32 bytes |
|
|
@@ -87,8 +87,8 @@ and decapsulation (10/group) are sub-sampled as `[first, mid, last]`
|
|
|
87
87
|
| Deterministic generation (seed) | ✅ | byte-exact on 9 ACVP keyGen vectors |
|
|
88
88
|
| Deterministic encapsulation (fixed m) | ✅ | byte-exact on 9 ACVP encap vectors |
|
|
89
89
|
| Decapsulation + implicit reject | ✅ | 9 ACVP decap vectors + tampering test |
|
|
90
|
-
| Public validation (§7.2 ek) | ✅ | `
|
|
91
|
-
| Private validation (§7.3 dk) | ✅ | `
|
|
90
|
+
| Public validation (§7.2 ek) | ✅ | `internalOf(ml_kem).isValidEncapsulationKey` + 30 vectors |
|
|
91
|
+
| Private validation (§7.3 dk) | ✅ | `internalOf(ml_kem).isValidDecapsulationKey` + 30 vectors |
|
|
92
92
|
| Power-on KAT / self-test | N/A | permanent KATs via 18 deterministic vectors |
|
|
93
93
|
| CT comparisons (secret) | ✅ | `_ctEqual` throughout (modulus, hash, reject mask) |
|
|
94
94
|
| No `throw` / timing leak | ✅ | Review: `console.warn/error` + `return false` |
|
|
@@ -97,7 +97,7 @@ and decapsulation (10/group) are sub-sampled as `[first, mid, last]`
|
|
|
97
97
|
## Known limitations
|
|
98
98
|
|
|
99
99
|
- **[first/mid/last] sub-sampling** by default: 9/75 keyGen, 9/75 encap,
|
|
100
|
-
9/30 decap (CI budget < 1 s).
|
|
100
|
+
9/30 decap (CI budget < 1 s). `CRYPTO_FULL=1` enables
|
|
101
101
|
the full 75 keyGen + 165 encapDecap (encapsulation, decapsulation,
|
|
102
102
|
encapsulationKeyCheck, decapsulationKeyCheck) → 336 tests in ~0.5 s via
|
|
103
103
|
direct loading of the `internalProjection.json` + `expectedResults.json`.
|
package/src/crypto/pkc/ml_kem.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
|
|
1
|
+
// Copyright (c) 2026 AwaCloud SAS
|
|
2
2
|
// Author: Matthieu Bouilloux
|
|
3
3
|
// SPDX-License-Identifier: Apache-2.0
|
|
4
4
|
|
|
@@ -55,7 +55,6 @@ import { random } from '../utils/random.js';
|
|
|
55
55
|
* @property {(seed?: Uint8Array) => ({ publicKey: Uint8Array, secretKey: Uint8Array }|false)} keygen Generate a key pair (deterministic for a 64-byte seed).
|
|
56
56
|
* @property {(publicKey: Uint8Array, msg?: Uint8Array) => ({ cipherText: Uint8Array, sharedSecret: Uint8Array }|false)} encapsulate Encapsulate to a public key.
|
|
57
57
|
* @property {(cipherText: Uint8Array, secretKey: Uint8Array) => (Uint8Array|false)} decapsulate Decapsulate; 32-byte shared secret.
|
|
58
|
-
* @property {{ isValidEncapsulationKey: (ek: Uint8Array) => boolean, isValidDecapsulationKey: (dk: Uint8Array) => boolean }} _internal Validation helpers.
|
|
59
58
|
*/
|
|
60
59
|
|
|
61
60
|
/**
|
|
@@ -64,15 +63,6 @@ import { random } from '../utils/random.js';
|
|
|
64
63
|
* @property {MlKemInstance} ml_kem512 ML-KEM-512 instance.
|
|
65
64
|
* @property {MlKemInstance} ml_kem768 ML-KEM-768 instance.
|
|
66
65
|
* @property {MlKemInstance} ml_kem1024 ML-KEM-1024 instance.
|
|
67
|
-
* @property {(f: Uint16Array) => Uint16Array} _ntt Test-only NTT.
|
|
68
|
-
* @property {(f: Uint16Array) => Uint16Array} _nttInv Test-only inverse NTT.
|
|
69
|
-
* @property {(out: Uint16Array, a: Uint16Array, b: Uint16Array) => Uint16Array} _multiplyNTTs Test-only pointwise product.
|
|
70
|
-
* @property {(prfBytes: Uint8Array, eta: number) => Uint16Array} _sampleCBD Test-only CBD sampler.
|
|
71
|
-
* @property {(rho: Uint8Array, j: number, i: number) => Uint16Array} _sampleNTT Test-only NTT sampler.
|
|
72
|
-
* @property {(poly: Uint16Array, d: number) => Uint8Array} _byteEncode Test-only encoder.
|
|
73
|
-
* @property {(bytes: Uint8Array, d: number) => Uint16Array} _byteDecode Test-only decoder.
|
|
74
|
-
* @property {(x: number, d: number) => number} _compress Test-only compress.
|
|
75
|
-
* @property {(y: number, d: number) => number} _decompress Test-only decompress.
|
|
76
66
|
*/
|
|
77
67
|
|
|
78
68
|
export const ml_kem = {
|
|
@@ -572,10 +562,11 @@ export const ml_kem = {
|
|
|
572
562
|
return _ctEqual(h, ekHash);
|
|
573
563
|
}
|
|
574
564
|
|
|
575
|
-
return {
|
|
576
|
-
lengths, keygen, encapsulate, decapsulate
|
|
577
|
-
|
|
578
|
-
|
|
565
|
+
return Object.defineProperty({
|
|
566
|
+
lengths, keygen, encapsulate, decapsulate
|
|
567
|
+
}, Symbol.for('@awacloud/fw/internal'), {
|
|
568
|
+
value: { isValidEncapsulationKey, isValidDecapsulationKey }
|
|
569
|
+
});
|
|
579
570
|
}
|
|
580
571
|
|
|
581
572
|
const PARAMS = {
|
|
@@ -584,13 +575,16 @@ export const ml_kem = {
|
|
|
584
575
|
1024: { K: 4, ETA1: 2, ETA2: 2, du: 11, dv: 5 }
|
|
585
576
|
};
|
|
586
577
|
|
|
587
|
-
return {
|
|
578
|
+
return Object.defineProperty({
|
|
588
579
|
ml_kem512: _make(PARAMS[512]),
|
|
589
580
|
ml_kem768: _make(PARAMS[768]),
|
|
590
|
-
ml_kem1024: _make(PARAMS[1024])
|
|
591
|
-
|
|
592
|
-
|
|
593
|
-
|
|
594
|
-
|
|
581
|
+
ml_kem1024: _make(PARAMS[1024])
|
|
582
|
+
}, Symbol.for('@awacloud/fw/internal'), {
|
|
583
|
+
// Internal (test-only, outside the API).
|
|
584
|
+
value: {
|
|
585
|
+
ntt: _ntt, nttInv: _nttInv, multiplyNTTs: _multiplyNTTs, sampleCBD: _sampleCBD, sampleNTT: _sampleNTT,
|
|
586
|
+
byteEncode: _byteEncode, byteDecode: _byteDecode, compress: _compress, decompress: _decompress
|
|
587
|
+
}
|
|
588
|
+
});
|
|
595
589
|
}
|
|
596
590
|
};
|