Skip to content

chore: update docs for v1 (1/n) #564

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 15 commits into
base: main
Choose a base branch
from
Open

chore: update docs for v1 (1/n) #564

wants to merge 15 commits into from

Conversation

tac0turtle
Copy link
Contributor

@tac0turtle tac0turtle commented May 5, 2025

Overview

This pr starts the redo of docs in order to comply with the v1 changes

Summary by CodeRabbit

  • New Features

    • Added comprehensive setup guides for EVM Single Sequencer and EVM Based Sequencer implementations.
    • Introduced a detailed configuration reference guide for customizing Rollkit nodes.
  • Documentation

    • Updated and expanded the metrics guide, configuration, and full node setup instructions.
    • Revised tutorials to use Ignite and gmd instead of Kurtosis and Docker for the GM world example.
    • Improved formatting and clarity across multiple guides and tutorials.
    • Consolidated and streamlined configuration and overview documentation.
    • Added a placeholder tutorial for the Single Sequencer.
  • Removals

    • Deleted outdated or redundant guides and tutorials, including those for Wordle, Artela EVM++, BeaconKit, Omni, Polaris EVM, Avail DA, centralized/local sequencers, and CLI usage.
    • Removed the Kurtosis deployment tutorial and several EVM contract interaction and monitoring integration guides.
    • Removed deprecated configuration and sequencing tutorials.
  • Chores

    • Removed an unused development dependency from the project configuration.
    • Updated repository URLs and build commands in installation scripts.

Copy link
Contributor

coderabbitai bot commented May 5, 2025

Walkthrough

This update restructures and consolidates Rollkit's documentation by removing numerous individual configuration and tutorial guides, introducing new comprehensive guides for configuration and EVM sequencer setups, updating navigation, and revising several tutorials for clarity and consistency. The changes focus on centralizing configuration information and modernizing setup instructions.

Changes

File(s) / Path(s) Change Summary
guides/block-times.md, guides/da-block-time.md, guides/gas-price.md, guides/lazy-sequencing.md, guides/max-pending-blocks.md, guides/rollkit-monitoring.md, guides/use-rollkit-cli.md, tutorials/da/avail-da.md, tutorials/execution/artela-evm-plus-plus.md, tutorials/execution/beaconkit.md, tutorials/execution/evm-contract-interaction.md, tutorials/execution/octane-evm.md, tutorials/execution/polaris-evm.md, tutorials/kurtosis.md, tutorials/sequencing/astria.md, tutorials/sequencing/centralized.md, tutorials/sequencing/local.md, tutorials/wordle.md, public/wordle/init.sh Deleted multiple individual configuration, monitoring, and tutorial guides, including block time, DA block time, gas price, lazy sequencing, max pending blocks, Range monitoring, CLI usage, Avail DA, Artela EVM++, BeaconKit, EVM contract interaction, Octane EVM, Polaris EVM, Kurtosis, Astria sequencing, centralized and local sequencer tutorials, Wordle tutorial, and the Wordle chain init script.
guides/config.md Added a comprehensive configuration reference guide for Rollkit, detailing all configuration options, categories, precedence, and usage examples for node customization.
guides/evm-single.md, guides/evm-based.md Added new, detailed setup guides for EVM Single Sequencer and EVM Based Sequencer implementations, including prerequisites, build steps, configuration, running sequencers and full nodes, verification, and flag references.
guides/overview.md Updated guide overview to remove deprecated guides, add new EVM rollup guides, and consolidate configuration into a single guide.
guides/full-node.md Updated full node setup guide by removing config_dir instructions, using a binary placeholder, and making minor formatting changes.
guides/create-genesis.md, learn/stack.md, tutorials/da/celestia-da.md, tutorials/deploy-overview.md, tutorials/docker-compose.md, tutorials/execution/cosmwasm.md Minor formatting, whitespace, and language tag adjustments; no content or logic changes.
guides/metrics.md Extensively revised and expanded the metrics guide, making it Rollkit-centric, restructuring metrics by subsystem, adding configuration, Prometheus, troubleshooting, and advanced options.
guides/reset-state.md Updated chain reset instructions to use a safer command-based approach (${BINARY} unsafe-clean) instead of manual directory deletion.
tutorials/da/local-da.md Corrected DA flag name, updated binary placeholders, revised expected log output, and added a documentation link for running local-da.
tutorials/da/overview.md Updated interface references from "go-da" to "core da," expanded interface definition, and removed Avail DA references.
tutorials/gm-world.md Replaced Kurtosis-based setup with Ignite/gmd-based flow, updated commands, outputs, and removed UI app section.
tutorials/sequencing/overview.md Revised sequencing overview to focus on the sequencing interface, updated links, and removed references to deprecated/mock sequencers.
tutorials/sequencing/based.md Minor formatting: removed trailing whitespace and a progress link.
tutorials/sequencing/forced-inclusion.md Added a newline at the end of the file.
tutorials/sequencing/single.md Added new placeholder file for Single Sequencer tutorial.
.vitepress/config.ts Updated navigation and sidebar: removed or consolidated links to deprecated tutorials/guides, added new EVM sequencer guides, and commented out the Testnets section.
package.json Removed the "@keplr-wallet/types" devDependency.
public/install-local-da.sh Changed the repo clone URL to rollkit/rollkit.git, updated build command to make build-da.

Sequence Diagram(s)

sequenceDiagram
    participant User
    participant Docs
    participant Rollkit Node
    participant EVM Layer
    participant DA Node

    User->>Docs: Accesses new config or EVM sequencer guide
    User->>Rollkit Node: Builds and configures node using guide
    User->>DA Node: Starts DA node as instructed
    User->>EVM Layer: Starts EVM execution layer (op-geth/reth)
    User->>Rollkit Node: Starts sequencer/full node with flags from guide
    Rollkit Node->>DA Node: Connects for data availability
    Rollkit Node->>EVM Layer: Connects for execution
    User->>Rollkit Node: Verifies operation via logs/metrics
Loading

Poem

🐇

Docs were scattered, guides galore,
Now they're neat—no clutter anymore!
EVM sequencers, configs in one place,
Ignite and gmd now set the pace.
Out with the old, in with the new,
Rollkit's docs—clear for you!

Hop, hop, hooray for tidy docs today!

Note

⚡️ AI Code Reviews for VS Code, Cursor, Windsurf

CodeRabbit now has a plugin for VS Code, Cursor and Windsurf. This brings AI code reviews directly in the code editor. Each commit is reviewed immediately, finding bugs before the PR is raised. Seamless context handoff to your AI code agent ensures that you can easily incorporate review feedback.
Learn more here.


Note

⚡️ Faster reviews with caching

CodeRabbit now supports caching for code and dependencies, helping speed up reviews. This means quicker feedback, reduced wait times, and a smoother review experience overall. Cached data is encrypted and stored securely. This feature will be automatically enabled for all accounts on May 16th. To opt out, configure Review - Disable Cache at either the organization or repository level. If you prefer to disable all data retention across your organization, simply turn off the Data Retention setting under your Organization Settings.
Enjoy the performance boost—your workflow just got faster.


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

github-actions bot commented May 5, 2025

PR Preview Action v1.6.1

🚀 View preview at
https://rollkit.github.io/docs-preview/pr-564/

Built to branch main at 2025-05-19 17:45 UTC.
Preview will be ready when the GitHub Pages deployment is complete.

@tac0turtle tac0turtle force-pushed the marko/update-docs branch from 51caf3f to 9e8b27f Compare May 5, 2025 12:13
@tac0turtle tac0turtle force-pushed the marko/update-docs branch from 3eed836 to d90c9bc Compare May 13, 2025 14:58
@tac0turtle tac0turtle marked this pull request as ready for review May 13, 2025 20:40
@tac0turtle tac0turtle enabled auto-merge (squash) May 13, 2025 20:41
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: 4

🧹 Nitpick comments (27)
guides/create-genesis.md (3)

5-5: Remove trailing whitespace and fix spelling in heading.
Good removal of trailing whitespace on this heading. However, "Pre-requisities" is misspelled; consider using "Prerequisites" (no hyphen) for consistency and correctness.


7-7: Add comma after introductory phrase.
Add a comma after "For this guide" to improve readability:

-For this guide you need to have a chain directory...
+For this guide, you need to have a chain directory...

12-12: Include missing article "the".
In "created in linked guide.", add "the" before "linked" for grammatical correctness:

-This guide will use the simple ignite chain created in linked guide.
+This guide will use the simple ignite chain created in the linked guide.
🧰 Tools
🪛 LanguageTool

[uncategorized] ~12-~12: You might be missing the article “the” here.
Context: ... use the simple ignite chain created in linked guide. Make sure to update any relevant...

(AI_EN_LECTOR_MISSING_DETERMINER_THE)

learn/stack.md (1)

101-101: Add missing comma for clarity
Insert a comma after “specified” to improve readability:

- If no height is specified the latest block will be used.
+ If no height is specified, the latest block will be used.
🧰 Tools
🪛 LanguageTool

[typographical] ~101-~101: It seems that a comma is missing.
Context: ...of the requested block. If no height is specified the latest block will be used. If heigh...

(IF_COMMA)

guides/reset-state.md (1)

10-10: Grammar refinement
Consider rephrasing for clarity:

- Some reason you might need to reset the state of your chain are:
+ Some reasons you might need to reset the state of your chain include:
tutorials/sequencing/overview.md (4)

2-4: Remove leading whitespace.
Line 4 begins with an extra space before “Sequencing is…”, which can affect Markdown rendering and consistency. Please remove the leading space.


8-16: Clarify interface method signatures.
Consider including Go parameter and return types in the snippet (e.g.

SubmitRollupTransaction(rollupID string, data []byte) error
GetNextBatch(rollupID string, lastBatchHash []byte, maxBytes int) (Batch, time.Time)
VerifyBatch(rollupID string, batchHash []byte) (Status, error)

) so readers know expected types. Also, add periods at the end of each method line to keep punctuation consistent.


20-23: Add terminal periods to bullets.
The list under “It mainly consists of:” is missing periods at the end of each item. Adding them improves readability and maintains style consistency.


26-27: Simplify wording and fix missing article.

  • Change “refactored functionality from the Rollkit prior to v1.0.0” to “refactored from Rollkit before v1.0.0”.
  • Add “the” before “single sequencer”: “…relays rollup transactions to the single sequencer…”.
🧰 Tools
🪛 LanguageTool

[style] ~26-~26: ‘prior to’ might be wordy. Consider a shorter alternative.
Context: ...factored functionality from the Rollkit prior to v1.0.0. The single sequencer is the m...

(EN_WORDINESS_PREMIUM_PRIOR_TO)


[uncategorized] ~26-~26: You might be missing the article “a” here.
Context: ...ator node relays rollup transactions to single sequencer which then submits them to th...

(AI_EN_LECTOR_MISSING_DETERMINER_A)

guides/evm-single-guide.md (5)

21-23: Specify shell language for code block.
Wrap the git clone commands in a fenced block labelled bash or shell for proper syntax highlighting, e.g.

git clone https://github.com/rollkit/rollkit.git
cd rollkit

28-30: Specify shell language for code block.
The make build-evm-single and make build-da commands should also be in a bash/shell fenced block to improve clarity.


42-44: Specify shell language for code block.
Starting the local DA node commands should be wrapped in a bash/shell code fence.


52-56: Specify shell language for code block.
Cloning the go-execution-evm repository would benefit from a bash code fence to distinguish commands from prose.


82-88: Link to unified configuration reference.
Consider adding a reference to the consolidated Config Settings guide here, so readers can look up flag descriptions and defaults without leaving this guide.

guides/evm-based.md (3)

21-23: Specify shell language for code block.
The git clone snippet should be wrapped in a bash/shell fenced code block for consistency.


28-30: Specify shell language for code block.
Wrap the make build-evm-based and make build-da commands in a bash/shell code fence.


126-136: Specify shell language for code block.
The full node start command should be in a bash code fence to improve readability.

guides/metrics.md (3)

3-4: Reconsider subsection title.
Under “Rollkit Metrics Guide,” the heading “## How to configure metrics” could be more descriptive as “## Enabling Prometheus metrics” to match its content.


9-12: Show YAML snippet in fenced block.
Display the setting for enabling metrics in a fenced yaml block, for example:

instrumentation:
  prometheus: true

57-63: Label code fence language for curl.
Wrap the curl http://localhost:26660/metrics example in a bash/shell fenced block for proper syntax highlighting.

guides/config.md (3)

52-59: Align section title with TOC.
Rename the section header from ## Configs to ## Introduction to Configurations so it matches the TOC entry and clarifies purpose.


761-766: Simplify wording.
Replace “used in conjunction with” with a shorter alternative like “used with” or “used alongside” to reduce wordiness.

🧰 Tools
🪛 LanguageTool

[style] ~761-~761: ‘in conjunction with’ might be wordy. Consider a shorter alternative.
Context: ...n the SignerConfig struct but is used in conjunction with it. YAML: This is typically not st...

(EN_WORDINESS_PREMIUM_IN_CONJUNCTION_WITH)


43-350: Add language identifiers to code blocks.
Many YAML and shell examples lack language tags on their fences. For better readability and syntax highlighting, annotate YAML snippets with yaml and shell commands with bash or shell.

tutorials/da/overview.md (4)

13-13: Use a versioned link for the DA interface
The link to the core DA interface currently points at the main branch (.../blob/main/...). Since this documentation is being updated for v1, you should point to the v1 tag (or a versioned path) to prevent the link from drifting when main changes.


17-17: Rephrase the interface overview for clarity
The phrase “Probably the two most important functions” sounds informal and downplays the expanded interface. Consider removing “Probably” and explicitly listing the core methods or pointing readers to the full interface below.


22-56: Document the expanded DA interface in detail
The DA interface has grown to include methods beyond Get and Submit (e.g., MaxBlobSize, GetIDs, GetProofs, Commit, SubmitWithOptions, Validate, GasPrice, GasMultiplier). To improve usability:

  • Add a brief description (or a table) summarizing each new method’s purpose.
  • Group related methods (reads vs. writes vs. utility) for better readability.
  • Ensure types like ID, Blob, Commitment, and the []byte-namespace parameter are linked or documented elsewhere.
  • Verify the opening and closing ```go fences are correctly labeled.

60-60: Fix the Celestia DA link and label
The reference [Celestia](celestia-da) lacks context and may not resolve as intended. Change it to something like [Celestia DA](celestia-da.md) or use a relative path (../da/celestia-da.md) and include “DA” in the link text for clarity.

📜 Review details

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

📥 Commits

Reviewing files that changed from the base of the PR and between 828ad26 and 0edcfda.

📒 Files selected for processing (34)
  • guides/block-times.md (0 hunks)
  • guides/config.md (1 hunks)
  • guides/create-genesis.md (2 hunks)
  • guides/da-block-time.md (0 hunks)
  • guides/evm-based.md (1 hunks)
  • guides/evm-single-guide.md (1 hunks)
  • guides/full-node.md (0 hunks)
  • guides/gas-price.md (2 hunks)
  • guides/lazy-sequencing.md (0 hunks)
  • guides/max-pending-blocks.md (0 hunks)
  • guides/metrics.md (1 hunks)
  • guides/overview.md (1 hunks)
  • guides/reset-state.md (2 hunks)
  • guides/rollkit-monitoring.md (0 hunks)
  • guides/use-rollkit-cli.md (0 hunks)
  • learn/stack.md (1 hunks)
  • tutorials/da/avail-da.md (0 hunks)
  • tutorials/da/celestia-da.md (2 hunks)
  • tutorials/da/local-da.md (4 hunks)
  • tutorials/da/overview.md (1 hunks)
  • tutorials/deploy-overview.md (1 hunks)
  • tutorials/execution/artela-evm-plus-plus.md (0 hunks)
  • tutorials/execution/beaconkit.md (0 hunks)
  • tutorials/execution/cosmwasm.md (7 hunks)
  • tutorials/execution/evm-contract-interaction.md (0 hunks)
  • tutorials/execution/octane-evm.md (0 hunks)
  • tutorials/execution/polaris-evm.md (0 hunks)
  • tutorials/kurtosis.md (0 hunks)
  • tutorials/sequencing/astria.md (0 hunks)
  • tutorials/sequencing/based.md (1 hunks)
  • tutorials/sequencing/centralized.md (0 hunks)
  • tutorials/sequencing/forced-inclusion.md (1 hunks)
  • tutorials/sequencing/local.md (0 hunks)
  • tutorials/sequencing/overview.md (2 hunks)
💤 Files with no reviewable changes (17)
  • tutorials/sequencing/astria.md
  • guides/max-pending-blocks.md
  • guides/block-times.md
  • guides/lazy-sequencing.md
  • guides/use-rollkit-cli.md
  • guides/da-block-time.md
  • tutorials/execution/artela-evm-plus-plus.md
  • tutorials/sequencing/local.md
  • tutorials/execution/evm-contract-interaction.md
  • guides/rollkit-monitoring.md
  • tutorials/kurtosis.md
  • guides/full-node.md
  • tutorials/execution/octane-evm.md
  • tutorials/sequencing/centralized.md
  • tutorials/execution/beaconkit.md
  • tutorials/execution/polaris-evm.md
  • tutorials/da/avail-da.md
🧰 Additional context used
🪛 LanguageTool
guides/create-genesis.md

[typographical] ~6-~6: Use a comma after an introductory phrase.
Context: ...tart the chain. ## 0. Pre-requisities For this guide you need to have a chain directory wher...

(COMMA_INTRODUCTORY_WORDS_PHRASES)


[uncategorized] ~12-~12: You might be missing the article “the” here.
Context: ... use the simple ignite chain created in linked guide. Make sure to update any relevant...

(AI_EN_LECTOR_MISSING_DETERMINER_THE)

guides/reset-state.md

[style] ~16-~16: Consider a more concise word here.
Context: ... changes * Hardforks ## Prerequisites In order to complete this guide, you will need to h...

(IN_ORDER_TO_PREMIUM)

learn/stack.md

[typographical] ~101-~101: It seems that a comma is missing.
Context: ...of the requested block. If no height is specified the latest block will be used. If heigh...

(IF_COMMA)

tutorials/sequencing/overview.md

[style] ~26-~26: ‘prior to’ might be wordy. Consider a shorter alternative.
Context: ...factored functionality from the Rollkit prior to v1.0.0. The single sequencer is the m...

(EN_WORDINESS_PREMIUM_PRIOR_TO)


[uncategorized] ~26-~26: You might be missing the article “a” here.
Context: ...ator node relays rollup transactions to single sequencer which then submits them to th...

(AI_EN_LECTOR_MISSING_DETERMINER_A)

guides/config.md

[style] ~761-~761: ‘in conjunction with’ might be wordy. Consider a shorter alternative.
Context: ...n the SignerConfig struct but is used in conjunction with it. YAML: This is typically not st...

(EN_WORDINESS_PREMIUM_IN_CONJUNCTION_WITH)

🪛 markdownlint-cli2 (0.17.2)
guides/config.md

7-7: Link fragments should be valid
null

(MD051, link-fragments)

🔇 Additional comments (26)
guides/create-genesis.md (1)

53-53: Ensure proper separation after code block.
The added blank line after the triple backticks improves Markdown rendering by separating the code block from the surrounding text. LGTM.

tutorials/sequencing/forced-inclusion.md (1)

3-3: Trivial whitespace update
A newline was added after the placeholder text. This ensures the file ends with a single newline, which is a good POSIX practice.

tutorials/sequencing/based.md (1)

1-1: Title formatting corrected
Removed the extra space in the heading (# Based Sequencing ) to standardize Markdown syntax. Looks good.

tutorials/da/celestia-da.md (2)

47-47: Removed trailing space in bullet
The trailing space after the prerequisite bullet was cleaned up for consistency.


146-146: Inserted blank line for readability
A blank line was added before the “Other explorers” list to improve Markdown rendering.

guides/reset-state.md (3)

15-15: Heading placement approved
The new “## Prerequisites” heading is well positioned and consistent with other guides.


21-21: Instruction description approved
The explanatory sentence about .rollkit creation is clear and accurate.


23-23: Directory preview caption approved
“This directory will look like the following.” accurately introduces the tree output.

tutorials/execution/cosmwasm.md (4)

33-33: Whitespace formatting cleanup
Removed trailing spaces from the sentence enhances markdown consistency without affecting content.


40-40: Add blank line after code block
Inserting a blank line after the code block improves readability and ensures proper rendering.


124-124: Remove trailing spaces in code snippet delimiter
Cleaning up trailing spaces in the fenced code block maintains consistency across examples.


134-134: Remove trailing spaces in code snippet delimiter
Minor formatting fix that does not impact tutorial steps.

tutorials/deploy-overview.md (2)

9-9: Remove trailing whitespace
Formatting-only change; no effect on tutorial content.


11-11: Remove trailing whitespace
Minor fix to improve markdown cleanliness.

guides/gas-price.md (2)

7-11: Flag syntax and example prefix updated
The documentation correctly changes the flag from --rollkit.da_gas_price to --rollkit.da.gas_price and generalizes the binary name to ${BINARY_NAME}. This aligns with the standardized configuration reference.


19-23: Gas multiplier flag syntax and example prefix updated
The flag --rollkit.da_gas_multiplier is now --rollkit.da.gas_multiplier, and the example uses ${BINARY_NAME}. This is consistent with the new naming conventions.

tutorials/da/local-da.md (4)

10-10: Clarify tutorial scope
Updating the introduction to reference the local-da repo directly improves context for readers.


26-26: Correct flag naming in description
Refers to --rollkit.da.address, matching the new dot-notation convention.


50-52: Expanded log output for clarity
Replacing a single-line log with the full initialization sequence helps users verify all startup steps.


57-57: Add link to local-da README
Including a reference to the binary’s README enriches the summary with actionable resources.

guides/overview.md (3)

20-20: Add reset-state guide link
Including the Reset your chain's state link aligns the overview with the new unsafe-clean command guide.


23-25: Introduce EVM Rollups section
New EVM Rollups entries correctly point to the evm-based and evm-single-guide setup guides.


27-27: Consolidate configuration reference
Linking to the unified Config Settings guide replaces multiple granular config docs for consistency.

guides/evm-based.md (1)

82-94: Include --based.auth flag or clarify optionality.
In config.md, there’s a --based.auth option for DA authentication, but this example omits it. Please confirm if an auth token is required and, if so, show how to supply it here.

guides/metrics.md (2)

21-26: Verify metric name prefixes.
Block Manager metrics use rollkit_sequencer_*, while Single Sequencer metrics drop the rollkit_ prefix. Clarify whether all metrics are exposed as rollkit_<name> or adjust the documentation to reflect actual metric names.


83-89: Inconsistent default port.
This guide states the default metrics port is 26660, but config.md lists the Prometheus default as ":2112". Please verify the correct default and align both documents.

@@ -44,7 +45,7 @@ tree $HOME/.rollkit
To reset the state of the chain, delete the entire `.rollkit` directory.

```bash
rm -rf $HOME/.rollkit
${BINARY} unsafe-clean
Copy link
Contributor

Choose a reason for hiding this comment

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

🛠️ Refactor suggestion

Clarify placeholder variable
Referencing ${BINARY} without definition can confuse readers. Recommend replacing it with the actual command or explaining the placeholder:

-${BINARY} unsafe-clean
+rollkit unsafe-clean
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
${BINARY} unsafe-clean
rollkit unsafe-clean

Comment on lines +35 to 42
{BINARY} start --rollkit.da_address http://localhost:7980
```

```sh [Wordle Chain]
rollkit start \
{BINARY} start \
--rollkit.aggregator \
--rollkit.da_address http://localhost:7980 \
--rollkit.sequencer_rollup_id wordle
Copy link
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue

Inconsistent flag usage in code snippet
The snippet still uses --rollkit.da_address (underscore) but the description expects --rollkit.da.address (dot). Please update both Quick Start and Wordle Chain examples:

- {BINARY} start --rollkit.da_address http://localhost:7980
+ {BINARY} start --rollkit.da.address http://localhost:7980

-    --rollkit.da_address http://localhost:7980 \
+    --rollkit.da.address http://localhost:7980 \
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
{BINARY} start --rollkit.da_address http://localhost:7980
```
```sh [Wordle Chain]
rollkit start \
{BINARY} start \
--rollkit.aggregator \
--rollkit.da_address http://localhost:7980 \
--rollkit.sequencer_rollup_id wordle

Comment on lines +7 to +15
- [Introduction to Configurations](#introduction-to-configurations)
- [Base Configuration](#base-configuration)
- [Root Directory](#root-directory)
- [Database Path](#database-path)
- [Chain ID](#chain-id)
- [Node Configuration (`node`)](#node-configuration-node)
- [Aggregator Mode](#aggregator-mode)
- [Light Client Mode](#light-client-mode)
- [Block Time](#block-time)
Copy link
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue

Invalid TOC fragment.
The TOC references “Introduction to Configurations” (#introduction-to-configurations), but no such heading exists. Update the TOC or add/rename a corresponding section.

🧰 Tools
🪛 markdownlint-cli2 (0.17.2)

7-7: Link fragments should be valid
null

(MD051, link-fragments)


## Go DA {#go-da}
## DA {#go-da}
Copy link
Contributor

Choose a reason for hiding this comment

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

🛠️ Refactor suggestion

Align section anchor with the heading
The anchor {#go-da} no longer matches the new heading “DA.” This mismatch can break intra-doc links. Rename the anchor to {#da} (or a more descriptive identifier) to keep your links accurate.

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: 1

🧹 Nitpick comments (1)
tutorials/gm-world.md (1)

77-77: Fix missing apostrophe in text

There's a grammatical error in the instruction text.

-First lets start the local DA network:
+First let's start the local DA network:
🧰 Tools
🪛 LanguageTool

[uncategorized] ~77-~77: It seems likely that a singular genitive (’s) apostrophe is missing.
Context: ...y running the following command: First lets start the local DA network: ```bash cu...

(AI_HYDRA_LEO_APOSTROPHE_S_XS)

📜 Review details

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

📥 Commits

Reviewing files that changed from the base of the PR and between 76678c5 and 12e7aeb.

⛔ Files ignored due to path filters (2)
  • package-lock.json is excluded by !**/package-lock.json
  • yarn.lock is excluded by !**/yarn.lock, !**/*.lock
📒 Files selected for processing (6)
  • .vitepress/config.ts (4 hunks)
  • guides/overview.md (1 hunks)
  • package.json (0 hunks)
  • public/install-local-da.sh (1 hunks)
  • tutorials/gm-world.md (6 hunks)
  • tutorials/sequencing/single.md (1 hunks)
💤 Files with no reviewable changes (1)
  • package.json
✅ Files skipped from review due to trivial changes (1)
  • tutorials/sequencing/single.md
🚧 Files skipped from review as they are similar to previous changes (1)
  • guides/overview.md
🧰 Additional context used
🪛 LanguageTool
tutorials/gm-world.md

[uncategorized] ~77-~77: It seems likely that a singular genitive (’s) apostrophe is missing.
Context: ...y running the following command: First lets start the local DA network: ```bash cu...

(AI_HYDRA_LEO_APOSTROPHE_S_XS)

🔇 Additional comments (20)
public/install-local-da.sh (1)

8-8: Updated build command for local-da

The build command was updated from make build to make build-da to align with the updated build targets in the Rollkit repository.

tutorials/gm-world.md (15)

32-32: Updated tooling from Kurtosis to Ignite

The tutorial now uses Ignite instead of Kurtosis for managing services, which aligns with the broader documentation update toward Ignite-based workflows.


37-52: Updated version verification command output

The output example for Ignite's version command provides clear information about the installed version and system requirements.


57-59: Updated chain generation commands

The chain generation now uses Ignite's scaffolding commands instead of previous Kurtosis-based approach.


61-71: Added Ignite app installation steps

New steps have been added for installing a specific version of the Ignite Rollkit app from GitHub, followed by local installation.


73-76: Updated rollup startup section

The section clearly introduces the updated workflow for launching the GM rollup with the local DA network.


80-80: Updated local DA installation command

The command now uses the installation script from rollkit.dev, including a version tag from constants.


86-89: Updated local DA log example

The log output example has been updated to reflect the current behavior of the local DA implementation.


94-94: Updated rollup start command

The command now directly uses gmd start with the Rollkit aggregator flag instead of running inside a Docker container.


99-124: Updated log output example

The updated log output provides a comprehensive example of what users should expect when starting their rollup with the new command.


126-127: Updated port information

The documentation now correctly reflects the ports used by the GM rollup (7331) and local DA network (7980).


135-136: Updated CLI command for key listing

The command has been updated to use gmd keys list instead of the previous approach.


161-161: Updated transaction submission command

The command now uses gmd tx bank send with appropriate flags for the new tooling.


204-204: Updated balance query command

The command has been updated to use gmd query bank balances instead of the previous approach.


221-221: Updated second balance query command

Consistent update to use gmd query bank balances for checking the sender's balance.


235-253: Commented out UI app section

The GM world UI app section related to Kurtosis has been commented out since it's no longer applicable with the move to Ignite-based workflow.

.vitepress/config.ts (4)

220-220: Updated "Build a chain" tutorial link

The tutorial link has been updated from "/tutorials/wordle" to "/tutorials/gm-world" to reflect the documentation restructuring.


248-249: Consolidated sequencing tutorials

The "Local" and "Centralized" sequencing tutorials have been replaced with a single "Single" tutorial, simplifying the documentation structure.


270-270: Commented out RETH EVM tutorial link

The RETH EVM tutorial link has been commented out, likely because it's not ready or being replaced.


321-321: Consolidated configuration guides

The configuration guides have been consolidated into a single "/guides/config" link instead of multiple separate guides, simplifying the documentation structure.

@@ -1,10 +1,10 @@
#!/bin/bash

echo "Downloading Local-DA source code..."
git clone https://github.com/rollkit/local-da.git
git clone https://github.com/rollkit/rollkit.git
Copy link
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue

Repository change for local-da script

The script now clones from the Rollkit repository instead of the previously used local-da repository.

There's a potential issue: after cloning the rollkit repository on line 4, the script attempts to cd into local-da on line 5, which might not exist in the new repository structure. This could cause the script to fail.

-git clone https://github.com/rollkit/rollkit.git
+git clone https://github.com/rollkit/rollkit.git
+cd rollkit || { echo "Failed to find the downloaded repository"; exit 1; }
-cd local-da || { echo "Failed to find the downloaded repository"; exit 1; }

Run this script to verify the repository structure:

#!/bin/bash
# Check if the local-da directory exists in the rollkit repository
git clone https://github.com/rollkit/rollkit.git temp-rollkit
if [ -d "temp-rollkit/local-da" ]; then
  echo "local-da directory exists in the rollkit repository"
else
  echo "local-da directory does NOT exist in the rollkit repository"
  echo "Directory structure:"
  find temp-rollkit -type d -maxdepth 1
fi
rm -rf temp-rollkit

@julienrbrt julienrbrt self-requested a review May 13, 2025 22:33
Copy link
Member

@Manav-Aggarwal Manav-Aggarwal left a comment

Choose a reason for hiding this comment

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

Left some comments, a lot of guides/pages are still not linked correctly. Not sure if you've run it with yarn run docs:dev yet.

Also, any reason we got rid of the Rollkit CLI that makes the binary be rollkit instead? Part of the reason we did this is to have a notion of rollkit start just like celestia light start exists for a quick-start guide.

Comment on lines 1 to 15
# Rollup Full Node Setup Guide

## Introduction

This guide covers how to set up a full node to run alongside a sequencer node in a Rollkit-based blockchain network. A full node maintains a complete copy of the blockchain and helps validate transactions, improving the network's decentralization and security.

## Prerequisites

Before starting, ensure you have:

- A local Data Availability (DA) network node running on port `7980`.
- A Rollkit sequencer node running and posting blocks to the DA network.
- The Rollkit CLI installed on your system.

## Setting Up Your Full Node
Copy link
Member

Choose a reason for hiding this comment

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

Any reason we're getting rid of a full node guide?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

was going to add it back in a follow up but ill do it quickly here

Copy link
Contributor Author

Choose a reason for hiding this comment

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

ah now i remember i removed it cause all nodes are full node, this guis is full node along side a sequencer so it doesnt make sense, Ill rework it to make sense if we want to keep it

@@ -0,0 +1,162 @@
# Rollkit EVM Single Sequencer Setup Guide
Copy link
Member

Choose a reason for hiding this comment

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

Can't access this anywhere from the sidebar

Comment on lines 6 to 10
The gas price can also be configured manually with the flag
`--rollkit.da_gas_price`:
`--rollkit.da.gas_price`:

```bash
rollkit start --rollkit.da_gas_price=0.1 [existing flags...]
${BINARY_NAME} start --rollkit.da.gas_price=0.1 [existing flags...]
Copy link
Member

Choose a reason for hiding this comment

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

Not accessible from sidebar

Copy link
Contributor Author

Choose a reason for hiding this comment

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

removed the file since its covered in config

Comment on lines -1 to -8
# Quick Start Guide for Artela EVM++ with Rollkit

<!-- markdownlint-disable MD033 -->
<script setup>
import Callout from '../../.vitepress/components/callout.vue'
import ExecutionCallout from '../../.vitepress/components/execution_callout.vue'
import constants from '../../.vitepress/constants/constants.js'
</script>
Copy link
Member

Choose a reason for hiding this comment

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

May be we can move this under v0.13.x since some users are still on Artela?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

hmm there are no version docs. will create a v0.13 section.

@Manav-Aggarwal
Copy link
Member

Manav-Aggarwal commented May 16, 2025

This single sequencer page is empty with this PR

image

I also receive a 404 for http://localhost:5173/tutorials/execution/evm-contract-interaction

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

🔭 Outside diff range comments (1)
.vitepress/config.ts (1)

133-134: 🛠️ Refactor suggestion

Consider implementing redirects for changed or removed pages.

With the significant navigation changes in this PR, users following older documentation links may encounter 404 errors. Consider implementing redirects from old URLs to their new locations to ensure a smooth user experience during this transition.

sidebar: {
  "/": sidebarHome(),
+  // Add redirects for changed pages
+  // This can be done using VitePress aliases or server-side redirects
},
📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro
Cache: Disabled due to data retention organization setting
Knowledge Base: Disabled due to data retention organization setting

📥 Commits

Reviewing files that changed from the base of the PR and between a9abd94 and c8a81f8.

📒 Files selected for processing (1)
  • .vitepress/config.ts (5 hunks)
🔇 Additional comments (2)
.vitepress/config.ts (2)

220-220:

✅ Verification successful

Verify that the new "Build a chain" tutorial exists and is complete.

The "Build a chain" tutorial link has been updated from "/tutorials/wordle" to "/tutorials/gm-world". Ensure this new tutorial is complete and provides equivalent or improved functionality compared to the previous tutorial.


🏁 Script executed:

#!/bin/bash
# Check if the new gm-world tutorial exists and has content
if [ -f "tutorials/gm-world.md" ]; then
  echo "New tutorial exists. Checking content..."
  content_size=$(wc -c < "tutorials/gm-world.md")
  if [ "$content_size" -lt 500 ]; then
    echo "WARNING: New tutorial exists but may not have sufficient content (size: $content_size bytes)"
  else
    echo "New tutorial has content (size: $content_size bytes)"
  fi
  
  # Check if old tutorial existed
  if [ -f "tutorials/wordle.md" ]; then
    echo "Old tutorial still exists, consider adding a redirect"
  else
    echo "Old tutorial has been removed"
  fi
else
  echo "ERROR: New tutorial does not exist!"
fi

Length of output: 376


Verified “Build a chain” tutorial availability and completeness

  • The new tutorial at tutorials/gm-world.md exists and contains 9 078 bytes of content, indicating a full write-up.
  • The old tutorials/wordle.md has been removed, so there’s no stale content to redirect.

All set—the link update to /tutorials/gm-world is correct and complete.


321-334:

❓ Verification inconclusive

Verify all consolidated configuration guides are completed.

The configuration section has been significantly restructured from multiple detailed guides to a consolidated approach with additional EVM-specific guides. Ensure that all the content from the previous guides has been properly migrated to the new structure to avoid information loss.


🏁 Script executed:

#!/bin/bash
# Check if all the new configuration guides exist and have content
files_to_check=("guides/config.md" "guides/evm-single.md" "guides/evm-based.md" "guides/metrics.md")

for file in "${files_to_check[@]}"; do
  if [ -f "$file" ]; then
    echo "$file exists. Checking content..."
    content_size=$(wc -c < "$file")
    if [ "$content_size" -lt 100 ]; then
      echo "WARNING: $file exists but may not have sufficient content (size: $content_size bytes)"
    else
      echo "$file has content (size: $content_size bytes)"
    fi
  else
    echo "ERROR: $file does not exist!"
  fi
done

# Look for old config guides that might need to be migrated
echo "Looking for old configuration guides that might need content migration..."
find guides -name "*.md" -type f -exec grep -l "Configuration" {} \;

Length of output: 1843


Verify consolidated configuration guides content migration

The four new guides (guides/config.md, guides/evm-single.md, guides/evm-based.md, guides/metrics.md) all exist and contain substantial content (4–22 KB each). To avoid any information loss, please manually cross-check and ensure that all relevant configuration details from the legacy guides have been fully migrated into this new structure. Legacy files referencing “Configuration” that may need review:

  • guides/cometbft-to-rollkit.md
  • guides/ignite-rollkit.md
  • guides/use-tia-for-gas.md
  • guides/overview.md

Ensure any unique sections from these are summarized or integrated in the consolidated guides.

Comment on lines +248 to 250
text: "Single",
link: "/tutorials/sequencing/single",
},
Copy link
Contributor

Choose a reason for hiding this comment

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

💡 Verification agent

🧩 Analysis chain

Fix the empty "single sequencer" page.

According to the PR comments, the "single sequencer" page is empty, but it's being linked here in the navigation. Ensure that the content for /tutorials/sequencing/single is properly implemented before merging this PR.


🏁 Script executed:

#!/bin/bash
# Check if the single sequencer page exists and has content
if [ -f "tutorials/sequencing/single.md" ]; then
  echo "File exists. Checking content..."
  content_size=$(wc -c < tutorials/sequencing/single.md)
  if [ "$content_size" -lt 100 ]; then
    echo "WARNING: File exists but may not have sufficient content (size: $content_size bytes)"
  else
    echo "File has content (size: $content_size bytes)"
  fi
else
  echo "ERROR: File does not exist!"
fi

Length of output: 323


Implement content for the “Single Sequencer” tutorial page

Our verification shows that while the navigation entry in .vitepress/config.ts correctly links to /tutorials/sequencing/single, the target file is essentially empty:

  • File: tutorials/sequencing/single.md
    • Exists but only ~19 bytes in size (placeholder)

Please populate single.md with the full tutorial content (overview, code examples, explanations, etc.) before merging this PR.

🤖 Prompt for AI Agents
In .vitepress/config.ts around lines 248 to 250, the navigation links to the
"single sequencer" tutorial page at /tutorials/sequencing/single, but the
corresponding markdown file tutorials/sequencing/single.md is nearly empty with
only a placeholder. To fix this, fully implement the content of single.md by
adding a comprehensive tutorial including an overview, code examples, and
explanations so that the linked page is not empty and provides value to users.

Comment on lines +299 to +302
{
text: "Run a Full Node",
link: "/guides/full-node",
},
Copy link
Contributor

Choose a reason for hiding this comment

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

💡 Verification agent

🧩 Analysis chain

Confirm "Run a Full Node" guide is appropriately updated.

The guide appears to have been renamed from "Use the Rollkit CLI" to "Run a Full Node". Ensure that the content has been updated accordingly and provides clear instructions for users.


🏁 Script executed:

#!/bin/bash
# Check if the full-node guide exists and has been recently updated
if [ -f "guides/full-node.md" ]; then
  echo "Guide exists. Checking last modification date..."
  stat -c "%y" "guides/full-node.md"
  
  echo "Checking for references to 'Rollkit CLI' that might need updating..."
  grep -n "Rollkit CLI" "guides/full-node.md" || echo "No direct references to 'Rollkit CLI' found"
else
  echo "ERROR: Guide does not exist!"
fi

Length of output: 511


Replace remaining “Rollkit CLI” reference in the Full Node guide

There’s still one reference to “Rollkit CLI” in guides/full-node.md that needs updating to match the new “Run a Full Node” narrative:

  • guides/full-node.md:13
    Current:
    - The Rollkit CLI installed on your system.
    Should be revised to reflect your full-node setup instructions (e.g., “Your full-node software installed on your system”).
🤖 Prompt for AI Agents
In .vitepress/config.ts around lines 299 to 302, the link text "Run a Full Node"
is correct but the associated guide file guides/full-node.md still contains an
outdated reference to "Rollkit CLI" on line 13. Update that line in
guides/full-node.md to replace "The Rollkit CLI installed on your system." with
a phrase consistent with the new guide title, such as "Your full-node software
installed on your system," to ensure the content matches the updated narrative.

Comment on lines +266 to +272
// {
// text: "EVM",
// collapsed: true,
// items: [
// // { text: "RETH EVM", link: "/tutorials/execution/reth-evm" },
// ],
// },
Copy link
Contributor

Choose a reason for hiding this comment

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

💡 Verification agent

🧩 Analysis chain

Resolve 404 error for EVM contract interaction page.

The commented-out EVM section is causing a 404 error when attempting to access the URL http://localhost:5173/tutorials/execution/evm-contract-interaction as reported in the PR comments. Either:

  1. Restore the EVM section with proper links, or
  2. Add redirects to guide users to the new content location

This is particularly important since the navigation changes might confuse users looking for EVM documentation.


🏁 Script executed:

#!/bin/bash
# Check if the EVM contract interaction page exists
if [ -f "tutorials/execution/evm-contract-interaction.md" ]; then
  echo "File exists"
else
  echo "File does not exist, checking for potential redirects..."
  grep -r "evm-contract-interaction" --include="*.md" .
fi

Length of output: 237


🏁 Script executed:

#!/bin/bash
# Verify existence and list contents of the 'tutorials' directory
echo "Checking for 'tutorials' directory at project root..."
if find . -maxdepth 2 -type d | grep -q "^./tutorials$"; then
  echo "✔ 'tutorials' directory found. Contents:"
  ls -1 tutorials
else
  echo "✖ 'tutorials' directory not found at project root."
fi

# Verify existence and list contents of 'tutorials/execution'
echo
echo "Checking for 'tutorials/execution' directory..."
if [ -d "tutorials/execution" ]; then
  echo "✔ 'tutorials/execution' directory found. Contents:"
  ls -1 tutorials/execution
else
  echo "✖ 'tutorials/execution' directory not found."
fi

Length of output: 700


🏁 Script executed:

#!/bin/bash
# Search for any markdown files with 'evm' in their filename
echo "Looking for EVM-related markdown files..."
find . -type f -iname "*evm*.md" 2>/dev/null

echo
# Search for any directories with 'evm' in their name
echo "Looking for EVM-related directories..."
find . -type d -iname "*evm*" 2>/dev/null

echo
# Inspect references to 'evm' in the VitePress config
echo "Scanning .vitepress/config.ts for 'evm' references..."
rg -n "evm" --ignore-case .vitepress/config.ts || echo "No matches found in config.ts"

Length of output: 847


Restore EVM section in sidebar and point to new guide paths

The tutorials/execution/evm-contract-interaction page no longer exists—EVM content has moved under guides. Instead of leaving the EVM block commented out, re-enable it and update its links to the new locations.

• File: .vitepress/config.ts
• Lines: ~266–272

Suggested replacement for the commented block:

{
  text: "EVM",
  collapsed: true,
  items: [
    { text: "EVM Single Sequencer", link: "/guides/evm-single" },
    { text: "EVM Based Sequencer",  link: "/guides/evm-based" },
  ],
},

This will restore the EVM section in the sidebar and eliminate the 404 error when users navigate to EVM docs.

🤖 Prompt for AI Agents
In .vitepress/config.ts around lines 266 to 272, the EVM sidebar section is
commented out and points to outdated tutorial links causing 404 errors. To fix
this, uncomment the EVM block and update its items array to reference the new
guide paths: "/guides/evm-single" and "/guides/evm-based" with appropriate text
labels. This will restore the EVM section in the sidebar and prevent navigation
errors.

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: 1

♻️ Duplicate comments (1)
tutorials/da/overview.md (1)

15-15: Align section anchor with heading
The anchor {#go-da} does not match the heading “DA,” which can break intra-doc links. Please rename the anchor to {#da} (or a more descriptive identifier) to keep your links accurate.

🧹 Nitpick comments (8)
tutorials/gm-world.md (4)

33-33: Use descriptive link text
Avoid “here” as link text. For accessibility and clarity, revise to something like:

You can install Ignite by following the official installation guide.

38-53: Sanitize example CLI output
The ignite version output includes machine‐specific details (Your cwd, uname -a) that aren’t relevant to most readers and may expose private info. Consider truncating to only the most important fields (version, build date, SDK version).


55-55: Add an anchor ID for consistency
This heading lacks a {#generate-your-app} anchor like other sections. Adding it will ensure consistent sidebar/navigation links:

- ## Generate your App
+ ## Generate your App {#generate-your-app}

236-254: Correct commented‐out UI section syntax
The HTML comment start (<!--) and end (::: -->) do not match, which can break parsing. Either remove this entire block or wrap it properly using:

<!--
## 📦 GM world UI app
…content…
-->
tutorials/da/overview.md (4)

13-13: Refine core DA interface link
The hyperlink includes a hard-coded line number (#L11) which may become outdated as the interface evolves. Consider linking to the file root or to a stable documentation anchor instead.

-Rollkit uses the [core da interface](https://github.com/rollkit/rollkit/blob/main/core/da/da.go#L11) to communicate to DA layers.
+Rollkit uses the [core DA interface](https://github.com/rollkit/rollkit/blob/main/core/da/da.go) to communicate to DA layers.

17-17: Update reference to key interface methods
The text still highlights only Get and Submit as the most important functions, but the interface now includes many more methods (e.g., MaxBlobSize, GetIDs, Commit, Validate, etc.). Consider updating this sentence to reflect the broader set of operations supported.


22-23: Standardize GoDoc comment style
The comment “MaxBlobSize returns the max blob size” should use “maximum” instead of “max” and end with a period for consistency with GoDoc conventions.

- // MaxBlobSize returns the max blob size
+ // MaxBlobSize returns the maximum blob size.

60-60: Fix punctuation for clarity
Add a comma to improve readability:

- DA layers can integrate the `DA` interface directly into their node like [Celestia DA](celestia-da.md).
+ DA layers can integrate the `DA` interface directly into their node, like [Celestia DA](celestia-da.md).
🧰 Tools
🪛 LanguageTool

[uncategorized] ~60-~60: Possible missing comma found.
Context: ... the DA interface directly into their node like Celestia DA. ##...

(AI_HYDRA_LEO_MISSING_COMMA)

📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro
Cache: Disabled due to data retention organization setting
Knowledge Base: Disabled due to data retention organization setting

📥 Commits

Reviewing files that changed from the base of the PR and between c8a81f8 and a9d7e1f.

📒 Files selected for processing (2)
  • tutorials/da/overview.md (1 hunks)
  • tutorials/gm-world.md (7 hunks)
🧰 Additional context used
🪛 GitHub Actions: Deploy PR previews
tutorials/gm-world.md

[error] 4-4: [vitepress] YAML parsing error: end of the stream or a document separator is expected at line 4, column 12 in frontmatter. This caused the build to fail.

🪛 GitHub Actions: Build VitePress Site
tutorials/gm-world.md

[error] 4-4: Vitepress build error: YAML frontmatter parsing failed - end of the stream or a document separator is expected at line 4, column 12.

🪛 LanguageTool
tutorials/da/overview.md

[uncategorized] ~60-~60: Possible missing comma found.
Context: ... the DA interface directly into their node like Celestia DA. ##...

(AI_HYDRA_LEO_MISSING_COMMA)

🔇 Additional comments (3)
tutorials/gm-world.md (1)

81-82: Verify dynamic constant interpolation
You’re using {{constants.localDALatestTag}} inside a fenced code block. Confirm that VitePress will render this value instead of displaying the raw template. If it doesn’t resolve, consider using a <CodeBlock> component or preprocessing the file.

tutorials/da/overview.md (2)

19-57: DA interface expanded comprehensively
Great to see the interface definitions fleshed out with additional methods for commitment creation, proof retrieval, validation, and gas configuration. This provides clearer guidance for implementers.


60-60:

✅ Verification successful

Verify Celestia DA tutorial link
Ensure the celestia-da.md file exists and is correctly linked; otherwise, this will lead to a broken page.


🏁 Script executed:

#!/bin/bash
# Verify that the Celestia DA tutorial exists
fd celestia-da.md tutorials/da

Length of output: 60


Celestia DA link verified
The file tutorials/da/celestia-da.md exists, so the link in tutorials/da/overview.md (line 60) is valid. No changes required.

🧰 Tools
🪛 LanguageTool

[uncategorized] ~60-~60: Possible missing comma found.
Context: ... the DA interface directly into their node like Celestia DA. ##...

(AI_HYDRA_LEO_MISSING_COMMA)

Comment on lines 1 to 5
---
description: Build a sovereign rollup using only Rollkit CLI and a local DA network.
---
++ b/tutorials/gm-world.md
@@ 1,3
description: Build a sovereign rollup using Ignite, the `gmd` CLI, and a local DA network.

Copy link
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue

Fix YAML frontmatter formatting
The current frontmatter block is invalid—lines like ++ b/tutorials/gm-world.md and @@ 1,3 are Git diff artifacts and must be removed. Also, ensure you have a closing --- after your metadata. A minimal valid example:

---
title: "GM world rollup"
description: "Build a sovereign rollup using Ignite, the `gmd` CLI, and a local DA network."
---
🧰 Tools
🪛 GitHub Actions: Deploy PR previews

[error] 4-4: [vitepress] YAML parsing error: end of the stream or a document separator is expected at line 4, column 12 in frontmatter. This caused the build to fail.

🪛 GitHub Actions: Build VitePress Site

[error] 4-4: Vitepress build error: YAML frontmatter parsing failed - end of the stream or a document separator is expected at line 4, column 12.

🤖 Prompt for AI Agents
In tutorials/gm-world.md around lines 1 to 5, remove all Git diff artifacts such
as '++ b/tutorials/gm-world.md' and '@@ 1,3' from the YAML frontmatter. Ensure
the frontmatter starts and ends with '---' lines and contains only valid YAML
key-value pairs like title and description. Add a closing '---' after the
metadata to properly close the frontmatter block.

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