Skip to content

Comments

docs: add security model documentation#24

Merged
phertyameen merged 1 commit intobridgelet-org:mainfrom
Cedarich:docs/add-security-model
Jan 30, 2026
Merged

docs: add security model documentation#24
phertyameen merged 1 commit intobridgelet-org:mainfrom
Cedarich:docs/add-security-model

Conversation

@Cedarich
Copy link

Description

This PR adds the docs/security.md file to document the security model of the Bridgelet Core system. It covers the threat model, authorization mechanisms, security guarantees, and best practices for integrators.

Changes

  • Created docs/security.md.
  • Documented key threat vectors:
    • Unauthorized Sweeping.
    • Double Spending / Replay Attacks.
    • Expiration Bypass.
    • Malicious Initialization.
  • Detailed the layered authorization model (Creator for Init, Ed25519 for Sweep, Public for Expiry).
  • Highlighted critical limitations, specifically the current lack of signature verification in EphemeralAccount::sweep (must use SweepController).

Checklist

  • Documentation created.
  • Threat model defined.
  • Authorization flows explained.
  • Limitations disclosed.

close #10

Copy link
Contributor

@phertyameen phertyameen left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Short and concise is all that's needed. cool!

@phertyameen phertyameen merged commit 49b77ed into bridgelet-org:main Jan 30, 2026
1 check passed
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.

Create Security Model Documentation

3 participants