Skip to content

docs: fix testnet version pins and eth_blockNumber verification wording - #306

Open
kutluhaneth46 wants to merge 2 commits into
circlefin:mainfrom
kutluhaneth46:docs/operator-guide-version-and-blocknumber-fixes
Open

docs: fix testnet version pins and eth_blockNumber verification wording#306
kutluhaneth46 wants to merge 2 commits into
circlefin:mainfrom
kutluhaneth46:docs/operator-guide-version-and-blocknumber-fixes

Conversation

@kutluhaneth46

Copy link
Copy Markdown

Summary

Operator documentation fixes — three stale or incorrect items that mislead node runners:

  1. installation.md — Arc Testnet version table and arcup example still pointed at v0.6.0; updated to v0.8.0 (current release; Zero8 activates on testnet 2026-09-03 per CHANGELOG).
  2. running-an-arc-node.md — "Verify operation" claimed eth_blockNumber returns the next block height and documented a broken printf "%0d" conversion; aligned with the Docker verify section and osr21's guidance on docs: node verification guide incorrectly describes eth_blockNumber as returning the next block height #272.
  3. docker-compose.yml — header comment examples updated from 0.6.0 to 0.8.0.

Fixes #272, #225, #235.

Validation

  • Docs-only change
  • Wording matches Docker "Verify" section for eth_blockNumber
  • Version matches CHANGELOG v0.8.0

Test plan

  • Version table and arcup example consistent
  • Bare-metal verify prose matches Docker verify section
  • docker-compose comment examples match current release tag

@osr21

osr21 commented Sep 1, 2026

Copy link
Copy Markdown

Verified all three content changes against the repo, CHANGELOG, and live behavior — the substance is correct, and one part is genuinely time-critical. But the PR overlaps two open PRs, one of them already approved, and would benefit from dropping one hunk.

Content verification

Overlaps (the actionable part)

  1. deployments/docker-compose.yml hunk conflicts with approved docs: use $ARC_VERSION in docker-compose.yml image comments #238 — merge-tested in both orders: textual conflict both ways, since both PRs rewrite the same two header-comment lines. docs: use $ARC_VERSION in docker-compose.yml image comments #238 (open since early August, approved) implements the $ARC_VERSION pattern that the docs: docker-compose.yml comment examples still reference v0.6.0 #235 discussion deliberately chose over a literal pin, precisely so these comments stop going stale each release. This PR's literal 0.8.0 re-introduces the drift cycle — the same one that let the installation table sit wrong through three releases. Suggest dropping the docker-compose hunk from this PR and letting docs: use $ARC_VERSION in docker-compose.yml image comments #238 close out docs: docker-compose.yml comment examples still reference v0.6.0 #235.
  2. docs/installation.md lines are the same two lines open docs: update Arc Testnet version to v0.7.3 in installation.md #226 edits (to v0.7.3, itself now stale). This PR supersedes docs: update Arc Testnet version to v0.7.3 in installation.md #226 on both counts; flagging so maintainers close one, or whichever lands second hits a conflict.
  3. No conflict with docs: mark separated-host RPC transport deprecated as of v0.8.0 #295 — merge-tested clean; the two PRs touch running-an-arc-node.md ~170 lines apart. No coordination needed there.

Slimmed to installation.md + running-an-arc-node.md, this lands two verified fixes (#272, #225) with no competing PR — and the version-table half is the one with a hard deadline tomorrow.

…eview)

Co-authored-by: Cursor <cursoragent@cursor.com>
@kutluhaneth46

Copy link
Copy Markdown
Author

Dropped the \deployments/docker-compose.yml\ hunk in fb6e7b9 — leaving that to approved #238 as you suggested. PR now only touches \installation.md\ +
unning-an-arc-node.md\ (#272, #225).

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.

docs: node verification guide incorrectly describes eth_blockNumber as returning the next block height

2 participants