제27장. 패턴 설계의 기준선: 네 가지 질문, 실패 처리, 원장 시간

누가 지금 서명하고, 누가 다음에 행사하며, 무엇이 소비되고 생성되는가 — 프로젝트 구성과 모델링 점검표

핵심 키워드: Project Setup · dpm · 4-Question Checklist · failWithStatus vs Choice · Ledger Time & SCU
"순서도를 보여 주고 표를 감춘다면 나는 계속 어리둥절할 것이다. 표를 보여 준다면 대개 순서도는 필요 없다. 순서도는 뻔히 보일 테니까." — 프레드릭 P. 브룩스 주니어, 『맨먼스 미신(The Mythical Man-Month)』 제9장, 애디슨-웨슬리, 1975

이 장은 제28~34장의 모든 패턴이 공유하는 기준선을 정합니다. 프로젝트 구성, 템플릿을 쓰기 전에 답해야 할 네 가지 질문, 실패와 비즈니스 거절의 구분, 원장 시간과 업그레이드 호환 규칙입니다. 서명과 초이스의 기본 의미는 제6장에서, 권한 검증 규칙(Authorization Rules)과 실행 의미론은 제10장에서 다루었으므로 여기서는 반복하지 않고, 이후 장의 코드가 그대로 가져다 쓸 규칙만 고정합니다.

1. 패턴 27.1 · 프로젝트 구성: daml.yaml, dpm, Daml Script

문제: 패턴 코드를 여러 팀이 나누어 작성하면 빌드 도구, 수치 타입, 종목 식별 방식, 테스트 관례가 제각각이 되기 쉽습니다. 제6부의 모든 예제가 같은 프로젝트에서 빌드되고, 같은 방식으로 권한을 검증하도록 기준을 먼저 정합니다.

Daml 2 시절의 튜토리얼에 익숙한 개발자가 먼저 마주치는 변화는 명령줄 도구입니다. Daml 3 계열(기준 버전은 머리말 참조)은 기존 daml 어시스턴트 대신 패키지 매니저 dpm을 씁니다. DAR(Daml Archive) 컴파일은 dpm build, Daml Script 테스트 실행은 dpm test, 로컬 Canton 샌드박스 기동은 dpm sandbox, TypeScript 바인딩 생성은 dpm codegen-js입니다.

금액과 수량에는 부동소수점(number, Double)을 쓰지 않습니다. 0.1 + 0.2가 0.30000000000000004가 되는 오차는 결제 원장의 대사(reconciliation)를 깨뜨립니다. 모든 수량과 금액은 유효숫자 38자리 중 소수점 아래 10자리를 고정하는 Numeric 10(별칭 Decimal)으로 통일합니다. 또 제32~34장의 계좌·결제·생애주기 패턴이 함께 쓸 종목 식별자 InstrumentKey를 여기서 정의합니다.

구성 요소 / 당사자 Daml 구성 역할
빌드 및 검증 도구 dpm build · dpm test · dpm codegen-js Daml-LF 패키지 컴파일과 Script 시나리오 실행
공통 종목 식별자 (InstrumentKey) issuer : Party, symbol : Text, version : Text 발행 주체·종목 코드·기업행위 버전을 묶는 제6부 공용 식별자
발행인 (issuer) Voucher의 signatory 바우처 채무를 지는 발행자 (자기 서명만으로 발행 가능)
소지인과 무권한자 (holder / intruder) submit holder 통과 / submitMustFail intruder 기각 정상 경로와 함께 무권한자의 행사 실패도 테스트로 고정
daml.yaml — 프로젝트 매니페스트와 dpm 명령 YAML
# 주요 명령:
#   dpm build        -> .daml/dist/canton-patterns-0.1.0.dar 생성
#   dpm test         -> 모든 Daml Script 테스트 실행
#   dpm sandbox      -> 로컬 Canton 샌드박스 원장 기동
#   dpm codegen-js   -> TypeScript 클라이언트 바인딩 생성

sdk-version: 3.7.2  # 본서 기준 버전 — 머리말 참조
name: canton-patterns
source: daml
version: 0.1.0
dependencies:
  - daml-prim
  - daml-stdlib
  - daml-script
build-options:
  - --target=2.1  # 본서 기준 버전 — 머리말 참조

# 배포용 DAR에서는 daml-script 의존성을 빼고,
# 테스트는 이 패키지를 참조하는 별도 test/daml.yaml 패키지로 분리한다.
Common.daml — 공통 InstrumentKey와 정상·실패 경로 검증 Daml
module Patterns.Common where

import Daml.Script

-- 제27~34장이 공유하는 종목 식별자
data InstrumentKey = InstrumentKey
  with
    issuer  : Party
    symbol  : Text
    version : Text
  deriving (Eq, Show, Ord)

template Voucher
  with
    instrument : InstrumentKey
    holder     : Party
    quantity   : Numeric 10
  where
    signatory instrument.issuer
    observer  holder
    ensure    quantity > 0.0 && instrument.symbol /= ""

    -- Daml 3 초이스 구문: 이름, 반환 타입, (with 인자), controller, do 순서
    choice RedeemVoucher : ()
      controller holder
      do
        return ()

testWorkbench : Script ()
testWorkbench = script do
  issuer   <- allocateParty "Issuer"
  holder   <- allocateParty "AliceHolder"
  intruder <- allocateParty "MalloryIntruder"

  let usdVoucher = InstrumentKey with
        issuer; symbol = "VOUCHER-USD"; version = "v1"

  voucherCid <- submit issuer do
    createCmd Voucher with
      instrument = usdVoucher; holder; quantity = 15.0

  -- 1. 실패 경로: 무권한자의 행사는 거부되어야 한다 (계약을 볼 수 없으므로 실패)
  submitMustFail intruder do
    exerciseCmd voucherCid RedeemVoucher

  -- 2. 정상 경로: 소지인이 행사하면 바우처가 소비된다
  submit holder do
    exerciseCmd voucherCid RedeemVoucher

  -- 3. 실패 경로: 이미 소비된 바우처는 다시 행사할 수 없다
  submitMustFail holder do
    exerciseCmd voucherCid RedeemVoucher

submit만으로는 테스트가 절반이다. 정상 경로 테스트는 "권한 있는 당사자가 행사하면 성공한다"만 확인합니다. 원장 모델에서 더 중요한 성질은 반대쪽입니다. 권한 없는 제3자가 행사할 때, 수량이 0일 때, 이미 소비된 계약을 다시 행사할 때 원장이 거부한다는 것을 submitMustFail로 고정해 두어야 권한 모델이 회귀하지 않습니다. 제6부의 모든 스크립트는 정상 경로와 실패 경로를 쌍으로 둡니다.

네 칸으로 구획된 나무 판 위에 인장, 작은 열쇠, 파쇄 투입구, 빈 접시가 놓이고 옆에 정밀 저울과 모래시계가 있는 추상 스팟 일러스트
[FIG 27.1] 네 가지 모델링 질문: 템플릿을 쓰기 전에 서명자(인장), 행사자(열쇠), 소비되는 계약(파쇄 투입구), 생성되는 계약(빈 접시)을 먼저 정해 두면, 복잡한 거래도 권한 오류 없이 나눌 수 있다.
삽화 구성 및 생성 프롬프트 보기 열기 / 닫기
연출 의도: 정갈하게 구획된 사분면 작업판 위에 서명 스탬프, 열쇠, 파쇄 슬롯, 새 접시, 그리고 정밀 천칭 저울이 질서 정연하게 놓인 작업대를 솔 스타인버그 풍 펜화로 묘사.
Sparse 1960s-1970s American editorial spot cartoon on aged warm off-white cream newsprint paper. Top-down angled view of a crisp rectangular wooden chef cutting board neatly divided into four geometric quadrants in wide empty paper space: holding a round wax stamp, a small brass key, a neat paper shredder slot, and a clean serving plate, flanked by a precision balance scale and an hourglass. Saul Steinberg and Bell Labs technical manual doodle style, raw slightly wobbly dip-pen black ink lines, coarse off-register gray Zip-A-Tone halftone dots, 75% empty paper negative space, flat 2D print aesthetic, no 3D shading, strictly zero text, zero letters, zero words, and zero numbers anywhere in the image. --ar 16:9

2. 패턴 27.2 · 모델링 네 가지 질문과 ensure · assertMsg · failWithStatus의 역할 분담

문제: 요구사항 문서에서 바로 템플릿을 작성하면, 권한 오류는 테스트를 돌린 뒤에야 드러납니다. 또 입력 오류, 상태 불일치, 상대방의 정상적인 거절을 모두 같은 방식(예외)으로 처리하면, 거절된 제안이 원장에서 치워지지 않는 문제가 생깁니다.

template을 쓰기 전에 아래 모델링 네 가지 질문의 빈칸을 먼저 채웁니다. 네 칸이 채워지면 서명자 구성과 초이스의 소비 여부가 정해지고, 권한 오류의 대부분은 코드를 쓰기 전에 드러납니다.

순번 모델링 네 가지 질문 대응 Daml 구문 자주 빠지는 함정과 검산 기준
질문 1 누가 지금 서명하는가? signatory 이 계약으로 의무를 지는 주체인가? 생성 트랜잭션의 권한 부여자(제출자, 또는 상위 계약의 서명자와 행사자)만으로 모두 충족되는가?
질문 2 누가 다음에 행사하는가? controller & observer controller가 서명자가 아니라면 observer로 지정하거나 명시적 공개(explicit disclosure)로 계약을 전달해야 한다. 계약을 볼 수 없는 당사자는 초이스를 행사할 수 없다.
질문 3 무엇이 소비되는가? 기본 consuming vs nonconsuming 한 번 행사하면 소멸해야 하는 일회용 권리(consuming)인가, 반복해서 행사하는 장기 역할 계약(nonconsuming)인가?
질문 4 무엇이 생성되는가? do 블록 안의 create / 하위 exercise 새로 태어나는 계약의 signatory들이 기존 계약의 signatory와 현재 controller 합집합 안에 다 있는가?

질문 3과 질문 4는 엔진의 권한 검사 규칙과 직접 대응합니다. 초이스 본문 안에서 쓸 수 있는 권한은 그 계약의 서명자와 초이스 행사자(actor)의 합집합이고, 본문의 각 하위 동작이 요구하는 권한은 이 합집합에 포함되어야 합니다. 계약 생성이라면 새 계약의 서명자 전원이, 하위 초이스 행사라면 그 초이스의 행사자 전원이 이 합집합 안에 있어야 합니다. 어긋나면 엔진은 DAML_AUTHORIZATION_ERROR("requires authorizers …, but only … were given")로 트랜잭션을 거부합니다.

ReqAuth(e) ⊆ Sig(c) ∪ Ctrl(e)

권한 조건을 통과한 초이스 실행 하나가 활성 계약 집합(Active Contract Set, ACS)을 바꿀 때, 소비된 계약과 생성된 계약 사이의 관계는 다음과 같다.

ACS' = (ACS \ C_cons) ∪ C_new, |ACS'| = |ACS| - |C_cons| + |C_new|

수치 예시: 원장에 활성 계약이 \(|\mathrm{ACS}| = 10\)건 있다고 하자. 발행자 \(P_{\mathrm{iss}}\)와 수탁은행 \(P_{\mathrm{cus}}\)가 공동 서명한 배정 계약 \(c_1\)(\(\mathrm{Sig}(c_1) = \{P_{\mathrm{iss}}, P_{\mathrm{cus}}\}\))에서 투자자 \(P_{\mathrm{inv}}\)가 결제 초이스 \(e\)를 행사하면(\(\mathrm{Ctrl}(e) = \{P_{\mathrm{inv}}\}\)), 본문에서 쓸 수 있는 권한은 \(\{P_{\mathrm{iss}}, P_{\mathrm{cus}}, P_{\mathrm{inv}}\}\)다.

본문이 세 당사자 모두를 서명자로 하는 결제 확인서를 생성한다면 \(\mathrm{ReqAuth} = \{P_{\mathrm{iss}}, P_{\mathrm{cus}}, P_{\mathrm{inv}}\} \subseteq \{P_{\mathrm{iss}}, P_{\mathrm{cus}}, P_{\mathrm{inv}}\}\)이므로 통과한다.

같은 초이스가 배정 계약과 대금 계약 \(|C_{\mathrm{cons}}| = 2\)건을 소비하고 증권 보유분·잔액 계약·확인서 \(|C_{\mathrm{new}}| = 3\)건을 생성하면, 실행 직후 \(|\mathrm{ACS}'| = 10 - 2 + 3 = 11\)건이다. 트랜잭션은 원자적이므로 일부만 반영된 중간 상태는 다른 당사자에게 관찰되지 않는다.

INVARIANT 27.1 · 초이스 권한 포함 조건과 활성 계약 집합(ACS) 전이식

예외 대신 세 가지 실패 경로를 나누는 이유

TypeScript나 Java 백엔드에서는 값이 음수이든, 잔액이 부족하든, 고객이 주문을 거절하든 throw new Error(...)로 처리하고 상위에서 try/catch로 잡는 습관이 흔합니다. Daml 3에서는 이 방식을 쓰지 않습니다. Daml 예외(DA.Exception의 throw/try-catch)는 폐기 예정(deprecated)이며, Canton 릴리스 노트는 failWithStatus로 옮겨 가라고 안내합니다. 잡히지 않은 오류는 Ledger API에서 DAML_FAILURE 오류로 보고되고, failWithStatus로 발생시킨 오류는 사용자가 정한 error_id를 오류 메타데이터에 싣습니다. failWithStatus는 Daml 코드 안에서 잡을 수 없으므로 트랜잭션 전체가 중단됩니다.

이 점이 설계에 주는 함의는 분명합니다. 오류로 중단된 트랜잭션은 원장에 아무것도 남기지 않습니다. 따라서 "실패"와 "정상적인 거절"을 같은 수단으로 표현하면 안 됩니다. Daml 3 코드는 실패와 거절을 다음 세 경로로 나눕니다.

  • 1. 템플릿 불변식(ensure): 원장에 존재해서는 안 되는 상태(예: amount <= 0.0, 만기일이 발행일보다 빠른 계약)를 막습니다. 위반하면 어떤 경로로 생성하든 TEMPLATE_PRECONDITION_VIOLATED로 거부됩니다. 업그레이드된 패키지에서 기존 계약을 읽을 때도 새 코드의 ensure가 다시 평가됩니다(패턴 27.3).
  • 2. 초이스 입력·상태 검증(assertMsg, failWithStatus): 호출자가 잘못된 인자를 넣었거나 원장 시각·상태가 조건에 맞지 않으면 트랜잭션 전체를 중단합니다. 클라이언트가 재시도 여부를 기계적으로 판단해야 하는 API 경계에서는 문자열 단언 대신 failWithStatus로 오류 식별자(errorId)와 범주(FailureCategory)를 함께 보냅니다.
  • 3. 비즈니스 거절·철회 초이스(Reject, Withdraw): 상대방이 제안을 거절해 원장에서 제안을 치워야 할 때는 오류를 발생시키지 않고, 소비형 초이스를 정상 완료시킵니다.
안티패턴 — 예외 던지기와 비즈니스 상태 전이를 뒤섞은 혼란 TypeScript
// 흔한 백엔드 습관: 거절도 예외로 던지고, 상위에서 catch로 수습
async function handleBondQuote(quoteId: string, accept: boolean, qty: number) {
  const quote = await db.quotes.findUnique({ id: quoteId });
  if (!accept) {
    // Daml 초이스 안에서 같은 방식으로 실패를 발생시키면
    // 트랜잭션 전체가 중단되어 제안 계약이 소비되지 않고
    // 활성 계약 집합에 그대로 남는다.
    throw new Error("QUOTE_REJECTED_BY_CLIENT");
  }
  if (qty <= 0) throw new Error("bad qty"); // 비정형 문자열 에러
  await db.quotes.update({ id: quoteId, status: "FILLED" });
}
Guards.daml — ensure · failWithStatus · 명시적 Reject 분리 Daml
module Patterns.Guards where

import DA.Fail (FailureCategory(..), FailureStatus(..), failWithStatus)
import qualified DA.TextMap as TextMap
import Patterns.Common (InstrumentKey(..))

-- 클라이언트가 Ledger API 오류 메타데이터로 판독할 수 있는 실패 헬퍼
abortInvalidArg : Text -> Text -> Update a
abortInvalidArg code msg = failWithStatus FailureStatus
  with
    errorId  = code
    category = InvalidIndependentOfSystemState
    message  = msg
    meta     = TextMap.empty

template BondOrderRequest
  with
    dealer     : Party
    investor   : Party
    instrument : InstrumentKey
    maxPrice   : Numeric 10
  where
    signatory investor
    observer  dealer
    -- [경로 1] 불변식: 0 이하의 가격 한도로는 생성할 수 없다
    ensure maxPrice > 0.0

    choice FillOrder : Numeric 10
      with
        executionPrice : Numeric 10
      controller dealer
      do
        -- [경로 2] 조건 위반 시 구조화된 오류와 함께 트랜잭션 전체 중단
        if executionPrice <= 0.0 || executionPrice > maxPrice
          then abortInvalidArg "EXECUTION_PRICE_OUT_OF_BOUNDS"
                 "Execution price must be positive and within investor maxPrice."
          else return executionPrice

    -- [경로 3] 비즈니스 거절: 오류가 아니라 정상 완료로 계약을 소비하고 사유를 반환
    choice RejectOrder : Text
      with
        reason : Text
      controller dealer
      do
        assertMsg "Rejection reason required" (reason /= "")
        return reason
나란히 선 세 개의 아치형 검문소에서 첫째는 저울로 불량 블록을 막고 둘째는 소포를 튕겨 돌려보내며 셋째는 거절된 전표를 수거함에 넣는 스팟 일러스트
[FIG 27.2] 세 가지 실패 경로의 분업: 원장에 존재해서는 안 되는 상태를 막는 ensure, 조건에 맞지 않는 호출을 트랜잭션째 중단시키는 failWithStatus, 거절된 제안을 정상 완료로 소비해 치우는 Reject 초이스는 서로의 역할을 대신하지 않는다.
삽화 구성 및 생성 프롬프트 보기 열기 / 닫기
연출 의도: 세 개의 나란한 아치형 검문소를 통해 (1) 입구 저울 검열(ensure), (2) 규격 외 주문 즉시 반송 게이트(DA.Fail), (3) 도장 찍어 파쇄함으로 깔끔히 수거하는 정식 거절 창구(Reject choice)의 차이를 직관적 스팟 만화로 대비.
Sparse 1960s-1970s American editorial spot cartoon on aged warm off-white cream newsprint paper. Three neat minimalist archway checkpoints standing side by side in open empty paper space: at the first arch a tiny inspector blocks a crooked block with a strict balance scale; at the second arch a spring-loaded bumper bounces an oversized parcel cleanly backward; at the third arch a polite clerk drops a rejected slip neatly into a tidy disposal basket so nothing lingers. Saul Steinberg and Bell Labs manual doodle style, raw dip-pen black ink lines, coarse off-register gray Zip-A-Tone halftone dots, 75% empty paper negative space, flat 2D retro print feel, no 3D shading, strictly zero text, zero letters, zero words, and zero numbers anywhere in the image. --ar 16:9

딜러가 거절을 표시하려고 RejectOrder 초이스 안에서 failWithStatus를 호출하면 원장에서 무슨 일이 일어납니까?

결과

assertMsg나 failWithStatus가 실행되면 트랜잭션 전체가 중단되고 원장에는 아무것도 기록되지 않습니다. BondOrderRequest를 소비하려던 동작도 함께 취소되므로 주문 계약은 활성 계약 집합(ACS)에 그대로 남습니다. 딜러가 거절을 몇 번 시도해도 주문은 사라지지 않습니다.

원칙

생성이나 행사의 조건이 맞지 않을 때는 failWithStatus로 트랜잭션을 막습니다. 이미 원장에 있는 제안을 거절·취소·만료시켜 원장에서 치워야 할 때는 consuming 초이스가 오류 없이 끝까지 실행되도록 작성해야 계약이 소비됩니다.

3. 패턴 27.3 · 원장 시간(getTime)의 반열린 구간 판정과 SCU 호환 필드 규칙

문제: 청약 마감, 호가 유효기간, 결제 창은 경계 시각에서 판정이 갈립니다. 마감 정각에 제출된 주문이 마감 전인지 후인지 모든 참가자가 같은 답을 내야 하고, 서로 맞닿은 두 창 사이에 중복이나 공백이 없어야 합니다. 또 수년간 운영되는 원장에서는 템플릿을 고쳐 배포한 뒤에도 이미 생성된 계약을 그대로 행사할 수 있어야 합니다.

모든 참가자 노드는 같은 트랜잭션에 대해 같은 결과를 내야 하므로, Daml 초이스 안에는 서버의 로컬 시계를 읽는 함수가 없습니다. 초이스가 읽을 수 있는 시각은 원장 시각(getTime : Update Time)뿐입니다. 원장 시각은 제출하는 참가자가 정하되, 트랜잭션이 사용하는 계약들의 원장 시각보다 작아지지 않도록 올려 잡습니다. 검증하는 참가자는 원장 시각이 기록 시각(record time)에서 허용 오차(ledgerTimeRecordTimeTolerance, 기본 60초) 안에 있는지 확인하고, 벗어나면 LOCAL_VERDICT_LEDGER_TIME_OUT_OF_BOUND로 거부합니다.

시간 경계는 반열린 구간(Half-Open Interval) [openFrom, expiresAt)으로 판정합니다. 시작 시각은 포함(openFrom <= now)하고 마감 시각은 제외(now < expiresAt)하면, 1차 청약 창 [09:00, 15:00)과 2차 창 [15:00, 18:00)이 맞닿는 15:00:00Z에서 두 창이 겹치지도 않고 비지도 않습니다. 정확히 15:00:00Z에 찍힌 주문은 2차 창에만 속합니다.

패키지 버전을 1.0.0에서 1.1.0으로 올릴 때는 이미 생성된 1.0.0 계약을 데이터 이전 없이 새 코드로 읽고 행사할 수 있어야 합니다. 이를 보장하는 Daml 3.7 스마트 계약 업그레이드(SCU)의 필드 규칙을 아래 코드에 함께 반영합니다.

TimeAndUpgrade.daml — 반열린 시간 창문 판정기와 SCU 호환 Optional 확장 Daml
module Patterns.TimeAndUpgrade where

import DA.Date (Month(..), date)
import DA.Fail (FailureCategory(..), FailureStatus(..), failWithStatus)
import qualified DA.TextMap as TextMap
import DA.Time (hours, seconds, time)
import Daml.Script
import Patterns.Common (InstrumentKey(..))

-- 반열린 구간 [openFrom, expiresAt) 판정: openFrom <= now && now < expiresAt
assertWithinHalfOpenWindow : Time -> Time -> Time -> Update ()
assertWithinHalfOpenWindow openFrom expiresAt now =
  if openFrom <= now && now < expiresAt
    then return ()
    else failWithStatus FailureStatus
      with
        errorId  = "OUTSIDE_SUBSCRIPTION_WINDOW"
        category = InvalidGivenCurrentSystemStateOther
        message  = "Current ledger time is outside [openFrom, expiresAt)."
        meta     = TextMap.empty

template SubscriptionTicket
  with
    issuer        : Party
    subscriber    : Party
    instrument    : InstrumentKey
    openFrom      : Time
    expiresAt     : Time
    -- [SCU 필드 규칙] v1.1.0에서 추가한 필드: 기존 필드 뒤에 Optional로만 덧붙인다.
    -- v1.0.0으로 생성된 계약은 새 코드에서 이 필드가 None인 것으로 읽힌다.
    referralTag   : Optional Text
  where
    signatory issuer
    observer  subscriber
    ensure    openFrom < expiresAt

    choice ExerciseWithinWindow : Time
      controller subscriber
      do
        now <- getTime
        assertWithinHalfOpenWindow openFrom expiresAt now
        return now

testHalfOpenBoundary : Script ()
testHalfOpenBoundary = script do
  issuer <- allocateParty "BondIssuer"
  sub    <- allocateParty "Subscriber"
  let tOpen   = time (date 2026 Nov 13) 9 0 0
  let tExpire = time (date 2026 Nov 14) 0 0 0
  let bondKey = InstrumentKey with issuer; symbol = "CORP-3Y"; version = "v1"

  setTime tOpen
  cid1 <- submit issuer do
    createCmd SubscriptionTicket with
      issuer; subscriber = sub; instrument = bondKey
      openFrom = tOpen; expiresAt = tExpire; referralTag = None
  cid2 <- submit issuer do
    createCmd SubscriptionTicket with
      issuer; subscriber = sub; instrument = bondKey
      openFrom = tOpen; expiresAt = tExpire; referralTag = Some "PB-DESK"

  -- 2026-11-13 23:59:59Z (마감 1초 전): 구간 안이므로 통과
  passTime (hours 14)
  passTime (seconds 3599)
  _ <- submit sub do exerciseCmd cid1 ExerciseWithinWindow

  -- 2026-11-14 00:00:00Z (now == expiresAt): 오른쪽 경계는 제외되므로 거부
  passTime (seconds 1)
  submitMustFail sub do exerciseCmd cid2 ExerciseWithinWindow

SCU 호환 규칙: 새 패키지 버전으로 기존 계약을 읽거나 행사하면, 엔진은 새 코드로 그 계약의 ensure를 다시 평가하고 서명자·관찰자·계약 키와 키 관리자(maintainer)를 다시 계산합니다. ensure가 거짓이면 거부되고, 다시 계산한 서명자·관찰자·키가 원래 값과 다르면 업그레이드 검증 실패(INTERPRETATION_UPGRADE_ERROR_VALIDATION_FAILED)로 거부됩니다. 따라서 (1) 기존 템플릿·레코드 필드의 순서와 타입을 바꾸거나 삭제하지 않고, (2) 새 필드는 레코드 끝에 Optional 타입으로만 추가하며, (3) 같은 계약 인자에 대한 signatory·observer·키 계산 결과를 바꾸지 않고, (4) ensure를 기존 계약이 위반하게 될 만큼 강화하지 않습니다. 이 규칙을 지키면 업그레이드에 데이터 이전 작업이 필요하지 않습니다.

눈금이 새겨진 시간 축 위에서 왼쪽 끝은 각진 기둥이고 오른쪽 끝은 열린 아치인 두 창틀이 한 눈금에서 맞닿는 추상 스팟 일러스트
[FIG 27.3] 반열린 시간 구간 [openFrom, expiresAt): 각 구간은 시작 시각을 포함하고 마감 시각을 다음 구간에 넘긴다. 맞닿은 두 구간의 경계에서 이중 실행도 공백도 생기지 않는다.
삽화 구성 및 생성 프롬프트 보기 열기 / 닫기
연출 의도: 눈금이 그어진 수평 시간 축 위에서 왼쪽은 각진 닫힌 기둥, 오른쪽은 곡선으로 열린 아치 형태를 한 슬라이딩 창틀 두 개가 빈틈도 겹침도 없이 맞물려 정각 경계를 가르는 기하학적 장면을 벨 연구소 드로잉 풍으로 시각화.
Sparse 1960s-1970s American editorial spot cartoon on aged warm off-white cream newsprint paper. Along a clean horizontal ruled timeline floating in wide empty paper space, two adjacent geometric sliding frames meet at a single crisp tick mark without overlap: each frame has a solid square-cornered pillar on its left edge and an open curved crescent arch on its right edge, while a tiny mechanical clock pendulum hovers precisely at the boundary tick. Saul Steinberg and Bell Labs technical manual doodle style, raw dip-pen black ink lines, coarse off-register gray Zip-A-Tone halftone dots, 75% empty paper negative space, flat 2D print aesthetic, no 3D shading, strictly zero text, zero letters, zero words, and zero numbers anywhere in the image. --ar 16:9

CPMI-IOSCO 금융시장인프라 원칙(PFMI) 원칙 8(결제 완결성)과 결제완결성 규범: PFMI 원칙 8은 금융시장인프라가 결제가 최종 확정되는 시점과, 미결제 지시를 더 이상 철회할 수 없는 시점을 규칙으로 명확히 정할 것을 요구합니다. EU 결제완결성 지침(Settlement Finality Directive, 98/26/EC)도 이체 지시가 시스템에 들어간 시점과 철회 불가 시점을 시스템 규칙으로 정하게 합니다. 원장 코드에서 이 요구는 두 가지로 구현됩니다. 하나는 getTime 기반 반열린 구간(openFrom <= now && now < expiresAt)으로 모든 참가자가 같은 경계 판정을 내리게 하는 것이고, 다른 하나는 failWithStatus로 경계 위반을 기계 판독 가능한 오류로 돌려주는 것입니다. 서버 간 시계 차이나 자정 경계의 중복 체결로 인한 분쟁 여지는 이 단계에서 줄어듭니다.

이 장에서 남는 것

  1. dpm 프로젝트 구성과 Numeric 10. Daml 3 프로젝트는 dpm으로 빌드·테스트하고, 금액과 수량은 고정 소수점 Numeric 10으로, 종목은 공통 InstrumentKey로 표현한다.
  2. 정상·실패 경로 쌍 테스트. 모든 패턴 스크립트는 권한 있는 당사자의 submit 성공과 함께, 무권한자·기한 경과·이미 소비된 계약을 겨냥한 submitMustFail을 쌍으로 둔다.
  3. 네 가지 모델링 질문과 권한 포함 조건. 코드를 쓰기 전에 서명자, 행사자와 가시성, 소비 여부, 생성되는 계약의 권한(\(\mathrm{ReqAuth}(e) \subseteq \mathrm{Sig}(c) \cup \mathrm{Ctrl}(e)\))을 먼저 정한다.
  4. 세 가지 실패 경로. 상태 불변식은 ensure로, 잘못된 호출은 failWithStatus로, 비즈니스 거절·철회는 정상 완료되는 소비형 초이스로 나눈다. 폐기 예정인 DA.Exception은 쓰지 않는다.
  5. 반열린 시간 구간과 SCU 필드 규칙. 시간 경계는 [openFrom, expiresAt)로 판정하고, 새 버전의 필드는 레코드 끝에 Optional로만 추가하며, 서명자·관찰자·키 계산 결과를 바꾸지 않는다.