@brightunion/sdk
Version:
Brightjs is a set of javascript tools to interact with the Bright Union's risk platform aggregator's protocol on Ethereum, Binance Smart Chain and Polygon blockchains.
131 lines (89 loc) • 3.18 kB
Markdown
<p align="center">
<img src="https://img.api.cryptorank.io/coins/bright%20union%201628151410793.png" alt="Bright Union"/>
</p>
# Bright Union SDK
The Bright Union SDK is a set of javascript utilities that enables an easy integration of the Bright Union's multi-chain protocol into any web project.
This SDK will give you access to the Bright Union aggregator contract that combines risk coverage services from:
- [Nexus Mutual](https://nexusmutual.io/)
- [Bridge Mutual](https://www.bridgemutual.io/)
- [Inurace](https://www.insurace.io/)
A swagger API documentation can be found [here](http://api.brightunion.io/protocol/api-docs/).
## Prerequisites
- Node v14+
- Blockchain client node provider:
- infura, quicknode, anyblock etc...
## Installation
```javascript
npm install @brightunion/sdk
```
# Available methods
### Get the full catalog from all our distributors
```
getCatalog()
```
### Get total cover count from address around all our distributors
````
getCoverCountFrom(< walletAddress >)
````
### Get all the covers details from account around all distributors
```
getCoversFrom(< WalletAddress >)
```
### Get quotes from distributor
```
getQuotes( amount, currency, period, productId)
```
### Get specific quote from distributor
```
getQuoteFrom( distributorName, amount, currency, period, productId)
```
### Buy previously queried quote
```
buyQuote(< preExistingQuote>)
```
## Basic Use
```javascript
const BrightClient = require('@Brightunion/SDK');
const brightClient= new BrightClient({ <web3_instance> });
// Initialize the client
await brightClient.initialize();
// Get catalog of all risk covers available
const catalog = brightClient.getCatalog();
// Get quotes for a catalog item from all risk providers available
const quotes = brightClient.getQuotes( <amount> , <currency>, <period>, <catalog_item> )
// Buy quoted cover
brightClient.buyQuote( <quote> ).then(data => {
// transaction done
})
// Get purchased cover count from all distributors
const coversCount = await brightClient.getAllCoversCount();
// Get purchased covers from all distributors
const coversAll = await brightClient.getAllCovers();
```
## Quote and buy a specific cover product
```javascript
const BrightClient = require('@Brightunion/SDK');B
const brightClient= new BrightClient({ <web3_instance> });
// Initialize the client
await brightClient.initialize();
//Define a Catalog Item from a supported insurance distributor
//INSURACE catalog item example
const catalogItemInsurace = { productId: <Insurace_product_id> };
//BRIDGE catalog item example
const catalogItemBridge = { bridgeProductAddress: <Bridge_product_address> };
//NEXUS catalog item example
const catalogItemNexus = { nexusCoverable: <Nexus_product_address> };
// Get quote from specific distributor on a catalog item
const quote = await brightClient.getQuoteFrom( <distributorName>, <amount> , <currency>, <period>, <catalog_item>);
// Buy quoted cover
brightClient.buyQuote( <quote> ).then(data => {
// transaction done
})
```
<!-- ## Currently supported distributors
- InsurAce
- Ethereum - ETH
- Binance smart chain -
- Polygon
- Nexus -->
<!-- ## Methods -->