אינטרפרטציה של משתתפים

(סעיף: מערכת אקולוגית ורשת)

1) מהי אינטרפרטציה בין המשתתפים

Interoperability - יכולתם של ארגונים שונים (אופרטורים, אולפנים, PSP, ספקי KYC/AML, גשרים, משתייכים, אנליסטים ומושלים) לתקשר זה עם זה באופן אמין באמצעות פרוטוקולים וחוזים מוסכמים, תוך שמירה על ביטחון, פרטיות ורבייה של תוצאות עסקיות.

• זמן לאינטגרציה
• חיזוי (SLO/SLA יציב על ידי זרימות קריטיות).
• ביטחון וציות (מינימום זכויות, ביקורת).
• אבולוציה ללא התמוטטות (ורסינציה, תאימות לאחור).

2) רמות ביניים (מודל שכבה)

1. תחבורה ורשת: HTTP/2/3, gRPC/QUIC, שקעי אינטרנט, P2P, mTLS.
2. זהויות ואמון: org_id, peer_id, X.509/mTLS, חתימות, סיבוב מפתח.
3. אירועים ונתונים: תרשימי אירועים מאוחדים, קטלוגים של נכס/רשת, אידמפוטנטיות.
4. תהליכים וחוזים עסקיים: תשלום/הסדר, ייחוס, אותות סיכון, שכפול מוגבל.
5. שכבה ניהולית/משפטית: SLA/SLO, DPA, רישיונות, תקנות של מושל.
6. יכולת תצפית ואיכות: SLI/SLO, כריתת עצים, איתור, ביקורת חשבונות.

לכל שכבה יש חוזים, בדיקות ומדיניות תאימות משלה.

3) עקרונות עיצוב

Contract-first: APIs/schemas/events מותאמים באופן פורמלי לפני היישום.
שינויים תואמים אחורנית: אסטרטגיית ”הוספת שדות בלבד” וחלון פחת של 90 יום.
משא ומתן על יכולת: משתתפות מחליפות יכולות נתמכות ובוחרות תת-קבוצה משותפת.
בידוד ו-POLP: גישה ומגבלות מונפקות ”מינימום הכרחי”.
אידמפוטנטיות ודטרמיניזם: פעולות חוזרות-בטוחות, כללי קונפליקט צפויים.
תצפית ברירת מחדל: התאמה אידית של בקשות/אירועים, חשבונות ניתנים לאימות.
מזעור נתונים: חוסר מח "ש בטלמטריה/תוויות, פסאודונימיזציה.

4) משא ומתן על יכולת

כשלוחצים ידיים, המשתתפים מפרסמים גילוי דעת של תכונות וגרסאות.

yaml participant:
org_id: "ORG:ACME"
versions:
api: "2. 6. 1"
events: "1. 9. 0"
capabilities:
payouts: { create: true, cancel: true, currencies: [USD, EUR, USDC] }
kyc: { level: ["basic","enhanced"], sla_minutes_p95: 15 }
bridge: { proof: ["light","zk"], challenge_supported: true }
telemetry: { qos: ["P0","P1"], traces: true }
limits:
payouts_daily_usd: 1_000_000 rate_limits: { create_per_minute: 500 }

מנוע התאימות מתאים למניפסטים של המפלגה ובוחר פרופיל עבודה (למשל: פגישות: v2, אירועים: v1. 9`).

5) API/Event Contracts and Schemas

חוזי API: OpenAPI/gRPC IDL, קודי שגיאה נקיים, מפתחות אידמפוטנטים (Idempotency-Key), אילוצי גוף.
מודל אירוע: "הפקדה. ", התשלום. ',' גשר. ", קייק. ”,” סיכון. ”,” מוצר. עם שדות יציבים.
ספריות/קטלוגים: רשתות, נכסים, שיטות תשלום, גרסאות SDK, אזורים/תחומי שיפוט.
חוזי נתונים - שנבחנו במודיעיני, שינויים באמצעות ממשל עם טיימלוק.

yaml event:
id: uuid ts: timestamp_utc type: payout. created    payout. finalized    bridge. lock...
src_org: string dst_org: string payload: object trace_id: string idempotency_key: string signature: string # source signature

6) ורסינציה ותאימות

גרסאות סמנטיות: 'מייג' ור. מינורי. טלאי '.
כללים: MINOR/PATCH - התאמה לאחור; קיום מקביל רב ־ סרן עם ”מסתגלים”, דלה ב ־ 90 יום.
ספרי משחק: תבניות נדידה עבור API/Events/Directories; אמולטורים של פורמטים ישנים.

7) תבניות אינטגרציה (תבניות)

בקשה-תגובה + אידמפוטנטיות: תשלומים מאובטחים/גבולות/רזרבות.
”מקורות האמת” שולחים שינוי; המנויים מממשים חנויות.
Outbox/Inbox: פרסום אטומי של אירועים ממסד הנתונים; קבלת פנים אידמפוטנטית במנוי.
SAGA (תזמור/כוריאוגרפיה): פעולות רב-תחומיות מתואמות (לדוגמה, ”popolniye ac igrovoye sobytiye ac vyplata”).
שומר דו-כתיבה: אין רשומות כפולות ישירות ללא תיבת יוצא.
הילוך חוזר/הילוך אחורי: כשל עם סדר וסיום.

8) ביטחון ואמון

MTLS וקשירת מפתח ל- ”org _ id/peer _ id”.
חתימות אירוע, יומן אמון (מי ומה חתום/קיבל).
RBAC/ABAC ומכסות: זכויות לפי תפקיד, מגבלות לפי תפעול/נפח.
ניהול סודי: רוטציה, איסור על אסימונים ”ארוכים”, סקופים קצרים.
PII/פרטיות: טוקניזציה, הפרדת נתונים אזורית (EU/ROW), תהליכי DSR (מחיקה/יצוא).
הגנה מפני התעללות: מהירות מוגבלת, אותות נגד הונאה, בדיקות סנקציות.

9) SLI/SLO ויכולת תצפית בין-זוגית

• 'p95 זמן להכיר'.
• 'p95 End-to-End' (ליצור סופי/לבצע).
• 'שיעור הצלחה' על ידי אירוע/סוג פעולה.
• 'Schema/Contract Complication%' (הודעות תקפות).
• 'כיסוי הוכחה%' (פרופורציה של ראיות חתומות/מצורפות).
• ”שרפת תקציב שגיאה” P0/P1.

• P0 (תשלום/גשר): p95 E2E 5 דקות, הצלחה 99. 5%, אק 2 שניות.
• P1 (מוצר): רעננות p95/3 min, ציות 99. 9%.
• חוזי נתונים: Drift MTTA 5 MIN, Breaking changes = 0 ללא MAJOR.

Ops Interop, Contract Health, Latency & Success, Schema Drift, Security & Keys.

10) מטריצת תאימות (עיצוב מבחן)

• תרחישים: תשלום, הפקדות, גשר, סיכון, מוצר, טלמטריה.
• גרסאות: API v2. 6/v2. 5, אירועים v1. 9/v1. 8.
• מצבי רשת: נורמלי, השפלה, גירה, עיכובים של התובע המחוזי.
• תחומי שיפוט: EU/UK/TR/LA - קטלוגים וכללים שונים.

מבחנים אוטומטיים: מבחני חוזה (יצרן/צרכן), אידמפוטנטיות, ריטרי/פיצוי, סכימה-לינטרים, פרופילי טעינה.

11) תוכניות התייחסות וקטלוגים

קטלוג תכונות (SQL)

sql
CREATE TABLE capabilities (
org_id TEXT,
cap_name TEXT,
version TEXT,
params JSONB,
PRIMARY KEY (org_id, cap_name)
);

חוזה/רשימת גרסאות

sql
CREATE TABLE contracts (
name TEXT, kind TEXT,     -- api    events    catalog version TEXT, status TEXT,  -- active    deprecated    retired breaking BOOLEAN DEFAULT FALSE,
effective_from TIMESTAMPTZ,
deprecates_at TIMESTAMPTZ,
PRIMARY KEY (name, version)
);

תאימות ניטור

sql
SELECT name, version, 100. 0SUM(CASE WHEN compliant THEN 1 END)/COUNT() AS compliance_pct
FROM contract_checks
WHERE ts >= now() - INTERVAL '7 days'
GROUP BY name, version;

12) תצורות (YAML)

מדיניות וריאציות

yaml versioning:
events: { compatibility: "BACKWARD", deprecate_days: 90 }
api:  { parallel_majors: true, support_minors: 2 }

idempotency וחוזר

yaml idempotency:
header: "Idempotency-Key"
ttl_hours: 72 conflict_policy: "prefer-latest-payload-with-signature"

כיתות QOS

yaml qos:
P0: { ack_timeout_ms: 2000, retries: 3, backoff_ms: [100,400,800] }
P1: { ack_timeout_ms: 5000, retries: 2 }
P2: { best_effort: true }

13) נוהלי הפעלה

דו "ח ציות על חוזים/מזימות, מפתחות שפג תוקפם, שריפת SLO.
שבועי: ועדת ביניים (הזדמנויות חדשות, נדידה, ירידה).
לפני השחרור: בדיקות חוזה, קנרית עם מדדים ”זכוכית”, תוכניות rollback.
תקריות: ערוץ מצב יחיד, תבניות הודעה לשותפים, דו "ח 72 h לאחר המוות.

14) תקריות משחק

סכימה/חוזה דריפט

1. אפשר ”מצב נוקשה” (לחתוך הודעות בלתי הולמות),

2. פתח את התקרית והודיע למקורות,

3. ליצור דיפ

4. שחרר את המתאם/תיקון,

5. לאחר המוות ועדכון לינטר.

B. Bulk חוזר/הודעות כפולות

1. בדוק אידמפוטנטיות/מפתחות,

2. הפעל את מסנני הדיאדופ,

3. להגביל את המפיק הרועש,

4. חישוב מחדש של חלונות חנות.

עלייה באיחוי אק/מגירה

1. לתעדף P0, להגדיל את הצרכנים,

2. באופן זמני להפחית דגימת P2,

3. ניתוח מסלול וצוואר בקבוק רשת.

ד. פשרת מפתח

1. ביטול, סיבוב, עדכון רישום מהימן,

2. חתימה מחדש של קבוצות/תעודות ביקורתיות,

3. ביקורת של פעולות, לדווח לשותפים.

אי. התאמת ספריות (נכסים/רשתות)

1. הודעות עימות הסגר,

2. קטלוג רולוג לאחור

3. חישוב מחדש של אגרגטים,

4. פרסום מדבקות.

15) רשימת מימושים

1. הגדר רמות וחוזים (API, אירועים, ספריות, מפתחות).
2. הפעל את משא ומתן היכולת ורשימת גירסה/יכולת.
3. כולל אידמפוטנטיות, מכסות, QOS, חתימות, ו-MTLS.
4. הגדרות SLI/SLO, לוחות מחוונים והתראות (אק, E2E, ציות).
5. בדיקת חוזה אוטומטית ומטריצת מבחן תאימות.
6. הזן נהלי ירידה ונדידה (MAJOR במקביל).
7. סקירה קבועה של קטלוגים/פרטיות וכללי גישה.

16) גלוסרי

משא ומתן יכולות - ליישב יכולות נתמכות ופרופיל עבודה.
חוזה ראשון - עיצוב ממשקים באמצעות חוזים רשמיים לפני יישום.
אידמפוטנטיות, פעולות אבטחה חוזרות.
סכימה/חוזה דריפט - אי התאמה בין הודעות בפועל וחוזים מוצהרים.
POLP הוא העיקרון של מינימום זכויות הכרחיות.
ציות% הוא אחוז ההודעות/בקשות התואמות את החוזה.

שורה תחתונה: אינטראקציה משתתפת היא מערכת מנוהלת של חוזים, גרסאות, יכולות ויכולת תצפית. על ידי הפעלת מסגרת זו, המערכת האקולוגית מספקת אינטגרציה מהירה, זורמים עסקיים ברי קיימא ואבולוציה בטוחה ללא התמוטטות - מרמת הרשת וזהויות לתהליכים וממשל.