Skip to content

Repository files navigation

SorobanShield

SorobanShield is an open, local-first security and audit-preparation MVP for Soroban Rust contracts on Stellar. It gives developers fast, explainable review points for authorization, storage, cross-contract calls, and arithmetic before testnet or mainnet deployment.

Repository: github.com/Ekpemark/sorobanshield
Live Application Demo: sorobanshield.vercel.app

Security notice: SorobanShield is audit preparation tooling, not a professional security audit or a guarantee that a contract is safe.

🎬 Demo Video

SorobanShield Demo Video

▶️ Watch the demo: YouTube Shorts - SorobanShield Demo

Run locally

Prerequisite: Node.js 20+.

npm.cmd install
npm.cmd run dev

Then open http://localhost:3000. The app works fully in-browser: paste a Soroban Rust contract, run the heuristic scan, and download a Markdown security report.

Current MVP coverage

  • 10 Soroban-specific security rules covering authorization (require_auth), persistent storage lifecycle, TTL extension, cross-contract calls, unchecked arithmetic, unwrap()/expect() panic risks, explicit panic!, hardcoded addresses, dynamic Symbol::new allocations, and unauthenticated event publishing.
  • Interactive Contract Presets: Switch instantly between Unsafe Vault, DeFi Swap, and Secure Vault (Clean Soroban Contract).
  • Audit Readiness Reports: Exportable Markdown reports with severity tags, exact source line numbers, evidence snippets, and actionable remediation steps.

Grant-ready project evidence

The current scope is an execution-ready 30-day Instaward sprint. It does not claim users, audits, integrations, or vulnerability prevention outcomes that have not yet been independently verified.

Next milestones

See docs/GRANT_REQUIREMENTS.md for the current SCF eligibility check and docs/INSTAWARD_APPLICATION.md for the $5,000, 30-day request. The public grant landing page is available at /grant.

About

AI-powered security review and audit preparation platform for Soroban smart contracts. Automated vulnerability detection, AI-assisted code review, audit reporting, and CI/CD security checks for the Stellar ecosystem.

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages