A BCHD gRPC client for node.js
This package provides a gRPC client for connecting to BCHD. SLP support is provided when the full node has SLP index enabled, which is currently under development here.
Install
$ npm i grpc-bchrpc-node
(for web-browser based projects see this version)
Run Unit Tests
$ git clone https://github.com/simpleledgerinc/grpc-bchrpc-node
$ npm i
$ npm test
./bchrpc.proto
)
Optional: Rebuild gRPC generated js & d.ts from source (from - Install Protobuf Compiler from: https://github.com/protocolbuffers/protobuf
$ npm i
$ npm run build
Example usage
In this simple example we create a new client that connects to bchd.greyh.at:8335
and calls the getRawTransaction
rpc endpoint and prints the result to the console. We use reversedHashOrder: true
to automatically reverse the txid endianness because BCHD expects to receive transaction hashes without endianness reversed.
let grpc = new GrpcClient();
let txid = "11556da6ee3cb1d14727b3a8f4b37093b6fecd2bc7d577a02b4e98b7be58a7e8";
let res = await grpc.getRawTransaction({ hash: txid, reversedHashOrder: true });
console.log(Buffer.from(res.getTransaction_asU8()).toString('hex'));
See also the test
directory for more examples of how to use.
Tests
Some integration tests have been added. Extensive test coverage is not planned currently planned since this library is just a wrapper for BCHD's gRPC interface.
$ npm test
Known Public Instances
- https://bchd.greyh.at:8335
- https://bchd.imaginary.cash:8335
- https://bchd-testnet.greyh.at:18335
- https://bchd.fountainhead.cash:443
Connecting to local BCHD
To connect to a local BCHD server you will need to utilize a self-signed certificate. Simply start BCHD using rpccert=
and rpckey=
flags pointing to a location where to save new certificate and private key files.
Then you can connect using the following GrpcClient
constructor:
const grpc = new GrpcClient({ url: "localhost:8335", rootCertPath: "<path to cert>"});