Smart Contract protocol where a user can deposit an NFT and fractionalize it into a number of ERC20 tokens called fractions. The user can to create an offering for the fractions. Other users could choose and buy fractions at the specified time.
- Test the contracts
npm hardhat test npm hardhat coverage- Production
- ERC20FractionTokenFactory
- ERC20FractionToken
- IAuction
ERC20FractionTokenFactory contract has only one function: to create new ERC20FractionToken contracts, that are backed up by single IERC721 NFT.
ERC20FractionTokenFactory.create initializes the ERC20FractionToken smart contract and mints the total supply. After the ERC20FractionToken is initialized, ERC20FractionTokenFactory transfers the NFT to it. Before that transfer of NFT, the user must call
(ERC721)NFT.approve(ERC20FractionTokenFactory.address)
In order to create a fraction, the ERC20FractionTokenFactory.create needs the following parameters:
name — new name use for ERC20
symbol — new ERC20 symbol
token — NFT contract address
id — NFT id
suply — the max supply of ERC20 Contract
Auction specifics:
- time based
- supply based
Currently, the project provide types of auction:
- First bid, first buy action
- Dutch Auction ! feel free to implement IAuction interface and provide other types of auctions
Every auction must implement this interface:
interface IAuction {
function start(uint256 _tokensForSale);
function bid(address recipient) payable;
function end();
function getPrice() view returns(uint256);
function getRemainderTokens() view returns(uint256);
}
An auction can be kicked off by creating contract instance of IAuction interface and calling ERC20FractionTokenFactory#startOffering
ERC20FractionToken#startOffering can be called only with the condition:
- the msg.sender must have all the minted ERC20 tokens
Other bidders can submit their bids by calling ERC20FractionToken#bid. Each bid is payable, but if it doesn`t succeed, the ethers/wei are given back.
depending on the specifics of the Auction, ERC20FractionToken.end is very different. See implementaion for more info.