So verwendest du getMinimumBalanceForRentExemption

​

Häufige Anwendungsfälle

• Kontoerstellung: Bevor du ein neues Konto erstellst, etwa ein neues Token-Konto, eine von einem Programm abgeleitete Adresse oder einen benutzerdefinierten Datenspeicher, kannst du mit dieser Methode die erforderliche Anzahl an Lamports ermitteln. So ist das Konto von Anfang an von der Rent befreit und wird nicht automatisch gelöscht, wenn sein Guthaben zu niedrig wird.
• Dynamische Kontogröße: Wenn deine Anwendung Konten verwendet, deren Daten wachsen können, kannst du mit dieser Methode regelmäßig prüfen, ob zusätzliche Lamports erforderlich sind, um die Befreiung von der Rent aufrechtzuerhalten.
• Kostenschätzung: Schätze die SOL-Kosten für die Bereitstellung von Programmen oder die Erstellung von Datenkonten unterschiedlicher Größe.
• Integration in Wallets und SDKs: Wallets und SDKs verwenden diese Methode, um neue Konten mit ausreichend Guthaben auszustatten.

​

Request-Parameter

1. dataLength (usize, erforderlich): Die Länge der Kontodaten in Byte. Sie ist der wichtigste Faktor für die Bestimmung des Mindestguthabens zur Befreiung von der Rent.
   • Beispiel: 165 (für ein standardmäßiges SPL-Token-Konto).
2. commitment (object, optional): Gibt die Stufe des commitment für die Abfrage an. Wenn du den Parameter weglässt, wird das standardmäßige commitment des RPC node verwendet.
   • Felder:
     • commitment (Zeichenfolge): z. B. "finalized", "confirmed" oder "processed".

​

Response-Struktur

​

Beispiele

​

1. Rent-Befreiung für ein standardmäßiges Token-Konto abrufen (165 Byte)

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

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

async function fetchMinimumBalanceForRentExemption() {
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
  const dataLength = 165; // Data length for a typical SPL token account

  try {
    const lamports = await connection.getMinimumBalanceForRentExemption(dataLength);
    console.log(`Minimum lamports for rent exemption (data length ${dataLength} bytes): ${lamports} SOL: (${lamports / 1_000_000_000})`);
  } catch (error) {
    console.error(`Error fetching minimum balance for rent exemption for data length ${dataLength}:`, error);
  }
}

fetchMinimumBalanceForRentExemption();

​

2. Rent-Befreiung für ein Konto mit null Byte abrufen

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

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

async function fetchMinimumBalanceForZeroByteAccount() {
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
  const dataLength = 0;

  try {
    const lamports = await connection.getMinimumBalanceForRentExemption(dataLength);
    console.log(`Minimum lamports for rent exemption (data length ${dataLength} bytes): ${lamports} SOL: (${lamports / 1_000_000_000})`);
  } catch (error) {
    console.error(`Error fetching minimum balance for rent exemption for data length ${dataLength}:`, error);
  }
}

fetchMinimumBalanceForZeroByteAccount();

​

Tipps für Entwickler

• Rent hängt von der Datengröße ab: Je größer die Datenmenge des Kontos ist, desto höher ist das Mindestguthaben für die Rent-Befreiung.
• Netzwerkparameter: Die zugrunde liegenden Rent-Kosten (Lamports pro Byte-Jahr) sind ein Netzwerkparameter, der theoretisch durch eine Abstimmung im cluster geändert werden kann. Das kommt jedoch selten vor. Die Methode getMinimumBalanceForRentExemption gibt immer den aktuellen Wert basierend auf dem Zustand des cluster zurück.
• Lamports und SOL: Die response wird in Lamports angegeben. Beachte: 1 SOL = 1.000.000.000 Lamports.
• Wichtig für die langfristige Speicherung: Damit Daten langfristig auf der Solana-Blockchain erhalten bleiben, müssen die zugehörigen Konten von der Rent befreit sein.