Cách sử dụng getMinimumBalanceForRentExemption

​

Các trường hợp sử dụng phổ biến

• Tạo tài khoản: Trước khi tạo tài khoản mới (ví dụ: tài khoản token mới, địa chỉ do chương trình tạo hoặc kho lưu trữ dữ liệu tùy chỉnh), hãy sử dụng phương thức này để xác định số lamport cần phân bổ nhằm giúp tài khoản được miễn tiền thuê ngay từ đầu. Điều này ngăn tài khoản bị thu gom rác nếu số dư xuống quá thấp.
• Định cỡ tài khoản động: Nếu ứng dụng xử lý các tài khoản có kích thước dữ liệu có thể tăng lên, bạn có thể sử dụng phương thức này để kiểm tra định kỳ xem có cần thêm lamport để duy trì trạng thái miễn tiền thuê hay không.
• Ước tính chi phí: Ước tính chi phí SOL liên quan đến việc triển khai chương trình hoặc tạo tài khoản dữ liệu có nhiều kích thước khác nhau.
• Tích hợp ví và SDK: Các ví và SDK sử dụng phương thức này để đảm bảo cấp vốn phù hợp cho tài khoản mới.

​

Tham số yêu cầu

1. dataLength (usize, bắt buộc): Độ dài dữ liệu của tài khoản tính bằng byte. Đây là yếu tố chính quyết định mức tối thiểu để được miễn tiền thuê.
   • Ví dụ: 165 (đối với tài khoản SPL Token tiêu chuẩn).
2. commitment (object, không bắt buộc): Chỉ định mức cam kết cho truy vấn. Nếu bỏ qua, mức cam kết mặc định của nút RPC sẽ được sử dụng.
   • Các trường:
     • commitment (chuỗi): ví dụ: "finalized", "confirmed" hoặc "processed".

​

Cấu trúc phản hồi

​

Ví dụ

​

1. Lấy mức miễn tiền thuê cho tài khoản token tiêu chuẩn (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. Lấy mức miễn tiền thuê cho tài khoản có dữ liệu 0 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();

​

Mẹo dành cho nhà phát triển

• Tiền thuê thay đổi theo kích thước dữ liệu: Dữ liệu của tài khoản càng lớn thì mức tối thiểu để được miễn tiền thuê càng cao.
• Tham số mạng: Chi phí tiền thuê cơ sở (lamport trên mỗi byte-năm) là một tham số mạng, về lý thuyết có thể thay đổi thông qua biểu quyết của cụm, mặc dù điều này hiếm khi xảy ra. Phương thức getMinimumBalanceForRentExemption sẽ luôn trả về giá trị hiện tại dựa trên trạng thái của cụm.
• Lamport so với SOL: Phản hồi được tính bằng lamport. Hãy nhớ rằng 1 SOL = 1.000.000.000 lamport.
• Thiết yếu cho khả năng tồn tại lâu dài: Việc đảm bảo các tài khoản được miễn tiền thuê rất quan trọng đối với khả năng duy trì dữ liệu lâu dài trên blockchain Solana.