SMART CONTRACTS

Useful toolbox for Interplanetary lab's smart contracts.

• Provides extensions of OpenZeppelin libraries with many useful and generic functions.
• Allows inter-compatibility with others tools of Interplanetary lab's.
• Provide audited (comming soon) and tested smart contracts.

Table of Contents

• SMART CONTRACTS
  • Table of Contents
  • Overview
    • Installation
    • Usage
  • Smart contracts
    • ERC721RoundsUpgradeable and ERC1155RoundsUpgradeable

Overview

Installation

$ npm install @interplanetary-lab/smart-contracts

Usage

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

pragma solidity ^0.8.0;

import "@interplanetary-lab/smart-contracts/contracts/ERC721Upgradeable/ERC721RoundsUpgradeable.sol";

contract MyContract is ERC721RoundsUpgradeable {

}

Smart contracts

ERC721RoundsUpgradeable and ERC1155RoundsUpgradeable

View documentation for ERC721RoundsUpgradeable View documentation for ERC1155RoundsUpgradeable

Overview

Contract allowing the management of mint rounds for OpenZeppelin ERC721Upgradeable or OpenZeppelin ERC1155Upgradeable.

• Create rounds with a start date, a duration, a supply and a price.
• Can setup a private round with a validator address where the mint is authorized through the validator's signature only.
• In a private round, the maxMint of a wallet is determined by the validator.
• For ERC1155, each round is determined for only one tokenId

Usage

1. Setup public and private mint functions

function mint(uint256 roundId, uint256 amount) external payable virtual {
    // My custom requirements
    // require(
    //    totalMintedBy(msg.sender, roundId) + amount <= maxMintsPerWallet,
    //    "Max allowed"
    // );
    _publicRoundMint(msg.sender, roundId, amount);
}

function privateMint(
    uint256 roundId,
    uint256 amount,
    uint256 maxMint,
    uint256 payloadExpiration,
    bytes memory sig
) external payable virtual {
    // My custom requirements
    // ...

    _privateRoundMint(
        msg.sender,
        roundId,
        amount,
        maxMint,
        payloadExpiration,
        sig
    );
}

2. Setup before and after mint custom requirements

function _beforeMint(address to, uint256 amount) internal virtual override {
    // My custom requirements
    // require(_totalMinted + amount <= MAX_SUPPLY, "Supply exceeded");
    super._beforeMint(to, amount);
}

3. (optional) Personalize the assignment of identifiers (by default start at 1).

function _getNextTokenId(address to, uint256 totalMinted)
    internal
    virtual
    returns (uint256)
{
    // My custom ID attribution function
    return totalMinted + 1;
}

4. Gives admin access to setup rounds (here with OpenZeppelin Ownable)

function setupRound(
    uint256 roundId,
    uint32 supply,
    uint64 startTime,
    uint64 duration,
    address validator,
    uint256 price
) external virtual onlyOwner {
    _setupRound(roundId, supply, startTime, duration, validator, price);
}

Signature provider for private mint

In a private mint, the signature of the validator address must be generated like this:

let message = web3.utils.soliditySha3(
  web3.utils.encodePacked(
    user_address, // The address who want to mint
    payloadExpiration, // The maximum timestamp before the signature is considered invalid
    roundId, // The mint round index
    // tokenID // The tokenId for ERC1155
    maxMint, // The maximum token that the user is allowed to mint in the round
    smartContractAddress, // The address of the smart contract (to maximize security)
    smartContractChainId // The chainId of the smart contract (to maximize security)
  )
);
return web3.eth.accounts.sign(message, validator_private_key).signature;

Example

For a complete example, see DummyERC721RoundsUpgradeable or DummyERC1155RoundsUpgradeablesmart contract.