How to Report an Issue
This document outlines how to report an issue with the XDC Network or the core tooling around the XDC Network. It is intended to be followed by both developers building on the network as well as users who face issues with the XDC Network. Note that if the issue is specifically with a layer 2 project then you should begin by reaching out to that project.
Issue Reporting Process Overview
In general the issue reporting process has two steps:
Raise the issue on the issue tracker of the appropriate GitHub repository
Elaborate on the issue with a post on xdc.dev
Raising an Issue on GitHub
On GitHub.com, navigate to the main page of the repository.
Under your repository name, click Issues.
Click New issue.
If your repository uses issue templates, click Get started next to the type of issue you'd like to open.Or, click Open a blank issue if the type of issue you'd like to open isn't included in the available options.
Type a title and description for your issue.
If you're a project maintainer, you can assign the issue to someone, add it to a project board, associate it with a milestone, or apply a label.
When you're finished, click Submit new issue.
Creating a Post on XDC.dev
On xdc.dev (after having created an account) click on the "Create Post" button in the upper right hand corner.
Add a descriptive title to your post and be sure to provide a link back to the GitHub issue in the body of the post.
Within the body of the post be sure to provide as much context as possible, including screenshots that help illustrate the issue. The post on xdc.dev will raise the issue with XDC Developer Community and also give you a way to provide detailed information to the developers who will be working on resolving your issue.
As an example of a post describing an issue please reference: https://www.xdc.dev/menezesphill/ethereum-compatible-rpc-endpoint-on-apothem-rejecting-remote-calls-jel
Once your post is complete, hit the "Publish" button on the bottom left hand corner of the screen to make the post live.
You can use the comments section below your post to engage with developers to answer questions or provide further feedback on your issue.
Helpful Repository Links
Here is a list of the most common repositories that you can reference for issue creation.
Protocol Level Issues: https://github.com/XinFinOrg/XDPoSChain/issues
Block Explorer Issues: https://github.com/XinFinOrg/XDCScan/issues, and be sure to tag @blocksscanio on your xdc.dev post
RPC Server Issues: Post the issue on the GitHub repository associated with the product or platform, and be sure to tag @blocksscanio on your xdc.dev post
Apothem Testnet: https://github.com/XinFinOrg/Faucet/issues
Apothem Faucet: https://github.com/XinFinOrg/Faucet/issues
docs.xdc.community: https://github.com/XDC-Community/docs/issues
Leo Testnet Faucet: https://github.com/XDCFoundation/xdc-faucet-leo/issues
Android SDK: https://github.com/XDCFoundation/XDC3Android/issues
React Native SDK: https://github.com/XDCFoundation/XDC3ReactNative/issues
XinFin Remix IDE: https://github.com/XinFinOrg/XDCremix
Last updated