Welcome potential contributor of Astar Network! The Astar Network project (formerly known as Plasm Network) is a collection of Open Source Projects maintained by the Astar Team and Stake Technologies. We want to make contributing to this project as easy and transparent as possible.
This document will act as a starting point for those who want to be part of the Astar Ecosystem, which includes code contribution and community contribution.
We welcome any types of contributions that can improve the project/network in any shape or form, may it be directly to the Astar repository codebase, feedback, or making community contributions. You don't have to be a developer to contribute to the network.
The Astar Network project uses GitHub as the main source control hosting service. Most forms of communication regarding changes to the code will be done within the issue board of the repository.
The core of Astar Network codebase is split into two repositories:
Contributions within GitHub can take on the following forms:
- Bug Report: If you find any bugs or unexpected behaviors using the Astar node, please open an issue that describes the issue and other information that the developer may need when investigating.
- User Questions: Posting your question that is not addressed on our official docs, Substrate docs, or through other issue tickets helps us improve our wiki and keep the community informed. For any inquiries related to the usage/development of the code, please open an issue on our repository.
- Feature Request: If you have any suggestions or requests for a feature that can be made within a relatively short development time, feel free to open an issue that describes the 'what,' 'why,' 'how,' of the feature.
For those who wish to make changes to the source code, please ensure that there is an open issue that is related to the changes you're trying to make. You must open an issue before you open a pull request as this allows us to understand what changes will come and prevent stale pull requests. The issue should contain a rough description of how you are planning on changing the code to fix or add features. Once the repository maintainer gives the green light, you can fork the repository and open a pull request with your changes to our main branch (Dusty).
In short:
- Open an issue regarding a bug fix or feature request (fill in our issue templates)
- Briefly describe how you plan to make changes to the code
- Fork the current default branch on Astar or astar-frame or both (depending on where you need to make changes)
- Open a pull request to the default branch (fill in our pull request template)
- Ensure all workflow checks have passed
- Wait for the maintainers approval or change requests
- Your code will be merged
Contributors should adhere to the rustfmt styles.
Running cargo fmt prior to creating a commit will ensure everything is properly formatted.
All branch names should adhere to the following rules:
feature/*: new features are addeddoc/*: documentation changesfix/*: bug fixes
TODO: We don't really use this at all from what I've seen?
development/*: nodes that are actively in development (including release candidates) will have thedevelopment/prefix in their branch name.
Every major feature will be first deployed on our testnet parachain Shibuya after which it can be deployed on one of the production networks. The expected flow is:
local testnet/dry-run → Shibuya → Shiden → Astar
By contributing, you agree that your contributions will be licensed under the GNU General Public License v3.0 as is with the Astar source code. If you have any concerns regarding this matter, please contact the maintainer.
As a public blockchain network, Astar Network welcomes any contributions that help our community members and create the best blockchain network. Anyone can interact with the community through our official forum, discord, and Telegram. You can contribute to the community by actively participating in the forum discussions, helping other members, or sharing Astar Network with others.