@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
|
@@ -19,19 +19,22 @@ FIPS 186-5 + RFC 6979 compliant ECDSA (deterministic k via HMAC-DRBG, eliminates
|
|
|
19
19
|
|
|
20
20
|
```js
|
|
21
21
|
const ecc = runtime.resolve('ecc');
|
|
22
|
-
// Returns: { curves,
|
|
22
|
+
// Returns: { ecdsa, elGamal, curves, curveName, deserialize, basicKey, curve, point, pointJac }
|
|
23
23
|
```
|
|
24
24
|
|
|
25
25
|
## API
|
|
26
26
|
|
|
27
|
-
|
|
|
27
|
+
| Member | Signature | Returns |
|
|
28
28
|
|--------|-----------|---------|
|
|
29
|
-
| `curves` | `{c192, c224, c256, c384, c521, k192, k224, k256
|
|
30
|
-
| `
|
|
31
|
-
| `
|
|
32
|
-
| `
|
|
33
|
-
| `
|
|
34
|
-
| `
|
|
29
|
+
| `curves` | `{c192, c224, c256, c384, c521, k192, k224, k256}` | The registered curves: P-192 … P-521 and secp192k1 / secp224k1 / secp256k1 |
|
|
30
|
+
| `curveName(curve)` | `(curve) => string \| false` | The registry key of a curve instance (`'c256'`) |
|
|
31
|
+
| `ecdsa.generateKeys(curve, paranoia?, sec?)` | `(number \| curve, number?, bn?) => {pub, sec} \| false` | A key pair; a number is a curve size (`256` → `curves.c256`) |
|
|
32
|
+
| `ecdsa.secretKey` / `ecdsa.publicKey` | constructors `(curve, exponent)` / `(curve, point)` | Key objects (prefer `generateKeys` / `deserialize`) |
|
|
33
|
+
| `sec.sign(hash, opts?)` | `(bitArray, {strict?, hashForK?, deterministic?}) => bitArray` | `r ‖ s` (deterministic RFC 6979 by default) |
|
|
34
|
+
| `pub.verify(hash, rs, opts?)` | `(bitArray, bitArray, {strict?, fakeLegacyVersion?}) => boolean` | `true`, or `false` on any invalid input |
|
|
35
|
+
| `elGamal.generateKeys(curve, paranoia?, sec?)` | as `ecdsa` | ECDH key pair: `sec.dh(pub)`, `pub.kem()` → `{key, tag}`, `sec.unkem(tag)` |
|
|
36
|
+
| `deserialize(key)` | `({type: 'ecdsa'\|'elGamal', curve, point \| exponent, secretKey?}) => key \| false` | A public key (subgroup-checked) or a secret key; `point` is the hex of `x ‖ y`, `exponent` hex, `curve` a `curves` key |
|
|
37
|
+
| `basicKey`, `curve`, `point`, `pointJac` | constructors | The low-level key, curve and point classes the keys are built on |
|
|
35
38
|
|
|
36
39
|
### Options
|
|
37
40
|
|
|
@@ -46,22 +49,21 @@ const ecc = runtime.resolve('ecc');
|
|
|
46
49
|
```js
|
|
47
50
|
const { ecc, sha256 } = fw.runtime.resolveAll(['ecc', 'sha256']);
|
|
48
51
|
|
|
49
|
-
const
|
|
50
|
-
const pk = sk.publicKey;
|
|
52
|
+
const { pub, sec } = ecc.ecdsa.generateKeys(256);
|
|
51
53
|
|
|
52
54
|
const hashBa = sha256.hash('message');
|
|
53
|
-
const sig =
|
|
54
|
-
const ok =
|
|
55
|
+
const sig = sec.sign(hashBa); // deterministic RFC 6979
|
|
56
|
+
const ok = pub.verify(hashBa, sig); // true
|
|
55
57
|
|
|
56
58
|
// Strict mode (low-s)
|
|
57
|
-
const sigStrict =
|
|
58
|
-
const okStrict =
|
|
59
|
+
const sigStrict = sec.sign(hashBa, { strict: true });
|
|
60
|
+
const okStrict = pub.verify(hashBa, sigStrict, { strict: true });
|
|
59
61
|
```
|
|
60
62
|
|
|
61
63
|
### Subgroup check (deserialize)
|
|
62
64
|
|
|
63
65
|
```js
|
|
64
|
-
const
|
|
66
|
+
const pk = ecc.deserialize({ type: 'ecdsa', curve: 'c256', point: hexPoint }); // false if the point is outside the subgroup
|
|
65
67
|
```
|
|
66
68
|
|
|
67
69
|
## Worker Usage
|
|
@@ -69,7 +71,7 @@ const pkPoint = ecc.deserialize(rawBytes, 'c256'); // false if point is outsid
|
|
|
69
71
|
```js
|
|
70
72
|
const worker = fw.createWorker(
|
|
71
73
|
function ({ libs, args }) {
|
|
72
|
-
const sk = libs.ecc.secretKey
|
|
74
|
+
const sk = libs.ecc.deserialize({ type: 'ecdsa', secretKey: true, curve: 'c256', exponent: args[0] });
|
|
73
75
|
self.postMessage(sk.sign(args[1]));
|
|
74
76
|
},
|
|
75
77
|
{ dependencies: ['ecc'], args: [exponent, hashBa] }
|
|
@@ -82,7 +84,7 @@ const worker = fw.createWorker(
|
|
|
82
84
|
- **Scalar mult NOT constant-time**: 4-bit windowed method with pre-computed multiple table — the index is the scalar nibble, observable via cache-timing (Bernstein 2005). Acceptable in a browser without a co-resident adversary; for multi-tenant servers prefer WebCrypto `subtle.*` or X25519/Ed25519.
|
|
83
85
|
- **Subgroup check FIPS 186-5 §A.4.2**: `deserialize` rejects points outside the subgroup of order `n` (~1-3 ms per P-256).
|
|
84
86
|
- **P-521 RFC 6979** byte-exact (fixes the `bn.bitLength() = 528` rounding bug via the `_trueBitLength` helper).
|
|
85
|
-
- **K-curves (Koblitz)**:
|
|
87
|
+
- **K-curves (Koblitz)**: k192, k224 and k256 (secp192k1 / secp224k1 / secp256k1) — prefer the P-curves.
|
|
86
88
|
|
|
87
89
|
## See also
|
|
88
90
|
|
|
@@ -19,7 +19,7 @@ EdDSA over Curve25519 (cofactor 8). Faster than ECDSA, deterministic by construc
|
|
|
19
19
|
|
|
20
20
|
```js
|
|
21
21
|
const ed25519 = runtime.resolve('ed25519');
|
|
22
|
-
// Returns: { keyPair, sign, verify, signPh, verifyPh, signCtx, verifyCtx
|
|
22
|
+
// Returns: { keyPair, sign, verify, signPh, verifyPh, signCtx, verifyCtx }
|
|
23
23
|
```
|
|
24
24
|
|
|
25
25
|
## API
|
|
@@ -28,12 +28,11 @@ const ed25519 = runtime.resolve('ed25519');
|
|
|
28
28
|
|--------|-----------|---------|
|
|
29
29
|
| `keyPair(seed)` | `(Uint8Array(32)) => {publicKey, privateKey} \| false` | Derives the pair from the seed; `false` if seed absent or ≠ 32 bytes |
|
|
30
30
|
| `sign(privateKey, msg)` | `(Uint8Array(64), Uint8Array) => Uint8Array(64) \| false` | Pure Ed25519 signature (`privateKey` = seed ‖ pubKey, 64 bytes) |
|
|
31
|
-
| `verify(publicKey,
|
|
31
|
+
| `verify(publicKey, sig, msg)` | `(Uint8Array(32), Uint8Array(64), Uint8Array) => boolean` | Verifies + rejects s≥L constant-time |
|
|
32
32
|
| `signPh(privateKey, msg, ctx?)` | `(Uint8Array(64), Uint8Array, Uint8Array?) => Uint8Array(64) \| false` | Ed25519ph — pass the **raw message** (SHA-512 applied internally) |
|
|
33
|
-
| `verifyPh(publicKey,
|
|
33
|
+
| `verifyPh(publicKey, sig, msg, ctx?)` | — | `boolean` |
|
|
34
34
|
| `signCtx(privateKey, msg, ctx)` | `(Uint8Array(64), Uint8Array, Uint8Array(1..255)) => Uint8Array(64) \| false` | Ed25519ctx (context required, 1..255 bytes) |
|
|
35
|
-
| `verifyCtx(publicKey,
|
|
36
|
-
| `ed448.{keyPair,sign,verify,signPh,verifyPh}` | `() => false` | **NOT-IMPLEMENTED** explicit reject |
|
|
35
|
+
| `verifyCtx(publicKey, sig, msg, ctx)` | — | `boolean` |
|
|
37
36
|
|
|
38
37
|
## Examples
|
|
39
38
|
|
|
@@ -45,7 +44,7 @@ const { privateKey, publicKey } = ed25519.keyPair(random.bytes(32));
|
|
|
45
44
|
|
|
46
45
|
const msg = new TextEncoder().encode('Hello, EdDSA!');
|
|
47
46
|
const sig = ed25519.sign(privateKey, msg);
|
|
48
|
-
const ok = ed25519.verify(publicKey,
|
|
47
|
+
const ok = ed25519.verify(publicKey, sig, msg); // true
|
|
49
48
|
```
|
|
50
49
|
|
|
51
50
|
### Ed25519ph (prehash + dom2)
|
|
@@ -53,7 +52,7 @@ const ok = ed25519.verify(publicKey, msg, sig); // true
|
|
|
53
52
|
```js
|
|
54
53
|
// signPh takes the raw message — SHA-512 is applied internally
|
|
55
54
|
const sig = ed25519.signPh(privateKey, msg);
|
|
56
|
-
const ok = ed25519.verifyPh(publicKey,
|
|
55
|
+
const ok = ed25519.verifyPh(publicKey, sig, msg);
|
|
57
56
|
```
|
|
58
57
|
|
|
59
58
|
### Ed25519ctx (context separation)
|
|
@@ -61,14 +60,8 @@ const ok = ed25519.verifyPh(publicKey, msg, sig);
|
|
|
61
60
|
```js
|
|
62
61
|
const ctx = new TextEncoder().encode('app-v1'); // 1..255 bytes required
|
|
63
62
|
const sig = ed25519.signCtx(privateKey, msg, ctx);
|
|
64
|
-
const ok = ed25519.verifyCtx(publicKey,
|
|
65
|
-
const bad = ed25519.verifyCtx(publicKey,
|
|
66
|
-
```
|
|
67
|
-
|
|
68
|
-
### Ed448 rejected
|
|
69
|
-
|
|
70
|
-
```js
|
|
71
|
-
ed25519.ed448.keyPair(); // false + console.warn('NOT-IMPLEMENTED: ed25519: Ed448 ...')
|
|
63
|
+
const ok = ed25519.verifyCtx(publicKey, sig, msg, ctx);
|
|
64
|
+
const bad = ed25519.verifyCtx(publicKey, sig, msg, otherCtx); // false
|
|
72
65
|
```
|
|
73
66
|
|
|
74
67
|
## Worker Usage
|
|
@@ -90,6 +83,8 @@ const worker = fw.createWorker(
|
|
|
90
83
|
- **`keyPair(seed)` — seed required**: `keyPair()` without argument returns `false` + warn. Use `random.bytes(32)` for generation.
|
|
91
84
|
- **Ed25519ph**: pass the **raw message** — `signPh` applies SHA-512 internally. Do not pre-hash before the call.
|
|
92
85
|
- **Ed448 not implemented** — edwards448 curve + SHAKE-256; create a separate `ed448.js` module if required for CMVP.
|
|
86
|
+
- **Speed**: `sign` about 0.3-0.5 ms, `verify` about 1.0-1.2 ms (Bun / Node; 46x / 10x and 42x / 13x `node:crypto`). The first `keyPair` / `sign` of a factory also builds the base-point table (256 points, about 4 ms); every later one uses it.
|
|
87
|
+
- **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` works on public data and uses a variable-time window.
|
|
93
88
|
|
|
94
89
|
## See also
|
|
95
90
|
|
|
@@ -124,7 +124,7 @@ const kp = await worker.call('hybridKem.xwing.keygen');
|
|
|
124
124
|
|
|
125
125
|
## Positioning & liability
|
|
126
126
|
|
|
127
|
-
|
|
127
|
+
AWA ships X-Wing as a **certifiable cryptographic component**, not a certified
|
|
128
128
|
product: no ANSSI/FIPS certification of the composite scheme is claimed here. The
|
|
129
129
|
underlying ML-KEM-768 is ACVP-green (`src/crypto/pkc/ml_kem.acvp.md`); X25519 is
|
|
130
130
|
RFC 7748 vector-green. Correctness is anchored to the **official IETF X-Wing KAT**
|
|
@@ -168,7 +168,13 @@ deterministic, network-free regeneration proof.
|
|
|
168
168
|
or key derivation breaks interop — re-pin and re-verify against fresh vectors.
|
|
169
169
|
- Deterministic for fixed inputs (32-byte seed, 64-byte encaps randomness), which
|
|
170
170
|
is exactly what the KAT exercises; production callers omit them to draw the
|
|
171
|
-
platform CSPRNG.
|
|
171
|
+
platform CSPRNG — `crypto.getRandomValues` directly, not the fw `random`
|
|
172
|
+
module (no DRBG, no SP 800-90B health tests on that path).
|
|
173
|
+
- The standalone `xwing` export (`import { xwing } from '@awacloud/fw/crypto/pkc/hybridKem.js'`)
|
|
174
|
+
builds its default primitives on first use and keeps that one instance at
|
|
175
|
+
module scope: nothing runs at import, and the DI factory stays pure and
|
|
176
|
+
worker-serializable. It is the package's one convenience cache outside a
|
|
177
|
+
factory; resolve `hybridKem` through the runtime for an instance you own.
|
|
172
178
|
|
|
173
179
|
## See also
|
|
174
180
|
|
|
@@ -19,7 +19,7 @@ Composes vetted fw primitives into `draft-ietf-lamps-pq-composite-sigs` composit
|
|
|
19
19
|
|
|
20
20
|
```js
|
|
21
21
|
const hybridSign = runtime.resolve('hybridSign');
|
|
22
|
-
// Returns: { mldsa65_ed25519, mldsa65_ecdsaP256
|
|
22
|
+
// Returns: { mldsa65_ed25519, mldsa65_ecdsaP256 }
|
|
23
23
|
```
|
|
24
24
|
|
|
25
25
|
## Construction (frozen, vector-verified)
|
|
@@ -54,7 +54,9 @@ interop vectors.
|
|
|
54
54
|
| `<variant>.lengths` | object | Component + container byte lengths |
|
|
55
55
|
| `<variant>.keygen()` | `() => {publicKey, secretKey}` | TLV-encoded key pair (independent seeds) |
|
|
56
56
|
| `<variant>.sign(sk, msg, ctx?)` | `(Uint8Array, Uint8Array, Uint8Array?) => Uint8Array \| false` | Composite signature |
|
|
57
|
-
| `<variant>.verify(pk,
|
|
57
|
+
| `<variant>.verify(pk, sig, msg, ctx?)` | `(Uint8Array, Uint8Array, Uint8Array, Uint8Array?) => boolean` | AND of both components |
|
|
58
|
+
| `<variant>.fromComponents(kind, { pq, trad })` | `('publicKey' \| 'secretKey' \| 'signature', {pq: Uint8Array, trad: Uint8Array}) => Uint8Array \| false` | The container built from its two components (see [Components](#components)) |
|
|
59
|
+
| `<variant>.toComponents(kind, bytes)` | `('publicKey' \| 'secretKey' \| 'signature', Uint8Array) => {pq, trad} \| false` | The two components of a container (copies) |
|
|
58
60
|
|
|
59
61
|
Inputs/outputs are `Uint8Array`; any invalid input returns `false` (sign) or
|
|
60
62
|
`false` (verify). `ctx` is an optional 0..255-byte application context bound
|
|
@@ -73,8 +75,33 @@ into `M'`.
|
|
|
73
75
|
`mldsaSig(3309) || u16(derLen) || DER`.
|
|
74
76
|
|
|
75
77
|
The official LAMPS vectors use a plain component concat; the vendored conformance
|
|
76
|
-
tests
|
|
77
|
-
through the real `verify()` path.
|
|
78
|
+
tests build this container from the exact official component bytes with
|
|
79
|
+
`fromComponents` and verify through the real `verify()` path.
|
|
80
|
+
|
|
81
|
+
## Components
|
|
82
|
+
|
|
83
|
+
`fromComponents(kind, { pq, trad })` builds a container from components made
|
|
84
|
+
elsewhere — a key from a hardware or external ML-DSA key, the official wire form
|
|
85
|
+
(plain concatenation) of a peer — and `toComponents(kind, bytes)` splits one.
|
|
86
|
+
`pq` is the ML-DSA-65 component; `trad` the traditional one:
|
|
87
|
+
|
|
88
|
+
| `kind` | `pq` | `trad` — Ed25519 | `trad` — ECDSA-P256 |
|
|
89
|
+
|---|---|---|---|
|
|
90
|
+
| `'publicKey'` | 1952 B | 32 B | 65 B, SEC1 uncompressed (`0x04` …) |
|
|
91
|
+
| `'secretKey'` | 4032 B | 64 B (seed ‖ public key) | 32 B scalar |
|
|
92
|
+
| `'signature'` | 3309 B | 64 B | DER `SEQUENCE { r, s }` |
|
|
93
|
+
|
|
94
|
+
A wrong length or form, an unknown `kind` or a container that does not decode is
|
|
95
|
+
`false`. Both return fresh arrays, never views of their input. The structural
|
|
96
|
+
checks are not a key validation: a point off the curve still builds a public key
|
|
97
|
+
that `verify` then rejects.
|
|
98
|
+
|
|
99
|
+
```js
|
|
100
|
+
const v = hybridSign.mldsa65_ed25519;
|
|
101
|
+
// the official LAMPS wire form: mldsaPk(1952) || ed25519Pk(32)
|
|
102
|
+
const publicKey = v.fromComponents('publicKey', { pq: wire.subarray(0, 1952), trad: wire.subarray(1952) });
|
|
103
|
+
const { pq, trad } = v.toComponents('publicKey', publicKey);
|
|
104
|
+
```
|
|
78
105
|
|
|
79
106
|
## Examples
|
|
80
107
|
|
|
@@ -85,13 +112,13 @@ const v = hybridSign.mldsa65_ed25519;
|
|
|
85
112
|
const { publicKey, secretKey } = v.keygen();
|
|
86
113
|
const msg = new TextEncoder().encode('hello');
|
|
87
114
|
const sig = v.sign(secretKey, msg);
|
|
88
|
-
v.verify(publicKey,
|
|
115
|
+
v.verify(publicKey, sig, msg); // true
|
|
89
116
|
|
|
90
117
|
// bind an application context
|
|
91
118
|
const ctx = new TextEncoder().encode('app:v1');
|
|
92
119
|
const sigCtx = v.sign(secretKey, msg, ctx);
|
|
93
|
-
v.verify(publicKey,
|
|
94
|
-
v.verify(publicKey,
|
|
120
|
+
v.verify(publicKey, sigCtx, msg, ctx); // true
|
|
121
|
+
v.verify(publicKey, sigCtx, msg); // false — ctx mismatch
|
|
95
122
|
```
|
|
96
123
|
|
|
97
124
|
## Worker Usage
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
module: ml_dsa
|
|
3
3
|
category: crypto/pkc
|
|
4
|
-
dependencies: [sha3, bitArray, random
|
|
4
|
+
dependencies: [sha3, bitArray, random]
|
|
5
5
|
returns: object
|
|
6
6
|
worker-safe: true
|
|
7
7
|
status: complete
|
|
@@ -11,7 +11,7 @@ status: complete
|
|
|
11
11
|
|
|
12
12
|
> ML-DSA (FIPS 204, August 2024) — CRYSTALS-Dilithium post-quantum signatures + HashML-DSA + internal interface.
|
|
13
13
|
|
|
14
|
-
**Module** `ml_dsa` | **Source** `packages/front/fw/src/crypto/pkc/ml_dsa.js` | **Deps** `sha3`, `bitArray`, `random
|
|
14
|
+
**Module** `ml_dsa` | **Source** `packages/front/fw/src/crypto/pkc/ml_dsa.js` | **Deps** `sha3`, `bitArray`, `random` | **Worker-safe** yes
|
|
15
15
|
|
|
16
16
|
NIST post-quantum signatures. 3 paramSets. Variants: pure (default), preHash (HashML-DSA, FIPS 204 §5.4), internal (raw §6.2), externalMu (pre-computed mu).
|
|
17
17
|
|
|
@@ -19,7 +19,7 @@ NIST post-quantum signatures. 3 paramSets. Variants: pure (default), preHash (Ha
|
|
|
19
19
|
|
|
20
20
|
```js
|
|
21
21
|
const ml_dsa = runtime.resolve('ml_dsa');
|
|
22
|
-
// Returns: { ml_dsa44, ml_dsa65, ml_dsa87
|
|
22
|
+
// Returns: { ml_dsa44, ml_dsa65, ml_dsa87 }
|
|
23
23
|
```
|
|
24
24
|
|
|
25
25
|
## API
|
|
@@ -33,14 +33,14 @@ const ml_dsa = runtime.resolve('ml_dsa');
|
|
|
33
33
|
| Method | Signature | Returns |
|
|
34
34
|
|--------|-----------|---------|
|
|
35
35
|
| `ml_dsa<N>.keygen(seed?)` | `(Uint8Array(32)?) => {publicKey, secretKey}` | Keypair |
|
|
36
|
-
| `ml_dsa<N>.sign(
|
|
37
|
-
| `ml_dsa<N>.verify(sig, msg,
|
|
38
|
-
| `ml_dsa<N>.signPh(
|
|
39
|
-
| `ml_dsa<N>.verifyPh(sig, msg,
|
|
40
|
-
| `
|
|
41
|
-
| `
|
|
42
|
-
| `
|
|
43
|
-
| `
|
|
36
|
+
| `ml_dsa<N>.sign(sk, msg, ctx?, rnd?)` | `(Uint8Array, Uint8Array, Uint8Array?, Uint8Array(32)?) => Uint8Array` | Sign external+pure |
|
|
37
|
+
| `ml_dsa<N>.verify(pk, sig, msg, ctx?)` | — | `boolean` |
|
|
38
|
+
| `ml_dsa<N>.signPh(sk, msg, hashAlg, hashMod, ctx?, rnd?)` | — | HashML-DSA (preHash + OID) |
|
|
39
|
+
| `ml_dsa<N>.verifyPh(pk, sig, msg, hashAlg, hashMod, ctx?)` | — | `boolean` |
|
|
40
|
+
| `internalOf(ml_dsa).signInternal(M, sk, rnd?)` | — | Raw §6.2 (no M' wrapper) |
|
|
41
|
+
| `internalOf(ml_dsa).verifyInternal(sig, M, pk)` | — | `boolean` raw |
|
|
42
|
+
| `internalOf(ml_dsa).signWithMu(mu, sk, rnd?)` | — | externalMu (pre-computed mu) |
|
|
43
|
+
| `internalOf(ml_dsa).verifyWithMu(sig, mu, pk)` | — | `boolean` |
|
|
44
44
|
|
|
45
45
|
### Supported `hashAlg` values (HashML-DSA)
|
|
46
46
|
|
|
@@ -55,22 +55,22 @@ const { ml_dsa } = fw.runtime.resolveAll(['ml_dsa']);
|
|
|
55
55
|
const { publicKey, secretKey } = ml_dsa.ml_dsa65.keygen();
|
|
56
56
|
|
|
57
57
|
const msg = new TextEncoder().encode('Hello, ML-DSA!');
|
|
58
|
-
const sig = ml_dsa.ml_dsa65.sign(
|
|
59
|
-
const ok = ml_dsa.ml_dsa65.verify(sig, msg
|
|
58
|
+
const sig = ml_dsa.ml_dsa65.sign(secretKey, msg); // hedged: 32 fresh random bytes
|
|
59
|
+
const ok = ml_dsa.ml_dsa65.verify(publicKey, sig, msg); // true
|
|
60
60
|
```
|
|
61
61
|
|
|
62
62
|
### HashML-DSA (preHash variant)
|
|
63
63
|
|
|
64
64
|
```js
|
|
65
65
|
const sha256 = fw.runtime.resolve('sha256');
|
|
66
|
-
const sig = ml_dsa.ml_dsa65.signPh(
|
|
67
|
-
const ok = ml_dsa.ml_dsa65.verifyPh(sig, msg,
|
|
66
|
+
const sig = ml_dsa.ml_dsa65.signPh(secretKey, msg, 'SHA2-256', sha256, ctx);
|
|
67
|
+
const ok = ml_dsa.ml_dsa65.verifyPh(publicKey, sig, msg, 'SHA2-256', sha256, ctx);
|
|
68
68
|
```
|
|
69
69
|
|
|
70
70
|
### Internal interface (raw §6.2)
|
|
71
71
|
|
|
72
72
|
```js
|
|
73
|
-
const sig = ml_dsa.ml_dsa65.
|
|
73
|
+
const sig = internalOf(ml_dsa.ml_dsa65).signInternal(M, secretKey); // no M' wrapper
|
|
74
74
|
```
|
|
75
75
|
|
|
76
76
|
## Worker Usage
|
|
@@ -81,15 +81,16 @@ const worker = fw.createWorker(
|
|
|
81
81
|
function ({ libs, args }) {
|
|
82
82
|
self.postMessage(libs.ml_dsa.ml_dsa65.sign(args[0], args[1]));
|
|
83
83
|
},
|
|
84
|
-
{ dependencies: ['ml_dsa'], args: [
|
|
84
|
+
{ dependencies: ['ml_dsa'], args: [secretKey, msg] }
|
|
85
85
|
);
|
|
86
86
|
```
|
|
87
87
|
|
|
88
88
|
## Notes
|
|
89
89
|
|
|
90
|
-
- **
|
|
90
|
+
- **Argument order**: `sign(sk, msg, …)`, `verify(pk, sig, msg, …)`, as the wasm and WebCrypto tiers. The fw order for every signature scheme and tier: `sign(key, message, …)`, `verify(key, signature, message, …)`.
|
|
91
|
+
- **Hedged by default** (FIPS 204 §3.4): without `rnd`, `sign` draws 32 random bytes, so two signatures of one message differ. Pass `new Uint8Array(32)` as `rnd` for the deterministic mode (KAT vectors, reproducible signatures).
|
|
91
92
|
- **HashML-DSA OID**: DER prefix embedded in the M' wrapper (FIPS 204 Algorithm 4).
|
|
92
|
-
- **`
|
|
93
|
+
- **`internalOf(ml_dsa).*`** test-only — bypasses §5.4 wrappers; do NOT expose to end users (risk of secret sk leakage).
|
|
93
94
|
- **Full ACVP** under `CRYPTO_FULL=1`: 75 keyGen + 45 sigVer + 90 sigGen ext+pure.
|
|
94
95
|
|
|
95
96
|
## See also
|
|
@@ -19,7 +19,7 @@ NIST-standardised post-quantum KEM (Key Encapsulation Mechanism). Replaces ECDH
|
|
|
19
19
|
|
|
20
20
|
```js
|
|
21
21
|
const ml_kem = runtime.resolve('ml_kem');
|
|
22
|
-
// Returns: { ml_kem512, ml_kem768, ml_kem1024
|
|
22
|
+
// Returns: { ml_kem512, ml_kem768, ml_kem1024 }
|
|
23
23
|
```
|
|
24
24
|
|
|
25
25
|
## API
|
|
@@ -35,7 +35,7 @@ const ml_kem = runtime.resolve('ml_kem');
|
|
|
35
35
|
| `ml_kem<N>.keygen(seed?)` | `(Uint8Array(64)?) => {publicKey, secretKey}` | Keypair (random if seed absent) |
|
|
36
36
|
| `ml_kem<N>.encapsulate(publicKey, m?)` | `(Uint8Array, Uint8Array(32)?) => {cipherText, sharedSecret}` | Encapsulate; m random if absent |
|
|
37
37
|
| `ml_kem<N>.decapsulate(cipherText, secretKey)` | `(Uint8Array, Uint8Array) => Uint8Array(32)` | Shared secret (constant-time, implicit reject) |
|
|
38
|
-
| `
|
|
38
|
+
| `internalOf(ml_kem).{ntt, nttInv, isValidEncapsulationKey, isValidDecapsulationKey}` | — | Primitives + key check FIPS 203 §7.2/§7.3 |
|
|
39
39
|
|
|
40
40
|
## Examples
|
|
41
41
|
|
|
@@ -80,7 +80,7 @@ const worker = fw.createWorker(
|
|
|
80
80
|
|
|
81
81
|
- **Implicit reject** on invalid ciphertext: `decapsulate` returns a pseudo-random sharedSecret (not `false`) per FIPS 203 §6.3 — the caller must NOT distinguish.
|
|
82
82
|
- **Constant-time**: final Khat/Kbar selection by mask, no short-circuit.
|
|
83
|
-
- **Key check** opt-in: `
|
|
83
|
+
- **Key check** opt-in: `internalOf(ml_kem).isValidEncapsulationKey(ek)` (modulus q check) + `isValidDecapsulationKey(dk)` (hash consistency).
|
|
84
84
|
|
|
85
85
|
## See also
|
|
86
86
|
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
module: rsa
|
|
3
3
|
category: crypto/pkc
|
|
4
|
-
dependencies: [
|
|
4
|
+
dependencies: [bitArray, bn, random]
|
|
5
5
|
returns: object
|
|
6
6
|
worker-safe: true
|
|
7
7
|
status: complete
|
|
@@ -11,7 +11,7 @@ status: complete
|
|
|
11
11
|
|
|
12
12
|
> RSA-OAEP + RSA-PSS (FIPS 186-5 §5.4 / RFC 8017) — asymmetric encryption + signatures. PKCS#1 v1.5 explicit reject.
|
|
13
13
|
|
|
14
|
-
**Module** `rsa` | **Source** `packages/front/fw/src/crypto/pkc/rsa.js` | **Deps** `
|
|
14
|
+
**Module** `rsa` | **Source** `packages/front/fw/src/crypto/pkc/rsa.js` | **Deps** `bitArray`, `bn`, `random` | **Worker-safe** yes
|
|
15
15
|
|
|
16
16
|
CRT auto-enabled for decrypt/sign (4× speedup). Chaum/Pollard RSA blinding enabled by default (anti-Boneh-Brumley 2003 timing attack).
|
|
17
17
|
|
|
@@ -19,7 +19,7 @@ CRT auto-enabled for decrypt/sign (4× speedup). Chaum/Pollard RSA blinding enab
|
|
|
19
19
|
|
|
20
20
|
```js
|
|
21
21
|
const rsa = runtime.resolve('rsa');
|
|
22
|
-
// Returns: { oaepEncrypt, oaepDecrypt, pssSign, pssVerify
|
|
22
|
+
// Returns: { oaepEncrypt, oaepDecrypt, pssSign, pssVerify }
|
|
23
23
|
```
|
|
24
24
|
|
|
25
25
|
## API
|
|
@@ -30,9 +30,7 @@ const rsa = runtime.resolve('rsa');
|
|
|
30
30
|
| `oaepDecrypt(priv, ct, hashMod?)` | — | Plaintext or `false` (constant-time anti-Manger) |
|
|
31
31
|
| `pssSign(priv, msg, hashMod?, sLen?, salt?)` | — | Signature |
|
|
32
32
|
| `pssVerify(pub, msg, sig, hashMod?, sLen?)` | — | `boolean` |
|
|
33
|
-
| `
|
|
34
|
-
| `pkcs1v15Encrypt/Decrypt` | `() => false` | **DEPRECATED\|UNSAFE** (Bleichenbacher) |
|
|
35
|
-
| `_internal.{rsaep, rsadp, mgf1}` | — | Primitives + RSA blinding control |
|
|
33
|
+
| `internalOf(rsa).{rsaep, rsadp, mgf1}` | — | Primitives + RSA blinding control |
|
|
36
34
|
|
|
37
35
|
## Examples
|
|
38
36
|
|
|
@@ -59,7 +57,7 @@ const ok = rsa.pssVerify(publicKey, msg, sig); // true
|
|
|
59
57
|
### Disable blinding (benchmark)
|
|
60
58
|
|
|
61
59
|
```js
|
|
62
|
-
const pt = rsa.
|
|
60
|
+
const pt = internalOf(rsa).rsadp(secretKey, ct, { blinding: false });
|
|
63
61
|
```
|
|
64
62
|
|
|
65
63
|
## Worker Usage
|
|
@@ -76,8 +74,8 @@ const worker = fw.createWorker(
|
|
|
76
74
|
|
|
77
75
|
## Notes
|
|
78
76
|
|
|
79
|
-
- **PKCS #1 v1.5
|
|
80
|
-
- **RSA blinding default ON**: opt-out via `
|
|
77
|
+
- **No PKCS #1 v1.5** (signature or encryption): SP 800-131A Rev.2 deprecates v1.5 signatures, and v1.5 encryption carries the Bleichenbacher padding oracle. Use PSS and OAEP.
|
|
78
|
+
- **RSA blinding default ON**: opt-out via `internalOf(rsa).rsadp(p, c, {blinding:false})` for benchmarks; covers Boneh-Brumley 2003 anti-timing.
|
|
81
79
|
- **OAEP decrypt constant-time** anti-Manger: separator scanned without early-exit.
|
|
82
80
|
|
|
83
81
|
## See also
|
|
@@ -19,7 +19,7 @@ Purely hash-based signatures (conservative quantum resistance). 12 variants: 2 h
|
|
|
19
19
|
|
|
20
20
|
```js
|
|
21
21
|
const slh_dsa = runtime.resolve('slh_dsa');
|
|
22
|
-
// Returns: { slh_dsa_sha2_128f, ..., slh_dsa_shake_256s
|
|
22
|
+
// Returns: { slh_dsa_sha2_128f, ..., slh_dsa_shake_256s }
|
|
23
23
|
```
|
|
24
24
|
|
|
25
25
|
## API (12 paramSets)
|
|
@@ -33,12 +33,12 @@ const slh_dsa = runtime.resolve('slh_dsa');
|
|
|
33
33
|
| Method | Signature | Returns |
|
|
34
34
|
|--------|-----------|---------|
|
|
35
35
|
| `slh_dsa_*.keygen(seed?)` | — | `{publicKey, secretKey}` |
|
|
36
|
-
| `slh_dsa_*.sign(
|
|
37
|
-
| `slh_dsa_*.verify(sig, msg,
|
|
38
|
-
| `slh_dsa_*.signPh(
|
|
39
|
-
| `slh_dsa_*.verifyPh(sig, msg,
|
|
40
|
-
| `
|
|
41
|
-
| `
|
|
36
|
+
| `slh_dsa_*.sign(sk, msg, opts?)` | `(Uint8Array, Uint8Array, {context?, extraEntropy?}) => Uint8Array` | Signature |
|
|
37
|
+
| `slh_dsa_*.verify(pk, sig, msg, opts?)` | — | `boolean` |
|
|
38
|
+
| `slh_dsa_*.signPh(sk, msg, hashAlg, hashMod, opts?)` | — | HashSLH-DSA (preHash + OID) |
|
|
39
|
+
| `slh_dsa_*.verifyPh(pk, sig, msg, hashAlg, hashMod, opts?)` | — | `boolean` |
|
|
40
|
+
| `internalOf(slh_dsa).signInternal(M, sk, opts?)` | — | Raw §6 (no M' wrapper) |
|
|
41
|
+
| `internalOf(slh_dsa).verifyInternal(sig, M, pk)` | — | `boolean` raw |
|
|
42
42
|
|
|
43
43
|
## Examples
|
|
44
44
|
|
|
@@ -49,15 +49,15 @@ const { slh_dsa } = fw.runtime.resolveAll(['slh_dsa']);
|
|
|
49
49
|
|
|
50
50
|
// SHAKE-128f : fastest sign, large sig (17 KB)
|
|
51
51
|
const { publicKey, secretKey } = slh_dsa.slh_dsa_shake_128f.keygen();
|
|
52
|
-
const sig = slh_dsa.slh_dsa_shake_128f.sign(
|
|
53
|
-
const ok = slh_dsa.slh_dsa_shake_128f.verify(sig, msg
|
|
52
|
+
const sig = slh_dsa.slh_dsa_shake_128f.sign(secretKey, msg);
|
|
53
|
+
const ok = slh_dsa.slh_dsa_shake_128f.verify(publicKey, sig, msg);
|
|
54
54
|
```
|
|
55
55
|
|
|
56
56
|
### HashSLH-DSA preHash
|
|
57
57
|
|
|
58
58
|
```js
|
|
59
59
|
const sha256 = fw.runtime.resolve('sha256');
|
|
60
|
-
const sig = slh_dsa.slh_dsa_sha2_128f.signPh(
|
|
60
|
+
const sig = slh_dsa.slh_dsa_sha2_128f.signPh(secretKey, msg, 'SHA2-256', sha256);
|
|
61
61
|
```
|
|
62
62
|
|
|
63
63
|
## Worker Usage
|
|
@@ -68,7 +68,7 @@ const worker = fw.createWorker(
|
|
|
68
68
|
function ({ libs, args }) {
|
|
69
69
|
self.postMessage(libs.slh_dsa.slh_dsa_sha2_128f.sign(args[0], args[1]));
|
|
70
70
|
},
|
|
71
|
-
{ dependencies: ['slh_dsa'], args: [
|
|
71
|
+
{ dependencies: ['slh_dsa'], args: [secretKey, msg] }
|
|
72
72
|
);
|
|
73
73
|
```
|
|
74
74
|
|
|
@@ -76,7 +76,7 @@ const worker = fw.createWorker(
|
|
|
76
76
|
|
|
77
77
|
- **Variant choice**: `f` (fast sign, large sig) for interactive use; `s` (small sig, slow sign) for infrequent long-term artefacts.
|
|
78
78
|
- **256s sign costs minutes** — never block the UI.
|
|
79
|
-
- **`
|
|
79
|
+
- **`internalOf(slh_dsa).*`** test-only, the internal slot (not API) — bypasses the §5.4 wrapper.
|
|
80
80
|
- **Full ACVP keyGen + sigVer ext+pure** under `CRYPTO_FULL=1` (~135 s). Full sigGen (624) deliberately not wired (would take hours).
|
|
81
81
|
|
|
82
82
|
## See also
|
|
@@ -9,7 +9,7 @@ status: complete
|
|
|
9
9
|
|
|
10
10
|
# x25519
|
|
11
11
|
|
|
12
|
-
> X25519 (RFC 7748) — Diffie-Hellman over Curve25519,
|
|
12
|
+
> X25519 (RFC 7748) — Diffie-Hellman over Curve25519, a minimal ECDH primitive.
|
|
13
13
|
|
|
14
14
|
**Module** `x25519` | **Source** `packages/front/fw/src/crypto/pkc/x25519.js` | **Deps** none | **Worker-safe** yes
|
|
15
15
|
|
|
@@ -19,7 +19,7 @@ Outside NIST but a de facto standard (TLS 1.3, Signal, WireGuard). TweetNaCl-der
|
|
|
19
19
|
|
|
20
20
|
```js
|
|
21
21
|
const x25519 = runtime.resolve('x25519');
|
|
22
|
-
// Returns: { scalarMult, scalarMultBase, isLowOrderPoint
|
|
22
|
+
// Returns: { scalarMult, scalarMultBase, isLowOrderPoint }
|
|
23
23
|
```
|
|
24
24
|
|
|
25
25
|
## API
|
|
@@ -29,7 +29,7 @@ const x25519 = runtime.resolve('x25519');
|
|
|
29
29
|
| `scalarMult(scalar, u)` | `(Uint8Array(32), Uint8Array(32)) => Uint8Array(32) \| false` | Shared secret (clamping auto per RFC 7748 §5) |
|
|
30
30
|
| `scalarMultBase(scalar)` | `(Uint8Array(32)) => Uint8Array(32)` | `scalarMult(scalar, basePoint=9)` (public key) |
|
|
31
31
|
| `isLowOrderPoint(u)` | `(Uint8Array(32)) => boolean` | true if `u` is low-order (cofactor 8) |
|
|
32
|
-
| `
|
|
32
|
+
| `internalOf(x25519).lowOrderPoints` | `Uint8Array[7]` | Table of the 7 documented LOPs |
|
|
33
33
|
|
|
34
34
|
## Examples
|
|
35
35
|
|
|
@@ -75,7 +75,8 @@ const worker = fw.createWorker(
|
|
|
75
75
|
|
|
76
76
|
- **Automatic clamping** per RFC 7748 §5 (clear low 3 bits, clear high bit, set bit 254).
|
|
77
77
|
- **Low-order points**: `scalarMult(scalar, lowOrderU) === 0...0`. RFC 7748 §6.1 allows this (non-rejected by design); `isLowOrderPoint` enables explicit caller-side rejection (constant-time vs 7 documented LOPs).
|
|
78
|
-
-
|
|
78
|
+
- **Timing**: the ladder is algorithmically constant-time (255 fixed steps, swaps by mask, a fixed inversion chain); the engine-level timing of Float64 arithmetic cannot be guaranteed from JavaScript. Acceptable per RFC 7748 §A.1 in an interactive ECDH context.
|
|
79
|
+
- **Speed**: `scalarMult` about 0.65-0.8 ms (Bun / Node), the field multiply and square unrolled.
|
|
79
80
|
- **RFC 7748 1M iterations** validation gated on `CRYPTO_FULL=1`.
|
|
80
81
|
|
|
81
82
|
## See also
|
|
@@ -4,18 +4,18 @@ Utilities: DRBG, key generation, algebraic primitives (BN, bitArray), formats (P
|
|
|
4
4
|
|
|
5
5
|
| Module | Returns | Deps | Description |
|
|
6
6
|
|--------|----------|------|-------------|
|
|
7
|
-
| [random](./random.md) | `{fill, float, int, bytes, words, bits,
|
|
8
|
-
| [rsaKeygen](./rsaKeygen.md) | `{generate, generateProbablePrime
|
|
7
|
+
| [random](./random.md) | `{fill, float, int, bytes, words, bits, drbg, health, isReady, selfTest}` | `bitArray`, `aes`, `sha256` | CTR_DRBG-AES-256 (SP 800-90A) + RCT/APT (SP 800-90B); AES-128/192 + df via `internalOf(random).makeDrbg` (internal slot) |
|
|
8
|
+
| [rsaKeygen](./rsaKeygen.md) | `{generate, generateProbablePrime}` | `bn`, `random` | RSA 2048+ generation (FIPS 186-5 §A.1.3, probable primes) |
|
|
9
9
|
| [bn](./bn.md) | constructor `BN` + statics | `bitArray`, `random` | Big integer (SJCL-derived, BSD-2-Clause; see [provenance](../../../dev/provenance.md)) — ECDSA / RSA arithmetic |
|
|
10
10
|
| [bitArray](./bitArray.md) | `{...}` | none | Bit-precise representation (SJCL convention, see [provenance](../../../dev/provenance.md); 32-bit words + partial last word) |
|
|
11
11
|
| [pad](./pad.md) | `{pad, strip}` | none | PKCS#7 padding (RFC 5652 §6.3) |
|
|
12
12
|
| [pem](./pem.md) | `{encode, decode}` | none | PEM (RFC 7468) — Base64 encoding + BEGIN/END headers |
|
|
13
|
-
| [asn1](./asn1.md) | `{
|
|
13
|
+
| [asn1](./asn1.md) | `{TAG, encode*, parseOne, parseChildren, read*}` | none | ASN.1 DER (X.690) — primitive tag serialisation |
|
|
14
14
|
| [asn1Oid](./asn1-oid.md) | `{lookup, byName, findByCategory, OID_DATABASE}` | none | ASN.1 OID database — bidirectional name ↔ OID resolution (≥ 180 OIDs, 12 categories) |
|
|
15
|
-
| [keyformat](./keyformat.md) | `{encodePkcs8Edwards, decodePkcs8Edwards, encodeSpkiEdwards, decodeSpkiEdwards, encodeSec1, decodeSec1, encodePkcs8Ec, decodePkcs8Ec, encodeSpkiEc, decodeSpkiEc, OID}` | `asn1
|
|
16
|
-
| [
|
|
17
|
-
| [
|
|
18
|
-
| [
|
|
15
|
+
| [keyformat](./keyformat.md) | `{encodePkcs8Edwards, decodePkcs8Edwards, encodeSpkiEdwards, decodeSpkiEdwards, encodeSec1, decodeSec1, encodePkcs8Ec, decodePkcs8Ec, encodeSpkiEc, decodeSpkiEc, encodeRsaPublicKey, decodeRsaPublicKey, encodeRsaPrivateKey, decodeRsaPrivateKey, encodeSpkiRsa, decodeSpkiRsa, encodePkcs8Rsa, decodePkcs8Rsa, OID}` | `asn1` | RSA / EC (P-256/384/521) / Ed25519 / X25519 key serialisation — PKCS#8, SPKI, SEC1, PKCS#1 |
|
|
16
|
+
| [x509](./x509.md) | `{create, parse, verify, toPem, fromPem}` | `asn1`, `keyformat`, `pem`, `ed25519`, `ecc`, `sha256`, `bitArray` | X.509 v3 certificates (RFC 5280) for Ed25519 / ECDSA P-256 keys — create, parse, verify |
|
|
17
|
+
| [jws](./jws.md) | `{sign, verify, signJwt, verifyJwt}` | `bitArray`, `utf8`, `b64`, `hmac`, `sha256`, `sha512`, `ed25519` | JSON Web Signature (RFC 7515) HS*/EdDSA |
|
|
18
|
+
| [aes_modes](./aes_modes.md) | `{cbc, ctr, gcm, kw}` | `bitArray`, `aes`, `cbc`, `ctr`, `gcm`, `kw`, `pad` | Uniform Uint8Array wrapper over all AES modes |
|
|
19
19
|
| [totp](./totp.md) | `{generate, verify, enroll, uri}` | `hmac`, `random`, `base32` | TOTP RFC 6238 + HOTP RFC 4226 — time-based OTP codes |
|
|
20
20
|
| [uuid](./uuid.md) | `{v1, v4}` | `hex` | UUID v1 (time-based) + v4 (random) — RFC 4122 / RFC 9562 |
|
|
21
21
|
|
|
@@ -19,7 +19,7 @@ Fully Uint8Array API (no bitArray on the caller side). Recommended for external
|
|
|
19
19
|
|
|
20
20
|
```js
|
|
21
21
|
const am = runtime.resolve('aes_modes');
|
|
22
|
-
// Returns: { cbc, ctr, gcm, kw
|
|
22
|
+
// Returns: { cbc, ctr, gcm, kw }
|
|
23
23
|
```
|
|
24
24
|
|
|
25
25
|
## API
|
|
@@ -29,8 +29,7 @@ const am = runtime.resolve('aes_modes');
|
|
|
29
29
|
| `am.cbc` | `encrypt(key, iv, pt) → ct` (PKCS#7 included), `decrypt(key, iv, ct) → pt` |
|
|
30
30
|
| `am.ctr` | `encrypt(key, iv, data) → out` (involution) |
|
|
31
31
|
| `am.gcm` | `encrypt(key, iv, pt, aad?, tagLen?) → {ct, tag}`, `decrypt(key, iv, ct, tag, aad?) → pt \| false` |
|
|
32
|
-
| `am.kw` | `wrap(kek, key) → ct`, `unwrap(kek, ct) → key \| false` |
|
|
33
|
-
| `am.kwp` | `wrapPad(kek, key) → ct`, `unwrapPad(kek, ct) → key \| false` |
|
|
32
|
+
| `am.kw` | `wrap(kek, key) → ct`, `unwrap(kek, ct) → key \| false`; KWP (padded, RFC 5649): `wrapPad(kek, key) → ct`, `unwrapPad(kek, ct) → key \| false` |
|
|
34
33
|
|
|
35
34
|
All inputs/outputs = `Uint8Array`.
|
|
36
35
|
|
|
@@ -72,10 +71,8 @@ const worker = fw.createWorker(
|
|
|
72
71
|
## Notes
|
|
73
72
|
|
|
74
73
|
- **Convenience wrapper**: 100% of FIPS / SP 800 conformance is delegated to `cipher/aes` + `mode/{cbc,ctr,gcm,kw}`.
|
|
75
|
-
- **Recommended for new code** over `aes_ctr.js` (legacy, deprecated).
|
|
76
74
|
- **No `nonceTracker`**: use `mode/gcm.js` directly if required.
|
|
77
75
|
|
|
78
76
|
## See also
|
|
79
77
|
|
|
80
78
|
- [cbc](../mode/cbc.md), [ctr](../mode/ctr.md), [gcm](../mode/gcm.md), [kw](../mode/kw.md) — underlying algorithms
|
|
81
|
-
- [aes_ctr](./aes_ctr.md) — legacy CTR-only wrapper (deprecated)
|