Как использовать getLatestBlockhash

​

Распространенные сценарии использования

• Создание транзакции: получите недавний хеш блока, чтобы включить его в новую транзакцию перед подписанием и отправкой.
• Управление временем жизни транзакции: используйте lastValidBlockHeight, чтобы определить, как долго транзакция, ссылающаяся на полученный хеш блока, будет оставаться действительной.
• Предварительные проверки: хотя simulateTransaction может выполнять их автоматически, приложения могут получать хеш блока, чтобы вручную подготовить транзакцию к симуляции.

​

Параметры запроса

• commitment (строка, необязательный): задает уровень подтверждения для запроса. Если параметр не указан, используется уровень подтверждения узла по умолчанию. Для транзакций обычно используют confirmed или finalized, чтобы получить хеш блока из достаточно стабильной части цепочки.
• minContextSlot (целое число, необязательный): минимальный слот, на котором может быть выполнен запрос. Это гарантирует, что запрос выполняется к состоянию реестра, обработавшему данные как минимум до этого слота.

​

Структура ответа

• blockhash (строка): строка в кодировке base58, представляющая последний хеш блока.
• lastValidBlockHeight (u64): высота блока, на которой истекает срок действия blockhash. Транзакция, ссылающаяся на этот blockhash, действительна, пока сеть не достигнет lastValidBlockHeight.

​

Примеры

​

1. Получение последнего хеша блока с уровнем подтверждения по умолчанию

# 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": "getLatestBlockhash"
  }'

// Replace <api-key> with your Helius API key
const { Connection } = require('@solana/web3.js');

async function fetchLatestBlockhash() {
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
  try {
    const { blockhash, lastValidBlockHeight } = await connection.getLatestBlockhash();
    console.log('Latest Blockhash Info:');
    console.log(`  Blockhash: ${blockhash}`);
    console.log(`  Last Valid Block Height: ${lastValidBlockHeight}`);
    // This blockhash can now be used in a transaction
  } catch (error) {
    console.error('Error fetching latest blockhash:', error);
  }
}

fetchLatestBlockhash();

​

2. Получение последнего хеша блока с уровнем подтверждения ‘confirmed’

# 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": "getLatestBlockhash",
    "params": [{ "commitment": "confirmed" }]
  }'

// Replace <api-key> with your Helius API key
const { Connection } = require('@solana/web3.js');

async function fetchConfirmedBlockhash() {
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
  try {
    const { blockhash, lastValidBlockHeight } = await connection.getLatestBlockhash('confirmed');
    console.log('Confirmed Blockhash Info:');
    console.log(`  Blockhash: ${blockhash}`);
    console.log(`  Last Valid Block Height: ${lastValidBlockHeight}`);
  } catch (error) {
    console.error('Error fetching confirmed blockhash:', error);
  }
}

fetchConfirmedBlockhash();

​

Рекомендации разработчикам

• Срок действия хеша блока: хеш блока действителен в течение ограниченного времени — примерно 2 минут, хотя это значение может меняться. Транзакции должны быть подтверждены сетью до достижения их lastValidBlockHeight. Всегда запрашивайте новый хеш блока, если с момента получения предыдущего прошло значительное время.
• Выбор уровня подтверждения: для критически важных транзакций уровень подтверждения finalized дает наиболее надежную гарантию того, что хеш блока относится к основному ответвлению цепочки, но сам хеш может быть немного старее. confirmed обеспечивает хороший баланс. Подробности см. в материале об уровнях подтверждения.
• Комиссии за транзакции: не забудьте также рассчитать и указать подходящую комиссию за транзакцию. Сам хеш блока не определяет размер комиссии.
• Логика повторных попыток: если срок действия транзакции истек из-за достижения lastValidBlockHeight, необходимо повторно подписать ее с новым, более свежим хешем блока и отправить снова.

​

Связанные методы