컨트랙트 크기 제한에 맞서 컨트랙트 축소하기

Solidity

스마트 컨트랙트

저장소

중급

마르쿠스 바스

soliditydeveloper.com

2020년 6월 26일

12 분 소요

페이지 편집

왜 제한이 있을까요?

2016년 11월 22일 (opens in a new tab) Spurious Dragon 하드 포크에서 24.576kb의 스마트 컨트랙트 크기 제한을 추가하는 EIP-170 (opens in a new tab)이 도입되었습니다. Solidity 개발자에게 이는 컨트랙트에 기능을 계속 추가하다 보면 어느 순간 제한에 도달하게 되고, 배포 시 다음과 같은 오류가 발생한다는 것을 의미합니다.

Warning: Contract code size exceeds 24576 bytes (a limit introduced in Spurious Dragon). This contract may not be deployable on Mainnet. Consider enabling the optimizer (with a low "runs" value!), turning off revert strings, or using libraries.

이 제한은 서비스 거부(DOS) 공격을 방지하기 위해 도입되었습니다. 컨트랙트 호출은 가스 측면에서 상대적으로 저렴합니다. 하지만 이더리움 노드에 대한 컨트랙트 호출의 영향은 호출된 컨트랙트 코드의 크기(디스크에서 코드 읽기, 코드 전처리, 머클 증명에 데이터 추가)에 따라 불균형적으로 증가합니다. 공격자가 적은 리소스로 다른 사람들에게 많은 작업을 유발할 수 있는 상황이 발생할 때마다 DOS 공격의 가능성이 생깁니다.

원래 자연스러운 컨트랙트 크기 제한 중 하나가 블록 가스 한도였기 때문에 이는 큰 문제가 되지 않았습니다. 당연히 컨트랙트는 컨트랙트의 모든 바이트코드를 포함하는 트랜잭션 내에 배포되어야 합니다. 블록에 해당 트랜잭션 하나만 포함하면 그 가스를 모두 사용할 수 있지만, 무한하지는 않습니다. 런던 업그레이드 이후, 블록 가스 한도는 네트워크 수요에 따라 1,500만에서 3,000만 단위 사이에서 변동될 수 있게 되었습니다.

다음에서는 잠재적인 영향력 순으로 몇 가지 방법을 살펴보겠습니다. 체중 감량의 관점에서 생각해 보세요. 목표 체중(이 경우 24kb)에 도달하기 위한 가장 좋은 전략은 영향력이 큰 방법에 먼저 집중하는 것입니다. 대부분의 경우 식단만 조절해도 목표에 도달할 수 있지만, 때로는 조금 더 많은 노력이 필요합니다. 그럴 때 운동(중간 영향)이나 보충제(작은 영향)를 추가할 수 있습니다.

큰 영향

컨트랙트 분리하기

이것이 항상 첫 번째 접근 방식이 되어야 합니다. 컨트랙트를 어떻게 여러 개의 작은 컨트랙트로 분리할 수 있을까요? 이는 일반적으로 컨트랙트를 위한 좋은 아키텍처를 고안하도록 만듭니다. 코드 가독성 측면에서도 항상 작은 컨트랙트가 선호됩니다. 컨트랙트를 분할할 때 스스로에게 다음과 같이 질문해 보세요.

어떤 함수들이 함께 속해야 할까요? 각 함수 세트는 자체 컨트랙트에 있는 것이 가장 좋을 수 있습니다.
컨트랙트 상태를 읽을 필요가 없거나 상태의 특정 하위 집합만 필요한 함수는 무엇인가요?
저장소와 기능을 분리할 수 있나요?

라이브러리

기능 코드를 저장소에서 분리하는 간단한 방법 중 하나는 라이브러리 (opens in a new tab)를 사용하는 것입니다. 라이브러리 함수를 internal로 선언하지 마세요. 컴파일 중에 컨트랙트에 직접 추가 (opens in a new tab)되기 때문입니다. 하지만 public 함수를 사용하면 실제로는 별도의 라이브러리 컨트랙트에 존재하게 됩니다. 라이브러리를 더 편리하게 사용하려면 using for (opens in a new tab) 사용을 고려해 보세요.

프록시

더 고급 전략은 프록시 시스템입니다. 라이브러리는 내부적으로 DELEGATECALL를 사용하여 호출하는 컨트랙트의 상태로 다른 컨트랙트의 함수를 단순히 실행합니다. 프록시 시스템에 대해 자세히 알아보려면 이 블로그 게시물 (opens in a new tab)을 확인하세요. 프록시는 업그레이드 가능성과 같은 더 많은 기능을 제공하지만, 복잡성도 크게 증가시킵니다. 어떤 이유로든 유일한 옵션이 아니라면, 단순히 컨트랙트 크기를 줄이기 위해 프록시를 추가하지는 않을 것입니다.

중간 영향

함수 제거하기

이것은 명백합니다. 함수는 컨트랙트 크기를 꽤 많이 증가시킵니다.

External: 편의를 위해 많은 view 함수를 추가하는 경우가 많습니다. 크기 제한에 도달하기 전까지는 전혀 문제가 되지 않습니다. 하지만 제한에 도달하면 절대적으로 필수적인 함수를 제외하고 모두 제거하는 것을 진지하게 고려해야 할 수 있습니다.
Internal: 함수가 한 번만 호출되는 경우 internal/private 함수를 제거하고 코드를 단순히 인라인 처리할 수도 있습니다.

추가 변수 피하기

function get(uint id) returns (address,address) {
    MyStruct memory myStruct = myStructs[id];
    return (myStruct.addr1, myStruct.addr2);
}

function get(uint id) returns (address,address) {
    return (myStructs[id].addr1, myStructs[id].addr2);
}

이러한 간단한 변경만으로도 0.28kb의 차이가 발생합니다. 컨트랙트에서 이와 유사한 상황을 많이 찾을 수 있으며, 이것들이 모이면 상당한 양이 될 수 있습니다.

오류 메시지 줄이기

긴 되돌리기 메시지, 특히 다양하고 많은 되돌리기 메시지는 컨트랙트 크기를 부풀릴 수 있습니다. 대신 짧은 오류 코드를 사용하고 컨트랙트에서 이를 디코딩하세요. 긴 메시지를 훨씬 짧게 만들 수 있습니다.

require(msg.sender == owner, "Only the owner of this contract can call this function");

require(msg.sender == owner, "OW1");

오류 메시지 대신 사용자 정의 오류 사용하기

사용자 정의 오류는 Solidity 0.8.4 (opens in a new tab)에 도입되었습니다. 사용자 정의 오류는 (함수와 마찬가지로) 선택자(selector)로 ABI 인코딩되므로 컨트랙트 크기를 줄이는 좋은 방법입니다.

error Unauthorized();

if (msg.sender != owner) {
    revert Unauthorized();
}

최적화 도구에서 낮은 실행 값 고려하기

최적화 도구(optimizer) 설정을 변경할 수도 있습니다. 기본값인 200은 함수가 200번 호출되는 것처럼 바이트코드를 최적화하려고 시도한다는 의미입니다. 이 값을 1로 변경하면 기본적으로 각 함수가 한 번만 실행되는 경우에 맞춰 최적화하도록 최적화 도구에 지시하는 것입니다. 한 번만 실행되도록 최적화된 함수는 배포 자체에 최적화되어 있음을 의미합니다. 이로 인해 함수 실행에 대한 가스 비용이 증가하므로, 이 방법을 원하지 않을 수도 있다는 점에 유의하세요.

작은 영향

함수에 구조체 전달 피하기

ABIEncoderV2 (opens in a new tab)를 사용하는 경우, 함수에 구조체를 전달하지 않는 것이 도움이 될 수 있습니다. 매개변수를 구조체로 전달하는 대신, 필요한 매개변수를 직접 전달하세요. 이 예제에서는 추가로 0.1kb를 절약했습니다.

function get(uint id) returns (address,address) {
    return _get(myStruct);
}

function _get(MyStruct memory myStruct) private view returns(address,address) {
    return (myStruct.addr1, myStruct.addr2);
}

function get(uint id) returns(address,address) {
    return _get(myStructs[id].addr1, myStructs[id].addr2);
}

function _get(address addr1, address addr2) private view returns(address,address) {
    return (addr1, addr2);
}

함수 및 변수에 대한 올바른 가시성 선언하기

외부에서만 호출되는 함수나 변수인가요? public 대신 external로 선언하세요.
컨트랙트 내부에서만 호출되는 함수나 변수인가요? public 대신 private 또는 internal로 선언하세요.

제어자 제거하기

제어자(modifier)는 특히 집중적으로 사용할 경우 컨트랙트 크기에 상당한 영향을 미칠 수 있습니다. 제어자를 제거하고 대신 함수를 사용하는 것을 고려해 보세요.

modifier checkStuff() {}

function doSomething() checkStuff {}

function checkStuff() private {}

function doSomething() { checkStuff(); }

이러한 팁들은 컨트랙트 크기를 크게 줄이는 데 도움이 될 것입니다. 다시 한번 강조하지만, 가장 큰 효과를 얻으려면 가능할 때마다 항상 컨트랙트를 분리하는 데 집중하세요.

페이지 최근 업데이트: 2026년 4월 3일

+10