Skip to content

docs: sync with ckb v0.207.0#827

Merged
yfeng2824 merged 3 commits into
nervosnetwork:developfrom
humble-little-bear:autopilot/ckb-v0.207.0-docs-sync
Jun 17, 2026
Merged

docs: sync with ckb v0.207.0#827
yfeng2824 merged 3 commits into
nervosnetwork:developfrom
humble-little-bear:autopilot/ckb-v0.207.0-docs-sync

Conversation

@humble-little-bear

@humble-little-bear humble-little-bear commented Jun 15, 2026

Copy link
Copy Markdown
Contributor

This PR syncs the Nervos CKB documentation with the upstream ckb v0.207.0 release (2026-06-10). The previous recorded release was v0.206.0, so the diff range is v0.206.0...v0.207.0.

Changes applied

CKB change Docs file What changed
script/src/syscalls/load_header.rs: load_header now treats unconfirmed tx-pool Cells (PoolCell) as missing and returns CKB_ITEM_MISSING instead of panicking. website/docs/script/syscalls-for-script.mdx Updated ckb_load_header description to note CKB_ITEM_MISSING for unconfirmed Cells.
script/src/syscalls/load_block_extension.rs: same CKB_ITEM_MISSING behavior for unconfirmed tx-pool Cells. website/docs/script/syscalls-for-script.mdx Updated ckb_load_extension description to note CKB_ITEM_MISSING for unconfirmed Cells.
docs/devnet-from-existing-data.md: split Mainnet/Testnet [params] examples; Mainnet requires genesis_epoch_length = 1743, Testnet keeps the default 1000. website/docs/node/run-devnet-node.mdx Added a note under the epoch-length section explaining that devnets initialized from existing Mainnet/Testnet data must preserve the source chain's genesis_epoch_length.

Release diff reference

  • Full compare: nervosnetwork/ckb@v0.206.0...v0.207.0
  • Key files reviewed:
    • script/src/syscalls/load_header.rs
    • script/src/syscalls/load_block_extension.rs
    • docs/devnet-from-existing-data.md
    • rpc/README.md (only a grammar fix; no docs.nervos.org page references this text)
    • rpc/src/util/fee_rate.rs (internal overflow/robustness fix; no user-facing RPC change)
    • util/constant/src/default_assume_valid_target.rs / latest_assume_valid_target.rs (assume-valid target updates; not documented on docs.nervos.org)

Items needing manual confirmation

  • None of the RPC grammar changes in rpc/README.md / util/jsonrpc-types/src/indexer.rs are reflected on docs.nervos.org because the site does not currently include the generated RPC type descriptions. If a dedicated RPC reference page is added later, the phrasing "An array representing..." should be used.
  • The rpc/src/server.rs HTTP timeout status-code change and the fee_rate.rs internal averaging fix are implementation details with no visible configuration or RPC contract change, so they are not documented here.

Breaking / high-priority notes

  • Script behavior: ckb_load_header and ckb_load_extension now return CKB_ITEM_MISSING (error code 2) for unconfirmed tx-pool Cells instead of aborting the VM. Scripts that previously relied on the abort behavior should handle CKB_ITEM_MISSING explicitly.

Autopilot record

.autopilot/last_ckb_release.txt is updated to v0.207.0.

- Document CKB_ITEM_MISSING behavior for load_header/load_extension on
  unconfirmed tx-pool cells (script/src/syscalls/load_header.rs,
  script/src/syscalls/load_block_extension.rs).
- Add devnet-from-existing-data genesis_epoch_length note for Mainnet/Testnet
  (docs/devnet-from-existing-data.md).
- Record last processed CKB release as v0.207.0.
@vercel

vercel Bot commented Jun 15, 2026

Copy link
Copy Markdown

@humble-little-bear is attempting to deploy a commit to the CKBA-2026 Team on Vercel.

A member of the Team first needs to authorize it.

@vercel

vercel Bot commented Jun 15, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
nervos-ckb-docs Ready Ready Preview, Comment Jun 16, 2026 6:38am

Request Review

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates docs.nervos.org to match the upstream CKB v0.207.0 release, primarily documenting updated syscall behavior around tx-pool (unconfirmed) Cells and clarifying devnet initialization requirements when reusing Mainnet/Testnet data.

Changes:

  • Documented that ckb_load_header and ckb_load_extension return CKB_ITEM_MISSING for unconfirmed tx-pool Cells (instead of aborting).
  • Added guidance that devnets initialized from existing Mainnet/Testnet data must preserve the source chain’s genesis_epoch_length to avoid genesis hash mismatches.
  • Bumped the autopilot tracked upstream release to v0.207.0.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 3 comments.

File Description
website/docs/script/syscalls-for-script.mdx Updates syscall table descriptions to reflect CKB_ITEM_MISSING behavior for unconfirmed tx-pool Cells.
website/docs/node/run-devnet-node.mdx Adds a note warning about genesis_epoch_length requirements when initializing from Mainnet/Testnet data.
.autopilot/last_ckb_release.txt Records the synced upstream CKB version as v0.207.0.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread website/docs/script/syscalls-for-script.mdx Outdated
Comment thread website/docs/script/syscalls-for-script.mdx Outdated
Comment thread website/docs/node/run-devnet-node.mdx Outdated
- Remove internal Rust type name 'PoolCell' from syscall descriptions.
- Use 'devnet' consistently instead of 'dev chain'.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@yfeng2824
yfeng2824 merged commit beef689 into nervosnetwork:develop Jun 17, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants