Skip to content

Conversation

@jasperpotts
Copy link
Contributor

@jasperpotts jasperpotts commented Oct 17, 2025

PR for work on command line tools for processing record file history.

This pull request introduces several documentation improvements and project configuration updates, focusing on clearer build instructions, coding conventions, and more accurate references to the tools module. It also adds new experimental protobuf definitions for block streaming and proof structures.

Documentation and Reference Improvements:

  • Added a comprehensive BUILDING.md file at the project root, detailing prerequisites, common build tasks, and module-specific instructions for building and running each app/module.
  • Updated references to the tools module in README.md and docs/overview.md to use correct relative links, improving navigation and accuracy. [1] [2]
  • Removed outdated or redundant documentation files in docs/tools/, including README.md and quickstart.md, streamlining and centralizing documentation. [1] [2]

Project Configuration and Coding Standards:

  • Added .github/copilot-instructions.md to provide explicit, actionable guidance for Copilot-generated Java code, covering file headers, import ordering, Javadoc, naming conventions, formatting, logging, tests, and usage of modern Java APIs.
  • Updated .editorconfig to set the default indentation size to 4 spaces, aligning with the documented coding standards.

Protobuf Definitions for Experimental Block Streaming:

  • Added experimental_block.proto defining the Block message, with detailed comments on block structure, usage, and RFC keyword interpretation.
  • Added experimental_block_footer.proto defining the BlockFooter message, describing root hashes for block verification and state, with RFC-style documentation.

@jasperpotts jasperpotts self-assigned this Oct 22, 2025
@jasperpotts jasperpotts force-pushed the 1736-add-blockchain-cli-tools branch from 8cd3741 to 70b0961 Compare January 21, 2026 02:21
@rockysingh rockysingh added the Block Node Tools Additional tools related to, but not part of, the Block Node label Jan 21, 2026
@jasperpotts jasperpotts changed the title 1736 add blockchain cli tools fix: 1736 add blockchain cli tools Jan 23, 2026
@jasperpotts jasperpotts marked this pull request as ready for review January 23, 2026 19:36
@jasperpotts jasperpotts requested review from a team as code owners January 23, 2026 19:36
Signed-off-by: Jasper Potts <1466205+jasperpotts@users.noreply.github.com>
… for AI

Signed-off-by: Jasper Potts <1466205+jasperpotts@users.noreply.github.com>
Signed-off-by: Jasper Potts <1466205+jasperpotts@users.noreply.github.com>
Signed-off-by: Jasper Potts <1466205+jasperpotts@users.noreply.github.com>
Signed-off-by: Jasper Potts <1466205+jasperpotts@users.noreply.github.com>
Signed-off-by: Jasper Potts <1466205+jasperpotts@users.noreply.github.com>
Signed-off-by: Jasper Potts <1466205+jasperpotts@users.noreply.github.com>
Signed-off-by: Jasper Potts <1466205+jasperpotts@users.noreply.github.com>
Signed-off-by: Jasper Potts <1466205+jasperpotts@users.noreply.github.com>
Signed-off-by: Jasper Potts <1466205+jasperpotts@users.noreply.github.com>
Signed-off-by: Jasper Potts <1466205+jasperpotts@users.noreply.github.com>
Signed-off-by: Jasper Potts <1466205+jasperpotts@users.noreply.github.com>
Signed-off-by: Jasper Potts <1466205+jasperpotts@users.noreply.github.com>
Signed-off-by: Jasper Potts <1466205+jasperpotts@users.noreply.github.com>
Signed-off-by: Jasper Potts <1466205+jasperpotts@users.noreply.github.com>
Signed-off-by: Jasper Potts <1466205+jasperpotts@users.noreply.github.com>
Signed-off-by: Jasper Potts <1466205+jasperpotts@users.noreply.github.com>
Signed-off-by: Jasper Potts <1466205+jasperpotts@users.noreply.github.com>
jasperpotts and others added 23 commits January 23, 2026 11:38
Signed-off-by: Jasper Potts <1466205+jasperpotts@users.noreply.github.com>
Signed-off-by: Jasper Potts <1466205+jasperpotts@users.noreply.github.com>
Signed-off-by: Jasper Potts <1466205+jasperpotts@users.noreply.github.com>
…kle tree

Signed-off-by: Jasper Potts <1466205+jasperpotts@users.noreply.github.com>
Signed-off-by: Jasper Potts <1466205+jasperpotts@users.noreply.github.com>
Signed-off-by: Jasper Potts <1466205+jasperpotts@users.noreply.github.com>
…rough all the CLI tools

Signed-off-by: Jasper Potts <1466205+jasperpotts@users.noreply.github.com>
Signed-off-by: Jasper Potts <1466205+jasperpotts@users.noreply.github.com>
…ixed bigs in date parsing and added unit tests for RecordFileDates.

Signed-off-by: Jasper Potts <1466205+jasperpotts@users.noreply.github.com>
… to downloads in MainNetBucket

Signed-off-by: Jasper Potts <1466205+jasperpotts@users.noreply.github.com>
Signed-off-by: Jasper Potts <1466205+jasperpotts@users.noreply.github.com>
…kchain. Cleaned up and refined the wrapping

Signed-off-by: Jasper Potts <1466205+jasperpotts@users.noreply.github.com>
Signed-off-by: Jasper Potts <1466205+jasperpotts@users.noreply.github.com>
Signed-off-by: Jasper Potts <1466205+jasperpotts@users.noreply.github.com>
… based on mistake Matt spotted

Signed-off-by: Jasper Potts <1466205+jasperpotts@users.noreply.github.com>
…n with Validation, Daily Tar Archives, and Automatic Rollover (#1973)

Signed-off-by: Rocky Thind <harpender.t@swirldslabs.com>
Signed-off-by: Jasper Potts <1466205+jasperpotts@users.noreply.github.com>
Signed-off-by: Rocky Thind <harpender.t@swirldslabs.com>
Signed-off-by: Jasper Potts <1466205+jasperpotts@users.noreply.github.com>
…lidation with stats - added performance improvement to download-live and added new download-live2 with different techniques (#1991)

Signed-off-by: Rocky Thind <harpender.t@swirldslabs.com>
Signed-off-by: Jasper Potts <1466205+jasperpotts@users.noreply.github.com>
…gic (#2009)

Signed-off-by: Rocky Thind <harpender.t@swirldslabs.com>
Signed-off-by: Jasper Potts <1466205+jasperpotts@users.noreply.github.com>
Signed-off-by: Jasper Potts <1466205+jasperpotts@users.noreply.github.com>
Signed-off-by: Jasper Potts <1466205+jasperpotts@users.noreply.github.com>
Signed-off-by: Jasper Potts <1466205+jasperpotts@users.noreply.github.com>
Signed-off-by: Rocky Thind <harpender.t@swirldslabs.com>
Signed-off-by: Jasper Potts <1466205+jasperpotts@users.noreply.github.com>
@jasperpotts jasperpotts force-pushed the 1736-add-blockchain-cli-tools branch from 2a84b1c to 0172d3b Compare January 23, 2026 19:38
@jasperpotts jasperpotts added this to the 0.27.0 milestone Jan 23, 2026
Signed-off-by: Jasper Potts <1466205+jasperpotts@users.noreply.github.com>
Signed-off-by: Jasper Potts <1466205+jasperpotts@users.noreply.github.com>
Signed-off-by: Jasper Potts <1466205+jasperpotts@users.noreply.github.com>
@codecov
Copy link

codecov bot commented Jan 23, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.

@@             Coverage Diff              @@
##               main    #1769      +/-   ##
============================================
+ Coverage     80.38%   80.68%   +0.29%     
- Complexity     1389     1390       +1     
============================================
  Files           137      137              
  Lines          6471     6471              
  Branches        707      707              
============================================
+ Hits           5202     5221      +19     
+ Misses          960      942      -18     
+ Partials        309      308       -1     

see 2 files with indirect coverage changes

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Block Node Tools Additional tools related to, but not part of, the Block Node

Projects

Status: Todo

Development

Successfully merging this pull request may close these issues.

3 participants