About this project

SovereignKit is an open-source toolkit for measuring, explaining, and routing around Solana transaction-accessibility failures. It distinguishes RPC acknowledgment from ledger observation, using an explicit observation quorum of logical readers. Components include a telemetry core with append-only events and deterministic timelines, a probe engine that creates matched transaction pairs and signed results, a loopback-only hostile proxy for controlled interventions, a validating idempotent collector, an analysis engine with windows and Wilson intervals, an SDK for bounded primary/fallback routing with TTL, hysteresis, developer override and fail-open behavior, and a static read-only dashboard. In an accepted controlled experiment, 10 matched program pairs produced 20 unique signatures, 510/510 compute units per declared class, 600 signed statistical units with 600/600 observer signatures reverified, and a 2/3 quorum across 3 logical readers. Four scenarios (HEALTHY, DEGRADED, ASYMMETRIC, INSUFFICIENT_DATA) were distinguished. Evidence is limited at n=30 per eligible cell; all local readers share one validator and host, demonstrating logical redundancy only. v0.1 is explicitly not a public provider-ranking service, censorship oracle, or decentralized observer network. A Devnet integration validation retained a finalized transaction lifecycle from CREATED to FINALIZED with a finalized 1,000,000-lamport recipient balance. A reproducible public experimental report freezes controlled and Devnet evidence with canonical JSON, CSV, and SHA-256 provenance. The project ships under Apache-2.0, with methodology, threat model, and reproduction guides included.