The Binance Chain Java SDK works as a lightweight Java library for interacting with the Binance Chain. It provides a complete API coverage, and supports synchronous and asynchronous requests. It includes the following core components:
- crypto - core cryptographic functions.
- amino encoding - amino (protobuf-like) encoding and decoding of transactions.
- client - implementations of API rest client, supporting synchronous and asynchronous access to Binance Chain's REST APIs.
- wallet - management of accounts, including seed and encrypted mnemonic generation.
This branch is under active development, all subject to potential future change without notification and not ready for production use. The code and security audit have not been fully completed and not ready for any bug bounty.
- Install library into your Maven's local repository by running
mvn install
- Add the following Maven dependency to your project's
pom.xml
:
<dependency>
<groupId>com.binance.dex.api</groupId>
<artifactId>binance-dex-api-client</artifactId>
<version>1.1.2</version>
</dependency>
The protobuf-maven-plugin is used in this SDK. It is a plugin that integrates protocol buffers compiler (protoc) into Maven lifecycle. The Plugin generates Java source files from .proto (protocol buffer definition) files for this project by running mvn compile
.
These Java source files will be packaged into the final artifact and referenced as imports from the dependent projects or modules by running mvn clean package
.
More details please refer to https://github.com/xolstice/protobuf-maven-plugin
For examples, please check the wiki.
All new code changes should be covered with unit tests. You can see the existing test cases here: https://github.com/binance-chain/java-sdk/tree/master/src/test/java/com/binance/dex/api/client/encoding
Contributions to the Binance Chain Java SDK are welcome. Please ensure that you have tested the changes with a local client and have added unit test coverage for your code.