Cómo usar getFeeForMessage

​

Casos de uso comunes

• Estimación de comisiones: Determina la comisión de transacción probable (en lamports) para un mensaje específico.
• Optimización de costos: Analiza las comisiones de distintas estructuras de transacción o en diferentes momentos.
• Visualización en la interfaz de usuario: Muestra a los usuarios un costo de transacción estimado antes de que firmen y envíen una transacción.

​

Parámetros de solicitud

1. message (cadena, obligatorio): El mensaje de la transacción, codificado en base64. Puedes obtenerlo compilando una transacción.
2. config (objeto, opcional): Un objeto de configuración con los siguientes campos:
   • commitment (cadena, opcional): Especifica el nivel de compromiso que se usará. El valor predeterminado es finalized.
   • minContextSlot (número, opcional): La ranura mínima en la que se puede evaluar la solicitud.

​

Estructura de la respuesta

• context (objeto):
  • slot (u64): La ranura en la que se evaluó la comisión.
• value (u64 | null): La comisión estimada en lamports. Puede ser null si no se puede determinar la comisión (por ejemplo, si el hash de bloque usado en el mensaje es demasiado antiguo o no es válido).

​

Ejemplos

​

1. Estimar la comisión de un mensaje de transferencia simple

# First, you need a base64 encoded message. 
# This typically involves creating a transaction, compiling its message, 
# and then base64 encoding the serialized message.
# The example message below is illustrative.
# Replace "MESSAGE_BASE64_ENCODED" with your actual encoded message.
curl https://mainnet.helius-rpc.com/?api-key=<api-key> -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getFeeForMessage",
    "params": [
      "MESSAGE_BASE64_ENCODED", // Replace with your actual base64 encoded message
      { "commitment": "processed" }
    ]
  }'

const { Connection, Keypair, SystemProgram, Transaction, LAMPORTS_PER_SOL } = require('@solana/web3.js');

async function estimateTransactionFee() {
  const connection = new Connection('https://devnet.helius-rpc.com/?api-key=<api-key>');

  try {
    const fromPublicKey = Keypair.generate().publicKey;
    const toPublicKey = Keypair.generate().publicKey;

    let transaction = new Transaction().add(
      SystemProgram.transfer({
        fromPubkey: fromPublicKey,
        toPubkey: toPublicKey,
        lamports: 1000,
      })
    );

    transaction.feePayer = fromPublicKey;
    const { blockhash } = await connection.getLatestBlockhash('confirmed');
    transaction.recentBlockhash = blockhash;

    const message = transaction.compileMessage();
    const messageBase64 = message.serialize().toString('base64');

    console.log(`Compiled Message (Base64): ${messageBase64}`);

    const feeResult = await connection.getFeeForMessage(message, 'confirmed');

    if (feeResult && feeResult.value !== null) {
      console.log(`Estimated Fee: ${feeResult.value} lamports`);
    } else {
      console.log('Could not estimate fee. The value was null.');
      console.log('This might happen if the blockhash is too old or the message is invalid.');
    }

  } catch (error) {
    console.error('Error estimating transaction fee:', error);
    if (error.message.includes('failed to get recent blockhash')) {
        console.error('Ensure your RPC endpoint is responsive or try a different commitment level for getLatestBlockhash.');
    }
  }
}

estimateTransactionFee();

​

Consejos para desarrolladores

• Creación del mensaje: La clave para usar getFeeForMessage es crear y serializar correctamente el Message de la transacción. Esto implica establecer el pagador de la comisión, las instrucciones y un hash de bloque reciente.
• Hash de bloque reciente: El mensaje debe crearse con un hash de bloque reciente. Si el hash de bloque es demasiado antiguo, el valor de value en la respuesta podría ser null.
• Comisión base frente a comisión de prioridad: Este método devuelve la comisión base de la red. No incluye las comisiones de prioridad adicionales que podrías agregar a una transacción para aumentar la probabilidad de que se procese rápidamente durante períodos de congestión de la red. Usa getRecentPrioritizationFees para estimar las comisiones de prioridad.
• Lamports: La comisión se devuelve en lamports (1 SOL = 1,000,000,000 lamports).
• Valor nulo: Un valor null para la comisión puede indicar problemas con el mensaje (por ejemplo, un hash de bloque no válido o un mensaje mal formado) o que el nodo no puede calcular una comisión para este en el nivel de compromiso o la ranura especificados.

​

Métodos relacionados