> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Verwendung von getMinimumBalanceForRentExemption
> Erfahren Sie mehr über Anwendungsfälle, Codebeispiele, Anforderungsparameter, Antwortstruktur und Tipps zu getMinimumBalanceForRentExemption.
Die [`getMinimumBalanceForRentExemption`](https://www.helius.dev/docs/api-reference/rpc/http/getminimumbalanceforrentexemption) RPC-Methode ermöglicht es Ihnen, diesen Mindest-Lamport-Betrag zu berechnen, der für ein Konto einer bestimmten Datengröße erforderlich ist, um mietfrei zu sein.
In Solana müssen Konten ein Mindestguthaben halten, um Speicherkosten über die Zeit abzudecken, ein Konzept, das als Miete bekannt ist. Konten, die ein Guthaben haben, das zwei Jahre Mietzahlungen entspricht, gelten als "mietfrei" und ihr Guthaben wird nicht durch [Miete](https://www.helius.dev/blog/solana-executive-overview) verringert.
## 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](https://www.helius.dev/blog/solana-commitment-levels) 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
Das `result` Feld der JSON-RPC-Antwort wird ein `u64` (unsignierter 64-Bit-Integer) sein, der die minimale Anzahl von Lamports darstellt, die für ein Konto mit der angegebenen `dataLength` erforderlich sind, um mietfrei zu sein.
## Beispiele
### 1. Mietfreiheit für ein Standard-Token-Konto (165 Bytes) erhalten
Dieses Beispiel fragt das Mindestguthaben ab, das für ein typisches SPL-Token-Konto (das eine Datengröße von 165 Bytes hat) erforderlich ist, um mietfrei zu sein.
```bash cURL theme={"system"}
# Replace with your Helius API key
curl https://mainnet.helius-rpc.com/?api-key= -X POST -H "Content-Type: application/json" -d \
'{
"jsonrpc": "2.0",
"id": 1,
"method": "getMinimumBalanceForRentExemption",
"params": [
165
]
}'
```
```javascript JavaScript (using @solana/web3.js) theme={"system"}
// Replace 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=');
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
Dies zeigt die Basismietfreiheit für ein Konto ohne Daten, oft das absolute Minimum für jedes Konto.
```bash cURL theme={"system"}
# Replace with your Helius API key
curl https://mainnet.helius-rpc.com/?api-key= -X POST -H "Content-Type: application/json" -d \
'{
"jsonrpc": "2.0",
"id": 1,
"method": "getMinimumBalanceForRentExemption",
"params": [
0
]
}'
```
```javascript JavaScript (using @solana/web3.js) theme={"system"}
// Replace 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=');
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.
Dieser Leitfaden hilft Ihnen, die `getMinimumBalanceForRentExemption` RPC-Methode zu verstehen und effektiv zu nutzen, um die Miete für Konten in Ihren Solana-Anwendungen zu verwalten.