MultiChainJAVAAPI is an open source Java interface MultiChain blockchains, written in Java.
https://github.com/SimplyUb/MultiChainJavaAPI
Copyright (c) 2017 Worldline
License: GNU General Public License version 3, see COPYING
These compilation instructions have been tested on Windows 7.0 and Ubuntu 12.4 x64 only with Java 1.7.0_80
* Java 1.7.0 is needed, upper version should be compatible
* All other depencies are managed by Maven.
The goal of the API is to directly integrate calls to command system and Json Formating to make Java developing easier :
The initial mind of the project is to manage Wallet. There's no command to manage the BlockChain like : create a blockChain, join a blockChain, ... Theses commands are more linked with the system. Next versions will decide to integrate (or not) theses commands.
The package multichain.command and the Class MultiChainCommand are the essential of the project.
They contain Java commands to call.
Examples of command calls can be found in multichain.test.command.
A simple example to get addresses :
//BlockChain has to be created and started before
multiChainCommand = new MultiChainCommand("localhost", "6824", "multichainrpc","73oYQWzx45hossFPPWUgicpLvHhsD8PempYxnSF6bnY9");
// localhost is the IP used by Multichain
// 6824 is, here, the port used by the BlockChain, corresponding of the value of default-rpc-port in the file params.dat
// multichainrpc and 73oYQWzx45h... are login and password to access to RPC commands, values can be found in the file multichain.conf
List<String> result = null;
try {
result = multiChainCommand.getAddressCommand().getAddresses();
} catch (MultichainException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
//result contains the addresses of the wallet as list of String.
The package multichain.object contains Java objects which can be used to call functions or returned by functions.
The package contains formatters with technical classes used to format Json to Java using Gson API.
The package multichain.test contains Java unit test.
Test are written with main() function to be executed whatever IDE or system used.
The package command has to contain unit tests for each command.
The package object.formatters is helpful to test the good work of Formatters Json<->Java.
Todo :
- integrate new functions
- Direct RPC Server calls
- Dependencies under Maven
Based on functions contained in MultiChain 1.0 Beta 1
Integrated functions about :
- Streams
Based on functions contained in MultiChain Alpha 24
Integrated functions about :
- Block
- Address
- Grant
- Balance
- Wallet
- Issue/Assets
- Transaction
- Transaction RAW
MultiChainJAVAAPI is released under the [GNU General Public License version 3] (LICENSE).
Copyright (c) 2017 Worldline.
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.