Chế độ giao diện
6.3. Kỹ Nghệ Hợp Đồng Giao Diện và Tiến Hóa Schema (API Contract Engineering & Schema Evolution)
IMPORTANT
Nếu bạn chỉ được nhớ một điều duy nhất: API không chỉ là mã nguồn hay đường dẫn mạng mà là bản cam kết pháp lý và kỹ thuật bất biến giữa các hệ thống độc lập — mọi sự thay đổi phá vỡ tương thích ngược (Breaking Change) đều là một lỗi nghiêm trọng của kiến trúc; tiến hóa schema an toàn bắt buộc phải áp dụng nguyên lý Additive Changes, mẫu thiết kế Tolerant Reader, kiểm thử Consumer-Driven Contracts (Pact) và chính sách khai tử chuẩn mực với HTTP Sunset Header (RFC 8594).
1. Kiến trúc Tổng quan & Mô hình Tư duy (Mental Model)
Ẩn dụ Đời sống: Bản Vẽ Quy Hoạch Xây Dựng và Hợp Đồng Thương Mại Quốc Tế
Hãy hình dung kỹ nghệ hợp đồng API tương tự như việc quản lý Bản vẽ kỹ thuật trong xây dựng một đại đô thị:
- Contract Specifications (Bản Vẽ Kỹ Thuật Đóng Dấu Đỏ): Trước khi đặt bất kỳ viên gạch nào (viết code), kiến trúc sư trưởng phát hành bản vẽ tiêu chuẩn (OpenAPI / Protobuf IDL). Đội điện, đội nước và đội xây thô (Client và Server teams) căn cứ vào bản vẽ này để thi công song song độc lập mà không cần chờ đợi nhau.
- Breaking Changes vs Additive Changes (Đập Bỏ Cột Trụ vs Lắp Thêm Ổ Cắm Điện):
- Breaking Change: Đột ngột dời cột trụ chịu lực hoặc thu nhỏ kích thước cửa thoát hiểm (Xóa trường, đổi kiểu dữ liệu). Toàn bộ cư dân và xe cộ đang lưu thông lập tức gặp tai nạn (Client crash toàn diện).
- Additive Change: Lắp thêm một ổ cắm điện dự phòng trên tường (Thêm trường mới). Cư dân cũ không dùng ổ cắm này vẫn sinh hoạt bình thường; cư dân mới có thể cắm thêm thiết bị thông minh.
- Tolerant Reader Pattern (Người Đọc Khoan Dung): Người mua nhà chỉ quan tâm đến phòng ngủ và phòng bếp của họ. Nếu nhà thầu sơn thêm một họa tiết mới trên trần nhà mà họ chưa từng thấy, họ chỉ lướt qua mà không ngất xỉu hay khiếu nại (Client bỏ qua các trường lạ mà nó không nhận biết).
- Consumer-Driven Contracts - CDC (Yêu Cầu Từ Người Tiêu Dùng): Thay vì chủ đầu tư tự ý xây những tiện ích không ai dùng, cư dân (Consumers) gửi trước danh sách các tiện ích tối thiểu mà họ bắt buộc phải có để sống. Chủ đầu tư (Provider) cam kết trong hợp đồng không được cắt giảm bất kỳ tiện ích nào trong danh sách đó.
- API Versioning (Quy Hoạch Giai Đoạn 1 và Giai Đoạn 2): Khi công nghệ thay đổi hoàn toàn (từ đường dây đồng sang cáp quang quang học), thành phố mở một phân khu mới (/v2/) thay vì cắt đứt đường dây của toàn bộ khu dân cư cũ (/v1/).
- Sunset Header (Thông Báo Giải Tỏa Mặt Bằng Có Kỳ Hạn): Chính quyền phát thông báo: "Tuyến đường cũ sẽ chính thức đóng vào ngày 31/12/2026. Xin vui lòng chuyển sang đường cao tốc mới" (
Sunset: RFC 8594). Không bao giờ có chuyện sáng ngủ dậy thấy đường bị rào chắn đột ngột không báo trước.
flowchart TD
subgraph ContractSpec["1. Định Nghĩa Hợp Đồng (Contract Specifications)"]
OAS["OpenAPI 3.1 / Swagger (REST YAML/JSON)"]
Proto["Protobuf IDL (.proto Binary Schema)"]
JSONSchema["JSON Schema & GraphQL SDL"]
end
subgraph EvolutionGovernance["2. Quản Trị Tiến Hóa Schema (Evolution)"]
direction TB
ChangeDecision{Đánh Giá Thay Đổi}
NonBreak["Non-Breaking (Additive Changes)<br/>- Thêm trường mới tùy chọn<br/>- Tolerant Reader Pattern"]
Break["Breaking Changes<br/>- Xóa trường / Đổi kiểu / Thêm required field"]
end
subgraph VersioningAndLifecycle["3. Vòng Đời & Phiên Bản (Lifecycle)"]
URI_V["URI Versioning: /v1 $\to$ /v2"]
Sunset["RFC 8594 Sunset Header<br/>Deprecation Notice (6-12 tháng)"]
CDC["Consumer-Driven Contract Testing (Pact CI/CD)"]
end
ContractSpec --> ChangeDecision
ChangeDecision -->|An toàn| NonBreak
ChangeDecision -->|Nguy hiểm| Break
Break --> URI_V
URI_V --> Sunset
NonBreak --> CDC
Break --> CDC
2. Chi tiết từng Keyword (Under-the-Hood Deep Dive)
2.1. Contract Specifications: OpenAPI, Swagger, JSON Schema & Protobuf
1. OpenAPI Specification (OAS 3.0 / 3.1) & Swagger
- Bản chất: Tiêu chuẩn đặc tả giao diện lập trình hướng tài nguyên mở dựa trên cấu trúc YAML hoặc JSON, hoàn toàn độc lập với ngôn ngữ lập trình.
- Giá trị cốt lõi trong quy trình API-First Design:
- Single Source of Truth: File
openapi.yamllà bản hợp đồng duy nhất giữa Backend, Frontend, Mobile và QA. - Automated Code Generation: Dùng công cụ
openapi-generator-cliđể sinh tự động Client SDKs (TypeScript, Swift, Kotlin, Dart) và Server Stubs (Go, Java, Python, C++). - Interactive Documentation: Tích hợp Swagger UI / Redoc giúp lập trình viên thử nghiệm trực tiếp API trên trình duyệt.
- Contract Mocking: Tự động khởi chạy Mock Server (Prism, WireMock) dựa trên schema để Frontend có thể lập trình ngay cả khi Backend chưa code xong một dòng nào.
- Single Source of Truth: File
2. JSON Schema (Draft 2020-12)
- Cung cấp cơ chế thẩm định (Validation) cấu trúc dữ liệu JSON chặt chẽ tại runtime: kiểm tra kiểu dữ liệu (
type: "string"), độ dài tối thiểu (minLength: 8), định dạng đặc biệt (format: "email",format: "uuid"), và các ràng buộc tổ hợp (oneOf,anyOf,allOf).
3. Protocol Buffers (Protobuf IDL - Google)
- Cơ chế Field Tags: Trong file
.proto, mỗi thuộc tính được gán một số nguyên dương bất biến gọi là Field Tag / Number:protobufmessage UserResponse { uint64 id = 1; string username = 2; string email = 3; }1
2
3
4
5 - Tại sao Field Tag giải quyết triệt để bài toán tiến hóa schema? Khi mã hóa nhị phân, Protobuf không bao giờ gửi tên trường (
"username"tốn 8 bytes), mà chỉ gửi cặp giá trị:(Field Tag << 3 | Wire Type)chiếm đúng 1 byte. Nhờ đó:- Ta có thể đổi tên trường từ
usernamethànhdisplay_nametrong code mà không làm gãy kết nối nhị phân, miễn là Tag2được giữ nguyên. - Server gửi trường Tag
4mới, Client phiên bản cũ không biết Tag4là gì sẽ tự động bỏ qua (Unknown Field skipping) mà không crash.
- Ta có thể đổi tên trường từ
2.2. Schema Evolution: Breaking vs Non-Breaking Changes & Versioning Strategies
1. Bản Chất của Breaking Changes (Thay Đổi Gây Gãy Đổ)
Một thay đổi được coi là Breaking nếu nó phá vỡ giả định của Client đang chạy:
- Xóa bỏ (Removing) một trường dữ liệu trong Response hoặc một Endpoint.
- Đổi tên (Renaming) trường dữ liệu (Client tìm kiếm key cũ sẽ nhận về
undefined/null). - Thay đổi kiểu dữ liệu (Type Mutation): Đổi trường
idtừ số nguyênint64sang chuỗistring UUID(Gây lỗi giải mã kiểu dữ liệu nghiêm trọng). - Thêm trường bắt buộc mới (New Required Field) trong Request Payload (Client cũ không gửi trường này sẽ bị Server từ chối bằng lỗi
400 Bad Request). - Thu hẹp miền giá trị chấp nhận: Ví dụ trường
statustrước đây chấp nhận chuỗi bất kỳ, nay chỉ chấp nhận Enum["ACTIVE", "INACTIVE"].
2. Non-Breaking Changes (Thay Đổi An Toàn / Additive Changes)
- Thêm trường mới tùy chọn (Optional Field) vào Request payload (đi kèm giá trị mặc định).
- Thêm trường mới vào Response payload: Được coi là an toàn nếu Client tuân thủ nguyên lý Tolerant Reader Pattern (nguyên lý của Martin Fowler: hệ thống chỉ trích xuất những trường nó cần và phớt lờ các trường chưa biết).
- Thêm một Endpoint hoàn toàn mới (
POST /v1/orders/bulk-cancel).
3. Các Chiến Lược Quản Lý Phiên Bản (API Versioning Strategies)
| Chiến Lược | Cú Pháp Minh Họa | Ưu Điểm Kỹ Thuật | Nhược Điểm / Đánh Đổi |
|---|---|---|---|
| URI Versioning (Khuyên dùng) | https://api.corp.com/v1/ordershttps://api.corp.com/v2/orders | Cực kỳ rõ ràng, trực quan. Định tuyến (Routing) tại API Gateway/Nginx rất dễ dàng. Hỗ trợ caching tuyệt đối. | Tạo ra nhiều endpoints trùng lặp; vi phạm thuần túy lý thuyết REST (URI nên đại diện cho tài nguyên, không phải phiên bản). |
| Header Versioning (Custom Header) | X-API-Version: 2 | URI sạch sẽ, giữ nguyên địa chỉ tài nguyên. | Khó kiểm thử trên thanh địa chỉ trình duyệt. Phức tạp khi cấu hình CDN Caching (Cần cấu hình Vary: X-API-Version). |
| Content Negotiation (Accept Header) | Accept: application/vnd.corp.v2+json | Chuẩn mực học thuật REST nhất (HATEOAS). | Rất khó hiểu cho các lập trình viên mới, phức tạp khi gọi bằng cURL hoặc Postman. |
| Query Parameter | https://api.corp.com/orders?version=2 | Dễ truyền tham số, có giá trị mặc định. | Dễ xung đột với các bộ lọc phân trang và caching. |
2.3. Consumer-Driven Contracts (CDC) & Deprecation Policy
1. Consumer-Driven Contract Testing (Pact Framework)
- Vấn đề của End-to-End Testing truyền thống: Trong kiến trúc 50 Microservices, việc dựng toàn bộ 50 services lên môi trường Test để chạy integration tests cực kỳ chậm chạp, tốn kém tài nguyên và thường xuyên bị lỗi chập chờn (Flaky Tests).
- Cơ chế Consumer-Driven Contracts:
- Consumer định nghĩa nhu cầu: Client tạo một hợp đồng kiểm thử (Pact File JSON): "Tôi gọi GET /v1/users/101, tôi mong đợi HTTP 200 và response tối thiểu phải có trường name kiểu string".
- Publish Pact: Pact File được tải lên máy chủ trung tâm Pact Broker.
- Provider tự động xác thực: Trong pipeline CI/CD của Provider (Backend), một test suite tự động nạp toàn bộ Pact Files từ Pact Broker và chạy giả lập trên code hiện tại của Provider.
- Can-I-Deploy Gate: Nếu Provider sửa code làm mất trường
name, build pipeline sẽ bị chặn đứng ngay lập tức với thông báo: "Consumer Mobile App v3.2 sẽ bị gãy đổ nếu bản build này được deploy!".
sequenceDiagram
autonumber
participant Consumer as Consumer CI (Client)
participant Broker as Central Pact Broker
participant Provider as Provider CI (Backend Service)
Consumer->>Consumer: Run Unit Test with Mock Provider
Consumer->>Broker: Publish Pact Contract (pact.json)
Note over Broker: Lưu trữ hợp đồng và phiên bản Consumer
Provider->>Broker: Fetch latest Consumer Contracts
Provider->>Provider: Replay requests against Real Controller
alt Hợp đồng được bảo toàn
Provider->>Broker: Contract Verification: PASSED
Provider->>Provider: can-i-deploy -> OK (Deploy to Prod)
else Phát hiện Breaking Change
Provider->>Broker: Contract Verification: FAILED!
Provider->>Provider: can-i-deploy -> BLOCKED!
end
2. Chính Sách Khai Tử API & Tiêu Chuẩn RFC 8594 Sunset Header
- Quy trình khai tử chuẩn mực (Deprecation Lifecycle):
- Giai đoạn Thông báo (Announcement): Duy trì phiên bản cũ tối thiểu từ 6 đến 12 tháng.
- Giai đoạn Gắn nhãn kỹ thuật (Technical Notice): Trả về HTTP Headers chuẩn mực trên mọi response của phiên bản cũ:
Deprecation: true(hoặc@deprecatedtimestamp).Sunset: Wed, 11 Nov 2026 00:00:00 GMT(Chỉ định chính xác thời điểm tắt server vĩnh viễn theo RFC 8594).Link: <https://api.corp.com/v2/migration-guide>; rel="sunset".
- Giai đoạn Brownout (Tắt thử nghiệm): 1 tháng trước ngày Sunset, tắt API cũ trong 15 phút vào giờ thấp điểm để kiểm tra xem còn hệ thống nào quên chưa chuyển đổi.
- Giai đoạn Tắt vĩnh viễn (Decommissioning): Chuyển toàn bộ lưu lượng của URL cũ sang mã phản hồi
410 Gone.
3. Thực thi Mã nguồn & Mô phỏng Chuyên sâu (Dual-Engine Implementation)
3.1. Phiên bản C++20: Bộ Thẩm Định Hợp Đồng Schema & Middleware Tự Động Gắn RFC 8594 Sunset Header
cpp
#include <iostream>
#include <string>
#include <vector>
#include <memory>
#include <format>
#include <unordered_map>
#include <chrono>
#include <optional>
#include <stdexcept>
// ============================================================================
// 1. CONTRACT DEFINITION & SCHEMA VALIDATOR
// ============================================================================
struct UserProfileContractV1 {
uint64_t id;
std::string fullName;
std::string email; // Bắt buộc ở v1
};
struct UserProfileContractV2 {
uint64_t id;
std::string firstName;
std::string lastName;
std::string corporateEmail;
std::optional<std::string> secondaryEmail; // Additive change (Optional)
};
// ============================================================================
// 2. HTTP ENVELOPE & SUNSET MIDDLEWARE (RFC 8594)
// ============================================================================
struct HttpResponseContext {
int statusCode;
std::unordered_map<std::string, std::string> headers;
std::string body;
};
class ApiLifecycleMiddleware {
public:
// Tự động gắn Sunset & Deprecation headers cho các Endpoint phiên bản cũ
static void applyDeprecationHeaders(HttpResponseContext& response, const std::string& sunsetDateGmt) {
response.headers["Deprecation"] = "true";
response.headers["Sunset"] = sunsetDateGmt;
response.headers["Link"] = "<https://api.enterprise.com/docs/v2/migration>; rel=\"sunset\"";
}
};
// ============================================================================
// 3. API CONTROLLER DEMO SUPPORTING V1 (DEPRECATED) AND V2 (CURRENT)
// ============================================================================
class CustomerApiController {
public:
// Endpoint V1: Đang trong lộ trình khai tử (Deprecated with Sunset RFC 8594)
HttpResponseContext getUserV1(uint64_t userId) {
HttpResponseContext res;
res.statusCode = 200;
res.headers["Content-Type"] = "application/json";
// Gắn header khai tử chuẩn quốc tế
ApiLifecycleMiddleware::applyDeprecationHeaders(res, "Wed, 11 Nov 2026 00:00:00 GMT");
res.body = std::format(
"{{\n"
" \"id\": {},\n"
" \"fullName\": \"Nguyen Van An\",\n"
" \"email\": \"an.nguyen@enterprise.vn\"\n"
"}}", userId
);
return res;
}
// Endpoint V2: Phiên bản hiện đại tuân thủ Additive Changes
HttpResponseContext getUserV2(uint64_t userId) {
HttpResponseContext res;
res.statusCode = 200;
res.headers["Content-Type"] = "application/json";
res.body = std::format(
"{{\n"
" \"id\": {},\n"
" \"firstName\": \"An\",\n"
" \"lastName\": \"Nguyen Van\",\n"
" \"corporateEmail\": \"an.nguyen@enterprise.vn\",\n"
" \"secondaryEmail\": null\n"
"}}", userId
);
return res;
}
};
int main() {
std::cout << "=========================================================\n";
std::cout << " DEMO API CONTRACT & RFC 8594 SUNSET HEADERS (C++20) \n";
std::cout << "=========================================================\n\n";
CustomerApiController controller;
// 1. Gọi API v1 cũ: Kiểm tra các Headers cảnh báo khai tử
std::cout << "--- 1. CLIENT GỌI ENDPOINT V1 (GET /v1/users/101) ---\n";
HttpResponseContext resV1 = controller.getUserV1(101);
std::cout << std::format("HTTP Status Code: {}\n", resV1.statusCode);
std::cout << "[Response Headers]:\n";
for (const auto& [key, val] : resV1.headers) {
std::cout << std::format(" {}: {}\n", key, val);
}
std::cout << "[Response Payload]:\n" << resV1.body << "\n\n";
// 2. Gọi API v2 mới: Không có Sunset Header
std::cout << "--- 2. CLIENT ĐÃ NÂNG CẤP LÊN V2 (GET /v2/users/101) ---\n";
HttpResponseContext resV2 = controller.getUserV2(101);
std::cout << std::format("HTTP Status Code: {}\n", resV2.statusCode);
std::cout << std::format("Sunset Header Present: {}\n", resV2.headers.contains("Sunset") ? "YES" : "NO");
std::cout << "[Response Payload]:\n" << resV2.body << "\n";
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
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
3.2. Phiên bản Python 3.11+: Mô Phỏng Kiểm Thử Consumer-Driven Contract (CDC)
python
from __future__ import annotations
import json
from dataclasses import dataclass
from typing import Dict, Any, List
# ============================================================================
# 1. CONSUMER PACT CONTRACT DEFINITION
# ============================================================================
@dataclass
class PactInteraction:
description: str
endpoint: str
expected_status: int
expected_fields: Dict[str, type] # Cấu trúc tối thiểu mà Consumer bắt buộc cần
class ConsumerContractPact:
"""Bên Consumer (Mobile App) định nghĩa bản cam kết về dữ liệu nó cần."""
@staticmethod
def get_mobile_app_pact() -> PactInteraction:
return PactInteraction(
description="Lấy thông tin tài khoản cơ bản cho màn hình Profile",
endpoint="/v1/accounts/me",
expected_status=200,
expected_fields={
"account_id": int,
"display_name": str,
"tier": str
}
)
# ============================================================================
# 2. PROVIDER IMPLEMENTATION (BACKEND SERVICE)
# ============================================================================
class BackendAccountService:
def __init__(self, simulate_breaking_change: bool = False):
self._breaking = simulate_breaking_change
def handle_request(self, endpoint: str) -> tuple[int, Dict[str, Any]]:
if endpoint != "/v1/accounts/me":
return 404, {"error": "Not Found"}
if self._breaking:
# LẬP TRÌNH VIÊN BACKEND VÔ TÌNH ĐỔI TÊN 'display_name' THÀNH 'user_fullname'!
return 200, {
"account_id": 9988,
"user_fullname": "Tran Thi B", # BREAKING CHANGE!
"tier": "PLATINUM"
}
else:
# Phiên bản chuẩn mực bảo toàn tương thích ngược
return 200, {
"account_id": 9988,
"display_name": "Tran Thi B",
"tier": "PLATINUM",
"extra_metadata": {"login_count": 42} # Additive change (An toàn)
}
# ============================================================================
# 3. PACT VERIFIER ENGINE (Chạy trong CI/CD của Backend)
# ============================================================================
class PactVerifierEngine:
@staticmethod
def verify(provider: BackendAccountService, pact: PactInteraction) -> bool:
print(f"\n[Pact Verifier] Đang kiểm tra hợp đồng: '{pact.description}'")
status, response_payload = provider.handle_request(pact.endpoint)
# 1. Kiểm tra HTTP Status
if status != pact.expected_status:
print(f" ❌ FAILED: Kỳ vọng status {pact.expected_status} nhưng nhận được {status}")
return False
# 2. Kiểm tra từng trường dữ liệu cam kết
for field_name, expected_type in pact.expected_fields.items():
if field_name not in response_payload:
print(f" ❌ CONTRACT BREACH: Trường bắt buộc '{field_name}' bị thiếu trong response!")
return False
val = response_payload[field_name]
if not isinstance(val, expected_type):
print(f" ❌ TYPE MISMATCH: Trường '{field_name}' kỳ vọng kiểu {expected_type.__name__} nhưng là {type(val).__name__}!")
return False
print(" ✅ VERIFICATION PASSED: Provider đáp ứng 100% hợp đồng cam kết với Consumer!")
return True
if __name__ == "__main__":
print("=" * 65)
print(" DEMO CONSUMER-DRIVEN CONTRACT (CDC) VERIFICATION (PYTHON)")
print("=" * 65)
pact = ConsumerContractPact.get_mobile_app_pact()
# Kịch bản 1: Backend chạy code chuẩn mực -> Test pass, cho phép deploy
print("\n--- TEST CASE 1: BACKEND TUÂN THỦ HỢP ĐỒNG ---")
good_backend = BackendAccountService(simulate_breaking_change=False)
can_deploy_1 = PactVerifierEngine.verify(good_backend, pact)
print(f"Trạng thái CI/CD Can-I-Deploy: {'CHO PHÉP DEPLOY' if can_deploy_1 else 'CHẶN DEPLOY'}")
# Kịch bản 2: Backend đổi tên trường `display_name` -> Test phát hiện và chặn đứng
print("\n--- TEST CASE 2: BACKEND VÔ TÌNH PHÁ VỠ HỢP ĐỒNG (BREAKING CHANGE) ---")
broken_backend = BackendAccountService(simulate_breaking_change=True)
can_deploy_2 = PactVerifierEngine.verify(broken_backend, pact)
print(f"Trạng thái CI/CD Can-I-Deploy: {'CHO PHÉP DEPLOY' if can_deploy_2 else 'CHẶN DEPLOY (BUILD FAILED)'}")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
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
3.3. Giả Lập Terminal Output Thực Tế
text
=========================================================
DEMO API CONTRACT & RFC 8594 SUNSET HEADERS (C++20)
=========================================================
--- 1. CLIENT GỌI ENDPOINT V1 (GET /v1/users/101) ---
HTTP Status Code: 200
[Response Headers]:
Content-Type: application/json
Deprecation: true
Sunset: Wed, 11 Nov 2026 00:00:00 GMT
Link: <https://api.enterprise.com/docs/v2/migration>; rel="sunset"
[Response Payload]:
{
"id": 101,
"fullName": "Nguyen Van An",
"email": "an.nguyen@enterprise.vn"
}
--- 2. CLIENT ĐÃ NÂNG CẤP LÊN V2 (GET /v2/users/101) ---
HTTP Status Code: 200
Sunset Header Present: NO
[Response Payload]:
{
"id": 101,
"firstName": "An",
"lastName": "Nguyen Van",
"corporateEmail": "an.nguyen@enterprise.vn",
"secondaryEmail": null
}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
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
4. Systems Engineering & Production Pitfalls
Cạm Bẫy Sản Xuất Thường Gặp (Production Anti-Patterns & Gotchas)
Hiểm Họa Zombie APIs & Chi Phí Hạ Tầng Bị Lãng Phí (Zombie Endpoints):
- Bản chất: Phát hành API
/v2nhưng không bao giờ khai tử/v1. Sau 5 năm, hệ thống tồn tại đồng thời/v1,/v2,/v3,/v4. Đội ngũ kỹ sư không dám xóa/v1vì sợ làm vỡ một ứng dụng nội bộ nào đó không rõ chủ sở hữu. Chi phí vận hành, bảo trì, vá lỗi bảo mật tăng gấp 4 lần. - Giải pháp: Thiết lập quy chế vòng đời bất biến: Bất kỳ API nào bị deprecated chỉ được phép sống tối đa 12 tháng. Phải có công cụ giám sát lưu lượng gọi vào URL cũ để chủ động liên hệ người dùng trước ngày Sunset.
- Bản chất: Phát hành API
Xung Đột Field Tag Trong Protobuf (Tag Reuse Disaster):
- Bản chất: Lập trình viên xóa trường cũ
string phone_number = 3;và tạo một trường mớiint64 account_id = 3;tái sử dụng Tag số 3. Khi server mới gửi dữ liệu cho client cũ, parser nhị phân sẽ cố ép kiểu chuỗi thành số nguyên và gây sập tiến trình ngay lập tức (Crash Crash). - Giải pháp: Khi ngừng sử dụng một trường trong Protobuf, bắt buộc dùng từ khóa
reserved 3; reserved "phone_number";. Trình biên dịchprotocsẽ chặn đứng bất kỳ ai cố gắng dùng lại Tag số 3.
- Bản chất: Lập trình viên xóa trường cũ
Chủ Quan Tin Tưởng Vào Việc Khách Hàng Tuân Thủ Thông Báo Email:
- Bản chất: Gửi email thông báo đổi API nhưng các kỹ sư đối tác không đọc. Đến ngày cắt dịch vụ, hệ thống đối tác ngừng trệ gây kiện tụng thương mại.
- Giải pháp: Tự động tiêm HTTP Sunset Header và kích hoạt cơ chế Brownout Testing (Tắt ngắt quãng có chủ đích) trước 30 ngày để buộc đối tác phải chú ý log lỗi và nâng cấp.
Kỹ Thuật Chẩn Đoán & Giám Sát Production Bằng CLI:
bash# 1. Quét tìm các lời gọi API cũ còn dính líu đến v1 trong AWS CloudWatch Logs aws logs filter-log-events --log-group-name "/aws/apigateway/enterprise-api" \ --filter-pattern '{ $.requestPath = "/v1/*" }' --limit 20 # 2. Chạy Pact Broker CLI để kiểm tra tính sẵn sàng trước khi deploy pact-broker can-i-deploy \ --pacticipant OrderService --version 2.4.1 \ --to-environment production --broker-base-url https://pact.corp.com # 3. Thẩm định cú pháp file OpenAPI bằng Spectral Linter npx @stoplight/spectral-cli lint openapi/v1/customer-spec.yaml1
2
3
4
5
6
7
8
9
10
11
5. Bảng So sánh & Decision Matrix
5.1. So Sánh Các Ngôn Ngữ Đặc Tả Hợp Đồng API (Contract Specifications)
| Tiêu Chí Kỹ Thuật | OpenAPI (OAS 3.1) | Protocol Buffers (Protobuf) | JSON Schema | GraphQL SDL |
|---|---|---|---|---|
| Giao thức mục tiêu | RESTful HTTP/1.1 & HTTP/2 | gRPC / HTTP/2 | JSON payloads tổng quát | GraphQL Engine |
| Định dạng dữ liệu | YAML / JSON | Binary Format | JSON | GraphQL Schema Definition |
| Độ trễ tuần tự hóa | Trung bình (Text parsing) | Cực nhanh ( | N/A (Chỉ validate) | Trung bình |
| Hỗ trợ Code Gen | Rất mạnh (Swagger Codegen) | Hoàn hảo (protoc compiler) | Trung bình | Rất tốt |
| Khả năng đọc hiểu | Con người đọc trực tiếp dễ | Cần file .proto để dịch | Dễ | Dễ |
| Trường hợp tối ưu | Public Web/Mobile APIs | Microservice nội bộ, IoT | Thẩm định runtime payload | Dynamic Frontend Query |
5.2. Ma Trận Quyết Định Xử Lý Thay Đổi API (Change Decision Matrix)
| Hành Động Thay Đổi Đề Xuất | Loại Thay Đổi | Cách Xử Lý Chuẩn Mực | Cần Nâng Minor/Major? |
|---|---|---|---|
| Thêm trường mới tùy chọn vào Request | Non-Breaking | Cập nhật tài liệu OpenAPI, giữ nguyên URL /v1 | Tăng Minor (1.1.0) |
| Thêm trường mới vào Response JSON | Non-Breaking | Yêu cầu Client dùng Tolerant Reader, giữ /v1 | Tăng Minor (1.1.0) |
| Xóa một trường đang tồn tại trong Response | Breaking | CẤM sửa trực tiếp! Tạo /v2, gắn Sunset cho /v1 | Tăng Major (2.0.0) |
Đổi kiểu dữ liệu từ int sang string | Breaking | CẤM sửa trực tiếp! Tạo /v2, hỗ trợ migration | Tăng Major (2.0.0) |
| Sửa lỗi chính tả tên trường JSON | Breaking | Giữ trường cũ, thêm trường mới song song cả hai | Tăng Minor (1.2.0) |
| Sửa đổi logic tính toán nội bộ (Bug fix) | Safe | Triển khai trực tiếp không cần đổi schema | Tăng Patch (1.0.1) |
IyA2LjMuIEvhu7kgTmdo4buHIEjhu6NwIMSQ4buTbmcgR2lhbyBEaeG7h24gdsOgIFRp4bq/biBIw7NhIFNjaGVtYSAoQVBJIENvbnRyYWN0IEVuZ2luZWVyaW5nICYgU2NoZW1hIEV2b2x1dGlvbikNCg0KPiBbIUlNUE9SVEFOVF0NCj4gKipO4bq/dSBi4bqhbiBjaOG7iSDEkcaw4bujYyBuaOG7myBt4buZdCDEkWnhu4F1IGR1eSBuaOG6pXQ6KiogQVBJIGtow7RuZyBjaOG7iSBsw6AgbcOjIG5ndeG7k24gaGF5IMSRxrDhu51uZyBk4bqrbiBt4bqhbmcgbcOgIGzDoCAqKmLhuqNuIGNhbSBr4bq/dCBwaMOhcCBsw70gdsOgIGvhu7kgdGh14bqtdCBi4bqldCBiaeG6v24gZ2nhu69hIGPDoWMgaOG7hyB0aOG7kW5nIMSR4buZYyBs4bqtcCoqIOKAlCBt4buNaSBz4buxIHRoYXkgxJHhu5VpIHBow6EgduG7oSB0xrDGoW5nIHRow61jaCBuZ8aw4bujYyAoQnJlYWtpbmcgQ2hhbmdlKSDEkeG7gXUgbMOgIG3hu5l0IGzhu5dpIG5naGnDqm0gdHLhu41uZyBj4bunYSBraeG6v24gdHLDumM7IHRp4bq/biBow7NhIHNjaGVtYSBhbiB0b8OgbiBi4bqvdCBideG7mWMgcGjhuqNpIMOhcCBk4bulbmcgbmd1ecOqbiBsw70gQWRkaXRpdmUgQ2hhbmdlcywgbeG6q3UgdGhp4bq/dCBr4bq/IFRvbGVyYW50IFJlYWRlciwga2nhu4NtIHRo4butIENvbnN1bWVyLURyaXZlbiBDb250cmFjdHMgKFBhY3QpIHbDoCBjaMOtbmggc8OhY2gga2hhaSB04butIGNodeG6qW4gbeG7sWMgduG7m2kgSFRUUCBTdW5zZXQgSGVhZGVyIChSRkMgODU5NCkuDQoNCi0tLQ0KDQojIyAxLiBLaeG6v24gdHLDumMgVOG7lW5nIHF1YW4gJiBNw7QgaMOsbmggVMawIGR1eSAoTWVudGFsIE1vZGVsKQ0KDQojIyMg4bqobiBk4bulIMSQ4budaSBz4buRbmc6IELhuqNuIFbhur0gUXV5IEhv4bqhY2ggWMOieSBE4buxbmcgdsOgIEjhu6NwIMSQ4buTbmcgVGjGsMahbmcgTeG6oWkgUXXhu5FjIFThur8NCkjDo3kgaMOsbmggZHVuZyBr4bu5IG5naOG7hyBo4bujcCDEkeG7k25nIEFQSSB0xrDGoW5nIHThu7EgbmjGsCB2aeG7h2MgcXXhuqNuIGzDvSBC4bqjbiB24bq9IGvhu7kgdGh14bqtdCB0cm9uZyB4w6J5IGThu7FuZyBt4buZdCDEkeG6oWkgxJHDtCB0aOG7izoNCi0gKipDb250cmFjdCBTcGVjaWZpY2F0aW9ucyAoQuG6o24gVuG6vSBL4bu5IFRodeG6rXQgxJDDs25nIEThuqV1IMSQ4buPKSoqOiBUcsaw4bubYyBraGkgxJHhurd0IGLhuqV0IGvhu7MgdmnDqm4gZ+G6oWNoIG7DoG8gKHZp4bq/dCBjb2RlKSwga2nhur9uIHRyw7pjIHPGsCB0csaw4bufbmcgcGjDoXQgaMOgbmggYuG6o24gduG6vSB0acOqdSBjaHXhuqluIChPcGVuQVBJIC8gUHJvdG9idWYgSURMKS4gxJDhu5lpIMSRaeG7h24sIMSR4buZaSBuxrDhu5tjIHbDoCDEkeG7mWkgeMOieSB0aMO0IChDbGllbnQgdsOgIFNlcnZlciB0ZWFtcykgY8SDbiBj4bupIHbDoG8gYuG6o24gduG6vSBuw6B5IMSR4buDIHRoaSBjw7RuZyBzb25nIHNvbmcgxJHhu5ljIGzhuq1wIG3DoCBraMO0bmcgY+G6p24gY2jhu50gxJHhu6NpIG5oYXUuDQotICoqQnJlYWtpbmcgQ2hhbmdlcyB2cyBBZGRpdGl2ZSBDaGFuZ2VzICjEkOG6rXAgQuG7jyBD4buZdCBUcuG7pSB2cyBM4bqvcCBUaMOqbSDhu5QgQ+G6r20gxJBp4buHbikqKjoNCiAgLSAqQnJlYWtpbmcgQ2hhbmdlKjogxJDhu5l0IG5n4buZdCBk4budaSBj4buZdCB0cuG7pSBjaOG7i3UgbOG7sWMgaG/hurdjIHRodSBuaOG7jyBrw61jaCB0aMaw4bubYyBj4butYSB0aG/DoXQgaGnhu4NtIChYw7NhIHRyxrDhu51uZywgxJHhu5VpIGtp4buDdSBk4buvIGxp4buHdSkuIFRvw6BuIGLhu5kgY8awIGTDom4gdsOgIHhlIGPhu5kgxJFhbmcgbMawdSB0aMO0bmcgbOG6rXAgdOG7qWMgZ+G6t3AgdGFpIG7huqFuIChDbGllbnQgY3Jhc2ggdG/DoG4gZGnhu4duKS4NCiAgLSAqQWRkaXRpdmUgQ2hhbmdlKjogTOG6r3AgdGjDqm0gbeG7mXQg4buVIGPhuq9tIMSRaeG7h24gZOG7sSBwaMOybmcgdHLDqm4gdMaw4budbmcgKFRow6ptIHRyxrDhu51uZyBt4bubaSkuIEPGsCBkw6JuIGPFqSBraMO0bmcgZMO5bmcg4buVIGPhuq9tIG7DoHkgduG6q24gc2luaCBob+G6oXQgYsOsbmggdGjGsOG7nW5nOyBjxrAgZMOibiBt4bubaSBjw7MgdGjhu4MgY+G6r20gdGjDqm0gdGhp4bq/dCBi4buLIHRow7RuZyBtaW5oLg0KLSAqKlRvbGVyYW50IFJlYWRlciBQYXR0ZXJuIChOZ8aw4budaSDEkOG7jWMgS2hvYW4gRHVuZykqKjogTmfGsOG7nWkgbXVhIG5ow6AgY2jhu4kgcXVhbiB0w6JtIMSR4bq/biBwaMOybmcgbmfhu6cgdsOgIHBow7JuZyBi4bq/cCBj4bunYSBo4buNLiBO4bq/dSBuaMOgIHRo4bqndSBzxqFuIHRow6ptIG3hu5l0IGjhu41hIHRp4bq/dCBt4bubaSB0csOqbiB0cuG6p24gbmjDoCBtw6AgaOG7jSBjaMawYSB04burbmcgdGjhuqV5LCBo4buNIGNo4buJIGzGsOG7m3QgcXVhIG3DoCBraMO0bmcgbmfhuqV0IHjhu4l1IGhheSBraGnhur91IG7huqFpIChDbGllbnQgYuG7jyBxdWEgY8OhYyB0csaw4budbmcgbOG6oSBtw6AgbsOzIGtow7RuZyBuaOG6rW4gYmnhur90KS4NCi0gKipDb25zdW1lci1Ecml2ZW4gQ29udHJhY3RzIC0gQ0RDIChZw6p1IEPhuqd1IFThu6sgTmfGsOG7nWkgVGnDqnUgRMO5bmcpKio6IFRoYXkgdsOsIGNo4bunIMSR4bqndSB0xrAgdOG7sSDDvSB4w6J5IG5o4buvbmcgdGnhu4duIMOtY2gga2jDtG5nIGFpIGTDuW5nLCBjxrAgZMOibiAoQ29uc3VtZXJzKSBn4butaSB0csaw4bubYyBkYW5oIHPDoWNoIGPDoWMgdGnhu4duIMOtY2ggdOG7kWkgdGhp4buDdSBtw6AgaOG7jSBi4bqvdCBideG7mWMgcGjhuqNpIGPDsyDEkeG7gyBz4buRbmcuIENo4bunIMSR4bqndSB0xrAgKFByb3ZpZGVyKSBjYW0ga+G6v3QgdHJvbmcgaOG7o3AgxJHhu5NuZyBraMO0bmcgxJHGsOG7o2MgY+G6r3QgZ2nhuqNtIGLhuqV0IGvhu7MgdGnhu4duIMOtY2ggbsOgbyB0cm9uZyBkYW5oIHPDoWNoIMSRw7MuDQotICoqQVBJIFZlcnNpb25pbmcgKFF1eSBIb+G6oWNoIEdpYWkgxJBv4bqhbiAxIHbDoCBHaWFpIMSQb+G6oW4gMikqKjogS2hpIGPDtG5nIG5naOG7hyB0aGF5IMSR4buVaSBob8OgbiB0b8OgbiAodOG7qyDEkcaw4budbmcgZMOieSDEkeG7k25nIHNhbmcgY8OhcCBxdWFuZyBxdWFuZyBo4buNYyksIHRow6BuaCBwaOG7kSBt4bufIG3hu5l0IHBow6JuIGtodSBt4bubaSAoL3YyLykgdGhheSB2w6wgY+G6r3QgxJHhu6l0IMSRxrDhu51uZyBkw6J5IGPhu6dhIHRvw6BuIGLhu5kga2h1IGTDom4gY8awIGPFqSAoL3YxLykuDQotICoqU3Vuc2V0IEhlYWRlciAoVGjDtG5nIELDoW8gR2nhuqNpIFThu49hIE3hurd0IELhurFuZyBDw7MgS+G7syBI4bqhbikqKjogQ2jDrW5oIHF1eeG7gW4gcGjDoXQgdGjDtG5nIGLDoW86ICoiVHV54bq/biDEkcaw4budbmcgY8WpIHPhur0gY2jDrW5oIHRo4bupYyDEkcOzbmcgdsOgbyBuZ8OgeSAzMS8xMi8yMDI2LiBYaW4gdnVpIGzDsm5nIGNodXnhu4NuIHNhbmcgxJHGsOG7nW5nIGNhbyB04buRYyBt4bubaSIqIChgU3Vuc2V0OiBSRkMgODU5NGApLiBLaMO0bmcgYmFvIGdp4budIGPDsyBjaHV54buHbiBzw6FuZyBuZ+G7pyBk4bqteSB0aOG6pXkgxJHGsOG7nW5nIGLhu4sgcsOgbyBjaOG6r24gxJHhu5l0IG5n4buZdCBraMO0bmcgYsOhbyB0csaw4bubYy4NCg0KYGBgbWVybWFpZA0KZmxvd2NoYXJ0IFREDQogICAgc3ViZ3JhcGggQ29udHJhY3RTcGVjWyIxLiDEkOG7i25oIE5naMSpYSBI4bujcCDEkOG7k25nIChDb250cmFjdCBTcGVjaWZpY2F0aW9ucykiXQ0KICAgICAgICBPQVNbIk9wZW5BUEkgMy4xIC8gU3dhZ2dlciAoUkVTVCBZQU1ML0pTT04pIl0NCiAgICAgICAgUHJvdG9bIlByb3RvYnVmIElETCAoLnByb3RvIEJpbmFyeSBTY2hlbWEpIl0NCiAgICAgICAgSlNPTlNjaGVtYVsiSlNPTiBTY2hlbWEgJiBHcmFwaFFMIFNETCJdDQogICAgZW5kDQoNCiAgICBzdWJncmFwaCBFdm9sdXRpb25Hb3Zlcm5hbmNlWyIyLiBRdeG6o24gVHLhu4sgVGnhur9uIEjDs2EgU2NoZW1hIChFdm9sdXRpb24pIl0NCiAgICAgICAgZGlyZWN0aW9uIFRCDQogICAgICAgIENoYW5nZURlY2lzaW9ue8SQw6FuaCBHacOhIFRoYXkgxJDhu5VpfQ0KICAgICAgICBOb25CcmVha1siTm9uLUJyZWFraW5nIChBZGRpdGl2ZSBDaGFuZ2VzKTxici8+LSBUaMOqbSB0csaw4budbmcgbeG7m2kgdMO5eSBjaOG7jW48YnIvPi0gVG9sZXJhbnQgUmVhZGVyIFBhdHRlcm4iXQ0KICAgICAgICBCcmVha1siQnJlYWtpbmcgQ2hhbmdlczxici8+LSBYw7NhIHRyxrDhu51uZyAvIMSQ4buVaSBraeG7g3UgLyBUaMOqbSByZXF1aXJlZCBmaWVsZCJdDQogICAgZW5kDQoNCiAgICBzdWJncmFwaCBWZXJzaW9uaW5nQW5kTGlmZWN5Y2xlWyIzLiBWw7JuZyDEkOG7nWkgJiBQaGnDqm4gQuG6o24gKExpZmVjeWNsZSkiXQ0KICAgICAgICBVUklfVlsiVVJJIFZlcnNpb25pbmc6IC92MSAkXHRvJCAvdjIiXQ0KICAgICAgICBTdW5zZXRbIlJGQyA4NTk0IFN1bnNldCBIZWFkZXI8YnIvPkRlcHJlY2F0aW9uIE5vdGljZSAoNi0xMiB0aMOhbmcpIl0NCiAgICAgICAgQ0RDWyJDb25zdW1lci1Ecml2ZW4gQ29udHJhY3QgVGVzdGluZyAoUGFjdCBDSS9DRCkiXQ0KICAgIGVuZA0KDQogICAgQ29udHJhY3RTcGVjIC0tPiBDaGFuZ2VEZWNpc2lvbg0KICAgIENoYW5nZURlY2lzaW9uIC0tPnxBbiB0b8OgbnwgTm9uQnJlYWsNCiAgICBDaGFuZ2VEZWNpc2lvbiAtLT58Tmd1eSBoaeG7g218IEJyZWFrDQogICAgQnJlYWsgLS0+IFVSSV9WDQogICAgVVJJX1YgLS0+IFN1bnNldA0KICAgIE5vbkJyZWFrIC0tPiBDREMNCiAgICBCcmVhayAtLT4gQ0RDDQpgYGANCg0KLS0tDQoNCiMjIDIuIENoaSB0aeG6v3QgdOG7q25nIEtleXdvcmQgKFVuZGVyLXRoZS1Ib29kIERlZXAgRGl2ZSkNCg0KIyMjIDIuMS4gQ29udHJhY3QgU3BlY2lmaWNhdGlvbnM6IE9wZW5BUEksIFN3YWdnZXIsIEpTT04gU2NoZW1hICYgUHJvdG9idWYNCg0KIyMjIyAxLiBPcGVuQVBJIFNwZWNpZmljYXRpb24gKE9BUyAzLjAgLyAzLjEpICYgU3dhZ2dlcg0KLSAqKkLhuqNuIGNo4bqldCoqOiBUacOqdSBjaHXhuqluIMSR4bq3YyB04bqjIGdpYW8gZGnhu4duIGzhuq1wIHRyw6xuaCBoxrDhu5tuZyB0w6BpIG5ndXnDqm4gbeG7nyBk4buxYSB0csOqbiBj4bqldSB0csO6YyBZQU1MIGhv4bq3YyBKU09OLCBob8OgbiB0b8OgbiDEkeG7mWMgbOG6rXAgduG7m2kgbmfDtG4gbmfhu68gbOG6rXAgdHLDrG5oLg0KLSAqKkdpw6EgdHLhu4sgY+G7kXQgbMO1aSB0cm9uZyBxdXkgdHLDrG5oIEFQSS1GaXJzdCBEZXNpZ24qKjoNCiAgLSAqU2luZ2xlIFNvdXJjZSBvZiBUcnV0aCo6IEZpbGUgYG9wZW5hcGkueWFtbGAgbMOgIGLhuqNuIGjhu6NwIMSR4buTbmcgZHV5IG5o4bqldCBnaeG7r2EgQmFja2VuZCwgRnJvbnRlbmQsIE1vYmlsZSB2w6AgUUEuDQogIC0gKkF1dG9tYXRlZCBDb2RlIEdlbmVyYXRpb24qOiBEw7luZyBjw7RuZyBj4bulIGBvcGVuYXBpLWdlbmVyYXRvci1jbGlgIMSR4buDIHNpbmggdOG7sSDEkeG7mW5nIENsaWVudCBTREtzIChUeXBlU2NyaXB0LCBTd2lmdCwgS290bGluLCBEYXJ0KSB2w6AgU2VydmVyIFN0dWJzIChHbywgSmF2YSwgUHl0aG9uLCBDKyspLg0KICAtICpJbnRlcmFjdGl2ZSBEb2N1bWVudGF0aW9uKjogVMOtY2ggaOG7o3AgU3dhZ2dlciBVSSAvIFJlZG9jIGdpw7pwIGzhuq1wIHRyw6xuaCB2acOqbiB0aOG7rSBuZ2hp4buHbSB0cuG7sWMgdGnhur9wIEFQSSB0csOqbiB0csOsbmggZHV54buHdC4NCiAgLSAqQ29udHJhY3QgTW9ja2luZyo6IFThu7EgxJHhu5luZyBraOG7n2kgY2jhuqF5IE1vY2sgU2VydmVyIChQcmlzbSwgV2lyZU1vY2spIGThu7FhIHRyw6puIHNjaGVtYSDEkeG7gyBGcm9udGVuZCBjw7MgdGjhu4MgbOG6rXAgdHLDrG5oIG5nYXkgY+G6oyBraGkgQmFja2VuZCBjaMawYSBjb2RlIHhvbmcgbeG7mXQgZMOybmcgbsOgby4NCg0KIyMjIyAyLiBKU09OIFNjaGVtYSAoRHJhZnQgMjAyMC0xMikNCi0gQ3VuZyBj4bqlcCBjxqEgY2jhur8gdGjhuqltIMSR4buLbmggKFZhbGlkYXRpb24pIGPhuqV1IHRyw7pjIGThu68gbGnhu4d1IEpTT04gY2jhurd0IGNo4bq9IHThuqFpIHJ1bnRpbWU6IGtp4buDbSB0cmEga2nhu4N1IGThu68gbGnhu4d1IChgdHlwZTogInN0cmluZyJgKSwgxJHhu5kgZMOgaSB04buRaSB0aGnhu4N1IChgbWluTGVuZ3RoOiA4YCksIMSR4buLbmggZOG6oW5nIMSR4bq3YyBiaeG7h3QgKGBmb3JtYXQ6ICJlbWFpbCJgLCBgZm9ybWF0OiAidXVpZCJgKSwgdsOgIGPDoWMgcsOgbmcgYnXhu5ljIHThu5UgaOG7o3AgKGBvbmVPZmAsIGBhbnlPZmAsIGBhbGxPZmApLg0KDQojIyMjIDMuIFByb3RvY29sIEJ1ZmZlcnMgKFByb3RvYnVmIElETCAtIEdvb2dsZSkNCi0gKipDxqEgY2jhur8gRmllbGQgVGFncyoqOiBUcm9uZyBmaWxlIGAucHJvdG9gLCBt4buXaSB0aHXhu5ljIHTDrW5oIMSRxrDhu6NjIGfDoW4gbeG7mXQgc+G7kSBuZ3V5w6puIGTGsMahbmcgYuG6pXQgYmnhur9uIGfhu41pIGzDoCAqKkZpZWxkIFRhZyAvIE51bWJlcioqOg0KICBgYGBwcm90b2J1Zg0KICBtZXNzYWdlIFVzZXJSZXNwb25zZSB7DQogICAgdWludDY0IGlkID0gMTsNCiAgICBzdHJpbmcgdXNlcm5hbWUgPSAyOw0KICAgIHN0cmluZyBlbWFpbCA9IDM7DQogIH0NCiAgYGBgDQotICoqVOG6oWkgc2FvIEZpZWxkIFRhZyBnaeG6o2kgcXV54bq/dCB0cmnhu4d0IMSR4buDIGLDoGkgdG/DoW4gdGnhur9uIGjDs2Egc2NoZW1hPyoqDQogIEtoaSBtw6MgaMOzYSBuaOG7iyBwaMOibiwgUHJvdG9idWYgKipraMO0bmcgYmFvIGdp4budIGfhu61pIHTDqm4gdHLGsOG7nW5nKiogKGAidXNlcm5hbWUiYCB04buRbiA4IGJ5dGVzKSwgbcOgIGNo4buJIGfhu61pIGPhurdwIGdpw6EgdHLhu4s6IGAoRmllbGQgVGFnIDw8IDMgfCBXaXJlIFR5cGUpYCBjaGnhur9tIMSRw7puZyAxIGJ5dGUuDQogIE5o4budIMSRw7M6DQogIC0gVGEgY8OzIHRo4buDIMSR4buVaSB0w6puIHRyxrDhu51uZyB04burIGB1c2VybmFtZWAgdGjDoG5oIGBkaXNwbGF5X25hbWVgIHRyb25nIGNvZGUgbcOgIGtow7RuZyBsw6BtIGfDo3kga+G6v3QgbuG7kWkgbmjhu4sgcGjDom4sIG1p4buFbiBsw6AgVGFnIGAyYCDEkcaw4bujYyBnaeG7ryBuZ3V5w6puLg0KICAtIFNlcnZlciBn4butaSB0csaw4budbmcgVGFnIGA0YCBt4bubaSwgQ2xpZW50IHBoacOqbiBi4bqjbiBjxakga2jDtG5nIGJp4bq/dCBUYWcgYDRgIGzDoCBnw6wgc+G6vSB04buxIMSR4buZbmcgYuG7jyBxdWEgKFVua25vd24gRmllbGQgc2tpcHBpbmcpIG3DoCBraMO0bmcgY3Jhc2guDQoNCi0tLQ0KDQojIyMgMi4yLiBTY2hlbWEgRXZvbHV0aW9uOiBCcmVha2luZyB2cyBOb24tQnJlYWtpbmcgQ2hhbmdlcyAmIFZlcnNpb25pbmcgU3RyYXRlZ2llcw0KDQojIyMjIDEuIELhuqNuIENo4bqldCBj4bunYSBCcmVha2luZyBDaGFuZ2VzIChUaGF5IMSQ4buVaSBHw6J5IEfDo3kgxJDhu5UpDQpN4buZdCB0aGF5IMSR4buVaSDEkcaw4bujYyBjb2kgbMOgIEJyZWFraW5nIG7hur91IG7DsyBwaMOhIHbhu6EgZ2nhuqMgxJHhu4tuaCBj4bunYSBDbGllbnQgxJFhbmcgY2jhuqF5Og0KLSAqKljDs2EgYuG7jyAoUmVtb3ZpbmcpKiogbeG7mXQgdHLGsOG7nW5nIGThu68gbGnhu4d1IHRyb25nIFJlc3BvbnNlIGhv4bq3YyBt4buZdCBFbmRwb2ludC4NCi0gKirEkOG7lWkgdMOqbiAoUmVuYW1pbmcpKiogdHLGsOG7nW5nIGThu68gbGnhu4d1IChDbGllbnQgdMOsbSBraeG6v20ga2V5IGPFqSBz4bq9IG5o4bqtbiB24buBIGB1bmRlZmluZWRgL2BudWxsYCkuDQotICoqVGhheSDEkeG7lWkga2nhu4N1IGThu68gbGnhu4d1IChUeXBlIE11dGF0aW9uKSoqOiDEkOG7lWkgdHLGsOG7nW5nIGBpZGAgdOG7qyBz4buRIG5ndXnDqm4gYGludDY0YCBzYW5nIGNodeG7l2kgYHN0cmluZyBVVUlEYCAoR8OieSBs4buXaSBnaeG6o2kgbcOjIGtp4buDdSBk4buvIGxp4buHdSBuZ2hpw6ptIHRy4buNbmcpLg0KLSAqKlRow6ptIHRyxrDhu51uZyBi4bqvdCBideG7mWMgbeG7m2kgKE5ldyBSZXF1aXJlZCBGaWVsZCkqKiB0cm9uZyBSZXF1ZXN0IFBheWxvYWQgKENsaWVudCBjxakga2jDtG5nIGfhu61pIHRyxrDhu51uZyBuw6B5IHPhur0gYuG7iyBTZXJ2ZXIgdOG7qyBjaOG7kWkgYuG6sW5nIGzhu5dpIGA0MDAgQmFkIFJlcXVlc3RgKS4NCi0gKipUaHUgaOG6uXAgbWnhu4FuIGdpw6EgdHLhu4sgY2jhuqVwIG5o4bqtbioqOiBWw60gZOG7pSB0csaw4budbmcgYHN0YXR1c2AgdHLGsOG7m2MgxJHDonkgY2jhuqVwIG5o4bqtbiBjaHXhu5dpIGLhuqV0IGvhu7MsIG5heSBjaOG7iSBjaOG6pXAgbmjhuq1uIEVudW0gYFsiQUNUSVZFIiwgIklOQUNUSVZFIl1gLg0KDQojIyMjIDIuIE5vbi1CcmVha2luZyBDaGFuZ2VzIChUaGF5IMSQ4buVaSBBbiBUb8OgbiAvIEFkZGl0aXZlIENoYW5nZXMpDQotICoqVGjDqm0gdHLGsOG7nW5nIG3hu5tpIHTDuXkgY2jhu41uIChPcHRpb25hbCBGaWVsZCkqKiB2w6BvIFJlcXVlc3QgcGF5bG9hZCAoxJFpIGvDqG0gZ2nDoSB0cuG7iyBt4bq3YyDEkeG7i25oKS4NCi0gKipUaMOqbSB0csaw4budbmcgbeG7m2kgdsOgbyBSZXNwb25zZSBwYXlsb2FkKio6IMSQxrDhu6NjIGNvaSBsw6AgYW4gdG/DoG4gbuG6v3UgQ2xpZW50IHR1w6JuIHRo4bunIG5ndXnDqm4gbMO9ICoqVG9sZXJhbnQgUmVhZGVyIFBhdHRlcm4qKiAobmd1ecOqbiBsw70gY+G7p2EgTWFydGluIEZvd2xlcjogaOG7hyB0aOG7kW5nIGNo4buJIHRyw61jaCB4deG6pXQgbmjhu69uZyB0csaw4budbmcgbsOzIGPhuqduIHbDoCBwaOG7m3QgbOG7nSBjw6FjIHRyxrDhu51uZyBjaMawYSBiaeG6v3QpLg0KLSAqKlRow6ptIG3hu5l0IEVuZHBvaW50IGhvw6BuIHRvw6BuIG3hu5tpKiogKGBQT1NUIC92MS9vcmRlcnMvYnVsay1jYW5jZWxgKS4NCg0KIyMjIyAzLiBDw6FjIENoaeG6v24gTMaw4bujYyBRdeG6o24gTMO9IFBoacOqbiBC4bqjbiAoQVBJIFZlcnNpb25pbmcgU3RyYXRlZ2llcykNCg0KfCBDaGnhur9uIEzGsOG7o2MgfCBDw7ogUGjDoXAgTWluaCBI4buNYSB8IMavdSDEkGnhu4NtIEvhu7kgVGh14bqtdCB8IE5oxrDhu6NjIMSQaeG7g20gLyDEkMOhbmggxJDhu5VpIHwNCnwgOi0tLSB8IDotLS0gfCA6LS0tIHwgOi0tLSB8DQp8ICoqVVJJIFZlcnNpb25pbmcqKiAqKEtodXnDqm4gZMO5bmcpKiB8IGBodHRwczovL2FwaS5jb3JwLmNvbS92MS9vcmRlcnNgPGJyLz5gaHR0cHM6Ly9hcGkuY29ycC5jb20vdjIvb3JkZXJzYCB8IEPhu7FjIGvhu7MgcsO1IHLDoG5nLCB0cuG7sWMgcXVhbi4gxJDhu4tuaCB0dXnhur9uIChSb3V0aW5nKSB04bqhaSBBUEkgR2F0ZXdheS9OZ2lueCBy4bqldCBk4buFIGTDoG5nLiBI4buXIHRy4bujIGNhY2hpbmcgdHV54buHdCDEkeG7kWkuIHwgVOG6oW8gcmEgbmhp4buBdSBlbmRwb2ludHMgdHLDuW5nIGzhurdwOyB2aSBwaOG6oW0gdGh14bqnbiB0w7p5IGzDvSB0aHV54bq/dCBSRVNUIChVUkkgbsOqbiDEkeG6oWkgZGnhu4duIGNobyB0w6BpIG5ndXnDqm4sIGtow7RuZyBwaOG6o2kgcGhpw6puIGLhuqNuKS4gfA0KfCAqKkhlYWRlciBWZXJzaW9uaW5nIChDdXN0b20gSGVhZGVyKSoqIHwgYFgtQVBJLVZlcnNpb246IDJgIHwgVVJJIHPhuqFjaCBz4bq9LCBnaeG7ryBuZ3V5w6puIMSR4buLYSBjaOG7iSB0w6BpIG5ndXnDqm4uIHwgS2jDsyBraeG7g20gdGjhu60gdHLDqm4gdGhhbmggxJHhu4thIGNo4buJIHRyw6xuaCBkdXnhu4d0LiBQaOG7qWMgdOG6oXAga2hpIGPhuqV1IGjDrG5oIENETiBDYWNoaW5nIChD4bqnbiBj4bqldSBow6xuaCBgVmFyeTogWC1BUEktVmVyc2lvbmApLiB8DQp8ICoqQ29udGVudCBOZWdvdGlhdGlvbiAoQWNjZXB0IEhlYWRlcikqKiB8IGBBY2NlcHQ6IGFwcGxpY2F0aW9uL3ZuZC5jb3JwLnYyK2pzb25gIHwgQ2h14bqpbiBt4buxYyBo4buNYyB0aHXhuq10IFJFU1QgbmjhuqV0IChIQVRFT0FTKS4gfCBS4bqldCBraMOzIGhp4buDdSBjaG8gY8OhYyBs4bqtcCB0csOsbmggdmnDqm4gbeG7m2ksIHBo4bupYyB04bqhcCBraGkgZ+G7jWkgYuG6sW5nIGNVUkwgaG/hurdjIFBvc3RtYW4uIHwNCnwgKipRdWVyeSBQYXJhbWV0ZXIqKiB8IGBodHRwczovL2FwaS5jb3JwLmNvbS9vcmRlcnM/dmVyc2lvbj0yYCB8IEThu4UgdHJ1eeG7gW4gdGhhbSBz4buRLCBjw7MgZ2nDoSB0cuG7iyBt4bq3YyDEkeG7i25oLiB8IEThu4UgeHVuZyDEkeG7mXQgduG7m2kgY8OhYyBi4buZIGzhu41jIHBow6JuIHRyYW5nIHbDoCBjYWNoaW5nLiB8DQoNCi0tLQ0KDQojIyMgMi4zLiBDb25zdW1lci1Ecml2ZW4gQ29udHJhY3RzIChDREMpICYgRGVwcmVjYXRpb24gUG9saWN5DQoNCiMjIyMgMS4gQ29uc3VtZXItRHJpdmVuIENvbnRyYWN0IFRlc3RpbmcgKFBhY3QgRnJhbWV3b3JrKQ0KLSAqKlbhuqVuIMSR4buBIGPhu6dhIEVuZC10by1FbmQgVGVzdGluZyB0cnV54buBbiB0aOG7kW5nKio6IFRyb25nIGtp4bq/biB0csO6YyA1MCBNaWNyb3NlcnZpY2VzLCB2aeG7h2MgZOG7sW5nIHRvw6BuIGLhu5kgNTAgc2VydmljZXMgbMOqbiBtw7RpIHRyxrDhu51uZyBUZXN0IMSR4buDIGNo4bqheSBpbnRlZ3JhdGlvbiB0ZXN0cyBj4buxYyBr4buzIGNo4bqtbSBjaOG6oXAsIHThu5FuIGvDqW0gdMOgaSBuZ3V5w6puIHbDoCB0aMaw4budbmcgeHV5w6puIGLhu4sgbOG7l2kgY2jhuq1wIGNo4budbiAoRmxha3kgVGVzdHMpLg0KLSAqKkPGoSBjaOG6vyBDb25zdW1lci1Ecml2ZW4gQ29udHJhY3RzKio6DQogIDEuICpDb25zdW1lciDEkeG7i25oIG5naMSpYSBuaHUgY+G6p3UqOiBDbGllbnQgdOG6oW8gbeG7mXQgaOG7o3AgxJHhu5NuZyBraeG7g20gdGjhu60gKFBhY3QgRmlsZSBKU09OKTogKiJUw7RpIGfhu41pIEdFVCAvdjEvdXNlcnMvMTAxLCB0w7RpIG1vbmcgxJHhu6NpIEhUVFAgMjAwIHbDoCByZXNwb25zZSB04buRaSB0aGnhu4N1IHBo4bqjaSBjw7MgdHLGsOG7nW5nIG5hbWUga2nhu4N1IHN0cmluZyIqLg0KICAyLiAqUHVibGlzaCBQYWN0KjogUGFjdCBGaWxlIMSRxrDhu6NjIHThuqNpIGzDqm4gbcOheSBjaOG7pyB0cnVuZyB0w6JtICoqUGFjdCBCcm9rZXIqKi4NCiAgMy4gKlByb3ZpZGVyIHThu7EgxJHhu5luZyB4w6FjIHRo4buxYyo6IFRyb25nIHBpcGVsaW5lIENJL0NEIGPhu6dhIFByb3ZpZGVyIChCYWNrZW5kKSwgbeG7mXQgdGVzdCBzdWl0ZSB04buxIMSR4buZbmcgbuG6oXAgdG/DoG4gYuG7mSBQYWN0IEZpbGVzIHThu6sgUGFjdCBCcm9rZXIgdsOgIGNo4bqheSBnaeG6oyBs4bqtcCB0csOqbiBjb2RlIGhp4buHbiB04bqhaSBj4bunYSBQcm92aWRlci4NCiAgNC4gKkNhbi1JLURlcGxveSBHYXRlKjogTuG6v3UgUHJvdmlkZXIgc+G7rWEgY29kZSBsw6BtIG3huqV0IHRyxrDhu51uZyBgbmFtZWAsIGJ1aWxkIHBpcGVsaW5lIHPhur0gYuG7iyBjaOG6t24gxJHhu6luZyBuZ2F5IGzhuq1wIHThu6ljIHbhu5tpIHRow7RuZyBiw6FvOiAqIkNvbnN1bWVyIE1vYmlsZSBBcHAgdjMuMiBz4bq9IGLhu4sgZ8OjeSDEkeG7lSBu4bq/dSBi4bqjbiBidWlsZCBuw6B5IMSRxrDhu6NjIGRlcGxveSEiKi4NCg0KYGBgbWVybWFpZA0Kc2VxdWVuY2VEaWFncmFtDQogICAgYXV0b251bWJlcg0KICAgIHBhcnRpY2lwYW50IENvbnN1bWVyIGFzIENvbnN1bWVyIENJIChDbGllbnQpDQogICAgcGFydGljaXBhbnQgQnJva2VyIGFzIENlbnRyYWwgUGFjdCBCcm9rZXINCiAgICBwYXJ0aWNpcGFudCBQcm92aWRlciBhcyBQcm92aWRlciBDSSAoQmFja2VuZCBTZXJ2aWNlKQ0KDQogICAgQ29uc3VtZXItPj5Db25zdW1lcjogUnVuIFVuaXQgVGVzdCB3aXRoIE1vY2sgUHJvdmlkZXINCiAgICBDb25zdW1lci0+PkJyb2tlcjogUHVibGlzaCBQYWN0IENvbnRyYWN0IChwYWN0Lmpzb24pDQogICAgTm90ZSBvdmVyIEJyb2tlcjogTMawdSB0cuG7ryBo4bujcCDEkeG7k25nIHbDoCBwaGnDqm4gYuG6o24gQ29uc3VtZXINCiAgICBQcm92aWRlci0+PkJyb2tlcjogRmV0Y2ggbGF0ZXN0IENvbnN1bWVyIENvbnRyYWN0cw0KICAgIFByb3ZpZGVyLT4+UHJvdmlkZXI6IFJlcGxheSByZXF1ZXN0cyBhZ2FpbnN0IFJlYWwgQ29udHJvbGxlcg0KICAgIGFsdCBI4bujcCDEkeG7k25nIMSRxrDhu6NjIGLhuqNvIHRvw6BuDQogICAgICAgIFByb3ZpZGVyLT4+QnJva2VyOiBDb250cmFjdCBWZXJpZmljYXRpb246IFBBU1NFRA0KICAgICAgICBQcm92aWRlci0+PlByb3ZpZGVyOiBjYW4taS1kZXBsb3kgLT4gT0sgKERlcGxveSB0byBQcm9kKQ0KICAgIGVsc2UgUGjDoXQgaGnhu4duIEJyZWFraW5nIENoYW5nZQ0KICAgICAgICBQcm92aWRlci0+PkJyb2tlcjogQ29udHJhY3QgVmVyaWZpY2F0aW9uOiBGQUlMRUQhDQogICAgICAgIFByb3ZpZGVyLT4+UHJvdmlkZXI6IGNhbi1pLWRlcGxveSAtPiBCTE9DS0VEIQ0KICAgIGVuZA0KYGBgDQoNCiMjIyMgMi4gQ2jDrW5oIFPDoWNoIEtoYWkgVOG7rSBBUEkgJiBUacOqdSBDaHXhuqluIFJGQyA4NTk0IFN1bnNldCBIZWFkZXINCi0gKipRdXkgdHLDrG5oIGtoYWkgdOG7rSBjaHXhuqluIG3hu7FjIChEZXByZWNhdGlvbiBMaWZlY3ljbGUpKio6DQogIDEuICpHaWFpIMSRb+G6oW4gVGjDtG5nIGLDoW8gKEFubm91bmNlbWVudCkqOiBEdXkgdHLDrCBwaGnDqm4gYuG6o24gY8WpIHThu5FpIHRoaeG7g3UgdOG7qyA2IMSR4bq/biAxMiB0aMOhbmcuDQogIDIuICpHaWFpIMSRb+G6oW4gR+G6r24gbmjDo24ga+G7uSB0aHXhuq10IChUZWNobmljYWwgTm90aWNlKSo6IFRy4bqjIHbhu4EgSFRUUCBIZWFkZXJzIGNodeG6qW4gbeG7sWMgdHLDqm4gbeG7jWkgcmVzcG9uc2UgY+G7p2EgcGhpw6puIGLhuqNuIGPFqToNCiAgICAgLSBgRGVwcmVjYXRpb246IHRydWVgIChob+G6t2MgYEBkZXByZWNhdGVkYCB0aW1lc3RhbXApLg0KICAgICAtIGBTdW5zZXQ6IFdlZCwgMTEgTm92IDIwMjYgMDA6MDA6MDAgR01UYCAoQ2jhu4kgxJHhu4tuaCBjaMOtbmggeMOhYyB0aOG7nWkgxJFp4buDbSB04bqvdCBzZXJ2ZXIgdsSpbmggdmnhu4VuIHRoZW8gUkZDIDg1OTQpLg0KICAgICAtIGBMaW5rOiA8aHR0cHM6Ly9hcGkuY29ycC5jb20vdjIvbWlncmF0aW9uLWd1aWRlPjsgcmVsPSJzdW5zZXQiYC4NCiAgMy4gKkdpYWkgxJFv4bqhbiBCcm93bm91dCAoVOG6r3QgdGjhu60gbmdoaeG7h20pKjogMSB0aMOhbmcgdHLGsOG7m2MgbmfDoHkgU3Vuc2V0LCB04bqvdCBBUEkgY8WpIHRyb25nIDE1IHBow7p0IHbDoG8gZ2nhu50gdGjhuqVwIMSRaeG7g20gxJHhu4Mga2nhu4NtIHRyYSB4ZW0gY8OybiBo4buHIHRo4buRbmcgbsOgbyBxdcOqbiBjaMawYSBjaHV54buDbiDEkeG7lWkuDQogIDQuICpHaWFpIMSRb+G6oW4gVOG6r3QgdsSpbmggdmnhu4VuIChEZWNvbW1pc3Npb25pbmcpKjogQ2h1eeG7g24gdG/DoG4gYuG7mSBsxrB1IGzGsOG7o25nIGPhu6dhIFVSTCBjxakgc2FuZyBtw6MgcGjhuqNuIGjhu5NpIGA0MTAgR29uZWAuDQoNCi0tLQ0KDQojIyAzLiBUaOG7sWMgdGhpIE3DoyBuZ3Xhu5NuICYgTcO0IHBo4buPbmcgQ2h1ecOqbiBzw6J1IChEdWFsLUVuZ2luZSBJbXBsZW1lbnRhdGlvbikNCg0KIyMjIDMuMS4gUGhpw6puIGLhuqNuIEMrKzIwOiBC4buZIFRo4bqpbSDEkOG7i25oIEjhu6NwIMSQ4buTbmcgU2NoZW1hICYgTWlkZGxld2FyZSBU4buxIMSQ4buZbmcgR+G6r24gUkZDIDg1OTQgU3Vuc2V0IEhlYWRlcg0KDQpgYGBjcHANCiNpbmNsdWRlIDxpb3N0cmVhbT4NCiNpbmNsdWRlIDxzdHJpbmc+DQojaW5jbHVkZSA8dmVjdG9yPg0KI2luY2x1ZGUgPG1lbW9yeT4NCiNpbmNsdWRlIDxmb3JtYXQ+DQojaW5jbHVkZSA8dW5vcmRlcmVkX21hcD4NCiNpbmNsdWRlIDxjaHJvbm8+DQojaW5jbHVkZSA8b3B0aW9uYWw+DQojaW5jbHVkZSA8c3RkZXhjZXB0Pg0KDQovLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09DQovLyAxLiBDT05UUkFDVCBERUZJTklUSU9OICYgU0NIRU1BIFZBTElEQVRPUg0KLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQ0Kc3RydWN0IFVzZXJQcm9maWxlQ29udHJhY3RWMSB7DQogICAgdWludDY0X3QgaWQ7DQogICAgc3RkOjpzdHJpbmcgZnVsbE5hbWU7DQogICAgc3RkOjpzdHJpbmcgZW1haWw7IC8vIELhuq90IGJ14buZYyDhu58gdjENCn07DQoNCnN0cnVjdCBVc2VyUHJvZmlsZUNvbnRyYWN0VjIgew0KICAgIHVpbnQ2NF90IGlkOw0KICAgIHN0ZDo6c3RyaW5nIGZpcnN0TmFtZTsNCiAgICBzdGQ6OnN0cmluZyBsYXN0TmFtZTsNCiAgICBzdGQ6OnN0cmluZyBjb3Jwb3JhdGVFbWFpbDsNCiAgICBzdGQ6Om9wdGlvbmFsPHN0ZDo6c3RyaW5nPiBzZWNvbmRhcnlFbWFpbDsgLy8gQWRkaXRpdmUgY2hhbmdlIChPcHRpb25hbCkNCn07DQoNCi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0NCi8vIDIuIEhUVFAgRU5WRUxPUEUgJiBTVU5TRVQgTUlERExFV0FSRSAoUkZDIDg1OTQpDQovLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09DQpzdHJ1Y3QgSHR0cFJlc3BvbnNlQ29udGV4dCB7DQogICAgaW50IHN0YXR1c0NvZGU7DQogICAgc3RkOjp1bm9yZGVyZWRfbWFwPHN0ZDo6c3RyaW5nLCBzdGQ6OnN0cmluZz4gaGVhZGVyczsNCiAgICBzdGQ6OnN0cmluZyBib2R5Ow0KfTsNCg0KY2xhc3MgQXBpTGlmZWN5Y2xlTWlkZGxld2FyZSB7DQpwdWJsaWM6DQogICAgLy8gVOG7sSDEkeG7mW5nIGfhuq9uIFN1bnNldCAmIERlcHJlY2F0aW9uIGhlYWRlcnMgY2hvIGPDoWMgRW5kcG9pbnQgcGhpw6puIGLhuqNuIGPFqQ0KICAgIHN0YXRpYyB2b2lkIGFwcGx5RGVwcmVjYXRpb25IZWFkZXJzKEh0dHBSZXNwb25zZUNvbnRleHQmIHJlc3BvbnNlLCBjb25zdCBzdGQ6OnN0cmluZyYgc3Vuc2V0RGF0ZUdtdCkgew0KICAgICAgICByZXNwb25zZS5oZWFkZXJzWyJEZXByZWNhdGlvbiJdID0gInRydWUiOw0KICAgICAgICByZXNwb25zZS5oZWFkZXJzWyJTdW5zZXQiXSA9IHN1bnNldERhdGVHbXQ7DQogICAgICAgIHJlc3BvbnNlLmhlYWRlcnNbIkxpbmsiXSA9ICI8aHR0cHM6Ly9hcGkuZW50ZXJwcmlzZS5jb20vZG9jcy92Mi9taWdyYXRpb24+OyByZWw9XCJzdW5zZXRcIiI7DQogICAgfQ0KfTsNCg0KLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQ0KLy8gMy4gQVBJIENPTlRST0xMRVIgREVNTyBTVVBQT1JUSU5HIFYxIChERVBSRUNBVEVEKSBBTkQgVjIgKENVUlJFTlQpDQovLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09DQpjbGFzcyBDdXN0b21lckFwaUNvbnRyb2xsZXIgew0KcHVibGljOg0KICAgIC8vIEVuZHBvaW50IFYxOiDEkGFuZyB0cm9uZyBs4buZIHRyw6xuaCBraGFpIHThu60gKERlcHJlY2F0ZWQgd2l0aCBTdW5zZXQgUkZDIDg1OTQpDQogICAgSHR0cFJlc3BvbnNlQ29udGV4dCBnZXRVc2VyVjEodWludDY0X3QgdXNlcklkKSB7DQogICAgICAgIEh0dHBSZXNwb25zZUNvbnRleHQgcmVzOw0KICAgICAgICByZXMuc3RhdHVzQ29kZSA9IDIwMDsNCiAgICAgICAgcmVzLmhlYWRlcnNbIkNvbnRlbnQtVHlwZSJdID0gImFwcGxpY2F0aW9uL2pzb24iOw0KDQogICAgICAgIC8vIEfhuq9uIGhlYWRlciBraGFpIHThu60gY2h14bqpbiBxdeG7kWMgdOG6vw0KICAgICAgICBBcGlMaWZlY3ljbGVNaWRkbGV3YXJlOjphcHBseURlcHJlY2F0aW9uSGVhZGVycyhyZXMsICJXZWQsIDExIE5vdiAyMDI2IDAwOjAwOjAwIEdNVCIpOw0KDQogICAgICAgIHJlcy5ib2R5ID0gc3RkOjpmb3JtYXQoDQogICAgICAgICAgICAie3tcbiINCiAgICAgICAgICAgICIgIFwiaWRcIjoge30sXG4iDQogICAgICAgICAgICAiICBcImZ1bGxOYW1lXCI6IFwiTmd1eWVuIFZhbiBBblwiLFxuIg0KICAgICAgICAgICAgIiAgXCJlbWFpbFwiOiBcImFuLm5ndXllbkBlbnRlcnByaXNlLnZuXCJcbiINCiAgICAgICAgICAgICJ9fSIsIHVzZXJJZA0KICAgICAgICApOw0KICAgICAgICByZXR1cm4gcmVzOw0KICAgIH0NCg0KICAgIC8vIEVuZHBvaW50IFYyOiBQaGnDqm4gYuG6o24gaGnhu4duIMSR4bqhaSB0dcOibiB0aOG7pyBBZGRpdGl2ZSBDaGFuZ2VzDQogICAgSHR0cFJlc3BvbnNlQ29udGV4dCBnZXRVc2VyVjIodWludDY0X3QgdXNlcklkKSB7DQogICAgICAgIEh0dHBSZXNwb25zZUNvbnRleHQgcmVzOw0KICAgICAgICByZXMuc3RhdHVzQ29kZSA9IDIwMDsNCiAgICAgICAgcmVzLmhlYWRlcnNbIkNvbnRlbnQtVHlwZSJdID0gImFwcGxpY2F0aW9uL2pzb24iOw0KDQogICAgICAgIHJlcy5ib2R5ID0gc3RkOjpmb3JtYXQoDQogICAgICAgICAgICAie3tcbiINCiAgICAgICAgICAgICIgIFwiaWRcIjoge30sXG4iDQogICAgICAgICAgICAiICBcImZpcnN0TmFtZVwiOiBcIkFuXCIsXG4iDQogICAgICAgICAgICAiICBcImxhc3ROYW1lXCI6IFwiTmd1eWVuIFZhblwiLFxuIg0KICAgICAgICAgICAgIiAgXCJjb3Jwb3JhdGVFbWFpbFwiOiBcImFuLm5ndXllbkBlbnRlcnByaXNlLnZuXCIsXG4iDQogICAgICAgICAgICAiICBcInNlY29uZGFyeUVtYWlsXCI6IG51bGxcbiINCiAgICAgICAgICAgICJ9fSIsIHVzZXJJZA0KICAgICAgICApOw0KICAgICAgICByZXR1cm4gcmVzOw0KICAgIH0NCn07DQoNCmludCBtYWluKCkgew0KICAgIHN0ZDo6Y291dCA8PCAiPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG4iOw0KICAgIHN0ZDo6Y291dCA8PCAiICBERU1PIEFQSSBDT05UUkFDVCAmIFJGQyA4NTk0IFNVTlNFVCBIRUFERVJTIChDKysyMCkgICAgXG4iOw0KICAgIHN0ZDo6Y291dCA8PCAiPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG5cbiI7DQoNCiAgICBDdXN0b21lckFwaUNvbnRyb2xsZXIgY29udHJvbGxlcjsNCg0KICAgIC8vIDEuIEfhu41pIEFQSSB2MSBjxak6IEtp4buDbSB0cmEgY8OhYyBIZWFkZXJzIGPhuqNuaCBiw6FvIGtoYWkgdOG7rQ0KICAgIHN0ZDo6Y291dCA8PCAiLS0tIDEuIENMSUVOVCBH4buMSSBFTkRQT0lOVCBWMSAoR0VUIC92MS91c2Vycy8xMDEpIC0tLVxuIjsNCiAgICBIdHRwUmVzcG9uc2VDb250ZXh0IHJlc1YxID0gY29udHJvbGxlci5nZXRVc2VyVjEoMTAxKTsNCiAgICBzdGQ6OmNvdXQgPDwgc3RkOjpmb3JtYXQoIkhUVFAgU3RhdHVzIENvZGU6IHt9XG4iLCByZXNWMS5zdGF0dXNDb2RlKTsNCiAgICBzdGQ6OmNvdXQgPDwgIltSZXNwb25zZSBIZWFkZXJzXTpcbiI7DQogICAgZm9yIChjb25zdCBhdXRvJiBba2V5LCB2YWxdIDogcmVzVjEuaGVhZGVycykgew0KICAgICAgICBzdGQ6OmNvdXQgPDwgc3RkOjpmb3JtYXQoIiAge306IHt9XG4iLCBrZXksIHZhbCk7DQogICAgfQ0KICAgIHN0ZDo6Y291dCA8PCAiW1Jlc3BvbnNlIFBheWxvYWRdOlxuIiA8PCByZXNWMS5ib2R5IDw8ICJcblxuIjsNCg0KICAgIC8vIDIuIEfhu41pIEFQSSB2MiBt4bubaTogS2jDtG5nIGPDsyBTdW5zZXQgSGVhZGVyDQogICAgc3RkOjpjb3V0IDw8ICItLS0gMi4gQ0xJRU5UIMSQw4MgTsOCTkcgQ+G6pFAgTMOKTiBWMiAoR0VUIC92Mi91c2Vycy8xMDEpIC0tLVxuIjsNCiAgICBIdHRwUmVzcG9uc2VDb250ZXh0IHJlc1YyID0gY29udHJvbGxlci5nZXRVc2VyVjIoMTAxKTsNCiAgICBzdGQ6OmNvdXQgPDwgc3RkOjpmb3JtYXQoIkhUVFAgU3RhdHVzIENvZGU6IHt9XG4iLCByZXNWMi5zdGF0dXNDb2RlKTsNCiAgICBzdGQ6OmNvdXQgPDwgc3RkOjpmb3JtYXQoIlN1bnNldCBIZWFkZXIgUHJlc2VudDoge31cbiIsIHJlc1YyLmhlYWRlcnMuY29udGFpbnMoIlN1bnNldCIpID8gIllFUyIgOiAiTk8iKTsNCiAgICBzdGQ6OmNvdXQgPDwgIltSZXNwb25zZSBQYXlsb2FkXTpcbiIgPDwgcmVzVjIuYm9keSA8PCAiXG4iOw0KDQogICAgcmV0dXJuIDA7DQp9DQpgYGANCg0KLS0tDQoNCiMjIyAzLjIuIFBoacOqbiBi4bqjbiBQeXRob24gMy4xMSs6IE3DtCBQaOG7j25nIEtp4buDbSBUaOG7rSBDb25zdW1lci1Ecml2ZW4gQ29udHJhY3QgKENEQykNCg0KYGBgcHl0aG9uDQpmcm9tIF9fZnV0dXJlX18gaW1wb3J0IGFubm90YXRpb25zDQppbXBvcnQganNvbg0KZnJvbSBkYXRhY2xhc3NlcyBpbXBvcnQgZGF0YWNsYXNzDQpmcm9tIHR5cGluZyBpbXBvcnQgRGljdCwgQW55LCBMaXN0DQoNCg0KIyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09DQojIDEuIENPTlNVTUVSIFBBQ1QgQ09OVFJBQ1QgREVGSU5JVElPTg0KIyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09DQpAZGF0YWNsYXNzDQpjbGFzcyBQYWN0SW50ZXJhY3Rpb246DQogICAgZGVzY3JpcHRpb246IHN0cg0KICAgIGVuZHBvaW50OiBzdHINCiAgICBleHBlY3RlZF9zdGF0dXM6IGludA0KICAgIGV4cGVjdGVkX2ZpZWxkczogRGljdFtzdHIsIHR5cGVdICMgQ+G6pXUgdHLDumMgdOG7kWkgdGhp4buDdSBtw6AgQ29uc3VtZXIgYuG6r3QgYnXhu5ljIGPhuqduDQoNCg0KY2xhc3MgQ29uc3VtZXJDb250cmFjdFBhY3Q6DQogICAgIiIiQsOqbiBDb25zdW1lciAoTW9iaWxlIEFwcCkgxJHhu4tuaCBuZ2jEqWEgYuG6o24gY2FtIGvhur90IHbhu4EgZOG7ryBsaeG7h3UgbsOzIGPhuqduLiIiIg0KICAgIEBzdGF0aWNtZXRob2QNCiAgICBkZWYgZ2V0X21vYmlsZV9hcHBfcGFjdCgpIC0+IFBhY3RJbnRlcmFjdGlvbjoNCiAgICAgICAgcmV0dXJuIFBhY3RJbnRlcmFjdGlvbigNCiAgICAgICAgICAgIGRlc2NyaXB0aW9uPSJM4bqleSB0aMO0bmcgdGluIHTDoGkga2hv4bqjbiBjxqEgYuG6o24gY2hvIG3DoG4gaMOsbmggUHJvZmlsZSIsDQogICAgICAgICAgICBlbmRwb2ludD0iL3YxL2FjY291bnRzL21lIiwNCiAgICAgICAgICAgIGV4cGVjdGVkX3N0YXR1cz0yMDAsDQogICAgICAgICAgICBleHBlY3RlZF9maWVsZHM9ew0KICAgICAgICAgICAgICAgICJhY2NvdW50X2lkIjogaW50LA0KICAgICAgICAgICAgICAgICJkaXNwbGF5X25hbWUiOiBzdHIsDQogICAgICAgICAgICAgICAgInRpZXIiOiBzdHINCiAgICAgICAgICAgIH0NCiAgICAgICAgKQ0KDQoNCiMgPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQ0KIyAyLiBQUk9WSURFUiBJTVBMRU1FTlRBVElPTiAoQkFDS0VORCBTRVJWSUNFKQ0KIyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09DQpjbGFzcyBCYWNrZW5kQWNjb3VudFNlcnZpY2U6DQogICAgZGVmIF9faW5pdF9fKHNlbGYsIHNpbXVsYXRlX2JyZWFraW5nX2NoYW5nZTogYm9vbCA9IEZhbHNlKToNCiAgICAgICAgc2VsZi5fYnJlYWtpbmcgPSBzaW11bGF0ZV9icmVha2luZ19jaGFuZ2UNCg0KICAgIGRlZiBoYW5kbGVfcmVxdWVzdChzZWxmLCBlbmRwb2ludDogc3RyKSAtPiB0dXBsZVtpbnQsIERpY3Rbc3RyLCBBbnldXToNCiAgICAgICAgaWYgZW5kcG9pbnQgIT0gIi92MS9hY2NvdW50cy9tZSI6DQogICAgICAgICAgICByZXR1cm4gNDA0LCB7ImVycm9yIjogIk5vdCBGb3VuZCJ9DQoNCiAgICAgICAgaWYgc2VsZi5fYnJlYWtpbmc6DQogICAgICAgICAgICAjIEzhuqxQIFRSw4xOSCBWScOKTiBCQUNLRU5EIFbDlCBUw4xOSCDEkOG7lEkgVMOKTiAnZGlzcGxheV9uYW1lJyBUSMOATkggJ3VzZXJfZnVsbG5hbWUnIQ0KICAgICAgICAgICAgcmV0dXJuIDIwMCwgew0KICAgICAgICAgICAgICAgICJhY2NvdW50X2lkIjogOTk4OCwNCiAgICAgICAgICAgICAgICAidXNlcl9mdWxsbmFtZSI6ICJUcmFuIFRoaSBCIiwgIyBCUkVBS0lORyBDSEFOR0UhDQogICAgICAgICAgICAgICAgInRpZXIiOiAiUExBVElOVU0iDQogICAgICAgICAgICB9DQogICAgICAgIGVsc2U6DQogICAgICAgICAgICAjIFBoacOqbiBi4bqjbiBjaHXhuqluIG3hu7FjIGLhuqNvIHRvw6BuIHTGsMahbmcgdGjDrWNoIG5nxrDhu6NjDQogICAgICAgICAgICByZXR1cm4gMjAwLCB7DQogICAgICAgICAgICAgICAgImFjY291bnRfaWQiOiA5OTg4LA0KICAgICAgICAgICAgICAgICJkaXNwbGF5X25hbWUiOiAiVHJhbiBUaGkgQiIsDQogICAgICAgICAgICAgICAgInRpZXIiOiAiUExBVElOVU0iLA0KICAgICAgICAgICAgICAgICJleHRyYV9tZXRhZGF0YSI6IHsibG9naW5fY291bnQiOiA0Mn0gIyBBZGRpdGl2ZSBjaGFuZ2UgKEFuIHRvw6BuKQ0KICAgICAgICAgICAgfQ0KDQoNCiMgPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQ0KIyAzLiBQQUNUIFZFUklGSUVSIEVOR0lORSAoQ2jhuqF5IHRyb25nIENJL0NEIGPhu6dhIEJhY2tlbmQpDQojID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0NCmNsYXNzIFBhY3RWZXJpZmllckVuZ2luZToNCiAgICBAc3RhdGljbWV0aG9kDQogICAgZGVmIHZlcmlmeShwcm92aWRlcjogQmFja2VuZEFjY291bnRTZXJ2aWNlLCBwYWN0OiBQYWN0SW50ZXJhY3Rpb24pIC0+IGJvb2w6DQogICAgICAgIHByaW50KGYiXG5bUGFjdCBWZXJpZmllcl0gxJBhbmcga2nhu4NtIHRyYSBo4bujcCDEkeG7k25nOiAne3BhY3QuZGVzY3JpcHRpb259JyIpDQogICAgICAgIHN0YXR1cywgcmVzcG9uc2VfcGF5bG9hZCA9IHByb3ZpZGVyLmhhbmRsZV9yZXF1ZXN0KHBhY3QuZW5kcG9pbnQpDQoNCiAgICAgICAgIyAxLiBLaeG7g20gdHJhIEhUVFAgU3RhdHVzDQogICAgICAgIGlmIHN0YXR1cyAhPSBwYWN0LmV4cGVjdGVkX3N0YXR1czoNCiAgICAgICAgICAgIHByaW50KGYiICDinYwgRkFJTEVEOiBL4buzIHbhu41uZyBzdGF0dXMge3BhY3QuZXhwZWN0ZWRfc3RhdHVzfSBuaMawbmcgbmjhuq1uIMSRxrDhu6NjIHtzdGF0dXN9IikNCiAgICAgICAgICAgIHJldHVybiBGYWxzZQ0KDQogICAgICAgICMgMi4gS2nhu4NtIHRyYSB04burbmcgdHLGsOG7nW5nIGThu68gbGnhu4d1IGNhbSBr4bq/dA0KICAgICAgICBmb3IgZmllbGRfbmFtZSwgZXhwZWN0ZWRfdHlwZSBpbiBwYWN0LmV4cGVjdGVkX2ZpZWxkcy5pdGVtcygpOg0KICAgICAgICAgICAgaWYgZmllbGRfbmFtZSBub3QgaW4gcmVzcG9uc2VfcGF5bG9hZDoNCiAgICAgICAgICAgICAgICBwcmludChmIiAg4p2MIENPTlRSQUNUIEJSRUFDSDogVHLGsOG7nW5nIGLhuq90IGJ14buZYyAne2ZpZWxkX25hbWV9JyBi4buLIHRoaeG6v3UgdHJvbmcgcmVzcG9uc2UhIikNCiAgICAgICAgICAgICAgICByZXR1cm4gRmFsc2UNCg0KICAgICAgICAgICAgdmFsID0gcmVzcG9uc2VfcGF5bG9hZFtmaWVsZF9uYW1lXQ0KICAgICAgICAgICAgaWYgbm90IGlzaW5zdGFuY2UodmFsLCBleHBlY3RlZF90eXBlKToNCiAgICAgICAgICAgICAgICBwcmludChmIiAg4p2MIFRZUEUgTUlTTUFUQ0g6IFRyxrDhu51uZyAne2ZpZWxkX25hbWV9JyBr4buzIHbhu41uZyBraeG7g3Uge2V4cGVjdGVkX3R5cGUuX19uYW1lX199IG5oxrBuZyBsw6Age3R5cGUodmFsKS5fX25hbWVfX30hIikNCiAgICAgICAgICAgICAgICByZXR1cm4gRmFsc2UNCg0KICAgICAgICBwcmludCgiICDinIUgVkVSSUZJQ0FUSU9OIFBBU1NFRDogUHJvdmlkZXIgxJHDoXAg4bupbmcgMTAwJSBo4bujcCDEkeG7k25nIGNhbSBr4bq/dCB24bubaSBDb25zdW1lciEiKQ0KICAgICAgICByZXR1cm4gVHJ1ZQ0KDQoNCmlmIF9fbmFtZV9fID09ICJfX21haW5fXyI6DQogICAgcHJpbnQoIj0iICogNjUpDQogICAgcHJpbnQoIiAgIERFTU8gQ09OU1VNRVItRFJJVkVOIENPTlRSQUNUIChDREMpIFZFUklGSUNBVElPTiAoUFlUSE9OKSIpDQogICAgcHJpbnQoIj0iICogNjUpDQoNCiAgICBwYWN0ID0gQ29uc3VtZXJDb250cmFjdFBhY3QuZ2V0X21vYmlsZV9hcHBfcGFjdCgpDQoNCiAgICAjIEvhu4tjaCBi4bqjbiAxOiBCYWNrZW5kIGNo4bqheSBjb2RlIGNodeG6qW4gbeG7sWMgLT4gVGVzdCBwYXNzLCBjaG8gcGjDqXAgZGVwbG95DQogICAgcHJpbnQoIlxuLS0tIFRFU1QgQ0FTRSAxOiBCQUNLRU5EIFRVw4JOIFRI4bumIEjhu6JQIMSQ4buSTkcgLS0tIikNCiAgICBnb29kX2JhY2tlbmQgPSBCYWNrZW5kQWNjb3VudFNlcnZpY2Uoc2ltdWxhdGVfYnJlYWtpbmdfY2hhbmdlPUZhbHNlKQ0KICAgIGNhbl9kZXBsb3lfMSA9IFBhY3RWZXJpZmllckVuZ2luZS52ZXJpZnkoZ29vZF9iYWNrZW5kLCBwYWN0KQ0KICAgIHByaW50KGYiVHLhuqFuZyB0aMOhaSBDSS9DRCBDYW4tSS1EZXBsb3k6IHsnQ0hPIFBIw4lQIERFUExPWScgaWYgY2FuX2RlcGxveV8xIGVsc2UgJ0NI4bq2TiBERVBMT1knfSIpDQoNCiAgICAjIEvhu4tjaCBi4bqjbiAyOiBCYWNrZW5kIMSR4buVaSB0w6puIHRyxrDhu51uZyBgZGlzcGxheV9uYW1lYCAtPiBUZXN0IHBow6F0IGhp4buHbiB2w6AgY2jhurduIMSR4bupbmcNCiAgICBwcmludCgiXG4tLS0gVEVTVCBDQVNFIDI6IEJBQ0tFTkQgVsOUIFTDjE5IIFBIw4EgVuG7oCBI4buiUCDEkOG7kk5HIChCUkVBS0lORyBDSEFOR0UpIC0tLSIpDQogICAgYnJva2VuX2JhY2tlbmQgPSBCYWNrZW5kQWNjb3VudFNlcnZpY2Uoc2ltdWxhdGVfYnJlYWtpbmdfY2hhbmdlPVRydWUpDQogICAgY2FuX2RlcGxveV8yID0gUGFjdFZlcmlmaWVyRW5naW5lLnZlcmlmeShicm9rZW5fYmFja2VuZCwgcGFjdCkNCiAgICBwcmludChmIlRy4bqhbmcgdGjDoWkgQ0kvQ0QgQ2FuLUktRGVwbG95OiB7J0NITyBQSMOJUCBERVBMT1knIGlmIGNhbl9kZXBsb3lfMiBlbHNlICdDSOG6tk4gREVQTE9ZIChCVUlMRCBGQUlMRUQpJ30iKQ0KYGBgDQoNCiMjIyAzLjMuIEdp4bqjIEzhuq1wIFRlcm1pbmFsIE91dHB1dCBUaOG7sWMgVOG6vw0KDQpgYGB0ZXh0DQo9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0NCiAgREVNTyBBUEkgQ09OVFJBQ1QgJiBSRkMgODU5NCBTVU5TRVQgSEVBREVSUyAoQysrMjApICAgIA0KPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09DQoNCi0tLSAxLiBDTElFTlQgR+G7jEkgRU5EUE9JTlQgVjEgKEdFVCAvdjEvdXNlcnMvMTAxKSAtLS0NCkhUVFAgU3RhdHVzIENvZGU6IDIwMA0KW1Jlc3BvbnNlIEhlYWRlcnNdOg0KICBDb250ZW50LVR5cGU6IGFwcGxpY2F0aW9uL2pzb24NCiAgRGVwcmVjYXRpb246IHRydWUNCiAgU3Vuc2V0OiBXZWQsIDExIE5vdiAyMDI2IDAwOjAwOjAwIEdNVA0KICBMaW5rOiA8aHR0cHM6Ly9hcGkuZW50ZXJwcmlzZS5jb20vZG9jcy92Mi9taWdyYXRpb24+OyByZWw9InN1bnNldCINCltSZXNwb25zZSBQYXlsb2FkXToNCnsNCiAgImlkIjogMTAxLA0KICAiZnVsbE5hbWUiOiAiTmd1eWVuIFZhbiBBbiIsDQogICJlbWFpbCI6ICJhbi5uZ3V5ZW5AZW50ZXJwcmlzZS52biINCn0NCg0KLS0tIDIuIENMSUVOVCDEkMODIE7Dgk5HIEPhuqRQIEzDik4gVjIgKEdFVCAvdjIvdXNlcnMvMTAxKSAtLS0NCkhUVFAgU3RhdHVzIENvZGU6IDIwMA0KU3Vuc2V0IEhlYWRlciBQcmVzZW50OiBOTw0KW1Jlc3BvbnNlIFBheWxvYWRdOg0Kew0KICAiaWQiOiAxMDEsDQogICJmaXJzdE5hbWUiOiAiQW4iLA0KICAibGFzdE5hbWUiOiAiTmd1eWVuIFZhbiIsDQogICJjb3Jwb3JhdGVFbWFpbCI6ICJhbi5uZ3V5ZW5AZW50ZXJwcmlzZS52biIsDQogICJzZWNvbmRhcnlFbWFpbCI6IG51bGwNCn0NCmBgYA0KDQotLS0NCg0KIyMgNC4gU3lzdGVtcyBFbmdpbmVlcmluZyAmIFByb2R1Y3Rpb24gUGl0ZmFsbHMNCg0KIyMjIEPhuqFtIELhuqt5IFPhuqNuIFh14bqldCBUaMaw4budbmcgR+G6t3AgKFByb2R1Y3Rpb24gQW50aS1QYXR0ZXJucyAmIEdvdGNoYXMpDQoNCjEuICoqSGnhu4NtIEjhu41hIFpvbWJpZSBBUElzICYgQ2hpIFBow60gSOG6oSBU4bqnbmcgQuG7iyBMw6NuZyBQaMOtIChab21iaWUgRW5kcG9pbnRzKSoqOg0KICAgLSAqQuG6o24gY2jhuqV0KjogUGjDoXQgaMOgbmggQVBJIGAvdjJgIG5oxrBuZyBraMO0bmcgYmFvIGdp4budIGtoYWkgdOG7rSBgL3YxYC4gU2F1IDUgbsSDbSwgaOG7hyB0aOG7kW5nIHThu5NuIHThuqFpIMSR4buTbmcgdGjhu51pIGAvdjFgLCBgL3YyYCwgYC92M2AsIGAvdjRgLiDEkOG7mWkgbmfFqSBr4bu5IHPGsCBraMO0bmcgZMOhbSB4w7NhIGAvdjFgIHbDrCBz4bujIGzDoG0gduG7oSBt4buZdCDhu6luZyBk4bulbmcgbuG7mWkgYuG7mSBuw6BvIMSRw7Mga2jDtG5nIHLDtSBjaOG7pyBz4bufIGjhu691LiBDaGkgcGjDrSB24bqtbiBow6BuaCwgYuG6o28gdHLDrCwgdsOhIGzhu5dpIGLhuqNvIG3huq10IHTEg25nIGfhuqVwIDQgbOG6p24uDQogICAtICpHaeG6o2kgcGjDoXAqOiBUaGnhur90IGzhuq1wIHF1eSBjaOG6vyB2w7JuZyDEkeG7nWkgYuG6pXQgYmnhur9uOiBC4bqldCBr4buzIEFQSSBuw6BvIGLhu4sgZGVwcmVjYXRlZCBjaOG7iSDEkcaw4bujYyBwaMOpcCBz4buRbmcgdOG7kWkgxJFhIDEyIHRow6FuZy4gUGjhuqNpIGPDsyBjw7RuZyBj4bulIGdpw6FtIHPDoXQgbMawdSBsxrDhu6NuZyBn4buNaSB2w6BvIFVSTCBjxakgxJHhu4MgY2jhu6cgxJHhu5luZyBsacOqbiBo4buHIG5nxrDhu51pIGTDuW5nIHRyxrDhu5tjIG5nw6B5IFN1bnNldC4NCg0KMi4gKipYdW5nIMSQ4buZdCBGaWVsZCBUYWcgVHJvbmcgUHJvdG9idWYgKFRhZyBSZXVzZSBEaXNhc3RlcikqKjoNCiAgIC0gKkLhuqNuIGNo4bqldCo6IEzhuq1wIHRyw6xuaCB2acOqbiB4w7NhIHRyxrDhu51uZyBjxakgYHN0cmluZyBwaG9uZV9udW1iZXIgPSAzO2AgdsOgIHThuqFvIG3hu5l0IHRyxrDhu51uZyBt4bubaSBgaW50NjQgYWNjb3VudF9pZCA9IDM7YCB0w6FpIHPhu60gZOG7pW5nIFRhZyBz4buRIDMuIEtoaSBzZXJ2ZXIgbeG7m2kgZ+G7rWkgZOG7ryBsaeG7h3UgY2hvIGNsaWVudCBjxaksIHBhcnNlciBuaOG7iyBwaMOibiBz4bq9IGPhu5Egw6lwIGtp4buDdSBjaHXhu5dpIHRow6BuaCBz4buRIG5ndXnDqm4gdsOgIGfDonkgc+G6rXAgdGnhur9uIHRyw6xuaCBuZ2F5IGzhuq1wIHThu6ljICgqKkNyYXNoIENyYXNoKiopLg0KICAgLSAqR2nhuqNpIHBow6FwKjogS2hpIG5n4burbmcgc+G7rSBk4bulbmcgbeG7mXQgdHLGsOG7nW5nIHRyb25nIFByb3RvYnVmLCBi4bqvdCBideG7mWMgZMO5bmcgdOG7qyBraMOzYSBgcmVzZXJ2ZWQgMzsgcmVzZXJ2ZWQgInBob25lX251bWJlciI7YC4gVHLDrG5oIGJpw6puIGThu4tjaCBgcHJvdG9jYCBz4bq9IGNo4bq3biDEkeG7qW5nIGLhuqV0IGvhu7MgYWkgY+G7kSBn4bqvbmcgZMO5bmcgbOG6oWkgVGFnIHPhu5EgMy4NCg0KMy4gKipDaOG7pyBRdWFuIFRpbiBUxrDhu59uZyBWw6BvIFZp4buHYyBLaMOhY2ggSMOgbmcgVHXDom4gVGjhu6cgVGjDtG5nIELDoW8gRW1haWwqKjoNCiAgIC0gKkLhuqNuIGNo4bqldCo6IEfhu61pIGVtYWlsIHRow7RuZyBiw6FvIMSR4buVaSBBUEkgbmjGsG5nIGPDoWMga+G7uSBzxrAgxJHhu5FpIHTDoWMga2jDtG5nIMSR4buNYy4gxJDhur9uIG5nw6B5IGPhuq90IGThu4tjaCB24bulLCBo4buHIHRo4buRbmcgxJHhu5FpIHTDoWMgbmfhu6tuZyB0cuG7hyBnw6J5IGtp4buHbiB04bulbmcgdGjGsMahbmcgbeG6oWkuDQogICAtICpHaeG6o2kgcGjDoXAqOiBU4buxIMSR4buZbmcgdGnDqm0gSFRUUCBTdW5zZXQgSGVhZGVyIHbDoCBrw61jaCBob+G6oXQgY8ahIGNo4bq/ICoqQnJvd25vdXQgVGVzdGluZyAoVOG6r3Qgbmfhuq90IHF1w6NuZyBjw7MgY2jhu6cgxJHDrWNoKSoqIHRyxrDhu5tjIDMwIG5nw6B5IMSR4buDIGJ14buZYyDEkeG7kWkgdMOhYyBwaOG6o2kgY2jDuiDDvSBsb2cgbOG7l2kgdsOgIG7Dom5nIGPhuqVwLg0KDQo0LiAqKkvhu7kgVGh14bqtdCBDaOG6qW4gxJBvw6FuICYgR2nDoW0gU8OhdCBQcm9kdWN0aW9uIELhurFuZyBDTEkqKjoNCiAgIGBgYGJhc2gNCiAgICMgMS4gUXXDqXQgdMOsbSBjw6FjIGzhu51pIGfhu41pIEFQSSBjxakgY8OybiBkw61uaCBsw611IMSR4bq/biB2MSB0cm9uZyBBV1MgQ2xvdWRXYXRjaCBMb2dzDQogICBhd3MgbG9ncyBmaWx0ZXItbG9nLWV2ZW50cyAtLWxvZy1ncm91cC1uYW1lICIvYXdzL2FwaWdhdGV3YXkvZW50ZXJwcmlzZS1hcGkiIFwNCiAgICAgLS1maWx0ZXItcGF0dGVybiAneyAkLnJlcXVlc3RQYXRoID0gIi92MS8qIiB9JyAtLWxpbWl0IDIwDQoNCiAgICMgMi4gQ2jhuqF5IFBhY3QgQnJva2VyIENMSSDEkeG7gyBraeG7g20gdHJhIHTDrW5oIHPhurVuIHPDoG5nIHRyxrDhu5tjIGtoaSBkZXBsb3kNCiAgIHBhY3QtYnJva2VyIGNhbi1pLWRlcGxveSBcDQogICAgIC0tcGFjdGljaXBhbnQgT3JkZXJTZXJ2aWNlIC0tdmVyc2lvbiAyLjQuMSBcDQogICAgIC0tdG8tZW52aXJvbm1lbnQgcHJvZHVjdGlvbiAtLWJyb2tlci1iYXNlLXVybCBodHRwczovL3BhY3QuY29ycC5jb20NCg0KICAgIyAzLiBUaOG6qW0gxJHhu4tuaCBjw7ogcGjDoXAgZmlsZSBPcGVuQVBJIGLhurFuZyBTcGVjdHJhbCBMaW50ZXINCiAgIG5weCBAc3RvcGxpZ2h0L3NwZWN0cmFsLWNsaSBsaW50IG9wZW5hcGkvdjEvY3VzdG9tZXItc3BlYy55YW1sDQogICBgYGANCg0KLS0tDQoNCiMjIDUuIELhuqNuZyBTbyBzw6FuaCAmIERlY2lzaW9uIE1hdHJpeA0KDQojIyMgNS4xLiBTbyBTw6FuaCBDw6FjIE5nw7RuIE5n4buvIMSQ4bq3YyBU4bqjIEjhu6NwIMSQ4buTbmcgQVBJIChDb250cmFjdCBTcGVjaWZpY2F0aW9ucykNCg0KfCBUacOqdSBDaMOtIEvhu7kgVGh14bqtdCB8IE9wZW5BUEkgKE9BUyAzLjEpIHwgUHJvdG9jb2wgQnVmZmVycyAoUHJvdG9idWYpIHwgSlNPTiBTY2hlbWEgfCBHcmFwaFFMIFNETCB8DQp8IDotLS0gfCA6LS0tIHwgOi0tLSB8IDotLS0gfCA6LS0tIHwNCnwgKipHaWFvIHRo4bupYyBt4bulYyB0acOqdSoqIHwgUkVTVGZ1bCBIVFRQLzEuMSAmIEhUVFAvMiB8IGdSUEMgLyBIVFRQLzIgfCBKU09OIHBheWxvYWRzIHThu5VuZyBxdcOhdCB8IEdyYXBoUUwgRW5naW5lIHwNCnwgKirEkOG7i25oIGThuqFuZyBk4buvIGxp4buHdSoqIHwgWUFNTCAvIEpTT04gfCBCaW5hcnkgRm9ybWF0IHwgSlNPTiB8IEdyYXBoUUwgU2NoZW1hIERlZmluaXRpb24gfA0KfCAqKsSQ4buZIHRy4buFIHR14bqnbiB04buxIGjDs2EqKnwgVHJ1bmcgYsOsbmggKFRleHQgcGFyc2luZykgfCBD4buxYyBuaGFuaCAoJDEwXHRpbWVzJCkgfCBOL0EgKENo4buJIHZhbGlkYXRlKSB8IFRydW5nIGLDrG5oIHwNCnwgKipI4buXIHRy4bujIENvZGUgR2VuKiogfCBS4bqldCBt4bqhbmggKFN3YWdnZXIgQ29kZWdlbikgfCBIb8OgbiBo4bqjbyAocHJvdG9jIGNvbXBpbGVyKSB8IFRydW5nIGLDrG5oIHwgUuG6pXQgdOG7kXQgfA0KfCAqKkto4bqjIG7Eg25nIMSR4buNYyBoaeG7g3UqKiB8IENvbiBuZ8aw4budaSDEkeG7jWMgdHLhu7FjIHRp4bq/cCBk4buFIHwgQ+G6p24gZmlsZSBgLnByb3RvYCDEkeG7gyBk4buLY2ggfCBE4buFIHwgROG7hSB8DQp8ICoqVHLGsOG7nW5nIGjhu6NwIHThu5FpIMawdSoqIHwgUHVibGljIFdlYi9Nb2JpbGUgQVBJcyB8IE1pY3Jvc2VydmljZSBu4buZaSBi4buZLCBJb1QgfCBUaOG6qW0gxJHhu4tuaCBydW50aW1lIHBheWxvYWQgfCBEeW5hbWljIEZyb250ZW5kIFF1ZXJ5IHwNCg0KIyMjIDUuMi4gTWEgVHLhuq1uIFF1eeG6v3QgxJDhu4tuaCBY4butIEzDvSBUaGF5IMSQ4buVaSBBUEkgKENoYW5nZSBEZWNpc2lvbiBNYXRyaXgpDQoNCnwgSMOgbmggxJDhu5luZyBUaGF5IMSQ4buVaSDEkOG7gSBYdeG6pXQgfCBMb+G6oWkgVGhheSDEkOG7lWkgfCBDw6FjaCBY4butIEzDvSBDaHXhuqluIE3hu7FjIHwgQ+G6p24gTsOibmcgTWlub3IvTWFqb3I/IHwNCnwgOi0tLSB8IDotLS06IHwgOi0tLSB8IDotLS06IHwNCnwgKipUaMOqbSB0csaw4budbmcgbeG7m2kgdMO5eSBjaOG7jW4gdsOgbyBSZXF1ZXN0KiogfCBOb24tQnJlYWtpbmcgfCBD4bqtcCBuaOG6rXQgdMOgaSBsaeG7h3UgT3BlbkFQSSwgZ2nhu68gbmd1ecOqbiBVUkwgYC92MWAgfCBUxINuZyBNaW5vciAoYDEuMS4wYCkgfA0KfCAqKlRow6ptIHRyxrDhu51uZyBt4bubaSB2w6BvIFJlc3BvbnNlIEpTT04qKiB8IE5vbi1CcmVha2luZyB8IFnDqnUgY+G6p3UgQ2xpZW50IGTDuW5nIFRvbGVyYW50IFJlYWRlciwgZ2nhu68gYC92MWAgfCBUxINuZyBNaW5vciAoYDEuMS4wYCkgfA0KfCAqKljDs2EgbeG7mXQgdHLGsOG7nW5nIMSRYW5nIHThu5NuIHThuqFpIHRyb25nIFJlc3BvbnNlKip8ICoqQnJlYWtpbmcqKiB8ICoqQ+G6pE0gc+G7rWEgdHLhu7FjIHRp4bq/cCEqKiBU4bqhbyBgL3YyYCwgZ+G6r24gU3Vuc2V0IGNobyBgL3YxYHwgVMSDbmcgTWFqb3IgKGAyLjAuMGApIHwNCnwgKirEkOG7lWkga2nhu4N1IGThu68gbGnhu4d1IHThu6sgYGludGAgc2FuZyBgc3RyaW5nYCoqIHwgKipCcmVha2luZyoqIHwgKipD4bqkTSBz4butYSB0cuG7sWMgdGnhur9wISoqIFThuqFvIGAvdjJgLCBo4buXIHRy4bujIG1pZ3JhdGlvbiB8IFTEg25nIE1ham9yIChgMi4wLjBgKSB8DQp8ICoqU+G7rWEgbOG7l2kgY2jDrW5oIHThuqMgdMOqbiB0csaw4budbmcgSlNPTioqIHwgKipCcmVha2luZyoqIHwgR2nhu68gdHLGsOG7nW5nIGPFqSwgdGjDqm0gdHLGsOG7nW5nIG3hu5tpIHNvbmcgc29uZyBj4bqjIGhhaSB8IFTEg25nIE1pbm9yIChgMS4yLjBgKSB8DQp8ICoqU+G7rWEgxJHhu5VpIGxvZ2ljIHTDrW5oIHRvw6FuIG7hu5lpIGLhu5kgKEJ1ZyBmaXgpKip8IFNhZmUgfCBUcmnhu4NuIGtoYWkgdHLhu7FjIHRp4bq/cCBraMO0bmcgY+G6p24gxJHhu5VpIHNjaGVtYSB8IFTEg25nIFBhdGNoIChgMS4wLjFgKSB8DQo=