This commit is contained in:
2026-07-23 16:37:12 +02:00
parent 99c345f2f2
commit 0da75c1311
2159 changed files with 230833 additions and 0 deletions

View File

@@ -0,0 +1,19 @@
# file: kb_config/Cargo.toml
# version: 3
[package]
name = "kb_config"
version.workspace = true
edition.workspace = true
license.workspace = true
publish.workspace = true
[dependencies]
kb_core = { path = "../kb_core" }
jsonschema.workspace = true
serde.workspace = true
serde_json.workspace = true
ts-rs.workspace = true
[lints]
workspace = true

View File

@@ -0,0 +1,68 @@
<!-- file: kb_config/README.md -->
<!-- version: 6 -->
# kb_config
Ce crate définit le contrat de configuration commun du workspace.
## Rôle dans l'écosystème
`kb_config` charge, valide et sérialise un fichier JSON contenant plusieurs profils. Un seul profil est actif à l'exécution grâce au champ `active_profile`.
Le crate fournit les structures typées runtime pour :
- l'application et l'environnement ;
- les sorties de logs console, fichier humain, fichier JSON et fichier erreurs ;
- les filtres de targets `tracing` ;
- les stores PostgreSQL et SQLite ;
- les endpoints HTTP JSON-RPC et WebSocket Solana ;
- les rôles et limites par endpoint ;
- les listeners Solana standards ;
- le wallet temporaire géré par profil ;
- les permissions d'envoi localnet/devnet/testnet/mainnet ;
- les plafonds de dépense, frais, priorité et fraîcheur du blockhash ;
- les pages de démonstration Tauri.
## Wallet temporaire
Le profil `local_devnet` active un wallet persistant de laboratoire sous :
```text
wallets/temporary/local_devnet/local-devnet-operator.json
```
Les profils mainnet conservent `temporary_wallet_enabled = false`. La validation typée refuse un wallet temporaire actif sur `mainnet-beta`, une persistance sans activation et les alias pouvant produire un chemin arbitraire.
## Exécution
La configuration sépare :
- le dry-run par défaut ;
- l'obligation de simulation ;
- la confirmation opérateur ;
- les plafonds de dépense localnet, devnet, testnet et mainnet ;
- le plafond de frais ;
- le plafond de prix par compute unit ;
- l'âge maximal du recent blockhash.
Un cluster dont l'envoi est activé doit disposer d'un plafond de dépense positif. Toute dépense configurée exige la simulation et toute dépense mainnet exige la confirmation opérateur. Les paramètres de confirmation sont bornés et le plafond dairdrop Devnet est interdit dans les profils dun autre cluster.
## Validation
La validation se fait en deux étapes :
1. validation JSON brute via `config/schema.config.json` et `jsonschema` ;
2. validation typée après désérialisation Rust.
## Secrets et placeholders
Le fichier versionné doit rester sans secret. Les placeholders restent directement dans les URLs. Les keypairs générés par `kb_wallet` vivent hors du fichier de configuration et sous un répertoire ignoré par Git.
## Exports TS-rs
Les structures exposées à Tauri utilisent `TS` avec un chemin `export_to` explicite. Les fichiers générés servent uniquement au partage des types Rust/TypeScript et ne remplacent pas le schéma JSON runtime.
```bash
cargo test export_bindings -p kb_config
cargo test -p kb_config settings::tests::
```

View File

@@ -0,0 +1,70 @@
// file: kb_config/src/lib.rs
// version: 2
//! Workspace configuration contract and loading helpers.
#![warn(missing_docs)]
#![deny(unreachable_pub)]
#![forbid(unsafe_code)]
mod settings;
/// Exposes the account listener configuration type.
pub use crate::settings::AccountListenerConfig;
/// Exposes the root application configuration type.
pub use crate::settings::AppConfig;
/// Exposes the application section configuration type.
pub use crate::settings::AppSectionConfig;
/// Exposes the local data configuration type.
pub use crate::settings::DataConfig;
/// Exposes the database configuration type.
pub use crate::settings::DatabaseConfig;
/// Exposes the demo application configuration type.
pub use crate::settings::DemoConfig;
/// Exposes the endpoint role configuration type.
pub use crate::settings::EndpointRoleConfig;
/// Exposes the execution configuration type.
pub use crate::settings::ExecutionConfig;
/// Exposes the HTTP endpoint configuration type.
pub use crate::settings::HttpEndpointConfig;
/// Exposes the listener configuration type.
pub use crate::settings::ListenerConfig;
/// Exposes the log listener configuration type.
pub use crate::settings::LogListenerConfig;
/// Exposes the logging target configuration type.
pub use crate::settings::LogTargetConfig;
/// Exposes the logging target filter configuration type.
pub use crate::settings::LogTargetFilterConfig;
/// Exposes the logging configuration type.
pub use crate::settings::LoggingConfig;
/// Exposes the PostgreSQL configuration type.
pub use crate::settings::PostgresConfig;
/// Exposes the profile configuration type.
pub use crate::settings::ProfileConfig;
/// Exposes the program listener configuration type.
pub use crate::settings::ProgramListenerConfig;
/// Exposes the Solana configuration type.
pub use crate::settings::SolanaConfig;
/// Exposes the SQLite configuration type.
pub use crate::settings::SqliteConfig;
/// Exposes the wallet configuration type.
pub use crate::settings::WalletConfig;
/// Exposes the WebSocket endpoint configuration type.
pub use crate::settings::WsEndpointConfig;
/// Exposes the active profile resolver.
pub use crate::settings::active_profile;
/// Exposes the embedded JSON Schema text.
pub use crate::settings::config_json_schema_text;
/// Exposes the embedded JSON Schema value parser.
pub use crate::settings::config_json_schema_value;
/// Exposes the configuration parser from a JSON string.
pub use crate::settings::parse_config_json;
/// Exposes the configuration loader from a filesystem path.
pub use crate::settings::read_config_json_file;
/// Exposes the compact JSON serializer for configuration values.
pub use crate::settings::serialize_config_json;
/// Exposes the pretty JSON serializer for configuration values.
pub use crate::settings::serialize_config_json_pretty;
/// Exposes the typed configuration validator.
pub use crate::settings::validate_config;
/// Exposes the JSON Schema validator for raw JSON configuration.
pub use crate::settings::validate_config_json_schema;

File diff suppressed because it is too large Load Diff