So verwendest du getVoteAccounts

​

Häufige Anwendungsfälle

• Validator-Monitoring: Verfolge den Status, den Stake und die Leistung von Validatoren im Netzwerk.
• Staking-Dashboards: Zeige Informationen zu verfügbaren Validatoren für Benutzer an, die ihre SOL delegieren möchten.
• Analyse des Netzwerkzustands: Beurteile den allgemeinen Zustand und die Dezentralisierung des Netzwerks, indem du die Verteilung des Stake und die Aktivität der Validatoren untersuchst.
• Inaktive Validatoren identifizieren: Finde Validatoren, die nicht aktiv am Konsens teilnehmen.

​

Request-Parameter

1. commitment (string, optional): Gibt das commitment-Level für die Abfrage an (z. B. "finalized", "confirmed", "processed"). Wenn du es weglässt, wird das standardmäßige commitment des node verwendet.
2. votePubkey (string, optional): Wenn du diesen Wert angibst, werden die Ergebnisse so gefiltert, dass sie nur die angegebene Vote-Account-Adresse des Validators enthalten (Base58-codiert).
3. keepUnstakedDelinquents (boolean, optional): Der Standardwert ist false. Wenn du den Wert auf true setzt, enthält die Liste delinquent auch Validatoren ohne aktivierten Stake. Andernfalls werden sie herausgefiltert.
4. delinquentSlotDistance (u64, optional): Gibt an, wie viele slots ein Validator hinter der Spitze des Ledgers liegen muss, um als inaktiv zu gelten. Wenn du keinen Wert angibst, verwendet der node einen Standardwert.

​

Response-Struktur

• current: Ein Array von Objekten. Jedes Objekt repräsentiert einen aktiven Vote-Account mit den folgenden Feldern:
  • votePubkey (string): Die Adresse des Vote-Accounts (Base58-codiert).
  • nodePubkey (string): Der öffentliche Identitätsschlüssel des Validator-node (Base58-codiert).
  • activatedStake (u64): Die Menge an Stake in Lamports, die an diesen Vote-Account delegiert wurde und in der aktuellen Epoche aktiv ist.
  • epochVoteAccount (boolean): true, wenn der Vote-Account während der aktuellen Epoche mindestens einmal aktiv war.
  • commission (number): Der vom Validator berechnete Provisionssatz in Prozent (0–100).
  • lastVote (u64): Die Nummer des neuesten slot, für den dieser Validator abgestimmt hat.
  • rootSlot (u64): Der letzte slot, den der node als Root betrachtet hat (ein vollständig bestätigter Block, der nicht zurückgesetzt wird).
  • epochCredits (array): Ein Array aus Arrays, wobei jedes innere Array [epoch, credits_earned_in_epoch, previous_total_credits] enthält.
• delinquent: Ein Array von Objekten mit derselben Struktur wie current. Es repräsentiert Validatoren, die der node als inaktiv einstuft.

{
  "jsonrpc": "2.0",
  "result": {
    "current": [
      {
        "commission": 10,
        "epochCredits": [[300, 12345, 567890]],
        "epochVoteAccount": true,
        "lastVote": 180000500,
        "nodePubkey": "NodePubkeyExample123...",
        "rootSlot": 180000450,
        "activatedStake": "50000000000000", // lamports
        "votePubkey": "VoteAccountPubkeyExample123..."
      }
      // ... more current validators
    ],
    "delinquent": [
      // ... delinquent validators, if any
    ]
  },
  "id": 1
}

​

Codebeispiele

# Get all current and delinquent vote accounts:
curl -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getVoteAccounts"
  }' \
  <YOUR_RPC_URL>

# Get a specific vote account:
curl -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getVoteAccounts",
    "params": [
      {
        "votePubkey": "<SPECIFIC_VOTE_ACCOUNT_PUBKEY>"
      }
    ]
  }' \
  <YOUR_RPC_URL>

# Get vote accounts with "confirmed" commitment and keep unstaked delinquents:
curl -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getVoteAccounts",
    "params": [
      {
        "commitment": "confirmed",
        "keepUnstakedDelinquents": true
      }
    ]
  }' \
  <YOUR_RPC_URL>

const { Connection } = require('@solana/web3.js');

async function fetchVoteAccounts() {
  // Replace with your RPC endpoint
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');

  try {
    // Get all vote accounts
    const voteAccounts = await connection.getVoteAccounts();
    console.log(`Found ${voteAccounts.current.length} current validators.`);
    console.log(`Found ${voteAccounts.delinquent.length} delinquent validators.`);

    if (voteAccounts.current.length > 0) {
      console.log("\nFirst current validator details:");
      console.log(`  Vote Pubkey: ${voteAccounts.current[0].votePubkey}`);
      console.log(`  Node Pubkey: ${voteAccounts.current[0].nodePubkey}`);
      console.log(`  Activated Stake: ${voteAccounts.current[0].activatedStake} lamports`);
      console.log(`  Commission: ${voteAccounts.current[0].commission}%`);
      console.log(`  Last Vote: ${voteAccounts.current[0].lastVote}`);
      // console.log(JSON.stringify(voteAccounts.current[0], null, 2)); // For full details
    }

    // Get a specific vote account (replace with an actual vote account public key)
    // const specificVotePubkey = 'SPECIFIC_VOTE_ACCOUNT_PUBKEY';
    // const specificValidator = await connection.getVoteAccounts('confirmed', specificVotePubkey);
    // console.log(`\nDetails for ${specificVotePubkey}:`, JSON.stringify(specificValidator, null, 2));

  } catch (error) {
    console.error('Error fetching vote accounts:', error);
  }
}

fetchVoteAccounts();

​

Tipps für Entwickler

• Große Response: Diese Methode kann große Datenmengen zurückgeben, besonders in Netzwerken mit vielen Validatoren wie Mainnet Beta. Achte auf die Größe der response und die Verarbeitungszeit.
• Definition von „inaktiv“: Ob ein Validator als „inaktiv“ gilt, kann von delinquentSlotDistance und der Perspektive des node abhängen. Ein Validator kann auf einem node als inaktiv erscheinen, auf einem anderen jedoch nicht, wenn deren Sicht auf die Spitze des Ledgers unterschiedlich ist.
• Stake-Aktivierung: activatedStake zeigt den Stake an, der in der aktuellen Epoche aktiv ist. Das Aktivieren und Deaktivieren von Stake dauert eine gewisse Zeit.
• Epochen-Credits: epochCredits enthält den Verlauf der Leistung eines Validators beim Sammeln von Credits durch Abstimmungen.