sal-mycelium 0.1.0

SAL Mycelium - Client interface for interacting with Mycelium node's HTTP API
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
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119

# SAL Mycelium (`sal-mycelium`)

A Rust client library for interacting with Mycelium node's HTTP API, with Rhai scripting support.

## Installation

Add this to your `Cargo.toml`:

```toml
[dependencies]
sal-mycelium = "0.1.0"
```

## Overview

SAL Mycelium provides async HTTP client functionality for managing Mycelium nodes, including:

- Node information retrieval
- Peer management (list, add, remove)
- Route inspection (selected and fallback routes)
- Message operations (send and receive)

## Usage

### Rust API

```rust
use sal_mycelium::*;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let api_url = "http://localhost:8989";
    
    // Get node information
    let node_info = get_node_info(api_url).await?;
    println!("Node info: {:?}", node_info);
    
    // List peers
    let peers = list_peers(api_url).await?;
    println!("Peers: {:?}", peers);
    
    // Send a message
    use std::time::Duration;
    let result = send_message(
        api_url,
        "destination_ip",
        "topic",
        "Hello, Mycelium!",
        Some(Duration::from_secs(30))
    ).await?;
    
    Ok(())
}
```

### Rhai Scripting

```rhai
// Get node information
let api_url = "http://localhost:8989";
let node_info = mycelium_get_node_info(api_url);
print(`Node subnet: ${node_info.nodeSubnet}`);

// List peers
let peers = mycelium_list_peers(api_url);
print(`Found ${peers.len()} peers`);

// Send message (timeout in seconds, -1 for no timeout)
let result = mycelium_send_message(api_url, "dest_ip", "topic", "message", 30);
```

## API Functions

### Core Functions

- `get_node_info(api_url)` - Get node information
- `list_peers(api_url)` - List connected peers
- `add_peer(api_url, peer_address)` - Add a new peer
- `remove_peer(api_url, peer_id)` - Remove a peer
- `list_selected_routes(api_url)` - List selected routes
- `list_fallback_routes(api_url)` - List fallback routes
- `send_message(api_url, destination, topic, message, timeout)` - Send message
- `receive_messages(api_url, topic, timeout)` - Receive messages

### Rhai Functions

All functions are available in Rhai with `mycelium_` prefix:
- `mycelium_get_node_info(api_url)`
- `mycelium_list_peers(api_url)`
- `mycelium_add_peer(api_url, peer_address)`
- `mycelium_remove_peer(api_url, peer_id)`
- `mycelium_list_selected_routes(api_url)`
- `mycelium_list_fallback_routes(api_url)`
- `mycelium_send_message(api_url, destination, topic, message, timeout_secs)`
- `mycelium_receive_messages(api_url, topic, timeout_secs)`

## Requirements

- A running Mycelium node with HTTP API enabled
- Default API endpoint: `http://localhost:8989`

## Testing

```bash
# Run all tests
cargo test

# Run with a live Mycelium node for integration tests
# (tests will skip if no node is available)
cargo test -- --nocapture
```

## Dependencies

- `reqwest` - HTTP client
- `serde_json` - JSON handling
- `base64` - Message encoding
- `tokio` - Async runtime
- `rhai` - Scripting support