Ethel is a framework I’m working on for writing smart contracts in solidity along with a testing framework in golang. In this tutorial I’m going to walk you though deploying a custom token to the Ethereum blockchain.

First we’ll need install the Mac OSX build tool Homebrew:

/usr/bin/ruby -e "$(curl -fsSL"

and then install golang:

brew install go

I’m developing ethel based off of the go-ethereum 1.5 API which isn’t out yet. To use that version you’ll have to check it out manually.:

go get
cd $GOPATH/src/
git checkout develop

Now we can install ethel:

go get

And initialize ethel. This will create us an account we can use to deploy our contract from.

ethel init

It’ll ask a few questions. I’d recommend encrypting your live key and not encrypting your testnet key but it’s up to you. Once it’s done it’ll print out your new address and testnet address.

At this point you’ll need to install geth and download the blockchain. Once geth is installed run:

geth --fast --testnet --rpc

While it’s syncing head over to the testnet explorer and click “Get Free Ether” up in the top left. Copy and paste your testnet address that was displayed when you ran ethel init and click “Get Ether”.

Once the testnet blockchain has synced (it might take a few hours) run:

ethel balance --testnet

If you’re impatient you can use my public testnet node for the remainder of the tutorial:

ethel balance --testnet --host=''

Once you see a valid balance you’re ready to deploy! First lets create a new project and cd into it:

ethel new my_token
cd my_token

this should create the following file structure:

├── contracts
│   ├── Token.sol
│   ├── ERC20Token.sol
│   └── token_test.go

Token.sol is a simple ethereum token contract of written in solidarity. Token.sol importants a library ERC20Token.sol which describes a ERC 20 standard token. token_test.go is an example test which tests the transfer function defined in Token.sol. It runs on a simlated blockchain which means it runs quickly and won’t cost ether to run. You can execute the test by running:

ethel test

If everything passes (it should), go ahead and deploy your contract:

ethel deploy --testnet

-> Contract pending deploy: 0x6b143788cbe2fbfdaee4fb7bb8101abe40eb2ef8
-> Transaction waiting to be mined:0x981a0723899230a84bda8a15a3bc90d3873d2f82481d04c919dee97041635fac
-> Deployed Token.
-> Balance: 78 Ether

Copy the “Contract pending deploy” and paste it into the search bar on You should see your contract deployed to the blockchain!

Once you’ve deployed you contract to the testnet blockchain you can try deploying it to the live network! To do this you’ll have to run geth and ethel deploy without the --testnet flag. You’ll also need to fund your account with Ether. The latest version of Mist has a Coinbase integration which allows you to buy Ether with a credit card right inside the app. You can also buy Ether from the Coinbase website or ShapeShift.

Ethel is still in the early prototype phase. If you’re looking for something more stable check out one of these similar projects:

If you have any questions don’t hesitate to reach out.

Thanks for reading!