Compare commits
6 Commits
Author | SHA1 | Date | |
---|---|---|---|
fe1c4ee2c8 | |||
ca10284479 | |||
afd21a5f2a | |||
d154567aeb | |||
8965a06dbe | |||
134504e870 |
68
README.md
68
README.md
@ -28,3 +28,71 @@ The `bal-server` application can be configured using environment variables. The
|
|||||||
| `BAL_SERVER_TESTNET_FIXED_FEE` | Fixed fee for the testnet environment. | 50000 |
|
| `BAL_SERVER_TESTNET_FIXED_FEE` | Fixed fee for the testnet environment. | 50000 |
|
||||||
| `BAL_SERVER_BITCOIN_ADDRESS` | Bitcoin address for the mainnet environment. | - |
|
| `BAL_SERVER_BITCOIN_ADDRESS` | Bitcoin address for the mainnet environment. | - |
|
||||||
| `BAL_SERVER_BITCOIN_FIXED_FEE` | Fixed fee for the mainnet environment. | 50000 |
|
| `BAL_SERVER_BITCOIN_FIXED_FEE` | Fixed fee for the mainnet environment. | 50000 |
|
||||||
|
# bal-pusher
|
||||||
|
|
||||||
|
`bal-pusher` is a tool that retrieves Bitcoin transactions from a database and pushes them to the Bitcoin network when their **locktime** exceeds the **median time past** (MTP). It listens for Bitcoin block updates via ZMQ.
|
||||||
|
|
||||||
|
## Installation
|
||||||
|
|
||||||
|
To use `bal-pusher`, you need to compile and install Bitcoin with ZMQ (ZeroMQ) support enabled. Then, configure your Bitcoin node and `bal-pusher` to push the transactions.
|
||||||
|
|
||||||
|
### Prerequisites
|
||||||
|
|
||||||
|
1. **Bitcoin with ZMQ Support**:
|
||||||
|
Ensure that Bitcoin is compiled with ZMQ support. Add the following line to your `bitcoin.conf` file:
|
||||||
|
|
||||||
|
```
|
||||||
|
zmqpubhashblock=tcp://127.0.0.1:28332
|
||||||
|
```
|
||||||
|
|
||||||
|
2. **Install Rust and Cargo**:
|
||||||
|
If you haven't already installed Rust and Cargo, you can follow the official instructions to do so: [Rust Installation](https://www.rust-lang.org/tools/install).
|
||||||
|
|
||||||
|
### Installation Steps
|
||||||
|
|
||||||
|
1. Clone the repository:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
git clone <repo-url>
|
||||||
|
cd bal-pusher
|
||||||
|
```
|
||||||
|
|
||||||
|
2. Build the project:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cargo build --release
|
||||||
|
```
|
||||||
|
|
||||||
|
3. Install the binary:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo cp target/release/bal-pusher /usr/local/bin
|
||||||
|
```
|
||||||
|
|
||||||
|
## Configuration
|
||||||
|
|
||||||
|
`bal-pusher` can be configured using environment variables. If no configuration file is provided, a default configuration file will be created.
|
||||||
|
|
||||||
|
### Available Configuration Variables
|
||||||
|
|
||||||
|
| Variable | Description | Default |
|
||||||
|
|---------------------------------------|------------------------------------------|----------------------------------------------|
|
||||||
|
| `BAL_PUSHER_CONFIG_FILE` | Path to the configuration file. If the file does not exist, it will be created. | `$HOME/.config/bal-pusher/default-config.toml` |
|
||||||
|
| `BAL_PUSHER_DB_FILE` | Path to the SQLite3 database file. If the file does not exist, it will be created. | `bal.db` |
|
||||||
|
| `BAL_PUSHER_ZMQ_LISTENER` | ZMQ listener for Bitcoin updates. | `tcp://127.0.0.1:28332` |
|
||||||
|
| `BAL_PUSHER_BITCOIN_HOST` | Bitcoin server host for RPC connections. | `http://127.0.0.1` |
|
||||||
|
| `BAL_PUSHER_BITCOIN_PORT` | Bitcoin RPC server port. | `8332` |
|
||||||
|
| `BAL_PUSHER_BITCOIN_COOKIE_FILE` | Path to Bitcoin RPC cookie file. | `$HOME/.bitcoin/.cookie` |
|
||||||
|
| `BAL_PUSHER_BITCOIN_RPC_USER` | Bitcoin RPC username. | - |
|
||||||
|
| `BAL_PUSHER_BITCOIN_RPC_PASSWORD` | Bitcoin RPC password. | - |
|
||||||
|
|
||||||
|
|
||||||
|
## Running `bal-pusher`
|
||||||
|
|
||||||
|
Once the application is installed and configured, you can start `bal-pusher` by running the following command:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
$ bal-pusher
|
||||||
|
```
|
||||||
|
|
||||||
|
This will start the service, which will listen for Bitcoin blocks via ZMQ and push transactions from the database when their locktime exceeds the median time past.
|
||||||
|
11
bal-pusher.env
Normal file
11
bal-pusher.env
Normal file
@ -0,0 +1,11 @@
|
|||||||
|
RUST_LOG=info
|
||||||
|
|
||||||
|
BAL_PUSHER_DB_FILE=/home/bal/bal.db
|
||||||
|
BAL_PUSHER_BITCOIN_COOKIE_FILE=/home/bitcoin/.bitcoin/.cookie
|
||||||
|
BAL_PUSHER_REGTEST_COOKIE_FILE=/home/bitcoin/.bitcoin/regtest/.cookie
|
||||||
|
BAL_PUSHER_TESTNET_COOKIE_FILE=/home/bitcoin/.bitcoin/testnet3/.cookie
|
||||||
|
BAL_PUSHER_SIGNET_COOKIE_FILE=/home/bitcoin/.bitcoin/signet/.cookie
|
||||||
|
|
||||||
|
BAL_PUSHER_ZMQ_LISTENER=tcp://127.0.0.1:28332
|
||||||
|
|
||||||
|
|
@ -9,8 +9,6 @@ use sqlite::{Value};
|
|||||||
use serde::Serialize;
|
use serde::Serialize;
|
||||||
use serde::Deserialize;
|
use serde::Deserialize;
|
||||||
use std::env;
|
use std::env;
|
||||||
use std::fs::OpenOptions;
|
|
||||||
use std::io::{ Write};
|
|
||||||
use log::{info,warn,error,trace,debug};
|
use log::{info,warn,error,trace,debug};
|
||||||
use zmq::{Context, Socket};
|
use zmq::{Context, Socket};
|
||||||
use std::str;
|
use std::str;
|
||||||
@ -203,15 +201,21 @@ fn main_result(cfg: &MyConfig, network_params: &NetworkParams) -> Result<(), Err
|
|||||||
//}
|
//}
|
||||||
//let average_time = time_sum/11;
|
//let average_time = time_sum/11;
|
||||||
info!("median time: {}",bcinfo.median_time);
|
info!("median time: {}",bcinfo.median_time);
|
||||||
|
info!("blocks: {}",bcinfo.blocks);
|
||||||
|
debug!("best block hash: {}",bcinfo.best_block_hash);
|
||||||
|
|
||||||
let average_time = bcinfo.median_time;
|
let average_time = bcinfo.median_time;
|
||||||
let db = sqlite::open(&cfg.db_file).unwrap();
|
let db = sqlite::open(&cfg.db_file).unwrap();
|
||||||
|
|
||||||
|
|
||||||
|
let sqlquery = "SELECT * FROM tbl_tx WHERE network = :network AND status = :status AND ( locktime < :bestblock_height OR locktime > :locktime_threshold AND locktime < :bestblock_time);";
|
||||||
|
let query_tx = db.prepare(sqlquery).unwrap().into_iter();
|
||||||
|
trace!("query_tx: {}",sqlquery);
|
||||||
trace!(":locktime_threshold: {}", LOCKTIME_THRESHOLD );
|
trace!(":locktime_threshold: {}", LOCKTIME_THRESHOLD );
|
||||||
trace!(":bestblock_time: {}", average_time);
|
trace!(":bestblock_time: {}", average_time);
|
||||||
trace!(":bestblock_height: {}", bcinfo.blocks);
|
trace!(":bestblock_height: {}", bcinfo.blocks);
|
||||||
trace!(":network: {}", network_params.db_field.clone());
|
trace!(":network: {}", network_params.db_field.clone());
|
||||||
trace!(":status: {}", 0);
|
trace!(":status: {}", 0);
|
||||||
|
|
||||||
let query_tx = db.prepare("SELECT * FROM tbl_tx WHERE network = :network AND status = :status AND ( locktime < :bestblock_height OR locktime > :locktime_threshold AND locktime < :bestblock_time);").unwrap().into_iter();
|
|
||||||
//let query_tx = db.prepare("SELECT * FROM tbl_tx where status = :status").unwrap().into_iter();
|
//let query_tx = db.prepare("SELECT * FROM tbl_tx where status = :status").unwrap().into_iter();
|
||||||
let mut pushed_txs:Vec<String> = Vec::new();
|
let mut pushed_txs:Vec<String> = Vec::new();
|
||||||
let mut invalid_txs: std::collections::HashMap<String, String> = HashMap::new();
|
let mut invalid_txs: std::collections::HashMap<String, String> = HashMap::new();
|
||||||
@ -231,25 +235,26 @@ fn main_result(cfg: &MyConfig, network_params: &NetworkParams) -> Result<(), Err
|
|||||||
info!("to be pushed: {}: {}",txid, locktime);
|
info!("to be pushed: {}: {}",txid, locktime);
|
||||||
match rpc.send_raw_transaction(tx){
|
match rpc.send_raw_transaction(tx){
|
||||||
Ok(o) => {
|
Ok(o) => {
|
||||||
let mut file = OpenOptions::new()
|
/*let mut file = OpenOptions::new()
|
||||||
.append(true) // Set the append option
|
.append(true) // Set the append option
|
||||||
.create(true) // Create the file if it doesn't exist
|
.create(true) // Create the file if it doesn't exist
|
||||||
.open("valid_txs")?;
|
.open("valid_txs")?;
|
||||||
let data = format!("{}\t:\t{}\t:\t{}\n",txid,average_time,locktime);
|
let data = format!("{}\t:\t{}\t:\t{}\n",txid,average_time,locktime);
|
||||||
file.write_all(data.as_bytes())?;
|
file.write_all(data.as_bytes())?;
|
||||||
drop(file);
|
drop(file);
|
||||||
|
*/
|
||||||
info!("tx: {} pusshata PUSHED\n{}",txid,o);
|
info!("tx: {} pusshata PUSHED\n{}",txid,o);
|
||||||
pushed_txs.push(txid.to_string());
|
pushed_txs.push(txid.to_string());
|
||||||
},
|
},
|
||||||
Err(err) => {
|
Err(err) => {
|
||||||
let mut file = OpenOptions::new()
|
/*let mut file = OpenOptions::new()
|
||||||
.append(true) // Set the append option
|
.append(true) // Set the append option
|
||||||
.create(true) // Create the file if it doesn't exist
|
.create(true) // Create the file if it doesn't exist
|
||||||
.open("invalid_txs")?;
|
.open("/home/bal/invalid_txs")?;
|
||||||
let data = format!("{}:\t{}\t:\t{}\t:\t{}\n",txid,err,average_time,locktime);
|
let data = format!("{}:\t{}\t:\t{}\t:\t{}\n",txid,err,average_time,locktime);
|
||||||
file.write_all(data.as_bytes())?;
|
file.write_all(data.as_bytes())?;
|
||||||
drop(file);
|
drop(file);
|
||||||
|
*/
|
||||||
warn!("Error: {}\n{}",err,txid);
|
warn!("Error: {}\n{}",err,txid);
|
||||||
//store err in invalid_txs
|
//store err in invalid_txs
|
||||||
invalid_txs.insert(txid.to_string(), err.to_string());
|
invalid_txs.insert(txid.to_string(), err.to_string());
|
||||||
@ -427,7 +432,7 @@ fn main(){
|
|||||||
debug!("ZMQ:GET TOPIC: {}", String::from_utf8(topic.clone()).expect("invalid topic"));
|
debug!("ZMQ:GET TOPIC: {}", String::from_utf8(topic.clone()).expect("invalid topic"));
|
||||||
trace!("ZMQ:GET BODY: {}", hex::encode(&body));
|
trace!("ZMQ:GET BODY: {}", hex::encode(&body));
|
||||||
if topic == b"hashblock" {
|
if topic == b"hashblock" {
|
||||||
info!("NEW BLOCK{}", hex::encode(&body));
|
info!("NEW BLOCK: {}", hex::encode(&body));
|
||||||
//let cfg = cfg.clone();
|
//let cfg = cfg.clone();
|
||||||
let _ = main_result(&cfg,network_params);
|
let _ = main_result(&cfg,network_params);
|
||||||
}
|
}
|
||||||
|
@ -33,7 +33,7 @@ use crate::db::{ create_database, get_next_address_index, insert_xpub, save_new_
|
|||||||
#[path = "../xpub.rs"]
|
#[path = "../xpub.rs"]
|
||||||
mod xpub;
|
mod xpub;
|
||||||
use crate::xpub::new_address_from_xpub;
|
use crate::xpub::new_address_from_xpub;
|
||||||
const VERSION:&str="0.2.0";
|
const VERSION:&str="0.2.1";
|
||||||
const NETWORKS : [&str; 4]= ["bitcoin","testnet","signet","regtest"];
|
const NETWORKS : [&str; 4]= ["bitcoin","testnet","signet","regtest"];
|
||||||
#[derive(Debug, Clone,Serialize, Deserialize)]
|
#[derive(Debug, Clone,Serialize, Deserialize)]
|
||||||
struct NetConfig {
|
struct NetConfig {
|
||||||
@ -499,7 +499,7 @@ fn parse_env_netconfig<'a>(mut cfg_lock: MutexGuard<'a, MyConfig>, chain: &'a st
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
if let Ok(value) = env::var(format!("BAL_SERVER_{}_FIXE_FEE",chain.to_uppercase())) {
|
if let Ok(value) = env::var(format!("BAL_SERVER_{}_FIXED_FEE",chain.to_uppercase())) {
|
||||||
if let Ok(v) = value.parse::<u64>(){
|
if let Ok(v) = value.parse::<u64>(){
|
||||||
cfg.fixed_fee = v;
|
cfg.fixed_fee = v;
|
||||||
}
|
}
|
||||||
|
Loading…
x
Reference in New Issue
Block a user