Verwendung von getMinimumBalanceForRentExemption

​

Häufige Anwendungsfälle

• Kontenerstellung: Bevor Sie ein neues Konto erstellen (z.B. für ein neues Token-Konto, programmgesteuerte Adresse oder benutzerdefinierten Datenspeicher), verwenden Sie diese Methode, um die erforderlichen Lamports zu bestimmen, damit es von Anfang an mietfrei ist. Dies verhindert, dass das Konto gelöscht wird, wenn sein Guthaben zu niedrig fällt.
• Dynamische Kontogrößenanpassung: Wenn Ihre Anwendung mit Konten arbeitet, die in der Datengröße wachsen können, können Sie diese Methode verwenden, um regelmäßig zu überprüfen, ob zusätzliche Lamports erforderlich sind, um die Mietfreiheit aufrechtzuerhalten.
• Kostenschätzung: Schätzen Sie die SOL-Kosten im Zusammenhang mit der Bereitstellung von Programmen oder der Erstellung von Datenkonten verschiedener Größen.
• Integration von Wallets und SDKs: Wallets und SDKs verwenden dies, um sicherzustellen, dass neue Konten angemessen finanziert werden.

​

Anforderungsparameter

1. dataLength (usize, erforderlich): Die Länge der Kontodaten in Bytes. Dies ist der Hauptfaktor, der das Mietfreiminimum bestimmt.
   • Beispiel: 165 (für ein Standard-SPL-Token-Konto).
2. commitment (object, optional): Gibt das Verbindlichkeitsniveau für die Abfrage an. Wenn es weggelassen wird, wird das Standardverbindlichkeitsniveau des RPC-Knotens verwendet.
   • Felder:
     • commitment (string): z. B. "finalized", "confirmed" oder "processed".

​

Antwortstruktur

​

Beispiele

​

1. Mietfreiheit für ein Standard-Token-Konto (165 Bytes) erhalten

# 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. Mietfreiheit für ein Null-Byte-Konto erhalten

# 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();

​

Entwicklertipps

• Miete variiert je nach Datengröße: Je größer die Kontodaten, desto höher ist das Mietfreiminimum.
• Netzwerkparameter: Die zugrunde liegenden Mietkosten (Lamports pro Byte-Jahr) sind ein Netzwerkparameter, der theoretisch durch eine Cluster-Abstimmung geändert werden kann, obwohl dies selten vorkommt. Die getMinimumBalanceForRentExemption Methode gibt immer den aktuellen Wert basierend auf dem Zustand des Clusters zurück.
• Lamports vs. SOL: Die Antwort erfolgt in Lamports. Denken Sie daran, dass 1 SOL = 1.000.000.000 Lamports.
• Wesentlich für Langlebigkeit: Die Sicherstellung der Mietfreiheit von Konten ist entscheidend für die dauerhafte Speicherung von Daten auf der Solana-Blockchain.