rustCryptoInstance function

Future<RustCryptoWorld> rustCryptoInstance({ required WasiConfig wasiConfig, Future<WasmModule> loadModule()?, })

Creates a RustCryptoWorld with the given wasiConfig. It setsUp the dynamic library for wasm_run for native platforms and loads the dart_wit_component WASM module from the file system or from the releases of wasm_run repository.

If loadModule is provided, it will be used to load the WASM module. This can be useful if you want to provide a different configuration or implementation, or you are loading it from Flutter assets or from a different HTTP endpoint. By default, it will load the WASM module from the file system in lib/dart_wit_component.wasm either reading it directly in native platforms or with a GET request for Dart web. As a fallback it will use the releases from the wasm_run repository.

Implementation

Future<RustCryptoWorld> rustCryptoInstance({
  required WasiConfig wasiConfig,
  Future<WasmModule> Function()? loadModule,
}) async {
  await WasmRunLibrary.setUp(override: false);
  // TODO: support smaller WASM modules if the user only needs a subset of the API
  const filename = 'rust_crypto_wasm.wasm';

  final WasmModule module;
  if (loadModule != null) {
    module = await loadModule();
  } else {
    final uri = await WasmFileUris.uriForPackage(
      package: 'rust_crypto',
      libPath: 'assets/rust_crypto_wasm.wasm',
      envVariable: 'RUST_CRYPTO_WASM_PATH',
    );
    WasmFileUris uris = WasmFileUris(uri: uri);
    if (!_isWeb) {
      const releaseUrl =
          'https://github.com/juancastillo0/wasm_run/releases/download/wasm_packages-v${WasmRunLibrary.version}/$filename';
      uris = WasmFileUris(
        uri: uri,
        fallback: WasmFileUris(uri: Uri.parse(releaseUrl)),
      );
    }

    module = await uris.loadModule();
  }
  final builder = module.builder(
    wasiConfig: wasiConfig,
  );
  final world = await RustCryptoWorld.init(
    builder,
    imports: const RustCryptoWorldImports(),
  );
  return world;
}