Linea Coordinator configuration reference

Advanced options

Some configuration keys are operational or environment-specific and are included for completeness. Their presence does not indicate that changing them is recommended or supported for every deployment. Verify their applicability against the relevant release and deployment guidance.

Defaults

Defaults are values defined in the Coordinator Kotlin config data classes (@ConfigDoc(default = ...)). They are not recommended production settings and may be overridden by deployment configuration. Sample *.toml files are never used as the source of defaults.

This reference lists Linea Coordinator TOML configuration keys, grouped by config file and section. Descriptions come from @ConfigDoc/@ConfigSection annotations on the config data classes; defaults are shown in the Default column.

Generated from LFDT-Lineth/lineth-monorepo@0c18048.

Keys may differ in other Coordinator releases.

coordinator

Main Coordinator configuration.

api

Coordinator JSON-RPC and observability API settings.

Key	Type	Required	Default	Status	Description
api.json-rpc-path	String	no	/	active	HTTP path the JSON-RPC API is served on.
api.json-rpc-port	UInt	no	0	active	Port serving the coordinator JSON-RPC API. 0 picks a random free port.
api.json-rpc-server-verticles	Int	no	1	active	Number of Vert.x verticles serving the JSON-RPC API.
api.observability-port	UInt	no	9545	active	Port serving observability endpoints (metrics/health).

conflation

Block conflation, blob compression, and proof aggregation settings.

Key	Type	Required	Default	Status	Description
conflation.backtesting-directory	Path?	no	-	active	Directory used to persist conflation backtesting data. Omit to disable backtesting output. Example: /data/conflation-backtesting.
conflation.blob-compression.batches-limit	UInt?	no	-	active	Maximum number of batches per blob. Omit for no explicit limit. Example: 1.
conflation.blob-compression.blob-compressor-version	BlobCompressorVersion	no	V3	active	Blob compressor version to use.
conflation.blob-compression.blob-size-limit	UInt	no	102400	active	Maximum compressed blob size in bytes before a blob is finalized.
conflation.blob-compression.handler-polling-interval	Duration	no	PT1S	active	Interval between blob compression handler runs.
conflation.blocks-limit	UInt?	no	-	active	Maximum number of L2 blocks in a single conflation. Omit for no block-count limit. Example: 2.
conflation.conflation-deadline	Duration?	no	-	active	Maximum time to wait before conflating available blocks even if limits are not reached. Omit to disable deadline-based conflation. Example: PT6S.
conflation.conflation-deadline-check-interval	Duration	no	PT30S	active	How often to check whether the conflation deadline has elapsed.
conflation.conflation-deadline-last-block-confirmation-delay	Duration	no	PT30S	active	Delay after the last block before confirming it, to absorb short reorgs.
conflation.consistent-number-of-blocks-on-l1-to-wait	UInt	no	32	active	Number of L1 blocks to wait for consistency (finality safety margin); defaults to one epoch.
conflation.disabled	Boolean	no	false	active	Whether conflation is disabled.
conflation.force-stop-conflation-at-block-inclusive	ULong?	no	-	active	Inclusive L2 block number at which to stop conflating. Omit to conflate indefinitely. Example: 100000000.
conflation.force-stop-conflation-at-block-timestamp-inclusive	Instant?	no	-	active	Inclusive block timestamp at which to stop conflating. Omit to conflate indefinitely. Example: 2024-01-01T00:00:00Z.
conflation.l2-endpoint	URL?	no	-	active	L2 endpoint used for conflation. Falls back to defaults.l2-endpoint. Example: http://sequencer:8545.
conflation.l2-fetch-blocks-limit	UInt?	no	-	active	Maximum number of L2 blocks to fetch that are unproven and held in memory. Omit for no limit. Example: 4000.
conflation.l2-logs-endpoint	URL?	no	-	active	L2 endpoint used for eth_getLogs during conflation. Falls back to l2-endpoint/defaults. Example: http://sequencer:8545.
conflation.l2-request-retries.backoff-delay	Duration	no	PT1S	active	Delay between retry attempts. Example: PT1S.
conflation.l2-request-retries.failures-warning-threshold	UInt?	no	-	active	Number of consecutive failures after which warning logs start being emitted. Omit to use the default threshold. Example: 3.
conflation.l2-request-retries.ignore-first-exceptions-until-time-elapsed	Duration?	no	-	active	Grace period during which initial failures are ignored (not logged/counted) before retries are treated as errors. Omit to disable. Example: PT5S.
conflation.l2-request-retries.max-retries	UInt?	no	-	active	Maximum number of retry attempts. Omit for endless retries. Example: 3.
conflation.l2-request-retries.timeout	Duration?	no	-	active	Overall timeout across all retry attempts. Omit to disable the timeout. Example: PT10S.
conflation.new-blocks-polling-interval	Duration	no	PT1S	active	Interval between polls for new L2 blocks.
conflation.proof-aggregation.aggregation-size-multiple-of	UInt	no	1	active	Aggregations are only closed when their size is a multiple of this value.
conflation.proof-aggregation.blobs-limit	UInt?	no	-	active	Maximum number of blobs in a single aggregation. Omit for no explicit limit. Example: 6.
conflation.proof-aggregation.coordinator-polling-interval	Duration	no	PT3S	active	Interval between coordinator polls for new proofs to aggregate.
conflation.proof-aggregation.deadline	Duration?	no	-	active	Maximum time to wait before aggregating available proofs. Omit to disable deadline-based aggregation (wait indefinitely). Example: PT1M.
conflation.proof-aggregation.deadline-check-interval	Duration	no	PT30S	active	How often to check whether the aggregation deadline has elapsed.
conflation.proof-aggregation.proofs-limit	UInt	no	300	active	Maximum number of proofs in a single aggregation.
conflation.proof-aggregation.target-end-blocks	List<ULong>?	no	-	active	L2 block numbers that must end an aggregation (e.g. hard-fork boundaries). Omit for none. Example: [].
conflation.proof-aggregation.timestamp-based-hard-forks	List<Instant>	no	[]	active	Timestamps that force an aggregation boundary (e.g. timestamp-based hard forks).
conflation.proof-aggregation.wait-api-resume-after-target-block	Boolean	no	false	active	Whether to wait for the API to resume after the target block before aggregating.
conflation.proof-aggregation.wait-for-no-l2-activity-to-trigger-aggregation	Boolean	no	false	active	Whether to wait for a period of no L2 activity before triggering an aggregation.
conflation.proof-aggregation.wait-target-block-l1-finalization	Boolean	no	false	active	Whether to wait for the target block to be finalized on L1 before aggregating.
conflation.riscv-starting-block-timestamp-inclusive	Instant?	no	-	active	RISC-V starting block timestamp (inclusive). Example: 2027-01-01T00:00:00Z.

database

Coordinator PostgreSQL persistence settings.

Key	Type	Required	Default	Status	Description
database.hostname	String	yes	-	active	PostgreSQL hostname used by the coordinator persistence layer. Example: postgres.
database.password	Masked	yes	-	active	PostgreSQL password. Masked in logs.
database.persistence-retries.backoff-delay	Duration	no	PT1S	active	Delay between retry attempts. Example: PT1S.
database.persistence-retries.failures-warning-threshold	UInt?	no	-	active	Number of consecutive failures after which warning logs start being emitted. Omit to use the default threshold. Example: 3.
database.persistence-retries.ignore-first-exceptions-until-time-elapsed	Duration?	no	-	active	Grace period during which initial failures are ignored (not logged/counted) before retries are treated as errors. Omit to disable. Example: PT5S.
database.persistence-retries.max-retries	UInt?	no	-	active	Maximum number of retry attempts. Omit for endless retries. Example: 3.
database.persistence-retries.timeout	Duration?	no	-	active	Overall timeout across all retry attempts. Omit to disable the timeout. Example: PT10S.
database.port	UInt	no	5432	active	PostgreSQL port.
database.read-pipelining-limit	Int	no	10	active	Maximum number of read queries pipelined on a single connection.
database.read-pool-size	Int	no	10	active	Connection pool size for read-only queries.
database.schema	String	no	linea_coordinator	active	PostgreSQL schema (database) name.
database.schema-version	Int	no	4	active	Expected database schema version; must match a supported migration version.
database.transactional-pool-size	Int	no	10	active	Connection pool size for transactional (read-write) queries.
database.username	String	yes	-	active	PostgreSQL username. Example: postgres.

defaults

Shared defaults (L1/L2 endpoints and retry policies) reused by coordinator services.

Key	Type	Required	Default	Status	Description
defaults.l1-endpoint	URL?	no	-	active	Default L1 execution-layer JSON-RPC endpoint used by services that do not override it. Example: http://l1-el-node:8545.
defaults.l1-request-retries.backoff-delay	Duration	no	PT1S	active	Delay between retry attempts. Example: PT1S.
defaults.l1-request-retries.failures-warning-threshold	UInt?	no	-	active	Number of consecutive failures after which warning logs start being emitted. Omit to use the default threshold. Example: 3.
defaults.l1-request-retries.ignore-first-exceptions-until-time-elapsed	Duration?	no	-	active	Grace period during which initial failures are ignored (not logged/counted) before retries are treated as errors. Omit to disable. Example: PT5S.
defaults.l1-request-retries.max-retries	UInt?	no	-	active	Maximum number of retry attempts. Omit for endless retries. Example: 3.
defaults.l1-request-retries.timeout	Duration?	no	-	active	Overall timeout across all retry attempts. Omit to disable the timeout. Example: PT10S.
defaults.l2-endpoint	URL?	no	-	active	Default L2 JSON-RPC endpoint used by services that do not override it. Example: http://sequencer:8545.
defaults.l2-request-retries.backoff-delay	Duration	no	PT1S	active	Delay between retry attempts. Example: PT1S.
defaults.l2-request-retries.failures-warning-threshold	UInt?	no	-	active	Number of consecutive failures after which warning logs start being emitted. Omit to use the default threshold. Example: 3.
defaults.l2-request-retries.ignore-first-exceptions-until-time-elapsed	Duration?	no	-	active	Grace period during which initial failures are ignored (not logged/counted) before retries are treated as errors. Omit to disable. Example: PT5S.
defaults.l2-request-retries.max-retries	UInt?	no	-	active	Maximum number of retry attempts. Omit for endless retries. Example: 3.
defaults.l2-request-retries.timeout	Duration?	no	-	active	Overall timeout across all retry attempts. Omit to disable the timeout. Example: PT10S.

forced-transactions

Forced transactions handling settings; omit the section to disable the feature.

Key	Type	Required	Default	Status	Description
forced-transactions.disabled	Boolean	no	false	active	Whether forced transactions handling is disabled.
forced-transactions.invalidity-proof-check-interval	Duration	no	PT2M	active	Interval between checks for invalidity proofs of forced transactions.
forced-transactions.l1-endpoint	URL?	no	-	active	L1 endpoint used to read forced transactions. Falls back to defaults.l1-endpoint. Example: http://l1-el-node:8545.
forced-transactions.l1-event-scraping.eth-logs-search-block-chunk-size	UInt	no	1000	active	Number of blocks scanned per eth_getLogs chunk.
forced-transactions.l1-event-scraping.eth-logs-search-max-block-range	UInt	no	10000	active	Maximum block range covered by a single eth_getLogs search.
forced-transactions.l1-event-scraping.eth-logs-search-success-backoff-delay	Duration	no	PT0.001S	active	Backoff delay after a successful eth_getLogs search before the next one.
forced-transactions.l1-event-scraping.polling-interval	Duration	no	PT12S	active	Interval between L1 log polling attempts.
forced-transactions.l1-event-scraping.polling-timeout	Duration	no	PT5S	active	Timeout for each L1 log polling request.
forced-transactions.l1-highest-block-tag	BlockParameter	no	FINALIZED	active	L1 block tag up to which forced-transaction events are read.
forced-transactions.l1-request-retries.backoff-delay	Duration	no	PT1S	active	Delay between retry attempts. Example: PT1S.
forced-transactions.l1-request-retries.failures-warning-threshold	UInt?	no	-	active	Number of consecutive failures after which warning logs start being emitted. Omit to use the default threshold. Example: 3.
forced-transactions.l1-request-retries.ignore-first-exceptions-until-time-elapsed	Duration?	no	-	active	Grace period during which initial failures are ignored (not logged/counted) before retries are treated as errors. Omit to disable. Example: PT5S.
forced-transactions.l1-request-retries.max-retries	UInt?	no	-	active	Maximum number of retry attempts. Omit for endless retries. Example: 3.
forced-transactions.l1-request-retries.timeout	Duration?	no	-	active	Overall timeout across all retry attempts. Omit to disable the timeout. Example: PT10S.
forced-transactions.processing-batch-size	UInt	no	10	active	Number of forced transactions processed per batch.
forced-transactions.processing-delay	Duration	no	PT0S	active	Delay before processing a forced transaction after it is detected.
forced-transactions.processing-tick-interval	Duration	no	PT2M	active	Interval between forced-transaction processing ticks.
forced-transactions.sequencer-endpoint	URL	yes	-	active	Sequencer endpoint to which forced transactions are submitted. Example: http://sequencer:8545.
forced-transactions.sequencer-request-retries.backoff-delay	Duration	no	PT1S	active	Delay between retry attempts. Example: PT1S.
forced-transactions.sequencer-request-retries.failures-warning-threshold	UInt?	no	-	active	Number of consecutive failures after which warning logs start being emitted. Omit to use the default threshold. Example: 3.
forced-transactions.sequencer-request-retries.ignore-first-exceptions-until-time-elapsed	Duration?	no	-	active	Grace period during which initial failures are ignored (not logged/counted) before retries are treated as errors. Omit to disable. Example: PT5S.
forced-transactions.sequencer-request-retries.max-retries	UInt?	no	-	active	Maximum number of retry attempts. Omit for endless retries. Example: 3.
forced-transactions.sequencer-request-retries.timeout	Duration?	no	-	active	Overall timeout across all retry attempts. Omit to disable the timeout. Example: PT10S.

l1-finalization-monitor

L1 finalization monitor polling settings.

Key	Type	Required	Default	Status	Description
l1-finalization-monitor.l1-endpoint	URL?	no	-	active	L1 endpoint for finalization monitoring. Falls back to defaults.l1-endpoint. Example: http://l1-el-node:8545.
l1-finalization-monitor.l1-polling-interval	Duration	no	PT6S	active	Interval between L1 finalization polls.
l1-finalization-monitor.l1-query-block-tag	Tag	no	FINALIZED	active	L1 block tag treated as finalized (e.g. FINALIZED, SAFE, LATEST).
l1-finalization-monitor.l1-request-retries.backoff-delay	Duration	no	PT1S	active	Delay between retry attempts. Example: PT1S.
l1-finalization-monitor.l1-request-retries.failures-warning-threshold	UInt?	no	-	active	Number of consecutive failures after which warning logs start being emitted. Omit to use the default threshold. Example: 3.
l1-finalization-monitor.l1-request-retries.ignore-first-exceptions-until-time-elapsed	Duration?	no	-	active	Grace period during which initial failures are ignored (not logged/counted) before retries are treated as errors. Omit to disable. Example: PT5S.
l1-finalization-monitor.l1-request-retries.max-retries	UInt?	no	-	active	Maximum number of retry attempts. Omit for endless retries. Example: 3.
l1-finalization-monitor.l1-request-retries.timeout	Duration?	no	-	active	Overall timeout across all retry attempts. Omit to disable the timeout. Example: PT10S.
l1-finalization-monitor.l2-endpoint	URL?	no	-	active	L2 endpoint for finalization monitoring. Falls back to defaults.l2-endpoint. Example: http://sequencer:8545.
l1-finalization-monitor.l2-request-retries.backoff-delay	Duration	no	PT1S	active	Delay between retry attempts. Example: PT1S.
l1-finalization-monitor.l2-request-retries.failures-warning-threshold	UInt?	no	-	active	Number of consecutive failures after which warning logs start being emitted. Omit to use the default threshold. Example: 3.
l1-finalization-monitor.l2-request-retries.ignore-first-exceptions-until-time-elapsed	Duration?	no	-	active	Grace period during which initial failures are ignored (not logged/counted) before retries are treated as errors. Omit to disable. Example: PT5S.
l1-finalization-monitor.l2-request-retries.max-retries	UInt?	no	-	active	Maximum number of retry attempts. Omit for endless retries. Example: 3.
l1-finalization-monitor.l2-request-retries.timeout	Duration?	no	-	active	Overall timeout across all retry attempts. Omit to disable the timeout. Example: PT10S.

l1-submission

L1 blob/aggregation submission (data availability and finalization) settings.

Key	Type	Required	Default	Status	Description
l1-submission.aggregation.disabled	Boolean	no	false	active	Whether aggregation submission is disabled.
l1-submission.aggregation.gas.fallback.priority-fee-per-gas-lower-bound	ULong	yes	-	active	Lower bound for the fallback priority fee per gas.
l1-submission.aggregation.gas.fallback.priority-fee-per-gas-upper-bound	ULong	yes	-	active	Upper bound for the fallback priority fee per gas.
l1-submission.aggregation.gas.gas-limit	ULong	yes	-	active	Gas limit for L1 submission transactions.
l1-submission.aggregation.gas.max-fee-per-blob-gas-cap	ULong	no	0	active	Cap on the max fee per blob gas for blob transactions. 0 disables the cap.
l1-submission.aggregation.gas.max-fee-per-gas-cap	ULong	yes	-	active	Cap on the EIP-1559 max fee per gas for L1 submission transactions.
l1-submission.aggregation.gas.max-priority-fee-per-gas-cap	ULong	yes	-	active	Cap on the EIP-1559 max priority fee per gas for L1 submission transactions.
l1-submission.aggregation.l1-endpoint	URL?	no	-	active	L1 endpoint for aggregation submission. Falls back to defaults.l1-endpoint. Example: http://l1-el-node:8545.
l1-submission.aggregation.l1-request-retries.backoff-delay	Duration	no	PT1S	active	Delay between retry attempts. Example: PT1S.
l1-submission.aggregation.l1-request-retries.failures-warning-threshold	UInt?	no	-	active	Number of consecutive failures after which warning logs start being emitted. Omit to use the default threshold. Example: 3.
l1-submission.aggregation.l1-request-retries.ignore-first-exceptions-until-time-elapsed	Duration?	no	-	active	Grace period during which initial failures are ignored (not logged/counted) before retries are treated as errors. Omit to disable. Example: PT5S.
l1-submission.aggregation.l1-request-retries.max-retries	UInt?	no	-	active	Maximum number of retry attempts. Omit for endless retries. Example: 3.
l1-submission.aggregation.l1-request-retries.timeout	Duration?	no	-	active	Overall timeout across all retry attempts. Omit to disable the timeout. Example: PT10S.
l1-submission.aggregation.max-submissions-per-tick	UInt	no	1	active	Maximum aggregation submissions sent per tick.
l1-submission.aggregation.signer.custom.name	String	yes	-	active	Logical signer name resolved by the injected signer factory.
l1-submission.aggregation.signer.type	SignerType	yes	-	active	Signer backend to use: WEB3J, WEB3SIGNER, or CUSTOM. Example: web3signer.
l1-submission.aggregation.signer.web3j.private-key	Masked	yes	-	active	Hex-encoded 32-byte private key used to sign transactions. Masked in logs.
l1-submission.aggregation.signer.web3signer.endpoint	URL	yes	-	active	Web3Signer HTTP endpoint. Example: http://web3signer:9000.
l1-submission.aggregation.signer.web3signer.keep-alive	Boolean	no	true	active	Whether to keep Web3Signer HTTP connections alive.
l1-submission.aggregation.signer.web3signer.max-pool-size	Int	no	10	active	Maximum size of the HTTP connection pool to Web3Signer.
l1-submission.aggregation.signer.web3signer.public-key	ByteArray	yes	-	active	Hex-encoded 64-byte public key whose corresponding key Web3Signer holds.
l1-submission.aggregation.signer.web3signer.tls.key-store-password	Masked	yes	-	active	Password for the client keystore. Masked in logs.
l1-submission.aggregation.signer.web3signer.tls.key-store-path	Path	yes	-	active	Path to the client keystore used for mutual TLS with Web3Signer. Example: /etc/coordinator/keystore.p12.
l1-submission.aggregation.signer.web3signer.tls.trust-store-password	Masked	yes	-	active	Password for the truststore. Masked in logs.
l1-submission.aggregation.signer.web3signer.tls.trust-store-path	Path	yes	-	active	Path to the truststore used to validate the Web3Signer certificate. Example: /etc/coordinator/truststore.p12.
l1-submission.aggregation.submission-delay	Duration	no	PT0S	active	Delay before submitting an aggregation after it becomes eligible.
l1-submission.aggregation.submission-tick-interval	Duration	no	PT24S	active	Interval between aggregation submission ticks.
l1-submission.blob.db-max-blobs-to-return	UInt	no	100	active	Maximum number of blobs read from the database per query.
l1-submission.blob.disabled	Boolean	no	false	active	Whether blob submission is disabled.
l1-submission.blob.gas.fallback.priority-fee-per-gas-lower-bound	ULong	yes	-	active	Lower bound for the fallback priority fee per gas.
l1-submission.blob.gas.fallback.priority-fee-per-gas-upper-bound	ULong	yes	-	active	Upper bound for the fallback priority fee per gas.
l1-submission.blob.gas.gas-limit	ULong	yes	-	active	Gas limit for L1 submission transactions.
l1-submission.blob.gas.max-fee-per-blob-gas-cap	ULong	no	0	active	Cap on the max fee per blob gas for blob transactions. 0 disables the cap.
l1-submission.blob.gas.max-fee-per-gas-cap	ULong	yes	-	active	Cap on the EIP-1559 max fee per gas for L1 submission transactions.
l1-submission.blob.gas.max-priority-fee-per-gas-cap	ULong	yes	-	active	Cap on the EIP-1559 max priority fee per gas for L1 submission transactions.
l1-submission.blob.l1-endpoint	URL?	no	-	active	L1 endpoint for blob submission. Falls back to defaults.l1-endpoint. Example: http://l1-el-node:8545.
l1-submission.blob.l1-request-retries.backoff-delay	Duration	no	PT1S	active	Delay between retry attempts. Example: PT1S.
l1-submission.blob.l1-request-retries.failures-warning-threshold	UInt?	no	-	active	Number of consecutive failures after which warning logs start being emitted. Omit to use the default threshold. Example: 3.
l1-submission.blob.l1-request-retries.ignore-first-exceptions-until-time-elapsed	Duration?	no	-	active	Grace period during which initial failures are ignored (not logged/counted) before retries are treated as errors. Omit to disable. Example: PT5S.
l1-submission.blob.l1-request-retries.max-retries	UInt?	no	-	active	Maximum number of retry attempts. Omit for endless retries. Example: 3.
l1-submission.blob.l1-request-retries.timeout	Duration?	no	-	active	Overall timeout across all retry attempts. Omit to disable the timeout. Example: PT10S.
l1-submission.blob.max-submission-transactions-per-tick	UInt	no	2	active	Maximum blob submission transactions sent per tick.
l1-submission.blob.signer.custom.name	String	yes	-	active	Logical signer name resolved by the injected signer factory.
l1-submission.blob.signer.type	SignerType	yes	-	active	Signer backend to use: WEB3J, WEB3SIGNER, or CUSTOM. Example: web3signer.
l1-submission.blob.signer.web3j.private-key	Masked	yes	-	active	Hex-encoded 32-byte private key used to sign transactions. Masked in logs.
l1-submission.blob.signer.web3signer.endpoint	URL	yes	-	active	Web3Signer HTTP endpoint. Example: http://web3signer:9000.
l1-submission.blob.signer.web3signer.keep-alive	Boolean	no	true	active	Whether to keep Web3Signer HTTP connections alive.
l1-submission.blob.signer.web3signer.max-pool-size	Int	no	10	active	Maximum size of the HTTP connection pool to Web3Signer.
l1-submission.blob.signer.web3signer.public-key	ByteArray	yes	-	active	Hex-encoded 64-byte public key whose corresponding key Web3Signer holds.
l1-submission.blob.signer.web3signer.tls.key-store-password	Masked	yes	-	active	Password for the client keystore. Masked in logs.
l1-submission.blob.signer.web3signer.tls.key-store-path	Path	yes	-	active	Path to the client keystore used for mutual TLS with Web3Signer. Example: /etc/coordinator/keystore.p12.
l1-submission.blob.signer.web3signer.tls.trust-store-password	Masked	yes	-	active	Password for the truststore. Masked in logs.
l1-submission.blob.signer.web3signer.tls.trust-store-path	Path	yes	-	active	Path to the truststore used to validate the Web3Signer certificate. Example: /etc/coordinator/truststore.p12.
l1-submission.blob.submission-delay	Duration	no	PT0S	active	Delay before submitting a blob after it becomes eligible.
l1-submission.blob.submission-tick-interval	Duration	no	PT12S	active	Interval between blob submission ticks.
l1-submission.blob.target-blobs-per-transaction	UInt	no	6	active	Target number of blobs per submission transaction (EIP-4844/7594 network cap is 6).
l1-submission.data-availability	DataAvailability	no	ROLLUP	active	Data availability mode: ROLLUP submits blobs to L1, VALIDIUM submits off-chain.
l1-submission.disabled	Boolean	no	false	active	Whether L1 submission is disabled.
l1-submission.dynamic-gas-price-cap.disabled	Boolean	no	false	active	Whether dynamic gas price cap calculation is disabled.
l1-submission.dynamic-gas-price-cap.fee-history-fetcher.fetch-interval	Duration	no	PT3S	active	Interval between fee-history fetches.
l1-submission.dynamic-gas-price-cap.fee-history-fetcher.l1-endpoint	URL?	no	-	active	L1 endpoint for fetching fee history. Falls back to defaults.l1-endpoint. Example: http://l1-el-node:8545.
l1-submission.dynamic-gas-price-cap.fee-history-fetcher.l1-request-retries.backoff-delay	Duration	no	PT1S	active	Delay between retry attempts. Example: PT1S.
l1-submission.dynamic-gas-price-cap.fee-history-fetcher.l1-request-retries.failures-warning-threshold	UInt?	no	-	active	Number of consecutive failures after which warning logs start being emitted. Omit to use the default threshold. Example: 3.
l1-submission.dynamic-gas-price-cap.fee-history-fetcher.l1-request-retries.ignore-first-exceptions-until-time-elapsed	Duration?	no	-	active	Grace period during which initial failures are ignored (not logged/counted) before retries are treated as errors. Omit to disable. Example: PT5S.
l1-submission.dynamic-gas-price-cap.fee-history-fetcher.l1-request-retries.max-retries	UInt?	no	-	active	Maximum number of retry attempts. Omit for endless retries. Example: 3.
l1-submission.dynamic-gas-price-cap.fee-history-fetcher.l1-request-retries.timeout	Duration?	no	-	active	Overall timeout across all retry attempts. Omit to disable the timeout. Example: PT10S.
l1-submission.dynamic-gas-price-cap.fee-history-fetcher.max-block-count	UInt	no	1000	active	Maximum number of blocks requested per fee-history call.
l1-submission.dynamic-gas-price-cap.fee-history-fetcher.num-of-blocks-before-latest	UInt	no	4	active	Number of blocks before the latest to stop at when fetching fee history.
l1-submission.dynamic-gas-price-cap.fee-history-fetcher.reward-percentiles	List<UInt>	no	[10, 20, 30, 40, 50, 60, 70, 80, 90, 100]	active	Reward percentiles requested from eth_feeHistory.
l1-submission.dynamic-gas-price-cap.fee-history-fetcher.storage-period	Duration	no	PT240H	active	How long fetched fee-history data is retained.
l1-submission.dynamic-gas-price-cap.gas-price-cap-calculation.adjustment-constant	UInt	yes	-	active	Additive constant applied when adjusting the (execution) gas price cap.
l1-submission.dynamic-gas-price-cap.gas-price-cap-calculation.base-fee-per-gas-percentile	UInt	yes	-	active	Percentile (1-100) of historical base fee per gas used in the calculation.
l1-submission.dynamic-gas-price-cap.gas-price-cap-calculation.base-fee-per-gas-percentile-window	Duration	yes	-	active	Time window over which the base-fee-per-gas percentile is computed.
l1-submission.dynamic-gas-price-cap.gas-price-cap-calculation.base-fee-per-gas-percentile-window-leeway	Duration	yes	-	active	Leeway subtracted from the base-fee-per-gas percentile window.
l1-submission.dynamic-gas-price-cap.gas-price-cap-calculation.blob-adjustment-constant	UInt	yes	-	active	Additive constant applied when adjusting the blob gas price cap.
l1-submission.dynamic-gas-price-cap.gas-price-cap-calculation.finalization-target-max-delay	Duration	yes	-	active	Maximum expected delay to finalization, used to scale the gas price cap.
l1-submission.dynamic-gas-price-cap.gas-price-cap-calculation.gas-price-caps-check-coefficient	Double	yes	-	active	Coefficient applied when checking computed gas price caps.
l1-submission.dynamic-gas-price-cap.gas-price-cap-calculation.historic-avg-reward-constant	ULong	yes	-	active	Constant used for the historical average reward calculation.
l1-submission.dynamic-gas-price-cap.gas-price-cap-calculation.historic-base-fee-per-blob-gas-lower-bound	ULong	yes	-	active	Lower bound for the historical base fee per blob gas.
l1-submission.fallback-gas-price.fee-history-block-count	UInt	yes	-	active	Number of blocks of fee history used to compute the fallback gas price.
l1-submission.fallback-gas-price.fee-history-reward-percentile	UInt	yes	-	active	Reward percentile (1-100) used to compute the fallback gas price.

l2-network-gas-pricing

L2 network gas pricing (dynamic gas price publishing) settings.

Key	Type	Required	Default	Status	Description
l2-network-gas-pricing.disabled	Boolean	no	false	active	Whether L2 network gas pricing is disabled.
l2-network-gas-pricing.dynamic-gas-pricing.blob-submission-expected-execution-gas	ULong	yes	-	active	Expected L1 execution gas consumed by a blob submission transaction.
l2-network-gas-pricing.dynamic-gas-pricing.calldata-based-pricing.block-size-non-calldata-overhead	UInt	no	540	active	Per-block non-calldata size overhead (bytes) in the calculation.
l2-network-gas-pricing.dynamic-gas-pricing.calldata-based-pricing.calldata-sum-size-block-count	UInt	no	5	active	Number of recent blocks summed when measuring calldata usage.
l2-network-gas-pricing.dynamic-gas-pricing.calldata-based-pricing.calldata-sum-size-target	ULong	no	109000	active	Target total calldata size (bytes) across the measured blocks.
l2-network-gas-pricing.dynamic-gas-pricing.calldata-based-pricing.fee-change-denominator	UInt	no	32	active	Denominator controlling how quickly the fee reacts to calldata-usage deviations.
l2-network-gas-pricing.dynamic-gas-pricing.l1-blob-gas	ULong	yes	-	active	Expected L1 blob gas used per blob when computing the variable cost.
l2-network-gas-pricing.dynamic-gas-pricing.margin	Double	yes	-	active	Multiplier applied to the computed variable cost (safety/profit margin).
l2-network-gas-pricing.dynamic-gas-pricing.variable-cost-lower-bound	ULong	yes	-	active	Lower bound for the computed variable cost component.
l2-network-gas-pricing.dynamic-gas-pricing.variable-cost-upper-bound	ULong	yes	-	active	Upper bound for the computed variable cost component.
l2-network-gas-pricing.extra-data-update-endpoint	URL	yes	-	active	L2 endpoint that receives the computed gas pricing via the extra-data update call. Example: http://sequencer:8545.
l2-network-gas-pricing.extra-data-update-request-retries.backoff-delay	Duration	no	PT1S	active	Delay between retry attempts. Example: PT1S.
l2-network-gas-pricing.extra-data-update-request-retries.failures-warning-threshold	UInt?	no	-	active	Number of consecutive failures after which warning logs start being emitted. Omit to use the default threshold. Example: 3.
l2-network-gas-pricing.extra-data-update-request-retries.ignore-first-exceptions-until-time-elapsed	Duration?	no	-	active	Grace period during which initial failures are ignored (not logged/counted) before retries are treated as errors. Omit to disable. Example: PT5S.
l2-network-gas-pricing.extra-data-update-request-retries.max-retries	UInt?	no	-	active	Maximum number of retry attempts. Omit for endless retries. Example: 3.
l2-network-gas-pricing.extra-data-update-request-retries.timeout	Duration?	no	-	active	Overall timeout across all retry attempts. Omit to disable the timeout. Example: PT10S.
l2-network-gas-pricing.fee-history-block-count	UInt	no	1000	active	Number of blocks of fee history used in gas pricing.
l2-network-gas-pricing.fee-history-reward-percentile	UInt	no	15	active	Reward percentile (1-100) of fee history used in gas pricing.
l2-network-gas-pricing.flat-rate-gas-pricing.compressed-tx-size	UInt	no	125	active	Assumed compressed size (bytes) of a transaction.
l2-network-gas-pricing.flat-rate-gas-pricing.expected-gas	UInt	no	21000	active	Assumed gas used by a plain transfer transaction.
l2-network-gas-pricing.flat-rate-gas-pricing.gas-price-lower-bound	ULong	yes	-	active	Lower bound (in wei) for the flat-rate L2 gas price.
l2-network-gas-pricing.flat-rate-gas-pricing.gas-price-upper-bound	ULong	yes	-	active	Upper bound (in wei) for the flat-rate L2 gas price.
l2-network-gas-pricing.flat-rate-gas-pricing.plain-transfer-cost-multiplier	Double	no	1.0	active	Multiplier applied to the plain-transfer cost when computing the price.
l2-network-gas-pricing.gas-price-fixed-cost	ULong	yes	-	active	Fixed cost component (in wei) added to the computed L2 gas price.
l2-network-gas-pricing.l1-endpoint	URL?	no	-	active	L1 endpoint used for gas pricing. Falls back to defaults.l1-endpoint. Example: http://l1-el-node:8545.
l2-network-gas-pricing.l1-request-retries.backoff-delay	Duration	no	PT1S	active	Delay between retry attempts. Example: PT1S.
l2-network-gas-pricing.l1-request-retries.failures-warning-threshold	UInt?	no	-	active	Number of consecutive failures after which warning logs start being emitted. Omit to use the default threshold. Example: 3.
l2-network-gas-pricing.l1-request-retries.ignore-first-exceptions-until-time-elapsed	Duration?	no	-	active	Grace period during which initial failures are ignored (not logged/counted) before retries are treated as errors. Omit to disable. Example: PT5S.
l2-network-gas-pricing.l1-request-retries.max-retries	UInt?	no	-	active	Maximum number of retry attempts. Omit for endless retries. Example: 3.
l2-network-gas-pricing.l1-request-retries.timeout	Duration?	no	-	active	Overall timeout across all retry attempts. Omit to disable the timeout. Example: PT10S.
l2-network-gas-pricing.l2-endpoint	URL?	no	-	active	L2 endpoint used for gas pricing. Falls back to defaults.l2-endpoint. Example: http://sequencer:8545.
l2-network-gas-pricing.l2-request-retries.backoff-delay	Duration	no	PT1S	active	Delay between retry attempts. Example: PT1S.
l2-network-gas-pricing.l2-request-retries.failures-warning-threshold	UInt?	no	-	active	Number of consecutive failures after which warning logs start being emitted. Omit to use the default threshold. Example: 3.
l2-network-gas-pricing.l2-request-retries.ignore-first-exceptions-until-time-elapsed	Duration?	no	-	active	Grace period during which initial failures are ignored (not logged/counted) before retries are treated as errors. Omit to disable. Example: PT5S.
l2-network-gas-pricing.l2-request-retries.max-retries	UInt?	no	-	active	Maximum number of retry attempts. Omit for endless retries. Example: 3.
l2-network-gas-pricing.l2-request-retries.timeout	Duration?	no	-	active	Overall timeout across all retry attempts. Omit to disable the timeout. Example: PT10S.
l2-network-gas-pricing.price-update-interval	Duration	no	PT12S	active	Interval between L2 gas price recalculations/updates.

message-anchoring

L1 to L2 message anchoring settings.

Key	Type	Required	Default	Status	Description
message-anchoring.anchoring-tick-interval	Duration	no	PT10S	active	Interval between message anchoring ticks.
message-anchoring.disabled	Boolean	no	false	active	Whether L1 to L2 message anchoring is disabled.
message-anchoring.gas.fee-history-block-count	UInt	no	4	active	Number of blocks of fee history used to price anchoring transactions.
message-anchoring.gas.fee-history-reward-percentile	UInt	no	15	active	Reward percentile (1-100) of fee history used to price anchoring transactions.
message-anchoring.gas.gas-limit	ULong	no	2500000	active	Gas limit for anchoring transactions.
message-anchoring.gas.max-fee-per-gas-cap	ULong	no	100000000000	active	Cap on the EIP-1559 max fee per gas for anchoring transactions (wei).
message-anchoring.l1-endpoint	URL?	no	-	active	L1 endpoint used for anchoring. Falls back to defaults.l1-endpoint. Example: http://l1-el-node:8545.
message-anchoring.l1-event-scraping.eth-logs-search-block-chunk-size	UInt	no	1000	active	Number of blocks scanned per eth_getLogs chunk.
message-anchoring.l1-event-scraping.eth-logs-search-max-block-range	UInt	no	10000	active	Maximum block range covered by a single eth_getLogs search.
message-anchoring.l1-event-scraping.eth-logs-search-success-backoff-delay	Duration	no	PT0.001S	active	Backoff delay after a successful eth_getLogs search before the next one.
message-anchoring.l1-event-scraping.polling-interval	Duration	no	PT6S	active	Interval between L1 log polling attempts.
message-anchoring.l1-event-scraping.polling-timeout	Duration	no	PT5S	active	Timeout for each L1 log polling request.
message-anchoring.l1-highest-block-tag	BlockParameter	no	FINALIZED	active	L1 block tag up to which message events are read (e.g. FINALIZED, LATEST, or a number).
message-anchoring.l1-request-retries.backoff-delay	Duration	no	PT1S	active	Delay between retry attempts. Example: PT1S.
message-anchoring.l1-request-retries.failures-warning-threshold	UInt?	no	-	active	Number of consecutive failures after which warning logs start being emitted. Omit to use the default threshold. Example: 3.
message-anchoring.l1-request-retries.ignore-first-exceptions-until-time-elapsed	Duration?	no	-	active	Grace period during which initial failures are ignored (not logged/counted) before retries are treated as errors. Omit to disable. Example: PT5S.
message-anchoring.l1-request-retries.max-retries	UInt?	no	-	active	Maximum number of retry attempts. Omit for endless retries. Example: 3.
message-anchoring.l1-request-retries.timeout	Duration?	no	-	active	Overall timeout across all retry attempts. Omit to disable the timeout. Example: PT10S.
message-anchoring.l2-endpoint	URL?	no	-	active	L2 endpoint used for anchoring. Falls back to defaults.l2-endpoint. Example: http://sequencer:8545.
message-anchoring.l2-highest-block-tag	BlockParameter	no	LATEST	active	L2 block tag up to which anchoring state is read (e.g. LATEST, FINALIZED, or a number).
message-anchoring.l2-request-retries.backoff-delay	Duration	no	PT1S	active	Delay between retry attempts. Example: PT1S.
message-anchoring.l2-request-retries.failures-warning-threshold	UInt?	no	-	active	Number of consecutive failures after which warning logs start being emitted. Omit to use the default threshold. Example: 3.
message-anchoring.l2-request-retries.ignore-first-exceptions-until-time-elapsed	Duration?	no	-	active	Grace period during which initial failures are ignored (not logged/counted) before retries are treated as errors. Omit to disable. Example: PT5S.
message-anchoring.l2-request-retries.max-retries	UInt?	no	-	active	Maximum number of retry attempts. Omit for endless retries. Example: 3.
message-anchoring.l2-request-retries.timeout	Duration?	no	-	active	Overall timeout across all retry attempts. Omit to disable the timeout. Example: PT10S.
message-anchoring.max-messages-to-anchor-per-l2-transaction	UInt	no	100	active	Maximum number of messages anchored in a single L2 transaction.
message-anchoring.message-queue-capacity	UInt	no	10000	active	Maximum number of messages buffered awaiting anchoring.
message-anchoring.signer.custom.name	String	yes	-	active	Logical signer name resolved by the injected signer factory.
message-anchoring.signer.type	SignerType	yes	-	active	Signer backend to use: WEB3J, WEB3SIGNER, or CUSTOM. Example: web3signer.
message-anchoring.signer.web3j.private-key	Masked	yes	-	active	Hex-encoded 32-byte private key used to sign transactions. Masked in logs.
message-anchoring.signer.web3signer.endpoint	URL	yes	-	active	Web3Signer HTTP endpoint. Example: http://web3signer:9000.
message-anchoring.signer.web3signer.keep-alive	Boolean	no	true	active	Whether to keep Web3Signer HTTP connections alive.
message-anchoring.signer.web3signer.max-pool-size	Int	no	10	active	Maximum size of the HTTP connection pool to Web3Signer.
message-anchoring.signer.web3signer.public-key	ByteArray	yes	-	active	Hex-encoded 64-byte public key whose corresponding key Web3Signer holds.
message-anchoring.signer.web3signer.tls.key-store-password	Masked	yes	-	active	Password for the client keystore. Masked in logs.
message-anchoring.signer.web3signer.tls.key-store-path	Path	yes	-	active	Path to the client keystore used for mutual TLS with Web3Signer. Example: /etc/coordinator/keystore.p12.
message-anchoring.signer.web3signer.tls.trust-store-password	Masked	yes	-	active	Password for the truststore. Masked in logs.
message-anchoring.signer.web3signer.tls.trust-store-path	Path	yes	-	active	Path to the truststore used to validate the Web3Signer certificate. Example: /etc/coordinator/truststore.p12.

protocol

Linea protocol contract addresses and genesis settings.

Key	Type	Required	Default	Status	Description
protocol.genesis.genesis-shnarf	ByteArray	yes	-	active	Genesis shnarf (starting shnarf) of the Linea chain (hex). Example: 0xc286ff42414401ccdc23ea8e738775378e8f6c6f7b2966eb2747798d45571b79.
protocol.genesis.genesis-state-root-hash	ByteArray	yes	-	active	Genesis state root hash of the Linea chain (hex). Example: 0x01d9afcd495c870f3ae9d8362cd0257a7de2057055058183596719285cae6101.
protocol.l1.block-time	Duration	no	PT12S	active	Average L1 block time, used for timing estimates.
protocol.l1.contract-address	String	yes	-	active	Address of the Linea rollup contract on L1. Example: 0xDc64a140Aa3E981100a9becA4E685f962f0cF6C9.
protocol.l1.contract-deployment-block-number	ULong?	no	-	active	L1 block number at which the rollup contract was deployed. Omit if not applicable. Example: 3.
protocol.l2.contract-address	String	yes	-	active	Address of the Linea contract on L2. Example: 0xe537D669CA013d86EBeF1D64e40fC74CADC91987.
protocol.l2.contract-deployment-block-number	ULong?	no	-	active	L2 block number at which the contract was deployed. Omit if not applicable. Example: 3.

prover

File-based prover request/response directories and switch-over settings.

Key	Type	Required	Default	Status	Description
prover.blob-compression.fs-requests-directory	String	yes	-	active	Directory the coordinator writes prover request files to. Example: /data/prover/v3/execution/requests.
prover.blob-compression.fs-responses-directory	String	yes	-	active	Directory the coordinator reads prover response files from. Example: /data/prover/v3/execution/responses.
prover.enable-request-files-cleanup	Boolean	no	false	active	Whether to delete request files after their responses are processed.
prover.execution.fs-requests-directory	String	yes	-	active	Directory the coordinator writes prover request files to. Example: /data/prover/v3/execution/requests.
prover.execution.fs-responses-directory	String	yes	-	active	Directory the coordinator reads prover response files from. Example: /data/prover/v3/execution/responses.
prover.fs-inprogress-proving-suffix-pattern	String	no	\\.inprogress\\.prover.*	active	Regex matching filenames a prover has claimed and is working on, so the coordinator treats them as in-progress.
prover.fs-inprogress-request-writing-suffix	String	no	.inprogress_coordinator_writing	active	Filename suffix appended while the coordinator is still writing a request file, so provers ignore partially-written requests.
prover.fs-polling-interval	Duration	no	PT15S	active	Interval between scans of the prover response directories for new responses.
prover.fs-polling-timeout	Duration	no	infinite	active	Maximum time to wait for a prover response before timing out. Defaults to no timeout.
prover.invalidity.fs-requests-directory	String	yes	-	active	Directory the coordinator writes prover request files to. Example: /data/prover/v3/execution/requests.
prover.invalidity.fs-responses-directory	String	yes	-	active	Directory the coordinator reads prover response files from. Example: /data/prover/v3/execution/responses.
prover.new.blob-compression.fs-requests-directory	String	yes	-	active	Directory the coordinator writes prover request files to. Example: /data/prover/v3/execution/requests.
prover.new.blob-compression.fs-responses-directory	String	yes	-	active	Directory the coordinator reads prover response files from. Example: /data/prover/v3/execution/responses.
prover.new.enable-request-files-cleanup	Boolean	no	false	active	Whether to delete request files after their responses are processed.
prover.new.execution.fs-requests-directory	String	yes	-	active	Directory the coordinator writes prover request files to. Example: /data/prover/v3/execution/requests.
prover.new.execution.fs-responses-directory	String	yes	-	active	Directory the coordinator reads prover response files from. Example: /data/prover/v3/execution/responses.
prover.new.fs-inprogress-proving-suffix-pattern	String	no	\\.inprogress\\.prover.*	active	Regex matching filenames a prover has claimed and is working on, so the coordinator treats them as in-progress.
prover.new.fs-inprogress-request-writing-suffix	String	no	.inprogress_coordinator_writing	active	Filename suffix appended while the coordinator is still writing a request file, so provers ignore partially-written requests.
prover.new.fs-polling-interval	Duration	no	PT15S	active	Interval between scans of the prover response directories for new responses.
prover.new.fs-polling-timeout	Duration	no	infinite	active	Maximum time to wait for a prover response before timing out. Defaults to no timeout.
prover.new.invalidity.fs-requests-directory	String	yes	-	active	Directory the coordinator writes prover request files to. Example: /data/prover/v3/execution/requests.
prover.new.invalidity.fs-responses-directory	String	yes	-	active	Directory the coordinator reads prover response files from. Example: /data/prover/v3/execution/responses.
prover.new.proof-aggregation.fs-requests-directory	String	yes	-	active	Directory the coordinator writes prover request files to. Example: /data/prover/v3/execution/requests.
prover.new.proof-aggregation.fs-responses-directory	String	yes	-	active	Directory the coordinator reads prover response files from. Example: /data/prover/v3/execution/responses.
prover.new.switch-block-number-inclusive	ULong?	no	-	active	Inclusive L2 block number at which to switch from this prover to the new prover. Mutually exclusive with switchBlockTimestamp. Example: 1000000.
prover.new.switch-block-timestamp	Instant?	no	-	active	Timestamp at which to switch from this prover to the new prover. Mutually exclusive with switchBlockNumberInclusive. Example: 2024-01-01T00:00:00Z.
prover.proof-aggregation.fs-requests-directory	String	yes	-	active	Directory the coordinator writes prover request files to. Example: /data/prover/v3/execution/requests.
prover.proof-aggregation.fs-responses-directory	String	yes	-	active	Directory the coordinator reads prover response files from. Example: /data/prover/v3/execution/responses.
prover.switch-block-number-inclusive	ULong?	no	-	active	Inclusive L2 block number at which to switch from this prover to the new prover. Mutually exclusive with switchBlockTimestamp. Example: 1000000.
prover.switch-block-timestamp	Instant?	no	-	active	Timestamp at which to switch from this prover to the new prover. Mutually exclusive with switchBlockNumberInclusive. Example: 2024-01-01T00:00:00Z.

state-manager

Shomei state manager client settings.

Key	Type	Required	Default	Status	Description
state-manager.endpoints	List<URL>	yes	-	active	Shomei state manager JSON-RPC endpoints. Example: ["http://shomei:8888"].
state-manager.request-limit-per-endpoint	UInt	no	4294967295	active	Maximum number of concurrent in-flight requests per state manager endpoint.
state-manager.request-retries.backoff-delay	Duration	no	PT1S	active	Delay between retry attempts. Example: PT1S.
state-manager.request-retries.failures-warning-threshold	UInt?	no	-	active	Number of consecutive failures after which warning logs start being emitted. Omit to use the default threshold. Example: 3.
state-manager.request-retries.ignore-first-exceptions-until-time-elapsed	Duration?	no	-	active	Grace period during which initial failures are ignored (not logged/counted) before retries are treated as errors. Omit to disable. Example: PT5S.
state-manager.request-retries.max-retries	UInt?	no	-	active	Maximum number of retry attempts. Omit for endless retries. Example: 3.
state-manager.request-retries.timeout	Duration?	no	-	active	Overall timeout across all retry attempts. Omit to disable the timeout. Example: PT10S.
state-manager.request-timeout	Duration?	no	-	active	Timeout for each state manager request. Omit to disable the timeout. Example: PT30S.

traces

Trace generation (traces API / conflation counters) client settings.

Key	Type	Required	Default	Status	Description
traces.conflation.endpoints	List<URL>?	no	-	active	Endpoints for this specific traces client. Falls back to traces.endpoints when omitted. Example: ["http://traces-node:8545"].
traces.conflation.request-limit-per-endpoint	UInt?	no	-	active	Per-endpoint concurrent request limit for this client. Falls back to the shared value. Example: 4.
traces.conflation.request-retries.backoff-delay	Duration	no	PT1S	active	Delay between retry attempts. Example: PT1S.
traces.conflation.request-retries.failures-warning-threshold	UInt?	no	-	active	Number of consecutive failures after which warning logs start being emitted. Omit to use the default threshold. Example: 3.
traces.conflation.request-retries.ignore-first-exceptions-until-time-elapsed	Duration?	no	-	active	Grace period during which initial failures are ignored (not logged/counted) before retries are treated as errors. Omit to disable. Example: PT5S.
traces.conflation.request-retries.max-retries	UInt?	no	-	active	Maximum number of retry attempts. Omit for endless retries. Example: 3.
traces.conflation.request-retries.timeout	Duration?	no	-	active	Overall timeout across all retry attempts. Omit to disable the timeout. Example: PT10S.
traces.conflation.request-timeout	Duration?	no	-	active	Request timeout for this client. Falls back to the shared value. Example: PT30S.
traces.counters.endpoints	List<URL>?	no	-	active	Endpoints for this specific traces client. Falls back to traces.endpoints when omitted. Example: ["http://traces-node:8545"].
traces.counters.request-limit-per-endpoint	UInt?	no	-	active	Per-endpoint concurrent request limit for this client. Falls back to the shared value. Example: 4.
traces.counters.request-retries.backoff-delay	Duration	no	PT1S	active	Delay between retry attempts. Example: PT1S.
traces.counters.request-retries.failures-warning-threshold	UInt?	no	-	active	Number of consecutive failures after which warning logs start being emitted. Omit to use the default threshold. Example: 3.
traces.counters.request-retries.ignore-first-exceptions-until-time-elapsed	Duration?	no	-	active	Grace period during which initial failures are ignored (not logged/counted) before retries are treated as errors. Omit to disable. Example: PT5S.
traces.counters.request-retries.max-retries	UInt?	no	-	active	Maximum number of retry attempts. Omit for endless retries. Example: 3.
traces.counters.request-retries.timeout	Duration?	no	-	active	Overall timeout across all retry attempts. Omit to disable the timeout. Example: PT10S.
traces.counters.request-timeout	Duration?	no	-	active	Request timeout for this client. Falls back to the shared value. Example: PT30S.
traces.endpoints	List<URL>?	no	-	active	Traces generator endpoints shared by the counters and conflation clients. Required unless both counters.endpoints and conflation.endpoints are set. Example: ["http://traces-node:8545"].
traces.ignore-traces-generator-errors	Boolean	no	false	active	Whether to continue despite traces generator errors instead of failing.
traces.new.conflation.endpoints	List<URL>?	no	-	active	Endpoints for this specific traces client. Falls back to traces.endpoints when omitted. Example: ["http://traces-node:8545"].
traces.new.conflation.request-limit-per-endpoint	UInt?	no	-	active	Per-endpoint concurrent request limit for this client. Falls back to the shared value. Example: 4.
traces.new.conflation.request-retries.backoff-delay	Duration	no	PT1S	active	Delay between retry attempts. Example: PT1S.
traces.new.conflation.request-retries.failures-warning-threshold	UInt?	no	-	active	Number of consecutive failures after which warning logs start being emitted. Omit to use the default threshold. Example: 3.
traces.new.conflation.request-retries.ignore-first-exceptions-until-time-elapsed	Duration?	no	-	active	Grace period during which initial failures are ignored (not logged/counted) before retries are treated as errors. Omit to disable. Example: PT5S.
traces.new.conflation.request-retries.max-retries	UInt?	no	-	active	Maximum number of retry attempts. Omit for endless retries. Example: 3.
traces.new.conflation.request-retries.timeout	Duration?	no	-	active	Overall timeout across all retry attempts. Omit to disable the timeout. Example: PT10S.
traces.new.conflation.request-timeout	Duration?	no	-	active	Request timeout for this client. Falls back to the shared value. Example: PT30S.
traces.new.counters.endpoints	List<URL>?	no	-	active	Endpoints for this specific traces client. Falls back to traces.endpoints when omitted. Example: ["http://traces-node:8545"].
traces.new.counters.request-limit-per-endpoint	UInt?	no	-	active	Per-endpoint concurrent request limit for this client. Falls back to the shared value. Example: 4.
traces.new.counters.request-retries.backoff-delay	Duration	no	PT1S	active	Delay between retry attempts. Example: PT1S.
traces.new.counters.request-retries.failures-warning-threshold	UInt?	no	-	active	Number of consecutive failures after which warning logs start being emitted. Omit to use the default threshold. Example: 3.
traces.new.counters.request-retries.ignore-first-exceptions-until-time-elapsed	Duration?	no	-	active	Grace period during which initial failures are ignored (not logged/counted) before retries are treated as errors. Omit to disable. Example: PT5S.
traces.new.counters.request-retries.max-retries	UInt?	no	-	active	Maximum number of retry attempts. Omit for endless retries. Example: 3.
traces.new.counters.request-retries.timeout	Duration?	no	-	active	Overall timeout across all retry attempts. Omit to disable the timeout. Example: PT10S.
traces.new.counters.request-timeout	Duration?	no	-	active	Request timeout for this client. Falls back to the shared value. Example: PT30S.
traces.new.endpoints	List<URL>?	no	-	active	Traces generator endpoints shared by the counters and conflation clients. Required unless both counters.endpoints and conflation.endpoints are set. Example: ["http://traces-node:8545"].
traces.new.ignore-traces-generator-errors	Boolean	no	false	active	Whether to continue despite traces generator errors instead of failing.
traces.new.request-limit-per-endpoint	UInt	no	4294967295	active	Maximum number of concurrent in-flight requests per traces endpoint.
traces.new.request-retries.backoff-delay	Duration	no	PT1S	active	Delay between retry attempts. Example: PT1S.
traces.new.request-retries.failures-warning-threshold	UInt?	no	-	active	Number of consecutive failures after which warning logs start being emitted. Omit to use the default threshold. Example: 3.
traces.new.request-retries.ignore-first-exceptions-until-time-elapsed	Duration?	no	-	active	Grace period during which initial failures are ignored (not logged/counted) before retries are treated as errors. Omit to disable. Example: PT5S.
traces.new.request-retries.max-retries	UInt?	no	-	active	Maximum number of retry attempts. Omit for endless retries. Example: 3.
traces.new.request-retries.timeout	Duration?	no	-	active	Overall timeout across all retry attempts. Omit to disable the timeout. Example: PT10S.
traces.new.request-timeout	Duration?	no	-	active	Timeout for each traces generator request. Omit to disable the timeout. Example: PT30S.
traces.new.switch-block-number-inclusive	UInt?	no	-	active	Inclusive L2 block number at which to switch from this traces config to the new one. Example: 1000000.
traces.request-limit-per-endpoint	UInt	no	4294967295	active	Maximum number of concurrent in-flight requests per traces endpoint.
traces.request-retries.backoff-delay	Duration	no	PT1S	active	Delay between retry attempts. Example: PT1S.
traces.request-retries.failures-warning-threshold	UInt?	no	-	active	Number of consecutive failures after which warning logs start being emitted. Omit to use the default threshold. Example: 3.
traces.request-retries.ignore-first-exceptions-until-time-elapsed	Duration?	no	-	active	Grace period during which initial failures are ignored (not logged/counted) before retries are treated as errors. Omit to disable. Example: PT5S.
traces.request-retries.max-retries	UInt?	no	-	active	Maximum number of retry attempts. Omit for endless retries. Example: 3.
traces.request-retries.timeout	Duration?	no	-	active	Overall timeout across all retry attempts. Omit to disable the timeout. Example: PT10S.
traces.request-timeout	Duration?	no	-	active	Timeout for each traces generator request. Omit to disable the timeout. Example: PT30S.
traces.switch-block-number-inclusive	UInt?	no	-	active	Inclusive L2 block number at which to switch from this traces config to the new one. Example: 1000000.

type2-state-proof-provider

Type-2 state proof provider (shnarf/state proof) settings.

Key	Type	Required	Default	Status	Description
type2-state-proof-provider.disabled	Boolean	no	false	active	Whether the type-2 state proof provider is disabled.
type2-state-proof-provider.endpoints	List<URL>	yes	-	active	Type-2 state proof provider JSON-RPC endpoints. Example: ["http://shomei-frontend:8888"].
type2-state-proof-provider.l1-polling-interval	Duration	no	PT6S	active	Interval between L1 polls for state proof updates.
type2-state-proof-provider.l1-query-block-tag	Tag	no	FINALIZED	active	L1 block tag queried for state proofs (e.g. FINALIZED, LATEST).
type2-state-proof-provider.request-retries.backoff-delay	Duration	no	PT1S	active	Delay between retry attempts. Example: PT1S.
type2-state-proof-provider.request-retries.failures-warning-threshold	UInt?	no	-	active	Number of consecutive failures after which warning logs start being emitted. Omit to use the default threshold. Example: 3.
type2-state-proof-provider.request-retries.ignore-first-exceptions-until-time-elapsed	Duration?	no	-	active	Grace period during which initial failures are ignored (not logged/counted) before retries are treated as errors. Omit to disable. Example: PT5S.
type2-state-proof-provider.request-retries.max-retries	UInt?	no	-	active	Maximum number of retry attempts. Omit for endless retries. Example: 3.
type2-state-proof-provider.request-retries.timeout	Duration?	no	-	active	Overall timeout across all retry attempts. Omit to disable the timeout. Example: PT10S.

traces-limits-v4

Per-module trace counter limits for v4 tracing modules.

Key	Type	Required	Default	Status	Description
traces-limits	Map<TracingModuleV4, UInt>	yes	-	active	Per-module trace counter limits (v4 tracing modules). Each entry maps a tracing module name to its maximum trace count.

traces-limits-v5

Per-module trace counter limits for v5 tracing modules.

Key	Type	Required	Default	Status	Description
traces-limits	Map<TracingModuleV5, UInt>	yes	-	active	Per-module trace counter limits (v5 tracing modules). Each entry maps a tracing module name to its maximum trace count.

gas-price-cap-time-of-day-multipliers

L1 dynamic gas price cap time-of-day multipliers.

Key	Type	Required	Default	Status	Description
gas-price-cap-time-of-day-multipliers	Map<String, Double>	yes	-	active	L1 dynamic gas price cap multipliers keyed by time-of-day/day-of-week slot; each entry scales the base gas price cap for that slot.

smart-contract-errors

Mapping of Linea smart-contract revert error codes to messages.

Key	Type	Required	Default	Status	Description
smart-contract-errors	Map<String, String>	yes	-	active	Mapping of Linea smart-contract revert error codes to human-readable messages, used to decode on-chain rejection reasons.

Deprecated Keys

None.