xdagj

Welcome to XDAGJ

GitHub release (latest SemVer) GitHub GitHub issues

System environment

JDK: v17
Maven: v3.9.1

JDK 17 Download

Eclipse Temurin™ 17 Latest Releases(https://adoptium.net/temurin/releases/)

Maven 3.9.1 Download

Apache Maven 3.9.x Latest Releases(https://maven.apache.org/download.cgi)

Installation and usage

The XDAGJ Testnet Tutorial can help you quickly access XDAGJ testnet by using wallets and mining functions. The Private Chain Building Tutorial helps you to build a private-chain for testing XDAGJ and finding bugs.

XDAGJ_TestNet_Tutorial

XDAGJ_Devnet_Tutorial

XDAGJ TestNet Explorer

Develop

XDAGJ has basic pool functions. Follow-up work will improve system stability and add new functions. The goal is to prepare XDAG for entry into the metaverse. It is important to adopt excellent blockchain technology.

XDAG Mars Project

Four stages:

Exploration phase: XDAGJ testnet is online (online, in beta)

Deploy XDAGJ test network environment, open beta
Implement the RandomX algorithm
Implement the libp2p network protocol
Testnet blockchain browser
Test coin acquisition

Landing phase: XDAGJ mainnet is online

Add test cases: write test cases for existing functions
Add log functions: provide a relatively complete log service to facilitate troubleshooting
Optimize synchronization protocol: ameliorate the existing synchronization protocol and improve synchronization efficiency
Implement the snapshot function: reduce the cost of running a mining pool and boost the loading process
Implement the RPC function: access Web3j, realize the standardization of the interface
Introduce the Stratum protocol for miners
Lightweight wallet application: join the browser wallet
Standardize the format of public and private keys, follow the BIPXX specification, and add mnemonic words to generate public and private key pairs

Expansion phase: XDAGJ & XRC

Improve the address block structure
Increase the handling fee
Optimize wallets to improve the user experience
Support XRC standards
Decrease the threshold of mining pool users
Open the whitelist to achieve complete decentralization

Prosperity phase: XDAGJ & DeFi

Implement cross-chain protocols, compatible with access to multiple blockchain systems, to achieve intercommunication between XDAG and other chain worlds
Implement the oracle function
Join a distributed exchange

Code

Git

We use the gitflow branch model
- master is the main branch, which is also used to deploy the production environment. Cannot modify the code directly at any time.
- develop is the development branch, always keep the latest code after completion and bug fixes.
- feature is a new feature branch. When developing new features, use the develop branch as the basis, and create the corresponding feature/xxx branch according to the development characteristics.
- release is the pre-launch branch. During the release test phase, the release branch code will be used as the benchmark test. When a set of features is developed, it will be merged into the develop branch first, and a release branch will be created when entering the test. If there is a bug that needs to be fixed during the testing process, it will be directly fixed and submitted by the developer in the release branch. When the test is completed, merge the release branch to the master and develop branches. At this time, the master is the latest code and is used to go online.
- hotfix is the branch for repairing urgent problems on the line. Using the master branch as the baseline, create a hotfix/xxx branch. After the repair is completed, it needs to be merged into the master branch and the develop branch.
Commit Message

The submission message must begin with a short subject line, followed by an optional, more detailed explanatory text, which should be separated from the abstract by a blank line.
Pull Request

The pull request must be as clear and detailed as possible, including all related issues. If the pull request is to close an issue, please use the Github keyword convention close, fix, or resolve. If the pull request only completes part of the problem, use the connected keyword. This helps our tool to correctly link the issue to the pull request.
Code Style

Use the formatter_eclipse.xml or formatter_intellij.xml of the xdagj code style in the misc/code-style folder.
Code Review

We value the quality and accuracy of the code. Therefore, we will review all of the code that needs to be changed.

FAQ

Time Synchronization Method with NTP XDAGJ_Time_Synchronization
XDAGJ RPC Document XDAGJ_RPC

Contribution

Security Question

XDAGJ is still in the process of large-scale development, which means that there may be problems with existing codes or protocols, or errors that may exist in practice. If you find a security problem, we hope you can report it back as soon as possible.

If you find a problem that may affect the security of the deployed system, we hope that you can send the problem privately to xdagj@xdag.io. Please do not discuss it publicly!

If the problem is a weakness of the agreement or does not affect the online system, it can be discussed publicly and posted to issues.
Features

We are very happy to add more useful and interesting new features to XDAGJ. You can suggest any interesting new features that you think would be beneficial.

If you are interested in the development of XDAGJ, we also welcome you to join the developer team and contribute your strength to XDAGJ. You can get in touch with us at xdagj@xdag.io.

Sponsorship

Since the launch of the Apollo Project, XDAGJ has made a significant breakthrough from 0 to 1. The development of XDAGJ has been on the right track. Your support can drive the successful implementation of XDAGJ technology. XDAG：BkcVG4i1BfxUJLdNPdctaCReBoyn4j32d