Comment utiliser getMinimumBalanceForRentExemption

​

Cas d’utilisation courants

• Création de compte : Avant de créer un nouveau compte (par exemple, pour un nouveau compte de jetons, une adresse dérivée du programme ou un stockage de données personnalisé), utilisez cette méthode pour déterminer les lamports nécessaires à allouer pour le rendre exempt de loyer dès le départ. Cela empêche le compte d’être collecté comme déchet si son solde descend trop bas.
• Dimensionnement dynamique des comptes : Si votre application gère des comptes dont la taille des données peut augmenter, vous pouvez utiliser cette méthode pour vérifier périodiquement si des lamports supplémentaires sont nécessaires pour maintenir l’exemption de loyer.
• Estimation des coûts : Estimez le coût en SOL associé au déploiement de programmes ou à la création de comptes de données de différentes tailles.
• Intégration des portefeuilles et des SDK : Les portefeuilles et les SDK l’utilisent pour s’assurer qu’ils financent correctement les nouveaux comptes.

​

Paramètres de requête

1. dataLength (usize, requis) : La longueur des données du compte en octets. C’est le principal facteur déterminant le minimum exempt de loyer.
   • Exemple : 165 (pour un compte SPL Token standard).
2. commitment (object, optionnel) : Spécifie le niveau d’engagement pour la requête. Si omis, l’engagement par défaut du nœud RPC est utilisé.
   • Champs :
     • commitment (chaîne) : par exemple, "finalized", "confirmed", ou "processed".

​

Structure de réponse

​

Exemples

​

1. Obtenir l’exemption de loyer pour un compte de jetons standard (165 octets)

# 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. Obtenir l’exemption de loyer pour un compte à zéro octet

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

​

Conseils pour les développeurs

• Le loyer varie en fonction de la taille des données : Plus les données du compte sont grandes, plus le minimum exempt de loyer sera élevé.
• Paramètre du réseau : Le coût sous-jacent du loyer (lamports par octet-an) est un paramètre du réseau qui peut théoriquement changer via un vote du cluster, bien que cela soit rare. La méthode getMinimumBalanceForRentExemption renverra toujours la valeur actuelle basée sur l’état du cluster.
• Lamports vs. SOL : La réponse est en lamports. Rappelez-vous qu’1 SOL = 1 000 000 000 lamports.
• Essentiel pour la longévité : Assurer que les comptes sont exempts de loyer est crucial pour la persistance à long terme des données sur la blockchain Solana.