FundContract

Installation

Deploy

Deployment can be done in several ways:

1. Through the intercoin factory mechanism.
2. Deploy FundFactory before and call the method produce.
3. Deploy FundContract directly on the network and call the method init.

In all cases, parameters need to be specified:

name | type | description | example
--|--|--|--
_sellingToken|address|address of the ITR token | 0x6Ef5febbD2A56FAb23f18a69d3fB9F4E2A70440B
_timestamps|uint256[] | array of timestamps (GMT) | [1609459200, 1614556800, 1619827200]
_prices|uint256[]| array of prices for the exchange in ETH (multiplied by 1e8) | [12000000, 15000000, 18000000]
_endTime|uint256| the time after which the exchange will be stopped | 1630454400
_thresholds|uint256[]| thresholds of ETH (in wei) that trigger bonuses for group members | [10000000000000000000, 25000000000000000000, 50000000000000000000]
_bonuses|uint256[]| bonuses in percentages (multiplied by 100), e.g., 10%, 20%, 30% or 0.1, 0.2, 0.5 | [10, 20, 50]
_ownerCanWithdraw|enum(never, afterEndTime, anytime)| an option representing the owner's ability to withdraw tokens left in the contract| 1
_whitelistData|{address contractAddress, bytes4 method, uint8 role, bool useWhitelist;}| settings for the whitelist. The exchange can only be accessed by whitelisted individuals. For more information, see the Intercoin/Whitelist repository. In example "internal whitelist"| [0x0000000000000000000000000000000000000000,0x95a8c58d,0x4,true]

Overview

Once installed, methods can be used for exchange.

Methods

| Method Name | Called By | Description |
|---|---|---|
| getConfig | Anyone | Retrieves data with which the contract was initialized. |
| receive | Anyone | An internal method triggered when the contract receives ETH. It exchanges ETH for tokens. |
| getGroupBonus | Anyone | Retrieves the current group bonus. |
| getTokenPrice | Anyone | Retrieves the current token price. |
| withdraw | Owner | Withdraws a specified amount of tokens to a given address. |
| withdrawAll | Owner | Withdraws all tokens to the owner (sender). |
| claim | Owner | Claims a specified amount of ETH to a given address. |
| claimAll | Owner | Claims all ETH to the owner (sender). |
| setGroup | Owner | Links participants to a group. |

$3

Returns the parameters with which the contract was initialized.

$3

Parameters:
name | type | description
--|--|--
groupName|string| The name of the group.

Returns the group bonus as a uint.

$3

Returns the token price as a uint.

$3

Parameters:
name | type | description
--|--|--
amount|uint256| The amount of tokens to withdraw.
addr|address| The address to send the tokens to.

$3

Withdraws all tokens to the owner.

$3

Parameters:
name | type | description
--|--|--
amount|uint256| The amount of tokens to claim.
addr|address| The address to send the tokens to.

$3

Claims all ETH to the owner (sender).

$3

Parameters:
name | type | description
--|--|--
addresses|address[]| The addresses that need to be linked with the group.
groupName|string| The name of the group. If the group doesn't exist, it will be created.

Example

1. Deploy the contract (through the intercoin factory mechanism).
2. Transfer some sellingToken to the contract.
3. Now, any user who sends ETH to the contract will be able to receive sellingToken until the endTime expires or the contract has enough tokens to return.
4. If the owner adds a user to a group (by calling the setGroup method) and the group reaches the threshold, all group members will receive bonus tokens.
5. Additionally, if a user acquires tokens without being in a group and then becomes a member of any group, all the contributed tokens will be part of the group and increase the group bonus.

How Bonuses Work

We have created a contract that sends additional tokens to a group of people who contribute more than the specified thresholds. For example:

After 10 ETH - 10% bonus

After 25 ETH - 20% bonus

After 50 ETH - 50% bonus

So the initial parameters will be:

thresholds = [10_000000000000000000, 25_000000000000000000, 50_000000000000000000]

bonuses = [10, 20, 50]

Here, the thresholds are set in wei and the bonuses are multiplied by 100.



For a better understanding of the math, let's take the variable price_ETH_TOKEN = 10000000 (0.5 ETH = 1 ITR).

look at the table below

	action	person	total contributed, ETH		bonus tokens contributed, ITR		got by transaction, ITR		Total balance, ITR	"BestGroup" Total, ETH		"BestGroup#2" Bonus, %
			old	new	old	new	main	bonus		Total, ETH	Bonus, %	Total, ETH	Bonus, %
1	Setup the same group "BestGroup"(setGroup) for Person#1,Person#2									0.0	0.0	0.0	0.0
2	Person#1 contributed $5,000	Person#1	0	5.0	0.0	0.0	10.0	0.0	10.0	5.0	0.0	0.0	0.0
		Person#2	0.0	0.0	0.0	0.0	0.0	0.0	0.0
		Person#3	0.0	0.0	0.0	0.0	0.0	0.0	0.0
		Person#4	0.0	0.0	0.0	0.0	0.0	0.0	0.0
3	Person#1 contributed $7,000	Person#1	5.0	12.0	0.0	2.4	14.0	2.4	26.4	12.0	10.0	0.0	0.0
		Person#2	0.0	0.0	0.0	0.0	0.0	0.0	0.0
		Person#3	0.0	0.0	0.0	0.0	0.0	0.0	0.0
		Person#4	0.0	0.0	0.0	0.0	0.0	0.0	0.0
4	Person#2 contributed 25 ETH	Person#1	12.0	12.0	2.4	4.8	0.0	2.4	28.8	37.0	20.0	0.0	0.0
		Person#2	0.0	25.0	0.0	10.0	50.0	10.0	60.0
		Person#3	0.0	0.0	0.0	0.0	0.0	0.0	0.0
		Person#4	0.0	0.0	0.0	0.0	0.0	0.0	0.0
5	Setup the same group "BestGroup"(setGroup) for Person#3									37.0	20.0	0.0	0.0
6	Person#3 contributed $25,000	Person#1	12.0	12.0	4.8	12.0	0.0	7.2	36.0	62.0	50.0	0.0	0.0
		Person#2	25.0	25.0	10.0	25.0	0.0	15.0	75.0
		Person#3	0.0	25.0	0.0	25.0	50.0	25.0	75.0
		Person#4	0.0	0.0	0.0	0.0	0.0	0.0	0.0
7	Person#4 without any group contributed 25 ETH	Person#1	12.0	12.0	4.8	12.0	0.0	7.2	36.0	62.0	50.0	0.0	0.0
		Person#2	25.0	25.0	10.0	25.0	0.0	15.0	75.0
		Person#3	0.0	25.0	0.0	25.0	50.0	25.0	75.0
		Person#4	0.0	25.0	0.0	0.0	50.0	0.0	50.0
8	Setup the same group "BestGroup#2"(setGroup) for Person#4									62.0	50.0	25.0	20.0
10	Finally	Person#1	12.0	12.0	4.8	12.0	0	7.2	36.0	62.0	50.0	25.0	20.0
		Person#2	25.0	25.0	10.0	25.0	0.0	15.0	75.0
		Person#3	0.0	25.0	0.0	25.0	50.0	25.0	75.0
		Person#4	25.0	25.0	50.0	10.0	0.0	0.0	60.0