neow3j: A Java Library to interact with NEO nodes

Neow3j is a Java library that aims to provide an easy and reliable integration to NEO nodes/clients.

By using neow3j, you will happily play with NEO and end up neow'ing around like Bongo Cat.

You can now focus on building Java/Android applications that use the functions provided by the NEO blockchain -- without being concerned on writing specific code to integrate with NEO nodes/clients.

Neow3j is an open-source project developed by the community and maintained by AxLabs.

Features

Support to NEO node/client API version 2.9.* (~80% currently implemented)
Observable pattern to get info about past and upcoming NEO blocks
Android support from API 24, which covers ~49% of all active Android devices (~1 billion devices)
Passphrase-protected Private Key implementation (NEP-2)
Wallet SDK implementation (NEP-6)
Mnemonic utils implementation (BIP-39), compatible to NEO
Multisig addresses
Signing and sending raw transactions
Sync and Async interface
Retry on node errors
Integration tests with the dotnet NEO VM

Upcoming Features/Enhancements

100% implementation of API version 2.9.0
Documentation on using neow3j with Android apps
Observable pattern to get specific transactions
Improve the response model: introduce purpose-specific objects rather than the current raw Java types
Interacting with smart contracts
Select best seed NEO node based on some metrics (e.g., latency)

Getting Started

Add the neow3j dependencies to your Java project -- either using Gradle or Maven:

Gradle

Java 8 & Android (min. API 24):

compile 'io.neow3j:core:1.0.8'

Maven

Java 8 & Android (min. API 24):

<dependency>
    <groupId>io.neow3j</groupId>
    <artifactId>core</artifactId>
    <version>1.0.8</version>
</dependency>

Examples

Initialize Neow3j providing the JSON-RPC's endpoint of a NEO node/client:

Neow3j neow3j = Neow3j.build(new HttpService("http://seed1.ngd.network:10332"));

Get all blocks starting from, e.g. 2889367, and subscribe to also get newly generated NEO blocks:

neow3j.catchUpToLatestAndSubscribeToNewBlocksObservable(new BlockParameterIndex(2889367), true)
        .subscribe((blockReqResult) -> {
            System.out.println("#######################################");
            System.out.println("blockIndex: " + blockReqResult.getBlock().getIndex());
            System.out.println("hashId: " + blockReqResult.getBlock().getHash());
            System.out.println("confirmations: " + blockReqResult.getBlock().getConfirmations());
            System.out.println("transactions: " + blockReqResult.getBlock().getTransactions());
        });

Or, you can just subscribe to the newly generated NEO blocks:

neow3j.catchUpToLatestAndSubscribeToNewBlocksObservable(BlockParameterName.LATEST, true)
        .subscribe((blockReqResult) -> {
            System.out.println("#######################################");
            System.out.println("blockIndex: " + blockReqResult.getBlock().getIndex());
            System.out.println("hashId: " + blockReqResult.getBlock().getHash());
            System.out.println("confirmations: " + blockReqResult.getBlock().getConfirmations());
            System.out.println("transactions: " + blockReqResult.getBlock().getTransactions());
        });

Get the latest block index received by the NEO node:

NeoBlockCount blockCountReq = neow3j.getBlockCount().send();
System.out.println(blockCountReq.getBlockIndex());

Validate whether an address is a valid NEO address:

NeoValidateAddress validateReq = neow3j.validateAddress("ARvMqz3hEFE4qBkHAaPNxALquNQtBbH12f").send();
System.out.println("isValid=" + validateReq.getValidation().isValid());

Get info about NEO consensus nodes:

NeoGetValidators getValidatorsReq = neow3j.getValidators().send();
System.out.println(getValidatorsReq.getValidators());

Create a key pair:

ECKeyPair ecKeyPair = Keys.createEcKeyPair();

Create a key pair from WIF:

ECKeyPair ecKeyPair = ECKeyPair.create(WIF.getPrivateKeyFromWIF("Kx9xMQVipBYAAjSxYEoZVatdVQfhYHbMFWSYPinSgAVd1d4Qgbpf"));

Generate the WIF based on a key pair:

String wif = ecKeyPair.exportAsWIF();

Get the NEO address from a key pair:

String neoAddress = Keys.getAddress(ecKeyPair);

Create a standard wallet (NEP-6):

WalletFile wallet = Wallet.createStandardWallet();

Create a password-protected account (NEP-2) based on a key pair:

WalletFile.Account account = Wallet.createStandardAccount("myPassw0rd!@#", keyPair);

Add a password-protected account (NEP-2) to a standard wallet (NEP-6):

wallet.addAccount(account);

Get the plain key pair from a password-protected account within a wallet:

ECKeyPair ecKeyPair = Wallet.decryptStandard("myPassw0rd!@#", wallet, account);

Also, if you want to create a wallet file (NEP-6), the class WalletUtils provide some easy to use methods.

Creates a wallet file, and adds an account based on the provided key pair and password:

String fileName = WalletUtils.generateWalletFile("myPassw0rd!@#", ecKeyPair, destinationDiretory);

Or, if you want to create a wallet file with a newly created account, you simply can call:

String fileName = WalletUtils.generateNewWalletFile("myPassw0rd!@#", destinationDiretory);

There's also the possibility to create a new BIP-39 compatible wallet (generating the mnemonic words):

Bip39Wallet bip39Wallet = WalletUtils.generateBip39Wallet("myPassw0rd!@#", destinationDirectory);
String mnemonicWords = bip39Wallet.getMnemonic();
System.out.println("mnemonic words: " + mnemonicWords);

And, load the credential based on the mnemonic words:

Credentials credentials = WalletUtils.loadBip39Credentials("myPassw0rd!@#", mnemonicWords);

Build a raw transaction with a 2/3 multisig address:

ECKeyPair ecKeyPair1 = ECKeyPair.create(WIF.getPrivateKeyFromWIF("Kx9xMQVipBYAAjSxYEoZVatdVQfhYHbMFWSYPinSgAVd1d4Qgbpf"));
ECKeyPair ecKeyPair2 = ECKeyPair.create(WIF.getPrivateKeyFromWIF("KzbKux44feMetfqdA5Cze9FNAkydRmphoFKnK5TGDdEQ8Nv1poXV"));
ECKeyPair ecKeyPair3 = ECKeyPair.create(WIF.getPrivateKeyFromWIF("L3hxLFUsNDmkzW6QoLH2PGc2DqGG5Kj1gCVwmr7duWJ9FReYWnjU"));

String multiSigAddress = Keys.getMultiSigAddress(
                2,
                ecKeyPair1.getPublicKey(),
                ecKeyPair2.getPublicKey(),
                ecKeyPair3.getPublicKey()
);

RawVerificationScript verificationScript = Keys.getVerificationScriptFromPublicKey(
                2,
                ecKeyPair1.getPublicKey(),
                ecKeyPair2.getPublicKey(),
                ecKeyPair3.getPublicKey()
);

RawTransaction rawTx = RawTransaction.createContractTransaction(
                null,
                null,
                Arrays.asList(
                        new RawTransactionInput("9feac4774eb0f01ab5d6817c713144b7c020b98f257c30b1105062d434e6f254", 0)
                ),
                Arrays.asList(
                        new RawTransactionOutput(0, NEOAsset.HASH_ID, "100.0", "AK2nJJpJr6o664CWJKi1QRXjqeic2zRp8y"),
                        new RawTransactionOutput(1, NEOAsset.HASH_ID, "900.0", multiSigAddress)
                )
);

// serialize the base raw transaction
// Important: without scripts!
byte[] rawTxUnsignedArray = rawTx.toArray();

// add 2 signatures out of the 3 possible -- order here is important!
List<RawInvocationScript> rawInvocationScriptList = new ArrayList<>();
rawInvocationScriptList.add(new RawInvocationScript(Sign.signMessage(rawTxUnsignedArray, ecKeyPair1)));
rawInvocationScriptList.add(new RawInvocationScript(Sign.signMessage(rawTxUnsignedArray, ecKeyPair2)));

// give the invocation and verification script to the raw transaction:
rawTx.addScript(rawInvocationScriptList, verificationScript);

byte[] rawTxSignedArray = rawTx.toArray();
String rawTransactionHexString = Numeric.toHexStringNoPrefix(rawTxSignedArray);
System.out.println("rawTransactionHexString: " + rawTransactionHexString);

Send the raw transaction (built in the example above) to a validator node:

NeoSendRawTransaction sendRawTransactionReq = neow3j.sendRawTransaction(rawTransactionHexString).send();
System.out.println(sendRawTransactionReq.getResult());

Donate

Help the development of neow3j by donating to the following addresses:

Crypto	Address
NEO	`ARvMqz3hEFE4qBkHAaPNxALquNQtBbH12f`
ETH	`0xe85EbabD96943655e2DcaC44d3F21DC75F403B2f`
BTC	`3L4br7KQ8DCJEZ77nBjJfrukWEdVRXoKiy`

NEO API Support

Version 2.9.0

The following NEO JSON-RPC methods are implemented in neow3j:

dumpprivkey <address>: Exports the private key of the specified address. Needs to open the wallet.
getaccountstate <address>: Checks account asset information according to account address.
getassetstate <asset_id>: Queries asset information according to the specified asset number.
getbalance <asset_id>: Returns the balance of the corresponding asset in the wallet according to the specified asset number. Need to open the wallet.
getbestblockhash: Gets the hash of the tallest block in the main chain.
getblock <hash> [verbose=0]: Returns the corresponding block information according to the specified hash value.
getblock <index> [verbose=0]: Returns the corresponding block information according to the specified index.
getblockcount: Gets the number of blocks in the main chain.
getblockhash <index>: Returns the hash value of the corresponding block based on the specified index.
getblockheader <hash> [verbose=0]: Returns the corresponding block header information according to the specified script hash.
getblocksysfee <index>: Returns the system fees before the block according to the specified index.
getconnectioncount: Gets the current number of connections for the node.
getcontractstate <script_hash>: Returns information about the contract based on the specified script hash.
getnewaddress: Creates a new address. Needs to open the wallet.
getrawmempool: Gets a list of unconfirmed transactions in memory.
getrawtransaction <txid> [verbose=0]: Returns the corresponding transaction information based on the specified hash value.
getstorage <script_hash> <key>: Returns the stored value based on the contract script hash and key.
gettxout <txid> <n>: Returns the corresponding transaction output (change) information based on the specified hash and index.
getpeers: Gets a list of nodes that are currently connected/disconnected by this node.
getversion: Gets version information of this node.
getvalidators: Gets NEO consensus nodes information.
getwalletheight: Gets the current wallet index height. Needs to open the wallet.
invoke <script_hash> <params>: Invokes a smart contract at specified script hash with the given parameters.
invokefunction <script_hash> <operation> <params>: Invokes a smart contract at specified script hash, passing in an operation and its params.
invokescript <script>: Runs a script through the virtual machine and returns the results.
listaddress: Lists all the addresses in the current wallet. Needs to open the wallet.
sendrawtransaction <hex>: Broadcast a transaction over the network. See the network protocol documentation.
sendtoaddress <asset_id> <address> <value> [fee=0] [change_address]: Transfer to specified address. Needs to open the wallet.
sendmany <outputs_array> [fee=0] [change_address]: Bulk transfer order. Needs to open the wallet.
submitblock <hex>: Submit new blocks. Needs to be a consensus node.
validateaddress <address>: Verify that the address is a correct NEO address.

Why "neow3j"?

This project is based on web3j, but focusing on NEO. That's why the suffix "w3j" was added to the "neo" name, forming "neow3j".

Well... then, it was simply natural to imagine Bongo Cat playing on NEO nodes and neow'ing instead of meow'ing, don't you think? :-)

Thanks and Credits

This project was strongly based on web3j, a library originally developed by Conor Svensson, latest on this commit. We are really thankful for it. :-)
NEO Global Development (NGD)

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

README.md

README.md

neow3j: A Java Library to interact with NEO nodes

Features

Upcoming Features/Enhancements

Getting Started

Gradle

Maven

Examples

Donate

NEO API Support

Version 2.9.0

Why "neow3j"?

Thanks and Credits

Files

README.md

Latest commit

History

README.md

File metadata and controls

neow3j: A Java Library to interact with NEO nodes

Features

Upcoming Features/Enhancements

Getting Started

Gradle

Maven

Examples

Donate

NEO API Support

Version 2.9.0

Why "neow3j"?

Thanks and Credits