기술적 범위 및 검증 상태 안내 본 글은 Aiken Spending Validator의 기본 개념과 예제 코드를 설명하는 교육 자료입니다. 본 문서의 작성 과정에서 별도의 로컬 컴파일, 자동화 테스트 및 테스트넷 배포가 완료된 상태를 의미하는 것은 아닙니다.
1 이번 글에서 만들 것
이번 글에서는 Cardano의 eUTxO 모델에서 동작하는 가장 기본적인 소유자 서명 잠금(Owner Signature Lock)을 살펴봅니다.
목표는 단순합니다.
- UTxO를 잠글 때 소유자의 공개키 해시를 Datum에 기록합니다.
- 나중에 해당 UTxO를 소비할 때 Spending Validator가 실행됩니다.
- 트랜잭션에 등록된 서명자 목록에 소유자의 공개키 해시가 있는지 확인합니다.
- 조건이 충족되면 소비를 허용하고, 그렇지 않으면 거부합니다.
이 예제는 학습용 최소 구현입니다. 실제 자산을 보호하는 완성된 지갑 또는 상용 계약으로 간주해서는 안 됩니다.
2 Spending Validator의 역할
Cardano에서 스크립트 주소에 잠긴 UTxO를 소비하려면 해당 스크립트의 검증 조건을 통과해야 합니다.
Spending Validator는 소비하려는 출력에 연결된 스크립트가 실행되는 경우를 다룹니다. Aiken의 spend 핸들러는 다음 네 가지 입력을 받습니다.
| 인자 | 의미 |
|---|---|
datum |
잠금 당시 출력에 연결된 데이터. Option 형태 |
redeemer |
소비자가 검증 과정에 전달하는 데이터 |
_own_ref |
소비 대상 UTxO의 OutputReference |
self |
트랜잭션 실행 컨텍스트 |
여기서 중요한 점은 Datum이 항상 존재한다고 가정할 수 없다는 것입니다. 따라서 Aiken의 Spending Validator에서는 Datum이 Option<Datum>으로 전달됩니다.
이번 예제는 Datum이 존재하지 않으면 검증을 중단하도록 작성합니다.
3 프로젝트 구조
Aiken 프로젝트에서 Validator 파일은 일반적으로 validators/ 디렉터리에 배치합니다.
owner-lock/
├── aiken.toml
├── README.md
├── lib/
└── validators/
└── owner_lock.ak
이번 글에서는 owner_lock.ak의 핵심 검증 로직에 집중합니다.
4 Datum과 Redeemer 정의
먼저 소유자의 공개키 해시를 보관할 Datum과 소비 요청을 표현할 Redeemer를 정의합니다.
pub type Datum {
owner: VerificationKeyHash,
}
pub type Redeemer {
Unlock
}
Datum에는 owner라는 필드가 있습니다. 이 값은 소유자의 개인키나 원본 서명이 아니라 공개키 해시입니다.
Redeemer의 Unlock은 소비자가 검증 과정에서 전달하는 데이터의 한 형태입니다. 이 예제에서는 별도의 복잡한 명령이나 상태 전이를 표현하지 않습니다.
5 owner_lock.ak 작성
다음은 핵심 Spending Validator 예제입니다.
use aiken/collection/list
use aiken/crypto.{VerificationKeyHash}
use cardano/transaction.{OutputReference, Transaction}
pub type Datum {
owner: VerificationKeyHash,
}
pub type Redeemer {
Unlock
}
validator owner_lock {
spend(
datum: Option<Datum>,
redeemer: Redeemer,
_own_ref: OutputReference,
self: Transaction,
) {
expect Some(Datum { owner }) = datum
expect Unlock = redeemer
list.has(self.extra_signatories, owner)
}
else(_) {
fail
}
}
이 코드는 다음 순서로 검증합니다.
- Datum이 존재하는지 확인합니다.
- Datum에서
owner값을 추출합니다. - Redeemer가
Unlock인지 확인합니다. - 트랜잭션의
extra_signatories목록에서owner를 찾습니다. - 소유자의 공개키 해시가 목록에 있으면
True를 반환합니다. - 다른 스크립트 목적 등 지원하지 않는 실행 경로는
else핸들러에서 거부합니다.
6 extra_signatories는 무엇인가?
이 예제에서 가장 중요한 부분은 다음 코드입니다.
list.has(self.extra_signatories, owner)
extra_signatories는 해당 트랜잭션에서 서명이 요구되는 공개키 해시 목록입니다.
여기에는 실제 디지털 서명 원문이 직접 들어 있는 것이 아닙니다. 트랜잭션의 서명은 Cardano 원장이 검증하며, 원장은 extra_signatories 목록의 각 공개키 해시에 대응하는 유효한 서명이 트랜잭션 증인(Witness)에 존재하는지 확인합니다.
따라서 다음 두 개념을 구분해야 합니다.
- 공개키 해시 확인: Validator가
extra_signatories에서 소유자의 해시를 찾는 과정 - 실제 서명 검증: 원장이 해당 목록의 각 공개키 해시에 대응하는 유효 서명이 있는지 검증하는 과정
list.has()는 목록에 특정 값이 존재하는지 확인하는 함수입니다. 따라서 이 코드는 소유자의 공개키 해시가 트랜잭션의 서명 요구 목록에 포함되어 있는지 확인합니다.
7 검증 성공과 실패
| 상황 | 예상 결과 |
|---|---|
| Datum이 존재하고 소유자 해시가 서명자 목록에 있음 | Validator 조건 충족 (True 반환) |
| Datum이 없음 | expect 실패 (스크립트 검증 실패) |
Redeemer가 Unlock이 아님 |
expect 실패 (스크립트 검증 실패) |
| 소유자 해시가 서명자 목록에 없음 | False 반환 (스크립트 검증 실패) |
| 지원하지 않는 스크립트 목적 | else에서 거부 (스크립트 실행 실패) |
여기서 False 반환 및 expect 실패는 모두 스크립트 검증 실패에 해당합니다. 또한 Validator의 True는 스크립트 검증 조건이 충족되었다는 의미일 뿐, 트랜잭션 전체가 반드시 성공한다는 뜻은 아닙니다. 수수료, 입력·출력 균형, 유효성 구간, 다른 스크립트 등 원장의 나머지 검증도 통과해야 합니다.
8 이 예제의 한계
이 코드는 소유자 서명 조건을 이해하기 위한 최소 예제입니다. 실제 서비스에 적용하려면 추가적인 설계와 검증이 필요합니다.
특히 다음 사항을 주의해야 합니다.
- 소유자 해시를 어떤 방식으로 Datum에 설정하고 검증할지 결정해야 합니다.
- 자산을 스크립트 주소로 잠그는 과정과 소비 트랜잭션을 구성하는 오프체인 로직이 별도로 필요합니다.
- 단일 소유자 조건만으로는 다중 서명, 시간 제한, 비상 회수 등의 정책을 구현할 수 없습니다.
- 스크립트가 허용하는 조건과 실제 트랜잭션의 전체 유효성은 구분해야 합니다.
- 실제 자산을 투입하기 전에 정상·실패 사례를 포함한 테스트와 독립적인 검토가 필요합니다.
9 정리
이번 예제에서 기억할 핵심은 세 가지입니다.
- Spending Validator는 스크립트 주소에 잠긴 UTxO를 소비할 때 실행되는 검증 로직입니다.
- Datum은 소유자의 공개키 해시를 보관하고, Redeemer는 소비 요청의 데이터를 전달합니다.
extra_signatories와list.has()를 사용하면 트랜잭션의 서명 요구 목록에 소유자의 공개키 해시가 포함되어 있는지 확인할 수 있습니다.
다음 글에서는 Datum과 Redeemer가 실제 트랜잭션 컨텍스트에서 어떤 역할을 하는지 더 자세히 살펴봅니다.
본 글은 Aiken Spending Validator의 개념과 예제 코드를 설명하는 교육 자료입니다. 실제 컴파일, 자동 테스트, 테스트넷 배포 또는 운영 환경 검증이 완료되었다는 의미는 아닙니다.