Skip to content

ChasmHQ/chasm

Repository files navigation

Chasm

Chasm is an all-in-one development and security tool for smart contracts. It is designed to bridge the gap between writing code and analyzing it, providing a unified interface that combines the best features of Remix, Postman, and Foundry.

Note: This project is still in the prototyping phase, so any feedback is welcome. It might contain a lot of bugs.

Just as Burp Suite is essential for web security and Postman for API testing, Chasm provides a workspace for blockchain developers and security researchers to interact with, debug, and audit contracts in a structure-agnostic environment.

Screenshots

Contract workspace Transaction trace Storage inspector Blockchain explorer

Features

Smart Contract Workspace

  • Zero-Config Compilation: Chasm recursively scans the current directory for any Solidity files and recompiles them automatically using foundry-compilers.
  • Persistent Interaction: A tabbed, Postman-style interface allows you to keep multiple function calls open simultaneously. Inputs and responses persist even when switching tabs.
  • Advanced Parameter Control: Support for constructor arguments, ETH value sending (with Wei/Gwei/ETH unit conversion), and manual gas limit overrides.
  • Raw RPC Editor: Toggle between a standard form view and a raw JSON-RPC request editor with syntax highlighting for low-level debugging.

Debugging & Security

  • Visual Transaction Traces: View detailed, colored execution traces for every transaction, similar to Foundry's -vvvv output.
  • Storage Inspector: Read any storage slot directly from the UI, including private variables, mappings, and long strings.
  • Foundry Integration: Built-in support for local simulation using Foundry cheatcodes, embedded Anvil node, easy transaction state revert, and more.

Blockchain Explorer

  • Universal Search: Search for wallet addresses, contract addresses, transaction hashes, or block numbers.
  • Network Dashboard: Real-time view of latest blocks and transactions on the connected network.

Installation

Quick Install (macOS ARM64)

Prerequisites:

  • Foundry: Required for simulation and tracing tools (anvil, cast, forge). Install from getfoundry.sh

Install:

curl -fsSL https://raw.githubusercontent.com/ChasmHQ/chasm/main/install.sh | bash

Or manually:

wget https://raw.githubusercontent.com/ChasmHQ/chasm/main/install.sh
chmod +x install.sh
./install.sh

Uninstall:

curl -fsSL https://raw.githubusercontent.com/ChasmHQ/chasm/main/uninstall.sh | bash

Quick Install (Windows)

Prerequisites:

  • Foundry: Required for simulation and tracing tools (anvil, cast, forge). Install from getfoundry.sh

Install: Run the following command in PowerShell:

iwr -useb https://raw.githubusercontent.com/ChasmHQ/chasm/main/install.ps1 | iex

Uninstall: Run the following command in PowerShell:

iwr -useb https://raw.githubusercontent.com/ChasmHQ/chasm/main/uninstall.ps1 | iex

Build from Source

Prerequisites:

  • Rust: Required to build the backend.
  • Foundry: Required for the underlying simulation and tracing tools (anvil, cast, forge).
  • Node.js: Required to build the UI assets once.

Steps:

  1. Clone the repository:
    git clone https://github.com/ChasmHQ/chasm
    cd chasm
  2. Build the UI and binary:
    • macOS / Linux:
      ./build.sh
    • Windows (PowerShell):
      ./build.ps1
  3. Run Chasm from any Solidity project directory:
    ./target/release/chasm ./contracts
  4. Open the web UI at http://localhost:3000

Usage

Launch Chasm in any folder containing Solidity files by running chasm .. The tool will automatically detect your contracts, allowing you to deploy them to a local node or attach to existing addresses on any network. Use the activity bar to switch between the Contract Workspace and the Blockchain Explorer.


Built for the Ethereum development and security community.

Next development

We will focusing on dynamic analysis to help auditor for debugging the smart contract, like tenderly simulations. It will been show all the stack traces, the reason why it failed. Also will been adding Fund Flow, and Gas Profiler for more clarity in transaction flow. If can will be re-making the revoke feature.

About

No description, website, or topics provided.

Resources

Stars

3 stars

Watchers

1 watching

Forks

Packages

 
 
 

Contributors