제6부. Daml 설계 패턴 — 원장 위에 시장을 조립하는 법
단독 서명이 가능한 가장 작은 합의에서 수탁 결제·토큰화 증권까지: 다섯 가지 기본 패턴과 여덟 가지 시장 조합
"각 패턴은 우리 환경에서 거듭 나타나는 문제를 서술하고, 그다음 그 해법의 핵심을 서술한다. 그래서 그 해법을 백만 번 쓰면서도 한 번도 똑같이 하지 않을 수 있다." — 크리스토퍼 알렉산더, 사라 이시카와, 머레이 실버스타인, 『패턴 랭귀지(A Pattern Language)』, 옥스퍼드 대학교 출판부, 1977
1. 원장의 동작 원리에서 계약 설계로
제1부부터 제5부까지는 원장이 어떻게 동작하는지를 다루었습니다. 분절된 기관별 장부가 왜 Canton의 가상 공유 원장(Virtual Shared Ledger)으로 모이는지, 권한 검증 규칙(Authorization Rules)과 블라인드 머클 트리(Blinded Merkle Tree)가 무엇을 보장하는지, 병렬 인덱서와 동기화기(Synchronizer)가 어떤 제약 아래에서 동작하는지를 차례로 살폈습니다.
그 지식만으로는 빈 .daml 파일 앞에서 답이 바로 나오지 않습니다. 장외 채권 협상 화면, 수탁은행의 다단계 승인 결재선, 토큰화 증권의 배당 기준일 처리를 코드로 옮기려면 먼저 정해야 할 것이 있습니다. 템플릿을 몇 개로 나눌지, 각 템플릿의 서명자(signatory)를 누구로 둘지, 어떤 초이스가 계약을 소비할지입니다.
제6부는 이 질문에 답하는 설계 패턴 모음입니다. 앞선 부가 "이 원장과 권한 규칙이 왜 이렇게 생겼는가"를 설명했다면, 제6부는 "그 규칙 위에서 실제 금융 계약을 어떤 단위로 나누고 어떤 순서로 조립하는가"를 다룹니다. 식당 계산서를 나누는 동료 사이의 정산, 온라인 마켓의 가격 흥정, 런던과 뉴욕 수탁은행 사이의 국채 대 예금 토큰 결제 지시는 모두 같은 구조를 공유합니다. 제6부의 모든 패턴은 머리말의 기준 버전에서 dpm test로 바로 실행할 수 있습니다.
삽화 구성 및 생성 프롬프트 보기 열기 / 닫기
2. 다섯 가지 기본 패턴과 하나의 원칙: "지금 단독으로 서명할 수 있는 가장 작은 합의"
Daml을 처음 쓰는 개발자가 가장 자주 부딪히는 오류는 실제 거래 하나를 템플릿 하나에 담으려는 데서 나옵니다. 매수인, 매도인, 수탁은행, 준법감시인 네 주체를 모두 signatory에 적고 계약을 생성하면, 원장은 DAML_AUTHORIZATION_ERROR("requires authorizers …, but only … were given")로 명령을 거부합니다. 계약 생성은 모든 서명자가 그 트랜잭션의 권한 부여자(authorizer)에 포함될 것을 요구하는데, 한 명령의 권한은 그 명령을 제출한 당사자(actAs)의 것뿐이기 때문입니다. 서로 다른 참가자 노드에 호스팅된 네 기관이 한 명령을 함께 제출할 방법은 없습니다.
그래서 제6부 전체를 관통하는 원칙은 한 문장입니다. "모든 거래를, 지금 한 주체가 단독으로 서명해 원장에 올릴 수 있는 가장 작은 합의 단위로 나눈다." Daml 생태계에서 정립된 다섯 가지 기본 패턴(Canonical Design Patterns)은 이 원칙을 적용하는 다섯 가지 방법입니다.
- 제안-수락(Propose-Accept): 상대방의 서명을 대신 받을 수는 없으므로, 내가 먼저 서명한 제안(Proposal) 계약을 올리고 상대방이 수락(Accept)·역제안(Counter)·거절(Reject) 초이스를 행사하게 합니다. 수락 초이스 안에서는 제안자의 서명과 수락자의 행사 권한이 합쳐져 양자 서명 계약을 생성할 수 있습니다.
- 다자 합의(Multiple Party Agreement): 대주단 은행 다섯 곳이나 공동 금고 관리자 세 명이 순서와 무관하게 각자 서명을 보태고, 약정된 전원 일치나 정족수(Quorum)가 채워졌을 때만 본계약을 생성합니다.
- 위임(Delegation): 권리자가 대리인(자산운용사, 자동 정산 프로세스, 수탁 대리인)에게 특정 초이스만, 정해진 한도와 기한 안에서 대신 행사하도록 허락하는 계약입니다.
- 인가(Authorization): 거래 당사자 둘이 합의했더라도, 제3의 심사 주체(고객확인(Know Your Customer, KYC) 담당 부서, 적격투자자 심사, 준법감시)가 발급한 유효한 자격 계약이 원장에 있어야만 체결을 허용합니다.
- 잠금(Locking / Escrow): 동시 결제나 담보 설정이 진행되는 동안 기초자산을 잠금 계약으로 묶어(Encumbrance), 정산 도중의 이중 처분을 막습니다.
여기에 원장 시각(Ledger Time, getTime)으로 기한을 판정하는 규칙과, 서로 다른 발행자의 자산을 같은 방식으로 다루게 하는 인터페이스(Interface) 및 스마트 계약 업그레이드(Smart Contract Upgrade, SCU) 규칙을 더하면, 자본시장의 주요 계약 대부분을 이 다섯 패턴의 조합으로 표현할 수 있습니다.
3. 시장 업무는 패턴의 조합이다 — 여덟 가지 조합
실제 시장 업무는 패턴 하나로 끝나지 않습니다. 아래 표는 제6부에서 구현할 여덟 가지 조합과, 각 조합이 다루는 업무 문제를 정리한 것입니다.
| 업무 문제 | 시장 업무 명칭 | 조합되는 Daml 패턴 | 다루는 장 |
|---|---|---|---|
| 증권과 대금, 또는 두 통화가 한쪽만 이동하는 상태를 없애야 한다 | 증권 대금 동시 결제(Delivery versus Payment, DvP) 및 외환 동시 결제(Payment versus Payment, PvP) | Propose-Accept + Locking + 자산 인터페이스 |
제31장 · 제33장 |
| 수취인이 응답하지 않아도 송금인의 자산이 묶이거나 사라지지 않아야 한다 | 2단계 자산 이전(Two-Step Transfer) 및 사전 수취 승인(Transfer Preapproval) | Propose-Accept + Delegation + 기한(Time) |
제28장 · 제30장 · 제31장 |
| 보유분을 나누고 합쳐도 총량이 변하지 않아야 한다 | 대체가능 보유분(Fungible Holding)의 분할·병합(Split & Merge)과 수량 보존 | 불변식(ensure) + 소비형 상태 전이 + 인터페이스 뷰 |
제32장 |
| 종목 정의, 계좌, 잔고의 책임 주체가 서로 다르다 | 종목(Instrument) · 계좌(Account) · 보유분(Holding) 3계층 분리 |
역할(Role) 계약 + Authorization + InstrumentKey |
제30장 · 제32장 |
| 여러 당사자의 결제 다리를 한꺼번에 확정해야 한다 | 결제 지시(Settlement Instruction) · 자산 할당(Allocation) · 다자 일괄 결제(Batch Settlement) | Multiple Party + Locking + 원자적 결제 체인 |
제31장 · 제33장 |
| 기준일 보유자에게 배당을 지급하고 분할 후 종목으로 교체해야 한다 | 배당(Dividend) · 액면분할(Stock Split) · 조기상환(Call) 등 기업행위(Corporate Actions) | nonconsuming 기준일 조회 + InstrumentKey 버전 교체 |
제34장 |
| 기본계약은 한 번 맺고 개별 거래는 매일 확인해야 한다 | 국제스왑파생상품협회(International Swaps and Derivatives Association, ISDA) 기본계약과 경개(Novation) | 장기 Master Agreement + Authorization + 다자 서명 교체 |
제28장 · 제29장 · 제34장 |
| 가격·금리 조건과 기한에 따라 권리가 갈라진다 | 옵션(Option) · 선도(Forward) · 담보(Collateral)와 토큰화 증권의 수익 정산 | 사전 동의(Pre-agreement) + 시간 창 + 담보 Locking |
제31장 · 제34장 |
삽화 구성 및 생성 프롬프트 보기 열기 / 닫기
4. 패턴 서술 형식과 독서 경로 E
제6부의 각 패턴은 같은 순서로 서술합니다. 어느 장을 펼쳐도 같은 위치에서 같은 정보를 찾을 수 있게 하기 위해서입니다.
- 문제: 패턴이 해결하는 기관 업무 문제를 한 문단으로 정의합니다.
- 당사자와 권한:
signatory·observer·controller를 표로 정리하고, 제27장의 네 가지 모델링 질문에 답합니다. - 계약 설계: 템플릿과 초이스, 각 초이스의 소비 여부(
consuming/nonconsuming),ensure불변식을 정합니다. - 코드:
dpm build·dpm test로 빌드·실행하도록 작성한 Daml 코드와 Daml Script 테스트(submit/submitMustFail)를 제시합니다. 폐기 예정인DA.Exception은 쓰지 않습니다. TypeScript 대조 코드는 비교로 배울 것이 있을 때만 넣습니다. - 상태 전이: 초이스 실행 전후의 활성 계약 집합(Active Contract Set, ACS)을 비교하고, 하위 동작의 필요 권한이 \(\mathrm{ReqAuth} \subseteq \mathrm{Sig} \cup \mathrm{Ctrl}\)을 만족하는지 검산합니다.
- 실패 양상: 동시 행사 경합, 만기 후 남는 계약, 응답 없는 당사자로 인한 교착, 관찰자 지정으로 인한 정보 노출을 점검합니다.
- 변형과 조합: 같은 문제의 다른 해법과, 다른 패턴과의 연결을 정리합니다.
- 규제 대응(해당 시): 금융시장인프라 원칙(PFMI), EU 결제완결성 지침(Settlement Finality Directive) 같은 국제 규범이나 계약법의 일반 원리와 코드의 대응 관계를 짚습니다.
제6부부터 읽는 독자를 위한 경로 E — Daml 설계 패턴 트랙: Daml 계약을 설계하는 데 앞선 부의 분산 합의 수식과 데이터베이스 튜닝이 모두 필요하지는 않습니다. 모델링 작업에 바로 투입된 독자라면 제6장(계약 대수 기초) → 제10장(인터페이스와 실행 의미론) → 제6부 시작글(현재 페이지) → 제27장~제34장 순서로 읽으십시오. 배경이 필요할 때 참고할 장은 다음과 같습니다. 동시 결제와 결제 완결성의 역사는 제2장(헤르슈타트 리스크), 거래 조건을 당사자별로 가리는 원리는 제11장(블라인드 머클 뷰), 네트워크 수수료 구조는 제22장(아뮬렛 토크노믹스), 토큰화 수익권과 캡테이블 정합성은 제23장에서 다룹니다.
제6부 장별 구성(제27장 ~ 제34장)
-
제27장 · 패턴 설계의 기준선: 네 가지 질문, 실패 처리, 원장 시간:
daml.yaml과dpm프로젝트 구성, 템플릿을 쓰기 전에 답할 네 가지 모델링 질문,ensure·failWithStatus·거절 초이스의 역할 분담, 반열린 시간 창([openFrom, expiresAt))과 스마트 계약 업그레이드(SCU) 호환 규칙을 정합니다. -
제28장 · 제안과 수락: 역제안, 만기 청약, 역할 계약, 일방 채무: 장외 호가의 역제안 루프(
CounterOffer), 기한이 지나면 수락할 수 없는 청약, 장기 역할 계약에서 발급하는 회원 초대, 원치 않는 입고를 막는 2단계 일방 채무(IOU) 이전을 구현합니다. - 제29장 · 다자 합의와 정족수: 순서 없는 서명, 거부, M-of-N 결의: 세 명 이상의 서명을 순서와 무관하게 모으는 수집 계약, 한 당사자의 거절과 기한 만료 처리, 인원수·지분 가중 정족수 결의와 대규모 투표의 개별 투표지 분리를 다룹니다.
-
제30장 · 인가와 위임: 자격 증명, 일회용 허가, 수탁 위임: KYC·적격투자자 자격을 검사하는 인가(
Authorization) 패턴과, 한도와 유효기간 안에서만 초이스 행사를 허락하는 위임(Delegation) 패턴을 결합합니다. -
제31장 · 잠금과 에스크로: 자산 동결, 조건부 지급, 비동기 이전, 보호예수: 결제나 조건 성취 전까지 자산을 잠금 계약으로 묶어 이중 처분을 막는 잠금(
Locking)과, 기한이 지난 뒤 소유자가 스스로 회수하는 에스크로 해제를 다룹니다. -
제32장 · 보유분과 계좌: Holding 인터페이스, 분할·병합, 3계층 분리: 공통
InstrumentKey위에서 종목(Instrument)·계좌(Account)·보유분(Holding)을 분리하고, 인터페이스 기반 분할·병합에서 수량 보존을 검증합니다. -
제33장 · 원자적 교환: DvP, PvP, 다자 일괄 정산: 증권과 대금이 한 트랜잭션에서 함께 이동하는 동시 결제(DvP·PvP)와, 결제 지시·자산 할당·다자 일괄 정산(
Batch Settlement)을 조립합니다. - 제34장 · 계약 생애주기: 기본계약, 담보, 기업행위, 노베이션, 토큰화 증권: ISDA 기본계약과 거래 확인서, 담보 관리와 실행, 기업행위, 당사자 교체 경개(Novation), 토큰화 수익권 정산까지 앞 장의 패턴을 조합합니다.