Inspiration
Free crypto mints can drain a wallet in one click. Sentinel was built to protect users by refusing unsafe mints — and proving every refusal.
What it does
Sentinel scans free-mint candidates and verifies each one against live on-chain data through a deterministic gate pipeline (verified contract, free phase open, zero cost, value signal, clean preview). The LLM is advisory only — no model output can authorise a transaction. Every run leaves an append-only audit trace, a Markdown report, and a live dashboard. A kill switch halts a run within one tick, and a hostile-input firewall blocks injected instructions from project pages. Built with Kiro (specs, steering, hooks, MCP).
How we built it
Spec-driven development with Kiro, with a deterministic gate pipeline verified against live on-chain data (BSC RPC and Sourcify), an advisory-only LLM, an append-only audit trace, a Markdown report and a live dashboard, a kill switch, and a hostile-input firewall.
How Kiro was used
Spec-driven development from .kiro/specs/sentinel (requirements, design, tasks); steering docs (product/tech/structure) with the rule that the LLM never authorises money movement; sentinel-guard custom agent plus save-hooks that run pytest on every edit (95 tests passing); MCP configured read-only (fetch + sequential-thinking, no credentials); Kiro CLI v3.1.0 logged in (Builder ID, [email protected]) with 1 real agent turn on 13 Nov 2026 that ran pytest (95 passed) and verified the demo. Honest limitation: no MCP server driven live through the CLI yet; 4,000 free Kiro credits not claimed.
Challenges we ran into
Keeping the LLM strictly advisory so no model output can authorise a transaction, verifying each candidate deterministically against live on-chain data, and blocking injected instructions from project pages with the hostile-input firewall.
What we learned
A deterministic gate pipeline plus an append-only audit trace makes every refusal verifiable, and spec-driven development with Kiro keeps the safety rules explicit and testable (95 tests passing).
How to run
git clone https://github.com/JohnyKucel/sentinel-kiroween.git ; cd sentinel-kiroween ; python3 -m venv .venv && source .venv/bin/activate ; pip install -r requirements.txt ; python3 -m sentinel.cli run --candidates fixtures/candidates.json ; python3 -m pytest -q
Built With
- 3.12
- bsc
- kiro
- pytest
- python
- rpc
- sourcify
