Practical overview
When it fits
Use it when you want a command-line Solidity workspace for quick evaluation or focused contract inspection, including a documented fork-mode workflow for reading contract storage.
Who it is for
- Solidity developers who want to evaluate expressions and define contracts or functions in an interactive session.
- Developers investigating contract interfaces, bytecode, opcodes, storage layout, or storage through a Ganache-backed provider.
Documented uses
- Evaluate Solidity expressions and inspect returned values in a REPL.
- Save, restore, undo, or reset interactive sessions.
- Select a Solidity compiler version through a pragma that attempts to load a matching remote compiler.
- Fetch an interface declaration from an Etherscan ABI specification and use it in the shell.
- Inspect contract bytecode, opcodes, storage layout, or storage, including storage on a fork.
Requirements & limits
The repository provides the npm installation command `npm install -g solidity-shell`.
- The tool is a CLI REPL rather than a general-purpose code editor.
- Compiler versions are selected by pragma, with matching remote compiler loading attempted by the shell.
- Ganache is part of the documented session workflow; fork use requires a fork URL.
- The README warns against concurrent shells when relying on previous-session restoration or saved settings.
- HTTPS URL imports are described as experimental.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Install and start the Solidity Shell
Install the npm package globally and open an interactive Solidity session.
Before you start
- A command-line environment with npm available.
Steps
Run the command below.
npm install -g solidity-shellRun
solidity-shellfrom a command prompt.Enter Solidity expressions or declarations; use
.helpfor shell commands and.exitto leave.
Expected outcome
An interactive Solidity session in which Solidity input can be evaluated.
Guide limitations
- The README shows the shell starting a temporary Ganache instance.
- The guide does not establish compatibility with particular operating systems or npm versions.
Inspect contract storage on a Ganache fork
Display storage slots for a contract at the latest block in fork mode.
Before you start
- Solidity Shell installed and runnable from a command line.
- A fork URL, such as the documented Infura-style URL with an API token.
- A contract address and storage slot range to inspect.
Steps
Start the shell with
solidity-shell --fork.At the prompt, run
.inspect storage 0 10to request storage beginning at slot 0 for 10 slots.
Expected outcome
The shell displays contract storage for the requested range, as illustrated for the latest block.
Guide limitations
- The example relies on a fork provider URL; the README does not establish provider availability or access terms.
- The documented example covers a storage read, not contract deployment or transaction execution.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 17 October 2026
- Original website title
- tintinweb/solidity-shell · Official homepage title · retained in its source language

