Git-Mirrors/haveno-ts
1
0
Fork 0
mirror of https://github.com/haveno-dex/haveno-ts.git synced 2024-10-01 01:35:42 -04:00
Code Issues Packages Projects Releases Wiki Activity
TypeScript library for using Haveno
116 Commits 5 Branches 28 Tags 37 MiB
TypeScript 99%
Dockerfile 0.4%
JavaScript 0.4%
Shell 0.2%
22d9ed7ac6
Go to file
woodser 22d9ed7ac6 support uphold
2022-06-24 15:47:07 -04:00
.github add workflow: label.yml 2022-06-06 09:12:00 -04:00
config support auto starting and stopping arbitrator, alice, and bob 2021-12-19 11:49:43 -05:00
dist bump version, update docs and dist 2022-06-07 17:48:57 -04:00
docs bump version, update docs and dist 2022-06-07 17:48:57 -04:00
scripts Export protobuf types (#100) 2022-05-10 09:55:41 -04:00
src support uphold 2022-06-24 15:47:07 -04:00
_config.yml add _config.yml for github pages documentation 2022-05-02 16:43:42 -04:00
.editorconfig enable and apply eslint rules 2022-05-02 15:21:48 -04:00
.eslintignore enable and apply eslint rules 2022-05-02 15:21:48 -04:00
.eslintrc.json convert to typescript library 2022-05-05 22:25:08 -04:00
.gitignore update typedocs 2022-05-05 23:30:40 -04:00
.project rename haveno-ui-poc project to haveno-ts 2022-05-03 08:06:56 -04:00
babel.config.js convert to typescript library 2022-05-05 22:25:08 -04:00
LICENSE change license to apache 2.0 (#6) 2021-09-10 06:43:06 -04:00
package-lock.json bump version, update docs and dist 2022-06-07 17:48:57 -04:00
package.json bump version, update docs and dist 2022-06-07 17:48:57 -04:00
README.md Export protobuf types (#100) 2022-05-10 09:55:41 -04:00
tsconfig.json change module to commonjs 2022-05-12 17:32:05 -04:00

README.md

Haveno TypeScript Library

TypeScript library for using Haveno.

Install

  1. Start a Haveno daemon (see installing.md).
  2. Install haveno-ts in your project: npm install haveno-ts

Sample code

import { HavenoClient } from "haveno-ts";

// create client connected to Haveno daemon
const alice = new HavenoClient("http://localhost:8080", "apitest");

// use Haveno daemon
const balances = await alice.getBalances();
const paymentAccounts = await alice.getPaymentAccounts();
const myOffers = await alice.getMyOffers("ETH");
const offers = await alice.getOffers("ETH", "BUY");
const trade = await alice.takeOffer(offers[0].getId(), paymentAccounts[0].getId());

// disconnect client
await alice.disconnect();

TypeDocs

See typedocs.

Run tests

Running the API tests is the best way to develop and test Haveno end-to-end.

HavenoClient.ts provides the client interface to Haveno's backend daemon.

  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-ts
  3. In a new terminal, start envoy with the config in haveno-ts/config/envoy.test.yaml (change absolute path for your system): docker run --rm --add-host host.docker.internal:host-gateway -it -v ~/git/haveno-ts/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 compiler v3.19.1 or later 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-ts
  8. npm install
  9. npm test to run all tests or npm run test -- -t 'my test' to run tests by name.