Skip to main content

Common error messages

This page indexes error and log messages emitted by Arbitrum chain infrastructure. Find your message below and follow the link for the cause and resolution.

Messages are grouped by the component that emits them. If you do not know which component produced a message, use your browser's find-in-page to search for a distinctive fragment of it.

This page is an index, not a guide

Each entry links to the guide that explains the message in full. This page deliberately carries no resolution steps of its own, so that it cannot fall out of step with those guides.

Log levels in the linked guides are worth reading closely. Many batch poster messages are logged quietly at first and escalate to WARN or ERROR only if they persist. A single WARN is usually noise; a sustained one that reaches ERROR is the real signal. To learn how that escalation works, see The escalation rule to remember.

Batch poster

Mempool and balance

MessageLikely causeWhere to look
Posting this transaction will exceed max mempool sizeParent chain mempool at capacity, or fees too low for inclusionMempool errors
ErrExceedsMaxMempoolSize / error posting batchIn-flight transaction window full; parent chain confirming slowlyMempool errors
lack of L1 balance prevents posting transaction with desired fee capParent chain wallet cannot cover the target max costMempool errors
a large batch posting backlog existsPosting is not keeping up with sequencingBacklog diagnosis
error fetching batch poster wallet balanceParent chain RPC hiccup; monitoring gap onlyMempool errors

Retries, nonces, and sync

MessageLikely causeWhere to look
Failed to re-send transactionNonce already consumed, stale storage, or underpriced replacementRetry errors
failed to update nonce with queue empty; falling back to using a recent blockFinality data unavailable; safe because the queue is emptyNonce and sync
Failed to get current nonceParent chain RPC; non-fatal, a previous nonce existsNonce and sync
Failed to get latest nonceTransient RPC; the iteration backs offNonce and sync
failed to update tx poster balance / failed to update tx poster noncePeriodic state refresh failed; loop backs offNonce and sync
DataPoster failed to send transactionMempool rejection or RPC issue; transaction stays queuedNonce and sync
failed to replace-by-fee transactionPer-nonce RBF error that escalates if it persistsNonce and sync
DataPoster is avoiding creating a mempool nonce gapDeliberate reorg safety; transaction is retriedParent chain bounds

Reverts and halting

MessageLikely causeWhere to look
Transaction from batch poster revertedContract rejected the batch; halts posting on persistent storageReverts and halting
Large gap between last seen and current block number, skipping check for revertsNode lag; reverts in the skipped window go undetectedReverts and halting
Error checking batch revertsRevert check failed; benign when it contains not foundReverts and halting

Fees and pricing

MessageLikely causeWhere to look
can't meet data poster fee cap obligations with current target max costParent chain fees spiked above the escalation targetFees and pricing
submitting transaction with GasFeeCap less than latest basefeePosting with a cap below current fees, expecting fees to fallFees and pricing
unable to fetch suggestedTipCap from l1 clientMetric gap only, not a posting failureFees and pricing

Parent chain bounds and reorg

MessageLikely causeWhere to look
Disabling batch posting due to batch being within reorg resistance marginExpected safety guard near the lower parent chain boundParent chain bounds
disabling L1 bound as batch posting message is close to the maximum delayBound overridden to avoid stalling near max-delayParent chain bounds
not posting more messages because block number or timestamp exceed L1 boundsNormal bounding behaviorParent chain bounds
error getting max time variation on L1 bound block; falling back on latest blockParent chain node could not serve state at the bound blockParent chain bounds
unknown L1 block bound config value; falling back on using finalizedInvalid l1-block-bound config valueParent chain bounds

Data availability

MessageLikely causeWhere to look
DA writer failed, operator action requiredNon-fallback DA writer error; posting stopsData availability fallback
DA writer explicitly requested fallbackDA backend requested fallback; check provider healthData availability fallback

Coordination, gas estimation, and startup

MessageLikely causeWhere to look
Error checking if we could acquire redis lockRedis connectivity; the poster tries anywayLock and coordination
Not posting batches right now because another batch poster has the lock or this node is behindNormal on backup postersLock and coordination
Failed to estimate gas for EIP-7623 checkCalldata-cost probe failed; relevant only on EIP-7623 parent chainsLock and coordination
error estimating gas for batchParent chain state lag or inbox not caught upLock and coordination
max-size is deprecated; use max-calldata-batch-sizeDeprecated flag in useConfig and startup
Disabling data poster storage, as parent chain appears to be an Arbitrum chain without a mempoolExpected when your parent chain is an Arbitrum chainConfig and startup
messagesPerBatch is somehow zeroDefensive guard; benign unless recurringConfig and startup

Validator

MessageLikely causeWhere to look
error initializing staker: could not create assertion chain: no contract code at given addressReading at finalized before the Rollup deployment finalized, or a stale rollup.rollupParent chain read consistency
ASSERTION_NOT_EXISTUnsynced node, inconsistent parent chain RPC, or reorg exposureAssertion errors
found incorrect assertion in watchtower modeLocal state disagrees with an onchain assertionAssertion errors

Messages not listed here

This index covers Arbitrum chain infrastructure that you operate. For errors from other areas, start with the guide for that area: