A
Aura Core Research SMART CONTRACT TUTORIALS
Home / Smart Contract Tutorials / aura-core-49-aiken-spending-validator
Cardano Smart Contract Development Series · Part 02 · AURA #49

첫 Spending Validator와 소유자 서명 조건: owner_lock.ak

Cardano의 eUTxO 모델에서 동작하는 기본 소유자 서명 잠금(owner_lock.ak)의 구조, Datum/Redeemer 정의, extra_signatories 기반 서명 확인 원리를 다루는 실전 개발자 가이드

PK
Paul Ko (Cardano Ambassador & DRep)
Published: 2026-11-03 · Series: Developer Tutorial
#Aiken #Cardano #SpendingValidator #owner_lock #eUTxO
기술적 범위 및 검증 상태 안내 본 글은 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
  }
}

이 코드는 다음 순서로 검증합니다.

  1. Datum이 존재하는지 확인합니다.
  2. Datum에서 owner 값을 추출합니다.
  3. Redeemer가 Unlock인지 확인합니다.
  4. 트랜잭션의 extra_signatories 목록에서 owner를 찾습니다.
  5. 소유자의 공개키 해시가 목록에 있으면 True를 반환합니다.
  6. 다른 스크립트 목적 등 지원하지 않는 실행 경로는 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 정리

이번 예제에서 기억할 핵심은 세 가지입니다.

  1. Spending Validator는 스크립트 주소에 잠긴 UTxO를 소비할 때 실행되는 검증 로직입니다.
  2. Datum은 소유자의 공개키 해시를 보관하고, Redeemer는 소비 요청의 데이터를 전달합니다.
  3. extra_signatories와 list.has()를 사용하면 트랜잭션의 서명 요구 목록에 소유자의 공개키 해시가 포함되어 있는지 확인할 수 있습니다.

다음 글에서는 Datum과 Redeemer가 실제 트랜잭션 컨텍스트에서 어떤 역할을 하는지 더 자세히 살펴봅니다.


기술적 범위 및 검증 상태 고지

본 글은 Aiken Spending Validator의 개념과 예제 코드를 설명하는 교육 자료입니다. 실제 컴파일, 자동 테스트, 테스트넷 배포 또는 운영 환경 검증이 완료되었다는 의미는 아닙니다.

이전 아티클 (AURA #48) Aiken 첫 프로젝트 만들기: 프로젝트 구조와 aiken.toml 이해하기
다음 아티클 (AURA #50) 다음 편 준비 중 (Datum, Redeemer와 트랜잭션 컨텍스트)