Merge pull request #823 from richardgreg/span-batches

docs: Add Chain Operator Feature: Span Batches

Author: krofax

pages/builders/chain-operators/features/_meta.json

@@ -2,5 +2,6 @@
     "preinstalls": "Preinstalls",
     "alt-da-mode": "Run an Alt-DA Mode Chain",
     "custom-gas-token": "Run a Custom Gas Token Chain",
+    "span-batches": "Use and Enable Span Batches on your Chain",
     "bridged-usdc-standard": "Bridged USDC Standard for the OP Stack"
 }

pages/builders/chain-operators/features/span-batches.mdx

@@ -0,0 +1,49 @@
+---
+title: Span Batches
+lang: en-US
+description: Learn how to use and enable span batches on your chain.
+---
+
+import { Callout, Steps } from 'nextra/components'
+
+# Span Batches
+
+Span batches are an important feature that optimizes batch processing within the chain. This section provides an overview of span batches, instructions on how to enable them, and links to detailed design documents.
+
+## Overview
+
+Span batches allow for efficient processing of multiple batches in a single operation, reducing overhead and improving performance. By grouping transactions together, span batches can help optimize the throughput of the network.
+
+## Enabling Span Batches
+
+To enable span batches, follow these steps:
+
+<Steps>
+  1.  **Configuration**:
+
+      *   Locate your chain configuration file.
+      *   Add or update the following settings to enable span batches:
+
+      ```yaml
+      span_batches:
+          enabled: true
+          max_batch_size: <desired_max_batch_size>  # Set your desired maximum batch size
+          batch_interval: <desired_batch_interval>  # Set your desired batch interval in seconds
+      ```
+
+  2.  **Deploy**:
+
+      *   After updating the configuration, redeploy your chain node to apply the changes.
+
+  3.  **Verify**:
+
+      *   Check the logs to ensure that span batches are enabled and functioning correctly.
+      *   You should see log entries indicating that batches are being processed according to the configured settings.
+</Steps>
+
+## Links to Related Pages
+
+For more detailed information on the design and implementation of span batches, refer to the following resources:
+
+*   [Span Batches Specification](https://specs.optimism.io/protocol/delta/span-batches.html#span-batches)
+*   [Span Batch Design Docs](https://op-tip.notion.site/Span-Batch-Design-Docs-b85e599a47774dcdb8171cc84cab2476)