Skip to content

chore(docs): add RPC requirements for low-traffic nodes#6997

Merged
hanabi1224 merged 4 commits intomainfrom
add-min-rpc-reqs
May 4, 2026
Merged

chore(docs): add RPC requirements for low-traffic nodes#6997
hanabi1224 merged 4 commits intomainfrom
add-min-rpc-reqs

Conversation

@LesnyRumcajs
Copy link
Copy Markdown
Member

@LesnyRumcajs LesnyRumcajs commented May 4, 2026

Summary of changes

Changes introduced in this pull request:

  • added sample setup for Forest users with low-traffic requirements

Reference issue to close (if applicable)

Closes

Other information and links

Change checklist

  • I have performed a self-review of my own code,
  • I have made corresponding changes to the documentation. All new code adheres to the team's documentation standards,
  • I have added tests that prove my fix is effective or that my feature works (if possible),
  • I have made sure the CHANGELOG is up-to-date. All user-facing changes should be reflected in this document.

Outside contributions

  • I have read and agree to the CONTRIBUTING document.
  • I have read and agree to the AI Policy document. I understand that failure to comply with the guidelines will lead to rejection of the pull request.

Summary by CodeRabbit

  • Documentation
    • Reorganized and expanded hardware requirements for RPC nodes.
    • Added “RPC Node (low traffic, minimal retention)” guidance with sizing recommendations.
    • Added “RPC Node (2 months retention)” with low‑ vs high‑traffic sizing and disk guidance.
    • Moved RPC disk‑space rule‑of‑thumb earlier; retention example changed to 60 days.
    • Updated disk growth estimate when GC is disabled (~2 GiB/day).
    • Removed prior generic/regular node sections.
    • Updated community portable solar node content to use a Twitter embed.

@LesnyRumcajs LesnyRumcajs requested a review from a team as a code owner May 4, 2026 14:49
@LesnyRumcajs LesnyRumcajs requested review from sudo-shashank and removed request for a team May 4, 2026 14:49
@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented May 4, 2026

Walkthrough

Reorganized and expanded the hardware requirements docs for Forest RPC nodes: added an upfront RPC disk-sizing rule-of-thumb (example for 60 days, updated "disable GC" growth), introduced "RPC Node (low traffic, minimal retention)" and "RPC Node (2 months retention)" sections with CPU/memory/disk tables, moved Bootstrap Node section, and replaced a Twitter iframe with a direct link.

Changes

Hardware Requirements — RPC & Bootstrap docs

Layer / File(s) Summary
Disk sizing rule-of-thumb
docs/docs/users/getting_started/hardware-reqs.md
Added an RPC disk sizing rule-of-thumb based on retention with a worked 60-day example; updated "disable GC" growth estimate to ~2 GiB/day and noted manual disk management.
RPC Node (low traffic, minimal retention)
docs/docs/users/getting_started/hardware-reqs.md
Replaced prior generic RPC section with "RPC Node (low traffic, minimal retention)" and added a new CPU/memory recommendation table (higher CPU, lower memory vs prior).
RPC Node (2 months retention)
docs/docs/users/getting_started/hardware-reqs.md
Added "RPC Node (2 months retention)" section with separate low-traffic (<100 req/min) and high-traffic tiers, including CPU, memory, and disk (500 GiB) recommendations.
Bootstrap Node (stateless) relocation
docs/docs/users/getting_started/hardware-reqs.md
Kept the existing bootstrap node stateless content and resource table but relocated it after the RPC guidance.
Community embed update
docs/docs/users/getting_started/hardware-reqs.md
Replaced an iframe embed with a direct Twitter link in the "Community: Portable Solar-Powered Forest Node" section.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~2 minutes

Possibly related PRs

Suggested reviewers

  • sudo-shashank
  • hanabi1224
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The PR title 'chore(docs): add RPC requirements for low-traffic nodes' is directly related to the main change: adding a new 'RPC Node (low traffic, minimal retention)' section with CPU/memory recommendations to the hardware requirements documentation.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch add-min-rpc-reqs
✨ Simplify code
  • Create PR with simplified code
  • Commit simplified code in branch add-min-rpc-reqs

Tip

💬 Introducing Slack Agent: The best way for teams to turn conversations into code.

Slack Agent is built on CodeRabbit's deep understanding of your code, so your team can collaborate across the entire SDLC without losing context.

  • Generate code and open pull requests
  • Plan features and break down work
  • Investigate incidents and troubleshoot customer tickets together
  • Automate recurring tasks and respond to alerts with triggers
  • Summarize progress and report instantly

Built for teams:

  • Shared memory across your entire org—no repeating context
  • Per-thread sandboxes to safely plan and execute work
  • Governance built-in—scoped access, auditability, and budget controls

One agent for your entire SDLC. Right inside Slack.

👉 Get started


Review rate limit: 4/5 reviews remaining, refill in 12 minutes.

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown
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: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@docs/docs/users/getting_started/hardware-reqs.md`:
- Line 44: The sentence contains a duplicated word "need need"; update the
string "might need need to tweak the setup." to "might need to tweak the setup."
by removing the extra "need" so the user-facing sentence reads correctly; search
for the exact phrase to locate and edit the line in
docs/users/getting_started/hardware-reqs.md.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: e071a23c-9460-4ff5-8d71-e4727d25ba11

📥 Commits

Reviewing files that changed from the base of the PR and between 18d24da and 3ce4f01.

📒 Files selected for processing (1)
  • docs/docs/users/getting_started/hardware-reqs.md

Comment thread docs/docs/users/getting_started/hardware-reqs.md Outdated
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Copy link
Copy Markdown
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.

🧹 Nitpick comments (1)
docs/docs/users/getting_started/hardware-reqs.md (1)

44-45: ⚡ Quick win

Clarify that retention also limits historical RPC availability.

This section explains sizing well, but it may still imply broad RPC coverage. Add a short note that requests for data older than the retention window may not be available.

Suggested patch
-This setup should be sufficient for a self-hosted RPC node that serves a small number of requests (under 100 requests per minute) and retains 2 months of historical state. Note that if the methods called by the clients are more resource-intensive, you might need to tweak the setup.
+This setup should be sufficient for a self-hosted RPC node that serves a small number of requests (under 100 requests per minute) and retains 2 months of historical state. Requests that require data older than the retention window may be unavailable. Note that if the methods called by the clients are more resource-intensive, you might need to tweak the setup.
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/docs/users/getting_started/hardware-reqs.md` around lines 44 - 45,
Update the paragraph that begins "This setup should be sufficient for a
self-hosted RPC node that serves a small number of requests..." to append a
short clarifying note that retention directly limits historical RPC availability
— e.g., add one sentence stating requests for data older than the configured
retention window may not be available and clients should plan accordingly; edit
the same stanza in hardware-reqs.md so the clarification appears alongside the
existing sizing guidance.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Nitpick comments:
In `@docs/docs/users/getting_started/hardware-reqs.md`:
- Around line 44-45: Update the paragraph that begins "This setup should be
sufficient for a self-hosted RPC node that serves a small number of requests..."
to append a short clarifying note that retention directly limits historical RPC
availability — e.g., add one sentence stating requests for data older than the
configured retention window may not be available and clients should plan
accordingly; edit the same stanza in hardware-reqs.md so the clarification
appears alongside the existing sizing guidance.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: ecdc3b8b-fbb2-4490-aaba-098053b02da0

📥 Commits

Reviewing files that changed from the base of the PR and between 3ce4f01 and d4ece8c.

📒 Files selected for processing (1)
  • docs/docs/users/getting_started/hardware-reqs.md

@LesnyRumcajs LesnyRumcajs marked this pull request as draft May 4, 2026 15:27
@LesnyRumcajs LesnyRumcajs marked this pull request as ready for review May 4, 2026 16:13
Copy link
Copy Markdown
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: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@docs/docs/users/getting_started/hardware-reqs.md`:
- Line 46: The sentence "More of a curiosity - [direct Twitter
link](https://platform.twitter.com/embed/Tweet.html?id=1937542522387026383)"
claims the embed was replaced but the iframe embed remains below; either remove
the iframe embed block that references the same Tweet or update that sentence to
accurately state that the Tweet is embedded (e.g., change "direct Twitter link"
to "embedded Tweet" or similar). Locate and edit the sentence text and the
corresponding iframe embed in the same document (hardware-reqs.md) so the
wording and the actual page behavior match.
- Around line 8-10: Split the disk-sizing guidance into two explicit models: (1)
a "retention-based sizing" model referencing the phrase "200 GiB + 5 GiB per day
of retention" and the example calculation "200 GiB + (5 GiB * 60) = 500 GiB";
and (2) a "GC-disabled growth" model referencing the sentence that starts with
"Also, if you disable GC" and the "~2 GiB per day" growth rate. For each model,
state the assumptions, the applicable formula or ongoing growth rate, and an
operator action (e.g., manual disk monitoring/cleanup for GC-disabled), making
clear they are mutually exclusive so readers do not combine "5 GiB/day" and "~2
GiB/day" in one calculation.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: e9bcf6b4-e656-48fc-b721-afb4007223cc

📥 Commits

Reviewing files that changed from the base of the PR and between d4ece8c and d57f9b6.

📒 Files selected for processing (1)
  • docs/docs/users/getting_started/hardware-reqs.md

Comment thread docs/docs/users/getting_started/hardware-reqs.md
Comment thread docs/docs/users/getting_started/hardware-reqs.md
@hanabi1224 hanabi1224 enabled auto-merge May 4, 2026 20:24
@hanabi1224 hanabi1224 added this pull request to the merge queue May 4, 2026
Merged via the queue into main with commit e1d8bbe May 4, 2026
17 checks passed
@hanabi1224 hanabi1224 deleted the add-min-rpc-reqs branch May 4, 2026 20:41
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.

2 participants