> For the complete documentation index, see [llms.txt](https://meversedex.gitbook.io/meverse-dev-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://meversedex.gitbook.io/meverse-dev-docs/meverse-dev-docs-kr/undefined-1/ide-and-tools/truffle.md).

# Truffle

트러플은 솔리디티로 작성된 스마트 컨트랙트를 컴파일하고 배포하는 데 사용됩니다. 트러플에 대한 자세한 내용은 다음 사이트를 참조하세요.

* 트러플 스토리지 - <https://github.com/trufflesuite/truffle>
* 트러플 문서 - <https://trufflesuite.com/docs/>

## 1. Truffle 설치

다음 명령을 실행하여 npm을 전역(global)으로 사용할 수 있습니다.

```shell
$ npm install truffle -g
```

## 2. 프로젝트 디렉토리 생성 <a href="#deploying-a-smart-contract-using-truffle" id="deploying-a-smart-contract-using-truffle"></a>

우선, 소스 코드가 위치할 디렉토리를 생성하세요.

```shell
$ mkdir meverse-test
$ cd meverse-test
```

## 3. 트러플 초기화

컨트랙트 배포를 위해 트러플을 초기화하세요.

```shell
$ truffle init
```

## 4. 간단한 솔리디티 스마트 컨트랙트 작성&#x20;

meverse-test/contracts 디렉토리에 MEVerseGreeter.sol을 생성합니다.&#x20;

```shell
$ cd contracts
$ touch MEVerseGreeter.sol
$ vi MEVerseGreeter.sol
```

MEVerseGreeter.sol에 다음 코드를 작성하세요.

```solidity
// SPDX-License-Identifier: MIT
pragma solidity ^0.5.6;
contract Mortal {
    /* 주소 타입의 소유자(owner) 변수 정의 */
    address payable owner;
    /* 이 함수는 초기화 시점에 실행되어 컨트랙트 소유자를 설정합니다 */
    constructor () public { owner = msg.sender; }
    /* 컨트랙트에서 자금을 회수하는 함수 */
    function kill() public payable { if (msg.sender == owner) selfdestruct(owner); }
}

contract MEVerseGreeter is Mortal {
    /* 문자열 타입의 변수 greeting 정의 */
    string greeting;
    /* 이 함수는 컨트랙트가 실행될 때 작동합니다 */
    constructor (string memory _greeting) public {
        greeting = _greeting;
    }
    /* 주(Main) 함수 */
    function greet() public view returns (string memory) {
        return greeting;
    }
}
```

## 5. 마이그레이션(Migration) 스크립트 수정

hdwallet-provider를 활용하여 컨트랙트를 배포합니다. 배포를 하기 위해 library를 설치합니다.

```shell
$ npm install @truffle/hdwallet-provider
```

* *truffle의 **Dashboard**를 활용하여 작성한 컨트랙트도 배포가 가능합니다. Dashboard의 자세한 내용은 하기 사이트를 참고하세요*.

> **Use Truffle Dashboard** : <https://trufflesuite.com/docs/truffle/how-to/use-the-truffle-dashboard/>

truffle-config.js에 MEVerse Testnet network 정보를 수정합니다.

```javascript
// truffle-config.js
const HDWalletProvider = require("@truffle/hdwallet-provider");
...
networks: {
    MEVerseTestnet: {
      provider: () =>
        new HDWalletProvider({
          privateKeys: [
            "adf...583a9", // 컨트랙트를 배포할 계정 private key
          ],
          providerOrUrl: "https://rpc.meversetestnet.io",
        }),
      network_id: 4759, // MEVerse testnet chain id
    }
}
```

## 6. 트러플을 사용하여 스마트 컨트랙트 배포 <a href="#deploying-a-smart-contract-using-truffle" id="deploying-a-smart-contract-using-truffle"></a>

```
$ truffle migrate --network MEVerseTestnet
Compiling your contracts...
===========================
> Compiling ./contracts/MEVerseGreeter.sol
> Artifacts written to /truffle_sample/build/contracts
> Compiled successfully using:
   - solc: 0.5.16+commit.9c3226ce.Emscripten.clang



Starting migrations...
======================
> Network name:    'MEVerseTestnet'
> Network id:      4759
> Block gas limit: 30000000 (0x1c9c380)


1_initial_migration.js
======================

   Deploying 'MEVerseGreeter'
   --------------------------
   > transaction hash:    0xe1f6fad3f5121cb1448750113f25e20228c4b9e800d0a7cda8ca04ff464257f2
   > Blocks: 0            Seconds: 0
   > contract address:    0xeb7A1483E3408Af19231262643672719CcFc6E17
   > block number:        27778152
   > block timestamp:     1668760128889501
   > account:             0x19368fCd2F0EE8d2C788b754F6504FD49de449E7
   > balance:             191907.1
   > gas used:            223381 (0x36895)
   > gas price:           1000 gwei
   > value sent:          0 ETH
   > total cost:          0.223381 ETH


   > Saving migration to chain.
   > Saving artifacts
   -------------------------------------
   > Total cost:            0.414624 ETH


Summary
=======
> Total deployments:   1
> Final cost:          0.414624 ETH
```

## 7. 배포 확인

배포된 컨트랙트 메서드 실행으로 스마트 컨트렉트가 제대로 배포되었는지 확인할 수 있습니다.

truffle networks 명령어로 배포된 컨트랙트의 네트워크를 확인할 수 있습니다.

```shell
$ truffle networks
Network: MEVerseTestnet (id: 4759)
  MEVerseGreeter: 0xeb7A1483E3408Af19231262643672719CcFc6E17
```

컨트랙트를 배포한 네트워크와 연결하기 위해 다음과 같은 명령어를 사용하면 됩니다.

```shell
$ truffle console --network MEVerseTestnet  
truffle(MEVerseTestnet)> 
```

접속후 인스턴스를 생성하고 인스턴스에서 메서드를 호출해서 동작이 잘 되는지를 확인합니다.

```bash
truffle(development)> let mev = await MEVerseGreeter.deployed()
undefined
truffle(MEVerseTestnet)> mev.greet()
'Hello, MEVerse'
truffle(MEVerseTestnet)> 
```

배포는 Console 화면에서 Contract Address를 확인하고 [MEVerse Testnet Scan](https://testnet.meversescan.io/)에서 트랜잭션 해시값으로 검색하여 확인합니다.

<figure><img src="/files/bijopjcjampnztJMpYW0" alt=""><figcaption><p>Testnet Scan(배포 트랜잭션 해시값으로 조회)</p></figcaption></figure>
