rust-bitcoin / corepc

Rust library for interacting with Bitcoin Core over JSONRPC
Creative Commons Zero v1.0 Universal
1 stars 1 forks source link

Bitcoin Core JSON-RPC support

There are two primary purposes of this repository:

  1. Provide the corepc-types crate for use in production software.

  2. Provide tools for integration testing Rust code that interacts with the Bitcoin network. Primarily consumers of the rust-bitcoin library. And enable doing so against multiple versions of Bitcoin Core.

If you require a JSON RPC client in production software it is expected you write your own and only use the corepc-types crate in your dependency graph. Feel free to copy/steal/plagiarise or otherwise enjoy yourself with anything in this repository - no attribution required.

Contributing

PRs, feature requests, and bug reports against corepc-types most welcome and appreciated.

PRs, feature requests, and bug reports against the other crates welcome if you are using them for integration testing.

Please do not use corepc-client in production and raise bugs, issues, or feature requests.

Crate/directory listing

Design

This repository is a bit oddly designed. It was done so very intentionally.

Original code

I don't know who is using bitcoind and/or rust-bitocincore-rpc in the wild and I do not want to disrupt them. As such bitcoind was pulled in here with permission of the original author.

Some code shamelessly stolen from rust-bitcoincore-rpc (credit to Steven).

Minimum Supported Rust Version (MSRV)

This library should always compile with any combination of features on Rust 1.63.0.

Use Cargo-minimal.lock to build the MSRV by copying to Cargo.lock and building.