This is the main code reposity for all joystream software. It will house the substrate chain project, the full node and runtime and all reusable substrate runtime modules that make up the joystream runtime. In addition to all front-end apps and infrastructure servers necessary for operating the network.
The repository is currently just a cargo workspace, but eventually will also contain yarn workspaces, and possibly other project type workspaces.
More detailed build history on Travis CI
The Joystream network builds on a pre-release version of substrate v2.0 and adds additional functionality to support the various roles that can be entered into on the platform.
Joystream node is the main server application that connects to the network, synchronizes the blockchain with other nodes and produces blocks if configured as a validator node.
To setup a full node and validator review the advanced guide from the helpdesk.
The latest pre-built binaries can be downloads from the releases page.
Clone the repository and install build tools:
git clone https://github.com/Joystream/substrate-runtime-joystream.git
cd substrate-runtime-joystream/
./setup.sh
cargo build --release
Run the node and connect to the public testnet.
cargo run --release -- --chain ./rome-tesnet.json
The rome-testnet.json
chain file can be ontained from the release page
This will install the executable joystream-node
to your ~/.cargo/bin
folder, which you would normally have in your $PATH
environment.
cargo install joystream-node --path node/
Now you can run
joystream-node --chain rome-testnet.json
This will build and run a fresh new local development chain purging existing one:
./scripts/run-dev-chain.sh
cargo test
The runtime is the code that defines the consensus rules of the Joystream protocol. It is compiled to WASM and lives on chain. Joystream node execute the code's logic to validate transactions and blocks on the blockchain.
When building joystream-node as described abot with cargo build --release
, in addition to the joystream-node binary being built the WASM blob artifact is produced in:
target/release/wbuild/joystream-node-runtime/joystream_node_runtime.compact.wasm
Deploying the compiled runtime on a live system can be done in one of two ways:
-
Joystream runtime upgrade proposals which will be voted on by the council. When the Joystream platform is live, this will be the only way to upgrade the chain's runtime code.
-
During development and testnet phases, we can send an extrinsic (transaction signed with the sudo key) invoking
system::setCode()
. This can be done either from the UI/extrinsics app, or directly with an admin script.
Versioning of the runtime is set in runtime/src/lib.rs
For detailed information about how to set correct version numbers when developing a new runtime, see this
We use cargo-fmt
to format the source code for consistency.
It should be available on your machine if you ran the setup.sh
script, otherwise install it with rustup:
rustup component add rustfmt
Applying code formatting on all source files recursing subfolders:
cargo-fmt
Please see our contributing guidlines for details on our code of conduct, and the process for submitting pull requests to us.
See also the list of CONTRIBUTORS who participated in this project.
This project is licensed under the GPLv3 License - see the LICENSE file for details
Thanks to the whole Parity Tech team for making substrate and helping on riot chat with tips, suggestions, tutorials and answering all our questions during development.