SORA Nexus خدمات

SORA Nexus يضيف طائرات الخدمة التي تواجه التطبيقات حول Iroha 3. هذه الخدمات ليست دفترًا كبيرًا منفصلًا. يتم تركيزها بواسطة Iroha الدولة العالمية ، Norito المظاهر ، سجلات الحوكمة ، و Torii عائلات المسارات.

تتوفر يعتمد على بناء العقدة وملف الشبكة. استخدم /openapi على العقدة المستهدفة كقائمة موثوقة للطرق المحمولة.

خريطة المكونات

المكون	الدور	السطح الرئيسي
Soracloud	تنفيذ التطبيقات، الخدمات المضيفة، النموذج الخاص/حالة وقت التشغيل، ومراقبة دورة حياة الخدمة.	/v1/soracloud/، /api/، iroha app soracloud ...
في الداخل	Soracloud استضاف HTTP وقت تشغيل لإصلاحات الخدمة التي تحتاج إلى طائرة HTTP مباشرة.	Soracloud تشكيل وقت التشغيل، إعلانات قدرة المضيف، النسخة حالة الوقت التشغيلي
SoraNet	الخصوصية وتغطية النقل للدوائر، حركة المرور الإرسالية، VPN، جلسات الاتصال، وطرق البث.	/v1/connect/ ، /v1/vpn/، SoraNet البيانات الأساسية للطريق
الوصول إلى البيانات (DA)	دليل التوافر، والالتزام، وطبقة نية الحملات المفيدة التي يتم الإشارة إليها من خلال خطوط Nexus، وإشعار SoraFS، وتدفقات الدليل.	/v1/da/، FindDaPinIntent، [sumeragi.da]
SoraFS	نسيج التخزين مع عنوان المحتوى للانشارات ، والحمولات المفيدة CAR ، والمحتويات المثبتة ، ومقاطع البوابة ، وتدفقات إثبات استرداد.	/v1/sorafs/، /sorafs/، FindSorafsProviderOwner
SoraDNS	طبقة التسمية المحددة وتصنيف القرار للخدمات والمحتوى التي يتم استضافةها في SORA.	/v1/soradns/، /soradns/، أحداث دليل القرار
أيتاي	ممر تسوية الأصول على مستوى التطبيقات المدعومة من سجلات الاحتفاظ الأصلية ، وليس من قبل دفتر رئيسي منفصل	OpenAssetEscrow, FindAssetEscrow*, EscrowEventFilter, Kotodama escrow_* المباني

التدفقات الشائعة

تطبيق تقسيم استضافة

تطبيق مشترك عادي يستخدم كل القطع معا:

1. يتم تعبئة الأصول العادية للجهة الأمامية ووضعها في SoraFS.
2. يتم تسجيل المضيف العام على سبيل المثال <app>.sora من خلال SoraDNS.
3. طرق Soracloud /api/v1/search أو /api/v1/stream إلى خدمة HTTP في الإنترون.
4. طرق Soracloud /api/auth و/api/v1/user إلى المعاملين المحددين IVM.
5. يمكن للعملاء الذين يحتاجون إلى الخصوصية الوصول إلى نفس المحتوى أو طريق API من خلال دائرة SoraNet.

الطريق	الطائرة الخلفية	لماذا ؟
/	SoraFS محتوى ثابت	تخزين الجذر والبوابة الاحتياطية للمحتوى المتكرر
/assets/*	SoraFS محتوى ثابت	الأصول التي تعتمد على المحتوى و الدليل الرئيسي
/api/auth*	Soracloud IVM	إعادة تشغيل آمن و محفظة تحدي الحالة
/api/v1/user*	Soracloud IVM	التحولات الحكومية الحساسة
/api/v1/search*	Soracloud إنرو	خدمة HTTP المباشرة، التخزين الآلي، SSE، أو حالة جمع

النشر المحتوى

SoraFS النشر ينتج الآثار الدائمة قبل أن يشير اسمها إليها:

1. بناء حمولة مفيدة أو دليل.
2. إربطها في CAR أرشيف و خطة قطعة.
3. بناء مذكرة Norito مع بيانات سياسة البن والحوكمة.
4. قم بإرسال المخطط إلى Torii.
5. سجل نية DA أو الالتزام بالتوفر عندما يتطلب الملف الشخصي المستهدف إثباتًا صراحة.
6. ربط المخطط بإسم SoraDNS أو طريق Soracloud أمامية ثابتة.

طريق التوصيل الخاص أو البث

SoraNet يمكن أن تجلس أمام SoraFS أو Soracloud:

1. العميل يحل الاسم أو المذكرة.
2. سجل الحراسة أو دليل المسار يختار رلي دخول وخارج.
3. يتم تعبئة حركة المرور وإرسالها عبر دائرة SoraNet.
4. يصل إرسال الخروج إلى بوابة SoraFS ، أو سلسلة Torii ، أو طريق Soracloud.

أيتاي

أيتاي هو ممر التطبيق SORA للتسوية على شكل السوق حيث يقوم المشتري والبائع بتنسيق دفع خارج سلسلة الدفع بينما يسيطر Iroha على الاحتفاظ بالأصول على السلسلة. يجب أن تستخدم عائلة تعليمات الاحتفاض الأصلية بدلاً من حساب الاحتفاذ المملوك للعقود لتدفقات احتفاظ الأصول الرقمية الجديدة.

يحتفظ الوكيل الأصلي بالحماية في دفتر التسجيل. البائع يفتح عرضاً OpenAssetEscrow, المشتري يقبل ويضع علامة على الدفع خارج السلسلة: AcceptAssetEscrow و MarkEscrowPaymentSent, والبائع يطلق سراح ReleaseAssetEscrow إذا كان المشتري والبائع يختلفان، يمكن لأي من الطرفين فتح نزاع وحل مع CanResolveEscrowDispute بإمكانهم تقسيم المبلغ المحجوز

لمعرفة دورة الحياة الكاملة، قفل الأصول العامة، الاحتفاظ بالأموال المجهولة، والاستفسارات، والأحداث، ومثال Rust، انظر الاحتفاض الأصول الأصلية .

أيتاي سطح	استخدمها لـ
OpenAssetEscrow, AcceptAssetEscrow, MarkEscrowPaymentSent, ReleaseAssetEscrow, CancelAssetEscrow	عروض الأصول الرقمية الشفافة ، بما في ذلك تدفقات التسوية المعروفة بـ XOR.
OpenAnonymousAssetEscrow, AcceptAnonymousAssetEscrow, MarkAnonymousEscrowPaymentSent, ReleaseAnonymousAssetEscrow, CancelAnonymousAssetEscrow	العروض المحمية تستخدم مرفقات دليل للتمويل وإغلاق الحركات.
OpenEscrowDispute, ResolveEscrowDispute, OpenAnonymousEscrowDispute, ResolveAnonymousEscrowDispute	دخول النزاعات وحل المحاكم.
FindAssetEscrowById, FindAssetEscrowsBySeller, FindAssetEscrowsByBuyer, FindAssetEscrowsByStatus	صفحات حالة التطبيقات، وظائف المصالحة، وأدوات الدعم.
EscrowEventFilter	اشتراكات الاحتفاظ الشفافية على الهوية الاحتفالية، البائع، المشتري، الحالة، أو نوع الأحداث.
Kotodama escrow_open_offer, escrow_accept, escrow_mark_payment_sent, escrow_release, escrow_cancel, escrow_open_dispute, escrow_resolve_dispute	Kotodama المكالمات العقدية المدعومة من قبل V1 أوراق الاحتفاظ.

للاستخدام العام Taira أو Minamoto، اعتبر سكة الدفع خارج السلسلة وأي تدفق عمل دعم أو محاكمة سياسة التطبيق. Iroha تسجل حالة الاحتفاظ والأحداث في دورة الحياة ومكافحة الأدلة وحركة الأصول النهائية؛ فإنه لا يتحقق من التسوية القانونية بمفرده .

تحقق من عقدة الهدف

قبل استخدام الأمثلة من هذه الصفحة، تأكد من وجود عائلة الطرق على العقدة التي تستهدفها:

export TORII_URL=https://taira.sora.org

curl -fsS "$TORII_URL/openapi.json" \
  | jq '.paths | keys[] | select(test("^/v1/(soracloud|sorafs|soradns|connect|vpn|da)/"))'

curl -fsS "$TORII_URL/status" | jq .

إذا لم يتم الكشف عن /openapi.json من قبل الملف الشخصي، حاول /openapi. يعتمد التوافر الدقيق للمسار على ميزات البناء وتكوين الشبكة.

Taira تشيكات الدخان القراءة فقط

النقطة النهائية العامة Taira مفيدة للتحقق من جانب القراءة ، ولكن لا تستخدمها في أمثلة الطفرات ما لم تكن تشغل حسابًا مصرح به وتعتزم تغيير الحالة المباشرة.

export TORII_URL=https://taira.sora.org

curl -fsS "$TORII_URL/status" \
  | jq '{version: .build.version, peers, blocks, lanes: (.teu_lane_commit | length)}'

curl -fsS "$TORII_URL/v1/connect/status" | jq '{enabled, sessions_active}'

curl -fsS "$TORII_URL/v1/vpn/profile" \
  | jq '{available, relay_endpoint, supported_exit_classes}'

curl -fsS "$TORII_URL/v1/sorafs/storage/state" \
  | jq '{bytes_capacity, bytes_used, pin_queue_depth, por_inflight}'

curl -fsS -H 'Accept: application/json' "$TORII_URL/v1/soracloud/status" \
  | jq '.control_plane | {service_count, services: [.services[] | {service_name, current_version}]}'

Taira قد يعرض مسارات طائرة التحكم الخاصة بالتنفيذ غير المدرجة في خريطة المسار OpenAPI. تعامل /openapi كعقد API المولود الأساسي، ثم تأكد من أي مسار محدد للتنفيذ مباشرة قبل توثيقه على قيد الحياة .

Soracloud

Soracloud هو طائرة التحكم في تطبيقات SORA. تتتبع حزم التنفيذ وإصلاحات الخدمة والالتوجيه وحالة الانطلاق وإدخالات الإعدادات المعتمدة وسرية الخدمة المشفرة ومسجلات سجل النموذج ودورات الاستنتاج الخاصة وصناديق الوقت التشغيلي.

Soracloud يستخدم طائرتين للتنفيذ:

طائرة الإعدام	وقت التشغيل	استخدمها لـ
DeterministicService	Ivm	المؤلف، حالة الخزنة، القراءات المعتمدة، موظفين صناديق البريد، الطفرات الحساسة للإدارة
HttpService	Inrou	المباشر HTTP APIs، العمل الثقيل للمجمعين، الخدمات المدعومة من التخزين الآلي، SSE، التدفقات المساعدة من المتصفح

طائرة التحكم هي مؤكدة. تعتمد أوامر النشر والترقية والرجوع إلى الوراء والتشغيل السري والنموذج والحالة على إرسالها عبر Torii وقراءة حالة العالم الملتزم بها؛ لا تعتمد على مرآة محلية منفصلة CLI. التوجيه العام يعتمد على أطول مستوى، وبالتالي يمكن لمضيف مسجل واحد تقسيم حركة المرور بين طرق HTTP المضيفة والطرق الحتمية API.

قم بتجميع التطبيقات المفصلة

يخلق نموذج تقسيم التطبيق مقدمة ثابتة بالإضافة إلى خدمة مضيفة حية API وخدمة خزنة تحديدية واحدة / API:

iroha app soracloud app init \
  --template split-app \
  --app-name solswap_indexer \
  --app-version 0.1.0 \
  --public-host solswap-indexer.sora \
  --output-dir ./apps/solswap-indexer

iroha app soracloud app local-plan \
  --manifest ./apps/solswap-indexer/app_manifest.json

iroha app soracloud app doctor \
  --manifest ./apps/solswap-indexer/app_manifest.json

local-plan طبع تقسيم المسار، وإبلاغات خدمة الأطفال، مسارات النصوص في مجال العمل، والطريقة المتوقعة لنشر الطرف الأمامي. doctor تؤكد عقد الإفراج المحلي قبل أن تشمل Torii.

تنفيذ وتفتيش حالة التطبيق

export SORACLOUD_TORII_URL=https://<soracloud-enabled-torii>

iroha app soracloud app deploy \
  --manifest ./apps/solswap-indexer/app_manifest.json \
  --torii-url "$SORACLOUD_TORII_URL"

iroha app soracloud app status \
  --manifest ./apps/solswap-indexer/app_manifest.json \
  --torii-url "$SORACLOUD_TORII_URL"

لخدمة تم نشرها بالفعل، استخدم الأوامر المحددة على مستوى الخدمة:

iroha app soracloud status \
  --service-name solswap_indexer_live \
  --torii-url "$SORACLOUD_TORII_URL"

iroha app soracloud rollback \
  --service-name solswap_indexer_live \
  --target-version 0.1.0 \
  --torii-url "$SORACLOUD_TORII_URL"

المواد المخفية والسرية

Soracloud الإعدادات والإدخالات السرية هي جزء من حالة التنفيذ المعتمدة. لا يتم إغلاق الانتشار والترقية والاستعادة عندما تكون الإعدادات أو الالتزامات السرية المطلوبة مفقودة أو غير متوافقة مع المنشورات النشطة.

iroha app soracloud config-set \
  --service-name solswap_indexer_live \
  --config-name indexer/public_config \
  --value-file ./config/public-config.json \
  --torii-url "$SORACLOUD_TORII_URL"

iroha app soracloud secret-set \
  --service-name solswap_indexer_live \
  --secret-name indexer/api_key \
  --secret-file ./secrets/api-key.envelope.json \
  --torii-url "$SORACLOUD_TORII_URL"

استخدم مساعدة CLI للحصول على العلامات الوثيقة التي يتطلبها ملفك الشخصي:

iroha app soracloud config-set --help
iroha app soracloud secret-set --help

إندرو

إنرو هي المضيفة HTTP وقت التشغيل المستخدم من Soracloud. (إنه) Iroha العقدة مع المضمنة Soracloud المشاريع التي تم قبولها في الوقت المناسب Soracloud الدولة في خطة التمثيل المحلية، يبدأ النسخ المخصصة للخدمة المستضافة كخدمات الخلفية، و تقارير نسخة من حالة التشغيل مرة أخرى إلى النموذج المعتمد.

استخدم Inrou لتحميلات العمل التي تحتاج إلى سطح HTTP مباشر ، مثل التدفقات الثقيلة للجمع APIs ، SSE ، ومعالجات مدعومة بالخزن الآلي ، أو الخدمات المساعدة من المتصفح.

متطلبات وقت تشغيل

• يجب أن يكون وقت تشغيل مظلة الحاويات Inrou.
• يجب أن تكون طائرة تنفيذ بيانات الخدمة HttpService.
• HttpService + Inrou يتطلب بالضبط واحدة PersistentRootLeaseVolume مثبتة على /.
• تحتاج خدمات Inrou المكررة أيضًا إلى خدمة مشتركة أو تخزين تأجير سري عندما تحتفظ بحالة مشتركة متغيرة.
• يجب على عقدات استضافة الإنتاج الإعلان عن قدرة Inrou الحقيقية بدلاً من العمل كوكيل فقط.

قطعة واضحة

يظهر المثال أدناه شكل الإظهارين. إنه قطعة، وليس مجموعة كاملة للتنفيذ.

// container_manifest.json
{
  "schema_version": 1,
  "runtime": { "runtime": "Inrou", "value": null },
  "bundle_path": "/bundles/solswap-indexer.inrou",
  "entrypoint": "/app/bin/launch-indexer.sh",
  "args": [],
  "env": {
    "RUST_LOG": "info",
  },
  "inrou": {
    "schema_version": 1,
    "guest_os": { "guest_os": "DebianSlim", "value": null },
    "guest_images": {
      "x86_64": {
        "kernel_image_path": "/inrou/x86_64/vmlinux",
        "rootfs_image_path": "/inrou/x86_64/rootfs.ext4",
        "initrd_image_path": null,
      },
      "aarch64": {
        "kernel_image_path": "/inrou/aarch64/vmlinux",
        "rootfs_image_path": "/inrou/aarch64/rootfs.ext4",
        "initrd_image_path": null,
      },
    },
  },
  "lifecycle": {
    "start_grace_secs": 60,
    "stop_grace_secs": 30,
    "healthcheck_path": "/api/indexer/v1/health",
  },
}

// service_manifest.json
{
  "schema_version": 1,
  "service_name": "solswap_indexer_live",
  "service_version": "0.1.0",
  "execution_plane": { "execution_plane": "HttpService", "value": null },
  "replicas": 2,
  "route": {
    "host": "solswap-indexer.sora",
    "path_prefix": "/api/v1/search",
    "service_port": 8080,
    "visibility": { "visibility": "Public", "value": null },
    "tls_mode": { "tls": "Required", "value": null },
  },
  "lease_volumes": [
    {
      "volume_name": "root_disk",
      "kind": {
        "lease_volume": "PersistentRootLeaseVolume",
        "value": null,
      },
      "storage_class": { "storage_class": "Warm", "value": null },
      "mount_path": "/",
      "max_total_bytes": 8589934592,
    },
    {
      "volume_name": "index_state",
      "kind": { "lease_volume": "ServiceLeaseVolume", "value": null },
      "storage_class": { "storage_class": "Warm", "value": null },
      "mount_path": "/var/lib/solswap-indexer",
      "max_total_bytes": 1073741824,
    },
  ],
}

في وقت التشغيل، يتم تعريض كل حجم تأجير مثبت من خلال متغيرات بيئة مشتقة من اسم الكمية:

SORACLOUD_LEASE_VOLUME_ROOT_DISK_DIR
SORACLOUD_LEASE_VOLUME_ROOT_DISK_MOUNT_PATH
SORACLOUD_LEASE_VOLUME_INDEX_STATE_DIR
SORACLOUD_LEASE_VOLUME_INDEX_STATE_MOUNT_PATH

SoraNet

SoraNet هي التغطية على الخصوصية والنقل. إنها توفر طرق قائمة على الرصيف للحركة المرور التي لا يجب أن تتصل مباشرة بالبوابة المستهدفة أو الخدمة. يستخدم تصميم النقل أدوار إرسال الدخول والوسط والخروج ، QUIC النقل ، ومصافحة اليد الهجينة القائمة على الضوضاء ، وتفاوض القدرة ، وبيانات البيانات من دليل الإرسال ، والخلايا المغطاة ذات الحجم الثابت.

في Nexus الانتشارات SoraNet يمكن أن يحمل محمولات المحتوى، حركة المرور عبر البوابة، VPN أو جلسات الاتصال، و Norito طرق التدفق. إدخالات السجلات يمكن أن تُعَرِّف على الروابط التي تدعم norito-stream, مما يسمح للعملاء بتفضيل الطرق المناسبة ل Torii RPC أو تدفق حركة المرور.

تكوين التدفقات

يسمح ملف Nexus بتوفير SoraNet لطرق البث:

[streaming]
feature_bits = 0b11

[streaming.soranet]
enabled = true
exit_multiaddr = "/dns/torii/udp/9443/quic"
padding_budget_ms = 25
access_kind = "authenticated"
provision_spool_dir = "./storage/streaming/soranet_routes"
provision_spool_max_bytes = 0
provision_window_segments = 4
provision_queue_capacity = 256

استخدم access_kind = "read-only" لطرق المحتوى التي لا تتطلب مصادقة المشاهد. استخدم authenticated عندما يجب على جهاز إرسال الخروج فرض التذاكر أو هوية المشاهد قبل الانتقال إلى Torii أو خدمة استضافة.

SoraNet-علم SoraFS جلب

(الـ) SoraFS الوصول CLI يمكن أن تنشر إشارة وكيل محلية والعجلة SoraNet البيانات الوصولية لمتوسيعات المتصفح أو SDK المعدلات:

sorafs_cli fetch \
  --plan artifacts/payload_plan.json \
  --manifest-id 7bb2...9d31 \
  --provider name=alpha,provider-id=9f5c...73aa,base-url=https://gw-alpha.example.org/,stream-token="$(cat alpha.token)" \
  --output artifacts/payload.bin \
  --json-out artifacts/fetch_summary.json \
  --local-proxy-manifest-out artifacts/proxy_manifest.json \
  --local-proxy-mode bridge \
  --local-proxy-norito-spool storage/streaming/soranet_routes \
  --local-proxy-kaigi-spool storage/streaming/soranet_routes \
  --local-proxy-kaigi-policy authenticated \
  --max-peers=2 \
  --retry-budget=4

تقارير مزود السجلات الموجّهة والإيصالات المقطوعة، البيانات الأساسية المحلية، وإعدادات الطريق الفعلي المستخدمة للحصول على.

إمكانية الحصول على البيانات (DA)

DA هي طبقة إثبات التوافر للحميات المفيدة التي كبيرة جدا، حساسة جدا للحفاظ على الخصوصية، أو الخدمات الخاصة جدا لوضعها مباشرة في حالة العالم. فإنه يسجل الالتزامات المحددة والتزامات الاسترداد بحيث يمكن للمؤكدين والبوابات والعملاء الاتفاق على البايتات التي تم وعدها، والسياسة التي تنطبق، وأي الأدلة قد لاحظت.

DA لا يحل محل Kura أو SoraFS:

• Kura تخزين بيانات استرداد الكتل النهائية والإتفاقية.
• SoraFS تخزين وتخدم البايتات المعروضة على المحتوى، والحمولات المفيدة CAR، والمخططات.
• DA تسجل الالتزامات وسياسات الإثبات، فتحات الأدلة، ومقصود اللوحة التي تسمح بتعيين تلك البايتات، والتحقق منها، وربطها مرة أخرى إلى حالة دفتر التسجيل.

استخدم DA عندما يحتاج تطبيق أو Nexus طريق إلى وعد مرئي في دفتر التسجيل بأن البيانات خارج السلسلة لا تزال قابلة للاسترداد. وتشمل الأمثلة الشائعة الالتزامات بالحمولة المفيدة في المسار لتدفقات التسوية، و SoraFS مقصدات اللوحة للمحتويات المنشورة ، حزم الأدلة التي يجب الاحتفاظ بها للتحقق في وقت لاحق، وأثاث التطبيقات التي ينبغي أن تكون الحالة العامة هي إضافة بدلاً من تحميل كامل.

دورة الحياة

المرحلة	ما هو المسجل
النية	التذكرة، الإشارة المعلنة، الاسم الأدنى، إشارة الطريق/العصر/السلسلة، سياسة الاحتفاظ، أو هدف النسخ.
الالتزام	إرسال المواد التي تربط الشريط، الحمولة المفيدة، حزمة الدليل، أو جذور المحتوى إلى سجل الرسومات المرئي.
الأدلة	التصويت على إمكانية الوصول، فتحات الأدلة، شهادات المزودين، أو أدلة أخرى محددة في الشخصية التي تقبلها شبكة الهدف.
السؤال	عمليات البحث المتعلقة بـ FindDaPinIntentByTicket ، FindDaPinIntentByManifest، FindDaPinIntentByAlias، أو FindDaPinIntentByLaneEpochSequence.

التدفق النموذجي للنشر المدعوم من DA هو:

1. إنشاء أو استلام الحمولة المفيدة خارج WSV، على سبيل المثال ملف SoraFS CAR أو Nexus حمولة مفيدة في المسار.
2. ووصف الحمولة المفيدة في مذكرة التزام Norito أو سجل الالتزامات المحدد للخطوط.
3. قم بإرسال المخطط أو نية اللوحة أو الالتزام عبر /v1/da/* عندما يتم تمكين عائلة الطرق تلك، أو من خلال مسار المعاملات الموقعة للشبكة.
4. دع المحققين أو مقدمي التوافر جمع الأدلة التي تتطلبها سياسة الإثبات النشط.
5. اسأل عن النية أو الالتزام الناتج قبل تعزيز مستعار، دليل تسوية، أو طريق البوابة التي تعتمد على الحمولة المفيدة.

النموذج الخوارجي

DA يحول حمولة مفيدة إلى التزاما موقعاً محمياً من إعادة تشغيل الكتلة. الخوارزميات المهمة هي تحديدية بحيث يمكن للمؤكّدين والبوابات إعادة احتساب نفس الخصائص من نفس البايت.

1. تحويل الحمل المفيد الذي تم تقديمه. Torii يقبل طلب استهلاك مع (lane_id, epoch, sequence) ، بايتات الحمولة المفيدة، بيانات التضخم، حجم الجزء، ملف مسح، سياسة الاحتفاظ، وتوقيع المرسل. يقوم العقد بتفكيك تحميلات gzip أو deflate أو Zstandard عند الطلب ، ثم يتحقق من أن طول البايت القنوني يساوي total_size.
2. تأكيد معايير المسار والجزء. يجب أن يكون هناك مسار في كتالوج المسارات Nexus. يجب أن تكون chunk_size قوة غير صفر من اثنين ، لا يقل عن بايتين ، ولا يزيد عن الحد الأقصى المحدد. يجب أن يتضمن ملف التمرير شرائح البيانات وعشرات مساوية على الأقل. يتم اختيار نظام الدليل في كتالوج المسار، إما merkle_sha256 أو kzg_bls12_381.
3. تطبيق سياسة الشبكة. يفرض العقد خط أساس التكرار والاحتفاظ المحدد للفئة البلوب. يجب أن تبقى البيانات الأساسية العامة متنًا صافيًا؛ يتم تشفير البيانات المحددة للحكم فقط بمفتاح البيانات الوصول إلى الحكم المحدد للعقد قبل كتابتها في المنشور.
4. الجزء والإجراء. يتم تقسيم الحمل المفيد القنوني مع ملف ذات الحجم الثابت مشتق من chunk_size. Torii يحسب هضم الحمولة المفيدة، جذور شجرة إثبات الاسترداد، والتزامات لكل قطعة. تتحمل قطع البيانات التزامات BLAKE3 على بايتها.
5. إضافة التزامات محو. يتم تجميع قطع في شريطات من data_shards. الخلايا المفقودة في الشريط النهائي هي صفر مدفوع لحساب الموازنة. RS(16) يخلق الموازنة شرائح المساواة الصفية / العالمية ؛ اختياريًا row_parity_stripes إضافة مساواة الشريط في نمط العمود عبر المصفوفة. الالتزامات في شرائحة المساواية هي BLAKE3 استهلاك رموز u16 صغيرة.
6. قم بإنشاء المخطط. DaManifestV1 تسجل المسار، العصر، فئة البقع، القوديك، هضم الحمولة المفيدة، الجذر الجزء، حجم الجزء، ملف مسح، سياسة الاحتفاظ، اقتباس الإيجار، التزامات الجزء، الاختيارية IPA الالتزام، البيانات الأساسية، والوقت للإصدار. تذكرة التخزين هي تحديدية: العقد يضغط أولاً على نموذج منشور مع تذكرة فارغة، ثم يكتب بصمة الإصبع إلى الوراء باعتبارها النهائية storage_ticket.
7. رفض صراعات إعادة التشغيل. مفتاح إعادة اللعب هو (lane_id, epoch, sequence, manifest_fingerprint). نسخة مزدوجة ذات نفس بصمة الإصبع غير فعالة. يتم رفض تسلسل قديم أو نفس السلسلة ذات بصمة إصبع مختلفة.
8. إصدار القطع الأثرية الموقعة. Torii يحسب التزاماً PDP، ويوقع على DaIngestReceipt ، ويقوم بإنشاء DaCommitmentRecord، ويكتب القطع الأوثرية للكاتب العام، الالتزام PDP، سجل الالتزام، جدول الالتزامات، نية اللوحة، ملف الإيصال، وسجل الإيصال. يقدم مؤشر الإيصال بشكل واحد لكل (lane_id, epoch).

سجلات الالتزام هي ما يحمله الكتل السجل يربط:

• الطريق، العصر، والترتيب
• المكالمة المتصلة ID والشاشة الكانونيكية للنشر
• مخطط إثبات المسارات
• الجذر الكثيف
• الالتزام الافتراضي KZG للطرق KZG
• PDP/إسهام الأدلة
• فئة الاحتفاظ وتذكرة التخزين
• Torii DA توقيع التأكيد

قبل أن تضم حزمة سجلات DA ، يؤكد مسار تجميع الحزمة:

• (lane_id, epoch, sequence) يجب أن يكون فريدًا داخل الحزمة.
• يجب أن تكون الحشيشات الواضحة غير صفرية ووحيدة داخل الكتلة.
• يجب أن تتطابق نظام إثبات الالتزام مع سياسة المسارات المكوّنة.
• طرق ميركل ترفض الالتزامات KZG؛ طرق KZG تتطلب الالتزام غير الصفر KZG.
• يتم تصنيف مقصدات اللوحة، وتنظيمها، وتصفيتها حسب الشارع، والإشارة الهمشية، وتذكرة التخزين، وحساب المالك، وقواعد اصطدام الألقاب.

يحتفظ عنوان الكتلة بالهاشز لسياسات إثبات DA والالتزامات ، ومقصود اللوحة. بالنسبة لإثبات العضوية ، يعرض حزم الالتزام أيضًا جذور ميركل التي تركها هي حشيشات من القيم Norito المشفورة DaCommitmentRecord. العقد الأولي يحتوي على الحشيشة بين الأطفال اليسرى واليمين. يتم تعزيز ورقة غريبة دون تغيير إلى الطبقة التالية.

التحقق من الأدلة

/v1/da/commitments/prove يمكن أن توفر إثباتًا لالتزام واحد في كتلة. يحتوي الإثبات على الالتزام ، وارتفاع الكتلة ، والمؤشر في الحزمة ، والحش حزمة ، وطول الحزمة، جذور Merkle ، ومسار الأخوة. تحقق:

1. يطابق هاش حزمة البرهان DA الالتزام في عنوان الكتلة.
2. ارتفاع كتلة الدليل يطابق رأس كتلة المشار إليها.
3. المؤشر في الحدود والالتزام يساوي إدخال حزمة في هذا المؤشر.
4. سياسة تأمين المسارات تقبل الالتزام.
5. إطاحة المسار الإخوة من ورقة الالتزام يعيد بناء الجذر المقدم.
6. الجذر الذي تم إعادة بناؤه يساوي جذر الكتلة.

هذا يثبت أن التزامًا محددًا بالتوفر كان مدرجًا في حمولة مفيدة خاصة؛ فهذا لا يدل على أن كل نسخة موجودة حاليًا على الإنترنت. يتم التحقق من إمكانية الاسترداد المباشر بشكل منفصل عن طريق جمع مقدمي SoraFS ، والتحقق من PDP/PoTR ، أو دليل على توافر محدد للملف.

تفاعل التوافق

يتم ربط DA مع Sumeragi من خلال البث الموثوق به (RBC) ، لكنه ليس بروتوكولًا نهائيًا ثانيًا. RBC ينشر ويقوم باسترداد حمولات المقترح: يعلن مقدم المقترح عن جلسة ل (height, view, payload_hash) ، وقطع تبادل الأقران، وتتبع إشارات READY/DELIVER ما إذا كان عدد كاف من المحققين قد لاحظوا نفس الحمل الاستثماري.

في Iroha 3 ، يعتبر الزميل الحمل المفيد المتعلّق بالحجم المتاحة عندما:

• الكتلة المحلية المعلقة البيانات hash إلى الحمل المفيد المتوقع hash، أو
• RBC عثرت على حمولة مفيدة تتطابق مع الحاجز الكتل، ارتفاع، المشاهدة، والحاجز الفيد

إذا لم تثبت أي من الحالات، سجلات الأقران missing_local_data ، تستمر في محاولة لاسترداد الحمولة المفيدة من خلال RBC أو إيقاف التزامن، وتقرير DA البوابة في الحالة والتلفونية. في التنفيذ الحالي هذه الإشارات DA هي إشارة لتحقيق النهاية: كتلة لا تزال تنتهي من شهادة الالتزام بالإضافة إلى الحمل المفيد المحلي المتطابق، ليس من شهادة قياسية منفصلة DA.

يوسع توقيت DA نوافذ الاسترداد. يتم استنباط التوقيت الفعال لـ DA من الكتلة الموضحة وتوقيت الالتزام، ثم مضاعفة بـ sumeragi.advanced.da.quorum_timeout_multiplier. وقت التوافر هو max(quorum_timeout, availability_timeout_floor_ms) * availability_timeout_multiplier. قبل انتهاء فترة التوافر هذه، يفضل العقد استرداد الحمل المفيد وتجنب إعادة جدولة مبكرة؛ بعد انتهائها، يمكن أن تستمر مسارات الاسترداد الطبيعية وتغيير الرؤية.

ملاحظات المشغل

تشمل ملفات الشخصية المتفق عليها في Iroha 3 نشر الحمولة المفيدة المدعومة من RBC، وحماية المظاهر، وصحة الكتلة DA، وتسجيل التلفزيون. يعرض نموذج الأقران حدود [sumeragi.da] للالتزامات والفتوحات الإثباتية لكل كتلة، بالإضافة إلى مضاعفات التوقيت [sumeragi.advanced.da] للسلوك القياسي والتوافر. الحفاظ على هذه الإعدادات متسقة بين المحققين في ملف تعريف شبكة واحد.

للكشف عن المسار، ابدأ بالوثيقة OpenAPI للعقد:

curl -fsS "$TORII_URL/openapi.json" \
  | jq '.paths | keys[] | select(startswith("/v1/da/"))'

استخدم إشارة استفسار لأسماء الاستفسارات الحالية DA، وشكل تشكيل الزملاء للأزرار المحلية [sumeragi.da] المعروضة من خلال البناء الخاص بك.

SoraFS

SoraFS هو النسيج اللامركزي لتخزين المحتوى. يحتوي على حزم البايت في قطع تحديدية، أرشيفات CAR، ومظاهر Norito التي تربط جذور المحتوى، ملفات تعريف المحتويات، وسياسات الوصف، وإثباتات الحوكمة. مزودي التخزين يعلنون عن القدرة وتوافر المحتوى، في حين تقوم البوابات بالتحقق من الإشعارات والالتزامات المتعلقة بالمحتوى قبل تقديمها.

النموذجي SoraFS الاستخدامات تشمل أصول التطبيقات الثابتة ، ومجموعات الوثائق ، والمنطقة المجموعات، والإشارات إلى النماذج أو الأثرية، ومجموعات الدليل على الحكم. Iroha تعرض نماذج البيانات SoraFS أحداث البوابة و FindSorafsProviderOwner الاستفسار عن حل ملكية المزود.

التعبئة، الإعلان، التوقيع، والإرسال

cargo run -p sorafs_car --features cli --bin sorafs_cli -- \
  car pack \
  --input ./dist \
  --car-out artifacts/site.car \
  --plan-out artifacts/site.chunk-plan.json \
  --summary-out artifacts/site.car-summary.json

cargo run -p sorafs_car --features cli --bin sorafs_cli -- \
  manifest build \
  --summary artifacts/site.car-summary.json \
  --manifest-out artifacts/site.manifest.to \
  --manifest-json-out artifacts/site.manifest.json \
  --pin-min-replicas=3 \
  --pin-storage-class=warm \
  --pin-retention-epoch=42

SIGSTORE_ID_TOKEN=$(oidc-client fetch-token) \
cargo run -p sorafs_car --features cli --bin sorafs_cli -- \
  manifest sign \
  --manifest artifacts/site.manifest.to \
  --bundle-out artifacts/site.manifest.bundle.json \
  --signature-out artifacts/site.manifest.sig

cargo run -p sorafs_car --features cli --bin sorafs_cli -- \
  manifest submit \
  --manifest artifacts/site.manifest.to \
  --chunk-plan artifacts/site.chunk-plan.json \
  --torii-url "$TORII_URL" \
  --resolve-submitted-epoch=true \
  --authority=<i105-account-id> \
  --private-key-file ./secrets/authority.ed25519 \
  --summary-out artifacts/site.manifest.submit.json \
  --response-out artifacts/site.manifest.submit.body

إذا لم يتم توجيه /v1/sorafs/pin/register على العقدة المستهدفة، فيمكن أن يعود CLI إلى تقديم /transaction وقع عليه وانتظار حالة خط الأنابيب المحمول.

التحقق والحصول

cargo run -p sorafs_car --features cli --bin sorafs_cli -- \
  proof verify \
  --manifest artifacts/site.manifest.to \
  --car artifacts/site.car \
  --chunk-plan artifacts/site.chunk-plan.json \
  --summary-out artifacts/site.verify.json

sorafs_cli fetch \
  --plan artifacts/site.chunk-plan.json \
  --manifest-id <manifest-digest-hex> \
  --provider name=primary,provider-id=<provider-id-hex>,base-url=https://gateway.example.org/,stream-token="$(cat provider.token)" \
  --output artifacts/site.fetch.tar \
  --json-out artifacts/site.fetch.json

التحقق من إثبات استردادية

يمكن للمشغلين تفتيش وتفعيل عمليات التحقق من إثبات الاحتفاظ بمقدمي المخزن:

sorafs_cli por status \
  --torii-url "$TORII_URL" \
  --manifest <manifest-digest-hex> \
  --status=failed \
  --limit=20

sorafs_cli por trigger \
  --torii-url "$TORII_URL" \
  --manifest <manifest-digest-hex> \
  --provider <provider-id-hex> \
  --reason=latency_probe \
  --samples=48 \
  --auth-token artifacts/challenge_token.to

SoraDNS

SoraDNS هي طبقة الإسميات المحددة لخدمات SORA والمحتوى. فإنه يطبق الأسماء، يركز تحديثات إرشادات حلول في Iroha، وتوزع حزم المنطقة الموقعة أو الحل من خلال SoraFS. يقوم الحل والبوابات التحقق من وثائق إثبات الحل قبل الثقة في البيانات الأساسية للكشف.

بالنسبة للوصول إلى المتصفح ، SoraDNS يستخرج مضيفات البوابة من FQDN مسجل. يبقى مضيف الخيانة المسجل أصل التطبيق القنوني ، في حين أن ملفات تعريف بوابة المنشأة تكشف عن متصفح وطرق إرجاع Torii لهذا الأصل.

نموذج المضيف

النموذج	مثال	الغرض
أصل الباطل	https://<fqdn>/<path>	التطبيق الكنسي URL المسجل في المخططات ومذكرات الإفراج
Taira مدخل المتصفح	https://<fqdn>.mon.taira.sora.net/<path>	بوابة متصفح عامة لـ مستعار نشط
Torii الطريق للعودة	https://taira.sora.org/soradns/<fqdn>/<path>	Torii إزالة التحليل والعودة إلى الطريق لـ مستعار نشط
بوابة الهاشية القنونية	<base32(blake3(name))>.gw.sora.id	هوية البوابة المحددة و GAR التحقق

/soradns/<alias>/... fallback ليس العام المفضل URL. يجب أن تفضل أدوات، مظاهر التطبيقات، وتكوين الجبهة الأمامية مضيف الفخام نفسه. إذا كان الاسم غير نشط على Taira، فإن بوابة المتصفح أو مسار العودة إلى الوراء يمكن أن يعود 404 أو يفشل TLS قبل بدء توجيه التطبيق.

مضيفات البوابة المشتقة

import {
  deriveSoradnsGatewayHosts,
  hostPatternsCoverDerivedHosts,
} from '@iroha/iroha-js'

const derived = deriveSoradnsGatewayHosts('docs.sora')
console.log(derived.canonicalHost)
console.log(derived.prettyHost)

const taira = deriveSoradnsGatewayHosts('solswap-indexer.sora', {
  prettySuffix: 'mon.taira.sora.net',
})
console.log(taira.prettyHost)

const patterns = [
  derived.canonicalHost,
  derived.canonicalWildcard,
  derived.prettyHost,
]
console.log(hostPatternsCoverDerivedHosts(patterns, derived))

GAR يجب أن تغطي الحمولات المفيدة مضيف الهاش القنوني والبطاقة البرية القنوني والمضيف الجميل الذي تم اختياره

احصل على صورة لقطة المخططات

curl -i "$TORII_URL/v1/soradns/directory/latest"

soradns_resolver directory fetch \
  --record-url "$TORII_URL/v1/soradns/directory/latest" \
  --directory-url https://gateway.example.org/soradns/directory/latest.car \
  --output ./state/soradns-directory

soradns_resolver rad verify \
  --rad ./state/soradns-directory/rad/resolver-a.norito

يجب على واجهات البوابة رفض الحلّات التي يفتقد وثيقة إثبات الحلّة، أو تنتهي صلاحيتها، أو غير الموقعة، أو لا تربط في أحدث دليل Merkle root. على شبكة لم يتم فيها نشر أي دليل حلّ بعد، يمكن /v1/soradns/directory/latest العودة إلى 404 على الرغم من تمكين طريقها.

المفوضية العامة DNS

SoraDNS استنتاج المضيف لا يحل محل تفويض الإنترنت العادي DNS. إذا كان يجب أن يشير اسم عام DNS إلى بوابة SoraDNS:

• للمنطاقات الفرعية، نشر CNAME إلى المضيف الجميل المختار
• عن أسماء النقاط العليا، استخدم سجلات ALIAS/ANAME أو A/AAAA إلى البوابة أيcast IPs.
• الحفاظ على مضيف الهاشي القنوني تحت نطاق البوابة SoraDNS لتحقيقات GAR

FHE و UAID

السطحات المتعلقة FHE المتاحة لخدمات Nexus تشمل:

• iroha_crypto::fhe_bfv تنفذ دعمًا محددًا BFV لتقييم النص المشفر المتعدد. يستخدم قرار المحدد BfvIdentifierPublicParameters و BfvIdentifierCiphertext ، حيث تخزين فتحة 0 طول البايت المدخل وتخزين فتحات لاحقة بايت مشفر واحد لكل منها.
• Soracloud النموذج من مخططات الدولة والوظائف FHE أحمال عمل نص تشفير مع مجموعات المعلمات التي يتم إدارتها في الإدارة، وسياسات التنفيذ، والتزامات نص تشفري، غلافات الاستفسارات، وطلبات الكشف عن.

يتم استخدام مسار معرف BFV للحفاظ على الخصوصية في التسجيل. يمكن للعميل تقديم معرف مشفر إلى حلول Torii. يقوم القرار بتقييم وفقًا لسياسة التعرف النشط، فإنه يستخرج OpaqueAccountId ، ويصدر إيصالًا. ClaimIdentifier ثم يربط هذا الإيصال إلى UAID المرفق على الحساب المستهدف.

(الـ) UAID هو الهوية والقدرة المرسومة حول هذا التدفق. في نموذج البيانات، UniversalAccountId يتم دعمها بالهاشة ويعرض على uaid:<hash>. الاطلاع يقبل إما uaid:<hash> أو الـ64 هيكس الخام Account و NewAccount يحتوي على اختياري uaid و opaque_ids تسجيل وقت التشغيل يفرض على واحد إلى واحد UAID-مؤشر الحساب، يرفض المعرفات غير الشفافة المتكررة أو المتصادمة، ويرفض المعرفات الغامضة بدون UAID. في كل مرة UAID تغييرات ربط الحساب، وقت تشغيل يعيد بناء دائرة البيانات الإداري الفضاء ربط لهذا UAID.

دليل الفضاء يظهر إمكانات ربط إلى UAID. (إنه) AssetPermissionManifest الأسماء UAID, مساحة البيانات ، وتشغيل وفترة انتهاء اختياري ، والإدخالات المترتبة على السماح / رفض المساحة للبيانات ، والبرنامج ، والأسلوب ، والأصل ، AMX الدور. التقييم هو رفض-فوز: الرفض الأول يرفض الطلب، وإلا يتم التحقق من أحدث إمكانية مطابقة المرشح ضد أي حد للمبلغ. نشر، انتهاء الصلاحية، وإلغاء هذه المخططات يحرص على CanPublishSpaceDirectoryManifest.

بالنسبة إلى حالة Soracloud FHE، فإن النظم المنفذة هي:

المخطط	ما يسيطر عليه
SoraStateBindingV1 مع FheCiphertext	يعلن أن القيم تحت مقدمة مفتاح الحالة هي FHE نصوص رمزية.
FheParamSetV1	أسماء النظام، الخلفية، سلسلة الوحدات، درجة الكتلة، عدد الفتحات، الهدف الأمني، دورة الحياة، وتلاعب المعلمات.
FheExecutionPolicyV1	تحد من حجم النص المشفر ، وحجم النص الصريح ، ومعدل الدخول / الخروج ، وعمق الضربة ، والدورات ، والشرائط الناشئة ، ونظام التجميض.
FheGovernanceBundleV1	يرتبط مع parameter واحد مع سياسة تنفيذ واحدة للتحقق من القبول.
FheJobSpecV1	يصف العمل المحدد Add ، Multiply، RotateLeft، أو Bootstrap على مفاتيح حالة النص الشفر والالتزامات.
CiphertextQuerySpecV1	استفسارات تشفير النص فقط الحالة من خلال الخدمة، الالتزام، المقبلات الرئيسية، حدود النتيجة، مستوى البيانات المتعددة، وإثبات الإدراج الاختياري.
DecryptionRequestV1	يطلب الكشف عن الالتزام بالنص المشفر واحد بموجب سياسة تفكير السلطة.

يتحقق FheJobSpecV1::validate_for_execution من توافق الوظيفة وسياسة التنفيذ ومجموعة المعايير قبل القبول. كما أنه يفرض قواعد محددة للعمليات: إضافة وتضاعف يحتاج إلى مدخلين على الأقل، يجب أن تبقى العميقة المطلوبة ، وعدد الدوران ، وعدد التشغيل ، وعدد المدخلات ، وبايتات الحمل المفيد ، وحجم الإخراج القياسي داخل حدود السياسة. لا يجب أن تعود نتائج استفسار رمز النص الصفوفية.

UAID ليس النص المشفر وليس سياسة FHE نفسها. إنه مقعد قدرة الحساب المستقرة المستخدم للعثور على الحساب ، ومزاعم التعرف غير الشفافة ، وربطات دليل المساحة التي تسمح بدفع خدمة أو مساحة بيانات. تخطيطات FHE تحكم إدخال الحمولة المفيدة المشفرة وتنفيذها بشكل منفصل من خلال مجموعات المعايير وسياسات التنفيذ والتزامات النص المشفر وسياسات سلطة فك الشفرة.

الأسطح ذات الصلة Torii تشمل:

• /v1/identifier-policies
• /v1/identifiers/resolve
• /v1/accounts/{account_id}/identifiers/claim-receipt
• /v1/identifiers/receipts/{receipt_hash}
• /v1/accounts/{uaid}/portfolio
• /v1/space-directory/uaids/{uaid}
• /v1/space-directory/uaids/{uaid}/manifests
• /v1/soracloud/model/run-private
• /v1/soracloud/model/run-private/finalize
• /v1/soracloud/model/decrypt-output

حدود البيانات المعدنية العامة واضحة في مخططات: UAID الارتباطات، سجلات الهوية غير الشفافة، دورة حياة المظاهر، إضافة مفتاح الحالة، حجم النص المشفر، التزامات النص الشفري، أسماء السياسات، نسخ مجموعة المعايير، عمليات الوظائف، مفاتيح حالة الخروج، ويمكن رؤية البيانات الأساسية لمطالب الإفصاح. يُمكن أن تكون النصوص العادية للتعرف والحالة المفكورة وإدخالات النموذج والمخرجات، ومفاتيح السرية FHE خارج هذه سجلات الاستفسار العامة.

قائمة الفحص التشغيلية

• تأكيد عائلات الخدمة الممكّنة مع /openapi على العقدة المستهدفة Torii.
• العلاج Soracloud بيانات التنفيذ SoraFS المخططات SoraDNS سجلات إدراجات resolver، SoraNet سجلات إرشادية الإرسال ، و DA نواياها أو التزامات توافرها كمواد حساسة للحوكمة.
• استخدم نفس الملف الشخصي SORA Nexus باستمرار عبر المؤهلات في شبكة واحدة.
• الحفاظ على جذر Inrou وحجم الإيجار المشترك في المنشورات بدلاً من الاعتماد على مسارات العقدة المحلية الخاصة.
• استخدم SoraFS التحقق من الإثبات قبل تشجيع أسماء مستعار للمحتوى.
• المراقب SoraNet فشل في ضغط اليد، DA الإجراءات القضائية أو مواعيد التوافر SoraFS رفض البوابة، SoraDNS RAD الطازجة ، و Soracloud الوصول الصحي.
• للاستخدام العام Taira أو Minamoto، ابدأ بـ تواصل مع نطاقات البيانات SORA Nexus .

انظر أيضاً:

• نقاط نهاية Torii
• مرشحات حوادث البيانات
• إشارة الاستفسار