Configure

Shiroi integration is configured via standard solana-validator flags.

All standard solana-validator parameters are supported. Shiroi introduces a minimal set of additional, optional flags that enable interaction with external block builders.

No protocol, consensus, or execution flags are modified.

Required configuration

To enable external block building, the validator must be configured with a Block Builder endpoint.

Block builder endpoint

--block-builder-url <BBM_URL>

This flag specifies the URL of the external Block Builder Module (BBM) that provides ready-to-propose blocks.

The validator will attempt to fetch complete blocks from this endpoint during its proposer slots.

Example invocation

./agave-validator \
  --block-builder-url https://bbm.shiroi.example \
  # ... all standard solana-validator configuration flags

All other validator configuration (identity, ledger, voting, networking, RPC, etc.) remains unchanged.

Optional behavior

If the block builder is unavailable or fails to deliver a valid block:

  • the validator continues operating normally

  • standard block production behavior applies

  • no liveness dependency on BBM is introduced

Integration with Shiroi is additive and fail-safe.

Last updated