command line

sbt-ethereum offers a text-based user interface to the ethereum blockchain. You work with it from a “terminal” or “command prompt” window. On a Mac or Linux, run the Terminal application to get started. On Windows, you can use “Windows Power Shell”, or if you are old-school, CMD.exe. You can also use the version of “bash” that comes with some versions of Windows git.

java 8 runtime

To work with sbt-ethereum, you’ll need a Java 8 runtime installed on your computer. To see whether you already have this installed, type

$ java -version

You should see something like

java version "1.8.0_172"
Java(TM) SE Runtime Environment (build 1.8.0_172-b11)
Java HotSpot(TM) 64-Bit Server VM (build 25.172-b11, mixed mode)

The exact version numbers don’t matter, as long as they begin with “1.8”.

If you do not already have a Java 8 VM installed, you can download it from Oracle here.


In order to download, modify, and publish sbt-ethereum repositories, you will want to have the git command line tool installed as well. You may have it already. Try

$ git --version

If it’s already installed, you’ll see something like

git version 2.18.0

Don’t worry too much about what version you have. It’ll probably be fine.

If it is not installed, you can download it from here. Alternatively, on a Mac it comes with X Code Command Line Tools (you’ll have to sign up for a free developer account), and on Linux, it will be available through your distribution’s package manager (dnf, yum, apt, etc.).


sbt-ethereum is based on a command-line development tool called sbt. Many sbt-ethereum distributions include sbt launch scripts for Mac or Linux, so it is not strictly necessary to download sbt seprately. But it doesn’t hurt. And on Windows it is necessary.

You can download sbt here.

etherscan API key (optional)

To interact with deployed ethereum smart contracts, it is usually necessary to have an ABI (application binary interface) that describes what users can do with the contract. The on-line service etherscan collect the source code and ABI of deployed ethereum contracts, and verifies that they match the applications actually deployed on the blockchain. sbt-ethereum can automatically import these verified ABIs into its internal database, so that it is very easy to interact with deployed, verified, smart contracts.

To get an etherscan API key, you’ll need to create an account, then click on “MY ACCOUNT”, then “API-KEYs” under the “Developers” menu. Finally click “Create Api Key”. Later [TK] we’ll see how to import this key into your sbt-ethereum database, which will make it extremely easy to work with published smart contracts.