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

​

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

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

​

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

1. blockhash (строка, обязательный): проверяемый хеш блока в виде строки, закодированной в base-58.
2. options (объект, необязательный): необязательный объект конфигурации, который может содержать:
   • commitment (строка, необязательный): задает уровень подтверждения для запроса (например, "finalized", "confirmed", "processed"). Если параметр не указан, используется уровень подтверждения узла по умолчанию.
   • minContextSlot (u64, необязательный): минимальный слот, на котором можно обработать запрос. Это гарантирует, что узел RPC не вернет состояние из слота, предшествующего minContextSlot.

​

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

• context (объект): объект, содержащий:
  • slot (u64): слот, на котором узел RPC оценивал действительность хеша блока.
• value (логическое значение): true, если хеш блока все еще действителен, иначе false.

{
  "jsonrpc": "2.0",
  "result": {
    "context": { "slot": 180000500 },
    "value": true
  },
  "id": 1
}

{
  "jsonrpc": "2.0",
  "result": {
    "context": { "slot": 180000800 },
    "value": false
  },
  "id": 1
}

​

Примеры кода

# Check validity of a blockhash (replace <YOUR_BLOCKHASH>):
curl -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "isBlockhashValid",
    "params": [
      "<YOUR_BLOCKHASH>"
    ]
  }' \
  <YOUR_RPC_URL>

# Check with commitment and minContextSlot (replace <YOUR_BLOCKHASH>):
curl -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "isBlockhashValid",
    "params": [
      "<YOUR_BLOCKHASH>",
      {
        "commitment": "confirmed",
        "minContextSlot": 170000000
      }
    ]
  }' \
  <YOUR_RPC_URL>

const { Connection } = require('@solana/web3.js');

async function checkBlockhash(blockhashToCheck) {
  // Replace with your RPC endpoint
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');

  try {
    console.log(`Checking validity of blockhash: ${blockhashToCheck}`);
    const result = await connection.isBlockhashValid(blockhashToCheck);
    
    console.log(`  Blockhash is valid: ${result.value}`);
    console.log(`  Checked at slot: ${result.context.slot}`);

    // Example with options
    // const resultWithOptions = await connection.isBlockhashValid(
    //   blockhashToCheck,
    //   { commitment: 'confirmed', minContextSlot: result.context.slot - 100 }
    // );
    // console.log(`\nWith options - Valid: ${resultWithOptions.value}, Slot: ${resultWithOptions.context.slot}`);

  } catch (error) {
    console.error(`Error checking blockhash ${blockhashToCheck}:`, error);
  }
}

// Example usage: First, get a recent blockhash
async function getRecentBlockhashAndCheck() {
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
  try {
    const { blockhash } = await connection.getLatestBlockhash();
    await checkBlockhash(blockhash); 
    
    // Example with a known old/invalid blockhash (will likely be false)
    // This blockhash is just an example and will be invalid.
    const oldBlockhash = 'J7rBdM6AecPDEZp8aPq5iPSNKVkU5Q76F3oAV4eW5wsW'; 
    // await checkBlockhash(oldBlockhash);

  } catch (error) {
    console.error('Error in example execution:', error);
  }
}

getRecentBlockhashAndCheck();

​

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

• Срок действия хешей блоков истекает: хеши блоков действительны только в течение ограниченного времени — около 150 слотов, или примерно 1–2 минут. Всегда получайте новый хеш блока, если не уверены в его актуальности или если прошло значительное время.
• Использование minContextSlot: используйте minContextSlot для защиты от запросов к неактуальному узлу RPC, который может вернуть устаревший ответ «действителен» для хеша блока, фактически уже слишком старого с точки зрения остальной части кластера.
• Альтернатива для старых узлов: для узлов с версиями Solana ниже 1.9 используйте getFeeCalculatorForBlockhash("<YOUR_BLOCKHASH>"). Если этот метод выполнен успешно, хеш блока действителен. Если он возвращает ошибку — обычно потому, что хеш блока не найден или слишком стар, — хеш блока недействителен.
• Подтверждение сетью: даже если isBlockhashValid возвращает true, транзакция считается окончательно подтвержденной только после того, как после отправки достигнет в сети требуемого уровня подтверждения.

​

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