Comment utiliser getBlock

​

Cas d’utilisation courants

• Inspection du contenu des blocs : Voir toutes les transactions incluses dans un bloc spécifique.
• Récupération des hachages de blocs : Obtenez le blockhash pour un slot donné, le blockhash de son parent et son slot parent.
• Vérification de la hauteur et du temps du bloc : Découvrez la hauteur d’un bloc (son numéro de séquence) et son temps de production estimé.
• Analyse des détails des transactions : Avec les paramètres appropriés, vous pouvez obtenir les données complètes des transactions, y compris les métadonnées telles que les frais, le statut, les soldes avant/après et les instructions internes.
• Récupération des récompenses : Incluez optionnellement les informations de récompense pour le bloc.

​

Paramètres

1. slot (nombre, requis) : Le numéro du slot du bloc à interroger (u64).
2. config (objet, optionnel) : Un objet de configuration avec les champs suivants :
   • commitment (chaîne, optionnel) : Spécifie le niveau d’engagement à utiliser. processed n’est pas supporté pour cette méthode. Par défaut, finalized.
   • encoding (chaîne, optionnel) : Le codage des données de transaction. Par défaut, json si transactionDetails est full ou accounts, sinon base64.
     • json : Retourne les transactions et les données de comptes au format JSON (déprécié en faveur de jsonParsed).
     • jsonParsed : Retourne les transactions et les données de comptes sous forme de JSON analysé. Ceci est recommandé car il inclut toutes les clés de compte de transaction (y compris celles des Address Lookup Tables).
     • base58 (lent)
     • base64
     • base64+zstd
   • transactionDetails (chaîne, optionnel) : Spécifie le niveau de détail de transaction à retourner. Par défaut, full.
     • full : Retourne tous les détails de la transaction, y compris les métadonnées de transaction.
     • accounts : Retourne une liste des comptes détaillés dans chaque transaction, mais pas les données complètes de transaction ni les métadonnées.
     • signatures : Retourne uniquement les signatures de transaction.
     • none : Ne retourne aucun détail de transaction.
   • rewards (booléen, optionnel) : Si inclure ou non le tableau des récompenses dans la réponse. Par défaut, false.
   • maxSupportedTransactionVersion (nombre, optionnel) : La version de transaction maximale à retourner. Si le bloc contient une transaction avec une version supérieure, la requête échoue avec une erreur JSON-RPC -32015. Si omis, seules les transactions héritées sont retournées, et un bloc avec toute transaction versionnée provoque une erreur. Définir à 1 pour inclure les transactions héritées, v0 (Address Lookup Tables) et v1. Voir Support de Transaction v1.

​

Réponse

• blockhash (chaîne) : Le blockhash encodé en base-58 pour ce bloc.
• previousBlockhash (chaîne) : Le blockhash encodé en base-58 du bloc précédent. Si le parent n’est pas disponible (en raison du nettoyage du registre), cela pourrait être l’ID du programme système.
• parentSlot (nombre) : Le numéro du slot du bloc parent.
• transactions (tableau) : Un tableau d’objets de transaction inclus dans le bloc. La structure de ces objets dépend des paramètres encoding et transactionDetails.
  • Chaque objet de transaction contient généralement meta (métadonnées comme les frais, le statut, les journaux, les soldes avant/après) et transaction (les données réelles de la transaction, y compris le message et les signatures).
• rewards (tableau, optionnel) : Un tableau d’objets de récompense, présent si rewards: true a été spécifié. Chaque objet détaille pubkey, lamports, postBalance, rewardType, et potentiellement commission.
• blockTime (nombre | null) : Le temps de production estimé du bloc en tant que timestamp Unix (secondes depuis l’époque), ou null si non disponible.
• blockHeight (nombre | null) : La hauteur de ce bloc (nombre de blocs avant celui-ci dans la chaîne à partir du slot 0), ou null si non disponible.

​

Exemple : Récupération d’informations sur un bloc

# Replace 250000000 with a valid, recent slot number on Devnet/Mainnet
curl https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY -X POST -H "Content-Type: application/json" -d \
'{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getBlock",
  "params": [
    250000000, 
    {
      "encoding": "jsonParsed",
      "transactionDetails": "full",
      "rewards": true,
      "maxSupportedTransactionVersion": 1
    }
  ]
}'

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

async function getBlockDetails() {
  const rpcUrl = 'https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY'; // Replace YOUR_API_KEY
  const connection = new Connection(rpcUrl, 'confirmed');
  
  // Replace with a valid, recent slot number on your target network
  const slotToQuery = 250000000; 

  try {
    const block = await connection.getBlock(slotToQuery, {
      encoding: "jsonParsed",
      transactionDetails: "full",
      rewards: true,
      maxSupportedTransactionVersion: 1 
    });

    if (block) {
      console.log('Block Details:');
      console.log(`   Slot: ${slotToQuery}`);
      console.log(`   Blockhash: ${block.blockhash}`);
      console.log(`   Previous Blockhash: ${block.previousBlockhash}`);
      console.log(`   Parent Slot: ${block.parentSlot}`);
      console.log(`   Block Height: ${block.blockHeight !== null ? block.blockHeight : 'N/A'}`);
      console.log(`   Block Time: ${block.blockTime ? new Date(block.blockTime * 1000).toISOString() : 'N/A'}`);
      console.log(`   Transactions Count: ${block.transactions.length}`);
      // console.log('   Transactions:', JSON.stringify(block.transactions, null, 2)); // Full transaction details
      // console.log('   Rewards:', JSON.stringify(block.rewards, null, 2)); // Reward details
    } else {
      console.log(`Block at slot ${slotToQuery} not found or not confirmed.`);
    }
  } catch (error) {
    console.error(`Error fetching block ${slotToQuery}:`, error);
  }
}

getBlockDetails();

import { createSolanaRpc } from "@solana/kit";

const rpc_url = "https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY";
const rpc = createSolanaRpc(rpc_url);

const slot_number = BigInt(377261141);

let block = await rpc
  .getBlock(
    slot_number,
    {
      commitment: "finalized",
      encoding: "json",
      transactionDetails: "full",
      maxSupportedTransactionVersion: 1,
      rewards: false,
    },
  )
  .send();

console.log("block:", block);

use anyhow::Result;
use solana_client::nonblocking::rpc_client::RpcClient;
use solana_sdk::commitment_config::CommitmentConfig;
use solana_transaction_status_client_types::{TransactionDetails, UiTransactionEncoding};

#[tokio::main]
async fn main() -> Result<()> {
    let client = RpcClient::new_with_commitment(
        String::from("https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY"),
        CommitmentConfig::confirmed(),
    );

    let slot_number = 377261141;

    let config = solana_client::rpc_config::RpcBlockConfig {
        encoding: UiTransactionEncoding::Base58.into(),
        transaction_details: TransactionDetails::Full.into(),
        rewards: None,
        commitment: CommitmentConfig::finalized().into(),
        max_supported_transaction_version: Some(0),
    };
    let block = client.get_block_with_config(slot_number, config).await?;

    println!("Block: {:#?}", block);

    Ok(())
}

​

Conseils pour les développeurs

• Slot vs. Hauteur de Bloc : N’oubliez pas que getBlock prend un nombre slot comme entrée, pas nécessairement une hauteur de bloc. Bien que les slots soient séquentiels, certains peuvent être ignorés par les leaders. Le champ blockHeight dans la réponse indique le nombre réel de blocs avant celui-ci.
• maxSupportedTransactionVersion est Crucial : Pour inspecter les blocs avec des transactions versionnées (qui sont désormais standard et utilisent les Address Lookup Tables), vous devez définir maxSupportedTransactionVersion: 1 (ou une version plus élevée si une nouvelle norme émerge). L’oublier entraînera des erreurs pour la plupart des blocs modernes.
• Choisir transactionDetails :
  • full est nécessaire pour une analyse détaillée mais retourne le plus de données.
  • signatures est utile si vous avez seulement besoin de lister les transactions dans un bloc.
  • accounts peut être un juste milieu si vous devez voir quels comptes étaient impliqués sans récupérer toutes les données d’instruction.
  • none est rare mais pourrait être utilisé si vous vous souciez uniquement des métadonnées au niveau du bloc comme blockhash ou rewards.
• jsonParsed est Recommandé pour l’encodage : Lors de la demande de détails de transaction, jsonParsed fournit la sortie la plus conviviale pour les développeurs et résout correctement les comptes des Address Lookup Tables, ce que json (déprécié) ne fait pas.
• Indisponibilité du Bloc : Un résultat null signifie que le bloc à ce slot n’a pas été trouvé. Cela pourrait être dû au fait que le slot a été ignoré, que le bloc n’a pas été confirmé au niveau spécifié par votre commitment, ou que le nœud RPC a supprimé ce bloc historique de son registre (commun pour les slots plus anciens).
• Informations sur les Récompenses : La configuration rewards: true est nécessaire pour voir la distribution des récompenses de bloc au validateur (et potentiellement aux stakers, selon le type de récompense). Cela ajoute à la taille de la réponse.
• Compréhension de la Structure des Blocs : Pour une compréhension plus approfondie de la façon dont les blocs s’intègrent dans l’architecture de Solana, voir Comprendre les Slots, Blocs et Époques sur Solana.