Libraries for building Monero applications, in the language you already use.
libmonero maintains a family of Monero libraries that share one thing: the same data model and API. Learn it once, and the wallet, the daemon, the transactions and the listeners look the same in C++, C, Python, Java, Kotlin and C#.
Every library is built to the same ideas:
- One clearly defined data model and API specification, intended to be intuitive and robust, and implemented the same way in every language.
- RPC clients and native bindings. Talk to
monerodandmonero-wallet-rpc, or run a fully client-side wallet on top of monero-project/monerowallet2. - Interchangeable implementations. A wallet backed by RPC and a wallet backed by native bindings conform to the same interface, so you can swap one for the other without rewriting your application.
- Multisig, view-only, offline and keys-only wallets.
- Query and listen. Find transactions, transfers and outputs by their properties, and receive notifications when blocks are added or when a wallet syncs, sends or receives.
- Tested against real daemons and wallets, with unit and integration tests in CI.
flowchart TD
monero["monero-project/monero<br/>(wallet2, daemon, RPC)"]
cpp["monero-cpp<br/>C++ data model and API"]
c["monero-c<br/>C ABI"]
py["monero-python"]
java["monero-java"]
kt["monero-kotlin"]
cs["monero-csharp"]
apps["Your application"]
monero --> cpp
cpp --> c
cpp -- "pybind11" --> py
cpp -- "JNI" --> java
c -- "FFI" --> kt
c -- "P/Invoke" --> cs
cpp --> apps
py --> apps
java --> apps
kt --> apps
cs --> apps
monero-cpp wraps Monero's wallet2 and defines the data model. monero-c exposes it as a C ABI, so any language with an FFI can build on it. Python and Java bind to monero-cpp directly. Kotlin and C# bind to monero-c.
| Repository | Language | Bindings | Notes |
|---|---|---|---|
| monero-cpp | C++ | wraps wallet2 |
Core library and reference data model. Wallet and daemon RPC clients, full, keys-only, multisig, view-only and offline wallets. |
| monero-c | C | C ABI over monero-cpp | Opaque handles, JSON data and listener callbacks. Foundation for FFI bindings. |
| monero-python | Python 3.10 to 3.14 | pybind11 | Prebuilt .deb and wheel packages, documentation. |
| monero-java | Java | JNI | Over 300 tests. |
| monero-kotlin | Kotlin | monero-c | Linux, macOS, Windows and Android (AAR). |
| monero-csharp | C# (.NET 10) | monero-c (P/Invoke) | Async API with cancellation. |
| Repository | Description |
|---|---|
| docker-monero-rpc | Docker images for monerod and monero-wallet-rpc, for development and testing against regtest or mainnet. |
Note
Most of these projects are under development and unfunded. Expect bugs and breaking changes, and read the status notice at the top of each repository before depending on it. Wallets handle real funds: test on stagenet or testnet first.
Connect to a daemon and read the chain height, in every language:
# Python
from monero import *
daemon = MoneroDaemonRpc("http://localhost:38081", "superuser", "abctesting123")
height = daemon.get_height() # 1523651
wallet = MoneroWalletRpc("http://localhost:38083", "rpc_user", "abc123")
wallet.open_wallet("sample_wallet_rpc", "supersecretpassword123")
balance = wallet.get_balance() # 533648366742 (atomic units)// Java
import monero.daemon.MoneroDaemon;
import monero.daemon.MoneroDaemonRpc;
MoneroDaemon daemon = new MoneroDaemonRpc("http://localhost:38081", "superuser", "abctesting123");
long height = daemon.getHeight(); // 1523651// Kotlin
import monero.daemon.MoneroDaemonRpc
MoneroDaemonRpc("http://localhost:38081", "superuser", "abctesting123").use { daemon ->
val height = daemon.getHeight() // 1523651
}// C#
using Monero.Daemon;
MoneroDaemon daemon = new MoneroDaemonRpc("http://localhost:38081", "superuser", "abctesting123");
ulong height = await daemon.GetHeightAsync(); // 1523651Contributions are welcome in every repository: bug reports, tests, documentation, new language bindings and fixes. Read the contributing guide and open an issue to discuss larger changes before sending a pull request.
Because the libraries share a model, an API change usually starts in the specification and then lands in each language.
Do not report vulnerabilities in public issues. Follow the security policy instead.
libmonero builds on the work of the Monero Project and on woodser's monero-cpp, monero-java and monero-ts.
The libraries are released under the MIT License.
