Optimism Documentation

This page catalogues every configuration option for the op-batcher, the service that posts L2 sequencer data to L1 to make it available for verifiers. The options are from the --help in v1.10.0. For guidance on choosing values — the batcher policy, cost tuning, multi-blob transactions, and sequencer throttling — see the batcher configuration guide.

Batch generation

batch-type

The batch type. 0 for SingularBatch and 1 for SpanBatch. The default value is 0 for SingularBatch. See the span batch feature page to learn more.

Syntax
Example
Environment Variable

--batch-type=<value>

--batch-type=singular

OP_BATCHER_BATCH_TYPE=

max-blocks-per-span-batch

Maximum number of blocks to add to a span batch. The default value is 0, meaning no maximum.

Syntax
Example
Environment Variable

--max-blocks-per-span-batch=<value>

--max-blocks-per-span-batch=0

OP_BATCHER_MAX_BLOCKS_PER_SPAN_BATCH=0

compression-algo

The compression algorithm to use. Valid options: zlib, brotli, brotli-9, brotli-10, brotli-11. The default value is zlib.

Syntax
Example
Environment Variable

--compression-algo=<value>

--compression-algo=zlib

OP_BATCHER_COMPRESSION_ALGO=zlib

compressor

The type of compressor. Valid options: none, ratio, shadow. The default value is shadow.

Syntax
Example
Environment Variable

--compressor=<value>

--compressor=shadow

OP_BATCHER_COMPRESSOR=shadow

approx-compr-ratio

Only relevant for ratio compressor. The approximate compression ratio (<=1.0). The default value is 0.6.

Syntax
Example
Environment Variable

--approx-compr-ratio=<value>

--approx-compr-ratio=0.6

OP_BATCHER_APPROX_COMPR_RATIO=0.6

poll-interval

How frequently to poll L2 for new blocks. The default value is 6s.

Syntax
Example
Environment Variable

--poll-interval=<value>

--poll-interval=6s

OP_BATCHER_POLL_INTERVAL=6s

Batch submission

data-availability-type

Setting this flag to auto will allow the batcher to automatically switch between calldata and blobs based on the current L1 gas price.

The data availability type to use for submitting batches to the L1. Valid options: calldata, blobs, and auto. The default value is calldata.

Syntax
Example
Environment Variable

--data-availability-type=<value>

--data-availability-type=calldata

OP_BATCHER_DATA_AVAILABILITY_TYPE=calldata

target-num-frames

The target number of frames to create per channel. Controls number of blobs per blob tx, if using Blob DA. The default value is 1.

Syntax
Example
Environment Variable

--target-num-frames=<value>

--target-num-frames=1

OP_BATCHER_TARGET_NUM_FRAMES=1

max-channel-duration

The maximum duration of L1-blocks to keep a channel open. 0 to disable. The default value is 0.

Syntax
Example
Environment Variable

--max-channel-duration=<value>

--max-channel-duration=0

OP_BATCHER_MAX_CHANNEL_DURATION=0

sub-safety-margin

The batcher tx submission safety margin (in #L1-blocks) to subtract from a channel’s timeout and sequencing window, to guarantee safe inclusion of a channel on L1. The default value is 10.

Syntax
Example
Environment Variable

--sub-safety-margin=<value>

--sub-safety-margin=10

OP_BATCHER_SUB_SAFETY_MARGIN=10s

max-l1-tx-size-bytes

The maximum size of a batch tx submitted to L1. Ignored for blobs, where max blob size will be used. The default value is 120000.

Syntax
Example
Environment Variable

--max-l1-tx-size-bytes=<value>

--max-l1-tx-size-bytes=120000

OP_BATCHER_MAX_L1_TX_SIZE_BYTES=120000

Batcher startup

wait-node-sync

Indicates if, during startup, the batcher should wait for a recent batcher tx on L1 to finalize (via more block confirmations). This should help avoid duplicate batcher txs. The default value is false.

Syntax
Example
Environment Variable

--wait-node-sync=<value>

--wait-node-sync=false

OP_BATCHER_WAIT_NODE_SYNC=false

check-recent-txs-depth

Indicates how many blocks back the batcher should look during startup for a recent batch tx on L1. This can speed up waiting for node sync. It should be set to the verifier confirmation depth of the sequencer (e.g. 4). The default value is 0.

Syntax
Example
Environment Variable

--check-recent-txs-depth=<value>

--check-recent-txs-depth=0

OP_BATCHER_CHECK_RECENT_TXS_DEPTH=0

stopped

Initialize the batcher in a stopped state. The batcher can be started using the admin_startBatcher RPC. The default value is false.

Syntax
Example
Environment Variable

--stopped=<value>

--stopped=false

OP_BATCHER_STOPPED=false

Throttling

The batcher supports throttling configuration to limit DA usage for transactions and blocks, and to control throttle intensity via several controller types. The following flags are available:

throttle.additional-endpoints

Comma-separated list of endpoints to distribute throttling configuration to (in addition to the L2 endpoints specified with --l2-eth-rpc).

Syntax
Example
Environment Variable

--throttle.additional-endpoints=<endpoint1>,<endpoint2>,...

--throttle.additional-endpoints=http://builder1:8545,http://builder2:8545

OP_BATCHER_THROTTLE_ADDITIONAL_ENDPOINTS=http://builder1:8545,http://builder2:8545

throttle.tx-size-lower-limit

The DA size limit for individual transactions when the throttle intensity is at its maximum. 0 disables limits; use 1 as the smallest effective limit.

Syntax
Example
Environment Variable

--throttle.tx-size-lower-limit=<bytes>

--throttle.tx-size-lower-limit=150

OP_BATCHER_THROTTLE_TX_SIZE_LOWER_LIMIT=150

throttle.tx-size-upper-limit

The DA size limit for individual transactions as throttle intensity approaches 0 (minimal throttling). Not applied when throttling is inactive.

Syntax
Example
Environment Variable

--throttle.tx-size-upper-limit=<bytes>

--throttle.tx-size-upper-limit=20000

OP_BATCHER_THROTTLE_TX_SIZE_UPPER_LIMIT=20000

throttle.block-size-lower-limit

The DA size limit for blocks when throttle intensity is at maximum (applies for linear and quadratic controllers). 0 disables limits; use 1 as the smallest effective limit.

Syntax
Example
Environment Variable

--throttle.block-size-lower-limit=<bytes>

--throttle.block-size-lower-limit=2000

OP_BATCHER_THROTTLE_BLOCK_SIZE_LOWER_LIMIT=2000

throttle.block-size-upper-limit

The DA size limit for blocks when throttling is inactive (throttle intensity = 0).

Syntax
Example
Environment Variable

--throttle.block-size-upper-limit=<bytes>

--throttle.block-size-upper-limit=130000

OP_BATCHER_THROTTLE_BLOCK_SIZE_UPPER_LIMIT=130000

throttle.controller-type

Type of throttle controller to use. Valid values: step, linear, or quadratic (default).

Syntax
Example
Environment Variable

--throttle.controller-type=<step|linear|quadratic|pid>

--throttle.controller-type=quadratic

OP_BATCHER_THROTTLE_CONTROLLER_TYPE=quadratic

throttle.unsafe-da-bytes-lower-threshold

Threshold on unsafe_da_bytes beyond which the batcher will start to throttle the block builder. 0 disables throttling.

Syntax
Example
Environment Variable

--throttle.unsafe-da-bytes-lower-threshold=<bytes>

--throttle.unsafe-da-bytes-lower-threshold=3200000

OP_BATCHER_THROTTLE_UNSAFE_DA_BYTES_LOWER_THRESHOLD=3200000

throttle.unsafe-da-bytes-upper-threshold

Threshold on unsafe_da_bytes at which throttling reaches maximum intensity (applies for linear and quadratic controllers).

Syntax
Example
Environment Variable

--throttle.unsafe-da-bytes-upper-threshold=<bytes>

--throttle.unsafe-da-bytes-upper-threshold=12800000

OP_BATCHER_THROTTLE_UNSAFE_DA_BYTES_UPPER_THRESHOLD=12800000

Transaction manager

num-confirmations

Number of confirmations which we will wait after sending a transaction. The default value is 10.

Syntax
Example
Environment Variable

--num-confirmations=<value>

--num-confirmations=10

OP_BATCHER_NUM_CONFIRMATIONS=10

max-pending-tx

The maximum number of pending transactions. 0 for no limit. The default value is 1.

Syntax
Example
Environment Variable

--max-pending-tx=<value>

--max-pending-tx=1

OP_BATCHER_MAX_PENDING_TX=1

resubmission-timeout

Duration we will wait before resubmitting a transaction to L1. The default value is 48s.

Syntax
Example
Environment Variable

--resubmission-timeout=<value>

--resubmission-timeout=48s

OP_BATCHER_RESUBMISSION_TIMEOUT=48s

safe-abort-nonce-too-low-count

Number of ErrNonceTooLow observations required to give up on a tx at a particular nonce without receiving confirmation. The default value is 3.

Syntax
Example
Environment Variable

--safe-abort-nonce-too-low-count=<value>

--safe-abort-nonce-too-low-count=3

OP_BATCHER_SAFE_ABORT_NONCE_TOO_LOW_COUNT=3

txmgr.min-basefee

Enforces a minimum base fee (in GWei) to assume when determining tx fees. 1 GWei by default. The default value is 1.

Syntax
Example
Environment Variable

--txmgr.min-basefee=<value>

--txmgr.min-basefee=1

OP_BATCHER_TXMGR_MIN_BASEFEE=1

txmgr.min-tip-cap

Enforces a minimum tip cap (in GWei) to use when determining tx fees. 1 GWei by default. The default value is 1.

Syntax
Example
Environment Variable

--txmgr.min-tip-cap=<value>

--txmgr.min-tip-cap=1

OP_BATCHER_TXMGR_MIN_TIP_CAP=1

fee-limit-multiplier

The multiplier applied to fee suggestions to put a hard limit on fee increases. The default value is 5.

Syntax
Example
Environment Variable

--fee-limit-multiplier=<value>

--fee-limit-multiplier=5

OP_BATCHER_TXMGR_FEE_LIMIT_MULTIPLIER=5

txmgr.fee-limit-threshold

The minimum threshold (in GWei) at which fee bumping starts to be capped. Allows arbitrary fee bumps below this threshold. The default value is 100.

Syntax
Example
Environment Variable

--txmgr.fee-limit-threshold=<value>

--txmgr.fee-limit-threshold=100

OP_BATCHER_TXMGR_FEE_LIMIT_THRESHOLD=100

txmgr.receipt-query-interval

Frequency to poll for receipts. The default value is 12s.

Syntax
Example
Environment Variable

--txmgr.receipt-query-interval=<value>

--txmgr.receipt-query-interval=12s

OP_BATCHER_TXMGR_RECEIPT_QUERY_INTERVAL=12s

txmgr.not-in-mempool-timeout

Timeout for aborting a tx send if the tx does not make it to the mempool. The default value is 2m0s.

Syntax
Example
Environment Variable

--txmgr.not-in-mempool-timeout=<value>

--txmgr.not-in-mempool-timeout=2m0s

OP_BATCHER_TXMGR_TX_NOT_IN_MEMPOOL_TIMEOUT=2m0s

txmgr.send-timeout

Timeout for sending transactions. If 0 it is disabled. The default value is 0s.

Syntax
Example
Environment Variable

--txmgr.send-timeout=<value>

--txmgr.send-timeout=0s

OP_BATCHER_TXMGR_TX_SEND_TIMEOUT=0s

Authentication and wallet

private-key

The private key to use with the service. Must not be used with mnemonic.

Syntax
Example
Environment Variable

--private-key=<value>

--private-key=

OP_BATCHER_PRIVATE_KEY=

mnemonic

The mnemonic used to derive the wallets for either the service.

Syntax
Example
Environment Variable

--mnemonic=<value>

--mnemonic=

OP_BATCHER_MNEMONIC=

hd-path

The HD path used to derive the sequencer wallet from the mnemonic. The mnemonic flag must also be set.

Syntax
Example
Environment Variable

--hd-path=<value>

--hd-path=

OP_BATCHER_HD_PATH=

signer.address

Address the signer is signing transactions for.

Syntax
Example
Environment Variable

--signer.address=<value>

--signer.address=

OP_BATCHER_SIGNER_ADDRESS=

signer.endpoint

Signer endpoint the client will connect to.

Syntax
Example
Environment Variable

--signer.endpoint=<value>

--signer.endpoint=

OP_BATCHER_SIGNER_ENDPOINT=

signer.header

Headers to pass to the remote signer. Format key=value.
Value can contain any character allowed in an HTTP header.
When using env vars, split multiple headers with commas.
When using flags, provide one key-value pair per flag.

Syntax
Example
Environment Variable

--signer.header=<key=value>

--signer.header="Authorization=Bearer 123abc"

OP_BATCHER_SIGNER_HEADER=Authorization=Bearer 123abc

signer.tls.ca

tls ca cert path. The default value is tls/ca.crt.

Syntax
Example
Environment Variable

--signer.tls.ca=<value>

--signer.tls.ca=tls/ca.crt

OP_BATCHER_SIGNER_TLS_CA=tls/ca.crt

signer.tls.cert

tls cert path. The default value is tls/tls.crt.

Syntax
Example
Environment Variable

--signer.tls.cert=<value>

--signer.tls.cert=tls/tls.crt

OP_BATCHER_SIGNER_TLS_CERT=

signer.tls.key

tls key. The default value is tls/tls.key.

Syntax
Example
Environment Variable

--signer.tls.key=<value>

--signer.tls.key=tls/tls.key

OP_BATCHER_SIGNER_TLS_KEY=

Network connections

l1-eth-rpc

HTTP provider URL for L1.

Syntax
Example
Environment Variable

--l1-eth-rpc=<value>

--l1-eth-rpc

OP_BATCHER_L1_ETH_RPC=

l2-eth-rpc

HTTP provider URL for L2 execution engine. A comma-separated list enables the active L2 endpoint provider. Such a list needs to match the number of rollup-rpcs provided.

Syntax
Example
Environment Variable

--l2-eth-rpc=<value>

--l2-eth-rpc=

OP_BATCHER_L2_ETH_RPC=

rollup-rpc

HTTP provider URL for Rollup node. A comma-separated list enables the active L2 endpoint provider. Such a list needs to match the number of l2-eth-rpcs provided.

Syntax
Example
Environment Variable

--rollup-rpc=<value>

--rollup-rpc=

OP_BATCHER_ROLLUP_RPC=

rpc.addr

rpc listening address. The default value is 0.0.0.0.

Syntax
Example
Environment Variable

--rpc.addr=<value>

--rpc.addr=0.0.0.0

OP_BATCHER_RPC_ADDR=0.0.0.0

rpc.enable-admin

Enable the admin API. The default value is false.

Syntax
Example
Environment Variable

--rpc.enable-admin=<value>

--rpc.enable-admin=false

OP_BATCHER_RPC_ENABLE_ADMIN=false

rpc.port

rpc listening port. The default value is 8545.

Syntax
Example
Environment Variable

--rpc.port=<value>

--rpc.port=8545

OP_BATCHER_RPC_PORT=8545

network-timeout

Timeout for all network operations. The default value is 10s.

Syntax
Example
Environment Variable

--network-timeout=<value>

--network-timeout=10s

OP_BATCHER_NETWORK_TIMEOUT=10s

Alt-DA mode (Beta feature)

altda.enabled

Enable Alt-DA mode, Alt-DA mode is a Beta feature of the OP Stack. While it has received initial review from core contributors, it is still undergoing testing, and may have bugs or other issues. The default value is false.

Syntax
Example
Environment Variable

--altda.enabled=<value>

--altda.enabled=false

OP_BATCHER_ALTDA_ENABLED=false

altda.da-server

HTTP address of a DA Server.

Syntax
Example
Environment Variable

--altda.da-server=<value>

--altda.da-server=http://da.example.com:1234

OP_BATCHER_ALTDA_DA_SERVER=http://da.example.com:1234

altda.da-service

Use DA service type where commitments are generated by Alt-DA server. The default value is false.

Syntax
Example
Environment Variable

--altda.da-service=<value>

--altda.da-service=true

OP_BATCHER_ALTDA_DA_SERVER=true

altda.get-timeout

Timeout for get requests. 0 means no timeout.

Syntax
Example
Environment Variable

--altda.get-timeout=<value>

--altda.get-timeout=5s

OP_BATCHER_ALTDA_GET_TIMEOUT=5s

altda.put-timeout

Timeout for put requests. 0 means no timeout.

Syntax
Example
Environment Variable

--altda.put-timeout=<value>

--altda.put-timeout=10s

OP_BATCHER_ALTDA_PUT_TIMEOUT=10s

altda.max-concurrent-da-requests

Maximum number of concurrent requests to the DA server.

Syntax
Example
Environment Variable

--altda.max-concurrent-da-requests=<value>

--altda.max-concurrent-da-requests=4

OP_BATCHER_ALTDA_MAX_CONCURRENT_DA_REQUESTS=4

altda.verify-on-read

Verify input data matches the commitments from the DA storage service.

Syntax
Example
Environment Variable

--altda.verify-on-read=<value>

--altda.verify-on-read=true

OP_BATCHER_ALTDA_VERIFY_ON_READ=true

Logging and monitoring

log.level

The lowest log level that will be output. The default value is INFO.

Syntax
Example
Environment Variable

--log.level=<value>

--log.level=INFO

OP_BATCHER_LOG_LEVEL=INFO

log.format

Format the log output. Supported formats: ‘text’, ‘terminal’, ‘logfmt’, ‘json’, ‘json-pretty’. The default value is text.

Syntax
Example
Environment Variable

--log.format=<value>

--log.format=text

OP_BATCHER_LOG_FORMAT=text

log.color

Color the log output if in terminal mode. The default value is false.

Syntax
Example
Environment Variable

--log.color=<value>

--log.color=false

OP_BATCHER_LOG_COLOR=false

log.pid

Show PID in the log.

Syntax
Example
Environment Variable

--log.pid=<value>

--log.pid=true

OP_BATCHER_LOG_PID=true

metrics.enabled

Enable the metrics server. The default value is false.

Syntax
Example
Environment Variable

--metrics.enabled=<value>

--metrics.enabled=false

OP_BATCHER_METRICS_ENABLED=false

Miscellaneous

active-sequencer-check-duration

The duration between checks to determine the active sequencer endpoint. The default value is 2m0s.

Syntax
Example
Environment Variable

--active-sequencer-check-duration=<value>

--active-sequencer-check-duration=2m0s

OP_BATCHER_ACTIVE_SEQUENCER_CHECK_DURATION=2m0s

pprof.addr

pprof listening address. The default value is 0.0.0.0.

Syntax
Example
Environment Variable

--pprof.addr=<value>

--pprof.addr=0.0.0.0

OP_BATCHER_PPROF_ADDR=0.0.0.0

pprof.enabled

Enable the pprof server. The default value is false.

Syntax
Example
Environment Variable

--pprof.enabled=<value>

--pprof.enabled=false

OP_BATCHER_PPROF_ENABLED=false

pprof.path

pprof file path. If it is a directory, the path is {dir}/{profileType}.prof.

Syntax
Example
Environment Variable

--pprof.path=<value>

--pprof.path=

OP_BATCHER_PPROF_PATH=

pprof.port

pprof listening port. The default value is 6060.

Syntax
Example
Environment Variable

--pprof.port=<value>

--pprof.port=6060

OP_BATCHER_PPROF_PORT=6060

pprof.type

pprof profile type. One of cpu, heap, goroutine, threadcreate, block, mutex, allocs.

Syntax
Example
Environment Variable

--pprof.type=<value>

--pprof.type

OP_BATCHER_PPROF_TYPE=

help

Show help. The default value is false.

Syntax
Example
Environment Variable

--help=<value>

--help=false

OP_BATCHER_HELP=false

version

Print the version. The default value is false.

Syntax
Example
Environment Variable

--version=<value>

--version=false

OP_BATCHER_VERSION=false

​Batch generation

​batch-type

​max-blocks-per-span-batch

​compression-algo

​compressor

​approx-compr-ratio

​poll-interval

​Batch submission

​data-availability-type

​target-num-frames

​max-channel-duration

​sub-safety-margin

​max-l1-tx-size-bytes

​Batcher startup

​wait-node-sync

​check-recent-txs-depth

​stopped

​Throttling

​throttle.additional-endpoints

​throttle.tx-size-lower-limit

​throttle.tx-size-upper-limit

​throttle.block-size-lower-limit

​throttle.block-size-upper-limit

​throttle.controller-type

​throttle.unsafe-da-bytes-lower-threshold

​throttle.unsafe-da-bytes-upper-threshold

​Transaction manager

​num-confirmations

​max-pending-tx

​resubmission-timeout

​safe-abort-nonce-too-low-count

​txmgr.min-basefee

​txmgr.min-tip-cap

​fee-limit-multiplier

​txmgr.fee-limit-threshold

​txmgr.receipt-query-interval

​txmgr.not-in-mempool-timeout

​txmgr.send-timeout

​Authentication and wallet

​private-key

​mnemonic

​hd-path

​signer.address

​signer.endpoint

​signer.header

​signer.tls.ca

​signer.tls.cert

​signer.tls.key

​Network connections

​l1-eth-rpc

​l2-eth-rpc

​rollup-rpc

​rpc.addr

​rpc.enable-admin

​rpc.port

​network-timeout

​Alt-DA mode (Beta feature)

​altda.enabled

​altda.da-server

​altda.da-service

​altda.get-timeout

​altda.put-timeout

​altda.max-concurrent-da-requests

​altda.verify-on-read

​Logging and monitoring

​log.level

​log.format

​log.color

​log.pid

​metrics.enabled

​Miscellaneous

​active-sequencer-check-duration

​pprof.addr

​pprof.enabled

​pprof.path

​pprof.port

​pprof.type

​help

​version

Batch generation

batch-type

max-blocks-per-span-batch

compression-algo

compressor

approx-compr-ratio

poll-interval

Batch submission

data-availability-type

target-num-frames

max-channel-duration

sub-safety-margin

max-l1-tx-size-bytes

Batcher startup

wait-node-sync

check-recent-txs-depth

stopped

Throttling

throttle.additional-endpoints

throttle.tx-size-lower-limit

throttle.tx-size-upper-limit

throttle.block-size-lower-limit

throttle.block-size-upper-limit

throttle.controller-type

throttle.unsafe-da-bytes-lower-threshold

throttle.unsafe-da-bytes-upper-threshold

Transaction manager

num-confirmations

max-pending-tx

resubmission-timeout

safe-abort-nonce-too-low-count

txmgr.min-basefee

txmgr.min-tip-cap

fee-limit-multiplier

txmgr.fee-limit-threshold

txmgr.receipt-query-interval

txmgr.not-in-mempool-timeout

txmgr.send-timeout

Authentication and wallet

private-key

mnemonic

hd-path

signer.address

signer.endpoint

signer.header

signer.tls.ca

signer.tls.cert

signer.tls.key

Network connections

l1-eth-rpc

l2-eth-rpc

rollup-rpc

rpc.addr

rpc.enable-admin

rpc.port

network-timeout

Alt-DA mode (Beta feature)

altda.enabled

altda.da-server

altda.da-service

altda.get-timeout

altda.put-timeout

altda.max-concurrent-da-requests

altda.verify-on-read

Logging and monitoring

log.level

log.format

log.color

log.pid

metrics.enabled

Miscellaneous

active-sequencer-check-duration

pprof.addr

pprof.enabled

pprof.path

pprof.port

pprof.type

help

version