Testnet manual

  1. Installing Metamask

  2. How to create a Metamask account

  3. Connecting Metamask to Kovan testnet

  4. How to obtain testnet tokens

  5. Connecting Metamask to Augmented Finance testnet

  6. Supplying assets

  7. Borrowing assets

  8. Withdrawing supplied assets

  9. Repaying the borrowed assets

  10. Disabling collateral

  11. Staking agTokens for AGF incentives

  12. Unstaking agTokens

  13. Locking / Unlocking AGF

  14. Referral incentives

1. Installing MetaMask

1. Go to the Chrome Web Store

2. Install the MetaMask Chrome Extension

3. After installing you need to create a Metamask account

2. How to create Metamask account

You have two options:

  • Create a new Metamask account

  • Import your existing Metamask account (see instructions)

We recommend creating a new (clean) account for the test.

How to create a Metamask account.

  1. You’ll be redirected to the Metamask website for creating an account

3. Click “Create a Wallet”

4. Select “No thanks” on the next screen

5. Create a password

6. Save the secret backup phrase

7. Confirm the backup phrase

You’re done: Metamask account created; enter your password and move to the next steps

3. Connecting Metamask to the Kovan testnet

Open Metamask, click on “Networks” and select “Kovan Test Network”

4. How to obtain testnet tokens.

In this part you’ll learn how and where to get Kovan ETH, USDC, USDT, WBTC, DAI, aDAI, cDAI, and cETH tokens. You’ll need all of them for Augmented Finance testing.

In order to make test tokens visible in your Metamask, add these cryptocurrencies’ Kovan smart contracts.

Go to Metamask “Assets” and click Add Token

Enter the following Token Contract addresses:

  • DAI - 0xFf795577d9AC8bD7D90Ee22b6C1703490b6512FD

  • USDC - 0xe22da380ee6B445bb8273C81944ADEB6E8450422

  • USDT - 0x13512979ADE267AB5100878E2e0f485B568328a4

  • WBTC - 0xD1B98B6607330172f1D991521145A22BCe793277

  • AGF - 0x438bA477ed273716b1d3214B96Eb9d1461233248

  • aDAI - 0xdCf0aF9e59C002FA3AA091a46196b37530FD48a8

  • cDAI - 0xF0d0EB522cfa50B716B3b1604C4F0fA6f04376AD

  • cETH - 0x41B5844f4680a8C38fBb695b7F9CFd1F64474a72

1. Kovan ETH (WETH)

You’ll need them to pay transaction fees while testing the Augmented Finance protocol.

Request Kovan ETH from the KETH faucet (it gives 0.1 ETH): https://faucets.chain.link/kovan

Use your Metamask wallet address for that.

  1. Copy your Metamask address

2. Paste it into the faucet “Testnet Account Address”. Select “Kovan testnet” in the Network dropdown menu. Click the checkbox “0.1 test ETH” and send request. You’ll get 0.1 ETH to your Metamask in a few seconds.

If the Chainlink faucet doesn’t work, please use one of the following:

https://ethdrop.dev/ (gives 0.001318 ETH per request)

https://gitter.im/kovan-testnet/faucet (one request per 24 hours)

https://app.mycrypto.com/faucet (gives 0.01 ETH per request)

To avoid ETH shortage, we recommended to decrease gasPrice to 1 GWEI.

2. USDC, USDT, WBTC, and DAI.

These are testnet stable coins. You will use them for depositing (supplying) to the protocol.

You can get tokens for testing at AAVE’s faucet https://testnet.aave.com/faucet.

1. Select Kovan AAVE V2 market in the top right corner (it must have a “K” letter in the top right corner); click “Connect” to connect your Metamask; make sure you select Kovan ETH before using the faucet

2. Choose “Browser wallet”

3. This is how it looks when you’re connected Make sure your Metamask wallet address is connected to the AAVE faucet and your Metamask wallet address used for Augmented testnet are the same. Sometimes people have two or more Metamask addresses and this can lead to confusion between them.

4. Then click 'More' --> 'Faucet' Select USDC, USDT, DAI, and WBTC one by one, and submit the transaction.

After submitting your wallet balance should look like this:

  • USDC : 10,000

  • USDT : 10,000

  • DAI : 10,000

  • WBTC : 1,000

  • ETH (KETH) : 0.1 (a little less because you paid transaction fees to the Kovan testnet)

3. aDAI, cDAI, cETH test tokens.

These are AAVE and Compound interest bearing tokens.You deposit DAI or ETH to AAVE or Compound, and get a/cTokens to your wallet. They are also applicable for supplying to Augmented Finance. We’ll support more of a/cTokens, not only these three in Augmented mainnet.

  1. aDAI

  • To get them, you have to stay connected to the Kovan AAVE V2 market

  • Set the deposit amount: 2000 DAI

  • Approve the transaction and click “Deposit”

  • Now you have 2000 aDAI tokens on your Metamask balance

Check it in Metamask:

or at https://kovan.augmented.finance/supply

2. cDAI, cETH

Since they are Compound interest bearing tokens, you’ll get them on the Compound testnet.

  • Once connected, you’ll see your wallet address in the top right corner

  • Go to the Supply tab and click “Dai Stablecoin”

  • Inside the window select “Withdraw” and go to the bottom of it; you’ll find the “Faucet” for getting Compound testnet tokens; click on it

  • Confirm the Metamask transaction and in a few seconds you’ll get DAI testnet coins; the Compound faucet gives 0.0068 DAI per one request

Now, you need to supply them to Compound testnet in order to get cDAI tokens.

  • Go to Supply tab and click “Dai Stablecoin”

  • Inside the window select “Supply”, click “Enable”, and confirm the Metamask transaction

  • Choose “Supply” and click MAX to supply all of your DAI; then click “Supply” button and confirm the transaction

  • You will now have cDAI tokens; they are displayed in your Metamask balance

To receive cETH tokens, you need to supply ETH from your balance.

  • Go to the Compound supply tab and select ETH

  • Enter the ETH amount you want to supply inside the window that opens

We recommend not to supply all your ETH because you’ll need ETH to pay transaction fees.

  • Click “Supply”

Done! You now have cETH tokens.

Now you have all testnet tokens you need (USDT, USDC, DAI, WBTC, ETH, aDAI, cDAI, cETH). Go to the https://kovan.augmented.finance/ and start testing Augmented Finance.

5. Connecting Metamask to Augmented Finance testnet

  1. Visit https://kovan.augmented.finance/ and connect it to Metamask

2. You are ready for the test!

6. Supplying assets

  1. Choose the asset you want to supply and click on “Supply”

3. You will then be redirected to the supply page

4. Click “Approve” to approve the transaction 5. Confirm the transaction in Metamask 6. Enter the amount to supply and click “Supply”

7. Confirm the transaction in Metamask

8. The transaction may need some time to be executed, depending on the gas price that you decided to pay; even with default gas it’s quite fast

9. If your transaction has been processed, you'll see a confirmation message

10. In case something wrong with your supply transaction, please describe your problem and together with the hash of this transaction send it to our support team in the chat, in Discord (#testnet-feedback), or email support@augmented.finance

11. Now you can see the supply amount on your dashboard https://kovan.augmented.finance/dashboard/assets.

Once they have supplied their assets, users start earning interest in both underlying assets (DAI and AGF tokens in this example) and the interest is added directly to the balance.

You can Disable/Enable the “Collateral” option depending on whether or not you want to borrow against that asset

Please note: we don't accrue rewards for USDC, aDAI, cDAI and cETH tokens. It's a testnet limitation. All rewards will work properly on the mainnet.

Please note: APY% is the amount of interest that a user receives annually on a particular token. This value is not fixed and can fluctuate depending upon the market supply and demand of the asset.

7. Borrowing assets

With Augmented Finance, a user can either lend (supply) or lend and borrow simultaneously. Borrowing requires supplying some collateral.

Here you see the assets for borrowing. “Available to borrow” column shows you each asset max. amount you can borrow.

2. Choose the asset you want to borrow and click “Borrow”

  • Make sure you supplied another asset as a collateral

  • If you supplied an asset as collateral but disabled it from being collateral, you can enable it in the dashboard

  • If you supplied and staked the asset, your interest-bearing tokens are staked and can’t be used as a collateral; you can unstake them anytime in the “Stake agTokens” tab

3. Enter the token amount that you want to take out as a loan and click “Borrow”

4. A transaction is triggered, which you need to approve in Metamask

If your transaction has been processed, you'll see a confirmation message. After the approval, you’ll see the transaction status and are able to check it on Kovan Etherscan.

5. In case something wrong with your borrow transaction, please describe your problem and together with the hash of this transaction send it to our support team in the chat, in Discord (#testnet-feedback), or email support@augmented.finance

6. Now you can see the borrow and supply balances in your dashboard; the same amount of tokens will also appear in your MetaMask wallet, which you can use for further transaction activities

8. Withdrawing supplied assets

You have 2 options to withdraw:

Choose the asset you want to withdraw and click on the “Withdraw” button.

2. Or go to your Dashboard, find the “Withdraw” button and click it

3. Enter the amount and click “Withdraw”

4. Confirm the transaction in Metamask

5. If your transaction has been processed, you'll see a confirmation message

9. Repaying the borrowed assets

You have two options to repay:

  1. Choose the asset you want to repay and click “Repay”

3. Or use the Dashboard page, choose the asset you want to repay, and click “Repay”

4. Enter the amount you want to repay and click “Repay” to repay your borrowed loan

5. If your transaction has been processed, you'll see a confirmation message

10. Disabling collateral

By default, supplied assets are used as collateral. You can turn off the “Collateral” option depending on whether or not you want to borrow against the supplied assets. Please note: in order to disable collateral, make sure you've supplied all assets according to the testnet report form (at least 3 assets). Then, collateral disable will be available.

  1. Find “Collateral” and click “Disable”

3. Approve the transaction

4. Confirm the transaction in Metamask

5. If your transaction has been processed, you'll see a confirmation message

6. Go back to “Dashboard” and check the Collateral button; it will show “Enable”

11. Staking agTokens for AGF incentives

Staking agTokens is one of the options for getting AGF tokens. Please note: In order to stake agTokens, make sure you've supplied all assets according to testnet report form (at least 3 assets). Staking agTokens reduces your health factor, so you may be able to stake only one agToken depending on the amount of assets you supplied beforehand.

  1. Select “Stake agTokens”

3. Select the asset you would like to stake and click the “Operations” dropdown menu

4. Enter the number of agTokens that you want to stake, click the “Stake” button, and approve the transaction using Metamask

5. The staked amount should be reflected in the “Staked balance”

NB: agTokens and all other tokens in the staking module are subject to 30% slashing in case of a shortfall event.

12. Unstaking agTokens

  1. To unstake your agTokens go to https://kovan.augmented.finance/stake

  2. Select “Stake agTokens”

  3. Choose the assets you want to unstake and click the “Operations” dropdown menu

  4. Click the “Cooldown to unstake” button and confirm your transaction

5. After that, the 2-minute cooldown period will be applied (for mainnet it will be 48 hours): you need to wait until it’s over

6. Once it’s completed, the “Withdraw” field will be activated and you’ll have 24 hours to withdraw; if you miss this deadline, the unstaking procedure will be canceled and you have to start over again with the cooldown period

13. Locking/Unlocking AGF

Locking AGF tokens allows you to earn a maximum boost of up to 4x AGF incentives depending on your supply, borrow, and staking activity. By locking AGF you receive xAGF tokens which are used to boost rewards, to get a portion of the protocol's treasury, and to vote on protocol proposals.

Your AGF balance should be visible in your Metamask wallet. If you don’t see AGF in the Metamask, add its contract manually:

  • Go to Metamask “Assets” and at the bottom click “Add Token

  • Enter the AGF token contract addresses:

  • AGF - 0x438bA477ed273716b1d3214B96Eb9d1461233248

Claiming AGF for locking

  • To lock AGF you need to have them on your wallet balance; if there is no AGF, but you have assets supplied / borrowed / staked, check your dashboard about the AGF rewards available to be claimed

  • Click “Claim & Lock”; after Metamask has confirmed, your AGF will be locked automatically for a 3-month period

  • To check your locked AGF balance, go to the “Boost” tab and to the “Boost APY” section; the locked balance is displayed in the “Balance” section

How to set auto lock parameters:

  • Go to the “Boost” tab and to the “Automate” section

  • Find the “Auto lock parameters” tab; here you can regulate the auto lock parameters

How to disable auto lock:

If you want to regulate AGF locking manually, you need to disable AGF auto lock before claiming AGF.

  • Go to the “Boost” tab and to the “Automate” section

  • Find the “Auto lock status” tab

  • Switch it to “Inactive” and confirm the Metamask transaction

  • Now your claimed AGF will be sent to your Metamask address instead of being locked

How to lock AGF manually:

  • Go to the “Boost” tab and to the “Boost APY” section

  • Find the “Lock AGF to boost your APY” tab; it shows your AGF balance and allows you to set the locking amount and period (from 7 days to 4 years)

  • Set everything and click “Lock”

  • Now the locked balance is displayed in the “Balance” section

In the “Boost APY” section, you also have tabs for regulating your lock. You can increase the locked amount and extend the locking period.

14. Referral incentives

The referral section will let you track your reflink usage and rewards.

2. Copy the unique referral link and share it across your social media accounts

3. The “Transaction history” tab shows your reflink usage history

Last updated