# solidity repl
[![npm version](https://img.shields.io/npm/v/solidity-repl.svg)](https://npmjs.org/package/solidity-repl)
[![Build Status](https://travis-ci.org/raineorshine/solidity-repl.svg?branch=master)](https://travis-ci.org/raineorshine/solidity-repl)

![REPL Screenshot](https://raw.githubusercontent.com/raineorshine/solidity-repl/master/screenshot.png)

## Installation

```sh
# requires local RPC client
$ npm install -g ganache-cli

# install
$ npm install -g solidity-repl
```

Dependending on your permissions, you may need a bigger hammer:

```
sudo npm install -g solidity-repl --unsafe-perm=true --allow-root
```

## Usage

```sh
# Run RPC client on port 8545
$ ganache-cli

$ solr
Welcome to the Solidity REPL!
> uint a = 10
> uint b = 20
> a + b
30
> msg.sender
0x2f42491c0a08e4bc0cd3d5a96533a69727e16911
```

## Help Wanted

Here are some features that are great candidates for pull requests! Start an issue to let me know you are working on it.

1. Make it work in the browser!
2. Fix `1 ether`
3. Fix `this`
4. Add support for function declarations.
5. Add up and down arrow

# Developer Notes

- bignumber.js is included because it is missing from a dependency

## License

ISC