Bancor is a decentralized liquidity protocol that provides tokens with constant liquidity. The protocol is made up of a series of smart contracts which are designed to pool liquidity and perform non-custodial token-to-token conversions in a single transaction. More than 150 tokens are integrated with the Bancor Protocol, including ETH, EOS, DAI, IQ, PEOS & more.
- Join the Bancor Developers Telegram group or the Bancor Protocol Telegram group
- Check out the Bancor Blog
- Read the Bancor Protocol Whitepaper
- Visit the Bancor Web App
Token conversions via the Bancor Protocol are executed against on-chain liquidity pools known as “Bancor Relays”. Each Relay holds reserves of both BNT (Bancor’s Network Token) and a base token (which could be any ERC20 or EOS-based token, with more blockchains to come). For instance, the base token for the ‘DAIBNT’ Relay is DAI.
A Relay’s reserves receive and dispense tokens in order to fulfill trades and are autonomously rebalanced to determine prices. Selling BNT for the base token increases the size of the BNT reserve and decreases the size of the base token’s reserve. This shifts the reserve ratio, increasing the base token's price relative to BNT for subsequent transactions. The larger a trade relative to the total size of the reserves, the more price slippage will occur.
Since BNT is a common pair for all Relays, it can be used as an intermediary allowing direct token-token trades in a single transaction, including across different blockchains. Notably, traders never need to hold BNT to perform conversions via Bancor Protocol.
Anyone can become a liquidity provider to a Relay and contribute to its reserves. This is different than buying tokens on Bancor. It requires staking tokens in a Relay. Users can stake their tokens in a Relay by buying “Relay Tokens” on bancor.network, or through any third-party liquidity portal built atop the Bancor Protocol. Relay Tokens can be sold at any time to withdraw a proportional share of the Relay’s liquidity.
Each time a Relay processes a conversion, a small liquidity provider fee (usually 0.1-0.3%) is taken out of each trade and deposited into the Relay’s reserves. These fees function as an incentive for liquidity providers who can withdraw their proportional share of the reserves including the accumulated fees. The larger a Relay’s reserves, the lower the slippage costs incurred by traders transacting with the Relay, driving more conversion volume and, in turn, more fees for liquidity providers.
Currently, whoever initiates the Relay determines its fees, while in the future, liquidity providers will be able to vote on the Relay’s fee. Bancor takes no platform fee from trades.
All smart contract functions are public and all upgrades are opt-in. If significant improvements are made to the system a new version will be released. Token owners can choose between moving to the new system or staying in the old one. If possible, new versions will be backwards compatible and able to trade with the old versions.
A “Smart Token” refers to tokens which utilize reserves to automate trading, including “Liquid Tokens” (one reserve), “Relay Tokens” (two reserves) and “Array Tokens” (three or more reserves). See Section 6 of the Bancor Whitepaper (“Smart Token Configurations”) for more details.
The terms “reserves” and “connectors” have the same meaning throughout Bancor’s smart contract code and documentation. “Reserve ratio” and “connector weight” are also used interchangeably. “Connector balance” refers to the token inventories held in a Smart Token’s reserve.
Bancor is a work in progress. Make sure you understand the risks before using it.
Bancor protocol is implemented using multiple contracts. The main contracts are SmartToken and BancorConverter. BancorConverter is responsible for converting between a token and its connectors. SmartToken represents a converter aware ERC-20 compliant token.
Those will allow creating a Bancor compliant token while keeping dependencies at a minimum. In addition, it allows an owning contract to extend its functionality by giving the owner full control.
First and foremost, a Smart Token is also an ERC-20 compliant token. As such, it implements both the standard token methods and the standard token events.
Note that these methods can only be executed by the token owner.
issue
function issue(address _to, uint256 _amount)Increases the token supply and sends the new tokens to an account.
destroy
function destroy(address _from, uint256 _amount)Removes tokens from an account and decreases the token supply.
disableTransfers
function disableTransfers(bool _disable)Disables transfer/transferFrom functionality.
NewSmartToken
event NewSmartToken(address _token)Triggered when a smart token is deployed.
Issuance
event Issuance(uint256 _amount)Triggered when the total supply is increased.
Destruction
event Destruction(uint256 _amount)Triggered when the total supply is decreased.
The following section describes standard functions a bancor converter can implement.
Those will allow dapps and wallets to buy and sell the token.
The most important here is convert.
connectorTokenCount
function connectorTokenCount() public constant returns (uint16 count)Gets the number of connector tokens defined for the token.
connectorTokens
function connectorTokens() public constant returns (address[] connectorTokens)Gets an array of the connector token contract addresses.
connectors
function connectors(address _connectorToken) public constantGets the connector token details.
convert
function convert(address _fromToken, address _toToken, uint256 _amount, uint256 _minReturn)converts a specific amount of _fromToken to _toToken
The conversion will only take place if it returns a value greater or equal to _minReturn.
Conversion
event Conversion(address indexed _fromToken, address indexed _toToken, address indexed _trader, uint256 _amount, uint256 _return, uint256 _currentPriceN, uint256 _currentPriceD);Triggered when a conversion between one of the convertible tokens takes place.
Tests are included and are run using truffle & ganache
- node v10.16.0
- npm v6.9.0
To run the test:
- Use
npm installin order to install all required packages. - Use
npm test 1in order to run truffle-test ornpm test 2in order to run solidity-coverage.
Bancor Protocol is open source and distributed under the Apache License v2.0