بدائل tonapi.io في 2026 لمطوّري TON

الطلب الأول مرّ، والطلب المئة عاد بـ 429 — وها أنت تبحث عن بديل لـ tonapi

الساعة الثالثة فجرًا، وأنت تنشر بوتًا يراقب مدفوعات USDT الواردة إلى محافظ مستخدميك. محليًا كان كل شيء يعمل بسرعة البرق. أما في الإنتاج — بعد خمس دقائق من الإطلاق — فالسجلّات ممتلئة عن آخرها بالسطر نفسه: HTTP 429 Too Many Requests. تحديث الأرصدة يجري على دفعات متقطّعة، والمستخدمون يكتبون «أين أموالي؟». يبدو مألوفًا؟ الـ API العام اصطدم بحدّه، وحركة الطلبات لم تكد تبدأ بالنمو بعد. ومن هنا يبدأ البحث: تحتاج إلى بديل tonapi يصمد في الإنتاج (وفي البحث الإنجليزي يُصاغ هذا هكذا: «tonapi alternative 2026»).

وبلا مفتاح، يبلغ الحد العام لـ tonapi.io نحو طلب واحد في الثانية، وأي حلقة من نوع «اجمع الأرصدة لقائمة محافظ» أو «اسحب سجل المعاملات» تصطدم به فورًا.

ولنحسم أولًا مسألةً متداولة حتى لا تطارد شيئًا غير موجود. يتداول مجتمع TON طرفة «الخطأ 228» — وهو رقم ميم (meme) متداوَل، لا كود خطأ في أي API. فلا tonapi ولا toncenter يعيد لك «228» أبدًا. أما كود الحد الحقيقي فهو 429، وهو ما ينبغي التقاطه ومعالجته. فإن كنت تبحث في جوجل عن «tonapi 228» فأنت في الحقيقة تحتاج إلى إصلاح 429، وقد فصّلناه في /blog/tonapi-429-fix.

وفيما يلي تحليل صادق: أين يقف سقف tonapi.io، ومن غيره في السوق، ولماذا يتّجه عدد متزايد من الفرق إلى TON لا عبر REST خام بل عبر MCP.

ما هو tonapi.io وأين يقف سقفه

tonapi.io واجهة HTTP API عامة لشبكة TON (أي REST مفهرس فوق عقدة). ترسل طلبًا فتستقبل JSON: الرصيد، والمعاملات، وحالة الحساب، وبيانات الجيتونات وNFT. ولا بنية تحتية عليك أن تديرها إطلاقًا. وللنموذج الأولي — مثالي.

ويبدأ السقف حيث يبدأ الإنتاج:

• حدّ مشترك للطلبات. بلا مفتاح نحو طلب واحد في الثانية، وبعده 429. ومع مفتاح يرتفع الحد، لكنها تبقى بنية تحتية مشتركة. وهذا ليس حظرًا ولا عطلًا — بل هكذا يُفترض أن يعمل تحديد المعدّل على مورد مشترك.
• REST خام. تحصل على JSON وتكتب الشيفرة كلها بنفسك: إعادة حساب وحدات raw وفق decimals، وحساب عنوان محفظة الجيتون، وتجميع معاملة المبادلة. فالـ API لا «يجيد» الأفعال — بل يقرأ فحسب.
• القراءة فقط. لا مبادلة ولا كروس-تشين ولا توليد محافظ جاهزًا للاستخدام مباشرةً — ولم تكن تلك مهمّته أصلًا.

وللوحة معلومات، هذا يكفي. أما لوكيل يحتاج أن يفعل شيئًا على TON — فلا يكفي.

لماذا يبحث المطوّرون عن بديل tonapi في 2026

ثلاثة أسباب هي الأكثر تكرارًا:

1. الحدود تعضّ في اللحظة التي ينطلق فيها مشروعك. ما دام لديك عشرة مستخدمين، فطلب واحد في الثانية يكفي. وحين يأتي ألف — تنهمر أخطاء 429 كالمطر. وهذا من تصميم النقطة العامة، لا خلل فيها. وعن الخيارات المتاحة، انظر بدائل toncenter لعام 2026.
2. طبقة التكامل تغيّرت. صار الذي يخاطب TON في الغالب ليس واجهتك الخلفية مباشرةً، بل وكيل ذكاء اصطناعي — Claude أو Cursor أو ChatGPT/Codex. وبالنسبة إلى الوكيل، نقطة REST ليست إلا وثائق عليه أن يستوعبها ويحلّلها دون أن يخلط بين الوسائط. أما واجهة الوكيل الأصلية فليست REST، بل أدوات عبر MCP.
3. أنت تحتاج أفعالًا لا بيانات فقط. مبادلة GRAM⇄جيتون، وتبادل كروس-تشين، وإنشاء محفظة. وtonapi لا يغطّي ذلك — فينتهي بك الأمر تلصق عدّة SDK معًا.

والتشبيه بسيط. الـ API العام حافلة مدينة: مجانية، وتسير وفق جدول، لكنها في ساعة الذروة تمتلئ عن آخرها وتتحرّك بتشنّج. أما الإنتاج فيحتاج إمّا مسارًا خاصًّا بك وإمّا وسيلة نقل مختلفة جذريًا.

من تضع في الحسبان: واجهات API عامة، ولايت-سيرفرات، ومفهرسات، وMCP

خريطة صادقة للخيارات في 2026:

• واجهات HTTP API العامة (tonapi.io، toncenter). بداية سريعة وبيانات مفهرسة. والعيب — حدّ مشترك للطلبات، و429، وقراءة فقط.
• اللايت-سيرفرات العامة من الإعداد العالمي (ADNL). وصول أصلي إلى العقدة، لكن الخوادم مشتركة ومحدودة: فهي تحت الحمل كثيرًا ما تردّ بـ not ready أو تسقط بمهلة ADNL، ولا تحتفظ بسجل عميق.
• لايت-سيرفر خاص بك / عقدة أرشيفية / مفهرس. أقصى تحكّم وأعمق سجل، لكنك تدفع الثمن عتادًا ووقتَ مزامنة وساعات devops. إنه مشروع بنية تحتية لا خدمة ذاتية.
• خادم MCP لشبكة TON. أدوات بدل REST الخام: يستدعي الوكيل get_balance أو build_swap_tx بدل أن يحلّل JSON يدويًا. وعن البروتوكول نفسه، انظر MCP لشبكة TON: من أين تبدأ.

TONNode: الوصول إلى TON عبر MCP لا عبر REST خام

TONNode (الموقع tonnode.io) هو خادم MCP مستضاف لشبكة TON. وMCP (Model Context Protocol) معيار تستدعي عبره وكلاء الذكاء الاصطناعي (Claude وCursor وChatGPT/Codex وأي عميل MCP) الأدوات. والفارق عن tonapi في صياغة المسألة نفسها: بدل «أعطني JSON وسأتدبّر أمري»، تسلّم الوكيل مجموعة أدوات محدّدة الأنواع، فيقرّر هو أيّها يستدعي.

مثال عملي. لمعرفة رصيد USDT لعنوان ما عبر REST الخام تحتاج إلى: إيجاد عنوان جيتون-ماستر الخاص بـ USDT، وحساب عنوان محفظة الجيتون للمالك، واستدعاء get-method فيها، وأخذ decimals (وهي 6 في USDT)، وإعادة حساب وحدات raw. أما عبر TONNode فهو استدعاء واحد لـ get_jetton_balance — ومحفظة الجيتون تُحسب على السلسلة نيابةً عنك. تحليل مفصّل للحالة: رصيد USDT على TON باستدعاء واحد.

وملاحظة مهمة في باب الصدق: TONNode ليس دفعًا لكل طلب، وليس واجهة REST/API مفهرسة، وليس بثًّا عبر SSE/WebSocket، وليس وِبهوكس. والعقدة الأرشيفية ما زالت تتزامن، لذلك لا نَعِد بسجل عميق كخدمة جاهزة. وما هو موجود اليوم هو بالضبط ما يُوصَف أدناه، بلا إضافات.

16 أداة: قراءة + مبادلة + كروس-تشين + محفظة

16 أداة بالضبط، في أربع مجموعات. والستّ عشرة كلها متاحة على جميع الخطط.

القراءة (8):

• get_masterchain_info — رأس الـ masterchain
• get_balance — رصيد GRAM
• get_account_state — الحالة، والأعلام، وآخر معاملة
• get_transactions — سجل المعاملات
• run_get_method — أي get-method للقراءة فقط في أي عقد
• get_jetton_balance — رصيد الجيتون/USDT؛ ويُحسب عنوان محفظة الجيتون على السلسلة نيابةً عنك
• get_jetton_info — بيانات الجيتون الوصفية: الاسم، والرمز، وdecimals، والكمية المُصدَرة (وتحتاج decimals لإعادة حساب الوحدات الخام: USDT=6، ومعظم الجيتونات 9)
• parse_address — تحويل صيغ EQ/UQ/raw والتحقق منها، ويعمل دون اتصال

المبادلة (2):

• get_swap_quote — عرض سعر مؤكَّد من الـ DEX لزوج GRAM⇄جيتون عبر بروتوكول Omniston (سيولة STON.fi + DeDust)
• build_swap_tx — معاملة مبادلة غير موقّعة، جاهزة لـ TonConnect

الكروس-تشين (5):

• get_crosschain_quote — عرض سعر التبادل الكروس-تشين
• build_crosschain_swap_tx — معاملة إسكرو HTLC غير موقّعة + السرّ
• track_crosschain_swap — مراحل الصفقة على الشبكتين
• disclose_crosschain_secret — كشف السرّ للتسوية بعد التحقق من الجاهزية على السلسلة
• build_crosschain_refund — استرجاع الأموال من الإسكرو إن تعلّقت الصفقة

إسكرو HTLC ذرّي، وTON هو المصدر دائمًا. وشبكات الوجهة: Ethereum، وArbitrum، وBase، وBNB Chain، وPolygon، وAvalanche. أما TRON فغير مدعومة بعد.

المحفظة (1):

• generate_wallet — ينشئ محفظة بإصدار v3r2 / v4 / v5r1 / highload_v3؛ ويعيد العبارة التذكيرية والمفاتيح والعنوان

و«رصيد USDT» نفسه — مصدر كل المعاناة مع سلسلة الاستدعاءات اليدوية — هو هنا أداة واحدة. كما يمكنك أن تعطي الوكيل مهامّه بلغة بشرية عادية:

تحقّق من رصيد USDT في المحفظة EQC… واعرض آخر 5 معاملات

أعطِني عرض سعر مؤكَّدًا لمبادلة 100 GRAM بـ USDT وجمّع المعاملة غير الموقّعة

سيفكّك الوكيل الأمر الأول إلى get_jetton_balance + get_transactions، والثاني إلى get_swap_quote + build_swap_tx. وستوقّع محفظةُ المستخدم نتيجةَ المبادلة — دون سطر تحليل واحد من عندك.

عدم الاحتجاز: الخادم لا يوقّع ولا يحتفظ بالمفاتيح

هذا هو الفارق الجوهري الذي يستحق أن تواصل القراءة من أجله. فأدوات المبادلة والكروس-تشين والمحفظة غير احتجازية بصرامة:

• الخادم لا يوقّع المعاملات أبدًا ولا يحتفظ بالأموال أو المفاتيح الخاصة أبدًا.
• يعيد build_swap_tx وbuild_crosschain_swap_tx وغيرهما رسائل TonConnect غير موقّعة. وتوقّعها محفظة المستخدم — فالخادم لا يرى سوى رسالة جاهزة للتوقيع.
• والمحفظة الصادرة عن generate_wallet تُسلَّم إليك كاملة (عبارة تذكيرية + مفاتيح + عنوان) ولا يبقى منها شيء على الخادم.

أي إن TONNode يجهّز المعاملة، لكن الضغط على «وقّع» لا يقدر عليه إلا صاحب المفتاح.

وللمقارنة بإنصاف: @ton/mcp الرسمي من TON Foundation محفظة وكيل احتجازية (بنظام split-key: مفتاح المشغّل لدى الوكيل، ومفتاح المالك لدى المستخدم). فهو يوقّع بنفسه، ويستطيع الإنفاق باستقلالية، ويتعامل مع NFT/DNS. وله نقاط قوة حقيقية. والفارق بسيط: هو احتجازي وعلى TON فقط؛ وTONNode غير احتجازي ومعه كروس-تشين. المقارنة التفصيلية على tonnode.io/mcp/vs-official.

كيف تربطه: مجانًا محليًا، أو بمفتاح مستضاف

مجانًا ومحليًا. حزمة @tonnode/mcp مفتوحة المصدر (MIT)، وموجودة على npm وGitHub (tonnode/mcp)، وتعمل عبر بروتوكول TON الأصلي ADNL بلا طبقات HTTP وسيطة. ومجموعة القراءة الكاملة متاحة فورًا:

{
  "mcpServers": {
    "ton": {
      "command": "npx",
      "args": ["-y", "@tonnode/mcp"]
    }
  }
}

مفتاح مستضاف — حين تحتاج سعة تمرير مضمونة تحت مفتاحك الخاص:

{
  "mcpServers": {
    "ton": {
      "type": "http",
      "url": "https://mcp.tonnode.io/mcp",
      "headers": { "Authorization": "Bearer tn_live_…" }
    }
  }
}

الخطط (الأدوات الـ16 كلها في كل مكان — أنت تدفع مقابل سعة التمرير فقط):

الخطة	السعر	الحد
Hobby	مجانية إلى الأبد	60 طلبًا/دقيقة
Pro	29 دولارًا/شهر	300 طلب/دقيقة
Scale	199 دولارًا/شهر	1200 طلب/دقيقة

ويُصدر مفتاح Hobby المجاني فور تسجيل الدخول، بلا بطاقة. وتُدفع الخطط المدفوعة بـ GRAM أو USDT على شبكة TON عبر TonConnect، أو بـ BTC/ETH/SOL وغيرها عبر فاتورة xRocket في Telegram؛ ويُصدر المفتاح تلقائيًا بعد تسوية الدفعة. (وGRAM هو Toncoin بعد إعادة تسميته في يونيو 2026؛ أما الشبكة فما زالت تُسمّى TON.)

ماذا تختار لمهمّتك

• نموذج أولي أو سكربت لمرّة واحدة تكفي فيه القراءة. tonapi.io / toncenter العامّان، أو npx -y @tonnode/mcp محليًا — مجانًا وبما يكفي. لكن ضع 429 في حسبانك ولا تبنِ عليه إنتاجًا.
• وكيل يقرأ TON (أرصدة، ومعاملات، وUSDT، وget-methods). ثبّت @tonnode/mcp محليًا — مجانًا، ومجموعة القراءة كاملة، وبلا أي بنية تحتية.
• إنتاج تحت الحمل + مبادلة/كروس-تشين/توليد محافظ. مفتاح TONNode المستضاف: حدّ مضمون، ومعاملات غير موقّعة وغير احتجازية، وكروس-تشين ذرّي إلى 6 شبكات EVM.
• تحتاج محفظة وكيل مستقلّة مع NFT/DNS. انظر @ton/mcp الرسمي — مع مراعاة كونه احتجازيًا. أما في TONNode فأدوات NFT/DNS على خارطة الطريق، والسجل الأرشيفي العميق ما زال يتزامن، ويُنصَّب لايت-سيرفر مخصّص يدويًا عند الطلب — فإن كان ذلك حاسمًا لديك، فراسِلنا.

وباختصار: 429 إشارة إلى أنك تجاوزت طَور الحافلة، وأفضل بديل لـ tonapi تحت الحمل ليس نقطة REST مشتركة أخرى، بل سعة تمرير مضمونة عبر MCP. ابدأ بمجموعة القراءة المجانية محليًا، وحين تصطدم بالحد خذ مفتاحًا يضمنها.

احصل على مفتاح Hobby مجانًا (بلا بطاقة) ← tonnode.io/dashboard?plan=hobby

اطّلع على الأدوات كلها — tonnode.io/mcp · والخطط — tonnode.io/pricing