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
requestAirdropverwenden, 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
pubkey(string, erforderlich): Der öffentliche Schlüssel des Kontos, das die abgeworfenen Lamports erhält, als Base-58-kodierte Zeichenfolge.lamports(u64, erforderlich): Die Menge der angeforderten Lamports. (1 SOL = 1.000.000.000 Lamports).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 Feldresult in der JSON-RPC-Antwort ist eine einzelne Zeichenkette, die die Transaktionssignatur des Airdrop in Base-58-kodierter Form darstellt.
Beispielantwort:
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
requestAirdropeine Signatur zurückgibt, muss die Transaktion noch vom Netzwerk verarbeitet und bestätigt werden. Sie könnenconfirmTransaction(von@solana/web3.js) verwenden odergetSignatureStatusesabfragen, um auf die Bestätigung zu warten.
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