API Reference

Bancor SDK

Bancor SDK v0.2 (beta)

Javascript API that provides utilities and access to the Bancor Network mainnet contracts across the different blockchains using a unified & simplified interface.

Initialization

1
const BancorSDK = require('@bancor/sdk').SDK;
2
3
const settings = {
4
// optional, mandatory when interacting with the ethereum mainnet
5
ethereumNodeEndpoint: '<ethereum node endpoint>',
6
// optional, mandatory when interacting with the EOS mainnet
7
eosNodeEndpoint: '<eos node endpoint>'
8
};
9
10
let bancorSDK = await BancorSDK.create(settings);
Copied!

Usage

getPathAndRate - returns the best conversion path and rate between any two tokens in the Bancor Network. Note that the source token and the target token can reside on two different blockchains. In addition, input/output amounts format is a decimal string (as opposed to wei) since the function is blockchain agnostic.
1
// get the path/rate between DAI and ENJ
2
const sourceToken = {
3
blockchainType: 'ethereum',
4
blockchainId: '0x6B175474E89094C44Da98b954EedeAC495271d0F'
5
};
6
const targetToken = {
7
blockchainType: 'ethereum',
8
blockchainId: '0xF629cBd94d3791C9250152BD8dfBDF380E2a3B9c'
9
};
10
const res = await bancorSDK.pricing.getPathAndRate(sourceToken, targetToken, "1.0");
11
12
// output:
13
{
14
path: [
15
{ blockchainType: 'ethereum', blockchainId: '0x6B175474E89094C44Da98b954EedeAC495271d0F' },
16
{ blockchainType: 'ethereum', blockchainId: '0xcb913ED43e43cc7Cec1D77243bA381615101E7E4' },
17
{ blockchainType: 'ethereum', blockchainId: '0x309627af60F0926daa6041B8279484312f2bf060' },
18
{ blockchainType: 'ethereum', blockchainId: '0xd1146B08e8104EeDBa44a73B7bda1d102c6ceDC9' },
19
{ blockchainType: 'ethereum', blockchainId: '0x1F573D6Fb3F13d689FF844B4cE37794d79a7FF1C' },
20
{ blockchainType: 'ethereum', blockchainId: '0xf3aD2cBc4276eb4B0fb627Af0059CfcE094E20a1' },
21
{ blockchainType: 'ethereum', blockchainId: '0xF629cBd94d3791C9250152BD8dfBDF380E2a3B9c' }
22
],
23
rate: '7.640578979520041176'
24
}
Copied!

Cleanup

1
await BancorSDK.destroy(bancorSDK);
Copied!

Features

    Price discovery
    Conversion path generation
    Historical data
    Utilities
    Cross-chain support

Collaborators

Last modified 5mo ago