This is a Beta version and may still contain bugs. We are not responsible for any losses caused by this version.

Design Concept

RICO is a framework which forms a robust boilerplate for decentralized initial coin offerings (ICO). With RICO your ICO will be more responsible and be easier to set up and launch.

The problems with conventional ICO's

With a conventional ICO, the project owner can freely decide the process how tokens are generated. That is, the token design and holding ratio is decided by the project owner. After an initial issuance these tokens are sold to supporters at a certain price or exchanged for the total raised funds during the ICO.

RICO's approach

With RICO's approach the entire execution process of issuing tokens is strictly defined on the Ethereum Virtual Machine (EVM) and executed automatically. With RICO your ICO will be fully automatic and decentrilized. The decentrilized nature of an ICO created with RICO implements a true fair distribution system.

An ICO made with RICO is:

• Decentralized
• Autonomous
• Fair
• Mintable
• Easy to use

Docs

Whitepaper

• Whitepaper[EN]
• Whitepaper[JP]

Tutorial

• RICOTrutorial[JP]

Dependencies

• Node v9.0.0
• Truffle v4.0.1
• solidity-compiler v0.4.18

This project requires the truffle framework to be installed globally. Please make sure you install this globally first:

$ npm install [email protected] -g 

You can use ethereumjs-testrpc to test your RICO build.

$ npm install ganache-cli -g

Getting Started

Install rico-core

$ npm install -g rico-core

Generate project

$ rico new helloico && cd helloico 

Local Testnet deploy

Coming soon.

Testnet deploy (ropsten)

Caution: ropsten hit the Byzantium HardFork #1700000 you have to update geth to v1.7 and sync to the latest block.

$ npm install truffle-hdwallet-provider

In order to deploy a new project, sending a deploy transaction to launcher contract. For now, launcher has deployed in ropsten network. => launcher.sol

Sending deploy transaction process:

$ export MNEMONIC_KEY="your mnemonic key 12 words" 
$ export RICO_ADDR=0x9e18e5bdb7f47631cf212b34a42cd54cfd713a6d
$ export LAUNCHER_ADDR=0x40c75eb39c3a06c50b9109d36b1e488d99aadf97
$ truffle exec exec/KickStarter/deploy.js --network ropsten

Mainnet deploy

$ export MNEMONIC_KEY="your mnemonic key 12 words" 
$ export RICO_ADDR="non"
$ export LAUNCHER_ADDR="non"
$ truffle exec exec/KickStarter/deploy.js --network mainnet

Customize ICO project

To customizing ICO deploy files -> exec/KickStarter/deploy.js

const Launcher = artifacts.require("./Launcher.sol")
const RICO = artifacts.require("./RICO.sol")
const MultiSigWalletWithDailyLimit = artifacts.require("./MultiSigWalletWithDailyLimit.sol")

const name = "Responsible ICO Token";
const symbol = "RIT";
const decimals = 18;

const totalTokenSupply = 400000 * 10 ** 18; // set maximum supply to 400,000.
const TokenSupply = totalTokenSupply * 10 / 100
const bidWeiLimit = 100 * 10 ** 18
const now = parseInt(new Date() / 1000)
const bidStartTime = now + 72000; //sec

const podTokenSupply = totalTokenSupply * 90 / 100
const podWeiLimit = 100 * 10 ** 18
const podStartTime = now + 172000; //sec

const lastSupply = totalTokenSupply * 30 / 100;

const marketMaker = 0x1d0DcC8d8BcaFa8e8502BEaEeF6CBD49d3AFFCDC; // set first market maker's address 
const owner = 0x8a20a13b75d0aefb995c0626f22df0d98031a4b6;
const dailyLimit = 200 * 10 ** 18

module.exports = async function (callback) {

  const rico = await RICO.at(process.env.RICO_ADDR) // ropsten tsetnet
  const launcher = await Launcher.at(process.env.LAUNCHER_ADDR) //ropsten testnet
  const po = await getAccount()

  console.log(`RICO: ${rico.address} launcher: ${launcher.address}`)

  const wallet = await MultiSigWalletWithDailyLimit.new([owner, po], 2, dailyLimit)

  console.log(`MultisigWallet: ${wallet.address}`)

  const newICO = await launcher.simpleICO(
      name,
      symbol,
      decimals,
      wallet.address, [podStartTime, podTokenSupply, podWeiLimit], [podTokenSupply / 2, podStartTime + 78000]
    )
  }

  console.log(`tx:${newICO.tx}`)

}

Calling method standardICO process uses RICO standard pods.

  newICO = await launcher.standardICO(
    rico.address,
    name,
    symbol,
    decimals,
    wallet.address,
    0, [bidStartTime, bidTokenSupply, bidWeiLimit, lastSupply], [podStartTime, podTokenSupply, podWeiLimit], [po, owner], [marketMaker]
  )

Test

testing on ganache-cli

Running ganache-cli, and allocate account's balance.

$ ./rpcrun.bash

$ truffle test 

LICENSE

RICO is licensed under the GNU General Public License v3.0.