본문으로 건너뛰기

스마트 컨트랙트 배포

1. Count dApp 클론 ​

1) Count dApp 리포지토리 클론 ​



2) Count dApp 설치 및 실행 ​

방금 복제한 패키지는 수정 없이 바로 실행할 수 있습니다.

샘플 컨트랙트는 이미 Baobab 테스트넷에 배포되어 있으며, contract ABI는 저희 패키지에 포함되어 있습니다.
Klaystagram 프론트엔드 코드는 초기에 Baobab 테스트넷의 스마트 컨트랙트에 연결하도록 구성됩니다.

앱을 바로 실행하여 작동 방식을 확인하려면 아래에 입력하세요.

첫 페이지에 언급된 테스트 환경을 따르는 것을 적극 권장합니다.


$ npm install
$ npm run local

⚠ 작동하지 않는 경우 파일 및 디렉터리 권한을 확인하세요. '오류: EACCES: 권한 거부'가 발생하면 sudo chmod -R 755 /yourProjectDirectoryName 명령이 도움이 될 수 있습니다.

애플리케이션이 바로 팝업됩니다!

2. Klaystagram 스마트 컨트랙트 작성하기 ​

  1. 배경
  2. 변수 정의
  3. 함수 정의
  4. 더 많은 작업을 해봅시다.
    4.1. 변수 추가
    4.2. 기능 업데이트

1) 배경 ​

"Count"라는 매우 간단한 컨트랙트를 만들겠습니다.

a. count라는 저장 변수가 하나만 있을 것입니다.
b. 사용자는 count 변수를 1만큼 증가시키거나 1만큼 감소시킬 수 있습니다. 따라서 count 변수를 1만큼 증가시키는 plus 함수와 count 변수를 1만큼 감소시키는 minus 함수의 두 가지 함수가 있습니다. 그게 다입니다!

2) 변수 정의 ​

변수를 설정하기 전에 Solidity 버전을 지정해야 합니다. 0.5.6 안정 버전 사용을 권장합니다.


Solidity 버전을 지정합니다.

그런 다음 컨트랙트의 이름을 "Count"로 지정합니다.


pragma solidity 0.5.6;
contract Count { // set contract names to "Count"
}

변수 count를 uint(부호 없는 정수) 유형으로 선언하고 0으로 초기화해야 합니다.


pragma solidity 0.5.6;
contract Count {
uint public count = 0; // Declare count variable as uint type and initialize its value to 0.
}

3) 함수 정의 ​

plus와 minus라는 두 개의 함수가 필요합니다. 각 함수의 역할은 다음과 같습니다:
plus - count를 1씩 증가시킵니다. (카운트 = 카운트 + 1)
minus - count를 1만큼 감소시킵니다. (카운트 = 카운트 - 1)


pragma solidity 0.5.6;
contract Count {
uint public count = 0;
function plus() public { // Make a public function called 'plus'
count = count + 1; // 'plus' function increases count variable by 1.
}
function minus() public { // Make a public function called 'plus'
count = count - 1; // 'minus' function decreases count variable by 1.
}
}

참고
컨트랙트 외부에서 함수를 호출할 수 있도록 하려면 함수를 public으로 선언해야 합니다.


function plus() public { … }

4) 뭔가 더 해봅시다 ​

기능을 하나 더 추가하려고 합니다. 마지막 참가자의 지갑 주소를 기억하는 것은 어떨까요?

4-1) 변수 추가 ​

따라서 lastParticipant라는 변수를 address 유형으로 갖게 됩니다:
address public lastParticipant;


pragma solidity 0.5.6;
contract Count {
uint public count = 0;
address public lastParticipant;
function plus() public { // Make a public function called 'plus'
count = count + 1; // 'plus' function increases count variable by 1.
}
function minus() public { // Make a public function called 'plus'
count = count - 1; // 'minus' function decreases count variable by 1.
}
}

4-2) transferOwnership ​

마지막 참가자의 주소를 추적하기 위해 아래와 같이 lastParticipant에 주소를 저장합니다:


pragma solidity 0.5.6;
contract Count {
uint public count = 0;
address public lastParticipant;
function plus() public {
count = count + 1;
lastParticipant = msg.sender; // store msg.sender to lastParticipant
}
function minus() public {
count = count - 1;
lastParticipant = msg.sender; // store msg.sender to lastParticipant
}
}

참고
1) public 변수나 함수를 public로 선언하면 블록체인 외부에서 접근할 수 있습니다. 프론트엔드 애플리케이션에서 컨트랙트 공개 메서드 및 변수와 상호작용하는 방법은 Count 컴포넌트 챕터에서 확인할 수 있습니다.

2) msg.sender
msg.sender는 현재 트랜잭션을 시작한 주소입니다.
트랜잭션 발신자의 주소를 얻으려면 msg.sender 변수를 사용할 수 있습니다.


lastParticipant = msg.sender;

이 줄은 lastParticipant가 msg.sender를 갖도록 만듭니다.

3. 컨트랙트 배포​

  1. Truffle 구성
  2. 배포 설정
  3. 배포

2) Truffle 구성 ​

truffle-config.js는 배포 구성을 포함한 구성 파일입니다. Truffle-config.js에서 아래 항목을 구성할 수 있습니다.

1) 누가 컨트랙트를 배포할 것인가(어떤 클레이튼 계정이 컨트랙트를 배포할 것인가)?
2) 어느 네트워크에 배포할 것인가?
3) 컨트랙트를 배포하기 위해 얼마나 많은 가스를 지불할 의향이 있는가?

컨트랙트를 배포하는 방법에는 두 가지가 있는데, 첫 번째는 private key를 사용하고 다른 하나는 unlocked account`을 사용합니다.

배포 방법 1: 개인 키로 ​

경고: 개인키를 노출해서는 안 됩니다. 그렇지 않으면 계정이 해킹될 수 있습니다.

개인 키를 사용하여 컨트랙트를 배포하려면 provider 옵션이 필요합니다.

1) 개인키를 new HDWalletProvider()의 첫 번째 인수로 전달합니다.
2) new HDWalletProvider()의 두 번째 인자로 클레이튼 노드의 URL을 전달합니다.

예)


{
...,
provider: new HDWalletProvider(
'YOUR PRIVATE KEY',
'https://public-en-baobab.klaytn.net', // If you're running full node you can set your node's rpc url.
),
...
}


// truffle-config.js
const HDWalletProvider = require("truffle-hdwallet-provider-klaytn");
/**
* truffle network variables
* for deploying contract to klaytn network.
*/
const NETWORK_ID = '1001'
/**
* URL: URL for the remote node you will be using
* PRIVATE_KEY: Private key of the account that pays for the transaction (Change it to your own private key)
*/
const URL = 'https://public-en-baobab.klaytn.net'
// Paste your `Private `key` that has enough KLAY to truffle.js
const PRIVATE_KEY = 'your_private_key'
module.exports = {
networks: {
klaytn: {
provider: () => new HDWalletProvider(PRIVATE_KEY, URL),
network_id: NETWORK_ID,
gas: '8500000',
gasPrice: null,
},
},
// Specify the version of compiler, we use 0.5.6
compilers: {
solc: {
version: '0.5.6',
},
},
}

위의 networks 속성을 참조하십시오. klaytn 네트워크에는 4개의 프로퍼티가 있습니다.
provider, network_id, gas, gasPrice

provider: 새로운 HDWalletProvider(PRIVATE_KEY, URL) 줄은 컨트랙트 배포자 계정과 대상 네트워크 노드 URL을 알려줍니다.

network_id : NETWORK_ID 줄은 클레이튼의 네트워크 아이디를 지정합니다. Baobab 네트워크(테스트넷)의 경우 1001을 사용합니다.

gas: GASLIMIT 지출하고자 하는 최대 가스입니다.

gasPrice: null 가스 단위당 가격입니다. 현재 클레이튼에서 가스 가격은 '25000000000'로 고정되어 있습니다. 이를 null로 설정하면 Truffle이 자동으로 가스 가격을 설정합니다.

배포 방법 2: 잠금 해제된 계정으로 배포(어려움) ​

잠금 해제된 계정으로 컨트랙트를 배포하려면 클레이튼 풀 노드가 있어야 합니다. $ klay attach http://localhost:8551를 입력하여 클레이튼 노드 콘솔에 접속합니다.
노드에 클레이튼 계정이 없는 경우, 콘솔에서 personal.newAccount()를 입력하여 계정을 생성합니다.
이미 계정이 있는 경우 personal.unlockAccount()를 통해 계정을 잠금 해제합니다.

계정이 잠금 해제되었는지 확인한 후, host, port, network_id, from 속성을 설정해야 합니다.\ 1) 배포할 네트워크(host, port, network_id)
2) 배포할 대상(from) 3) 컨트랙트를 배포하기 위해 감내할 가스 양(gas)

잠금 해제된 계정 주소를 from에 넣습니다. 자체 클레이튼 풀 노드를 실행하는 경우, 노드의 호스트를 host로, 노드의 포트를 port로 설정합니다.

예)


{
host: 'localhost',
port: 8551,
from: '0xd0122fc8df283027b6285cc889f5aa624eac1d23',
network_id: NETWORK_ID,
gas: GASLIMIT,
gasPrice: null,
}

2. 배포 설정(어떤 컨트랙트를 배포하시겠습니까?) ​

migrations/2_deploy_contacts.js:


const Klaystagram = artifacts.require('./Klaystagram.sol')
const fs = require('fs')
module.exports = function (deployer) {
deployer.deploy(Klaystagram)
.then(() => {
if (Klaystagram._json) {
// 1. Record recently deployed contract's abi file to 'deployedABI'
fs.writeFile(
'deployedABI',
JSON.stringify(Klaystagram._json.abi, 2),
(err) => {
if (err) throw err
console.log(`The abi of ${Klaystagram._json.contractName} is recorded on deployedABI file`)
})
}
// 2. Record recently deployed contract's address to 'deployedAddress'
fs.writeFile(
'deployedAddress',
Klaystagram.address,
(err) => {
if (err) throw err
console.log(`The deployed contract address * ${Klaystagram.address} * is recorded on deployedAddress file`)
})
})
}

contracts/ 디렉터리에 배포할 컨트랙트 코드를 지정할 수 있습니다. 먼저, const Count = artifacts.require('./Count.sol')를 통해 이 파일에 있는 컨트랙트 파일(Count.sol)을 가져와야 합니다. 그리고 deployer를 사용하여 deployer.deploy(Count)를 통해 컨트랙트를 배포합니다. 컨트랙트를 배포한 후 일부 로직을 실행하려면 .then()을 사용하세요. contract ABI와 배포된 주소를 파일에 저장하고 싶습니다. 이를 위해 fs node.js 모듈을 사용합니다. (fs.writeFile(filename, content, callback))
이 후처리를 통해 컨트랙트 주소와 ABI는 디렉터리에 deployedABI와 deployedAddress로 저장됩니다.. artifacts에 대한 자세한 내용은 Truffle 문서 사이트를 참고하세요.

3. 배포하기 ​

컨트랙트를 배포하려면 KLAY가 필요합니다. 테스트넷의 클레이튼 지갑을 통해 150 KLAY를 받을 수 있습니다.

  • Baobab 클레이튼 지갑에서 클레이튼 계정을 생성합니다 -> Truffle 설정에 PRIVATE key`가 사용됩니다. 따라서 어딘가에 복사해 두세요. 클레이튼 계정을 생성한 후, Baobab 클레이튼 Faucet에서 Faucet를 실행하여 Baobab 테스트넷 KLAY 5개를 받습니다. 클레이튼 계정을 생성한 후 Faucet를 실행하면 150 KLAY를 받을 수 있습니다.

배포 컨트랙트

터미널에서 $ truffle deploy --network baobab을 입력합니다.

참조) --reset 옵션
컨트랙트를 배포한 후 $ truffle deploy --network baobab을 다시 입력하면 아무 일도 일어나지 않습니다.

요약하자면,

  • truffle-config.js는 target network, deployer account 및 gas limit을 구성합니다.
  • truffle-config.js 및 migrations/2_deploy_contracts.js 구성에 따라 컨트랙트를 배포합니다.
  • target network: 노드 https://public-en-baobab.klaytn.net에 컨트랙트를 배포합니다.
  • deployer account: '0xd0122fc8df283027b6285cc889f5aa624eac1d23'이 이 컨트랙트를 배포합니다.
  • gas limit: 컨트랙트 배포를 위해 최대 '20000000' 가스까지 견딜 수 있습니다.
  • contract: Count 컨트랙트를 배포합니다.

배포가 성공하면 터미널에 배포된 컨트랙트 주소가 표시됩니다.

4. 앱 실행​

실행

브라우저에서 앱을 실행합니다.
$ npm run local을 실행하면 브라우저가 열리고 앱이 실행됩니다.

Make this page better