feat(truapi-server): add platform runtime and host bridge by pgherveou · Pull Request #250 · paritytech/truapi

pgherveou · 2026-06-30T21:51:57Z

Summary

Adds the Rust server runtime layer for product-host execution: product runtime state, session/auth orchestration, SSO pairing/signing flows, chain/preimage/statement-store plumbing, subscriptions, and host-core dispatch integration.

This layer also fixes the runtime permission/lifecycle issues found during review:

remote chain/preimage/statement submit paths require product-scoped permission before backend calls
get_user_id requires cached identity-disclosure consent
login single-flight state is cleared if pairing is aborted
runtime disposal cancels active subscriptions
permission state is documented with an ASCII product-to-host flow diagram

Stack

Part of the Rust core runtime port umbrella #104. Full port sequence:

feat(truapi): add testing API and versioned wiring #248 - layer 1/9, merged historical: truapi testing API and versioned wiring.
feat(truapi-platform): add host capability traits #249 - layer 2/9, merged historical: truapi-platform host capability traits.
feat(truapi-codegen): emit Rust dispatcher, wire table, and host callbacks #254 - layer 3/9, merged historical: codegen Rust dispatcher, wire table, and host callbacks.
feat(truapi-server): add host logic primitives #255 - layer 4/9, merged historical: server host logic primitives.
feat(truapi-server): add wire and chain infrastructure #256 - layer 5/9, merged historical: server wire and chain infrastructure.
👉 feat(truapi-server): add platform runtime and host bridge #250 - active layer 1/4: server runtime, permissions, lifecycle, and permission-flow docs. This PR.
feat(codegen): generate wasm bridge callbacks #265 - active layer 2/4: generic wasm bridge/codegen layer.
feat(host-wasm): add @parity/truapi-host-wasm runtime #252 - active layer 3/4: @parity/truapi-host-wasm namespaced callback consumer.
chore: docs, CI, tooling, and dotli integration for the Rust core #253 - active layer 4/4, top: docs, CI/tooling, playground, and dotli integration.

Active child #253 is kept tree-equivalent with umbrella #104.

Validation

cargo fmt --all --check
cargo check -p truapi-server
cargo test -p truapi-codegen golden_host_callbacks_ts
cargo test -p truapi-server

Adds the canonical testing module (api/testing.rs) and its v01/v02/versioned wiring used by the Rust host runtime and generated clients.

New crate defining the host syscall traits (storage, navigation, consent, permissions, ...) that host runtimes implement. Types are re-exported from truapi::versioned/v01 rather than redefined.

…ver-wire-chain

…er-runtime

Gate identity disclosure and remote submit paths through product-scoped permission state, and cancel pending lifecycle work on abort/dispose.

pgherveou · 2026-07-06T07:22:17Z

+    /// Product-scoped permission to disclose the user's primary identity.
+    IdentityDisclosure,


Temp, maybe we should not add it right now and define it in an RFC first.
cc @filvecchiato what do you think

pgherveou force-pushed the rust-core/02-platform-traits branch from 4b83619 to 4843b5c Compare June 30, 2026 22:10

pgherveou force-pushed the rust-core/03-server-runtime branch 2 times, most recently from 8cceb16 to 36e81a5 Compare June 30, 2026 22:12

pgherveou force-pushed the rust-core/02-platform-traits branch from 4843b5c to df4a0ba Compare June 30, 2026 22:15

pgherveou force-pushed the rust-core/03-server-runtime branch from 36e81a5 to b7c0a12 Compare June 30, 2026 22:17

feat(truapi): add testing API and versioned wiring

8e0e71f

Adds the canonical testing module (api/testing.rs) and its v01/v02/versioned wiring used by the Rust host runtime and generated clients.

pgherveou force-pushed the rust-core/03-server-runtime branch from b7c0a12 to c28f271 Compare July 1, 2026 06:39

pgherveou force-pushed the rust-core/02-platform-traits branch from df4a0ba to 1a7d349 Compare July 1, 2026 06:39

pgherveou force-pushed the rust-core/03-server-runtime branch from c28f271 to 71a3f71 Compare July 1, 2026 08:14

pgherveou mentioned this pull request Jul 1, 2026

feat(truapi-codegen): emit Rust dispatcher, wire table, and host callbacks #254

Merged

pgherveou changed the base branch from rust-core/02-platform-traits to rust-core/04-codegen July 1, 2026 08:17

pgherveou force-pushed the rust-core/03-server-runtime branch from 71a3f71 to 195a6b7 Compare July 1, 2026 09:26

pgherveou changed the base branch from rust-core/04-codegen to rust-core/04b-server-wire-chain July 1, 2026 09:27

pgherveou changed the title ~~feat(truapi-server): add Rust host runtime~~ feat(truapi-server): add platform runtime and host bridge Jul 1, 2026

This was referenced Jul 1, 2026

feat(truapi-server): add host logic primitives #255

Merged

feat(truapi-server): add wire and chain infrastructure #256

Merged

fixup! feat(truapi): add testing API and versioned wiring

dea080a

pgherveou force-pushed the rust-core/03-server-runtime branch from 195a6b7 to 538cb2e Compare July 1, 2026 20:38

pgherveou force-pushed the rust-core/04b-server-wire-chain branch from 4567da7 to 26cc238 Compare July 1, 2026 20:38

fixup! feat(truapi): add testing API and versioned wiring

3409152

pgherveou force-pushed the rust-core/03-server-runtime branch from 538cb2e to 3e7a360 Compare July 1, 2026 21:23

pgherveou force-pushed the rust-core/04b-server-wire-chain branch from 26cc238 to 937d576 Compare July 1, 2026 21:23

pgherveou added 2 commits July 2, 2026 10:10

fixup! feat(truapi): add testing API and versioned wiring

0569aaf

feat(truapi-platform): add host capability traits

8c93e99

New crate defining the host syscall traits (storage, navigation, consent, permissions, ...) that host runtimes implement. Types are re-exported from truapi::versioned/v01 rather than redefined.

pgherveou added 4 commits July 3, 2026 17:26

fixup! feat(truapi-server): add platform runtime and host bridge

80ff2c7

fixup! feat(truapi-server): add platform runtime and host bridge

c6091f0

fixup! feat(truapi-server): add wire and chain infrastructure

e4d9a0d

fixup! feat(truapi-server): add platform runtime and host bridge

7ac562a

pgherveou force-pushed the rust-core/04b-server-wire-chain branch from 2a75bee to e4d9a0d Compare July 3, 2026 15:32

pgherveou force-pushed the rust-core/03-server-runtime branch from b0c161b to 7ac562a Compare July 3, 2026 15:32

pgherveou added 9 commits July 3, 2026 18:22

Merge origin/main into rust-core/04-codegen

dab5395

Merge branch 'rust-core/04-codegen' into rust-core/04a-server-host-logic

15e1594

docs(host-logic): link host-spec sections

54f0b20

Merge branch 'rust-core/04a-server-host-logic' into rust-core/04b-ser…

2da3da5

…ver-wire-chain

Merge branch 'rust-core/04b-server-wire-chain' into rust-core/03-serv…

f7b2424

…er-runtime

docs(runtime): link host-spec sections

ac7992f

fixup! feat(truapi-server): add wire and chain infrastructure

cda27e1

Merge branch 'rust-core/04b-server-wire-chain' into rust-core/03-serv…

227f47c

…er-runtime

fixup! feat(truapi-server): add platform runtime and host bridge

8bd9085

Base automatically changed from rust-core/04b-server-wire-chain to main July 3, 2026 20:49

pgherveou requested a review from a team July 3, 2026 20:49

pgherveou added 4 commits July 3, 2026 22:53

Merge branch 'main' into rust-core/03-server-runtime

ba2571a

fix(server): enforce runtime permissions

b804d04

Gate identity disclosure and remote submit paths through product-scoped permission state, and cancel pending lifecycle work on abort/dispose.

fix(server): include runtime crate in workspace

5de806e

docs(server): describe permission flow

0d304f8

pgherveou mentioned this pull request Jul 6, 2026

feat(codegen): generate wasm bridge callbacks #265

Open

pgherveou commented Jul 6, 2026

View reviewed changes

pgherveou added 7 commits July 6, 2026 09:28

test(server): wait for auth sync callback

1735b8a

test(server): make pairing snapshot test deterministic

f421258

chore(stack): move wasm bridge out of runtime layer

7190552

fixup! feat(truapi-server): add platform runtime and host bridge

5fbf0b3

fixup! feat(truapi-server): add platform runtime and host bridge

95516f7

fixup! feat(truapi-server): add platform runtime and host bridge

86ffc19

fixup! feat(truapi-server): add platform runtime and host bridge

98b1023

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat(truapi-server): add platform runtime and host bridge#250

feat(truapi-server): add platform runtime and host bridge#250
pgherveou wants to merge 47 commits into
mainfrom
rust-core/03-server-runtime

pgherveou commented Jun 30, 2026 •

edited

Loading

Uh oh!

pgherveou Jul 6, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

		/// Product-scoped permission to disclose the user's primary identity.
		IdentityDisclosure,

Uh oh!

Conversation

pgherveou commented Jun 30, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Stack

Validation

Uh oh!

pgherveou Jul 6, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

pgherveou commented Jun 30, 2026 •

edited

Loading