@iov/bns

@iov/bns

This package is an implementation of the BlockchainConnection interface for the BNS blockchain (currently just as bcp-demo prototype). It should be able to adapt this code fairly easily to support any other weave based blockchain as well.

This provides a reference implementation of the full feature set of BlockchainConnection, so it is also a good read when starting support of another blockchain.

Simplest usage, to use auto-detecting tendermint client and standard bns transaction parser:

const connection = await BnsConnection.establish(
  "wss://rpc-private-a-x-exchangenet.iov.one",
);

Supported weave (bnsd) versions

IOV-Core version	Supported weave versions
2.2.5	1.0.4+
2.0.2	0.22.x, 0.24.x – 0.25.x, 1.0.0
1.2	0.22.x
1.1	0.21.x
1.0	0.21.x
0.17	0.21.x
0.16	0.19.x - 0.20.x
0.15	0.16.x
0.14	0.14.x
0.12 – 0.13	0.10.x - 0.11.x
0.9 – 0.11	0.4.x - 0.9.x
0.1 – 0.8	0.4.x - 0.8.x

API Documentation

https://iov-one.github.io/iov-core-docs/latest/iov-bns/

The main entry point is the BnsConnection, which creates a Tendermint client (from iov-tendermint-rpc) and a codec to parse transactions. The BNS codec for reading and writing transactions (also useful for MultiChainSigner) is exported as top-level bnsCodec.

License

This package is part of the IOV-Core repository, licensed under the Apache License 2.0 (see NOTICE and LICENSE).