whatisgithub

What is contract-auditor?

nursca/contract-auditor — explained in plain English

Analysis updated 2026-05-18

0HTMLAudience · developerComplexity · 3/5Setup · moderate

In one sentence

An AI-assisted scanner that reads pasted Solidity code and returns a ranked report of security vulnerabilities in seconds.

Mindmap

mindmap
  root((Contract Auditor))
    What it does
      Scans Solidity contracts
      Ranks findings by severity
      Gives risk score
    Tech stack
      Next.js
      TypeScript
      Tailwind
      Claude API
    Use cases
      Pre audit check
      Catch payment bugs
      Learn contract risks
    Audience
      Solidity developers
      Hackathon builders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Paste a Solidity contract before deploying it to catch common vulnerabilities early.

USE CASE 2

Get a quick risk score to prioritize which contracts need a deeper manual audit.

USE CASE 3

Spot payment or refund logic errors that plain rule based scanners tend to miss.

What is it built with?

Next.jsTypeScriptTailwindClaude APIVercel

How does it compare?

nursca/contract-auditor100/rutgers-pbl-dining-2015a15n/a15n_old
Stars0
LanguageHTMLHTMLHTML
Last pushed2015-12-012016-06-18
MaintenanceDormantDormant
Setup difficultymoderateeasyeasy
Complexity3/51/51/5
Audiencedevelopergeneralgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Node.js 18+ and a paid Anthropic API key to run the AI analysis locally.

No license information is stated in the README.

So what is it?

Contract Auditor is a tool that checks Solidity smart contracts for security problems. Solidity is the programming language used to write smart contracts, the code that runs on blockchains like Ethereum. A user pastes their contract code into the app and within about fifteen seconds gets back a report listing any vulnerabilities found, ranked by how serious they are. The tool combines two different checking methods. First, a set of seven fixed rules looks for well known problems such as reentrancy attacks, unchecked external calls, missing access control, and unbounded loops. Second, an AI model reviews the same code looking for logic mistakes in payment or refund calculations that the fixed rules would not catch on their own. Both checks run at the same time rather than one after another, which keeps the wait short. If the AI check fails or takes too long, the app still shows the results from the fixed rule checks instead of failing outright. Findings are sorted from critical down to informational, and the report includes an overall risk score out of 100. When both the fixed rules and the AI model flag the same issue, it is marked as a higher confidence finding. The app does not save or log the contracts people submit, so nothing pasted into it is stored afterward. The project is built with Next.js, TypeScript, and Tailwind for the interface, and it calls the Claude API to power the AI portion of the analysis. It is meant to run as a web app deployed on Vercel, and setup requires Node.js and an Anthropic API key. Right now it only checks one file at a time, has no accounts or saved history, and was built as an entry for a hackathon called the Web3LadiesBuildWithAI Ship It Challenge. The listed next steps include more thorough analysis, checking whole GitHub repos with multiple files, and exporting reports as PDFs.

Copy-paste prompts

Prompt 1
Explain how the reentrancy check in this Contract Auditor project works and how I could add an eighth static rule.
Prompt 2
Help me set up this Next.js project locally and connect my own Anthropic API key to the Claude powered analysis engine.
Prompt 3
Show me how to extend the /api/analyze endpoint so it can accept a GitHub repo URL instead of pasted source.
Prompt 4
Write a test Solidity contract with a deliberate reentrancy bug so I can confirm this auditor catches it.

Frequently asked questions

What is contract-auditor?

An AI-assisted scanner that reads pasted Solidity code and returns a ranked report of security vulnerabilities in seconds.

What language is contract-auditor written in?

Mainly HTML. The stack also includes Next.js, TypeScript, Tailwind.

What license does contract-auditor use?

No license information is stated in the README.

How hard is contract-auditor to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is contract-auditor for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.