@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
|
@@ -10,19 +10,19 @@ Hashes, MAC, KDF (RFC + FIPS / SP NIST). Four families:
|
|
|
10
10
|
| Module | Returns | Deps | Description |
|
|
11
11
|
|--------|----------|------|-------------|
|
|
12
12
|
| [sha224](./sha224.md) | `{fn, hash}` | `sha256` | SHA-224 (FIPS 180-4 §6.3) — sha256 wrapper |
|
|
13
|
-
| [sha256](./sha256.md) | `{fn, hash
|
|
13
|
+
| [sha256](./sha256.md) | `{fn, hash}` | `bitArray`, `utf8` | SHA-256 (FIPS 180-4 §6.2) |
|
|
14
14
|
| [sha384](./sha384.md) | `{fn, hash}` | `sha512` | SHA-384 (FIPS 180-4 §6.5) — sha512 wrapper |
|
|
15
|
-
| [sha512](./sha512.md) | `{fn, hash
|
|
15
|
+
| [sha512](./sha512.md) | `{fn, hash}` | `bitArray`, `utf8` | SHA-512 (FIPS 180-4 §6.4) + parametric builder |
|
|
16
16
|
| [sha512_224](./sha512_224.md) | `{fn, hash}` | `sha512` | SHA-512/224 (FIPS 180-4 §5.3.6.1) |
|
|
17
17
|
| [sha512_256](./sha512_256.md) | `{fn, hash}` | `sha512` | SHA-512/256 (FIPS 180-4 §5.3.6.2) |
|
|
18
18
|
| [sha3](./sha3.md) | `{sha3_*, shake*, sha3_*_hash}` | `bitArray`, `utf8` | SHA-3 + SHAKE (FIPS 202) one-shot + streaming |
|
|
19
19
|
| [hmac](./hmac.md) | `{fn, verify}` | `bitArray`, `utf8`, `sha256` | Polymorphic HMAC (RFC 2104 / FIPS 198-1) over any hash |
|
|
20
20
|
| [hkdf](./hkdf.md) | `{extract, expand, derive}` | `bitArray`, `utf8`, `hmac` | HKDF (RFC 5869 / SP 800-56C Rev. 2) |
|
|
21
21
|
| [pbkdf2](./pbkdf2.md) | callable + `.derive`, `.MIN_RECOMMENDED_COUNT` | `bitArray`, `utf8`, `hmac` | PBKDF2 (RFC 2898 / SP 800-132), default 600,000 iter |
|
|
22
|
-
| [blake2b](./blake2b.md) | `{hash,
|
|
22
|
+
| [blake2b](./blake2b.md) | `{hash, create}` | none | BLAKE2b (RFC 7693); salt/person; keyed mode |
|
|
23
23
|
| [poly1305](./poly1305.md) | `{mac, verify}` | none | Poly1305 (RFC 8439 §2.5) — 128-bit one-shot MAC |
|
|
24
|
-
| [argon2](./argon2.md) | `{hash
|
|
25
|
-
| [adf](./adf.md) | `{
|
|
24
|
+
| [argon2](./argon2.md) | `{hash}` | `blake2b` | Argon2id (RFC 9106) |
|
|
25
|
+
| [adf](./adf.md) | `{fn, partial, MIN_RECOMMENDED_ROUNDS, MAX_ROUNDS}` | `aes`, `sha256` | KeePass AES-DF (KDBX 3.x) — legacy interop |
|
|
26
26
|
|
|
27
27
|
## Common pattern (one-shot)
|
|
28
28
|
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
module: adf
|
|
3
3
|
category: crypto/hash
|
|
4
|
-
dependencies: [
|
|
4
|
+
dependencies: [sha256, aes]
|
|
5
5
|
returns: object
|
|
6
6
|
worker-safe: true
|
|
7
7
|
status: complete
|
|
@@ -11,7 +11,7 @@ status: complete
|
|
|
11
11
|
|
|
12
12
|
> AES-DF (KeePass KDBX 3.x) — KDF interop legacy, NOT RECOMMENDED for new code.
|
|
13
13
|
|
|
14
|
-
**Module** `adf` | **Source** `packages/front/fw/src/crypto/hash/adf.js` | **Deps** `
|
|
14
|
+
**Module** `adf` | **Source** `packages/front/fw/src/crypto/hash/adf.js` | **Deps** `sha256`, `aes` | **Worker-safe** yes
|
|
15
15
|
|
|
16
16
|
Format-spec interop for KeePass v1 / KDBX 3.x databases. For new password hashing, use [`argon2`](./argon2.md) (RFC 9106). For generic KDF, use [`hkdf`](./hkdf.md) or [`pbkdf2`](./pbkdf2.md).
|
|
17
17
|
|
|
@@ -19,23 +19,33 @@ Format-spec interop for KeePass v1 / KDBX 3.x databases. For new password hashin
|
|
|
19
19
|
|
|
20
20
|
```js
|
|
21
21
|
const adf = runtime.resolve('adf');
|
|
22
|
-
// Returns: {
|
|
22
|
+
// Returns: { fn, partial, MIN_RECOMMENDED_ROUNDS, MAX_ROUNDS }
|
|
23
23
|
```
|
|
24
24
|
|
|
25
25
|
## API
|
|
26
26
|
|
|
27
|
-
|
|
27
|
+
Inputs and outputs are bitArrays (`number[]` words, see [bitArray](../utils/bitArray.md)).
|
|
28
|
+
|
|
29
|
+
| Member | Signature | Returns |
|
|
28
30
|
|---------|-----------|---------|
|
|
29
|
-
| `
|
|
31
|
+
| `fn(master, transform, rounds, composite)` | `(number[], number[], number, number[]) => number[] \| false` | The KDBX 3.x final key: `SHA-256(partial(…))` |
|
|
32
|
+
| `partial(master, transform, rounds, composite)` | `(number[], number[], number, number[]) => number[] \| false` | `master ‖ SHA-256(transformed)`, the key before the last hash |
|
|
33
|
+
| `MIN_RECOMMENDED_ROUNDS` | `number` | KeePass's recommended minimum round count |
|
|
34
|
+
| `MAX_ROUNDS` | `number` | The largest accepted round count |
|
|
35
|
+
|
|
36
|
+
`master` is the master seed (32 bytes), `transform` the transform seed (32 bytes, the AES-256 key), `composite` the composite key (the hash of the credentials). Any invalid input returns `false` with a warning.
|
|
30
37
|
|
|
31
38
|
## Examples
|
|
32
39
|
|
|
33
40
|
```js
|
|
34
|
-
const { adf,
|
|
41
|
+
const { adf, bitArray } = fw.runtime.resolveAll(['adf', 'bitArray']);
|
|
35
42
|
|
|
36
|
-
const
|
|
37
|
-
|
|
38
|
-
|
|
43
|
+
const key = adf.fn(
|
|
44
|
+
bitArray.ui8_to_ba(masterSeed),
|
|
45
|
+
bitArray.ui8_to_ba(transformSeed),
|
|
46
|
+
600000,
|
|
47
|
+
bitArray.ui8_to_ba(compositeKey),
|
|
48
|
+
);
|
|
39
49
|
```
|
|
40
50
|
|
|
41
51
|
## Worker Usage
|
|
@@ -43,9 +53,9 @@ const out = adf.transform(masterKey, transformSeed, 600000);
|
|
|
43
53
|
```js
|
|
44
54
|
const worker = fw.createWorker(
|
|
45
55
|
function ({ libs, args }) {
|
|
46
|
-
self.postMessage(libs.adf.
|
|
56
|
+
self.postMessage(libs.adf.fn(args[0], args[1], args[2], args[3]));
|
|
47
57
|
},
|
|
48
|
-
{ dependencies: ['adf'], args: [
|
|
58
|
+
{ dependencies: ['adf'], args: [master, transform, 600000, composite] }
|
|
49
59
|
);
|
|
50
60
|
```
|
|
51
61
|
|
|
@@ -13,13 +13,13 @@ status: complete
|
|
|
13
13
|
|
|
14
14
|
**Module** `argon2` | **Source** `packages/front/fw/src/crypto/hash/argon2.js` | **Deps** `blake2b` | **Worker-safe** yes
|
|
15
15
|
|
|
16
|
-
NIST/IETF/OWASP selection for password storage. RFC 9106 §4 mandates Argon2id (d/i hybrid)
|
|
16
|
+
NIST/IETF/OWASP selection for password storage. RFC 9106 §4 mandates Argon2id (d/i hybrid); Argon2d and Argon2i are not offered.
|
|
17
17
|
|
|
18
18
|
## Resolve
|
|
19
19
|
|
|
20
20
|
```js
|
|
21
21
|
const argon2 = runtime.resolve('argon2');
|
|
22
|
-
// Returns: { hash
|
|
22
|
+
// Returns: { hash }
|
|
23
23
|
```
|
|
24
24
|
|
|
25
25
|
## API
|
|
@@ -27,9 +27,7 @@ const argon2 = runtime.resolve('argon2');
|
|
|
27
27
|
| Method | Signature | Returns |
|
|
28
28
|
|---------|-----------|---------|
|
|
29
29
|
| `hash(opts)` | `({password, salt, time, memory, parallelism, tagLen, secret?, ad?}) => Uint8Array \| false` | Argon2id tag |
|
|
30
|
-
| `
|
|
31
|
-
| `hashI()` | `() => false` | **DEPRECATED reject** (Alwen-Blocki 2016) |
|
|
32
|
-
| `_internal.{Hp, compress}` | — | Test/debug primitives |
|
|
30
|
+
| `internalOf(argon2).{Hp, compress}` | — | Test/debug primitives |
|
|
33
31
|
|
|
34
32
|
### Options `hash`
|
|
35
33
|
|
|
@@ -59,13 +57,6 @@ const tag = argon2.hash({
|
|
|
59
57
|
// Store (tag, salt) in the database; rehash at login to verify.
|
|
60
58
|
```
|
|
61
59
|
|
|
62
|
-
### Argon2d / Argon2i rejected
|
|
63
|
-
|
|
64
|
-
```js
|
|
65
|
-
argon2.hashD(); // false + console.warn('UNSAFE: Argon2d cache-timing')
|
|
66
|
-
argon2.hashI(); // false + console.warn('DEPRECATED: Argon2i Alwen-Blocki 2016')
|
|
67
|
-
```
|
|
68
|
-
|
|
69
60
|
## Worker Usage
|
|
70
61
|
|
|
71
62
|
```js
|
|
@@ -19,25 +19,23 @@ Extremely fast hash (1× faster than MD5, ~2× SHA-256) with security margins
|
|
|
19
19
|
|
|
20
20
|
```js
|
|
21
21
|
const blake2b = runtime.resolve('blake2b');
|
|
22
|
-
// Returns: { hash,
|
|
22
|
+
// Returns: { hash, create }
|
|
23
23
|
```
|
|
24
24
|
|
|
25
25
|
## API
|
|
26
26
|
|
|
27
27
|
| Method | Signature | Returns |
|
|
28
28
|
|---------|-----------|---------|
|
|
29
|
-
| `hash(msg, outLen=64,
|
|
30
|
-
| `
|
|
31
|
-
| `fn.prototype.update(data)` | `(Uint8Array) => this` | Absorbs input |
|
|
32
|
-
| `fn.prototype.finalize()` | `() => Uint8Array` | Emits the digest |
|
|
29
|
+
| `hash(msg, outLen = 64, key?)` | `(Uint8Array, number?, Uint8Array?) => Uint8Array \| false` | One-shot digest, `outLen` ∈ [1, 64] bytes, keyed when `key` is given |
|
|
30
|
+
| `create(outLen = 64, key?, salt?, person?)` | `(number?, Uint8Array?, Uint8Array?, Uint8Array?) => ctx \| false` | A streaming context: `ctx.update(chunk)` (`false` once finalised), `ctx.digest()` |
|
|
33
31
|
|
|
34
|
-
###
|
|
32
|
+
### Parameters
|
|
35
33
|
|
|
36
|
-
|
|
|
34
|
+
| Parameter | Type | Description |
|
|
37
35
|
|--------|------|-------------|
|
|
38
|
-
| `key` | `Uint8Array(0..64)` | Keyed mode (HMAC alternative
|
|
39
|
-
| `salt` | `Uint8Array(16)` | Per-instance domain separation |
|
|
40
|
-
| `person` | `Uint8Array(16)` | Per-application domain separation |
|
|
36
|
+
| `key` | `Uint8Array(0..64)` | Keyed mode (a MAC, an HMAC alternative) |
|
|
37
|
+
| `salt` | `Uint8Array(16)` | Per-instance domain separation (`create` only) |
|
|
38
|
+
| `person` | `Uint8Array(16)` | Per-application domain separation (`create` only) |
|
|
41
39
|
|
|
42
40
|
## Examples
|
|
43
41
|
|
|
@@ -52,16 +50,16 @@ hex.fromBytes(out);
|
|
|
52
50
|
### Keyed (HMAC alternative)
|
|
53
51
|
|
|
54
52
|
```js
|
|
55
|
-
const tag = blake2b.hash(msg, 32,
|
|
53
|
+
const tag = blake2b.hash(msg, 32, secretKey);
|
|
56
54
|
```
|
|
57
55
|
|
|
58
|
-
### Streaming
|
|
56
|
+
### Streaming, with salt and personalisation
|
|
59
57
|
|
|
60
58
|
```js
|
|
61
|
-
const h =
|
|
59
|
+
const h = blake2b.create(64, undefined, salt16, person16);
|
|
62
60
|
h.update(chunk1);
|
|
63
61
|
h.update(chunk2);
|
|
64
|
-
const out = h.
|
|
62
|
+
const out = h.digest();
|
|
65
63
|
```
|
|
66
64
|
|
|
67
65
|
## Worker Usage
|
|
@@ -84,7 +84,7 @@ const worker = fw.createWorker(
|
|
|
84
84
|
|
|
85
85
|
- **Default 600 000 iter** (OWASP 2023). `count < 100000` emits `console.warn('WEAK')` but does not abort (compat with KAT vectors).
|
|
86
86
|
- **`length=0`** returns `[]` (audit post-upgrade Finding 4 — previously returned a phantom block).
|
|
87
|
-
- **SP 800-132 limits**: `count ≥ 1000` + `length ≤ (2³² - 1) × hashLen`.
|
|
87
|
+
- **SP 800-132 limits**: `count ≥ 1000` + `length ≤ (2³² - 1) × hashLen`. A count below 1 (or `NaN`) returns `false` (RFC 8018 §5.2: a positive integer); below 100 000 only the `WEAK` warning.
|
|
88
88
|
|
|
89
89
|
## See also
|
|
90
90
|
|
|
@@ -13,7 +13,7 @@ status: complete
|
|
|
13
13
|
|
|
14
14
|
**Module** `sha224` | **Source** `packages/front/fw/src/crypto/hash/sha224.js` | **Deps** `sha256` | **Worker-safe** yes
|
|
15
15
|
|
|
16
|
-
14-LOC wrapper over `sha256.
|
|
16
|
+
14-LOC wrapper over `internalOf(sha256).makeSha(_INIT_224, 7)`. Previously this module duplicated ~80 LOC of the compression function — refactored in the post-upgrade audit.
|
|
17
17
|
|
|
18
18
|
## Resolve
|
|
19
19
|
|
|
@@ -52,7 +52,7 @@ const worker = fw.createWorker(
|
|
|
52
52
|
|
|
53
53
|
- **HMAC-compatible**: `blockSize = 512` bits (identical to SHA-256, required by RFC 2104).
|
|
54
54
|
- **LDT 1 GiB** validation gated behind `CRYPTO_FULL=1` — see [Conformance](../../../../src/crypto/hash/sha224.acvp.md).
|
|
55
|
-
- **No own API**: everything is delegated to `sha256.
|
|
55
|
+
- **No own API**: everything is delegated to `internalOf(sha256).makeSha`.
|
|
56
56
|
|
|
57
57
|
## See also
|
|
58
58
|
|
|
@@ -13,13 +13,13 @@ status: complete
|
|
|
13
13
|
|
|
14
14
|
**Module** `sha256` | **Source** `packages/front/fw/src/crypto/hash/sha256.js` | **Deps** `bitArray`, `utf8` | **Worker-safe** yes
|
|
15
15
|
|
|
16
|
-
Streaming `fn` API + one-shot `hash`. The parametric factory `
|
|
16
|
+
Streaming `fn` API + one-shot `hash`. The parametric factory `internalOf(sha256).makeSha(init, outWords)` is used by [`sha224`](./sha224.md) (mirrors the [`sha512`](./sha512.md) ↔ [`sha512_224`](./sha512_224.md) / [`sha512_256`](./sha512_256.md) pattern).
|
|
17
17
|
|
|
18
18
|
## Resolve
|
|
19
19
|
|
|
20
20
|
```js
|
|
21
21
|
const sha256 = runtime.resolve('sha256');
|
|
22
|
-
// Returns: { fn, hash
|
|
22
|
+
// Returns: { fn, hash }
|
|
23
23
|
```
|
|
24
24
|
|
|
25
25
|
## API
|
|
@@ -31,7 +31,7 @@ const sha256 = runtime.resolve('sha256');
|
|
|
31
31
|
| `fn.prototype.update` | `(data: string \| bitArray) => this` | Absorbs; chainable |
|
|
32
32
|
| `fn.prototype.finalize` | `() => bitArray` | Emits the digest and resets |
|
|
33
33
|
| `fn.prototype.reset` | `() => this` | Reinitializes state |
|
|
34
|
-
| `
|
|
34
|
+
| `internalOf(sha256).makeSha` | `(init: number[], outWords: number) => {fn, hash}` | Parametric builder (used by sha224) |
|
|
35
35
|
|
|
36
36
|
## Examples
|
|
37
37
|
|
|
@@ -75,7 +75,7 @@ const worker = fw.createWorker(
|
|
|
75
75
|
|
|
76
76
|
- **Max limit**: `update` rejects via `false` + `console.warn('INVALID')` beyond 2⁵³−1 bits (IEEE-754 limit of the `_length` counter).
|
|
77
77
|
- **`update` after `finalize`**: `finalize()` resets state → the instance is reusable. To clone without reset: `new sha256.fn(other)`.
|
|
78
|
-
- **LDT (Large Data Test) 1 GiB** validation gated behind `CRYPTO_FULL=1
|
|
78
|
+
- **LDT (Large Data Test) 1 GiB** validation gated behind `CRYPTO_FULL=1`.
|
|
79
79
|
|
|
80
80
|
## See also
|
|
81
81
|
|
|
@@ -19,7 +19,7 @@ One-shot API for SHA-3 and SHAKE + 4 streaming `sha3_*_hash` sub-modules consuma
|
|
|
19
19
|
|
|
20
20
|
```js
|
|
21
21
|
const sha3 = runtime.resolve('sha3');
|
|
22
|
-
// Returns: {
|
|
22
|
+
// Returns: { sha3_224, sha3_256, sha3_384, sha3_512, shake128, shake256,
|
|
23
23
|
// sha3_224_hash, sha3_256_hash, sha3_384_hash, sha3_512_hash }
|
|
24
24
|
```
|
|
25
25
|
|
|
@@ -80,7 +80,7 @@ const worker = fw.createWorker(
|
|
|
80
80
|
|
|
81
81
|
- **One-shot only on `sha3_*` / `shake*`** — no direct streaming API (use `sha3_*_hash.fn` which exposes update/finalize).
|
|
82
82
|
- **SHAKE outBits**: must be a multiple of 8 (byte alignment); otherwise `false` + `console.warn('INVALID')`.
|
|
83
|
-
- **MCT byte-exact**: all SHA3-{224,256,384,512} variants tested 100/100 iterations × 1000 inner
|
|
83
|
+
- **MCT byte-exact**: all SHA3-{224,256,384,512} variants tested 100/100 iterations × 1000 inner.
|
|
84
84
|
|
|
85
85
|
## See also
|
|
86
86
|
|
|
@@ -13,7 +13,7 @@ status: complete
|
|
|
13
13
|
|
|
14
14
|
**Module** `sha384` | **Source** `packages/front/fw/src/crypto/hash/sha384.js` | **Deps** `sha512` | **Worker-safe** yes
|
|
15
15
|
|
|
16
|
-
14-LOC wrapper over `sha512.
|
|
16
|
+
14-LOC wrapper over `internalOf(sha512).makeSha(_INIT_384, 12)`. Previously this module duplicated ~120 LOC of the compression function — refactored in the post-upgrade audit.
|
|
17
17
|
|
|
18
18
|
## Resolve
|
|
19
19
|
|
|
@@ -13,13 +13,13 @@ status: complete
|
|
|
13
13
|
|
|
14
14
|
**Module** `sha512` | **Source** `packages/front/fw/src/crypto/hash/sha512.js` | **Deps** `bitArray`, `utf8` | **Worker-safe** yes
|
|
15
15
|
|
|
16
|
-
Streaming `fn` API + one-shot `hash`. The parametric factory `
|
|
16
|
+
Streaming `fn` API + one-shot `hash`. The parametric factory `internalOf(sha512).makeSha(init, outWords)` is used by [`sha384`](./sha384.md), [`sha512_224`](./sha512_224.md), [`sha512_256`](./sha512_256.md).
|
|
17
17
|
|
|
18
18
|
## Resolve
|
|
19
19
|
|
|
20
20
|
```js
|
|
21
21
|
const sha512 = runtime.resolve('sha512');
|
|
22
|
-
// Returns: { fn, hash
|
|
22
|
+
// Returns: { fn, hash }
|
|
23
23
|
```
|
|
24
24
|
|
|
25
25
|
## API
|
|
@@ -30,7 +30,7 @@ const sha512 = runtime.resolve('sha512');
|
|
|
30
30
|
| `fn` | `constructor()` or `constructor(other)` | Streaming instance + copy constructor |
|
|
31
31
|
| `fn.prototype.update` | `(data) => this` | Absorbs; chainable |
|
|
32
32
|
| `fn.prototype.finalize` | `() => bitArray` | Emits the digest and resets |
|
|
33
|
-
| `
|
|
33
|
+
| `internalOf(sha512).makeSha` | `(init: number[], outWords: number) => {fn, hash}` | Builder for truncated variants |
|
|
34
34
|
|
|
35
35
|
## Examples
|
|
36
36
|
|
|
@@ -46,7 +46,7 @@ hex.fromBytes(bitArray.ba_to_ui8(digestBa));
|
|
|
46
46
|
|
|
47
47
|
```js
|
|
48
48
|
// Used by sha384.js / sha512_224.js / sha512_256.js
|
|
49
|
-
const sha384Like = sha512.
|
|
49
|
+
const sha384Like = internalOf(sha512).makeSha(_INIT_384, 12);
|
|
50
50
|
const digest = sha384Like.hash('abc'); // 12 words × 32 = 384 bits
|
|
51
51
|
```
|
|
52
52
|
|
|
@@ -64,7 +64,7 @@ const worker = fw.createWorker(
|
|
|
64
64
|
- **Input domain is a `bitArray`, not raw bytes.** `hash(data)` accepts a UTF-8 string or a `bitArray`. Passing a `Uint8Array` does **not** throw — it is consumed as a word array and yields a wrong-but-deterministic digest that still round-trips self-consistently and only fails against official vectors. Convert first: `sha512.hash(bitArray.ui8_to_ba(bytes))`. The same domain applies to the `pkc` hash helper; the WASM `sha2` / `sha3` wrappers, by contrast, consume raw bytes directly. A green round-trip is not evidence of a correct digest.
|
|
65
65
|
- **Block size**: 1024 bits (vs 512 for SHA-256). 64-bit `_length` counter FIPS 180-4 §5.1.2 limited to 2⁵³−1 by IEEE-754.
|
|
66
66
|
- **64-bit operations emulated** as 32-bit pairs (high/low) — no BigInt.
|
|
67
|
-
- **LDT 1 GiB** validation gated behind `CRYPTO_FULL=1
|
|
67
|
+
- **LDT 1 GiB** validation gated behind `CRYPTO_FULL=1`.
|
|
68
68
|
|
|
69
69
|
## See also
|
|
70
70
|
|
|
@@ -6,9 +6,9 @@ AES operating modes + ChaCha20 AEAD. Each module takes a pre-scheduled block/str
|
|
|
6
6
|
|--------|----------|------|-------------|
|
|
7
7
|
| [cbc](./cbc.md) | `{encrypt, decrypt}` | `bitArray`, `aes` | AES-CBC (SP 800-38A §6.2) — confidentiality, caller-provided padding |
|
|
8
8
|
| [ctr](./ctr.md) | `{encrypt}` | `bitArray`, `aes` | AES-CTR (SP 800-38A §6.5) — stream, no padding |
|
|
9
|
-
| [gcm](./gcm.md) | `{encrypt, decrypt, gmac, gmacVerify, nonceTracker
|
|
10
|
-
| [cmac](./cmac.md) | `{mac, verify, truncatedMac, truncatedVerify
|
|
11
|
-
| [kw](./kw.md) | `{wrap, unwrap, wrapPad, unwrapPad, wrapInverseCipher, unwrapInverseCipher
|
|
9
|
+
| [gcm](./gcm.md) | `{encrypt, decrypt, gmac, gmacVerify, nonceTracker}` | `bitArray`, `aes` | AES-GCM (SP 800-38D) — AEAD, GMAC included |
|
|
10
|
+
| [cmac](./cmac.md) | `{mac, verify, truncatedMac, truncatedVerify}` | `bitArray`, `aes` | AES-CMAC (SP 800-38B / RFC 4493); TDES rejected |
|
|
11
|
+
| [kw](./kw.md) | `{wrap, unwrap, wrapPad, unwrapPad, wrapInverseCipher, unwrapInverseCipher}` | `bitArray`, `aes` | AES-KW + KWP (SP 800-38F / RFC 3394 / RFC 5649) |
|
|
12
12
|
| [chacha20poly1305](./chacha20poly1305.md) | `{encrypt, decrypt, nonceTracker}` | `chacha20`, `poly1305` | AEAD ChaCha20-Poly1305 (RFC 8439) |
|
|
13
13
|
|
|
14
14
|
## Common pattern (AEAD)
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
module: cbc
|
|
3
3
|
category: crypto/mode
|
|
4
|
-
dependencies: [bitArray
|
|
4
|
+
dependencies: [bitArray]
|
|
5
5
|
returns: object
|
|
6
6
|
worker-safe: true
|
|
7
7
|
status: complete
|
|
@@ -11,7 +11,7 @@ status: complete
|
|
|
11
11
|
|
|
12
12
|
> AES-CBC (SP 800-38A §6.2) — confidentiality, padding is the caller's responsibility.
|
|
13
13
|
|
|
14
|
-
**Module** `cbc` | **Source** `packages/front/fw/src/crypto/mode/cbc.js` | **Deps** `bitArray
|
|
14
|
+
**Module** `cbc` | **Source** `packages/front/fw/src/crypto/mode/cbc.js` | **Deps** `bitArray` | **Worker-safe** yes
|
|
15
15
|
|
|
16
16
|
CBC is **unauthenticated**: use [`gcm`](./gcm.md) or [`chacha20poly1305`](./chacha20poly1305.md) for AEAD. If CBC is required, layer an explicit MAC (encrypt-then-MAC).
|
|
17
17
|
|
|
@@ -67,7 +67,7 @@ const worker = fw.createWorker(
|
|
|
67
67
|
## Notes
|
|
68
68
|
|
|
69
69
|
- **12-byte nonce** (RFC 8439 §2.3). **Nonce reuse** does not degrade Poly1305 cryptographically but **leaks the XOR of plaintexts** + enables forgery → use `nonceTracker` for in-process detection.
|
|
70
|
-
- **Tag mismatch → `false`** + `console.
|
|
70
|
+
- **Tag mismatch → `false`** + `console.warn('CORRUPT')` (an expected outcome; nonce reuse stays at `console.error`). Plaintext is never released on an invalid tag.
|
|
71
71
|
- **No AES-NI required**: better performance than GCM on ARM / mobile / without AES hardware.
|
|
72
72
|
|
|
73
73
|
## See also
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
module: cmac
|
|
3
3
|
category: crypto/mode
|
|
4
|
-
dependencies: [bitArray
|
|
4
|
+
dependencies: [bitArray]
|
|
5
5
|
returns: object
|
|
6
6
|
worker-safe: true
|
|
7
7
|
status: complete
|
|
@@ -11,7 +11,7 @@ status: complete
|
|
|
11
11
|
|
|
12
12
|
> AES-CMAC (SP 800-38B / RFC 4493) — deterministic MAC based on AES, TDES rejected.
|
|
13
13
|
|
|
14
|
-
**Module** `cmac` | **Source** `packages/front/fw/src/crypto/mode/cmac.js` | **Deps** `bitArray
|
|
14
|
+
**Module** `cmac` | **Source** `packages/front/fw/src/crypto/mode/cmac.js` | **Deps** `bitArray` | **Worker-safe** yes
|
|
15
15
|
|
|
16
16
|
Default 128-bit tag, truncatable to 32-128 via `truncatedMac` (SP 800-38B §6.4 minimum 32 bits).
|
|
17
17
|
|
|
@@ -19,7 +19,7 @@ Default 128-bit tag, truncatable to 32-128 via `truncatedMac` (SP 800-38B §6.4
|
|
|
19
19
|
|
|
20
20
|
```js
|
|
21
21
|
const cmac = runtime.resolve('cmac');
|
|
22
|
-
// Returns: { mac, verify, truncatedMac, truncatedVerify
|
|
22
|
+
// Returns: { mac, verify, truncatedMac, truncatedVerify }
|
|
23
23
|
```
|
|
24
24
|
|
|
25
25
|
## API
|
|
@@ -30,7 +30,7 @@ const cmac = runtime.resolve('cmac');
|
|
|
30
30
|
| `verify(prf, msgBa, tagBa)` | — | `boolean` (constant-time) |
|
|
31
31
|
| `truncatedMac(prf, msgBa, tagLen)` | — | Truncated tag `tagLen ∈ [32, 128]` |
|
|
32
32
|
| `truncatedVerify(prf, msgBa, tagBa, tagLen)` | — | `boolean` |
|
|
33
|
-
| `
|
|
33
|
+
| `internalOf(cmac).{subkeys}` | — | Debug primitives |
|
|
34
34
|
|
|
35
35
|
## Examples
|
|
36
36
|
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
module: ctr
|
|
3
3
|
category: crypto/mode
|
|
4
|
-
dependencies: [bitArray
|
|
4
|
+
dependencies: [bitArray]
|
|
5
5
|
returns: object
|
|
6
6
|
worker-safe: true
|
|
7
7
|
status: complete
|
|
@@ -11,7 +11,7 @@ status: complete
|
|
|
11
11
|
|
|
12
12
|
> AES-CTR (SP 800-38A §6.5) — stream mode, no padding, encrypt/decrypt involution.
|
|
13
13
|
|
|
14
|
-
**Module** `ctr` | **Source** `packages/front/fw/src/crypto/mode/ctr.js` | **Deps** `bitArray
|
|
14
|
+
**Module** `ctr` | **Source** `packages/front/fw/src/crypto/mode/ctr.js` | **Deps** `bitArray` | **Worker-safe** yes
|
|
15
15
|
|
|
16
16
|
CTR = stream cipher derived from a block cipher. **Unauthenticated**: use GCM for AEAD. **Nonce reuse is catastrophic**: 2 messages under an identical (key, IV) → keystream recovery.
|
|
17
17
|
|
|
@@ -61,6 +61,5 @@ const worker = fw.createWorker(
|
|
|
61
61
|
## See also
|
|
62
62
|
|
|
63
63
|
- [aes](../cipher/aes.md), [aes_modes](../utils/aes_modes.md) — Uint8Array wrapper
|
|
64
|
-
- [aes_ctr](../utils/aes_ctr.md) — legacy wrapper with PKCS#7 (deprecated)
|
|
65
64
|
- [gcm](./gcm.md) — recommended AEAD
|
|
66
65
|
- [Conformance ctr.acvp.md](../../../../src/crypto/mode/ctr.acvp.md)
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
module: gcm
|
|
3
3
|
category: crypto/mode
|
|
4
|
-
dependencies: [bitArray
|
|
4
|
+
dependencies: [bitArray]
|
|
5
5
|
returns: object
|
|
6
6
|
worker-safe: true
|
|
7
7
|
status: complete
|
|
@@ -11,7 +11,7 @@ status: complete
|
|
|
11
11
|
|
|
12
12
|
> AES-GCM (SP 800-38D) — authenticated AEAD + GMAC, IV-reuse catastrophic.
|
|
13
13
|
|
|
14
|
-
**Module** `gcm` | **Source** `packages/front/fw/src/crypto/mode/gcm.js` | **Deps** `bitArray
|
|
14
|
+
**Module** `gcm` | **Source** `packages/front/fw/src/crypto/mode/gcm.js` | **Deps** `bitArray` | **Worker-safe** yes
|
|
15
15
|
|
|
16
16
|
Recommended AEAD mode for TLS / file encryption. **IV reuse under the same key is catastrophic**: loss of the GHASH authentication key + leak of the XOR of plaintexts.
|
|
17
17
|
|
|
@@ -19,7 +19,7 @@ Recommended AEAD mode for TLS / file encryption. **IV reuse under the same key i
|
|
|
19
19
|
|
|
20
20
|
```js
|
|
21
21
|
const gcm = runtime.resolve('gcm');
|
|
22
|
-
// Returns: { encrypt, decrypt, gmac, gmacVerify, nonceTracker
|
|
22
|
+
// Returns: { encrypt, decrypt, gmac, gmacVerify, nonceTracker }
|
|
23
23
|
```
|
|
24
24
|
|
|
25
25
|
## API
|
|
@@ -31,7 +31,7 @@ const gcm = runtime.resolve('gcm');
|
|
|
31
31
|
| `gmac(prf, aadBa, ivBa, tagLenBits)` | — | Tag (no PT) |
|
|
32
32
|
| `gmacVerify(prf, aadBa, ivBa, tagBa, tagLenBits)` | — | `boolean` |
|
|
33
33
|
| `nonceTracker(prf)` | `({encrypt}) => {encrypt, decrypt, seenNonces}` | Anti-IV-reuse wrapper (in-process) |
|
|
34
|
-
| `
|
|
34
|
+
| `internalOf(gcm).{ghash, gctr}` | — | Debug primitives |
|
|
35
35
|
|
|
36
36
|
### `tagLenBits`
|
|
37
37
|
|
|
@@ -83,7 +83,7 @@ const worker = fw.createWorker(
|
|
|
83
83
|
## Notes
|
|
84
84
|
|
|
85
85
|
- **Unique IV** per (key, message): use `random.bytes(12)` or a monotonic counter. `nonceTracker` detects reuse in-process.
|
|
86
|
-
- **Tag mismatch → `false`** + `console.
|
|
86
|
+
- **Tag mismatch → `false`** + `console.warn('CORRUPT: gcm: authentication tag mismatch')` (an expected outcome; nonce reuse stays at `console.error`). Plaintext is **never** released on an invalid tag.
|
|
87
87
|
- **AES-128/192/256**: `cipher` can be scheduled on any of the 3 key sizes (key-size-agnostic via `aes.fn`).
|
|
88
88
|
|
|
89
89
|
## See also
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
module: kw
|
|
3
3
|
category: crypto/mode
|
|
4
|
-
dependencies: [bitArray
|
|
4
|
+
dependencies: [bitArray]
|
|
5
5
|
returns: object
|
|
6
6
|
worker-safe: true
|
|
7
7
|
status: complete
|
|
@@ -11,7 +11,7 @@ status: complete
|
|
|
11
11
|
|
|
12
12
|
> AES-KW + KWP (SP 800-38F / RFC 3394 / RFC 5649) — symmetric key wrapping.
|
|
13
13
|
|
|
14
|
-
**Module** `kw` | **Source** `packages/front/fw/src/crypto/mode/kw.js` | **Deps** `bitArray
|
|
14
|
+
**Module** `kw` | **Source** `packages/front/fw/src/crypto/mode/kw.js` | **Deps** `bitArray` | **Worker-safe** yes
|
|
15
15
|
|
|
16
16
|
KW (RFC 3394) wraps payloads that are multiples of 64 bits. KWP (RFC 5649) adds padding for arbitrary-length payloads. Inverse-cipher variant (SP 800-38F §6.3) explicitly rejected.
|
|
17
17
|
|
|
@@ -19,7 +19,7 @@ KW (RFC 3394) wraps payloads that are multiples of 64 bits. KWP (RFC 5649) adds
|
|
|
19
19
|
|
|
20
20
|
```js
|
|
21
21
|
const kw = runtime.resolve('kw');
|
|
22
|
-
// Returns: { wrap, unwrap, wrapPad, unwrapPad, wrapInverseCipher, unwrapInverseCipher
|
|
22
|
+
// Returns: { wrap, unwrap, wrapPad, unwrapPad, wrapInverseCipher, unwrapInverseCipher }
|
|
23
23
|
```
|
|
24
24
|
|
|
25
25
|
## API
|
|
@@ -32,7 +32,7 @@ const kw = runtime.resolve('kw');
|
|
|
32
32
|
| `unwrapPad(prf, ctBa)` | — | PT or `false` |
|
|
33
33
|
| `wrapInverseCipher()` | `() => false` | **NOT-IMPLEMENTED** explicit reject |
|
|
34
34
|
| `unwrapInverseCipher()` | `() => false` | **NOT-IMPLEMENTED** explicit reject |
|
|
35
|
-
| `
|
|
35
|
+
| `internalOf(kw).{...}` | — | Debug primitives |
|
|
36
36
|
|
|
37
37
|
## Examples
|
|
38
38
|
|
|
@@ -8,13 +8,13 @@ Asymmetric cryptography: signatures, key exchange, KEM. Four families:
|
|
|
8
8
|
|
|
9
9
|
| Module | Returns | Deps | Description |
|
|
10
10
|
|--------|----------|------|-------------|
|
|
11
|
-
| [rsa](./rsa.md) | `{oaepEncrypt, oaepDecrypt, pssSign, pssVerify
|
|
12
|
-
| [ecc](./ecc.md) | `{curves,
|
|
13
|
-
| [ed25519](./ed25519.md) | `{keyPair, sign, verify, signPh, verifyPh, signCtx, verifyCtx
|
|
14
|
-
| [x25519](./x25519.md) | `{scalarMult, scalarMultBase, isLowOrderPoint
|
|
15
|
-
| [ml_kem](./ml_kem.md) | `{ml_kem512, ml_kem768, ml_kem1024
|
|
16
|
-
| [ml_dsa](./ml_dsa.md) | `{ml_dsa44, ml_dsa65, ml_dsa87
|
|
17
|
-
| [slh_dsa](./slh_dsa.md) | `{slh_dsa_*_
|
|
11
|
+
| [rsa](./rsa.md) | `{oaepEncrypt, oaepDecrypt, pssSign, pssVerify}` | `sha256`, `bitArray`, `utf8`, `hex` | RSA-OAEP + RSA-PSS (FIPS 186-5 §5.4 / RFC 8017); v1.5 explicit reject |
|
|
12
|
+
| [ecc](./ecc.md) | `{ecdsa, elGamal, curves, curveName, deserialize, basicKey, curve, point, pointJac}` | `bitArray`, `hex`, `bn`, `sha256`, `sha384`, `sha512`, `hmac` | ECDSA FIPS 186-5 + RFC 6979 + subgroup check |
|
|
13
|
+
| [ed25519](./ed25519.md) | `{keyPair, sign, verify, signPh, verifyPh, signCtx, verifyCtx}` | `sha512`, `bitArray` | Ed25519 PureEdDSA + ph + ctx (RFC 8032 / FIPS 186-5 §7.6) |
|
|
14
|
+
| [x25519](./x25519.md) | `{scalarMult, scalarMultBase, isLowOrderPoint}` | none | X25519 DH (RFC 7748) — TweetNaCl-derived (public domain; see [provenance](../../../dev/provenance.md)) |
|
|
15
|
+
| [ml_kem](./ml_kem.md) | `{ml_kem512, ml_kem768, ml_kem1024}` | `sha3`, `bitArray`, `random` | ML-KEM CRYSTALS-Kyber (FIPS 203, August 2024) |
|
|
16
|
+
| [ml_dsa](./ml_dsa.md) | `{ml_dsa44, ml_dsa65, ml_dsa87}` | `sha3`, `bitArray`, `random`, `sha256`, `sha384`, ... | ML-DSA Dilithium + HashML-DSA (FIPS 204) |
|
|
17
|
+
| [slh_dsa](./slh_dsa.md) | `{slh_dsa_*_*}` | `sha3`, `sha256`, `sha512`, `hmac`, `bitArray`, `random` | SLH-DSA SPHINCS+ + HashSLH-DSA (FIPS 205, 12 variants) |
|
|
18
18
|
| [hybridKem](./hybridKem.md) | `{xwing}` | `x25519`, `ml_kem`, `sha3` | X-Wing hybrid KEM (X25519+ML-KEM-768, draft-connolly-cfrg-xwing-kem -06; official IETF KAT) |
|
|
19
19
|
| [hybridSign](./hybridSign.md) | `{mldsa65_ed25519, mldsa65_ecdsaP256}` | `ml_dsa`, `ed25519`, `ecc`, `sha512`, `sha256`, `random`, `utf8` | Composite signatures (draft-ietf-lamps-pq-composite-sigs, AND-verify): MLDSA65-Ed25519 + MLDSA65-ECDSA-P256 |
|
|
20
20
|
|
|
@@ -24,7 +24,7 @@ Asymmetric cryptography: signatures, key exchange, KEM. Four families:
|
|
|
24
24
|
const { ed25519, random } = fw.runtime.resolveAll(['ed25519', 'random']);
|
|
25
25
|
const { privateKey, publicKey } = ed25519.keyPair(random.bytes(32));
|
|
26
26
|
const sig = ed25519.sign(privateKey, msg);
|
|
27
|
-
const ok = ed25519.verify(publicKey,
|
|
27
|
+
const ok = ed25519.verify(publicKey, sig, msg); // true / false
|
|
28
28
|
```
|
|
29
29
|
|
|
30
30
|
## Common pattern (PQC KEM)
|