Monero wallet Java implementation.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
woodser 4b0f14ddcf update run tests readme 3 months ago
.settings commit eclipse metadata files 4 months ago
bin -> 5 months ago
doc update javadoc 6 months ago
external move monero-cpp-library from ./submodules to ./external 3 months ago
src update readme 3 months ago
.classpath update classpath from monero-java-rpc to monero-java 4 months ago
.gitignore ignore "log_java_tests.txt" 3 months ago
.gitmodules move monero-cpp-library from ./submodules to ./external 3 months ago
.project rename project to monero-java 4 months ago
CMakeLists.txt move monero-cpp-library from ./submodules to ./external 3 months ago
LICENCE.txt copyright years 9 months ago update run tests readme 3 months ago
donate.png readme formatting and donation address 10 months ago
pom.xml separate jni static methods, otherwise can't build without including 7 months ago
todo.txt update readme 3 months ago

Monero Java

This project is an extensive library for interacting with a Monero wallet and daemon in Java using RPC and native bindings to Monero Core.

In addition, this project offers an API specification for interacting with a wallet and daemon. The specification is intended to be intuitive, robust, and for long-term use in the Monero project.

Main Features

  • Extensive API to interact with a Monero wallet and daemon in Java
  • RPC and JNI bindings to Monero Core
  • Query wallet transactions and outputs by their attributes
  • Fetch and process binary data from the daemon (e.g. raw blocks)
  • Over 250 automated tests

Sample Code

This code is a brief demonstration of the API. See the JavaDoc, specification PDF, or JUnit tests for details.

// connect to a daemon
MoneroDaemon daemon = new MoneroDaemonRpc("http://localhost:38081");
long height = daemon.getHeight();                 // 1523651
BigInteger feeEstimate = daemon.getFeeEstimate(); // 1014313512

// get transactions in the pool
List<MoneroTx> txsInPool = daemon.getTxPool();
for (MoneroTx tx : txsInPool) {
  String id = tx.getId();
  BigInteger fee = tx.getFee();
  boolean isDoubleSpendSeen = tx.isDoubleSpendSeen();

// get last 100 blocks as a binary request
List<MoneroBlock> blocks = daemon.getBlocksByRange(height - 100, height);
for (MoneroBlock block : blocks) {
  int numTxs = block.getTxs().size();

// mine with 2 threads in the background
String address = "74oAtjgE2dfD1bJBo4DW...";
int numThreads = 2;
boolean isBackground = true;
boolean ignoreBattery = false;
daemon.startMining(address, numThreads, isBackground, ignoreBattery);

// wait for the next block to be added to the chain
MoneroBlockHeader nextBlockHeader = daemon.getNextBlockHeader();
long nextNumTxs = nextBlockHeader.getNumTxs();

// connect to a wallet using RPC
MoneroWallet walletRPC = new MoneroWalletRpc("http://localhost:38083", "rpc_user", "abc123");
BigInteger balance = walletRPC.getBalance();           // 533648366742
String primaryAddress = walletRPC.getPrimaryAddress(); // 59aZULsUF3YNSKGiHz4J...
MoneroSubaddress subaddress = walletRPC.getSubaddress(1, 0);
BigInteger subaddressBalance = subaddress.getBalance();

// query a transaction
MoneroTxWallet tx = walletRPC.getTx("3276252c5a545b90c8e147fcde45d3e1917726470a8f7d4c8977b527a44dfd15");
List<MoneroIncomingTransfer> incomingTransfers = tx.getIncomingTransfers();
List<MoneroDestination> destinations = tx.getOutgoingTransfer().getDestinations();

// query incoming transfers to account 1
MoneroTransferQuery transferQuery = new MoneroTransferQuery().setIsIncoming(true).setAccountIndex(1);
List<MoneroTransfer> transfers = walletRPC.getTransfers(transferQuery);

// query unspent outputs
MoneroOutputQuery outputQuery = new MoneroOutputQuery().setIsSpent(false);
List<MoneroOutputWallet> outputs = walletRPC.getOutputs(outputQuery);

// create a new wallet using native Java binding to Monero Core
MoneroWalletJni walletJNI = MoneroWalletJni.createWalletRandom("MyWallet", "supersecretpassword123", MoneroNetworkType.MAINNET);

// listen for incoming funds to the JNI wallet
walletJNI.addListener(new MoneroWalletListener() {
  public void onOutputReceived(MoneroOutputWallet output) {
    System.out.println("Funds received!"); 
    int accountIdx = output.getAccountIndex();
    int subaddressIdx = output.getSubaddressIndex();
    MoneroKeyImage keyImage = output.getKeyImage();

// send funds from the RPC wallet to the JNI wallet
MoneroTxWallet sentTx = walletRPC.send(0, walletJNI.getPrimaryAddress(), new BigInteger("50000"));

// create and relay tx which sends funds to multiple destinations in the JNI wallet
MoneroSendRequest request = new MoneroSendRequest()
        .setAccountIndex(1)                           // send from account 1
        .setSubaddressIndices(0, 1)                   // send from subaddreses in account 1
        .setPriority(MoneroSendPriority.UNIMPORTANT)  // no rush
                new MoneroDestination(walletJNI.getAddress(1, 0), new BigInteger("50000")),
                new MoneroDestination(walletJNI.getAddress(2, 0), new BigInteger("50000")));
MoneroTxWallet createdTx = walletRPC.createTx(request);
BigInteger fee = createdTx.getFee();  // "Are you sure you want to send ...?"

Monero RPC Setup

  1. Download and extract the latest Monero CLI for your platform.
  2. Start Monero daemon locally: ./monerod --stagenet (or use a remote daemon).
  3. Create a wallet file if one does not exist. This is only necessary one time.
    • Create new / open existing: ./monero-wallet-cli --daemon-address http://localhost:38081 --stagenet
    • Restore from mnemonic seed: ./monero-wallet-cli --daemon-address http://localhost:38081 --stagenet --restore-deterministic-wallet
  4. Start monero-wallet-rpc (requires --wallet-dir to run tests):

    e.g. For wallet name test_wallet_1, user rpc_user, password abc123, stagenet: ./monero-wallet-rpc --daemon-address http://localhost:38081 --stagenet --rpc-bind-port 38083 --rpc-login rpc_user:abc123 --wallet-dir /Applications/monero-v0.14.0.3

Build Libraries for Java JNI

In order to use a local wallet or fetch and process binary data (e.g. raw blocks) in Java, C++ source code must be built as a dynamic library for Java to access using JNI. This project depends on the associated C++ library (included as a submodule in ./submodules/monero-cpp-library) to support a local wallet and convert between JSON and binary data in Monero’s portable storage format in Java.

The dynamic library is platform-specific so it must be built from source for the specific platform it is running on (e.g. Linux, Mac, Windows, etc).

Build Steps

  1. Build the C++ library as a dynamic library
  2. Copy the built libmonero-cpp.dylib in step 1 to ./external-libs
  3. export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk1.8.0_66.jdk/Contents/Home/ (change as appropriate)
  4. Build libmonero-java.dylib to ./build: ./bin/
  5. Copy ./build/libmonero-java.dylib to ./lib
  6. Run JUnit tests to verify the dynamic library is working with Java JNI

Run Tests

  1. Clone the Java repository: git clone --recurse-submodules
  2. Install project dependencies: maven install
  3. Set up running instances of Monero Wallet RPC and Monero Daemon RPC. See Monero RPC Setup.
  4. Configure the desired RPC endpoints, authentication, and test wallet in
  5. Build a dynamic library from Monero C++ for your platform.
  6. Run all *.java files in src/main/test as JUnits.

See Also

These libraries conform the same API specification as this library.

JavaScript reference implementation

C++ reference implementation


This project is licensed under MIT.

Donations are gratefully accepted. Thank you for supporting this project.