Introspection des instructions

Sysvar Instructions

Les programmes peuvent inspecter toutes les instructions de niveau supérieur dans la transaction actuelle via le sysvar Instructions (Sysvar1nstructions1111111111111111111111111). Cela permet à un programme d'inspecter les autres instructions dans la même transaction, par exemple pour vérifier qu'une instruction spécifique se trouve dans la même transaction que l'instruction qu'il exécute.

Le sysvar instructions n'est pas accessible via le trait Sysvar normal. Au lieu de cela, il est accessible via des fonctions libres dans la crate solana_instructions_sysvar.

Les données du sysvar sont sérialisées avec une disposition binaire personnalisée :

Chaque instruction sérialisée contient : le nombre de comptes (u16), les comptes sous forme d'entrées de 33 octets (1 octet de drapeau + clé publique de 32 octets), l'ID du programme (32 octets), la longueur des données (u16) et les octets de données brutes.

Fonctions clés :

• load_current_index_checked(account_info) : Renvoie l'index de l'instruction en cours d'exécution. Le runtime met à jour cette valeur chaque fois qu'une nouvelle instruction de niveau supérieur commence.
• load_instruction_at_checked(index, account_info) : Désérialise l'instruction à l'index absolu donné.
• get_instruction_relative(offset, account_info) : Charge une instruction relative à l'instruction actuelle (par exemple, -1 pour l'instruction précédente, 1 pour la suivante).