Forked from Joystream/joystream https://github.com/Joystream/joystream

Mokhtar Naamani 20d73e12f6 Merge pull request #2473 from ahhda/deploy-independent-node 3 gadi atpakaļ
.github a5093c9fe3 Change key name to standard 3 gadi atpakaļ
cli 70bdbcdfe5 cli: README 3 gadi atpakaļ
content-metadata-protobuf 0804bfbb34 Fix checks - remove StorageProviderRecord and run formatter on protobuf library 3 gadi atpakaļ
devops ba21713c49 Remove pre built AMI option for single node 3 gadi atpakaļ
node 77c50c53cc runtime: bump initial "default" data directory voucher limits 3 gadi atpakaļ
pioneer 0d47ce0d57 Merge pull request #2423 from DzhideX/sumer-update-tokenomics-operation 3 gadi atpakaļ
query-node 2adbf7d346 query node - bytes converion utf-8 null character handling 3 gadi atpakaļ
runtime fb4a5fd45e runtime changelong update 3 gadi atpakaļ
runtime-modules bb011dbebe vouchers: reduce initial default object limits 3 gadi atpakaļ
scripts f7e53e4dba rust nightly-2021-03-24 3 gadi atpakaļ
storage-node 250ea4849e storage-node allow 10GB uploads 3 gadi atpakaļ
testnets 5524c31b89 add antioch chainspec file 3 gadi atpakaļ
tests 5a420fc766 drop unnecessary typecast to SubmittableExtrinsic<'promise'> 3 gadi atpakaļ
types aaeb89561a add @polkadot/metadata to package.json resolutions and rebuild augment types 3 gadi atpakaļ
utils 20653d141d @joystream/types v0.16.1 3 gadi atpakaļ
.dockerignore c2b0c729d9 Merge branch 'query_node_mappings' into sumer-new-substrate-update-apps 3 gadi atpakaļ
.editorconfig 565ade3481 code style last tweaks, add format and checks yarn scripts 4 gadi atpakaļ
.env 716d9eb835 github workflow start joystream-node before running query-node tests 3 gadi atpakaļ
.eslintrc.js 1a3bcbfa55 global tsconfig and .eslintrc 4 gadi atpakaļ
.gitignore f7cb4b976a spec-builder: upgrade to v2.0.0 3 gadi atpakaļ
.prettierrc.js 9da958cc1c pretty some files 4 gadi atpakaļ
.yarnclean 643c08c7a0 Pioneer workspaces config etc. 4 gadi atpakaļ
Cargo.lock 77c50c53cc runtime: bump initial "default" data directory voucher limits 3 gadi atpakaļ
Cargo.toml 8768c1bebf runtime and types: drop service_discovery module 3 gadi atpakaļ
LICENSE 248dcb5c30 README 4 gadi atpakaļ
README.md 5524c31b89 add antioch chainspec file 3 gadi atpakaļ
apps.Dockerfile 72229f792b nodejs 14 3 gadi atpakaļ
build-docker-images.sh 8732afe6db drop old build.sh and re-fix typo 3 gadi atpakaļ
build-npm-packages.sh 232282f617 Remove CLI build workaround 3 gadi atpakaļ
docker-compose.yml a0f037baab update joystream/hydra-indexer:2.1.0-beta.9 3 gadi atpakaļ
joystream-node.Dockerfile c5ecfcc1ed fix docker run commands 3 gadi atpakaļ
package.json aaeb89561a add @polkadot/metadata to package.json resolutions and rebuild augment types 3 gadi atpakaļ
pioneer.Dockerfile 72229f792b nodejs 14 3 gadi atpakaļ
setup.sh 4985aa676b install node@14 in setup.sh 3 gadi atpakaļ
start.sh dc47ff2183 api-scripts: add helper script to make sudo the membership screening authority 3 gadi atpakaļ
tsconfig.json 7e97ac9cff Revert "dropped parserOptions.project array from pioneer/.eslintrc.js" 4 gadi atpakaļ
yarn.lock aaeb89561a add @polkadot/metadata to package.json resolutions and rebuild augment types 3 gadi atpakaļ

README.md

Joystream

This is the main code repository for all Joystream software. In this mono-repo you will find all the software required to run a Joystream network: The Joystream full node, 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.

Overview

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.

Development Tools

The following tools are required for building, testing and contributing to this repo:

If you use VSCode as your code editor we recommend using the workspace settings for recommend eslint plugin to function properly.

After cloning the repo run the following initialization scripts:

# Install rust toolchain
./setup.sh

# Install npm package dependencies, build packages and docker images
yarn build

# start a local development network
yarn start

Software

Substrate blockchain

Server Applications - infrastructure

Front-end Applications

  • Pioneer - Main UI for accessing all Joystream features
  • Atlas - Media Player- under development

Tools and CLI

Testing infrastructure

Exploring the network with Pioneer

Pioneer is currently the main web interface to interact with the network:

Currently hosted on: https://testnet.joystream.org

You may have to disable some privacy/ad-blocker extensions in your browser for proper functionality, especially when browsing media.

You can also run a local development instance:

The HEAD of the master branch should always be used for the correct version of the applications to connect to the current testnet:

git checkout master
yarn install
yarn build:packages
yarn workspace pioneer start

This runs a local development web server on port 3000.

Use the link below to browse the network using the publicly hosted endpoint: http://localhost:3000/?rpc=wss://rome-rpc-endpoint.joystream.org:9944/

Running a local full node

You can also run your our own joystream-node:

git checkout master
WASM_BUILD_TOOLCHAIN=nightly-2021-03-24 cargo build --release
./target/release/joystream-node -- --pruning archive --chain testnets/joy-testnet-5.json

Wait for the node to sync to the latest block, then change pioneer settings "remote node" option to "Local Node", or follow the link below:

http://localhost:3000/?rpc=ws://localhost:9944/

Learn more about joystream-node.

A step by step guide to setup a full node and validator on the Joystream testnet, can be found here.

Integration tests

tests/network-tests/run-tests.sh

Contributing

We have lots of good first issues open to help you get started on contributing code. If you are not a developer you can still make valuable contributions by testing our software and providing feedback and opening new issues.

A description of our branching model will help you to understand where work on different software components happens, and consequently where to direct your pull requests.

We rely on eslint for code quality of our JavaScript and TypeScript code and prettier for consistent formatting. For Rust we rely on rustfmt and clippy.

The husky npm package is used to manage the project git-hooks. This is automatically installed and setup when you run yarn install.

When you git commit and git push some scripts will run automatically to ensure committed code passes lint, tests, and code-style checks.

During a rebase/merge you may want to skip all hooks, you can use HUSKY_SKIP_HOOKS environment variable.

HUSKY_SKIP_HOOKS=1 git rebase ...

RLS Extension in VScode or Atom Editors

If you use RLS extension in your IDE, start your editor with the BUILD_DUMMY_WASM_BINARY=1 environment set to workaround a build issue that occurs in the IDE only.

BUILD_DUMMY_WASM_BINARY=1 code ./joystream

Authors

See the list of contributors who participated in this project.

License

All software under this project is licensed as GPLv3 unless otherwise indicated.

Acknowledgments

Thanks to the whole Parity Tech team for making substrate and helping in chat with tips, suggestions, tutorials and answering all our questions during development.