Skip to content

Reddio Sidecar Integration Overview

Reddio’s EVM engine and Sidecar collaborate via a multi‑tiered protocol to enable seamless integration between on‑chain contracts and off‑chain services.

1. Modular Architecture

Key components include:

  • Sequencer RPC Layer
    Queues L2 transactions and forwards external call tasks (with requestId and current state root) to Sidecar via JSON‑RPC.

  • State Exporter
    Captures and packages an on‑chain snapshot—Merkle root, account states, and execution context—whenever a precompile invocation occurs.

  • Sidecar Scheduler
    Orchestrates concurrency controls, rate limiting, and priority queues with auto‑scaling support to maintain stability during traffic spikes.

  • Data Integrity Checker
    Before applying results on‑chain, verifies signatures, timestamps, and contextual consistency to ensure payload authenticity.

2. Advanced Security Model

  • Multi‑Sig Attestation
    Optional threshold signature scheme requiring n‑of‑m Sidecar instances to sign, mitigating single‑point forgery.

  • HSM Integration
    Sidecar private keys reside in an HSM, with scheduled rotation and tamper‑proof audit logs.

  • Selective Data Exposure
    Sensitive endpoints can return only hash commitments; on‑chain logic verifies actual payloads via Merkle proofs.

3. Observability & Monitoring

  • Metrics Export
    Built‑in Prometheus metrics covering request latency histograms, signature verification duration, error rates, and cache hit ratios.

  • Structured Logging
    Every call emits events with request_id, state_root, response_hash, and execution duration—ingestible by ELK or Loki stacks.

  • Alerting Policies
    Configurable alerts on failure spikes, timeouts, and queue backlogs with integrations for PagerDuty, Slack, etc.

4. Gas & Performance Trade‑offs

  • Batching Calls
    Multiple external requests can be aggregated into one precompile invocation, amortizing verification costs.

  • Hierarchical Caching
    Support in‑memory, on‑disk, and edge caching layers to accelerate access to hot data (e.g., market prices, metadata) and minimize redundant network I/O.