Skip to content

Conversation

niran
Copy link

@niran niran commented Oct 1, 2025

Introduces a shadow block building stack that runs in parallel with the production sequencer for testing purposes. The builder syncs from production but does not submit blocks to L1, making it safe for testing TIPS bundle integration.

Changes:

  • Add builder-cl and builder services to docker-compose.yml
    • builder-cl: op-node in sequencer mode syncing from production via P2P
    • builder: op-rbuilder instance that queries TIPS datastore and builds blocks with eligible bundles (blocks are not submitted to L1)
  • Add build-rbuilder command to justfile for building op-rbuilder Docker image with TIPS datastore integration
  • Consolidate op-node environment configuration into .env.example and use env_file in docker-compose.yml to share common config between simulator-cl and builder-cl
  • Update justfile commands to support multiple compose profiles
    • Rename start-playground to start-builder
    • Update stop-all/start-all to accept comma-separated profiles
  • Document simulator and shadow block builder stack in README.md with prerequisites and quick start instructions

niran added 7 commits October 1, 2025 11:27
Introduces a shadow block building stack that runs in parallel with the production sequencer for testing purposes. The builder syncs from production but does not submit blocks to L1, making it safe for testing TIPS bundle integration.

Changes:
- Add builder-cl and builder services to docker-compose.yml
  - builder-cl: op-node in sequencer mode syncing from production via P2P
  - builder: op-rbuilder instance that queries TIPS datastore and builds
    blocks with eligible bundles (blocks are not submitted to L1)
- Add build-rbuilder command to justfile for building op-rbuilder Docker
  image with TIPS datastore integration
- Consolidate op-node environment configuration into .env.example and use
  env_file in docker-compose.yml to share common config between
  simulator-cl and builder-cl
- Update justfile commands to support multiple compose profiles
  - Rename start-playground to start-builder
  - Update stop-all/start-all to accept comma-separated profiles
- Document simulator and shadow block builder stack in README.md with
  prerequisites and quick start instructions
Replace BundleWithLatestSimulation struct with a simple tuple
(BundleWithMetadata, Simulation) for select_bundles_with_latest_simulation
return values.

This eliminates awkward naming in consuming code by allowing direct
destructuring instead of verbose field access patterns like
`result.bundle_with_metadata.bundle.block_number`.
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.

1 participant