@iov/bns
v2.5.0
Published
Transaction codec and BCP client to communicate with BNS blockchain
Downloads
120
Readme
@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).