bitcoin-cli-ts

bitcoin-cli-ts

Auto-generated Bitcoin client library for bitcoind json rpc api

Installation

Install the package with:

npm i bitcoin-cli-ts
# or
yarn add bitcoin-cli-ts

Usage

Config

import { authenticatedBitcoind } from 'bitcoin-cli-ts'

const { host, username, password, port } = getBitcoinCoreRPCConfig()
const bitcoind = authenticatedBitcoind({
  protocol: 'http',
  host: host,
  username,
  password,
  timeout: 30000,
  port: parseInt(port, 10),
  walletName: wallet, // optional
})

Use rpc command

import { getBalance } from 'bitcoin-cli-ts'

const balance = await getBalance({ bitcoind })

Test

Test with Jest framework:

yarn test

Build

Build production (distribution) files in dist folder:

yarn build

It generates CommonJS (in dist/cjs folder), ES Modules (in dist/esm folder), as well as TypeScript declaration files (in dist/types folder).

Local development

Run:

yarn link
# or
npm link

and in your test project run:

yarn link bitcoin-cli-ts
# or
npm link bitcoin-cli-ts

If you want to remove the symlink, run:

# in your test project
yarn unlink bitcoin-cli-ts
# or
npm unlink bitcoin-cli-ts

# in bitcoin-cli-ts folder
yarn unlink
# or
npm unlink

Please check more details in npm link or yarn link

References

This library was developed based on:

• developer.bitcoin.org helpers
• Example TypeScript Package