Skip to content

chore: update docs for cardano-node 11.x and current ecosystem state - #18

Merged
wcatz merged 4 commits into
masterfrom
chore/audit-2025-05
May 9, 2026
Merged

chore: update docs for cardano-node 11.x and current ecosystem state#18
wcatz merged 4 commits into
masterfrom
chore/audit-2025-05

Conversation

@wcatz

@wcatz wcatz commented May 9, 2026

Copy link
Copy Markdown

Summary

Comprehensive docs audit against Cardano Book World and current upstream sources (May 2025). Every guide that referenced building, downloading, or configuring a Cardano node has been brought up to date.

Key changes

  • Hardware requirements — mainnet RAM 16GB → 24GB/8GB (InMemory/OnDisk), storage 150GB → 300GB; added Raspberry Pi LSM crash warning for node 11.0.1
  • GitHub org — all input-output-hk/{cardano-node,libsodium}IntersectMBO; dead Hydra CI URLs replaced with book.world.dev.cardano.org and raw GitHub
  • GHC/Cabal (oracle-db-sync, oracle-ampere, m1-asahi-linux, arch-linux-os) — GHC 8.10.x → 9.6.7, Cabal 3.4/3.6 → 3.12.1.0; removed obsolete cardano-crypto-praos flag; added liburing-dev protobuf-compiler libsnappy-dev deps
  • Static binaries — all old .zip download commands updated to new .tar.zst format; versions bumped to 10.7.1
  • Dynamic binaries — marked as unmaintained past 8.2.1 with deprecation warnings redirecting to static build guide
  • blst — v0.3.10 → v0.3.15 (m1-asahi-linux)
  • Asahi Linux guide — title updated M1 → Apple Silicon; prereqs updated for M1–M4 and Fedora Asahi Remix; dead 2022 alpha blog link replaced
  • Conway eraconway-genesis.json added to all config download blocks
  • P2P topologyuseLedgerAfterSlot 79387772 → 185500763
  • ogmios — v6.3.0 → v6.14.0
  • Alpine — 1.35.0 → 10.7.1 with zstd extraction
  • Ubuntu — 22.04 → 24.04 in Pi tutorial download page
  • Docker guide — tag corrected 8.9.3 → 8.7.2 (last published); unmaintained warning added
  • Stake Pool School link — dead gitbook URL replaced with Cardano Course + Developer Portal
  • NFT guide — dead Hydra genesis downloads replaced with book.world.dev URLs

Files changed

20 files across docs/hardware, docs/cardano-developer-guides, and docs/stake-pool-guides.

Test plan

  • Verify all download URLs resolve (spot-check a few wget targets)
  • Confirm book.world.dev.cardano.org/environments/mainnet/conway-genesis.json is reachable
  • Confirm github.com/IntersectMBO/cardano-node and IntersectMBO/libsodium resolve
  • Confirm armada-alliance/cardano-node-binaries tarball filename matches
  • Build docs site locally and check for broken MDX/Docusaurus rendering

wcatz added 4 commits May 9, 2026 08:48
- Hardware: bump RAM to 24GB/8GB (InMemory/OnDisk), storage to 300GB,
  add Pi LSM crash warning for node 11.0.1
- All build guides: input-output-hk → IntersectMBO for cardano-node
  and libsodium repos; GHC 8.10.x → 9.6.7; Cabal 3.4/3.6 → 3.12.1.0;
  add liburing-dev protobuf-compiler libsnappy-dev deps; remove
  obsolete cardano-crypto-praos cabal flag
- blst: v0.3.10 → v0.3.15 (m1-asahi-linux)
- Asahi guide: update title/prereqs for M1–M4, link to current Fedora
  Asahi Remix release, remove 2022 alpha blog link
- Config downloads: replace dead Hydra URLs with book.world.dev.cardano.org
  and raw.githubusercontent.com/IntersectMBO; add conway-genesis.json;
  remove NODE_BUILD_NUM Hydra scrape from all guides
- Static build: 8.9.3 → 10.7.1 with new .tar.zst download format
- Dynamic build: mark as unmaintained past 8.2.1, add deprecation warning
- Docker guide: correct tag 8.9.3 → 8.7.2, add unmaintained warning
- ogmios: v6.3.0 → v6.14.0
- P2P topology: useLedgerAfterSlot 79387772 → 185500763
- Alpine: 1.35.0 → 10.7.1 static binary with new zstd tarball format
- Pi tutorial: replace dead Stake Pool School link; Ubuntu 22.04 → 24.04;
  replace dead Hydra cardano-wallet link with armada-alliance binaries repo
- NFT guide: replace dead Hydra genesis downloads with book.world.dev URLs
- two-testnets: remove vestigial NODE_BUILD_NUM; 8_1_1 → 10.7.1 tarball
@wcatz
wcatz merged commit e33b5e3 into master May 9, 2026
1 check 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.

1 participant