mirror of
https://github.com/haveno-dex/haveno-ts.git
synced 2024-10-01 01:35:42 -04:00
TypeScript library for using Haveno
.github | ||
bin | ||
config | ||
public | ||
src | ||
.gitignore | ||
.project | ||
haveno-ui-poc.png | ||
LICENSE | ||
package-lock.json | ||
package.json | ||
README.md | ||
tsconfig.json |
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
- Run a local Haveno test network, running Alice as a daemon with
make alice-daemon
. git clone https://github.com/haveno-dex/haveno-ui-poc
- 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
cd haveno-ui-poc
npm install
npm start
to open http://localhost:3000 in a browser- 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.
- Run a local Haveno test network, running Alice and Bob as daemons with
make alice-daemon
andmake bob-daemon
. git clone https://github.com/haveno-dex/haveno-ui-poc
- 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 8080:8080 -p 8081:8081 envoyproxy/envoy-dev:8a2143613d43d17d1eb35a24b4a4a4c432215606 -c /envoy.test.yaml
- In a new terminal, start an instance of monero-wallet-rpc at port 38084. This wallet will be automatically funded in order to fund Alice and Bob during the tests.
For example:cd ~/git/haveno/.localnet/ && ./monero-wallet-rpc --daemon-address http://localhost:38081 --daemon-login superuser:abctesting123 --stagenet --rpc-bind-port 38084 --rpc-login rpc_user:abc123 --wallet-dir ./ --rpc-access-control-origins http://localhost:8080
cd haveno-ui-poc
npm install
npm test
to run all tests ornpm run test -- -t 'my test'
to run tests by name.
How to Update the Protobuf Client
If the protobuf definitions in haveno-dex/haveno are updated, the typescript imports must be regenerated:
- Copy grpc.proto and pb.proto from Haveno's protobuf definitions to ./config.
- Install protobuf for your system, e.g. on mac:
brew install protobuf
./bin/build_protobuf.sh