Skip to content

docs: overhaul README with architecture diagram and protocol guide - #116

Merged
EmeditWeb merged 1 commit into
mainfrom
docs/readme-overhaul
Sep 28, 2026
Merged

EmeditWeb merged 1 commit into
mainfrom
docs/readme-overhaul

Conversation

@EmeditWeb

Copy link
Copy Markdown
Member

Summary

Rewrites the README into a standard, detailed protocol guide and adds an embedded system-architecture diagram showing where the contracts sit in StepFi (clients/API → contracts on Stellar). Adds a per-contract responsibility table, the score→APR→limit credit model, canonical testnet addresses with explorer links, a security/governance summary, per-crate test counts, and a roadmap. The contributor-leaderboard block and its LEADERBOARD_START/END markers are preserved so the leaderboard workflow keeps working. Adds an MIT LICENSE.

Docs/assets only — no contract code changed.

Type of change

  • Other: documentation

Testing

  • cargo build unaffected (no Rust changed) — verified by CI
  • cargo test unaffected — verified by CI

Notes

  • New asset: docs/architecture.svg (hand-authored, GitHub-rendered).
  • Corrects prior inaccuracies: reputation is a 0–100 score with APR/limit brackets (not named tiers), and the suite now has 420 tests.

…uide

Rewrite the README into a standard, detailed guide: what StepFi is and
where the contracts fit, a per-contract responsibility table, the
score-based credit model (APR/limit brackets), contract-interaction
overview, canonical testnet addresses with explorer links, security &
governance summary, build/test instructions with per-crate test counts,
CI/CD and roadmap. Add an embedded SVG architecture diagram and an MIT
LICENSE. The contributor-leaderboard block and its markers are preserved
so the leaderboard workflow keeps updating.
@EmeditWeb
EmeditWeb merged commit 43da5d8 into main Sep 28, 2026
2 checks passed
@EmeditWeb
EmeditWeb deleted the docs/readme-overhaul branch September 28, 2026 15:08
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