This section explains how to get started making insured refundable investments in the projects covered by the dApp.
You can create, monitor and manage your insurance with every tool that is able to interact with the Ethereum blockchain, but for maximum convenience, we recommend using the official UI of the dApp - ICO-Refund.com.
This section of the documentation implies that you will be using the official UI of the dApp - ICO-Refund.com to interact with the dApp.
Using the demo¶
A demo version of the platform is deployed on the Rinkeby test network - https://demo.ico-refund.com. It’s completely identical to the main net one, it’s source code is also open source and published as a proof of that. You can try the dApp and get familiar with its functionality easy and with no cost.
When you request you investment insurance for a demo project your project tokens will be automatically transferred to you as you have received it in exchange for a contribution to it. See your newly received tokens in your MetaMask plugin by clicking ‘Add token’ in the menu, then ‘Custom token’, and enter the token details displayed in the project information section.
Requesting a demo insurance¶
To make new test insurance for your hypothetical investment in the demo project first go to the Rinkeby faucet to get some test Ether on the Rinkeby test network. Then visit the page of one of the currently running demo projects on Refundable Token Offerings demo UI.
Go to the ‘New Insurance’ tab, enter the amount of your investment - your pool contribution (‘fee’) will be calculated for you, then confirm the 2 transactions with your MetaMask plugin:
- The first one is the purchase of your demo tokens and it only exists here on the demo version to simulate the investment in the project. On the main net dApp you make your investment separately just like you normally do, it is NOT made through the RTO platform.
- The second one is your insurance request call to the dApp on the blockchain. In about 15 minutes your project tokens will be automatically transferred to you when the transactions are confirmed - as you have received it in exchange for your contribution to the project.
Governance & UI controls¶
Your Ethereum account now posses the tokens from your fictional investment and it is insured with a refund option. You along with the other investors in the demo project that test the dApp along with you can decide if you will vote the project as failed and receive the refund of your hypothetical test investment or not.
You can also cancel your insurance and receive their fee back or not and to test the insurance cancelation available for investors which for example want to sell their tokens and no longer need a refund option. All governance controls and information for your insurance and the current project state is located in the tabs on the project’s page under the information section.
Demo time periods and project state durations¶
The contracts of the demo and main net dApp versions are completely identical with the exception of the block numbers used for measuring of time - they are lowered in the demo instance in order to shorten state durations and various other time periods. For example, the coverage period of a project (the insurance policy) is shortened from 2 years to 2 days for demonstration.
The time durations are approximate as they are measured in blocks on the dApp
- Insurance policy (project coverage): ~ 48 hours
- Base policy: ~ 24 hours
- Open for new insurance requests: ~ 6 hours
- Cancelation period: ~ up to 3 hours after insurance request
- Internal vote period: ~ 6 hours
- Freezestate: ~ 1 hours
- Refund period: ~ 4 hours
- Dispute voting stage: ~ 4 hours
- Dispute revealing stage: ~ 3 hours
Your first investment insurance¶
You can make your insurance both after you made your contribution to a project, or before that. The important thing is to request your investment insurance with the same Ethereum account that will receive, or already has received, the tokens from the token offering.
When the tokens get distributed to the investors, the dApp checks the Ethereum addresses of the insurance owners for the project tokens to validate their investment and therefore - insurance.
To make your investment protection all you have to do is go to the project page of the token offering, click on the ‘Protect my contribution’ button or the ‘New Insurance’ tab and enter the amount of your investment in the form.
Your secured amount and pool contribution - the ‘insurance fee’ will be calculated for you. Use ‘Protect my investment with insurance’ button to send the transaction with the data and the payment to the dApp and confirm it with MetaMask or your Ethereum compatible browser.
That’s all, your investment in the project is now protected. In case of project failure of any kind, or drastic drop in the value of the token, the secured amount of your investment will be refunded back to you.
Let’s say Bob wants to make an investment of 10 Ether in ‘Project X’. However, Bob knows that participating in token offerings and investing in new blockchain projects is extremely risky so he wants to cover himself with investment insurance and a refund option.
He finds the Project X in the list of covered projects on ICO-Refund.com and enters 10 ETH for his investment amount in the form of the project’ page. If the current protection rate of ‘Project X’ is 95% - his investment insurance will be:
|Investment||Secured amount||Pool contribution (‘fee’)|
|10.00000000 ETH||9.50000000 ETH||1.80000000 ETH|
Bob sends and confirms his insurance, his investment is now covered. He can choose to hold the insured tokens and wait for the progress of ‘Project X’, or to cancel his insurance and withdraw his fee back if for example the ‘Project X’ tokens are up in price and he wants to sell them for profit.
If he chooses the first option and something goes wrong with the project and/or its token value during the 2-year insurance policy, Bob can take his 9.5 ETH back.
Requesting a refund state¶
Because the dApp is built as a decentralized autonomous organization, the decisions for its governance are made not by a single individual or centralized group of people in power but by the collective consensus of the participants in the platform.
Requesting a refund state is a form of project governance (control), exercised by you and the other investors that have active investment insurance for that project.
If you request a refund state for a project that means you are voting that the project has been failed and has to be refunded. When 15% of the total number of investors in that project also do that, a period of 3-month internal voting by the investors will start. After that, if enough number of them consider the project as unsuccessful, a refund state will be assigned.
The only requirement that you have to do before you can request a refund state (vote for a project failure) is to transfer your project tokens to your ‘token litter’ address. This is a one-way Ethereum address that nobody has access to and it only serves as a container for returned tokens of unsuccessful projects that has to be refunded.
To make your request for a refund state go to the ‘Controls’ tab of the project’s page and click on the ‘Request a Refund State’. That will show to you your token litter address and the button to send your request. Transfer your project tokens to the address and click the button.
Confirm the call with MetaMask or your Ethereum compatible browser to send it to the blockchain. The dApp will check if the tokens have been handed over and validate your request.
The refund state will be forced to a project if it matches one or more of the community guidelines for which project are safe to be considered as unsuccessful and eligible for a refund.
Moderators can only force a refund state to a project once and do NOT have the ability to do the opposite - revoke a refund state, in case one has been already assigned.
A DAO is governed by the participants in it. The investors can settle a project state (status) themselves - by reaching a collective consensus, without relying on a centralized authority. This necessitates the need for malicious actions and/or manipulation attempts to be penalized.
Requesting a refund state for a project, that is NOT failed, according to the general consensus (vote result), is considered by the dApp as malicious act/manipulation attempt and will result in the suspension of your investment protection.
To avoid that, it’s highly recommended to make sure that the project matches one of the conditions listed in the community guidelines on which project can safely be considered as unsuccessful and eligible for a refund when you vote for a refund state.
Withdraw your investment refund¶
Once a refund state has been assigned to an unsuccessful project, to withdraw your the secured amount of your investment go to the project page, click on the ‘Controls’ tab and then on the ‘Withdraw your refund’ button to request your refund.
When you confirm the call to the dApp with MetaMask or your Ethereum compatible browser, go to your profile page and click on ‘Withdraw your funds’ to transfer the funds to your account.
You have the option cancel your insurance in case you no longer need investment protection, in case, for example, you want to trade your tokens. You can do that in a 2-months time frame - during the 2nd and 3rd months of your insurance policy.
After insurance cancelation, the investor is repaid the net amount of his pool contribution - his initial ‘fee’ amount, after the affiliate and platform commissions are deducted from it. The net amount of the pool contribution is 70% of its overall value.
To cancel your insurance go to the ‘Controls’ tab of the project page and click on ‘Cancel Your Insurance’. Confirm the call to the dApp with MetaMask or your Ethereum compatible browser, then go to your profile and use ‘Withdraw your funds’ button to transfer your payment.
Once you cancel your insurance and withdraw your fee you are no longer eligible for a refund in case of project failure or token value drop.
Insurance stats and controls (UI)¶
The information for your investment insurance(s), along with project statistics, indicators and controls (management tools), are located on every project page - under the general project information.
You can find the list with your investment insurances for the project, their status, secured amount and the pool contributions paid for them in the ‘Insurances tab’ - under the ‘Project Tracker’ box that displays the current state of the project.
In the ‘Dashboard’ tab you can see project and insurance information as well as the global pool statistics. The insurance indicators fetched from the blockchain are:
- Insurance status - the current condition of your investment protection;
- Insurance rate - the secured percentage of your total investment - it is based on the current protection rate of the project at the moment of your insurance request;
- Requested a refund -
Nobased on whether you have voted that this project is unsuccessful or not;
- Ethereum account - The Ethereum account owning the insurance - the one used for its creation (sending the new insurance request);
- Policy left - The number of months left of the insurance policy before it expires;
The ‘Controls’ tab contains the buttons that are used for project governance and insurance management, like requesting a refund state, cancelation and fee withdrawal.
The ‘Supporters’ section is for the controls used by the supporters and owners of the project.
Your profile (UI)¶
This section covers the various information, statistics and indicators displayed a profile page in the dApp’s official UI - ICO-Refund.com
- Total invested funds - the overall amount of your investments in all covered projects;
- Overall secured amount - the total secured amount from your total invested funds;
- Pool contributions - Total amount of ‘fees’ paid for all insurances;
- Affiliate Earnings - The current amount of affiliate commissions since your last withdrawal;
- Repaid pool contributions - Total amount of withdrawn repaid fees from canceled insurances;
- Total withdrawable funds - Total funds that you currently have available for withdrawal - includes investment refunds and pool contributions;
- Bookmarks - a list of projects that you have followed;
- Disputes - a list of disputes (public community votes) that you are watching;
- 2FA - Google 2-Factor Authentication settings for your profile;
An affiliate partner earns 20% of every insurance request made by a referred user. Besides that, the referred user gets 10% discount on all of his requests. Like the other features of the platform, the affiliate functionality is also executed by smart contracts.
That means you can withdraw your earnings whenever you like and don’t have to count on somebody to order your payment or worry about delays of any kind. When your referral makes new insurance, your commission is automatically transferred to your balance by the dApp.
Because of the enormous amount of corruption and dishonesty among some of the reviewers and “influencers”, we only allow approved referral partners. If you like the dApp and want to be a part of it, please contact us via the contact form or at firstname.lastname@example.org
In order to receive your affiliate payments, you must go to your profile page and fill your Ethereum account in the ‘Primary Ethereum Address’ field.
On every new insurance request made by a user that you has referred, the dApp automatically gives you your commission from his payment to the Ethereum address provided.
To withdraw your affiliate earnings go to your profile page, click on the “Request affiliate payment” and then on “Withdraw my affiliate payment” button and confirm the transaction. You must do it with the same Ethereum account that you pointed in your profile.
Project owners & supporters¶
Owners and supporters of a project can help the investors and potential investors by
making a special type of collateral deposit to the collective
pool that boosts the protection rate of that project, adds a
Supported rank to it and displays it higher on the site’s listing.
This way, they are also contributing to the ecosystem as a whole while making a statement about their commitment and belief. See Premium Listing & Better Visibility ››
Read Calculation of Protection Rate section of this document to learn how the collateral deposits increase the protection rate percentage of a project.
Sending of a collateral deposit
To make a new supporter collateral deposit go to the project page, then to the ‘Supporters’ tab and click on the ‘Supporter Collateral’ button. Enter the amount of the collateral deposit you want to send, the protection rate increase will be calculated for you. Send and confirm the call to the dApp.
When you click on ‘Supporter Collateral’ you can see a table showing your collateral contribution to the project, overall collateral amount sent to it, as well as the amount that has not been used for protection rate calculation - it will be on the next deposit.
Repaying of collateral deposits
Owners and supporters can withdraw half of their net collateral contribution back after 1 year of the project coverage and the other half once the extended coverage policy of 2 years expires if the project hasn’t been settled as unsuccessful and refunded.
To withdraw a collateral deposit back you must again go to the ‘Supporters’ tab of the project page, then you must use the ‘Withdraw Supporter Collateral’ button to make the transfer.