Skip to main content
Die requestAirdrop RPC-Methode ermöglicht es Ihnen, einen Airdrop von SOL (Lamports) auf ein angegebenes Konto zu beantragen. Diese Methode ist ausschließlich für nicht-Mainnet-Umgebungen wie Devnet und Testnet gedacht, wo sie als Faucet dient, um Entwicklern kostenlos SOL für das Testen ihrer Anwendungen bereitzustellen. Wichtig: Diese Methode funktioniert nicht auf Mainnet Beta.

Häufige Anwendungsfälle

  • Finanzierung von Testgeldbörsen: Erhalt von SOL zur Bezahlung von Transaktionsgebühren und Bereitstellung von Programmen auf Devnet oder Testnet.
  • Automatisiertes Testen: Scripts können requestAirdrop verwenden, um sicherzustellen, dass Testkonten über genügend SOL verfügen, bevor Testsuiten ausgeführt werden.
  • Entwicklung & Experimentieren: Schneller Erwerb von SOL zur Interaktion mit On-Chain-Programmen während der Entwicklung.

Anforderungsparameter

  1. pubkey (string, erforderlich): Der öffentliche Schlüssel des Kontos, das die abgeworfenen Lamports erhält, als Base-58-kodierte Zeichenfolge.
  2. lamports (u64, erforderlich): Die Menge der angeforderten Lamports. (1 SOL = 1.000.000.000 Lamports).
  3. options (object, optional): Ein optionales Konfigurationsobjekt, das Folgendes enthalten kann:
    • commitment (string, optional): Gibt das Commitment-Level an, auf das beim Bestätigen der Airdrop-Transaktion gewartet werden soll (z.B. "finalized", "confirmed", "processed"). Wenn nicht angegeben, wird das Standard-Commitment des Knotens für Airdrops verwendet.

Antwortstruktur

Das Feld result in der JSON-RPC-Antwort ist eine einzelne Zeichenkette, die die Transaktionssignatur des Airdrop in Base-58-kodierter Form darstellt. Beispielantwort:
Diese Signatur kann dann mit getTransaction oder einem Solana-Explorer verwendet werden, um den Status der Airdrop-Transaktion zu verfolgen.

Codebeispiele

Entwickler-Tipps

  • Netzwerkspezifisch: Diese Methode funktioniert nur in Testnetzwerken (Devnet, Testnet), die über einen aktivierten Faucet verfügen. Sie schlägt auf Mainnet Beta fehl.
  • Ratenbegrenzung: Airdrop-Faucets sind oft rate-limitiert, um Missbrauch zu verhindern. Wenn Sie in kurzer Zeit zu viele Anfragen stellen, können Sie Fehler erhalten.
  • Betragsbegrenzungen: Es kann Begrenzungen geben, wie viel SOL Sie pro Airdrop oder pro Zeitperiode anfordern können.
  • Bestätigung: Nachdem requestAirdrop eine Signatur zurückgibt, muss die Transaktion noch vom Netzwerk verarbeitet und bestätigt werden. Sie können confirmTransaction (von @solana/web3.js) verwenden oder getSignatureStatuses abfragen, um auf die Bestätigung zu warten.
Dieser Leitfaden erklärt, wie Sie requestAirdrop verwenden, um Ihre Testkonten auf Solanas Entwicklungsnetzwerken zu finanzieren.

Verwandte Methoden

getBalance

Überprüfen Sie das SOL-Guthaben nach Erhalt eines Airdrop

getSignatureStatuses

Abfrage des Transaktionsstatus zur Bestätigung des Airdrop