Rust bindings

.gitignore

@@ -1,2 +1,2 @@
 release/
-build/
+build/

impls/monero.rs/.gitignore

@@ -0,0 +1,3 @@
+target/
+scripts/monero_c
+lib/

impls/monero.rs/Cargo.toml

@@ -0,0 +1,21 @@
+[package]
+name = "monero_rust"
+version = "0.0.1"
+edition = "2021"
+description = "monero_c Rust bindings."
+repository = "https://github.com/ManyMath/monero_rust"
+license = "MIT"
+build = "build.rs"
+
+[lib]
+name = "monero_rust"
+path = "src/lib.rs"
+crate-type = ["lib", "cdylib"]
+
+[dependencies]
+libc = "0.2"
+libloading = "0.8.5"
+
+[build-dependencies]
+bindgen = "0.70.1"
+

impls/monero.rs/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2024 Joshua Babb
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

impls/monero.rs/README.md

@@ -0,0 +1,46 @@
+# `monero_rust`
+Proof of concept `monero_c` bindings for Rust.
+
+## Getting started
+<!--
+### Prerequisites
+You may need
+```
+sudo apt-get install libhidapi-dev
+```
+-->
+### Build `monero_c`
+Build the monero_c library for your architecture.  Follow the upstream docs at 
+https://github.com/MrCyjaneK/monero_c <!-- TODO: use example CMakeLists --> and 
+place the library at `monero_c/impls/monero_rust/lib/libwallet2_api_c.so` or use 
+the provided script:
+```
+cd scripts
+./build_monero_c.sh
+```
+
+or build it manually as in:
+```
+git clone https://git.mrcyjanek.net/MrCyjaneK/monero_c --branch rust
+cd monero_c
+git submodule update --init --recursive
+rm -rf monero wownero release # Clean any previous builds.
+git submodule update --init --recursive --force
+./apply_patches.sh monero
+./build_single.sh monero x86_64-linux-gnu -j$(nproc)
+
+# Adjust the commands below for your arch.
+unxz -f release/monero/x86_64-linux-gnu_libwallet2_api_c.so.xz
+mv release/monero/x86_64-linux-gnu_libwallet2_api_c.so ../lib/libwallet2_api_c.so
+# The library should be at monero_c/impls/monero_rust/lib/libwallet2_api_c.so.
+```
+
+### Run `monero_rust` demo
+From `monero_c/impls/monero_rust`:
+```
+cargo run
+```
+
+## Using `monero_rust` in your own crate
+Refer to the `example` folder.  `libwallet2_api_c.so` must be in the same 
+directory as the binary (*eg.* at `example/target/debug/libwallet2_api_c.so`).