Skip to main content

linea_getTransactionExclusionStatusV1

Checks if a transaction was rejected for exceeding data line limits, preventing the prover from generating a proof to be included in a block.

warning

You can only check for rejected transactions within seven days of the transaction attempt. Querying transactions older than this returns a null response.

If the transaction is rejected, the API call succeeds and provides the reason; otherwise, it returns null as the result.

Parameters​

transaction hash: [Required] A string representing the hash (32 bytes) of a transaction.

Returns​

  • txHash: The hash of the transaction.
  • from: The address of the sender.
  • nonce: Number of transactions made by the sender.
  • txRejectionStage: The point at which the transaction was rejected. One of:
    • SEQUENCER: Rejected by the sequencer.
    • RPC: Rejected by an RPC node.
    • P2P: Rejected by a P2P-connected node.
  • reasonMessage: The reason 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 ISO 8601 format.

Example​

Replace YOUR-API-KEY with an API key from your Infura dashboard.

Request​

curl https://linea-mainnet.infura.io/v3/<YOUR-API-KEY> \
  -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"
  }
}

If the transaction was not rejected for exceeding line limits, or is older than seven days, it will not be found in the database, and a null result is returned. For example:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": null
}
Last updated on