Monero Java Library (lite)

A minimum Java library for using monero-wallet-rpc

License	MIT License The Apache License, Version 2.0
Categories	Java Languages
GroupId	io.github.woodser
ArtifactId	monero-java-lite
Last Version	0.2.1
Release Date	Dec 20, 2019
Type	jar
Description	Monero Java Library (lite) A minimum Java library for using monero-wallet-rpc
Project URL	https://github.com/woodser/monero-java-lite
Source Code Management	http://github.com/woodser/monero-java-lite/tree/master

Download monero-java-lite

Filename	Size
monero-java-lite-0.2.1.pom
monero-java-lite-0.2.1.jar	134 KB
monero-java-lite-0.2.1-sources.jar	84 KB
monero-java-lite-0.2.1-javadoc.jar	417 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/io.github.woodser/monero-java-lite/ -->
<dependency>
    <groupId>io.github.woodser</groupId>
    <artifactId>monero-java-lite</artifactId>
    <version>0.2.1</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/io.github.woodser/monero-java-lite/
implementation 'io.github.woodser:monero-java-lite:0.2.1'

Gradle Kotlin

// https://jarcasting.com/artifacts/io.github.woodser/monero-java-lite/
implementation ("io.github.woodser:monero-java-lite:0.2.1")

Apache Buildr

'io.github.woodser:monero-java-lite:jar:0.2.1'

Apache Ivy

<dependency org="io.github.woodser" name="monero-java-lite" rev="0.2.1">
  <artifact name="monero-java-lite" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='io.github.woodser', module='monero-java-lite', version='0.2.1')
)

Scala SBT

libraryDependencies += "io.github.woodser" % "monero-java-lite" % "0.2.1"

Leiningen

[io.github.woodser/monero-java-lite "0.2.1"]

Dependencies

compile (2)

Group / Artifact	Type	Version
com.google.code.gson : gson	jar	2.7
org.apache.httpcomponents : httpclient	jar	4.5.3

test (1)

Group / Artifact	Type	Version
junit : junit	jar	4.12

Project Modules

There are no modules declared in this project.

Monero Java Library (lite)

This project is a version of monero-java which supports only basic wallet functionality using monero-wallet-rpc.

This project conforms to an API specification intended to be intuitive, robust, and suitable for long-term use in the Monero project.

Main Features

• Manage a Monero wallet using RPC
• Cohesive APIs with rigorous focus on ease-of-use
• Query wallet transactions, transfers, and outputs by their many attributes
• Over 145 passing JUnit test cases

How to Use This Library

For Maven, add to pom.xml:

<dependency>
  <groupId>io.github.woodser</groupId>
  <artifactId>monero-java-lite</artifactId>
  <version>0.2.1</version>
</dependency>

For Gradle, add to build.gradle:

compile 'io.github.woodser:monero-java-lite:0.2.1'

You are now ready to use this library with monero-wallet-rpc.

How to Run Monero RPC

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.

   • 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 ./

How to Run JUnit Tests

1. Clone the Java repository: git clone --recurse-submodules https://github.com/woodser/monero-java-lite.git
2. Install project dependencies: mvn install
3. Run monero-wallet-rpc. See How to Run Monero RPC.
4. Configure the appropriate RPC endpoints, authentication, and test wallet in TestUtils.java.
5. Run all *.java files in src/main/test as JUnits.

See Also

These libraries conform to the same API specification.

Java reference implementation (full version)

JavaScript reference implementation

C++ reference implementation

License

This project is licensed under MIT.

Donate

Donations are gratefully accepted. Thank you for your support!

46FR1GKVqFNQnDiFkH7AuzbUBrGQwz2VdaXTDD4jcjRE8YkkoTYTmZ2Vohsz9gLSqkj5EM6ai9Q7sBoX4FPPYJdGKQQXPVz

Versions

Version
0.2.1 Dec 20, 2019
0.2.0 Dec 18, 2019