Skip to content

docs: add a test host migration guide and correct the migration skill - #1918

Merged
TarikGul merged 5 commits into
mainfrom
docs/test-host-migration-guide
Nov 10, 2026
Merged

TarikGul merged 5 commits into
mainfrom
docs/test-host-migration-guide

Conversation

@decrypto21

@decrypto21 decrypto21 commented Nov 5, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Adds docs/migration/test-host.md, a guide for product teams moving their e2e suites from @parity/host-api-test-sdk to @parity/truapi-host/testing. It is linked from the README and the truapi-host README. Part of #1349.

The guide covers which stacks can move (@parity/truapi 0.24 or later, which is product-sdk-host 0.25 or product-sdk 0.34), the dependency swap, how each old fixture option, method, return shape and export maps across or why it is gone, funding the derived product account, and what needs 0.30.

.claude/skills/migrate-to-truapi-test-host/SKILL.md matches the code at 0.30. Where the old package changed between releases, each claim names the old versions it holds for.

docs/migration/README.md and product-sdk-truapi-migration.patch are removed. They described the product-sdk migration, which has landed in paritytech/product-sdk#435.

@github-actions github-actions Bot added the size:XL 500 to 999 lines changed; consider splitting label Nov 5, 2026
@github-actions

github-actions Bot commented Nov 5, 2026 •

Copy link
Copy Markdown
Contributor

Bundle size report

Compared with main at 5454b5a.

Raw Gzip Brotli
truapi-host 8.61 MiB 5.90 MiB 5.55 MiB
truapi-provider 4.04 MiB 1.27 MiB 962.0 KiB
truapi 8.32 MiB 1.16 MiB 967.6 KiB
trinity-stack 634.3 KiB 247.5 KiB 204.7 KiB
Total 21.58 MiB 8.58 MiB 7.64 MiB

WebAssembly modules

Raw Gzip Brotli
truapi-host/wasm/web/truapi_server_bg.wasm 3.48 MiB 1.20 MiB 915.8 KiB
truapi-host/wasm/web/truapi_verifiable_bg.wasm 4.89 MiB 4.64 MiB 4.61 MiB
truapi-provider/truapi_provider_bg.wasm 3.99 MiB 1.26 MiB 954.2 KiB
trinity-stack/wasm/trinity_stack_bg.wasm 564.5 KiB 230.5 KiB 190.0 KiB

No file changed size.

Commit: b9d5d46

@github-actions

github-actions Bot commented Nov 5, 2026 •

Copy link
Copy Markdown
Contributor

CI Status: 24 required jobs green, 16 passed and 8 skipped by path filter.

All job results
job result
android-app skipped
android-bindings skipped
bundle-size success
changes success
changeset-guard skipped
cli-package skipped
codegen success
e2e skipped
explorer success
headless-install success
host-wasm success
ios-app skipped
ios-bindings success
licenses success
playground success
provider-android-bindings skipped
release-guard success
rust success
ts-client success
ts-debugger success
ts-host success
ts-trinity-stack success
wasm-provider success
workflow-lint skipped

Signing credentials: valid as of 2026-11-10

Commit b9d5d46d · run log

@decrypto21
decrypto21 marked this pull request as ready for review November 5, 2026 12:56
@decrypto21
decrypto21 requested review from a team as code owners November 5, 2026 12:56
@github-actions github-actions Bot added the status:waiting-on-review Ready for a reviewer label Nov 5, 2026
decrypto21 and others added 3 commits November 6, 2026 13:20
…ion-guide

# Conflicts:
#	.claude/skills/migrate-to-truapi-test-host/SKILL.md
…ion-guide

# Conflicts:
#	.claude/skills/migrate-to-truapi-test-host/SKILL.md
…package

Cover the old boot options (executionKind, initialState, behaviors), the
connection status, theme, storage and DEV_ACCOUNTS shape changes, the
grantPermission signature, and the missing eve and ferdie accounts. Qualify the
login, simulateDisconnect and payment claims that hold only for the old package
up to 0.12, fix the codec versions and the getSentRpc naming, and drop merge
history from the skill.

Remove docs/migration/README.md and its patch, which described the product-sdk
migration that has since landed and contradicted the guide, and link the guide
from the top-level and truapi-host READMEs.
@github-actions github-actions Bot added size:XXL 1000 lines or more; split it, or say in the description why it cannot be and removed size:XL 500 to 999 lines changed; consider splitting labels Nov 10, 2026
Note that seedProductStorage and productStorage take the product's own key,
add the product-sdk versions to the stack table, and say a shared hostUrl
server takes no options. Move login approval beside signing out, introduce
allowances, funding and readyTimeoutMs, map initialState.supportedChains, and
give the step 3 example its imports.

Scope the old-package claims to the versions they hold for (statement shape,
alice.01, DEV_ACCOUNTS), drop the TransactionSubmit and ChainConfig renames no
current suite uses, align the deep link wording, and rewrap the skill.
@github-actions github-actions Bot added status:ready-to-merge Approved and waiting only to be queued and removed status:waiting-on-review Ready for a reviewer labels Nov 10, 2026
@TarikGul
TarikGul added this pull request to the merge queue Nov 10, 2026
Merged via the queue into main with commit 4eb970e Nov 10, 2026
42 checks passed
@TarikGul
TarikGul deleted the docs/test-host-migration-guide branch November 10, 2026 21:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size:XXL 1000 lines or more; split it, or say in the description why it cannot be status:ready-to-merge Approved and waiting only to be queued

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants