Debug Trace Service (invalidating-trace)

Home · Generic Index · Chain Overlays

This document describes the Foundry tracer service in invalidating-trace and how the dApp integrates with it.

Tracer Architecture

Trace Request Flow

Security and Correlation

• Bidirectional API keys:
  • TRACER_SERVICE_API_KEY is used by the dApp to authenticate to the tracer.
  • TRACER_API_KEY_* are accepted by the dApp to authenticate tracer callbacks.
  • TRACER_CALLBACK_API_KEY is used by the tracer when calling the dApp.
• Correlation: debug_trace_id is embedded in the callback URL query string; tracer is intentionally stateless and does not parse it.

Key Files

• Tracer service: invalidating-trace/index.ts
• Tracer contract/interface docs: invalidating-trace/README.md
• Integration spec: invalidating-trace/docs/tracer-integration-prd.md
• dApp tracer request: credible-layer-dapp/packages/inngest/src/functions/tracer-request.ts
• dApp tracer callback router: credible-layer-dapp/packages/dapp-api/src/v1/routers/tracer/