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, avec les mêmes contrats contextualisés, la même façade publique et sans dépendance inverse vers kb-store.

2.6 KiB Raw Blame History Unescape Escape