Chế độ giao diện
6.2. Thiết Kế Chuẩn Mực RESTful API (REST API Design & Best Practices)
IMPORTANT
Nếu bạn chỉ được nhớ một điều duy nhất: Thiết kế RESTful API chuẩn mực không phải là nhét JSON vào URL bất kỳ, mà là mô hình hóa tài nguyên (Resource Modeling) và tôn trọng tuyệt đối ngữ nghĩa giao thức HTTP (RFC 9110) — dùng danh từ số nhiều cho URI, phân biệt rạch ròi tính Safe/Idempotent của các động từ, thay thế phân trang Offset bằng Cursor Pagination ở quy mô lớn và chuẩn hóa cấu trúc lỗi theo RFC 9457.
1. Kiến trúc Tổng quan & Mô hình Tư duy (Mental Model)
Ẩn dụ Đời sống: Thư Viện Quốc Gia và Hệ Thống Tra Cứu Thẻ Mục Lục
Hãy hình dung thiết kế một hệ thống RESTful API chuẩn mực tương tự như cách tổ chức và vận hành một Thư viện Quốc gia quy mô triệu đầu sách:
- Tài nguyên & Danh từ số nhiều (
/books,/authors): Mỗi cuốn sách, tác giả hay thẻ mượn là một "Tài nguyên" có mã định danh bất biến. Khách không bao giờ nói: "Cho tôi hành động lấy sách số 10" (/getBook?id=10- Level 0/RPC), mà nói: "Tôi muốn xem thông tin tại ngăn sách số 10" (GET /books/10- Level 2/REST). - Quan hệ thứ bậc lồng ghép (
/authors/7/books): Để tìm các cuốn sách của tác giả số 7, thủ thư mở ngăn kéo của tác giả đó và xem danh mục sách bên trong. - Richardson Maturity Model (Các cấp bậc hiện đại hóa thư viện):
- Level 0 (Hòm thư duy nhất): Mọi yêu cầu mượn, trả, tìm sách đều nhét chung vào một hòm thư giấy duy nhất (
POST /libraryEndpoint). - Level 1 (Chia từng quầy riêng biệt): Có quầy Sách, quầy Tác giả, quầy Thẻ mượn riêng (
/books,/authors), nhưng mọi việc ở mọi quầy đều xử lý qua một loại giấy biên nhận chung (POST). - Level 2 (Chuẩn hóa hành động & Biên lai): Đọc sách dùng mắt xem (
GET- Safe), đăng ký thẻ mới điền đơn (POST- Non-idempotent), đổi toàn bộ thông tin thẻ (PUT- Idempotent), xé bỏ thẻ (DELETE- Idempotent). Trả biên lai chuẩn màu xanh200/201khi thành công, màu đỏ400/404khi lỗi. - Level 3: HATEOAS (Tấm bản đồ chỉ đường thông minh đính kèm): Khi thủ thư trả sách cho bạn, trên phiếu mượn in sẵn các liên kết: "Bấm vào đây để gia hạn" (
rel: extend), "Bấm vào đây để thanh toán tiền phạt" (rel: pay). Bạn không cần nhớ quy trình tiếp theo, chính tài nguyên sẽ hướng dẫn bạn.
- Level 0 (Hòm thư duy nhất): Mọi yêu cầu mượn, trả, tìm sách đều nhét chung vào một hòm thư giấy duy nhất (
- Offset vs Cursor Pagination (Đếm từng trang sách vs Dải ruy băng đánh dấu trang):
- Offset Pagination: Thủ thư bắt bạn lật từ trang 1 đến trang 100,000 để đọc tiếp trang 100,001 (
scan kiệt sức). Nếu ai đó xé mất 1 trang ở giữa, toàn bộ số trang bị lệch và bạn đọc trùng nội dung. - Cursor Pagination: Bạn kẹp một dải ruy băng ghi ID cuốn sách cuối cùng (
cursor = book_id_9988). Lần sau chỉ cần mở ngay sau dải ruy băng qua Index B-Tree ( ).
- Offset Pagination: Thủ thư bắt bạn lật từ trang 1 đến trang 100,000 để đọc tiếp trang 100,001 (
- RFC 9457 Problem Details (Phiếu báo lỗi tiêu chuẩn y tế/pháp lý): Không trả về thông báo lỗi chung chung kiểu
"Lỗi rồi!", mà có mẫu in chuẩn quốc tế: loại lỗi gì, tiêu đề, mã số, lý do chi tiết và đường dẫn request cụ thể.
flowchart TD
subgraph ResourceSpace["Mô Hình Hóa Tài Nguyên (Resource Modeling)"]
Collection["Tập Hợp Danh Từ Số Nhiều: /v1/orders"]
Item["Thực Thể Con Cụ Thể: /v1/orders/{orderId}"]
SubCollection["Mối Quan Hệ Phân Cấp: /v1/orders/{orderId}/items"]
end
subgraph HttpSemantics["Ngữ Nghĩa Động Từ & Ràng Buộc An Toàn (RFC 9110)"]
GET["GET: Safe & Idempotent (Chỉ đọc, Cacheable)"]
POST["POST: Unsafe & Non-Idempotent (Tạo mới)"]
PUT["PUT: Unsafe & Idempotent (Thay thế toàn bộ)"]
PATCH["PATCH: Unsafe & Partial Update (Sửa 1 phần)"]
DELETE["DELETE: Unsafe & Idempotent (Hủy tài nguyên)"]
end
subgraph Maturity["Cấp Độ Trưởng Thành Richardson (Maturity Model)"]
L0["Level 0: The Swamp of POX (RPC, One Endpoint POST)"]
L1["Level 1: Separate Resources (Nhiều URIs)"]
L2["Level 2: HTTP Verbs & Status Codes (GET/POST/PUT/DELETE)"]
L3["Level 3: HATEOAS (Hypermedia As The Engine of App State)"]
L0 --> L1 --> L2 --> L3
end
Collection --> HttpSemantics
Item --> HttpSemantics
SubCollection --> HttpSemantics
2. Chi tiết từng Keyword (Under-the-Hood Deep Dive)
2.1. Resource Modeling, Naming & Richardson Maturity Model
1. Quy Chuẩn Đặt Tên URI & Mô Hình Hóa Tài Nguyên
- Sử dụng Danh từ số nhiều (Plural Nouns): Đại diện cho một tập hợp thực thể:
- Chuẩn:
/v1/users,/v1/products,/v1/invoices. - Cấm tuyệt đối: Dùng động từ trong URI (như
/v1/getUsers,/v1/createProduct,/v1/deleteInvoice). Động từ phải được biểu đạt bằng chính các phương thức HTTP.
- Chuẩn:
- Ký tự và Định dạng (Kebab-case):
- Sử dụng chữ viết thường và dấu gạch ngang:
/v1/payment-methods,/v1/customer-addresses. - Không dùng camelCase (
/paymentMethods) hay snake_case (/payment_methods) trong path URL.
- Sử dụng chữ viết thường và dấu gạch ngang:
- Mô hình hóa quan hệ Cha - Con (Sub-resources):
- Chỉ nên lồng tối đa 2 cấp để tránh URI quá dài và phức tạp:
/v1/teams/{teamId}/members/{memberId}. - Nếu mối quan hệ phức tạp hơn, hãy làm phẳng (Flattening) tài nguyên: Thay vì
/v1/companies/{cId}/departments/{dId}/teams/{tId}/employees, hãy dùng/v1/employees?team_id={tId}.
- Chỉ nên lồng tối đa 2 cấp để tránh URI quá dài và phức tạp:
2. Richardson Maturity Model (Mô Hình Trưởng Thành REST)
- Level 0: The Swamp of POX (Đầm lầy Plain Old XML/JSON):
- Dùng HTTP chỉ như một giao thức truyền tải tầng dưới (Transport mechanism cho RPC).
- Chỉ có 1 endpoint duy nhất (ví dụ:
POST /api/service), mọi lệnh gọi được bọc trong body:{"action": "createOrder", "data": {...}}. Luôn trả về HTTP status 200 kèm body lỗi nếu thất bại.
- Level 1: Resources (Tài Nguyên Riêng Biệt):
- Hệ thống bắt đầu phân tách các URIs khác nhau cho từng đối tượng (
/orders,/customers), nhưng vẫn chỉ dùng một phương thức HTTP duy nhất (hầu hết làPOST).
- Hệ thống bắt đầu phân tách các URIs khác nhau cho từng đối tượng (
- Level 2: HTTP Verbs & Status Codes (Chuẩn Ngữ Nghĩa HTTP):
- Áp dụng đầy đủ và chính xác các động từ HTTP (
GETđể truy vấn,POSTđể tạo mới,PUT/PATCHđể cập nhật,DELETEđể xóa). - Trả về mã HTTP Status Codes chuẩn (
201 Created,404 Not Found,409 Conflict,422 Unprocessable). - Hơn 95% API trong các tập đoàn công nghệ hiện nay vận hành ở Level 2.
- Áp dụng đầy đủ và chính xác các động từ HTTP (
- Level 3: Hypermedia Controls (HATEOAS):
- Hypermedia As The Engine Of Application State: Server trả về dữ liệu kèm theo các siêu liên kết (
_linkshoặc JSON:API format) mô tả các hành động tiếp theo mà Client có quyền thực hiện dựa trên trạng thái hiện tại của tài nguyên. Client không cần hardcode URL của các bước kế tiếp.
- Hypermedia As The Engine Of Application State: Server trả về dữ liệu kèm theo các siêu liên kết (
json
{
"orderId": "ORD-998877",
"status": "AWAITING_PAYMENT",
"totalAmountUSD": 149.99,
"_links": {
"self": { "href": "/v1/orders/ORD-998877", "method": "GET" },
"payment": { "href": "/v1/orders/ORD-998877/payments", "method": "POST" },
"cancel": { "href": "/v1/orders/ORD-998877/cancel", "method": "POST" }
}
}1
2
3
4
5
6
7
8
9
10
2
3
4
5
6
7
8
9
10
2.2. HTTP Methods Semantics: Safe vs Idempotent & Status Codes
1. Bản Chất Kỹ Thuật: Safe Methods vs Idempotent Methods
- Safe Methods (Phương thức An toàn - RFC 9110):
- Các phương thức được định nghĩa là chỉ đọc (Read-only), việc thực thi chúng không được gây ra bất kỳ tác dụng phụ (side-effects) làm thay đổi trạng thái dữ liệu trên máy chủ.
- Các phương thức an toàn:
GET,HEAD,OPTIONS,TRACE. - Các trình duyệt web, proxy và crawler (như Googlebot) giả định mọi lời gọi
GETđều an toàn và có thể tự ý kích hoạt lại hoặc tải trước (Prefetching) mà không gây nguy hiểm.
- Idempotent Methods (Phương thức Bất biến tác dụng):
- Một phương thức là Idempotent nếu gọi
lần liên tiếp ( ) với cùng tham số đều dẫn tới trạng thái dữ liệu trên máy chủ hoàn toàn đồng nhất như nhau. PUT: Thay thế toàn bộ bản ghi. Gọi 10 lần vẫn là thay thế bản ghi đó bằng dữ liệu đó Idempotent.DELETE: Xóa bản ghi. Lần 1 xóa thành công (204/200), lần 2 báo không tìm thấy (404), nhưng trạng thái máy chủ sau lần 1 và lần 10 là như nhau (bản ghi không còn tồn tại) Idempotent.POST: Tạo mới bản ghi. Gọi 10 lần sinh ra 10 bản ghi khác nhau Non-Idempotent.PATCH: Về lý thuyết RFC là Non-Idempotent (nếu dùng thao tác cộng dồn{"op": "increment", "value": 5}), nhưng trong thực tế thường được thiết kế Idempotent (chỉ cập nhật một số trường cụ thể{"status": "ACTIVE"}).
- Một phương thức là Idempotent nếu gọi
2. Hệ Thống Mã Trạng Thái HTTP (Status Codes Hierarchy) Chuẩn Mực
| Dải Mã | Mã Cụ Thể | Ý Nghĩa Kỹ Thuật Chuẩn | Ngữ Cảnh Sử Dụng Đúng |
|---|---|---|---|
| 2xx | 200 OK | Thành công chung | Trả về dữ liệu cho GET, PUT, PATCH |
| 201 Created | Tạo tài nguyên mới thành công | Trả về cho POST kèm Header Location: /v1/orders/101 | |
| 202 Accepted | Tiếp nhận tác vụ bất đồng bộ | Cho các tiến trình nền (Async Job/Worker chưa xong ngay) | |
| 204 No Content | Thành công nhưng không có body | Thường dùng cho DELETE hoặc PUT không cần trả payload | |
| 3xx | 301 Moved | Đổi URL vĩnh viễn | Chuyển hướng endpoint vĩnh viễn (SEO friendly) |
| 304 Not Modified | Dữ liệu cache chưa thay đổi | Cực kỳ quan trọng: Trả về khi khớp ETag / If-None-Match | |
| 4xx | 400 Bad Request | Sai cú pháp request | JSON parse error, sai định dạng trường |
| 401 Unauthorized | Chưa định danh (Unauthenticated) | Thiếu JWT Token, Token hết hạn, sai chữ ký số | |
| 403 Forbidden | Không có quyền (Unauthorized) | Đã xác thực nhưng Role/Permission không đủ quyền | |
| 404 Not Found | Không tìm thấy tài nguyên | URI không tồn tại hoặc ID không có trong cơ sở dữ liệu | |
| 409 Conflict | Xung đột trạng thái hệ thống | Trùng Email duy nhất, trùng phiên bản khóa lạc quan | |
| 422 Unprocessable | Vi phạm quy tắc nghiệp vụ | Cú pháp JSON đúng nhưng tuổi < 18 hoặc số dư không đủ | |
| 429 Too Many Req | Bị chặn do vượt quá Rate Limit | Vượt quota API, trả kèm header Retry-After: 60 | |
| 5xx | 500 Internal Err | Lỗi hệ thống không lường trước | Crash tiến trình, Unhandled Exception, OOM |
| 502 Bad Gateway | Cổng trung gian bị lỗi upstream | Nginx / Envoy không kết nối được tới Backend service | |
| 503 Service Unavail | Dịch vụ đang quá tải / bảo trì | Hệ thống Circuit Breaker đang ngắt mạch | |
| 504 Gateway Timeout | Hết thời gian chờ upstream | Microservice phía sau phản hồi quá chậm (> 30s) |
2.3. Query Engineering: Offset vs Cursor Pagination & RFC 9457 Problem Details
1. So Sánh Bản Chất Kỹ Thuật: Offset-based vs Cursor-based Pagination
flowchart TD
subgraph OffsetPaging["1. Offset-based Pagination: ?page=1000&limit=20"]
O1["Câu lệnh SQL: SELECT * FROM orders ORDER BY id ASC LIMIT 20 OFFSET 20000;"]
O2["Database Engine B-Tree Index: Buộc phải quét tuần tự 20,020 bản ghi"]
O3["Vấn đề: O(N) Disk & CPU Scan. Rủi ro Duplicate reading khi có dữ liệu mới chèn vào."]
O1 --> O2 --> O3
end
subgraph CursorPaging["2. Cursor-based (Keyset) Pagination: ?cursor=eyJpZCI6MjAwMDB9&limit=20"]
C1["Câu lệnh SQL: SELECT * FROM orders WHERE id > 20000 ORDER BY id ASC LIMIT 20;"]
C2["Database Engine B-Tree Index: Nhảy thẳng tới nút id = 20000 với độ phức tạp O(log N)"]
C3["Ưu điểm: Tốc độ siêu tốc bất biến dù dữ liệu hàng tỷ dòng. Không bao giờ trôi dữ liệu."]
C1 --> C2 --> C3
end
- Offset-based Pagination (
LIMIT 20 OFFSET 1000000):- Cơ chế: Database phải duyệt qua
dòng dữ liệu đầu tiên, nạp vào RAM rồi sau đó vứt bỏ toàn bộ để chỉ lấy đúng 20 dòng cuối cùng. - Hiện tượng trôi dữ liệu (Data Drift / Page Drift): Khi user đang ở trang 1, nếu có 1 đơn hàng mới được tạo chèn vào đầu bảng, khi user bấm sang trang 2, toàn bộ bản ghi bị đẩy lùi 1 nấc, khiến user nhìn thấy bản ghi cuối cùng của trang 1 lặp lại ở đầu trang 2.
- Cơ chế: Database phải duyệt qua
- Cursor-based / Keyset Pagination (
WHERE id > :last_seen_id LIMIT 20):- Cơ chế: Con trỏ (Cursor) là một chuỗi mã hóa Base64 chứa giá trị của cột định danh sắp xếp (thường là
idhoặccreated_atcó đánh chỉ mục B-Tree). - Hiệu năng: Database sử dụng phép tìm kiếm cây nhị phân (Index Seek) để nhảy trực tiếp đến nút con trỏ với chi phí
, hoàn toàn miễn nhiễm với khối lượng dữ liệu khổng lồ phía trước.
- Cơ chế: Con trỏ (Cursor) là một chuỗi mã hóa Base64 chứa giá trị của cột định danh sắp xếp (thường là
2. Chuẩn Hóa Lỗi Toàn Cầu Theo RFC 9457 (Problem Details for HTTP APIs)
- Thay thế cấu trúc báo lỗi tùy tiện (
{"err": "Lỗi", "code": 12}) bằng định dạng chuẩn của IETF RFC 9457 vớiContent-Type: application/problem+json:type: Đường dẫn URI chỉ tới tài liệu hướng dẫn chi tiết về loại lỗi này.title: Tóm tắt ngắn gọn, dễ hiểu về lỗi (không thay đổi giữa các lần xuất hiện).status: Mã HTTP Status Code tương ứng (trùng với HTTP header).detail: Giải thích nguyên nhân cụ thể dẫn đến lỗi cho request hiện tại.instance: URI của request cụ thể đã phát sinh lỗi (hỗ trợ điều tra log).invalid_params: Trường mở rộng mô tả danh sách các thuộc tính không hợp lệ.
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: Mô Phỏng Động Cơ Keyset Pagination và RFC 9457 Problem Details Builder
cpp
#include <iostream>
#include <string>
#include <vector>
#include <memory>
#include <format>
#include <optional>
#include <algorithm>
#include <cstdint>
// ============================================================================
// 1. DOMAIN DATA CONTRACT & REPOSITORY
// ============================================================================
struct OrderItemRecord {
uint64_t id;
std::string customerName;
double amountUSD;
};
// ============================================================================
// 2. RFC 9457 PROBLEM DETAILS STANDARD BUILDER
// ============================================================================
struct InvalidFieldParam {
std::string fieldName;
std::string violationReason;
};
class ProblemDetailsException : public std::exception {
private:
std::string typeUri_;
std::string title_;
int statusHttp_;
std::string detail_;
std::string instanceUri_;
std::vector<InvalidFieldParam> invalidParams_;
public:
ProblemDetailsException(std::string type, std::string title, int status,
std::string detail, std::string instance,
std::vector<InvalidFieldParam> params = {})
: typeUri_(std::move(type)), title_(std::move(title)), statusHttp_(status),
detail_(std::move(detail)), instanceUri_(std::move(instance)),
invalidParams_(std::move(params)) {}
[[nodiscard]] std::string serializeJson() const {
std::string json = "{\n";
json += std::format(" \"type\": \"{}\",\n", typeUri_);
json += std::format(" \"title\": \"{}\",\n", title_);
json += std::format(" \"status\": {},\n", statusHttp_);
json += std::format(" \"detail\": \"{}\",\n", detail_);
json += std::format(" \"instance\": \"{}\"", instanceUri_);
if (!invalidParams_.empty()) {
json += ",\n \"invalid_params\": [\n";
for (size_t i = 0; i < invalidParams_.size(); ++i) {
json += std::format(" {{\"name\": \"{}\", \"reason\": \"{}\"}}",
invalidParams_[i].fieldName, invalidParams_[i].violationReason);
if (i + 1 < invalidParams_.size()) json += ",";
json += "\n";
}
json += " ]\n";
} else {
json += "\n";
}
json += "}";
return json;
}
};
// ============================================================================
// 3. CURSOR-BASED (KEYSET) PAGINATION ENGINE
// ============================================================================
struct PageResult {
std::vector<OrderItemRecord> items;
std::optional<uint64_t> nextCursor;
bool hasMore;
};
class OrderRestService {
private:
std::vector<OrderItemRecord> databaseTable_;
public:
OrderRestService() {
// Khởi tạo 100 bản ghi giả lập trong cơ sở dữ liệu
for (uint64_t i = 1; i <= 50; ++i) {
databaseTable_.push_back({i, std::format("Khach_Hang_{:03d}", i), 50.0 + (i * 2.5)});
}
}
// Hiện thực Keyset Pagination: WHERE id > cursor LIMIT limit
PageResult listOrders(std::optional<uint64_t> cursor, size_t limit, const std::string& requestUri) {
if (limit == 0 || limit > 100) {
throw ProblemDetailsException(
"https://api.enterprise.com/errors/invalid-pagination-limit",
"Pagination limit parameter out of acceptable bounds.",
400,
"Tham số 'limit' phải nằm trong khoảng từ 1 đến 100 bản ghi.",
requestUri,
{{"limit", "Giá trị truyền vào không hợp lệ (nhỏ hơn 1 hoặc lớn hơn 100)"}}
);
}
uint64_t startId = cursor.value_or(0);
std::vector<OrderItemRecord> results;
// Giả lập phép quét Index Seek B-Tree: WHERE id > startId LIMIT limit + 1
for (const auto& row : databaseTable_) {
if (row.id > startId) {
results.push_back(row);
if (results.size() == limit + 1) {
break;
}
}
}
bool hasMore = results.size() > limit;
if (hasMore) {
results.pop_back(); // Bỏ phần tử thứ limit + 1
}
std::optional<uint64_t> nextCursor = std::nullopt;
if (hasMore && !results.empty()) {
nextCursor = results.back().id;
}
return PageResult{std::move(results), nextCursor, hasMore};
}
};
int main() {
std::cout << "=========================================================\n";
std::cout << " DEMO REST API: KEYSET PAGINATION & RFC 9457 ERRORS \n";
std::cout << "=========================================================\n\n";
OrderRestService service;
// Kịch bản 1: Truy vấn trang đầu tiên (Cursor = null, Limit = 3)
std::cout << "--- 1. TRUY VẤN TRANG ĐẦU TIÊN (GET /v1/orders?limit=3) ---\n";
PageResult page1 = service.listOrders(std::nullopt, 3, "/v1/orders?limit=3");
for (const auto& item : page1.items) {
std::cout << std::format(" [Row ID: {:02d}] Customer: {} | Amount: ${:.2f}\n",
item.id, item.customerName, item.amountUSD);
}
std::cout << std::format("Next Cursor Token: {}\n\n", page1.nextCursor.value_or(0));
// Kịch bản 2: Truy vấn trang kế tiếp dựa trên Next Cursor vừa nhận
std::cout << std::format("--- 2. TRUY VẤN TRANG 2 DỰA TRÊN CURSOR (GET /v1/orders?cursor={}&limit=3) ---\n",
page1.nextCursor.value());
PageResult page2 = service.listOrders(page1.nextCursor, 3, "/v1/orders?cursor=3&limit=3");
for (const auto& item : page2.items) {
std::cout << std::format(" [Row ID: {:02d}] Customer: {} | Amount: ${:.2f}\n",
item.id, item.customerName, item.amountUSD);
}
std::cout << std::format("Next Cursor Token: {}\n\n", page2.nextCursor.value_or(0));
// Kịch bản 3: Client truyền tham số limit = 500 (Gây lỗi và kích hoạt RFC 9457)
std::cout << "--- 3. CLIENT GỬI LIMIT = 500 (BẮT LỖI VÀ XUẤT RFC 9457 PROBLEM DETAILS) ---\n";
try {
service.listOrders(std::nullopt, 500, "/v1/orders?limit=500");
} catch (const ProblemDetailsException& pde) {
std::cout << "HTTP/1.1 400 Bad Request\n";
std::cout << "Content-Type: application/problem+json\n\n";
std::cout << pde.serializeJson() << "\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
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
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
3.2. Phiên bản Python 3.11+: Bộ Điều Phối REST HATEOAS và Phân Trang Cursor Base64
python
from __future__ import annotations
import base64
import json
from dataclasses import dataclass, field
from typing import Dict, List, Optional, Any
@dataclass
class Product:
id: int
name: str
price_usd: float
category: str
class RestProductCatalogService:
def __init__(self):
# 30 sản phẩm mẫu trong kho
self._db: List[Product] = [
Product(i, f"Pro-Item-{i:03d}", round(10.0 + (i * 3.5), 2), "Electronics")
for i in range(1, 31)
]
@staticmethod
def encode_cursor(last_id: int) -> str:
raw_json = json.dumps({"last_id": last_id})
return base64.urlsafe_b64encode(raw_json.encode("utf-8")).decode("utf-8")
@staticmethod
def decode_cursor(cursor_str: str) -> int:
try:
raw_bytes = base64.urlsafe_b64decode(cursor_str.encode("utf-8"))
data = json.loads(raw_bytes.decode("utf-8"))
return int(data["last_id"])
except Exception:
raise ValueError("Con trỏ cursor bị hỏng hoặc không đúng định dạng Base64.")
def get_paginated_products(self, cursor: Optional[str], limit: int = 4) -> Dict[str, Any]:
start_id = self.decode_cursor(cursor) if cursor else 0
# Keyset seek: Lọc các bản ghi có ID lớn hơn start_id
matched = [p for p in self._db if p.id > start_id]
page_items = matched[:limit]
has_more = len(matched) > limit
next_cursor = self.encode_cursor(page_items[-1].id) if has_more and page_items else None
# Xây dựng phản hồi chuẩn HATEOAS (Richardson Level 3)
response: Dict[str, Any] = {
"data": [
{
"id": p.id,
"name": p.name,
"price": p.price_usd,
"category": p.category,
"_links": {
"self": {"href": f"/v1/products/{p.id}", "method": "GET"},
"update": {"href": f"/v1/products/{p.id}", "method": "PATCH"},
"delete": {"href": f"/v1/products/{p.id}", "method": "DELETE"}
}
}
for p in page_items
],
"pagination": {
"limit": limit,
"has_more": has_more,
"next_cursor": next_cursor
},
"_links": {
"self": {"href": f"/v1/products?limit={limit}" + (f"&cursor={cursor}" if cursor else "")}
}
}
if next_cursor:
response["_links"]["next"] = {
"href": f"/v1/products?limit={limit}&cursor={next_cursor}",
"method": "GET"
}
return response
if __name__ == "__main__":
print("=" * 65)
print(" REST API DEMO: HATEOAS LEVEL 3 & BASE64 CURSOR PAGINATION")
print("=" * 65)
api = RestProductCatalogService()
# Trang 1
print("\n--- 1. LẤY TRANG ĐẦU TIÊN (GET /v1/products?limit=2) ---")
page1 = api.get_paginated_products(cursor=None, limit=2)
print(json.dumps(page1, indent=2, ensure_ascii=False))
# Trang 2 dùng next_cursor từ trang 1
token = page1["pagination"]["next_cursor"]
print(f"\n--- 2. LẤY TRANG THỨ HAI VỚI CURSOR TOKEN: '{token}' ---")
page2 = api.get_paginated_products(cursor=token, limit=2)
print(f"Nhận được {len(page2['data'])} sản phẩm tiếp theo:")
for item in page2["data"]:
print(f" -> ID: {item['id']} | Tên: {item['name']} | Giá: ${item['price']}")
print(f"Next Link HATEOAS: {page2['_links'].get('next', {}).get('href')}")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
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
3.3. Giả Lập Terminal Output Thực Tế
text
=========================================================
DEMO REST API: KEYSET PAGINATION & RFC 9457 ERRORS
=========================================================
--- 1. TRUY VẤN TRANG ĐẦU TIÊN (GET /v1/orders?limit=3) ---
[Row ID: 01] Customer: Khach_Hang_001 | Amount: $52.50
[Row ID: 02] Customer: Khach_Hang_002 | Amount: $55.00
[Row ID: 03] Customer: Khach_Hang_003 | Amount: $57.50
Next Cursor Token: 3
--- 2. TRUY VẤN TRANG 2 DỰA TRÊN CURSOR (GET /v1/orders?cursor=3&limit=3) ---
[Row ID: 04] Customer: Khach_Hang_004 | Amount: $60.00
[Row ID: 05] Customer: Khach_Hang_005 | Amount: $62.50
[Row ID: 06] Customer: Khach_Hang_006 | Amount: $65.00
Next Cursor Token: 6
--- 3. CLIENT GỬI LIMIT = 500 (BẮT LỖI VÀ XUẤT RFC 9457 PROBLEM DETAILS) ---
HTTP/1.1 400 Bad Request
Content-Type: application/problem+json
{
"type": "https://api.enterprise.com/errors/invalid-pagination-limit",
"title": "Pagination limit parameter out of acceptable bounds.",
"status": 400,
"detail": "Tham số 'limit' phải nằm trong khoảng từ 1 đến 100 bản ghi.",
"instance": "/v1/orders?limit=500",
"invalid_params": [
{"name": "limit", "reason": "Giá trị truyền vào không hợp lệ (nhỏ hơn 1 hoặc lớn hơn 100)"}
]
}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
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
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 "HTTP 200 OK Nhưng Thất Bại" (The Pseudo-200 Anti-Pattern):
- Bản chất: API luôn trả về mã trạng thái
200 OK, nhưng trong body lại chứa{ "status": "ERROR", "message": "Null Pointer Crash" }. - Hậu quả tai hại: Toàn bộ hạ tầng mạng trung gian bị đánh lừa: Proxy Cache lưu lại kết quả lỗi; API Gateway tính tỷ lệ lỗi
dù dịch vụ đang sập; các hệ thống giám sát SLO/SLA (như Prometheus, Datadog) không thể phát hiện sự cố tự động. - Quy chuẩn: Luôn phản ánh đúng bản chất sự cố bằng dải mã
4xxhoặc5xx.
- Bản chất: API luôn trả về mã trạng thái
Cú Sốc Hiệu Năng Phân Trang Deep Offset (Deep Offset Performance Cliff):
- Bản chất: Lập trình viên phơi bày giao diện phân trang
?page=50000. Khi bot cào dữ liệu lật tới trang thứ 50,000, database phải đọc 1,000,000 dòng khiến thời gian phản hồi tăng từ 10ms lên 45 giây, gây cạn kiệt Connection Pool và làm sập Database chính. - Giải pháp: Đối với Public API hoặc dữ liệu lớn, bắt buộc chặn cứng
max_offset = 1000hoặc chuyển đổi toàn bộ sang Cursor-based Pagination.
- Bản chất: Lập trình viên phơi bày giao diện phân trang
Rò Rỉ Thông Tin Nguy Hiểm Qua Báo Lỗi (Information Disclosure via Stack Traces):
- Bản chất: Khi có Exception, server trả về nguyên văn vết ngăn xếp Java/Python/Node.js chứa tên bảng database, câu lệnh SQL nội bộ, đường dẫn file trên máy chủ. Kẻ tấn công lợi dụng thông tin này để khai thác SQL Injection.
- Giải pháp: Ở môi trường Production, bắt buộc lọc sạch thông điệp lỗi qua Middleware, chỉ trả về mã lỗi chuẩn RFC 9457 và lưu vết chi tiết trong hệ thống giám sát nội bộ (ELK / CloudWatch) kèm theo
correlation_id.
Kỹ Thuật Chẩn Đoán & Giám Sát Production Bằng CLI:
bash# 1. Kiểm tra mã trạng thái HTTP trả về từ API bằng cURL (Xem cả Response Headers) curl -i -X POST https://api.enterprise.com/v1/orders \ -H "Content-Type: application/json" \ -d '{"items": []}' # 2. Benchmark độ trễ phân trang Keyset vs Offset bằng Apache Benchmark ab -n 1000 -c 20 "https://api.enterprise.com/v1/orders?cursor=eyJpZCI6MTAwMH0=&limit=50" # 3. Quét log tìm các request trả về mã lỗi 4xx/5xx trong Nginx Access Log awk '($9 >= 400) {print $7, $9}' /var/log/nginx/access.log | sort | uniq -c | sort -nr | head -n 201
2
3
4
5
6
7
8
9
10
5. Bảng So sánh & Decision Matrix
5.1. So Sánh Hai Chiến Lược Phân Trang (Pagination Strategies)
| Tiêu Chí Kỹ Thuật | Phân Trang Dựa Trên Offset (Page/Offset) | Phân Trang Dựa Trên Con Trỏ (Cursor/Keyset) |
|---|---|---|
| Cú pháp URL điển hình | ?page=5&limit=20 hoặc ?offset=80&limit=20 | ?cursor=eyJpZCI6ODF9&limit=20 |
| Độ phức tạp SQL | ||
| Hiện tượng trôi dữ liệu | Có (Dễ đọc trùng hoặc sót khi có dữ liệu mới) | Không bao giờ bị trôi |
| Nhảy tới trang bất kỳ | Rất dễ dàng (Jump to Page 10) | Không hỗ trợ (Chỉ đi tới/lui từng bước) |
| Trường hợp tối ưu | Trang quản trị Admin nhỏ, dữ liệu tĩnh ít đổi | Feed mạng xã hội, Mobile Infinite Scroll, Big Data |
5.2. Ma Trận Quyết Định Lựa Chọn HTTP Methods và Mã Phản Hồi
| Hành Động Nghiệp Vụ Cần Thực Hiện | Động Từ Chuẩn | HTTP Status Thành Công | Mã Lỗi Điển Hình |
|---|---|---|---|
| Đọc danh sách hoặc chi tiết bản ghi | GET | 200 OK (kèm body) | 404 Not Found |
| Tạo mới một tài nguyên (Đơn hàng, Khách hàng) | POST | 201 Created (Location header) | 400 Bad Request, 422 Unprocessable |
| Thay thế toàn bộ thông tin tài nguyên | PUT | 200 OK hoặc 204 No Content | 404 Not Found, 409 Conflict |
| Chỉ cập nhật 1 trường (ví dụ: đổi trạng thái) | PATCH | 200 OK | 422 Unprocessable |
| Hủy bỏ / Xóa một tài nguyên | DELETE | 204 No Content | 404 Not Found |
| Gửi tác vụ nặng chạy ngầm (Export CSV 1 triệu dòng) | POST | 202 Accepted | 429 Too Many Requests |
IyA2LjIuIFRoaeG6v3QgS+G6vyBDaHXhuqluIE3hu7FjIFJFU1RmdWwgQVBJIChSRVNUIEFQSSBEZXNpZ24gJiBCZXN0IFByYWN0aWNlcykNCg0KPiBbIUlNUE9SVEFOVF0NCj4gKipO4bq/dSBi4bqhbiBjaOG7iSDEkcaw4bujYyBuaOG7myBt4buZdCDEkWnhu4F1IGR1eSBuaOG6pXQ6KiogVGhp4bq/dCBr4bq/IFJFU1RmdWwgQVBJIGNodeG6qW4gbeG7sWMga2jDtG5nIHBo4bqjaSBsw6AgbmjDqXQgSlNPTiB2w6BvIFVSTCBi4bqldCBr4buzLCBtw6AgbMOgICoqbcO0IGjDrG5oIGjDs2EgdMOgaSBuZ3V5w6puIChSZXNvdXJjZSBNb2RlbGluZykgdsOgIHTDtG4gdHLhu41uZyB0dXnhu4d0IMSR4buRaSBuZ+G7ryBuZ2jEqWEgZ2lhbyB0aOG7qWMgSFRUUCoqIChSRkMgOTExMCkg4oCUIGTDuW5nIGRhbmggdOG7qyBz4buRIG5oaeG7gXUgY2hvIFVSSSwgcGjDom4gYmnhu4d0IHLhuqFjaCByw7JpIHTDrW5oIFNhZmUvSWRlbXBvdGVudCBj4bunYSBjw6FjIMSR4buZbmcgdOG7qywgdGhheSB0aOG6vyBwaMOibiB0cmFuZyBPZmZzZXQgYuG6sW5nIEN1cnNvciBQYWdpbmF0aW9uIOG7nyBxdXkgbcO0IGzhu5tuIHbDoCBjaHXhuqluIGjDs2EgY+G6pXUgdHLDumMgbOG7l2kgdGhlbyBSRkMgOTQ1Ny4NCg0KLS0tDQoNCiMjIDEuIEtp4bq/biB0csO6YyBU4buVbmcgcXVhbiAmIE3DtCBow6xuaCBUxrAgZHV5IChNZW50YWwgTW9kZWwpDQoNCiMjIyDhuqhuIGThu6UgxJDhu51pIHPhu5FuZzogVGjGsCBWaeG7h24gUXXhu5FjIEdpYSB2w6AgSOG7hyBUaOG7kW5nIFRyYSBD4bupdSBUaOG6uyBN4bulYyBM4bulYw0KSMOjeSBow6xuaCBkdW5nIHRoaeG6v3Qga+G6vyBt4buZdCBo4buHIHRo4buRbmcgUkVTVGZ1bCBBUEkgY2h14bqpbiBt4buxYyB0xrDGoW5nIHThu7EgbmjGsCBjw6FjaCB04buVIGNo4bupYyB2w6AgduG6rW4gaMOgbmggbeG7mXQgVGjGsCB2aeG7h24gUXXhu5FjIGdpYSBxdXkgbcO0IHRyaeG7h3UgxJHhuqd1IHPDoWNoOg0KLSAqKlTDoGkgbmd1ecOqbiAmIERhbmggdOG7qyBz4buRIG5oaeG7gXUgKGAvYm9va3NgLCBgL2F1dGhvcnNgKSoqOiBN4buXaSBjdeG7kW4gc8OhY2gsIHTDoWMgZ2nhuqMgaGF5IHRo4bq7IG3GsOG7o24gbMOgIG3hu5l0ICJUw6BpIG5ndXnDqm4iIGPDsyBtw6MgxJHhu4tuaCBkYW5oIGLhuqV0IGJp4bq/bi4gS2jDoWNoIGtow7RuZyBiYW8gZ2nhu50gbsOzaTogKiJDaG8gdMO0aSBow6BuaCDEkeG7mW5nIGzhuqV5IHPDoWNoIHPhu5EgMTAiKiAoYC9nZXRCb29rP2lkPTEwYCAtIExldmVsIDAvUlBDKSwgbcOgIG7Ds2k6ICoiVMO0aSBtdeG7kW4geGVtIHRow7RuZyB0aW4gdOG6oWkgbmfEg24gc8OhY2ggc+G7kSAxMCIqIChgR0VUIC9ib29rcy8xMGAgLSBMZXZlbCAyL1JFU1QpLg0KLSAqKlF1YW4gaOG7hyB0aOG7qSBi4bqtYyBs4buTbmcgZ2jDqXAgKGAvYXV0aG9ycy83L2Jvb2tzYCkqKjogxJDhu4MgdMOsbSBjw6FjIGN14buRbiBzw6FjaCBj4bunYSB0w6FjIGdp4bqjIHPhu5EgNywgdGjhu6cgdGjGsCBt4bufIG5nxINuIGvDqW8gY+G7p2EgdMOhYyBnaeG6oyDEkcOzIHbDoCB4ZW0gZGFuaCBt4bulYyBzw6FjaCBiw6puIHRyb25nLg0KLSAqKlJpY2hhcmRzb24gTWF0dXJpdHkgTW9kZWwgKEPDoWMgY+G6pXAgYuG6rWMgaGnhu4duIMSR4bqhaSBow7NhIHRoxrAgdmnhu4duKSoqOg0KICAtICpMZXZlbCAwIChIw7JtIHRoxrAgZHV5IG5o4bqldCkqOiBN4buNaSB5w6p1IGPhuqd1IG3GsOG7o24sIHRy4bqjLCB0w6xtIHPDoWNoIMSR4buBdSBuaMOpdCBjaHVuZyB2w6BvIG3hu5l0IGjDsm0gdGjGsCBnaeG6pXkgZHV5IG5o4bqldCAoYFBPU1QgL2xpYnJhcnlFbmRwb2ludGApLg0KICAtICpMZXZlbCAxIChDaGlhIHThu6tuZyBxdeG6p3kgcmnDqm5nIGJp4buHdCkqOiBDw7MgcXXhuqd5IFPDoWNoLCBxdeG6p3kgVMOhYyBnaeG6oywgcXXhuqd5IFRo4bq7IG3GsOG7o24gcmnDqm5nIChgL2Jvb2tzYCwgYC9hdXRob3JzYCksIG5oxrBuZyBt4buNaSB2aeG7h2Mg4bufIG3hu41pIHF14bqneSDEkeG7gXUgeOG7rSBsw70gcXVhIG3hu5l0IGxv4bqhaSBnaeG6pXkgYmnDqm4gbmjhuq1uIGNodW5nIChgUE9TVGApLg0KICAtICpMZXZlbCAyIChDaHXhuqluIGjDs2EgaMOgbmggxJHhu5luZyAmIEJpw6puIGxhaSkqOiDEkOG7jWMgc8OhY2ggZMO5bmcgbeG6r3QgeGVtIChgR0VUYCAtIFNhZmUpLCDEkcSDbmcga8O9IHRo4bq7IG3hu5tpIMSRaeG7gW4gxJHGoW4gKGBQT1NUYCAtIE5vbi1pZGVtcG90ZW50KSwgxJHhu5VpIHRvw6BuIGLhu5kgdGjDtG5nIHRpbiB0aOG6uyAoYFBVVGAgLSBJZGVtcG90ZW50KSwgeMOpIGLhu48gdGjhursgKGBERUxFVEVgIC0gSWRlbXBvdGVudCkuIFRy4bqjIGJpw6puIGxhaSBjaHXhuqluIG3DoHUgeGFuaCBgMjAwLzIwMWAga2hpIHRow6BuaCBjw7RuZywgbcOgdSDEkeG7jyBgNDAwLzQwNGAga2hpIGzhu5dpLg0KICAtICpMZXZlbCAzOiBIQVRFT0FTIChU4bqlbSBi4bqjbiDEkeG7kyBjaOG7iSDEkcaw4budbmcgdGjDtG5nIG1pbmggxJHDrW5oIGvDqG0pKjogS2hpIHRo4bunIHRoxrAgdHLhuqMgc8OhY2ggY2hvIGLhuqFuLCB0csOqbiBwaGnhur91IG3GsOG7o24gaW4gc+G6tW4gY8OhYyBsacOqbiBr4bq/dDogKiJC4bqlbSB2w6BvIMSRw6J5IMSR4buDIGdpYSBo4bqhbiIqIChgcmVsOiBleHRlbmRgKSwgKiJC4bqlbSB2w6BvIMSRw6J5IMSR4buDIHRoYW5oIHRvw6FuIHRp4buBbiBwaOG6oXQiKiAoYHJlbDogcGF5YCkuIELhuqFuIGtow7RuZyBj4bqnbiBuaOG7myBxdXkgdHLDrG5oIHRp4bq/cCB0aGVvLCBjaMOtbmggdMOgaSBuZ3V5w6puIHPhur0gaMaw4bubbmcgZOG6q24gYuG6oW4uDQotICoqT2Zmc2V0IHZzIEN1cnNvciBQYWdpbmF0aW9uICjEkOG6v20gdOG7q25nIHRyYW5nIHPDoWNoIHZzIEThuqNpIHJ1eSBixINuZyDEkcOhbmggZOG6pXUgdHJhbmcpKio6DQogIC0gKk9mZnNldCBQYWdpbmF0aW9uKjogVGjhu6cgdGjGsCBi4bqvdCBi4bqhbiBs4bqtdCB04burIHRyYW5nIDEgxJHhur9uIHRyYW5nIDEwMCwwMDAgxJHhu4MgxJHhu41jIHRp4bq/cCB0cmFuZyAxMDAsMDAxICgkTyhOKSQgc2NhbiBraeG7h3Qgc+G7qWMpLiBO4bq/dSBhaSDEkcOzIHjDqSBt4bqldCAxIHRyYW5nIOG7nyBnaeG7r2EsIHRvw6BuIGLhu5kgc+G7kSB0cmFuZyBi4buLIGzhu4djaCB2w6AgYuG6oW4gxJHhu41jIHRyw7luZyBu4buZaSBkdW5nLg0KICAtICpDdXJzb3IgUGFnaW5hdGlvbio6IELhuqFuIGvhurlwIG3hu5l0IGThuqNpIHJ1eSBixINuZyBnaGkgSUQgY3Xhu5FuIHPDoWNoIGN14buRaSBjw7luZyAoYGN1cnNvciA9IGJvb2tfaWRfOTk4OGApLiBM4bqnbiBzYXUgY2jhu4kgY+G6p24gbeG7nyBuZ2F5IHNhdSBk4bqjaSBydXkgYsSDbmcgcXVhIEluZGV4IEItVHJlZSAoJE8oXGxvZyBOKSQpLg0KLSAqKlJGQyA5NDU3IFByb2JsZW0gRGV0YWlscyAoUGhp4bq/dSBiw6FvIGzhu5dpIHRpw6p1IGNodeG6qW4geSB04bq/L3Bow6FwIGzDvSkqKjogS2jDtG5nIHRy4bqjIHbhu4EgdGjDtG5nIGLDoW8gbOG7l2kgY2h1bmcgY2h1bmcga2nhu4N1IGAiTOG7l2kgcuG7k2khImAsIG3DoCBjw7MgbeG6q3UgaW4gY2h14bqpbiBxdeG7kWMgdOG6vzogbG/huqFpIGzhu5dpIGfDrCwgdGnDqnUgxJHhu4EsIG3DoyBz4buRLCBsw70gZG8gY2hpIHRp4bq/dCB2w6AgxJHGsOG7nW5nIGThuqtuIHJlcXVlc3QgY+G7pSB0aOG7gy4NCg0KYGBgbWVybWFpZA0KZmxvd2NoYXJ0IFREDQogICAgc3ViZ3JhcGggUmVzb3VyY2VTcGFjZVsiTcO0IEjDrG5oIEjDs2EgVMOgaSBOZ3V5w6puIChSZXNvdXJjZSBNb2RlbGluZykiXQ0KICAgICAgICBDb2xsZWN0aW9uWyJU4bqtcCBI4bujcCBEYW5oIFThu6sgU+G7kSBOaGnhu4F1OiAvdjEvb3JkZXJzIl0NCiAgICAgICAgSXRlbVsiVGjhu7FjIFRo4buDIENvbiBD4bulIFRo4buDOiAvdjEvb3JkZXJzL3tvcmRlcklkfSJdDQogICAgICAgIFN1YkNvbGxlY3Rpb25bIk3hu5FpIFF1YW4gSOG7hyBQaMOibiBD4bqlcDogL3YxL29yZGVycy97b3JkZXJJZH0vaXRlbXMiXQ0KICAgIGVuZA0KDQogICAgc3ViZ3JhcGggSHR0cFNlbWFudGljc1siTmfhu68gTmdoxKlhIMSQ4buZbmcgVOG7qyAmIFLDoG5nIEJ14buZYyBBbiBUb8OgbiAoUkZDIDkxMTApIl0NCiAgICAgICAgR0VUWyJHRVQ6IFNhZmUgJiBJZGVtcG90ZW50IChDaOG7iSDEkeG7jWMsIENhY2hlYWJsZSkiXQ0KICAgICAgICBQT1NUWyJQT1NUOiBVbnNhZmUgJiBOb24tSWRlbXBvdGVudCAoVOG6oW8gbeG7m2kpIl0NCiAgICAgICAgUFVUWyJQVVQ6IFVuc2FmZSAmIElkZW1wb3RlbnQgKFRoYXkgdGjhur8gdG/DoG4gYuG7mSkiXQ0KICAgICAgICBQQVRDSFsiUEFUQ0g6IFVuc2FmZSAmIFBhcnRpYWwgVXBkYXRlIChT4butYSAxIHBo4bqnbikiXQ0KICAgICAgICBERUxFVEVbIkRFTEVURTogVW5zYWZlICYgSWRlbXBvdGVudCAoSOG7p3kgdMOgaSBuZ3V5w6puKSJdDQogICAgZW5kDQoNCiAgICBzdWJncmFwaCBNYXR1cml0eVsiQ+G6pXAgxJDhu5kgVHLGsOG7n25nIFRow6BuaCBSaWNoYXJkc29uIChNYXR1cml0eSBNb2RlbCkiXQ0KICAgICAgICBMMFsiTGV2ZWwgMDogVGhlIFN3YW1wIG9mIFBPWCAoUlBDLCBPbmUgRW5kcG9pbnQgUE9TVCkiXQ0KICAgICAgICBMMVsiTGV2ZWwgMTogU2VwYXJhdGUgUmVzb3VyY2VzIChOaGnhu4F1IFVSSXMpIl0NCiAgICAgICAgTDJbIkxldmVsIDI6IEhUVFAgVmVyYnMgJiBTdGF0dXMgQ29kZXMgKEdFVC9QT1NUL1BVVC9ERUxFVEUpIl0NCiAgICAgICAgTDNbIkxldmVsIDM6IEhBVEVPQVMgKEh5cGVybWVkaWEgQXMgVGhlIEVuZ2luZSBvZiBBcHAgU3RhdGUpIl0NCiAgICAgICAgTDAgLS0+IEwxIC0tPiBMMiAtLT4gTDMNCiAgICBlbmQNCg0KICAgIENvbGxlY3Rpb24gLS0+IEh0dHBTZW1hbnRpY3MNCiAgICBJdGVtIC0tPiBIdHRwU2VtYW50aWNzDQogICAgU3ViQ29sbGVjdGlvbiAtLT4gSHR0cFNlbWFudGljcw0KYGBgDQoNCi0tLQ0KDQojIyAyLiBDaGkgdGnhur90IHThu6tuZyBLZXl3b3JkIChVbmRlci10aGUtSG9vZCBEZWVwIERpdmUpDQoNCiMjIyAyLjEuIFJlc291cmNlIE1vZGVsaW5nLCBOYW1pbmcgJiBSaWNoYXJkc29uIE1hdHVyaXR5IE1vZGVsDQoNCiMjIyMgMS4gUXV5IENodeG6qW4gxJDhurd0IFTDqm4gVVJJICYgTcO0IEjDrG5oIEjDs2EgVMOgaSBOZ3V5w6puDQotICoqU+G7rSBk4bulbmcgRGFuaCB04burIHPhu5Egbmhp4buBdSAoUGx1cmFsIE5vdW5zKSoqOiDEkOG6oWkgZGnhu4duIGNobyBt4buZdCB04bqtcCBo4bujcCB0aOG7sWMgdGjhu4M6DQogIC0gQ2h14bqpbjogYC92MS91c2Vyc2AsIGAvdjEvcHJvZHVjdHNgLCBgL3YxL2ludm9pY2VzYC4NCiAgLSAqQ+G6pW0gdHV54buHdCDEkeG7kWkqOiBEw7luZyDEkeG7mW5nIHThu6sgdHJvbmcgVVJJIChuaMawIGAvdjEvZ2V0VXNlcnNgLCBgL3YxL2NyZWF0ZVByb2R1Y3RgLCBgL3YxL2RlbGV0ZUludm9pY2VgKS4gxJDhu5luZyB04burIHBo4bqjaSDEkcaw4bujYyBiaeG7g3UgxJHhuqF0IGLhurFuZyBjaMOtbmggY8OhYyBwaMawxqFuZyB0aOG7qWMgSFRUUC4NCi0gKipLw70gdOG7sSB2w6AgxJDhu4tuaCBk4bqhbmcgKEtlYmFiLWNhc2UpKio6DQogIC0gU+G7rSBk4bulbmcgY2jhu68gdmnhur90IHRoxrDhu51uZyB2w6AgZOG6pXUgZ+G6oWNoIG5nYW5nOiBgL3YxL3BheW1lbnQtbWV0aG9kc2AsIGAvdjEvY3VzdG9tZXItYWRkcmVzc2VzYC4NCiAgLSBLaMO0bmcgZMO5bmcgY2FtZWxDYXNlIChgL3BheW1lbnRNZXRob2RzYCkgaGF5IHNuYWtlX2Nhc2UgKGAvcGF5bWVudF9tZXRob2RzYCkgdHJvbmcgcGF0aCBVUkwuDQotICoqTcO0IGjDrG5oIGjDs2EgcXVhbiBo4buHIENoYSAtIENvbiAoU3ViLXJlc291cmNlcykqKjoNCiAgLSBDaOG7iSBuw6puIGzhu5NuZyB04buRaSDEkWEgMiBj4bqlcCDEkeG7gyB0csOhbmggVVJJIHF1w6EgZMOgaSB2w6AgcGjhu6ljIHThuqFwOg0KICAgIGAvdjEvdGVhbXMve3RlYW1JZH0vbWVtYmVycy97bWVtYmVySWR9YC4NCiAgLSBO4bq/dSBt4buRaSBxdWFuIGjhu4cgcGjhu6ljIHThuqFwIGjGoW4sIGjDo3kgbMOgbSBwaOG6s25nIChGbGF0dGVuaW5nKSB0w6BpIG5ndXnDqm46IFRoYXkgdsOsIGAvdjEvY29tcGFuaWVzL3tjSWR9L2RlcGFydG1lbnRzL3tkSWR9L3RlYW1zL3t0SWR9L2VtcGxveWVlc2AsIGjDo3kgZMO5bmcgYC92MS9lbXBsb3llZXM/dGVhbV9pZD17dElkfWAuDQoNCiMjIyMgMi4gUmljaGFyZHNvbiBNYXR1cml0eSBNb2RlbCAoTcO0IEjDrG5oIFRyxrDhu59uZyBUaMOgbmggUkVTVCkNCjEuICoqTGV2ZWwgMDogVGhlIFN3YW1wIG9mIFBPWCAoxJDhuqdtIGzhuqd5IFBsYWluIE9sZCBYTUwvSlNPTikqKjoNCiAgIC0gRMO5bmcgSFRUUCBjaOG7iSBuaMawIG3hu5l0IGdpYW8gdGjhu6ljIHRydXnhu4FuIHThuqNpIHThuqduZyBkxrDhu5tpIChUcmFuc3BvcnQgbWVjaGFuaXNtIGNobyBSUEMpLg0KICAgLSBDaOG7iSBjw7MgMSBlbmRwb2ludCBkdXkgbmjhuqV0ICh2w60gZOG7pTogYFBPU1QgL2FwaS9zZXJ2aWNlYCksIG3hu41pIGzhu4duaCBn4buNaSDEkcaw4bujYyBi4buNYyB0cm9uZyBib2R5OiBgeyJhY3Rpb24iOiAiY3JlYXRlT3JkZXIiLCAiZGF0YSI6IHsuLi59fWAuIEx1w7RuIHRy4bqjIHbhu4EgSFRUUCBzdGF0dXMgMjAwIGvDqG0gYm9keSBs4buXaSBu4bq/dSB0aOG6pXQgYuG6oWkuDQoyLiAqKkxldmVsIDE6IFJlc291cmNlcyAoVMOgaSBOZ3V5w6puIFJpw6puZyBCaeG7h3QpKio6DQogICAtIEjhu4cgdGjhu5FuZyBi4bqvdCDEkeG6p3UgcGjDom4gdMOhY2ggY8OhYyBVUklzIGtow6FjIG5oYXUgY2hvIHThu6tuZyDEkeG7kWkgdMaw4bujbmcgKGAvb3JkZXJzYCwgYC9jdXN0b21lcnNgKSwgbmjGsG5nIHbhuqtuIGNo4buJIGTDuW5nIG3hu5l0IHBoxrDGoW5nIHRo4bupYyBIVFRQIGR1eSBuaOG6pXQgKGjhuqd1IGjhur90IGzDoCBgUE9TVGApLg0KMy4gKipMZXZlbCAyOiBIVFRQIFZlcmJzICYgU3RhdHVzIENvZGVzIChDaHXhuqluIE5n4buvIE5naMSpYSBIVFRQKSoqOg0KICAgLSDDgXAgZOG7pW5nIMSR4bqneSDEkeG7pyB2w6AgY2jDrW5oIHjDoWMgY8OhYyDEkeG7mW5nIHThu6sgSFRUUCAoYEdFVGAgxJHhu4MgdHJ1eSB24bqlbiwgYFBPU1RgIMSR4buDIHThuqFvIG3hu5tpLCBgUFVUL1BBVENIYCDEkeG7gyBj4bqtcCBuaOG6rXQsIGBERUxFVEVgIMSR4buDIHjDs2EpLg0KICAgLSBUcuG6oyB24buBIG3DoyBIVFRQIFN0YXR1cyBDb2RlcyBjaHXhuqluIChgMjAxIENyZWF0ZWRgLCBgNDA0IE5vdCBGb3VuZGAsIGA0MDkgQ29uZmxpY3RgLCBgNDIyIFVucHJvY2Vzc2FibGVgKS4NCiAgIC0gKkjGoW4gOTUlIEFQSSB0cm9uZyBjw6FjIHThuq1wIMSRb8OgbiBjw7RuZyBuZ2jhu4cgaGnhu4duIG5heSB24bqtbiBow6BuaCDhu58gTGV2ZWwgMiouDQo0LiAqKkxldmVsIDM6IEh5cGVybWVkaWEgQ29udHJvbHMgKEhBVEVPQVMpKio6DQogICAtIEh5cGVybWVkaWEgQXMgVGhlIEVuZ2luZSBPZiBBcHBsaWNhdGlvbiBTdGF0ZTogU2VydmVyIHRy4bqjIHbhu4EgZOG7ryBsaeG7h3Uga8OobSB0aGVvIGPDoWMgc2nDqnUgbGnDqm4ga+G6v3QgKGBfbGlua3NgIGhv4bq3YyBKU09OOkFQSSBmb3JtYXQpIG3DtCB04bqjIGPDoWMgaMOgbmggxJHhu5luZyB0aeG6v3AgdGhlbyBtw6AgQ2xpZW50IGPDsyBxdXnhu4FuIHRo4buxYyBoaeG7h24gZOG7sWEgdHLDqm4gdHLhuqFuZyB0aMOhaSBoaeG7h24gdOG6oWkgY+G7p2EgdMOgaSBuZ3V5w6puLiBDbGllbnQga2jDtG5nIGPhuqduIGhhcmRjb2RlIFVSTCBj4bunYSBjw6FjIGLGsOG7m2Mga+G6vyB0aeG6v3AuDQoNCmBgYGpzb24NCnsNCiAgIm9yZGVySWQiOiAiT1JELTk5ODg3NyIsDQogICJzdGF0dXMiOiAiQVdBSVRJTkdfUEFZTUVOVCIsDQogICJ0b3RhbEFtb3VudFVTRCI6IDE0OS45OSwNCiAgIl9saW5rcyI6IHsNCiAgICAic2VsZiI6IHsgImhyZWYiOiAiL3YxL29yZGVycy9PUkQtOTk4ODc3IiwgIm1ldGhvZCI6ICJHRVQiIH0sDQogICAgInBheW1lbnQiOiB7ICJocmVmIjogIi92MS9vcmRlcnMvT1JELTk5ODg3Ny9wYXltZW50cyIsICJtZXRob2QiOiAiUE9TVCIgfSwNCiAgICAiY2FuY2VsIjogeyAiaHJlZiI6ICIvdjEvb3JkZXJzL09SRC05OTg4NzcvY2FuY2VsIiwgIm1ldGhvZCI6ICJQT1NUIiB9DQogIH0NCn0NCmBgYA0KDQotLS0NCg0KIyMjIDIuMi4gSFRUUCBNZXRob2RzIFNlbWFudGljczogU2FmZSB2cyBJZGVtcG90ZW50ICYgU3RhdHVzIENvZGVzDQoNCiMjIyMgMS4gQuG6o24gQ2jhuqV0IEvhu7kgVGh14bqtdDogU2FmZSBNZXRob2RzIHZzIElkZW1wb3RlbnQgTWV0aG9kcw0KLSAqKlNhZmUgTWV0aG9kcyAoUGjGsMahbmcgdGjhu6ljIEFuIHRvw6BuIC0gUkZDIDkxMTApKio6DQogIC0gQ8OhYyBwaMawxqFuZyB0aOG7qWMgxJHGsOG7o2MgxJHhu4tuaCBuZ2jEqWEgbMOgICoqY2jhu4kgxJHhu41jIChSZWFkLW9ubHkpKiosIHZp4buHYyB0aOG7sWMgdGhpIGNow7puZyBraMO0bmcgxJHGsOG7o2MgZ8OieSByYSBi4bqldCBr4buzIHTDoWMgZOG7pW5nIHBo4bulIChzaWRlLWVmZmVjdHMpIGzDoG0gdGhheSDEkeG7lWkgdHLhuqFuZyB0aMOhaSBk4buvIGxp4buHdSB0csOqbiBtw6F5IGNo4bunLg0KICAtIEPDoWMgcGjGsMahbmcgdGjhu6ljIGFuIHRvw6BuOiBgR0VUYCwgYEhFQURgLCBgT1BUSU9OU2AsIGBUUkFDRWAuDQogIC0gQ8OhYyB0csOsbmggZHV54buHdCB3ZWIsIHByb3h5IHbDoCBjcmF3bGVyIChuaMawIEdvb2dsZWJvdCkgZ2nhuqMgxJHhu4tuaCBt4buNaSBs4budaSBn4buNaSBgR0VUYCDEkeG7gXUgYW4gdG/DoG4gdsOgIGPDsyB0aOG7gyB04buxIMO9IGvDrWNoIGhv4bqhdCBs4bqhaSBob+G6t2MgdOG6o2kgdHLGsOG7m2MgKFByZWZldGNoaW5nKSBtw6Aga2jDtG5nIGfDonkgbmd1eSBoaeG7g20uDQotICoqSWRlbXBvdGVudCBNZXRob2RzIChQaMawxqFuZyB0aOG7qWMgQuG6pXQgYmnhur9uIHTDoWMgZOG7pW5nKSoqOg0KICAtIE3hu5l0IHBoxrDGoW5nIHRo4bupYyBsw6AgSWRlbXBvdGVudCBu4bq/dSBn4buNaSAkTiQgbOG6p24gbGnDqm4gdGnhur9wICgkTiBcZ2UgMSQpIHbhu5tpIGPDuW5nIHRoYW0gc+G7kSDEkeG7gXUgZOG6q24gdOG7m2kgdHLhuqFuZyB0aMOhaSBk4buvIGxp4buHdSB0csOqbiBtw6F5IGNo4bunIGhvw6BuIHRvw6BuIMSR4buTbmcgbmjhuqV0IG5oxrAgbmhhdS4NCiAgLSBgUFVUYDogVGhheSB0aOG6vyB0b8OgbiBi4buZIGLhuqNuIGdoaS4gR+G7jWkgMTAgbOG6p24gduG6q24gbMOgIHRoYXkgdGjhur8gYuG6o24gZ2hpIMSRw7MgYuG6sW5nIGThu68gbGnhu4d1IMSRw7MgJFx0byQgKipJZGVtcG90ZW50KiouDQogIC0gYERFTEVURWA6IFjDs2EgYuG6o24gZ2hpLiBM4bqnbiAxIHjDs2EgdGjDoG5oIGPDtG5nICgyMDQvMjAwKSwgbOG6p24gMiBiw6FvIGtow7RuZyB0w6xtIHRo4bqleSAoNDA0KSwgbmjGsG5nIHRy4bqhbmcgdGjDoWkgbcOheSBjaOG7pyBzYXUgbOG6p24gMSB2w6AgbOG6p24gMTAgbMOgIG5oxrAgbmhhdSAoYuG6o24gZ2hpIGtow7RuZyBjw7JuIHThu5NuIHThuqFpKSAkXHRvJCAqKklkZW1wb3RlbnQqKi4NCiAgLSBgUE9TVGA6IFThuqFvIG3hu5tpIGLhuqNuIGdoaS4gR+G7jWkgMTAgbOG6p24gc2luaCByYSAxMCBi4bqjbiBnaGkga2jDoWMgbmhhdSAkXHRvJCAqKk5vbi1JZGVtcG90ZW50KiouDQogIC0gYFBBVENIYDogVuG7gSBsw70gdGh1eeG6v3QgUkZDIGzDoCBOb24tSWRlbXBvdGVudCAobuG6v3UgZMO5bmcgdGhhbyB0w6FjIGPhu5luZyBk4buTbiBgeyJvcCI6ICJpbmNyZW1lbnQiLCAidmFsdWUiOiA1fWApLCBuaMawbmcgdHJvbmcgdGjhu7FjIHThur8gdGjGsOG7nW5nIMSRxrDhu6NjIHRoaeG6v3Qga+G6vyBJZGVtcG90ZW50IChjaOG7iSBj4bqtcCBuaOG6rXQgbeG7mXQgc+G7kSB0csaw4budbmcgY+G7pSB0aOG7gyBgeyJzdGF0dXMiOiAiQUNUSVZFIn1gKS4NCg0KIyMjIyAyLiBI4buHIFRo4buRbmcgTcOjIFRy4bqhbmcgVGjDoWkgSFRUUCAoU3RhdHVzIENvZGVzIEhpZXJhcmNoeSkgQ2h14bqpbiBN4buxYw0KDQp8IEThuqNpIE3DoyB8IE3DoyBD4bulIFRo4buDIHwgw50gTmdoxKlhIEvhu7kgVGh14bqtdCBDaHXhuqluIHwgTmfhu68gQ+G6o25oIFPhu60gROG7pW5nIMSQw7puZyB8DQp8IDotLS0gfCA6LS0tIHwgOi0tLSB8IDotLS0gfA0KfCAqKjJ4eCoqIHwgKioyMDAgT0sqKiB8IFRow6BuaCBjw7RuZyBjaHVuZyB8IFRy4bqjIHbhu4EgZOG7ryBsaeG7h3UgY2hvIGBHRVRgLCBgUFVUYCwgYFBBVENIYCB8DQp8IHwgKioyMDEgQ3JlYXRlZCoqIHwgVOG6oW8gdMOgaSBuZ3V5w6puIG3hu5tpIHRow6BuaCBjw7RuZyB8IFRy4bqjIHbhu4EgY2hvIGBQT1NUYCBrw6htIEhlYWRlciBgTG9jYXRpb246IC92MS9vcmRlcnMvMTAxYCB8DQp8IHwgKioyMDIgQWNjZXB0ZWQqKiB8IFRp4bq/cCBuaOG6rW4gdMOhYyB24bulIGLhuqV0IMSR4buTbmcgYuG7mSB8IENobyBjw6FjIHRp4bq/biB0csOsbmggbuG7gW4gKEFzeW5jIEpvYi9Xb3JrZXIgY2jGsGEgeG9uZyBuZ2F5KSB8DQp8IHwgKioyMDQgTm8gQ29udGVudCoqfCBUaMOgbmggY8O0bmcgbmjGsG5nIGtow7RuZyBjw7MgYm9keSB8IFRoxrDhu51uZyBkw7luZyBjaG8gYERFTEVURWAgaG/hurdjIGBQVVRgIGtow7RuZyBj4bqnbiB0cuG6oyBwYXlsb2FkIHwNCnwgKiozeHgqKiB8ICoqMzAxIE1vdmVkKiogfCDEkOG7lWkgVVJMIHbEqW5oIHZp4buFbiB8IENodXnhu4NuIGjGsOG7m25nIGVuZHBvaW50IHbEqW5oIHZp4buFbiAoU0VPIGZyaWVuZGx5KSB8DQp8IHwgKiozMDQgTm90IE1vZGlmaWVkKip8IEThu68gbGnhu4d1IGNhY2hlIGNoxrBhIHRoYXkgxJHhu5VpIHwgQ+G7sWMga+G7syBxdWFuIHRy4buNbmc6IFRy4bqjIHbhu4Ega2hpIGto4bubcCBgRVRhZ2AgLyBgSWYtTm9uZS1NYXRjaGAgfA0KfCAqKjR4eCoqIHwgKio0MDAgQmFkIFJlcXVlc3QqKnwgU2FpIGPDuiBwaMOhcCByZXF1ZXN0IHwgSlNPTiBwYXJzZSBlcnJvciwgc2FpIMSR4buLbmggZOG6oW5nIHRyxrDhu51uZyB8DQp8IHwgKio0MDEgVW5hdXRob3JpemVkKip8IENoxrBhIMSR4buLbmggZGFuaCAoVW5hdXRoZW50aWNhdGVkKXwgVGhp4bq/dSBKV1QgVG9rZW4sIFRva2VuIGjhur90IGjhuqFuLCBzYWkgY2jhu68ga8O9IHPhu5EgfA0KfCB8ICoqNDAzIEZvcmJpZGRlbioqIHwgS2jDtG5nIGPDsyBxdXnhu4FuIChVbmF1dGhvcml6ZWQpIHwgxJDDoyB4w6FjIHRo4buxYyBuaMawbmcgUm9sZS9QZXJtaXNzaW9uIGtow7RuZyDEkeG7pyBxdXnhu4FuIHwNCnwgfCAqKjQwNCBOb3QgRm91bmQqKiB8IEtow7RuZyB0w6xtIHRo4bqleSB0w6BpIG5ndXnDqm4gfCBVUkkga2jDtG5nIHThu5NuIHThuqFpIGhv4bq3YyBJRCBraMO0bmcgY8OzIHRyb25nIGPGoSBz4bufIGThu68gbGnhu4d1IHwNCnwgfCAqKjQwOSBDb25mbGljdCoqIHwgWHVuZyDEkeG7mXQgdHLhuqFuZyB0aMOhaSBo4buHIHRo4buRbmcgfCBUcsO5bmcgRW1haWwgZHV5IG5o4bqldCwgdHLDuW5nIHBoacOqbiBi4bqjbiBraMOzYSBs4bqhYyBxdWFuIHwNCnwgfCAqKjQyMiBVbnByb2Nlc3NhYmxlKip8IFZpIHBo4bqhbSBxdXkgdOG6r2MgbmdoaeG7h3AgduG7pSB8IEPDuiBwaMOhcCBKU09OIMSRw7puZyBuaMawbmcgdHXhu5VpIDwgMTggaG/hurdjIHPhu5EgZMawIGtow7RuZyDEkeG7pyB8DQp8IHwgKio0MjkgVG9vIE1hbnkgUmVxKip8IELhu4sgY2jhurduIGRvIHbGsOG7o3QgcXXDoSBSYXRlIExpbWl0IHwgVsaw4bujdCBxdW90YSBBUEksIHRy4bqjIGvDqG0gaGVhZGVyIGBSZXRyeS1BZnRlcjogNjBgIHwNCnwgKio1eHgqKiB8ICoqNTAwIEludGVybmFsIEVycioqfCBM4buXaSBo4buHIHRo4buRbmcga2jDtG5nIGzGsOG7nW5nIHRyxrDhu5tjIHwgQ3Jhc2ggdGnhur9uIHRyw6xuaCwgVW5oYW5kbGVkIEV4Y2VwdGlvbiwgT09NIHwNCnwgfCAqKjUwMiBCYWQgR2F0ZXdheSoqIHwgQ+G7lW5nIHRydW5nIGdpYW4gYuG7iyBs4buXaSB1cHN0cmVhbSB8IE5naW54IC8gRW52b3kga2jDtG5nIGvhur90IG7hu5FpIMSRxrDhu6NjIHThu5tpIEJhY2tlbmQgc2VydmljZSB8DQp8IHwgKio1MDMgU2VydmljZSBVbmF2YWlsKip8IEThu4tjaCB24bulIMSRYW5nIHF1w6EgdOG6o2kgLyBi4bqjbyB0csOsIHwgSOG7hyB0aOG7kW5nIENpcmN1aXQgQnJlYWtlciDEkWFuZyBuZ+G6r3QgbeG6oWNoIHwNCnwgfCAqKjUwNCBHYXRld2F5IFRpbWVvdXQqKnwgSOG6v3QgdGjhu51pIGdpYW4gY2jhu50gdXBzdHJlYW0gfCBNaWNyb3NlcnZpY2UgcGjDrWEgc2F1IHBo4bqjbiBo4buTaSBxdcOhIGNo4bqtbSAoPiAzMHMpIHwNCg0KLS0tDQoNCiMjIyAyLjMuIFF1ZXJ5IEVuZ2luZWVyaW5nOiBPZmZzZXQgdnMgQ3Vyc29yIFBhZ2luYXRpb24gJiBSRkMgOTQ1NyBQcm9ibGVtIERldGFpbHMNCg0KIyMjIyAxLiBTbyBTw6FuaCBC4bqjbiBDaOG6pXQgS+G7uSBUaHXhuq10OiBPZmZzZXQtYmFzZWQgdnMgQ3Vyc29yLWJhc2VkIFBhZ2luYXRpb24NCg0KYGBgbWVybWFpZA0KZmxvd2NoYXJ0IFREDQogICAgc3ViZ3JhcGggT2Zmc2V0UGFnaW5nWyIxLiBPZmZzZXQtYmFzZWQgUGFnaW5hdGlvbjogP3BhZ2U9MTAwMCZsaW1pdD0yMCJdDQogICAgICAgIE8xWyJDw6J1IGzhu4duaCBTUUw6IFNFTEVDVCAqIEZST00gb3JkZXJzIE9SREVSIEJZIGlkIEFTQyBMSU1JVCAyMCBPRkZTRVQgMjAwMDA7Il0NCiAgICAgICAgTzJbIkRhdGFiYXNlIEVuZ2luZSBCLVRyZWUgSW5kZXg6IEJ14buZYyBwaOG6o2kgcXXDqXQgdHXhuqduIHThu7EgMjAsMDIwIGLhuqNuIGdoaSJdDQogICAgICAgIE8zWyJW4bqlbiDEkeG7gTogTyhOKSBEaXNrICYgQ1BVIFNjYW4uIFLhu6dpIHJvIER1cGxpY2F0ZSByZWFkaW5nIGtoaSBjw7MgZOG7ryBsaeG7h3UgbeG7m2kgY2jDqG4gdsOgby4iXQ0KICAgICAgICBPMSAtLT4gTzIgLS0+IE8zDQogICAgZW5kDQoNCiAgICBzdWJncmFwaCBDdXJzb3JQYWdpbmdbIjIuIEN1cnNvci1iYXNlZCAoS2V5c2V0KSBQYWdpbmF0aW9uOiA/Y3Vyc29yPWV5SnBaQ0k2TWpBd01EQjkmbGltaXQ9MjAiXQ0KICAgICAgICBDMVsiQ8OidSBs4buHbmggU1FMOiBTRUxFQ1QgKiBGUk9NIG9yZGVycyBXSEVSRSBpZCA+IDIwMDAwIE9SREVSIEJZIGlkIEFTQyBMSU1JVCAyMDsiXQ0KICAgICAgICBDMlsiRGF0YWJhc2UgRW5naW5lIEItVHJlZSBJbmRleDogTmjhuqN5IHRo4bqzbmcgdOG7m2kgbsO6dCBpZCA9IDIwMDAwIHbhu5tpIMSR4buZIHBo4bupYyB04bqhcCBPKGxvZyBOKSJdDQogICAgICAgIEMzWyLGr3UgxJFp4buDbTogVOG7kWMgxJHhu5kgc2nDqnUgdOG7kWMgYuG6pXQgYmnhur9uIGTDuSBk4buvIGxp4buHdSBow6BuZyB04bu3IGTDsm5nLiBLaMO0bmcgYmFvIGdp4budIHRyw7RpIGThu68gbGnhu4d1LiJdDQogICAgICAgIEMxIC0tPiBDMiAtLT4gQzMNCiAgICBlbmQNCmBgYA0KDQotICoqT2Zmc2V0LWJhc2VkIFBhZ2luYXRpb24gKGBMSU1JVCAyMCBPRkZTRVQgMTAwMDAwMGApKio6DQogIC0gKkPGoSBjaOG6vyo6IERhdGFiYXNlIHBo4bqjaSBkdXnhu4d0IHF1YSAkMSwwMDAsMDAwJCBkw7JuZyBk4buvIGxp4buHdSDEkeG6p3UgdGnDqm4sIG7huqFwIHbDoG8gUkFNIHLhu5NpIHNhdSDEkcOzIHbhu6l0IGLhu48gdG/DoG4gYuG7mSDEkeG7gyBjaOG7iSBs4bqleSDEkcO6bmcgMjAgZMOybmcgY3Xhu5FpIGPDuW5nLg0KICAtICpIaeG7h24gdMaw4bujbmcgdHLDtGkgZOG7ryBsaeG7h3UgKERhdGEgRHJpZnQgLyBQYWdlIERyaWZ0KSo6IEtoaSB1c2VyIMSRYW5nIOG7nyB0cmFuZyAxLCBu4bq/dSBjw7MgMSDEkcahbiBow6BuZyBt4bubaSDEkcaw4bujYyB04bqhbyBjaMOobiB2w6BvIMSR4bqndSBi4bqjbmcsIGtoaSB1c2VyIGLhuqVtIHNhbmcgdHJhbmcgMiwgdG/DoG4gYuG7mSBi4bqjbiBnaGkgYuG7iyDEkeG6qXkgbMO5aSAxIG7huqVjLCBraGnhur9uIHVzZXIgbmjDrG4gdGjhuqV5IGLhuqNuIGdoaSBjdeG7kWkgY8O5bmcgY+G7p2EgdHJhbmcgMSBs4bq3cCBs4bqhaSDhu58gxJHhuqd1IHRyYW5nIDIuDQotICoqQ3Vyc29yLWJhc2VkIC8gS2V5c2V0IFBhZ2luYXRpb24gKGBXSEVSRSBpZCA+IDpsYXN0X3NlZW5faWQgTElNSVQgMjBgKSoqOg0KICAtICpDxqEgY2jhur8qOiBDb24gdHLhu48gKEN1cnNvcikgbMOgIG3hu5l0IGNodeG7l2kgbcOjIGjDs2EgQmFzZTY0IGNo4bupYSBnacOhIHRy4buLIGPhu6dhIGPhu5l0IMSR4buLbmggZGFuaCBz4bqvcCB44bq/cCAodGjGsOG7nW5nIGzDoCBgaWRgIGhv4bq3YyBgY3JlYXRlZF9hdGAgY8OzIMSRw6FuaCBjaOG7iSBt4bulYyBCLVRyZWUpLg0KICAtICpIaeG7h3UgbsSDbmcqOiBEYXRhYmFzZSBz4butIGThu6VuZyBwaMOpcCB0w6xtIGtp4bq/bSBjw6J5IG5o4buLIHBow6JuIChJbmRleCBTZWVrKSDEkeG7gyBuaOG6o3kgdHLhu7FjIHRp4bq/cCDEkeG6v24gbsO6dCBjb24gdHLhu48gduG7m2kgY2hpIHBow60gJE8oXGxvZyBOKSQsIGhvw6BuIHRvw6BuIG1p4buFbiBuaGnhu4VtIHbhu5tpIGto4buRaSBsxrDhu6NuZyBk4buvIGxp4buHdSBraOG7lW5nIGzhu5MgcGjDrWEgdHLGsOG7m2MuDQoNCiMjIyMgMi4gQ2h14bqpbiBIw7NhIEzhu5dpIFRvw6BuIEPhuqd1IFRoZW8gUkZDIDk0NTcgKFByb2JsZW0gRGV0YWlscyBmb3IgSFRUUCBBUElzKQ0KLSBUaGF5IHRo4bq/IGPhuqV1IHRyw7pjIGLDoW8gbOG7l2kgdMO5eSB0aeG7h24gKGB7ImVyciI6ICJM4buXaSIsICJjb2RlIjogMTJ9YCkgYuG6sW5nIMSR4buLbmggZOG6oW5nIGNodeG6qW4gY+G7p2EgSUVURiBSRkMgOTQ1NyB24bubaSBgQ29udGVudC1UeXBlOiBhcHBsaWNhdGlvbi9wcm9ibGVtK2pzb25gOg0KICAtIGB0eXBlYDogxJDGsOG7nW5nIGThuqtuIFVSSSBjaOG7iSB04bubaSB0w6BpIGxp4buHdSBoxrDhu5tuZyBk4bqrbiBjaGkgdGnhur90IHbhu4EgbG/huqFpIGzhu5dpIG7DoHkuDQogIC0gYHRpdGxlYDogVMOzbSB04bqvdCBuZ+G6r24gZ+G7jW4sIGThu4UgaGnhu4N1IHbhu4EgbOG7l2kgKGtow7RuZyB0aGF5IMSR4buVaSBnaeG7r2EgY8OhYyBs4bqnbiB4deG6pXQgaGnhu4duKS4NCiAgLSBgc3RhdHVzYDogTcOjIEhUVFAgU3RhdHVzIENvZGUgdMawxqFuZyDhu6luZyAodHLDuW5nIHbhu5tpIEhUVFAgaGVhZGVyKS4NCiAgLSBgZGV0YWlsYDogR2nhuqNpIHRow61jaCBuZ3V5w6puIG5ow6JuIGPhu6UgdGjhu4MgZOG6q24gxJHhur9uIGzhu5dpIGNobyByZXF1ZXN0IGhp4buHbiB04bqhaS4NCiAgLSBgaW5zdGFuY2VgOiBVUkkgY+G7p2EgcmVxdWVzdCBj4bulIHRo4buDIMSRw6MgcGjDoXQgc2luaCBs4buXaSAoaOG7lyB0cuG7oyDEkWnhu4F1IHRyYSBsb2cpLg0KICAtIGBpbnZhbGlkX3BhcmFtc2A6IFRyxrDhu51uZyBt4bufIHLhu5luZyBtw7QgdOG6oyBkYW5oIHPDoWNoIGPDoWMgdGh14buZYyB0w61uaCBraMO0bmcgaOG7o3AgbOG7hy4NCg0KLS0tDQoNCiMjIDMuIFRo4buxYyB0aGkgTcOjIG5ndeG7k24gJiBNw7QgcGjhu49uZyBDaHV5w6puIHPDonUgKER1YWwtRW5naW5lIEltcGxlbWVudGF0aW9uKQ0KDQojIyMgMy4xLiBQaGnDqm4gYuG6o24gQysrMjA6IE3DtCBQaOG7j25nIMSQ4buZbmcgQ8ahIEtleXNldCBQYWdpbmF0aW9uIHbDoCBSRkMgOTQ1NyBQcm9ibGVtIERldGFpbHMgQnVpbGRlcg0KDQpgYGBjcHANCiNpbmNsdWRlIDxpb3N0cmVhbT4NCiNpbmNsdWRlIDxzdHJpbmc+DQojaW5jbHVkZSA8dmVjdG9yPg0KI2luY2x1ZGUgPG1lbW9yeT4NCiNpbmNsdWRlIDxmb3JtYXQ+DQojaW5jbHVkZSA8b3B0aW9uYWw+DQojaW5jbHVkZSA8YWxnb3JpdGhtPg0KI2luY2x1ZGUgPGNzdGRpbnQ+DQoNCi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0NCi8vIDEuIERPTUFJTiBEQVRBIENPTlRSQUNUICYgUkVQT1NJVE9SWQ0KLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQ0Kc3RydWN0IE9yZGVySXRlbVJlY29yZCB7DQogICAgdWludDY0X3QgaWQ7DQogICAgc3RkOjpzdHJpbmcgY3VzdG9tZXJOYW1lOw0KICAgIGRvdWJsZSBhbW91bnRVU0Q7DQp9Ow0KDQovLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09DQovLyAyLiBSRkMgOTQ1NyBQUk9CTEVNIERFVEFJTFMgU1RBTkRBUkQgQlVJTERFUg0KLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQ0Kc3RydWN0IEludmFsaWRGaWVsZFBhcmFtIHsNCiAgICBzdGQ6OnN0cmluZyBmaWVsZE5hbWU7DQogICAgc3RkOjpzdHJpbmcgdmlvbGF0aW9uUmVhc29uOw0KfTsNCg0KY2xhc3MgUHJvYmxlbURldGFpbHNFeGNlcHRpb24gOiBwdWJsaWMgc3RkOjpleGNlcHRpb24gew0KcHJpdmF0ZToNCiAgICBzdGQ6OnN0cmluZyB0eXBlVXJpXzsNCiAgICBzdGQ6OnN0cmluZyB0aXRsZV87DQogICAgaW50IHN0YXR1c0h0dHBfOw0KICAgIHN0ZDo6c3RyaW5nIGRldGFpbF87DQogICAgc3RkOjpzdHJpbmcgaW5zdGFuY2VVcmlfOw0KICAgIHN0ZDo6dmVjdG9yPEludmFsaWRGaWVsZFBhcmFtPiBpbnZhbGlkUGFyYW1zXzsNCg0KcHVibGljOg0KICAgIFByb2JsZW1EZXRhaWxzRXhjZXB0aW9uKHN0ZDo6c3RyaW5nIHR5cGUsIHN0ZDo6c3RyaW5nIHRpdGxlLCBpbnQgc3RhdHVzLCANCiAgICAgICAgICAgICAgICAgICAgICAgICAgICBzdGQ6OnN0cmluZyBkZXRhaWwsIHN0ZDo6c3RyaW5nIGluc3RhbmNlLCANCiAgICAgICAgICAgICAgICAgICAgICAgICAgICBzdGQ6OnZlY3RvcjxJbnZhbGlkRmllbGRQYXJhbT4gcGFyYW1zID0ge30pDQogICAgICAgIDogdHlwZVVyaV8oc3RkOjptb3ZlKHR5cGUpKSwgdGl0bGVfKHN0ZDo6bW92ZSh0aXRsZSkpLCBzdGF0dXNIdHRwXyhzdGF0dXMpLA0KICAgICAgICAgIGRldGFpbF8oc3RkOjptb3ZlKGRldGFpbCkpLCBpbnN0YW5jZVVyaV8oc3RkOjptb3ZlKGluc3RhbmNlKSksDQogICAgICAgICAgaW52YWxpZFBhcmFtc18oc3RkOjptb3ZlKHBhcmFtcykpIHt9DQoNCiAgICBbW25vZGlzY2FyZF1dIHN0ZDo6c3RyaW5nIHNlcmlhbGl6ZUpzb24oKSBjb25zdCB7DQogICAgICAgIHN0ZDo6c3RyaW5nIGpzb24gPSAie1xuIjsNCiAgICAgICAganNvbiArPSBzdGQ6OmZvcm1hdCgiICBcInR5cGVcIjogXCJ7fVwiLFxuIiwgdHlwZVVyaV8pOw0KICAgICAgICBqc29uICs9IHN0ZDo6Zm9ybWF0KCIgIFwidGl0bGVcIjogXCJ7fVwiLFxuIiwgdGl0bGVfKTsNCiAgICAgICAganNvbiArPSBzdGQ6OmZvcm1hdCgiICBcInN0YXR1c1wiOiB7fSxcbiIsIHN0YXR1c0h0dHBfKTsNCiAgICAgICAganNvbiArPSBzdGQ6OmZvcm1hdCgiICBcImRldGFpbFwiOiBcInt9XCIsXG4iLCBkZXRhaWxfKTsNCiAgICAgICAganNvbiArPSBzdGQ6OmZvcm1hdCgiICBcImluc3RhbmNlXCI6IFwie31cIiIsIGluc3RhbmNlVXJpXyk7DQoNCiAgICAgICAgaWYgKCFpbnZhbGlkUGFyYW1zXy5lbXB0eSgpKSB7DQogICAgICAgICAgICBqc29uICs9ICIsXG4gIFwiaW52YWxpZF9wYXJhbXNcIjogW1xuIjsNCiAgICAgICAgICAgIGZvciAoc2l6ZV90IGkgPSAwOyBpIDwgaW52YWxpZFBhcmFtc18uc2l6ZSgpOyArK2kpIHsNCiAgICAgICAgICAgICAgICBqc29uICs9IHN0ZDo6Zm9ybWF0KCIgICAge3tcIm5hbWVcIjogXCJ7fVwiLCBcInJlYXNvblwiOiBcInt9XCJ9fSIsIA0KICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgaW52YWxpZFBhcmFtc19baV0uZmllbGROYW1lLCBpbnZhbGlkUGFyYW1zX1tpXS52aW9sYXRpb25SZWFzb24pOw0KICAgICAgICAgICAgICAgIGlmIChpICsgMSA8IGludmFsaWRQYXJhbXNfLnNpemUoKSkganNvbiArPSAiLCI7DQogICAgICAgICAgICAgICAganNvbiArPSAiXG4iOw0KICAgICAgICAgICAgfQ0KICAgICAgICAgICAganNvbiArPSAiICBdXG4iOw0KICAgICAgICB9IGVsc2Ugew0KICAgICAgICAgICAganNvbiArPSAiXG4iOw0KICAgICAgICB9DQogICAgICAgIGpzb24gKz0gIn0iOw0KICAgICAgICByZXR1cm4ganNvbjsNCiAgICB9DQp9Ow0KDQovLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09DQovLyAzLiBDVVJTT1ItQkFTRUQgKEtFWVNFVCkgUEFHSU5BVElPTiBFTkdJTkUNCi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0NCnN0cnVjdCBQYWdlUmVzdWx0IHsNCiAgICBzdGQ6OnZlY3RvcjxPcmRlckl0ZW1SZWNvcmQ+IGl0ZW1zOw0KICAgIHN0ZDo6b3B0aW9uYWw8dWludDY0X3Q+IG5leHRDdXJzb3I7DQogICAgYm9vbCBoYXNNb3JlOw0KfTsNCg0KY2xhc3MgT3JkZXJSZXN0U2VydmljZSB7DQpwcml2YXRlOg0KICAgIHN0ZDo6dmVjdG9yPE9yZGVySXRlbVJlY29yZD4gZGF0YWJhc2VUYWJsZV87DQoNCnB1YmxpYzoNCiAgICBPcmRlclJlc3RTZXJ2aWNlKCkgew0KICAgICAgICAvLyBLaOG7n2kgdOG6oW8gMTAwIGLhuqNuIGdoaSBnaeG6oyBs4bqtcCB0cm9uZyBjxqEgc+G7nyBk4buvIGxp4buHdQ0KICAgICAgICBmb3IgKHVpbnQ2NF90IGkgPSAxOyBpIDw9IDUwOyArK2kpIHsNCiAgICAgICAgICAgIGRhdGFiYXNlVGFibGVfLnB1c2hfYmFjayh7aSwgc3RkOjpmb3JtYXQoIktoYWNoX0hhbmdfezowM2R9IiwgaSksIDUwLjAgKyAoaSAqIDIuNSl9KTsNCiAgICAgICAgfQ0KICAgIH0NCg0KICAgIC8vIEhp4buHbiB0aOG7sWMgS2V5c2V0IFBhZ2luYXRpb246IFdIRVJFIGlkID4gY3Vyc29yIExJTUlUIGxpbWl0DQogICAgUGFnZVJlc3VsdCBsaXN0T3JkZXJzKHN0ZDo6b3B0aW9uYWw8dWludDY0X3Q+IGN1cnNvciwgc2l6ZV90IGxpbWl0LCBjb25zdCBzdGQ6OnN0cmluZyYgcmVxdWVzdFVyaSkgew0KICAgICAgICBpZiAobGltaXQgPT0gMCB8fCBsaW1pdCA+IDEwMCkgew0KICAgICAgICAgICAgdGhyb3cgUHJvYmxlbURldGFpbHNFeGNlcHRpb24oDQogICAgICAgICAgICAgICAgImh0dHBzOi8vYXBpLmVudGVycHJpc2UuY29tL2Vycm9ycy9pbnZhbGlkLXBhZ2luYXRpb24tbGltaXQiLA0KICAgICAgICAgICAgICAgICJQYWdpbmF0aW9uIGxpbWl0IHBhcmFtZXRlciBvdXQgb2YgYWNjZXB0YWJsZSBib3VuZHMuIiwNCiAgICAgICAgICAgICAgICA0MDAsDQogICAgICAgICAgICAgICAgIlRoYW0gc+G7kSAnbGltaXQnIHBo4bqjaSBu4bqxbSB0cm9uZyBraG/huqNuZyB04burIDEgxJHhur9uIDEwMCBi4bqjbiBnaGkuIiwNCiAgICAgICAgICAgICAgICByZXF1ZXN0VXJpLA0KICAgICAgICAgICAgICAgIHt7ImxpbWl0IiwgIkdpw6EgdHLhu4sgdHJ1eeG7gW4gdsOgbyBraMO0bmcgaOG7o3AgbOG7hyAobmjhu48gaMahbiAxIGhv4bq3YyBs4bubbiBoxqFuIDEwMCkifX0NCiAgICAgICAgICAgICk7DQogICAgICAgIH0NCg0KICAgICAgICB1aW50NjRfdCBzdGFydElkID0gY3Vyc29yLnZhbHVlX29yKDApOw0KICAgICAgICBzdGQ6OnZlY3RvcjxPcmRlckl0ZW1SZWNvcmQ+IHJlc3VsdHM7DQoNCiAgICAgICAgLy8gR2nhuqMgbOG6rXAgcGjDqXAgcXXDqXQgSW5kZXggU2VlayBCLVRyZWU6IFdIRVJFIGlkID4gc3RhcnRJZCBMSU1JVCBsaW1pdCArIDENCiAgICAgICAgZm9yIChjb25zdCBhdXRvJiByb3cgOiBkYXRhYmFzZVRhYmxlXykgew0KICAgICAgICAgICAgaWYgKHJvdy5pZCA+IHN0YXJ0SWQpIHsNCiAgICAgICAgICAgICAgICByZXN1bHRzLnB1c2hfYmFjayhyb3cpOw0KICAgICAgICAgICAgICAgIGlmIChyZXN1bHRzLnNpemUoKSA9PSBsaW1pdCArIDEpIHsNCiAgICAgICAgICAgICAgICAgICAgYnJlYWs7DQogICAgICAgICAgICAgICAgfQ0KICAgICAgICAgICAgfQ0KICAgICAgICB9DQoNCiAgICAgICAgYm9vbCBoYXNNb3JlID0gcmVzdWx0cy5zaXplKCkgPiBsaW1pdDsNCiAgICAgICAgaWYgKGhhc01vcmUpIHsNCiAgICAgICAgICAgIHJlc3VsdHMucG9wX2JhY2soKTsgLy8gQuG7jyBwaOG6p24gdOG7rSB0aOG7qSBsaW1pdCArIDENCiAgICAgICAgfQ0KDQogICAgICAgIHN0ZDo6b3B0aW9uYWw8dWludDY0X3Q+IG5leHRDdXJzb3IgPSBzdGQ6Om51bGxvcHQ7DQogICAgICAgIGlmIChoYXNNb3JlICYmICFyZXN1bHRzLmVtcHR5KCkpIHsNCiAgICAgICAgICAgIG5leHRDdXJzb3IgPSByZXN1bHRzLmJhY2soKS5pZDsNCiAgICAgICAgfQ0KDQogICAgICAgIHJldHVybiBQYWdlUmVzdWx0e3N0ZDo6bW92ZShyZXN1bHRzKSwgbmV4dEN1cnNvciwgaGFzTW9yZX07DQogICAgfQ0KfTsNCg0KaW50IG1haW4oKSB7DQogICAgc3RkOjpjb3V0IDw8ICI9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT1cbiI7DQogICAgc3RkOjpjb3V0IDw8ICIgIERFTU8gUkVTVCBBUEk6IEtFWVNFVCBQQUdJTkFUSU9OICYgUkZDIDk0NTcgRVJST1JTICAgICBcbiI7DQogICAgc3RkOjpjb3V0IDw8ICI9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT1cblxuIjsNCg0KICAgIE9yZGVyUmVzdFNlcnZpY2Ugc2VydmljZTsNCg0KICAgIC8vIEvhu4tjaCBi4bqjbiAxOiBUcnV5IHbhuqVuIHRyYW5nIMSR4bqndSB0acOqbiAoQ3Vyc29yID0gbnVsbCwgTGltaXQgPSAzKQ0KICAgIHN0ZDo6Y291dCA8PCAiLS0tIDEuIFRSVVkgVuG6pE4gVFJBTkcgxJDhuqZVIFRJw4pOIChHRVQgL3YxL29yZGVycz9saW1pdD0zKSAtLS1cbiI7DQogICAgUGFnZVJlc3VsdCBwYWdlMSA9IHNlcnZpY2UubGlzdE9yZGVycyhzdGQ6Om51bGxvcHQsIDMsICIvdjEvb3JkZXJzP2xpbWl0PTMiKTsNCiAgICBmb3IgKGNvbnN0IGF1dG8mIGl0ZW0gOiBwYWdlMS5pdGVtcykgew0KICAgICAgICBzdGQ6OmNvdXQgPDwgc3RkOjpmb3JtYXQoIiAgW1JvdyBJRDogezowMmR9XSBDdXN0b21lcjoge30gfCBBbW91bnQ6ICR7Oi4yZn1cbiIsIA0KICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgaXRlbS5pZCwgaXRlbS5jdXN0b21lck5hbWUsIGl0ZW0uYW1vdW50VVNEKTsNCiAgICB9DQogICAgc3RkOjpjb3V0IDw8IHN0ZDo6Zm9ybWF0KCJOZXh0IEN1cnNvciBUb2tlbjoge31cblxuIiwgcGFnZTEubmV4dEN1cnNvci52YWx1ZV9vcigwKSk7DQoNCiAgICAvLyBL4buLY2ggYuG6o24gMjogVHJ1eSB24bqlbiB0cmFuZyBr4bq/IHRp4bq/cCBk4buxYSB0csOqbiBOZXh0IEN1cnNvciB24burYSBuaOG6rW4NCiAgICBzdGQ6OmNvdXQgPDwgc3RkOjpmb3JtYXQoIi0tLSAyLiBUUlVZIFbhuqROIFRSQU5HIDIgROG7sEEgVFLDik4gQ1VSU09SIChHRVQgL3YxL29yZGVycz9jdXJzb3I9e30mbGltaXQ9MykgLS0tXG4iLCANCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgcGFnZTEubmV4dEN1cnNvci52YWx1ZSgpKTsNCiAgICBQYWdlUmVzdWx0IHBhZ2UyID0gc2VydmljZS5saXN0T3JkZXJzKHBhZ2UxLm5leHRDdXJzb3IsIDMsICIvdjEvb3JkZXJzP2N1cnNvcj0zJmxpbWl0PTMiKTsNCiAgICBmb3IgKGNvbnN0IGF1dG8mIGl0ZW0gOiBwYWdlMi5pdGVtcykgew0KICAgICAgICBzdGQ6OmNvdXQgPDwgc3RkOjpmb3JtYXQoIiAgW1JvdyBJRDogezowMmR9XSBDdXN0b21lcjoge30gfCBBbW91bnQ6ICR7Oi4yZn1cbiIsIA0KICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgaXRlbS5pZCwgaXRlbS5jdXN0b21lck5hbWUsIGl0ZW0uYW1vdW50VVNEKTsNCiAgICB9DQogICAgc3RkOjpjb3V0IDw8IHN0ZDo6Zm9ybWF0KCJOZXh0IEN1cnNvciBUb2tlbjoge31cblxuIiwgcGFnZTIubmV4dEN1cnNvci52YWx1ZV9vcigwKSk7DQoNCiAgICAvLyBL4buLY2ggYuG6o24gMzogQ2xpZW50IHRydXnhu4FuIHRoYW0gc+G7kSBsaW1pdCA9IDUwMCAoR8OieSBs4buXaSB2w6Aga8OtY2ggaG/huqF0IFJGQyA5NDU3KQ0KICAgIHN0ZDo6Y291dCA8PCAiLS0tIDMuIENMSUVOVCBH4busSSBMSU1JVCA9IDUwMCAoQuG6rlQgTOG7lkkgVsOAIFhV4bqkVCBSRkMgOTQ1NyBQUk9CTEVNIERFVEFJTFMpIC0tLVxuIjsNCiAgICB0cnkgew0KICAgICAgICBzZXJ2aWNlLmxpc3RPcmRlcnMoc3RkOjpudWxsb3B0LCA1MDAsICIvdjEvb3JkZXJzP2xpbWl0PTUwMCIpOw0KICAgIH0gY2F0Y2ggKGNvbnN0IFByb2JsZW1EZXRhaWxzRXhjZXB0aW9uJiBwZGUpIHsNCiAgICAgICAgc3RkOjpjb3V0IDw8ICJIVFRQLzEuMSA0MDAgQmFkIFJlcXVlc3RcbiI7DQogICAgICAgIHN0ZDo6Y291dCA8PCAiQ29udGVudC1UeXBlOiBhcHBsaWNhdGlvbi9wcm9ibGVtK2pzb25cblxuIjsNCiAgICAgICAgc3RkOjpjb3V0IDw8IHBkZS5zZXJpYWxpemVKc29uKCkgPDwgIlxuIjsNCiAgICB9DQoNCiAgICByZXR1cm4gMDsNCn0NCmBgYA0KDQotLS0NCg0KIyMjIDMuMi4gUGhpw6puIGLhuqNuIFB5dGhvbiAzLjExKzogQuG7mSDEkGnhu4F1IFBo4buRaSBSRVNUIEhBVEVPQVMgdsOgIFBow6JuIFRyYW5nIEN1cnNvciBCYXNlNjQNCg0KYGBgcHl0aG9uDQpmcm9tIF9fZnV0dXJlX18gaW1wb3J0IGFubm90YXRpb25zDQppbXBvcnQgYmFzZTY0DQppbXBvcnQganNvbg0KZnJvbSBkYXRhY2xhc3NlcyBpbXBvcnQgZGF0YWNsYXNzLCBmaWVsZA0KZnJvbSB0eXBpbmcgaW1wb3J0IERpY3QsIExpc3QsIE9wdGlvbmFsLCBBbnkNCg0KDQpAZGF0YWNsYXNzDQpjbGFzcyBQcm9kdWN0Og0KICAgIGlkOiBpbnQNCiAgICBuYW1lOiBzdHINCiAgICBwcmljZV91c2Q6IGZsb2F0DQogICAgY2F0ZWdvcnk6IHN0cg0KDQoNCmNsYXNzIFJlc3RQcm9kdWN0Q2F0YWxvZ1NlcnZpY2U6DQogICAgZGVmIF9faW5pdF9fKHNlbGYpOg0KICAgICAgICAjIDMwIHPhuqNuIHBo4bqpbSBt4bqrdSB0cm9uZyBraG8NCiAgICAgICAgc2VsZi5fZGI6IExpc3RbUHJvZHVjdF0gPSBbDQogICAgICAgICAgICBQcm9kdWN0KGksIGYiUHJvLUl0ZW0te2k6MDNkfSIsIHJvdW5kKDEwLjAgKyAoaSAqIDMuNSksIDIpLCAiRWxlY3Ryb25pY3MiKQ0KICAgICAgICAgICAgZm9yIGkgaW4gcmFuZ2UoMSwgMzEpDQogICAgICAgIF0NCg0KICAgIEBzdGF0aWNtZXRob2QNCiAgICBkZWYgZW5jb2RlX2N1cnNvcihsYXN0X2lkOiBpbnQpIC0+IHN0cjoNCiAgICAgICAgcmF3X2pzb24gPSBqc29uLmR1bXBzKHsibGFzdF9pZCI6IGxhc3RfaWR9KQ0KICAgICAgICByZXR1cm4gYmFzZTY0LnVybHNhZmVfYjY0ZW5jb2RlKHJhd19qc29uLmVuY29kZSgidXRmLTgiKSkuZGVjb2RlKCJ1dGYtOCIpDQoNCiAgICBAc3RhdGljbWV0aG9kDQogICAgZGVmIGRlY29kZV9jdXJzb3IoY3Vyc29yX3N0cjogc3RyKSAtPiBpbnQ6DQogICAgICAgIHRyeToNCiAgICAgICAgICAgIHJhd19ieXRlcyA9IGJhc2U2NC51cmxzYWZlX2I2NGRlY29kZShjdXJzb3Jfc3RyLmVuY29kZSgidXRmLTgiKSkNCiAgICAgICAgICAgIGRhdGEgPSBqc29uLmxvYWRzKHJhd19ieXRlcy5kZWNvZGUoInV0Zi04IikpDQogICAgICAgICAgICByZXR1cm4gaW50KGRhdGFbImxhc3RfaWQiXSkNCiAgICAgICAgZXhjZXB0IEV4Y2VwdGlvbjoNCiAgICAgICAgICAgIHJhaXNlIFZhbHVlRXJyb3IoIkNvbiB0cuG7jyBjdXJzb3IgYuG7iyBo4buPbmcgaG/hurdjIGtow7RuZyDEkcO6bmcgxJHhu4tuaCBk4bqhbmcgQmFzZTY0LiIpDQoNCiAgICBkZWYgZ2V0X3BhZ2luYXRlZF9wcm9kdWN0cyhzZWxmLCBjdXJzb3I6IE9wdGlvbmFsW3N0cl0sIGxpbWl0OiBpbnQgPSA0KSAtPiBEaWN0W3N0ciwgQW55XToNCiAgICAgICAgc3RhcnRfaWQgPSBzZWxmLmRlY29kZV9jdXJzb3IoY3Vyc29yKSBpZiBjdXJzb3IgZWxzZSAwDQoNCiAgICAgICAgIyBLZXlzZXQgc2VlazogTOG7jWMgY8OhYyBi4bqjbiBnaGkgY8OzIElEIGzhu5tuIGjGoW4gc3RhcnRfaWQNCiAgICAgICAgbWF0Y2hlZCA9IFtwIGZvciBwIGluIHNlbGYuX2RiIGlmIHAuaWQgPiBzdGFydF9pZF0NCiAgICAgICAgcGFnZV9pdGVtcyA9IG1hdGNoZWRbOmxpbWl0XQ0KICAgICAgICBoYXNfbW9yZSA9IGxlbihtYXRjaGVkKSA+IGxpbWl0DQoNCiAgICAgICAgbmV4dF9jdXJzb3IgPSBzZWxmLmVuY29kZV9jdXJzb3IocGFnZV9pdGVtc1stMV0uaWQpIGlmIGhhc19tb3JlIGFuZCBwYWdlX2l0ZW1zIGVsc2UgTm9uZQ0KDQogICAgICAgICMgWMOieSBk4buxbmcgcGjhuqNuIGjhu5NpIGNodeG6qW4gSEFURU9BUyAoUmljaGFyZHNvbiBMZXZlbCAzKQ0KICAgICAgICByZXNwb25zZTogRGljdFtzdHIsIEFueV0gPSB7DQogICAgICAgICAgICAiZGF0YSI6IFsNCiAgICAgICAgICAgICAgICB7DQogICAgICAgICAgICAgICAgICAgICJpZCI6IHAuaWQsDQogICAgICAgICAgICAgICAgICAgICJuYW1lIjogcC5uYW1lLA0KICAgICAgICAgICAgICAgICAgICAicHJpY2UiOiBwLnByaWNlX3VzZCwNCiAgICAgICAgICAgICAgICAgICAgImNhdGVnb3J5IjogcC5jYXRlZ29yeSwNCiAgICAgICAgICAgICAgICAgICAgIl9saW5rcyI6IHsNCiAgICAgICAgICAgICAgICAgICAgICAgICJzZWxmIjogeyJocmVmIjogZiIvdjEvcHJvZHVjdHMve3AuaWR9IiwgIm1ldGhvZCI6ICJHRVQifSwNCiAgICAgICAgICAgICAgICAgICAgICAgICJ1cGRhdGUiOiB7ImhyZWYiOiBmIi92MS9wcm9kdWN0cy97cC5pZH0iLCAibWV0aG9kIjogIlBBVENIIn0sDQogICAgICAgICAgICAgICAgICAgICAgICAiZGVsZXRlIjogeyJocmVmIjogZiIvdjEvcHJvZHVjdHMve3AuaWR9IiwgIm1ldGhvZCI6ICJERUxFVEUifQ0KICAgICAgICAgICAgICAgICAgICB9DQogICAgICAgICAgICAgICAgfQ0KICAgICAgICAgICAgICAgIGZvciBwIGluIHBhZ2VfaXRlbXMNCiAgICAgICAgICAgIF0sDQogICAgICAgICAgICAicGFnaW5hdGlvbiI6IHsNCiAgICAgICAgICAgICAgICAibGltaXQiOiBsaW1pdCwNCiAgICAgICAgICAgICAgICAiaGFzX21vcmUiOiBoYXNfbW9yZSwNCiAgICAgICAgICAgICAgICAibmV4dF9jdXJzb3IiOiBuZXh0X2N1cnNvcg0KICAgICAgICAgICAgfSwNCiAgICAgICAgICAgICJfbGlua3MiOiB7DQogICAgICAgICAgICAgICAgInNlbGYiOiB7ImhyZWYiOiBmIi92MS9wcm9kdWN0cz9saW1pdD17bGltaXR9IiArIChmIiZjdXJzb3I9e2N1cnNvcn0iIGlmIGN1cnNvciBlbHNlICIiKX0NCiAgICAgICAgICAgIH0NCiAgICAgICAgfQ0KDQogICAgICAgIGlmIG5leHRfY3Vyc29yOg0KICAgICAgICAgICAgcmVzcG9uc2VbIl9saW5rcyJdWyJuZXh0Il0gPSB7DQogICAgICAgICAgICAgICAgImhyZWYiOiBmIi92MS9wcm9kdWN0cz9saW1pdD17bGltaXR9JmN1cnNvcj17bmV4dF9jdXJzb3J9IiwNCiAgICAgICAgICAgICAgICAibWV0aG9kIjogIkdFVCINCiAgICAgICAgICAgIH0NCg0KICAgICAgICByZXR1cm4gcmVzcG9uc2UNCg0KDQppZiBfX25hbWVfXyA9PSAiX19tYWluX18iOg0KICAgIHByaW50KCI9IiAqIDY1KQ0KICAgIHByaW50KCIgICAgUkVTVCBBUEkgREVNTzogSEFURU9BUyBMRVZFTCAzICYgQkFTRTY0IENVUlNPUiBQQUdJTkFUSU9OIikNCiAgICBwcmludCgiPSIgKiA2NSkNCg0KICAgIGFwaSA9IFJlc3RQcm9kdWN0Q2F0YWxvZ1NlcnZpY2UoKQ0KDQogICAgIyBUcmFuZyAxDQogICAgcHJpbnQoIlxuLS0tIDEuIEzhuqRZIFRSQU5HIMSQ4bqmVSBUScOKTiAoR0VUIC92MS9wcm9kdWN0cz9saW1pdD0yKSAtLS0iKQ0KICAgIHBhZ2UxID0gYXBpLmdldF9wYWdpbmF0ZWRfcHJvZHVjdHMoY3Vyc29yPU5vbmUsIGxpbWl0PTIpDQogICAgcHJpbnQoanNvbi5kdW1wcyhwYWdlMSwgaW5kZW50PTIsIGVuc3VyZV9hc2NpaT1GYWxzZSkpDQoNCiAgICAjIFRyYW5nIDIgZMO5bmcgbmV4dF9jdXJzb3IgdOG7qyB0cmFuZyAxDQogICAgdG9rZW4gPSBwYWdlMVsicGFnaW5hdGlvbiJdWyJuZXh0X2N1cnNvciJdDQogICAgcHJpbnQoZiJcbi0tLSAyLiBM4bqkWSBUUkFORyBUSOG7qCBIQUkgVuG7mkkgQ1VSU09SIFRPS0VOOiAne3Rva2VufScgLS0tIikNCiAgICBwYWdlMiA9IGFwaS5nZXRfcGFnaW5hdGVkX3Byb2R1Y3RzKGN1cnNvcj10b2tlbiwgbGltaXQ9MikNCiAgICBwcmludChmIk5o4bqtbiDEkcaw4bujYyB7bGVuKHBhZ2UyWydkYXRhJ10pfSBz4bqjbiBwaOG6qW0gdGnhur9wIHRoZW86IikNCiAgICBmb3IgaXRlbSBpbiBwYWdlMlsiZGF0YSJdOg0KICAgICAgICBwcmludChmIiAgLT4gSUQ6IHtpdGVtWydpZCddfSB8IFTDqm46IHtpdGVtWyduYW1lJ119IHwgR2nDoTogJHtpdGVtWydwcmljZSddfSIpDQogICAgcHJpbnQoZiJOZXh0IExpbmsgSEFURU9BUzoge3BhZ2UyWydfbGlua3MnXS5nZXQoJ25leHQnLCB7fSkuZ2V0KCdocmVmJyl9IikNCmBgYA0KDQojIyMgMy4zLiBHaeG6oyBM4bqtcCBUZXJtaW5hbCBPdXRwdXQgVGjhu7FjIFThur8NCg0KYGBgdGV4dA0KPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09DQogIERFTU8gUkVTVCBBUEk6IEtFWVNFVCBQQUdJTkFUSU9OICYgUkZDIDk0NTcgRVJST1JTICAgICANCj09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PQ0KDQotLS0gMS4gVFJVWSBW4bqkTiBUUkFORyDEkOG6plUgVEnDik4gKEdFVCAvdjEvb3JkZXJzP2xpbWl0PTMpIC0tLQ0KICBbUm93IElEOiAwMV0gQ3VzdG9tZXI6IEtoYWNoX0hhbmdfMDAxIHwgQW1vdW50OiAkNTIuNTANCiAgW1JvdyBJRDogMDJdIEN1c3RvbWVyOiBLaGFjaF9IYW5nXzAwMiB8IEFtb3VudDogJDU1LjAwDQogIFtSb3cgSUQ6IDAzXSBDdXN0b21lcjogS2hhY2hfSGFuZ18wMDMgfCBBbW91bnQ6ICQ1Ny41MA0KTmV4dCBDdXJzb3IgVG9rZW46IDMNCg0KLS0tIDIuIFRSVVkgVuG6pE4gVFJBTkcgMiBE4buwQSBUUsOKTiBDVVJTT1IgKEdFVCAvdjEvb3JkZXJzP2N1cnNvcj0zJmxpbWl0PTMpIC0tLQ0KICBbUm93IElEOiAwNF0gQ3VzdG9tZXI6IEtoYWNoX0hhbmdfMDA0IHwgQW1vdW50OiAkNjAuMDANCiAgW1JvdyBJRDogMDVdIEN1c3RvbWVyOiBLaGFjaF9IYW5nXzAwNSB8IEFtb3VudDogJDYyLjUwDQogIFtSb3cgSUQ6IDA2XSBDdXN0b21lcjogS2hhY2hfSGFuZ18wMDYgfCBBbW91bnQ6ICQ2NS4wMA0KTmV4dCBDdXJzb3IgVG9rZW46IDYNCg0KLS0tIDMuIENMSUVOVCBH4busSSBMSU1JVCA9IDUwMCAoQuG6rlQgTOG7lkkgVsOAIFhV4bqkVCBSRkMgOTQ1NyBQUk9CTEVNIERFVEFJTFMpIC0tLQ0KSFRUUC8xLjEgNDAwIEJhZCBSZXF1ZXN0DQpDb250ZW50LVR5cGU6IGFwcGxpY2F0aW9uL3Byb2JsZW0ranNvbg0KDQp7DQogICJ0eXBlIjogImh0dHBzOi8vYXBpLmVudGVycHJpc2UuY29tL2Vycm9ycy9pbnZhbGlkLXBhZ2luYXRpb24tbGltaXQiLA0KICAidGl0bGUiOiAiUGFnaW5hdGlvbiBsaW1pdCBwYXJhbWV0ZXIgb3V0IG9mIGFjY2VwdGFibGUgYm91bmRzLiIsDQogICJzdGF0dXMiOiA0MDAsDQogICJkZXRhaWwiOiAiVGhhbSBz4buRICdsaW1pdCcgcGjhuqNpIG7hurFtIHRyb25nIGtob+G6o25nIHThu6sgMSDEkeG6v24gMTAwIGLhuqNuIGdoaS4iLA0KICAiaW5zdGFuY2UiOiAiL3YxL29yZGVycz9saW1pdD01MDAiLA0KICAiaW52YWxpZF9wYXJhbXMiOiBbDQogICAgeyJuYW1lIjogImxpbWl0IiwgInJlYXNvbiI6ICJHacOhIHRy4buLIHRydXnhu4FuIHbDoG8ga2jDtG5nIGjhu6NwIGzhu4cgKG5o4buPIGjGoW4gMSBob+G6t2MgbOG7m24gaMahbiAxMDApIn0NCiAgXQ0KfQ0KYGBgDQoNCi0tLQ0KDQojIyA0LiBTeXN0ZW1zIEVuZ2luZWVyaW5nICYgUHJvZHVjdGlvbiBQaXRmYWxscw0KDQojIyMgQ+G6oW0gQuG6q3kgU+G6o24gWHXhuqV0IFRoxrDhu51uZyBH4bq3cCAoUHJvZHVjdGlvbiBBbnRpLVBhdHRlcm5zICYgR290Y2hhcykNCg0KMS4gKipIaeG7g20gSOG7jWEgIkhUVFAgMjAwIE9LIE5oxrBuZyBUaOG6pXQgQuG6oWkiIChUaGUgUHNldWRvLTIwMCBBbnRpLVBhdHRlcm4pKio6DQogICAtICpC4bqjbiBjaOG6pXQqOiBBUEkgbHXDtG4gdHLhuqMgduG7gSBtw6MgdHLhuqFuZyB0aMOhaSBgMjAwIE9LYCwgbmjGsG5nIHRyb25nIGJvZHkgbOG6oWkgY2jhu6lhIGB7ICJzdGF0dXMiOiAiRVJST1IiLCAibWVzc2FnZSI6ICJOdWxsIFBvaW50ZXIgQ3Jhc2giIH1gLg0KICAgLSAqSOG6rXUgcXXhuqMgdGFpIGjhuqFpKjogVG/DoG4gYuG7mSBo4bqhIHThuqduZyBt4bqhbmcgdHJ1bmcgZ2lhbiBi4buLIMSRw6FuaCBs4burYTogUHJveHkgQ2FjaGUgbMawdSBs4bqhaSBr4bq/dCBxdeG6oyBs4buXaTsgQVBJIEdhdGV3YXkgdMOtbmggdOG7tyBs4buHIGzhu5dpICQwXCUkIGTDuSBk4buLY2ggduG7pSDEkWFuZyBz4bqtcDsgY8OhYyBo4buHIHRo4buRbmcgZ2nDoW0gc8OhdCBTTE8vU0xBIChuaMawIFByb21ldGhldXMsIERhdGFkb2cpIGtow7RuZyB0aOG7gyBwaMOhdCBoaeG7h24gc+G7sSBj4buRIHThu7EgxJHhu5luZy4NCiAgIC0gKlF1eSBjaHXhuqluKjogTHXDtG4gcGjhuqNuIMOhbmggxJHDum5nIGLhuqNuIGNo4bqldCBz4buxIGPhu5EgYuG6sW5nIGThuqNpIG3DoyBgNHh4YCBob+G6t2MgYDV4eGAuDQoNCjIuICoqQ8O6IFPhu5FjIEhp4buHdSBOxINuZyBQaMOibiBUcmFuZyBEZWVwIE9mZnNldCAoRGVlcCBPZmZzZXQgUGVyZm9ybWFuY2UgQ2xpZmYpKio6DQogICAtICpC4bqjbiBjaOG6pXQqOiBM4bqtcCB0csOsbmggdmnDqm4gcGjGoWkgYsOgeSBnaWFvIGRp4buHbiBwaMOibiB0cmFuZyBgP3BhZ2U9NTAwMDBgLiBLaGkgYm90IGPDoG8gZOG7ryBsaeG7h3UgbOG6rXQgdOG7m2kgdHJhbmcgdGjhu6kgNTAsMDAwLCBkYXRhYmFzZSBwaOG6o2kgxJHhu41jIDEsMDAwLDAwMCBkw7JuZyBraGnhur9uIHRo4budaSBnaWFuIHBo4bqjbiBo4buTaSB0xINuZyB04burIDEwbXMgbMOqbiA0NSBnacOieSwgZ8OieSBj4bqhbiBraeG7h3QgQ29ubmVjdGlvbiBQb29sIHbDoCBsw6BtIHPhuq1wIERhdGFiYXNlIGNow61uaC4NCiAgIC0gKkdp4bqjaSBwaMOhcCo6IMSQ4buRaSB24bubaSBQdWJsaWMgQVBJIGhv4bq3YyBk4buvIGxp4buHdSBs4bubbiwgYuG6r3QgYnXhu5ljIGNo4bq3biBj4bupbmcgYG1heF9vZmZzZXQgPSAxMDAwYCBob+G6t2MgY2h1eeG7g24gxJHhu5VpIHRvw6BuIGLhu5kgc2FuZyBDdXJzb3ItYmFzZWQgUGFnaW5hdGlvbi4NCg0KMy4gKipSw7IgUuG7iSBUaMO0bmcgVGluIE5ndXkgSGnhu4NtIFF1YSBCw6FvIEzhu5dpIChJbmZvcm1hdGlvbiBEaXNjbG9zdXJlIHZpYSBTdGFjayBUcmFjZXMpKio6DQogICAtICpC4bqjbiBjaOG6pXQqOiBLaGkgY8OzIEV4Y2VwdGlvbiwgc2VydmVyIHRy4bqjIHbhu4Egbmd1ecOqbiB2xINuIHbhur90IG5nxINuIHjhur9wIEphdmEvUHl0aG9uL05vZGUuanMgY2jhu6lhIHTDqm4gYuG6o25nIGRhdGFiYXNlLCBjw6J1IGzhu4duaCBTUUwgbuG7mWkgYuG7mSwgxJHGsOG7nW5nIGThuqtuIGZpbGUgdHLDqm4gbcOheSBjaOG7py4gS+G6uyB04bqlbiBjw7RuZyBs4bujaSBk4bulbmcgdGjDtG5nIHRpbiBuw6B5IMSR4buDIGtoYWkgdGjDoWMgU1FMIEluamVjdGlvbi4NCiAgIC0gKkdp4bqjaSBwaMOhcCo6IOG7niBtw7RpIHRyxrDhu51uZyBQcm9kdWN0aW9uLCBi4bqvdCBideG7mWMgbOG7jWMgc+G6oWNoIHRow7RuZyDEkWnhu4dwIGzhu5dpIHF1YSBNaWRkbGV3YXJlLCBjaOG7iSB0cuG6oyB24buBIG3DoyBs4buXaSBjaHXhuqluIFJGQyA5NDU3IHbDoCBsxrB1IHbhur90IGNoaSB0aeG6v3QgdHJvbmcgaOG7hyB0aOG7kW5nIGdpw6FtIHPDoXQgbuG7mWkgYuG7mSAoRUxLIC8gQ2xvdWRXYXRjaCkga8OobSB0aGVvIGBjb3JyZWxhdGlvbl9pZGAuDQoNCjQuICoqS+G7uSBUaHXhuq10IENo4bqpbiDEkG/DoW4gJiBHacOhbSBTw6F0IFByb2R1Y3Rpb24gQuG6sW5nIENMSSoqOg0KICAgYGBgYmFzaA0KICAgIyAxLiBLaeG7g20gdHJhIG3DoyB0cuG6oW5nIHRow6FpIEhUVFAgdHLhuqMgduG7gSB04burIEFQSSBi4bqxbmcgY1VSTCAoWGVtIGPhuqMgUmVzcG9uc2UgSGVhZGVycykNCiAgIGN1cmwgLWkgLVggUE9TVCBodHRwczovL2FwaS5lbnRlcnByaXNlLmNvbS92MS9vcmRlcnMgXA0KICAgICAtSCAiQ29udGVudC1UeXBlOiBhcHBsaWNhdGlvbi9qc29uIiBcDQogICAgIC1kICd7Iml0ZW1zIjogW119Jw0KDQogICAjIDIuIEJlbmNobWFyayDEkeG7mSB0cuG7hSBwaMOibiB0cmFuZyBLZXlzZXQgdnMgT2Zmc2V0IGLhurFuZyBBcGFjaGUgQmVuY2htYXJrDQogICBhYiAtbiAxMDAwIC1jIDIwICJodHRwczovL2FwaS5lbnRlcnByaXNlLmNvbS92MS9vcmRlcnM/Y3Vyc29yPWV5SnBaQ0k2TVRBd01IMD0mbGltaXQ9NTAiDQoNCiAgICMgMy4gUXXDqXQgbG9nIHTDrG0gY8OhYyByZXF1ZXN0IHRy4bqjIHbhu4EgbcOjIGzhu5dpIDR4eC81eHggdHJvbmcgTmdpbnggQWNjZXNzIExvZw0KICAgYXdrICcoJDkgPj0gNDAwKSB7cHJpbnQgJDcsICQ5fScgL3Zhci9sb2cvbmdpbngvYWNjZXNzLmxvZyB8IHNvcnQgfCB1bmlxIC1jIHwgc29ydCAtbnIgfCBoZWFkIC1uIDIwDQogICBgYGANCg0KLS0tDQoNCiMjIDUuIELhuqNuZyBTbyBzw6FuaCAmIERlY2lzaW9uIE1hdHJpeA0KDQojIyMgNS4xLiBTbyBTw6FuaCBIYWkgQ2hp4bq/biBMxrDhu6NjIFBow6JuIFRyYW5nIChQYWdpbmF0aW9uIFN0cmF0ZWdpZXMpDQoNCnwgVGnDqnUgQ2jDrSBL4bu5IFRodeG6rXQgfCBQaMOibiBUcmFuZyBE4buxYSBUcsOqbiBPZmZzZXQgKFBhZ2UvT2Zmc2V0KSB8IFBow6JuIFRyYW5nIEThu7FhIFRyw6puIENvbiBUcuG7jyAoQ3Vyc29yL0tleXNldCkgfA0KfCA6LS0tIHwgOi0tLSB8IDotLS0gfA0KfCAqKkPDuiBwaMOhcCBVUkwgxJFp4buDbiBow6xuaCoqIHwgYD9wYWdlPTUmbGltaXQ9MjBgIGhv4bq3YyBgP29mZnNldD04MCZsaW1pdD0yMGAgfCBgP2N1cnNvcj1leUpwWkNJNk9ERjkmbGltaXQ9MjBgIHwNCnwgKirEkOG7mSBwaOG7qWMgdOG6oXAgU1FMKiogfCAkTyhOKSQg4oCUIEPDoG5nIHbhu4Egc2F1IGPDoG5nIGNo4bqtbSB8ICRPKFxsb2cgTikkIOKAlCBMdcO0biBuaGFuaCBi4bqldCBiaeG6v24gfA0KfCAqKkhp4buHbiB0xrDhu6NuZyB0csO0aSBk4buvIGxp4buHdSoqfCBDw7MgKEThu4UgxJHhu41jIHRyw7luZyBob+G6t2Mgc8OzdCBraGkgY8OzIGThu68gbGnhu4d1IG3hu5tpKSB8IEtow7RuZyBiYW8gZ2nhu50gYuG7iyB0csO0aSB8DQp8ICoqTmjhuqN5IHThu5tpIHRyYW5nIGLhuqV0IGvhu7MqKiB8IFLhuqV0IGThu4UgZMOgbmcgKGBKdW1wIHRvIFBhZ2UgMTBgKSB8IEtow7RuZyBo4buXIHRy4bujIChDaOG7iSDEkWkgdOG7m2kvbHVpIHThu6tuZyBixrDhu5tjKSB8DQp8ICoqVHLGsOG7nW5nIGjhu6NwIHThu5FpIMawdSoqIHwgVHJhbmcgcXXhuqNuIHRy4buLIEFkbWluIG5o4buPLCBk4buvIGxp4buHdSB0xKluaCDDrXQgxJHhu5VpIHwgRmVlZCBt4bqhbmcgeMOjIGjhu5lpLCBNb2JpbGUgSW5maW5pdGUgU2Nyb2xsLCBCaWcgRGF0YSB8DQoNCiMjIyA1LjIuIE1hIFRy4bqtbiBRdXnhur90IMSQ4buLbmggTOG7sWEgQ2jhu41uIEhUVFAgTWV0aG9kcyB2w6AgTcOjIFBo4bqjbiBI4buTaQ0KDQp8IEjDoG5oIMSQ4buZbmcgTmdoaeG7h3AgVuG7pSBD4bqnbiBUaOG7sWMgSGnhu4duIHwgxJDhu5luZyBU4burIENodeG6qW4gfCBIVFRQIFN0YXR1cyBUaMOgbmggQ8O0bmcgfCBNw6MgTOG7l2kgxJBp4buDbiBIw6xuaCB8DQp8IDotLS0gfCA6LS0tOiB8IDotLS06IHwgOi0tLTogfA0KfCAqKsSQ4buNYyBkYW5oIHPDoWNoIGhv4bq3YyBjaGkgdGnhur90IGLhuqNuIGdoaSoqIHwgYEdFVGAgfCBgMjAwIE9LYCAoa8OobSBib2R5KSB8IGA0MDQgTm90IEZvdW5kYCB8DQp8ICoqVOG6oW8gbeG7m2kgbeG7mXQgdMOgaSBuZ3V5w6puICjEkMahbiBow6BuZywgS2jDoWNoIGjDoG5nKSoqIHwgYFBPU1RgIHwgYDIwMSBDcmVhdGVkYCAoYExvY2F0aW9uYCBoZWFkZXIpIHwgYDQwMCBCYWQgUmVxdWVzdGAsIGA0MjIgVW5wcm9jZXNzYWJsZWAgfA0KfCAqKlRoYXkgdGjhur8gdG/DoG4gYuG7mSB0aMO0bmcgdGluIHTDoGkgbmd1ecOqbioqIHwgYFBVVGAgfCBgMjAwIE9LYCBob+G6t2MgYDIwNCBObyBDb250ZW50YCB8IGA0MDQgTm90IEZvdW5kYCwgYDQwOSBDb25mbGljdGAgfA0KfCAqKkNo4buJIGPhuq1wIG5o4bqtdCAxIHRyxrDhu51uZyAodsOtIGThu6U6IMSR4buVaSB0cuG6oW5nIHRow6FpKSoqIHwgYFBBVENIYCB8IGAyMDAgT0tgIHwgYDQyMiBVbnByb2Nlc3NhYmxlYCB8DQp8ICoqSOG7p3kgYuG7jyAvIFjDs2EgbeG7mXQgdMOgaSBuZ3V5w6puKiogfCBgREVMRVRFYCB8IGAyMDQgTm8gQ29udGVudGAgfCBgNDA0IE5vdCBGb3VuZGAgfA0KfCAqKkfhu61pIHTDoWMgduG7pSBu4bq3bmcgY2jhuqF5IG5n4bqnbSAoRXhwb3J0IENTViAxIHRyaeG7h3UgZMOybmcpKip8IGBQT1NUYCB8IGAyMDIgQWNjZXB0ZWRgIHwgYDQyOSBUb28gTWFueSBSZXF1ZXN0c2AgfA0K