All lessons · CKB node, RPC and indexer · Start here · Glossary
Gating the Terminal RPC module on CKB version including prereleasesWorkingFrom one fix
From one fix · Check: right · Checked 2026-11-21
The Terminal RPC module first shipped in CKB 0.205.0, and older binaries refuse to start when rpc.modules in ckb.toml lists it (serde unknown variant), so a tool should only enable it for binaries at or above that version. When gating, 0.205.0 release candidates already carry the module but semver.gte('0.205.0-rc1', '0.205.0') is false. Use semver.satisfies(v, '>=0.205.0-0', { includePrerelease: true }) so that 0.205.0 rc builds and prereleases of newer versions pass while 0.204.x still fails.
Why it matters: Without prerelease-aware gating, offckb strips the Terminal module from the devnet config for 0.205.0 rc builds that support it, and the system-metric panels of offckb status (ckb-tui) lose functionality.
Version gating that must accept prerelease CKB builds; not covered by existing lessons.
Pattern
return semver.satisfies(ckbVersion, `>=${TERMINAL_RPC_MIN_CKB_VERSION}-0`, { includePrerelease: true });Taken from the commit, shortened.
A test changed in the same commit
It sits next to the fix. We did not run it.
- ckb-devrel/offckb:
tests/ckb-tui-install.test.ts,tests/init-chain.test.ts,tests/logs-command.test.ts,tests/logs.test.ts,tests/proxy-events.test.ts
- Concepts
- Network and RPC reliability, Testing and devnet
- Evidence
- From one fix: from one project, checked against its commit
- First seen
- 2026-08-03
- Last changed
- 2026-08-03
- Last checked
- 2026-11-21
- Check against the commit
- right: the lesson follows from its commit and still holds in the code today
Sources (1)
- 2026-08-03 · ckb-devrel/offckb · more from this project
More about CKB node, RPC and indexer
- get_transaction returns an object with a null transaction for rejected and unknown txs
- CKB log subscription notifications may carry params.result as a JSON string
- Simulating a real CKB reorg with two devnet nodes over P2P
Do you maintain a project this lesson came from? Confirm or correct it
Cite this lesson
LusoCryptoLabs, "Gating the Terminal RPC module on CKB version including prereleases", CKB lessons, https://pulse.lusocryptolabs.com/learned/node/gating-the-terminal-rpc-module-on-ckb-version-including-prer, CC BY 4.0, last changed 2026-08-03.