This repository contains contracts that are helpful to building blockchain applications on Klaytn.

Some files were derived from openzeppelin contracts v2.3.0.

WARNING: Please take special care when you use this code in production. We take no responsibility for any security problems you might experience. If you find any security problems in the source code, please report it to [email protected].

The following packages should be installed before using this source code.

• git
• docker
• Node v10.21.0
• Truffle v5.1.61
• ganache-cli v6.12.1

Please install node packages first.

$ npm install
$ npm install -g [email protected]
$ npm install -g [email protected]

Ganache is a local blockchain environment for easy testing. Klaytn is a fork of Ethereum and compatible with Constantinople EVM, so you can use Ganache for testing. To run a Ganache, execute the following command:

$ npm run run:ganache

This ganache network is defined as "development" network in truffle-config.js

You can easily deploy a local Klaytn network via the following command:

$ npm run run:klaytn

To see the execution logs, run npm run run:klaytn:log. To stop the network, run npm run run:klaytn:stop. To resume the network, run npm run run:klaytn:resume. To completely terminate the network, run npm run run:klaytn:terminate. To remove log files, run npm run run:klaytn:cleanlog.

Just execute the command as follows:

$ npm run test:ganache

# To run a specific test, execute the below.
$ npm run test:ganache -- ./test/token/KIP7/KIP7.test.js

# To run a test on a local klaytn network, execute the below.
$ npm run test:klaytn
$ npm run test:klaytn -- ./test/token/KIP7/KIP7.test.js

1. To deploy a contract, please modify 2_contract_migration.js. The file deploys a KIP7 contract currently.
2. Execute the following command to deploy the local network.

$ npm run deploy:klaytn

Update privateKey and EN URL in baobab of truffle-config.js.

    baobab: {
      provider: () => {
        return new HDWalletProvider(privateKey, "https://your.baobab.en:8651");
      },
      network_id: '1001', //Klaytn baobab testnet's network id
      gas: '8500000',
      gasPrice: null
    },

Also, you can use KAS instead of your own EN. Please refer to kasBaobab as shown below. In this case, you need to update privateKey, accessKeyId, and secretAccessKey.

NOTE: As of Feb 2021, "Using KAS" is not supported yet.

const accessKeyId = "ACCESS_KEY";
const secretAccessKey = "SECRET_KEY";

...

    kasBaobab: {
      provider: () => {
        option.headers['x-chain-id'] = '1001';
        return new HDWalletProvider(privateKey, new Caver.providers.HttpProvider("https://node-api.klaytnapi.com/v1/klaytn", option))
      },
      network_id: '1001', //Klaytn baobab testnet's network id
      gas: '8500000',
      gasPrice:'25000000000'
    },

Update privateKey and EN URL in baobab of truffle-config.js.

    cypress: {
      provider: () => new HDWalletProvider(privateKey, "https://your.cypress.en:8651"),
      network_id: '8217', //Klaytn mainnet's network id
      gas: '8500000',
      gasPrice: null
    }

Also, you can use KAS instead of your own EN. Please refer to kasBaobab as shown below. In this case, you need to update privateKey, accessKeyId, and secretAccessKey.

NOTE: As of Feb 2021, "Using KAS" is not supported yet.

const accessKeyId = "ACCESS_KEY";
const secretAccessKey = "SECRET_KEY";

...

    kasCypress: {
      provider: () => {
        option.headers['x-chain-id'] = '8217';
        return new HDWalletProvider(privateKey, new Caver.providers.HttpProvider("https://node-api.klaytnapi.com/v1/klaytn", option))
      },
      network_id: '8217', //Klaytn baobab testnet's network id
      gas: '8500000',
      gasPrice:'25000000000'
    },