@flarelabs/fasset
v1.0.0-beta.12
Published
Smart contracts implementing FAsset system.
Downloads
139
Readme
FAsset contracts
Solidity contracts for Flare Labs FAsset system.
Overview
The FAsset contracts are used to mint assets on top of Flare (or Songbird). The system is designed to handle chains which don’t have (full) smart contract capabilities, although it can also work for smart contract chains. Initially, FAsset system will support assets XRP, BTC, DOGE, and LTC. Later we might add other blockchains.
The minted FAssets are secured by collateral, which is in the form of ERC20 tokens on Flare/Songbird chain and native tokens (FLR/SGB). The collateral is locked in contracts that guarantee that minted tokens can always be redeemed for underlying assets or compensated by collateral.
Two novel protocols, available on Flare and Songbird blockchains, enable the FAsset system to operate:
- FTSO contracts which provide decentralised price feeds for multiple tokens.
- Flare’s State Connector, which bridges payment data from any connected chain.
Development
Getting started
- Clone this repository.
- Run
yarn
. - Compile the solidity code:
yarn c
. - Run basic tests
yarn testHH
.
Flare-smart-contracts dependency
Currently, flare-smart-contracts
dependency is obtained directly from git repository from a tag that supports the required functionality.
For development, it might be beneficial to directly use checked-out code of flare-smart-contracts
. This can be done with yarn link
:
- In
flare-smart-contracts
project folder runyarn link
- In
fasset
project folder runyarn link flare-smart-contracts
This creates softlink from node_modules/flare-smart-contracts
to the flare-smart-contracts project folder.
For development in VSCode you might also find VSCode Workspace feature useful - it allows you to have multiple projects open in the same window (e.g. both fasset and flare-smart-contracts).
Testing
Note: be sure to compile (yarn c
) after any solidity code changes or if starting a clean project as Typescript stubs need to be generated as part of the compilation.
Then one can run different types of tests.
yarn testHH
- all tests in hardhat environment (includes following two types of tests).yarn test_unit_hh
- only unit tests in hardhat environment.test_integration_hh
- only integration tests in hardhat environment.
To check test coverage run yarn cov
.