Skip to content

feat: aztec_network_status tool for local sandbox/node reachability (#1) - #27

Open
AnubisQuantumCipher wants to merge 1 commit into
AztecProtocol:mainfrom
AnubisQuantumCipher:feat/local-network-status
Open

feat: aztec_network_status tool for local sandbox/node reachability (#1)#27
AnubisQuantumCipher wants to merge 1 commit into
AztecProtocol:mainfrom
AnubisQuantumCipher:feat/local-network-status

Conversation

@AnubisQuantumCipher

Copy link
Copy Markdown

Summary

Implements #1: an MCP tool that makes checking local network / sandbox status a single tool call.

aztec_status already reports cloned repository state. This PR adds aztec_network_status, which probes live RPC endpoints (PXE / node / L1) and returns:

  • overall ready | degraded | down
  • per-endpoint reachability, latency, HTTP status
  • role-aware JSON-RPC method fallthrough (Aztec method names evolve; agents still get a useful signal)
  • agent-branchable error taxonomy (unreachable, timeout, method_not_found, …)
  • full JSON blob in the tool response for structured consumption

Defaults: http://127.0.0.1:8080 (PXE), :8081 (node), :8545 (L1). Override with urls / roles / timeoutMs.

Test plan

  • npm test — 312 tests pass (includes 6 new network-status tests with mocked fetch)
  • npx tsc --noEmit clean
  • Manual: with sandbox down → overall: down
  • Manual: with sandbox up → PXE/node/L1 report reachable where applicable

Notes

Happy to adjust default ports / method lists to match whatever the current sandbox surface is — the structure is intentionally fail-soft.

Implements issue AztecProtocol#1: MCP tool-callable local network status distinct from
aztec_status (cloned repos). Probes PXE/node/L1 with role-aware JSON-RPC
fallthrough, ready|degraded|down overall status, latency, and agent-branchable
error taxonomy. Includes vitest coverage.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant