Optimism Documentation

This page lists all configuration options for op-proposer. The op-proposer posts output roots (proposals) to L1, making them available for verifiers. Withdrawals to L1 must reference an output root. If the chain is running permissioned fault proofs, only the designated proposer can submit output roots. With permissionless fault proofs, anyone can make a proposal.

Proposer policy

The proposer policy defines high-level constraints and responsibilities regarding how L2 output roots are posted to L1. Below are the standard guidelines for configuring the proposer within the OP Stack.

Parameter	Description	Administrator	Requirement	Notes
Output Frequency	Defines how frequently L2 output roots are submitted to L1 (via the output oracle).	L1 Proxy Admin	43,200 L2 blocks (24 hours at 2s block times) or lower	It cannot be set to 0 (there must be some cadence for outputs).

Example configuration

OP_PROPOSER_L1_ETH_RPC: YOUR_L1_RPC_URL_HERE
OP_PROPOSER_ROLLUP_RPC: YOUR_CHAINS_RPC_URL_HERE
OP_PROPOSER_GAME_FACTORY_ADDRESS: YOUR_CHAINS_GAME_FACTORY_ADDRESS_HERE
OP_PROPOSER_PROPOSAL_INTERVAL: 5h
OP_PROPOSER_WAIT_NODE_SYNC: true
OP_PROPOSER_ALLOW_NON_FINALIZED: "false"
OP_PROPOSER_POLL_INTERVAL: "20s"
OP_PROPOSER_NUM_CONFIRMATIONS: "1"
OP_PROPOSER_SAFE_ABORT_NONCE_TOO_LOW_COUNT: "3"
OP_PROPOSER_RESUBMISSION_TIMEOUT: "30s"
OP_PROPOSER_METRICS_ENABLED: "true"
OP_PROPOSER_METRICS_ADDR: 0.0.0.0
OP_PROPOSER_METRICS_PORT: 7300

Higher throughput chains can decrease the proposal-interval to allow users submit withdrawals more often.

All configuration variables

Output root generation

poll-interval

Delay between periodic checks on whether it is time to load an output root and propose it. The default value is 6s.

Syntax
Example
Environment Variable

--poll-interval=<value>

--poll-interval=6s

OP_PROPOSER_POLL_INTERVAL=6s

active-sequencer-check-duration

The duration between checks to determine the active sequencer endpoint from which output roots will be derived. The default value is 2m0s.

Syntax
Example
Environment Variable

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

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

OP_PROPOSER_ACTIVE_SEQUENCER_CHECK_DURATION=2m0s

Output root submission

proposal-interval

Interval between submitting L2 output proposals when the dispute game factory address is set. The default value is 0s.

Syntax
Example
Environment Variable

--proposal-interval=<value>

--proposal-interval=0s

OP_PROPOSER_PROPOSAL_INTERVAL=0s

allow-non-finalized

Allow the proposer to submit proposals for L2 blocks from non-finalized L1 blocks. The default value is false.

Syntax
Example
Environment Variable

--allow-non-finalized=<value>

--allow-non-finalized=false

OP_PROPOSER_ALLOW_NON_FINALIZED=false

game-factory-address

Address of the DisputeGameFactory contract. This is where the proposer will submit output roots.

Syntax
Example
Environment Variable

--game-factory-address=<value>

OP_PROPOSER_GAME_FACTORY_ADDRESS=<value>

game-type

Dispute game type to create via the configured DisputeGameFactory. The default value is 0.

Syntax
Example
Environment Variable

--game-type=<value>

--game-type=0

OP_PROPOSER_GAME_TYPE=0

Proposer startup

wait-node-sync

Indicates if, during startup, the proposer should wait for the rollup node to sync to the current L1 tip before proceeding with its driver loop. The default value is false.

Syntax
Example
Environment Variable

--wait-node-sync=<value>

--wait-node-sync=false

OP_PROPOSER_WAIT_NODE_SYNC=false

Transaction manager

fee-limit-multiplier

The multiplier applied to fee suggestions to limit fee increases. The default value is 5.

Syntax
Example
Environment Variable

--fee-limit-multiplier=<value>

--fee-limit-multiplier=5

OP_PROPOSER_TXMGR_FEE_LIMIT_MULTIPLIER=5

num-confirmations

Number of confirmations to wait after sending a transaction. The default value is 10.

Syntax
Example
Environment Variable

--num-confirmations=<value>

--num-confirmations=10

OP_PROPOSER_NUM_CONFIRMATIONS=10

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_PROPOSER_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_PROPOSER_SAFE_ABORT_NONCE_TOO_LOW_COUNT=3

txmgr.fee-limit-threshold

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

Syntax
Example
Environment Variable

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

--txmgr.fee-limit-threshold=100

OP_PROPOSER_TXMGR_FEE_LIMIT_THRESHOLD=100

txmgr.min-basefee

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

Syntax
Example
Environment Variable

--txmgr.min-basefee=<value>

--txmgr.min-basefee=1

OP_PROPOSER_TXMGR_MIN_BASEFEE=1

txmgr.min-tip-cap

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

Syntax
Example
Environment Variable

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

--txmgr.min-tip-cap=1

OP_PROPOSER_TXMGR_MIN_TIP_CAP=1

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_PROPOSER_TXMGR_TX_NOT_IN_MEMPOOL_TIMEOUT=2m0s

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_PROPOSER_TXMGR_RECEIPT_QUERY_INTERVAL=12s

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_PROPOSER_TXMGR_TX_SEND_TIMEOUT=0s

Wallet

hd-path

The HD path used to derive the sequencer wallet from the mnemonic.

Tab Title
Tab Title
Tab Title

--hd-path=<value>

OP_PROPOSER_HD_PATH=<value>

mnemonic

The mnemonic used to derive the wallets for the service.

Syntax
Example
Environment Variable

--mnemonic=<value>

OP_PROPOSER_MNEMONIC=<value>

RPC

l1-eth-rpc

HTTP provider URL for L1.

Syntax
Example
Environment Variable

--l1-eth-rpc=<value>

OP_PROPOSER_L1_ETH_RPC=<value>

rollup-rpc

HTTP provider URL for the rollup node. A comma-separated list enables the active rollup provider.

Syntax
Example
Environment Variable

--rollup-rpc=<value>

OP_PROPOSER_ROLLUP_RPC=<value>

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_PROPOSER_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_PROPOSER_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_PROPOSER_RPC_PORT=8545

Logging

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_PROPOSER_LOG_COLOR=false

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_PROPOSER_LOG_FORMAT=text

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_PROPOSER_LOG_LEVEL=INFO

Metrics

metrics.addr

Metrics listening address. The default value is “0.0.0.0”.

Syntax
Example
Environment Variable

--metrics.addr=<value>

--metrics.addr=0.0.0.0

OP_PROPOSER_METRICS_ADDR=0.0.0.0

metrics.enabled

Enable the metrics server. The default value is false.

Syntax
Example
Environment Variable

--metrics.enabled=<value>

--metrics.enabled=false

OP_PROPOSER_METRICS_ENABLED=false

metrics.port

Metrics listening port. The default value is 7300.

Syntax
Example
Environment Variable

--metrics.port=<value>

--metrics.port=7300

OP_PROPOSER_METRICS_PORT=7300

pprof

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_PROPOSER_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_PROPOSER_PPROF_ENABLED=false

pprof.path

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

Syntax
Example
Environment Variable

--pprof.path=<value>

OP_PROPOSER_PPROF_PATH=<value>

pprof.port

pprof listening port. The default value is 6060.

Syntax
Example
Environment Variable

--pprof.port=<value>

--pprof.port=6060

OP_PROPOSER_PPROF_PORT=6060

pprof.type

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

Syntax
Example
Environment Variable

--pprof.type=<value>

OP_PROPOSER_PPROF_TYPE=<value>

Signer

signer.address

Address the signer is signing transactions for.

Syntax
Example
Environment Variable

--signer.address=<value>

OP_PROPOSER_SIGNER_ADDRESS=<value>

signer.endpoint

Signer endpoint the client will connect to.

Syntax
Example
Environment Variable

--signer.endpoint=<value>

OP_PROPOSER_SIGNER_ENDPOINT=<value>

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_PROPOSER_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_PROPOSER_SIGNER_TLS_CERT=tls/tls.crt

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_PROPOSER_SIGNER_TLS_KEY=tls/tls.key

Miscellaneous

network-timeout

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

Syntax
Example
Environment Variable

--network-timeout=<value>

--network-timeout=10s

OP_PROPOSER_NETWORK_TIMEOUT=10s

help

Show help. The default value is false.

Syntax
Example

--help=<value>

--help=false

version

Print the version. The default value is false.

Tab Title
Tab Title

--version=<value>

--version=false

Quickstart

Guides

Tutorials

Tools

Reference

​Proposer policy

​Example configuration

​All configuration variables

​Output root generation

​poll-interval

​active-sequencer-check-duration

​Output root submission

​proposal-interval

​allow-non-finalized

​game-factory-address

​game-type

​Proposer startup

​wait-node-sync

​Transaction manager

​fee-limit-multiplier

​num-confirmations

​resubmission-timeout

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

​txmgr.fee-limit-threshold

​txmgr.min-basefee

​txmgr.min-tip-cap

​txmgr.not-in-mempool-timeout

​txmgr.receipt-query-interval

​txmgr.send-timeout

​Wallet

​hd-path

​mnemonic

​RPC

​l1-eth-rpc

​rollup-rpc

​rpc.addr

​rpc.enable-admin

​rpc.port

​Logging

​log.color

​log.format

​log.level

​Metrics

​metrics.addr

​metrics.enabled

​metrics.port

​pprof

​pprof.addr

​pprof.enabled

​pprof.path

​pprof.port

​pprof.type

​Signer

​signer.address

​signer.endpoint

​signer.tls.ca

​signer.tls.cert

​signer.tls.key

​Miscellaneous

​network-timeout

​help

​version