# معماری شبکه و مرز مسئولیت‌ها

ارتباط شبکه Besu، کنترل‌گر Admin Main، ایستگاه سازمانی و مارکت‌پلیس؛ با تفکیک کد موجود از استقرار عملیاتی.

وضعیت: پیاده‌سازی‌شده | مخاطب: توسعه‌دهندگان، مدیران زیرساخت و نهادهای همکار
بازبینی مستندات: ۲۰۲۶/۰۹/۲۴ · ۲ مهر ۱۴۰۵

## چهار بخش مستقل

مارکت‌پلیس رابط انتخاب دارایی، حساب کاربری و درخواست‌های تجاری است. پنل مدیریت وب محتوای همین محصول و اتصال‌های آن را اداره می‌کند. Admin Main محصول زیرساختی دیگری برای مدیریت شبکه Besu، اعتبارسنج‌ها و گردش کنترل قراردادهاست؛ این دو پنل نقش و سطح دسترسی یکسان ندارند.

Plank Station محیط کاری محدود به نقش سازمان است. نصب Station لزوماً نود بلاک‌چین، عضویت اجماع یا اختیار مدیریت کل شبکه ایجاد نمی‌کند. نسخه Remote نیز برای مشاهده اطلاعات سرور طراحی شده و دفترکل کامل را روی رایانه کاربر دانلود نمی‌کند.

| جزء | مسئولیت اصلی | مرز دسترسی |
| --- | --- | --- |
| مارکت‌پلیس و مدیر وب | دارایی‌ها، حساب و اتصال‌های تجاری | مجوزهای برنامه وب |
| Admin Main | هویت شبکه، زیرساخت و چرخه اعتبارسنج | دسترسی اپراتور مجاز زیرساخت |
| Station سازمانی | عضویت، وظایف و منابع متصل به ایستگاه | نقش‌های تأییدشده همان سازمان |
| Besu | اجرای EVM، دفترکل و اجماع QBFT | پیکربندی و مجموعه اعتبارسنج شبکه |

## هویت شبکه از کجا مشخص می‌شود؟

در نسخه تولیدی، هویت مورد انتظار شبکه با Chain ID و هش بلاک آغازین پیکربندی می‌شود. پاسخ RPC باید با این مقادیر تطبیق داشته باشد؛ پاسخ‌دادن یک سرویس یا تشابه نام شبکه کافی نیست. برخی مسیرها Network ID را نیز کنترل می‌کنند.

هش بلاک صفر که از RPC خوانده می‌شود با SHA-256 فایل genesis.json دو شاهد متفاوت است. اولی برای تطبیق زنجیره و دومی در بعضی مجوزها برای اتصال تصمیم به فایل پیکربندی به کار می‌رود. مستند اتصال هر مؤلفه مشخص می‌کند کدام‌یک مورد نیاز است.

## Besu و اجماع مجوزدار

سورس Admin Main تصویر Besu با نسخه ثابت 26.7.1 و تولید Genesis مبتنی بر QBFT را نشان می‌دهد. اجرای قراردادها با EVM و خواندن داده از JSON-RPC انجام می‌شود. دوره بلاک، دوره بلاک خالی و مهلت درخواست، تنظیمات شبکه هستند و نباید به‌عنوان یک زمان قطعی عمومی برای همه نصب‌ها معرفی شوند.

پیکربندی تولیدشده epoch برابر ۳۰٬۰۰۰ و zeroBaseFee دارد. وجود این گزینه در مولد شبکه به‌تنهایی ثابت نمی‌کند هر شبکه موجود همین تنظیمات را دارد یا کارمزد تجاری همه خدمات صفر است؛ تنظیمات واقعی باید از Genesis همان استقرار بررسی شوند.

## سه سطح شواهد

این مجموعه میان قابلیت پیاده‌شده در سورس، خروجی بسته‌بندی‌شده و کارکرد تأییدشده در محیط عملیاتی تفاوت می‌گذارد. وجود قرارداد، فایل نصب یا آزمون محلی، استقرار آن روی شبکه واقعی را اثبات نمی‌کند.

گزارش‌های نسخه‌ای داخل پروژه مرجع تاریخی بررسی‌ها هستند. در تهیه این مستندات کد و گزارش‌ها خوانده شده‌اند؛ اتصال به سرور، رأی اجماع، نصب سرویس و اجرای تراکنش تولیدی انجام نشده است.

> وضعیت زنده از این صفحه به دست نمی‌آید: تعداد اعتبارسنج فعال، ارتفاع بلاک، آدرس RPC و قراردادهای مستقر باید از محیط مجاز همان شبکه دریافت شوند. این مستندات برای این مقادیر عدد یا نشانی عملیاتی فرض نمی‌کنند.

## اتصال برنامه‌ها به یکدیگر

شناخت سلامت Admin Main، ثبت یک نود در رجیستری، عضویت رسمی QBFT و داشتن نقش تجاری چهار موضوع جدا هستند. هیچ‌کدام را نباید از دیگری نتیجه گرفت. برای نمونه، سازمان می‌تواند Station فعال داشته باشد و اصلاً اعتبارسنج نباشد.

برای راه‌اندازی یک خدمت کامل باید قرارداد API، نقش سازمان، منبع RPC، امضاکننده و ثبت نتیجه تراکنش در هر دو سوی اتصال مشخص شوند. اتصال‌های قیمت مارکت‌پلیس نیز به‌خودی‌خود دسترسی مدیریت شبکه یا تسویه روی زنجیره ایجاد نمی‌کنند.

## مراجع پیاده‌سازی

- admin-main-new/backend/app/production.py
- admin-main-new/backend/app/services/network_service.py
- plank-station-new/agent/app.py
- plank-station-mac-remote/server/gateway.py