Core Concepts
Testing on Kovan
Testing on Kovan
Overview
This guide will walk through the process of interacting with Balancer on Kovan directly with the smart contracts along with additional tooling such as the subgraph and SOR.
Setup
This guide will use
seth - a tool built by Dapphub to interact directly with smart contracts. To install, run the below command. Note: the Dapp Tools suite installs Nix OS.1
curl https://dapp.tools/install | sh
Copied!
If this doesn't work, you might need to install nix manually first:
curl -L https://nixos.org/nix/install | shNix is broken on MacOS Catalina. To fix, follow the steps at: https://github.com/NixOS/nix/issues/2925#issuecomment-539570232​
Follow the remaining steps at: https://github.com/dapphub/dapptools/tree/master/src/seth#example-sethrc-file in order to select the
SETH_CHAIN and address / key.Run the below lines in your terminal to setup environment variables that will be used later in the guide.
1
export BFACTORY=0x8f7F78080219d4066A8036ccD30D588B416a40DB
2
export FAUCET=0xb48Cc42C45d262534e46d5965a9Ac496F1B7a830
3
export WETH=0xd0A1E359811322d97991E03f863a0C30C2cF029C
4
export DAI=0x1528F3FCc26d13F7079325Fb78D9442607781c8C
5
export MKR=0xef13C0c8abcaf5767160018d268f9697aE4f5375
6
export USDC=0x2F375e94FC336Cdec2Dc0cCB5277FE59CBf1cAe5
7
export REP=0x8c9e6c40d3402480ACE624730524fACC5482798c
8
export WBTC=0xe0C9275E44Ea80eF17579d33c55136b7DA269aEb
9
export BAT=0x1f1f156E0317167c11Aa412E3d1435ea29Dc3cCE
10
export SNX=0x86436BcE20258a6DcfE48C9512d4d49A30C4d8c4
11
export ANT=0x37f03a12241E9FD3658ad6777d289c3fb8512Bc9
12
export ZRX=0xccb0F4Cf5D3F97f4a55bb5f5cA321C3ED033f244
Copied!
Acquire Test Funds
All pools use wrapped ETH. In order to get WETH, either use the faucet at https://faucet.kovan.network and then
deposit() into the WETH contract. Or the faucet below may have some available WETH.For all other tokens, Balancer has deployed a set of test tokens and a faucet on Kovan. The guide below will use DAI & MKR, but feel free to use any of the available tokens. An user can call
drip once per day per token.Token
Address
Drip Amount
Call
drip on the faucet specifying a token address:1
seth send $FAUCET "drip(address)" $DAI
Copied!
Confirm that you received test tokens:
1
seth --from-wei $(seth --to-dec $(seth call $DAI "balanceOf(address)" $ETH_FROM))
Copied!
Repeat the above steps for any additional tokens you would like to interact with on the Balancer test deployment.
Pool Creation
Next we're going to create a new pool. This guide will create a 50% WETH, 25% DAI, 25% MKR pool. Feel free to use any of the tokens
Some tokens do not use the standard 18 decimals. Be aware of balance calculations and weights when using tokens with different decimals.
USDC - 6
WBTC - 8
Any Compound token - 8
1
seth send --gas 5000000 $BFACTORY "newBPool()"
Copied!
Make note of the created contract address and set the below
BPool variable to the address returned. This can be found on etherscan by looking at the internal txs of the tx hash.1
export BPOOL=0x... (address returned from previous step)
Copied!
1
BPOOL=0x... (address returned from previous step)
Copied!
Token approvals are needed for any tokens you plan on adding to the pool. Approvals per pool is only required when interacting with the contracts directly. The frontend interfaces will all use a proxy so there will only be 1 time approvals to interact with all pools in the Balancer ecosystem.
1
amount=$(seth --to-uint256 $(seth --to-wei 1000000 ether))
2
seth send $WETH "approve(address,uint256)" $BPOOL $amount
3
seth send $DAI "approve(address,uint256)" $BPOOL $amount
4
seth send $MKR "approve(address,uint256)" $BPOOL $amount
Copied!
After all approvals are confirmed, tokens are bound to a specific pool by calling ``bind(address token, uint balance, uint denorm)```
denorm is the denormalized weight for the token being added. Weights are stored in this fashion to prevent unnecessary gas costs of recalculating weights every time a new token is added. In our example, since we want 50% WETH, 25% DAI, and 25% MKR we can use the following denormalized weights: 10, 5, 5. (Note: the denorm weights are scaled to Wei; i.e., "1" = 10^18, to allow for non-integer weights.)Valid denorm values range from 1 to 50 - and the total sum must be <= 50. In practice, to ensure the math always works, best practice is to use a smaller range, such as 2 - 40.
1
# Bind 1 WETH with a denormalized weight of 10
2
amount=$(seth --to-uint256 $(seth --to-wei 1 ether))
3
weight=$(seth --to-uint256 $(seth --to-wei 10 ether))
4
seth send $BPOOL "bind(address, uint256, uint256)" $WETH $amount $weight
Copied!
Since we also want to bind DAI and MKR, and we know the desired weights, we have to calculate a balance for each token such that the internal token prices calculated by the protocol - based only on the weights and balances - match the external market prices of the tokens. (Otherwise, there would be immediate, unintended arbitrage opportunities as soon as you created the pool.) This example will assume the following asset prices: ETH - $200, MKR - $400, DAI - $1.
Since we bound 1 WETH at a price of $200 and we want that to be 50% of the pool, we want to bind $100 of both DAI and MKR.
1
# Bind 100 DAI with a denormalized weight of 5
2
amount=$(seth --to-uint256 $(seth --to-wei 100 ether))
3
weight=$(seth --to-uint256 $(seth --to-wei 5 ether))
4
seth send $BPOOL "bind(address, uint256, uint256)" $DAI $amount $weight
5
​
6
# Bind 0.25 MKR with a denormalized weight of 5
7
amount=$(seth --to-uint256 $(seth --to-wei 0.25 ether))
8
weight=$(seth --to-uint256 $(seth --to-wei 5 ether))
9
seth send $BPOOL "bind(address, uint256, uint256)" $MKR $amount $weight
Copied!
Let's confirm that all the tokens were added by using some view functions. This will get a token's normalized weight, or percentage of the pool, to make sure our original math was correct.
1
seth call $BPOOL "getNumTokens()"
2
​
3
seth --from-wei $(seth --to-dec $(seth call $BPOOL "getNormalizedWeight(address)" $WETH))
4
​
5
seth --from-wei $(seth --to-dec $(seth call $BPOOL "getNormalizedWeight(address)" $DAI))
6
​
7
seth --from-wei $(seth --to-dec $(seth call $BPOOL "getNormalizedWeight(address)" $MKR))
Copied!
Now that we're finished adding tokens, we need to set a swap fee for our pool. Otherwise we wouldn't earn anything on our assets and be more exposed to impermanent loss. In this example, we will set a swap fee of 0.3%:
1
fee=$(seth --to-uint256 $(seth --to-wei 0.003 ether))
2
seth send $BPOOL "setSwapFee(uint256)" $fee
Copied!
We have a valid pool with 3 bound tokens and a swap fee of 0.3%. At this point, a decision has to be made whether to
finalize the pool. A pool can either be private or shared. A private pool allows the owner to continually adjust tokens, balances, weights, and fees. But prevents anyone else from adding or removing liquidity to that pool - it wouldn't be fair if the owner changed weights if other users have contributed liquidity! A shared pool is created when the finalize function is called and is a one-way transition. This locks all of the tokens, balances, weights, and opens the ability for outside users to add and remove liquidity.A private pool allows the owner to continually adjust tokens, balances, weights, and fees - but prevents anyone else from adding or removing liquidity to that pool. After all, it wouldn't be fair if the owner changed weights after other users contributed liquidity! A shared pool is created when the
finalize function is called - and this is a one-way transition. This locks all of the tokens, balances, weights, and opens the pool to outside users to add and remove liquidity.For our example, we want other users to be able to add liquidity, so let's finalize it. 100 Balancer Pool Tokens will be minted as part of the pool finalization regardless of the bound token balances. Balancer Pool Tokens, or BPTs, represent proportional ownership of a pools liquidity. Any future joins or exits are calculated based on the relative liquidity being added.
1
seth send $BPOOL "finalize()"
Copied!
All done, now anyone can add liquidity and swap against the assets in the pool!
Let's confirm that we received BPTs by calling
balanceOf directly on the pool address (since the pools themselves are ERC20 tokens)1
seth --from-wei $(seth --to-dec $(seth call $BPOOL "balanceOf(address)" $ETH_FROM))
Copied!
Last modified 9mo ago