Chế độ giao diện
4.4. Kiến Trúc Sạch và Kiến Trúc Lục Giác (Clean Architecture & Hexagonal Ports & Adapters)
IMPORTANT
Nếu bạn chỉ được nhớ một điều duy nhất: Trọng tâm của Clean Architecture và Kiến trúc Lục giác là biến cơ sở dữ liệu, framework web và các dịch vụ bên thứ ba thành những chi tiết kỹ thuật có thể cắm-rút (Plugins) ở ngoại vi; mũi tên phụ thuộc mã nguồn bắt buộc phải luôn luôn hướng vào tâm lõi nghiệp vụ (The Dependency Rule), không bao giờ được phép hướng ra ngoài.
1. Kiến trúc Tổng quan & Mô hình Tư duy (Mental Model)
Ẩn dụ Đời sống: Bo Mạch Chủ Máy Tính và Chuẩn Cắm USB / PCIe
Hãy hình dung hệ thống phần mềm của bạn giống như một chiếc máy tính để bàn hiện đại:
- Core Domain & Use Cases (CPU & Bo Mạch Chủ - Motherboard): Nơi diễn ra các phép tính logic cốt lõi. Bo mạch chủ không quan tâm bạn cắm bàn phím cơ quang học hay bàn phím cao su rẻ tiền, cũng không cần biết màn hình hiển thị là OLED 4K hay màn hình đen trắng CRT. Nó chỉ giao tiếp thông qua các khe cắm chuẩn hóa.
- Ports (Các Khe Cắm Chuẩn - Ports: USB, HDMI, PCIe): Các giao diện trừu tượng (Interfaces) quy định hình dạng chân cắm và giao thức truyền tải tín hiệu điện tử.
- Adapters (Thiết bị Ngoại vi & Jack Chuyển Đổi): Chiếc chuột máy tính (Driving Adapter) gửi tín hiệu bấm vào bo mạch chủ thông qua cổng USB; chiếc Card đồ họa Nvidia (Driven Adapter) nhận dữ liệu từ CPU và xuất ra màn hình qua cổng HDMI.
- Khả năng thay thế tức thì (Hot-Swappable): Nếu chiếc bàn phím bị hỏng hoặc bạn muốn nâng cấp lên loại bàn phím công thái học mới, bạn chỉ cần rút giắc cắm cũ và cắm cái mới vào cổng USB mà không cần phải đập vỡ bo mạch chủ hay hàn lại vi mạch. Tương tự, bạn có thể đổi từ PostgreSQL sang DynamoDB trong 1 ngày mà không sửa một dòng code nghiệp vụ nào trong Domain!
flowchart TD
subgraph Frameworks["Tầng 4: Frameworks & Drivers (Bên ngoài cùng)"]
Web[Web Framework / HTTP Router]
DB[(SQL / NoSQL Database)]
UI[CLI / Desktop / Mobile UI]
Brokers[Kafka / RabbitMQ Broker]
end
subgraph Adapters["Tầng 3: Interface Adapters (Bộ điều hợp)"]
Controllers[REST Controllers]
Presenters[View Presenters / JSON Mappers]
Gateways[DB Repositories Implementation]
end
subgraph UseCases["Tầng 2: Use Cases (Application Business Rules)"]
UC[Ca Sử Dụng Nghiệp Vụ Ứng Dụng]
InPort[<<Inbound Port>> Primary Interface]
OutPort[<<Outbound Port>> Secondary Interface]
end
subgraph Entities["Tầng 1 (Tâm Lõi): Entities (Enterprise Business Rules)"]
DomainEntity[Domain Entities & Value Objects]
end
Web --> Controllers
UI --> Controllers
Controllers --> InPort
InPort --> UC
UC --> DomainEntity
UC --> OutPort
Gateways -.->|Implements| OutPort
Gateways --> DB
Presenters --> UI
2. Chi tiết từng Keyword (Under-the-Hood Deep Dive)
2.1. Bốn Vòng Tròn Đồng Tâm: Entities, Use Cases, Interface Adapters & Frameworks/Drivers
Mô hình Clean Architecture của Robert C. Martin (Uncle Bob) chuẩn hóa hệ thống thành 4 vòng tròn đồng tâm với ranh giới trách nhiệm cực kỳ khắt khe:
- Entities (Vòng 1 - Vùng Tâm Lõi - Enterprise Business Rules):
- Đại diện cho các quy tắc kinh doanh tối cao của doanh nghiệp.
- Chứa các thực thể cốt lõi mang hành vi và các quy tắc kiểm soát tính toàn vẹn (Invariants).
- Có tuổi thọ dài nhất: Dù công ty có chuyển từ ứng dụng Web sang Mobile, từ cơ sở dữ liệu quan hệ sang Blockchain, các Entities này vẫn giữ nguyên vẹn.
- Use Cases (Vòng 2 - Application Business Rules):
- Chứa các quy tắc nghiệp vụ đặc thù của ứng dụng phần mềm cụ thể.
- Đóng vai trò điều phối luồng dữ liệu tương tác giữa các Entities, triệu hồi các quy tắc của Entities để hoàn thành mục tiêu của người dùng (ví dụ:
RegisterNewCustomerUseCase,ProcessCheckoutUseCase). - Tầng này hoàn toàn độc lập với UI và Database.
- Interface Adapters (Vòng 3 - Bộ Chuyển Đổi Giao Diện):
- Chuyển đổi dữ liệu từ định dạng thuận tiện nhất cho Use Cases và Entities sang định dạng thuận tiện nhất cho các công cụ bên ngoài.
- Nơi cư trú của: Controllers (chuyển đổi HTTP Request thành DTO), Presenters (chuyển đổi DTO thành ViewModel), và Repository Implementations (chuyển đổi Entities thành các dòng SQL hoặc tài liệu BSON).
- Frameworks & Drivers (Vòng 4 - Vùng Ngoại Vi Dễ Thay Thế):
- Nơi chứa các công cụ cụ thể: Spring Boot, FastAPI, Gin, PostgreSQL, Docker, AWS S3.
- Đây là tầng chứa ít logic nhất và là tầng "dễ vứt bỏ nhất" khi công nghệ bị lỗi thời.
2.2. Quy Tắc Phụ Thuộc Tối Cao (The Dependency Rule) & Screaming Architecture
1. The Dependency Rule (Quy Tắc Phụ Thuộc)
"Mọi mũi tên phụ thuộc mã nguồn (Source Code Dependencies) bắt buộc phải luôn chỉ VÀO TRONG, tuyệt đối KHÔNG BAO GIỜ được chỉ ra ngoài!"
- Mã nguồn ở tầng bên trong không bao giờ được phép nhắc tên, biết sự tồn tại, hoặc
importbất kỳ lớp, hàm, biến hay kiểu dữ liệu nào được định nghĩa ở các tầng bên ngoài. - Dữ liệu đi qua ranh giới giữa các tầng phải là các cấu trúc dữ liệu đơn giản (Plain Data Structures / DTOs), không bao giờ truyền đối tượng của tầng ngoài (như
HttpRequesthaySqlRowSet) vào tầng bên trong.
2. Screaming Architecture (Kiến Trúc Biết Gào Thét)
Uncle Bob nhấn mạnh rằng kiến trúc phần mềm phải làm nổi bật bản chất nghiệp vụ chứ không phải framework:
- Kiến trúc Tồi: Khi mở một dự án, bạn nhìn thấy thư mục:
controllers/,models/,views/,services/. Kiến trúc này "gào thét" rằng: "Tôi là một ứng dụng Ruby on Rails hoặc Spring Boot!" nhưng không ai biết nó kinh doanh ngành gì. - Screaming Architecture Chuẩn: Khi mở dự án, bạn nhìn thấy:
loan_origination/,customer_onboarding/,payment_settlement/,risk_scoring/. Kiến trúc này "gào thét" rằng: "Đây là một hệ thống Tài chính - Ngân hàng (FinTech)!".
2.3. Ranh Giới Kiến Trúc và Vùng Lõi Tách Rời (Decoupled Core & Boundaries)
Để đạt được sự độc lập hoàn toàn, Clean Architecture dựng lên các Boundary Interfaces:
sequenceDiagram
autonumber
participant C as Controller (Outer Ring)
participant IP as <<Interface>> InboundPort (Use Case Boundary)
participant UC as UseCaseImpl (Inner Ring)
participant OP as <<Interface>> OutboundPort (Gateway Boundary)
participant GW as DbGatewayImpl (Outer Ring)
C->>IP: execute(InputDTO)
IP->>UC: dispatch call
activate UC
Note over UC: Orchestrate Domain Logic
UC->>OP: save(DomainEntity)
OP->>GW: polymorphically invoke
GW-->>OP: persisted
UC-->>C: OutputDTO
deactivate UC
- Inbound Boundary: Use Case định nghĩa một Input Port Interface. Controller gọi hàm thông qua Interface này.
- Outbound Boundary: Use Case định nghĩa một Output Port (Gateway) Interface. Database Adapter ở vòng ngoài cài đặt Interface này. Nhờ nguyên lý Dependency Inversion Principle (DIP), luồng điều khiển (Flow of Control) đi ra ngoài Database, nhưng chiều phụ thuộc mã nguồn (Source Code Dependency) lại hướng ngược vào trong lõi!
2.4. Kiến Trúc Lục Giác: Ports & Adapters (Alistair Cockburn)
Năm 2005, Alistair Cockburn phát minh ra Hexagonal Architecture (còn gọi là Ports and Adapters Pattern). Hình lục giác không có ý nghĩa toán học 6 cạnh, mà đại diện cho một ranh giới đa chiều nơi có vô số cổng cắm (Ports) kết nối với thế giới bên ngoài:
flowchart LR
subgraph DrivingAdapters["Driving / Primary Side (Actors)"]
HTTP[REST Controller]
CLI[Console Script]
Tests[Automated Unit Tests]
end
subgraph Hexagon["Application Core (The Hexagon)"]
subgraph Ports["Ports (Boundary Contracts)"]
InPort["<<Primary Port>><br/>OrderServicePort"]
OutPort["<<Secondary Port>><br/>OrderRepositoryPort"]
end
Domain["Domain Entities & Core Logic"]
InPort --> Domain
Domain --> OutPort
end
subgraph DrivenAdapters["Driven / Secondary Side (Providers)"]
SQLAdapter[PostgreSQL Adapter]
MockAdapter[In-Memory Mock Adapter]
StripeAdapter[Stripe Payment Adapter]
end
HTTP --> InPort
CLI --> InPort
Tests --> InPort
OutPort -.->|Implemented by| SQLAdapter
OutPort -.->|Implemented by| MockAdapter
OutPort -.->|Implemented by| StripeAdapter
2.5. Phân Định Driving vs Driven (Primary vs Secondary Ports & Adapters)
1. Driving Side (Phía Chủ Động / Primary Side)
- Tác nhân: Người dùng, ứng dụng web của bên thứ ba, hoặc hệ thống kiểm thử tự động. Đây là bên chủ động khởi tạo và điều khiển tương tác.
- Primary Ports (Inbound Ports): Các Interface định nghĩa những gì ứng dụng có thể làm (Use Cases API).
- Driving Adapters: Tiếp nhận yêu cầu bên ngoài, chuyển đổi sang ngôn ngữ của ứng dụng và gọi vào Primary Port (ví dụ: REST Controller, gRPC Handler, Kafka Consumer).
2. Driven Side (Phía Bị Động / Secondary Side)
- Tác nhân: Cơ sở dữ liệu, dịch vụ đám mây, máy chủ SMTP. Đây là bên bị động, chỉ hành động khi được ứng dụng yêu cầu.
- Secondary Ports (Outbound Ports): Các Interface do ứng dụng tự định nghĩa để yêu cầu thế giới cung cấp dữ liệu hoặc lưu trữ trạng thái (ví dụ:
IUserRepository,IPaymentGateway). - Driven Adapters: Cài đặt các Secondary Ports cụ thể (ví dụ:
PostgresUserRepository,StripePaymentGateway).
2.6. Khả Năng Kiểm Thử Tối Thượng (Testability Without Web or Database)
Ưu điểm lớn nhất của Hexagonal & Clean Architecture là Testability vô song:
- Trong kiến trúc truyền thống dính chặt vào database, để chạy kiểm thử tích hợp bạn phải bật Docker Compose, dựng cơ sở dữ liệu thật, chạy migrations và seed dữ liệu, làm một bộ test tốn hàng chục phút.
- Trong Kiến trúc Lục giác, bạn chỉ cần viết một Mock / In-Memory Adapter cài đặt Secondary Port. Toàn bộ
các luồng nghiệp vụ phức tạp của Use Cases và Entities được chạy và kiểm tra trong bộ nhớ RAM ở tốc độ hàng ngàn tests mỗi giây!
3. Thực thi Mã nguồn & Mô phỏng Chuyên sâu (Dual-Engine Implementation)
3.1. C++20 Implementation: Complete Hexagonal Architecture with Swappable Adapters
Chương trình C++20 dưới đây mô phỏng đầy đủ một hệ thống thương mại theo Kiến trúc Lục giác (Hexagonal Architecture) với Domain Entity, Inbound Port, Outbound Port, Driving Controller và hai bộ Driven Adapters có thể hoán đổi nóng (In-Memory Mock vs SQL Adapter).
cpp
#include <iostream>
#include <memory>
#include <string>
#include <unordered_map>
#include <stdexcept>
#include <utility>
// ============================================================================
// 1. INSIDE THE HEXAGON: DOMAIN ENTITY (Vòng 1 - Core Domain)
// ============================================================================
class Order {
public:
enum class Status { PENDING, PAID, CANCELLED };
private:
std::string id_;
std::string customerId_;
int64_t totalCents_;
Status status_{Status::PENDING};
public:
Order(std::string id, std::string customerId, int64_t totalCents)
: id_(std::move(id)), customerId_(std::move(customerId)), totalCents_(totalCents) {
if (totalCents_ <= 0) {
throw std::invalid_argument("Domain Invariant Violated: Total amount must be positive!");
}
}
void markAsPaid() {
if (status_ == Status::PAID) {
throw std::logic_error("Order is already settled!");
}
status_ = Status::PAID;
}
[[nodiscard]] const std::string& id() const noexcept { return id_; }
[[nodiscard]] const std::string& customerId() const noexcept { return customerId_; }
[[nodiscard]] int64_t totalCents() const noexcept { return totalCents_; }
[[nodiscard]] Status status() const noexcept { return status_; }
};
// ============================================================================
// 2. INSIDE THE HEXAGON: PORTS (Contracts)
// ============================================================================
// Outbound Port / Secondary Port: Do Core định nghĩa để yêu cầu lưu trữ
class IOrderRepositoryPort {
public:
virtual ~IOrderRepositoryPort() = default;
virtual std::unique_ptr<Order> findById(const std::string& id) = 0;
virtual void save(const Order& order) = 0;
};
// Inbound Port / Primary Port: Do Core cung cấp cho thế giới bên ngoài điều khiển
class IProcessPaymentUseCasePort {
public:
virtual ~IProcessPaymentUseCasePort() = default;
virtual void execute(const std::string& orderId) = 0;
};
// ============================================================================
// 3. INSIDE THE HEXAGON: USE CASE IMPLEMENTATION (Vòng 2 - Orchestration)
// ============================================================================
class ProcessPaymentUseCase : public IProcessPaymentUseCasePort {
private:
std::shared_ptr<IOrderRepositoryPort> repositoryPort_;
public:
explicit ProcessPaymentUseCase(std::shared_ptr<IOrderRepositoryPort> repoPort)
: repositoryPort_(std::move(repoPort)) {}
void execute(const std::string& orderId) override {
std::cout << "[Hexagon Core: UseCase] Processing payment for Order ID: " << orderId << "...\n";
auto order = repositoryPort_->findById(orderId);
if (!order) {
throw std::runtime_error("Order with ID " + orderId + " not found!");
}
// Triệu hồi hành vi của Entity
order->markAsPaid();
// Ghi lại thông qua Outbound Port
repositoryPort_->save(*order);
std::cout << "[Hexagon Core: UseCase] Order " << orderId << " settled successfully.\n";
}
};
// ============================================================================
// 4. OUTSIDE THE HEXAGON: DRIVEN ADAPTERS (Outbound Implementations)
// ============================================================================
// Driven Adapter A: Mock In-Memory (Dành cho Unit Testing siêu tốc)
class InMemoryOrderAdapter : public IOrderRepositoryPort {
private:
std::unordered_map<std::string, Order> store_;
public:
std::unique_ptr<Order> findById(const std::string& id) override {
auto it = store_.find(id);
if (it != store_.end()) {
return std::make_unique<Order>(it->second);
}
return nullptr;
}
void save(const Order& order) override {
store_.insert_or_assign(order.id(), order);
std::cout << " [Driven Adapter: In-Memory] Persisted Order " << order.id()
<< " in RAM cache (Zero Network Latency).\n";
}
};
// Driven Adapter B: Giả lập PostgreSQL Adapter (Dành cho Production)
class PostgresOrderAdapter : public IOrderRepositoryPort {
public:
std::unique_ptr<Order> findById(const std::string& id) override {
std::cout << " [Driven Adapter: PostgreSQL] SQL: SELECT * FROM orders WHERE id = '" << id << "';\n";
return std::make_unique<Order>(id, "CUST_VIP_99", 150'000);
}
void save(const Order& order) override {
std::cout << " [Driven Adapter: PostgreSQL] SQL: UPDATE orders SET status = 'PAID' WHERE id = '"
<< order.id() << "';\n";
}
};
// ============================================================================
// 5. OUTSIDE THE HEXAGON: DRIVING ADAPTER (Inbound Implementation)
// ============================================================================
class OrderRestHttpController {
private:
std::shared_ptr<IProcessPaymentUseCasePort> useCasePort_;
public:
explicit OrderRestHttpController(std::shared_ptr<IProcessPaymentUseCasePort> useCasePort)
: useCasePort_(std::move(useCasePort)) {}
void postPayOrderEndpoint(const std::string& orderId) {
std::cout << "\n[Driving Adapter: REST Controller] Received POST /api/orders/" << orderId << "/pay\n";
try {
useCasePort_->execute(orderId);
std::cout << " -> HTTP 200 OK: Payment settled.\n";
} catch (const std::exception& ex) {
std::cout << " -> HTTP 400 Bad Request: " << ex.what() << "\n";
}
}
};
int main() {
std::cout << "=== C++20 Hexagonal Ports & Adapters Architecture Demo ===\n";
// KỊCH BẢN 1: MÔI TRƯỜNG KIỂM THỬ SIÊU TỐC (IN-MEMORY ADAPTER)
std::cout << "\n--- 1. Testing Environment with In-Memory Adapter ---\n";
auto inMemoryRepo = std::make_shared<InMemoryOrderAdapter>();
// Seed dữ liệu vào RAM
inMemoryRepo->save(Order("ORD-001", "CUST-10", 49'900));
auto testUseCase = std::make_shared<ProcessPaymentUseCase>(inMemoryRepo);
OrderRestHttpController testController(testUseCase);
testController.postPayOrderEndpoint("ORD-001");
// KỊCH BẢN 2: MÔI TRƯỜNG PRODUCTION VỚI POSTGRESQL ADAPTER (KHÔNG ĐỔI 1 DÒNG CORE!)
std::cout << "\n--- 2. Production Environment with PostgreSQL Adapter ---\n";
auto postgresRepo = std::make_shared<PostgresOrderAdapter>();
auto prodUseCase = std::make_shared<ProcessPaymentUseCase>(postgresRepo);
OrderRestHttpController prodController(prodUseCase);
prodController.postPayOrderEndpoint("ORD-888");
return 0;
}1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
Terminal Output Mẫu (C++20):
text
=== C++20 Hexagonal Ports & Adapters Architecture Demo ===
--- 1. Testing Environment with In-Memory Adapter ---
[Driven Adapter: In-Memory] Persisted Order ORD-001 in RAM cache (Zero Network Latency).
[Driving Adapter: REST Controller] Received POST /api/orders/ORD-001/pay
[Hexagon Core: UseCase] Processing payment for Order ID: ORD-001...
[Driven Adapter: In-Memory] Persisted Order ORD-001 in RAM cache (Zero Network Latency).
[Hexagon Core: UseCase] Order ORD-001 settled successfully.
-> HTTP 200 OK: Payment settled.
--- 2. Production Environment with PostgreSQL Adapter ---
[Driving Adapter: REST Controller] Received POST /api/orders/ORD-888/pay
[Hexagon Core: UseCase] Processing payment for Order ID: ORD-888...
[Driven Adapter: PostgreSQL] SQL: SELECT * FROM orders WHERE id = 'ORD-888';
[Driven Adapter: PostgreSQL] SQL: UPDATE orders SET status = 'PAID' WHERE id = 'ORD-888';
[Hexagon Core: UseCase] Order ORD-888 settled successfully.
-> HTTP 200 OK: Payment settled.1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
3.2. Python 3.11+ Implementation: Clean Banking Architecture with Primary/Secondary Ports
Chương trình Python 3.11+ dưới đây minh họa việc thực hiện Clean Architecture thuần túy với các Primary / Secondary Ports định nghĩa bằng typing.Protocol và thực thi Unit Test trong bộ nhớ RAM mà không cần database.
python
from __future__ import annotations
from dataclasses import dataclass
from typing import Protocol, Optional
import unittest
# ============================================================================
# 1. CORE DOMAIN: ENTITIES (Vòng 1 - Trái tim hệ thống)
# ============================================================================
class InsufficientBalanceException(Exception):
pass
@dataclass
class Account:
account_id: str
owner_name: str
balance_usd: float
def withdraw(self, amount: float) -> None:
if amount <= 0:
raise ValueError("Withdrawal amount must be positive")
if self.balance_usd < amount:
raise InsufficientBalanceException(
f"Account {self.account_id} has insufficient funds: ${self.balance_usd:.2f} < ${amount:.2f}"
)
self.balance_usd -= amount
# ============================================================================
# 2. APPLICATION CORE: PORTS (Vòng 2 - Boundary Interfaces)
# ============================================================================
# Secondary Port (Outbound): Cổng lưu trữ
class AccountRepositoryPort(Protocol):
def get_by_id(self, account_id: str) -> Optional[Account]: ...
def save(self, account: Account) -> None: ...
# Primary Port (Inbound): Cổng nghiệp vụ
class WithdrawFundsUseCasePort(Protocol):
def execute(self, account_id: str, amount: float) -> float: ...
# ============================================================================
# 3. APPLICATION CORE: USE CASE INTERACTION (Vòng 2 - Implementation)
# ============================================================================
class WithdrawFundsUseCase(WithdrawFundsUseCasePort):
def __init__(self, repo_port: AccountRepositoryPort):
self._repo = repo_port
def execute(self, account_id: str, amount: float) -> float:
account = self._repo.get_by_id(account_id)
if not account:
raise LookupError(f"Account '{account_id}' does not exist")
account.withdraw(amount)
self._repo.save(account)
return account.balance_usd
# ============================================================================
# 4. ADAPTERS: DRIVEN ADAPTER (Vòng 3/4 - In-Memory Test Implementation)
# ============================================================================
class InMemoryAccountAdapter(AccountRepositoryPort):
def __init__(self):
self.accounts: dict[str, Account] = {}
def get_by_id(self, account_id: str) -> Optional[Account]:
return self.accounts.get(account_id)
def save(self, account: Account) -> None:
self.accounts[account.account_id] = account
# ============================================================================
# 5. ADAPTERS: DRIVING ADAPTER (Vòng 3/4 - FastAPI / Flask Controller Simulator)
# ============================================================================
class BankingApiController:
def __init__(self, withdraw_service: WithdrawFundsUseCasePort):
self.service = withdraw_service
def handle_withdraw_post(self, account_id: str, amount: float) -> tuple[int, dict]:
try:
new_balance = self.service.execute(account_id, amount)
return 200, {"status": "SUCCESS", "remaining_balance": new_balance}
except InsufficientBalanceException as ibe:
return 422, {"status": "UNPROCESSABLE_ENTITY", "error": str(ibe)}
except LookupError as le:
return 404, {"status": "NOT_FOUND", "error": str(le)}
except Exception as e:
return 500, {"status": "SERVER_ERROR", "error": str(e)}
if __name__ == "__main__":
print("=== Python 3.11+ Clean Architecture Bank Ledger Demo ===")
# Thiết lập Driven Adapter (In-Memory)
memory_repo = InMemoryAccountAdapter()
memory_repo.save(Account("ACC-007", "James Bond", 5000.00))
# Khởi tạo Lõi Nghiệp Vụ
use_case = WithdrawFundsUseCase(repo_port=memory_repo)
# Khởi tạo Driving Adapter
controller = BankingApiController(withdraw_service=use_case)
# Thử nghiệm 1: Rút tiền thành công
status, payload = controller.handle_withdraw_post("ACC-007", 1200.00)
print(f"\n[Test 1] Withdraw $1200.00 -> HTTP {status} | Response: {payload}")
# Thử nghiệm 2: Rút tiền vượt hạn mức (Vi phạm Domain Rule)
status, payload = controller.handle_withdraw_post("ACC-007", 10000.00)
print(f"\n[Test 2] Withdraw $10,000.00 -> HTTP {status} | Response: {payload}")
# Thử nghiệm 3: Tài khoản không tồn tại
status, payload = controller.handle_withdraw_post("ACC-999", 50.00)
print(f"\n[Test 3] Withdraw from non-existent account -> HTTP {status} | Response: {payload}")1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
Terminal Output Mẫu (Python 3.11+):
text
=== Python 3.11+ Clean Architecture Bank Ledger Demo ===
[Test 1] Withdraw $1200.00 -> HTTP 200 | Response: {'status': 'SUCCESS', 'remaining_balance': 3800.0}
[Test 2] Withdraw $10,000.00 -> HTTP 422 | Response: {'status': 'UNPROCESSABLE_ENTITY', 'error': 'Account ACC-007 has insufficient funds: $3800.00 < $10000.00'}
[Test 3] Withdraw from non-existent account -> HTTP 404 | Response: {'status': 'NOT_FOUND', 'error': "Account 'ACC-999' does not exist"}1
2
3
4
5
6
7
2
3
4
5
6
7
4. Systems Engineering & Production Pitfalls
Các Cạm Bẫy Thực Chiến (Gotchas & Production Antipatterns)
Ô Nhiễm Entity Bởi Annotations của Framework (Entity Framework Pollution):
- Bản chất: Lập trình viên gắn trực tiếp các annotations như
@Entity,@Table(name="orders"),@JsonPropertyhoặc@BsonIdlên các Entities trong Domain Layer. Việc này phá hủy hoàn toàn nguyên tắc cốt lõi: Domain không còn độc lập mà bị trói chặt vào ORM framework đó. - Khắc phục: Tách rời 2 lớp thực thể riêng biệt: Domain Entity (thuần túy không annotations) và Persistence Entity / Data Model (chứa annotations của ORM). Sử dụng Data Mapper ở tầng Infrastructure để chuyển đổi qua lại.
- Bản chất: Lập trình viên gắn trực tiếp các annotations như
Chi Phí Ánh Xạ Dữ Liệu Dày Đặc (Mapping Overhead Tax):
- Bản chất: Với mỗi request, dữ liệu phải được ánh xạ qua 4 cấp độ: HTTP JSON
Request DTO Domain Entity ORM Persistence Entity Database Row (và ngược lại ở chiều trả về). Trong các hệ thống xử lý hàng trăm ngàn requests/giây, việc cấp phát và sao chép liên tục hàng triệu object tạm thời này gây áp lực khổng lồ lên CPU Memory Bus và kích hoạt Garbage Collector liên tục. - Khắc phục: Với các hệ thống High-Throughput / Low-Latency, áp dụng CQRS để bypass toàn bộ mapping ở đường dẫn đọc (Read Queries).
- Bản chất: Với mỗi request, dữ liệu phải được ánh xạ qua 4 cấp độ: HTTP JSON
Hiện Tượng Mô Hình Nghiệp Vụ Thiếu Máu (Anemic Domain Model):
- Bản chất: Tạo ra Clean Architecture với đầy đủ các vòng tròn nhưng Entities lại chỉ chứa các trường
privatevới getters/setters rỗng tuếch. Toàn bộ logic nghiệp vụ bị dồn hết vào Use Cases, biến Use Cases thành các hàm thủ tục khổng lồ (Procedural Scripts), vi phạm tính đóng gói của OOP. - Khắc phục: Đưa các quy tắc tính toán, thẩm định và biến đổi trạng thái trở về chính bên trong các Entities; Use Case chỉ làm nhiệm vụ điều phối và giao tiếp với Ports.
- Bản chất: Tạo ra Clean Architecture với đầy đủ các vòng tròn nhưng Entities lại chỉ chứa các trường
Kỹ Thuật Chẩn Đoán & Giám Sát Kiến Trúc Bằng CLI:
bash# 1. Quét vi phạm The Dependency Rule bằng ArchUnit CLI trong Java/Kotlin archunit-cli check --rules clean-architecture-rules.xml target/classes # 2. Kiểm tra các module Domain bị phụ thuộc ngược ra ngoài bằng Dependabot / Deptrac CLI deptrac analyze --config-file=depfile.yaml # 3. Benchmark thời gian chạy của Unit Tests Clean Architecture (RAM vs DB) pytest tests/unit/ -v --benchmark-only1
2
3
4
5
6
7
8
5. Bảng So sánh & Decision Matrix
5.1. So Sánh Chi Tiết Các Trường Phái Kiến Trúc Hướng Nghiệp Vụ
| Tiêu Chí | Traditional Layered | Hexagonal (Ports & Adapters) | Onion Architecture | Clean Architecture |
|---|---|---|---|---|
| Tác Giả & Năm | N-Tier Standards (1990s) | Alistair Cockburn (2005) | Jeffrey Palermo (2008) | Robert C. Martin (2012) |
| Trọng Tâm | Tầng Cơ sở dữ liệu | Cổng tiếp nhận (Ports) | Domain Model & Services | The Dependency Rule |
| Hình Thái Trực Quan | Các thanh xếp ngang | Khối lục giác đối xứng | Các vòng tròn củ hành | Bốn vòng tròn đồng tâm |
| Thuật Ngữ Biên | DAL / Presentation | Driving / Driven Adapters | Infrastructure / UI | Interface Adapters |
| Mức Độ Cô Lập Domain | Thấp (Domain dính DB) | Tuyệt đối | Tuyệt đối | Tuyệt đối |
| Khả Năng Đổi DB | Khó khăn | Dễ như cắm USB | Dễ như cắm USB | Dễ như cắm USB |
5.2. Ma Trận Quyết Định Lựa Chọn Kiến Trúc Cho Dự Án Mới
| Quy Mô & Đặc Điểm Bài Toán | Nên Chọn Phong Cách | Lý Do Kỹ Thuật |
|---|---|---|
| MVP, Startup ngắn hạn (< 6 tháng) | Traditional 3-Tier Layered | Tốc độ ra mắt là tối thượng; không cần chi phí mapping phức tạp |
| Ứng dụng CRUD thuần túy, ít business logic | Active Record / Layered | Tránh bẫy Over-engineering; Clean Architecture sẽ biến thành Sinkhole |
| FinTech, Core Banking, Bảo Hiểm | Clean / Hexagonal Architecture | Logic nghiệp vụ phức tạp, cần tồn tại 10-20 năm, yêu cầu kiểm thử 100% RAM |
| Hệ thống Microservices quy mô lớn | Hexagonal Architecture per Service | Mỗi microservice tự bảo vệ ranh giới Domain của mình độc lập với transport |
IyA0LjQuIEtp4bq/biBUcsO6YyBT4bqhY2ggdsOgIEtp4bq/biBUcsO6YyBM4bulYyBHacOhYyAoQ2xlYW4gQXJjaGl0ZWN0dXJlICYgSGV4YWdvbmFsIFBvcnRzICYgQWRhcHRlcnMpDQoNCj4gWyFJTVBPUlRBTlRdDQo+ICoqTuG6v3UgYuG6oW4gY2jhu4kgxJHGsOG7o2Mgbmjhu5sgbeG7mXQgxJFp4buBdSBkdXkgbmjhuqV0OioqIFRy4buNbmcgdMOibSBj4bunYSBDbGVhbiBBcmNoaXRlY3R1cmUgdsOgIEtp4bq/biB0csO6YyBM4bulYyBnacOhYyBsw6AgYmnhur9uIGPGoSBz4bufIGThu68gbGnhu4d1LCBmcmFtZXdvcmsgd2ViIHbDoCBjw6FjIGThu4tjaCB24bulIGLDqm4gdGjhu6kgYmEgdGjDoG5oIG5o4buvbmcgY2hpIHRp4bq/dCBr4bu5IHRodeG6rXQgY8OzIHRo4buDIGPhuq9tLXLDunQgKFBsdWdpbnMpIOG7nyBuZ2/huqFpIHZpOyBtxalpIHTDqm4gcGjhu6UgdGh14buZYyBtw6Mgbmd14buTbiBi4bqvdCBideG7mWMgcGjhuqNpIGx1w7RuIGx1w7RuIGjGsOG7m25nIHbDoG8gdMOibSBsw7VpIG5naGnhu4dwIHbhu6UgKFRoZSBEZXBlbmRlbmN5IFJ1bGUpLCBraMO0bmcgYmFvIGdp4budIMSRxrDhu6NjIHBow6lwIGjGsOG7m25nIHJhIG5nb8OgaS4NCg0KLS0tDQoNCiMjIDEuIEtp4bq/biB0csO6YyBU4buVbmcgcXVhbiAmIE3DtCBow6xuaCBUxrAgZHV5IChNZW50YWwgTW9kZWwpDQoNCiMjIyDhuqhuIGThu6UgxJDhu51pIHPhu5FuZzogQm8gTeG6oWNoIENo4bunIE3DoXkgVMOtbmggdsOgIENodeG6qW4gQ+G6r20gVVNCIC8gUENJZQ0KSMOjeSBow6xuaCBkdW5nIGjhu4cgdGjhu5FuZyBwaOG6p24gbeG7gW0gY+G7p2EgYuG6oW4gZ2nhu5FuZyBuaMawIG3hu5l0IGNoaeG6v2MgbcOheSB0w61uaCDEkeG7gyBiw6BuIGhp4buHbiDEkeG6oWk6DQotICoqQ29yZSBEb21haW4gJiBVc2UgQ2FzZXMgKENQVSAmIEJvIE3huqFjaCBDaOG7pyAtIE1vdGhlcmJvYXJkKSoqOiBOxqFpIGRp4buFbiByYSBjw6FjIHBow6lwIHTDrW5oIGxvZ2ljIGPhu5F0IGzDtWkuIEJvIG3huqFjaCBjaOG7pyBraMO0bmcgcXVhbiB0w6JtIGLhuqFuIGPhuq9tIGLDoG4gcGjDrW0gY8ahIHF1YW5nIGjhu41jIGhheSBiw6BuIHBow61tIGNhbyBzdSBy4bq7IHRp4buBbiwgY8Wpbmcga2jDtG5nIGPhuqduIGJp4bq/dCBtw6BuIGjDrG5oIGhp4buDbiB0aOG7iyBsw6AgT0xFRCA0SyBoYXkgbcOgbiBow6xuaCDEkWVuIHRy4bqvbmcgQ1JULiBOw7MgY2jhu4kgZ2lhbyB0aeG6v3AgdGjDtG5nIHF1YSBjw6FjIGtoZSBj4bqvbSBjaHXhuqluIGjDs2EuDQotICoqUG9ydHMgKEPDoWMgS2hlIEPhuq9tIENodeG6qW4gLSBQb3J0czogVVNCLCBIRE1JLCBQQ0llKSoqOiBDw6FjIGdpYW8gZGnhu4duIHRy4burdSB0xrDhu6NuZyAoSW50ZXJmYWNlcykgcXV5IMSR4buLbmggaMOsbmggZOG6oW5nIGNow6JuIGPhuq9tIHbDoCBnaWFvIHRo4bupYyB0cnV54buBbiB04bqjaSB0w61uIGhp4buHdSDEkWnhu4duIHThu60uDQotICoqQWRhcHRlcnMgKFRoaeG6v3QgYuG7iyBOZ2/huqFpIHZpICYgSmFjayBDaHV54buDbiDEkOG7lWkpKio6IENoaeG6v2MgY2h14buZdCBtw6F5IHTDrW5oIChEcml2aW5nIEFkYXB0ZXIpIGfhu61pIHTDrW4gaGnhu4d1IGLhuqVtIHbDoG8gYm8gbeG6oWNoIGNo4bunIHRow7RuZyBxdWEgY+G7lW5nIFVTQjsgY2hp4bq/YyBDYXJkIMSR4buTIGjhu41hIE52aWRpYSAoRHJpdmVuIEFkYXB0ZXIpIG5o4bqtbiBk4buvIGxp4buHdSB04burIENQVSB2w6AgeHXhuqV0IHJhIG3DoG4gaMOsbmggcXVhIGPhu5VuZyBIRE1JLg0KLSAqKkto4bqjIG7Eg25nIHRoYXkgdGjhur8gdOG7qWMgdGjDrCAoSG90LVN3YXBwYWJsZSkqKjogTuG6v3UgY2hp4bq/YyBiw6BuIHBow61tIGLhu4sgaOG7j25nIGhv4bq3YyBi4bqhbiBtdeG7kW4gbsOibmcgY+G6pXAgbMOqbiBsb+G6oWkgYsOgbiBwaMOtbSBjw7RuZyB0aMOhaSBo4buNYyBt4bubaSwgYuG6oW4gY2jhu4kgY+G6p24gcsO6dCBnaeG6r2MgY+G6r20gY8WpIHbDoCBj4bqvbSBjw6FpIG3hu5tpIHbDoG8gY+G7lW5nIFVTQiBtw6Aga2jDtG5nIGPhuqduIHBo4bqjaSDEkeG6rXAgduG7oSBibyBt4bqhY2ggY2jhu6cgaGF5IGjDoG4gbOG6oWkgdmkgbeG6oWNoLiBUxrDGoW5nIHThu7EsIGLhuqFuIGPDsyB0aOG7gyDEkeG7lWkgdOG7qyBQb3N0Z3JlU1FMIHNhbmcgRHluYW1vREIgdHJvbmcgMSBuZ8OgeSBtw6Aga2jDtG5nIHPhu61hIG3hu5l0IGTDsm5nIGNvZGUgbmdoaeG7h3AgduG7pSBuw6BvIHRyb25nIERvbWFpbiENCg0KYGBgbWVybWFpZA0KZmxvd2NoYXJ0IFREDQogICAgc3ViZ3JhcGggRnJhbWV3b3Jrc1siVOG6p25nIDQ6IEZyYW1ld29ya3MgJiBEcml2ZXJzIChCw6puIG5nb8OgaSBjw7luZykiXQ0KICAgICAgICBXZWJbV2ViIEZyYW1ld29yayAvIEhUVFAgUm91dGVyXQ0KICAgICAgICBEQlsoU1FMIC8gTm9TUUwgRGF0YWJhc2UpXQ0KICAgICAgICBVSVtDTEkgLyBEZXNrdG9wIC8gTW9iaWxlIFVJXQ0KICAgICAgICBCcm9rZXJzW0thZmthIC8gUmFiYml0TVEgQnJva2VyXQ0KICAgIGVuZA0KDQogICAgc3ViZ3JhcGggQWRhcHRlcnNbIlThuqduZyAzOiBJbnRlcmZhY2UgQWRhcHRlcnMgKELhu5kgxJFp4buBdSBo4bujcCkiXQ0KICAgICAgICBDb250cm9sbGVyc1tSRVNUIENvbnRyb2xsZXJzXQ0KICAgICAgICBQcmVzZW50ZXJzW1ZpZXcgUHJlc2VudGVycyAvIEpTT04gTWFwcGVyc10NCiAgICAgICAgR2F0ZXdheXNbREIgUmVwb3NpdG9yaWVzIEltcGxlbWVudGF0aW9uXQ0KICAgIGVuZA0KDQogICAgc3ViZ3JhcGggVXNlQ2FzZXNbIlThuqduZyAyOiBVc2UgQ2FzZXMgKEFwcGxpY2F0aW9uIEJ1c2luZXNzIFJ1bGVzKSJdDQogICAgICAgIFVDW0NhIFPhu60gROG7pW5nIE5naGnhu4dwIFbhu6Ug4buobmcgROG7pW5nXQ0KICAgICAgICBJblBvcnRbPDxJbmJvdW5kIFBvcnQ+PiBQcmltYXJ5IEludGVyZmFjZV0NCiAgICAgICAgT3V0UG9ydFs8PE91dGJvdW5kIFBvcnQ+PiBTZWNvbmRhcnkgSW50ZXJmYWNlXQ0KICAgIGVuZA0KDQogICAgc3ViZ3JhcGggRW50aXRpZXNbIlThuqduZyAxIChUw6JtIEzDtWkpOiBFbnRpdGllcyAoRW50ZXJwcmlzZSBCdXNpbmVzcyBSdWxlcykiXQ0KICAgICAgICBEb21haW5FbnRpdHlbRG9tYWluIEVudGl0aWVzICYgVmFsdWUgT2JqZWN0c10NCiAgICBlbmQNCg0KICAgIFdlYiAtLT4gQ29udHJvbGxlcnMNCiAgICBVSSAtLT4gQ29udHJvbGxlcnMNCiAgICBDb250cm9sbGVycyAtLT4gSW5Qb3J0DQogICAgSW5Qb3J0IC0tPiBVQw0KICAgIFVDIC0tPiBEb21haW5FbnRpdHkNCiAgICBVQyAtLT4gT3V0UG9ydA0KICAgIEdhdGV3YXlzIC0uLT58SW1wbGVtZW50c3wgT3V0UG9ydA0KICAgIEdhdGV3YXlzIC0tPiBEQg0KICAgIFByZXNlbnRlcnMgLS0+IFVJDQpgYGANCg0KLS0tDQoNCiMjIDIuIENoaSB0aeG6v3QgdOG7q25nIEtleXdvcmQgKFVuZGVyLXRoZS1Ib29kIERlZXAgRGl2ZSkNCg0KIyMjIDIuMS4gQuG7kW4gVsOybmcgVHLDsm4gxJDhu5NuZyBUw6JtOiBFbnRpdGllcywgVXNlIENhc2VzLCBJbnRlcmZhY2UgQWRhcHRlcnMgJiBGcmFtZXdvcmtzL0RyaXZlcnMNCk3DtCBow6xuaCBDbGVhbiBBcmNoaXRlY3R1cmUgY+G7p2EgUm9iZXJ0IEMuIE1hcnRpbiAoVW5jbGUgQm9iKSBjaHXhuqluIGjDs2EgaOG7hyB0aOG7kW5nIHRow6BuaCA0IHbDsm5nIHRyw7JuIMSR4buTbmcgdMOibSB24bubaSByYW5oIGdp4bubaSB0csOhY2ggbmhp4buHbSBj4buxYyBr4buzIGto4bqvdCBraGU6DQoNCjEuICoqRW50aXRpZXMgKFbDsm5nIDEgLSBWw7luZyBUw6JtIEzDtWkgLSBFbnRlcnByaXNlIEJ1c2luZXNzIFJ1bGVzKSoqOg0KICAgLSDEkOG6oWkgZGnhu4duIGNobyBjw6FjIHF1eSB04bqvYyBraW5oIGRvYW5oIHThu5FpIGNhbyBj4bunYSBkb2FuaCBuZ2hp4buHcC4NCiAgIC0gQ2jhu6lhIGPDoWMgdGjhu7FjIHRo4buDIGPhu5F0IGzDtWkgbWFuZyBow6BuaCB2aSB2w6AgY8OhYyBxdXkgdOG6r2Mga2nhu4NtIHNvw6F0IHTDrW5oIHRvw6BuIHbhurluIChJbnZhcmlhbnRzKS4NCiAgIC0gQ8OzIHR14buVaSB0aOG7jSBkw6BpIG5o4bqldDogRMO5IGPDtG5nIHR5IGPDsyBjaHV54buDbiB04burIOG7qW5nIGThu6VuZyBXZWIgc2FuZyBNb2JpbGUsIHThu6sgY8ahIHPhu58gZOG7ryBsaeG7h3UgcXVhbiBo4buHIHNhbmcgQmxvY2tjaGFpbiwgY8OhYyBFbnRpdGllcyBuw6B5IHbhuqtuIGdp4buvIG5ndXnDqm4gduG6uW4uDQoyLiAqKlVzZSBDYXNlcyAoVsOybmcgMiAtIEFwcGxpY2F0aW9uIEJ1c2luZXNzIFJ1bGVzKSoqOg0KICAgLSBDaOG7qWEgY8OhYyBxdXkgdOG6r2MgbmdoaeG7h3AgduG7pSDEkeG6t2MgdGjDuSBj4bunYSDhu6luZyBk4bulbmcgcGjhuqduIG3hu4FtIGPhu6UgdGjhu4MuDQogICAtIMSQw7NuZyB2YWkgdHLDsiDEkWnhu4F1IHBo4buRaSBsdeG7k25nIGThu68gbGnhu4d1IHTGsMahbmcgdMOhYyBnaeG7r2EgY8OhYyBFbnRpdGllcywgdHJp4buHdSBo4buTaSBjw6FjIHF1eSB04bqvYyBj4bunYSBFbnRpdGllcyDEkeG7gyBob8OgbiB0aMOgbmggbeG7pWMgdGnDqnUgY+G7p2EgbmfGsOG7nWkgZMO5bmcgKHbDrSBk4bulOiBgUmVnaXN0ZXJOZXdDdXN0b21lclVzZUNhc2VgLCBgUHJvY2Vzc0NoZWNrb3V0VXNlQ2FzZWApLg0KICAgLSBU4bqnbmcgbsOgeSBob8OgbiB0b8OgbiDEkeG7mWMgbOG6rXAgduG7m2kgVUkgdsOgIERhdGFiYXNlLg0KMy4gKipJbnRlcmZhY2UgQWRhcHRlcnMgKFbDsm5nIDMgLSBC4buZIENodXnhu4NuIMSQ4buVaSBHaWFvIERp4buHbikqKjoNCiAgIC0gQ2h1eeG7g24gxJHhu5VpIGThu68gbGnhu4d1IHThu6sgxJHhu4tuaCBk4bqhbmcgdGh14bqtbiB0aeG7h24gbmjhuqV0IGNobyBVc2UgQ2FzZXMgdsOgIEVudGl0aWVzIHNhbmcgxJHhu4tuaCBk4bqhbmcgdGh14bqtbiB0aeG7h24gbmjhuqV0IGNobyBjw6FjIGPDtG5nIGPhu6UgYsOqbiBuZ2/DoGkuDQogICAtIE7GoWkgY8awIHRyw7ogY+G7p2E6ICoqQ29udHJvbGxlcnMqKiAoY2h1eeG7g24gxJHhu5VpIEhUVFAgUmVxdWVzdCB0aMOgbmggRFRPKSwgKipQcmVzZW50ZXJzKiogKGNodXnhu4NuIMSR4buVaSBEVE8gdGjDoG5oIFZpZXdNb2RlbCksIHbDoCAqKlJlcG9zaXRvcnkgSW1wbGVtZW50YXRpb25zKiogKGNodXnhu4NuIMSR4buVaSBFbnRpdGllcyB0aMOgbmggY8OhYyBkw7JuZyBTUUwgaG/hurdjIHTDoGkgbGnhu4d1IEJTT04pLg0KNC4gKipGcmFtZXdvcmtzICYgRHJpdmVycyAoVsOybmcgNCAtIFbDuW5nIE5nb+G6oWkgVmkgROG7hSBUaGF5IFRo4bq/KSoqOg0KICAgLSBOxqFpIGNo4bupYSBjw6FjIGPDtG5nIGPhu6UgY+G7pSB0aOG7gzogU3ByaW5nIEJvb3QsIEZhc3RBUEksIEdpbiwgUG9zdGdyZVNRTCwgRG9ja2VyLCBBV1MgUzMuDQogICAtIMSQw6J5IGzDoCB04bqnbmcgY2jhu6lhIMOtdCBsb2dpYyBuaOG6pXQgdsOgIGzDoCB04bqnbmcgImThu4UgduG7qXQgYuG7jyBuaOG6pXQiIGtoaSBjw7RuZyBuZ2jhu4cgYuG7iyBs4buXaSB0aOG7nWkuDQoNCi0tLQ0KDQojIyMgMi4yLiBRdXkgVOG6r2MgUGjhu6UgVGh14buZYyBU4buRaSBDYW8gKFRoZSBEZXBlbmRlbmN5IFJ1bGUpICYgU2NyZWFtaW5nIEFyY2hpdGVjdHVyZQ0KDQojIyMjIDEuIFRoZSBEZXBlbmRlbmN5IFJ1bGUgKFF1eSBU4bqvYyBQaOG7pSBUaHXhu5ljKQ0KPiAqIk3hu41pIG3FqWkgdMOqbiBwaOG7pSB0aHXhu5ljIG3DoyBuZ3Xhu5NuIChTb3VyY2UgQ29kZSBEZXBlbmRlbmNpZXMpIGLhuq90IGJ14buZYyBwaOG6o2kgbHXDtG4gY2jhu4kgVsOATyBUUk9ORywgdHV54buHdCDEkeG7kWkgS0jDlE5HIEJBTyBHSeG7nCDEkcaw4bujYyBjaOG7iSByYSBuZ2/DoGkhIioNCg0KLSBNw6Mgbmd14buTbiDhu58gdOG6p25nIGLDqm4gdHJvbmcga2jDtG5nIGJhbyBnaeG7nSDEkcaw4bujYyBwaMOpcCBuaOG6r2MgdMOqbiwgYmnhur90IHPhu7EgdOG7k24gdOG6oWksIGhv4bq3YyBgaW1wb3J0YCBi4bqldCBr4buzIGzhu5twLCBow6BtLCBiaeG6v24gaGF5IGtp4buDdSBk4buvIGxp4buHdSBuw6BvIMSRxrDhu6NjIMSR4buLbmggbmdoxKlhIOG7nyBjw6FjIHThuqduZyBiw6puIG5nb8OgaS4NCi0gROG7ryBsaeG7h3UgxJFpIHF1YSByYW5oIGdp4bubaSBnaeG7r2EgY8OhYyB04bqnbmcgcGjhuqNpIGzDoCBjw6FjIGPhuqV1IHRyw7pjIGThu68gbGnhu4d1IMSRxqFuIGdp4bqjbiAoUGxhaW4gRGF0YSBTdHJ1Y3R1cmVzIC8gRFRPcyksIGtow7RuZyBiYW8gZ2nhu50gdHJ1eeG7gW4gxJHhu5FpIHTGsOG7o25nIGPhu6dhIHThuqduZyBuZ2/DoGkgKG5oxrAgYEh0dHBSZXF1ZXN0YCBoYXkgYFNxbFJvd1NldGApIHbDoG8gdOG6p25nIGLDqm4gdHJvbmcuDQoNCiMjIyMgMi4gU2NyZWFtaW5nIEFyY2hpdGVjdHVyZSAoS2nhur9uIFRyw7pjIEJp4bq/dCBHw6BvIFRow6l0KQ0KVW5jbGUgQm9iIG5o4bqlbiBt4bqhbmggcuG6sW5nIGtp4bq/biB0csO6YyBwaOG6p24gbeG7gW0gcGjhuqNpIGzDoG0gbuG7lWkgYuG6rXQgYuG6o24gY2jhuqV0IG5naGnhu4dwIHbhu6UgY2jhu6kga2jDtG5nIHBo4bqjaSBmcmFtZXdvcms6DQotICoqS2nhur9uIHRyw7pjIFThu5NpKio6IEtoaSBt4bufIG3hu5l0IGThu7Egw6FuLCBi4bqhbiBuaMOsbiB0aOG6pXkgdGjGsCBt4bulYzogYGNvbnRyb2xsZXJzL2AsIGBtb2RlbHMvYCwgYHZpZXdzL2AsIGBzZXJ2aWNlcy9gLiBLaeG6v24gdHLDumMgbsOgeSAiZ8OgbyB0aMOpdCIgcuG6sW5nOiAqIlTDtGkgbMOgIG3hu5l0IOG7qW5nIGThu6VuZyBSdWJ5IG9uIFJhaWxzIGhv4bq3YyBTcHJpbmcgQm9vdCEiKiBuaMawbmcga2jDtG5nIGFpIGJp4bq/dCBuw7Mga2luaCBkb2FuaCBuZ8OgbmggZ8OsLg0KLSAqKlNjcmVhbWluZyBBcmNoaXRlY3R1cmUgQ2h14bqpbioqOiBLaGkgbeG7nyBk4buxIMOhbiwgYuG6oW4gbmjDrG4gdGjhuqV5OiBgbG9hbl9vcmlnaW5hdGlvbi9gLCBgY3VzdG9tZXJfb25ib2FyZGluZy9gLCBgcGF5bWVudF9zZXR0bGVtZW50L2AsIGByaXNrX3Njb3JpbmcvYC4gS2nhur9uIHRyw7pjIG7DoHkgImfDoG8gdGjDqXQiIHLhurFuZzogKiLEkMOieSBsw6AgbeG7mXQgaOG7hyB0aOG7kW5nIFTDoGkgY2jDrW5oIC0gTmfDom4gaMOgbmcgKEZpblRlY2gpISIqLg0KDQotLS0NCg0KIyMjIDIuMy4gUmFuaCBHaeG7m2kgS2nhur9uIFRyw7pjIHbDoCBWw7luZyBMw7VpIFTDoWNoIFLhu51pIChEZWNvdXBsZWQgQ29yZSAmIEJvdW5kYXJpZXMpDQrEkOG7gyDEkeG6oXQgxJHGsOG7o2Mgc+G7sSDEkeG7mWMgbOG6rXAgaG/DoG4gdG/DoG4sIENsZWFuIEFyY2hpdGVjdHVyZSBk4buxbmcgbMOqbiBjw6FjICoqQm91bmRhcnkgSW50ZXJmYWNlcyoqOg0KDQpgYGBtZXJtYWlkDQpzZXF1ZW5jZURpYWdyYW0NCiAgICBhdXRvbnVtYmVyDQogICAgcGFydGljaXBhbnQgQyBhcyBDb250cm9sbGVyIChPdXRlciBSaW5nKQ0KICAgIHBhcnRpY2lwYW50IElQIGFzIDw8SW50ZXJmYWNlPj4gSW5ib3VuZFBvcnQgKFVzZSBDYXNlIEJvdW5kYXJ5KQ0KICAgIHBhcnRpY2lwYW50IFVDIGFzIFVzZUNhc2VJbXBsIChJbm5lciBSaW5nKQ0KICAgIHBhcnRpY2lwYW50IE9QIGFzIDw8SW50ZXJmYWNlPj4gT3V0Ym91bmRQb3J0IChHYXRld2F5IEJvdW5kYXJ5KQ0KICAgIHBhcnRpY2lwYW50IEdXIGFzIERiR2F0ZXdheUltcGwgKE91dGVyIFJpbmcpDQoNCiAgICBDLT4+SVA6IGV4ZWN1dGUoSW5wdXREVE8pDQogICAgSVAtPj5VQzogZGlzcGF0Y2ggY2FsbA0KICAgIGFjdGl2YXRlIFVDDQogICAgTm90ZSBvdmVyIFVDOiBPcmNoZXN0cmF0ZSBEb21haW4gTG9naWMNCiAgICBVQy0+Pk9QOiBzYXZlKERvbWFpbkVudGl0eSkNCiAgICBPUC0+PkdXOiBwb2x5bW9ycGhpY2FsbHkgaW52b2tlDQogICAgR1ctLT4+T1A6IHBlcnNpc3RlZA0KICAgIFVDLS0+PkM6IE91dHB1dERUTw0KICAgIGRlYWN0aXZhdGUgVUMNCmBgYA0KLSAqKkluYm91bmQgQm91bmRhcnkqKjogVXNlIENhc2UgxJHhu4tuaCBuZ2jEqWEgbeG7mXQgSW5wdXQgUG9ydCBJbnRlcmZhY2UuIENvbnRyb2xsZXIgZ+G7jWkgaMOgbSB0aMO0bmcgcXVhIEludGVyZmFjZSBuw6B5Lg0KLSAqKk91dGJvdW5kIEJvdW5kYXJ5Kio6IFVzZSBDYXNlIMSR4buLbmggbmdoxKlhIG3hu5l0IE91dHB1dCBQb3J0IChHYXRld2F5KSBJbnRlcmZhY2UuIERhdGFiYXNlIEFkYXB0ZXIg4bufIHbDsm5nIG5nb8OgaSBjw6BpIMSR4bq3dCBJbnRlcmZhY2UgbsOgeS4gTmjhu50gbmd1ecOqbiBsw70gKipEZXBlbmRlbmN5IEludmVyc2lvbiBQcmluY2lwbGUgKERJUCkqKiwgbHXhu5NuZyDEkWnhu4F1IGtoaeG7g24gKEZsb3cgb2YgQ29udHJvbCkgxJFpIHJhIG5nb8OgaSBEYXRhYmFzZSwgbmjGsG5nIGNoaeG7gXUgcGjhu6UgdGh14buZYyBtw6Mgbmd14buTbiAoU291cmNlIENvZGUgRGVwZW5kZW5jeSkgbOG6oWkgaMaw4bubbmcgbmfGsOG7o2MgdsOgbyB0cm9uZyBsw7VpIQ0KDQotLS0NCg0KIyMjIDIuNC4gS2nhur9uIFRyw7pjIEzhu6VjIEdpw6FjOiBQb3J0cyAmIEFkYXB0ZXJzIChBbGlzdGFpciBDb2NrYnVybikNCk7Eg20gMjAwNSwgQWxpc3RhaXIgQ29ja2J1cm4gcGjDoXQgbWluaCByYSAqKkhleGFnb25hbCBBcmNoaXRlY3R1cmUqKiAoY8OybiBn4buNaSBsw6AgKlBvcnRzIGFuZCBBZGFwdGVycyBQYXR0ZXJuKikuIEjDrG5oIGzhu6VjIGdpw6FjIGtow7RuZyBjw7Mgw70gbmdoxKlhIHRvw6FuIGjhu41jIDYgY+G6oW5oLCBtw6AgxJHhuqFpIGRp4buHbiBjaG8gbeG7mXQgcmFuaCBnaeG7m2kgxJFhIGNoaeG7gXUgbsahaSBjw7MgdsO0IHPhu5EgY+G7lW5nIGPhuq9tIChQb3J0cykga+G6v3QgbuG7kWkgduG7m2kgdGjhur8gZ2nhu5tpIGLDqm4gbmdvw6BpOg0KDQpgYGBtZXJtYWlkDQpmbG93Y2hhcnQgTFINCiAgICBzdWJncmFwaCBEcml2aW5nQWRhcHRlcnNbIkRyaXZpbmcgLyBQcmltYXJ5IFNpZGUgKEFjdG9ycykiXQ0KICAgICAgICBIVFRQW1JFU1QgQ29udHJvbGxlcl0NCiAgICAgICAgQ0xJW0NvbnNvbGUgU2NyaXB0XQ0KICAgICAgICBUZXN0c1tBdXRvbWF0ZWQgVW5pdCBUZXN0c10NCiAgICBlbmQNCg0KICAgIHN1YmdyYXBoIEhleGFnb25bIkFwcGxpY2F0aW9uIENvcmUgKFRoZSBIZXhhZ29uKSJdDQogICAgICAgIHN1YmdyYXBoIFBvcnRzWyJQb3J0cyAoQm91bmRhcnkgQ29udHJhY3RzKSJdDQogICAgICAgICAgICBJblBvcnRbIjw8UHJpbWFyeSBQb3J0Pj48YnIvPk9yZGVyU2VydmljZVBvcnQiXQ0KICAgICAgICAgICAgT3V0UG9ydFsiPDxTZWNvbmRhcnkgUG9ydD4+PGJyLz5PcmRlclJlcG9zaXRvcnlQb3J0Il0NCiAgICAgICAgZW5kDQogICAgICAgIERvbWFpblsiRG9tYWluIEVudGl0aWVzICYgQ29yZSBMb2dpYyJdDQogICAgICAgIEluUG9ydCAtLT4gRG9tYWluDQogICAgICAgIERvbWFpbiAtLT4gT3V0UG9ydA0KICAgIGVuZA0KDQogICAgc3ViZ3JhcGggRHJpdmVuQWRhcHRlcnNbIkRyaXZlbiAvIFNlY29uZGFyeSBTaWRlIChQcm92aWRlcnMpIl0NCiAgICAgICAgU1FMQWRhcHRlcltQb3N0Z3JlU1FMIEFkYXB0ZXJdDQogICAgICAgIE1vY2tBZGFwdGVyW0luLU1lbW9yeSBNb2NrIEFkYXB0ZXJdDQogICAgICAgIFN0cmlwZUFkYXB0ZXJbU3RyaXBlIFBheW1lbnQgQWRhcHRlcl0NCiAgICBlbmQNCg0KICAgIEhUVFAgLS0+IEluUG9ydA0KICAgIENMSSAtLT4gSW5Qb3J0DQogICAgVGVzdHMgLS0+IEluUG9ydA0KICAgIA0KICAgIE91dFBvcnQgLS4tPnxJbXBsZW1lbnRlZCBieXwgU1FMQWRhcHRlcg0KICAgIE91dFBvcnQgLS4tPnxJbXBsZW1lbnRlZCBieXwgTW9ja0FkYXB0ZXINCiAgICBPdXRQb3J0IC0uLT58SW1wbGVtZW50ZWQgYnl8IFN0cmlwZUFkYXB0ZXINCmBgYA0KDQotLS0NCg0KIyMjIDIuNS4gUGjDom4gxJDhu4tuaCBEcml2aW5nIHZzIERyaXZlbiAoUHJpbWFyeSB2cyBTZWNvbmRhcnkgUG9ydHMgJiBBZGFwdGVycykNCg0KIyMjIyAxLiBEcml2aW5nIFNpZGUgKFBow61hIENo4bunIMSQ4buZbmcgLyBQcmltYXJ5IFNpZGUpDQotICoqVMOhYyBuaMOibioqOiBOZ8aw4budaSBkw7luZywg4bupbmcgZOG7pW5nIHdlYiBj4bunYSBiw6puIHRo4bupIGJhLCBob+G6t2MgaOG7hyB0aOG7kW5nIGtp4buDbSB0aOG7rSB04buxIMSR4buZbmcuIMSQw6J5IGzDoCBiw6puIGNo4bunIMSR4buZbmcga2jhu59pIHThuqFvIHbDoCDEkWnhu4F1IGtoaeG7g24gdMawxqFuZyB0w6FjLg0KLSAqKlByaW1hcnkgUG9ydHMgKEluYm91bmQgUG9ydHMpKio6IEPDoWMgSW50ZXJmYWNlIMSR4buLbmggbmdoxKlhIG5o4buvbmcgZ8OsIOG7qW5nIGThu6VuZyBjw7MgdGjhu4MgbMOgbSAoVXNlIENhc2VzIEFQSSkuDQotICoqRHJpdmluZyBBZGFwdGVycyoqOiBUaeG6v3Agbmjhuq1uIHnDqnUgY+G6p3UgYsOqbiBuZ2/DoGksIGNodXnhu4NuIMSR4buVaSBzYW5nIG5nw7RuIG5n4buvIGPhu6dhIOG7qW5nIGThu6VuZyB2w6AgZ+G7jWkgdsOgbyBQcmltYXJ5IFBvcnQgKHbDrSBk4bulOiBSRVNUIENvbnRyb2xsZXIsIGdSUEMgSGFuZGxlciwgS2Fma2EgQ29uc3VtZXIpLg0KDQojIyMjIDIuIERyaXZlbiBTaWRlIChQaMOtYSBC4buLIMSQ4buZbmcgLyBTZWNvbmRhcnkgU2lkZSkNCi0gKipUw6FjIG5ow6JuKio6IEPGoSBz4bufIGThu68gbGnhu4d1LCBk4buLY2ggduG7pSDEkcOhbSBtw6J5LCBtw6F5IGNo4bunIFNNVFAuIMSQw6J5IGzDoCBiw6puIGLhu4sgxJHhu5luZywgY2jhu4kgaMOgbmggxJHhu5luZyBraGkgxJHGsOG7o2Mg4bupbmcgZOG7pW5nIHnDqnUgY+G6p3UuDQotICoqU2Vjb25kYXJ5IFBvcnRzIChPdXRib3VuZCBQb3J0cykqKjogQ8OhYyBJbnRlcmZhY2UgZG8g4bupbmcgZOG7pW5nIHThu7EgxJHhu4tuaCBuZ2jEqWEgxJHhu4MgecOqdSBj4bqndSB0aOG6vyBnaeG7m2kgY3VuZyBj4bqlcCBk4buvIGxp4buHdSBob+G6t2MgbMawdSB0cuG7ryB0cuG6oW5nIHRow6FpICh2w60gZOG7pTogYElVc2VyUmVwb3NpdG9yeWAsIGBJUGF5bWVudEdhdGV3YXlgKS4NCi0gKipEcml2ZW4gQWRhcHRlcnMqKjogQ8OgaSDEkeG6t3QgY8OhYyBTZWNvbmRhcnkgUG9ydHMgY+G7pSB0aOG7gyAodsOtIGThu6U6IGBQb3N0Z3Jlc1VzZXJSZXBvc2l0b3J5YCwgYFN0cmlwZVBheW1lbnRHYXRld2F5YCkuDQoNCi0tLQ0KDQojIyMgMi42LiBLaOG6oyBOxINuZyBLaeG7g20gVGjhu60gVOG7kWkgVGjGsOG7o25nIChUZXN0YWJpbGl0eSBXaXRob3V0IFdlYiBvciBEYXRhYmFzZSkNCsavdSDEkWnhu4NtIGzhu5tuIG5o4bqldCBj4bunYSBIZXhhZ29uYWwgJiBDbGVhbiBBcmNoaXRlY3R1cmUgbMOgICoqVGVzdGFiaWxpdHkgdsO0IHNvbmcqKjoNCi0gVHJvbmcga2nhur9uIHRyw7pjIHRydXnhu4FuIHRo4buRbmcgZMOtbmggY2jhurd0IHbDoG8gZGF0YWJhc2UsIMSR4buDIGNo4bqheSBraeG7g20gdGjhu60gdMOtY2ggaOG7o3AgYuG6oW4gcGjhuqNpIGLhuq10IERvY2tlciBDb21wb3NlLCBk4buxbmcgY8ahIHPhu58gZOG7ryBsaeG7h3UgdGjhuq10LCBjaOG6oXkgbWlncmF0aW9ucyB2w6Agc2VlZCBk4buvIGxp4buHdSwgbMOgbSBt4buZdCBi4buZIHRlc3QgdOG7kW4gaMOgbmcgY2jhu6VjIHBow7p0Lg0KLSBUcm9uZyBLaeG6v24gdHLDumMgTOG7pWMgZ2nDoWMsIGLhuqFuIGNo4buJIGPhuqduIHZp4bq/dCBt4buZdCAqKk1vY2sgLyBJbi1NZW1vcnkgQWRhcHRlcioqIGPDoGkgxJHhurd0IFNlY29uZGFyeSBQb3J0LiBUb8OgbiBi4buZICQxMDBcJSQgY8OhYyBsdeG7k25nIG5naGnhu4dwIHbhu6UgcGjhu6ljIHThuqFwIGPhu6dhIFVzZSBDYXNlcyB2w6AgRW50aXRpZXMgxJHGsOG7o2MgY2jhuqF5IHbDoCBraeG7g20gdHJhIHRyb25nIGLhu5kgbmjhu5sgUkFNIOG7nyB04buRYyDEkeG7mSBow6BuZyBuZ8OgbiB0ZXN0cyBt4buXaSBnacOieSENCg0KLS0tDQoNCiMjIDMuIFRo4buxYyB0aGkgTcOjIG5ndeG7k24gJiBNw7QgcGjhu49uZyBDaHV5w6puIHPDonUgKER1YWwtRW5naW5lIEltcGxlbWVudGF0aW9uKQ0KDQojIyMgMy4xLiBDKysyMCBJbXBsZW1lbnRhdGlvbjogQ29tcGxldGUgSGV4YWdvbmFsIEFyY2hpdGVjdHVyZSB3aXRoIFN3YXBwYWJsZSBBZGFwdGVycw0KQ2jGsMahbmcgdHLDrG5oIEMrKzIwIGTGsOG7m2kgxJHDonkgbcO0IHBo4buPbmcgxJHhuqd5IMSR4bunIG3hu5l0IGjhu4cgdGjhu5FuZyB0aMawxqFuZyBt4bqhaSB0aGVvIEtp4bq/biB0csO6YyBM4bulYyBnacOhYyAoSGV4YWdvbmFsIEFyY2hpdGVjdHVyZSkgduG7m2kgRG9tYWluIEVudGl0eSwgSW5ib3VuZCBQb3J0LCBPdXRib3VuZCBQb3J0LCBEcml2aW5nIENvbnRyb2xsZXIgdsOgIGhhaSBi4buZIERyaXZlbiBBZGFwdGVycyBjw7MgdGjhu4MgaG/DoW4gxJHhu5VpIG7Ds25nIChJbi1NZW1vcnkgTW9jayB2cyBTUUwgQWRhcHRlcikuDQoNCmBgYGNwcA0KI2luY2x1ZGUgPGlvc3RyZWFtPg0KI2luY2x1ZGUgPG1lbW9yeT4NCiNpbmNsdWRlIDxzdHJpbmc+DQojaW5jbHVkZSA8dW5vcmRlcmVkX21hcD4NCiNpbmNsdWRlIDxzdGRleGNlcHQ+DQojaW5jbHVkZSA8dXRpbGl0eT4NCg0KLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQ0KLy8gMS4gSU5TSURFIFRIRSBIRVhBR09OOiBET01BSU4gRU5USVRZIChWw7JuZyAxIC0gQ29yZSBEb21haW4pDQovLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09DQpjbGFzcyBPcmRlciB7DQpwdWJsaWM6DQogICAgZW51bSBjbGFzcyBTdGF0dXMgeyBQRU5ESU5HLCBQQUlELCBDQU5DRUxMRUQgfTsNCg0KcHJpdmF0ZToNCiAgICBzdGQ6OnN0cmluZyBpZF87DQogICAgc3RkOjpzdHJpbmcgY3VzdG9tZXJJZF87DQogICAgaW50NjRfdCB0b3RhbENlbnRzXzsNCiAgICBTdGF0dXMgc3RhdHVzX3tTdGF0dXM6OlBFTkRJTkd9Ow0KDQpwdWJsaWM6DQogICAgT3JkZXIoc3RkOjpzdHJpbmcgaWQsIHN0ZDo6c3RyaW5nIGN1c3RvbWVySWQsIGludDY0X3QgdG90YWxDZW50cykNCiAgICAgICAgOiBpZF8oc3RkOjptb3ZlKGlkKSksIGN1c3RvbWVySWRfKHN0ZDo6bW92ZShjdXN0b21lcklkKSksIHRvdGFsQ2VudHNfKHRvdGFsQ2VudHMpIHsNCiAgICAgICAgaWYgKHRvdGFsQ2VudHNfIDw9IDApIHsNCiAgICAgICAgICAgIHRocm93IHN0ZDo6aW52YWxpZF9hcmd1bWVudCgiRG9tYWluIEludmFyaWFudCBWaW9sYXRlZDogVG90YWwgYW1vdW50IG11c3QgYmUgcG9zaXRpdmUhIik7DQogICAgICAgIH0NCiAgICB9DQoNCiAgICB2b2lkIG1hcmtBc1BhaWQoKSB7DQogICAgICAgIGlmIChzdGF0dXNfID09IFN0YXR1czo6UEFJRCkgew0KICAgICAgICAgICAgdGhyb3cgc3RkOjpsb2dpY19lcnJvcigiT3JkZXIgaXMgYWxyZWFkeSBzZXR0bGVkISIpOw0KICAgICAgICB9DQogICAgICAgIHN0YXR1c18gPSBTdGF0dXM6OlBBSUQ7DQogICAgfQ0KDQogICAgW1tub2Rpc2NhcmRdXSBjb25zdCBzdGQ6OnN0cmluZyYgaWQoKSBjb25zdCBub2V4Y2VwdCB7IHJldHVybiBpZF87IH0NCiAgICBbW25vZGlzY2FyZF1dIGNvbnN0IHN0ZDo6c3RyaW5nJiBjdXN0b21lcklkKCkgY29uc3Qgbm9leGNlcHQgeyByZXR1cm4gY3VzdG9tZXJJZF87IH0NCiAgICBbW25vZGlzY2FyZF1dIGludDY0X3QgdG90YWxDZW50cygpIGNvbnN0IG5vZXhjZXB0IHsgcmV0dXJuIHRvdGFsQ2VudHNfOyB9DQogICAgW1tub2Rpc2NhcmRdXSBTdGF0dXMgc3RhdHVzKCkgY29uc3Qgbm9leGNlcHQgeyByZXR1cm4gc3RhdHVzXzsgfQ0KfTsNCg0KLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQ0KLy8gMi4gSU5TSURFIFRIRSBIRVhBR09OOiBQT1JUUyAoQ29udHJhY3RzKQ0KLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQ0KDQovLyBPdXRib3VuZCBQb3J0IC8gU2Vjb25kYXJ5IFBvcnQ6IERvIENvcmUgxJHhu4tuaCBuZ2jEqWEgxJHhu4MgecOqdSBj4bqndSBsxrB1IHRy4buvDQpjbGFzcyBJT3JkZXJSZXBvc2l0b3J5UG9ydCB7DQpwdWJsaWM6DQogICAgdmlydHVhbCB+SU9yZGVyUmVwb3NpdG9yeVBvcnQoKSA9IGRlZmF1bHQ7DQogICAgdmlydHVhbCBzdGQ6OnVuaXF1ZV9wdHI8T3JkZXI+IGZpbmRCeUlkKGNvbnN0IHN0ZDo6c3RyaW5nJiBpZCkgPSAwOw0KICAgIHZpcnR1YWwgdm9pZCBzYXZlKGNvbnN0IE9yZGVyJiBvcmRlcikgPSAwOw0KfTsNCg0KLy8gSW5ib3VuZCBQb3J0IC8gUHJpbWFyeSBQb3J0OiBEbyBDb3JlIGN1bmcgY+G6pXAgY2hvIHRo4bq/IGdp4bubaSBiw6puIG5nb8OgaSDEkWnhu4F1IGtoaeG7g24NCmNsYXNzIElQcm9jZXNzUGF5bWVudFVzZUNhc2VQb3J0IHsNCnB1YmxpYzoNCiAgICB2aXJ0dWFsIH5JUHJvY2Vzc1BheW1lbnRVc2VDYXNlUG9ydCgpID0gZGVmYXVsdDsNCiAgICB2aXJ0dWFsIHZvaWQgZXhlY3V0ZShjb25zdCBzdGQ6OnN0cmluZyYgb3JkZXJJZCkgPSAwOw0KfTsNCg0KLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQ0KLy8gMy4gSU5TSURFIFRIRSBIRVhBR09OOiBVU0UgQ0FTRSBJTVBMRU1FTlRBVElPTiAoVsOybmcgMiAtIE9yY2hlc3RyYXRpb24pDQovLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09DQpjbGFzcyBQcm9jZXNzUGF5bWVudFVzZUNhc2UgOiBwdWJsaWMgSVByb2Nlc3NQYXltZW50VXNlQ2FzZVBvcnQgew0KcHJpdmF0ZToNCiAgICBzdGQ6OnNoYXJlZF9wdHI8SU9yZGVyUmVwb3NpdG9yeVBvcnQ+IHJlcG9zaXRvcnlQb3J0XzsNCg0KcHVibGljOg0KICAgIGV4cGxpY2l0IFByb2Nlc3NQYXltZW50VXNlQ2FzZShzdGQ6OnNoYXJlZF9wdHI8SU9yZGVyUmVwb3NpdG9yeVBvcnQ+IHJlcG9Qb3J0KQ0KICAgICAgICA6IHJlcG9zaXRvcnlQb3J0XyhzdGQ6Om1vdmUocmVwb1BvcnQpKSB7fQ0KDQogICAgdm9pZCBleGVjdXRlKGNvbnN0IHN0ZDo6c3RyaW5nJiBvcmRlcklkKSBvdmVycmlkZSB7DQogICAgICAgIHN0ZDo6Y291dCA8PCAiW0hleGFnb24gQ29yZTogVXNlQ2FzZV0gUHJvY2Vzc2luZyBwYXltZW50IGZvciBPcmRlciBJRDogIiA8PCBvcmRlcklkIDw8ICIuLi5cbiI7DQogICAgICAgIGF1dG8gb3JkZXIgPSByZXBvc2l0b3J5UG9ydF8tPmZpbmRCeUlkKG9yZGVySWQpOw0KICAgICAgICBpZiAoIW9yZGVyKSB7DQogICAgICAgICAgICB0aHJvdyBzdGQ6OnJ1bnRpbWVfZXJyb3IoIk9yZGVyIHdpdGggSUQgIiArIG9yZGVySWQgKyAiIG5vdCBmb3VuZCEiKTsNCiAgICAgICAgfQ0KDQogICAgICAgIC8vIFRyaeG7h3UgaOG7k2kgaMOgbmggdmkgY+G7p2EgRW50aXR5DQogICAgICAgIG9yZGVyLT5tYXJrQXNQYWlkKCk7DQoNCiAgICAgICAgLy8gR2hpIGzhuqFpIHRow7RuZyBxdWEgT3V0Ym91bmQgUG9ydA0KICAgICAgICByZXBvc2l0b3J5UG9ydF8tPnNhdmUoKm9yZGVyKTsNCiAgICAgICAgc3RkOjpjb3V0IDw8ICJbSGV4YWdvbiBDb3JlOiBVc2VDYXNlXSBPcmRlciAiIDw8IG9yZGVySWQgPDwgIiBzZXR0bGVkIHN1Y2Nlc3NmdWxseS5cbiI7DQogICAgfQ0KfTsNCg0KLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQ0KLy8gNC4gT1VUU0lERSBUSEUgSEVYQUdPTjogRFJJVkVOIEFEQVBURVJTIChPdXRib3VuZCBJbXBsZW1lbnRhdGlvbnMpDQovLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09DQoNCi8vIERyaXZlbiBBZGFwdGVyIEE6IE1vY2sgSW4tTWVtb3J5IChEw6BuaCBjaG8gVW5pdCBUZXN0aW5nIHNpw6p1IHThu5FjKQ0KY2xhc3MgSW5NZW1vcnlPcmRlckFkYXB0ZXIgOiBwdWJsaWMgSU9yZGVyUmVwb3NpdG9yeVBvcnQgew0KcHJpdmF0ZToNCiAgICBzdGQ6OnVub3JkZXJlZF9tYXA8c3RkOjpzdHJpbmcsIE9yZGVyPiBzdG9yZV87DQpwdWJsaWM6DQogICAgc3RkOjp1bmlxdWVfcHRyPE9yZGVyPiBmaW5kQnlJZChjb25zdCBzdGQ6OnN0cmluZyYgaWQpIG92ZXJyaWRlIHsNCiAgICAgICAgYXV0byBpdCA9IHN0b3JlXy5maW5kKGlkKTsNCiAgICAgICAgaWYgKGl0ICE9IHN0b3JlXy5lbmQoKSkgew0KICAgICAgICAgICAgcmV0dXJuIHN0ZDo6bWFrZV91bmlxdWU8T3JkZXI+KGl0LT5zZWNvbmQpOw0KICAgICAgICB9DQogICAgICAgIHJldHVybiBudWxscHRyOw0KICAgIH0NCg0KICAgIHZvaWQgc2F2ZShjb25zdCBPcmRlciYgb3JkZXIpIG92ZXJyaWRlIHsNCiAgICAgICAgc3RvcmVfLmluc2VydF9vcl9hc3NpZ24ob3JkZXIuaWQoKSwgb3JkZXIpOw0KICAgICAgICBzdGQ6OmNvdXQgPDwgIiAgW0RyaXZlbiBBZGFwdGVyOiBJbi1NZW1vcnldIFBlcnNpc3RlZCBPcmRlciAiIDw8IG9yZGVyLmlkKCkgDQogICAgICAgICAgICAgICAgICA8PCAiIGluIFJBTSBjYWNoZSAoWmVybyBOZXR3b3JrIExhdGVuY3kpLlxuIjsNCiAgICB9DQp9Ow0KDQovLyBEcml2ZW4gQWRhcHRlciBCOiBHaeG6oyBs4bqtcCBQb3N0Z3JlU1FMIEFkYXB0ZXIgKETDoG5oIGNobyBQcm9kdWN0aW9uKQ0KY2xhc3MgUG9zdGdyZXNPcmRlckFkYXB0ZXIgOiBwdWJsaWMgSU9yZGVyUmVwb3NpdG9yeVBvcnQgew0KcHVibGljOg0KICAgIHN0ZDo6dW5pcXVlX3B0cjxPcmRlcj4gZmluZEJ5SWQoY29uc3Qgc3RkOjpzdHJpbmcmIGlkKSBvdmVycmlkZSB7DQogICAgICAgIHN0ZDo6Y291dCA8PCAiICBbRHJpdmVuIEFkYXB0ZXI6IFBvc3RncmVTUUxdIFNRTDogU0VMRUNUICogRlJPTSBvcmRlcnMgV0hFUkUgaWQgPSAnIiA8PCBpZCA8PCAiJztcbiI7DQogICAgICAgIHJldHVybiBzdGQ6Om1ha2VfdW5pcXVlPE9yZGVyPihpZCwgIkNVU1RfVklQXzk5IiwgMTUwJzAwMCk7DQogICAgfQ0KDQogICAgdm9pZCBzYXZlKGNvbnN0IE9yZGVyJiBvcmRlcikgb3ZlcnJpZGUgew0KICAgICAgICBzdGQ6OmNvdXQgPDwgIiAgW0RyaXZlbiBBZGFwdGVyOiBQb3N0Z3JlU1FMXSBTUUw6IFVQREFURSBvcmRlcnMgU0VUIHN0YXR1cyA9ICdQQUlEJyBXSEVSRSBpZCA9ICciIA0KICAgICAgICAgICAgICAgICAgPDwgb3JkZXIuaWQoKSA8PCAiJztcbiI7DQogICAgfQ0KfTsNCg0KLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQ0KLy8gNS4gT1VUU0lERSBUSEUgSEVYQUdPTjogRFJJVklORyBBREFQVEVSIChJbmJvdW5kIEltcGxlbWVudGF0aW9uKQ0KLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQ0KY2xhc3MgT3JkZXJSZXN0SHR0cENvbnRyb2xsZXIgew0KcHJpdmF0ZToNCiAgICBzdGQ6OnNoYXJlZF9wdHI8SVByb2Nlc3NQYXltZW50VXNlQ2FzZVBvcnQ+IHVzZUNhc2VQb3J0XzsNCg0KcHVibGljOg0KICAgIGV4cGxpY2l0IE9yZGVyUmVzdEh0dHBDb250cm9sbGVyKHN0ZDo6c2hhcmVkX3B0cjxJUHJvY2Vzc1BheW1lbnRVc2VDYXNlUG9ydD4gdXNlQ2FzZVBvcnQpDQogICAgICAgIDogdXNlQ2FzZVBvcnRfKHN0ZDo6bW92ZSh1c2VDYXNlUG9ydCkpIHt9DQoNCiAgICB2b2lkIHBvc3RQYXlPcmRlckVuZHBvaW50KGNvbnN0IHN0ZDo6c3RyaW5nJiBvcmRlcklkKSB7DQogICAgICAgIHN0ZDo6Y291dCA8PCAiXG5bRHJpdmluZyBBZGFwdGVyOiBSRVNUIENvbnRyb2xsZXJdIFJlY2VpdmVkIFBPU1QgL2FwaS9vcmRlcnMvIiA8PCBvcmRlcklkIDw8ICIvcGF5XG4iOw0KICAgICAgICB0cnkgew0KICAgICAgICAgICAgdXNlQ2FzZVBvcnRfLT5leGVjdXRlKG9yZGVySWQpOw0KICAgICAgICAgICAgc3RkOjpjb3V0IDw8ICIgIC0+IEhUVFAgMjAwIE9LOiBQYXltZW50IHNldHRsZWQuXG4iOw0KICAgICAgICB9IGNhdGNoIChjb25zdCBzdGQ6OmV4Y2VwdGlvbiYgZXgpIHsNCiAgICAgICAgICAgIHN0ZDo6Y291dCA8PCAiICAtPiBIVFRQIDQwMCBCYWQgUmVxdWVzdDogIiA8PCBleC53aGF0KCkgPDwgIlxuIjsNCiAgICAgICAgfQ0KICAgIH0NCn07DQoNCmludCBtYWluKCkgew0KICAgIHN0ZDo6Y291dCA8PCAiPT09IEMrKzIwIEhleGFnb25hbCBQb3J0cyAmIEFkYXB0ZXJzIEFyY2hpdGVjdHVyZSBEZW1vID09PVxuIjsNCg0KICAgIC8vIEvhu4pDSCBC4bqiTiAxOiBNw5RJIFRSxq/hu5xORyBLSeG7gk0gVEjhu6wgU0nDilUgVOG7kEMgKElOLU1FTU9SWSBBREFQVEVSKQ0KICAgIHN0ZDo6Y291dCA8PCAiXG4tLS0gMS4gVGVzdGluZyBFbnZpcm9ubWVudCB3aXRoIEluLU1lbW9yeSBBZGFwdGVyIC0tLVxuIjsNCiAgICBhdXRvIGluTWVtb3J5UmVwbyA9IHN0ZDo6bWFrZV9zaGFyZWQ8SW5NZW1vcnlPcmRlckFkYXB0ZXI+KCk7DQogICAgLy8gU2VlZCBk4buvIGxp4buHdSB2w6BvIFJBTQ0KICAgIGluTWVtb3J5UmVwby0+c2F2ZShPcmRlcigiT1JELTAwMSIsICJDVVNULTEwIiwgNDknOTAwKSk7DQoNCiAgICBhdXRvIHRlc3RVc2VDYXNlID0gc3RkOjptYWtlX3NoYXJlZDxQcm9jZXNzUGF5bWVudFVzZUNhc2U+KGluTWVtb3J5UmVwbyk7DQogICAgT3JkZXJSZXN0SHR0cENvbnRyb2xsZXIgdGVzdENvbnRyb2xsZXIodGVzdFVzZUNhc2UpOw0KICAgIHRlc3RDb250cm9sbGVyLnBvc3RQYXlPcmRlckVuZHBvaW50KCJPUkQtMDAxIik7DQoNCiAgICAvLyBL4buKQ0ggQuG6ok4gMjogTcOUSSBUUsav4bucTkcgUFJPRFVDVElPTiBW4buaSSBQT1NUR1JFU1FMIEFEQVBURVIgKEtIw5RORyDEkOG7lEkgMSBEw5JORyBDT1JFISkNCiAgICBzdGQ6OmNvdXQgPDwgIlxuLS0tIDIuIFByb2R1Y3Rpb24gRW52aXJvbm1lbnQgd2l0aCBQb3N0Z3JlU1FMIEFkYXB0ZXIgLS0tXG4iOw0KICAgIGF1dG8gcG9zdGdyZXNSZXBvID0gc3RkOjptYWtlX3NoYXJlZDxQb3N0Z3Jlc09yZGVyQWRhcHRlcj4oKTsNCiAgICBhdXRvIHByb2RVc2VDYXNlID0gc3RkOjptYWtlX3NoYXJlZDxQcm9jZXNzUGF5bWVudFVzZUNhc2U+KHBvc3RncmVzUmVwbyk7DQogICAgT3JkZXJSZXN0SHR0cENvbnRyb2xsZXIgcHJvZENvbnRyb2xsZXIocHJvZFVzZUNhc2UpOw0KICAgIHByb2RDb250cm9sbGVyLnBvc3RQYXlPcmRlckVuZHBvaW50KCJPUkQtODg4Iik7DQoNCiAgICByZXR1cm4gMDsNCn0NCmBgYA0KDQojIyMjIFRlcm1pbmFsIE91dHB1dCBN4bqrdSAoQysrMjApOg0KYGBgdGV4dA0KPT09IEMrKzIwIEhleGFnb25hbCBQb3J0cyAmIEFkYXB0ZXJzIEFyY2hpdGVjdHVyZSBEZW1vID09PQ0KDQotLS0gMS4gVGVzdGluZyBFbnZpcm9ubWVudCB3aXRoIEluLU1lbW9yeSBBZGFwdGVyIC0tLQ0KICBbRHJpdmVuIEFkYXB0ZXI6IEluLU1lbW9yeV0gUGVyc2lzdGVkIE9yZGVyIE9SRC0wMDEgaW4gUkFNIGNhY2hlIChaZXJvIE5ldHdvcmsgTGF0ZW5jeSkuDQoNCltEcml2aW5nIEFkYXB0ZXI6IFJFU1QgQ29udHJvbGxlcl0gUmVjZWl2ZWQgUE9TVCAvYXBpL29yZGVycy9PUkQtMDAxL3BheQ0KW0hleGFnb24gQ29yZTogVXNlQ2FzZV0gUHJvY2Vzc2luZyBwYXltZW50IGZvciBPcmRlciBJRDogT1JELTAwMS4uLg0KICBbRHJpdmVuIEFkYXB0ZXI6IEluLU1lbW9yeV0gUGVyc2lzdGVkIE9yZGVyIE9SRC0wMDEgaW4gUkFNIGNhY2hlIChaZXJvIE5ldHdvcmsgTGF0ZW5jeSkuDQpbSGV4YWdvbiBDb3JlOiBVc2VDYXNlXSBPcmRlciBPUkQtMDAxIHNldHRsZWQgc3VjY2Vzc2Z1bGx5Lg0KICAtPiBIVFRQIDIwMCBPSzogUGF5bWVudCBzZXR0bGVkLg0KDQotLS0gMi4gUHJvZHVjdGlvbiBFbnZpcm9ubWVudCB3aXRoIFBvc3RncmVTUUwgQWRhcHRlciAtLS0NCg0KW0RyaXZpbmcgQWRhcHRlcjogUkVTVCBDb250cm9sbGVyXSBSZWNlaXZlZCBQT1NUIC9hcGkvb3JkZXJzL09SRC04ODgvcGF5DQpbSGV4YWdvbiBDb3JlOiBVc2VDYXNlXSBQcm9jZXNzaW5nIHBheW1lbnQgZm9yIE9yZGVyIElEOiBPUkQtODg4Li4uDQogIFtEcml2ZW4gQWRhcHRlcjogUG9zdGdyZVNRTF0gU1FMOiBTRUxFQ1QgKiBGUk9NIG9yZGVycyBXSEVSRSBpZCA9ICdPUkQtODg4JzsNCiAgW0RyaXZlbiBBZGFwdGVyOiBQb3N0Z3JlU1FMXSBTUUw6IFVQREFURSBvcmRlcnMgU0VUIHN0YXR1cyA9ICdQQUlEJyBXSEVSRSBpZCA9ICdPUkQtODg4JzsNCltIZXhhZ29uIENvcmU6IFVzZUNhc2VdIE9yZGVyIE9SRC04ODggc2V0dGxlZCBzdWNjZXNzZnVsbHkuDQogIC0+IEhUVFAgMjAwIE9LOiBQYXltZW50IHNldHRsZWQuDQpgYGANCg0KLS0tDQoNCiMjIyAzLjIuIFB5dGhvbiAzLjExKyBJbXBsZW1lbnRhdGlvbjogQ2xlYW4gQmFua2luZyBBcmNoaXRlY3R1cmUgd2l0aCBQcmltYXJ5L1NlY29uZGFyeSBQb3J0cw0KQ2jGsMahbmcgdHLDrG5oIFB5dGhvbiAzLjExKyBkxrDhu5tpIMSRw6J5IG1pbmggaOG7jWEgdmnhu4djIHRo4buxYyBoaeG7h24gQ2xlYW4gQXJjaGl0ZWN0dXJlIHRodeG6p24gdMO6eSB24bubaSBjw6FjIFByaW1hcnkgLyBTZWNvbmRhcnkgUG9ydHMgxJHhu4tuaCBuZ2jEqWEgYuG6sW5nIGB0eXBpbmcuUHJvdG9jb2xgIHbDoCB0aOG7sWMgdGhpIFVuaXQgVGVzdCB0cm9uZyBi4buZIG5o4bubIFJBTSBtw6Aga2jDtG5nIGPhuqduIGRhdGFiYXNlLg0KDQpgYGBweXRob24NCmZyb20gX19mdXR1cmVfXyBpbXBvcnQgYW5ub3RhdGlvbnMNCmZyb20gZGF0YWNsYXNzZXMgaW1wb3J0IGRhdGFjbGFzcw0KZnJvbSB0eXBpbmcgaW1wb3J0IFByb3RvY29sLCBPcHRpb25hbA0KaW1wb3J0IHVuaXR0ZXN0DQoNCiMgPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQ0KIyAxLiBDT1JFIERPTUFJTjogRU5USVRJRVMgKFbDsm5nIDEgLSBUcsOhaSB0aW0gaOG7hyB0aOG7kW5nKQ0KIyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09DQpjbGFzcyBJbnN1ZmZpY2llbnRCYWxhbmNlRXhjZXB0aW9uKEV4Y2VwdGlvbik6DQogICAgcGFzcw0KDQpAZGF0YWNsYXNzDQpjbGFzcyBBY2NvdW50Og0KICAgIGFjY291bnRfaWQ6IHN0cg0KICAgIG93bmVyX25hbWU6IHN0cg0KICAgIGJhbGFuY2VfdXNkOiBmbG9hdA0KDQogICAgZGVmIHdpdGhkcmF3KHNlbGYsIGFtb3VudDogZmxvYXQpIC0+IE5vbmU6DQogICAgICAgIGlmIGFtb3VudCA8PSAwOg0KICAgICAgICAgICAgcmFpc2UgVmFsdWVFcnJvcigiV2l0aGRyYXdhbCBhbW91bnQgbXVzdCBiZSBwb3NpdGl2ZSIpDQogICAgICAgIGlmIHNlbGYuYmFsYW5jZV91c2QgPCBhbW91bnQ6DQogICAgICAgICAgICByYWlzZSBJbnN1ZmZpY2llbnRCYWxhbmNlRXhjZXB0aW9uKA0KICAgICAgICAgICAgICAgIGYiQWNjb3VudCB7c2VsZi5hY2NvdW50X2lkfSBoYXMgaW5zdWZmaWNpZW50IGZ1bmRzOiAke3NlbGYuYmFsYW5jZV91c2Q6LjJmfSA8ICR7YW1vdW50Oi4yZn0iDQogICAgICAgICAgICApDQogICAgICAgIHNlbGYuYmFsYW5jZV91c2QgLT0gYW1vdW50DQoNCiMgPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQ0KIyAyLiBBUFBMSUNBVElPTiBDT1JFOiBQT1JUUyAoVsOybmcgMiAtIEJvdW5kYXJ5IEludGVyZmFjZXMpDQojID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0NCg0KIyBTZWNvbmRhcnkgUG9ydCAoT3V0Ym91bmQpOiBD4buVbmcgbMawdSB0cuG7rw0KY2xhc3MgQWNjb3VudFJlcG9zaXRvcnlQb3J0KFByb3RvY29sKToNCiAgICBkZWYgZ2V0X2J5X2lkKHNlbGYsIGFjY291bnRfaWQ6IHN0cikgLT4gT3B0aW9uYWxbQWNjb3VudF06IC4uLg0KICAgIGRlZiBzYXZlKHNlbGYsIGFjY291bnQ6IEFjY291bnQpIC0+IE5vbmU6IC4uLg0KDQojIFByaW1hcnkgUG9ydCAoSW5ib3VuZCk6IEPhu5VuZyBuZ2hp4buHcCB24bulDQpjbGFzcyBXaXRoZHJhd0Z1bmRzVXNlQ2FzZVBvcnQoUHJvdG9jb2wpOg0KICAgIGRlZiBleGVjdXRlKHNlbGYsIGFjY291bnRfaWQ6IHN0ciwgYW1vdW50OiBmbG9hdCkgLT4gZmxvYXQ6IC4uLg0KDQojID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0NCiMgMy4gQVBQTElDQVRJT04gQ09SRTogVVNFIENBU0UgSU5URVJBQ1RJT04gKFbDsm5nIDIgLSBJbXBsZW1lbnRhdGlvbikNCiMgPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQ0KY2xhc3MgV2l0aGRyYXdGdW5kc1VzZUNhc2UoV2l0aGRyYXdGdW5kc1VzZUNhc2VQb3J0KToNCiAgICBkZWYgX19pbml0X18oc2VsZiwgcmVwb19wb3J0OiBBY2NvdW50UmVwb3NpdG9yeVBvcnQpOg0KICAgICAgICBzZWxmLl9yZXBvID0gcmVwb19wb3J0DQoNCiAgICBkZWYgZXhlY3V0ZShzZWxmLCBhY2NvdW50X2lkOiBzdHIsIGFtb3VudDogZmxvYXQpIC0+IGZsb2F0Og0KICAgICAgICBhY2NvdW50ID0gc2VsZi5fcmVwby5nZXRfYnlfaWQoYWNjb3VudF9pZCkNCiAgICAgICAgaWYgbm90IGFjY291bnQ6DQogICAgICAgICAgICByYWlzZSBMb29rdXBFcnJvcihmIkFjY291bnQgJ3thY2NvdW50X2lkfScgZG9lcyBub3QgZXhpc3QiKQ0KICAgICAgICANCiAgICAgICAgYWNjb3VudC53aXRoZHJhdyhhbW91bnQpDQogICAgICAgIHNlbGYuX3JlcG8uc2F2ZShhY2NvdW50KQ0KICAgICAgICByZXR1cm4gYWNjb3VudC5iYWxhbmNlX3VzZA0KDQojID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0NCiMgNC4gQURBUFRFUlM6IERSSVZFTiBBREFQVEVSIChWw7JuZyAzLzQgLSBJbi1NZW1vcnkgVGVzdCBJbXBsZW1lbnRhdGlvbikNCiMgPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQ0KY2xhc3MgSW5NZW1vcnlBY2NvdW50QWRhcHRlcihBY2NvdW50UmVwb3NpdG9yeVBvcnQpOg0KICAgIGRlZiBfX2luaXRfXyhzZWxmKToNCiAgICAgICAgc2VsZi5hY2NvdW50czogZGljdFtzdHIsIEFjY291bnRdID0ge30NCg0KICAgIGRlZiBnZXRfYnlfaWQoc2VsZiwgYWNjb3VudF9pZDogc3RyKSAtPiBPcHRpb25hbFtBY2NvdW50XToNCiAgICAgICAgcmV0dXJuIHNlbGYuYWNjb3VudHMuZ2V0KGFjY291bnRfaWQpDQoNCiAgICBkZWYgc2F2ZShzZWxmLCBhY2NvdW50OiBBY2NvdW50KSAtPiBOb25lOg0KICAgICAgICBzZWxmLmFjY291bnRzW2FjY291bnQuYWNjb3VudF9pZF0gPSBhY2NvdW50DQoNCiMgPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQ0KIyA1LiBBREFQVEVSUzogRFJJVklORyBBREFQVEVSIChWw7JuZyAzLzQgLSBGYXN0QVBJIC8gRmxhc2sgQ29udHJvbGxlciBTaW11bGF0b3IpDQojID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0NCmNsYXNzIEJhbmtpbmdBcGlDb250cm9sbGVyOg0KICAgIGRlZiBfX2luaXRfXyhzZWxmLCB3aXRoZHJhd19zZXJ2aWNlOiBXaXRoZHJhd0Z1bmRzVXNlQ2FzZVBvcnQpOg0KICAgICAgICBzZWxmLnNlcnZpY2UgPSB3aXRoZHJhd19zZXJ2aWNlDQoNCiAgICBkZWYgaGFuZGxlX3dpdGhkcmF3X3Bvc3Qoc2VsZiwgYWNjb3VudF9pZDogc3RyLCBhbW91bnQ6IGZsb2F0KSAtPiB0dXBsZVtpbnQsIGRpY3RdOg0KICAgICAgICB0cnk6DQogICAgICAgICAgICBuZXdfYmFsYW5jZSA9IHNlbGYuc2VydmljZS5leGVjdXRlKGFjY291bnRfaWQsIGFtb3VudCkNCiAgICAgICAgICAgIHJldHVybiAyMDAsIHsic3RhdHVzIjogIlNVQ0NFU1MiLCAicmVtYWluaW5nX2JhbGFuY2UiOiBuZXdfYmFsYW5jZX0NCiAgICAgICAgZXhjZXB0IEluc3VmZmljaWVudEJhbGFuY2VFeGNlcHRpb24gYXMgaWJlOg0KICAgICAgICAgICAgcmV0dXJuIDQyMiwgeyJzdGF0dXMiOiAiVU5QUk9DRVNTQUJMRV9FTlRJVFkiLCAiZXJyb3IiOiBzdHIoaWJlKX0NCiAgICAgICAgZXhjZXB0IExvb2t1cEVycm9yIGFzIGxlOg0KICAgICAgICAgICAgcmV0dXJuIDQwNCwgeyJzdGF0dXMiOiAiTk9UX0ZPVU5EIiwgImVycm9yIjogc3RyKGxlKX0NCiAgICAgICAgZXhjZXB0IEV4Y2VwdGlvbiBhcyBlOg0KICAgICAgICAgICAgcmV0dXJuIDUwMCwgeyJzdGF0dXMiOiAiU0VSVkVSX0VSUk9SIiwgImVycm9yIjogc3RyKGUpfQ0KDQoNCmlmIF9fbmFtZV9fID09ICJfX21haW5fXyI6DQogICAgcHJpbnQoIj09PSBQeXRob24gMy4xMSsgQ2xlYW4gQXJjaGl0ZWN0dXJlIEJhbmsgTGVkZ2VyIERlbW8gPT09IikNCiAgICANCiAgICAjIFRoaeG6v3QgbOG6rXAgRHJpdmVuIEFkYXB0ZXIgKEluLU1lbW9yeSkNCiAgICBtZW1vcnlfcmVwbyA9IEluTWVtb3J5QWNjb3VudEFkYXB0ZXIoKQ0KICAgIG1lbW9yeV9yZXBvLnNhdmUoQWNjb3VudCgiQUNDLTAwNyIsICJKYW1lcyBCb25kIiwgNTAwMC4wMCkpDQoNCiAgICAjIEto4bufaSB04bqhbyBMw7VpIE5naGnhu4dwIFbhu6UNCiAgICB1c2VfY2FzZSA9IFdpdGhkcmF3RnVuZHNVc2VDYXNlKHJlcG9fcG9ydD1tZW1vcnlfcmVwbykNCg0KICAgICMgS2jhu59pIHThuqFvIERyaXZpbmcgQWRhcHRlcg0KICAgIGNvbnRyb2xsZXIgPSBCYW5raW5nQXBpQ29udHJvbGxlcih3aXRoZHJhd19zZXJ2aWNlPXVzZV9jYXNlKQ0KDQogICAgIyBUaOG7rSBuZ2hp4buHbSAxOiBSw7p0IHRp4buBbiB0aMOgbmggY8O0bmcNCiAgICBzdGF0dXMsIHBheWxvYWQgPSBjb250cm9sbGVyLmhhbmRsZV93aXRoZHJhd19wb3N0KCJBQ0MtMDA3IiwgMTIwMC4wMCkNCiAgICBwcmludChmIlxuW1Rlc3QgMV0gV2l0aGRyYXcgJDEyMDAuMDAgLT4gSFRUUCB7c3RhdHVzfSB8IFJlc3BvbnNlOiB7cGF5bG9hZH0iKQ0KDQogICAgIyBUaOG7rSBuZ2hp4buHbSAyOiBSw7p0IHRp4buBbiB2xrDhu6N0IGjhuqFuIG3hu6ljIChWaSBwaOG6oW0gRG9tYWluIFJ1bGUpDQogICAgc3RhdHVzLCBwYXlsb2FkID0gY29udHJvbGxlci5oYW5kbGVfd2l0aGRyYXdfcG9zdCgiQUNDLTAwNyIsIDEwMDAwLjAwKQ0KICAgIHByaW50KGYiXG5bVGVzdCAyXSBXaXRoZHJhdyAkMTAsMDAwLjAwIC0+IEhUVFAge3N0YXR1c30gfCBSZXNwb25zZToge3BheWxvYWR9IikNCg0KICAgICMgVGjhu60gbmdoaeG7h20gMzogVMOgaSBraG/huqNuIGtow7RuZyB04buTbiB04bqhaQ0KICAgIHN0YXR1cywgcGF5bG9hZCA9IGNvbnRyb2xsZXIuaGFuZGxlX3dpdGhkcmF3X3Bvc3QoIkFDQy05OTkiLCA1MC4wMCkNCiAgICBwcmludChmIlxuW1Rlc3QgM10gV2l0aGRyYXcgZnJvbSBub24tZXhpc3RlbnQgYWNjb3VudCAtPiBIVFRQIHtzdGF0dXN9IHwgUmVzcG9uc2U6IHtwYXlsb2FkfSIpDQpgYGANCg0KIyMjIyBUZXJtaW5hbCBPdXRwdXQgTeG6q3UgKFB5dGhvbiAzLjExKyk6DQpgYGB0ZXh0DQo9PT0gUHl0aG9uIDMuMTErIENsZWFuIEFyY2hpdGVjdHVyZSBCYW5rIExlZGdlciBEZW1vID09PQ0KDQpbVGVzdCAxXSBXaXRoZHJhdyAkMTIwMC4wMCAtPiBIVFRQIDIwMCB8IFJlc3BvbnNlOiB7J3N0YXR1cyc6ICdTVUNDRVNTJywgJ3JlbWFpbmluZ19iYWxhbmNlJzogMzgwMC4wfQ0KDQpbVGVzdCAyXSBXaXRoZHJhdyAkMTAsMDAwLjAwIC0+IEhUVFAgNDIyIHwgUmVzcG9uc2U6IHsnc3RhdHVzJzogJ1VOUFJPQ0VTU0FCTEVfRU5USVRZJywgJ2Vycm9yJzogJ0FjY291bnQgQUNDLTAwNyBoYXMgaW5zdWZmaWNpZW50IGZ1bmRzOiAkMzgwMC4wMCA8ICQxMDAwMC4wMCd9DQoNCltUZXN0IDNdIFdpdGhkcmF3IGZyb20gbm9uLWV4aXN0ZW50IGFjY291bnQgLT4gSFRUUCA0MDQgfCBSZXNwb25zZTogeydzdGF0dXMnOiAnTk9UX0ZPVU5EJywgJ2Vycm9yJzogIkFjY291bnQgJ0FDQy05OTknIGRvZXMgbm90IGV4aXN0In0NCmBgYA0KDQotLS0NCg0KIyMgNC4gU3lzdGVtcyBFbmdpbmVlcmluZyAmIFByb2R1Y3Rpb24gUGl0ZmFsbHMNCg0KIyMjIEPDoWMgQ+G6oW0gQuG6q3kgVGjhu7FjIENoaeG6v24gKEdvdGNoYXMgJiBQcm9kdWN0aW9uIEFudGlwYXR0ZXJucykNCg0KMS4gKirDlCBOaGnhu4VtIEVudGl0eSBC4bufaSBBbm5vdGF0aW9ucyBj4bunYSBGcmFtZXdvcmsgKEVudGl0eSBGcmFtZXdvcmsgUG9sbHV0aW9uKSoqOg0KICAgLSAqQuG6o24gY2jhuqV0KjogTOG6rXAgdHLDrG5oIHZpw6puIGfhuq9uIHRy4buxYyB0aeG6v3AgY8OhYyBhbm5vdGF0aW9ucyBuaMawIGBARW50aXR5YCwgYEBUYWJsZShuYW1lPSJvcmRlcnMiKWAsIGBASnNvblByb3BlcnR5YCBob+G6t2MgYEBCc29uSWRgIGzDqm4gY8OhYyBFbnRpdGllcyB0cm9uZyBEb21haW4gTGF5ZXIuIFZp4buHYyBuw6B5IHBow6EgaOG7p3kgaG/DoG4gdG/DoG4gbmd1ecOqbiB04bqvYyBj4buRdCBsw7VpOiBEb21haW4ga2jDtG5nIGPDsm4gxJHhu5ljIGzhuq1wIG3DoCBi4buLIHRyw7NpIGNo4bq3dCB2w6BvIE9STSBmcmFtZXdvcmsgxJHDsy4NCiAgIC0gKkto4bqvYyBwaOG7pWMqOiBUw6FjaCBy4budaSAyIGzhu5twIHRo4buxYyB0aOG7gyByacOqbmcgYmnhu4d0OiAqKkRvbWFpbiBFbnRpdHkqKiAodGh14bqnbiB0w7p5IGtow7RuZyBhbm5vdGF0aW9ucykgdsOgICoqUGVyc2lzdGVuY2UgRW50aXR5IC8gRGF0YSBNb2RlbCoqIChjaOG7qWEgYW5ub3RhdGlvbnMgY+G7p2EgT1JNKS4gU+G7rSBk4bulbmcgRGF0YSBNYXBwZXIg4bufIHThuqduZyBJbmZyYXN0cnVjdHVyZSDEkeG7gyBjaHV54buDbiDEkeG7lWkgcXVhIGzhuqFpLg0KDQoyLiAqKkNoaSBQaMOtIMOBbmggWOG6oSBE4buvIExp4buHdSBEw6B5IMSQ4bq3YyAoTWFwcGluZyBPdmVyaGVhZCBUYXgpKio6DQogICAtICpC4bqjbiBjaOG6pXQqOiBW4bubaSBt4buXaSByZXF1ZXN0LCBk4buvIGxp4buHdSBwaOG6o2kgxJHGsOG7o2Mgw6FuaCB44bqhIHF1YSA0IGPhuqVwIMSR4buZOiBIVFRQIEpTT04gJFx0byQgUmVxdWVzdCBEVE8gJFx0byQgRG9tYWluIEVudGl0eSAkXHRvJCBPUk0gUGVyc2lzdGVuY2UgRW50aXR5ICRcdG8kIERhdGFiYXNlIFJvdyAodsOgIG5nxrDhu6NjIGzhuqFpIOG7nyBjaGnhu4F1IHRy4bqjIHbhu4EpLiBUcm9uZyBjw6FjIGjhu4cgdGjhu5FuZyB44butIGzDvSBow6BuZyB0csSDbSBuZ8OgbiByZXF1ZXN0cy9nacOieSwgdmnhu4djIGPhuqVwIHBow6F0IHbDoCBzYW8gY2jDqXAgbGnDqm4gdOG7pWMgaMOgbmcgdHJp4buHdSBvYmplY3QgdOG6oW0gdGjhu51pIG7DoHkgZ8OieSDDoXAgbOG7sWMga2jhu5VuZyBs4buTIGzDqm4gQ1BVIE1lbW9yeSBCdXMgdsOgIGvDrWNoIGhv4bqhdCBHYXJiYWdlIENvbGxlY3RvciBsacOqbiB04bulYy4NCiAgIC0gKkto4bqvYyBwaOG7pWMqOiBW4bubaSBjw6FjIGjhu4cgdGjhu5FuZyBIaWdoLVRocm91Z2hwdXQgLyBMb3ctTGF0ZW5jeSwgw6FwIGThu6VuZyBDUVJTIMSR4buDIGJ5cGFzcyB0b8OgbiBi4buZIG1hcHBpbmcg4bufIMSRxrDhu51uZyBk4bqrbiDEkeG7jWMgKFJlYWQgUXVlcmllcykuDQoNCjMuICoqSGnhu4duIFTGsOG7o25nIE3DtCBIw6xuaCBOZ2hp4buHcCBW4bulIFRoaeG6v3UgTcOhdSAoQW5lbWljIERvbWFpbiBNb2RlbCkqKjoNCiAgIC0gKkLhuqNuIGNo4bqldCo6IFThuqFvIHJhIENsZWFuIEFyY2hpdGVjdHVyZSB24bubaSDEkeG6p3kgxJHhu6cgY8OhYyB2w7JuZyB0csOybiBuaMawbmcgRW50aXRpZXMgbOG6oWkgY2jhu4kgY2jhu6lhIGPDoWMgdHLGsOG7nW5nIGBwcml2YXRlYCB24bubaSBnZXR0ZXJzL3NldHRlcnMgcuG7l25nIHR14bq/Y2guIFRvw6BuIGLhu5kgbG9naWMgbmdoaeG7h3AgduG7pSBi4buLIGThu5NuIGjhur90IHbDoG8gVXNlIENhc2VzLCBiaeG6v24gVXNlIENhc2VzIHRow6BuaCBjw6FjIGjDoG0gdGjhu6cgdOG7pWMga2jhu5VuZyBs4buTIChQcm9jZWR1cmFsIFNjcmlwdHMpLCB2aSBwaOG6oW0gdMOtbmggxJHDs25nIGfDs2kgY+G7p2EgT09QLg0KICAgLSAqS2jhuq9jIHBo4bulYyo6IMSQxrBhIGPDoWMgcXV5IHThuq9jIHTDrW5oIHRvw6FuLCB0aOG6qW0gxJHhu4tuaCB2w6AgYmnhur9uIMSR4buVaSB0cuG6oW5nIHRow6FpIHRy4bufIHbhu4EgY2jDrW5oIGLDqm4gdHJvbmcgY8OhYyBFbnRpdGllczsgVXNlIENhc2UgY2jhu4kgbMOgbSBuaGnhu4dtIHbhu6UgxJFp4buBdSBwaOG7kWkgdsOgIGdpYW8gdGnhur9wIHbhu5tpIFBvcnRzLg0KDQo0LiAqKkvhu7kgVGh14bqtdCBDaOG6qW4gxJBvw6FuICYgR2nDoW0gU8OhdCBLaeG6v24gVHLDumMgQuG6sW5nIENMSSoqOg0KICAgYGBgYmFzaA0KICAgIyAxLiBRdcOpdCB2aSBwaOG6oW0gVGhlIERlcGVuZGVuY3kgUnVsZSBi4bqxbmcgQXJjaFVuaXQgQ0xJIHRyb25nIEphdmEvS290bGluDQogICBhcmNodW5pdC1jbGkgY2hlY2sgLS1ydWxlcyBjbGVhbi1hcmNoaXRlY3R1cmUtcnVsZXMueG1sIHRhcmdldC9jbGFzc2VzDQoNCiAgICMgMi4gS2nhu4NtIHRyYSBjw6FjIG1vZHVsZSBEb21haW4gYuG7iyBwaOG7pSB0aHXhu5ljIG5nxrDhu6NjIHJhIG5nb8OgaSBi4bqxbmcgRGVwZW5kYWJvdCAvIERlcHRyYWMgQ0xJDQogICBkZXB0cmFjIGFuYWx5emUgLS1jb25maWctZmlsZT1kZXBmaWxlLnlhbWwNCg0KICAgIyAzLiBCZW5jaG1hcmsgdGjhu51pIGdpYW4gY2jhuqF5IGPhu6dhIFVuaXQgVGVzdHMgQ2xlYW4gQXJjaGl0ZWN0dXJlIChSQU0gdnMgREIpDQogICBweXRlc3QgdGVzdHMvdW5pdC8gLXYgLS1iZW5jaG1hcmstb25seQ0KICAgYGBgDQoNCi0tLQ0KDQojIyA1LiBC4bqjbmcgU28gc8OhbmggJiBEZWNpc2lvbiBNYXRyaXgNCg0KIyMjIDUuMS4gU28gU8OhbmggQ2hpIFRp4bq/dCBDw6FjIFRyxrDhu51uZyBQaMOhaSBLaeG6v24gVHLDumMgSMaw4bubbmcgTmdoaeG7h3AgVuG7pQ0KDQp8IFRpw6p1IENow60gfCBUcmFkaXRpb25hbCBMYXllcmVkIHwgSGV4YWdvbmFsIChQb3J0cyAmIEFkYXB0ZXJzKSB8IE9uaW9uIEFyY2hpdGVjdHVyZSB8IENsZWFuIEFyY2hpdGVjdHVyZSB8DQp8IDotLS0gfCA6LS0tIHwgOi0tLSB8IDotLS0gfCA6LS0tIHwNCnwgKipUw6FjIEdp4bqjICYgTsSDbSoqIHwgTi1UaWVyIFN0YW5kYXJkcyAoMTk5MHMpIHwgQWxpc3RhaXIgQ29ja2J1cm4gKDIwMDUpIHwgSmVmZnJleSBQYWxlcm1vICgyMDA4KSB8IFJvYmVydCBDLiBNYXJ0aW4gKDIwMTIpIHwNCnwgKipUcuG7jW5nIFTDom0qKiB8IFThuqduZyBDxqEgc+G7nyBk4buvIGxp4buHdSB8IEPhu5VuZyB0aeG6v3Agbmjhuq1uIChQb3J0cykgfCBEb21haW4gTW9kZWwgJiBTZXJ2aWNlcyB8IFRoZSBEZXBlbmRlbmN5IFJ1bGUgfA0KfCAqKkjDrG5oIFRow6FpIFRy4buxYyBRdWFuKiogfCBDw6FjIHRoYW5oIHjhur9wIG5nYW5nIHwgS2jhu5FpIGzhu6VjIGdpw6FjIMSR4buRaSB44bupbmcgfCBDw6FjIHbDsm5nIHRyw7JuIGPhu6cgaMOgbmggfCBC4buRbiB2w7JuZyB0csOybiDEkeG7k25nIHTDom0gfA0KfCAqKlRodeG6rXQgTmfhu68gQmnDqm4qKiB8IERBTCAvIFByZXNlbnRhdGlvbiB8IERyaXZpbmcgLyBEcml2ZW4gQWRhcHRlcnMgfCBJbmZyYXN0cnVjdHVyZSAvIFVJIHwgSW50ZXJmYWNlIEFkYXB0ZXJzIHwNCnwgKipN4bupYyDEkOG7mSBDw7QgTOG6rXAgRG9tYWluKiogfCBUaOG6pXAgKERvbWFpbiBkw61uaCBEQikgfCAqKlR1eeG7h3QgxJHhu5FpKiogfCAqKlR1eeG7h3QgxJHhu5FpKiogfCAqKlR1eeG7h3QgxJHhu5FpKiogfA0KfCAqKkto4bqjIE7Eg25nIMSQ4buVaSBEQioqIHwgS2jDsyBraMSDbiB8IEThu4UgbmjGsCBj4bqvbSBVU0IgfCBE4buFIG5oxrAgY+G6r20gVVNCIHwgROG7hSBuaMawIGPhuq9tIFVTQiB8DQoNCiMjIyA1LjIuIE1hIFRy4bqtbiBRdXnhur90IMSQ4buLbmggTOG7sWEgQ2jhu41uIEtp4bq/biBUcsO6YyBDaG8gROG7sSDDgW4gTeG7m2kNCg0KfCBRdXkgTcO0ICYgxJDhurdjIMSQaeG7g20gQsOgaSBUb8OhbiB8IE7Dqm4gQ2jhu41uIFBob25nIEPDoWNoIHwgTMO9IERvIEvhu7kgVGh14bqtdCB8DQp8IDotLS0gfCA6LS0tIHwgOi0tLSB8DQp8ICoqTVZQLCBTdGFydHVwIG5n4bqvbiBo4bqhbiAoPCA2IHRow6FuZykqKiB8IFRyYWRpdGlvbmFsIDMtVGllciBMYXllcmVkIHwgVOG7kWMgxJHhu5kgcmEgbeG6r3QgbMOgIHThu5FpIHRoxrDhu6NuZzsga2jDtG5nIGPhuqduIGNoaSBwaMOtIG1hcHBpbmcgcGjhu6ljIHThuqFwIHwNCnwgKirhu6huZyBk4bulbmcgQ1JVRCB0aHXhuqduIHTDunksIMOtdCBidXNpbmVzcyBsb2dpYyoqIHwgQWN0aXZlIFJlY29yZCAvIExheWVyZWQgfCBUcsOhbmggYuG6q3kgT3Zlci1lbmdpbmVlcmluZzsgQ2xlYW4gQXJjaGl0ZWN0dXJlIHPhur0gYmnhur9uIHRow6BuaCBTaW5raG9sZSB8DQp8ICoqRmluVGVjaCwgQ29yZSBCYW5raW5nLCBC4bqjbyBIaeG7g20qKiB8ICoqQ2xlYW4gLyBIZXhhZ29uYWwgQXJjaGl0ZWN0dXJlKiogfCBMb2dpYyBuZ2hp4buHcCB24bulIHBo4bupYyB04bqhcCwgY+G6p24gdOG7k24gdOG6oWkgMTAtMjAgbsSDbSwgecOqdSBj4bqndSBraeG7g20gdGjhu60gMTAwJSBSQU0gfA0KfCAqKkjhu4cgdGjhu5FuZyBNaWNyb3NlcnZpY2VzIHF1eSBtw7QgbOG7m24qKiB8IEhleGFnb25hbCBBcmNoaXRlY3R1cmUgcGVyIFNlcnZpY2UgfCBN4buXaSBtaWNyb3NlcnZpY2UgdOG7sSBi4bqjbyB24buHIHJhbmggZ2nhu5tpIERvbWFpbiBj4bunYSBtw6xuaCDEkeG7mWMgbOG6rXAgduG7m2kgdHJhbnNwb3J0IHwNCg==