0.7.51

docs/DB_EVENT_MODEL_REVIEW.md

@@ -338,10 +338,34 @@ La re-vérification Raydium CLMM introduit une table dédiée `k_sol_token_accou
 
 Cette table permet de suivre les événements Token-2022/ATA significatifs sans les confondre avec les trades ou les liquidités.
 
-## Note `0.7.50-final` — FK-safe cleanup for instruction observations
+## Note `0.7.51` — impact AMM v4 sur le modèle DB
 
-`k_sol_instruction_observations` is a technical index table. When a legacy `*.instruction_audit` decoded event is replaced by a local specialized event, existing observation rows can still point to the old decoded event id on already-created SQLite databases.
+Aucune nouvelle table n'est ajoutée pour `raydium_amm_v4`.
 
-The final 0.7.50 cleanup therefore unlinks `k_sol_instruction_observations.decoded_event_id` before deleting replaced CPMM instruction-audit rows. New databases define the `decoded_event_id` foreign key with `ON DELETE SET NULL` for the same reason.
+Décisions DB maintenues :
 
-This is not a business-table promotion. It only keeps the technical observation index consistent with decoded event cleanup.
+- `k_sol_instruction_observations` reste une table technique d'indexation instruction/discriminant ;
+- AMM v4 utilise des discriminants d'un octet, donc l'index technique doit conserver `09`, `0b`, `10`, `11`, etc. sans les convertir en discriminants Anchor huit octets ;
+- le refresh de `k_sol_instruction_observations` reconstruit les observations par transaction avant upsert, afin de supprimer les restes historiques en huit octets après changement de stratégie d'indexation ;
+- les side effects SPL Token / Token-2022 restent transversaux et ne doivent pas être promus comme events directs `raydium_amm_v4.*` ;
+- les side effects Serum/OpenBook de AMM v4 doivent être documentés comme contexte orderbook, pas comme trades OpenBook autonomes ;
+- `raydium_pool_v4` ne justifie aucune table ni aucun decoder séparé sans corpus local.
+
+Le modèle actuel suffit pour ouvrir la tranche : decoded events + coverage entries + instruction observations + matérialisations existantes trade/liquidity/lifecycle/fee/admin/orderbook. Une extension future orderbook/vault/token-account ne doit être ajoutée qu'après preuves multi-DEX.
+
+
+
+### Clôture `0.7.51` — AMM v4 et modèle DB
+
+La validation finale AMM v4 confirme qu'aucune nouvelle table n'est requise pour `raydium_amm_v4`.
+
+Règles validées :
+
+- chaque decoded event AMM v4 matérialisé cible au plus une table métier principale ;
+- `migrate_to_open_book`, `monitor_step` et `admin_cancel_orders` alimentent `k_sol_orderbook_events` uniquement ;
+- `pre_initialize` alimente `k_sol_pool_lifecycle_events` comme audit deprecated/partial, sans création de paire exploitable ;
+- `simulate_info` reste dans `k_sol_dex_decoded_events` uniquement ;
+- les `deposit` / `withdraw` sans pool/pair catalogue ou sans deltas exploitables restent decoded-only expliqués ;
+- les side effects SPL Token / Token-2022 restent transversaux.
+
+Contrôle final AMM v4 : le SQL `materialized_target_count > 1` doit rester vide.