Skip to content

Monorepo containing various applications using the state channel framework

Notifications You must be signed in to change notification settings

statechannels/apps

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation


State Channels

Ethereum state channel applications built on statechannels.org framework

circleci license


statechannels is a simple off-chain framework for building state channel applications on top of the Ethereum blockchain. It aims to make it simpler to build permissionless applications that have instant finality with zero-fee transactions.

You can learn more about what state channels are by reading one or other of the whitepapers underpinning the project, or a less technical written description.

Packages

This repository is a monorepo, and contains the following packages maintained with lerna and yarn workspaces:

  • e2e-tests : End-to-end browser tests of all packages with puppeteer
  • persistent seeder : web3torrent dApp that can be run in a server environment.
  • rps : Rock paper scissors DApp
  • simple-hub : Simple server wallet for mediating virtual channels
  • tic-tac-toe : Tic-tac-toe DApp
  • web3torrent : DApp extension of webtorrent including micropayments

Contributing

Installing dependencies

Make sure you have Yarn v1.17.3 installed. For easy management of specific Yarn versions, we recommend using Yarn Version Manager (YVM).

To install the dependencies:

yarn

from the monorepo root.

Building packages

To build all packages:

yarn build

Clean

To clean all packages:

yarn clean

Lint

To lint all packages:

yarn lint:check

To also apply automatic fixes:

yarn lint:write

Tests

To run all tests:

yarn test

Development Flow

The rps, nitro-protocol, wallet, and hub packages will need to interact with a local blockchain when running and testing locally.

Running locally

Run

SC_ENV=virtual-funding yarn start-servers $APP

where APP is either web3torrent or rps. This will start a ganache instance on port 8545, and subsequently start servers for

  • the wallet
  • the app
  • the simple-hub (used for virtual-funding)

These servers use a common set of contracts deployed against the shared ganache instance.

Community

State Channels Forums: https://research.statechannels.org/