Skip to main content

getSignatureStatuses RPC Method

Returns the statuses of a list of signatures. Each signature must be a txid, the first signature of a transaction.

params​

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

object optional Configuration object containing the following fields:

searchTransactionHistory

if true - a Openverse node will search its ledger cache for any signatures not found in the recent status cache

result​

array An array of RpcResponse <object> consisting of either null or an object containing the following fields:

slot

The slot the transaction was processed

confirmations

Number of blocks since signature confirmation, null if rooted, as well as finalized by a supermajority of the cluster

err

Error if transaction failed, null if transaction succeeded. See TransactionError definitions for more info.

err

Error if transaction failed, null if transaction succeeded. See TransactionError definitions

confirmationStatus

The transaction's cluster confirmation status; Either processed, confirmed, or finalized. See Commitment for more on optimistic confirmation.

status

DEPRECATED Transaction status

  • "Ok": <null> - Transaction was successful
  • "Err": <ERR> - Transaction failed with TransactionError

cURL

curl https://us-seattle.openverse.network/api -s -X \
 POST -H "Content-Type: application/json" -d ' 
 {
   "jsonrpc": "2.0",
   "id": 1,
   "method": "getSignatureStatuses",
   "params": [
     [
       "5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW"
     ],
     {
       "searchTransactionHistory": true
     }
   ]
 }
'

Response

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