bitcoin-ts

A flexible, strongly-typed, FP-inspired, highly-portable, typescript bitcoin library.

Work in Progress

While this library is a work in progress, the currently-exposed functionality is production-ready (WASM implementations of secp256k1, ripemd160, sha256, sha512, and sha1).

More functionality will be exposed in future versions.

Design Goals

This library should provide the primitives needed to hack on Bitcoin and Bitcoin-related ideas.

1. flexible - Consumers should be able to import only the functionality they need
2. simple - Functions should be simple and return one type
3. portable – All code should work on every platform (no Node.js bindings or separate browser versions)

Please see the Design Guidelines for more info.

Usage

To use, simply install bitcoin-ts:

npm install bitcoin-ts
# OR
yarn add bitcoin-ts

And import the functionality you need:

import { instantiateSecp256k1 } from 'bitcoin-ts';
import { msgHash, pubkey, sig } from './somewhere';

(async () => {
  const secp256k1 = await instantiateSecp256k1();
  secp256k1.verifySignatureDERLowS(sig, pubkey, msgHash)
    ? console.log('🚀 Signature valid')
    : console.log('❌ Signature invalid');
})();

Documentation

API Documentation →

ECDSA

• instantiateSecp256k1
• Secp256k1 Interface

Hashing Functions

• instantiateRipemd160
• Ripemd160 Interface
• instantiateSha1
• Sha1 Interface
• instantiateSha256
• Sha256 Interface
• instantiateSha512
• Sha512 Interface

Contributing

Pull Requests welcome! Please see CONTRIBUTING.md for details.

This library requires Yarn for development. If you don't have Yarn, make sure you have Node.js installed (which ships with npm), then run npm install -g yarn. Once Yarn is installed:

# use --recursive to clone the secp256k1 submodule
git clone --recursive https://github.com/bitjson/bitcoin-ts.git && cd bitcoin-ts

Install the development dependencies:

yarn

Then try running the test suite:

yarn test

You can also run the benchmarks (this may take a while):

yarn bench

During development, you may find it helpful to use one of the testing watch tasks:

yarn watch
# OR
yarn watch:no-crypto # much faster

For more information about the available package scripts, run:

yarn run info