ckb 0.203.0 (88d1126 2025-10-22)

[doitian]

Highlights

BREAKING: #4910 introduces breaking changes to the Rust SDK. There's a tool to migrate old codes: https://github.com/driftluo/ckb-gen-type-migrate

Compatibility Table

Network	Consensus Version	Minimal CKB Version
dev	ckb2023 since epoch 0
preview	ckb2023 since epoch 0	v0.119.0
testnet	ckb2023 since epoch 9,690	v0.119.0
mainnet	ckb2023 since epoch 12,293	v0.200.0

See how to connect to various chains in Wiki.

Default assume valid target

• Mainnet: 0x75832aee642a94a2f8cfebe566158f5a1592e8c7625a9f9daf845dbddd2cd7d7
• Testnet: 0xecdcb715a51a8e4e428231d8969bf473e2ba914d2c58ead0a65b892c68779822

Downloads

OS	Arch	Runtime Dependencies	Package	Sign
macOS	x64	macOS 10.15 or above	zip	PGP
macOS (Portable)	x64	macOS 10.15 or above	zip	PGP
macOS	ARM64	macOS 10.15 or above	zip	PGP
macOS (Portable)	ARM64	macOS 10.15 or above	zip	PGP
Linux	x64	glibc, libstdc++	tarball	PGP
Linux (Portable)	x64	glibc, libstdc++	tarball	PGP
CentOS	x64	glibc, libstdc++	tarball	PGP
CentOS (Portable)	x64	glibc, libstdc++	tarball	PGP
Windows	x64	VC++ Redistributable	zip	PGP
Linux	ARM64	glibc, libstdc++	tarball	PGP
Docker			dockerhub

Deprecation Notice: CentOS has reached its EOL, we will stop providing CentOS binaries in the future. Please use other platforms or build from source.

The .asc files are signatures. It is wise and more secure to check out for the files integrity.

Try the portable variants if the binaries complains about illegal instructions.

Changes since v0.202.0

Compare changes in GitHub

Features

• feat: hole punching protocol metrics #4891: Hole punching protocol metrics (@driftluo)
• feat: Add 2 outbound block-relay-only connections #4888: Add 2 outbound block-relay-only connections (@zhangsoledad)
• feat: impl from/into for gen-type #4910: Impl from/into for gen-type (@driftluo)
• feat: Enhance scriptHashType serialization logic #4920: Enhance scriptHashType serialization logic (@zhangsoledad)

Bug Fixes

• NetRpcImpl fix error handling for add_node and remove_node #4895: NetRpcImpl fix error handling for add_node and remove_node (@eval-exec)

Improvements

• dep: set strum default-features to false #4970: Set strum default-features to false (@eval-exec)

• rich-indexer: keep rocksdb SecondaryDB sync before read #4946: Rich-indexer: keep rocksdb SecondaryDB sync before read (@eval-exec)

• Limit the size of filters field in message BlockFilters in GetBlockFiltersProcess #4972: Limit the size of filters field in message BlockFilters in GetBlockFiltersProcess (@Officeyutong)

  This PR limits size of filters field to 1.8MB, to avoid the frame sended by tentacle being too large (reaches 2MB) causing full CKB nodes disconnects light-client nodes

---

This discussion was created from the release ckb 0.203.0 (88d1126 2025-10-22).

[joshyates1980]

Normally, when I upgrade from a previous version to new version, I will cut/paste the data folder into the new version folder after I ckb init from 0.202 to 0.203, but this process did not work this time. The blockchain does not ckb run --indexer, I tested 0.203 on two computers with same error. I moved the data folder back to 0.202 and ckb run and blockchain executes successfully. Any advice?

[joshyates1980]

After installed VC++, does CKB v0.203.0 run well on your Windows 10 environment??

currently, there is a very long execution of a database migration. I pause the script executing and notice commands such as TRACE ckb_proposal_table and DEBUG ckb_chain : : verify and TRACE ckb_notify.

Could you show the last few lines of log entries in ./data/logs/run.log?

the file is over 6 gigs, this takes a while to open with some programs? How do you normally open/read run.log?
Insert into database and query?

[doitian]

You can change back the log filter setting back to filter = "info", otherwise the log file will grow very fast.

[joshyates1980]

You can change back the log filter setting back to filter = "info", otherwise the log file will grow very fast.

As Nervos blockchain grows, are there any plans on possibly indexing or splitting up run.log? Unless run.log is inserted into a database for query, this file is almost impossible to read with editor programs. Notepad, Word, web browsers, etc. will not open the file or just crash.

[eval-exec]

As Nervos blockchain grows, are there any plans on possibly indexing or splitting up run.log?

We will consider, and external tools such as logrotate can help you manage the increasing log file size.

Unless run.log is inserted into a database for query, this file is almost impossible to read with editor programs. Notepad, Word, web browsers, etc. will not open the file or just crash.

Regarding Windows, I’m not very familiar with Windows OS, but you might try one of the editors listed here: Text editor to open huge files to view very large text files.

[joshyates1980]

The VC++ is the fix. I have another windows10 Surface device that successfully runs 0.203 now, which I upgraded this morning:

---