A
Aura Core Research SMART CONTRACT TUTORIALS
Home / Smart Contract Tutorials / aura-core-56-aiken-smart-contract-comprehensive-guide
Cardano Smart Contract Development Series · Part 09 · Final Chapter · AURA #56

Aiken 스마트 컨트랙트 종합 정리 및 다음 단계

Aiken 스마트 컨트랙트 개발의 전체 생명주기: On-chain과 Off-chain 역할 분리, 프로젝트 구성, 목적별 Validator 설계, Datum·Redeemer·Context 모델, 단위 및 Property 테스트, aiken build와 CIP-0057 Blueprint, Reference Script, CBOR 트랜잭션 파이프라인, ExUnits 최적화, 보안 및 운영 위험, 테스트넷에서 메인넷까지의 종합 가이드

PK
Paul Ko (Cardano Ambassador & DRep)
Published: 2026-11-17 · Series: Developer Tutorial · Series Finale
#Aiken #Cardano #Lifecycle #Blueprint #EndToEnd
교육 및 기술 이해를 위한 안내 본 문서는 교육 및 기술 이해를 위한 자료이며, 특정 스마트 컨트랙트의 보안성이나 메인넷 배포 준비 상태를 보증하지 않습니다. 실제 배포 전에는 해당 버전의 공식 명세, 테스트 결과 및 독립적인 보안 검토가 필요합니다.

0 들어가며: Validator 작성은 개발의 끝이 아니다

Aiken으로 스마트 컨트랙트를 개발한다는 것은 단순히 몇 개의 검증 함수를 작성하는 일이 아닙니다.

실제 서비스에서는 다음과 같은 과정이 하나의 연결된 시스템으로 작동해야 합니다.

  1. 프로토콜과 비즈니스 규칙을 명세한다.
  2. 상태와 데이터 구조를 설계한다.
  3. Aiken Validator를 작성한다.
  4. 정상 경로와 실패 경로를 테스트한다.
  5. Validator를 빌드하고 Blueprint를 확인한다.
  6. 스크립트 식별자와 주소를 결정한다.
  7. Off-chain 애플리케이션에서 트랜잭션을 구성한다.
  8. 비용과 실행 예산을 평가한다.
  9. 지갑 서명과 네트워크 제출을 수행한다.
  10. 실제 체인 상태를 관찰하고 운영 위험에 대응한다.

이 과정 중 하나라도 빠지면 코드는 정상적으로 빌드되더라도 실제 서비스에서는 문제가 발생할 수 있습니다.

예를 들어 Validator가 올바른 조건을 검사하더라도 Off-chain 코드가 잘못된 Redeemer를 전달하거나, 이미 소비된 UTxO를 다시 사용하려고 하거나, 필요한 서명을 빠뜨리면 트랜잭션은 실패합니다.

On-chain 코드는 규칙을 강제하고, Off-chain 시스템은 그 규칙을 만족하는 트랜잭션을 구성하며, Ledger는 최종적으로 해당 트랜잭션을 검증하고 상태를 전이시킨다.

이번 마지막 편에서는 AURA #48~#55에서 다룬 내용을 하나의 End-to-End 개발 생명주기로 연결합니다.

1 전체 아키텍처: On-chain과 Off-chain의 역할 분리

Cardano 스마트 컨트랙트는 Extended UTxO(eUTxO) 모델 위에서 작동합니다.

일반적인 계정 기반 모델과 달리 Cardano에서는 트랜잭션이 소비할 UTxO를 명시적으로 지정합니다. 스마트 컨트랙트는 입력과 함께 제공된 데이터, 출력, 서명 및 트랜잭션 문맥을 검증합니다.

On-chain: 규칙의 집행

On-chain Validator는 Ledger가 트랜잭션을 검증할 때 실행되는 프로그램입니다. 주요 책임은 다음과 같습니다.

  • 소비하려는 UTxO의 Datum과 상태 확인
  • 전달된 Redeemer의 의미 검증
  • 트랜잭션 입력과 출력의 관계 검증
  • 필요한 서명자 및 권한 확인
  • 자산 이동과 상태 전이 조건 검증
  • 허용되지 않는 상태 변경 거부

Validator는 외부 데이터베이스에 직접 접속하거나 일반적인 웹 API를 호출하는 애플리케이션이 아닙니다. 트랜잭션에 포함되거나 Ledger가 제공하는 검증 문맥을 바탕으로 결정적인 검증을 수행합니다.

Off-chain: 트랜잭션의 구성

Off-chain 애플리케이션은 사용자의 요청을 실제 Ledger 트랜잭션으로 변환합니다. 주요 책임은 다음과 같습니다.

  • 현재 UTxO와 관련 데이터 조회
  • Datum과 Redeemer 구성
  • 입력과 출력 선택
  • Reference Input 및 Reference Script 지정
  • 수수료와 실행 예산 계산
  • 필요한 서명 수집
  • 트랜잭션 제출
  • 제출 결과와 체인 상태 확인

TypeScript, Python, Rust 등 다양한 언어와 SDK를 사용할 수 있습니다.

두 영역 사이의 경계

구분 On-chain Off-chain
주요 역할 규칙 검증 트랜잭션 구성
실행 환경 Ledger 검증 과정 사용자 애플리케이션 및 인프라
주요 데이터 Script Context UTxO 조회 결과 및 사용자 입력
실패 사례 Validator 조건 불충족 잘못된 입력 구성, UTxO 경쟁
변경 방식 새 스크립트 배포 및 상태 전환 설계 애플리케이션 업데이트

두 영역은 서로 다른 책임을 가지지만 하나의 프로토콜을 구현합니다. 따라서 On-chain과 Off-chain을 별도로 테스트하는 것만으로는 충분하지 않으며, 실제 트랜잭션이 두 영역의 계약을 올바르게 연결하는지 통합 검증해야 합니다.

2 Aiken 개발 환경과 프로젝트 구성

Aiken은 Cardano 스마트 컨트랙트 개발을 위한 언어이자 개발 도구 체계입니다. 일반적인 개발 흐름은 프로젝트 생성, 모듈 구성, 의존성 관리, Validator 작성, 테스트 및 빌드로 구성됩니다.

프로젝트 구조의 예

my-cardano-contract/
├── aiken.toml
├── lib/
│   └── my_project/
│       ├── types.ak
│       ├── validation.ak
│       └── helpers.ak
├── validators/
│   ├── spending.ak
│   └── minting.ak
├── build/
│   └── plutus.json
└── README.md

위 구조는 하나의 설계 예시입니다. 실제 프로젝트의 디렉터리 구성은 규모와 모듈 설계에 따라 달라질 수 있습니다.

모듈 분리 원칙

가능하면 다음 책임을 분리합니다.

  • types.ak: Datum, Redeemer 및 공통 데이터 타입
  • helpers.ak: 재사용 가능한 검증 보조 함수
  • validation.ak: 공통 비즈니스 규칙
  • spending.ak: Spending Validator
  • minting.ak: Minting Policy

모듈 분리는 단순히 파일을 나누는 작업이 아닙니다. 변경 범위를 좁히고 테스트 대상을 명확히 하며, 검증 규칙의 중복을 줄이기 위한 설계 방법입니다.

의존성 관리

외부 라이브러리와 표준 라이브러리는 프로젝트 설정에 명시적으로 관리해야 합니다. 실무에서는 다음을 기록하는 것이 좋습니다.

  • Aiken 컴파일러 버전
  • 의존성 버전 및 잠금 상태
  • 빌드 명령과 환경
  • 테스트 실행 결과
  • 생성된 Blueprint
  • 배포에 사용한 스크립트 식별 정보
중요: Aiken 버전이나 의존성 버전이 달라지면 컴파일 결과와 사용 가능한 기능이 달라질 수 있습니다. 따라서 문서에 작성한 명령을 실제 프로젝트 환경에서 확인하지 않고 그대로 복사해서는 안 됩니다.

3 Validator 설계: 목적별 검증 구조

Validator를 설계할 때 가장 먼저 결정해야 하는 것은 어떤 Ledger 목적에 대해 어떤 조건을 검사할 것인지입니다.

Cardano의 Script Purpose는 대표적으로 다음 여섯 범주로 설명할 수 있습니다.

Ledger 목적 개념 대표적인 사용 사례
Spending UTxO 소비 예치금 인출, 상태 변경
Minting 자산 발행 및 소각 토큰 발행 정책
Certifying 인증서 처리 Stake 및 관련 인증서
Rewarding 보상 인출 Reward Withdrawal
Voting 거버넌스 투표 Governance Vote
Proposing 거버넌스 제안 Proposal Procedure

Aiken에서 사용되는 Validator 핸들러 명칭은 Ledger 목적의 개념과 구분해서 이해해야 합니다. 예를 들어 Aiken의 publish는 Ledger의 Certifying 목적과 연결되는 핸들러 명칭이지, Ledger 목적 자체의 공식 명칭을 대체하는 것은 아닙니다.

Conway Era에서는 CIP-1694에 따른 온체인 거버넌스가 도입되면서 Voting과 Proposing 목적도 스마트 컨트랙트 설계에서 중요해졌습니다.

Spending Validator 설계 예

다음은 개념적인 상태 전이 구조입니다.

Current State
     │
     ▼
Read Datum
     │
     ▼
Receive Redeemer
     │
     ▼
Check Authorization
     │
     ▼
Validate Output State
     │
     ▼
Accept or Reject

예를 들어 예치금 인출을 허용하는 Validator라면 다음 조건을 검토할 수 있습니다.

  1. 현재 상태가 인출 가능한 상태인가?
  2. 요청한 인출량이 허용 범위에 있는가?
  3. 필요한 권한 서명이 존재하는가?
  4. 인출 후 남은 상태가 프로토콜 규칙을 만족하는가?
  5. 자산이 의도한 주소로 이동하는가?

Validator는 단순히 사용자가 요청한 작업을 확인하는 것이 아니라, 해당 트랜잭션 전체가 프로토콜의 불변 조건을 지키는지 검증해야 합니다.

4 Datum, Redeemer, Transaction Context

eUTxO 스마트 컨트랙트의 핵심 데이터 모델은 Datum, Redeemer 및 Script Context입니다.

Datum: 현재 상태

Datum은 UTxO에 연결된 상태 데이터입니다. 예를 들어 다음과 같은 정보를 저장할 수 있습니다.

PoolDatum {
  owner,
  total_deposit,
  interest_rate,
  status
}

위 타입은 개념적 예시입니다. 실제 Aiken 타입 선언과 직렬화 방식은 프로젝트에서 별도로 정의해야 합니다.

Redeemer: 요청된 동작

Redeemer는 소비 트랜잭션에서 스크립트에 전달하는 동작 관련 데이터입니다. 예를 들어 다음과 같은 요청을 표현할 수 있습니다.

Redeemer =
  Deposit
  | Withdraw
  | Close

Validator는 Redeemer가 요청한 동작을 무조건 허용하지 않습니다. Datum, Script Context 및 프로토콜 규칙을 함께 확인해야 합니다.

Transaction Context: 실제 트랜잭션 문맥

Script Context에는 스크립트가 검증할 수 있도록 트랜잭션 관련 정보가 제공됩니다. 대표적으로 다음 항목을 검토합니다.

  • 입력 UTxO
  • 출력 UTxO
  • Minted Value
  • 필요한 서명자
  • 유효 시간 범위
  • Reference Input
  • 관련 Datum 및 Redeemer
  • Script Purpose

여기서 중요한 점은 검증 대상이 사용자의 설명이나 애플리케이션 화면이 아니라 실제 트랜잭션이라는 것입니다. 사용자가 화면에서 “100 ADA를 인출한다”고 입력했더라도 Validator는 실제 출력과 자산 이동이 그 조건을 만족하는지 확인해야 합니다.

Datum Hash와 Inline Datum

Datum을 다루는 방법에는 여러 방식이 있습니다.

  • Datum Hash: 출력에는 Datum의 해시를 저장하고 소비 트랜잭션에서 실제 Datum을 제공하는 방식
  • Inline Datum: Datum 자체를 출력에 포함하는 방식

Inline Datum은 CIP-0032에서 제안된 기능입니다. 이를 사용하면 소비 측이 별도로 Datum을 전달받지 않고 UTxO에 포함된 데이터를 읽을 수 있습니다.

그러나 Inline Datum이 모든 상황에서 더 저렴하거나 더 좋은 것은 아닙니다. 출력 크기, 최소 ADA, 데이터 공개 범위 및 애플리케이션의 데이터 전달 구조를 함께 고려해야 합니다.

5 테스트 전략: 정상 경로만 테스트해서는 안 된다

스마트 컨트랙트의 테스트는 단순히 정상적인 입력에서 성공하는지를 확인하는 작업이 아닙니다. 잘못된 입력과 공격적인 조건에서도 프로토콜의 불변 조건이 유지되는지 검증해야 합니다.

Aiken 단위 테스트

Aiken은 test 구문을 통해 Validator와 관련 함수의 단위 테스트를 작성할 수 있습니다. 기본 실행 명령은 다음과 같습니다.

aiken check

대표적인 테스트 대상은 다음과 같습니다.

  • 올바른 Datum과 Redeemer
  • 잘못된 권한 서명자
  • 허용 범위를 초과한 인출
  • 잘못된 출력 주소
  • 잘못된 자산 수량
  • 유효 시간 범위 위반
  • 허용되지 않는 상태 전이

Property-based Testing

단위 테스트가 특정 입력을 검증한다면 Property-based Testing은 다양한 입력을 생성하여 일반적인 규칙이 유지되는지 검사합니다.

예를 들어 다음과 같은 속성을 정의할 수 있습니다.

  • 인출 후 잔액은 음수가 될 수 없다.
  • 권한이 없는 사용자는 소유자 전용 작업을 수행할 수 없다.
  • 허용되지 않은 상태 전이는 항상 거부된다.
  • 발행 권한이 없는 조건에서는 추가 토큰이 생성되지 않는다.

Property-based Testing에서는 생성기 자체의 품질도 중요합니다. 입력 생성기가 실제 위험 조건을 충분히 탐색하지 못하면 테스트가 통과하더라도 중요한 취약점을 놓칠 수 있습니다. Aiken의 테스트 기능과 Fuzzer를 활용할 수 있으며, 공식 문서는 aiken check를 통한 테스트 실행과 Property 기반 검증을 설명합니다.

테스트 매트릭스

테스트 유형 검증 목표
정상 경로유효한 요청이 성공하는가
실패 경로잘못된 요청이 거부되는가
경계값최소·최대값에서 규칙이 유지되는가
권한서명자와 권한 조건이 정확한가
자산ADA와 Native Asset의 수량이 정확한가
시간Validity Range가 정확한가
상태 전이이전 상태와 다음 상태의 관계가 올바른가
Property다양한 입력에서도 불변 조건이 유지되는가

통합 테스트

Validator 단위 테스트만으로 Off-chain 트랜잭션 구성의 정확성을 보장할 수는 없습니다. 다음 사항은 별도의 통합 테스트가 필요합니다.

  • UTxO 조회
  • Datum 직렬화 및 역직렬화
  • Redeemer 구성
  • Reference Input 지정
  • 수수료 계산
  • 서명 수집
  • 트랜잭션 제출
  • 결과 상태 확인

6 빌드와 Blueprint: 실행 가능한 아티팩트 확인

Aiken 소스 코드를 작성한 후에는 빌드 결과를 확인해야 합니다. 대표적인 명령은 다음과 같습니다.

aiken build

프로젝트 설정과 Aiken 버전에 따라 세부 출력은 달라질 수 있지만, 중요한 결과물 중 하나는 Plutus Blueprint인 plutus.json입니다.

Blueprint의 역할

Blueprint는 단순한 설명 문서가 아닙니다. 다음과 같은 정보를 전달하는 인터페이스 아티팩트입니다.

  • Validator 정의
  • Datum 및 Redeemer 관련 타입 정보
  • 파라미터 정보
  • 스키마 정의
  • 스크립트 관련 메타데이터

CIP-0057은 Plutus Blueprint 형식을 정의합니다.

빌드 후 확인할 항목

  1. 빌드가 오류 없이 완료되었는가?
  2. 예상한 Validator가 생성되었는가?
  3. Datum과 Redeemer의 타입 정의가 정확한가?
  4. 파라미터가 의도한 순서와 타입으로 표현되었는가?
  5. 생성된 스크립트 정보가 실제 Off-chain 코드와 일치하는가?
  6. 사용 중인 도구가 Blueprint의 필드를 올바르게 처리하는가?
참고: 특히 title은 사람이 읽기 위한 설명적 식별 정보로 이해해야 합니다. 이를 Ledger가 보장하는 유일한 스크립트 식별자로 취급해서는 안 됩니다. 실제 연동에서는 생성된 Blueprint의 구조와 스크립트 데이터, Hash 등을 확인해야 합니다.

7 Script Hash, 파라미터화 및 Reference Script

Validator를 빌드한 뒤에는 해당 스크립트의 식별 정보와 주소를 이해해야 합니다.

Script Hash와 주소

Cardano의 Script Address는 스크립트와 연결된 Hash를 기반으로 구성됩니다. 따라서 스크립트 코드 또는 파라미터 적용 결과가 달라지면 스크립트 Hash와 관련 주소도 달라질 수 있습니다.

Parameterized Validator

하나의 Validator 로직을 여러 인스턴스에서 사용해야 하는 경우 파라미터를 적용할 수 있습니다. 예를 들어 다음과 같은 설정을 생각할 수 있습니다.

  • 관리자 공개키 Hash
  • 토큰 Policy ID
  • 프로토콜 설정값
  • 특정 Registry 식별자

파라미터를 적용한 스크립트는 적용 전 스크립트와 동일한 것으로 취급해서는 안 됩니다. 실제 적용된 스크립트 바이트와 Hash를 확인하고, 해당 결과를 배포 및 Off-chain 코드에서 동일하게 사용해야 합니다.

Reference Script: CIP-0033

CIP-0033은 Reference Script를 통해 자주 사용되는 스크립트를 UTxO에 저장하고, 이후 트랜잭션이 해당 스크립트를 참조하도록 하는 기능입니다.

일반적인 방식에서는 스크립트 사용 트랜잭션이 스크립트 전체를 Witness에 포함해야 할 수 있습니다. Reference Script를 사용하면 이미 UTxO에 저장된 스크립트를 참조하여 매번 전체 스크립트를 트랜잭션에 포함하지 않아도 됩니다.

기대 효과는 다음과 같습니다.

  • 트랜잭션 크기 감소
  • 반복적인 스크립트 전송 부담 감소
  • 공통 스크립트 재사용

그러나 Reference Script도 비용이 없는 것은 아닙니다. 스크립트를 보관하는 UTxO의 크기와 최소 ADA, 참조 비용 및 관리 정책을 고려해야 합니다.

Reference Input과 Reference Script의 차이

항목 Reference Input Reference Script
핵심 기능 UTxO 데이터 읽기 저장된 스크립트 참조
목적 상태 및 데이터 공유 스크립트 재사용
소비 여부 참조만으로는 소비하지 않음 참조만으로는 소비하지 않음
관련 CIP CIP-0031 CIP-0033

Reference Input은 읽기 공유를 위한 기능이고, Reference Script는 스크립트 코드를 반복해서 전달하지 않기 위한 기능입니다. 둘은 함께 사용될 수 있지만 서로 대체하는 기능은 아닙니다.

8 Off-chain 트랜잭션 파이프라인

On-chain Validator가 올바르게 작성되었더라도 실제 트랜잭션이 올바르게 구성되지 않으면 실행할 수 없습니다. 일반적인 트랜잭션 파이프라인은 다음과 같습니다.

User Request
     │
     ▼
Query UTxOs
     │
     ▼
Construct Transaction
     │
     ▼
Attach Datum / Redeemer
     │
     ▼
Select Inputs and Outputs
     │
     ▼
Evaluate Scripts and Balance
     │
     ▼
Calculate Fee and Collateral
     │
     ▼
Sign Transaction
     │
     ▼
Submit Transaction
     │
     ▼
Monitor Chain Confirmation

이 순서는 개념적인 흐름입니다. 실제 SDK와 Ledger 환경에서는 평가, 균형 조정 및 수수료 계산이 반복되거나 순서가 달라질 수 있습니다.

UTxO Selection

트랜잭션을 구성할 때 사용할 입력 UTxO를 선택해야 합니다. 이 과정에서는 다음을 고려합니다.

  • 필요한 ADA 수량
  • Native Asset 구성
  • 최소 ADA 조건
  • 출력 Value 크기 제한
  • 트랜잭션 크기
  • 수수료
  • Collateral 요구 조건

단순히 입력 UTxO의 총액이 충분하다고 해서 트랜잭션이 반드시 유효한 것은 아닙니다.

Datum과 Redeemer

Validator가 요구하는 데이터 구조와 Off-chain 애플리케이션이 전달하는 데이터 구조가 정확하게 일치해야 합니다. 직렬화 오류, 타입 불일치, 잘못된 인덱스 또는 잘못된 Script Purpose는 검증 실패의 원인이 될 수 있습니다.

CBOR와 Transaction Body

Cardano 트랜잭션은 Ledger 규칙에 따라 직렬화됩니다. 트랜잭션을 구성하고 서명하는 과정에서 Transaction Body의 내용이 변경되면 기존 서명은 더 이상 해당 Body를 보증하지 않습니다.

TxId는 전체 트랜잭션이나 Witness Set이 아니라 Ledger 규칙에 따른 Transaction Body의 직렬화 결과를 기반으로 계산됩니다. 따라서 서명 이후 Body를 변경하면 다시 서명해야 합니다.

Evaluate, Balance, Sign, Submit

트랜잭션을 제출하기 전에 스크립트 실행 예산과 수수료를 평가해야 합니다. 일반적으로 다음 항목을 확인합니다.

  • Script Evaluation 결과
  • ExUnits
  • 수수료
  • Collateral
  • 필요한 서명
  • 최종 Transaction Body

Submit 성공 응답은 네트워크에 제출되었다는 사실을 의미할 뿐, 블록 포함이나 최종 확정을 보장하지 않습니다.

9 비용과 자원 최적화

스마트 컨트랙트의 성능은 코드가 짧은지 여부만으로 평가할 수 없습니다. 실제 실행 비용은 스크립트가 처리하는 데이터와 연산량, Ledger의 프로토콜 파라미터 등에 영향을 받습니다.

ExUnits

Plutus Script의 실행 예산은 대표적으로 다음 두 지표로 설명됩니다.

  • Memory: 스크립트 실행에 필요한 메모리 자원
  • Steps: 추상적인 연산 실행량

트랜잭션은 허용된 실행 예산을 초과해서는 안 됩니다.

Aiken Benchmark

Aiken은 aiken bench를 통해 특정 코드의 실행 비용을 측정하고 비교할 수 있습니다.

aiken bench

벤치마크 결과는 코드 변경 전후의 비용을 비교하거나 입력 크기에 따른 비용 증가를 확인하는 데 유용합니다. 예를 들어 다음 항목을 비교할 수 있습니다.

  • 리스트 탐색 길이
  • Datum 크기
  • 반복 연산 횟수
  • 복잡한 데이터 구조 처리
  • Validator 함수별 실행 비용

그러나 로컬 벤치마크 결과만으로 메인넷 수수료를 확정해서는 안 됩니다. 실제 트랜잭션의 수수료와 실행 예산은 해당 시점의 Ledger 규칙과 Protocol Parameters에 따라 확인해야 합니다.

Collateral과 Collateral Return

Phase-2 스크립트가 실패할 경우를 대비하여 트랜잭션에는 Collateral이 필요할 수 있습니다. Babbage 이후의 기능을 지원하는 환경에서는 Collateral Return을 이용해 요구되는 담보 금액을 제외한 잔액을 반환할 수 있습니다.

다만 정확한 조건과 처리 방식은 Era별 Ledger 규칙을 확인해야 합니다. 비용 최적화의 목표는 단순히 ADA 수수료를 줄이는 것이 아닙니다.

안전한 검증을 유지하면서 불필요한 연산과 데이터 전달을 줄이는 것이 최적화의 핵심이다.

10 보안과 운영 위험

스마트 컨트랙트의 보안은 Validator 코드 한 곳에서만 결정되지 않습니다. 상태 구조, UTxO 배치, Off-chain 트랜잭션 조립, 서명 및 운영 절차까지 함께 검토해야 합니다.

10.1 UTxO Contention과 Stale UTxO

eUTxO에서는 하나의 UTxO를 여러 트랜잭션이 동시에 소비할 수 없습니다. 예를 들어 하나의 공유 Pool UTxO를 Alice와 Bob이 동시에 소비하려고 한다고 가정하겠습니다.

             Shared Pool UTxO
                    │
           ┌────────┴────────┐
           │                 │
       Alice Tx           Bob Tx
           │                 │
        Compete for the same input

먼저 유효하게 포함된 트랜잭션이 해당 UTxO를 소비하면, 다른 트랜잭션은 더 이상 동일한 입력을 사용할 수 없습니다. 이때 후속 트랜잭션은 최신 상태를 다시 조회하고 재구성해야 합니다.

이 문제를 줄이기 위한 설계 방법은 다음과 같습니다.

  • 상태를 여러 독립 UTxO로 분산
  • Reference Input을 이용한 읽기 공유
  • 사용자별 또는 작업별 상태 분리
  • Batching 구조
  • 실패 시 최신 상태를 조회하는 재시도 정책

단, Reference Input은 읽기 공유를 지원하지만 해당 상태 UTxO를 소비하는 경쟁까지 해결하는 것은 아닙니다.

10.2 Double Satisfaction

Double Satisfaction은 서로 다른 Validator가 동일한 출력 하나를 각자의 조건을 만족하는 출력으로 동시에 해석하여, 의도한 것보다 적은 자산으로 여러 의무를 충족하는 취약점입니다.

예를 들어 두 개의 Pool이 각각 100 USDx의 지급을 요구한다고 가정하겠습니다. 잘못 설계된 Validator가 단순히 “100 USDx를 포함한 출력이 존재하는가?”만 확인한다면 하나의 출력이 두 Validator의 검증을 동시에 통과할 가능성이 있습니다.

방어 방법은 다음과 같습니다.

  • 각 작업의 출력에 고유한 식별 정보 부여
  • 자신의 입력과 대응하는 출력을 정확히 식별
  • 토큰 및 상태 전이 조건 검증
  • 전체 트랜잭션의 자산 흐름 확인

Double Satisfaction은 UTxO 동시 소비 문제와 동일한 취약점이 아닙니다. 두 문제는 각각 별도로 분석해야 합니다.

10.3 권한 서명자 누락

관리자 전용 작업이나 특정 권한이 필요한 작업에서는 서명자 검증이 중요합니다. 검증해야 할 항목은 다음과 같습니다.

  • 요구되는 서명자의 Hash
  • 실제 Transaction Signers
  • 권한 변경 조건
  • 관리자 교체 절차
  • 다중 서명 정책

단순히 Off-chain 애플리케이션에서 관리자 버튼을 숨기는 것은 보안 통제가 아닙니다. 최종 권한 검증은 On-chain에서 수행해야 합니다.

10.4 상태 마이그레이션과 업그레이드

배포된 Validator의 코드를 기존 UTxO에 대해 임의로 교체할 수 있다고 가정해서는 안 됩니다. 새로운 Validator를 배포하더라도 기존 스크립트 주소에 잠긴 UTxO가 자동으로 새 주소로 이동하지는 않습니다.

따라서 초기 설계 단계부터 다음을 검토해야 합니다.

  • 상태 이전 조건
  • 기존 UTxO를 소비할 권한
  • 새로운 Validator의 상태 구조
  • 토큰 및 자산 보존
  • 마이그레이션 실패 시 복구 방안
  • 사용자에게 필요한 동의 및 서명

업그레이드 가능성을 고려하지 않은 프로토콜은 시간이 지나면서 운영상 큰 제약을 받을 수 있습니다.

11 테스트넷에서 메인넷까지

로컬 테스트가 통과했다고 해서 실제 네트워크에서의 운영 준비가 완료된 것은 아닙니다. 개발 환경은 위험과 검증 목적에 따라 단계적으로 확장해야 합니다.

단계 1: 로컬 단위 테스트

목표는 Validator의 논리적 정확성을 확인하는 것입니다. aiken check, 정상 및 실패 경로, Property-based Testing, 경계값 테스트를 수행합니다.

단계 2: 로컬 Ledger 또는 Devnet 통합 테스트

실제 트랜잭션 구성과 제출 흐름을 검증합니다. Yaci DevKit과 같은 로컬 개발 네트워크 도구를 활용할 수 있습니다. 검증 대상은 노드 및 관련 서비스 연결, 트랜잭션 구성, 서명과 제출, 블록 생성 및 상태 변화, 여러 트랜잭션의 의존 관계입니다.

로컬 Devnet은 통제된 환경에서 빠르게 반복 검증하는 데 유용하지만, 실제 공개 네트워크의 경쟁 상황과 운영 조건을 모두 대체하지는 않습니다.

단계 3: Preprod

Preprod는 메인넷 출시 전 실제 네트워크 조건에 가까운 최종 리허설을 수행하는 데 적합합니다. 실제 네트워크 파라미터와의 호환성, 지갑 연동, 수수료 및 실행 예산, 트랜잭션 제출, 블록 포함 확인, 서비스 장애 및 재시도 처리를 확인합니다. (테스트 ADA는 실제 가치가 없으며 메인넷 자산과 구분해야 합니다.)

단계 4: Mainnet

메인넷은 실제 자산이 움직이는 운영 환경입니다. 출시 전 다음 조건을 모두 확인해야 합니다: Validator와 파라미터가 최종 확정되었는가, 보안 검토가 완료되었는가, 테스트넷 전체 시나리오가 통과했는가, 관리자 및 권한 복구 절차가 준비되었는가, 모니터링과 장애 대응 체계가 있는가, 사용자가 트랜잭션 위험을 이해할 수 있는가.

Mempool 수락과 블록 포함 및 Finality

트랜잭션 상태를 정확히 이해하는 것도 중요합니다.

단계 의미
Submit 노드 또는 제출 경로로 트랜잭션 전달
Mempool Acceptance 해당 노드의 현재 상태 기준으로 대기열에 수용
Block Inclusion 블록에 포함
Confirmations 후속 블록이 쌓이는 과정
Finality Confidence 합의 및 운영 기준에 따라 되돌림 위험이 충분히 낮아졌다고 판단하는 수준

Mempool에 수용되었다고 해서 반드시 블록에 포함되는 것은 아니며, 블록에 포함되었다고 해서 즉시 모든 운영 환경에서 최종 확정으로 취급할 수 있는 것도 아닙니다. 서비스는 자신의 위험 수준에 맞는 확인 정책을 정의해야 합니다.

12 Production Readiness Checklist와 다음 단계

스마트 컨트랙트를 실제 서비스에 적용하기 전에는 다음 항목을 확인해야 합니다.

1. 설계

  • On-chain과 Off-chain 책임이 명확히 분리되어 있다.
  • Datum과 Redeemer 타입이 정의되어 있다.
  • 상태 전이와 불변 조건이 문서화되어 있다.
  • 권한과 관리자 변경 정책이 정의되어 있다.
  • UTxO 구조와 동시성 전략이 설계되어 있다.

2. 개발 및 테스트

  • Aiken 프로젝트와 의존성 버전이 고정되어 있다.
  • Validator 단위 테스트가 통과했다.
  • 실패 경로와 경계값 테스트가 수행되었다.
  • Property-based Testing이 수행되었다.
  • Off-chain 트랜잭션 통합 테스트가 통과했다.
  • 보안 취약점 검토가 수행되었다.

3. 빌드 및 배포 준비

  • aiken build 결과를 확인했다.
  • plutus.json Blueprint를 검토했다.
  • Script Hash와 주소를 검증했다.
  • 파라미터 적용 결과를 기록했다.
  • Reference Script 사용 여부를 결정했다.
  • 배포에 사용한 아티팩트를 보관했다.

4. 트랜잭션과 운영

  • UTxO Selection 및 상태 갱신 전략이 준비되어 있다.
  • Datum과 Redeemer 직렬화가 검증되었다.
  • ExUnits 및 수수료가 확인되었다.
  • Collateral 조건이 확인되었다.
  • 필요한 서명자 검증이 완료되었다.
  • 제출 및 블록 포함 확인 절차가 있다.
  • Stale UTxO 및 재시도 정책이 있다.
  • 장애 및 상태 마이그레이션 계획이 있다.

5. 출시

  • 로컬 테스트가 통과했다.
  • Devnet 통합 테스트가 통과했다.
  • Preprod 최종 리허설이 완료되었다.
  • 보안 및 운영 검토가 완료되었다.
  • 메인넷 배포 승인 절차가 마련되어 있다.

13 마무리: 스마트 컨트랙트는 하나의 시스템이다

AURA #48부터 #55까지 우리는 Aiken 스마트 컨트랙트 개발의 주요 구성 요소를 하나씩 살펴보았습니다.

  • 프로젝트 구조와 개발 환경 (Part 01)
  • Spending Validator (Part 02)
  • Datum, Redeemer, Transaction Context (Part 03)
  • 단위 테스트 (Part 04)
  • Aiken Build와 Plutus Blueprint (Part 05)
  • Validator와 Handler 및 Blueprint Title (Part 06)
  • CPU, Memory 및 Execution Units (Part 07)
  • Off-chain Transaction과 CBOR Serialization (Part 08)

이 모든 주제는 별개의 기술이 아닙니다. 각 요소는 하나의 프로토콜을 완성하기 위해 서로 연결됩니다.

Validator가 올바른 규칙을 강제하려면 데이터 구조가 정확해야 합니다. 데이터 구조가 정확하더라도 테스트가 부족하면 예외 상황을 놓칠 수 있습니다. 빌드가 성공하더라도 Off-chain 트랜잭션이 잘못 구성되면 제출할 수 없습니다. 트랜잭션이 제출되더라도 UTxO 경쟁과 운영 위험에 대응하지 못하면 안정적인 서비스를 만들기 어렵습니다.

따라서 스마트 컨트랙트 개발자의 목표는 단순히 Validator를 작성하는 것이 아닙니다. 명세부터 테스트, 빌드, 트랜잭션 구성, 실행 평가, 서명, 제출 및 운영 검증까지 일관된 시스템을 설계하는 것입니다.

이것이 Aiken 스마트 컨트랙트 개발의 전체 생명주기입니다.

다음 학습 경로

이 시리즈를 마친 독자는 다음 영역으로 학습을 확장할 수 있습니다.

  1. 복잡한 eUTxO 상태 구조와 확장성 설계
  2. DEX, Lending 및 Governance 프로토콜 아키텍처
  3. Reference Script와 상태 공유 설계
  4. 고급 보안 테스트와 감사 방법론
  5. Off-chain 서비스의 안정성 및 운영 자동화
  6. Cardano 확장성 기술과 Layer 2 생태계

Cardano 개발 생태계와 Ledger 규칙은 계속 발전합니다. 따라서 실제 프로젝트에서는 사용 중인 Aiken 버전, Ledger Era, Protocol Parameters 및 SDK 버전을 지속적으로 확인해야 합니다.

참고 자료 및 공식 문서

  1. Cardano Developer Portal — Smart Contracts:
    https://developers.cardano.org/docs/build/smart-contracts/overview/
  2. Aiken — Tests:
    https://aiken-lang.org/language-tour/tests
  3. Aiken — Benchmarks:
    https://aiken-lang.org/language-tour/bench
  4. CIP-0057 — Plutus Blueprint:
    https://cips.cardano.org/cip/CIP-57
  5. CIP-0032 — Inline Datums:
    https://cips.cardano.org/cip/CIP-32
  6. CIP-0033 — Reference Scripts:
    https://cips.cardano.org/cip/CIP-33
  7. Cardano Developer Portal — Extended UTxO Model:
    https://developers.cardano.org/docs/get-started/technical-concepts/eutxo/
  8. Cardano Developer Portal — Smart Contract Security:
    https://developers.cardano.org/docs/developers/curriculum/smart-contracts/security/
  9. Cardano Developer Portal — Local Testing:
    https://developers.cardano.org/docs/developers/curriculum/start-building/local-testing/
  10. Cardano Developer Portal — Going to Production:
    https://developers.cardano.org/docs/developers/curriculum/production/going-to-production/
  11. Cardano Developer Portal — Testnets and Devnets:
    https://developers.cardano.org/docs/get-started/testnets-and-devnets/
  12. Cardano Blueprint — Mempool:
    https://cardano-scaling.github.io/cardano-blueprint/mempool/