Cara Menggunakan getMinimumBalanceForRentExemption

​

Kasus Penggunaan Umum

• Pembuatan Akun: Sebelum membuat akun baru (misalnya, untuk akun token baru, alamat turunan program, atau penyimpanan data khusus), gunakan metode ini untuk menentukan jumlah lamport yang perlu dialokasikan agar akun tersebut bebas sewa sejak awal. Ini mencegah akun dihapus oleh proses pengumpulan sampah jika saldonya terlalu rendah.
• Penentuan Ukuran Akun Dinamis: Jika aplikasi Anda menangani akun yang ukuran datanya dapat bertambah, Anda dapat menggunakan metode ini untuk memeriksa secara berkala apakah lamport tambahan diperlukan untuk mempertahankan status bebas sewa.
• Estimasi Biaya: Perkirakan biaya SOL yang terkait dengan penerapan program atau pembuatan akun data dengan berbagai ukuran.
• Integrasi Dompet dan SDK: Dompet dan SDK menggunakan metode ini untuk memastikan akun baru menerima pendanaan yang sesuai.

​

Parameter Permintaan

1. dataLength (usize, wajib): Panjang data akun dalam byte. Ini adalah faktor utama yang menentukan saldo minimum agar akun bebas sewa.
   • Contoh: 165 (untuk akun SPL Token standar).
2. commitment (object, opsional): Menentukan tingkat komitmen untuk kueri. Jika dihilangkan, komitmen default dari node RPC akan digunakan.
   • Bidang:
     • commitment (string): misalnya, "finalized", "confirmed", atau "processed".

​

Struktur Respons

​

Contoh

​

1. Mendapatkan Saldo Bebas Sewa untuk Akun Token Standar (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. Mendapatkan Saldo Bebas Sewa untuk Akun Berukuran Nol 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": [
      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();

​

Tips untuk Developer

• Sewa Berbeda Berdasarkan Ukuran Data: Semakin besar data akun, semakin tinggi saldo minimum agar akun bebas sewa.
• Parameter Jaringan: Biaya dasar sewa (lamport per byte-tahun) adalah parameter jaringan yang secara teoretis dapat berubah melalui pemungutan suara cluster, meskipun hal ini jarang terjadi. Metode getMinimumBalanceForRentExemption akan selalu mengembalikan nilai terkini berdasarkan status cluster.
• Lamport vs. SOL: Respons diberikan dalam lamport. Ingat bahwa 1 SOL = 1.000.000.000 lamport.
• Penting untuk Keberlanjutan: Memastikan akun bebas sewa sangat penting untuk mempertahankan data dalam jangka panjang di blockchain Solana.