Build Status unsafe forbidden Crates.io Documentation License MSRV

Monero Daemon & Wallet RPC

Monero daemon and wallet RPC written in asynchronous Rust :crab:.

Example with tokio::test

Create the RPC client and transform it into a deamon RPC to call /get_transactions method and print the result.

```rust use monero_rpc::{RpcClient, JsonTransaction};

[tokio::test]

async fn monerodaemontransactionstest() { let txid = "7c50844eced8ab78a8f26a126fbc1f731134e0ae3e6f9ba0f205f98c1426ff60".tostring(); let rpcclient = monerorpc::RpcClient::new("http://node.monerooutreach.org:18081".tostring()); let daemonrpcclient = rpcclient.daemonrpc(); let mut fixedhash: [u8; 32] = [0; 32]; hex::decodetoslice(txid, &mut fixedhash).unwrap(); let tx = daemonrpcclient .gettransactions(vec![fixedhash.into()], Some(true), Some(true)) .await; println!("tx {:?}", tx); println!( "unlock time: {:?}", serdejson::fromstr::(&tx.unwrap().txsas_json.unwrap()[0]) ); } ```

Testing

First, you'll need docker and docker-compose to run the RPC integration tests, which are in tests/, in case you don't want to run monerod and monero-wallet-rpc on your own.

If you have the docker stack installed, go to the tests folder and run docker-compose up. Note that the daemon will run on port 18081 and monero-wallet-rpc will run on port 18083.

After that, just run cargo test as you normally would.

Also, you can run docker-compose down to stop and remove the two containers started by docker-compose up.

Important: the blockchain must be empty when running the main_functional_test test on tests/rpc.rs, i.e. it must have only the genesis block. In regtest, the blockchain restarts when monerod restarts (as a side note, if you want to keep the blockchain in regtest between restarts, you should pass the --keep-fakechain flag when starting monerod).

Releases and Changelog

See CHANGELOG.md and RELEASING.md.

Licensing

The code in this project is licensed under the Apache-2.0