The purpose of this repo is to demo a library that transmits bitcoin objects (addresses, raw_trx, psbt, etc) over a mesh network.
This project leverages:
- The
bdk-pythonbindings for Bitcoin wallet and transaction functionalities. More information can be found here: bdk-python. - The Meshtastic Python API for transmitting data over mesh networks. Documentation and details are available at Meshtastic Python API.
This example assumes there are three meshtastic devices (Alice, Bob and Charlie) sending around PSBTs. I used two different LILYGO T-Beams and a T-echo. You can adapt the demo to work with fewer or more devices as needed.
Steps:
- Follow the Meshtastic documentation to flash meshtastic firmware onto your devices.
- Use
unzip btc/wallets.zip walletsto unzip the wallets directory. The password (hcpp23_mesh) was set to keep the duller bots out. - These wallets should already be funded with testnet sats, but you may need to create new wallets or fund them again if their balance is insufficient.
- You can broadcast and receive transactions manually, or use the bdk tooling from this demo to do so.
- Start the listener from the machine you wish to act as your bridge between the internet and the mesh.
python3 btc/listen.py /dev/ttyACM<number>
- Start the broadcaster from the machine you wish to use to send transactions.
python3 btc/broadcast_tx.py /dev/ttyACM<number>
Note that you will need to replace /dev/ttyACM<number> with the actual port your device is connected to.
Essentially the function broadcast_tx.py will:
- Select a sender and receiver based on the wallet balances of the wallets in
btc/wallets. - Create a PSBT from the sender's wallet to the receiver's wallet.
- Broadcast the PSBT over the mesh network.
The function listen.py will:
- Listen for PSBTs being broadcast over the mesh network.
- Broadcast the PSBTs to the Bitcoin testnet network upon receiving complete PSBTs.
Pull requests are welcome. For major changes, please open an issue first to explain the changes that are being made on the branch.