Skip to content
Proof of concept applications that use the Force Move Game framework.
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci Try running in band for circleCI Jan 22, 2019
packages Merge branch 'master' into as-multiple-channels Mar 21, 2019
.gitignore
.prettierrc
README.md Merge branch 'master' into ag-mining-dependency Mar 6, 2019
cloudbuild.yaml Remove service worker Feb 12, 2019
lerna.json Move circle CI config to root Jan 15, 2019
orange_fireball.svg
package.json More prettier package.jsons Mar 5, 2019
yarn.lock

README.md

Magmo Apps

Welcome to the Magmo mono-repo, home of several proof-of-concept applications built on our state channel protocols.

For more information

On our website you will find links to our whitepapers and contact information. Whether you simply want to try out our apps, or get involved more deeply we would love to hear your thoughts. Deployed versions of our games may be accessed with these links:

Development Conventions

Prettier

Prettier is configured via .prettierrc. Tests will fail if code does not satisfy the rules specificied in .prettierrc. We suggest that you configure your editor to auto-format using prettier, or that you run it in a pre-commit git hook. You can also run yarn prettier:write.

Setting up development environment and running a game application

You will need yarn installed (see here for instructions). After cloning the code,

  1. In the top directory, run yarn install.

  2. Run npx lerna bootstrap.

  3. Start ganache by running yarn ganache:start .

  4. (In a new shell) Run the wallet via yarn start in the wallet package directory

  5. (In a new shell) Run a game (either RPS or TTT) via yarn start in the relevant package directory.

  6. Add MetaMask to your browser, and point it to localhost:3001 to view the application. You will need to import one of our (testnet-only) seed accounts into metamask to have funds to transact.

    1. Open the metamask browser extension
    2. Click on the account icon (circle in the top right)
    3. Select "Import"
    4. Paste in one of these secret keys.

You may visit the app in two different browsers in order to play against yourself. We use Redux DevTools to develop and test our apps.

Configuration

All default configuration values are located in the .env and .env.production files. These can be overridden by adding a .env.local or .env.production.local and specifying values there.

To run storybook

We use Storybook to view our react components during development. You can start Storybook by running:

yarn storybook

in the relevant package directory. This will fire up the Storybook panel inside a browser.

To create an optimized production build:

  1. Optionally override the TARGET_NETWORK by setting the value in your .env.production.local file. Otherwise the application will be built against the ropsten test network.

  2. Build the application:

    yarn run build
    

To deploy smart contracts

  1. Add test eth to your account for the deployment using an eth faucet: https://faucet.ropsten.be/ or https://faucet.metamask.io.
  2. Set TARGET_NETWORK in your .env.local file to the network you want to deploy to: either 'development', 'ropsten', 'kovan' or 'rinkeby'.
  3. Deploy the contracts to the network:
    yarn deployContracts
    

Alternatively, simply run, e.g. TARGET_NETWORK=ropsten yarn deployContracts.

Running Tests specific to a certain app

From the relevant subdirectory...

  • To run application tests in watch mode:
yarn test:app
  • To run smart contract tests:
yarn test:contracts
  • To run all tests relating (before submitting a PR):
yarn test
  • To update dependencies:
npx lerna bootstrap
  • To add a dependency:
npx lerna add [dependency name] --scope=[target package]

This installs the latest version of the dependency to the target package (ttt, rps or wallet). Use --dev flag to add the new package to devDependencies instead of dependencies.

  • To update the version of a dependency:
yarn upgrade [package-name@version-number]

Documentation

We are working hard to produce documenation for our applications. In the interim, please see our Developer Handbook, which as some of the hints and tips for developing on ethereum that we have used to develop our apps. You will also find some information in the /notes/ subdirectory of each app.

Problems?

Frequently, problems can be sorted by one or more of the following steps:

  • Resetting your MetaMask account (i.e. deleting transaction history), or simply switching to a different network and back again.
  • Restarting ganache
  • Running npx lerna bootstrap if you changed any dependencies

Otherwise, please check issues, someone else may have had the same experience. You may find a solution -- if not, please add to or create an issue.

You can’t perform that action at this time.