Skip to main content

Supporting Tools and Utilities

Home · Generic Index · Chain Overlays

This document captures auxiliary services and tools in credible-sdk that support debugging, testing, and state validation.

Shadow Driver​

credible-sdk/crates/shadow-driver is a gRPC client that replays blocks into the sidecar. It subscribes to new heads via WebSocket and sends events (commit_head, new_iteration, transaction) using gRPC streaming.

Key files:

  • credible-sdk/crates/shadow-driver/src/main.rs
  • credible-sdk/crates/shadow-driver/src/listener.rs

State Checker​

credible-sdk/crates/state-checker validates the MDBX state cache by recalculating a state root and comparing it with stored block metadata.

Key files:

  • credible-sdk/crates/state-checker/src/main.rs
  • credible-sdk/crates/state-checker/src/state_root.rs

Integration Test Utilities​

credible-sdk/crates/int-test-utils provides helpers for integration testing (contract deployments, chain setups).

Dapp API Client​

credible-sdk/crates/dapp-api-client is a Rust client generated from the dApp OpenAPI spec. It is used by the sidecar Transaction Observer to report incidents and can be reused by other services.