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

Lezek123 5920eaeedf Merge pull request #3053 from thesan/olympia-types-oracle-judgment преди 3 години
.github 019bd2022a query node - council mappings lint fixes II преди 3 години
analyses 0ebede74df Forum: runtime changes to support thread labels/tags преди 3 години
cli b903f4e7d3 CI checks fixes - CLI, @joystream/types, api-scripts преди 3 години
devops f7be0e2fb8 rollback to rust nightly-2021-02-20 преди 3 години
metadata-protobuf c08ce5bade Metadata-protobuf: Remove autogenerated files from the repo преди 3 години
node f7be0e2fb8 rollback to rust nightly-2021-02-20 преди 3 години
pioneer 96a637fa70 Merge branch 'olympia-proposals-mappings' into olympia-forum-mappings-part-2 преди 3 години
query-node 0c27ce4d53 Update chain-metadata, wait unti db service fully running (./query-node/start.sh) преди 3 години
runtime 0ebede74df Forum: runtime changes to support thread labels/tags преди 3 години
runtime-modules f80e66d781 Fix merge conflicts преди 3 години
scripts 7454c98be0 Merge branch 'olympia' into olympia-readme преди 3 години
storage-node fcd1ad162e Update @polkadot/api, @joystream/types, query-node, integration-tests, remove BTree(Set|Map) workarounds преди 3 години
testnets 5524c31b89 add antioch chainspec file преди 3 години
tests 32b1b0585a integration tests - fixes for forum and council tests failing преди 3 години
types de3e3e289a Regenerate types преди 3 години
utils b903f4e7d3 CI checks fixes - CLI, @joystream/types, api-scripts преди 3 години
.dockerignore f9bab952fa dockerignore fix (test node proposal-parameters) преди 3 години
.editorconfig 565ade3481 code style last tweaks, add format and checks yarn scripts преди 4 години
.env a7c825455c Merge branch 'master' into olympia-staging-and-conflicts-resolutions преди 3 години
.eslintrc.js 1a3bcbfa55 global tsconfig and .eslintrc преди 4 години
.gitignore f7cb4b976a spec-builder: upgrade to v2.0.0 преди 4 години
.prettierrc.js 9da958cc1c pretty some files преди 4 години
.yarnclean 643c08c7a0 Pioneer workspaces config etc. преди 4 години
Cargo.lock ecda6dc166 chain: Fix benchmarking. преди 3 години
Cargo.toml a7c825455c Merge branch 'master' into olympia-staging-and-conflicts-resolutions преди 3 години
LICENSE 248dcb5c30 README преди 4 години
README.md 7454c98be0 Merge branch 'olympia' into olympia-readme преди 3 години
apps.Dockerfile e39b3f71d8 Olympia: Improve query-node setup and update README преди 3 години
build-docker-images.sh a7c825455c Merge branch 'master' into olympia-staging-and-conflicts-resolutions преди 3 години
build-npm-packages.sh 5afc1f22d7 Remove references to content-metadata-protobuf преди 3 години
chain-metadata.json 0c27ce4d53 Update chain-metadata, wait unti db service fully running (./query-node/start.sh) преди 3 години
docker-compose.yml e39b3f71d8 Olympia: Improve query-node setup and update README преди 3 години
joystream-node.Dockerfile f7be0e2fb8 rollback to rust nightly-2021-02-20 преди 3 години
package.json 7454c98be0 Merge branch 'olympia' into olympia-readme преди 3 години
pioneer.Dockerfile 72229f792b nodejs 14 преди 3 години
setup.sh f7be0e2fb8 rollback to rust nightly-2021-02-20 преди 3 години
start.sh e39b3f71d8 Olympia: Improve query-node setup and update README преди 3 години
tsconfig.json 7e97ac9cff Revert "dropped parserOptions.project array from pioneer/.eslintrc.js" преди 4 години
yarn.lock 0c27ce4d53 Update chain-metadata, wait unti db service fully running (./query-node/start.sh) преди 3 години

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 npm packages
yarn build:packages

# 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-02-20 cargo +nightly-2021-02-20 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.