Skip to main content

linea_getTransactionExclusionStatusV1

Queries a database maintained by the sequencer to check if a transaction was rejected because it exceeded data line limits that would prevent the prover from generating a proof for the block.

If the transaction was rejected, the API call will be successful and provide the reason.

Transactions that were not rejected for this reason will return a Rejected transaction not available error.

warning

Transactions older than 24 hours cannot be checked.

Parameters​

txHash: [Required] The hash of the subject transaction.

Returns​

  • txHash: The hash of the subject transaction.
  • from: The public address of the account that sent the transaction.
  • nonce: The transaction nonce, hexadecimal.
  • txRejectionStage: A string detailing the point at which the transaction was rejected. One of:
    • SEQUENCER: Rejected by the sequencer.
    • RPC: Rejected by an RPC node (e.g. https://rpc.linea.build).
    • P2P: Rejected by a P2P-connected node (e.g. an edge node).
  • reasonMessage: Explains why the transaction was rejected.
  • blockNumber: The block that the transaction was rejected from, in hexadecimal format. Only returned for transactions rejected by the sequencer.
  • timestamp: Time of rejection, in ISO8601 format.

Example​

Request​

curl https://rpc.linea.build \
-X POST
-H "Content-Type: application/json" \
-d '{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "linea_getTransactionExclusionStatusV1",
    "params": ["0x526e56101cf39c1e717cef9cedf6fdddb42684711abda35bae51136dbb350ad7"],
}'

Response​

{
    "jsonrpc": "2.0",
    "id": "1",
    "result": {
        "txHash": "0x526e56101cf39c1e717cef9cedf6fdddb42684711abda35bae51136dbb350ad7",
        "from": "0x4d144d7b9c96b26361d6ac74dd1d8267edca4fc2",
        "nonce": "0x64",
        "txRejectionStage": "SEQUENCER",
        "reasonMessage": "Transaction line count for module ADD=402 is above the limit 70",
        "blockNumber": "0x3039",
        "timestamp": "2024-08-22T09:18:51Z"
    }
}