Flow is a fast, secure, and developer-friendly blockchain built to support the next generation of games, apps and the digital assets that power them. Read more about it here.
- To install all dependencies and tools, see the project setup guide
- To dig into more documentation about Flow, see the documentation
- To learn how to contribute, see the contributing guide
- To see information on developing Flow, see the development workflow
You can find an overview of the Flow architecture on the documentation website.
Development on Flow is divided into work streams. Each work stream has a home directory containing high-level documentation for the stream, as well as links to documentation for relevant components used by that work stream.
The following table lists all work streams and links to their home directory and documentation:
Work Stream | Home directory |
---|---|
Access Node | /cmd/access |
Collection Node | /cmd/collection |
Consensus Node | /cmd/consensus |
Execution Node | /cmd/execution |
Verification Node | /cmd/verification |
HotStuff | /consensus/hotstuff |
Storage | /storage |
Ledger | /ledger |
Networking | /network |
Cryptography | /crypto |
-
Clone this repository
-
Clone this repository's submodules:
git submodule update --init --recursive
-
Install Go (Flow supports Go 1.13 and later)
-
Install CMake, which is used for building the crypto library
-
Install Docker, which is used for running a local network and integration tests
-
Make sure the
GOPATH
andGOBIN
environment variables are set, andGOBIN
is added to your path:export GOPATH=$(go env GOPATH) export GOBIN=$GOPATH/bin export PATH=$PATH:$GOBIN
Add these to your shell profile to persist them for future runs.
-
Then, run the following command:
make install-tools
At this point, you should be ready to build, test, and run Flow! 🎉
Note: if there is error about "relic" or "crypto", trying force removing the relic build and reinstall the tools again:
rm -rf crypto/relic
make install-tools
Flow has a unit test suite and an integration test suite. Unit tests for a module
live within the module they are testing. Integration tests live in integration/tests
.
Run the unit test suite:
make test
Run the integration test suite:
make integration-test
The recommended way to build and run Flow for local development is using Docker.
Build a Docker image for all nodes:
make docker-build-flow
Build a Docker image for a particular node role (replace $ROLE
with collection
, consensus
, etc.):
make docker-build-$ROLE
A local version of the network can be run for manual testing and integration. See the Local Network Guide for instructions.
Generated code is kept up to date in the repository, so should be committed whenever it changes.
Run all code generators:
make generate
Generate protobuf stubs:
make generate-proto
Generate mocks used for unit tests:
make generate-mocks