Solidity Payment Processor

A Library for Processing Stablecoin Payments & ERC20 payments in smart contract development. Built for easier payment processing inside smart contracts.

Supports 50+ ERC20 tokens & all stablecoins. Integrate to your smart contracts with ease.

Table of contents

• Getting Started
• Prerequisites
• Installation
• Project structure

Built with

• Hardhat - Smart Contract Development Suite
• Solhint - Linting Suite
• Prettier - Automatic Code Formatting
• Solidity - Smart Contract Programming Language
• Chainlink - Price Feed (Free)

Overview

Prerequisites

The repository is built using hardhat. So it is recommended to install hardhat globally through npm or yarn using the following commands. Also the development of these smart contracts are done in npm version v7.21.1 & NodeJs version v16.1.0

sudo npm i -g hardhat

Installation

$ npm i @nodeberry/solidity-payment-processor

Usage

Once installed, you can use the contracts in the library by importing them:

pragma solidity ^0.8.7;

import "@nodeberry/solidity-payment-processor/contracts/PaymentProcessor.sol";

contract TestProcessor is PaymentProcessor {
    // Initialize Your Smart Contracts
    constructor() PaymentProcessor() {}

    function mockSale(string memory _ticker, uint256 _usd) public virtual {
        // Process Payments Equivalent in USD inside your smart contracts
        // usd should be represented in 8 decimals - 1 USD = 100000000
        payment(_ticker, "", _usd);
    }
}

If you're new to smart contract development, head to Developing Smart Contracts to learn about creating a new project and compiling your contracts.

To keep your system secure, you should always use the installed code as-is, and neither copy-paste it from online sources, nor modify it yourself. The library is designed so that only the contracts and functions you use are deployed, so you don't need to worry about it needlessly increasing gas costs.

Learn More

Project structure

1. All contract codes, interfaces and utilites imported in the smart contracts can be found at /contracts
2. All chainlink related contracts are found at /contracts/chainlink
3. All contract interfaces are found at /contracts/interface.
4. An example implementation is given at /contracts/example.

All configuration is done in hardhat.config.js & linting configurations are made in .solhint.json & .prettierrc

Directory layout

├── contracts
	├── chainlink
	├── example
	├── interface
	├── mock
	├── PaymentProcessor.sol
├── test
├── .prettierrc
├── .eslintrc.js
├── .solcover.js
├── .solhint.json
├── package.json
├── hardhat.config.js
└── README.md

Testing

For running unit & integration tests:

$ npm run test

To run code-coverage:

$  npm run coverage

Contribute

Nodeberry Contracts exists thanks to its contributors. There are many ways you can participate and help build high quality software.

License

The Contracts are released under the MIT License.