Skip to content

feat: Starknet RPC healthcheck probing logic #4013

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
haiyuechen-nearone merged 9 commits into from
Aug 4, 2026
Merged

feat: Starknet RPC healthcheck probing logic #4013

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
0b90bee
feat(starknet): probe RPC providers for the chain identity they serve
haiyuechen-nearone Jul 30, 2026
ff07a2c
fix(starknet): tell a provider's refusal apart from an unreachable one
haiyuechen-nearone Jul 30, 2026
1b8799a
style(starknet): hoist the classifier's imports to module scope
haiyuechen-nearone Jul 30, 2026
aefb0c4
fix(starknet): scope the identity check to the chains that have a probe
haiyuechen-nearone Jul 31, 2026
17cd361
fix: follow the config field rename in the probe
haiyuechen-nearone Jul 31, 2026
169ad01
refactor: adopt the network fingerprint vocabulary in the probe
haiyuechen-nearone Jul 31, 2026
7205b97
docs(probe): tighten the comments and name the classify pair symmetri…
haiyuechen-nearone Jul 31, 2026
29221d9
test(starknet): collapse the chain id canonicalization cases
haiyuechen-nearone Jul 31, 2026
693b5cf
refactor(probe): tighten comments and move the classification tests i…
haiyuechen-nearone Aug 4, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions Cargo.lock
View file
Open in desktop

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

4 changes: 3 additions & 1 deletion crates/foreign-chain-health-check/Cargo.toml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,15 +14,17 @@ clap = { workspace = true, optional = true }
foreign-chain-inspector = { workspace = true }
foreign-chain-rpc-auth = { workspace = true }
foreign-chain-rpc-interfaces = { workspace = true }
futures = { workspace = true }
hex = { workspace = true }
http = { workspace = true }
mpc-node-config = { workspace = true }
near-mpc-bounded-collections = { workspace = true }
near-mpc-contract-interface = { workspace = true }
tokio = { workspace = true }

[dev-dependencies]
assert_matches = { workspace = true }
httpmock = { workspace = true }
near-mpc-bounded-collections = { workspace = true }
serde_json = { workspace = true }

[lints]
Expand Down
12 changes: 9 additions & 3 deletions crates/foreign-chain-health-check/src/lib.rs
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,10 @@
//! Foreign-chain RPC provider health checks: probe every configured provider
//! with a fixed golden request and report a per-provider result. Sui is the
//! exception — see `run_sui`.
//! Foreign-chain RPC provider health checks, in two independent routes:
//!
//! * [`check_all_providers`] replays a fixed golden transaction per chain.
//! * [`probe::probe_all_providers`] asks each provider for the network it serves and compares that
//! against the operator's configured expectation.

pub mod probe;

@netrome netrome Aug 4, 2026

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Made me think of https://linux.die.net/man/8/modprobe 😅


mod checks;
mod golden;
Expand Down Expand Up @@ -35,6 +39,8 @@ use crate::golden::{AptosVector, BlockHashVector, SuiVector};
/// Chains with no reference for `network`, or configured but unsupported, are
/// [`Status::Skipped`]; a chain absent from the config still yields a single
/// placeholder `Skipped` result so its absence stays visible.
///
/// TODO(#3969): retire this route in favour of [`probe::probe_all_providers`].
pub async fn check_all_providers(
fc: &ForeignChainsConfig,
network: Network,
Expand Down
Loading
Loading