khadhroony-bot3/docs/guides/DEVNET_0_4_6_OPERATOR_GUIDE.md

Guide opérateur Devnet pour l’alignement 0.4.6

1. Objectif

Ce guide regroupe les opérations minimales à valider avant le passage officiel de bot3 à 0.4.6.

2. Préparer le profil

• sélectionner un profil Devnet valide ;
• vérifier le RPC HTTP, le WebSocket et PostgreSQL ;
• vérifier que auto_initialize_schema correspond à l’intention de la campagne ;
• utiliser un wallet de démonstration persistant et financé par faucet Web.

La clé privée ne doit jamais être copiée dans les logs ou l’interface.

3. Vérifier PostgreSQL

Depuis les fenêtres SQL :

1. charger le diagnostic général ;
2. vérifier les tables raw ;
3. vérifier les tables Core ;
4. vérifier les tables decode/materialization ;
5. noter la version de migration et les anomalies d’index ou contraintes.

4. Campagne raw → Core → Decode → Materialize

1. Exécuter un backfill borné sur un Program ID ou une adresse connue.
2. Vérifier l’insertion raw et les observations.
3. Exécuter Core extraction sur les nouvelles lignes.
4. Exécuter Decode replay avec les décodeurs adaptés.
5. Activer la matérialisation.
6. Vérifier les diagnostics et projections.
7. Rejouer la même sélection.
8. Confirmer l’idempotence et l’absence de duplications.

5. Exécution Solana Core

Pour System Transfer :

• vérifier le wallet et la balance ;
• générer ou saisir un destinataire ;
• utiliser un montant minimal ;
• exécuter d’abord la simulation ;
• confirmer explicitement l’envoi ;
• vérifier la signature finalisée ;
• effectuer backfill, Core extraction et replay ;
• vérifier les observations et projections attendues.

6. Exécution SPL

Valider séparément :

• Memo v4 ;
• ATA classique ;
• ATA Token-2022 ;
• SPL Token classique TransferChecked ;
• opérations Token-2022 documentées comme supportées.

Pour chaque scénario :

1. vérifier les préconditions et comptes ;
2. vérifier les signers ;
3. simuler ;
4. confirmer l’envoi ;
5. vérifier la confirmation réseau ;
6. effectuer le backfill ;
7. effectuer Core extraction ;
8. effectuer Decode replay et matérialisation ;
9. rejouer pour l’idempotence ;
10. vérifier l’état final via CLI ou RPC lorsque pertinent.

7. WebSocket

Exécuter intégralement WEBSOCKET_LIFECYCLE_VALIDATION_SCENARIO.md.

8. Résultats à consigner

Pour chaque campagne, conserver :

• profil et cluster ;
• opération ;
• comptes publics concernés ;
• signature ;
• résultat simulation ;
• résultat envoi et confirmation ;
• nombres raw/Core/decode/materialize ;
• diagnostics ;
• résultat du second replay ;
• commande CLI ou RPC de vérification finale.

9. Hors périmètre

Metaplex Token Metadata complet n’est pas un critère de 0.4.6. Il sera planifié et terminé dans 0.4.7.

Le registre ElGamal reste conditionnel tant que son déploiement réseau et les preuves nécessaires ne sont pas confirmés.