How adoemwanmei/darksword-prov2 works
DarkSword combines an iOS exploit-delivery server and payload chain with a separate web-based operations console. The documented device workflow runs from Safari delivery through RCE, sandbox escape, privilege escalation, and post-exploitation; the console manages devices, commands, and collected data. The CLI configures the delivery service, while the admin API exposes management functions backed by SQLite and a Vue interface. Several payload and admin subsystems are represented from README descriptions or the source index rather than inspected implementations, so those links are documented rather than inferred from names.
Main entry points: main.py Admin API app · server.py HTTP delivery server · database.py SQLite data store · App.vue Admin web UI
Components 28
Delivery service
- CLI
darksword/cli.py - Server configuration
darksword/config.py - Payload selection
darksword/payloads.py - HTTP delivery server
darksword/server.py
Device payload stages
- RCE loader
payloads/rce_loader.js - RCE modules
payloads/rce_module.js - RCE workers
payloads/rce_worker.js - Sandbox escape
payloads/sbx1_main.js - Privilege escalation
payloads/pe_main.js - Post-exploitation
payloads/post_exploit.js
Admin API
- Admin API app
admin/main.py - Authentication routes
admin/routers/auth.py - Device routes
admin/routers/devices.py - Command routes
admin/routers/commands.py - Exfiltration routes
admin/routers/exfil.py - Other API routes
admin/routers - Authentication logic
admin/auth.py
Admin data
- SQLite data store
admin/database.py - API schemas
admin/schemas.py
Admin console
- Admin web UI
admin/frontend/src/App.vue - UI authentication
admin/frontend/src/stores/auth.js - API client
admin/frontend/src/utils/axios.js - Device management
admin/frontend/src/views/Devices.vue - Dashboard
admin/frontend/src/views/Dashboard.vue - Data and wallets
admin/frontend/src/views/Wallets.vue
Other components
- Operator
- iOS Safari user
- C2 service
Connections 36
- Operator → CLI: runs
README.md - CLI → HTTP delivery server: starts
darksword/cli.py - CLI → Server configuration: loads
darksword/cli.py - CLI → Payload selection: uses
darksword/cli.py - iOS Safari user → HTTP delivery server: requests payload
README.md - HTTP delivery server → RCE loader: serves
README.md - RCE loader → RCE modules: selects by version
README.md - RCE loader → RCE workers: creates worker
README.md - RCE modules → Sandbox escape: precedes
README.md - Sandbox escape → Privilege escalation: precedes
README.md - Privilege escalation → Post-exploitation: precedes
README.md - Post-exploitation → C2 service: uploads data
README.md - Post-exploitation → C2 service: polls commands
README.md - C2 service → HTTP delivery server: receives uploads
README.md - Admin API app → Authentication routes: registers
admin/main.py - Admin API app → Device routes: registers
admin/main.py - Admin API app → Command routes: registers
admin/main.py - Admin API app → Exfiltration routes: registers
admin/main.py - Admin API app → Other API routes: registers
admin/main.py - Admin API app → SQLite data store: initializes
admin/main.py - Authentication routes → Authentication logic: authenticates
admin/routers/auth.py - Authentication routes → SQLite data store: reads and writes
admin/routers/auth.py - Device routes → SQLite data store: reads and writes
admin/routers/devices.py - Command routes → SQLite data store: reads and writes
admin/routers/commands.py - Exfiltration routes → SQLite data store: reads and writes
admin/routers/exfil.py - HTTP delivery server → SQLite data store: shares device state
darksword/server.py - Admin web UI → UI authentication: uses
admin/frontend/src/App.vue - UI authentication → API client: calls
admin/frontend/src/stores/auth.js - Device management → API client: calls
admin/frontend/src/views/Devices.vue - Dashboard → API client: calls
admin/frontend/src/views/Dashboard.vue - Data and wallets → API client: calls
admin/frontend/src/views/Wallets.vue - Admin web UI → Device management: routes to
- Admin web UI → Dashboard: routes to
- Admin web UI → Data and wallets: routes to
- Device routes → Command routes: device commands
- HTTP delivery server → Admin API app: registers devices
darksword/server.py