Skip to content

Commit

Permalink
BitHyve Wrapper setup instructions
Browse files Browse the repository at this point in the history
  • Loading branch information
AliMeer committed Dec 23, 2020
1 parent bac52c4 commit 22f6879
Showing 1 changed file with 36 additions and 5 deletions.
41 changes: 36 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,23 @@

BitHyve wrapper is a server instance that wraps around [electrs](https://github.com/Blockstream/electrs) to provide some additional functionality on top of electrs as required by [hexa](https://github.com/bithyve/hexa)

## Getting Started
## Prerequisites for running BitHyve Wrappe

BitHyve Wrapper requires **electrs** (https://github.com/Blockstream/electrs) and electrs requires a **Bitcoin Core** (v0.16+)

**Bitcoin Core daemon**

Bitcoin Core can be downloaded from https://bitcoincore.org/en/download/

Detailed instructions on installing, configuring and running Bitcoin Core as daemon are available here https://bitcoin.org/en/full-node

**Electrs**

Electrs can be installed from https://github.com/Blockstream/electrs

Please follow the instructions here https://github.com/Blockstream/electrs#installing--indexing for help in installing and setting up electrs.

## Installing and running BitHyve Wrapper

1. Install golang (replace 1.15.4 with your favorite version)

Expand All @@ -20,10 +36,25 @@ export GOPATH=$HOME/go
export PATH=$GOPATH/bin:$GOROOT/bin:$PATH
```

3. Download and install wrapper
3. Download and build

```
go get github.com/bithyve/bithyve-wrapper
cd ~/go/src/github.com/bithyve/bithyve-wrapper
go get ./...
go build
```

4. Run the wrapper
- Before running the wrapper please ensure that Bitcoin Core daemon and electrs have been setup and and are running as these are required for BitHyve Wrapper.
- You would need to know the ip number of the machine/server runnig the BitHyand port number where you are running

```
sudo screen -SL wrapper ./bithyve-wrapper -m
```

5. Ensure your server accepts http traffic

```
git clone https://github.com/bithyve/bithyve-wrapper.git && cd bithyve-wrapper
go install github.com/bithyve/bithyve-wrapper && go build
sudo ./BitHyve-wrapper -t
sudo screen -SL socat80 socat tcp-listen:80,reuseaddr,fork tcp:localhost:3001
```

0 comments on commit 22f6879

Please sign in to comment.