BUX: JS Client

Get started using BUX in five minutes

Table of Contents

• What is BUX?
• Installation
• Usage
• Documentation
• Code Standards
• Contributing
• License

What is BUX?

Read more about BUX

Installation

Install all npm packages

$ make install

See more scripts in the package.json file or the makefile.

There is a peer dependency on the bsv library. This version of the JS BUX client supports version 1.x of the bsv library.

Usage

Here's the getting started with BUX

import bsv from 'bsv';
import { BuxClient } from 'js-buxclient';

const server = "http://localhost:3003/v1";
const transportType = 'http'; // or graphql
const xPriv = bsv.HDPrivateKey.fromRandom();

const buxClient = new BuxClient(server, {
  signRequest: true,
  transportType,
  xPriv,
});

const recipients = [{
  to: "[email protected]",
  satoshis: 10000,
}];
const result = await buxClient.SendToRecipients(recipients, { agent: 'Bux test' })

Documentation

View more BUX documentation.

Connection options

| Option | Description | | |-----------------|-------------------------------------------------|---------------------| | accessKeyString | Hex private part of an access key | string | | debug | Whether to turn debugging on | boolean | | signRequest | Whether to sign all requests sent to the server | boolean | | transportType | Transport type to use for server requests | "http" or "graphql" | | xPriv | bsv HDPrivateKey instance | | | xPrivString | HD Private key string | "xprv....." | | xPub | bsv HD Public key instance | | | xPubString | HD Public key string | "xpub....." |

Connection as a BUX admin

You can add the admin key to the BUX client after initialisation to support admin requests (IE: registering an xPub).

const adminKey = 'xprv.....';
buxClient.SetAdminKey(adminKey);

Releases are automatically created when you create a new git tag!

If you want to manually make releases, please install GoReleaser:

goreleaser for easy binary or library deployment to Github and can be installed:

• using make: make install-releaser
• using brew: brew install goreleaser

The .goreleaser.yml file is used to configure goreleaser.

Automatic Releases on Tag Creation (recommended)

Automatic releases via Github Actions from creating a new tag:

make tag version=1.2.3

Manual Releases (optional)

Use make release-snap to create a snapshot version of the release, and finally make release to ship to production (manually).

View all makefile commands

make help

List of all current commands:

audit                         Checks for vulnerabilities in dependencies
clean                         Remove previous builds and any test cache data
help                          Show this help message
install                       Installs the dependencies for the package
install-all-contributors      Installs all contributors locally
outdated                      Checks for outdated packages via npm
publish                       Will publish the version to npm
release                       Full production release (creates release in Github)
release                       Run after releasing - deploy to npm
release-snap                  Test the full release (build binaries)
release-test                  Full production test release (everything except deploy)
replace-version               Replaces the version in HTML/JS (pre-deploy)
tag                           Generate a new tag and push (tag version=0.0.0)
tag-remove                    Remove a tag if found (tag-remove version=0.0.0)
tag-update                    Update an existing tag to current commit (tag-update version=0.0.0)
test                          Will run unit tests
update-contributors           Regenerates the contributors html/list

Code Standards

Please read our code standards document

Contributing

View the contributing guidelines and follow the code of conduct.

How can I help?

All kinds of contributions are welcome :raised_hands:! The most basic way to show your support is to star :star2: the project, or to raise issues :speech_balloon:. You can also support this project by becoming a sponsor on GitHub :clap: or by making a bitcoin donation to ensure this journey continues indefinitely! :rocket:

Contributors ✨

Thank you to these wonderful people (emoji key):

This project follows the all-contributors specification.

License