Skip to content

docs: Write security model documentation covering threat actors and mitigations #652

Description

@FaveTeamz

Summary

The project handles cryptographic key authorization and on-chain state transitions with financial implications. There is no documented security model describing threat actors, attack surfaces, mitigations, and residual risks.

Problem

Without a formal security model, contributors and auditors cannot quickly assess whether a proposed change introduces new attack vectors. Security reviewers must reconstruct the threat model from source code.

Acceptance Criteria

  • Create docs/security-model.md covering:
    • Threat actors: malicious contributors, rogue maintainers, compromised admin keys
    • Attack surfaces: API endpoints, contract function calls, Horizon node trust
    • Mitigations: rate limiting, signature verification, cap enforcement, WAF
    • Residual risks: Stellar network downtime, Horizon RPC compromise
  • Include a data flow diagram showing where auth checks occur
  • Reference specific error codes from docs/error-reference.md where relevant
  • Link from the README security section

Metadata

Metadata

Assignees

Labels

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions