Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/moneybutton/bsv

Bitcoin SV javascript library
https://github.com/moneybutton/bsv

Last synced: 3 months ago
JSON representation

Bitcoin SV javascript library

Awesome Lists containing this project

README

        

# bsv

bsv is a javascript library for Bitcoin SV (BSV) intended to satisfy certain
goals:

1. Support ease-of-use by being internally consistent. It should not be
necessary to read the source code of a class or function to know how to use it.
Once you know how to use part of the library, the other parts should feel
natural.

2. Have 100% test coverage, or nearly so, so that the library is known to be
reliable. This should include running standard test vectors from the reference
implementation.

3. Library objects have an interface suitable for use with a command-line
interface or other libraries and tools, in particular having toString,
fromString, toJSON, fromJSON, toBuffer, fromBuffer, toHex, fromHex methods.

4. All standard features of the blockchain are implemented (or will be) and
saved in lib/. All BIPs are correctly implemented and, where appropriate, saved
as bip-xx.js in lib/ (since that is their standard name). In order to allow
rapid development, Yours Bitcoin includes non-standard and experimental
features. Any non-standard features (such as colored coins or stealth
addresses) are labeled as such in index.js as well as in comments.

5. Expose everything, including dependencies. This makes it possible to develop
apps that require fine-grained control over the basics, such as big numbers and
points. However, it also means that you can hurt yourself if you misuse these
primitives.

6. Use standard javascript conventions wherever possible so that other
developers find the code easy to understand.

7. Minimize the use of dependencies so that all code can be easily audited.

8. All instance methods modify the state of the object and return the object,
unless there is a good reason to do something different. To access the result
of an instance method, you must access the object property(s) that it modifies.

9. Support web workers to unblock web wallet UIs when performing cryptography.

## Environment Variables

* `BSV_JS_BASE_URL` - Default "/".
* `BSV_JS_BUNDLE_FILE` - Default "bsv.js"
* `BSV_JS_WORKER_FILE` - Default "bsv-worker.js"
* `NETWORK` - Default "mainnet"

You can change the network to run the CLI in testnet mode:

```
NETWORK=testnet ./bin/bsv.js
```