Haveno UI Proof of Concept

A proof of concept to fetch and render data from Haveno's daemon in ReactJS.

This application is a lightly modified create-react-app with typescript using envoy proxy and grpc-web to use Haveno's gRPC API.

Run in a Browser

1. Run a local Haveno test network, running Alice as a daemon with make alice-daemon.
2. Clone this project to the same parent directory as the haveno project: git clone https://github.com/haveno-dex/haveno-ui-poc
3. In a new terminal, start envoy with the config in haveno-ui-poc/config/envoy.yaml (change absolute path for your system): docker run --rm --add-host host.docker.internal:host-gateway -it -v ~/git/haveno-ui-poc/config/envoy.yaml:/envoy.yaml -p 8080:8080 envoyproxy/envoy-dev:8a2143613d43d17d1eb35a24b4a4a4c432215606 -c /envoy.yaml
4. Install protobuf for your system:
   mac: brew install protobuf
   linux: apt install protobuf-compiler NOTE: You may need to upgrade to v3.19.1 manually if your package manager installs an older version.
5. Download protoc-gen-grpc-web plugin and make executable as shown here.
6. cd haveno-ui-poc
7. npm install
8. npm start to open http://localhost:3000 in a browser
9. Confirm that the Haveno daemon version is displayed (1.6.2).

Run Tests

Running the top-level API tests is a great way to develop and test Haveno end-to-end.

HavenoDaemon provides the interface to the Haveno daemon's gRPC API.

1. Run a local Haveno test network and then shut down the arbitrator, Alice, and Bob or run them as daemons, e.g. make alice-daemon. You may omit the arbitrator registration steps since it is done automatically in the tests.
2. Clone this project to the same parent directory as the haveno project: git clone https://github.com/haveno-dex/haveno-ui-poc
3. In a new terminal, start envoy with the config in haveno-ui-poc/config/envoy.test.yaml (change absolute path for your system): docker run --rm --add-host host.docker.internal:host-gateway -it -v ~/git/haveno-ui-poc/config/envoy.test.yaml:/envoy.test.yaml -p 8079:8079 -p 8080:8080 -p 8081:8081 -p 8082:8082 -p 8083:8083 -p 8084:8084 -p 8085:8085 -p 8086:8086 envoyproxy/envoy-dev:8a2143613d43d17d1eb35a24b4a4a4c432215606 -c /envoy.test.yaml
4. In a new terminal, start the funding wallet. This wallet will be automatically funded in order to fund Alice and Bob during the tests.
   For example: cd ~/git/haveno && make funding-wallet.
5. Install protobuf for your system:
   mac: brew install protobuf
   linux: apt install protobuf-compiler NOTE: You may need to upgrade to v3.19.1 manually if your package manager installs an older version.
6. Download protoc-gen-grpc-web plugin and make executable as shown here.
7. cd haveno-ui-poc
8. npm install
9. npm test to run all tests or npm run test -- -t 'my test' to run tests by name.

Troubleshooting

Running Haveno UI POC results in error stack:

Error: error:0308010C:digital envelope routines::unsupported
    at new Hash (node:internal/crypto/hash:67:19)
    at Object.createHash (node:crypto:130:10)
    ...

If you are using node.js v17+, this is caused by a bug in a dependency. Run the following command in your terminal:

export NODE_OPTIONS=--openssl-legacy-provider

Running envoy in Docker fails with permission error:

docker: Got permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock: Post http://%2Fvar%2Frun%2Fdocker.sock/v1.35/containers/create: dial unix /var/run/docker.sock: connect: permission denied. See 'docker run --help'.

Run the following command in your terminal:

sudo chmod 666 /var/run/docker.sock

Test fails with error:

wallet and network is not yet initialized

Mine some blocks in monerod to an address:

1. In the monerod console enter start_mining <address> 1
2. Wait for some blocks to show up.
3. Enter stop_mining