[dApp] 진짜 쉬운 이더리움 은행 만들기 2편 with Truffle

할 것

1. Contract 생성 및 작성

2. Migration 및 Deploy

3. 실행하기

이 프로젝트는 github에 등록되어 있습니다.

---

컨트랙트 생성

> truffle create contract Bank

잘 생성되었나 확인합시다:

> tree
.
├── contracts
│   ├── Bank.sol
│   └── Migrations.sol
├── migrations
│   └── 1_initial_migration.js
├── test
├── truffle-config.js
└── truffle.js

3 directories, 5 files

/contracts 에 Bank.sol 이 보입니다.

생성자 및 멤버 변수

pragma solidity ^0.4.20;

contract Bank {
  function Bank() {
    // 생성자
  }
}

Bank.sol 컨트랙트와 함께 생성자(Constructor)가 자동으로 생성되었습니다.

첫번째 라인은 0.4.2 ~ 0.5.0 버전 사이의 Solidity Compiler 를 사용함을 의미합니다. truffle version 을 입력하여 확인해볼까요?

> truffle version
Truffle v4.1.8 (core: 4.1.8)
Solidity v0.4.23 (solc-js)

멤버 변수를 선언합니다:

contract Bank {
  // 계좌의 소유주
  address public owner;
  ...

• address: 20byte 사이즈의 이더리움 주소를 담는 특별한 타입입니다.

멤버 변수를 선언하고 Visibility 를 정의합니다. Solidity 는 객체 지향 프로그래밍 언어에서 흔히 사용하는 접근지정자(Access Modifier)를 Visibility 로 부릅니다. public 으로 설정하면 다른 Contract 와 클라이언트가 이 변수를 들여다 볼 수 있습니다. 자세한 내용은 여기에서 확인해주세요.

이제 생성자(Constructor)를 수정합시다:

function Bank(address _owner) public {
        owner = _owner;
}

이 생성자는 address 타입의 _owner 매개 변수를 받아 계좌 소유주를 의미하는 owner 멤버 변수에 대입합니다.

입금 함수

function deposit() public payable {
        require(msg.value > 0);
}

• payable 은 매우 중요합니다. 이 키워드가 없다면 이더리움 트랜젝션(Transaction)이 불가능합니다. deposit() 함수는 직접적으로 이더리움을 전송하므로 만약 payable 키워드 없이 함수를 정의하면 트랜잭션(Transaction)은 거절(reject)됩니다.

• deposit() 함수는 payable function 이기 때문에 내부에 송금 로직을 작성하지 않고도 이더리움을 전송 할 수 있습니다.

• require 은 괄호 안의 값을 평가합니다. 만약 참 이라면 계속해서 함수를 실행 시키지만 거짓 일땐 함수 실행을 중지시키며 Transaction 을 취소(Revert)합니다. msg.value > 0 은 입금(deposit) 금액이 0 ETH 이상인지 검사합니다.

• msg.value 는 전송하는 이더리움의 양입니다. Bank.sol 어디에서 정의되어 있지 않지만 사용 가능한 이유는 우리가 payable 함수를 실행(call)시킬때 인자로 msg 객체를 전달합니다.

출금 함수

function withdraw() public {
        require(msg.sender == owner);
        owner.transfer(address(this).balance);
}

• require 를 이용해 withdraw() 함수를 실행(call)하는 클라이언트(msg.sender)가 계좌 소유주(owner)와 동일한지 확인합니다. msg.sender 는 함수를 실행하는 주체(address)입니다. 값은 함수 실행시 자동 할당됩니다.

• transfer(amount) 함수는 amount 만큼 이더리움을 송금합니다. 이는 payable function call 과 달리 transaction 이 아닙니다. 이에 대한 자세한 내용은 여기를 참고하세요.

• address(this).balance 는 컨트랙트의 이더 잔액(balance)입니다. address(this) 는 Contract 인스턴스의 주소를 의미합니다. 즉 this 는 Contract 자기 자신입니다.

정리하자면 withdraw() 는 함수를 실행시키는 클라이언트가 계좌의 소유주임을 확인하고 현재 Contract 의 잔액(balance) 만큼 owner 에세 송금합니다.

마지막으로 Bank.sol 의 전체 코드를 확인하세요.

pragma solidity ^0.4.4;

contract Bank {
    address public owner;

    function Bank(address _owner) public {
        owner = _owner;
    }

    function deposit() public payable {
        require(msg.value > 0);
    }

    function withdraw() public {
        require(msg.sender == owner);
        owner.transfer(address(this).balance);
    }
}

축하합니다! 이제 Contract 모두 작성했습니다. 앞으로

• compile

• migrate

작업이 남았습니다!

---

Compile & Migrate

컴파일을 합니다:

> truffle compile
Compiling ./contracts/Bank.sol...
Compilation warnings encountered:
Writing artifacts to ./build/contracts

/build 폴더에 여러분이 작성한 Bank.sol 코드가 Bank.json 으로 아름답게 변환되어 있을겁니다.

Truffle 은 여러분이 작성한 Contract 를 어떻게 Deploy 할 지 아직 모릅니다. 이를 알려주기 위해서 우리는 Migration Script 를 작성합니다.

> truffle create migration bank

/migrations 폴더에 1525834979_bank.js 처럼 타임스탬프(timestamp) 형식으로 파일이 자동 생성되었습니다.

아래 코드로 채워주세요:

var Bank = artifacts.require("Bank");

module.exports = function(deployer) {
  let ownerAddress = web3.eth.accounts[0];
  deployer.deploy(Bank, ownerAddress);
};

우리가 Compile 한 Bank.json 를 불러오기 위해 artifacts.require 라는 조금 특수한 구문을 사용합니다. 이는 Truffle 이 Contract 를 성공적으로 Deploy 하도록 고안 방법입니다.

• ownerAddress 에 0 번 계정을 대입했습니다.

• web3.eth.accounts 는 클라이언트의 정보를 담고 있는 배열(Array)입니다. 즉 web3.eth.accounts[0] 은 Ganache 상의 첫번째 계정과 동일하며 ownerAddress 는 이를 담고 있습니다.

• deplyer.deploy 는 Contract 를 Deploy 합니다. 첫 번째 매개 변수는 Contract 를 전달하고 두 번째 매개 변수는 생성자(Constructor)에 전달할 매개 변수입니다. 우리가 앞서 작성한 생성자 함수에는 address 타입의 매개 변수를 요구하므로 ownerAddress 를 전달합니다. 이는 우리가 작성한 은행의 소유주는 Ganache 의 첫 번째 계정, 다시 말해 web3.eth.accounts[0] 이라는걸 뜻합니다.

Migration 하기 전에 마지막으로 설치한 Ganache 를 실행시켜주세요. Ganache 인스턴스가 가동중이 아니라면 Migration 이 불가능합니다.

Ganache 실행 화면:

이제 터미널에 truffle migrate 를 입력해주세요:

> truffle migrate
Using network 'development'.

Running migration: 1_initial_migration.js
  Replacing Migrations...
  ... 0x189d93748c4f08398e841a303017514df868b7fcb54eba73bb4a631aad8c2bb9
  Migrations: 0x695ebfa99c04c3bcf934c65dd84cafa8d7e955f9
Saving successful migration to network...
  ... 0x0b1a2c70362deeb97322306c1680e865bd7759b54aba69ae57d8f51985d9e493
Saving artifacts...
Running migration: 1525834979_bank.js
  Replacing Bank...
  ... 0x9f702f9405c93be4c08b8dded6e3ce9f682228d9d54456fc331766270671132d
  Bank: 0xc18d5daf5afab9bc329d81700b269d4aac25a528
Saving successful migration to network...
  ... 0x84af0d76df1ecc280f6624f8a91691ebde7c646d3fa45d903a00569a1afb1454
Saving artifacts...

만약 에러가 발생하면 truffle migrate --reset 를 입력해주세요. 이전에 작업하시던 dApp 프로젝트와 충돌이 날 때가 있습니다.

---

실습

우리는 프론트엔드 없이 콘솔 환경 실습합니다.

> truffle console
truffle(development)>

이제 Deploy 한 Contract 의 인스턴스를 변수에 저장합니다:

truffle(development)> Bank.deployed().then(instance => bank = instance)

Bank.deployed() 는 Contract 의 인스턴스 평가하는 프로미스(Promise)를 반환합니다. then 을 이용하여 우리는 이를 bank 에 bind 합니다.

owner 멤버 변수를 확인해봅시다:

truffle(development)> bank.owner()
'0xdaf72fcee99c3ed561b5f91a83b69c6f3d6b02e8'

Ganache 의 첫 번째 계정과 address 가 동일합니다!

이제 은행에 10 ETH 만큼 입금을 해봅시다:

truffle(development)> bank.deposit({value: web3.toWei(10, 'ether')})

deposit 은 payable 함수입니다. 때문에 저희는 value 를 매개 변수로 담을 수 있습니다. value 는 ETH 의 최소 단위인 Wei 를 가집니다. 따라서 web3.toWei 를 통해 10 ETH 를 Wei 로 변환해야합니다.

이제 Ganache 의 첫 번째 계정의 잔액(balance)을 확인합니다:

89.94 ETH 가 남았습니다. 왜 90.00 ETH 가 아닐까요? 이는 Contract 의 함수를 실행시키는 수수료(Gas) 때문입니다. Gas 에 대한 자세한 내용은 여기를 참고하세요.

이제 출금할 차례입니다:

truffle(development)> bank.withdraw()

첫 번째 계정에 10 ETH 가 다시 들어왔습니다!

마치며

축하합니다! 드디어 이더리움 은행 dApp 을 완성했습니다. 여기까지 따라오신 분들 모두 수고하셨습니다. 감사합니다.