paritytech / paritytech/host-rust-core
truapi-host: make the development product identity contract explicit
Nobody has claimed this yet.
- Dominant language
- Swift
- Stars
- 10
- Forks
- 3
- Avg merge
- 1d 10h
- Merged PRs (30d)
- 148
Description
Part of #517.
Context
truapi-host dev derives localhost:<app-port> as the product id. That is correct only when the product uses its local-origin identity. A locally served version of a deployed .dot product must pass its production product id to the host and use the same value in the app.
The host derives the product account from the product id and refuses to sign for any other one, so a mismatch surfaces late, as a PermissionDenied on the first signature. Current documentation also contains contradictory claims about whether host and app configuration can drift.
Required behavior
- Documentation distinguishes local-origin products from deployed
.dotproducts. - Examples show
--product-id dim2.dotand the matching product-side identity. - Startup output shows the product identity being served.
- A product-id mismatch is reported at the earliest observable point, with an identity-specific diagnostic rather than a generic permission error.
- Documentation no longer claims that host and app configuration cannot drift.
Related: #515.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with the truapi-host dev entry point and the documentation work tracked in #517, then compare the local-origin and deployed .dot cases described here. The work is done when examples use a matching --product-id dim2.dot, startup output exposes the identity, mismatches produce an identity-specific early diagnostic, and contradictory drift claims are removed.
Written by the indexing model from the issue text.
Assessment
- Domain
- api, backend, documentation
- Issue type
- Feature
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 45/100