<!-- Canonical: https://docs.linea.build/reference/component-configuration/linea-besu-plugin-options -->

> For the complete Linea documentation index, see [llms.txt](/llms.txt).
> Agents can fetch this page as Markdown at [https://docs.linea.build/reference/component-configuration/linea-besu-plugin-options.md](https://docs.linea.build/reference/component-configuration/linea-besu-plugin-options.md).

# Linea Besu plugin configuration reference

Advanced options

Options marked Advanced are hidden from the standard CLI help output but 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 plugin source. They are not recommended production settings and may be overridden by deployment configuration.

Forced transactions excluded

The `LineaForcedTransactionCliOptions` group is excluded because the forced-transactions feature has not been released.

This reference lists plugin-specific options (flags starting with `--plugin-`), grouped by plugin and feature. Descriptions come from the Java `@Option` sources; defaults are shown in the Default column. Repeated `(default: …)` text is omitted from descriptions.

Generated from [`LFDT-Lineth/lineth-monorepo@0443bff`](https://github.com/LFDT-Lineth/lineth-monorepo/commit/0443bff60e5603105067b88868fb5549aed03cbc).

Options may differ in other Linea Besu releases.

## Sequencer

### Sequencer — Bundle

Config-file key: `bundle-sequencer`

| Option | Description | Default | Type | Visibility |
| --- | --- | --- | --- | --- |
| `--plugin-linea-bundles-forward-urls` | A comma separated list of endpoints to which incoming bundles will be forwarded | `[]` | `SET<URL>` | Standard |
| `--plugin-linea-bundles-forward-retry-delay` | Number of milliseconds to wait before retrying a failed forward | `1000` | `INTEGER` | Standard |
| `--plugin-linea-bundles-forward-timeout` | Number of milliseconds to wait before a forward times out | `5000` | `INTEGER` | Standard |

### Sequencer — Liveness service

Config-file key: `liveness-config`

| Option | Description | Default | Type | Visibility |
| --- | --- | --- | --- | --- |
| `--plugin-linea-liveness-enabled` | Enable the Linea liveness service | `false` | `BOOLEAN` | Advanced |
| `--plugin-linea-liveness-max-block-age-seconds` | Maximum age of the last block in seconds before reporting | `60` | `LONG` | Advanced |
| `--plugin-linea-liveness-bundle-max-timestamp-surplus-seconds` | Additional seconds for the max timestamp of bundle | `12` | `LONG` | Advanced |
| `--plugin-linea-liveness-contract-address` | Address of the LineaSequencerUptimeFeed contract | — | `SMC_ADDRESS` | Advanced |
| `--plugin-linea-liveness-signer-url` | URL of the Web3Signer service, in charge of signing transactions | — | `URL` | Advanced |
| `--plugin-linea-liveness-signer-key-id` | Key ID to use with Web3Signer, the public key in hex corresponding to the private key in charge of signing transactions | — | `PUBLIC_KEY_HEX` | Advanced |
| `--plugin-linea-liveness-signer-address` | Ethereum address corresponding to the Web3Signer key ID | — | `EOA_ADDRESS` | Advanced |
| `--plugin-linea-liveness-tls-enabled` | Enable TLS connection to Web3Signer | `false` | `BOOLEAN` | Advanced |
| `--plugin-linea-liveness-tls-key-store-path` | Path to the TLS key store file | — | `FILE_PATH` | Advanced |
| `--plugin-linea-liveness-tls-key-store-password` | TLS key store password | — | `PASSWORD` | Advanced |
| `--plugin-linea-liveness-tls-trust-store-path` | Path to the TLS trust store file | — | `FILE_PATH` | Advanced |
| `--plugin-linea-liveness-tls-trust-store-password` | TLS trust store password | — | `PASSWORD` | Advanced |
| `--plugin-linea-liveness-gas-limit` | Gas limit for transactions | `100000` | `LONG` | Advanced |
| `--plugin-linea-liveness-gas-price` | Gas price in Wei for transactions. | `7` | `LONG` | Advanced |

### Sequencer — Profitability

Config-file key: `profitability-config`

| Option | Description | Default | Type | Visibility |
| --- | --- | --- | --- | --- |
| `--plugin-linea-fixed-gas-cost-wei` | Fixed gas cost in Wei | `0` | `INTEGER` | Advanced |
| `--plugin-linea-variable-gas-cost-wei` | Variable gas cost in Wei | `10000000000` | `INTEGER` | Advanced |
| `--plugin-linea-min-margin` | Minimum margin of a transaction to be selected | `1` | `FLOAT` | Advanced |
| `--plugin-linea-estimate-gas-min-margin` | Recommend a specific gas price when using linea_estimateGas | `1` | `FLOAT` | Advanced |
| `--plugin-linea-tx-pool-min-margin` | The min margin an incoming tx must have to be accepted in the txpool | `0.5` | `FLOAT` | Advanced |
| `--plugin-linea-tx-pool-profitability-check-api-enabled` | Enable the profitability check for txs received via API? | `true` | `BOOLEAN` | Advanced |
| `--plugin-linea-tx-pool-profitability-check-p2p-enabled` | Enable the profitability check for txs received via p2p? | `false` | `BOOLEAN` | Advanced |
| `--plugin-linea-extra-data-pricing-enabled` | Enable setting pricing parameters via extra data field | `false` | `BOOLEAN` | Advanced |
| `--plugin-linea-extra-data-set-min-gas-price-enabled` | Enable setting min gas price runtime value via extra data field | `true` | `BOOLEAN` | Advanced |
| `--plugin-linea-profitability-metrics-buckets` | List of buckets to use to create the histogram for ratio between the effective priority fee and the calculate profitable priority of the tx | `[0.1, 0.3, 0.5, 0.7, 0.9, 1.0, 1.1, 1.2, 1.5, 2.0, 5.0, 10.0]` | `FLOAT[]` | Advanced |
| `--plugin-linea-compressed-tx-cache-size` | Size of the compressed transaction cache | `10000` | `INTEGER` | Advanced |

### Sequencer — Rejected Tx reporting

Config-file key: `rejected-tx-reporting-config`

| Option | Description | Default | Type | Visibility |
| --- | --- | --- | --- | --- |
| `--plugin-linea-rejected-tx-endpoint` | Endpoint URI for reporting rejected transactions. Specify a valid URI to enable reporting. | — | `URL` | Advanced |
| `--plugin-linea-node-type` | Linea Node type to use when reporting rejected transactions. (Valid values: SEQUENCER, RPC, P2P) | — | `NODE_TYPE` | Advanced |

### Sequencer — RPC

Config-file key: `rpc-config-sequencer`

| Option | Description | Default | Type | Visibility |
| --- | --- | --- | --- | --- |
| `--plugin-linea-estimate-gas-compatibility-mode-enabled` | Set to true to return the min mineable gas price \* multiplier, instead of the profitable price | `false` | `BOOLEAN` | Standard |
| `--plugin-linea-estimate-gas-compatibility-mode-multiplier` | Set to multiplier to apply to the min priority fee per gas when the compatibility mode is enabled | `1.2` | `FLOAT` | Standard |

### Sequencer — Tracer

Config-file key: `tracer-sequencer-config`

| Option | Description | Default | Type | Visibility |
| --- | --- | --- | --- | --- |
| `--plugin-linea-module-limit-file-path` | Path to the toml file containing the module limits | `moduleLimitFile.toml` | `STRING` | Advanced |

### Sequencer — Transaction pool validator

Config-file key: `transaction-pool-validator-config`

| Option | Description | Default | Type | Visibility |
| --- | --- | --- | --- | --- |
| `--plugin-linea-deny-list-path` | Path to the file containing the deny list | `lineaDenyList.txt` | `STRING` | Advanced |
| `--plugin-linea-bundle-overriding-deny-list-path` | Path to the file containing the deny list for bundles. | — | `STRING` | Advanced |
| `--plugin-linea-max-tx-gas-limit` | Maximum gas limit for a transaction | `30000000` | `INT` | Advanced |
| `--plugin-linea-max-tx-calldata-size` | Maximum size for the calldata of a Transaction. If set, the calldata validator is enabled. | — | `INTEGER` | Advanced |
| `--plugin-linea-tx-pool-simulation-check-api-enabled` | Enable the simulation check for txs received via API? | `false` | `BOOLEAN` | Advanced |
| `--plugin-linea-tx-pool-simulation-check-p2p-enabled` | Enable the simulation check for txs received via p2p? | `false` | `BOOLEAN` | Advanced |

### Sequencer — Transaction selector

Config-file key: `transaction-selector-config`

| Option | Description | Default | Type | Visibility |
| --- | --- | --- | --- | --- |
| `--plugin-linea-max-block-calldata-size` | Maximum size for the calldata of a block. If set, the raw calldata size selector is enabled. | — | `INTEGER` | Advanced |
| `--plugin-linea-blob-size-limit` | Maximum compressed block size in bytes (block must fit in blob when compressed). If set, the compression-aware selector is enabled. | — | `INTEGER` | Advanced |
| `--plugin-linea-compressed-block-header-overhead` | Estimated compressed block header overhead in bytes. Subtracted from blobSizeLimit during the fast-path compression check to account for block header data that is not included in per-tx compression estimates | `1024` | `INTEGER` | Advanced |
| `--plugin-linea-over-line-count-limit-cache-size` | Max number of transactions that go over the line count limit we keep track of | `10000` | `INTEGER` | Advanced |
| `--plugin-linea-max-block-gas` | Sets max gas per block | `30000000` | `LONG` | Advanced |
| `--plugin-linea-max-bundle-pool-size-bytes` | Sets max memory size, in bytes, that the bundle txpool can occupy | `16777216` | `LONG` | Advanced |
| `--plugin-linea-max-bundle-block-gas` | Sets max amount of block gas bundle transactions can use | `15000000` | `LONG` | Advanced |
| `--plugin-linea-events-deny-list-path` | Path to the file containing the events deny list | — | `STRING` | Advanced |
| `--plugin-linea-events-bundle-deny-list-path` | Path to the file containing the events deny list for bundles | — | `STRING` | Advanced |
| `--plugin-linea-blob-compressor-version-timestamps` | Comma-separated map of BlobCompressorVersion to Instant, e.g. V2=2025-01-01T00:00:00Z,V3=2026-01-01T00:00:00Z .Available versions: V2, V3, V4 . | `V3=-100001-12-31T23:59:59.999999999Z` | `MAP` | Advanced |

### Sequencer — Transaction validator

Config-file key: `transaction-validator-config`

| Option | Description | Default | Type | Visibility |
| --- | --- | --- | --- | --- |
| `--plugin-linea-blob-tx-enabled` | Enable blob transactions? | `false` | `BOOLEAN` | Advanced |
| `--plugin-linea-delegate-code-tx-enabled` | Enable EIP7702 delegate code transactions? | `true` | `BOOLEAN` | Advanced |

## Tracer

### Tracer — L1 L2 bridge shared

Config-file key: `l1-l2-bridge-shared-config`

| Option | Description | Default | Type | Visibility |
| --- | --- | --- | --- | --- |
| `--plugin-linea-l1l2-bridge-contract` | The address of the L1 L2 bridge contract | `0x0000000000000000000000000000000000000000` | `ADDRESS` | Standard |
| `--plugin-linea-l1l2-bridge-topic` | The log topic of the L1 L2 bridge | `0x0000000000000000000000000000000000000000000000000000000000000000` | `BYTES_32` | Standard |

### Tracer — Tracer shared

Config-file key: `tracer-shared-config`

| Option | Description | Default | Type | Visibility |
| --- | --- | --- | --- | --- |
| `--plugin-linea-limitless-enabled` | If the sequencer needs to use or not the limitless prover | `false` | `BOOLEAN` | Advanced |
| `--plugin-linea-count-historical-blockhash-enabled` | If the sequencer/coordinator needs to count the lines from historical blockhashes | `false` | `BOOLEAN` | Advanced |

### Tracer — RPC

Config-file key: `rpc-config`

| Option | Description | Default | Type | Visibility |
| --- | --- | --- | --- | --- |
| `--plugin-linea-rpc-concurrent-requests-limit` | Number of allowed concurrent requests | `1` | `REQUEST_COUNT_LIMIT` | Advanced |

### Tracer — Tracer readiness

Config-file key: `tracer-readiness`

| Option | Description | Default | Type | Visibility |
| --- | --- | --- | --- | --- |
| `--plugin-linea-tracer-readiness-server-port` | HTTP server port for tracer readiness plugin | `8548` | `SERVER_PORT` | Advanced |
| `--plugin-linea-tracer-readiness-server-host` | HTTP server host for tracer readiness plugin | `0.0.0.0` | `SERVER_HOST` | Advanced |
| `--plugin-linea-tracer-readiness-max-blocks-behind` | Maximum number of block behind the head of the chain to treat negligible in state sync | `0` | `BLOCK_COUNT` | Advanced |

### Tracer — Traces endpoint

Config-file key: `traces-endpoint-config`

| Option | Description | Default | Type | Visibility |
| --- | --- | --- | --- | --- |
| `--plugin-linea-conflated-trace-generation-traces-output-path` | Path to where traces will be written | — | `PATH` | Advanced |
| `--plugin-linea-rpc-caching` | Reuse existing trace files when available | `true` | `CACHING` | Advanced |
| `--plugin-linea-conflated-trace-generation-trace-compression` | Specify whether or not to employ trace compression | `true` | `BOOL` | Advanced |
| `--plugin-linea-conflated-trace-generation-trace-file-version` | Specify major version of trace file format to use (e.g. v1 or v2) | `2` | `INT` | Advanced |

## State recovery

_No plugin-specific CLI options were found in this plugin._