Khadhroony Bot3

Khadhroony Bot3 is the consolidated successor workspace to khadhroony-bot2.

Workspace crates

kb-core: foundation errors and shared primitives.
kb-config: configuration contracts.
kb-lib: all decoder, executor and materializer APIs and implementations.
kb-logging: logging and tracing runtime.
kb-program-ids: Solana program identifier registry.
kb-pipeline: ingestion, decoding, materialization and execution orchestration.
kb-rpc: HTTP and WebSocket Solana transports.
kb-store: store-neutral contracts and PostgreSQL implementation modules.
kb-wallet: wallet and signer support.
kb-app-demo: the only binary retained during the initial migration.

Migration principle

The previous workspace is preserved under migration/khadhroony-bot2-reference. The new workspace compiles independently as a controlled scaffold. Public APIs are ported into kb-lib module by module, with compatibility recorded in migration/module-map.json.

Validation

cargo fmt --all
cargo check --workspace
cargo test --workspace
cargo clippy --workspace --all-targets

État de migration `0.1.0-pre.001`

kb-wallet remplace définitivement le scaffold kb_wallet.
kb-core conserve l’architecture de kb_core : implémentations dans error.rs et module.rs, façade et réexports dans lib.rs.
Les prochaines APIs consolidées de kb-lib suivront la même règle : aucun contrat métier ne sera défini directement dans lib.rs.

Contrats consolidés

À partir de 0.1.0-pre.002, kb-lib porte les modèles et contrats fondamentaux autrefois répartis entre kb_model, kb_decoder_api, kb_materializer_api et kb_execution_api. Les implémentations restent dans des modules dédiés ; kb-lib/src/lib.rs ne contient que les déclarations de modules et les réexports publics.

Stockage consolidé

À partir de 0.1.0-pre.003, kb-store remplace le scaffold initial par une implémentation complète :

contrats store-neutral : DTO, entités, pagination, santé et traits de repository ;
adaptateur PostgreSQL : connexion, initialisation idempotente, requêtes, diagnostics et replay ;
façade unique dans kb-store/src/lib.rs ;
modèle de replay partagé conservé dans kb-lib, sans duplication ;
options PostgreSQL indépendantes de kb-config, adaptées par la frontière applicative.

Décodeurs consolidés

0.1.0-pre.004 porte le décodeur Solana Core dans kb-lib. 0.1.0-pre.005 ajoute SPL Memo v1, v3 et v4. 0.1.0-pre.006 ajoute le décodeur SPL Token classique avec ses 28 tags publiés, son wire borné, ses formes d’autorité et son Batch structuré. 0.1.0-pre.007 ajoute le programme SPL Associated Token Account avec ses trois instructions, sa forme historique Create vide et la validation canonique des PDA pour SPL Token classique et Token‑2022. Tous utilisent les mêmes contrats contextualisés, la même façade publique et aucune dépendance inverse vers kb-store.

3.0 KiB Raw Blame History Unescape Escape