Skip to content
New

DeepSeek V4.1 Flash free for 7 days: 10M tokens a day after a top-up of $10 or more. Until Nov 30.

How it works
aeondave/restlerReverse engineering and fuzzing

restler

⁨Auth/lab ref: Stateful REST API fuzzer from OpenAPI specs. For testing complex API dependency chains, producer-consumer request sequencing, and replayable bug-bucket workflows for API reliability/security testing.⁩

v2026.11.13-21cd5683 installs+3 in 7 days39 StarsMITsynced 11 hours ago

Install

No NotHoly CLI yet? Install it first.

$ curl -fsSL https://notholy.com/install.sh | sh
$ notholy skills install aeondave/restler

Writes to ⁦~/.notholy/skills⁩ after checking the signature and the SHA-256.

SignatureSigned, ed25519
WsRFhK4QLp…nBq3fjBg==The CLI checks the SHA-256 and the signature before it writes a file.
Package5ca93d77…5f6c3e2d
5ca93d771b72…bb4d5f6c3e2d1 file · ⁦1.5 KB⁩
ScanLow1 finding
  • Links to outside domains
See the full scan
Sourcegithub.com/AeonDave/malskill/tree/main/offensive-tools/fuzzing/restler@21cd568

RESTler explores deeper API states by inferring request dependencies from OpenAPI definitions.

  1. Compile: OpenAPI -> RESTler grammar.
  2. Test (smoke): verify setup and required dictionary values.
  3. Fuzz-lean: quick bug hunting baseline.
  4. Fuzz: deep BFS-style state exploration.

Quick Start

bash
# Build (local)
python build-restler.py --dest_dir <restler_bin>

# Typical campaign starts with compile + test before fuzz modes
restler.exe fuzz-lean --grammar_file <grammar.py> --dictionary_file <dict.json>
restler.exe fuzz --grammar_file <grammar.py> --dictionary_file <dict.json> --time_budget 1

Operator Flow

  1. Validate schema quality and authentication path first.
  2. Run test/smoke style workflow to confirm dependencies and dictionary values.
  3. Run fuzz-lean for quick risk discovery.
  4. Run fuzz for deeper sequence exploration with settings file tuning.
  5. Reproduce via replay logs and bug buckets before assigning fixes.

Practical Notes

  • Always fix setup gaps discovered in test mode before deep fuzzing.
  • Deep fuzzing can cause service instability/outages on weak implementations.
  • Use replay logs and bug buckets for deterministic re-validation.

High-Value Settings

  • fuzzing_mode (bfs, bfs-cheap, random-walk, directed-smoke-test)
  • max_sequence_length, max_combinations
  • include/exclude endpoint filters (include_requests, exclude_requests, path_regex)
  • retry & timing controls (custom_retry_settings, producer_timing_delay)
  • trace database (use_trace_database) for structured replay workflows

Replay & Triage Pattern

  1. Start from bug_buckets.txt summary.
  2. Open specific bucket replay log and verify request sequence.
  3. Replay with same auth/host settings.
  4. Confirm reproducibility and collect minimal sequence evidence.
  5. Patch server + rerun replay to verify closure.

Common Pitfalls

  • Skipping auth refresh handling leads to noisy false negatives.
  • Fuzzing full API surface without scope controls can burn time-budget quickly.
  • Forgetting manual cleanup after replay-created resources.

Resources

Files in this version

Permissions

PermissionDeclaredFound by the scan
Reads filesNoNo
Writes filesYesYes
Runs shell commandsYesYes
Uses the networkYesYes
Uses connectorsNoNo
Drives a browserNoNo

Scan findings

Reviewed on Nov 13, 2026

  1. InfoLink · Links to outside domains

A clean scan lowers the risk but does not prove a package is safe. Read what you install.

VersionPublishedCommitSHA-256SignaturePermission change
v2026.11.13-21cd568Nov 13, 202621cd5685ca93d77Signed–

Ask anything your scope allows.

Create an account, add credits and ask the first question in the chat or the terminal.

  1. 1/3

    Create the account

    Individual or company. You can switch to a company later without losing balance or keys.

    IndividualCompany
  2. 2/3

    Add credits

    By card. Pay per token, no subscription.

    $5.00minimum deposit
  3. 3/3

    Ask

    In the chat, or install the CLI and run notholy login in your terminal.

    $ notholy login