ethos-bitcoind 30.2.0

Generated client for ethos-bitcoind.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62

# ethos-bitcoind

[![License: CC0-1.0](https://img.shields.io/badge/license-CC0--1.0-blue)](LICENSE)
[![Docs.rs](https://img.shields.io/docsrs/ethos-bitcoind)](https://docs.rs/ethos-bitcoind)
[![crates.io](https://img.shields.io/crates/v/ethos-bitcoind)](https://crates.io/crates/ethos-bitcoind)

A type-safe Rust client for Bitcoin Core v30.2.0 RPCs.

## Why Use This?

This client aims to provide:
- Less repetitive boilerplate
- Easier upgrades across protocol versions
- Compile-time type checks for RPC requests/responses
- Managed integration testing (spawns protocol daemons as subprocesses, handles ports)

## Project Structure

- `client_trait/`: Rust traits for Bitcoin Core RPC endpoints
- `node/`: Node manager for process orchestration in integration environments
- `bitcoin_core_clients/`: Utilities for driving integration tests against spawned local nodes
- `transport/`: Async transport layer with batching and error handling
- `types/`: Typed response structs and enums for all RPC methods

## Example

This async example (using [Tokio](https://tokio.rs)) demonstrates integration testing with a spawned node:

```toml
[dependencies]
ethos-bitcoind = "30.2.0"
tokio = { version = "1", features = ["full"] }
```

```rust
#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let manager = crate::node::BitcoinNodeManager::new()?;
    manager.start().await?;
    let transport = manager.create_transport().await?;
    let client = crate::BitcoinTestClient::new(transport);
    let result = client.getblockchaininfo().await?;
    println!("Blockchain info: {:?}", result);
    manager.stop().await?;
    Ok(())
}
```

## Requirements
Requires a working `bitcoind` in `$PATH`.

## About
This crate is generated by [ethos](https://github.com/nervana21/ethos). Its code is kept synchronized with upstream protocol changes through code generation.

## Contributing
See [CONTRIBUTING.md](CONTRIBUTING.md).

## License
Ethos is released under the terms of the CC0-1.0 license. See [LICENSE](LICENSE) for details.

## Security
This library launches Bitcoin Core daemons for local integration testing. For real network use, use strong network/firewall controls and carefully audit all dependencies.