feat(cat-voices): Enable wasm support for Catalyst Voices (#3622)

dt-iohk · web-flow · commit ab23ad4fc32d · 2025-11-05T09:39:52.000+01:00
* feat: enable wasm support

* feat: update vscode launch.json to enable wasm

* fix: wasm undefined support

* chore: update to CI version with wasm support

* fix: undefined in wasm

* chore: cleanup

* style: spelling

* chore: add wasm argument

* fix: syntax

* chore: switch to master
diff --git a/.vscode/launch.recommended.json b/.vscode/launch.recommended.json
@@ -14,6 +14,7 @@
       "deviceId": "chrome",
       "program": "lib/configs/main_web.dart",
       "args": [
+        "--wasm",
         "--dart-define",
         "SENTRY_DSN=REPLACE_WITH_SENTRY_DSN_URL",
         "--web-header",
@@ -34,6 +35,7 @@
       "deviceId": "chrome",
       "program": "lib/configs/main_web.dart",
       "args": [
+        "--wasm",
         "--dart-define",
         "SENTRY_DSN=REPLACE_WITH_SENTRY_DSN_URL",
         "--web-header",
@@ -52,6 +54,7 @@
       "deviceId": "chrome",
       "program": "lib/configs/main_web.dart",
       "args": [
+        "--wasm",
         "--dart-define",
         "SENTRY_DSN=REPLACE_WITH_SENTRY_DSN_URL",
         "--web-header",
@@ -70,6 +73,7 @@
       "deviceId": "chrome",
       "program": "lib/configs/main_web.dart",
       "args": [
+        "--wasm",
         "--dart-define",
         "SENTRY_DSN=REPLACE_WITH_SENTRY_DSN_URL",
         "--web-header",
@@ -88,6 +92,7 @@
       "deviceId": "chrome",
       "program": "lib/configs/main_web.dart",
       "args": [
+        "--wasm",
         "--dart-define",
         "SENTRY_DSN=REPLACE_WITH_SENTRY_DSN_URL",
         "--web-header",
@@ -106,6 +111,7 @@
       "deviceId": "chrome",
       "program": "lib/configs/main_web.dart",
       "args": [
+        "--wasm",
         "--dart-define",
         "SENTRY_DSN=REPLACE_WITH_SENTRY_DSN_URL",
         "--web-header",
@@ -124,6 +130,7 @@
       "deviceId": "chrome",
       "program": "lib/configs/main_web.dart",
       "args": [
+        "--wasm",
         "--dart-define",
         "SENTRY_DSN=REPLACE_WITH_SENTRY_DSN_URL",
         "--web-header",
@@ -142,6 +149,7 @@
       "deviceId": "chrome",
       "program": "lib/configs/main_web.dart",
       "args": [
+        "--wasm",
         "--dart-define",
         "SENTRY_DSN=REPLACE_WITH_SENTRY_DSN_URL",
         "--web-header",
@@ -160,6 +168,7 @@
       "deviceId": "chrome",
       "program": "lib/configs/main_web.dart",
       "args": [
+        "--wasm",
         "--dart-define",
         "SENTRY_DSN=REPLACE_WITH_SENTRY_DSN_URL",
         "--web-header",
diff --git a/Earthfile b/Earthfile
@@ -1,8 +1,8 @@
 VERSION 0.8
 
-IMPORT github.com/input-output-hk/catalyst-ci/earthly/mdlint:v3.5.20 AS mdlint-ci
-IMPORT github.com/input-output-hk/catalyst-ci/earthly/cspell:v3.5.20 AS cspell-ci
-IMPORT github.com/input-output-hk/catalyst-ci/earthly/postgresql:v3.5.20 AS postgresql-ci
+IMPORT github.com/input-output-hk/catalyst-ci/earthly/mdlint:master AS mdlint-ci
+IMPORT github.com/input-output-hk/catalyst-ci/earthly/cspell:master AS cspell-ci
+IMPORT github.com/input-output-hk/catalyst-ci/earthly/postgresql:master AS postgresql-ci
 
 ARG --global REGISTRY="harbor.shared-services.projectcatalyst.io/dockerhub/library"
 FROM ${REGISTRY}/debian:stable-slim
diff --git a/catalyst-gateway/Earthfile b/catalyst-gateway/Earthfile
@@ -1,6 +1,6 @@
 VERSION 0.8
 
-IMPORT github.com/input-output-hk/catalyst-ci/earthly/rust:v3.5.21 AS rust-ci
+IMPORT github.com/input-output-hk/catalyst-ci/earthly/rust:master AS rust-ci
 IMPORT ../ AS repo-ci
 IMPORT github.com/input-output-hk/catalyst-voices/catalyst-gateway:main AS cat-gateway-main
 
diff --git a/catalyst-gateway/event-db/Earthfile b/catalyst-gateway/event-db/Earthfile
@@ -3,7 +3,7 @@
 # the database and its associated software.
 VERSION 0.8
 
-IMPORT github.com/input-output-hk/catalyst-ci/earthly/postgresql:v3.5.20 AS postgresql-ci
+IMPORT github.com/input-output-hk/catalyst-ci/earthly/postgresql:master AS postgresql-ci
 
 # cspell: words
 
diff --git a/catalyst-gateway/tests/Earthfile b/catalyst-gateway/tests/Earthfile
@@ -1,7 +1,7 @@
 # cspell: words unittests socat
 
 VERSION 0.8
-IMPORT github.com/input-output-hk/catalyst-ci/earthly/spectral:v3.5.20 AS spectral-ci
+IMPORT github.com/input-output-hk/catalyst-ci/earthly/spectral:master AS spectral-ci
 IMPORT .. AS gateway
 
 # build all necessary docker images required to run `docker-compose.yml` services
diff --git a/catalyst-gateway/tests/api_tests/Earthfile b/catalyst-gateway/tests/api_tests/Earthfile
@@ -1,6 +1,6 @@
 VERSION 0.8
 
-IMPORT github.com/input-output-hk/catalyst-ci/earthly/python:v3.5.20 AS python-ci
+IMPORT github.com/input-output-hk/catalyst-ci/earthly/python:master AS python-ci
 IMPORT github.com/input-output-hk/catalyst-libs/rust:catalyst-signed-doc/v0.0.8 AS cat-libs-rust
 IMPORT github.com/input-output-hk/catalyst-libs/rust:catalyst-signed-doc/v.0.0.4-fix-earthly-build AS dep-cat-libs-rust
 IMPORT github.com/input-output-hk/catalyst-storage AS cat-storage
diff --git a/catalyst_voices/Earthfile b/catalyst_voices/Earthfile
@@ -2,7 +2,7 @@ VERSION 0.8
 
 IMPORT ../ AS repo-ci
 IMPORT ../catalyst-gateway AS catalyst-gateway
-IMPORT github.com/input-output-hk/catalyst-ci/earthly/flutter:v3.5.20 AS flutter-ci
+IMPORT github.com/input-output-hk/catalyst-ci/earthly/flutter:master AS flutter-ci
 
 # repo-catalyst-voices - Creates artifacts of all configuration files,
 # packages and folders related to catalyst_voices frontend.
@@ -126,8 +126,9 @@ build-web:
         --TARGET=lib/configs/main_web.dart \
         --UPLOAD_DEBUG_SYMBOLS=$UPLOAD_DEBUG_SYMBOLS \
         --SENTRY_ORG='iohk-j4' \
-        --SENTRY_PROJECT='catalyst-voices'
-    SAVE ARTIFACT --keep-ts web
+        --SENTRY_PROJECT='catalyst-voices' \
+        --WASM=true
+    SAVE ARTIFACT --keep-ts web AS LOCAL web
 
 package:
     FROM harbor.shared-services.projectcatalyst.io/dockerhub/caddy:2.10
diff --git a/catalyst_voices/packages/internal/catalyst_voices_shared/lib/src/browser/catalyst_browser.dart b/catalyst_voices/packages/internal/catalyst_voices_shared/lib/src/browser/catalyst_browser.dart
@@ -2,4 +2,4 @@ library catalyst_browser;
 
 export 'package:catalyst_voices_shared/src/browser/browser_stub.dart'
     if (dart.library.io) 'io_browser.dart'
-    if (dart.library.html) 'web_browser.dart';
+    if (dart.library.js_interop) 'web_browser.dart';
diff --git a/catalyst_voices/packages/internal/catalyst_voices_shared/lib/src/platform/form_factor/form_factor.dart b/catalyst_voices/packages/internal/catalyst_voices_shared/lib/src/platform/form_factor/form_factor.dart
@@ -1,6 +1,6 @@
 import 'package:catalyst_voices_shared/src/platform/form_factor/helpers/stub_form_factor.dart'
     if (dart.library.io) 'helpers/io_form_factor.dart'
-    if (dart.library.html) 'helpers/web_form_factor.dart';
+    if (dart.library.js_interop) 'helpers/web_form_factor.dart';
 
 /// A form factor of the device the app is executing on.
 ///
diff --git a/catalyst_voices/packages/libs/catalyst_cardano/catalyst_cardano/wallet-automation/Earthfile b/catalyst_voices/packages/libs/catalyst_cardano/catalyst_cardano/wallet-automation/Earthfile
@@ -1,6 +1,6 @@
 VERSION 0.8
-IMPORT github.com/input-output-hk/catalyst-ci/earthly/flutter:v3.5.20 AS flutter-ci
-IMPORT github.com/input-output-hk/catalyst-ci/earthly/playwright:v3.5.20 AS playwright-ci
+IMPORT github.com/input-output-hk/catalyst-ci/earthly/flutter:master AS flutter-ci
+IMPORT github.com/input-output-hk/catalyst-ci/earthly/playwright:master AS playwright-ci
 
 ARG --global REGISTRY="harbor.shared-services.projectcatalyst.io/dockerhub/"
 
diff --git a/catalyst_voices/packages/libs/catalyst_cardano/catalyst_cardano_web/lib/src/interop/catalyst_cardano_wallet_proxy.dart b/catalyst_voices/packages/libs/catalyst_cardano/catalyst_cardano_web/lib/src/interop/catalyst_cardano_wallet_proxy.dart
@@ -172,14 +172,19 @@ class JSCardanoWalletApiProxy implements CardanoWalletApi {
   @override
   Future<List<ShelleyAddress>> getUsedAddresses({Paginate? paginate}) async {
     try {
-      final jsPaginate = paginate != null ? JSPaginate.fromDart(paginate) : makeUndefined();
+      final JSPromise<JSArray<JSString>> promise;
+      if (paginate != null) {
+        promise = _delegate.getUsedAddresses(JSPaginate.fromDart(paginate));
+      } else {
+        // Currently it's not possible to make "undefined" value in wasm
+        // https://api.flutter.dev/flutter/dart-js_interop/NullableUndefineableJSAnyExtension/isUndefined.html
+        // Not passing the argument will fill it with "undefined" on the JS side.
+        promise = _delegate.getUsedAddresses();
+      }
 
-      return await _delegate
-          .getUsedAddresses(jsPaginate)
-          .toDart
-          .then(
-            (array) => array.toDart.map((item) => ShelleyAddress(hexDecode(item.toDart))).toList(),
-          );
+      return await promise.toDart.then(
+        (array) => array.toDart.map((item) => ShelleyAddress(hexDecode(item.toDart))).toList(),
+      );
     } catch (ex) {
       throw _mapApiException(ex) ?? _mapPaginateException(ex) ?? _fallbackApiException(ex);
     }
@@ -191,14 +196,40 @@ class JSCardanoWalletApiProxy implements CardanoWalletApi {
     Paginate? paginate,
   }) async {
     try {
-      final utxos = _delegate.getUtxos(
-        amount != null ? hex.encode(cbor.encode(amount.toCbor())).toJS : makeUndefined(),
-        paginate != null ? JSPaginate.fromDart(paginate) : makeUndefined(),
-      );
+      final JSPromise<JSArray<JSString>>? promise;
+      if (amount == null && paginate == null) {
+        // Currently it's not possible to make "undefined" value in wasm
+        // https://api.flutter.dev/flutter/dart-js_interop/NullableUndefineableJSAnyExtension/isUndefined.html
+        // Not passing the argument will fill it with "undefined" on the JS side.
+        promise = _delegate.getUtxos();
+      } else if (amount != null && paginate != null) {
+        promise = _delegate.getUtxos(
+          hex.encode(cbor.encode(amount.toCbor())).toJS,
+          JSPaginate.fromDart(paginate),
+        );
+      } else if (amount == null && paginate != null) {
+        // TODO(dt-iohk): instead of throwing an error rewrite the JS side so that it can accept "null" values,
+        // and from JS side communicate with the wallet extension translating it to "undefined".
+        //
+        // Currently we're talking to the wallet extension directly from dart (wasm) and there's
+        // no man-in-the-middle who could translate nulls to undefined.
+        //
+        // Best to do together with https://github.com/input-output-hk/catalyst-voices/issues/3382
+        throw UnsupportedError(
+          'Due to wasm limitations, the "undefined" values are not supported '
+          'therefore the "paginate" parameter must not be given if "amount" is not given too. '
+          'The JS interface of CIP-30 strictly relies on undefined values which we may not satisfy in wasm.',
+        );
+      } else {
+        promise = _delegate.getUtxos(
+          amount != null ? hex.encode(cbor.encode(amount.toCbor())).toJS : makeUndefined(),
+          paginate != null ? JSPaginate.fromDart(paginate) : makeUndefined(),
+        );
+      }
 
-      if (utxos == null) return {};
+      if (promise == null) return const {};
 
-      return await utxos.toDart.then(
+      return await promise.toDart.then(
         (array) => array.toDart
             .map(
               (item) => TransactionUnspentOutput.fromCbor(
diff --git a/catalyst_voices/packages/libs/catalyst_compression/Earthfile b/catalyst_voices/packages/libs/catalyst_compression/Earthfile
@@ -1,8 +1,8 @@
 VERSION 0.8
 
 IMPORT ../../../ AS catalyst-voices
-IMPORT github.com/input-output-hk/catalyst-ci/earthly/flutter:v3.5.20 AS flutter-ci
-IMPORT github.com/input-output-hk/catalyst-ci/earthly/flutter_rust_bridge:v3.5.20 AS flutter_rust_bridge
+IMPORT github.com/input-output-hk/catalyst-ci/earthly/flutter:master AS flutter-ci
+IMPORT github.com/input-output-hk/catalyst-ci/earthly/flutter_rust_bridge:master AS flutter_rust_bridge
 
 builder:
     FROM flutter_rust_bridge+builder
diff --git a/catalyst_voices/packages/libs/catalyst_compression/rust/Earthfile b/catalyst_voices/packages/libs/catalyst_compression/rust/Earthfile
@@ -1,6 +1,6 @@
 VERSION 0.8
 
-IMPORT github.com/input-output-hk/catalyst-ci/earthly/rust:v3.5.20 AS rust-ci
+IMPORT github.com/input-output-hk/catalyst-ci/earthly/rust:master AS rust-ci
 IMPORT ../ AS flutter-rust-bridge
 
 # builder : Setup the builder
diff --git a/catalyst_voices/packages/libs/catalyst_key_derivation/Earthfile b/catalyst_voices/packages/libs/catalyst_key_derivation/Earthfile
@@ -1,8 +1,8 @@
 VERSION 0.8
 
 IMPORT ../../../ AS catalyst-voices
-IMPORT github.com/input-output-hk/catalyst-ci/earthly/flutter:v3.5.20 AS flutter-ci
-IMPORT github.com/input-output-hk/catalyst-ci/earthly/flutter_rust_bridge:v3.5.20 AS flutter_rust_bridge
+IMPORT github.com/input-output-hk/catalyst-ci/earthly/flutter:master AS flutter-ci
+IMPORT github.com/input-output-hk/catalyst-ci/earthly/flutter_rust_bridge:master AS flutter_rust_bridge
 
 builder:
     FROM flutter_rust_bridge+builder
diff --git a/catalyst_voices/packages/libs/catalyst_key_derivation/rust/Earthfile b/catalyst_voices/packages/libs/catalyst_key_derivation/rust/Earthfile
@@ -1,6 +1,6 @@
 VERSION 0.8
 
-IMPORT github.com/input-output-hk/catalyst-ci/earthly/rust:v3.5.20 AS rust-ci
+IMPORT github.com/input-output-hk/catalyst-ci/earthly/rust:master AS rust-ci
 IMPORT ../ AS flutter-rust-bridge
 
 # builder : Setup the builder
diff --git a/catalyst_voices/pubspec.yaml b/catalyst_voices/pubspec.yaml
@@ -39,6 +39,11 @@ dependencies:
 dev_dependencies:
   melos: ^7.1.1
 
+# TODO(dt-iohk): revert when flutter_secure_storage pulls transitively these or newer versions
+dependency_overrides:
+  flutter_secure_storage_web: ^2.0.0
+  flutter_secure_storage_platform_interface: ^2.0.1
+
 melos:
   repository: https://github.com/input-output-hk/catalyst-voices
 
diff --git a/catalyst_voices/utilities/poc_local_storage/pubspec.yaml b/catalyst_voices/utilities/poc_local_storage/pubspec.yaml
@@ -22,8 +22,5 @@ dependencies:
 dev_dependencies:
   catalyst_analysis: ^3.0.0
 
-dependency_overrides:
-  flutter_secure_storage_web: ^2.0.0-beta.1
-
 flutter:
   uses-material-design: true
diff --git a/catalyst_voices/utilities/uikit_example/Earthfile b/catalyst_voices/utilities/uikit_example/Earthfile
@@ -1,7 +1,7 @@
 VERSION 0.8
 
 IMPORT ../../ AS catalyst-voices
-IMPORT github.com/input-output-hk/catalyst-ci/earthly/flutter:v3.5.20 AS flutter-ci
+IMPORT github.com/input-output-hk/catalyst-ci/earthly/flutter:master AS flutter-ci
 
 # local-build-web - build web version of UIKit example.
 # Prefixed by "local" to make sure it's not auto triggered, the target was
diff --git a/docs/Earthfile b/docs/Earthfile
@@ -1,6 +1,6 @@
 VERSION 0.8
 
-IMPORT github.com/input-output-hk/catalyst-ci/earthly/docs:v3.5.20 AS docs-ci
+IMPORT github.com/input-output-hk/catalyst-ci/earthly/docs:master AS docs-ci
 
 IMPORT .. AS repo
 IMPORT ../catalyst-gateway AS catalyst-gateway
diff --git a/utilities/docs-preview/Earthfile b/utilities/docs-preview/Earthfile
@@ -1,6 +1,6 @@
 VERSION 0.8
 
-IMPORT github.com/input-output-hk/catalyst-ci/earthly/docs:v3.5.20 AS docs-ci
+IMPORT github.com/input-output-hk/catalyst-ci/earthly/docs:master AS docs-ci
 
 # update-docs-dev-script: get the latest docs dev script from CI.
 update-docs-dev-script:
