[브라우니 (Brownie)] 5. 컨트랙트 컴파일하기

 

프로젝트의 contracts/ 하위 폴더에 있는 모든 컨트랙트 소스를 컴파일합니다:

brownie compile

컴파일러가 실행될 때마다 브라우니는 각 컨트랙트 소스의 해시를 기존 컴파일된 버전의 해시와 비교합니다. 컨트랙트가 변경되지 않은 경우 다시 컴파일되지 않습니다. 전체 프로젝트를 강제로 다시 컴파일하려면 brownie compile --all을 사용하세요.

하나 이상의 컨트랙트를 컴파일할 수 없는 경우 Brownie는 컴파일에 실패한 이유에 대한 정보와 함께 예외를 발생시킵니다. 컴파일에 실패하는 동안에는 프로젝트에 Brownie를 사용할 수 없습니다. 이름 시작 부분에 밑줄(_)을 추가하여 파일이나 폴더를 컴파일에서 일시적으로 제외할 수 있습니다.

지원 언어

브라우니는 솔리디티(>=0.4.22) 및 바이퍼(>=0.1.0-beta.16)를 지원합니다. 파일 확장자에 따라 사용되는 컴파일러가 결정됩니다:

솔리디티:.sol Vyper: .vy

인터페이스

프로젝트 컨트랙트는 interfaces/ 서브폴더에서 인터페이스를 가져올 수 있습니다. 인터페이스는 프로젝트의 주요 구성 요소로 간주되지 않습니다. 인터페이스를 추가하거나 수정하면 컨트랙트가 해당 인터페이스에 종속된 경우에만 다시 컴파일이 트리거됩니다.

The interfaces/ 폴더는 다음 상황에서 특히 유용합니다:

1. 인터페이스가 반드시 컴파일 가능한 소스 코드가 아니므로 contracts/ 폴더에 포함할 수 없는 Vyper를 사용하는 경우.

2. 동일한 프로젝트에서 솔리디티와 Vyper를 사용하거나 여러 버전의 솔리디티를 사용하는 경우, 호환성 문제로 인해 컨트랙트가 서로를 직접 참조할 수 없는 경우.

인터페이스는 솔리디티(.sol) 또는 바이퍼(.vy)로 작성할 수 있습니다. Vyper 컨트랙트는 JSON으로 인코딩된 ABI(.json) 파일도 직접 가져올 수 있습니다.

컴파일러 설정

컴파일러 설정은 프로젝트의 구성 파일에서 선언할 수 있습니다. 설정 파일이 없거나 설정이 생략된 경우 Brownie는 다음 기본값을 사용합니다:

compiler:
    evm_version: null
    solc:
        version: null
        optimizer:
            enabled: true
            runs: 200
    vyper:
        version: null

컴파일러 설정을 수정하면 프로젝트가 완전히 다시 컴파일됩니다.

컴파일러 버전 설정

✅

브라우니는 솔리디티 버전 >=0.4.22 및 바이퍼 버전 >=0.1.0-beta.16을 지원합니다.

구성 파일에 컴파일러 버전이 설정되어 있으면 프로젝트의 모든 컨트랙트는 해당 버전을 사용하여 컴파일됩니다. 컴파일러가 없는 경우 자동으로 설치됩니다. 버전은 0.x.x 형식의 문자열로 지정해야 합니다.

컴파일러 버전이 명시적으로 선언되지 않은 경우 Brownie는 각 컨트랙트의 버전 프라그마를 살펴보고 설치된 최신 일치하는 컴파일러 버전을 사용합니다. 일치하는 버전을 찾을 수 없으면 가장 최근 릴리스가 설치됩니다.

프래그마를 통해 버전을 설정하면 단일 프로젝트에서 여러 버전을 사용할 수 있습니다. 이렇게 하면 한 컨트랙트가 상위 버전에서 컴파일해야 하는 다른 컨트랙트를 가져올 때 컴파일러 오류가 발생할 수 있습니다. 이러한 상황에서는 실제 컨트랙트가 아닌 인터페이스를 임포트하고 모든 인터페이스 프래그마를 >=0.4.22로 설정하는 것이 좋습니다.

EVM 버전

By default evm_version is set to null.기본적으로 evm_version은 null로 설정됩니다. 브라우니는 컴파일러를 기반으로 규칙 집합을 설정합니다:

• byzantium: 솔리디티 <=0.5.4

• petersburg: 솔리디티 >=0.5.5 <=0.5.12

• istanbul: 솔리디티 >=0.5.13, 바이퍼

EVM 버전을 수동으로 설정할 수도 있습니다. 유효한 옵션은 byzantium, constantinople, petersburg , istanbul입니다. 컴파일러에 전달되기 전에 해당 이더리움으로 변환되는 이더리움 클래식 규칙 집합 atlantis와 agharta를 사용할 수도 있습니다.

필요한 경우 솔리디티와 바이퍼에서 evm_version을 설정하여 솔리디티와 바이퍼의 EVM 버전을 다르게 설정할 수 있습니다.

다른 EVM 버전과 컴파일에 미치는 영향에 대한 자세한 내용은 솔리디티 EVM 설명서 또는 바이퍼 EVM 설명서를 참조하세요.

컴파일러 최적화

컴파일러 최적화는 기본적으로 활성화되어 있습니다. 커버리지 평가는 최적화된 컨트랙트를 사용하여 설계되었으므로 테스트 중에 비활성화할 필요가 없습니다.

프로젝트 구성 파일의 compiler.solc.optimizer  아래에 지정된 값은 컴파일러에 직접 전달됩니다. 이렇게 하면 특정 옵티마이저 설정을 수정할 수 있습니다. 예를 들어, 일반적인 하위 표현식 제거 및 YUL 옵티마이저를 활성화할 수 있습니다:

compiler:
    solc:
        optimizer:
            details:
                cse: true
                yul: true

옵티마이저 및 사용 가능한 설정에 대한 자세한 내용은 솔리디티 설명서를 참조하세요.

경로 리매핑

솔리디티 컴파일러는 경로 리매핑을 허용합니다. 브라우니는 구성 파일의 compiler.solc.remappings 필드를 통해 이 기능을 노출합니다:

compiler:
    solc:
        remappings:
          - zeppelin=/usr/local/lib/open-zeppelin/contracts/
          - github.com/ethereum/dapp-bin/=/usr/local/lib/dapp-bin/

remappings  아래의 각 값은 prefix=path 형식의 문자열입니다. 리매핑은 컴파일러가 특정 경로에서 주어진 접두사를 검색하도록 지시합니다. 예를 들어

github.com/ethereum/dapp-bin/=/usr/local/lib/dapp-bin/

이 리매핑은 컴파일러가 /usr/local/lib/dapp-bin에서 github.com/ethereum/dapp-bin/으로 시작하는 모든 것을 검색하도록 지시합니다.

브라우니는 자동으로 모든 리매핑된 경로가 허용되도록 합니다. allow_paths를 선언할 필요가 없습니다.

⚠️

브라우니는 프로젝트의 루트 폴더 외부에서 가져온 파일에 대한 수정 사항을 감지하지 못합니다. 외부 소스 파일이 변경되면 프로젝트를 수동으로 다시 컴파일해야 합니다.

설치된 패키지 리매핑

리매핑은 설치된 패키지에도 적용할 수 있습니다. 예를 들어

compiler:
    solc:
        remappings:
          - "@openzeppelin=OpenZeppelin/openzeppelin-contracts@3.0.0"

OpenZeppelin/openzeppelin-contracts@3.0.0 패키지가 설치되고 위의 리매핑이 구성 파일에 추가되면 다음 가져오기 문은 모두 동일한 위치를 가리킵니다:

import "OpenZeppelin/openzeppelin-contracts@3.0.0/contracts/math/SafeMath.sol";

import "@openzeppelin/contracts/math/SafeMath.sol";

컴파일러 설치

다른 버전의 solc 또는 vyper를 수동으로 설치하려는 경우:

>>> from brownie.project.compiler import install_solc
>>> install_solc("0.5.10")

>>> from brownie.project.compiler.vyper import install_vyper
>>> install_vyper("0.2.4")