getSignatureStatuses RPC Method

Returns the current status for each supplied transaction signature. Each signature must be a txid, the first signature of a transaction.

Source

get_signature_statuses

Unless the searchTransactionHistory configuration parameter is included, this method only searches the recent status cache of signatures, which retains statuses for all active slots plus MAX_RECENT_BLOCKHASHES rooted slots.

params

arrayrequired

An array of transaction signatures to confirm, as base-58 encoded strings (up to a maximum of 256)

objectoptional

Configuration object containing the following fields:

result

object

RpcResponse object containing:

$ curl https://api.devnet.solana.com -s -X \
>   POST -H "Content-Type: application/json" -d ' 
>   {
>     "jsonrpc": "2.0",
>     "id": 1,
>     "method": "getSignatureStatuses",
>     "params": [
>       [
>         "4cdd1oX7cfVALfr26tP52BZ6cSzrgnNGtYD7BFhm6FFeZV5sPTnRvg6NRn8yC6DbEikXcrNChBM5vVJnTgKhGhVu"
>       ],
>       {
>         "searchTransactionHistory": true
>       }
>     ]
>   }
> '

Response

{
  "jsonrpc": "2.0",
  "result": {
    "context": { "apiVersion": "3.1.8", "slot": 82 },
    "value": [
      {
        "slot": 48,
        "confirmations": null,
        "err": null,
        "status": {
          "Ok": null
        },
        "confirmationStatus": "finalized"
      },
      null
    ]
  },
  "id": 1
}

$ curl https://api.devnet.solana.com -s -X \
>   POST -H "Content-Type: application/json" -d ' 
>   {
>     "jsonrpc": "2.0",
>     "id": 1,
>     "method": "getSignatureStatuses",
>     "params": [
>       [
>         "4cdd1oX7cfVALfr26tP52BZ6cSzrgnNGtYD7BFhm6FFeZV5sPTnRvg6NRn8yC6DbEikXcrNChBM5vVJnTgKhGhVu"
>       ],
>       {
>         "searchTransactionHistory": true
>       }
>     ]
>   }
> '