gen_getTransactionStatus

Returns the transaction's current materialized consensus status. This is the lightweight polling surface: it does not project deadlines or turn protocol actions into synthetic statuses.

Method: gen_getTransactionStatus

Parameters:

• request (object, required):
  • txId (string, required): The transaction hash (hex-encoded with 0x prefix)

Returns: Object with status string and numeric code

Response Fields:

Status Codes:

Example Request:

{
  "jsonrpc": "2.0",
  "method": "gen_getTransactionStatus",
  "params": [
    {
      "txId": "0x563f046c187d711127c51213ca62e2e4fee52009a98f0989a73a0a0382d21890"
    }
  ],
  "id": 1
}

Example Response:

{
  "jsonrpc": "2.0",
  "result": {
    "status": "Finalized",
    "statusCode": 7
  },
  "id": 1
}

Notes:

• This endpoint reads the stored status directly. A deadline passing does not change this response until the corresponding protocol transition is materialized.
• Use this for polling — it's cheaper than gen_getTransactionReceipt which returns the full receipt
• Finalize is an action, not a status. Explorers and operator tooling that need projected state or recovery actions should use gen_getTransactionLifecycle.