Cómo usar getMinimumBalanceForRentExemption

​

Casos de uso comunes

• Creación de cuentas: Antes de crear una cuenta nueva (por ejemplo, una nueva cuenta de token, una dirección derivada de un programa o almacenamiento de datos personalizado), usa este método para determinar los lamports necesarios que debes asignar a fin de que esté exenta de renta desde el principio. Esto evita que la cuenta se elimine automáticamente si su saldo disminuye demasiado.
• Tamaño dinámico de cuentas: Si tu aplicación trabaja con cuentas cuyo tamaño de datos puede aumentar, puedes usar este método para comprobar periódicamente si se necesitan lamports adicionales para mantener la exención de renta.
• Estimación de costos: Estima el costo en SOL asociado con el despliegue de programas o la creación de cuentas de datos de distintos tamaños.
• Integración con billeteras y SDK: Las billeteras y los SDK usan este método para asegurarse de financiar correctamente las cuentas nuevas.

​

Parámetros de la solicitud

1. dataLength (usize, obligatorio): La longitud de los datos de la cuenta en bytes. Este es el factor principal que determina el mínimo para la exención de renta.
   • Ejemplo: 165 (para una cuenta estándar de SPL Token).
2. commitment (object, opcional): Especifica el nivel de compromiso de la consulta. Si se omite, se usa el nivel de compromiso predeterminado del nodo RPC.
   • Campos:
     • commitment (cadena): por ejemplo, "finalized", "confirmed" o "processed".

​

Estructura de la respuesta

​

Ejemplos

​

1. Obtén la exención de renta para una cuenta de token estándar (165 bytes)

# 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. Obtén la exención de renta para una cuenta de cero bytes

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

​

Consejos para desarrolladores

• La renta varía según el tamaño de los datos: Cuanto más grandes sean los datos de la cuenta, mayor será el mínimo para la exención de renta.
• Parámetro de red: El costo subyacente de la renta (lamports por byte-año) es un parámetro de red que, en teoría, puede cambiar mediante una votación del clúster, aunque esto es poco frecuente. El método getMinimumBalanceForRentExemption siempre devolverá el valor actual según el estado del clúster.
• Lamports frente a SOL: La respuesta se expresa en lamports. Recuerda que 1 SOL = 1,000,000,000 lamports.
• Esencial para la persistencia: Garantizar que las cuentas estén exentas de renta es fundamental para la persistencia a largo plazo de los datos en la blockchain de Solana.