npm package: @pigzbe/erc20-contract
Description: Pigzbe Wollo ERC20 contract
Author: Silvio Paganini
Latest version: 3.3.2

# Pigzbe ERC20 Burnable Contract

This contract is based on OpenZeppelin.org Burnable Token

https://github.com/OpenZeppelin/openzeppelin-solidity/blob/master/contracts/token/ERC20/BurnableToken.sol

This tool is intended to be used in any Pigzbe/Wollo project that requires access to the ERC20 Token, so all applications have the same code.

## Install on your project

```bash
yarn add @pigzbe/erc20-contract
```

## .env.json file

Run on your project folder

```bash
pigzbe-contract init

```

this will create a `.env.json` file in for you or create an `.env.json` file in manually with the following

You only need the local network parameters, the tool will output a JSON file with the deployed networks automatically.

```json
{
  "CONTRACT_VARS_PATH": "./erc20-contract.json",
  "networks" : {
    "local" : {
      "KEY_MNEMONIC": "",
      "SEED_INDEX": 0,
      "RPC_HOST": "http://127.0.0.1:7545"
    }
  }
}

```
Vars description:

* *CONTRACT_VARS_PATH* is where the Contract variables will be output
* *CONTRACT_SOL_DIR* is where the flattened sol contracts will be output
* *KEY_MNEMONIC* Is the Ethereum account memorable works (seed)
* *SEED_INDEX* Index account the tool should derive the seed in order to get the private key of the account
* *PRIVATE_KEY* is the ethereum private key account to deploy the contract from

__Use either *KEY_MNEMONIC* + *SEED_INDEX* combination or *PRIVATE_KEY* to deploy your contracts to the networks__

### To deploy the contract locally run

if you have exported the local `node_modules` folder on your bash profile

```bash
export PATH="./node_modules/.bin/:$PATH"
```

You can run the following commands without prefixing it with `./node_modules/.bin`


```bash

# looks for the default .env.json file in the project root and deploy on default local network
pigzbe-contract deploy

# looks for the default .env.json file in the project root and on all networks listed on .env.json, otherwise only compile/deploy to local network

# BE EXTRA CAREFUL WHEN USING THE FOLLOWING FLAGS, ALL PROJECTS SHOULD BE UPDATED TO GET THE NEW CONTRACTS

# Compiles and deploys new contracts
pigzbe-contract deploy

# Compiles contracts without deploying to any networks
pigzbe-contract deploy --dryrun

# if you want to pass a different path for your .env.json file
pigzbe-contract deploy --env .env.json

# you can check the help by running
pigzbe-contract --help

# or a help for the deploy function  by running
pigzbe-contract deploy --help

```

This will take the `.env.json` file, create the wallet to deploy the contract to the network, merge the contract with the latest OpenZeppelin dependencies, create the ABI and Binary of the contract, deploy on local network and create a JSON file in the path set on `CONTRACT_VARS_PATH` in the `.env.json` with the following

```json

{
  "TokenName": {
    "abi": [],
    "networks": {
      "local": {
        "network": "local",
        "rpc": "Network RPC",
        "name": "Contract Name",
        "address": "Address the contract is deployed to"
      },
      [...]
    }
  }
}

```

With those parameters, you can use `web3` to create and interact with your contract like


```js

const Web3 = require('web3')
const ercContract = require('../erc20-contract.json')

const getContract = async () => {
  const contract = ercContract.local
  // your local geth server RPC http url
  const URL_PROVIDER = contract.rpc
  const web3 = new Web3(new Web3.providers.HttpProvider(URL_PROVIDER))

  try {
    const deployedContract = new web3.eth.Contract(contract.abi, contract.address, {
      gasPrice: await web3.eth.getGasPrice(),
      gas: 6721975
    })

    console.log(deployedContract)
  } catch (e) {
    console.log(e)
  }
}

getContract()

```