Tutorial
Docs
Truffle Console
Get started using Truffle Console
In this tutorial we will:
- Use
@superfluid-finance/js-sdkin the truffle console with goerli testnet - Mint Superfluid DAI (DAIx)
- Check Super Token balances
Installation
Download the example repo, which includes the Superfluid JavaScript software development kit.
1
git clone https://github.com/superfluid-finance/protocol-monorepo
2
yarn install
3
yarn build
Copied!
If you haven't already, install truffle and jq.
1
npm i -g truffle
2
3
# Linux
4
sudo apt-get install jq
5
# Mac
6
brew install jq
Copied!
Obtain goerli ETH
Before we can get testnet ETH, we need a 12-word mnemonic to create some test wallets. If you don't have a mnemonic, we can use Truffle to create one.
1
truffle develop
2
3
> Accounts:
4
> (0) 0x627306090abab3a6e1400e9345bc60c78a8bef57
5
> (1) 0xf17f52151ebef6c7334fad080c5704d77216b732
6
7
> Mnemonic: rigid cradle south ...
Copied!
Copy the first address and use one of the Görli testnet faucets listed at https://goerli.net/ to obtain some ETH. You can also add it to MetaMask, but please don't use it for mainnet / real tokens! If you opt for the MetaMask method, our dashboard will also send you testnet ETH when logging in.
Now exit from truffle develop, and create a file named
.env in packages/ethereum-contracts. Add the mnemonic you just created, and your web3 provider URL for goerli test network.1
cd packages/ethereum-contracts
2
cp .env.template .env
3
4
# Add your details
5
GOERLI_MNEMONIC=rigid cradle south ...
6
GOERLI_PROVIDER_URL=https://goerli.infura.io/v3/<API_KEY>
Copied!
Truffle console
We are ready to open the Truffle console. You should be in
packages/ethereum-contracts next to your .env file for this step.1
npx truffle --network goerli console
Copied!
Let's load the SDK and initialize it with the contracts.
1
SuperfluidSDK = require("@superfluid-finance/js-sdk")
2
3
sf = new SuperfluidSDK.Framework({version: "v1", web3, tokens: ["fDAI"] })
4
5
await sf.initialize()
6
7
chainId 5
8
Resolver at 0x3710AB3fDE2B61736B8BB0CE845D6c61F667a78E
9
Resolving contracts with version v1
10
Superfluid host contract: TruffleContract .host @0x22ff293e14F1EC3A09B137e9e06084AFd63adDF9
11
ConstantFlowAgreementV1: TruffleContract .agreements.cfa @0xEd6BcbF6907D4feEEe8a8875543249bEa9D308E8 | Helper .cfa
12
InstantDistributionAgreementV1: TruffleContract .agreements.ida @0xfDdcdac21D64B639546f3Ce2868C7EF06036990c | Helper .ida
13
fDAI: ERC20WithTokenInfo .tokens["fDAI"] @0x88271d333C72e51516B67f5567c728E702b3eeE8
14
fDAIx: ISuperToken .tokens["fDAIx"] @0xF2d68898557cCb2Cf4C10c3Ef2B034b2a69DAD00
Copied!
What just happened? The Superfluid SDK used theresolvercontract deployed on goerli to fetch all the Superfluid contracts for the version "test". Then the contract objects were created using the Truffle artifacts in the/buildfolder. Make sure you are using the latest version name!
For this tutorial, we'll be using fake ERC20 tokens called fDAI. If you need more than one token, you can easily add fUSDC and fTUSD as parameters when creating the sf object.
Superfluid SDK created a Truffle object for our test token, and its superToken wrapper, at sf.tokens.fDAI and sf.tokens.fDAIx
Now we'll load a web3 utility library
@decentral.ee/web3-helpers and create easy-to-use aliases for our wallet addresses and tokens.1
const {
2
toWad,
3
toBN,
4
fromWad,
5
wad4human
6
} = require("@decentral.ee/web3-helpers");
7
8
const dai = await TestToken.at(sf.tokens.fDAI.address);
9
const daix = sf.tokens.fDAIx;
10
11
bob = accounts[0];
12
alice = accounts[1];
13
dan = accounts[2];
14
carol = accounts[3];
Copied!
Mint some DAIx (Superfluid DAI)
If you used MetaMask and the Superfluid Dashboard with this wallet, then your should already have some DAIx tokens. You can skip ahead to checking balance.
Let's mint bob 100 DAI (in testnet, minting is open for anyone to call).
1
await dai.mint(bob, web3.utils.toWei("100", "ether"), { from: bob })
2
3
# Check bob's balance
4
(async () => (wad4human(await dai.balanceOf(bob))))()
5
> '100.00000'
Copied!
Now bob has some normal DAI.
Before we can use DAI with Superfluid, we need to upgrade it to the Superfluid version "DAIx".
This is done using a
SuperToken wrapper contract. Generally, there is a single wrapper for each ERC20.Because we previously got the daix object when initializing the contract, we can now upgrade 50 of bob's DAI by calling
approve() followed by upgrade()1
dai.approve(daix.address, "1"+"0".repeat(42), { from: bob })
2
3
daix.upgrade(web3.utils.toWei("50", "ether"), { from: bob })
4
Copied!
Check Balances
1
(async () => (wad4human(await daix.balanceOf(bob))))()
2
> '50.00000'
Copied!
Hurrah, we now have 50 Superfluid-enabled DAI or "DAIx". We are ready to start using Superfluid.
Up next
Last modified 8mo ago