Skip to content
Switch branches/tags

Latest commit


Git stats


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

Menlo One TownHall has been replaced by Menlo One Expo

Click through to the Expo Github

Use Expo on Kovan

Find out about Menlo:



To develop and run the town hall locally, install the following prerequisites and dependencies before running the app.



We assume brew for package management to install IPFS and other dependencies:

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


TownHall uses IPFS for storage of messages.

Menlo specific setup of IPFS can be installed and configured via:

    yarn run menlo:setup


Metamask or Mist should be used for interacting with the town hall dapp.

Install Metamask extensions into your browser of choice, Chrome or Brave supported:

Import development chain account

Import this private key into MetaMask for use with truffle develop and Ganache:


import MetaMask

Install app and dependencies

  1. Install nvm and node: brew install nvm && nvm install
  2. Clone the repo: git clone
  3. Install dependencies: cd townhall && nvm use && yarn install

Run the application

  1. Run a local dev blockchain in a separate window: yarn run truffle develop
  2. Run IPFS daemon in a separate window: ipfs daemon
  3. Now, deploy the contracts: yarn run truffle deploy --network develop
  4. Run the app: yarn start

Interact with TownHall

A browser window should open after starting: http://localhost:3000/

Ensure you are logged into MetaMask and switch to your imported account.

Set the network in MetaMask to, add a Custom RPC if that network doesn't already exist:



For a light, easy to use private chain with a visual and cli interface, try Ganache.

You can deploy and test using network ganache:

yarn run truffle deploy --network ganache

Note: Ganache and truffle develop are transitory. Once you shut them down, you will have to redeploy the contracts and redo any needed transactions.


For a persistent local testing environment to test before deploying to testnet or mainnet, use a Dev chain with Parity or Geth.

You can set the following environment variables in your local .env file to run against a local dev chain if you already have Parity or Geth configured or set with needed accounts:

- MENLO_TENET_1: Address for first tenet account.
- MENLO_TENET_2: Address for second tenet account.
- MENLO_TENET_3: Address for third tenet account.
- MENLO_POSTER: Address for the account used to interact with town hall.


To run a private dev chain with Parity, first run a dev chain, setup Menlo accounts, and then deploy contracts.

Install Parity

Installing Parity:

    brew install parity

Run unlocked dev chain

Assuming a default Parity setup, the initial dev account address is static:


You need to unlock your dev account to be able to run Truffle migrations easily. The following script runs parity with an unlocked dev account, it will need to be modified if you've changed the default dev account:


Set up Menlo accounts

Create the needed Menlo accounts:

    yarn run truffle menlo:create-integration-accounts

After running the account creation, a set of accounts will be displayed to add to your .env file.


Deploy Contracts

Once you add the environment variables to your account, rerun parity with the helper script:

    yarn run menlo:parity-dev-chain

Now deploy the contracts, use the integration network defined in truffle.js when using parity.

    yarn run truffle deploy --network integration

Your contracts will live between parity dev runs, you can check the contracts addresses to watch with truffle network.

Browse http://localhost:8180 to interact with the Parity wallet.

Parity has a lot of config and features: Read the effin manual

Subsequent runs

    yarn run menlo:parity-dev-chain


For testing the TownHall dapp:

  yarn test

For testing the town hall contracts:

  dapp update
  dapp test


Set the following environment variables:


Deploy to server using shipit:

  yarn run menlo:deploy

Staging and Testnet

Rinkeby & Mist

MetaMask can be used with a Rinkeby account to test against.

The Mist browser can be used to test the Rinkeby testnet.

Mist uses Geth underneath:

    brew install geth

Run Geth against Rinkeby with the Apis needed by Truffle:

    geth --rinkeby --rpc --rpcapi db,eth,net,web3,personal --rpccorsdomain http://localhost:3000

Now, run Mist against your local instance of Geth:

    /Applications/ --rpc

Wait for the blocks to sync , (go for a walk and enjoy the sunshine).

After the blocks sycn, note your account hash in the Mist Wallet, you'll need it later.

Close Mist, Stop Geth.

Now, run Geth with the account you noted above unlocked:

    geth --rinkeby --rpc --rpcapi db,eth,net,web3,personal --unlock="0x4B71d4020a69902E6cB1d9a387a03cF0a839d33b" --rpccorsdomain http://localhost:3000

Run Mist again:

    /Applications/ --rpc

Now you are ready to deploy contracts and test:

    yarn run truffle deploy --network rinkeby

Go to the faucet to get some free Ether: Rinkeby Faucet

Give your Mist account some TK/MET tokens:

    yarn run truffle console --network rinkeby

Run the Town Hall and browse in Mist to http://localhost:3000.



    parity --chain kovan

Production and Mainnet


Overriding the default configuration

This repo uses create-react-app environment variables.