Introduction

This project provides a Java interface for managing a Monero wallet.

The interface relies on a running instance of Monero Wallet RPC to manage the wallet. Monero Wallet RPC is an application that manages a Monero wallet via remote procedure calls and relies on a full node to interact with the Monero blockchain.

Getting started

1. Download and extract the latest Monero CLI for your platform.
2. In a command terminal, cd to the extracted directory.
3. Create a Monero wallet for development and tests:
   • New testnet wallet: ./monero-wallet-cli --testnet --daemon-address http://node.xmrbackb.one:28081
   • Restore testnet wallet: ./monero-wallet-cli --restore-deterministic-wallet --testnet --daemon-address http://node.xmrbackb.one:28081
4. Start monero-wallet-rpc:
   • Example: wallet name TestWallet, user rpc_user, password abc123: ./monero-wallet-rpc --testnet --daemon-address http://node.xmrbackb.one:28081 --rpc-bind-port 18082 --wallet-file /Applications/monero-v0.11.1.0/TestWallet --rpc-login rpc_user:abc123
5. Download the latest code from this GitHub repository:
   1. Create a directory to hold project assets: mkdir monero_wallet_java && cd monero_wallet_java
   2. Check out the code: git clone https://github.com/woodser/monero-wallet-java.git
   3. Optionally import the Java projects into an IDE like Eclipse
6. If necessary, configure the default wallet for running JUnit tests within TestUtils.java. The RPC domain, port, and authentication username and password can be configured.
7. Run JUnits under src/test/java to verify the setup. Note that TestMoneroWalletSends.java requires sufficient funds to be available in the wallet to test sending payments (hence why testnet mode is recommended, so it's not real XMR).

Supported Methods

public int getHeight();
public BigInteger getBalance();
public BigInteger getUnlockedBalance();
public MoneroAddress getStandardAddress();
public MoneroIntegratedAddress getIntegratedAddress(String paymentId);
public MoneroIntegratedAddress splitIntegratedAddress(String integratedAddress);
public String getMnemonicSeed();
public String getViewKey();
public URI toUri(MoneroUri uri);
public MoneroUri fromUri(URI uri);
public void saveBlockchain();
public void stopWallet();
public MoneroTransaction send(String address, BigInteger amount, String paymentId, BigInteger fee, int mixin, int unlockTime);
public MoneroTransaction send(MoneroAddress address, BigInteger amount, String paymentId, BigInteger fee, int mixin, int unlockTime);
public MoneroTransaction send(MoneroPayment payment, String paymentId, BigInteger fee, int mixin, int unlockTime);
public MoneroTransaction send(List<MoneroPayment> payments, String paymentId, BigInteger fee, int mixin, int unlockTime);
public List<MoneroTransaction> sendSplit(List<MoneroPayment> payments, String paymentId, BigInteger fee, int mixin, int unlockTime, Boolean newAlgorithm);
public List<MoneroTransaction> sweepDust();
public List<MoneroTransaction> getAllTransactions();
public List<MoneroTransaction> getTransactions(boolean getIncoming, boolean getOutgoing, boolean getPending, boolean getFailed, boolean getMemPool, Collection<String> paymentIds, Integer minHeight, Integer maxHeight);

License

This project is licensed under Apache 2.0 and MIT.