Skip to content

Latest commit

 

History

History
153 lines (96 loc) · 3.38 KB

README.md

File metadata and controls

153 lines (96 loc) · 3.38 KB
Raw

Requirements:

  • node ^8.1.4
  • npm ^5.3.0
  • python 3.5
  • solc ^0.4.11
  • Truffle ^3.4.4
  • Testrpc ^4.0.1

Trello: https://trello.com/b/bVfPFfjM/tasks

Introduction

This application is divided in two sections, protocol and ui. Protocol folder manage all things related to Ethereum, whereas ui will import protocol as a npm module. This architecture offers a clean separation between front and back.

The UI is built with React, Redux, Redux-Saga, Bootstrap 4, Fusebox, etc.

Run the app with Testrpc and Truffle (recommended way)

At the root level, install all dependencies

npm install

In a separate tab, run testrpc

testrpc [-m yourMnemonic]
or node_modules/.bin/testrpc

In a separate tab, compile and migrate the contracts

cd customModules/protocol
[npm install]
[truffle compile --compile-all]
truffle migrate

Attach a console

truffle console
or geth attach http://localhost:8545

Serve the app

npm run dev

=> Go to http://localhost:8085/

Run UI tests (using Jest)

npm run testUI

Run Smart Contract tests (using Mocha and Chai under the hood)

npm run testProtocol

If you work on the protocol, you may want to use npm link to avoid reinstalling the lib at each change.

npm run linkprotocol

Run the app with Geth

Launch the Geth node

geth --dev --rpc --rpcapi 'web3,eth,debug' --rpccorsdomain="*" --datadir /tmp/ethereum_dev_mode

To load the auto setup

geth --dev --preload autoSetupForGeth.js attach ipc:/tmp/ethereum_dev_mode/geth.ipc

Prepare contracts to be deployed, with python, based on a template

run

npm run compile

which is equivalent to

cd ./protocol/customDeploy
python3.5 compile.py ../contracts/Owned.sol
python3.5 compile.py ../contracts/Dao1901Members.sol
python3.5 compile.py ../contracts/Dao1901Votes.sol

Three files are created (one per contracts)

Then you need to do the following boilerplate stuff, either using autoSetup or manually

Auto Setup for Geth

In the geth console, load script "autoSetupForGeth.js" It will:

  • create 3 accounts if not already 3 (alias name alice, bob, carol)
  • run the miner (2 CPU)
  • load contract deployment functions
    loadScript("autoSetupForGeth.js");

then deploy contracts

var Dao1901Members = deployDao1901Members();
// when Dao1901Members is mined
var Dao1901Votes = deployDao1901Votes(Dao1901Members.address);

then serve the app

npm run start

The manual way with Geth

In the geth console

// check if accounts exists
personal.listAccounts 
// create account if no one exists
// it will set eth.coinbase automatically
personal.newAccount("");
// check eth.coinbase
eth.coinbase
// unlock your account
personal.unlockAccount(eth.accounts[0], "", 3600);

run the miner

miner.start(2)

Deploy the contracts

load the Dao1901Members deploy function and run it

loadScript("Dao1901Members.js");
var Dao1901Members = deployDao1901Members();

Wait Dao1901Members to be mined, then: same for Dao1901Votes

loadScript("Dao1901Votes.js");
var Dao1901Votes = deployDao1901Votes(Dao1901Members.address);

Wait Dao1901Votes to be mined

Type exit to quit the console