@gxchain2/contracts

[![NPM Version](https://img.shields.io/npm/v/@gxchain2/contracts)](https://www.npmjs.org/package/@gxchain2/contracts) ![License](https://img.shields.io/npm/l/@gxchain2/contracts)

Usage no npm install needed!

<script type="module">
  import gxchain2Contracts from 'https://cdn.skypack.dev/@gxchain2/contracts';
</script>

README

@gxchain2/contracts

NPM Version License

GXChain2.0 genesis contracts

  • Config Global config contract, deployed at 0x0000000000000000000000000000000000001000
  • StakeManager Stake manager contract, deployed at 0x0000000000000000000000000000000000001001
  • UnstakePool A smart contract that keeps unstake amount, deployed at 0x0000000000000000000000000000000000001003
  • ValidatorRewardPool A smart contract that keeps validator reward for validator, deployed at 0x0000000000000000000000000000000000001004
  • CommmissionShare A smart contract that keeps commission reward for all staking user, dynamically deployed for each validator
  • Fee A smart contract that accepts GXC deposit and calculates user fees, deployed at 0x0000000000000000000000000000000000001005
  • FreeFee A smart contract that calculates user daily free fees, deployed at 0x0000000000000000000000000000000000001006
  • FeePool A smart contract that assigns GXC rewards to miners according to miner shares every 24 hours, deployed at 0x0000000000000000000000000000000000001007
  • Router A router smart contract, blockchain will only interact with router contract, deployed at 0x0000000000000000000000000000000000001008
  • FeeToken An ERC20 smart contract, only provides balanceOf method for users to query the fee balance, deployed at 0x0000000000000000000000000000000000001009
  • FreeFeeToken An ERC20 smart contract, only provides balanceOf method for users to query the free fee balance, deployed at 0x000000000000000000000000000000000000100a
  • ContractFee A smart contract for registering contract creators and setting contract fee, deployed at 0x000000000000000000000000000000000000100b

Install

npm install @gxchain2/contracts

Usage

// SPDX-License-Identifier: GPL-3.0-or-later

pragma solidity ^0.6.0;

import "@openzeppelin/contracts/token/ERC20/ERC20Burnable.sol";
import "@openzeppelin/contracts/math/SafeMath.sol";
import "@openzeppelin/contracts/access/Ownable.sol";
import "@gxchain2/contracts/src/interfaces/IStakeManager.sol";
import "@gxchain2/contracts/src/interfaces/ICommissionShare.sol";

// candy token for stake user
// after deployment, the `transferOwnership` method should be called
// to transfer ownership to the `LockedStake` contract
contract Candy is ERC20Burnable, Ownable {
  constructor() public ERC20("Candy", "CD") {}

  function mint(address to, uint256 amount) external onlyOwner {
    _mint(to, amount);
  }
}

/**
 * A locked staking smart contract,
 * user stake for validator can get candy reward,
 * but only can start unstake after `lockTime`
 */
contract LockedStake {
  using SafeMath for uint256;

  // lock the shares until 4 weeks later
  uint256 public lockTime = 4 weeks;
  address public validator;
  Candy public candy;
  IStakeManager public sm;
  mapping(uint256 => uint256) public stakeTimestampOf;
  mapping(uint256 => uint256) public stakeSharesOf;
  mapping(uint256 => address) public stakeOwnerOf;

  // auto-increment id for each stack
  uint256 private autoIncrement = 0;

  event Stake(
    address indexed staker,
    uint256 indexed id,
    uint256 amount,
    uint256 shares
  );

  event Unstake(uint256 indexed unstakeId);

  constructor(address _validator, Candy _candy) public {
    validator = _validator;
    candy = _candy;
    sm = IStakeManager(0x0000000000000000000000000000000000001001);
  }

  function stake() external payable returns (uint256 id) {
    id = autoIncrement;
    autoIncrement = id.add(1);
    uint256 shares = sm.stake{ value: msg.value }(validator, address(this));
    stakeTimestampOf[id] = block.timestamp;
    stakeSharesOf[id] = shares;
    stakeOwnerOf[id] = msg.sender;
    candy.mint(msg.sender, shares);
    emit Stake(msg.sender, id, msg.value, shares);
  }

  function unstake(uint256 id, address payable to)
    external
    returns (uint256 unstakeId)
  {
    uint256 timestamp = stakeTimestampOf[id];
    require(
      timestamp != 0 && timestamp.add(lockTime) >= block.timestamp,
      "LockedStake: invalid id or timestamp"
    );
    require(stakeOwnerOf[id] == msg.sender, "LockedStake: invalid stake owner");
    uint256 _shares = stakeSharesOf[id];
    // we should approve the shares to stake manager before starting unstake
    ICommissionShare(sm.validators(validator).commissionShare).approve(
      address(sm),
      _shares
    );
    // stake manager will burn the shares and return the GXC after `config.unstakeDelay`
    unstakeId = sm.startUnstake(validator, to, _shares);
    delete stakeTimestampOf[id];
    delete stakeSharesOf[id];
    delete stakeOwnerOf[id];
    emit Unstake(unstakeId);
  }
}

Hardhat tasks

AVAILABLE TASKS:

  abr                   Assign block reward
  accounts              List accounts
  afb                   Call onAfterBlock callback
  approve               Approve commission share
  balance               Get balance
  deploy                Deploy contracts
  deposit               Deposit GXC for fee
  fee                   Query user fee and free fee info
  gb                    Get gxc balance
  lscfgaddr             List config addresses
  scr                   Set commission rate
  stake                 Stake for validator
  sunstake              Start unstake
  transfer              Transfer value to target address
  unstake               Do unstake
  verify                Verifies contract on Etherscan
  vp                    Visit validator voting power by address
  vu                    Visit unstake info by id
  vva                   Visit validator information by address
  vvi                   Visit validator information by index
  withdraw              Withdraw GXC from fee contract

Any detailed options of the task can be obtained like this:

npx hardhat stake --help

Hardhat tasks usage

Stake

npx hardhat --networkd gxc2-testnet stake --address 0x0000000000000000000000000000000000001001 --validator 0x...123 --value 100 --ether

stake 100 GXC for 0x...123 on gxc2-testnet

Start unstake

npx hardhat --networkd gxc2-testnet sunstake --address 0x0000000000000000000000000000000000001001 --validator 0x...123 --shares 100 --ether

start unstake 100 CommissionShares for 0x...123 on gxc2-testnet

Unstake

npx hardhat --networkd gxc2-testnet unstake --address 0x0000000000000000000000000000000000001001 --id 0

unstake for id 0

License

GNU General Public License v3.0