Code Monkey home page Code Monkey logo

sediment's Introduction

Sediment

Sediment is a smart contract library for Solidity and the EVM offering various building-blocks for projects and EVM chains to offer commonly requested functionality.

Installation

To add to your project, run:

npm add @dirtroad/sediment

Then important according to each of the modules:

Modules

Authority

Add AccessControl from OpenZeppelin to your contract with some pre-defined roles for authority.

import "@dirtroad/sediment/contracts/authority/Authority.sol";

Leaderboards

Sediment offers three (3) leaderboard options for developers to use:

Default Leaderboard

This leaderboard uses Ethereum addresses as the primary identifier.

import "@dirtroad/sediment/contracts/leaderboard/Leaderboard.sol";
String Leaderboard

This leaderboard uses strings as the primary identifier. This is a great option for using UUID's or other string based ID's from a server.

import "@dirtroad/sediment/contracts/leaderboard/StringLeaderboard.sol";
Bytes Leaderboard

This leaderboard uses bytes32 as the primary identifier.

import "@dirtroad/sediment/contracts/leaderboard/BytesLeaderboard.sol";

Logger

A simple logging smart contract that allows you to add more traditional log types to your contract to help identify specific issues or information.

Automatically hashes the value with the timestamp to ensure Unique Identifiers are created for each log.

import "@dirtroad/sediment/contracts/logger/Logger.sol";

Rate Limit

There are two rate limit contracts offered in Sediment. The first is a basic rate limit that helps ensure that transactions on a specific function are limited. This is great for chains that have low or zero gas fees.

import "@dirtroad/sediment/contracts/rateLimit/RateLimit.sol";

Bot Protection

The second rate limit contract offered by Sediment is geared more towards mitigation against bots. Great for protecting public functions that write state to chain or offer minting; this has configurable limit times coupled with a strike system in addition to an optional blacklist for addresses.

import "@dirtroad/sediment/contracts/rateLimit/BotProtection.sol";

Token Checker

While not a silver bullet; this contract will help identify most tokens by type allowing for dynamic usage of addresses within a Solidity function. This is used internally within the TokenGate contracts, but can be used externally as well.

import "@dirtroad/sediment/contracts/tokenChecker/TokenChecker.sol";

Chain Level Token Gating

The TokenGate contract was designed to be deployed once at the chain level and used by any dApp to do high-level token gating.

import "@dirtroad/sediment/contracts/tokenGate/TokenGate.sol";

Project Level Token Gating

The project level token gates are designed per standard token. With an ERC-20, ERC-721, and ERC-1155 token gate available; these can be deployed with a project to offer specific token gating with slightly more direct features.

/// For ERC-20
import "@dirtroad/sediment/contracts/tokenGate/ERC20.sol";

/// For ERC-721
import "@dirtroad/sediment/contracts/tokenGate/ERC721.sol";

/// For ERC-1155
import "@dirtroad/sediment/contracts/tokenGate/ERC1155.sol";

Security and Liability

The Sediment contracts and code is WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

License

See MIT License.

sediment's People

Contributors

thegreataxios avatar

Stargazers

 avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.