blvm-node 0.1.5

Bitcoin Commons BLVM: Minimal Bitcoin node implementation using blvm-protocol and blvm-consensus
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

//! Example: Basic wallet integration with blvm-node
//!
//! This example shows how to use blvm-node RPC API for wallet operations.
//! This demonstrates the RPC calls wallets need - actual wallets handle key management separately.
//!
//! This example shows the RPC request format. To test with a running node:
//!   1. Start blvm-node: blvm-node --network testnet
//!   2. Run this example: cargo run --example wallet-integration
//!
//! Or use curl:
//!   curl -X POST http://127.0.0.1:18332 \\
//!     -H "Content-Type: application/json" \\
//!     -d '{"jsonrpc":"2.0","method":"getblockchaininfo","params":[],"id":1}'

use serde_json::json;

fn main() -> anyhow::Result<()> {
    println!("blvm-node Wallet Integration RPC Examples");
    println!("============================================");
    println!();
    println!("This example shows the RPC calls wallets need to integrate with blvm-node.");
    println!("All methods are Bitcoin Core-compatible.");
    println!();

    // RPC endpoint (adjust for your setup)
    let rpc_url = "http://127.0.0.1:18332"; // Testnet
                                            // let rpc_url = "http://127.0.0.1:8332"; // Mainnet

    println!("RPC Endpoint: {rpc_url}");
    println!();
    println!("Example RPC Requests:");
    println!();

    // Example 1: Get blockchain info
    println!("1. getblockchaininfo - Get chain state");
    let request = json!({
        "jsonrpc": "2.0",
        "method": "getblockchaininfo",
        "params": [],
        "id": 1
    });
    println!("   Request: {}", serde_json::to_string_pretty(&request)?);
    println!("   Use: Check chain state, block height, best block hash");
    println!();

    // Example 2: Get UTXO (for checking balance)
    println!("2. gettxout - Get UTXO information");
    let txid = "0000000000000000000000000000000000000000000000000000000000000000";
    let vout = 0;
    let request = json!({
        "jsonrpc": "2.0",
        "method": "gettxout",
        "params": [txid, vout, true],
        "id": 2
    });
    println!("   Request: {}", serde_json::to_string_pretty(&request)?);
    println!("   Use: Check if UTXO exists, get value and confirmations");
    println!("   Note: Replace txid/vout with actual values");
    println!();

    // Example 3: Get raw transaction
    println!("3. getrawtransaction - Get transaction data");
    let request = json!({
        "jsonrpc": "2.0",
        "method": "getrawtransaction",
        "params": [txid, true],
        "id": 3
    });
    println!("   Request: {}", serde_json::to_string_pretty(&request)?);
    println!("   Use: Get transaction details for history");
    println!();

    // Example 4: Send raw transaction
    println!("4. sendrawtransaction - Broadcast transaction");
    let raw_tx =
        "01000000010000000000000000000000000000000000000000000000000000000000000000ffffffff...";
    let request = json!({
        "jsonrpc": "2.0",
        "method": "sendrawtransaction",
        "params": [raw_tx],
        "id": 4
    });
    println!("   Request: {}", serde_json::to_string_pretty(&request)?);
    println!("   Use: Broadcast signed transaction to network");
    println!("   Note: Wallet creates and signs transaction, node broadcasts");
    println!();

    // Example 5: Estimate fee
    println!("5. estimatesmartfee - Get fee estimation");
    let request = json!({
        "jsonrpc": "2.0",
        "method": "estimatesmartfee",
        "params": [6],
        "id": 5
    });
    println!("   Request: {}", serde_json::to_string_pretty(&request)?);
    println!("   Use: Get recommended fee rate for transaction");
    println!();

    println!("Integration Checklist:");
    println!("  ✅ getblockchaininfo - Chain state");
    println!("  ✅ gettxout - UTXO queries (balance checking)");
    println!("  ✅ getrawtransaction - Transaction data");
    println!("  ✅ sendrawtransaction - Transaction broadcasting");
    println!("  ✅ estimatesmartfee - Fee estimation");
    println!();
    println!("To test with a running node:");
    println!("  1. Start node: blvm-node --network testnet");
    println!("  2. Use curl or your HTTP client to send these requests");
    println!("  3. Or use the blvm-sdk for Rust integration");
    println!();
    println!("Your wallet can now integrate with blvm-node!");

    Ok(())
}