Skip to content

refactor(ui): remove the legacy Nova host-api bridge#86

Draft
pgherveou wants to merge 38 commits into
mainfrom
remove-legacy-mode
Draft

refactor(ui): remove the legacy Nova host-api bridge#86
pgherveou wants to merge 38 commits into
mainfrom
remove-legacy-mode

Conversation

@pgherveou

@pgherveou pgherveou commented Jul 20, 2026

Copy link
Copy Markdown
Collaborator

Once all the products have migrated to using truapi, we can proably get rid of the legacy bridge

Description

Products connect to the host exclusively over the TrUAPI MessagePort transport wired in createIframeHost; @parity/truapi is the only supported product SDK.

  • Deletes packages/ui/src/legacy-host-bridge.ts (the window-postMessage transport and Nova chain-head follow-id rewriting) and its test suite.
  • Deletes the first-frame probe in packages/ui/src/bridge.ts that sniffed raw Uint8Array frames to re-pipe the core over window-postMessage.
  • Updates MIGRATION.md accordingly.

pgherveou added 30 commits July 15, 2026 11:03
Replace the Nova host-container, auth, and signing path with the worker-backed Rust core. Keep dotli responsible only for browser policy, persistence, UI, and physical chain transports.
Notification grants do not alter iframe Permissions Policy. Reloading disposed the in-flight Rust request before its response reached the product.
The pending-message flush drops send failures silently, matching the
pre-port behavior. Surfacing them as JSON-RPC errors moves to a
follow-up PR with test coverage.
…follow-up

Keep @polkadot-api/signer and @polkadot-labs/hdkd{,-helpers} declared
(unused since before the port) and limit rpc-chain tests to the new
core gateway provider surface. Removing the dead deps and adding
coverage for pre-existing chain checks moves to a follow-up PR.
Keep the base panel top offset and suffix-based terminator matching
(minus the removed host-papp events). The offset correction, the
exact-match terminator set, and the @dotli/config dependency
declaration move to a follow-up PR.
Prompts always reach the modal, matching the pre-port behavior. The
sliding-window limiter returns in a follow-up PR together with the
denied-path semantics and a test that trips the window.
AllowanceKeys persist as plain hex through the same path as every
other core storage key. The at-rest cipher moves to a follow-up PR
where the scheme (per-write nonce, plain-hex read fallback) can get a
focused security review.
The bridge emits only the first_inbound/first_outbound lifecycle
events. The per-frame TrUAPI tap that feeds the debug panel timeline
returns in a follow-up PR; the panel's truapi event handling stays in
place and receives no events until then.
… follow-up

Login failures fall back to the raw reason except for the base
OriginPersonProviderError mapping, and the permissions popover renders
last-write-wins without a staleness guard or unavailable-state hint.
The failure-message pack and popover hardening move to a follow-up PR.
…i-host 0.1.0

The published packages replace the temporary personal-scope npm
aliases used while the port was in review.
bun run link:truapi replaces the two installed TrUAPI npm packages with
symlinks to a sibling TrUAPI checkout, and bun run unlink:truapi runs a
forced frozen install to restore the declared packages. Package
resolution is validated after linking so local E2E cannot silently
exercise a stale npm build. The parent truapi repo's make e2e-dotli
target depends on this script via make dotli-link.
getActiveGatewayChains and its doc comment match the pre-port source;
only the core gateway set is new.
Nova exposes synthetic follow ids to legacy products, while the Rust core requires the subscription wire request id. Translate only at the legacy window boundary so existing product-sdk apps keep working without weakening core validation.
All OpenUrl requests are normalized and scheme-validated by the Rust core before they reach this browser callback, so duplicating that policy in TypeScript would create a second allowlist that can drift.

Add the noopener window feature to every routing branch instead. This prevents an allowed destination from retaining window.opener access to the dotli host while preserving the existing dot-domain, localhost, and external URL routing behavior.

Cover all three branches with a regression test that verifies each new tab is opened with noopener.
Changing a permission dispatched a synchronous permission-changed event whose listener started rendering the open popover, then the dropdown success path started a second render directly. Both asynchronous renders appended their rows after the same clear, doubling every entry.

Remove only the redundant success-path render and keep the catch-path render for recovery. The permission event remains the single successful refresh trigger for both device and non-device permissions.

Add a regression test that changes a dropdown and asserts the popover still contains exactly one row per permission.
The topbar login promise previously listened only for response frames. If the core provider closed during pairing, no response could arrive and the pending promise retained its message subscription indefinitely.

Subscribe to provider close events and reject with the transport error. Centralize settlement and cleanup so message responses, malformed frames, send failures, and provider closure all unsubscribe both listeners exactly once.

The cleanup also handles the provider contract where an already-closed provider invokes the close callback during subscription. Add a regression test that closes a pending provider and verifies rejection plus listener cleanup.
The confirmation adapter already rendered and resolved the newer review variants, but its suite exercised only legacy payload signing and omitted transaction creation and the dedicated preimage flow.

Add product-account payload and transaction assertions so account formatting and transaction fields are locked down. Add both allow and cancel cases for preimage submission to verify that the dedicated modal maps user intent to the boolean host response.

This intentionally changes tests only: the existing production behavior satisfies the review request once these untested branches are covered.
The legacy window transport accepted inbound frames based only on Window identity and sent outbound frames with a wildcard target. The iframe keeps its real origin because its sandbox includes allow-same-origin; credentialless mode does not make that origin opaque.

Require the resolved product origin for inbound provider frames, use it as the outbound postMessage target, and enforce it on the initial modern-versus-legacy probe before replaying the first frame. This closes the wildcard path without changing the legacy Nova wire compatibility layer.

Add coverage for the exact outbound target and for rejecting both wrong-origin and wrong-source inbound messages.
Preimage lookup trusted non-empty bytes returned by both the IPFS gateway and Bitswap and cached them under the requested key. A faulty or hostile backend could therefore poison the process-wide cache and serve mismatched bytes to later subscribers.

Recompute the requested Blake2b-256 content hash with the existing content verification utility before either cache write. Verification failures follow the existing backend-error stream path and never populate the cache.

Cover successful verified caching and corrupt responses from both backend modes. The corruption cases subscribe twice to prove that rejected bytes are fetched again rather than retained.
Link one TrUAPI client across dotli and the product so local runs exercise the same runtime end to end. Surface authentication progress while pairing finalizes.
PAPI registers Function.prototype as a WebSocket no-op. Sentry's BrowserApiErrors wrapper then marks the prototype and makes later event listeners resolve to that no-op.
Products connect over the TrUAPI MessagePort transport only. This drops
the window-postMessage shim for products built on the Nova host-api SDK
(legacy-host-bridge.ts), its first-frame probe in bridge.ts, and the
shim mention in MIGRATION.md.
@github-actions

Copy link
Copy Markdown
Contributor

⚡ Performance Report

⚠️ No baseline found on main. This PR's results are recorded but cannot be compared.
Merge to main to establish a baseline.

@github-actions

Copy link
Copy Markdown
Contributor

Bundle Size Report

Chunks over 500 KB:

File Raw Brotli Gzip
host/assets/paseo.smol-DboPaEh1.json 1.84 MB 941.7 KB 1019.4 KB
host/assets/paseo-people-next.smol.json 3.36 MB 1.68 MB 1.82 MB
host/assets/previewnet.smol.json 1.88 MB 181.4 KB 353.0 KB
host/assets/smoldot.js 2.98 MB 2.21 MB 2.22 MB
host/assets/smoldot_worker.js 2.95 MB 2.21 MB 2.21 MB
host/assets/wasm/web/truapi_server_bg.wasm 1.96 MB 617.3 KB 812.7 KB
Total 15.88 MB (+5.09 MB) 8.11 MB (+2.87 MB) (-49%) 8.73 MB (+3.08 MB)
All files
File Raw Brotli Gzip
host/.well-known/apple-app-site-association 738 B 738 B 738 B
host/.well-known/assetlinks.json 1.3 KB 317 B 391 B
host/assets/bridge.js 53.6 KB (+48.2 KB) 15.2 KB (+13.4 KB) 17.5 KB (+15.4 KB)
host/assets/browser.js 22.9 KB (-10 B) 7.6 KB (-8 B) 8.6 KB (-9 B)
host/assets/client.js 100.1 KB (+6.9 KB) 29.5 KB (+2.0 KB) 32.4 KB (+2.2 KB)
host/assets/dist.js 39.0 KB (+14.2 KB) 12.8 KB (+5.1 KB) 14.5 KB (+5.9 KB)
host/assets/dotli-debug-bus.js 646 B (+151 B) 646 B (+151 B) 646 B (+151 B)
host/assets/get-sync-provider.js 2.8 KB 1.1 KB 1.2 KB
host/assets/hex.js 152 B 152 B 152 B
host/assets/index.css 44.8 KB (-3.1 KB) 7.1 KB (-382 B) 7.9 KB (-423 B)
host/assets/index.js 136.9 KB (+30.3 KB) 37.3 KB (+8.3 KB) 43.7 KB (+9.8 KB)
host/assets/manifest.js 22.5 KB (-133 B) 7.2 KB (-68 B) 7.9 KB (-67 B)
host/assets/panel.js 72.5 KB (-12.3 KB) 19.7 KB (-3.3 KB) 22.3 KB (-4.0 KB)
host/assets/paseo.smol-DboPaEh1.json 1.84 MB 941.7 KB 1019.4 KB
host/assets/paseo-people-next.smol.json 3.36 MB 1.68 MB 1.82 MB
host/assets/paseo.smol.json 25.4 KB 4.9 KB 5.6 KB
host/assets/previewnet.smol.json 1.88 MB 181.4 KB 353.0 KB
host/assets/resolve.js 128 B (-24 B) 128 B (-24 B) 128 B (-24 B)
host/assets/rpc-resolve.js 2.4 KB (-71 B) 1022 B (-35 B) 1.1 KB (-36 B)
host/assets/shared-mode.js 1.8 KB (-82 B) 751 B (-42 B) 852 B (-44 B)
host/assets/smoldot.js 2.98 MB 2.21 MB 2.22 MB
host/assets/smoldot_worker.js 2.95 MB 2.21 MB 2.21 MB
host/assets/src.js 1.8 KB (-119 B) 843 B (-45 B) 946 B (-55 B)
host/assets/styles.css 15.1 KB 3.2 KB 3.8 KB
host/assets/wasm/web/README.md 10.9 KB 10.9 KB 10.9 KB
host/assets/wasm/web/package.json 371 B 371 B 371 B
host/assets/wasm/web/truapi_server.d.ts 6.9 KB 6.9 KB 6.9 KB
host/assets/wasm/web/truapi_server.js 35.6 KB 6.2 KB 7.2 KB
host/assets/wasm/web/truapi_server_bg.wasm 1.96 MB 617.3 KB 812.7 KB
host/assets/wasm/web/truapi_server_bg.wasm.d.ts 2.5 KB 2.5 KB 2.5 KB
host/assets/web.js 13.2 KB 3.6 KB 4.0 KB
host/assets/worker-runtime.js 6.3 KB 1.6 KB 1.8 KB
host/assets/worker-runtime.js 106 B 106 B 106 B
host/assets/ws.js 23.1 KB (-2.8 KB) 7.5 KB (-882 B) 8.2 KB (-940 B)
host/dotli.png 11.5 KB 11.5 KB 11.5 KB
host/favicon.svg 1.8 KB 1.8 KB 1.8 KB
host/host-sw.js 2.7 KB (-110 B) 1.1 KB (+3 B) 1.2 KB (-17 B)
host/icon-192.png 12.5 KB 12.5 KB 12.5 KB
host/icon-512.png 42.8 KB 42.8 KB 42.8 KB
host/index.html 19.9 KB (-320 B) 4.4 KB (-79 B) 5.4 KB (-76 B)
host/manifest.webmanifest 441 B 441 B 441 B
host/workbox.js 14.8 KB 4.6 KB 5.1 KB
sandbox/app-sw.js 9.6 KB 3.1 KB (-10 B) 3.5 KB (-1 B)
sandbox/assets/bitswap-bridge.js 840 B 840 B 840 B
sandbox/assets/fetch.js 3.4 KB 1.2 KB (-2 B) 1.4 KB (-2 B)
sandbox/assets/index.css 44.8 KB (-3.1 KB) 7.1 KB (-382 B) 7.9 KB (-423 B)
sandbox/assets/index.js 118.0 KB 33.8 KB (+75 B) 39.6 KB (-2 B)
sandbox/favicon.svg 1.8 KB 1.8 KB 1.8 KB
sandbox/index.html 1.7 KB 579 B 785 B (-1 B)
Total 15.88 MB (+5.09 MB) 8.11 MB (+2.87 MB) (-49%) 8.73 MB (+3.08 MB)

Commit: 0884d33

@github-actions

Copy link
Copy Markdown
Contributor

E2E Product suite failed on 902e79c4faf67e5b274be0570e05586aca36e400 — 9 passed, 36 failed, 17 skipped.

Failed tests:

  • Get Product Account
  • Product Signer
  • Product Account Alias
  • Request Login
  • Get User Identity
  • Derive Entropy
  • StatementStore Allowance
  • Bulletin Allowance
  • Smart-Contract Allowance
  • All Allowances
  • String Write & Read
  • Bytes Write & Read
  • JSON Write & Read
  • Factory
  • Feature Check
  • Remote: HTTP/WS
  • Remote: WebRTC
  • Remote: Chain Submit
  • Remote: Preimage Submit
  • Remote: Statement Submit
  • Create Proof Authorized
  • Submit
  • HTTP URL
  • Polkadot URL
  • Chain Spec: Genesis Hash
  • Chain Spec: Chain Name
  • Chain Spec: Properties
  • Query Balance
  • Query Stored Value
  • Query Data Length
  • Query Balance
  • Query Total Deposits
  • Factory
  • Submit
  • Push Notification
  • Sign Raw Message

Logs: https://github.com/paritytech/dotli-community/actions/runs/29782805042
Artifacts: e2e-product-results (uploaded above) — open the failed test's trace.zip with npx playwright show-trace.

@pgherveou
pgherveou marked this pull request as draft July 23, 2026 14:03
Base automatically changed from codex/bulletin-preimage-in-core-dotli to main July 24, 2026 01:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant