Parameters
An array of transaction signatures to confirm, as base-58 encoded strings
Response
The slot this request was processed in
The slot the transaction was processed
Number of blocks since signature confirmation, null if rooted or not found
Error if transaction failed, null if transaction succeeded
The transaction’s cluster confirmation status; either “processed”, “confirmed”, or “finalized”
Code Examples
Basic Request
curl http://rpc.orbitflare.com -X POST -H "Content-Type: application/json" -d '{
"jsonrpc": "2.0",
"id": 1,
"method": "getSignatureStatuses",
"params": [
[
"5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW",
"5j7s6NiJS3JAkvgkoc18WVAsiSaci2pxB2A6ueCJP4tprA2TFg9wSyTLeYouxPBJEMzJinENTkpA52YStRW5Dia7"
]
]
}'
Using web3.js
import { Connection } from '@solana/web3.js';
const connection = new Connection('http://rpc.orbitflare.com');
const signatures = [
'5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW',
'5j7s6NiJS3JAkvgkoc18WVAsiSaci2pxB2A6ueCJP4tprA2TFg9wSyTLeYouxPBJEMzJinENTkpA52YStRW5Dia7'
];
const statuses = await connection.getSignatureStatuses(signatures);
console.log(statuses);
Using Python
from solana.rpc.api import Client
client = Client("http://rpc.orbitflare.com")
signatures = [
"5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW",
"5j7s6NiJS3JAkvgkoc18WVAsiSaci2pxB2A6ueCJP4tprA2TFg9wSyTLeYouxPBJEMzJinENTkpA52YStRW5Dia7"
]
response = client.get_signature_statuses(signatures)
print(response)
Notes
- Returns the statuses of a list of transaction signatures
- By default, only searches recent status cache (last ~5 minutes of transactions)
- Setting searchTransactionHistory to true will search further back in the ledger
- null values in the response array indicate signatures that could not be found
- confirmationStatus indicates how finalized a transaction is on the network
Best Practices
- Use this method to check the status of recently submitted transactions
- Pass multiple signatures in a single request to reduce network overhead
- Set searchTransactionHistory to true only when needed (performance impact)
- Handle null values in the response array appropriately
- Check confirmationStatus to determine transaction finality level