paritytech / paritytech/host-rust-core

RFC: Route Relay

Open
#481 0 comments 0 reactions 1 assignee View on GitHub

@pgherveou is already working on this.

Since Sep 11, 2026.

rfc
Dominant language
Swift
Stars
10
Forks
3
Avg merge
1d 10h
Merged PRs (30d)
148

Description

Source PR: #92 · docs/rfcs/0021-route-relay.md · @pgherveou

Description

host_route_get, host_route_set and host_route_changed relay an opaque route string between a product and the Host shell, so in-product navigation becomes deep-linkable, shareable and reload-stable.

Motivation

The address bar belongs to the Host, so a product's own pushState is invisible to the user, unshareable, and lost on reload. At bootstrap the product also cannot tell which sub-route the user opened.

Requirements

  • set mirrors push/replace; the empty string means home.
  • changed fires only for Host-side changes and must never echo the product's own set.
  • The route is opaque UTF-8; hosts may cap its length and rate-limit set.
  • No permission prompt.

Tasks

  • RFC document body
  • Implementation — rust-core
  • Implementation — hosts
    • dotli
    • Desktop
    • iOS
    • Android
    • host-cli

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.