Skip to content

real-token/realtoken-yam-core

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Contributors Forks Stargazers Issues MIT License LinkedIn

Lint Slither Build pass Prettier


Logo

RealToken YAM

Peer-to-peer RealToken YAM
Realt.co

Report Bug · Request Feature

Table of Contents
  1. About The Project
  2. Getting Started
  3. Usage
  4. Roadmap
  5. Contributing
  6. License
  7. Contact
  8. Built With Hardhat

Getting Started

Prerequisites

  • npm
    npm install npm@latest -g

Installation

  1. Clone the repo

    git clone https://github.com/real-token/realtoken-yam-core.git
  2. Install NPM packages

    npm install
  3. Setup a .env file, with the following config

    CoinMarketCap API Key here

    Infura API Key here

    Etherscan API Key here

    Check .env.example

  4. Check available command

    npx hardhat --help
    
  5. Deploy contract

    Use this command to deploy the Yam contract using private key (replace networkId with hardhat, goerli, mainnet, gnosis)

    npm run deploy:realtokenYam::networkId
    

    or this command to deploy the Yam contract using hardware wallet via Frame (replace networkId with hardhat, goerli, mainnet, gnosis)

    npm run deployFrame:realtokenYam::networkId
    

Hardhat Getting Started here

(back to top)

Usage

The contract allows sell, buy and exchange tokens between users.

The sellers can create, update and delete their offers. The buyers can buy the offer.

The contract also supports tokens with permit functionnality.

Whitelist token

Admin can whitelist tokens which is allows to be sold via this contract. This helps to prevent listing undesired tokens.

(back to top)

Audit

Auditing the solidity code in an important aspect of this language, we need to be confident with the code we ship to the customer to avoid malicious attacks

A lot of the auditing have been done during the contract construction using the Solidity static analysis framework Slither

You can download Slither and use the following command to audit the code

slither .

(back to top)

Roadmap

  • YAM core contracts with basic functionnalities ✅
  • Add whitelisting token functionnalities ✅
  • Testing ✅
  • Slither analysis ✅
  • Support for Hardware Wallet ✅
  • Adding more features in next versions ❌

See the open issues for a full list of proposed features (and known issues).

(back to top)

Coverage

npx hardhat coverage

(back to top)

Test

npx hardhat test

(back to top)

Contributing

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

(back to top)

License

Distributed under the MIT License. See LICENSE.txt for more information.

(back to top)

Contact

Support - @RealTPlatform - [email protected]

Project Link: https://github.com/real-token/realtoken-yam-core

(back to top)

Built With Hardhat

Acknowledgement: The YAM contract is inspired by the wallet2wallet DEX SwapCat.

(back to top)