Settlement

On-chain과 Off-chain을 결합한 하이브리드 정산 메커니즘을 설명합니다.

---

Overview

EZYS는 거래 자산 유형에 따라 On-chain과 Off-chain 정산을 자동 결합합니다. Execution이 확정되면 Settlement Layer가 Settlement Plan을 실행합니다.

Formal Definition

Given:
  E = (I, q*, v*)                           확정된 Execution

Settlement:
  S(E) = { L₁, L₂, ..., Lₖ }              Leg의 집합

  where Lᵢ = [(fromaddr, toaddr, asset, amount), (fromaddr, toaddr, asset, amount)]

Leg type determination:
  type(Lᵢ) = offchain   if Lᵢ.asset ∈ Fiat    where Fiat = { USD, EUR, KRW, JPY, ... }
  type(Lᵢ) = onchain    if Lᵢ.asset ∈ Crypto  where Crypto = { USDC, USDT, ETH, ... }

Typical 2-Leg plan:
  S(E) = { L_outflow, L_inflow }
       = { (type₁, source, inputAmt, outflow, σ),
           (type₂, target, outputAmt, inflow, σ) }

  where σ = partial (Type A) | revert (Type B)

┌───────────────────────────────────────────────────────────────────────┐
│  Hybrid Settlement                                                    │
│                                                                       │
│   Execution Committed                                                 │
│         │                                                             │
│         ▼                                                             │
│   ┌──────────────┐                                                    │
│   │ Settlement   │                                                    │
│   │    Plan      │                                                    │
│   └──────┬───────┘                                                    │
│          │                                                            │
│     ┌────┴────────────────┐                                           │
│     │                     │                                           │
│     ▼                     ▼                                           │
│  ┌──────────────┐   ┌──────────────┐                                  │
│  │  On-chain    │   │  Off-chain   │                                  │
│  │              │   │              │                                  │
│  │  Vault       │   │  Fiat        │                                  │
│  │  Contract    │   │  Gateway     │                                  │
│  │              │   │              │                                  │
│  │  USDC, USDT  │   │  USD, EUR    │                                  │
│  │  즉시 확정     │   │  KRW, JPY    │                                  │
│  └──────────────┘   │  T+0 ~ T+1   │                                  │
│                     └──────────────┘                                  │
│                                                                       │
└───────────────────────────────────────────────────────────────────────┘

---

Settlement Types

거래 유형에 따라 두 가지 Settlement 전략이 적용됩니다.

Type A (Retail)

대상	리테일 고객
Leg 실행	병렬
실패 처리	partial — 성공한 leg 유지

Leg 0 (Outflow) ──┐
                   ├──▶ 병렬 실행 ──▶ Settlement Complete
Leg 1 (Inflow)  ──┘

Type B (Institution)

대상	기관 고객
Leg 실행	순차 (Saga 패턴)
실패 처리	revert — 전체 보상 트랜잭션

Leg 0 (Outflow)
      │
      ▼  성공
Leg 1 (Inflow)
      │
  ┌───┴───┐
  │       │
Success  Fail
  │       │
  ▼       ▼
 Done   Compensate Leg 0

---

Leg Structure

Settlement은 하나 이상의 Leg으로 구성됩니다. 각 Leg는 단일 자산의 단방향 이동을 나타냅니다.

Leg Type Determination

┌────────────────────────────────────────────────────────────────────┐
│  Leg Type Decision                                                  │
│                                                                    │
│   Asset                                                            │
│     │                                                              │
│     ├─── Fiat (USD, EUR, KRW, JPY, ...) ───▶ OFFCHAIN             │
│     │                                                              │
│     └─── Crypto (USDC, USDT, ETH, ...) ───▶ ONCHAIN               │
│                                                                    │
└────────────────────────────────────────────────────────────────────┘

Leg Fields

Field	Type	Description
legIndex	number	실행 순서 (0부터)
type	onchain | offchain	실행 레이어
chain	string	블록체인 (onchain인 경우)
asset	string	자산 코드
amount	string	금액
direction	outflow | inflow	자금 흐름 방향
tenorDays	number	정산 기간 (0=즉시, 1=T+1)
failureStrategy	revert | partial	실패 시 처리 전략

---

Settlement Plan

Execution이 확정되면 Settlement Plan이 생성됩니다.

Plan Structure

┌────────────────────────────────────────────────────────────────────┐
│  Settlement Plan                                                    │
│                                                                    │
│  ┌──────────────────────────────────────────────────────────────┐ │
│  │  settleId:   "stl_m1n2o3"                                     │ │
│  │  intentId:   "int_2f8a3b1c"                                   │ │
│  │  type:       "type_a"                                         │ │
│  │                                                               │ │
│  │  legs:                                                        │ │
│  │    ┌────────────────────────────────────────────────────┐    │ │
│  │    │  Leg 0                                              │    │ │
│  │    │  ├─ type:      "onchain"                            │    │ │
│  │    │  ├─ chain:     "ethereum"                           │    │ │
│  │    │  ├─ asset:     "USDC"                               │    │ │
│  │    │  ├─ amount:    "1000.00"                            │    │ │
│  │    │  ├─ direction: "outflow"                            │    │ │
│  │    │  └─ tenor:     0 (즉시)                              │    │ │
│  │    └────────────────────────────────────────────────────┘    │ │
│  │    ┌────────────────────────────────────────────────────┐    │ │
│  │    │  Leg 1                                              │    │ │
│  │    │  ├─ type:      "offchain"                           │    │ │
│  │    │  ├─ asset:     "KRW"                                │    │ │
│  │    │  ├─ amount:    "1424500.00"                         │    │ │
│  │    │  ├─ direction: "inflow"                             │    │ │
│  │    │  └─ tenor:     1 (T+1)                              │    │ │
│  │    └────────────────────────────────────────────────────┘    │ │
│  │                                                               │ │
│  └──────────────────────────────────────────────────────────────┘ │
│                                                                    │
└────────────────────────────────────────────────────────────────────┘

---

Settlement Examples

Example 1: USDC → KRW (Crypto to Fiat)

┌────────────────────────────────────────────────────────────────────┐
│  USDC → KRW Settlement                                              │
│                                                                    │
│  Leg 0: ONCHAIN                    Leg 1: OFFCHAIN                 │
│  ┌────────────────────────┐       ┌────────────────────────┐      │
│  │  asset:  USDC          │       │  asset:  KRW           │      │
│  │  amount: 1,000         │       │  amount: 1,424,500     │      │
│  │  chain:  Ethereum      │  ───▶ │  rail:   Domestic Wire │      │
│  │  dir:    outflow       │       │  dir:    inflow        │      │
│  │  tenor:  0 (즉시)       │       │  tenor:  0~1           │      │
│  └────────────────────────┘       └────────────────────────┘      │
│                                                                    │
└────────────────────────────────────────────────────────────────────┘

Example 2: KRW → USDC (Fiat to Crypto)

┌────────────────────────────────────────────────────────────────────┐
│  KRW → USDC Settlement                                              │
│                                                                    │
│  Leg 0: OFFCHAIN                   Leg 1: ONCHAIN                  │
│  ┌────────────────────────┐       ┌────────────────────────┐      │
│  │  asset:  KRW           │       │  asset:  USDC          │      │
│  │  amount: 1,424,500     │       │  amount: 1,000         │      │
│  │  rail:   Domestic Wire │  ───▶ │  chain:  Ethereum      │      │
│  │  dir:    outflow       │       │  dir:    inflow        │      │
│  │  tenor:  0~1           │       │  tenor:  0 (즉시)       │      │
│  └────────────────────────┘       └────────────────────────┘      │
│                                                                    │
└────────────────────────────────────────────────────────────────────┘

Example 3: USD → EUR (Fiat to Fiat)

┌────────────────────────────────────────────────────────────────────┐
│  USD → EUR Settlement                                               │
│                                                                    │
│  Leg 0: OFFCHAIN                   Leg 1: OFFCHAIN                 │
│  ┌────────────────────────┐       ┌────────────────────────┐      │
│  │  asset:  USD           │       │  asset:  EUR           │      │
│  │  amount: 10,000        │       │  amount: 9,250         │      │
│  │  rail:   SWIFT         │  ───▶ │  rail:   SEPA          │      │
│  │  dir:    outflow       │       │  dir:    inflow        │      │
│  │  tenor:  1~2           │       │  tenor:  0~1           │      │
│  └────────────────────────┘       └────────────────────────┘      │
│                                                                    │
└────────────────────────────────────────────────────────────────────┘

---

On-chain Settlement

Smart Contract Vault를 통한 디지털 자산 정산:

┌────────────────────────────────────────────────────────────────────┐
│  On-chain Settlement                                                │
│                                                                    │
│   Settlement Layer                                                 │
│         │                                                          │
│         ▼                                                          │
│   ┌──────────────┐                                                │
│   │    Vault     │  Execution 검증 후                              │
│   │   Contract   │  자산 전송 실행                                  │
│   └──────┬───────┘                                                │
│          │                                                         │
│          ▼                                                         │
│   USDC/USDT 전송                                                   │
│          │                                                         │
│          ▼                                                         │
│   Leg Completed (수초 내)                                          │
│                                                                    │
└────────────────────────────────────────────────────────────────────┘

Chain	Settlement Time	지원 자산
Ethereum	~15 sec	USDC, USDT
Polygon	~2 sec	USDC, USDT
Arbitrum	~1 sec	USDC, USDT
Base	~2 sec	USDC

---

Off-chain Settlement

Fiat Gateway를 통한 법정화폐 정산:

┌────────────────────────────────────────────────────────────────────┐
│  Off-chain Settlement                                               │
│                                                                    │
│   Settlement Layer                                                 │
│         │                                                          │
│         ▼                                                          │
│   ┌──────────────┐                                                │
│   │    Fiat      │  결제 레일 선택                                  │
│   │   Gateway    │  (SWIFT, SEPA, Domestic)                       │
│   └──────┬───────┘                                                │
│          │                                                         │
│          ▼                                                         │
│   은행 송금 실행                                                    │
│          │                                                         │
│          ▼                                                         │
│   Leg Completed (T+0 ~ T+2)                                       │
│                                                                    │
└────────────────────────────────────────────────────────────────────┘

Rail	Tenor	Coverage
SWIFT	T+1~2	Global
SEPA	T+0~1	Europe
Domestic Wire	T+0	By country

---

Settlement Lifecycle

┌────────────────────────────────────────────────────────────────────┐
│  Settlement Lifecycle                                               │
│                                                                    │
│  Execution Committed                                               │
│         │                                                          │
│         ▼                                                          │
│  ┌──────────────┐                                                 │
│  │ Plan Created │  Settlement Plan 생성                           │
│  │   (pending)  │                                                 │
│  └──────┬───────┘                                                 │
│         │                                                          │
│         ▼                                                          │
│  ┌──────────────┐                                                 │
│  │ Legs Queued  │  각 Leg를 실행 대기열에 추가                     │
│  │(in_progress) │                                                 │
│  └──────┬───────┘                                                 │
│         │                                                          │
│    ┌────┴────┐                                                    │
│    │         │                                                    │
│    ▼         ▼                                                    │
│ On-chain  Off-chain                                               │
│    │         │                                                    │
│    ▼         ▼                                                    │
│ Confirmed  Confirmed                                              │
│    │         │                                                    │
│    └────┬────┘                                                    │
│         │                                                          │
│         ▼                                                          │
│  ┌──────────────┐                                                 │
│  │  Completed   │  모든 Leg 완료 → Settlement 확정                │
│  └──────────────┘                                                 │
│                                                                    │
└────────────────────────────────────────────────────────────────────┘

Settlement Status

Status	Description
pending	Plan 생성됨, 실행 대기
in_progress	Leg 실행 중
completed	모든 Leg 완료
failed	실패 (failureStrategy에 따라 처리)

Leg Status

Status	Description
pending	대기 중
executing	실행 중
completed	완료
failed	실패

---

Next Steps

• Solver Node - Solver Node 내부 아키텍처

• Solver Network - 네트워크 합의 및 Commitment