Contact [email protected] if you can not access.

Rappe is an online marketplace that operates on Ethereum Network. There are store fronts that shoppers can login using their Metamask accounts and purchase some goods. Along with MarketPlace contracts, you can find two ERC-20 token contracts which are built based on open-zeppelin ERC-20 contract. These contracts are used as dummy contracts to show, it's able to purchase goods with ERC-20 tokens.

• Rappa Store - A decentralized Market Place
  • Table of Contents
  • Features
    • Pausable
    • Ownable
    • SafeMath
    • Storage of Data
  • Actors
    • Owner
    • Pauser
    • Admin
    • StoreOwner
    • Shopper
  • Getting Started
    • Contract Compilation, Migration and Tests
    • Running Frontend
    • Prerequisites
    • Related Docs

Rappa Store is implemented using circuit-breaker pattern with the help of open-zeppelin's Pausable contract.

Ownable Library of Zeppelin provides access control mechanism for specific functions.

As solidity based on unsigned integers, it's important to prevent from underflows/overflows. Therefore, all arithmetic operations are done using SafeMath Library.

It's expensive to store metadata on Blockchains. Therefore, the metadata about products and shops are stored in IPFS to achieve complete decentralization. The pointers to these metadatas are stored in the contract using bytes32. When compared to storing string, it's cheaper to store bytes32 so this conversion is very rationale.

The actors of Market Place are as follows:

Owner is set as deployer of MarketPlace contract. The contract owner can add new Admins to the system.

Pauser is set as deployer of MarketPlace contract. The pauser can stop contract state updates due to any emergency such as vulnerabilities etc.

An admin can add new store owners to Rappa Store

A store owner can create a new storefront that will be displayed on the marketplace. They can update metadata of store like name, description or image along with managing products on the stores such as adding or adjusting price. They can also withdraw any funds that the store has collected from sales.

Shopper can browse the stores and goods of these stores. If enough funds are available, they can purchase goods with ERC-20 tokens or Ethereum. In the case that user purchases a product with ERC-20, first it approves MarketPlace contract to spend some amounf of tokens, later the shopper will be able to purchase. This pattern can be executed with approveAndCall in one transactions but it's considered as secure executing these operation in two transactions(First Approve, Then Purchase).

• You can clone the directory onto your local machine and install dependencies

    npm install

NOTE THAT YOU CAN USE NPM OR YARN AS PACKAGE MANAGER

    yarn install

Export environment variables or manipulate these values in truffle-config.js

    export infuraURLKovan="INFURA_URL"
    export infuraKeyKovan="INFURA_KEY"
    export mnemonic="MNEMONIC MNEMONIC ..."
    export gasPrice="5000000000"
    export gasAmount="7000000"

You can compile and deploy the contract to Kovan, Rinkeby, Ropsten, Mainnet or local ganache network.

// Compile
    > truffle compile
// Mainnet
    > truffle migrate --network mainnet --reset
// Kovan
    > truffle migrate --network kovan --reset
// Rinkeby
    > truffle migrate --network rinkeby --reset

You can test your contract after running a local ganache network.

    > ganache-cli
    > truffle-test

Go to frontend directory

    > cd frontend

Before interacting with contract, if you go on with your own deployment, you need to first update contract addresses and ABIs in src\config\contracts.js

Install required node modules and start the project. It will start on localhost:3000 by default.

    > yarn install
    > yarn start

• Node-js (Above version 8)
• Npm (Above version 6)

• Truffle
• ERC-20 Standard