Give Coin

Give Coin is the official coin for charitable giving and the non-profit industry.

Scope

• ERC223 token creation based upon Ethereum

• A protocol with special event creation to anchor giving data to a blockchain specifically targeted for the non-profit sector. This includes:

  1. Timestamp
  2. Donor Address
  3. Donor Name
  4. Amount
  5. Recipient Address
  6. Recipient Name

• Token crowdsale parameters based upon the following:

  1. Token Supply: Fixed at 50M (Non-mineable)
  2. Crowdsale Supply: 25M (50%)
  3. Max Cap = 25M
  4. 300 GIVE Coin = 1 ETH
  5. Purchase Methods = ETH, BTC
  6. Minimum Contribution Amount = 0.01 ETH or .001 BTC
  7. Duration = 30 Days starting 10/2

• For more details regarding the GIVE Coin including the crowdsale, utility, and ecosystem, please view the whitepaper located here: https://docs.google.com/document/d/1CIwDHv7pg97ZBLzup-Xq84GSAp3Dx4HEVNj0j5CrnXs/edit?usp=sharing

Testnet

The whole contract system is already operationable. It is currently deployed on Rinkeby testnet:

Crowdsale contract: 0x6eD1020f4521B78c064367F1B32C8e198f072320

Token contract: 0x8a9ef205f2787fde2ac9bbbaa7149b9e0de0cc90

Database contract: 0xd05835b3e8a136661487fe1fd8bcbbb921eb3f78

Getting Started

To contribute to Give Coin crowdsale you should just send ETH into the crowdsale contract address. 120 000 GAS is required.

MyEtherWallet could be used to send the transaction:

To watch the token on MyEtherWallet you need to add it to your token list. Press "Add Custom Token" button and insert token contract address (0x20d7e07c51e2ad3eb5529f7ec047ec895568dcda on Rinkeby), token symbol (anything you like) and token decimals ( 2 ) then press "Save" button.

Test Private Key: 1234560000000000000000000000000000000000000000000000000000000fff Test Address: 0xCa9622A798CCD9855558E75560C1052862EEf18E

Making a Donation

The donate function should be executed to submit an official donation.

You can execute it via MyEtherWallet web interface. You need to access "Contracts" tab and insert token contract address and its ABI.

Token contract address is 0x20d7e07c51e2ad3eb5529f7ec047ec895568dcda on Rinkeby. Token contract ABI can be found here.

Copy and Paste token ABI and address as follows, then press "Access" button:

Selec the donate function. The function works as ERC223 transfer with additional special event to anchor Donor and Recipient data to the blockchain.

• _to parameter is an address of the recipient.
• _value is an amount of tokens you would like to donate.
• _data is a special data of ERC223 token transfer. Leave it empty.
• _donor is a name of donor.
• _recipient is a name of the recipient.

To watch the donation you should access transaction event logs. Example donation transaction on Rinkeby can be found by this link.

Donor and recipient names could be accessed as hex-encoded string values of the event topic 0xfd25b07f10b1223eefa1bfa653ba0829d1f27af024473ed776abeb44b46cee61.

Deploying contracts

1. Compile and deploy token, token database and ICO contracts.
2. Call configure function to upload at the ICO contract to upload token contract address, ICO start timestamp (in UNIX seconds) and ICO end timestamp (in UNIX seconds).
3. Call configure function to connect token contract with token database.
4. Call configure function to connect token database with ICO and token contracts.

NOTE: The whole system of contracts will only work if all contracts are properly connected with each other via configure functions.

Starting the ICO

NOTE: When configuring contracts, you should assign ICO start and end dates. If you need to re-assign dates you can call configure function again with new dates. This will overwrite previous values.

Contracts owner (address that deployed contracts) will automatically receive a full amount of tokens (50 M) at his balance after contracts deployment. The ICO contract must be filled with tokens before the ICO begins.

1. Transfer 25,000,000 tokens to the ICO contract address.
2. If the ICO contract was correctly configured, the ICO will start at the specified time and will end automatically.
3. If ETH price changes during the ICO period then it can be adjusted by adjust_price function of the ICO contract.
4. In case that not all tokens were sold during the ICO the remaining tokens should be withdrawn by withdraw_tokens function of the ICO contract.