기술적 범위 안내 본 글의 명령어와 코드는 개념을 설명하기 위한 예시입니다. 특정 Aiken 버전, SDK, 네트워크에서 실제 실행 및 테스트를 완료했다는 의미는 아닙니다. 프로토콜 파라미터와 실행 가격은 네트워크의 현재 값을 확인해야 합니다.
1 이번 글에서 배울 것
AURA #53에서는 Aiken Validator의 핸들러와 CIP-0057 Plutus Blueprint의 Title을 살펴봤습니다. 이제 오프체인 애플리케이션이 Validator를 호출하는 단계에서 반드시 이해해야 할 개념이 있습니다.
바로 Execution Units(ExUnits)입니다.
Cardano에서 Plutus 스마트 컨트랙트는 단순히 실행에 성공하는지만 중요한 것이 아닙니다. 스크립트가 실행되는 동안 어느 정도의 계산 자원과 메모리를 사용하는지도 측정하고 제한합니다.
이때 사용하는 두 가지 핵심 지표가 다음과 같습니다.
- CPU Steps: 스크립트가 수행하는 계산 작업의 추상적인 실행 비용
- Memory Units: 스크립트 실행에 필요한 메모리 사용량을 나타내는 측정값
두 지표는 서로 다른 자원을 측정합니다. 따라서 CPU 사용량이 낮다고 해서 반드시 Memory 사용량도 낮은 것은 아닙니다.
이번 글에서는 다음 내용을 다룹니다.
- Execution Units의 의미와 CPU·Memory의 차이
- 개별 Redeemer와 트랜잭션 전체의 실행 예산
- 프로토콜 파라미터와 실행 한도
- ExUnits와 트랜잭션 수수료의 관계
- Aiken 테스트와 오프체인 트랜잭션 평가
- 실행 예산 초과와 스크립트 실패의 원인
- 실무에서 실행 비용을 측정하고 관리하는 방법
2 Execution Units란 무엇인가?
Cardano의 Plutus 스크립트는 트랜잭션 검증 과정에서 실행됩니다.
스크립트가 무제한으로 계산을 수행하도록 허용하면 네트워크 자원을 과도하게 소비할 수 있습니다. 이를 방지하기 위해 Cardano는 스크립트 실행에 사용할 수 있는 자원을 정량화하고, 트랜잭션에 실행 예산을 포함하도록 설계했습니다.
이 실행 예산을 Execution Units, 줄여서 ExUnits라고 부릅니다.
ExUnits는 두 가지 값으로 구성됩니다.
Execution Units
├── Memory
└── CPU Steps
① CPU Steps
CPU Steps는 스크립트가 수행하는 계산 작업의 비용을 나타냅니다. 다음과 같은 연산은 서로 다른 계산 비용을 가질 수 있습니다.
- 정수 비교 및 산술 연산
- 리스트 탐색과 반복 처리
- 바이트 배열 처리
- 해시 계산
- 암호학적 연산
예를 들어 단순한 정수 비교와 복잡한 암호학적 연산은 동일한 CPU 비용을 사용하지 않습니다.
여기서 CPU Steps는 실제 컴퓨터의 CPU 사용 시간이나 GHz를 직접 나타내는 값이 아닙니다. Plutus 실행 모델의 Cost Model에 따라 산정되는 추상적인 계산 비용입니다.
② Memory Units
Memory Units는 스크립트 실행에 필요한 메모리 사용량을 측정합니다. 다음과 같은 작업은 메모리 소비에 영향을 줄 수 있습니다.
- 큰 리스트 또는 데이터 구조 처리
- 복잡한 중첩 데이터 탐색
- 바이트 배열 생성 및 처리
- 많은 중간 계산 결과 유지
- 큰 입력 데이터에 대한 패턴 매칭
Memory는 단순히 코드의 파일 크기나 UPLC 바이트코드 크기를 뜻하지 않습니다. 코드가 작더라도 실행 중 많은 메모리를 사용할 수 있고, 반대로 코드가 상대적으로 길더라도 실행 메모리는 적을 수 있습니다.
CPU와 Memory 비교
| 구분 | CPU Steps | Memory Units |
|---|---|---|
| 측정 대상 | 계산 작업 비용 | 실행 중 메모리 사용량 |
| 주요 영향 | 연산 횟수와 연산 종류 | 데이터 크기와 중간 계산 상태 |
| 대표적인 부담 | 반복 계산, 해시, 복잡한 연산 | 큰 리스트, 데이터 구조, 임시 값 |
| 관리 방법 | 불필요한 계산과 반복 축소 | 불필요한 데이터 생성 및 유지 축소 |
핵심: CPU와 Memory는 별개의 실행 자원입니다. 두 지표를 함께 측정하고 각각의 한도를 관리해야 합니다.
3 Redeemer별 실행 예산과 트랜잭션 전체 한도
Cardano 트랜잭션에서 실행 예산은 각 Plutus 스크립트 실행에 대응하는 Redeemer 항목에 포함됩니다.
Redeemer는 스크립트에 전달되는 입력 데이터이면서, 해당 스크립트 실행에 필요한 ExUnits 예산과 연결됩니다.
개념적으로 다음과 같은 구조입니다.
Transaction
│
├── Redeemer A
│ ├── Data
│ └── ExUnits
│ ├── Memory
│ └── CPU Steps
│
├── Redeemer B
│ ├── Data
│ └── ExUnits
│ ├── Memory
│ └── CPU Steps
│
└── Transaction-wide limits
├── Maximum Memory
└── Maximum CPU Steps
예를 들어 하나의 트랜잭션이 두 개의 Plutus 스크립트를 실행한다고 가정하겠습니다.
| 실행 항목 | Memory 예산 | CPU Steps 예산 |
|---|---|---|
| Redeemer A | 1,000,000 | 200,000,000 |
| Redeemer B | 2,000,000 | 350,000,000 |
| 합계 | 3,000,000 | 550,000,000 |
위 숫자는 구조를 이해하기 위한 가상 예시입니다.
각 Redeemer에는 별도의 실행 예산이 지정되며, 트랜잭션 전체의 Memory 및 CPU 예산은 각각 합산하여 프로토콜 한도와 비교해야 합니다.
중요한 점은 다음 두 가지입니다.
- 개별 스크립트의 실행 예산이 실제 소비량보다 충분해야 합니다.
- 트랜잭션에 포함된 모든 Redeemer의 예산 합계가 해당 네트워크의 트랜잭션 실행 한도를 초과해서는 안 됩니다.
즉, 개별 스크립트 하나가 정상적으로 실행될 수 있더라도 여러 스크립트의 예산을 합산했을 때 트랜잭션 전체 한도를 넘으면 문제가 발생할 수 있습니다.
4 Protocol Parameters와 실행 한도
Cardano는 실행 예산을 무제한으로 허용하지 않습니다. 프로토콜 파라미터를 통해 개별 트랜잭션과 블록 전체에 적용되는 실행 한도를 관리합니다.
| 파라미터 | 의미 |
|---|---|
maxTxExecutionUnits |
트랜잭션 하나가 사용할 수 있는 최대 실행 예산 |
maxBlockExecutionUnits |
블록 전체에 포함된 트랜잭션들이 사용할 수 있는 최대 실행 예산 |
executionUnitPrices |
CPU 및 Memory 실행 단위별 가격 |
costModels |
Plutus 실행 연산의 비용을 계산하는 모델 |
① 트랜잭션 한도
maxTxExecutionUnits는 하나의 트랜잭션이 사용할 수 있는 최대 실행 자원을 제한합니다. Memory와 CPU Steps는 각각 별도로 관리됩니다.
② 블록 한도
maxBlockExecutionUnits는 블록에 포함되는 트랜잭션들의 실행 예산을 제한합니다. 블록에 포함되는 트랜잭션이 많고 각 트랜잭션의 실행 비용이 높다면 블록 전체 실행 예산에도 영향을 줍니다. 따라서 개별 트랜잭션이 한도 안에 있다고 해서 블록 전체의 자원 사용에 아무런 영향이 없는 것은 아닙니다.
③ Cost Model
Cost Model은 Plutus 실행 과정에서 각 연산에 얼마만큼의 CPU 및 Memory 비용을 부여할지 결정하는 모델입니다. Plutus 버전과 관련된 비용 모델이 달라질 수 있으므로, 서로 다른 환경에서 측정한 실행 비용을 무조건 동일하게 취급해서는 안 됩니다.
실제 값을 확인하는 방법
프로토콜 파라미터는 네트워크의 거버넌스 및 프로토콜 업데이트에 따라 변경될 수 있습니다. 따라서 과거 문서나 예제에 등장하는 숫자를 현재 Mainnet 또는 Preprod의 고정 한도로 사용해서는 안 됩니다.
Cardano CLI를 사용하는 경우 다음 명령으로 해당 네트워크의 프로토콜 파라미터를 조회할 수 있습니다.
cardano-cli query protocol-parameters \
--mainnet \
--out-file protocol-parameters.json
테스트넷에서는 해당 네트워크에 맞는 옵션을 사용해야 합니다. 조회한 JSON에서 다음 항목을 확인합니다.
{
"maxTxExecutionUnits": {
"memory": "<현재_트랜잭션_Memory_한도>",
"steps": "<현재_트랜잭션_CPU_한도>"
},
"maxBlockExecutionUnits": {
"memory": "<현재_블록_Memory_한도>",
"steps": "<현재_블록_CPU_한도>"
},
"executionUnitPrices": {
"priceMemory": "<현재_Memory_가격>",
"priceSteps": "<현재_CPU_가격>"
}
}
위 JSON은 필드의 의미를 설명하기 위한 개념적 예시입니다. 실제 CLI 출력의 필드 이름과 구조는 사용 중인 Cardano 노드 및 CLI 버전에 맞춰 확인해야 합니다.
5 ExUnits와 트랜잭션 수수료의 관계
Cardano의 스마트 컨트랙트 트랜잭션 수수료는 단순히 트랜잭션 크기만으로 결정되지 않습니다. 일반적으로 다음 요소들이 반영됩니다.
- 트랜잭션 직렬화 크기
- Plutus 스크립트 실행 예산
- Reference Script 사용에 따른 비용 등 해당 거래에 적용되는 추가 비용
기본적인 수수료 구조는 다음과 같이 이해할 수 있습니다.
Transaction Fee
=
Transaction Size Fee
+
Script Execution Fee
+
Applicable Additional Fees
여기서 Script Execution Fee는 CPU와 Memory의 실행 가격을 각각 반영합니다. 개념적인 계산식은 다음과 같습니다.
실제 거래에서는 모든 Redeemer의 실행 예산을 합산하고, 해당 네트워크의 프로토콜 파라미터와 수수료 계산 규칙을 적용합니다.
중요한 실무 원칙: 예산을 과도하게 크게 잡지 말 것
실행 예산은 실제 소비량을 충족할 만큼 충분해야 합니다. 그러나 필요 이상으로 크게 설정하는 것도 바람직하지 않습니다. 트랜잭션의 실행 수수료는 일반적으로 Redeemer에 선언된 실행 예산을 기준으로 계산되기 때문입니다.
예를 들어 다음 두 가지 상황을 비교해 보겠습니다.
| 항목 | 사례 A | 사례 B |
|---|---|---|
| 실제 측정 CPU | 200,000,000 | 200,000,000 |
| 선언 CPU 예산 | 220,000,000 | 1,000,000,000 |
| 실제 측정 Memory | 1,000,000 | 1,000,000 |
| 선언 Memory 예산 | 1,100,000 | 5,000,000 |
두 사례의 실제 계산 작업은 같지만, 사례 B는 더 큰 실행 예산을 선언하고 있습니다. 따라서 사례 B는 불필요하게 높은 실행 비용을 부담할 수 있습니다.
반대로 예산을 너무 작게 설정하면 스크립트가 실행 도중 예산을 초과하여 실패할 수 있습니다.
목표는 가장 작은 숫자가 아니라, 실제 실행을 안정적으로 수용하는 적절한 예산입니다.
6 Aiken 테스트와 오프체인 실행 평가
ExUnits를 관리하려면 먼저 스크립트의 실행 비용을 측정해야 합니다. Aiken은 기본 테스트 도구를 통해 테스트별 Memory 및 CPU 실행 비용을 확인할 수 있습니다.
① aiken check
Aiken 프로젝트에서 다음 명령을 실행합니다.
aiken check
이 명령은 프로젝트의 테스트를 실행하고 결과를 보고합니다. Aiken 테스트 보고서는 각 테스트의 Memory 및 CPU 실행 비용을 보여줄 수 있습니다.
Test Results
--------------------------------
Test: spend_valid_case
Memory: <measured_memory>
CPU: <measured_cpu>
Test: spend_invalid_case
Memory: <measured_memory>
CPU: <measured_cpu>
--------------------------------
위 출력은 설명을 위한 예시이며 실제 터미널 출력 형식이나 숫자를 재현한 것은 아닙니다. 테스트 결과는 다음과 같은 목적으로 활용할 수 있습니다.
- 서로 다른 구현 방식의 비용 비교
- 입력 데이터 크기에 따른 비용 변화 확인
- 불필요한 연산의 영향 분석
- 리팩터링 전후의 성능 변화 비교
다만 Aiken 단위 테스트의 비용을 실제 트랜잭션에 들어갈 최종 ExUnits와 동일하다고 간주해서는 안 됩니다. 테스트는 코드의 실행 비용을 이해하는 개발 단계의 측정 수단입니다. 실제 거래에는 Redeemer, Script Context, 트랜잭션 구성, 사용 중인 Cost Model 등 추가적인 요소가 관여합니다.
② aiken bench
입력 크기에 따른 실행 비용을 비교하려면 Aiken의 Benchmark 기능도 활용할 수 있습니다.
aiken bench
Benchmark는 서로 다른 입력 크기에서 실행 비용이 어떻게 변하는지 살펴보는 데 유용합니다. 예를 들어 작은 리스트와 큰 리스트를 처리하는 Validator의 비용 변화를 비교할 수 있습니다. 이 과정을 통해 단순한 단일 테스트 결과만으로는 발견하기 어려운 비용 증가 패턴을 파악할 수 있습니다.
③ 오프체인 트랜잭션 평가
실제 트랜잭션을 만들 때는 오프체인 SDK나 평가 서비스를 사용해 스크립트 실행 비용을 측정할 수 있습니다.
// 개념적인 오프체인 평가 예시
const redeemers = await provider.evaluateTx(unsignedTxCbor);
console.log(redeemers);
여기서 unsignedTxCbor는 평가할 미서명 트랜잭션의 CBOR 데이터입니다. 평가 결과에는 Redeemer별 실행 비용 정보가 포함될 수 있습니다. SDK나 Provider에 따라 메서드 이름, 입력 형식, 반환 데이터 구조는 다를 수 있으므로 실제 사용 중인 라이브러리의 API 문서를 확인해야 합니다.
권장 개발 흐름
Aiken Validator 작성
↓
Aiken 단위 테스트
↓
CPU / Memory 비용 비교
↓
오프체인 트랜잭션 구성
↓
트랜잭션 실행 비용 평가
↓
Redeemer별 ExUnits 확인
↓
프로토콜 한도 및 수수료 검증
↓
서명 및 제출
핵심: 단위 테스트는 코드 수준의 비용 분석에 사용하고, 오프체인 트랜잭션 평가는 실제 거래의 실행 예산을 결정하는 과정에 사용합니다.
7 실행 예산 초과와 스크립트 실패
실행 예산 관리가 중요한 이유는 예산이 부족하면 정상적인 비즈니스 로직을 가진 스크립트도 실행에 실패할 수 있기 때문입니다. 대표적인 위험 상황은 다음과 같습니다.
| 위험 상황 | 발생 가능한 문제 | 예방 방법 |
|---|---|---|
| CPU 예산 부족 | 계산 도중 실행 예산 초과 | 반복 및 불필요한 계산 최적화 |
| Memory 예산 부족 | 실행 중 메모리 예산 초과 | 데이터 구조와 중간 값 사용량 점검 |
| Redeemer 예산 과소 설정 | 해당 스크립트 실행 실패 | 오프체인 평가 결과에 맞춰 예산 설정 |
| 트랜잭션 전체 예산 초과 | 네트워크의 트랜잭션 실행 한도 위반 | 모든 Redeemer 예산 합산 검사 |
| Cost Model 불일치 | 예상 비용과 실제 평가 조건의 차이 | 대상 네트워크와 Plutus 버전 확인 |
| 오래된 프로토콜 파라미터 사용 | 현재 네트워크 한도와 다른 예산 설정 | 거래 구성 시 최신 파라미터 조회 |
실패의 두 가지 구분
Cardano 트랜잭션은 크게 Phase 1과 Phase 2의 검증 단계를 거칩니다.
- Phase 1: 트랜잭션 구조, 서명, 입력 및 기본 원장 규칙 등을 확인합니다.
- Phase 2: Plutus 스크립트를 실행하여 비즈니스 로직의 검증 결과를 확인합니다.
실행 예산 부족은 Plutus 실행 단계와 관련된 문제입니다. 반면 트랜잭션의 구조나 서명에 문제가 있다면 스크립트 실행 단계에 도달하기 전에 거부될 수 있습니다.
또한 Phase 2 스크립트가 실패하는 경우에는 담보(Collateral)가 영향을 받을 수 있습니다. 담보는 일반적인 실행 수수료와 다른 개념이며, 스크립트 실패 시 네트워크의 규칙에 따라 처리됩니다. 따라서 실행 예산 초과와 일반적인 트랜잭션 구성 오류를 동일한 문제로 취급해서는 안 됩니다.
8 실무에서 ExUnits를 관리하는 방법
스마트 컨트랙트 개발에서는 실행 비용을 한 번 측정하고 끝내는 방식보다, 테스트와 최적화를 반복하면서 비용 변화를 관리하는 것이 중요합니다. 다음과 같은 관리 절차를 권장합니다.
① 대표 입력과 경계 입력을 함께 테스트
정상적인 입력만으로 실행 비용을 측정해서는 안 됩니다.
- 일반적인 입력
- 최소 크기 입력
- 최대 허용 크기 입력
- 빈 데이터 또는 경계 조건
- 오류가 발생할 수 있는 입력
이러한 테스트를 통해 특정 입력에서 실행 비용이 급격히 증가하는지 확인합니다.
② 불필요한 탐색과 반복을 줄이기
리스트나 트랜잭션 입력을 반복해서 탐색하는 코드는 실행 비용을 증가시킬 수 있습니다. 가능하다면 다음과 같은 개선을 검토합니다.
- 동일한 데이터를 반복해서 탐색하지 않기
- 불필요한 리스트 변환 줄이기
- 중복 계산을 제거하기
- 필요한 조건만 확인하도록 로직 단순화하기
단, 실행 비용을 줄이기 위해 보안 검증을 제거하거나 검증 범위를 축소해서는 안 됩니다.
③ CPU와 Memory를 별도로 비교
최적화 전후의 결과를 하나의 숫자로 합쳐 비교하지 않는 것이 좋습니다.
| 비교 항목 | 최적화 전 | 최적화 후 |
|---|---|---|
| CPU Steps | 측정값 A | 측정값 B |
| Memory Units | 측정값 C | 측정값 D |
| Script Size | 측정값 E | 측정값 F |
| 테스트 성공 여부 | 결과 A | 결과 B |
CPU가 줄었더라도 Memory가 증가할 수 있습니다. 스크립트 크기 역시 실행 비용과 별도로 관리해야 합니다.
④ 실행 비용의 기준 환경 기록
비용 측정 결과를 기록할 때는 다음 정보를 함께 보관하는 것이 좋습니다.
- Aiken 컴파일러 버전
- Plutus 버전
- Cost Model 및 프로토콜 파라미터 기준
- 테스트 입력 데이터
- Validator 및 Redeemer 구성
- 측정한 CPU Steps 및 Memory Units
- 측정 시점과 네트워크
⑤ 최종 거래 구성에서 다시 평가
코드 수준의 테스트 결과가 양호하더라도 실제 트랜잭션 구성 단계에서는 다시 평가해야 합니다. 특히 여러 Redeemer가 포함된 트랜잭션이라면 개별 예산뿐 아니라 전체 예산 합계도 확인해야 합니다.
9 핵심 요약
| 개념 | 기억해야 할 내용 |
|---|---|
| ExUnits | Plutus 스크립트 실행 자원을 측정하는 단위 |
| CPU Steps | 계산 작업의 추상적인 실행 비용 |
| Memory Units | 실행 중 메모리 사용량을 나타내는 지표 |
| Redeemer별 예산 | 각 스크립트 실행에 지정되는 예산 |
| 트랜잭션 한도 | 하나의 트랜잭션에 포함된 실행 예산의 총량 제한 |
| 블록 한도 | 블록 전체의 Plutus 실행 예산 제한 |
| Execution Prices | CPU 및 Memory 예산을 수수료로 환산하는 가격 |
| Aiken 테스트 | 코드 수준의 실행 비용을 측정하고 비교하는 도구 |
| 오프체인 평가 | 실제 트랜잭션의 Redeemer별 실행 예산을 확인하는 과정 |
Cardano 스마트 컨트랙트는 단순히 올바른 결과를 반환하는 것만으로 충분하지 않습니다. 실제 네트워크에서 안정적으로 실행되려면 CPU와 Memory 사용량을 모두 고려해야 하며, 개별 스크립트의 예산과 트랜잭션 전체 한도도 함께 관리해야 합니다.
실행 예산을 너무 작게 설정하면 검증이 실패할 수 있고, 반대로 필요 이상으로 크게 설정하면 사용자가 부담하는 수수료가 증가할 수 있습니다. 따라서 정확한 측정, 적절한 예산 설정, 실제 트랜잭션 평가가 함께 이루어져야 합니다.
다음 AURA #55에서는 스마트 컨트랙트와 오프체인 애플리케이션 사이의 연결을 더 깊이 살펴봅니다. 특히 트랜잭션 구성, CBOR 직렬화, Redeemer 및 Datum 데이터 전달 과정에서 발생할 수 있는 오류와 검증 방법을 다룰 예정입니다.
본 글은 Cardano ExUnits, 프로토콜 파라미터 및 Aiken 테스트·오프체인 평가 절차를 설명하는 교육용 기술 자료입니다. 명령어와 코드 예시는 개념 설명용이며, 특정 네트워크에서 실제 컴파일·실행·테스트넷 배포를 완료했다는 의미는 아닙니다.