# Meta-Hook Router

إن Meta-Hook Router هو مُعدِّد إرسال لوصلة تحويل Token-2022 Transfer Hook. وهو يحل قيدًا أساسيًا: لا يسمح Token-2022 إلا بـ **واحدة** وصلة تحويل واحدة لكل mint. يَشغل Meta-Hook Router هذا الموضع الوحيد ويوجّه إلى ما يصل إلى 8 وصلات فرعية — سواء برامج سولانا الأصلية أو عقود Solidity على Rome EVM.

## المشكلة

وصلات تحويل Token-2022 قوية — فهي تعمل عند كل `transfer_checked` استدعاء، مما يتيح الامتثال والإتاوات والتحليلات وغير ذلك. لكن كل mint يحصل على برنامج وصلة واحد فقط. إذا احتاج مُصدِر عملة مستقرة إلى فحوصات KYC وAND فحص العقوبات وAND إنفاذ الإتاوات، فلن يتمكن من استخدام ثلاثة برامج وصلات منفصلة.

## الحل

يسجّل Meta-Hook Router نفسه باعتباره وصلة التحويل الوحيدة الخاصة بالـ mint، ثم يوجّه إلى عدة وصلات فرعية حسب ترتيب الأولوية:

```
SPL Transfer (Jupiter, Raydium, wallet)
    ↓
Token-2022 transfer_checked
    ↓
Meta-Hook Router (slot وصلة واحد)
    ├── الوصلة الفرعية 1: امتثال KYC (Solidity على Rome EVM)
    ├── الوصلة الفرعية 2: فحص العقوبات (Solidity على Rome EVM)
    ├── الوصلة الفرعية 3: تحليلات التحويل (برنامج سولانا أصلي)
    └── الوصلة الفرعية 4: إنفاذ الإتاوات (Solidity على Rome EVM)
    ↓
أول فشل يوقف الجميع — يتم إرجاع التحويل
```

## الخصائص الرئيسية

**إرسال متعدد الوصلات** — حتى 8 وصلات فرعية لكل mint، تُرسل بالتسلسل حسب ترتيب الأولوية.

**وصلات فرعية أصلية + EVM** — امزج برامج سولانا الأصلية وعقود Solidity في سلسلة إرسال واحدة.

**أول فشل يوقف الجميع** — إذا رفضت أي وصلة فرعية التحويل، يتم إرجاع التحويل بالكامل. وهذا يضمن عدم إمكانية تجاوز الامتثال.

**تجميع ExtraAccountMetaList** — يقوم الموجّه بربط بيانات تعريف الحسابات الإضافية من جميع الوصلات الفرعية حتى يتمكن Token-2022 من تمرير الحسابات الصحيحة إلى كل منها.

**تعليمات المشرف** — `registerSubHook`, `removeSubHook`, `reorderSubHooks`, `pauseSubHook` — إدارة دورة حياة كاملة.

**وضع الحالة الواحدة فقط** — تُنفَّذ وصلات التحويل داخل معاملات سولانا. لا يمكن الوصول إلى OP-Geth من هذا السياق، لذا يجب أن تستخدم جميع الوصلات الفرعية EVM وضع الحالة الواحدة (الوكيل).

## البنية المعمارية

### امتثال بطبقتين

يتيح Meta-Hook Router الامتثال على طبقتين:

**طبقة SPL (سولانا)** — يعمل الموجّه عند كل `transfer_checked` استدعاء. عندما يبدّل شخص ما رمزًا متوافقًا على Jupiter، أو يرسله من Phantom، أو يتفاعل مع أي بروتوكول DeFi على سولانا، تعمل وصلة الامتثال.

**طبقة ERC-20 (EVM)** — داخل Rome EVM، يمكن لعقد التغليف ERC-20 تنفيذ قيود النقل الخاصة به (متوافق مع ERC-3643). تتم مراجعة الامتثال لجميع التحويلات داخل EVM.

**طبقة الجسر** — تعمل الوصلة عندما تدخل الرموز إلى Rome EVM أو تخرج منه. يتم إدراج خزنة الجسر في القائمة البيضاء داخل عقد الامتثال للسماح بالإيداع/السحب.

**السجل المشترك** — تقرأ كلتا الطبقتين من نفس `KYCRegistry.sol` العقد. موافقة KYC واحدة تغطي سولانا وEVM معًا.

### ميزانية الحوسبة

| نوع الوصلة           | تكلفة CU   |
| -------------------- | ---------- |
| عبء التحويل الأساسي  | 100,000 CU |
| لكل وصلة فرعية أصلية | 50,000 CU  |
| لكل وصلة فرعية EVM   | 200,000 CU |
| موصى به لتحويل EVM   | 800,000 CU |

## حلول الوصلات الفرعية

### P0 — الإطلاق أولًا

**S1: وصلة امتثال KYC/العقوبات** — عقود امتثال Solidity كمعالجات Transfer Hook. تخصيص أسماء لكل mint، وإدراج خزائن البروتوكولات في القائمة البيضاء (Jupiter/Kamino/Orca + خزنة جسر Rome)، وربط العناوين من أجل KYC عبر السلاسل.

**S1b: غلاف امتثال ERC-20** — مكمل لـ S1 على جانب EVM. قيود نقل متوافقة مع ERC-3643 على تمثيل ERC-20 داخل Rome EVM.

**S2: مُعدِّد إرسال متعدد الوصلات (غير EVM)** — الموجّه نفسه، مفيد لأي مُصدِر Token-2022 حتى بدون EVM. يحل مشكلة وصلة واحدة لكل mint عبر النظام البيئي كله.

**S3: امتثال العملات المستقرة وفق GENIUS Act** — وصلات تنظيمية للعملات المستقرة: العقوبات، الولايات القضائية، التقارير.

### P1 — الإطلاق التالي

**S4: حدود التحويل وضوابط السرعة** — حد أقصى لكل تحويل، وحدود سرعة يومية/أسبوعية، وفترات تبريد.

**S5: قواعد التحويل القائمة على الولاية القضائية** — قوائم حظر الدول، وفحوصات المستثمر المعتمد، وفترات الاحتفاظ حسب الولاية القضائية.

**S6: إنفاذ الإتاوات** — إتاوات منشئ غير قابلة للتجاوز على كل تحويل SPL.

**S7: تحليلات التحويل على السلسلة** — وصلة للقراءة فقط تُصدر أحداثًا. نقطة جذب لاعتماد الخطة المجانية.

### P2 — التوسع في السوق

**S8: طبقة L2 مُصرَّح بها عبر بوابة الجسر** — الامتثال عند حدود إيداع/سحب الجسر.

**S9: توجيه الرسوم الديناميكي** — استخراج رسوم قابل للبرمجة لكل تحويل.

**S10: نقاط الولاء/المكافآت** — منح نقاط عند التحويل.

**S11: إنفاذ الاستحقاق/القفل** — منع التحويلات التي تنتهك جداول الاستحقاق.

## حالة استخدام: امتثال RWA من البداية إلى النهاية

```
يقوم المُصدِر (مثل Securitize) بنشر:
  1. ComplianceHook.sol على Rome EVM (سجل KYC، العقوبات، قواعد الولاية القضائية)
  2. يسجله كوصلة فرعية EVM في Meta-Hook Router
  3. يصك رمز RWA كـ Token-2022 مع transfer_hook = Meta-Hook Router

مستخدم سولانا يبدّل رمز RWA على Jupiter:
  Jupiter يستدعي transfer_checked
    → يستدعي Token-2022 Meta-Hook Router
    → يوجّه الموجّه إلى Rome EVM عبر CPI
    → يتحقق ComplianceHook من KYC للمرسل/المستقبل + العقوبات
    → نجاح: يكتمل التحويل
    → فشل: يتم إرجاع التحويل بالكامل

مستخدم EVM يجسر رمز RWA إلى Rome EVM:
  تحويل SPL إلى خزنة الجسر
    → تعمل الوصلة (فحص الامتثال عند الدخول)
    → يتم سك ERC-20 داخل EVM
    → لدى ERC-20 قيود النقل الخاصة به (ERC-3643)
    → تتم مراجعة امتثال جميع تحويلات EVM على مستوى ERC-20
```

## القيود المعروفة

1. **وضع الحالة الواحدة فقط** — لا يمكن الوصول إلى OP-Geth من داخل معاملة سولانا
2. **فقط transfer\_checked** — لا تعمل الوصلات إلا عند `transfer_checked`، وليس عند `transfer`. يجب على جسر Rome أن يستخدم `transfer_checked`
3. **السكّ/الحرق غير مرتبطين بالخطافات** — لا تعمل وصلات Token-2022 على عمليات السك/الحرق. يتم التحكم بها عبر سلطة السك
4. **الحد الأقصى 8 وصلات فرعية** — حد لكل mint
5. **الهروب عبر تغليف الرموز** — يمكن للمستخدمين تغليف الرموز لتجاوز الوصلات. يتم التخفيف من ذلك عبر القائمة السوداء للغلاف + امتداد PermanentDelegate
6. **نموذج عنوان EVM** — ترى الوصلات عناوين EVM المشتقة من Rome، وليس عناوين Ethereum. توفر SDK أداة اشتقاق

## الحالة

**قيد التنفيذ** — نواة الموجّه وواجهة تنفيذ وصلة KYC (S1) نشطان. تم توثيق 9 حزم، و13 قيدًا صعبًا، و24 حالة حافة.

## ذات صلة

* [Transfer Hooks](/ar/almfahym-alasasyh/transfer-hooks.md) — كيف تعمل وصلات تحويل Token-2022 في Rome
* [تكامل الرموز](/ar/almfahym-alasasyh/token-interop.md) — نموذج رمز ERC-20 ↔ SPL
* [مُصدرو العملات المستقرة](/ar/halat-alastkhdam/stablecoin-issuers.md) — امتثال متعدد الوصلات للعملات المستقرة


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.rome.builders/ar/almntjat/meta-hook-router.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.