A flexible, strongly-typed, FP-inspired, highly-portable, typescript bitcoin library.
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.
This library should provide the primitives needed to hack on Bitcoin and Bitcoin-related ideas.
- flexible - Consumers should be able to import only the functionality they need
- simple - Functions should be simple and return one type
- portable – All code should work on every platform (no Node.js bindings or separate browser versions)
Please see the Design Guidelines for more info.
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');
})();
- instantiateRipemd160
- Ripemd160 Interface
- instantiateSha1
- Sha1 Interface
- instantiateSha256
- Sha256 Interface
- instantiateSha512
- Sha512 Interface
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