So verwendest du getSignatureStatuses

​

Häufige Anwendungsfälle

• Finalität einer Transaktion bestätigen: Prüfe, ob eine übermittelte Transaktion die gewünschte Bestätigungsstufe erreicht hat, z. B. confirmed oder finalized.
• Status mehrerer Transaktionen abrufen: Prüfe effizient den Status mehrerer Transaktionen gleichzeitig, beispielsweise nach einem Batch-Versand.
• UI anhand des Transaktionsstatus aktualisieren: Zeige Nutzern den Echtzeitstatus einer Transaktion an.
• Fehlerprüfung: Ermittle, ob Transaktionen aus einer Liste fehlgeschlagen sind und warum.

​

Parameter für den request

1. signatures (array aus string): (Erforderlich) Ein Array mit Base58-codierten Transaktionssignaturen. Du kannst mit einem einzelnen request bis zu 256 Signaturen abfragen.
2. options (object, optional): Ein optionales Konfigurationsobjekt mit dem folgenden Feld:
   • searchTransactionHistory (boolean, optional): Bei true durchsucht der RPC node seinen vollständigen Transaktionsverlauf nach den Signaturen. Bei false (Standardwert) durchsucht er nur einen Cache mit aktuellen Statusinformationen. Setze diesen Wert bei alten oder möglicherweise verworfenen Transaktionen auf true.

​

Struktur der response

• context (object): Ein Objekt mit folgendem Inhalt:
  • slot (u64): Der slot, in dem der RPC node diesen request verarbeitet hat.
• value (array aus object | null): Ein Array mit Statusobjekten. Ihre Reihenfolge entspricht der Reihenfolge der Signaturen im request. Jedes Element kann Folgendes sein:
  • Ein Objekt mit den folgenden Feldern, wenn die Signatur gefunden wurde:
    • slot (u64): Der slot, in dem die Transaktion verarbeitet wurde.
    • confirmations (number | null): Die Anzahl der Blöcke, die seit der Verarbeitung der Transaktion bestätigt wurden. Bei einer finalisierten Transaktion lautet der Wert null. Die Finalität bedeutet, dass die Transaktion nicht zurückgesetzt wird. Daher ist eine bestimmte Anzahl von Bestätigungen weniger relevant.
    • err (object | null): Ein Fehlerobjekt, wenn die Transaktion fehlgeschlagen ist, z. B. {"InstructionError":[0,{"Custom":1}]}. Bei einer erfolgreichen Transaktion lautet der Wert null.
    • status (object): Ein Objekt, das den Ausführungsstatus der Transaktion angibt. Bei erfolgreichen Transaktionen lautet der Wert normalerweise {"Ok":null}. Bei fehlgeschlagenen Transaktionen enthält das Objekt Details zum Fehler.
    • confirmationStatus (string | null): Der Bestätigungsstatus der Transaktion im cluster, z. B. processed, confirmed oder finalized. Der Wert kann null sein, wenn der Status nicht im Cache verfügbar ist und searchTransactionHistory auf false gesetzt ist.
  • null: Wenn eine Signatur nicht im Status-Cache gefunden wurde und searchTransactionHistory auf false gesetzt ist. Das gilt auch, wenn die Signatur selbst bei einer Verlaufssuche tatsächlich nicht existiert.

​

Beispiele

​

1. Status einer Liste von Signaturen abrufen (aktueller Cache)

# Replace <api-key> with your Helius API key
# Replace with actual transaction signatures
curl https://mainnet.helius-rpc.com/?api-key=<api-key> -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getSignatureStatuses",
    "params": [
      [
        "5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW",
        "2x5YfV29N4p9K2kEFK2gFfC5T5acbs2z2MytTZqrgq17pYjCMfYjW4sAUpkWMkMzxGztD2Qv5v7n92uYJcQY9c7a" 
      ]
    ]
  }'

// Replace <api-key> with your Helius API key
const { Connection } = require('@solana/web3.js');

async function checkRecentSignatures() {
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
  const signatures = [
    '5VERv8NMvzbJMEkV8xnrLkEaWRtSz9CosKDYjCJjBRnbJLgp8uirBgmQpjKhoR4tjF3ZpRzrFmBV6UjKdiSZkQUW',
    '2x5YfV29N4p9K2kEFK2gFfC5T5acbs2z2MytTZqrgq17pYjCMfYjW4sAUpkWMkMzxGztD2Qv5v7n92uYJcQY9c7a' // Replace with another signature
  ];

  try {
    const response = await connection.getSignatureStatuses(signatures);
    console.log("RPC Response Context Slot:", response.context.slot);
    response.value.forEach((status, index) => {
      console.log(`--- Status for Signature ${index + 1} (${signatures[index].substring(0,10)}...) ---`);
      if (status) {
        console.log(`  Slot: ${status.slot}`);
        console.log(`  Confirmations: ${status.confirmations === null ? 'Finalized (or N/A)' : status.confirmations}`);
        console.log(`  Error: ${JSON.stringify(status.err)}`);
        console.log(`  Execution Status: ${JSON.stringify(status.status)}`);
        console.log(`  Confirmation Status: ${status.confirmationStatus}`);
      } else {
        console.log('  Status not found (likely not in recent cache or does not exist).');
      }
    });
  } catch (error) {
    console.error('Error fetching signature statuses:', error);
  }
}

checkRecentSignatures();

​

2. Status mit Suche im Transaktionsverlauf abrufen

# Replace <api-key> with your Helius API key
# Replace with actual transaction signatures
curl https://mainnet.helius-rpc.com/?api-key=<api-key> -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getSignatureStatuses",
    "params": [
      [
        "3jPTfHcbzWHeD4jW8q4Y8g3h2D1aBwM81y1sHhDqYQ7Z9x5n7cVy2gD8QWbK9eXwSjJ6aA7FzV2kLpQoEwU9jX", 
        "4SyzjM2fTALqTNjLKMM1yG1bW7kCFu2GvEkKcvKChG9o1KjQW8jLdZ6sWfN9mP1pU3rD7XvA6B2CjHkLwRzYxTnX"  
      ],
      {
        "searchTransactionHistory": true
      }
    ]
  }'

// Replace <api-key> with your Helius API key
const { Connection } = require('@solana/web3.js');

async function checkSignaturesWithHistory() {
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
  const signatures = [
    // Replace with a signature you know is older or might have been dropped
    '3jPTfHcbzWHeD4jW8q4Y8g3h2D1aBwM81y1sHhDqYQ7Z9x5n7cVy2gD8QWbK9eXwSjJ6aA7FzV2kLpQoEwU9jX',
    // Replace with another valid signature
    '4SyzjM2fTALqTNjLKMM1yG1bW7kCFu2GvEkKcvKChG9o1KjQW8jLdZ6sWfN9mP1pU3rD7XvA6B2CjHkLwRzYxTnX' 
  ];

  try {
    const response = await connection.getSignatureStatuses(signatures, { searchTransactionHistory: true });
    console.log("RPC Response Context Slot:", response.context.slot);
    response.value.forEach((status, index) => {
      console.log(`--- Status for Signature ${index + 1} (${signatures[index].substring(0,10)}...) ---`);
      if (status) {
        console.log(`  Slot: ${status.slot}`);
        console.log(`  Confirmations: ${status.confirmations === null ? 'Finalized (or N/A)' : status.confirmations}`);
        console.log(`  Error: ${JSON.stringify(status.err)}`);
        console.log(`  Execution Status: ${JSON.stringify(status.status)}`);
        console.log(`  Confirmation Status: ${status.confirmationStatus}`);
      } else {
        console.log('  Status not found (even with history search, it might not exist or is too old).');
      }
    });
  } catch (error) {
    console.error('Error fetching signature statuses with history:', error);
  }
}

checkSignaturesWithHistory();

​

Tipps für Entwickler

• searchTransactionHistory: Entscheidend für die Zuverlässigkeit. Bei false (Standardwert) prüft die Methode nur einen begrenzten Cache mit aktuellen Statusinformationen. Wenn eine Transaktion alt ist oder möglicherweise verworfen wurde und nicht in diesem Cache enthalten ist, gibt die Methode für den Status dieser Signatur null zurück. Setze den Wert immer auf true, wenn du den Status von Transaktionen prüfen musst, die möglicherweise nicht mehr aktuell sind.
• Signaturlimit: Du kannst pro Aufruf maximal 256 Signaturen abfragen.
• Status null: Ein null im Array value bedeutet, dass der Status der betreffenden Signatur nicht gefunden wurde. Die Signatur befindet sich möglicherweise nicht im aktuellen Cache, wenn searchTransactionHistory auf false gesetzt ist. Möglicherweise wurde die Transaktion nie aufgenommen oder sie ist selbst für den Verlauf des node mit searchTransactionHistory: true zu alt.
• confirmations: null: Dies bedeutet normalerweise, dass die Transaktion den Status finalized erreicht hat. Ab diesem Punkt ist eine bestimmte Anzahl von Bestätigungen weniger relevant, da der Block als unumkehrbar gilt.
• Fehlerbehandlung: Prüfe das Feld err in jedem Statusobjekt, um festzustellen, ob eine Transaktion fehlgeschlagen ist. Das Feld status enthält ebenfalls Details, z. B. {"Err":...}.