Skip to main content

Smart contract security scanner — Slither + ML exploitability prediction

Project description

ChainAudit

Smart contract security scanner — Solidity, Solana/Rust, and L2/Arbitrum/Optimism support.

Install

Mac / Linux / Ubuntu

pip install chainaudit
pip install slither-analyzer
pip install solc-select
solc-select install 0.8.24
solc-select use 0.8.24

# Optional — for Solana/Rust scanning
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
cargo install cargo-audit

Windows

Requires Python 3.12. Download from python.org — check "Add Python to PATH" during install. Python 3.13 not yet supported on Windows.

pip install chainaudit
pip install slither-analyzer
pip install solc-select
solc-select install 0.8.24
solc-select use 0.8.24

If on a college/office network, use mobile hotspot for installation.


Usage

chainaudit scan contract.sol               # Solidity file
chainaudit scan program.rs                 # Solana/Rust program
chainaudit scan ./contracts --recursive    # directory
chainaudit scan contracts.zip              # zip archive
chainaudit scan contract.sol --json        # JSON output
chainaudit scan contract.sol --ml-only     # skip simulation
chainaudit --version                       # show version

Exit code 1 if CRITICAL vulnerabilities found — blocks deployments in CI.


GitHub Action

- uses: aizen299/smart-contract-auditor@v1
  with:
    target: contracts/
    fail-on-critical: true

What It Detects

EVM (Ethereum, Polygon, BNB Chain...)

Severity Examples
CRITICAL Reentrancy, Controlled Delegatecall
HIGH Unchecked Token Transfer, Weak Randomness, tx.origin Auth
MEDIUM Timestamp Dependence, Unchecked Send
LOW Missing Zero Check, Missing Events

L2 / Arbitrum / Optimism — auto-detected

Severity Examples
CRITICAL Cross-Chain Replay Attack, Bridge Reentrancy
HIGH L2 Block Number Assumption, Sequencer Dependence, Address Aliasing
MEDIUM Force-Include Griefing, Gas Price Assumption

Solana / Rust

Severity Examples
CRITICAL Missing Signer Check, Arbitrary CPI, Missing Owner Check
HIGH Integer Overflow, Unsafe Rust Code, CPI Reentrancy, Insecure Randomness
MEDIUM Missing Rent Exemption, PDA Seeds Not Validated
LOW Missing Freeze Authority, Deprecated Anchor Patterns

Detected via cargo-audit (CVE scanning) + pattern scanning on .rs source files.


ML Predictions

Each EVM finding includes an ML-predicted exploitability score (SmartBugs dataset, 88% accuracy).

{
  "title": "Reentrancy",
  "severity": "CRITICAL",
  "ml_exploitability": "CRITICAL",
  "ml_confidence": 0.96,
  "chain": "arbitrum"
}

Links

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

chainaudit-1.1.3.tar.gz (30.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

chainaudit-1.1.3-py3-none-any.whl (27.4 kB view details)

Uploaded Python 3

File details

Details for the file chainaudit-1.1.3.tar.gz.

File metadata

  • Download URL: chainaudit-1.1.3.tar.gz
  • Upload date:
  • Size: 30.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.15

File hashes

Hashes for chainaudit-1.1.3.tar.gz
Algorithm Hash digest
SHA256 5c092c812cb6e0524834617c250dbf422b23258fd1c8787cfe09e33022bc8368
MD5 8a57a098460a86844d0b571da9a4c032
BLAKE2b-256 0d5f16810e1c2294490f04bc30f4718e0dd767970b8cb24007ad6d84605f4839

See more details on using hashes here.

File details

Details for the file chainaudit-1.1.3-py3-none-any.whl.

File metadata

  • Download URL: chainaudit-1.1.3-py3-none-any.whl
  • Upload date:
  • Size: 27.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.15

File hashes

Hashes for chainaudit-1.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 df8812dacf008fc5d9d77514b5d77e465c0cb59a4ca17bcfb856ff5988c8c289
MD5 fb3413b5e1a39d3b00b1109b0a27770c
BLAKE2b-256 522a325803d45a3989d233f21c7f6a83f8634d2d341ac94e7639cc77eb149994

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page