search

Prerequisites

The Keyless Web SDK has three conditions that must be met in order for it to run, these conditions mainly revolve around module loading, bundling and security headers.

hashtag
Run as Module

The main Javascript entrypoint of the @keyless/sdk-web or @keyless/sdk-web-components module which is index.js must be loaded as a module.

<!doctype html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>Keyless Web SDK</title>
  </head>
  <body>
    <script type="module">
      import { ... } from '@keyless/sdk-web/index.js'
    </script>
  </body>
</html>

hashtag
Web Assembly Bundling

When building web applications it's extremely common to use a bundler, make sure yours is capable of bundling .wasm files.

hashtag
Security Headers

circle-info

This requirement applies only when using multi-threading, read more on Multi-Threading

The Web Assembly module requires two security headers to run, if these headers are unset or have unfit values you won't be able to use the Keyless Web SDK.

Name
Value

Cross-Origin-Embedder-Policy

require-corp

Cross-Origin-Opener-Policy

same-origin

In case you are loading resources from an external domain, make sure to load those resources in crossorigin, please read Cross-Origin-Embedder-Policy: Avoiding Blockage With CORSarrow-up-right for more details.

Last updated

Was this helpful?