الوثائق

الوحدات

تتشارك أربعة منتجات نواة واحدة: الحسابات والهوية، والحفظ، ودفتر الأستاذ، ومنصة التشغيل. ترخّصون منتجًا واحدًا أو عدة منتجات. لكل وحدة قسم عام هنا (المفاهيم، التكامل، واجهات API) وقسم خاص في بوابة العملاء (أدلة التشغيل، البنية، المفاتيح).

أين تبحثون

البيئات

لكل نشر بيئتان على الأقل: بيئة التجهيز (staging) وبيئة الإنتاج. يحصل عملاء السحابة على كلتيهما منا؛ ويشغّلهما عملاء الاستضافة على خوادمهم (self-hosted) ضمن بنيتهم التحتية باستخدام أداة التثبيت الخاصة بنا. تصل الإصدارات دائمًا إلى بيئة التجهيز أولًا، وتُرقّى إلى الإنتاج بعد موافقتكم في البوابة.

الأسابيع

ما نحتاجه منكم

ترخيص أو خطة ترخيص واضحة، وأصول العلامة التجارية، وحسابات المطورين في المتاجر، وعقود KYC والبنك/مزوّد الدفع الخاصة بكم (أو قرار باستخدام عقودنا)، وشخصان أو ثلاثة يتولون العمليات.

المقارنة

تحديد الحجم

# self-hosted, minimum footprint (production)
3× app nodes        8 vCPU · 32 GB
2× database         8 vCPU · 64 GB · NVMe, replicated
1× queue/cache      4 vCPU · 16 GB
1× custody signer   isolated network, HSM optional
1× monitoring       4 vCPU · 16 GB
# staging: half of the above, single database

إرسال أمر

POST /v1/orders
Authorization: HMAC-SHA256 <key>:<ts>:<sig>

{
  "market": "BTC-USDT",
  "side": "buy",
  "type": "limit",
  "price": "81720.00",
  "amount": "0.25",
  "time_in_force": "GTC",
  "post_only": false
}

201 Created
{ "id": "ord_7f3a…", "status": "open", "filled": "0" }

بيانات السوق

wss://api.yourbrand.exchange/v1/ws
{ "op": "subscribe", "channels": ["book.BTC-USDT.10", "trades.BTC-USDT"] }

{ "ch": "book.BTC-USDT.10", "bids": [["81726.1","0.88"], …], "asks": [["81729.0","2.31"], …], "seq": 9182311 }

أنواع الأوامر

حدود معدل الطلبات

الافتراضي 20 طلبًا/ثانية لكل مفتاح للأوامر، و60/ثانية للقراءة. تحصل مفاتيح صنّاع السوق على حدود أعلى عند الطلب. وتظهر الحدود والرصيد المتبقي في ترويسات الاستجابة.

كيف يعمل

يسعّر المحرك جانبي كل سوق بأسعار حقيقية قابلة للتنفيذ مستمدة من منصات مرجعية خارجية، بفارق سعري تحددونه لكل زوج. ويُتحوَّط لتنفيذات العملاء تلقائيًا؛ وتُطبَّق حدود المخزون والانكشاف على مدار الساعة.

إعدادات كل سوق

صنّاع السوق الخاصون بكم

يتصل صنّاع السوق الخارجيون بمفاتيح API عادية بحدود معدل مرفوعة. وتُضبط مستويات الرسوم مع الخصومات المستردة (rebates) في لوحة الإدارة.

إنشاء فاتورة

POST https://api.pay.yourbrand.com/v1/invoices
Authorization: Bearer sk_live_…

{ "amount": "49.00", "currency": "USD", "pay_currency": "USDT", "network": "tron",
  "order_id": "A-10422", "success_url": "https://shop.example/thanks", "webhook_url": "https://shop.example/hooks/pay" }

201 { "id": "inv_4821", "checkout_url": "https://pay.yourbrand.com/i/inv_4821", "expires_at": "…" }

استقبال الحدث

POST /hooks/pay
X-Signature: t=1729170000,v1=9f2a…

{ "type": "payment.confirmed", "invoice": "inv_4821", "amount_paid": "49.000000", "tx": "7f3a…c41e", "confirmations": 19 }

# verify: HMAC-SHA256(secret, t + "." + body) == v1

الأحداث

WooCommerce

ثبّتوا الإضافة، والصقوا مفتاح API، واختاروا الأصول المقبولة. تنتقل حالة الطلب إلى Processing عند payment.confirmed. وتضيف الدفعات الجزئية ملاحظة ورابط استكمال إلى الطلب.

Shopify

تطبيق بوابة دفع مستضافة. يُعتمد عبر مراجعة Shopify Partner تحت حسابكم؛ ونحن نُعدّ صفحة الإدراج. تتم التسوية إلى رصيد التاجر لديكم؛ ويرى Shopify بوابة قياسية.

Magento وOpenCart

متاحة عند الطلب؛ بنموذج الأحداث نفسه.

معايير الجولة

العقود

عقود الرمز القياسية ERC-20/BEP-20 وعقود الاستحقاق مضمّنة ومدقَّقة. الآليات المخصصة (ضبط المعروض، مستويات الحائزين) وحدة مستقلة؛ ونرتّب تدقيقًا خارجيًا قبل الإصدار.

المطالبة

عند TGE تُموَّل عقود الاستحقاق التدريجي. يربط المستثمرون المحفظة التي تحققوا بها ويطالبون بالمبالغ المفتوحة من البوابة. والجداول علنية.

السياسة

# policy.yaml (excerpt)
assets:
  BTC:
    hot_target: 5%
    cold_sweep_above: 8%
    approvals:
      - below: 10000 USD   quorum: 1-of-3   delay: 0
      - below: 1000000 USD quorum: 2-of-3   delay: 0
      - above: 1000000 USD quorum: 3-of-5   delay: 4h
    new_address_delay: 24h
    daily_cap: 2500000 USD

الموافقات

كل موافقة حدث مصادقة ثنائية يقوم به مسؤول مسمّى. ويُحدَّد النصاب لكل أصل ولكل شريحة مبالغ. وإجراءات الطوارئ (break-glass) موثّقة وتترك سجلًا.

مراقب الاحتياطيات

تقرأ خدمة مستقلة الأرصدة على السلسلة لكل عنوان قيد الحفظ وتقارنها بدفتر الأستاذ باستمرار. أي عدم تطابق يطلق تنبيهًا؛ والفحص الذي يتعذر إكماله يُبلَّغ عنه بحالة «غير معروف». وتتوفر تصديرات إثبات الاحتياطيات عند الطلب.

الأدوار الافتراضية

الإصدارات

تُبنى من نظام إدارة الإصدارات، وتُختبر (أكثر من 1,000 اختبار آلي)، وتُنشر على بيئة التجهيز، وتُعلن في البوابة مع سجل التغييرات، وتُرقّى بعد موافقتكم. والتراجع بأمر واحد.

اتفاقية مستوى خدمة الدعم