Skip to content

Conversation

@mkysel
Copy link
Collaborator

@mkysel mkysel commented May 23, 2025

Replace hardcoded 1000-block backfill size with configurable block size parameter in RpcLogStreamer

Introduces configurable block size for blockchain log backfilling through:

  • Adds backfillBlockSize field to RpcLogStreamer in rpcLogStreamer.go with new WithBackfillBlockSize option function
  • Adds BackfillBlockSize configuration option in options.go with CLI flag and environment variable support
  • Modifies NewAppChain in app_chain.go to accept block size parameter
  • Updates GetNextPage method to use configurable block size instead of hardcoded 1000-block constant

📍Where to Start

Start with the RpcLogStreamer struct and WithBackfillBlockSize option function changes in rpcLogStreamer.go, which define the core functionality for configurable block sizes.


Macroscope summarized db8f348.

Summary by CodeRabbit

  • New Features

    • Added support for configuring the backfill block size for blockchain log streaming, allowing users to customize this value via command-line options or environment variables.
  • Chores

    • Updated default backfill block size to 500 and ensured consistent configuration across components.

@mkysel mkysel requested a review from a team as a code owner May 23, 2025 15:41
@graphite-app
Copy link

graphite-app bot commented May 23, 2025

How to use the Graphite Merge Queue

Add either label to this PR to merge it via the merge queue:

  • Queue - adds this PR to the back of the merge queue
  • Hotfix - for urgent hot fixes, skip the queue and merge this PR next

You must have a Graphite account in order to use the merge queue. Sign up using this link.

An organization admin has enabled the Graphite Merge Queue in this repository.

Please do not merge from GitHub as this will restart CI on PRs being processed by the merge queue.

@coderabbitai
Copy link
Contributor

coderabbitai bot commented May 23, 2025

Walkthrough

The changes introduce a configurable backfill block size for log streaming, replacing a fixed constant with per-instance settings. This includes new fields and options in configuration structs, updates to constructors to accept and propagate the new parameter, and modifications to test utilities to support the new configuration.

Changes

File(s) Change Summary
pkg/blockchain/rpcLogStreamer.go Removed fixed BACKFILL_BLOCKS constant; added WithBackfillBlockSize option; updated RpcLogStreamer struct and methods to support configurable backfill block size.
pkg/config/options.go Added BackfillBlockSize field to ContractsOptions struct with CLI and environment variable support.
pkg/indexer/app_chain/app_chain.go Updated NewAppChain constructor to accept and use a blockSize parameter for backfill configuration.
pkg/indexer/indexer.go Modified NewIndexer to pass cfg.BackfillBlockSize to app_chain.NewAppChain.
pkg/testutils/config.go Updated NewContractsOptions to set BackfillBlockSize to 500 in returned struct.

Sequence Diagram(s)

sequenceDiagram
    participant Config as ContractsOptions
    participant Indexer
    participant AppChain
    participant RpcLogStreamer

    Config->>Indexer: Provides BackfillBlockSize
    Indexer->>AppChain: Passes BackfillBlockSize to NewAppChain
    AppChain->>RpcLogStreamer: Initializes with WithBackfillBlockSize
    RpcLogStreamer->>RpcLogStreamer: Uses backfillBlockSize for log fetching
Loading

Suggested reviewers

  • neekolas

Warning

There were issues while running some tools. Please review the errors and either fix the tool's configuration or disable the tool if it's a critical failure.

🔧 golangci-lint (1.64.8)

Error: you are using a configuration file for golangci-lint v2 with golangci-lint v1: please use golangci-lint v2
Failed executing command with error: you are using a configuration file for golangci-lint v2 with golangci-lint v1: please use golangci-lint v2


📜 Recent review details

Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 080949f and 8059668.

📒 Files selected for processing (2)
  • pkg/blockchain/rpcLogStreamer.go (4 hunks)
  • pkg/testutils/config.go (1 hunks)
🚧 Files skipped from review as they are similar to previous changes (1)
  • pkg/blockchain/rpcLogStreamer.go
⏰ Context from checks skipped due to timeout of 90000ms (5)
  • GitHub Check: Push Docker Images to GitHub Packages (xmtpd-cli)
  • GitHub Check: Test (Node)
  • GitHub Check: Upgrade Tests
  • GitHub Check: Push Docker Images to GitHub Packages (xmtpd)
  • GitHub Check: Code Review
🔇 Additional comments (1)
pkg/testutils/config.go (1)

42-42: LGTM! Test configuration properly updated for new feature.

The addition of BackfillBlockSize: 500 correctly supports the new configurable backfill block size feature and ensures test configurations remain compatible with the updated config.ContractsOptions struct.

✨ Finishing Touches
  • 📝 Generate Docstrings

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share
🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    • I pushed a fix in commit <commit_id>, please review it.
    • Explain this complex logic.
    • Open a follow-up GitHub issue for this discussion.
  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query. Examples:
    • @coderabbitai explain this code block.
    • @coderabbitai modularize this function.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
    • @coderabbitai read src/utils.ts and explain its main purpose.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.
    • @coderabbitai help me debug CodeRabbit configuration file.

Support

Need help? Create a ticket on our support page for assistance with any issues or questions.

Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments.

CodeRabbit Commands (Invoked using PR comments)

  • @coderabbitai pause to pause the reviews on a PR.
  • @coderabbitai resume to resume the paused reviews.
  • @coderabbitai review to trigger an incremental review. This is useful when automatic reviews are disabled for the repository.
  • @coderabbitai full review to do a full review from scratch and review all the files again.
  • @coderabbitai summary to regenerate the summary of the PR.
  • @coderabbitai generate docstrings to generate docstrings for this PR.
  • @coderabbitai generate sequence diagram to generate a sequence diagram of the changes in this PR.
  • @coderabbitai resolve resolve all the CodeRabbit review comments.
  • @coderabbitai configuration to show the current CodeRabbit configuration for the repository.
  • @coderabbitai help to get help.

Other keywords and placeholders

  • Add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
  • Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
  • Add @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit Configuration File (.coderabbit.yaml)

  • You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
  • Please see the configuration documentation for more information.
  • If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Documentation and Community

  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 3

🧹 Nitpick comments (1)
pkg/indexer/app_chain/app_chain.go (1)

44-44: Function signature correctly updated for configurable block size.

The addition of the blockSize uint64 parameter properly enables configuration of the backfill block size, replacing the previous fixed constant approach.

Consider adding validation for the blockSize parameter to ensure it's greater than zero:

func NewAppChain(
	ctxwc context.Context,
	log *zap.Logger,
	cfg config.AppChainOptions,
	db *sql.DB,
	validationService mlsvalidate.MLSValidationService,
	blockSize uint64,
) (*AppChain, error) {
+	if blockSize == 0 {
+		return nil, fmt.Errorf("blockSize must be greater than 0")
+	}
	ctxwc, cancel := context.WithCancel(ctxwc)
📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 15f572e and db8f348.

📒 Files selected for processing (5)
  • pkg/blockchain/rpcLogStreamer.go (3 hunks)
  • pkg/blockchain/rpcLogStreamer_test.go (1 hunks)
  • pkg/config/options.go (1 hunks)
  • pkg/indexer/app_chain/app_chain.go (2 hunks)
  • pkg/indexer/indexer.go (1 hunks)
🧰 Additional context used
🧬 Code Graph Analysis (2)
pkg/blockchain/rpcLogStreamer_test.go (1)
pkg/blockchain/rpcLogStreamer.go (1)
  • WithBackfillBlockSize (44-49)
pkg/indexer/app_chain/app_chain.go (1)
pkg/blockchain/rpcLogStreamer.go (1)
  • WithBackfillBlockSize (44-49)
⏰ Context from checks skipped due to timeout of 90000ms (5)
  • GitHub Check: Code Review
  • GitHub Check: Push Docker Images to GitHub Packages (xmtpd-cli)
  • GitHub Check: Test (Node)
  • GitHub Check: Push Docker Images to GitHub Packages (xmtpd)
  • GitHub Check: Upgrade Tests
🔇 Additional comments (4)
pkg/blockchain/rpcLogStreamer_test.go (1)

57-57: Good test coverage for the new configuration option.

The test correctly includes the new WithBackfillBlockSize(500) option, ensuring the configurable backfill block size path is covered. The value 500 is consistent with the default configured in pkg/config/options.go.

pkg/config/options.go (1)

29-29: Well-structured configuration field addition.

The new BackfillBlockSize field is properly defined with appropriate CLI and environment variable tags, descriptive help text, and a reasonable default value. The uint64 type is consistent with its usage throughout the codebase.

pkg/indexer/indexer.go (1)

39-39:

Details

✅ Verification successful

Correct configuration propagation to app chain.

The cfg.BackfillBlockSize parameter is properly passed through to the NewAppChain constructor, maintaining the configuration flow from the options to the blockchain components.

Since the NewAppChain function signature has changed, let's verify that all call sites have been updated:


🏁 Script executed:

#!/bin/bash
# Description: Verify all call sites to NewAppChain have been updated to include the new blockSize parameter
# Expected: Only find calls with the correct number of parameters

# Search for NewAppChain function calls
rg -A 10 "NewAppChain\("

Length of output: 1131


All NewAppChain call sites correctly updated – approving.

Verification confirmed only two occurrences of NewAppChain(:

  • Definition in pkg/indexer/app_chain/app_chain.go
  • Invocation in pkg/indexer/indexer.go already includes cfg.BackfillBlockSize

No further updates required.

pkg/indexer/app_chain/app_chain.go (1)

117-117: Correct integration of configurable backfill block size.

The blockchain.WithBackfillBlockSize(blockSize) option is properly applied to the RpcLogStreamer, enabling dynamic configuration of the backfill block size per the PR objectives.

@macroscopeapp
Copy link

macroscopeapp bot commented May 23, 2025

Replace hardcoded 1000-block backfill size with configurable block size parameter in RpcLogStreamer

Introduces configuration options for controlling blockchain log backfill block size across multiple components:

  • Adds backfillBlockSize field to RpcLogStreamer in rpcLogStreamer.go with a default value of 500 blocks
  • Implements WithBackfillBlockSize option function for configuration in rpcLogStreamer.go
  • Adds BackfillBlockSize configuration option to ContractsOptions in options.go with CLI flag and environment variable support
  • Modifies NewAppChain function in app_chain.go to accept block size parameter
  • Updates NewIndexer in indexer.go to pass configuration through to AppChain

📍Where to Start

Start with the RpcLogStreamer struct and its modifications in rpcLogStreamer.go, which contains the core changes to make the backfill block size configurable.


Macroscope summarized 8059668.

@mkysel mkysel merged commit 72f16dd into main May 23, 2025
10 checks passed
@mkysel mkysel deleted the mkysel/backfill-block-size branch May 23, 2025 16:22
@coderabbitai coderabbitai bot mentioned this pull request May 26, 2025
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.

3 participants