Hướng dẫn triển khai

Có nhiều cách khác nhau để triển khai hợp đồng thông minh trên Klaytn. Tài liệu này cung cấp hướng dẫn từng bước để triển khai một hợp đồng mẫu bằng các công cụ khác nhau. Chúng tôi giả định rằng bạn đã có tài khoản Klaytn với đủ KLAY để thanh toán phí giao dịch. Để tạo một tài khoản, vui lòng truy cập Ví Klaytn.

Remix Online IDE

Mở trình duyệt internet của bạn và truy cập Klaytn Plugin for Remix.

• Thêm tập tin mới.

• Sao chép và dán mã mẫu sau đây (hoặc bất kỳ mã nào bạn muốn triển khai) vào tập tin mới. Mã bao gồm hai hợp đồng được gọi là Mortal và KlaytnGreeter và mã này cho phép bạn chạy thông báo "Hello World!" đơn giản.

pragma solidity 0.5.12;

contract Mortal {
    /* Define variable owner of the type address */
    address payable owner;
    /* This function is executed at initialization and sets the owner of the contract */
    constructor () public { owner = msg.sender; }
    /* Function to recover the funds on the contract */
    function kill() public payable { if (msg.sender == owner) selfdestruct(owner); }
}

contract KlaytnGreeter is Mortal {
    /* Define variable greeting of the type string */
    string greeting;
    /* This runs when the contract is executed */
    constructor (string memory _greeting) public {
        greeting = _greeting;
    }
    /* Main function */
    function greet() public view returns (string memory) {
        return greeting;
    }
}

• Chọn Trình biên dịch trong bảng biểu tượng. Chọn môi trường EVM mong muốn. Đối với các mạng lưới Klaytn, bạn có thể chọn giữa Baobab (mạng thử nghiệm) và Cypress (mạng chính thức). Nhấp vào Compile khi mã nguồn mẫu đã sẵn sàng để được biên dịch trước khi triển khai thực tế.

• Bây giờ, chúng ta có thể triển khai hợp đồng. Nhấp vào logo Klaytn trong bảng biểu tượng. Nhập tài khoản bằng cách nhấp vào nút hình dấu cộng bên cạnh Account. Hãy đảm bảo rằng tài khoản có đủ KLAY để thanh toán cho giao dịch triển khai các hợp đồng thông minh cần thiết.

• Thiết lập Giới hạn gas và Giá trị cần gửi.

  • Nếu bạn triển khai một hợp đồng phức tạp hơn, bạn có thể cần thiết lập Giới hạn gas cao hơn. Bạn có thể để nguyên giá trị hiện tại trong ví dụ này.

  • Đặt Value là 0 trừ khi bạn muốn gửi KLAY đến hợp đồng vào thời điểm triển khai.

• Nhập "Hello World!" làm đối số cho hàm khởi tạo và nhấp vào nút Deploy.

• Nếu hợp đồng được triển khai thành công, bạn sẽ nhìn thấy biên lai giao dịch tương ứng và kết quả chi tiết trên bảng điều khiển.

• Bạn có thể tương tác với hợp đồng bằng cách nhấp vào các nút hàm. Các hàm được đại diện bằng các nút có màu sắc khác nhau. Các hàm constant hoặc pure trong Solidity có các nút màu xanh (ví dụ như greet) và không tạo giao dịch mới, do đó chúng không tốn bất kỳ gas nào. Các nút màu đỏ (ví dụ như kill) thể hiện các hàm payable thay đổi trạng thái trên blockchain, tiêu thụ gas và có thể nhận giá trị. Các nút màu cam đại diện cho các hàm non-payable thay đổi trạng thái của hợp đồng nhưng KHÔNG nhận giá trị.

Để biết thêm chi tiết, vui lòng tham khảo liên kết này.

Truffle

Truffle là bộ khung phổ biến nhất cho việc triển khai và thực thi các hợp đồng thông minh.

• Cài đặt bằng lệnh dưới đây.

$ sudo npm install -g truffle

• Thiết lập thư mục dự án và cài đặt .truffle-hdwallet-provider-klaytn

$ mkdir hello-klaytn
$ cd hello-klaytn
$ truffle init
$ npm install truffle-hdwallet-provider-klaytn

• Tạo KlaytnGreeter.sol dưới thư mục /contracts và sao chép đoạn mã sau.

pragma solidity 0.5.6;

contract Mortal {
    /* Define variable owner of the type address */
    address payable owner;
    /* This function is executed at initialization and sets the owner of the contract */
    constructor () public { owner = msg.sender; }
    /* Function to recover the funds on the contract */
    function kill() public payable { if (msg.sender == owner) selfdestruct(owner); }
}

contract KlaytnGreeter is Mortal {
    /* Define variable greeting of the type string */
    string greeting;
    /* This runs when the contract is executed */
    constructor (string memory _greeting) public {
        greeting = _greeting;
    }
    /* Main function */
    function greet() public view returns (string memory) {
        return greeting;
    }
}

• Sửa đổi /migrations/1_initial_migration.js như sau.

const Migrations = artifacts.require("./Migrations.sol");
const KlaytnGreeter = artifacts.require("./KlaytnGreeter.sol");
module.exports = function(deployer) {
  deployer.deploy(Migrations);
  deployer.deploy(KlaytnGreeter, 'Hello, Klaytn');
};

• Thiết lập truffle-config.js như bên dưới. Hãy đảm bảo rằng bạn nhập khóa riêng tư của tài khoản có đủ KLAY để triển khai hợp đồng.

const HDWalletProvider = require("truffle-hdwallet-provider-klaytn");

const privateKey = "0x3de..." // Nhập khóa riêng tư của bạn;

module.exports = {
  networks: {
    development: {
      host: "localhost",
      port: 8545,
      network_id: "*" // Match any network id
    },
    testnet: {
      provider: () => new HDWalletProvider(privateKey, "https://your.baobab.en.url:8651"),
      network_id: '1001', //Klaytn baobab testnet's network id
      gas: '8500000',
      gasPrice: null
    },
    mainnet: {
      provider: () => new HDWalletProvider(privateKey, "https://your.cypress.en.url:8651"),
      network_id: '8217', //Klaytn mainnet's network id
      gas: '8500000',
      gasPrice: null
    }
  },
  compilers: {
    solc: {
      version: "0.5.6"
    }
  }
};

LƯU Ý: Không khuyến nghị sử dụng ví dụ này cho mục đích sản xuất. Hãy đặc biệt cẩn trọng khi sử dụng các khóa riêng tư.

• Triển khai trên mạng thử nghiệm Klaytn.

$ truffle deploy --network testnet

• Triển khai trên mạng chính thức Klaytn.

$ truffle deploy --network mainnet

Để biết thêm chi tiết, vui lòng tham khảo liên kết này.

VVISP

vvisp là một công cụ/bộ khung CLI dễ sử dụng để phát triển các hợp đồng thông minh, do HEACHI LABS cung cấp. Bạn có thể dễ dàng thiết lập môi trường, triển khai và thực thi các hợp đồng thông minh Klaytn với một lệnh duy nhất. Tham khảo liên kết sau để biết thêm chi tiết.

• https://henesis.gitbook.io/vvisp/deploying-smart-contracts

solc & caver-js

Một cách khác để triển khai hợp đồng là biên dịch hợp đồng thủ công bằng trình biên dịch solc và triển khai chúng bằng thư viện caver-js.

• Tạo KlaytnGreeter.sol và viết đoạn mã sau.

pragma solidity 0.5.6;

contract Mortal {
    /* Define variable owner of the type address */
    address payable owner;
    /* This function is executed at initialization and sets the owner of the contract */
    constructor () public { owner = msg.sender; }
    /* Function to recover the funds on the contract */
    function kill() public payable { if (msg.sender == owner) selfdestruct(owner); }
}

contract KlaytnGreeter is Mortal {
    /* Define variable greeting of the type string */
    string greeting;
    /* This runs when the contract is executed */
    constructor (string memory _greeting) public {
        greeting = _greeting;
    }
    /* Main function */
    function greet() public view returns (string memory) {
        return greeting;
    }
}

• Cài đặt solc 0.5.6.

$ sudo npm install -g [email protected]

• Biên dịch hợp đồng.

$ solcjs KlaytnGreeter.sol --bin

• Cài đặt caver-js.

$ npm install caver-js.

• Tạo deploy.js trong cùng thư mục bằng đoạn mã sau.

const Caver = require("caver-js");
const caver = new Caver("https://public-en-baobab.klaytn.net")

const walletInstance = caver.klay.tài khoảns.privateKeyToAccount(
  '0x3de0c9...' // enter your private key to deploy contract with
);
caver.klay.tài khoảns.wallet.add(walletInstance);

const fs = require('fs')
const bytecode = fs.readFileSync('./KlaytnGreeter_sol_KlaytnGreeter.bin') // compiled output

const constructorType = ['string']  // enter appropriate constructor type
const constructorValue = ['Hello, Klaytn!']

const params = caver.klay.abi.encodeParameters(constructorType, constructorValue);

caver.klay.sendTransaction({
  from: caver.klay.tài khoảns.wallet[0].address,
  gas: "50000000",
  data: bytecode.toString() + params.substring(2, params.length)
})
.once("receipt", receipt => {
  console.log(receipt)
})
.once("error", error => {
  console.log(error);
})

LƯU Ý: Không khuyến nghị sử dụng ví dụ này cho mục đích sản xuất. Hãy đặc biệt cẩn trọng khi sử dụng các khóa riêng tư.

• Triển khai hợp đồng sử dụng môi trường nút mạng.

$ node deploy.js