Skip to content

Commit 9c18411

Browse files
docs: complete readme with capability and interest areas
1 parent f6eda52 commit 9c18411

1 file changed

Lines changed: 29 additions & 0 deletions

File tree

README.md

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -74,6 +74,35 @@ Intellectual Property Notice: this repository implements parts of the Sovereign
7474
- Economic layer: wallet-aware blockchain state, staking flows, reward path integration
7575
- Operations layer: Prometheus metrics, Grafana dashboards, alerting rules, reproducibility and governance CI gates
7676

77+
## Capability and Function Coverage
78+
79+
| Capability Domain | Primary Runtime Functions | Main Surfaces |
80+
| --- | --- | --- |
81+
| Federated Intelligence | Round coordination, convergence and model quality flow, distributed execution | `internal/convergence/`, `internal/node/`, `simulate-demo.py` |
82+
| Trust and Verification | Proof checks, trust status snapshots, verification policy enforcement | `internal/api/`, `internal/tpm/`, `capabilities.json` |
83+
| Governance and Policy | Proposal execution, policy updates, validator controls | `internal/blockchain/`, `internal/consensus/`, `Documentation/Project/ROADMAP.md` |
84+
| Economic Rails | Wallet-aware ledger, staking and rewards, transaction settlement | `internal/blockchain/`, `docs/RELEASE_NOTES_v1.2.0.md` |
85+
| Observability and Ops | Metrics export, SLO alerts, dashboards, operational checks | `cmd/metrics-exporter/`, `grafana/`, `prometheus.yml` |
86+
| Developer and Client Tooling | SDK package build/test flow, frontend and client integration | `packages/core/`, `packages/privacy/`, `frontend/`, `client/` |
87+
88+
## Areas for Development
89+
90+
1. Proof-system depth: strengthen ZK and hybrid verification backends with broader negative-path and adversarial coverage.
91+
2. Scale confidence: expand staged scale campaigns (10 -> 100 -> 1000+) with repeatable performance baselines.
92+
3. Policy automation: improve governance policy rollout and rollback safety with stronger contract/version migration checks.
93+
4. SDK maturity: add richer end-to-end SDK examples and conformance tests across TypeScript and Python surfaces.
94+
5. Operator hardening: expand production runbooks for incident response, token rotation cadence, and trust-event recovery.
95+
6. Multi-environment reproducibility: tighten parity between local/devcontainer/CI toolchain versions for deterministic outcomes.
96+
97+
## Areas of Interest
98+
99+
1. Byzantine resilience under mixed proof modes and changing trust assumptions.
100+
2. Reward fairness linked to verification confidence and real contribution quality.
101+
3. Attestation-aware scheduler strategies for secure model participation.
102+
4. Privacy-preserving aggregation and model update integrity in heterogeneous hardware environments.
103+
5. Explainable governance outcomes with auditable policy-to-behavior traceability.
104+
6. Cost-efficient observability for long-running, large-node federated deployments.
105+
77106
## Quick Start
78107

79108
### Prerequisites

0 commit comments

Comments
 (0)