• Install Homebrew for package management:

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

• Install xcode and run from command line, this is to assist homebrew:

xcode-select --install

• Install NodeJS from homebrew. NodeJS is used for ethereum development:

brew install node

• Install Geth from homebrew (way to interact with ethereum):

brew tap ethereum/ethereum

brew install ethereum

• Install TestRPC (develop and test contracts):

npm install -g ethereumjs-testrpc

• Install Truffle (framework to build and deploy contracts):

npm install -g truffle

• Download and install visual studio code:

https://code.visualstudio.com/docs/setup/mac

• Install solidity extension in visual studio code

The contents of a basic genesis block is in this repo. Create genesis.json file under a specific directory, which we will initialize to be the data directory in the next step.

Whenever you run geth, you must specify the data directory you use here In this repo, our data dir is ~/github.com/ethereum/private

geth --datadir ~/github.com/ethereum/private init genesis.json

geth --datadir ~/github.com/ethereum/private account new

geth --datadir ~/github.com/ethereum/private account list

The contents of startnode.sh is in this. This is a brief description of each param:

• networkid 4224: Provide a unique network id
• mine: Node will start mining automatically when started
• datadir "~/github.com/ethereum/private": specifies data dir
• nodiscover: Node will not look for other nodes initially
• rpc: Node will use rpc
• rpcport "8545": The rpc port
• port "30303": The port on which the node will listen to other nodes
• rpccorsdomain "*": accept any rpc domain
• nat "any": accept any nat connection
• rpcapi eth,web3,personal,net: Use these api's or libraries in your node
• unlock 0: unlock the first account we created
• password ~/github.com/ethereum/private/password.sec: specify password file
• ipcpath "~/Library/Ethereum/geth.ipc": For Mist to connect to this later (only mac)

Run the following command to make startnode.sh executable:

chmod a+x startnode.sh

./startnode.sh

• miner.start()
• miner.stop()
• eth.accounts
• eth.coinbase
• eth.getBalance(coinbase)
• eth.sendTransaction({from:eth.coinbase, to:eth.accounts[1], value:web3.toWei(100,"ether")})
• web3.fromWei(someWeiValue, "ether") // converts from Wei to Ether
• web3.toWei(someWeiValue, "ether") // converts from Ether to Wei
• Full list: https://github.com/ethereum/go-ethereum/wiki/JavaScript-Console

Mist is an ethereum UI to connect to your node

https://github.com/ethereum/mist/releases

Mist Gitter chat room: https://gitter.im/ethereum/mist

You can install the extension in your chrome and connect to a chain from there

https://metamask.io

https://slack.metamask.io

• Create directory for Truffle project
• Run this command to initate a Truffle project:

truffle init

• Truffle will create some directories. Clean up files under contracts directory, just keep Migrations.sol
• Under migrations directory, there are deployment scripts that run according to the order specified in the prefix number. You should see the truffle generate numbers. Anyway, cleanup the code there as well to have only the Migrations.json stuff
• Place your solidity contract under contracts
• From command line, run the following command to deploy contracts to testrpc:

truffle migrate [--reset]

• From command line run this command to start truffle console:

truffle console

• From truffle console, run this JS command to get an instance of deployed contract:

Greetings.deployed().then(function(value) { app = value;});

• Now you can execute functions like getters and setters of the contract:

app.getGreetings();
app.setGreetings("New Greeting", {from: web3.eth.accounts[0]}); // must specify who's paying