How s0md3v/bolt works
Bolt is a command-line CSRF scanner. Its main workflow crawls a target, evaluates discovered forms and tokens, compares tokens for replay or similarity signals, observes token generation under concurrent requests, actively probes protection, and analyzes token randomness. The CLI coordinates the scan; crawling, HTTP access, form parsing, and token-analysis helpers provide internal layers. Several phase relationships are documented in the README, while source excerpts show selected helper calls; unsampled implementation details are not inferred.
Main entry points: bolt.py Scan coordinator · photon.py Site crawling · requester.py HTTP requests · evaluate.py Form evaluation
Components 18
Scan workflow
- Scan coordinator
bolt.py - Site crawling
core/photon.py - Form evaluation
core/evaluate.py - Token comparison
bolt.py - Token observation
bolt.py - Active protection tests
bolt.py - Randomness analysis
core/entropy.py
Crawling and forms
- HTTP requests
core/requester.py - HTML form parser
core/zetanize.py - Test form data
core/datanize.py
Token checks
- Token mutation
core/tweaker.py - Hash patterns
db/hashes.json
Shared support
- Token rules
core/config.py - Token utilities
core/utils.py - Header input
core/prompt.py - Crawl URL helpers
core/utils.py
Other components
- Scanner user
- Target website
Connections 21
- Scanner user → Scan coordinator: starts scan
README.md - Scan coordinator → Site crawling: crawls target
README.md - Site crawling → Target website: requests pages
core/photon.py - Site crawling → HTTP requests: fetches pages
core/photon.py - Site crawling → HTML form parser: parses forms
core/photon.py - Site crawling → Crawl URL helpers: normalizes URLs
core/photon.py - Scan coordinator → Form evaluation: evaluates forms
README.md - Scan coordinator → Token comparison: compares tokens
README.md - Token comparison → Hash patterns: matches patterns
bolt.py - Scan coordinator → Token observation: observes generation
README.md - Scan coordinator → Active protection tests: tests protection
README.md - Active protection tests → Test form data: prepares form data
bolt.py - Active protection tests → Token mutation: mutates tokens
bolt.py - Active protection tests → HTTP requests: submits probes
bolt.py - Scan coordinator → Randomness analysis: analyzes tokens
README.md - HTML form parser → Target website: parses responses
- Test form data → Token rules: uses token rules
core/datanize.py - Form evaluation → Token utilities: checks strength
core/evaluate.py - Token mutation → Token rules: uses token pattern
core/tweaker.py - HTTP requests → Target website: sends requests
core/requester.py - Header input → Scan coordinator: supplies headers
bolt.py