feat: add configurable RPC concurrency via RPC_CONCURRENCY env var

Cargo.toml

@@ -26,7 +26,7 @@ edition = "2021"
 authors = ["ratankaliani", "zachobront", "fakedev9999", "yuwen01"]
 homepage = "https://succinctlabs.github.io/op-succinct/"
 repository = "https://github.com/succinctlabs/op-succinct"
-version = "3.4.0-rc.1"
+version = "3.4.0"
 
 [workspace.dependencies]
 # general
@@ -102,15 +102,15 @@ hana-host = { git = "https://github.com/celestiaorg/hana", tag = "v1.4.0-mocha"
 hana-oracle = { git = "https://github.com/celestiaorg/hana", tag = "v1.4.0-mocha" }
 
 # hokulea
-hokulea-compute-proof = { git = "https://github.com/Layr-Labs/hokulea", rev = "a465144d9b3fc5202898b320ed7573c5e5922ac5" }
-hokulea-eigenda = { git = "https://github.com/Layr-Labs/hokulea", rev = "a465144d9b3fc5202898b320ed7573c5e5922ac5" }
-hokulea-host-bin = { git = "https://github.com/Layr-Labs/hokulea", rev = "a465144d9b3fc5202898b320ed7573c5e5922ac5" }
-hokulea-proof = { git = "https://github.com/Layr-Labs/hokulea", rev = "a465144d9b3fc5202898b320ed7573c5e5922ac5" }
-hokulea-witgen = { git = "https://github.com/Layr-Labs/hokulea", rev = "a465144d9b3fc5202898b320ed7573c5e5922ac5" }
-hokulea-zkvm-verification = { git = "https://github.com/Layr-Labs/hokulea", rev = "a465144d9b3fc5202898b320ed7573c5e5922ac5" }
-canoe-sp1-cc-host = { git = "https://github.com/Layr-Labs/hokulea", rev = "a465144d9b3fc5202898b320ed7573c5e5922ac5" }
-canoe-sp1-cc-verifier = { git = "https://github.com/Layr-Labs/hokulea", rev = "a465144d9b3fc5202898b320ed7573c5e5922ac5" }
-canoe-verifier-address-fetcher = { git = "https://github.com/Layr-Labs/hokulea", rev = "a465144d9b3fc5202898b320ed7573c5e5922ac5" }
+hokulea-compute-proof = { git = "https://github.com/Layr-Labs/hokulea", tag = "hokulea-client/v1.1.2" }
+hokulea-eigenda = { git = "https://github.com/Layr-Labs/hokulea", tag = "hokulea-client/v1.1.2" }
+hokulea-host-bin = { git = "https://github.com/Layr-Labs/hokulea", tag = "hokulea-client/v1.1.2" }
+hokulea-proof = { git = "https://github.com/Layr-Labs/hokulea", tag = "hokulea-client/v1.1.2" }
+hokulea-witgen = { git = "https://github.com/Layr-Labs/hokulea", tag = "hokulea-client/v1.1.2" }
+hokulea-zkvm-verification = { git = "https://github.com/Layr-Labs/hokulea", tag = "hokulea-client/v1.1.2" }
+canoe-sp1-cc-host = { git = "https://github.com/Layr-Labs/hokulea", tag = "hokulea-client/v1.1.2" }
+canoe-sp1-cc-verifier = { git = "https://github.com/Layr-Labs/hokulea", tag = "hokulea-client/v1.1.2" }
+canoe-verifier-address-fetcher = { git = "https://github.com/Layr-Labs/hokulea", tag = "hokulea-client/v1.1.2" }
 
 # op-succinct
 op-succinct-prove = { path = "scripts/prove" }

book/fault_proofs/proposer.md

@@ -78,6 +78,7 @@ Depending on the one you choose, you must provide the corresponding environment
 
 | Variable | Description | Default Value |
 |----------|-------------|---------------|
+| `RPC_CONCURRENCY` | Maximum number of concurrent RPC requests. Lower this value (e.g., `3`-`5`) if hitting 429 rate limit errors. | `10` |
 | `L1_CONFIG_DIR` | The directory containing the L1 chain configuration files. | `<project-root>/configs/L1` |
 | `L2_CONFIG_DIR` | Directory containing L2 chain configuration files | `<project-root>/configs/L2` |
 | `MOCK_MODE` | Whether to use mock mode | `false` |

book/troubleshooting.md

@@ -48,3 +48,38 @@ let l1_head_number = l1_head_number + 100;
 The error occurs in the derivation pipeline when attempting to validate L2 blocks. The L1 head must be sufficiently ahead of the batch posting block to ensure all required data is available and the safe head state is consistent. The buffer of 20 blocks is added empirically to handle most cases where RPCs may have an incorrect view of the safe head state and have minimum overhead for the derivation process.
 
 Reference: [Fetcher Implementation](https://github.com/succinctlabs/op-succinct/blob/5dfc43928c75cef0ebf881d10bd8b3dcbe273419/utils/host/src/fetcher.rs#L773)
+
+### RPC Rate Limit Errors (429)
+
+**Error Message:**
+
+```text
+error code 429: Too Many Requests
+```
+
+or
+
+```text
+rate limit exceeded
+```
+
+**Cause:**
+This error occurs when your RPC provider is rate-limiting requests due to too many concurrent calls. OP Succinct makes concurrent RPC requests to fetch block data efficiently, which can exceed the limits of free or low-tier RPC plans.
+
+**Solution:**
+Set the `RPC_CONCURRENCY` environment variable to a lower value:
+
+```bash
+# For low-tier RPC plans, try 3-5 concurrent requests
+export RPC_CONCURRENCY=5
+
+# For very restrictive plans
+export RPC_CONCURRENCY=3
+```
+
+The default is `10` concurrent requests. Reducing this value will make operations slower but more reliable for rate-limited RPC endpoints.
+
+**Recommendations:**
+- Free RPC tiers: Set `RPC_CONCURRENCY=3`
+- Basic paid tiers: Set `RPC_CONCURRENCY=5`
+- Professional tiers: Default `10` should work, or increase for faster performance

book/validity/proposer.md

@@ -39,6 +39,7 @@ Before starting the proposer, ensure you have deployed the relevant contracts an
 | Parameter | Description |
 |-----------|-------------|
 | `L1_BEACON_RPC` | L1 Consensus (Beacon) Node. Could be required for integrations that access consensus-layer data. |
+| `RPC_CONCURRENCY` | Default: `10`. Maximum number of concurrent RPC requests. Lower this value (e.g., `3`-`5`) if you're hitting 429 rate limit errors from your RPC provider. |
 | `NETWORK_RPC_URL` | Default: `https://rpc.production.succinct.xyz`. RPC URL for the Succinct Prover Network. |
 | `DATABASE_URL` | Default: `postgres://op-succinct@postgres:5432/op-succinct`. The address of a Postgres database for storing the intermediate proposer state. |
 | `L1_CONFIG_DIR` | Default: `<project-root>/configs/L1`. The directory containing the L1 chain configuration files. |