open-bounty/README.md

3.0 KiB

Commiteth

Allows you to set bounties for Github issues, paid out in Ether.

More information: http://wiki.status.im/proposals/commiteth/

Live alpha version: https://commiteth.com The master branch is automatically deployed here.

Live testnet (Ropsten) version: https://openbounty.status.im:444 The develop branch is automatically deployed here.

Prerequisites

You will need Leiningen 2.0 or above installed.

PostgreSQL

Make sure you install PostgreSQL and properly set it up:

sudo -u postgres psql -c "CREATE USER commiteth WITH PASSWORD 'commiteth';"
sudo -u postgres createdb commiteth

solc

Solidity compiler 0.4.15 is required and needs to be in $PATH.

web3j

Web3j 2.3.0 is required and the command line tools need to be in $PATH.

Running

Make sure env/dev/resources/config.edn is correctly populated.

Lauch a local geth node with the bot account unlocked:

#!/bin/bash
geth --fast --testnet --cache=1024 --datadir=$HOME/.ropsten --verbosity 4 --port 50100 --ipcpath ~/.ropsten/geth.ipc --rpc --rpcaddr 127.0.0.1 --rpcport 8545 --rpcapi db,eth,net,web3,personal --rpccorsdomain "https://wallet.ethereum.org" --unlock "0xYOUR_ADDR" --password <(echo "YOUR_PASSPHRASE")

Launch the following command in a separate shell:

lein less auto

Next you want to start a REPL on the backend and the frontend.

lein repl

Now you can start a CLJS repl with:

(use 'figwheel-sidecar.repl-api)
(start-figwheel!)
(cljs-repl)

(Alternatively, if you use emacs and CIDER, you can run cider-jack-in. Details here)

Next start the application from the clojure REPL with:

(user/start)

Gotchas

Due to a current limitation you will get the following exception from the clojure compiler with dev builds:

Caused by: java.lang.ClassNotFoundException: commiteth.eth.contracts.TokenReg, compiling:(commiteth/eth/token_registry.clj:1:1)

The problem is the java classes generated by web3j have not been compiled. It can be worked around by running these commands:

lein build-contracts
lein jar
lein repl # this will fail
cp -r target/classes/commiteth target/base+system+user+dev/classes

This should be fixed to project.clj ASAP.

Uberjar build

To create a standalone uberjar:

lein uberjar

This creates target/uberjar/commiteth-<git-sha>.jar

Testing

QA

Please refer to doc/testing.md

Clojure tests

lein test

ClojureScript tests

lein with-profile test doo phantom test

Reagent component devcards

lein with-profile test figwheel devcards

Open http://localhost:3449/cards.html

License

Licensed under the Affero General Public License v3.0