Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


See it in action

Go to this page to see the app in action. You need MetaMask to use the application. Get it here. Our site is also hosted on the InterPlanetary FileSystem (IPFS), although it gets quite slow at times you can check our app here

Help us out

Follow the guides below to set up your testing environments, and help improve our contract/frontend!

Live testnet environment (for use in testing in the browser /w MetaMask)

Step 1: Download Geth

First, download the latest geth (1.6.1) to your laptop.

(I did it to my MacBook Air). Extract it and copy the geth binary to somewhere in your path.

Unknown whether Parity works as well. It will probably take some finagling to work with the Geth-style Genesis block.

Step 2: Download genesis block


Step 3: Initialize

At this point, you should probably start a tmux or screen session, so if you get interrupted during syncing it will still keep going in the background.

To run a full node, download rinkeby.json and start Geth with:

geth --datadir=$HOME/.rinkeby init rinkeby.json
geth --networkid=4 --datadir=$HOME/.rinkeby --cache=512 --ethstats='yournode:Respect my authoritah!' --bootnodes=enode://a24ac7c5484ef4ed0c5eb2d36620ba4e4aa13b8c84684e1b4aab0cebea2ae45cb4d375b77eab56516d34bfbd3c1a833fc51296ff084b770b94fb9028c4d25ccf@ --rpc --rpcapi="personal,eth,network"

Note that the credentials here yournode:Respect my authoritah! appear to be necessary. Unknown whether you can create your own creds on so that you can collect your own testnet mining stats :)

SECURITY WARNINGS: We've enabled RPC and also loaded the personal module to allow testing and participating in smart contracts. However, if you do these things on a mainnet node with your unlocked wallet exposed to the internet, you could get hacked and all your monies stolen. I'll write a separate gist about a secure way to participate in a mainnet contract with real ETH.

You can download Geth from

On a MacBook Air with a 10 MBps (standard home internet download speeds), I was able to sync all 187k blocks in < 7 minutes.

Step 4: Create an account

In a separate tmux pane or screen buffer or a separate terminal completely, create an account and save the password somewhere safe.

First, symlink the IPC file so you can geth attach to the existing geth process.

On Linux:

mkdir -p ~/.ethereum
ln -s ~/.rinkeby/geth.ipc ~/.ethereum/

On Mac:

mkdir -p ~/Library/Ethereum
ln -s ~/.rinkeby/geth.ipc ~/Library/Ethereum

After that, attach the console

geth attach

and create an account (substituting a much better password than notmyrealpassword.

Welcome to the Geth JavaScript console!

instance: Geth/v1.6.1-stable-021c3c28/darwin-amd64/go1.8.1
 modules: admin:1.0 clique:1.0 debug:1.0 eth:1.0 miner:1.0 net:1.0 personal:1.0 rpc:1.0 txpool:1.0 web3:1.0

> eth.accounts
> personal.newAccount("notmyrealpassword")
> eth.coinbase
> eth.getBalance(eth.coinbase)

You'll see a different address than 0xb2e9fe08ca9a0323103883fe12c9609ed380f475. That one's mine, provided for illustration. Save your password in a secret place, preferrably encrypted. I use Evernote encrypted text, but you can use any password manager like 1Password, LastPass, Dashlane, etc.

Leave that terminal open for now.

Step 5: Request ETH

Because Kovan and Rinkeby both use Proof-of-Authority (clique) to grant ETH, you'll need to request some to get started. However, unlike Kovan which requires you to bootstrap by requesting KETH from another human being, Rinkeby has a super-slick automated faucet, where you submit your address (copied from above) and submit a public gist.

Go to and create a gist, pasting a single line into it which is your Rinkeby address. Mine looks like this.

Copy the address of the gist, e.g. Go to the Crypto Faucet section of and paste it into the blank.

Choose an option from the dropdown which corresponds to how much Ether you need and how frequently (requesting more Ether will take longer between requests). I requested 3 ETH in 8 hours. Don't worry, you'll get your ETH in seconds, but you can't request again for another 8 hours. This is to prevent spammers from swamping the network by overpowering it with mining power and then out-spending everyone else.

This is the transaction where I received my 3 ETH:

Now, back in your geth console, wait for at most 15 seconds for the next block to be found, and verify your balance again

> eth.getBalance(eth.coinbase)

Woohoo! You're rich, in testnet wei :)

If you found this guide useful, follow us on Twitter at @InvisibleLearn or join us on Slack:

Coupling the rinkeby testnet to run with Embark (No longer necessary, just open index.html in your browser)

Step 1. locating the blockchain.json configuration file:

Clone our project and open it up in your favorite texteditor. We need to change the config file located in SoupCoin/config/blockchain.json

Step 2. changing 'privatenet' in the configuration file:

"privatenet": {
  "enabled": true,
  "networkType": "custom",
  "rpcHost": "localhost",
  "rpcPort": 8545,
  "rpcCorsDomain": "http://localhost:8000",
  "datadir": "$HOME/.rinkeby",
  "networkId": "4",
  "bootnodes": "enode://a24ac7c5484ef4ed0c5eb2d36620ba4e4aa13b8c84684e1b4aab0cebea2ae45cb4d375b77eab56516d34bfbd3c1a833fc51296ff084b770b94fb9028c4d25ccf@",
  "account": {
    "password": "config/rinkebynet/password"

I'll go over the important changes:

  • datadir -> Use the datadir specified earlier in the guide, when you were 'installing' the rinkeby blockchain.
  • networkId -> 4 (standard for rinkeby)
  • bootnodes -> take the bootnode specified in the second command when following the guide
  • account -> I made a rinkebynet directory in config with a password file. In that password file you'll put the password you used when you made your account in the geth console.

Step 3. running the blockchain via Embark:

# navigate to the SoupCoin directory in our project.
$ embark blockchain privatenet
# now open up a seperate terminal
$ embark run

Et voila! If everything went OK you should see Geth v1.6.1 (replace with your version) in the embark console. You can now start hacking away : - ).

Some more information

The serverside scripts



CRONjob that runs every 1 minute and checks a .sqlite db file for unprocessed soup orders. Then calls soupcoinmintscript.js


composes and signs a transaction which will mint some SoupCoin for someone. Takes Two cmdline arguments: address and amount. Needs a config file to work, which we won't be putting on github because well... passwords and stuff.

CRONjob that runs every weekday at 23:45. Calls soupcoinburnscript.js which is similar to soupcoinmintscript.js

Gets called in soupcoinburnscript.js. Sends a mail to the soup-delivery-thingamajig using mailgun. API key left out because evil Russian hackers.



IPN endpoint listener, which processes payments in the site thru paypal, writes to an sqlite DB file. left out for privacy reasons.


A decentralized currency - using Ethereum - for the employees of Digipolis. Coins never tasted better!








No releases published


No packages published

Contributors 4