richarddushime / bitcoin-bank

Bitcoin Bank Project Repository

Bitcoin Bank Project

This guide provides step-by-step instructions on how to run the Bitcoin Bank project.

For more information about the project, read the Design Document.

Prerequisites

Before running the project, make sure you have the following prerequisites installed on your system:

• Rust and Cargo: Install Rust and Cargo
• Git: Install Git
• Node.js: Install Node.js

Steps to Run the Project

1. Fork and Clone the Project:

Fork the project repository on GitHub by clicking the "Fork" button at the top right corner of the repository page. Then, clone the forked repository to your local machine using the following command:

git clone https://github.com/<your-username>/Bitcoin-bank.git

2. Navigate to the Project Directory:

Once the project is cloned, navigate to the project directory using the cd command:

cd Bitcoin-bank

Note:This project consists of 2 modules client(frontend) and backend,

3. Running the binaries

The service requires bitcoind and bitcoin-cli to installed. To run the binary, pass the config file which configures the bitcoin daemons for the mining node (node that consistently generates blocks), hot walled node and cold wallet node. The example config file can be found in the backend/btc_conf.toml file.

The binary checks for the home directory of your specific platform and uses that to create the data directory for the bitcoind for the nodes as follows:

UserHomeDir
  |-- bitcoin-bank-data #Application directory 
          |-- mining-node # Mining node data directory
          |-- hot-node # Hot wallet node data directory
          |-- cold-node # Cold wallet node data directory

To run the binary with the default config file

$ cd ./backend

$ cargo run -- ./btc_conf.toml

Explore the Frontend:

Navigate to the frontend directory and follow the instructions provided in the README file located there.

cd client

Access the Application:

Once the project is running, you can access the application by opening a web browser and navigating to the appropriate URL.

bitcoin-bank's Issues

Frontend Basic structure

Create the basic structure of the frontend.
Tasks:

• Define the basic structure and layouts.

Initialize Rust Project

Set up the initial Rust project structure for the backend

Tasks:

• Create a new Rust project.
• Configure project dependencies and settings.

Create code to create a multisignature script

The frontend and backend need a way to create multi-signature scripts requiring multiple signatures to transfer funds to and from hot, cold and external wallets

Create request handlers

The frontend needs to communicate with the backend so we need request handlers

• Handle login
• User can withdraw to an external wallet
• User can view balance
• User can receive from external wallet

Private Keys

Get the private keys to sign a transaction using bitcoin-cli

Storage

Create a simple key value store to persist state using sled.rs

Create data structure and TCP code to handle communication between wallets

The cold and hot wallets need to communicate between each other via TCP and exchange data which is PSBT

PSBT

Create code to handle Partially Signed Bitcoin Transactions

Transaction builder

Create code to create new transactions and signing

Setup basic authentication

Basic authentication with username and password

Implement Basic Structure for the backend

Develop the basic server structure for the backend
Tasks:

• Define the main server module.

@448-OG you can add more here

create a raw transaction

Create a bitcoin commands to create a raw transaction using bitcoin-cli

Set up Routing for API Endpoints

set the API endpoints

Tasks:

• Define routes for different API endpoints (e.g., login, balance).
• Implement request handlers for each route.